data-api-client 1.3.1 → 2.0.0

package/dist/client.d.ts

@@ -0,0 +1,3 @@
+import type { DataAPIClientConfig, DataAPIClient } from './types';
+export declare const init: (params: DataAPIClientConfig) => DataAPIClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,mBAAmB,EAAkB,aAAa,EAA6B,MAAM,SAAS,CAAA;AAyB5G,eAAO,MAAM,IAAI,GAAI,QAAQ,mBAAmB,KAAG,aAkHlD,CAAA"}

package/dist/client.js

@@ -0,0 +1,69 @@
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.init = void 0;
+const client_rds_data_1 = require("@aws-sdk/client-rds-data");
+const utils_1 = require("./utils");
+const query_1 = require("./query");
+const transaction_1 = require("./transaction");
+const init = (params) => {
+    const options = typeof params.options === 'object'
+        ? params.options
+        : params.options !== undefined
+            ? (0, utils_1.error)(`'options' must be an object`)
+            : {};
+    if (typeof params.region === 'string') {
+        options.region = params.region;
+    }
+    if (params.sslEnabled === false) {
+        console.warn('sslEnabled is deprecated. For local development, set options.endpoint instead.');
+    }
+    const config = {
+        engine: typeof params.engine === 'string' ? params.engine : 'pg',
+        secretArn: typeof params.secretArn === 'string' ? params.secretArn : (0, utils_1.error)(`'secretArn' string value required`),
+        resourceArn: typeof params.resourceArn === 'string' ? params.resourceArn : (0, utils_1.error)(`'resourceArn' string value required`),
+        database: typeof params.database === 'string'
+            ? params.database
+            : params.database !== undefined
+                ? (0, utils_1.error)(`'database' must be a string`)
+                : undefined,
+        hydrateColumnNames: typeof params.hydrateColumnNames === 'boolean' ? params.hydrateColumnNames : true,
+        formatOptions: {
+            deserializeDate: typeof params.formatOptions === 'object' && params.formatOptions.deserializeDate === false ? false : true,
+            treatAsLocalDate: typeof params.formatOptions === 'object' && params.formatOptions.treatAsLocalDate ? true : false
+        },
+        RDS: params.client ? params.client : new client_rds_data_1.RDSDataClient(options)
+    };
+    return {
+        query: (...x) => query_1.query.call(undefined, config, ...x),
+        transaction: (x) => (0, transaction_1.transaction)(config, x),
+        batchExecuteStatement: async (args) => config.RDS.send(new client_rds_data_1.BatchExecuteStatementCommand({
+            ...args,
+            resourceArn: args.resourceArn || config.resourceArn,
+            secretArn: args.secretArn || config.secretArn,
+            database: args.database || config.database
+        })),
+        beginTransaction: async (args) => config.RDS.send(new client_rds_data_1.BeginTransactionCommand({
+            ...(args || {}),
+            resourceArn: (args === null || args === void 0 ? void 0 : args.resourceArn) || config.resourceArn,
+            secretArn: (args === null || args === void 0 ? void 0 : args.secretArn) || config.secretArn,
+            database: (args === null || args === void 0 ? void 0 : args.database) || config.database
+        })),
+        commitTransaction: async (args) => config.RDS.send(new client_rds_data_1.CommitTransactionCommand({
+            ...args,
+            resourceArn: args.resourceArn || config.resourceArn,
+            secretArn: args.secretArn || config.secretArn
+        })),
+        executeStatement: async (args) => config.RDS.send(new client_rds_data_1.ExecuteStatementCommand({
+            ...args,
+            resourceArn: args.resourceArn || config.resourceArn,
+            secretArn: args.secretArn || config.secretArn,
+            database: args.database || config.database
+        })),
+        rollbackTransaction: async (args) => config.RDS.send(new client_rds_data_1.RollbackTransactionCommand({
+            ...args,
+            resourceArn: args.resourceArn || config.resourceArn,
+            secretArn: args.secretArn || config.secretArn
+        }))
+    };
+};
+exports.init = init;

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import { init } from './client';
+export = init;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAA;AAC/B,SAAS,IAAI,CAAA"}

package/dist/index.js

@@ -0,0 +1,3 @@
+'use strict';
+const client_1 = require("./client");
+module.exports = client_1.init;

package/dist/params.d.ts

@@ -0,0 +1,19 @@
+import type { InternalConfig, Parameters, ParameterValue, NamedParameter, FormattedParameter, SqlParamInfo, FormatOptions, SupportedType } from './types';
+export declare const parseParams: (args: any[]) => Parameters[];
+export declare const parseDatabase: (config: InternalConfig, args: any[]) => string | undefined;
+export declare const parseHydrate: (config: InternalConfig, args: any[]) => boolean;
+export declare const parseFormatOptions: (config: InternalConfig, args: any[]) => Required<FormatOptions>;
+export declare const prepareParams: ({ secretArn, resourceArn }: InternalConfig, args: any[]) => {
+    secretArn: string;
+    resourceArn: string;
+    [key: string]: any;
+};
+export declare const normalizeParams: (params: Parameters[]) => (NamedParameter | NamedParameter[])[];
+export declare const processParams: (engine: string, sql: string, sqlParams: Record<string, SqlParamInfo>, params: (NamedParameter | NamedParameter[])[], formatOptions: Required<FormatOptions>, row?: number) => {
+    processedParams: (FormattedParameter | FormattedParameter[])[];
+    escapedSql: string;
+};
+export declare const formatParam: (n: string, v: ParameterValue, formatOptions: Required<FormatOptions>) => FormattedParameter;
+export declare const splitParams: (p: Record<string, ParameterValue>) => NamedParameter[];
+export declare const formatType: (name: string, value: ParameterValue, type: SupportedType | null | undefined, typeHint: string | undefined, formatOptions: Required<FormatOptions>) => FormattedParameter;
+//# sourceMappingURL=params.d.ts.map

package/dist/params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.d.ts","sourceRoot":"","sources":["../src/params.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,cAAc,EACd,UAAU,EACV,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,aAAa,EACd,MAAM,SAAS,CAAA;AAIhB,eAAO,MAAM,WAAW,GAAI,MAAM,GAAG,EAAE,KAAG,UAAU,EAa5C,CAAA;AAGR,eAAO,MAAM,aAAa,GAAI,QAAQ,cAAc,EAAE,MAAM,GAAG,EAAE,KAAG,MAAM,GAAG,SAS9D,CAAA;AAGf,eAAO,MAAM,YAAY,GAAI,QAAQ,cAAc,EAAE,MAAM,GAAG,EAAE,KAAG,OAKpC,CAAA;AAG/B,eAAO,MAAM,kBAAkB,GAAI,QAAQ,cAAc,EAAE,MAAM,GAAG,EAAE,KAAG,QAAQ,CAAC,aAAa,CAkBrE,CAAA;AAG1B,eAAO,MAAM,aAAa,GACxB,4BAA4B,cAAc,EAC1C,MAAM,GAAG,EAAE,KACV;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAK9D,CAAA;AAOD,eAAO,MAAM,eAAe,GAAI,QAAQ,UAAU,EAAE,KAAG,CAAC,cAAc,GAAG,cAAc,EAAE,CAAC,EAavF,CAAA;AAGH,eAAO,MAAM,aAAa,GACxB,QAAQ,MAAM,EACd,KAAK,MAAM,EACX,WAAW,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,EACvC,QAAQ,CAAC,cAAc,GAAG,cAAc,EAAE,CAAC,EAAE,EAC7C,eAAe,QAAQ,CAAC,aAAa,CAAC,EACtC,MAAK,MAAU,KACd;IAAE,eAAe,EAAE,CAAC,kBAAkB,GAAG,kBAAkB,EAAE,CAAC,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAgCtF,CAAA;AAGD,eAAO,MAAM,WAAW,GAAI,GAAG,MAAM,EAAE,GAAG,cAAc,EAAE,eAAe,QAAQ,CAAC,aAAa,CAAC,KAAG,kBACtC,CAAA;AAG7D,eAAO,MAAM,WAAW,GAAI,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,KAAG,cAAc,EACiB,CAAA;AAG/F,eAAO,MAAM,UAAU,GACrB,MAAM,MAAM,EACZ,OAAO,cAAc,EACrB,MAAM,aAAa,GAAG,IAAI,GAAG,SAAS,EACtC,UAAU,MAAM,GAAG,SAAS,EAC5B,eAAe,QAAQ,CAAC,aAAa,CAAC,KACrC,kBAgBF,CAAA"}

package/dist/params.js

@@ -0,0 +1,125 @@
+'use strict';
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatType = exports.splitParams = exports.formatParam = exports.processParams = exports.normalizeParams = exports.prepareParams = exports.parseFormatOptions = exports.parseHydrate = exports.parseDatabase = exports.parseParams = void 0;
+const sqlstring_1 = __importDefault(require("sqlstring"));
+const pg_escape_1 = __importDefault(require("pg-escape"));
+const utils_1 = require("./utils");
+const parseParams = (args) => Array.isArray(args[0].parameters)
+    ? args[0].parameters
+    : typeof args[0].parameters === 'object'
+        ? [args[0].parameters]
+        : Array.isArray(args[1])
+            ? args[1]
+            : typeof args[1] === 'object'
+                ? [args[1]]
+                : args[0].parameters
+                    ? (0, utils_1.error)(`'parameters' must be an object or array`)
+                    : args[1]
+                        ? (0, utils_1.error)('Parameters must be an object or array')
+                        : [];
+exports.parseParams = parseParams;
+const parseDatabase = (config, args) => config.transactionId
+    ? config.database
+    : typeof args[0].database === 'string'
+        ? args[0].database
+        : args[0].database
+            ? (0, utils_1.error)(`'database' must be a string.`)
+            : config.database
+                ? config.database
+                : undefined;
+exports.parseDatabase = parseDatabase;
+const parseHydrate = (config, args) => typeof args[0].hydrateColumnNames === 'boolean'
+    ? args[0].hydrateColumnNames
+    : args[0].hydrateColumnNames
+        ? (0, utils_1.error)(`'hydrateColumnNames' must be a boolean.`)
+        : config.hydrateColumnNames;
+exports.parseHydrate = parseHydrate;
+const parseFormatOptions = (config, args) => typeof args[0].formatOptions === 'object'
+    ? {
+        deserializeDate: typeof args[0].formatOptions.deserializeDate === 'boolean'
+            ? args[0].formatOptions.deserializeDate
+            : args[0].formatOptions.deserializeDate
+                ? (0, utils_1.error)(`'formatOptions.deserializeDate' must be a boolean.`)
+                : config.formatOptions.deserializeDate,
+        treatAsLocalDate: typeof args[0].formatOptions.treatAsLocalDate == 'boolean'
+            ? args[0].formatOptions.treatAsLocalDate
+            : args[0].formatOptions.treatAsLocalDate
+                ? (0, utils_1.error)(`'formatOptions.treatAsLocalDate' must be a boolean.`)
+                : config.formatOptions.treatAsLocalDate
+    }
+    : args[0].formatOptions
+        ? (0, utils_1.error)(`'formatOptions' must be an object.`)
+        : config.formatOptions;
+exports.parseFormatOptions = parseFormatOptions;
+const prepareParams = ({ secretArn, resourceArn }, args) => {
+    return Object.assign({ secretArn, resourceArn }, typeof args[0] === 'object' ? omit(args[0], ['hydrateColumnNames', 'parameters']) : {});
+};
+exports.prepareParams = prepareParams;
+const omit = (obj, values) => Object.keys(obj).reduce((acc, x) => (values.includes(x) ? acc : Object.assign(acc, { [x]: obj[x] })), {});
+const normalizeParams = (params) => params.reduce((acc, p) => Array.isArray(p)
+    ? acc.concat([(0, exports.normalizeParams)(p)])
+    : (Object.keys(p).length === 2 && 'name' in p && typeof p.value !== 'undefined') ||
+        (Object.keys(p).length === 3 &&
+            'name' in p &&
+            typeof p.value !== 'undefined' &&
+            'cast' in p)
+        ? acc.concat(p)
+        : acc.concat(...(0, exports.splitParams)(p)), []);
+exports.normalizeParams = normalizeParams;
+const processParams = (engine, sql, sqlParams, params, formatOptions, row = 0) => {
+    return {
+        processedParams: params.reduce((acc, p) => {
+            if (Array.isArray(p)) {
+                const result = (0, exports.processParams)(engine, sql, sqlParams, p, formatOptions, row);
+                if (row === 0) {
+                    sql = result.escapedSql;
+                    row++;
+                }
+                return acc.concat([result.processedParams]);
+            }
+            else if (sqlParams[p.name]) {
+                if (sqlParams[p.name].type === 'n_ph') {
+                    if (p.cast) {
+                        const regex = new RegExp(':' + p.name + '\\b', 'g');
+                        sql = sql.replace(regex, engine === 'pg' ? `:${p.name}::${p.cast}` : `CAST(:${p.name} AS ${p.cast})`);
+                    }
+                    acc.push((0, exports.formatParam)(p.name, p.value, formatOptions));
+                }
+                else if (row === 0) {
+                    const regex = new RegExp('::' + p.name + '\\b', 'g');
+                    const escapedId = engine === 'pg'
+                        ? pg_escape_1.default.ident(p.value)
+                        : sqlstring_1.default.escapeId(p.value);
+                    sql = sql.replace(regex, escapedId);
+                }
+                return acc;
+            }
+            else {
+                return acc;
+            }
+        }, []),
+        escapedSql: sql
+    };
+};
+exports.processParams = processParams;
+const formatParam = (n, v, formatOptions) => (0, exports.formatType)(n, v, (0, utils_1.getType)(v), (0, utils_1.getTypeHint)(v), formatOptions);
+exports.formatParam = formatParam;
+const splitParams = (p) => Object.keys(p).reduce((arr, x) => arr.concat({ name: x, value: p[x] }), []);
+exports.splitParams = splitParams;
+const formatType = (name, value, type, typeHint, formatOptions) => {
+    return Object.assign(typeHint != null ? { name, typeHint } : { name }, type === null
+        ? { value }
+        : {
+            value: {
+                [type ? type : (0, utils_1.error)(`'${name}' is an invalid type`)]: type === 'isNull'
+                    ? true
+                    : (0, utils_1.isDate)(value)
+                        ? (0, utils_1.formatToTimeStamp)(value, formatOptions && formatOptions.treatAsLocalDate)
+                        : value
+            }
+        });
+};
+exports.formatType = formatType;

package/dist/query.d.ts

@@ -0,0 +1,5 @@
+import type { InternalConfig, QueryResult } from './types';
+export declare const query: (this: {
+    rollback?: (err: Error, status: any) => void;
+} | undefined, config: InternalConfig, ..._args: any[]) => Promise<QueryResult>;
+//# sourceMappingURL=query.d.ts.map

package/dist/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAc1D,eAAO,MAAM,KAAK,GAChB,MAAM;IAAE,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,KAAK,IAAI,CAAA;CAAE,GAAG,SAAS,EAClE,QAAQ,cAAc,EACtB,GAAG,OAAO,GAAG,EAAE,KACd,OAAO,CAAC,WAAW,CAgErB,CAAA"}

package/dist/query.js

@@ -0,0 +1,38 @@
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.query = void 0;
+const client_rds_data_1 = require("@aws-sdk/client-rds-data");
+const utils_1 = require("./utils");
+const params_1 = require("./params");
+const results_1 = require("./results");
+const query = async function (config, ..._args) {
+    const args = Array.isArray(_args[0]) ? (0, utils_1.flatten)(_args) : _args;
+    const sql = (0, utils_1.parseSQL)(args);
+    const sqlParams = (0, utils_1.getSqlParams)(sql);
+    const hydrateColumnNames = (0, params_1.parseHydrate)(config, args);
+    const formatOptions = (0, params_1.parseFormatOptions)(config, args);
+    const parameters = (0, params_1.normalizeParams)((0, params_1.parseParams)(args));
+    const { processedParams, escapedSql } = (0, params_1.processParams)(config.engine, sql, sqlParams, parameters, formatOptions);
+    const isBatch = processedParams.length > 0 && Array.isArray(processedParams[0]);
+    const params = Object.assign((0, params_1.prepareParams)(config, args), {
+        database: (0, params_1.parseDatabase)(config, args),
+        sql: escapedSql
+    }, processedParams.length > 0
+        ?
+            { [isBatch ? 'parameterSets' : 'parameters']: processedParams }
+        : {}, hydrateColumnNames && !isBatch ? { includeResultMetadata: true } : {}, config.transactionId ? { transactionId: config.transactionId } : {});
+    try {
+        const result = await (isBatch
+            ? config.RDS.send(new client_rds_data_1.BatchExecuteStatementCommand(params))
+            : config.RDS.send(new client_rds_data_1.ExecuteStatementCommand(params)));
+        return (0, results_1.formatResults)(result, hydrateColumnNames, args[0].includeResultMetadata === true, formatOptions);
+    }
+    catch (e) {
+        if (this && this.rollback) {
+            const rollback = await config.RDS.send(new client_rds_data_1.RollbackTransactionCommand((0, utils_1.pick)(params, ['resourceArn', 'secretArn', 'transactionId'])));
+            this.rollback(e, rollback);
+        }
+        throw e;
+    }
+};
+exports.query = query;

package/dist/results.d.ts

@@ -0,0 +1,12 @@
+import type { ExecuteStatementCommandOutput, BatchExecuteStatementCommandOutput, Field } from '@aws-sdk/client-rds-data';
+import type { QueryResult, UpdateResult, FormatOptions } from './types';
+export declare const formatResults: (result: ExecuteStatementCommandOutput | BatchExecuteStatementCommandOutput, hydrate: boolean, includeMeta: boolean, formatOptions: Required<FormatOptions>) => QueryResult;
+export declare const formatRecords: (recs: Field[][] | undefined, columns: {
+    label?: string;
+    typeName?: string;
+}[] | undefined, hydrate: boolean, formatOptions: Required<FormatOptions>) => any[];
+export declare const formatRecordValue: (value: any, typeName: string | undefined, formatOptions: Required<FormatOptions>) => any;
+export declare const formatUpdateResults: (res: {
+    generatedFields?: Field[];
+}[]) => UpdateResult[];
+//# sourceMappingURL=results.d.ts.map

package/dist/results.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"results.d.ts","sourceRoot":"","sources":["../src/results.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,6BAA6B,EAAE,kCAAkC,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAA;AACxH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAIvE,eAAO,MAAM,aAAa,GACxB,QAAQ,6BAA6B,GAAG,kCAAkC,EAC1E,SAAS,OAAO,EAChB,aAAa,OAAO,EACpB,eAAe,QAAQ,CAAC,aAAa,CAAC,KACrC,WAuBF,CAAA;AAID,eAAO,MAAM,aAAa,GACxB,MAAM,KAAK,EAAE,EAAE,GAAG,SAAS,EAC3B,SAAS;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,SAAS,EAC5D,SAAS,OAAO,EAChB,eAAe,QAAQ,CAAC,aAAa,CAAC,KACrC,GAAG,EAsDL,CAAA;AAsBD,eAAO,MAAM,iBAAiB,GAC5B,OAAO,GAAG,EACV,UAAU,MAAM,GAAG,SAAS,EAC5B,eAAe,QAAQ,CAAC,aAAa,CAAC,KACrC,GAmCF,CAAA;AAGD,eAAO,MAAM,mBAAmB,GAAI,KAAK;IAAE,eAAe,CAAC,EAAE,KAAK,EAAE,CAAA;CAAE,EAAE,KAAG,YAAY,EAGnF,CAAA"}

package/dist/results.js

@@ -0,0 +1,93 @@
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatUpdateResults = exports.formatRecordValue = exports.formatRecords = exports.formatResults = void 0;
+const utils_1 = require("./utils");
+const formatResults = (result, hydrate, includeMeta, formatOptions) => {
+    const { columnMetadata, numberOfRecordsUpdated, records, generatedFields, updateResults } = result;
+    return Object.assign(includeMeta ? { columnMetadata } : {}, numberOfRecordsUpdated !== undefined && !records ? { numberOfRecordsUpdated } : {}, records
+        ? {
+            records: (0, exports.formatRecords)(records, columnMetadata, hydrate, formatOptions)
+        }
+        : {}, updateResults ? { updateResults: (0, exports.formatUpdateResults)(updateResults) } : {}, generatedFields && generatedFields.length > 0 ? { insertId: generatedFields[0].longValue } : {});
+};
+exports.formatResults = formatResults;
+const formatRecords = (recs, columns, hydrate, formatOptions) => {
+    const fmap = recs && recs[0]
+        ? recs[0].map((_field, i) => {
+            return Object.assign({}, columns ? { label: columns[i].label, typeName: columns[i].typeName } : {});
+        })
+        : [];
+    return recs
+        ? recs.map((rec) => {
+            return rec.reduce((acc, field, i) => {
+                if (field.isNull === true) {
+                    return hydrate
+                        ? Object.assign(acc, { [fmap[i].label]: null })
+                        : acc.concat(null);
+                }
+                else if (fmap[i] && fmap[i].field) {
+                    const value = (0, exports.formatRecordValue)(field[fmap[i].field], fmap[i].typeName, formatOptions);
+                    return hydrate
+                        ? Object.assign(acc, { [fmap[i].label]: value })
+                        : acc.concat(value);
+                }
+                else {
+                    Object.keys(field).map((type) => {
+                        if (type !== 'isNull' && field[type] !== null) {
+                            fmap[i]['field'] = type;
+                        }
+                    });
+                    const value = (0, exports.formatRecordValue)(field[fmap[i].field], fmap[i].typeName, formatOptions);
+                    return hydrate
+                        ? Object.assign(acc, { [fmap[i].label]: value })
+                        : acc.concat(value);
+                }
+            }, hydrate ? {} : []);
+        })
+        : [];
+};
+exports.formatRecords = formatRecords;
+const flattenArrayValue = (arrayValue) => {
+    if (!arrayValue)
+        return [];
+    if (arrayValue.stringValues)
+        return arrayValue.stringValues.slice();
+    if (arrayValue.longValues)
+        return arrayValue.longValues.slice();
+    if (arrayValue.doubleValues)
+        return arrayValue.doubleValues.slice();
+    if (arrayValue.booleanValues)
+        return arrayValue.booleanValues.slice();
+    if (arrayValue.arrayValues) {
+        return arrayValue.arrayValues.map((nested) => flattenArrayValue(nested.arrayValue || nested));
+    }
+    return [];
+};
+const formatRecordValue = (value, typeName, formatOptions) => {
+    if (value instanceof Uint8Array) {
+        return Buffer.from(value);
+    }
+    if (value && typeof value === 'object' && typeName && typeName.startsWith('_')) {
+        return flattenArrayValue(value);
+    }
+    if (formatOptions &&
+        formatOptions.deserializeDate &&
+        typeName &&
+        ['DATE', 'DATETIME', 'TIMESTAMP', 'TIMESTAMPTZ', 'TIMESTAMP WITH TIME ZONE'].includes(typeName.toUpperCase())) {
+        return (0, utils_1.formatFromTimeStamp)(value, (formatOptions && formatOptions.treatAsLocalDate) || typeName === 'TIMESTAMP WITH TIME ZONE');
+    }
+    else if (typeName === 'JSON') {
+        return JSON.parse(value);
+    }
+    else if (typeName === 'YEAR') {
+        return typeof value === 'string' ? parseInt(value, 10) : value;
+    }
+    else {
+        return value;
+    }
+};
+exports.formatRecordValue = formatRecordValue;
+const formatUpdateResults = (res) => res.map((x) => {
+    return x.generatedFields && x.generatedFields.length > 0 ? { insertId: x.generatedFields[0].longValue } : {};
+});
+exports.formatUpdateResults = formatUpdateResults;

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;AAMxE,eAAO,MAAM,WAAW,GAAI,QAAQ,cAAc,EAAE,QAAQ,OAAO,CAAC,YAAY,CAAC,KAAG,WAgCnF,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,CAiCf,CAAA"}

package/dist/transaction.js

@@ -0,0 +1,57 @@
+'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 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),
+        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 config.RDS.send(new client_rds_data_1.BeginTransactionCommand((0, utils_1.pick)(config, ['resourceArn', 'secretArn', 'database'])));
+    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 txConfig.RDS.send(new client_rds_data_1.CommitTransactionCommand({
+        resourceArn: txConfig.resourceArn,
+        secretArn: txConfig.secretArn,
+        transactionId: txConfig.transactionId
+    }));
+    results.push({ transactionStatus });
+    return results;
+};
+exports.commit = commit;

package/dist/types.d.ts

@@ -0,0 +1,90 @@
+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 DataAPIClientConfig {
+    resourceArn: string;
+    secretArn: string;
+    database?: string;
+    engine?: 'mysql' | 'pg';
+    hydrateColumnNames?: boolean;
+    formatOptions?: FormatOptions;
+    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>;
+    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":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,6BAA6B,EAC7B,kCAAkC,EAClC,4BAA4B,EAC5B,6BAA6B,EAC7B,6BAA6B,EAC7B,8BAA8B,EAC9B,+BAA+B,EAC/B,gCAAgC,EAChC,4BAA4B,EAC5B,iCAAiC,EACjC,cAAc,EACd,gBAAgB,EACjB,MAAM,0BAA0B,CAAA;AAGjC,MAAM,MAAM,aAAa,GACrB,YAAY,GACZ,WAAW,GACX,cAAc,GACd,aAAa,GACb,QAAQ,GACR,WAAW,GACX,aAAa,GACb,aAAa,CAAA;AAGjB,MAAM,WAAW,mBAAmB;IAElC,WAAW,EAAE,MAAM,CAAA;IAEnB,SAAS,EAAE,MAAM,CAAA;IAEjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IAEvB,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAE5B,aAAa,CAAC,EAAE,aAAa,CAAA;IAE7B,OAAO,CAAC,EAAE,mBAAmB,CAAA;IAE7B,MAAM,CAAC,EAAE,aAAa,CAAA;IAEtB,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf,UAAU,CAAC,EAAE,OAAO,CAAA;IAEpB,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAGD,MAAM,WAAW,aAAa;IAE5B,eAAe,CAAC,EAAE,OAAO,CAAA;IAEzB,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAGD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,OAAO,GAAG,IAAI,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,kBAAkB,EAAE,OAAO,CAAA;IAC3B,aAAa,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAA;IACtC,GAAG,EAAE,aAAa,CAAA;IAClB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAGD,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,IAAI,GACJ,MAAM,GACN;KAAG,GAAG,IAAI,aAAa,CAAC,CAAC,EAAE,GAAG;CAAE,CAAA;AAGpC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,cAAc,CAAA;IACrB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAGD,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,cAAc,EAAE,CAAA;AAG1E,MAAM,WAAW,YAAY;IAE3B,GAAG,EAAE,MAAM,CAAA;IAEX,UAAU,CAAC,EAAE,UAAU,GAAG,UAAU,EAAE,CAAA;IAEtC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAE9B,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAE/B,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAE5B,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IAEnC,aAAa,CAAC,EAAE,aAAa,CAAA;CAC9B;AAGD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE;SACL,GAAG,IAAI,aAAa,CAAC,CAAC,EAAE,GAAG;KAC7B,CAAA;IACD,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAGD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;CACtB;AAGD,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,GAAG;IAClC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAA;IACb,cAAc,CAAC,EAAE,cAAc,EAAE,CAAA;IACjC,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,YAAY,EAAE,CAAA;CAC/B;AAGD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAGD,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,WAAW,CAAA;IACpD,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW,CAAA;IACzC,KAAK,CAAC,EAAE,EAAE,CAAC,UAAU,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,GAAG,WAAW,CAAA;IACrF,QAAQ,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,KAAK,IAAI,GAAG,WAAW,CAAA;IAC9D,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;CACzB;AAGD,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,UAAU,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAA;IACxF,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAA;IAC9D,WAAW,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,WAAW,CAAA;IACzD,qBAAqB,CAAC,IAAI,EAAE,iCAAiC,GAAG,OAAO,CAAC,kCAAkC,CAAC,CAAA;IAC3G,gBAAgB,CAAC,IAAI,CAAC,EAAE,4BAA4B,GAAG,OAAO,CAAC,6BAA6B,CAAC,CAAA;IAC7F,iBAAiB,CAAC,IAAI,EAAE,6BAA6B,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAAA;IAC/F,gBAAgB,CAAC,IAAI,EAAE,4BAA4B,GAAG,OAAO,CAAC,6BAA6B,CAAC,CAAA;IAC5F,mBAAmB,CAAC,IAAI,EAAE,+BAA+B,GAAG,OAAO,CAAC,gCAAgC,CAAC,CAAA;CACtG"}

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) => 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,KAAG,MAAM,GAAG,SAmC1D,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"}