data-api-client 2.0.0-beta.0 → 2.1.0

package/dist/retry.d.ts

@@ -0,0 +1,11 @@
+export interface RetryConfig {
+    enabled?: boolean;
+    maxRetries?: number;
+    baseDelay?: number;
+    retryableErrors?: string[];
+}
+export declare function isDatabaseResuming(error: any): boolean;
+export declare function isConnectionError(error: any): boolean;
+export declare function isRetryableError(error: any): boolean;
+export declare function withRetry<T>(fn: () => Promise<T>, config?: RetryConfig): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;CAC3B;AAwBD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAMtD;AAKD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAarD;AAKD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAEpD;AAUD,wBAAsB,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,GAAE,WAAgB,GAAG,OAAO,CAAC,CAAC,CAAC,CAoD7F"}

package/dist/retry.js

@@ -0,0 +1,76 @@
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isDatabaseResuming = isDatabaseResuming;
+exports.isConnectionError = isConnectionError;
+exports.isRetryableError = isRetryableError;
+exports.withRetry = withRetry;
+const RESUMING_RETRY_DELAYS = [0, 2000, 5000, 10000, 15000, 20000, 25000, 30000, 35000, 40000];
+const CONNECTION_RETRY_DELAYS = [0, 2000, 4000];
+const CONNECTION_ERROR_PATTERNS = [
+    'Communications link failure',
+    'Connection is not available',
+    'currently unavailable',
+    'Database cluster is not available',
+    "Can't connect to",
+    'Connection timed out'
+];
+function isDatabaseResuming(error) {
+    if (!error)
+        return false;
+    const code = error.code || error.Code || error.name || '';
+    const message = error.message || error.Message || '';
+    return code === 'DatabaseResumingException' || message.includes('is resuming after being auto-paused');
+}
+function isConnectionError(error) {
+    if (!error)
+        return false;
+    const message = error.message || error.Message || '';
+    const code = error.code || error.Code || error.name || '';
+    if (code === 'BadRequestException' || code === 'StatementTimeoutException') {
+        return true;
+    }
+    return CONNECTION_ERROR_PATTERNS.some((pattern) => message.includes(pattern));
+}
+function isRetryableError(error) {
+    return isDatabaseResuming(error) || isConnectionError(error);
+}
+async function withRetry(fn, config = {}) {
+    const { enabled = true, maxRetries = 9, retryableErrors = [] } = config;
+    if (!enabled) {
+        return fn();
+    }
+    let attempt = 0;
+    let retryDelays = [];
+    let maxAttempts = 0;
+    while (true) {
+        try {
+            if (attempt > 0 && retryDelays.length > 0) {
+                const delay = retryDelays[attempt] || retryDelays[retryDelays.length - 1];
+                await new Promise((resolve) => setTimeout(resolve, delay));
+            }
+            return await fn();
+        }
+        catch (error) {
+            let shouldRetry = false;
+            if (isDatabaseResuming(error)) {
+                retryDelays = RESUMING_RETRY_DELAYS;
+                maxAttempts = Math.min(maxRetries, retryDelays.length - 1);
+                shouldRetry = attempt < maxAttempts;
+            }
+            else if (isConnectionError(error)) {
+                retryDelays = CONNECTION_RETRY_DELAYS;
+                maxAttempts = CONNECTION_RETRY_DELAYS.length - 1;
+                shouldRetry = attempt < maxAttempts;
+            }
+            else if (retryableErrors.length > 0 && retryableErrors.includes(error.code || error.name)) {
+                retryDelays = RESUMING_RETRY_DELAYS;
+                maxAttempts = Math.min(maxRetries, retryDelays.length - 1);
+                shouldRetry = attempt < maxAttempts;
+            }
+            if (!shouldRetry) {
+                throw error;
+            }
+            attempt++;
+        }
+    }
+}

package/dist/transaction.d.ts

@@ -0,0 +1,4 @@
+import type { InternalConfig, Transaction, QueryOptions } from './types';
+export declare const transaction: (config: InternalConfig, _args?: Partial<QueryOptions>) => Transaction;
+export declare const commit: (config: InternalConfig, queries: Array<(lastResult: any, allResults: any[]) => any[]>, rollback: (err: Error, status: any) => void) => Promise<any[]>;
+//# sourceMappingURL=transaction.d.ts.map

package/dist/transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../src/transaction.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAOxE,eAAO,MAAM,WAAW,GAAI,QAAQ,cAAc,EAAE,QAAQ,OAAO,CAAC,YAAY,CAAC,KAAG,WAiCnF,CAAA;AAGD,eAAO,MAAM,MAAM,GACjB,QAAQ,cAAc,EACtB,SAAS,KAAK,CAAC,CAAC,UAAU,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,CAAC,EAC7D,UAAU,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,KAAK,IAAI,KAC1C,OAAO,CAAC,GAAG,EAAE,CAsCf,CAAA"}

package/dist/transaction.js

@@ -0,0 +1,59 @@
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.commit = exports.transaction = void 0;
+const client_rds_data_1 = require("@aws-sdk/client-rds-data");
+const params_1 = require("./params");
+const utils_1 = require("./utils");
+const query_1 = require("./query");
+const retry_1 = require("./retry");
+const transaction = (config, _args) => {
+    const args = typeof _args === 'object' ? [_args] : [{}];
+    const queries = [];
+    let rollback = () => { };
+    const txConfig = Object.assign((0, params_1.prepareParams)(config, args), {
+        database: (0, params_1.parseDatabase)(config, args),
+        hydrateColumnNames: (0, params_1.parseHydrate)(config, args),
+        formatOptions: (0, params_1.parseFormatOptions)(config, args),
+        retryOptions: config.retryOptions,
+        RDS: config.RDS,
+        engine: config.engine
+    });
+    return {
+        query: function (...args) {
+            if (typeof args[0] === 'function') {
+                queries.push(args[0]);
+            }
+            else {
+                queries.push(() => [...args]);
+            }
+            return this;
+        },
+        rollback: function (fn) {
+            if (typeof fn === 'function') {
+                rollback = fn;
+            }
+            return this;
+        },
+        commit: async function () {
+            return await (0, exports.commit)(txConfig, queries, rollback);
+        }
+    };
+};
+exports.transaction = transaction;
+const commit = async (config, queries, rollback) => {
+    const results = [];
+    const { transactionId } = await (0, retry_1.withRetry)(() => config.RDS.send(new client_rds_data_1.BeginTransactionCommand((0, utils_1.pick)(config, ['resourceArn', 'secretArn', 'database']))), config.retryOptions);
+    const txConfig = Object.assign(config, { transactionId });
+    for (let i = 0; i < queries.length; i++) {
+        const result = await query_1.query.apply({ rollback }, [config, queries[i](results[results.length - 1], results)]);
+        results.push(result);
+    }
+    const { transactionStatus } = await (0, retry_1.withRetry)(() => txConfig.RDS.send(new client_rds_data_1.CommitTransactionCommand({
+        resourceArn: txConfig.resourceArn,
+        secretArn: txConfig.secretArn,
+        transactionId: txConfig.transactionId
+    })), config.retryOptions);
+    results.push({ transactionStatus });
+    return results;
+};
+exports.commit = commit;

package/dist/types.d.ts

@@ -0,0 +1,97 @@
+import type { RDSDataClient, RDSDataClientConfig, ExecuteStatementCommandOutput, BatchExecuteStatementCommandOutput, BeginTransactionCommandInput, BeginTransactionCommandOutput, CommitTransactionCommandInput, CommitTransactionCommandOutput, RollbackTransactionCommandInput, RollbackTransactionCommandOutput, ExecuteStatementCommandInput, BatchExecuteStatementCommandInput, ColumnMetadata, ResultSetOptions } from '@aws-sdk/client-rds-data';
+export type SupportedType = 'arrayValue' | 'blobValue' | 'booleanValue' | 'doubleValue' | 'isNull' | 'longValue' | 'stringValue' | 'structValue';
+export interface RetryConfig {
+    enabled?: boolean;
+    maxRetries?: number;
+    retryableErrors?: string[];
+}
+export interface DataAPIClientConfig {
+    resourceArn: string;
+    secretArn: string;
+    database?: string;
+    engine?: 'mysql' | 'pg';
+    hydrateColumnNames?: boolean;
+    formatOptions?: FormatOptions;
+    retryOptions?: RetryConfig;
+    options?: RDSDataClientConfig;
+    client?: RDSDataClient;
+    region?: string;
+    sslEnabled?: boolean;
+    keepAlive?: boolean;
+}
+export interface FormatOptions {
+    deserializeDate?: boolean;
+    treatAsLocalDate?: boolean;
+}
+export interface InternalConfig {
+    engine: 'mysql' | 'pg';
+    secretArn: string;
+    resourceArn: string;
+    database?: string;
+    hydrateColumnNames: boolean;
+    formatOptions: Required<FormatOptions>;
+    retryOptions: Required<RetryConfig>;
+    RDS: RDSDataClient;
+    transactionId?: string;
+}
+export type ParameterValue = string | number | boolean | null | Date | Buffer | {
+    [key in SupportedType]?: any;
+};
+export interface NamedParameter {
+    name: string;
+    value: ParameterValue;
+    cast?: string;
+}
+export type Parameters = Record<string, ParameterValue> | NamedParameter[];
+export interface QueryOptions {
+    sql: string;
+    parameters?: Parameters | Parameters[];
+    database?: string;
+    schema?: string;
+    continueAfterTimeout?: boolean;
+    includeResultMetadata?: boolean;
+    hydrateColumnNames?: boolean;
+    transactionId?: string;
+    secretArn?: string;
+    resourceArn?: string;
+    resultSetOptions?: ResultSetOptions;
+    formatOptions?: FormatOptions;
+}
+export interface FormattedParameter {
+    name: string;
+    value?: {
+        [key in SupportedType]?: any;
+    };
+    typeHint?: string;
+}
+export interface SqlParamInfo {
+    type: 'n_ph' | 'n_id';
+}
+export interface QueryResult<T = any> {
+    records?: T[];
+    columnMetadata?: ColumnMetadata[];
+    numberOfRecordsUpdated?: number;
+    insertId?: number;
+    updateResults?: UpdateResult[];
+}
+export interface UpdateResult {
+    insertId?: number;
+}
+export interface Transaction {
+    query(sql: string, params?: Parameters): Transaction;
+    query(options: QueryOptions): Transaction;
+    query(fn: (lastResult: any, allResults: any[]) => [string, Parameters?]): Transaction;
+    rollback(fn: (error: Error, status: any) => void): Transaction;
+    commit(): Promise<any[]>;
+}
+export interface DataAPIClient {
+    query<T = any>(sql: string, params?: Parameters | Parameters[]): Promise<QueryResult<T>>;
+    query<T = any>(options: QueryOptions): Promise<QueryResult<T>>;
+    transaction(options?: Partial<QueryOptions>): Transaction;
+    batchExecuteStatement(args: BatchExecuteStatementCommandInput): Promise<BatchExecuteStatementCommandOutput>;
+    beginTransaction(args?: BeginTransactionCommandInput): Promise<BeginTransactionCommandOutput>;
+    commitTransaction(args: CommitTransactionCommandInput): Promise<CommitTransactionCommandOutput>;
+    executeStatement(args: ExecuteStatementCommandInput): Promise<ExecuteStatementCommandOutput>;
+    rollbackTransaction(args: RollbackTransactionCommandInput): Promise<RollbackTransactionCommandOutput>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/utils.d.ts

@@ -0,0 +1,19 @@
+import type { ParameterValue, SupportedType, SqlParamInfo } from './types';
+export declare const supportedTypes: SupportedType[];
+export declare const error: (...err: any[]) => never;
+export declare const parseSQL: (args: any[]) => string;
+export declare const omit: <T extends Record<string, any>>(obj: T, values: string[]) => Partial<T>;
+export declare const pick: <T extends Record<string, any>, K extends keyof T>(obj: T, values: K[]) => Pick<T, K>;
+export declare const flatten: <T>(arr: T[][]) => T[];
+export declare const getSqlParams: (sql: string) => Record<string, SqlParamInfo>;
+export declare const getType: (val: ParameterValue) => SupportedType | null | undefined;
+export declare const isDate: (val: any) => val is Date;
+export declare const isDateString: (val: string) => boolean;
+export declare const isTimeString: (val: string) => boolean;
+export declare const isDecimalString: (val: string) => boolean;
+export declare const isUUIDString: (val: string) => boolean;
+export declare const isJSONString: (val: string) => boolean;
+export declare const getTypeHint: (val: ParameterValue, engine?: string) => string | undefined;
+export declare const formatToTimeStamp: (date: Date, treatAsLocalDate: boolean) => string;
+export declare const formatFromTimeStamp: (value: string, treatAsLocalDate: boolean) => Date;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAG1E,eAAO,MAAM,cAAc,EAAE,aAAa,EASzC,CAAA;AAGD,eAAO,MAAM,KAAK,GAAI,GAAG,KAAK,GAAG,EAAE,KAAG,KAErC,CAAA;AAGD,eAAO,MAAM,QAAQ,GAAI,MAAM,GAAG,EAAE,KAAG,MAKI,CAAA;AAG3C,eAAO,MAAM,IAAI,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,CAAC,EAAE,QAAQ,MAAM,EAAE,KAAG,OAAO,CAAC,CAAC,CACiC,CAAA;AAGzH,eAAO,MAAM,IAAI,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,KAAK,CAAC,EAAE,QAAQ,CAAC,EAAE,KAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAInG,CAAA;AAGH,eAAO,MAAM,OAAO,GAAI,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,KAAG,CAAC,EAA+C,CAAA;AAGxF,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,KAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CA8CrE,CAAA;AAID,eAAO,MAAM,OAAO,GAAI,KAAK,cAAc,KAAG,aAAa,GAAG,IAAI,GAAG,SAsBtD,CAAA;AAKf,eAAO,MAAM,MAAM,GAAI,KAAK,GAAG,KAAG,GAAG,IAAI,IAA2B,CAAA;AAGpE,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,KAAG,OACV,CAAA;AAGjC,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,KAAG,OACE,CAAA;AAG7C,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,KAAG,OACpB,CAAA;AAG1B,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,KAAG,OACkC,CAAA;AAG7E,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,KAAG,OAU1C,CAAA;AAID,eAAO,MAAM,WAAW,GAAI,KAAK,cAAc,EAAE,SAAS,MAAM,KAAG,MAAM,GAAG,SAqC3E,CAAA;AAID,eAAO,MAAM,iBAAiB,GAAI,MAAM,IAAI,EAAE,kBAAkB,OAAO,KAAG,MAezE,CAAA;AAKD,eAAO,MAAM,mBAAmB,GAAI,OAAO,MAAM,EAAE,kBAAkB,OAAO,KAAG,IAG1D,CAAA"}

package/dist/utils.js

@@ -0,0 +1,150 @@
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatFromTimeStamp = exports.formatToTimeStamp = exports.getTypeHint = exports.isJSONString = exports.isUUIDString = exports.isDecimalString = exports.isTimeString = exports.isDateString = exports.isDate = exports.getType = exports.getSqlParams = exports.flatten = exports.pick = exports.omit = exports.parseSQL = exports.error = exports.supportedTypes = void 0;
+exports.supportedTypes = [
+    'arrayValue',
+    'blobValue',
+    'booleanValue',
+    'doubleValue',
+    'isNull',
+    'longValue',
+    'stringValue',
+    'structValue'
+];
+const error = (...err) => {
+    throw Error(...err);
+};
+exports.error = error;
+const parseSQL = (args) => typeof args[0] === 'string'
+    ? args[0]
+    : typeof args[0] === 'object' && typeof args[0].sql === 'string'
+        ? args[0].sql
+        : (0, exports.error)(`No 'sql' statement provided.`);
+exports.parseSQL = parseSQL;
+const omit = (obj, values) => Object.keys(obj).reduce((acc, x) => (values.includes(x) ? acc : Object.assign(acc, { [x]: obj[x] })), {});
+exports.omit = omit;
+const pick = (obj, values) => Object.keys(obj).reduce((acc, x) => (values.includes(x) ? Object.assign(acc, { [x]: obj[x] }) : acc), {});
+exports.pick = pick;
+const flatten = (arr) => arr.reduce((acc, x) => acc.concat(x), []);
+exports.flatten = flatten;
+const getSqlParams = (sql) => {
+    const matches = [];
+    const regex = /:{1,2}\w+/g;
+    let match;
+    while ((match = regex.exec(sql)) !== null) {
+        const matchedText = match[0];
+        const matchIndex = match.index;
+        if (matchedText.startsWith('::')) {
+            const beforeMatch = sql.substring(Math.max(0, matchIndex - 20), matchIndex);
+            const hasParamBefore = /:\w+$/.test(beforeMatch);
+            if (!hasParamBefore) {
+                matches.push(matchedText);
+            }
+        }
+        else {
+            matches.push(matchedText);
+        }
+    }
+    return matches
+        .map((p) => {
+        return p.startsWith('::')
+            ? { type: 'n_id', label: p.substr(2) }
+            : { type: 'n_ph', label: p.substr(1) };
+    })
+        .reduce((acc, x) => {
+        return Object.assign(acc, {
+            [x.label]: {
+                type: x.type
+            }
+        });
+    }, {});
+};
+exports.getSqlParams = getSqlParams;
+const getType = (val) => typeof val === 'string'
+    ? 'stringValue'
+    : typeof val === 'boolean'
+        ? 'booleanValue'
+        : typeof val === 'number' && parseInt(val.toString()) === val
+            ? 'longValue'
+            : typeof val === 'number' && parseFloat(val.toString()) === val
+                ? 'doubleValue'
+                : val === null
+                    ? 'isNull'
+                    : (0, exports.isDate)(val)
+                        ? 'stringValue'
+                        : Buffer.isBuffer(val)
+                            ? 'blobValue'
+                            :
+                                typeof val === 'object' &&
+                                    val !== null &&
+                                    Object.keys(val).length === 1 &&
+                                    exports.supportedTypes.includes(Object.keys(val)[0])
+                                    ? null
+                                    : undefined;
+exports.getType = getType;
+const isDate = (val) => val instanceof Date;
+exports.isDate = isDate;
+const isDateString = (val) => /^\d{4}-\d{2}-\d{2}$/.test(val);
+exports.isDateString = isDateString;
+const isTimeString = (val) => /^\d{2}:\d{2}:\d{2}(\.\d{1,3})?$/.test(val);
+exports.isTimeString = isTimeString;
+const isDecimalString = (val) => /^-?\d+\.\d+$/.test(val);
+exports.isDecimalString = isDecimalString;
+const isUUIDString = (val) => /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(val);
+exports.isUUIDString = isUUIDString;
+const isJSONString = (val) => {
+    if (typeof val !== 'string')
+        return false;
+    const trimmed = val.trim();
+    if (!trimmed.startsWith('{') && !trimmed.startsWith('['))
+        return false;
+    try {
+        const parsed = JSON.parse(val);
+        return typeof parsed === 'object' && parsed !== null;
+    }
+    catch (_a) {
+        return false;
+    }
+};
+exports.isJSONString = isJSONString;
+const getTypeHint = (val, engine) => {
+    if ((0, exports.isDate)(val)) {
+        return 'TIMESTAMP';
+    }
+    if (typeof val === 'string') {
+        if ((0, exports.isUUIDString)(val) && engine !== 'mysql') {
+            return 'UUID';
+        }
+        if ((0, exports.isDateString)(val)) {
+            return 'DATE';
+        }
+        if ((0, exports.isTimeString)(val)) {
+            return 'TIME';
+        }
+        if ((0, exports.isJSONString)(val) && engine !== 'mysql') {
+            return 'JSON';
+        }
+        if ((0, exports.isDecimalString)(val)) {
+            return 'DECIMAL';
+        }
+    }
+    return undefined;
+};
+exports.getTypeHint = getTypeHint;
+const formatToTimeStamp = (date, treatAsLocalDate) => {
+    const pad = (val, num = 2) => '0'.repeat(num - (val + '').length) + val;
+    const year = treatAsLocalDate ? date.getFullYear() : date.getUTCFullYear();
+    const month = (treatAsLocalDate ? date.getMonth() : date.getUTCMonth()) + 1;
+    const day = treatAsLocalDate ? date.getDate() : date.getUTCDate();
+    const hours = treatAsLocalDate ? date.getHours() : date.getUTCHours();
+    const minutes = treatAsLocalDate ? date.getMinutes() : date.getUTCMinutes();
+    const seconds = treatAsLocalDate ? date.getSeconds() : date.getUTCSeconds();
+    const ms = treatAsLocalDate ? date.getMilliseconds() : date.getUTCMilliseconds();
+    const fraction = ms <= 0 ? '' : `.${pad(ms, 3)}`;
+    return `${year}-${pad(month)}-${pad(day)} ${pad(hours)}:${pad(minutes)}:${pad(seconds)}${fraction}`;
+};
+exports.formatToTimeStamp = formatToTimeStamp;
+const formatFromTimeStamp = (value, treatAsLocalDate) => !treatAsLocalDate && /^\d{4}-\d{2}-\d{2}(\s\d{2}:\d{2}:\d{2}(\.\d+)?)?$/.test(value)
+    ? new Date(value + 'Z')
+    : new Date(value);
+exports.formatFromTimeStamp = formatFromTimeStamp;

package/package.json

@@ -1,12 +1,58 @@
 {
   "name": "data-api-client",
-  "version": "2.0.0-beta.0",
+  "version": "2.1.0",
   "description": "A lightweight wrapper that simplifies working with the Amazon Aurora Serverless Data API",
-  "main": "index.js",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    },
+    "./compat/pg": {
+      "types": "./dist/compat/pg.d.ts",
+      "import": "./dist/compat/pg.js",
+      "require": "./dist/compat/pg.js"
+    },
+    "./compat/mysql2": {
+      "types": "./dist/compat/mysql2.d.ts",
+      "import": "./dist/compat/mysql2.js",
+      "require": "./dist/compat/mysql2.js"
+    },
+    "./compat": {
+      "types": "./dist/compat/index.d.ts",
+      "import": "./dist/compat/index.js",
+      "require": "./dist/compat/index.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js",
+      "require": "./dist/types.js"
+    }
+  },
   "scripts": {
-    "test": "jest",
-    "test-ci": "eslint . && jest",
-    "lint": "eslint ."
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "prebuild": "rm -rf dist",
+    "test": "npm run build && vitest run src/",
+    "test:unit": "npm run build && vitest run src/",
+    "test:int:core": "npm run build && vitest run integration-tests/mysql.int.test.ts integration-tests/pg-compat.int.test.ts",
+    "test:int:core:mysql": "npm run build && vitest run integration-tests/mysql.int.test.ts",
+    "test:int:core:pg": "npm run build && vitest run integration-tests/postgres.int.test.ts",
+    "test:int:compat": "npm run build && vitest run integration-tests/pg-compat.int.test.ts integration-tests/mysql2-compat.int.test.ts",
+    "test:int:compat:pg": "npm run build && vitest run integration-tests/pg-compat.int.test.ts",
+    "test:int:compat:mysql": "npm run build && vitest run integration-tests/mysql2-compat.int.test.ts",
+    "test:int:orm:kysely": "npm run build && vitest run integration-tests/kysely-pg.int.test.ts integration-tests/kysely-mysql.int.test.ts",
+    "test:int:orm:kysely:pg": "npm run build && vitest run integration-tests/kysely-pg.int.test.ts",
+    "test:int:orm:kysely:mysql": "npm run build && vitest run integration-tests/kysely-mysql.int.test.ts",
+    "test:int:orm:drizzle": "npm run build && vitest run integration-tests/drizzle-pg.int.test.ts && vitest run integration-tests/drizzle-mysql.int.test.ts",
+    "test:int:orm:drizzle:pg": "npm run build && vitest run integration-tests/drizzle-pg.int.test.ts",
+    "test:int:orm:drizzle:mysql": "npm run build && vitest run integration-tests/drizzle-mysql.int.test.ts",
+    "test:int:orm:knex": "npm run build && vitest run integration-tests/knex-mysql.int.test.ts",
+    "test-ci": "npm run build && eslint src && vitest run src/",
+    "lint": "eslint src",
+    "prepublishOnly": "npm run build"
   },
   "repository": {
     "type": "git",
@@ -24,17 +70,42 @@
     "url": "https://github.com/jeremydaly/data-api-client/issues"
   },
   "homepage": "https://github.com/jeremydaly/data-api-client#readme",
+  "imports": {
+    "#fixtures/*": "./fixtures/*"
+  },
   "devDependencies": {
+    "@aws-sdk/client-rds-data": "^3.712.0",
+    "@types/node": "^24.6.2",
+    "@types/pg": "^8.15.5",
+    "@types/pg-escape": "^0.2.3",
+    "@types/sqlstring": "^2.3.2",
+    "@typescript-eslint/eslint-plugin": "^8.45.0",
+    "@typescript-eslint/parser": "^8.45.0",
+    "@vitest/ui": "^3.2.4",
+    "drizzle-orm": "^0.44.6",
     "eslint": "^8.12.0",
     "eslint-config-prettier": "^8.5.0",
-    "jest": "^27.5.1",
-    "rewire": "^6.0.0"
+    "knex": "^3.1.0",
+    "kysely": "^0.28.7",
+    "pg": "^8.16.3",
+    "prettier": "^2.6.2",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
   },
   "dependencies": {
-    "@aws-sdk/client-rds-data": "^3.58.0",
+    "pg-escape": "^0.2.0",
     "sqlstring": "^2.3.2"
   },
+  "peerDependencies": {
+    "@aws-sdk/client-rds-data": "^3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@aws-sdk/client-rds-data": {
+      "optional": true
+    }
+  },
   "files": [
-    "index.js"
+    "dist"
   ]
 }