@bitblit/ratchet-rdbms 4.0.1-alpha

package/CHANGELOG.md

@@ -0,0 +1,19 @@
+# Changelog
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Notes]
+Alpha releases are exactly what they sound like - places where I am trying out new things that aren't ready for prime
+time, but I need published to see how they interact with the rest of my software ecosystem.  If you use an alpha
+package without knowing why it is alpha you'll get exactly what you deserve.
+
+## [Unreleased]
+
+## In Flight
+
+## [4.0.x] - 2018-03-23
+### Initial Release
+- Basic support for RDBMS stuff
+

package/License.txt

@@ -0,0 +1,13 @@
+Copyright 2022-2023 Christopher Weiss
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,41 @@
+# @bitblit/ratchet-rdbms
+
+Typescript library to simplify using relational database systems by externalizing the queries.
+
+## Introduction
+
+Meant to be very similar to the ibatis/mybatis library in Java, which has the right level of abstraction
+of the RDBMS in my opinion.
+
+You may wish to read [the changelog](CHANGELOG.md)
+
+## Installation
+
+`yarn install @bitblit/ratchet-rdbms`
+
+## Usage
+
+### Paginator
+(To understand the terminology here you may want to read [this](https://nordicapis.com/understanding-5-types-of-web-api-pagination/))
+
+This library natively supports:
+* Cursor pagination (use columnName, sort, min, limit)
+* Keyset API pagination (use columnName, sort, min, max, maybe limit)
+* Seek API pagination (use columnName, sort, min, max, maybe limit)
+* Time-based (use columnName on a time column, sort, min, max, maybe limit)
+
+This library doesn't support offset pagination (e.g., using limit/offset in MySql) out of the box.  It does this
+on purpose - in general for large datasets offset pagination is an anti-pattern, and I hope by not supporting
+it natively it'll make it a little less likely that I'll use it when I get in a rush.  Obviously its possible
+to still implement it using this architecture.  At some point in the future I may give in and do it.
+
+# Testing
+
+Ha! No, seriously - all testing is done using Jest.  To run them:
+
+`yarn test`
+
+# Contributing
+
+Pull requests are welcome, although I'm not sure why you'd be interested!
+

package/lib/build/ratchet-rdbms-info.d.ts

@@ -0,0 +1,5 @@
+import { BuildInformation } from '@bitblit/ratchet-common';
+export declare class RatchetRdbmsInfo {
+    private constructor();
+    static buildInformation(): BuildInformation;
+}

package/lib/index.d.ts

@@ -0,0 +1,28 @@
+export * from './named-parameter-maria-db-service.js';
+export * from './non-pooled-mysql-style-connection-provider.js';
+export * from './rds-mysql-style-connection-provider.js';
+export * from './ssh-tunnel-service.js';
+export * from './transactional-named-parameter-maria-db-service.js';
+export * from './build/ratchet-rdbms-info.js';
+export * from './model/connection-config.js';
+export * from './model/db-config.js';
+export * from './model/group-by-count-result.js';
+export * from './model/paginated-results.js';
+export * from './model/pagination-bounds.js';
+export * from './model/paginator.js';
+export * from './model/query-defaults.js';
+export * from './model/query-text-provider.js';
+export * from './model/sort-direction.js';
+export * from './model/ssh-config.js';
+export * from './model/transaction-isolation-level.js';
+export * from './model/mysql/mysql-master-status.js';
+export * from './model/mysql/mysql-results-wrapper.js';
+export * from './model/mysql/mysql-slave-status.js';
+export * from './model/mysql/mysql-style-connection-provider.js';
+export * from './model/mysql/mysql-update-results.js';
+export * from './model/ssh/ssh-tunnel-config.js';
+export * from './model/ssh/ssh-tunnel-container.js';
+export * from './query-builder/query-builder-result.js';
+export * from './query-builder/query-builder.js';
+export * from './query-builder/query-util.js';
+export * from './util/relational-database-utils.js';

package/lib/index.mjs

@@ -0,0 +1,2 @@
+import{StringRatchet as t,Logger as e,RequireRatchet as n,ErrorRatchet as r,PromiseRatchet as i,StopWatch as s,TimeoutToken as o,DurationRatchet as a}from"@bitblit/ratchet-common";import c from"lodash";import u from"mysql2/promise";import l from"get-port";import*as h from"tunnel-ssh";class d{fields=[];replacements={};addReplacement(t,...e){this.replacements=Object.assign(this.replacements,t),this.addFields(...e)}appendReplacement(t,e,...n){this.replacements[t]=this.replacements[t]+e,this.addFields(...n)}addFields(...t){this.fields=this.fields.concat(...t)}getFields(){return this.fields}getReplacements(){return this.replacements}static sqlInjectionUnsafeParamRenderer(e){const n=e=>"string"==typeof e?'"'+e+'"':t.safeString(e);return Array.isArray(e)?e.map((t=>n(t))).join(","):n(e)}static renderQueryStringForPasteIntoTool(t,e,n=d.sqlInjectionUnsafeParamRenderer){const r=e??{};let i=d.reformatQueryForLogging(t);if(i){const t=Object.keys(r);t.sort(((t,e)=>e.length-t.length));for(const e of t){const t=":"+e,s=n(r[e]);i=i.split(t).join(s)}i.endsWith(";")||(i+=";")}return i}static reformatQueryForLogging(n,r=80){let i=r;if(!t.trimToNull(n))return null;let s="",o=t.trimToEmpty(n).split("\n").join(" ").split("\r").join(" ");for(;o.length>i;){let n=Math.min(o.length,i);for(;n>0&&![" ",","].includes(o.charAt(n));)n--;n>0?(s+=o.substring(0,n)+"\n",o=t.trimToEmpty(o.substring(n))):(e.silly("Input contains a string longer than the max line length - bumping"),i+=2)}return s+(o.length>0?o:"")}}var y,m;!function(t){t.Default="Default",t.ReadUncommitted="READ UNCOMMITTED"}(y||(y={}));class g{connection;constructor(t){this.connection=t,n.notNullOrUndefined(t)}async getConnection(){return this.connection}async clearConnectionCache(){return e.info("clearConnectionCache ignored - not pooled"),!0}}class f{query;namedParams;paginator;transactionIsolationLevel;constructor(t,e,n,r){this.query=t,this.namedParams=e,this.paginator=n,this.transactionIsolationLevel=r}}!function(t){t.Asc="Asc",t.Desc="Desc"}(m||(m={}));class w{static ALLOWED_SQL_CONSTRUCT=/^[a-z0-9_.`]+$/i;queryProvider;query;meta=Object.freeze({});sqlConstructs={};namedParams={};conditionals={};debugComment="";paginator;debugAnnotateMode=!1;transactionIsolationLevel=y.Default;constructor(t){this.queryProvider=t}clone(){const t=new w(this.queryProvider);return this.query&&t.withBaseQuery(this.query),t.sqlConstructs=c.clone(this.sqlConstructs),t.namedParams=c.clone(this.namedParams),t.conditionals=c.clone(this.conditionals),t.paginator=c.clone(this.paginator),t.debugComment=this.debugComment,t.transactionIsolationLevel=this.transactionIsolationLevel,t}withTransactionIsolationLevel(t){return this.transactionIsolationLevel=t,this}withDebugComment(t){return this.debugComment=t,this}appendDebugComment(t){return this.debugComment=this.debugComment+t,this}withNamedQuery(e){return this.query=this.queryProvider.fetchQuery(e),t.trimToNull(this.query)||r.throwFormattedErr("Requested query that does not exist : %s",e),this.meta=Object.freeze({queryPath:e}),this.withDebugComment(" "+e+" "),this}withBaseQuery(t){this.query=t}withSqlConstruct(t,e){return this.sqlConstructs[t]=e,this}withSqlConstructs(t){return this.sqlConstructs=Object.assign(this.sqlConstructs,t),this}removeParam(t){return delete this.namedParams[t],this}paramNames(){return Object.keys(this.namedParams)}withParam(t,e){return this.namedParams[t]=e,this}withParams(t){return this.namedParams=Object.assign(this.namedParams,t),this}withExpandedParam(t,n,r){const i=t+"Length";let s=this.fetchCopyOfParam(i)??0;if(s>0&&!r){e.silly("Old item found and not extending - removing old params");this.paramNames().filter((e=>e.startsWith(t))).forEach((t=>this.removeParam(t))),s=0}this.withParam(i,n.length+s);for(let e=0;e<n.length;e++){const r=n[e];if("object"==typeof r&&r)for(const n of Object.keys(r)){const i=t+n.charAt(0).toUpperCase()+n.slice(1)+(e+s);this.withParam(i,r[n])}else{const n=t+e;this.withParam(n,r)}}return this}withConditional(t,e=!0){return this.conditionals[t]=e,this}withConditionals(t){return this.conditionals=Object.assign(this.conditionals,t),this}withPaginator(t){return n.notNullOrUndefined(t,"paginator"),n.notNullOrUndefined(t.cn,"paginator.cn"),n.true(t.min||t.max||t.l,"paginator must have some limit"),t.s=t.s??m.Asc,this.paginator=t,this}fetchCopyOfParam(t){return this.namedParams[t]}fetchCopyOfConditional(t){return this.conditionals[t]}containsParam(t){return null!=this.namedParams[t]}getDebugComment(){return this.debugComment}containsConditional(t){return null!=this.conditionals[t]}build(){return this.clone().internalBuild(!1)}buildUnfiltered(){return this.clone().internalBuild(!0)}internalBuild(t){return this.applyQueryFragments(),this.applyConditionalBlocks(),this.applyRepeatBlocks(),this.applyPagination(t),this.applySqlConstructs(),this.applyComments(),this.runQueryChecks(),this.stripNonAsciiParams(),new f((this.query??"").trim(),this.namedParams,this.paginator,this.transactionIsolationLevel)}stripNonAsciiParams(){const e=t.stripNonAscii(JSON.stringify(this.namedParams));this.namedParams=JSON.parse(e)}runQueryChecks(){const t=[...this.query?.matchAll(/['"]:[A-z-]*['"]/gm)??[]];t.length>0&&e.warn("The resulting query contains quoted named params check this this is intended. Instances found: %s",t.join(", "))}applyComments(){if(this.debugComment.length&&this.query){const t=this.query.indexOf(" "),e=this.debugComment;this.query=this.query.substring(0,t+1)+`/*${e}*/`+this.query.substring(t+1)}}applySqlConstructs(){for(const e of Object.keys(this.sqlConstructs)){let n;const r=this.sqlConstructs[e];if(Array.isArray(r))r.forEach((t=>{if("string"!=typeof t||!t.match(w.ALLOWED_SQL_CONSTRUCT))throw new Error(`sql construct entry ${t} is invalid value must be alphanumeric only.`)})),n=r.join(", ");else if(n=t.safeString(r),n.length>0&&!n.match(w.ALLOWED_SQL_CONSTRUCT))throw new Error(`sql construct ${n} is invalid value must be alphanumeric only.`);const i=["update","insert","delete","drop","select"];for(const t of i)if(n.toLowerCase().includes(t))throw new Error(`sql construct ${n} is invalid value must not contain reserved word ${t}.`);const s=`##sqlConstruct:${e}##`;for(;this.query?.includes(s);)this.query=this.query.replace(s,n)}}applyRepeatBlocks(){const t="<repeat";for(;;){const e=this.query?.indexOf(t);if(-1===e||!this.query||"number"!=typeof e)return;const n=this.query.indexOf(">",e);if(-1==n)throw new Error(`Invalid query when finding end symbol matching > in ${this.query} check that you have closed all your tags correctly.`);const r="count=";let i="";const s="join=";let o;const a=this.query.substring(e+7,n).trim().split(" ");for(const t of a)t.includes(r)&&(i=t.substring(t.indexOf(r)+r.length)),t.includes(s)&&(o=t.substring(t.indexOf(s)+s.length));const c="</repeat>",u=this.query.indexOf(c),l=this.query.substring(n+1,u);this.query=this.query.substring(0,e)+this.query.substring(u+c.length);const h=this.namedParams[i.substring(1)];for(let t=0;t<h;t++){let n=l;o&&0!=t&&(n+=o);let r=n.indexOf("::");for(;-1!=r;){const e=n.indexOf("::",r+2);if(-1==e)throw new Error(`Invalid query when finding end symbol matching :: check that you have closed all your tags correctly. Query: ${this.query} `);const i=n.substring(r+2,e);n=n.replace("::"+i+"::",":"+i+t),r=n.indexOf("::")}this.query=this.query.substring(0,e)+n+this.query.substring(e)}}}applyQueryFragments(){for(;;){const t=this.query?.indexOf("[[");if(-1==t||!this.query||"number"!=typeof t)return;const e=this.query.indexOf("]]",t);if(-1==e)throw new Error(`Invalid query when finding end symbol matching ]] in ${this.query} check that you have closed all your tags correctly.`);const n=this.query.substring(t+2,e),r=this.queryProvider.fetchQuery(n);if(!r)throw new Error(`Invalid query, query fragment ${n} not found in named queries.`);this.query=this.query.replace(`[[${n}]]`,r)}}applyPagination(e){const n="##pagination##";if(!e&&this.paginator){const e=this.paginator.s==m.Desc?m.Desc:m.Asc,n=t.safeString(e);if(this.paginator.min||this.paginator.max){let t="WHERE ##sqlConstruct:queryBuilderPaginatorWhere##";this.withSqlConstruct("queryBuilderPaginatorWhere",this.paginator.cn),this.paginator.min&&(t+=">= :queryBuilderPaginatorWhereMin",this.withParam("queryBuilderPaginatorWhereMin",this.paginator.min)),this.paginator.max&&(this.paginator.min&&(t+=" AND ##sqlConstruct:queryBuilderPaginatorWhere##"),t+="< :queryBuilderPaginatorWhereMax",this.withParam("queryBuilderPaginatorWhereMax",this.paginator.max)),this.query+=t}this.query+=` ORDER BY ##sqlConstruct:queryBuilderOrderBy## ${n}`,this.withSqlConstruct("queryBuilderOrderBy",this.paginator.cn),this.paginator.l&&(this.query+=" LIMIT :queryBuilderLimit",this.withParam("queryBuilderLimit",this.paginator.l))}if(e&&this.query){const t=this.query.indexOf(n);-1!=t&&(this.query="SELECT COUNT(*) "+this.query.substring(t+14))}for(;this.query?.includes(n);)this.query=this.query.replace(n,"")}applyConditionalBlocks(){const t=">>";for(;;){const e=this.query?.indexOf("<<");if(-1==e||!this.query||"number"!=typeof e)return;const n=this.query.indexOf(t,e);if(-1==n)throw new Error(`Invalid query when finding end symbol matching ${t} in ${this.query} check that you have closed all your tags correctly.`);const r=this.query.substring(e+2,n),i=r.replace(":",""),s=`<</${r}>>`,o=this.query.indexOf(s);if(-1==o)throw new Error(`Invalid query when finding conditional end tag matching ${s} in ${this.query} check that your query contains an exact match of this tag.`);let a=this.query.substring(n+2,o);if(r.startsWith(":")){const t=this.namedParams[i];(null==t||Array.isArray(t)&&0==t.length)&&(a="")}else{const t=this.conditionals[i.replace("!","")];null!=t&&t!=i.startsWith("!")||(a="")}this.debugAnnotateMode&&(a="/* conditional "+i+"*/"),this.query=this.query.substring(0,e)+a+this.query.substring(o+s.length)}}}class p{queryProvider;connectionProvider;queryDefaults;static LONG_QUERY_TIME_MS=8500;serviceName="TBD";constructor(t,e,n){this.queryProvider=t,this.connectionProvider=e,this.queryDefaults=n,this.serviceName="NamedParameterMariaDb"}getQueryDefaults(){return this.queryDefaults}getQueryProvider(){return this.queryProvider}async createNonPooledMysqlStyleConnectionProvider(t,n){if(e.info("createTransactional :  %s : %j",t,n),!this.connectionProvider.createNonPooledDatabaseConnection)throw new Error("Connection provider does not implement createNonPooledDatabaseConnection");const r=await this.connectionProvider.createNonPooledDatabaseConnection(t,n);if(!r)throw new Error(`Connection could not be created for DB type ${t}`);return new g(r)}fetchQueryRawTextByName(t){return this.queryProvider.fetchQuery(t)}queryBuilder(t){const e=new w(this.queryProvider);return t&&e.withNamedQuery(t),e}async executeUpdateOrInsertByName(t,e,n=this.queryDefaults.timeoutMS){const r=this.queryBuilder(t).withParams(e??{});return this.buildAndExecuteUpdateOrInsert(r,n)}async buildAndExecuteUpdateOrInsert(t,e=this.queryDefaults.timeoutMS){const n=t.build();return(await this.executeQueryWithMeta(n.transactionIsolationLevel,n.query,n.namedParams,e)).results}async buildAndExecuteUpdateOrInsertWithRetry(t,n,r=this.queryDefaults.timeoutMS){let s,o=0;for(;!s&&o<n;){o++;try{s=await this.buildAndExecuteUpdateOrInsert(t,r)}catch(t){e.info("Caught problem while trying to update/insert : %d : %s ",o,t),await i.wait(2e3*o)}}if(!s)throw new Error(`Failed to execute update after ${n} retries`);return s}async executeQueryByName(t,e,n=this.queryDefaults.timeoutMS){const r=this.queryBuilder(t).withParams(e);return await this.buildAndExecute(r,n)}async executeQueryByNameSingle(t,e,n=this.queryDefaults.timeoutMS){const r=this.queryBuilder(t).withParams(e),i=await this.buildAndExecute(r,n);return 1===i.length?i[0]:null}async buildAndExecute(t,e=this.queryDefaults.timeoutMS){const n=t.build();return(await this.executeQueryWithMeta(n.transactionIsolationLevel,n.query,n.namedParams,e,t.getDebugComment())).results}async buildAndExecuteSingle(t,e=this.queryDefaults.timeoutMS){const n=t.build(),r=await this.executeQueryWithMeta(n.transactionIsolationLevel,n.query,n.namedParams,e,t.getDebugComment());return 1===r.results.length?r.results[0]:null}async buildAndExecuteFetchTotalRows(t,n="",r=this.queryDefaults.timeoutMS){const i=t.buildUnfiltered();let s=i.query.replace("COUNT(*)",`${n} as groupByField, COUNT(*) as count`);s=`${s} GROUP BY ${n}`,e.info("Unfiltered query %s",i.query);return(await this.executeQueryWithMeta(i.transactionIsolationLevel,s,i.namedParams,r)).results}async executeQueryWithMeta(t,n,r={},c=this.queryDefaults.timeoutMS,u){const l=new s;c||(c=this.queryDefaults.timeoutMS),await this.changeNextQueryTransactionIsolationLevel(t);const h=await i.timeout(this.innerExecutePreparedAsPromiseWithRetryCloseConnection(n,r,void 0),"Query:"+n,c);if(o.isTimeoutToken(h)){e.warn("Timed out (after %s): %j",a.colonFormatMsDuration(c),h);const t=a.colonFormatMsDuration(c);throw new Error(`Timed out (after ${t}) waiting for query : ${n}`)}const d=h;return d.results||e.error("DB:executeQueryWithMeta:Failure: %j",d),u&&l.elapsedMS()>p.LONG_QUERY_TIME_MS&&e.info("NamedParameterMariaDbService long query: %s, %s",u,l.dump()),d}async shutdown(){let t;e.info("Shutting down %s service",this.serviceName);try{t=await this.connectionProvider.clearConnectionCache()}catch(n){e.error("Failure trying to shutdown : %s",n,n),t=!1}return t}async testConnection(t=!1){t||e.info("Running connection test");const n=(await this.executeQueryWithMeta(y.Default,"SELECT UNIX_TIMESTAMP(now())*1000 AS test")).results,r=1===n.length?n[0].test:null;return t||e.info("Test returned : %j",r),r}async testDbFailure(){await this.executeQueryWithMeta(y.Default,"this is a bad query")}async changeNextQueryTransactionIsolationLevel(t){return t&&t!==y.Default?(e.debug("Setting tx to %s",t),await this.innerExecutePreparedAsPromiseWithRetryCloseConnection("SET TRANSACTION ISOLATION LEVEL "+t,{})):null}async forceCloseConnectionForTesting(){e.warn("Forcing connection closed for testing");const t=await this.getDB();try{return await t.end(),e.info("Connection has been ended, but not set to null"),!0}catch(t){return e.error("Error closing connection : %s",t,t),!1}}async innerExecutePreparedAsPromiseWithRetryCloseConnection(t,n={},s=1){try{return await this.innerExecutePreparedAsPromise(t,n)}catch(o){const a=r.asErr(o);if(a.message.includes("closed state")||a.message.includes("This socket has been ended by the other party")||a.message.includes("ETIMEDOUT")||a.message.includes("NeonNoConnection")||a.message.includes("ER_LOCK_WAIT_TIMEOUT")){const r=Math.min(1e3*s);if(e.warn("Found closed connection or lock timeout - clearing and attempting retry after %d (try %d of 3) (%s)",r,s,a.message),s<4){const o=await this.connectionProvider.clearConnectionCache();return e.info("Clear connection cache returned %s",o),await i.wait(r),this.innerExecutePreparedAsPromiseWithRetryCloseConnection(t,n,s+1)}throw e.warn("Ran out of retries"),new Error("Connection closed and cannot retry any more - dying horribly")}e.error("Named Param DB Query Failed : Err: %s Query: %s Params: %j",a,t,n,a);try{const r=await this.getDB();e.error("-----\nFor paste into tooling only: \n\n%s\n\n",d.renderQueryStringForPasteIntoTool(t,n,(t=>r.escape(t))))}catch(t){e.error("Really bad - failed trying to get the conn for logging : %s",t)}throw a}}async innerExecutePreparedAsPromise(t,n={}){const r=await this.getDB();r.config.namedPlaceholders=!0;const i=new s;try{const[s,o]=await r.query(t,n),a={results:s,fields:o};return e.debug("Success : Finished query : %s\n%s\n\nParams : %j",i.dump(),d.reformatQueryForLogging(t),n),e.debug("-----\nFor paste into tooling only : \n\n%s\n\n",d.renderQueryStringForPasteIntoTool(t,n,(t=>r.escape(t)))),a}finally{r.config.namedPlaceholders=!1}}async getDB(){const t=await this.connectionProvider.getConnection(this.queryDefaults.databaseName);if(!t)throw new Error("NeonNoConnection : getConnection returned null - likely failed to get connection from db");return t}async resetConnection(){let t=!1;e.info("Resetting connection");try{await this.connectionProvider.clearConnectionCache();t=!!await this.testConnection(),e.info("Reset connection returning %s",t)}catch(t){e.error("Failed to reset connection : %s",t)}return t}}class C{inConfigPromise;additionalConfig;ssh;static DEFAULT_CONNECTION_OPTIONS={multipleStatements:!0};tunnels=new Map;dbPromise=new Map;configPromise;constructor(t,n=C.DEFAULT_CONNECTION_OPTIONS,r){this.inConfigPromise=t,this.additionalConfig=n,this.ssh=r,this.configPromise=this.prepareConnectionConfig(t),e.info("Added shutdown handler to the process (Only once per instantiation)"),this.addShutdownHandlerToProcess()}get usingSshTunnel(){return!!this.ssh}addShutdownHandlerToProcess(){process.on("exit",(()=>{e.info("Process is shutting down, closing connections"),this.clearConnectionCache().catch((t=>{e.error("Shutdown connection failed : %s",t)}))}))}async clearConnectionCache(){e.info("Clearing connection cache for RdsMysqlConnectionProvider");const t=this.dbPromise,n=this.tunnels;if(this.dbPromise=new Map,this.tunnels=new Map,t.size>0){const n=Array.from(t.keys());for(const i of n){e.info("Shutting down connection : %s",i);const n=t.get(i);try{const t=await n;t?(await t.destroy(),e.info("Finished destroying old connection")):e.warn("Could not get old connection, so not destroying it")}catch(t){if(!r.asErr(t).message.includes("closed state"))throw e.error("Something went wrong closing the connection : %s",t),t}}}if(n.size>0){const t=Array.from(n.keys());for(const r of t)try{e.info("Shutting down SSH tunnel: %s",r);const t=n.get(r);t?await this.ssh.shutdown(t):e.warn("Could not get old tunnel, so not destroying it"),e.info("SSH Tunnel closed")}catch(t){e.error("Failure closing old tunnel : %s",t)}}return e.info("Old db and tunnel removed"),!1}async getConnection(t){if(!this.dbPromise.has(t)){const e=await this.getDbConfig(t),n=this.createDatabaseConnection(e,this.additionalConfig,!0);this.dbPromise.set(t,n)}return this.dbPromise.get(t)}async createNonPooledDatabaseConnection(t,n=C.DEFAULT_CONNECTION_OPTIONS){e.info("Creating non-pooled connection for %s",t.databaseName);const r=await this.getDbConfig(t.databaseName);return await this.createDatabaseConnection(r,n,!1)}async getDbConfig(t){e.info("RdsMysqlStyleConnectionProvider:getDbConfig:Initiating promise for %s",t);const n=(await this.configPromise).dbList.find((e=>e.label===t.toLowerCase()));if(!n)throw new Error(`Cannot find any connection config named ${t}`);return n}async createDatabaseConnection(t,n=C.DEFAULT_CONNECTION_OPTIONS,r,i){e.debug("In RdsMysqlStyleConnectionProvider:createDatabaseConnection : %s",t.label);const s=c.omit(c.clone(t),"label","tunnelPort");if(this.usingSshTunnel&&t.tunnelPort){let n=this.tunnels.get(t.label);if(!n){e.debug("Creating SSH tunnel from local port %d to remote host %s and port %d",t.tunnelPort,t.host,t.port);const r=await i;n=await this.ssh.createSSHTunnel(r,t.host,t.port,t.tunnelPort),this.tunnels.set(t.label,n)}s.port=n.serverOptions.port??-1,s.host="localhost"}let o;e.debug("Opening connection for RdsMysqlStyleConnectionProvider");try{o=await u.createConnection({...n,...s})}catch(t){return e.info("Failed trying to create connection : %s : clearing for retry",t),void(r&&(this.dbPromise=new Map))}return o.on("error",(t=>{e.info("An error was detected on the connection : %s : Clearing",t),this.clearConnectionCache().then((t=>{e.info("Connection cleared: %s",t)})).catch((t=>e.error("Failed to clear RDS connection cache: %j",t)))})),e.info("Added error handler to db, there are now %d error handlers and %d shutdown handlers",o.rawListeners("error").length,process.rawListeners("exit").length),o}async prepareConnectionConfig(t){n.notNullOrUndefined(t,"input");const e=await t;if(n.true(e.dbList.length>0,"input.dbList"),this.usingSshTunnel)for(const t of e.dbList)t.tunnelPort=await l();return e}}class q{async shutdown(t){if(!t.connection)return e.info("Not shutting down tunnel - non-tunnel passed"),!1;try{return e.info("Shutting down SSH Tunnel"),t.connection.end(),t.server.close(),!0}catch(t){return e.error("Error closing ssh tunnel : %s",t),!1}}async createSSHTunnel(t,n,r,i){const s={autoClose:!0},o={port:i},a={srcAddr:"localhost",srcPort:i,dstAddr:n,dstPort:r},[c,u]=await h.createTunnel(s,o,t,a);c.on("error",(t=>{e.warn("SSH Server Error : %s",t)}));return{tunnelOptions:s,serverOptions:o,sshOptions:t,forwardOptions:a,server:c,connection:u}}}class b extends p{myQueryProvider;myConnectionProvider;myQueryDefaults;currentTxFlag;static async create(t,n,r){e.info("createTransactionalNamedParameterMariaDbService :  %j : %j",n,r);const i=await t.createNonPooledMysqlStyleConnectionProvider(n,r);return new b(t.getQueryProvider(),i,n)}constructor(t,e,n){super(t,e,n),this.myQueryProvider=t,this.myConnectionProvider=e,this.myQueryDefaults=n}async cleanShutdown(){e.info("cleanShutdown");try{const t=await this.myConnectionProvider.getConnection();t&&(e.info("Shutting down connection"),t.destroy())}catch(t){e.info("Failure shutting down single-use connection : %s",t)}}async startTransaction(){if(this.currentTxFlag)r.throwFormattedErr("Tried to start a new transaction while one is already in progress : %s",this.currentTxFlag);else{this.currentTxFlag=t.createRandomHexString(10),e.info("Starting a transaction : %s",this.currentTxFlag);const n=await this.myConnectionProvider.getConnection();await(n?.beginTransaction())}}async commitTransaction(){if(this.currentTxFlag){e.info("commit a transaction : %s",this.currentTxFlag);const t=await this.myConnectionProvider.getConnection();await(t?.commit()),this.currentTxFlag=void 0}else r.throwFormattedErr("Cannot commit transaction - none in process")}async rollBackTransaction(){if(this.currentTxFlag){e.info("rollBack a transaction : %s",this.currentTxFlag);const t=await this.myConnectionProvider.getConnection();await(t?.rollback()),this.currentTxFlag=void 0}else r.throwFormattedErr("Cannot rollBack transaction - none in process")}async buildAndExecuteUpdateOrInsertInTransaction(t,n=this.myQueryDefaults.timeoutMS){e.info("buildAndExecuteUpdateOrInsertInTransaction"),await this.startTransaction();try{const e=await this.buildAndExecuteUpdateOrInsert(t,n);return await this.commitTransaction(),e}catch(t){return e.error("Failed - rolling back transaction : %s",t,t),await this.rollBackTransaction(),null}}async buildAndExecuteInTransaction(t,n=this.myQueryDefaults.timeoutMS){e.info("buildAndExecuteInTransaction"),await this.startTransaction();try{const e=await this.buildAndExecute(t,n);return await this.commitTransaction(),e}catch(t){return e.error("Failed - rolling back transaction : %s",t,t),await this.rollBackTransaction(),null}}static async oneStepBuildAndExecuteUpdateOrInsertInTransaction(t,n,r=t.getQueryDefaults().timeoutMS,i){let s,o=null;try{s=await b.create(t,t.getQueryDefaults(),i),o=await s.buildAndExecuteUpdateOrInsertInTransaction(n,r)}catch(t){e.error("Failure in oneStepBuildAndExecuteUpdateOrInsertInTransaction : %j : %s",n,t,t)}finally{s&&await s.cleanShutdown()}return o}static async oneStepBuildAndExecuteInTransaction(t,n,r=t.getQueryDefaults().timeoutMS,i){let s,o=null;try{s=await b.create(t,t.getQueryDefaults(),i),o=await s.buildAndExecuteInTransaction(n,r)}catch(t){e.error("Failure in oneStepbuildAndExecuteInTransaction : %j : %s",n,t,t)}finally{s&&await s.cleanShutdown()}return o}}class P{constructor(){}static buildInformation(){return{version:"LOCAL-SNAPSHOT",hash:"LOCAL-HASH",branch:"LOCAL-BRANCH",tag:"LOCAL-TAG",timeBuiltISO:"LOCAL-TIME-ISO",notes:"LOCAL-NOTES"}}}class T{static async uploadObjectArrayToTable(t,r,i,s=!1){if(n.notNullOrUndefined(t,"db"),n.notNullOrUndefined(r,"tableName"),n.notNullOrUndefined(i,"data"),e.info("Writing %d items to %s (clear: %s)",i.length,r,s),s){e.info("Clearing table %s",r);const{results:n}=await t.executeQueryWithMeta(y.Default,"DELETE FROM "+r,{});e.info("Removed %d rows",n.affectedRows)}const o=new Set(i.flatMap((t=>Object.keys(t)))),a=Array.from(o);e.info("Found columns : %j",a);const c="INSERT INTO "+r+" ("+a.join(",")+") VALUES :multiValue",{results:u}=await t.executeQueryWithMeta(y.Default,c,{multiValue:i}),l=u.affectedRows;return e.info("Wrote %d rows",l),l!==i.length&&e.warn("Should have written %d but wrote %d",i.length,l),l}}export{p as NamedParameterMariaDbService,g as NonPooledMysqlStyleConnectionProvider,w as QueryBuilder,f as QueryBuilderResult,d as QueryUtil,P as RatchetRdbmsInfo,C as RdsMysqlStyleConnectionProvider,T as RelationalDatabaseUtils,m as SortDirection,q as SshTunnelService,y as TransactionIsolationLevel,b as TransactionalNamedParameterMariaDbService};
+//# sourceMappingURL=index.mjs.map

package/lib/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":["../src/query-builder/query-util.ts","../src/model/transaction-isolation-level.ts","../src/model/sort-direction.ts","../src/non-pooled-mysql-style-connection-provider.ts","../src/query-builder/query-builder-result.ts","../src/query-builder/query-builder.ts","../src/named-parameter-maria-db-service.ts","../src/rds-mysql-style-connection-provider.ts","../src/ssh-tunnel-service.ts","../src/transactional-named-parameter-maria-db-service.ts","../src/build/ratchet-rdbms-info.ts","../src/util/relational-database-utils.ts"],"sourcesContent":[null,null,null,null,null,null,null,null,null,null,null,null],"names":["QueryUtil","fields","replacements","addReplacement","replacement","this","Object","assign","addFields","appendReplacement","replacementKey","appendValue","concat","getFields","getReplacements","static","value","rFn","val","StringRatchet","safeString","Array","isArray","map","s","join","query","inFields","transform","sqlInjectionUnsafeParamRenderer","rval","reformatQueryForLogging","keys","sort","b","a","length","key","find","repl","split","endsWith","qry","inMaxLineLength","maxLineLength","trimToNull","loggableQuery","cleaned","trimToEmpty","idx","Math","min","includes","charAt","substring","Logger","silly","TransactionIsolationLevel","SortDirection","NonPooledMysqlStyleConnectionProvider","connection","constructor","RequireRatchet","notNullOrUndefined","async","info","QueryBuilderResult","namedParams","paginator","transactionIsolationLevel","QueryBuilder","queryProvider","meta","freeze","sqlConstructs","conditionals","debugComment","debugAnnotateMode","Default","clone","withBaseQuery","_","withTransactionIsolationLevel","level","withDebugComment","comment","appendDebugComment","withNamedQuery","queryPath","fetchQuery","ErrorRatchet","throwFormattedErr","baseQuery","withSqlConstruct","withSqlConstructs","params","removeParam","paramNames","withParam","withParams","withExpandedParam","keyPrefix","values","extendIfExists","lengthParamName","oldSize","fetchCopyOfParam","filter","startsWith","forEach","i","paramKey","toUpperCase","slice","withConditional","tag","state","withConditionals","withPaginator","cn","true","max","l","Asc","paramName","fetchCopyOfConditional","conditionalName","containsParam","undefined","getDebugComment","containsConditional","build","internalBuild","buildUnfiltered","unfiltered","applyQueryFragments","applyConditionalBlocks","applyRepeatBlocks","applyPagination","applySqlConstructs","applyComments","runQueryChecks","stripNonAsciiParams","trim","reduced","stripNonAscii","JSON","stringify","parse","quotedNamedParams","matchAll","warn","firstSpaceIndex","indexOf","v","match","ALLOWED_SQL_CONSTRUCT","Error","sqlReservedWords","word","toLowerCase","rawKey","replace","startSymbol","startIndex","endIndex","countSymbol","countParam","joinSymbol","joinString","param","endTag","endTagIndex","repeatedContent","endSymbol","count","indexedContent","startParamTagIndex","endParamTagIndex","rawName","namedQueryElement","paginationRawKey","sortDirEnum","Desc","sortDir","wc","paginationSplitIndex","rawTag","conditional","NamedParameterMariaDbService","connectionProvider","queryDefaults","serviceName","getQueryDefaults","getQueryProvider","additionalConfig","createNonPooledDatabaseConnection","newConn","fetchQueryRawTextByName","queryBuilder","timeoutMS","builder","buildAndExecuteUpdateOrInsert","executeQueryWithMeta","results","maxRetries","res","retry","err","PromiseRatchet","wait","buildAndExecute","resp","groupBy","sw","StopWatch","changeNextQueryTransactionIsolationLevel","result","timeout","innerExecutePreparedAsPromiseWithRetryCloseConnection","TimeoutToken","isTimeoutToken","DurationRatchet","colonFormatMsDuration","duration","error","elapsedMS","LONG_QUERY_TIME_MS","dump","clearConnectionCache","quietMode","rows","timestamp","test","tx","debug","conn","getDB","end","retryCount","innerExecutePreparedAsPromise","errIn","asErr","message","cleared","renderQueryStringForPasteIntoTool","escape","err2","config","namedPlaceholders","outFields","getConnection","databaseName","testConnection","RdsMysqlStyleConnectionProvider","inConfigPromise","ssh","multipleStatements","tunnels","Map","dbPromise","configPromise","DEFAULT_CONNECTION_OPTIONS","prepareConnectionConfig","addShutdownHandlerToProcess","usingSshTunnel","process","on","catch","oldDbHooks","oldSshTunnels","size","hookNames","from","hookName","oldDbHook","get","oldConn","destroy","tunnelNames","tunnelName","tunnel","shutdown","name","has","dbConfig","getDbConfig","createDatabaseConnection","set","dbList","label","dbCfg","clearCacheOnConnectionFailure","sshConfigPromise","cfgCopy","omit","tunnelPort","host","port","sshConfig","createSSHTunnel","serverOptions","maria","createConnection","then","rawListeners","inputPromise","cfg","getPort","SshTunnelService","server","close","sshOptions","dstHost","dstPort","localPort","tunnelOptions","autoClose","forwardOptions","srcAddr","srcPort","dstAddr","TunnelSsh","createTunnel","TransactionalNamedParameterMariaDbService","myQueryProvider","myConnectionProvider","myQueryDefaults","currentTxFlag","src","connProv","createNonPooledMysqlStyleConnectionProvider","super","createRandomHexString","beginTransaction","commit","rollback","startTransaction","commitTransaction","rollBackTransaction","handler","create","buildAndExecuteUpdateOrInsertInTransaction","cleanShutdown","buildAndExecuteInTransaction","RatchetRdbmsInfo","version","hash","branch","timeBuiltISO","notes","RelationalDatabaseUtils","db","tableName","data","clearTableFirst","deleteResult","affectedRows","columns","Set","flatMap","row","colArr","sql","insertResult","multiValue","inserted"],"mappings":"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"}

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

@@ -0,0 +1,4 @@
+import { DbConfig } from './db-config.js';
+export interface ConnectionConfig {
+    dbList: DbConfig[];
+}

package/lib/model/db-config.d.ts

@@ -0,0 +1,9 @@
+export interface DbConfig {
+    label: string;
+    tunnelPort?: number;
+    host: string;
+    port: number;
+    user: string;
+    password: string;
+    database: string;
+}

package/lib/model/group-by-count-result.d.ts

@@ -0,0 +1,4 @@
+export interface GroupByCountResult {
+    groupByField: string;
+    count: number;
+}

package/lib/model/mysql/mysql-master-status.d.ts

@@ -0,0 +1,6 @@
+export interface MysqlMasterStatus {
+    File: string;
+    Position: number;
+    Binlog_Do_DB: string;
+    Binlog_Ignore_DB: string;
+}

package/lib/model/mysql/mysql-results-wrapper.d.ts

@@ -0,0 +1,5 @@
+import { FieldPacket } from 'mysql2';
+export interface MysqlResultsWrapper<T> {
+    results: T;
+    fields: FieldPacket[];
+}

package/lib/model/mysql/mysql-slave-status.d.ts

@@ -0,0 +1,52 @@
+export interface MysqlSlaveStatus {
+    Slave_IO_State: string;
+    Master_Host: string;
+    Master_User: string;
+    Master_Port: number;
+    Connect_Retry: number;
+    Master_Log_File: string;
+    Read_Master_Log_Pos: number;
+    Relay_Log_File: string;
+    Relay_Log_Pos: number;
+    Relay_Master_Log_File: string;
+    Slave_IO_Running: string;
+    Slave_SQL_Running: string;
+    Replicate_Do_DB: string;
+    Replicate_Ignore_DB: string;
+    Replicate_Do_Table: string;
+    Replicate_Ignore_Table: string;
+    Replicate_Wild_Do_Table: string;
+    Replicate_Wild_Ignore_Table: string;
+    Last_Errno: number;
+    Last_Error: string;
+    Skip_Counter: number;
+    Exec_Master_Log_Pos: number;
+    Relay_Log_Space: number;
+    Until_Condition: string;
+    Until_Log_File: string;
+    Until_Log_Pos: number;
+    Master_SSL_Allowed: string;
+    Master_SSL_CA_File: string;
+    Master_SSL_CA_Path: string;
+    Master_SSL_Cert: string;
+    Master_SSL_Cipher: string;
+    Master_SSL_Key: string;
+    Seconds_Behind_Master: number;
+    Master_SSL_Verify_Server_Cert: string;
+    Last_IO_Errno: number;
+    Last_IO_Error: string;
+    Last_SQL_Errno: number;
+    Last_SQL_Error: string;
+    Replicate_Ignore_Server_Ids: string;
+    Master_Server_Id: number;
+    Master_SSL_Crl: string;
+    Master_SSL_Crlpath: string;
+    Using_Gtid: string;
+    Gtid_IO_Pos: string;
+    Replicate_Do_Domain_Ids: string;
+    Replicate_Ignore_Domain_Ids: string;
+    Parallel_Mode: string;
+    SQL_Delay: number;
+    SQL_Remaining_Delay: string;
+    Slave_SQL_Running_State: string;
+}

package/lib/model/mysql/mysql-style-connection-provider.d.ts

@@ -0,0 +1,7 @@
+import { Connection, ConnectionOptions } from 'mysql2/promise';
+import { QueryDefaults } from '../query-defaults.js';
+export interface MysqlStyleConnectionProvider {
+    getConnection(name?: string): Promise<Connection | undefined>;
+    clearConnectionCache(): Promise<boolean>;
+    createNonPooledDatabaseConnection?(queryDefaults: QueryDefaults, additionalConfig?: ConnectionOptions): Promise<Connection | undefined>;
+}

package/lib/model/mysql/mysql-update-results.d.ts

@@ -0,0 +1,9 @@
+export interface MysqlUpdateResults {
+    fieldCount: number;
+    affectedRows: number;
+    insertId: number;
+    info: string;
+    serverStatus: number;
+    warningStatus: number;
+    changedRows: number;
+}

package/lib/model/paginated-results.d.ts

@@ -0,0 +1,5 @@
+export interface PaginatedResults<T> {
+    results: T[];
+    nextPageToken: string;
+    prevPageToken: string;
+}

package/lib/model/pagination-bounds.d.ts

@@ -0,0 +1,6 @@
+export interface PaginationBounds<T> {
+    cn: string;
+    min: T;
+    max: T;
+    count: number;
+}

package/lib/model/paginator.d.ts

@@ -0,0 +1,9 @@
+import { SortDirection } from './sort-direction.js';
+import { JwtTokenBase } from '@bitblit/ratchet-common';
+export interface Paginator<T> extends JwtTokenBase {
+    cn: string;
+    min?: T;
+    max?: T;
+    s?: SortDirection;
+    l?: number;
+}

package/lib/model/query-defaults.d.ts

@@ -0,0 +1,4 @@
+export interface QueryDefaults {
+    databaseName: string;
+    timeoutMS: number;
+}

package/lib/model/query-text-provider.d.ts

@@ -0,0 +1,4 @@
+export interface QueryTextProvider {
+    fetchQuery(queryDottedPath: string): string;
+    fetchAllQueries(): Record<string, string>;
+}

package/lib/model/sort-direction.d.ts

@@ -0,0 +1,4 @@
+export declare enum SortDirection {
+    Asc = "Asc",
+    Desc = "Desc"
+}

package/lib/model/ssh/ssh-tunnel-config.d.ts

@@ -0,0 +1,7 @@
+export interface SshTunnelConfig {
+    keepAlive: boolean;
+    username: string;
+    host: string;
+    port: number;
+    privateKey: string;
+}

package/lib/model/ssh/ssh-tunnel-container.d.ts

@@ -0,0 +1,12 @@
+/// <reference types="node" />
+import type { ListenOptions, Server } from 'net';
+import type { ConnectConfig, Connection } from 'ssh2';
+import * as TunnelSsh from 'tunnel-ssh';
+export interface SshTunnelContainer {
+    tunnelOptions: TunnelSsh.TunnelOptions;
+    serverOptions: ListenOptions;
+    sshOptions: ConnectConfig;
+    forwardOptions: TunnelSsh.ForwardOptions;
+    server: Server;
+    connection?: Connection;
+}

package/lib/model/ssh-config.d.ts

@@ -0,0 +1,5 @@
+export interface SshConfig {
+    localPort: number;
+    dbHost: string;
+    dbPort: number;
+}

package/lib/model/transaction-isolation-level.d.ts

@@ -0,0 +1,4 @@
+export declare enum TransactionIsolationLevel {
+    Default = "Default",
+    ReadUncommitted = "READ UNCOMMITTED"
+}

package/lib/named-parameter-maria-db-service.d.ts

@@ -0,0 +1,41 @@
+import { Connection, ConnectionOptions } from 'mysql2/promise';
+import { MysqlResultsWrapper } from './model/mysql/mysql-results-wrapper.js';
+import { MysqlUpdateResults } from './model/mysql/mysql-update-results.js';
+import { TransactionIsolationLevel } from './model/transaction-isolation-level.js';
+import { NonPooledMysqlStyleConnectionProvider } from './non-pooled-mysql-style-connection-provider.js';
+import { MysqlStyleConnectionProvider } from './model/mysql/mysql-style-connection-provider.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';
+export declare class NamedParameterMariaDbService {
+    private queryProvider;
+    private connectionProvider;
+    private queryDefaults;
+    private static LONG_QUERY_TIME_MS;
+    private serviceName;
+    constructor(queryProvider: QueryTextProvider, connectionProvider: MysqlStyleConnectionProvider, queryDefaults: QueryDefaults);
+    getQueryDefaults(): QueryDefaults;
+    getQueryProvider(): QueryTextProvider;
+    createNonPooledMysqlStyleConnectionProvider(queryDefaults: QueryDefaults, additionalConfig?: ConnectionOptions): Promise<NonPooledMysqlStyleConnectionProvider>;
+    fetchQueryRawTextByName(queryPath: string): string;
+    queryBuilder(queryPath?: string): QueryBuilder;
+    executeUpdateOrInsertByName(queryPath: string, params?: object, timeoutMS?: number): Promise<MysqlUpdateResults>;
+    buildAndExecuteUpdateOrInsert(queryBuilder: QueryBuilder, timeoutMS?: number): Promise<MysqlUpdateResults>;
+    buildAndExecuteUpdateOrInsertWithRetry(queryBuilder: QueryBuilder, maxRetries: number, timeoutMS?: number): Promise<MysqlUpdateResults>;
+    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>(transactionIsolationLevel: TransactionIsolationLevel, query: string, fields?: object, timeoutMS?: number, debugComment?: string): Promise<MysqlResultsWrapper<Row>>;
+    shutdown(): Promise<boolean>;
+    testConnection(quietMode?: boolean): Promise<number | null>;
+    testDbFailure(): Promise<void>;
+    changeNextQueryTransactionIsolationLevel<Row>(tx: TransactionIsolationLevel | null): Promise<MysqlResultsWrapper<Row> | null>;
+    forceCloseConnectionForTesting(): Promise<boolean>;
+    private innerExecutePreparedAsPromiseWithRetryCloseConnection;
+    private innerExecutePreparedAsPromise;
+    getDB(): Promise<Connection>;
+    resetConnection(): Promise<boolean>;
+}

package/lib/non-pooled-mysql-style-connection-provider.d.ts

@@ -0,0 +1,8 @@
+import { Connection } from 'mysql2/promise';
+import { MysqlStyleConnectionProvider } from './model/mysql/mysql-style-connection-provider.js';
+export declare class NonPooledMysqlStyleConnectionProvider implements MysqlStyleConnectionProvider {
+    private connection;
+    constructor(connection: Connection);
+    getConnection(): Promise<Connection>;
+    clearConnectionCache(): Promise<boolean>;
+}

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

@@ -0,0 +1,9 @@
+import { TransactionIsolationLevel } from '../model/transaction-isolation-level.js';
+import { Paginator } from '../model/paginator.js';
+export declare class QueryBuilderResult {
+    query: string;
+    namedParams: Record<string, unknown>;
+    paginator?: Paginator<any>;
+    transactionIsolationLevel: TransactionIsolationLevel;
+    constructor(query: string, namedParams: Record<string, unknown>, paginator: Paginator<any> | undefined, transactionIsolationLevel: TransactionIsolationLevel);
+}

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

@@ -0,0 +1,52 @@
+import { QueryBuilderResult } from './query-builder-result.js';
+import { TransactionIsolationLevel } from '../model/transaction-isolation-level.js';
+import { QueryTextProvider } from '../model/query-text-provider.js';
+import { Paginator } from '../model/paginator.js';
+export declare class QueryBuilder {
+    static readonly ALLOWED_SQL_CONSTRUCT: RegExp;
+    private readonly queryProvider;
+    private query?;
+    meta: {
+        queryPath?: string;
+    };
+    private sqlConstructs;
+    private namedParams;
+    private conditionals;
+    private debugComment;
+    private paginator?;
+    private debugAnnotateMode;
+    private transactionIsolationLevel;
+    constructor(queryProvider: QueryTextProvider);
+    clone(): QueryBuilder;
+    withTransactionIsolationLevel(level: TransactionIsolationLevel): QueryBuilder;
+    withDebugComment(comment: string): QueryBuilder;
+    appendDebugComment(comment: string): QueryBuilder;
+    withNamedQuery(queryPath: string): QueryBuilder;
+    withBaseQuery(baseQuery: string): void;
+    withSqlConstruct(key: string, value: unknown): QueryBuilder;
+    withSqlConstructs(params: Record<string, unknown>): QueryBuilder;
+    removeParam(key: string): QueryBuilder;
+    paramNames(): string[];
+    withParam(key: string, value: unknown): QueryBuilder;
+    withParams(params: unknown): QueryBuilder;
+    withExpandedParam(keyPrefix: string, values: unknown[], extendIfExists: boolean): QueryBuilder;
+    withConditional(tag: string, state?: boolean): QueryBuilder;
+    withConditionals(params: Record<string, boolean>): QueryBuilder;
+    withPaginator(paginator: Paginator<any>): QueryBuilder;
+    fetchCopyOfParam<T>(paramName: string): T | undefined;
+    fetchCopyOfConditional<T>(conditionalName: string): T | undefined;
+    containsParam(paramName: string): boolean;
+    getDebugComment(): string;
+    containsConditional(conditionalName: string): boolean;
+    build(): QueryBuilderResult;
+    buildUnfiltered(): QueryBuilderResult;
+    protected internalBuild(unfiltered: boolean): QueryBuilderResult;
+    private stripNonAsciiParams;
+    private runQueryChecks;
+    private applyComments;
+    applySqlConstructs(): void;
+    private applyRepeatBlocks;
+    private applyQueryFragments;
+    private applyPagination;
+    private applyConditionalBlocks;
+}

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

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,12 @@
+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;
+}

package/lib/rds-mysql-style-connection-provider.d.ts

@@ -0,0 +1,23 @@
+import { Connection, ConnectionOptions } from 'mysql2/promise';
+import { SshTunnelService } from './ssh-tunnel-service.js';
+import { MysqlStyleConnectionProvider } from './model/mysql/mysql-style-connection-provider.js';
+import { ConnectionConfig } from './model/connection-config.js';
+import { QueryDefaults } from './model/query-defaults.js';
+export declare class RdsMysqlStyleConnectionProvider implements MysqlStyleConnectionProvider {
+    private inConfigPromise;
+    private additionalConfig;
+    private ssh?;
+    static DEFAULT_CONNECTION_OPTIONS: ConnectionOptions;
+    private tunnels;
+    private dbPromise;
+    private readonly configPromise;
+    constructor(inConfigPromise: Promise<ConnectionConfig>, additionalConfig?: ConnectionOptions, ssh?: SshTunnelService);
+    get usingSshTunnel(): boolean;
+    private addShutdownHandlerToProcess;
+    clearConnectionCache(): Promise<boolean>;
+    getConnection(name: string): Promise<Connection | undefined>;
+    createNonPooledDatabaseConnection(queryDefaults: QueryDefaults, additionalConfig?: ConnectionOptions): Promise<Connection | undefined>;
+    private getDbConfig;
+    private createDatabaseConnection;
+    private prepareConnectionConfig;
+}

package/lib/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/transactional-named-parameter-maria-db-service.d.ts

@@ -0,0 +1,23 @@
+import { NamedParameterMariaDbService } from './named-parameter-maria-db-service.js';
+import { MysqlStyleConnectionProvider } from './model/mysql/mysql-style-connection-provider.js';
+import { ConnectionOptions } from 'mysql2/promise';
+import { QueryBuilder } from './query-builder/query-builder.js';
+import { MysqlUpdateResults } from './model/mysql/mysql-update-results.js';
+import { QueryDefaults } from './model/query-defaults.js';
+import { QueryTextProvider } from './model/query-text-provider.js';
+export declare class TransactionalNamedParameterMariaDbService extends NamedParameterMariaDbService {
+    private myQueryProvider;
+    private myConnectionProvider;
+    private myQueryDefaults;
+    private currentTxFlag?;
+    static create(src: NamedParameterMariaDbService, queryDefaults: QueryDefaults, additionalConfig?: ConnectionOptions): Promise<TransactionalNamedParameterMariaDbService>;
+    constructor(myQueryProvider: QueryTextProvider, myConnectionProvider: MysqlStyleConnectionProvider, myQueryDefaults: QueryDefaults);
+    cleanShutdown(): Promise<void>;
+    startTransaction(): Promise<void>;
+    commitTransaction(): Promise<void>;
+    rollBackTransaction(): Promise<void>;
+    buildAndExecuteUpdateOrInsertInTransaction(queryBuilder: QueryBuilder, timeoutMS?: number): Promise<MysqlUpdateResults | null>;
+    buildAndExecuteInTransaction<T>(queryBuilder: QueryBuilder, timeoutMS?: number): Promise<T[] | null>;
+    static oneStepBuildAndExecuteUpdateOrInsertInTransaction(src: NamedParameterMariaDbService, queryBuilder: QueryBuilder, timeoutMS?: number, additionalConfig?: ConnectionOptions): Promise<MysqlUpdateResults | null>;
+    static oneStepBuildAndExecuteInTransaction<T>(src: NamedParameterMariaDbService, queryBuilder: QueryBuilder, timeoutMS?: number, additionalConfig?: ConnectionOptions): Promise<T[] | null>;
+}

package/lib/util/relational-database-utils.d.ts

@@ -0,0 +1,4 @@
+import { NamedParameterMariaDbService } from '../named-parameter-maria-db-service.js';
+export declare class RelationalDatabaseUtils {
+    static uploadObjectArrayToTable<Item extends object>(db: NamedParameterMariaDbService, tableName: string, data: Item[], clearTableFirst?: boolean): Promise<number>;
+}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@bitblit/ratchet-rdbms",
+  "version": "4.0.1-alpha",
+  "description": "Ratchet tooling for working with relational databases",
+  "sideEffects": false,
+  "type": "module",
+  "files": [
+    "lib/*",
+    "bin/*"
+  ],
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "import": "./lib/index.mjs"
+    }
+  },
+  "contributors": [
+    "Christopher Weiss <bitblit@gmail.com>",
+    "Zach Herridge"
+  ],
+  "husky": {
+    "hooks": {
+      "pre-commit": "pretty-quick --staged"
+    }
+  },
+  "prettier": {
+    "printWidth": 140,
+    "singleQuote": true,
+    "arrowParens": "always"
+  },
+  "config": {},
+  "scripts": {
+    "watch": "tsc-watch",
+    "clean": "shx rm -Rf lib",
+    "test": "cross-env NODE_OPTIONS=--experimental-vm-modules jest",
+    "docs": "typedoc",
+    "lint": "eslint src/**/*.ts",
+    "lint-fix": "eslint --fix src/**/*.ts",
+    "generate-barrels": "barrelsby -q --delete -d src -e .*\\.spec\\.ts && sed -i 's/\\x27;/.js\\x27;/' src/index.ts",
+    "build": "yarn clean && yarn generate-barrels && shx mkdir -p lib/native  && rollup -c rollup.config.js",
+    "force-build": "tsc --build --force"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bitblit/Ratchet"
+  },
+  "keywords": [
+    "wrench",
+    "utility"
+  ],
+  "bugs": {
+    "url": "https://github.com/bitblit/Ratchet/issues"
+  },
+  "homepage": "https://github.com/bitblit/Ratchet#readme",
+  "engines": {
+    "node": ">=14.18"
+  },
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@bitblit/ratchet-common": "4.0.1-alpha",
+    "get-port": "6.1.2",
+    "mysql2": "3.3.1",
+    "tunnel-ssh": "5.0.5"
+  },
+  "peerDependencies": {
+  },
+  "resolutions": {},
+  "devDependencies": {}
+}