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

package/lib/query-builder/query-builder.js

@@ -0,0 +1,352 @@
+import { RequireRatchet } from '@bitblit/ratchet-common/lang/require-ratchet';
+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';
+import { QueryBuilderResult } from './query-builder-result.js';
+import { TransactionIsolationLevel } from '../model/transaction-isolation-level.js';
+import { SortDirection } from '../model/sort-direction.js';
+export class QueryBuilder {
+    static ALLOWED_SQL_CONSTRUCT = /^[a-z0-9_.`]+$/i;
+    queryProvider;
+    query;
+    meta = Object.freeze({});
+    sqlConstructs = {};
+    namedParams = {};
+    conditionals = {};
+    debugComment = '';
+    paginator;
+    debugAnnotateMode = false;
+    transactionIsolationLevel = TransactionIsolationLevel.Default;
+    constructor(queryProvider) {
+        this.queryProvider = queryProvider;
+    }
+    clone() {
+        const clone = new QueryBuilder(this.queryProvider);
+        if (this.query) {
+            clone.withBaseQuery(this.query);
+        }
+        clone.sqlConstructs = structuredClone(this.sqlConstructs);
+        clone.namedParams = structuredClone(this.namedParams);
+        clone.conditionals = structuredClone(this.conditionals);
+        clone.paginator = structuredClone(this.paginator);
+        clone.debugComment = this.debugComment;
+        clone.transactionIsolationLevel = this.transactionIsolationLevel;
+        return clone;
+    }
+    withTransactionIsolationLevel(level) {
+        this.transactionIsolationLevel = level;
+        return this;
+    }
+    withDebugComment(comment) {
+        this.debugComment = comment;
+        return this;
+    }
+    appendDebugComment(comment) {
+        this.debugComment = this.debugComment + comment;
+        return this;
+    }
+    withNamedQuery(queryPath) {
+        this.query = this.queryProvider.fetchQuery(queryPath);
+        if (!StringRatchet.trimToNull(this.query)) {
+            ErrorRatchet.throwFormattedErr('Requested query that does not exist : %s', queryPath);
+        }
+        this.meta = Object.freeze({ queryPath: queryPath });
+        this.withDebugComment(' ' + queryPath + ' ');
+        return this;
+    }
+    withBaseQuery(baseQuery) {
+        this.query = baseQuery;
+    }
+    withSqlConstruct(key, value) {
+        this.sqlConstructs[key] = value;
+        return this;
+    }
+    withSqlConstructs(params) {
+        this.sqlConstructs = Object.assign(this.sqlConstructs, params);
+        return this;
+    }
+    removeParam(key) {
+        delete this.namedParams[key];
+        return this;
+    }
+    paramNames() {
+        return Object.keys(this.namedParams);
+    }
+    withParam(key, value) {
+        this.namedParams[key] = value;
+        return this;
+    }
+    withParams(params) {
+        this.namedParams = Object.assign(this.namedParams, params);
+        return this;
+    }
+    withExpandedParam(keyPrefix, values, extendIfExists) {
+        const lengthParamName = keyPrefix + 'Length';
+        let oldSize = this.fetchCopyOfParam(lengthParamName) ?? 0;
+        if (oldSize > 0 && !extendIfExists) {
+            Logger.silly('Old item found and not extending - removing old params');
+            const toRemove = this.paramNames().filter((s) => s.startsWith(keyPrefix));
+            toRemove.forEach((s) => this.removeParam(s));
+            oldSize = 0;
+        }
+        this.withParam(lengthParamName, values.length + oldSize);
+        for (let i = 0; i < values.length; i++) {
+            const value = values[i];
+            if (typeof value === 'object' && !!value) {
+                for (const key of Object.keys(value)) {
+                    const paramKey = keyPrefix + key.charAt(0).toUpperCase() + key.slice(1) + (i + oldSize);
+                    this.withParam(paramKey, value[key]);
+                }
+            }
+            else {
+                const paramKey = keyPrefix + i;
+                this.withParam(paramKey, value);
+            }
+        }
+        return this;
+    }
+    withConditional(tag, state = true) {
+        this.conditionals[tag] = state;
+        return this;
+    }
+    withConditionals(params) {
+        this.conditionals = Object.assign(this.conditionals, params);
+        return this;
+    }
+    withPaginator(paginator) {
+        RequireRatchet.notNullOrUndefined(paginator, 'paginator');
+        RequireRatchet.notNullOrUndefined(paginator.cn, 'paginator.cn');
+        RequireRatchet.true(paginator.min || paginator.max || paginator.l, 'paginator must have some limit');
+        paginator.s = paginator.s ?? SortDirection.Asc;
+        this.paginator = paginator;
+        return this;
+    }
+    fetchCopyOfParam(paramName) {
+        return this.namedParams[paramName];
+    }
+    fetchCopyOfConditional(conditionalName) {
+        return this.conditionals[conditionalName];
+    }
+    containsParam(paramName) {
+        return this.namedParams[paramName] != undefined;
+    }
+    getDebugComment() {
+        return this.debugComment;
+    }
+    containsConditional(conditionalName) {
+        return this.conditionals[conditionalName] != undefined;
+    }
+    build() {
+        const build = this.clone();
+        return build.internalBuild(false);
+    }
+    buildUnfiltered() {
+        const builder = this.clone();
+        return builder.internalBuild(true);
+    }
+    internalBuild(unfiltered) {
+        this.applyQueryFragments();
+        this.applyConditionalBlocks();
+        this.applyRepeatBlocks();
+        this.applyPagination(unfiltered);
+        this.applySqlConstructs();
+        this.applyComments();
+        this.runQueryChecks();
+        this.stripNonAsciiParams();
+        return new QueryBuilderResult((this.query ?? '').trim(), this.namedParams, this.paginator, this.transactionIsolationLevel);
+    }
+    stripNonAsciiParams() {
+        const reduced = StringRatchet.stripNonAscii(JSON.stringify(this.namedParams));
+        this.namedParams = JSON.parse(reduced);
+    }
+    runQueryChecks() {
+        const quotedNamedParams = [...(this.query?.matchAll(/['"]:[A-z-]*['"]/gm) ?? [])];
+        if (quotedNamedParams.length > 0) {
+            Logger.warn('The resulting query contains quoted named params check this this is intended. Instances found: %s', quotedNamedParams.join(', '));
+        }
+    }
+    applyComments() {
+        if (this.debugComment.length && this.query) {
+            const firstSpaceIndex = this.query.indexOf(' ');
+            const comment = this.debugComment;
+            this.query = this.query.substring(0, firstSpaceIndex + 1) + `/*${comment}*/` + this.query.substring(firstSpaceIndex + 1);
+        }
+    }
+    applySqlConstructs() {
+        for (const key of Object.keys(this.sqlConstructs)) {
+            let value;
+            const val = this.sqlConstructs[key];
+            if (Array.isArray(val)) {
+                val.forEach((v) => {
+                    if (typeof v !== 'string' || !v.match(QueryBuilder.ALLOWED_SQL_CONSTRUCT)) {
+                        throw new Error(`sql construct entry ${v} is invalid value must be alphanumeric only.`);
+                    }
+                });
+                value = val.join(', ');
+            }
+            else {
+                value = StringRatchet.safeString(val);
+                if (value.length > 0 && !value.match(QueryBuilder.ALLOWED_SQL_CONSTRUCT)) {
+                    throw new Error(`sql construct ${value} is invalid value must be alphanumeric only.`);
+                }
+            }
+            const sqlReservedWords = ['update', 'insert', 'delete', 'drop', 'select'];
+            for (const word of sqlReservedWords) {
+                if (value.toLowerCase().includes(word)) {
+                    throw new Error(`sql construct ${value} is invalid value must not contain reserved word ${word}.`);
+                }
+            }
+            const rawKey = `##sqlConstruct:${key}##`;
+            while (this.query?.includes(rawKey)) {
+                this.query = this.query.replace(rawKey, value);
+            }
+        }
+    }
+    applyRepeatBlocks() {
+        const startSymbol = '<repeat';
+        const endSymbol = '>';
+        while (true) {
+            const startIndex = this.query?.indexOf(startSymbol);
+            if (startIndex === -1 || !this.query || typeof startIndex !== 'number') {
+                return;
+            }
+            const endIndex = this.query.indexOf(endSymbol, startIndex);
+            if (endIndex == -1) {
+                throw new Error(`Invalid query when finding end symbol matching ${endSymbol} in ${this.query} check that you have closed all your tags correctly.`);
+            }
+            const content = this.query.substring(startIndex + startSymbol.length, endIndex).trim();
+            const countSymbol = 'count=';
+            let countParam = '';
+            const joinSymbol = 'join=';
+            let joinString;
+            const params = content.split(' ');
+            for (const param of params) {
+                if (param.includes(countSymbol)) {
+                    countParam = param.substring(param.indexOf(countSymbol) + countSymbol.length);
+                }
+                if (param.includes(joinSymbol)) {
+                    joinString = param.substring(param.indexOf(joinSymbol) + joinSymbol.length);
+                }
+            }
+            const endTag = `</repeat>`;
+            const endTagIndex = this.query.indexOf(endTag);
+            const repeatedContent = this.query.substring(endIndex + endSymbol.length, endTagIndex);
+            this.query = this.query.substring(0, startIndex) + this.query.substring(endTagIndex + endTag.length);
+            const count = this.namedParams[countParam.substring(1)];
+            for (let i = 0; i < count; i++) {
+                let indexedContent = repeatedContent;
+                if (joinString && i != 0) {
+                    indexedContent += joinString;
+                }
+                let startParamTagIndex = indexedContent.indexOf(`::`);
+                while (startParamTagIndex != -1) {
+                    const endParamTagIndex = indexedContent.indexOf(`::`, startParamTagIndex + 2);
+                    if (endParamTagIndex == -1) {
+                        throw new Error(`Invalid query when finding end symbol matching :: check that you have closed all your tags correctly. Query: ${this.query} `);
+                    }
+                    const param = indexedContent.substring(startParamTagIndex + 2, endParamTagIndex);
+                    indexedContent = indexedContent.replace('::' + param + '::', ':' + param + i);
+                    startParamTagIndex = indexedContent.indexOf(`::`);
+                }
+                this.query = this.query.substring(0, startIndex) + indexedContent + this.query.substring(startIndex);
+            }
+        }
+    }
+    applyQueryFragments() {
+        const startSymbol = '[[';
+        const endSymbol = ']]';
+        while (true) {
+            const startIndex = this.query?.indexOf(startSymbol);
+            if (startIndex == -1 || !this.query || typeof startIndex !== 'number') {
+                return;
+            }
+            const endIndex = this.query.indexOf(endSymbol, startIndex);
+            if (endIndex == -1) {
+                throw new Error(`Invalid query when finding end symbol matching ${endSymbol} in ${this.query} check that you have closed all your tags correctly.`);
+            }
+            const rawName = this.query.substring(startIndex + startSymbol.length, endIndex);
+            const namedQueryElement = this.queryProvider.fetchQuery(rawName);
+            if (!namedQueryElement) {
+                throw new Error(`Invalid query, query fragment ${rawName} not found in named queries.`);
+            }
+            this.query = this.query.replace(`[[${rawName}]]`, namedQueryElement);
+        }
+    }
+    applyPagination(unfiltered) {
+        const paginationRawKey = '##pagination##';
+        if (!unfiltered && this.paginator) {
+            const sortDirEnum = this.paginator.s == SortDirection.Desc ? SortDirection.Desc : SortDirection.Asc;
+            const sortDir = StringRatchet.safeString(sortDirEnum);
+            if (this.paginator.min || this.paginator.max) {
+                let wc = 'WHERE ##sqlConstruct:queryBuilderPaginatorWhere##';
+                this.withSqlConstruct('queryBuilderPaginatorWhere', this.paginator.cn);
+                if (this.paginator.min) {
+                    wc += '>= :queryBuilderPaginatorWhereMin';
+                    this.withParam('queryBuilderPaginatorWhereMin', this.paginator.min);
+                }
+                if (this.paginator.max) {
+                    if (this.paginator.min) {
+                        wc += ' AND ##sqlConstruct:queryBuilderPaginatorWhere##';
+                    }
+                    wc += '< :queryBuilderPaginatorWhereMax';
+                    this.withParam('queryBuilderPaginatorWhereMax', this.paginator.max);
+                }
+                this.query += wc;
+            }
+            this.query += ` ORDER BY ##sqlConstruct:queryBuilderOrderBy## ${sortDir}`;
+            this.withSqlConstruct('queryBuilderOrderBy', this.paginator.cn);
+            if (this.paginator.l) {
+                this.query += ' LIMIT :queryBuilderLimit';
+                this.withParam('queryBuilderLimit', this.paginator.l);
+            }
+        }
+        if (unfiltered && this.query) {
+            const paginationSplitIndex = this.query.indexOf(paginationRawKey);
+            if (paginationSplitIndex != -1) {
+                this.query = 'SELECT COUNT(*) ' + this.query.substring(paginationSplitIndex + paginationRawKey.length);
+            }
+        }
+        while (this.query?.includes(paginationRawKey)) {
+            this.query = this.query.replace(paginationRawKey, '');
+        }
+    }
+    applyConditionalBlocks() {
+        const startSymbol = '<<';
+        const endSymbol = '>>';
+        while (true) {
+            const startIndex = this.query?.indexOf(startSymbol);
+            if (startIndex == -1 || !this.query || typeof startIndex !== 'number') {
+                return;
+            }
+            const endIndex = this.query.indexOf(endSymbol, startIndex);
+            if (endIndex == -1) {
+                throw new Error(`Invalid query when finding end symbol matching ${endSymbol} in ${this.query} check that you have closed all your tags correctly.`);
+            }
+            const rawTag = this.query.substring(startIndex + startSymbol.length, endIndex);
+            const tag = rawTag.replace(':', '');
+            const endTag = `<</${rawTag}>>`;
+            const endTagIndex = this.query.indexOf(endTag);
+            if (endTagIndex == -1) {
+                throw new Error(`Invalid query when finding conditional end tag matching ${endTag} in ${this.query} check that your query contains an exact match of this tag.`);
+            }
+            let replacement = this.query.substring(endIndex + endSymbol.length, endTagIndex);
+            if (rawTag.startsWith(':')) {
+                const param = this.namedParams[tag];
+                if (param == null || (Array.isArray(param) && param.length == 0)) {
+                    replacement = '';
+                }
+            }
+            else {
+                const conditional = this.conditionals[tag.replace('!', '')];
+                if (conditional == undefined || conditional == tag.startsWith('!')) {
+                    replacement = '';
+                }
+            }
+            if (this.debugAnnotateMode) {
+                replacement = '/* conditional ' + tag + '*/';
+            }
+            this.query = this.query.substring(0, startIndex) + replacement + this.query.substring(endTagIndex + endTag.length);
+        }
+    }
+}
+//# sourceMappingURL=query-builder.js.map

package/lib/query-builder/query-builder.js.map

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

package/lib/query-builder/query-util.d.ts

@@ -0,0 +1,16 @@
+export declare class QueryUtil {
+    private fields;
+    private replacements;
+    addReplacement(replacement: Record<string, unknown>, ...fields: string[]): void;
+    appendReplacement(replacementKey: string, appendValue: string, ...fields: string[]): void;
+    addFields(...fields: string[]): void;
+    getFields(): string[];
+    getReplacements(): Record<string, unknown>;
+    static sqlInjectionUnsafeParamRenderer(value: unknown): string;
+    static renderQueryStringForPasteIntoTool(query: string, inFields: object | null, transform?: (x: unknown) => string): string | null;
+    static reformatQueryForLogging(qry: string, inMaxLineLength?: number): string | null;
+    static addPrefixToFieldNames(fields: Record<string, any>, prefix?: string): Record<string, any>;
+    static replaceNullReplacementsInQuery(query: string, fields: Record<string, any>): string;
+    static removeUnusedFields(query: string, fields: Record<string, any>, prefix?: string): Record<string, any>;
+    static extractUsedNamedParams(query: string): string[];
+}

package/lib/query-builder/query-util.js

@@ -0,0 +1,137 @@
+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 QueryUtil {
+    fields = [];
+    replacements = {};
+    addReplacement(replacement, ...fields) {
+        this.replacements = Object.assign(this.replacements, replacement);
+        this.addFields(...fields);
+    }
+    appendReplacement(replacementKey, appendValue, ...fields) {
+        this.replacements[replacementKey] = this.replacements[replacementKey] + appendValue;
+        this.addFields(...fields);
+    }
+    addFields(...fields) {
+        this.fields = this.fields.concat(...fields);
+    }
+    getFields() {
+        return this.fields;
+    }
+    getReplacements() {
+        return this.replacements;
+    }
+    static sqlInjectionUnsafeParamRenderer(value) {
+        const rFn = (val) => (typeof val === 'string' ? '"' + val + '"' : StringRatchet.safeString(val));
+        const repl = Array.isArray(value) ? value.map((s) => rFn(s)).join(',') : rFn(value);
+        return repl;
+    }
+    static renderQueryStringForPasteIntoTool(query, inFields, transform = QueryUtil.sqlInjectionUnsafeParamRenderer) {
+        const fields = inFields ?? {};
+        let rval = QueryUtil.reformatQueryForLogging(query);
+        if (rval) {
+            const keys = Object.keys(fields);
+            keys.sort((b, a) => a.length - b.length);
+            for (const key of keys) {
+                const val = fields[key];
+                const find = ':' + key;
+                const repl = transform(val);
+                rval = rval.split(find).join(repl);
+            }
+            if (!rval.endsWith(';')) {
+                rval += ';';
+            }
+        }
+        return rval;
+    }
+    static reformatQueryForLogging(qry, inMaxLineLength = 80) {
+        let maxLineLength = inMaxLineLength;
+        if (!StringRatchet.trimToNull(qry)) {
+            return null;
+        }
+        let loggableQuery = '';
+        let cleaned = StringRatchet.trimToEmpty(qry).split('\n').join(' ').split('\r').join(' ');
+        while (cleaned.length > maxLineLength) {
+            let idx = Math.min(cleaned.length, maxLineLength);
+            while (idx > 0 && ![' ', ','].includes(cleaned.charAt(idx))) {
+                idx--;
+            }
+            if (idx > 0) {
+                loggableQuery += cleaned.substring(0, idx) + '\n';
+                cleaned = StringRatchet.trimToEmpty(cleaned.substring(idx));
+            }
+            else {
+                Logger.silly('Input contains a string longer than the max line length - bumping');
+                maxLineLength += 2;
+            }
+        }
+        return loggableQuery + (cleaned.length > 0 ? cleaned : '');
+    }
+    static addPrefixToFieldNames(fields, prefix = ':') {
+        const rval = {};
+        Object.keys(fields).forEach((k) => {
+            rval[prefix + k] = fields[k];
+        });
+        return rval;
+    }
+    static replaceNullReplacementsInQuery(query, fields) {
+        const rval = query;
+        Object.keys(fields).forEach((k) => {
+            if (fields[k] === null || fields[k] === undefined) {
+                rval.replaceAll(k, 'null');
+            }
+        });
+        return rval;
+    }
+    static removeUnusedFields(query, fields, prefix) {
+        const usedFields = QueryUtil.extractUsedNamedParams(query);
+        const rval = {};
+        Object.keys(fields).forEach((k) => {
+            if (usedFields.includes(k) || (prefix && usedFields.includes(prefix + k))) {
+                rval[k] = fields[k];
+            }
+        });
+        return rval;
+    }
+    static extractUsedNamedParams(query) {
+        let state = 0;
+        let idx = 0;
+        const frags = [];
+        const usedParams = [];
+        let curString = '';
+        while (idx < query.length) {
+            const nextChar = query.charAt(idx++);
+            if (state === 0) {
+                if (nextChar === ':') {
+                    frags.push(curString);
+                    curString = ':';
+                    state = 1;
+                }
+                else {
+                    curString += nextChar;
+                }
+            }
+            else if (state === 1) {
+                if (!StringRatchet.stringContainsOnlyAlphanumeric(nextChar)) {
+                    usedParams.push(curString);
+                    curString = nextChar;
+                    state = 0;
+                }
+                else {
+                    curString += nextChar;
+                }
+            }
+            else {
+                throw ErrorRatchet.fErr('Cant happen - invalid state');
+            }
+        }
+        if (state === 0) {
+            frags.push(curString);
+        }
+        else {
+            usedParams.push(curString);
+        }
+        return usedParams;
+    }
+}
+//# sourceMappingURL=query-util.js.map

package/lib/query-builder/query-util.js.map

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

package/lib/service/index.d.ts

@@ -0,0 +1,3 @@
+export * from './named-parameter-database-service.js';
+export * from './ssh-tunnel-service.js';
+export * from './transactional-named-parameter-database-service.js';

package/lib/service/index.js

@@ -0,0 +1,4 @@
+export * from './named-parameter-database-service.js';
+export * from './ssh-tunnel-service.js';
+export * from './transactional-named-parameter-database-service.js';
+//# sourceMappingURL=index.js.map

package/lib/service/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/service/index.ts"],"names":[],"mappings":"AAIA,cAAc,uCAAuC,CAAC;AACtD,cAAc,yBAAyB,CAAC;AACxC,cAAc,qDAAqD,CAAC"}

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

@@ -0,0 +1,42 @@
+import { TransactionIsolationLevel } from '../model/transaction-isolation-level.js';
+import { QueryBuilder } from '../query-builder/query-builder.js';
+import { GroupByCountResult } from '../model/group-by-count-result.js';
+import { QueryDefaults } from '../model/query-defaults.js';
+import { QueryTextProvider } from '../model/query-text-provider.js';
+import { ModifyResults } from '../model/modify-results.js';
+import { DatabaseAccessProvider } from '../model/database-access-provider.js';
+import { DatabaseAccess } from '../model/database-access.js';
+import { RequestResults } from '../model/request-results.js';
+import { DatabaseRequestType } from '../model/database-request-type.js';
+import { NamedParameterDatabaseServiceConfig } from '../model/named-parameter-database-service-config.js';
+export declare class NamedParameterDatabaseService {
+    private cfg;
+    constructor(cfg: NamedParameterDatabaseServiceConfig);
+    getConfig(): NamedParameterDatabaseServiceConfig;
+    nonPooledExtraConfiguration(): Record<string, any>;
+    nonPooledMode(): boolean;
+    get databaseAccessProvider(): DatabaseAccessProvider;
+    getQueryDefaults(): QueryDefaults;
+    getQueryProvider(): QueryTextProvider;
+    createNonPooledDatabaseAccess(queryDefaults: QueryDefaults, additionalConfig?: Record<string, any>): Promise<DatabaseAccess>;
+    fetchQueryRawTextByName(queryPath: string): string;
+    queryBuilder(queryPath?: string): QueryBuilder;
+    executeUpdateOrInsertByName(queryPath: string, params?: object, timeoutMS?: number): Promise<ModifyResults>;
+    buildAndExecuteUpdateOrInsert(queryBuilder: QueryBuilder, timeoutMS?: number): Promise<ModifyResults>;
+    buildAndExecuteUpdateOrInsertWithRetry(queryBuilder: QueryBuilder, maxRetries: number, timeoutMS?: number): Promise<ModifyResults>;
+    executeQueryByName<Row>(queryPath: string, params: object, timeoutMS?: number): Promise<Row[]>;
+    executeQueryByNameSingle<Row>(queryPath: string, params: object, timeoutMS?: number): Promise<Row | null>;
+    buildAndExecute<Row>(queryBuilder: QueryBuilder, timeoutMS?: number): Promise<Row[]>;
+    buildAndExecuteSingle<Row>(queryBuilder: QueryBuilder, timeoutMS?: number): Promise<Row | null>;
+    buildAndExecuteFetchTotalRows(queryBuilder: QueryBuilder, groupBy?: string, timeoutMS?: number): Promise<GroupByCountResult[]>;
+    executeQueryWithMeta<Row>(requestType: DatabaseRequestType, transactionIsolationLevel: TransactionIsolationLevel, query: string, fields?: object, timeoutMS?: number, debugComment?: string): Promise<RequestResults<Row>>;
+    shutdown(): Promise<boolean>;
+    testDbFailure(): Promise<void>;
+    changeNextQueryTransactionIsolationLevel<Row>(tx: TransactionIsolationLevel | null): Promise<RequestResults<Row> | null>;
+    forceCloseConnectionForTesting(): Promise<boolean>;
+    private innerExecutePreparedAsPromiseWithRetryCloseConnection;
+    private innerExecutePreparedAsPromise;
+    getDB(): Promise<DatabaseAccess>;
+    testConnection(logTestResults?: boolean): Promise<number>;
+    resetConnection(): Promise<boolean>;
+}