feat: add range error validation for datatypes

src/data-type.ts

@@ -80,7 +80,7 @@ export interface DataType {
   generateTypeInfo(parameter: ParameterData, options: InternalConnectionOptions): Buffer;
   generateParameterLength(parameter: ParameterData, options: InternalConnectionOptions): Buffer;
   generateParameterData(parameter: ParameterData, options: InternalConnectionOptions): Generator<Buffer, void>;
-  validate(value: any, collation: Collation | undefined): any; // TODO: Refactor 'any' and replace with more specific type.
+  validate(value: any, collation: Collation | undefined, options?: InternalConnectionOptions): any; // TODO: Refactor 'any' and replace with more specific type.
 
   hasTableName?: boolean;
 

src/data-types/date.ts

@@ -1,12 +1,18 @@
 import { type DataType } from '../data-type';
 import { ChronoUnit, LocalDate } from '@js-joda/core';
+import { type InternalConnectionOptions } from '../connection';
+
+import { Collation } from '../collation';
 
 // globalDate is to be used for JavaScript's global 'Date' object to avoid name clashing with the 'Date' constant below
 const globalDate = global.Date;
 const EPOCH_DATE = LocalDate.ofYearDay(1, 1);
 const NULL_LENGTH = Buffer.from([0x00]);
 const DATA_LENGTH = Buffer.from([0x03]);
 
+const MIN_DATE = new globalDate('January 1, 0001');
+const MAX_DATE = new globalDate('December 31, 9999');
+
 const Date: DataType = {
   id: 0x28,
   type: 'DATEN',
@@ -35,7 +41,7 @@ const Date: DataType = {
 
     const value = parameter.value as any; // Temporary solution. Remove 'any' later.
 
-    let date;
+    let date: LocalDate;
     if (options.useUTC) {
       date = LocalDate.of(value.getUTCFullYear(), value.getUTCMonth() + 1, value.getUTCDate());
     } else {
@@ -49,7 +55,7 @@ const Date: DataType = {
   },
 
   // TODO: value is technically of type 'unknown'.
-  validate: function(value): null | Date {
+  validate: function(value: any, collation: Collation | undefined, options: InternalConnectionOptions): null | Date {
     if (value == null) {
       return null;
     }
@@ -58,6 +64,18 @@ const Date: DataType = {
       value = new globalDate(globalDate.parse(value));
     }
 
+    value = value as Date;
+
+    // TODO: check date range: January 1, 0001, through December 31, 9999
+    //    : time range: 00:00:00 through 23:59:59.997
+    if (options && options.useUTC) {
+      value = new globalDate(value.toUTCString());
+    }
+
+    if (value < MIN_DATE || value > MAX_DATE) {
+      throw new TypeError('Out of range.');
+    }
+
     if (isNaN(value)) {
       throw new TypeError('Invalid date.');
     }

src/data-types/datetime.ts

@@ -1,11 +1,17 @@
 import { type DataType } from '../data-type';
 import DateTimeN from './datetimen';
 import { ChronoUnit, LocalDate } from '@js-joda/core';
+import { type InternalConnectionOptions } from '../connection';
+
+import { Collation } from '../collation';
 
 const EPOCH_DATE = LocalDate.ofYearDay(1900, 1);
 const NULL_LENGTH = Buffer.from([0x00]);
 const DATA_LENGTH = Buffer.from([0x08]);
 
+const MIN_DATE = new Date('January 1, 1753');
+const MAX_DATE = new Date('December 31, 9999');
+
 const DateTime: DataType = {
   id: 0x3D,
   type: 'DATETIME',
@@ -34,7 +40,7 @@ const DateTime: DataType = {
 
     const value = parameter.value as any; // Temporary solution. Remove 'any' later.
 
-    let date;
+    let date: LocalDate;
     if (options.useUTC) {
       date = LocalDate.of(value.getUTCFullYear(), value.getUTCMonth() + 1, value.getUTCDate());
     } else {
@@ -72,7 +78,7 @@ const DateTime: DataType = {
   },
 
   // TODO: type 'any' needs to be revisited.
-  validate: function(value): null | number {
+  validate: function(value: any, collation: Collation | undefined, options: InternalConnectionOptions): null | number {
     if (value == null) {
       return null;
     }
@@ -81,6 +87,18 @@ const DateTime: DataType = {
       value = new Date(Date.parse(value));
     }
 
+    value = value as Date;
+
+    // TODO: check date range: January 1, 1753, through December 31, 9999
+    //    : time range: 00:00:00 through 23:59:59.997
+    if (options && options.useUTC) {
+      value = new Date(value.toUTCString());
+    }
+
+    if (value < MIN_DATE || value > MAX_DATE) {
+      throw new TypeError('Out of range.');
+    }
+
     if (isNaN(value)) {
       throw new TypeError('Invalid date.');
     }

src/data-types/datetime2.ts

@@ -1,10 +1,16 @@
 import { type DataType } from '../data-type';
 import { ChronoUnit, LocalDate } from '@js-joda/core';
 import WritableTrackingBuffer from '../tracking-buffer/writable-tracking-buffer';
+import { type InternalConnectionOptions } from '../connection';
+
+import { Collation } from '../collation';
 
 const EPOCH_DATE = LocalDate.ofYearDay(1, 1);
 const NULL_LENGTH = Buffer.from([0x00]);
 
+const MIN_DATE = new Date('January 1, 0001');
+const MAX_DATE = new Date('December 31, 9999');
+
 const DateTime2: DataType & { resolveScale: NonNullable<DataType['resolveScale']> } = {
   id: 0x2A,
   type: 'DATETIME2N',
@@ -64,7 +70,7 @@ const DateTime2: DataType & { resolveScale: NonNullable<DataType['resolveScale']
     const buffer = new WritableTrackingBuffer(16);
     scale = scale!;
 
-    let timestamp;
+    let timestamp: number;
     if (options.useUTC) {
       timestamp = ((value.getUTCHours() * 60 + value.getUTCMinutes()) * 60 + value.getUTCSeconds()) * 1000 + value.getUTCMilliseconds();
     } else {
@@ -102,7 +108,7 @@ const DateTime2: DataType & { resolveScale: NonNullable<DataType['resolveScale']
     yield buffer.data;
   },
 
-  validate: function(value): null | number {
+  validate: function(value: any, collation: Collation | undefined, options: InternalConnectionOptions): null | number {
     if (value == null) {
       return null;
     }
@@ -111,6 +117,18 @@ const DateTime2: DataType & { resolveScale: NonNullable<DataType['resolveScale']
       value = new Date(Date.parse(value));
     }
 
+    value = value as Date;
+
+    // TODO: check date range: January 1, 0001, through December 31, 9999
+    //    : time range: 00:00:00 through 23:59:59.997
+    if (options && options.useUTC) {
+      value = new Date(value.toUTCString());
+    }
+
+    if (value < MIN_DATE || value > MAX_DATE) {
+      throw new TypeError('Out of range.');
+    }
+
     if (isNaN(value)) {
       throw new TypeError('Invalid date.');
     }

src/data-types/datetimeoffset.ts

@@ -1,10 +1,16 @@
 import { type DataType } from '../data-type';
 import { ChronoUnit, LocalDate } from '@js-joda/core';
 import WritableTrackingBuffer from '../tracking-buffer/writable-tracking-buffer';
+import { type InternalConnectionOptions } from '../connection';
+
+import { Collation } from '../collation';
 
 const EPOCH_DATE = LocalDate.ofYearDay(1, 1);
 const NULL_LENGTH = Buffer.from([0x00]);
 
+const MIN_DATE = new Date('January 1, 0001');
+const MAX_DATE = new Date('December 31, 9999');
+
 const DateTimeOffset: DataType & { resolveScale: NonNullable<DataType['resolveScale']> } = {
   id: 0x2B,
   type: 'DATETIMEOFFSETN',
@@ -62,7 +68,7 @@ const DateTimeOffset: DataType & { resolveScale: NonNullable<DataType['resolveSc
     const buffer = new WritableTrackingBuffer(16);
     scale = scale!;
 
-    let timestamp;
+    let timestamp: number;
     timestamp = ((value.getUTCHours() * 60 + value.getUTCMinutes()) * 60 + value.getUTCSeconds()) * 1000 + value.getMilliseconds();
     timestamp = timestamp * Math.pow(10, scale - 3);
     timestamp += (value.nanosecondDelta != null ? value.nanosecondDelta : 0) * Math.pow(10, scale);
@@ -92,7 +98,7 @@ const DateTimeOffset: DataType & { resolveScale: NonNullable<DataType['resolveSc
     buffer.writeInt16LE(offset);
     yield buffer.data;
   },
-  validate: function(value): null | number {
+  validate: function(value: any, collation: Collation | undefined, options: InternalConnectionOptions): null | number {
     if (value == null) {
       return null;
     }
@@ -101,6 +107,18 @@ const DateTimeOffset: DataType & { resolveScale: NonNullable<DataType['resolveSc
       value = new Date(Date.parse(value));
     }
 
+    value = value as Date;
+
+    // TODO: check date range: January 1, 0001, through December 31, 9999
+    //    : time range: 00:00:00 through 23:59:59.997
+    if (options && options.useUTC) {
+      value = new Date(value.toUTCString());
+    }
+
+    if (value < MIN_DATE || value > MAX_DATE) {
+      throw new TypeError('Out of range.');
+    }
+
     if (isNaN(value)) {
       throw new TypeError('Invalid date.');
     }

src/data-types/money.ts

@@ -49,6 +49,14 @@ const Money: DataType = {
     if (isNaN(value)) {
       throw new TypeError('Invalid number.');
     }
+    // money： -922337203685477.5808 to 922337203685477.5807
+    // in javascript -922337203685477.5808 === -922337203685477.6
+    //                922337203685477.5807 === 922337203685477.6
+    // javascript number doesn't have enough precision.
+    if (value < -922337203685477.6 || value > 922337203685477.6) {
+      throw new TypeError('Value must be between -922337203685477.5808 and 922337203685477.5807, inclusive.');
+    }
+
     return value;
   }
 };

src/data-types/smalldatetime.ts

@@ -1,9 +1,15 @@
 import { type DataType } from '../data-type';
 import DateTimeN from './datetimen';
+import { type InternalConnectionOptions } from '../connection';
+
+import { Collation } from '../collation';
 
 const EPOCH_DATE = new Date(1900, 0, 1);
 const UTC_EPOCH_DATE = new Date(Date.UTC(1900, 0, 1));
 
+const MIN_DATE = new Date(1900, 1, 1);
+const MAX_DATE = new Date(2079, 5, 6, 23, 59, 59, 0);
+
 const DATA_LENGTH = Buffer.from([0x04]);
 const NULL_LENGTH = Buffer.from([0x00]);
 
@@ -35,7 +41,7 @@ const SmallDateTime: DataType = {
 
     const buffer = Buffer.alloc(4);
 
-    let days, dstDiff, minutes;
+    let days: number, dstDiff: number, minutes: number;
     if (options.useUTC) {
       days = Math.floor((parameter.value.getTime() - UTC_EPOCH_DATE.getTime()) / (1000 * 60 * 60 * 24));
       minutes = (parameter.value.getUTCHours() * 60) + parameter.value.getUTCMinutes();
@@ -51,7 +57,7 @@ const SmallDateTime: DataType = {
     yield buffer;
   },
 
-  validate: function(value): null | Date {
+  validate: function(value, collation: Collation | undefined, options: InternalConnectionOptions): null | Date {
     if (value == null) {
       return null;
     }
@@ -60,6 +66,16 @@ const SmallDateTime: DataType = {
       value = new Date(Date.parse(value));
     }
 
+    value = value as Date;
+
+    if (options && options.useUTC) {
+      value = new Date(value.toUTCString());
+    }
+
+    if (value < MIN_DATE || value > MAX_DATE) {
+      throw new TypeError('Out of range.');
+    }
+
     if (isNaN(value)) {
       throw new TypeError('Invalid date.');
     }