@bitblit/ratchet-rdbms 4.0.420-alpha → 4.0.421-alpha

package/lib/service/named-parameter-database-service.js

@@ -0,0 +1,272 @@
+import { Logger } from '@bitblit/ratchet-common/logger/logger';
+import { ErrorRatchet } from '@bitblit/ratchet-common/lang/error-ratchet';
+import { PromiseRatchet } from '@bitblit/ratchet-common/lang/promise-ratchet';
+import { StopWatch } from '@bitblit/ratchet-common/lang/stop-watch';
+import { TimeoutToken } from '@bitblit/ratchet-common/lang/timeout-token';
+import { DurationRatchet } from '@bitblit/ratchet-common/lang/duration-ratchet';
+import { QueryUtil } from '../query-builder/query-util.js';
+import { TransactionIsolationLevel } from '../model/transaction-isolation-level.js';
+import { QueryBuilder } from '../query-builder/query-builder.js';
+import { DatabaseRequestType } from '../model/database-request-type.js';
+export class NamedParameterDatabaseService {
+    cfg;
+    constructor(cfg) {
+        this.cfg = cfg;
+        cfg.serviceName = cfg.serviceName ?? 'NamedParameterDatabaseService';
+        cfg.logger = cfg.logger || Logger.getLogger();
+        Logger.info('NamedParameterDatabaseService using logger %s at %s', cfg.logger.guid, cfg.logger.level);
+    }
+    getConfig() {
+        return this.cfg;
+    }
+    nonPooledExtraConfiguration() {
+        return null;
+    }
+    nonPooledMode() {
+        return false;
+    }
+    get databaseAccessProvider() {
+        return this.cfg.connectionProvider;
+    }
+    getQueryDefaults() {
+        return this.cfg.queryDefaults;
+    }
+    getQueryProvider() {
+        return this.cfg.queryProvider;
+    }
+    async createNonPooledDatabaseAccess(queryDefaults, additionalConfig) {
+        this.cfg.logger.info('createTransactional :  %s : %j', queryDefaults, additionalConfig);
+        if (!this.cfg.connectionProvider.createNonPooledDatabaseAccess) {
+            throw new Error(`Connection provider does not implement createNonPooledDatabaseAccess`);
+        }
+        const newConn = await this.cfg.connectionProvider.createNonPooledDatabaseAccess(queryDefaults, additionalConfig);
+        if (!newConn) {
+            throw new Error(`Connection could not be created for DB type ${queryDefaults}`);
+        }
+        return newConn;
+    }
+    fetchQueryRawTextByName(queryPath) {
+        return this.cfg.queryProvider.fetchQuery(queryPath);
+    }
+    queryBuilder(queryPath) {
+        const queryBuilder = new QueryBuilder(this.cfg.queryProvider);
+        if (queryPath) {
+            queryBuilder.withNamedQuery(queryPath);
+        }
+        return queryBuilder;
+    }
+    async executeUpdateOrInsertByName(queryPath, params, timeoutMS = this.cfg.queryDefaults.timeoutMS) {
+        const builder = this.queryBuilder(queryPath).withParams(params ?? {});
+        return this.buildAndExecuteUpdateOrInsert(builder, timeoutMS);
+    }
+    async buildAndExecuteUpdateOrInsert(queryBuilder, timeoutMS = this.cfg.queryDefaults.timeoutMS) {
+        const build = queryBuilder.build();
+        const resp = await this.executeQueryWithMeta(DatabaseRequestType.Modify, build.transactionIsolationLevel, build.query, build.namedParams, timeoutMS);
+        const rval = resp.results;
+        return rval;
+    }
+    async buildAndExecuteUpdateOrInsertWithRetry(queryBuilder, maxRetries, timeoutMS = this.cfg.queryDefaults.timeoutMS) {
+        let retry = 0;
+        let res;
+        while (!res && retry < maxRetries) {
+            retry++;
+            try {
+                res = await this.buildAndExecuteUpdateOrInsert(queryBuilder, timeoutMS);
+            }
+            catch (err) {
+                this.cfg.logger.info('Caught problem while trying to update/insert : %d : %s ', retry, err);
+                await PromiseRatchet.wait(retry * 2000);
+            }
+        }
+        if (!res) {
+            throw new Error(`Failed to execute update after ${maxRetries} retries`);
+        }
+        return res;
+    }
+    async executeQueryByName(queryPath, params, timeoutMS = this.cfg.queryDefaults.timeoutMS) {
+        const builder = this.queryBuilder(queryPath).withParams(params);
+        const resp = await this.buildAndExecute(builder, timeoutMS);
+        return resp;
+    }
+    async executeQueryByNameSingle(queryPath, params, timeoutMS = this.cfg.queryDefaults.timeoutMS) {
+        const builder = this.queryBuilder(queryPath).withParams(params);
+        const resp = await this.buildAndExecute(builder, timeoutMS);
+        return resp.length === 1 ? resp[0] : null;
+    }
+    async buildAndExecute(queryBuilder, timeoutMS = this.cfg.queryDefaults.timeoutMS) {
+        const build = queryBuilder.build();
+        const resp = await this.executeQueryWithMeta(DatabaseRequestType.Query, build.transactionIsolationLevel, build.query, build.namedParams, timeoutMS, queryBuilder.getDebugComment());
+        return resp.results;
+    }
+    async buildAndExecuteSingle(queryBuilder, timeoutMS = this.cfg.queryDefaults.timeoutMS) {
+        const build = queryBuilder.build();
+        const resp = await this.executeQueryWithMeta(DatabaseRequestType.Query, build.transactionIsolationLevel, build.query, build.namedParams, timeoutMS, queryBuilder.getDebugComment());
+        return resp.results.length === 1 ? resp.results[0] : null;
+    }
+    async buildAndExecuteFetchTotalRows(queryBuilder, groupBy = '', timeoutMS = this.cfg.queryDefaults.timeoutMS) {
+        const buildUnfiltered = queryBuilder.buildUnfiltered();
+        let query = buildUnfiltered.query.replace('COUNT(*)', `${groupBy} as groupByField, COUNT(*) as count`);
+        query = `${query} GROUP BY ${groupBy}`;
+        this.cfg.logger.info('Unfiltered query %s', buildUnfiltered.query);
+        const resp = await this.executeQueryWithMeta(DatabaseRequestType.Query, buildUnfiltered.transactionIsolationLevel, query, buildUnfiltered.namedParams, timeoutMS);
+        return resp.results;
+    }
+    async executeQueryWithMeta(requestType, transactionIsolationLevel, query, fields = {}, timeoutMS = this.cfg.queryDefaults.timeoutMS, debugComment) {
+        const sw = new StopWatch();
+        if (!timeoutMS) {
+            timeoutMS = this.cfg.queryDefaults.timeoutMS;
+        }
+        await this.changeNextQueryTransactionIsolationLevel(transactionIsolationLevel);
+        const result = await PromiseRatchet.timeout(this.innerExecutePreparedAsPromiseWithRetryCloseConnection(requestType, query, fields, undefined), 'Query:' + query, timeoutMS);
+        if (TimeoutToken.isTimeoutToken(result)) {
+            this.cfg.logger.warn('Timed out (after %s): %j', DurationRatchet.colonFormatMsDuration(timeoutMS), result);
+            const duration = DurationRatchet.colonFormatMsDuration(timeoutMS);
+            throw new Error(`Timed out (after ${duration}) waiting for query : ${query}`);
+        }
+        const rval = result;
+        if (!rval.results) {
+            this.cfg.logger.error('DB:executeQueryWithMeta:Failure: %j', rval);
+        }
+        if (debugComment && sw.elapsedMS() > this.cfg.longQueryTimeMs) {
+            this.cfg.logger.info('NamedParameterDatabaseService long query: %s, %s', debugComment, sw.dump());
+        }
+        return rval;
+    }
+    async shutdown() {
+        this.cfg.logger.info('Shutting down %s service', this.cfg.serviceName);
+        let rval;
+        try {
+            rval = await this.cfg.connectionProvider.clearDatabaseAccessCache();
+        }
+        catch (err) {
+            this.cfg.logger.error('Failure trying to shutdown : %s', err, err);
+            rval = false;
+        }
+        return rval;
+    }
+    async testDbFailure() {
+        await this.executeQueryWithMeta(DatabaseRequestType.Query, TransactionIsolationLevel.Default, 'this is a bad query');
+    }
+    async changeNextQueryTransactionIsolationLevel(tx) {
+        if (tx && tx !== TransactionIsolationLevel.Default) {
+            this.cfg.logger.debug('Setting tx to %s', tx);
+            return await this.innerExecutePreparedAsPromiseWithRetryCloseConnection(DatabaseRequestType.Meta, 'SET TRANSACTION ISOLATION LEVEL ' + tx, {});
+        }
+        return null;
+    }
+    async forceCloseConnectionForTesting() {
+        this.cfg.logger.warn('Forcing connection closed for testing');
+        const conn = await this.getDB();
+        try {
+            await conn.close();
+            this.cfg.logger.info('Connection has been ended, but not set to null');
+            return true;
+        }
+        catch (err) {
+            this.cfg.logger.error('Error closing connection : %s', err, err);
+            return false;
+        }
+    }
+    async innerExecutePreparedAsPromiseWithRetryCloseConnection(requestType, query, fields = {}, retryCount = 1) {
+        try {
+            const result = await this.innerExecutePreparedAsPromise(requestType, query, fields);
+            return result;
+        }
+        catch (errIn) {
+            const err = ErrorRatchet.asErr(errIn);
+            if (err.message.includes('closed state') ||
+                err.message.includes('This socket has been ended by the other party') ||
+                err.message.includes('ETIMEDOUT') ||
+                err.message.includes('RatchetNoConnection') ||
+                err.message.includes('ER_LOCK_WAIT_TIMEOUT')) {
+                const wait = Math.min(1000 * retryCount);
+                this.cfg.logger.warn('Found closed connection or lock timeout - clearing and attempting retry after %d (try %d of 3) (%s)', wait, retryCount, err.message);
+                if (retryCount < 4) {
+                    const cleared = await this.cfg.connectionProvider.clearDatabaseAccessCache();
+                    this.cfg.logger.info('Clear connection cache returned %s', cleared);
+                    await PromiseRatchet.wait(wait);
+                    return this.innerExecutePreparedAsPromiseWithRetryCloseConnection(requestType, query, fields, retryCount + 1);
+                }
+                else {
+                    this.cfg.logger.warn('Ran out of retries');
+                    throw new Error('Connection closed and cannot retry any more - dying horribly');
+                }
+            }
+            else {
+                this.cfg.logger.error('Named Param DB Query Failed : Err: %s Query: %s Params: %j', err, query, fields, err);
+                try {
+                    const conn = await this.getDB();
+                    this.cfg.logger.error('-----\nFor paste into tooling only: \n\n%s\n\n', QueryUtil.renderQueryStringForPasteIntoTool(query, fields, (v) => conn.escape(v)));
+                }
+                catch (err2) {
+                    this.cfg.logger.error('Really bad - failed trying to get the conn for logging : %s', err2);
+                }
+                throw err;
+            }
+        }
+    }
+    async innerExecutePreparedAsPromise(requestType, query, fields = {}) {
+        const conn = await this.getDB();
+        if (conn.preQuery) {
+            await conn.preQuery();
+        }
+        const sw = new StopWatch();
+        try {
+            let output;
+            if (requestType === DatabaseRequestType.Modify) {
+                this.cfg.logger.debug('Executing modify on underlying db : %s / %j', query, fields);
+                output = await conn.modify(query, fields);
+            }
+            else {
+                this.cfg.logger.debug('Executing query on underlying db : %s / %j', query, fields);
+                output = await conn.query(query, fields);
+            }
+            this.cfg.logger.debug('Success : Finished query : %s\n%s\n\nParams : %j', sw.dump(), QueryUtil.reformatQueryForLogging(query), fields);
+            this.cfg.logger.debug('-----\nFor paste into tooling only : \n\n%s\n\n', QueryUtil.renderQueryStringForPasteIntoTool(query, fields, (v) => conn.escape(v)));
+            if (conn.onRequestSuccessOnly) {
+                await conn.onRequestSuccessOnly(requestType);
+            }
+            return output;
+        }
+        catch (err) {
+            if (conn.onRequestFailureOnly) {
+                await conn.onRequestFailureOnly(requestType);
+            }
+            throw err;
+        }
+        finally {
+            if (conn.onRequestSuccessOrFailure) {
+                await conn.onRequestSuccessOrFailure(requestType);
+            }
+        }
+    }
+    async getDB() {
+        const conn = this.nonPooledMode()
+            ? await this.cfg.connectionProvider.createNonPooledDatabaseAccess(this.cfg.queryDefaults, this.nonPooledExtraConfiguration())
+            : await this.cfg.connectionProvider.getDatabaseAccess(this.cfg.queryDefaults.databaseName);
+        if (!conn) {
+            throw new Error('RatchetNoConnection : getConnection returned null - likely failed to get connection from db');
+        }
+        return conn;
+    }
+    async testConnection(logTestResults) {
+        const db = await this.getDB();
+        return db.testConnection(logTestResults);
+    }
+    async resetConnection() {
+        let rval = false;
+        this.cfg.logger.info('Resetting connection');
+        try {
+            await this.cfg.connectionProvider.clearDatabaseAccessCache();
+            const db = await this.getDB();
+            const tmpValue = await db.testConnection(true);
+            rval = !!tmpValue;
+            this.cfg.logger.info('Reset connection returning %s', rval);
+        }
+        catch (err) {
+            this.cfg.logger.error('Failed to reset connection : %s', err);
+        }
+        return rval;
+    }
+}
+//# sourceMappingURL=named-parameter-database-service.js.map

package/lib/service/named-parameter-database-service.js.map

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

package/lib/service/ssh-tunnel-service.d.ts

@@ -0,0 +1,6 @@
+import { SshTunnelContainer } from '../model/ssh/ssh-tunnel-container.js';
+import { SshTunnelConfig } from '../model/ssh/ssh-tunnel-config.js';
+export declare class SshTunnelService {
+    shutdown(ssh: SshTunnelContainer): Promise<boolean>;
+    createSSHTunnel(sshOptions: SshTunnelConfig, dstHost: string, dstPort: number, localPort: number): Promise<SshTunnelContainer>;
+}

package/lib/service/ssh-tunnel-service.js

@@ -0,0 +1,49 @@
+import * as TunnelSsh from 'tunnel-ssh';
+import { Logger } from '@bitblit/ratchet-common/logger/logger';
+export class SshTunnelService {
+    async shutdown(ssh) {
+        if (!ssh.connection) {
+            Logger.info('Not shutting down tunnel - non-tunnel passed');
+            return false;
+        }
+        try {
+            Logger.info('Shutting down SSH Tunnel');
+            ssh.connection.end();
+            ssh.server.close();
+            return true;
+        }
+        catch (err) {
+            Logger.error('Error closing ssh tunnel : %s', err);
+            return false;
+        }
+    }
+    async createSSHTunnel(sshOptions, dstHost, dstPort, localPort) {
+        const tunnelOptions = {
+            autoClose: true,
+        };
+        const serverOptions = {
+            port: localPort,
+        };
+        const forwardOptions = {
+            srcAddr: 'localhost',
+            srcPort: localPort,
+            dstAddr: dstHost,
+            dstPort: dstPort,
+        };
+        const [server, connection] = await TunnelSsh.createTunnel(tunnelOptions, serverOptions, sshOptions, forwardOptions);
+        server.on('error', (err) => {
+            Logger.warn('SSH Server Error : %s', err);
+        });
+        const rval = {
+            localPort: localPort,
+            tunnelOptions: tunnelOptions,
+            serverOptions: serverOptions,
+            sshOptions: sshOptions,
+            forwardOptions: forwardOptions,
+            server: server,
+            connection: connection,
+        };
+        return rval;
+    }
+}
+//# sourceMappingURL=ssh-tunnel-service.js.map

package/lib/service/ssh-tunnel-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssh-tunnel-service.js","sourceRoot":"","sources":["../../src/service/ssh-tunnel-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,uCAAuC,CAAC;AAI/D,MAAM,OAAO,gBAAgB;IACpB,KAAK,CAAC,QAAQ,CAAC,GAAuB;QAC3C,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;YAC5D,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;YACxC,GAAG,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC;YACrB,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CAAC,+BAA+B,EAAE,GAAG,CAAC,CAAC;YACnD,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,eAAe,CAC1B,UAA2B,EAC3B,OAAe,EACf,OAAe,EACf,SAAiB;QAEjB,MAAM,aAAa,GAAG;YACpB,SAAS,EAAE,IAAI;SAChB,CAAC;QACF,MAAM,aAAa,GAAG;YACpB,IAAI,EAAE,SAAS;SAChB,CAAC;QACF,MAAM,cAAc,GAAG;YACrB,OAAO,EAAE,WAAW;YACpB,OAAO,EAAE,SAAS;YAClB,OAAO,EAAE,OAAO;YAChB,OAAO,EAAE,OAAO;SACjB,CAAC;QAEF,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,MAAM,SAAS,CAAC,YAAY,CAAC,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC;QAEpH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAU,EAAE,EAAE;YAChC,MAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE,GAAG,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QAEH,MAAM,IAAI,GAAuB;YAC/B,SAAS,EAAE,SAAS;YACpB,aAAa,EAAE,aAAa;YAC5B,aAAa,EAAE,aAAa;YAC5B,UAAU,EAAE,UAAU;YACtB,cAAc,EAAE,cAAc;YAC9B,MAAM,EAAE,MAAM;YACd,UAAU,EAAE,UAAU;SACvB,CAAC;QAEF,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/lib/service/transactional-named-parameter-database-service.d.ts

@@ -0,0 +1,20 @@
+import { NamedParameterDatabaseService } from './named-parameter-database-service.js';
+import { QueryBuilder } from '../query-builder/query-builder.js';
+import { ModifyResults } from '../model/modify-results.js';
+import { NamedParameterDatabaseServiceConfig } from '../model/named-parameter-database-service-config.js';
+export declare class TransactionalNamedParameterDatabaseService extends NamedParameterDatabaseService {
+    private transCfg;
+    private additionalConfig;
+    private currentTxFlag?;
+    constructor(transCfg: NamedParameterDatabaseServiceConfig, additionalConfig: Record<string, any>);
+    nonPooledExtraConfiguration(): Record<string, any>;
+    nonPooledMode(): boolean;
+    cleanShutdown(): Promise<void>;
+    startTransaction(): Promise<void>;
+    commitTransaction(): Promise<void>;
+    rollBackTransaction(): Promise<void>;
+    buildAndExecuteUpdateOrInsertInTransaction(queryBuilder: QueryBuilder, timeoutMS?: number): Promise<ModifyResults | null>;
+    buildAndExecuteInTransaction<T>(queryBuilder: QueryBuilder, timeoutMS?: number): Promise<T[] | null>;
+    static oneStepBuildAndExecuteUpdateOrInsertInTransaction(src: NamedParameterDatabaseService, queryBuilder: QueryBuilder, timeoutMS?: number, additionalConfig?: Record<string, any>): Promise<ModifyResults | null>;
+    static oneStepBuildAndExecuteInTransaction<S, T, R>(src: NamedParameterDatabaseService, queryBuilder: QueryBuilder, timeoutMS?: number, additionalConfig?: R): Promise<S[] | null>;
+}

package/lib/service/transactional-named-parameter-database-service.js

@@ -0,0 +1,129 @@
+import { NamedParameterDatabaseService } from './named-parameter-database-service.js';
+import { Logger } from '@bitblit/ratchet-common/logger/logger';
+import { ErrorRatchet } from '@bitblit/ratchet-common/lang/error-ratchet';
+import { StringRatchet } from '@bitblit/ratchet-common/lang/string-ratchet';
+export class TransactionalNamedParameterDatabaseService extends NamedParameterDatabaseService {
+    transCfg;
+    additionalConfig;
+    currentTxFlag;
+    constructor(transCfg, additionalConfig) {
+        super(transCfg);
+        this.transCfg = transCfg;
+        this.additionalConfig = additionalConfig;
+    }
+    nonPooledExtraConfiguration() {
+        return this.additionalConfig;
+    }
+    nonPooledMode() {
+        return true;
+    }
+    async cleanShutdown() {
+        Logger.info('cleanShutdown');
+        try {
+            const conn = await this.transCfg.connectionProvider.getDatabaseAccess();
+            if (conn) {
+                Logger.info('Shutting down connection');
+                await conn.close();
+            }
+        }
+        catch (err) {
+            Logger.info('Failure shutting down single-use connection : %s', err);
+        }
+    }
+    async startTransaction() {
+        if (!this.currentTxFlag) {
+            this.currentTxFlag = StringRatchet.createRandomHexString(10);
+            Logger.info('Starting a transaction : %s', this.currentTxFlag);
+            const conn = await this.transCfg.connectionProvider.getDatabaseAccess();
+            await conn?.beginTransaction();
+        }
+        else {
+            ErrorRatchet.throwFormattedErr('Tried to start a new transaction while one is already in progress : %s', this.currentTxFlag);
+        }
+    }
+    async commitTransaction() {
+        if (this.currentTxFlag) {
+            Logger.info('commit a transaction : %s', this.currentTxFlag);
+            const conn = await this.transCfg.connectionProvider.getDatabaseAccess();
+            await conn?.commitTransaction();
+            this.currentTxFlag = undefined;
+        }
+        else {
+            ErrorRatchet.throwFormattedErr('Cannot commit transaction - none in process');
+        }
+    }
+    async rollBackTransaction() {
+        if (this.currentTxFlag) {
+            Logger.info('rollBack a transaction : %s', this.currentTxFlag);
+            const conn = await this.transCfg.connectionProvider.getDatabaseAccess();
+            await conn?.rollbackTransaction();
+            this.currentTxFlag = undefined;
+        }
+        else {
+            ErrorRatchet.throwFormattedErr('Cannot rollBack transaction - none in process');
+        }
+    }
+    async buildAndExecuteUpdateOrInsertInTransaction(queryBuilder, timeoutMS = this.transCfg.queryDefaults.timeoutMS) {
+        Logger.info('buildAndExecuteUpdateOrInsertInTransaction');
+        await this.startTransaction();
+        try {
+            const rval = await this.buildAndExecuteUpdateOrInsert(queryBuilder, timeoutMS);
+            await this.commitTransaction();
+            return rval;
+        }
+        catch (err) {
+            Logger.error('Failed - rolling back transaction : %s', err, err);
+            await this.rollBackTransaction();
+            return null;
+        }
+    }
+    async buildAndExecuteInTransaction(queryBuilder, timeoutMS = this.transCfg.queryDefaults.timeoutMS) {
+        Logger.info('buildAndExecuteInTransaction');
+        await this.startTransaction();
+        try {
+            const rval = await this.buildAndExecute(queryBuilder, timeoutMS);
+            await this.commitTransaction();
+            return rval;
+        }
+        catch (err) {
+            Logger.error('Failed - rolling back transaction : %s', err, err);
+            await this.rollBackTransaction();
+            return null;
+        }
+    }
+    static async oneStepBuildAndExecuteUpdateOrInsertInTransaction(src, queryBuilder, timeoutMS = src.getQueryDefaults().timeoutMS, additionalConfig) {
+        let handler;
+        let rval = null;
+        try {
+            handler = new TransactionalNamedParameterDatabaseService(src.getConfig(), additionalConfig);
+            rval = await handler.buildAndExecuteUpdateOrInsertInTransaction(queryBuilder, timeoutMS);
+        }
+        catch (err) {
+            Logger.error('Failure in oneStepBuildAndExecuteUpdateOrInsertInTransaction : %j : %s', queryBuilder, err, err);
+        }
+        finally {
+            if (handler) {
+                await handler.cleanShutdown();
+            }
+        }
+        return rval;
+    }
+    static async oneStepBuildAndExecuteInTransaction(src, queryBuilder, timeoutMS = src.getQueryDefaults().timeoutMS, additionalConfig) {
+        let handler;
+        let rval = null;
+        try {
+            handler = new TransactionalNamedParameterDatabaseService(src.getConfig(), additionalConfig);
+            rval = await handler.buildAndExecuteInTransaction(queryBuilder, timeoutMS);
+        }
+        catch (err) {
+            Logger.error('Failure in oneStepbuildAndExecuteInTransaction : %j : %s', queryBuilder, err, err);
+        }
+        finally {
+            if (handler) {
+                await handler.cleanShutdown();
+            }
+        }
+        return rval;
+    }
+}
+//# sourceMappingURL=transactional-named-parameter-database-service.js.map

package/lib/service/transactional-named-parameter-database-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactional-named-parameter-database-service.js","sourceRoot":"","sources":["../../src/service/transactional-named-parameter-database-service.ts"],"names":[],"mappings":"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"}

package/lib/sqlite/index.d.ts

@@ -0,0 +1,9 @@
+export * from './sqlite-database-access.js';
+export * from './sqlite-remote-sync-database-access.js';
+export * from './sqlite-style-connection-provider.js';
+export * from './model/fetch-remote-mode.js';
+export * from './model/flush-remote-mode.js';
+export * from './model/sqlite-connection-config-flag.js';
+export * from './model/sqlite-connection-config.js';
+export * from './model/sqlite-local-file-config.js';
+export * from './model/sqlite-remote-file-sync-config.js';

package/lib/sqlite/index.js

@@ -0,0 +1,10 @@
+export * from './sqlite-database-access.js';
+export * from './sqlite-remote-sync-database-access.js';
+export * from './sqlite-style-connection-provider.js';
+export * from './model/fetch-remote-mode.js';
+export * from './model/flush-remote-mode.js';
+export * from './model/sqlite-connection-config-flag.js';
+export * from './model/sqlite-connection-config.js';
+export * from './model/sqlite-local-file-config.js';
+export * from './model/sqlite-remote-file-sync-config.js';
+//# sourceMappingURL=index.js.map

package/lib/sqlite/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sqlite/index.ts"],"names":[],"mappings":"AAIA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yCAAyC,CAAC;AACxD,cAAc,uCAAuC,CAAC;AACtD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0CAA0C,CAAC;AACzD,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AACpD,cAAc,2CAA2C,CAAC"}

package/lib/sqlite/model/fetch-remote-mode.d.ts

@@ -0,0 +1,4 @@
+export declare enum FetchRemoteMode {
+    OnStartup = "OnStartup",
+    EveryQuery = "EveryQuery"
+}

package/lib/sqlite/model/fetch-remote-mode.js

@@ -0,0 +1,6 @@
+export var FetchRemoteMode;
+(function (FetchRemoteMode) {
+    FetchRemoteMode["OnStartup"] = "OnStartup";
+    FetchRemoteMode["EveryQuery"] = "EveryQuery";
+})(FetchRemoteMode || (FetchRemoteMode = {}));
+//# sourceMappingURL=fetch-remote-mode.js.map

package/lib/sqlite/model/fetch-remote-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-remote-mode.js","sourceRoot":"","sources":["../../../src/sqlite/model/fetch-remote-mode.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,0CAAuB,CAAA;IACvB,4CAAyB,CAAA;AAC3B,CAAC,EAHW,eAAe,KAAf,eAAe,QAG1B"}

package/lib/sqlite/model/flush-remote-mode.d.ts

@@ -0,0 +1,4 @@
+export declare enum FlushRemoteMode {
+    Auto = "Auto",
+    Explicit = "Explicit"
+}

package/lib/sqlite/model/flush-remote-mode.js

@@ -0,0 +1,6 @@
+export var FlushRemoteMode;
+(function (FlushRemoteMode) {
+    FlushRemoteMode["Auto"] = "Auto";
+    FlushRemoteMode["Explicit"] = "Explicit";
+})(FlushRemoteMode || (FlushRemoteMode = {}));
+//# sourceMappingURL=flush-remote-mode.js.map

package/lib/sqlite/model/flush-remote-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flush-remote-mode.js","sourceRoot":"","sources":["../../../src/sqlite/model/flush-remote-mode.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,gCAAa,CAAA;IACb,wCAAqB,CAAA;AACvB,CAAC,EAHW,eAAe,KAAf,eAAe,QAG1B"}

package/lib/sqlite/model/sqlite-connection-config-flag.d.ts

@@ -0,0 +1,3 @@
+export declare enum SqliteConnectionConfigFlag {
+    AlwaysCollateNoCase = "AlwaysCollateNoCase"
+}

package/lib/sqlite/model/sqlite-connection-config-flag.js

@@ -0,0 +1,5 @@
+export var SqliteConnectionConfigFlag;
+(function (SqliteConnectionConfigFlag) {
+    SqliteConnectionConfigFlag["AlwaysCollateNoCase"] = "AlwaysCollateNoCase";
+})(SqliteConnectionConfigFlag || (SqliteConnectionConfigFlag = {}));
+//# sourceMappingURL=sqlite-connection-config-flag.js.map

package/lib/sqlite/model/sqlite-connection-config-flag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-connection-config-flag.js","sourceRoot":"","sources":["../../../src/sqlite/model/sqlite-connection-config-flag.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,0BAEX;AAFD,WAAY,0BAA0B;IACpC,yEAA2C,CAAA;AAC7C,CAAC,EAFW,0BAA0B,KAA1B,0BAA0B,QAErC"}

package/lib/sqlite/model/sqlite-connection-config.d.ts

@@ -0,0 +1,9 @@
+import { SqliteRemoteFileSyncConfig } from './sqlite-remote-file-sync-config.js';
+import { SqliteConnectionConfigFlag } from './sqlite-connection-config-flag.js';
+import { SqliteLocalFileConfig } from './sqlite-local-file-config.js';
+export interface SqliteConnectionConfig {
+    label: string;
+    localFile?: SqliteLocalFileConfig;
+    remoteFileSync?: SqliteRemoteFileSyncConfig;
+    flags?: SqliteConnectionConfigFlag[];
+}

package/lib/sqlite/model/sqlite-connection-config.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sqlite-connection-config.js.map

package/lib/sqlite/model/sqlite-connection-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-connection-config.js","sourceRoot":"","sources":["../../../src/sqlite/model/sqlite-connection-config.ts"],"names":[],"mappings":""}

package/lib/sqlite/model/sqlite-local-file-config.d.ts

@@ -0,0 +1,3 @@
+export interface SqliteLocalFileConfig {
+    filePath?: string;
+}

package/lib/sqlite/model/sqlite-local-file-config.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sqlite-local-file-config.js.map

package/lib/sqlite/model/sqlite-local-file-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-local-file-config.js","sourceRoot":"","sources":["../../../src/sqlite/model/sqlite-local-file-config.ts"],"names":[],"mappings":""}

package/lib/sqlite/model/sqlite-remote-file-sync-config.d.ts

@@ -0,0 +1,8 @@
+import { FlushRemoteMode } from './flush-remote-mode.js';
+import { FetchRemoteMode } from './fetch-remote-mode.js';
+import { RemoteFileSyncLike } from '@bitblit/ratchet-common/network/remote-file-sync/remote-file-sync-like';
+export interface SqliteRemoteFileSyncConfig {
+    remoteFileSync: RemoteFileSyncLike;
+    flushRemoteMode?: FlushRemoteMode;
+    fetchRemoteMode?: FetchRemoteMode;
+}

package/lib/sqlite/model/sqlite-remote-file-sync-config.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sqlite-remote-file-sync-config.js.map