Improve BigInteger and BigSerial support

Change-type: major

src/type-utils.ts

@@ -93,6 +93,12 @@ export const validate = {
 		}
 		return processedValue;
 	}),
+	bigint: checkRequired((value) => {
+		if (value === '') {
+			throw new Error('Cannot convert empty string to a BigInt');
+		}
+		return BigInt(value);
+	}),
 	text: (length?: number) =>
 		checkRequired((value) => {
 			if (typeof value !== 'string') {

src/types/big-integer.ts

@@ -9,13 +9,30 @@ export const types = {
 	},
 };
 
-export type Types = TypeUtils.TsTypes<number, number>;
-type DbWriteType = number;
+export type Types = TypeUtils.TsTypes<bigint, number | bigint>;
+type DbWriteType = bigint;
+
+export const fetchProcessing: TypeUtils.FetchProcessing<Types['Read']> = (
+	data,
+) => {
+	if (data == null) {
+		return data;
+	}
+	let value: bigint;
+	if (typeof data === 'bigint') {
+		value = data;
+	} else if (typeof data === 'string' || typeof data === 'number') {
+		value = BigInt(data);
+	} else {
+		throw new Error('Fetched bigint is not valid: ' + typeof data);
+	}
+	return value;
+};
 
 export const nativeFactTypes: TypeUtils.NativeFactTypes = {
 	Integer: TypeUtils.nativeFactTypeTemplates.comparison,
 	Real: TypeUtils.nativeFactTypeTemplates.comparison,
 };
 
 export const validate: TypeUtils.Validate<Types['Write'], DbWriteType> =
-	TypeUtils.validate.integer;
+	TypeUtils.validate.bigint;

src/types/big-serial.ts

@@ -1,4 +1,5 @@
 import * as TypeUtils from '../type-utils';
+export { fetchProcessing } from './big-integer';
 
 const mysqlType: TypeUtils.DatabaseTypeFn = (
 	necessity: string,
@@ -23,8 +24,8 @@ export const types = {
 	},
 };
 
-export type Types = TypeUtils.TsTypes<number, number>;
-type DbWriteType = number;
+export type Types = TypeUtils.TsTypes<bigint, number | bigint>;
+type DbWriteType = bigint;
 
 export const validate: TypeUtils.Validate<Types['Write'], DbWriteType> =
-	TypeUtils.validate.integer;
+	TypeUtils.validate.bigint;

test/Big Integer.ts

@@ -1,8 +1,39 @@
 import * as helpers from './helpers';
 
 helpers.describe('Big Integer', (test) => {
+	const testBigIntString = String(Number.MAX_SAFE_INTEGER) + '00000001';
+
+	describe('fetchProcessing', function () {
+		test.fetch(1, BigInt(1));
+		test.fetch('1', BigInt(1));
+		test.fetch('1', BigInt(1));
+		test.fetch(BigInt(testBigIntString), BigInt(testBigIntString));
+		test.fetch(testBigIntString, BigInt(testBigIntString));
+		test.fetch({}, new Error('Fetched bigint is not valid: object'));
+	});
+
 	describe('validate', function () {
-		test.validate(1, true, 1);
-		test.validate('1', true, 1);
+		test.validate(
+			1.1,
+			new RangeError(
+				'The number 1.1 cannot be converted to a BigInt because it is not an integer',
+			),
+		);
+		test.validate('1.1', new SyntaxError('Cannot convert 1.1 to a BigInt'));
+		test.validate('', new Error('Cannot convert empty string to a BigInt'));
+		test.validate(
+			'testNotANumber',
+			new Error('Cannot convert testNotANumber to a BigInt'),
+		);
+		test.validate(
+			NaN,
+			new SyntaxError(
+				'The number NaN cannot be converted to a BigInt because it is not an integer',
+			),
+		);
+		test.validate(1, true, BigInt(1));
+		test.validate('1', true, BigInt(1));
+		test.validate(BigInt(testBigIntString), true, BigInt(testBigIntString));
+		test.validate(testBigIntString, true, BigInt(testBigIntString));
 	});
 });

test/Big Serial.ts

@@ -23,8 +23,39 @@ helpers.describe('Big Serial', function (test) {
 		});
 	});
 
+	const testBigIntString = String(Number.MAX_SAFE_INTEGER) + '00000001';
+
+	describe('fetchProcessing', function () {
+		test.fetch(1, BigInt(1));
+		test.fetch('1', BigInt(1));
+		test.fetch('1', BigInt(1));
+		test.fetch(BigInt(testBigIntString), BigInt(testBigIntString));
+		test.fetch(testBigIntString, BigInt(testBigIntString));
+	});
+
 	describe('validate', function () {
-		test.validate(1, true, 1);
-		test.validate('1', true, 1);
+		test.validate(
+			1.1,
+			new RangeError(
+				'The number 1.1 cannot be converted to a BigInt because it is not an integer',
+			),
+		);
+		test.validate('1.1', new SyntaxError('Cannot convert 1.1 to a BigInt'));
+		test.validate('', new Error('Cannot convert empty string to a BigInt'));
+		test.validate(
+			'testNotANumber',
+			new Error('Cannot convert testNotANumber to a BigInt'),
+		);
+		test.validate(
+			NaN,
+			new SyntaxError(
+				'The number NaN cannot be converted to a BigInt because it is not an integer',
+			),
+		);
+
+		test.validate(1, true, BigInt(1));
+		test.validate('1', true, BigInt(1));
+		test.validate(BigInt(testBigIntString), true, BigInt(testBigIntString));
+		test.validate(testBigIntString, true, BigInt(testBigIntString));
 	});
 });

test/helpers.ts

@@ -15,6 +15,7 @@ type TestFn = (
 			| null
 			| string
 			| number
+			| bigint
 			| boolean
 			| Date
 			| Buffer