@fluidware-it/mysql2-client 0.0.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   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,3 @@
+# Fluidware Mysql2 Client
+
+helper library to expose high-level functions for mysql2 connection

package/build/esm/Config.d.ts

@@ -0,0 +1,4 @@
+import { ConnectionOptions } from 'mysql2';
+export declare const USE_READ_COMMITTED_ISOLATION: boolean;
+export declare function getMysqlConnectionOptions(prefix?: string): ConnectionOptions;
+//# sourceMappingURL=Config.d.ts.map

package/build/esm/Config.js

@@ -0,0 +1,57 @@
+/*
+ * Copyright Fluidware srl
+ *
+ * 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
+ *
+ *      https://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.
+ */
+import { EnvParse } from '@fluidware-it/node-utils';
+import * as fs from 'fs';
+export var USE_READ_COMMITTED_ISOLATION = EnvParse.envBool('USE_READ_COMMITTED_ISOLATION', false);
+function getDbPassword(DB_PASSWORD_FILE, DB_PASSWORD) {
+    if (DB_PASSWORD_FILE) {
+        return fs.readFileSync(DB_PASSWORD_FILE, 'utf8');
+    }
+    else {
+        return DB_PASSWORD;
+    }
+}
+export function getMysqlConnectionOptions(prefix) {
+    if (prefix === void 0) { prefix = ''; }
+    var DB_HOST = EnvParse.envString("".concat(prefix, "DB_HOST"), 'localhost');
+    var DB_PORT = EnvParse.envInt("".concat(prefix, "DB_PORT"), 3306);
+    var DB_USER = EnvParse.envStringRequired("".concat(prefix, "DB_USER"));
+    var DB_NAME = EnvParse.envString("".concat(prefix, "DB_NAME"), DB_USER);
+    var DB_CONN_OPTIONS = EnvParse.envJSON("".concat(prefix, "DB_NAME"), {});
+    var DB_PASSWORD = EnvParse.envString("".concat(prefix, "DB_PASSWORD"), '');
+    var DB_PASSWORD_FILE = EnvParse.envString("".concat(prefix, "DB_PASSWORD_FILE"), '');
+    if (!DB_PASSWORD && !DB_PASSWORD_FILE) {
+        throw new Error('DB_PASSWORD or DB_PASSWORD_FILE env is required');
+    }
+    var dbPassword = getDbPassword(DB_PASSWORD_FILE, DB_PASSWORD);
+    var dbName = DB_NAME || DB_USER;
+    var dbHost = DB_HOST || '127.0.0.1';
+    var dbPort = Number(DB_PORT) || 3306;
+    var dbOptions = {
+        host: dbHost,
+        port: dbPort,
+        user: DB_USER,
+        password: dbPassword,
+        database: dbName
+    };
+    if (DB_CONN_OPTIONS) {
+        // See https://github.com/mysqljs/mysql#connection-options for all possible options
+        var customOptions = JSON.parse(DB_CONN_OPTIONS);
+        Object.assign(dbOptions, customOptions);
+    }
+    return dbOptions;
+}
+//# sourceMappingURL=Config.js.map

package/build/esm/Config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Config.js","sourceRoot":"","sources":["../../src/Config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAGzB,MAAM,CAAC,IAAM,4BAA4B,GAAG,QAAQ,CAAC,OAAO,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAC;AAEpG,SAAS,aAAa,CAAC,gBAAwB,EAAE,WAAmB;IAClE,IAAI,gBAAgB,EAAE;QACpB,OAAO,EAAE,CAAC,YAAY,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;KAClD;SAAM;QACL,OAAO,WAAW,CAAC;KACpB;AACH,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,MAAW;IAAX,uBAAA,EAAA,WAAW;IACnD,IAAM,OAAO,GAAG,QAAQ,CAAC,SAAS,CAAC,UAAG,MAAM,YAAS,EAAE,WAAW,CAAC,CAAC;IACpE,IAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,UAAG,MAAM,YAAS,EAAE,IAAI,CAAC,CAAC;IAC1D,IAAM,OAAO,GAAG,QAAQ,CAAC,iBAAiB,CAAC,UAAG,MAAM,YAAS,CAAC,CAAC;IAC/D,IAAM,OAAO,GAAG,QAAQ,CAAC,SAAS,CAAC,UAAG,MAAM,YAAS,EAAE,OAAO,CAAC,CAAC;IAChE,IAAM,eAAe,GAAG,QAAQ,CAAC,OAAO,CAAC,UAAG,MAAM,YAAS,EAAE,EAAE,CAAC,CAAC;IACjE,IAAM,WAAW,GAAG,QAAQ,CAAC,SAAS,CAAC,UAAG,MAAM,gBAAa,EAAE,EAAE,CAAC,CAAC;IACnE,IAAM,gBAAgB,GAAG,QAAQ,CAAC,SAAS,CAAC,UAAG,MAAM,qBAAkB,EAAE,EAAE,CAAC,CAAC;IAE7E,IAAI,CAAC,WAAW,IAAI,CAAC,gBAAgB,EAAE;QACrC,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;KACpE;IAED,IAAM,UAAU,GAAG,aAAa,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAC;IAChE,IAAM,MAAM,GAAG,OAAO,IAAI,OAAO,CAAC;IAClC,IAAM,MAAM,GAAG,OAAO,IAAI,WAAW,CAAC;IACtC,IAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;IAEvC,IAAM,SAAS,GAAG;QAChB,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,UAAU;QACpB,QAAQ,EAAE,MAAM;KACjB,CAAC;IACF,IAAI,eAAe,EAAE;QACnB,mFAAmF;QACnF,IAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QAClD,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;KACzC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC","sourcesContent":["/*\n * Copyright Fluidware srl\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *      https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { EnvParse } from '@fluidware-it/node-utils';\nimport * as fs from 'fs';\nimport { ConnectionOptions } from 'mysql2';\n\nexport const USE_READ_COMMITTED_ISOLATION = EnvParse.envBool('USE_READ_COMMITTED_ISOLATION', false);\n\nfunction getDbPassword(DB_PASSWORD_FILE: string, DB_PASSWORD: string): string {\n  if (DB_PASSWORD_FILE) {\n    return fs.readFileSync(DB_PASSWORD_FILE, 'utf8');\n  } else {\n    return DB_PASSWORD;\n  }\n}\n\nexport function getMysqlConnectionOptions(prefix = ''): ConnectionOptions {\n  const DB_HOST = EnvParse.envString(`${prefix}DB_HOST`, 'localhost');\n  const DB_PORT = EnvParse.envInt(`${prefix}DB_PORT`, 3306);\n  const DB_USER = EnvParse.envStringRequired(`${prefix}DB_USER`);\n  const DB_NAME = EnvParse.envString(`${prefix}DB_NAME`, DB_USER);\n  const DB_CONN_OPTIONS = EnvParse.envJSON(`${prefix}DB_NAME`, {});\n  const DB_PASSWORD = EnvParse.envString(`${prefix}DB_PASSWORD`, '');\n  const DB_PASSWORD_FILE = EnvParse.envString(`${prefix}DB_PASSWORD_FILE`, '');\n\n  if (!DB_PASSWORD && !DB_PASSWORD_FILE) {\n    throw new Error('DB_PASSWORD or DB_PASSWORD_FILE env is required');\n  }\n\n  const dbPassword = getDbPassword(DB_PASSWORD_FILE, DB_PASSWORD);\n  const dbName = DB_NAME || DB_USER;\n  const dbHost = DB_HOST || '127.0.0.1';\n  const dbPort = Number(DB_PORT) || 3306;\n\n  const dbOptions = {\n    host: dbHost,\n    port: dbPort,\n    user: DB_USER,\n    password: dbPassword,\n    database: dbName\n  };\n  if (DB_CONN_OPTIONS) {\n    // See https://github.com/mysqljs/mysql#connection-options for all possible options\n    const customOptions = JSON.parse(DB_CONN_OPTIONS);\n    Object.assign(dbOptions, customOptions);\n  }\n  return dbOptions;\n}\n"]}

package/build/esm/DbClient.d.ts

@@ -0,0 +1,26 @@
+import { Connection, RowDataPacket, ResultSetHeader, ProcedureCallPacket, FieldPacket } from 'mysql2/promise';
+import { ConnectionOptions } from 'mysql2';
+interface ConnectionWrap extends Connection {
+    run<T extends ResultSetHeader | ResultSetHeader[] | RowDataPacket[] | RowDataPacket[][] | ProcedureCallPacket>(sql: string, phs?: (string | number | boolean)[]): Promise<{
+        rows: T;
+        cols: FieldPacket[];
+    }>;
+}
+export declare class DbClient {
+    private connection?;
+    private connectionOptions;
+    constructor(connectionOptionsOrPrefix?: ConnectionOptions | string);
+    open(): Promise<void>;
+    getConnection(): ConnectionWrap | undefined;
+    close(): Promise<void>;
+    startTransaction(): Promise<void>;
+    commit(closeTransaction?: boolean): Promise<void>;
+    rollback(closeTransaction?: boolean): Promise<void>;
+    all(sql: string, phs?: (string | number | boolean)[]): Promise<RowDataPacket[]>;
+    get(sql: string, phs?: (string | number | boolean)[]): Promise<RowDataPacket>;
+    insert(sql: string, phs?: (string | number | boolean)[]): Promise<number>;
+    update(sql: string, phs?: (string | number | boolean)[]): Promise<number>;
+    delete(sql: string, phs?: (string | number | boolean)[]): Promise<number>;
+}
+export {};
+//# sourceMappingURL=DbClient.d.ts.map

package/build/esm/DbClient.js

@@ -0,0 +1,291 @@
+/*
+ * Copyright Fluidware srl
+ *
+ * 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
+ *
+ *      https://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.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __read = (this && this.__read) || function (o, n) {
+    var m = typeof Symbol === "function" && o[Symbol.iterator];
+    if (!m) return o;
+    var i = m.call(o), r, ar = [], e;
+    try {
+        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
+    }
+    catch (error) { e = { error: error }; }
+    finally {
+        try {
+            if (r && !r.done && (m = i["return"])) m.call(i);
+        }
+        finally { if (e) throw e.error; }
+    }
+    return ar;
+};
+import { createConnection } from 'mysql2/promise';
+import { getMysqlConnectionOptions, USE_READ_COMMITTED_ISOLATION } from './Config';
+var DbClient = /** @class */ (function () {
+    function DbClient(connectionOptionsOrPrefix) {
+        if (connectionOptionsOrPrefix) {
+            if (typeof connectionOptionsOrPrefix === 'string') {
+                this.connectionOptions = getMysqlConnectionOptions(connectionOptionsOrPrefix);
+            }
+            else {
+                this.connectionOptions = connectionOptionsOrPrefix;
+            }
+        }
+        else {
+            this.connectionOptions = getMysqlConnectionOptions('');
+        }
+    }
+    DbClient.prototype.open = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var _a;
+            var _this = this;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        _a = this;
+                        return [4 /*yield*/, createConnection(this.connectionOptions)];
+                    case 1:
+                        _a.connection = (_b.sent());
+                        this.connection.run = function (sql, phs) { return __awaiter(_this, void 0, void 0, function () {
+                            var _a, rows, cols;
+                            return __generator(this, function (_b) {
+                                switch (_b.label) {
+                                    case 0:
+                                        if (!this.connection) {
+                                            throw new Error('run() called but no connection available');
+                                        }
+                                        return [4 /*yield*/, this.connection.execute(sql, phs)];
+                                    case 1:
+                                        _a = __read.apply(void 0, [_b.sent(), 2]), rows = _a[0], cols = _a[1];
+                                        return [2 /*return*/, {
+                                                rows: rows,
+                                                cols: cols
+                                            }];
+                                }
+                            });
+                        }); };
+                        return [2 /*return*/];
+                }
+            });
+        });
+    };
+    DbClient.prototype.getConnection = function () {
+        return this.connection;
+    };
+    DbClient.prototype.close = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (!this.connection) return [3 /*break*/, 2];
+                        return [4 /*yield*/, this.connection.end()];
+                    case 1:
+                        _a.sent();
+                        _a.label = 2;
+                    case 2: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    DbClient.prototype.startTransaction = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (!this.connection) {
+                            throw new Error('no connection available');
+                        }
+                        if (!USE_READ_COMMITTED_ISOLATION) return [3 /*break*/, 2];
+                        return [4 /*yield*/, this.connection.execute("SET SESSION tx_isolation='read-committed'")];
+                    case 1:
+                        _a.sent();
+                        _a.label = 2;
+                    case 2: return [4 /*yield*/, this.connection.execute('SET AUTOCOMMIT=0')];
+                    case 3:
+                        _a.sent();
+                        return [2 /*return*/];
+                }
+            });
+        });
+    };
+    DbClient.prototype.commit = function (closeTransaction) {
+        if (closeTransaction === void 0) { closeTransaction = true; }
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (!this.connection) {
+                            throw new Error('no connection available');
+                        }
+                        return [4 /*yield*/, this.connection.execute('COMMIT')];
+                    case 1:
+                        _a.sent();
+                        if (!closeTransaction) return [3 /*break*/, 3];
+                        return [4 /*yield*/, this.connection.execute('SET AUTOCOMMIT=1')];
+                    case 2:
+                        _a.sent();
+                        _a.label = 3;
+                    case 3: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    DbClient.prototype.rollback = function (closeTransaction) {
+        if (closeTransaction === void 0) { closeTransaction = true; }
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (!this.connection) {
+                            throw new Error('no connection available');
+                        }
+                        return [4 /*yield*/, this.connection.execute('ROLLBACK')];
+                    case 1:
+                        _a.sent();
+                        if (!closeTransaction) return [3 /*break*/, 3];
+                        return [4 /*yield*/, this.connection.execute('SET AUTOCOMMIT=1')];
+                    case 2:
+                        _a.sent();
+                        _a.label = 3;
+                    case 3: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    DbClient.prototype.all = function (sql, phs) {
+        return __awaiter(this, void 0, void 0, function () {
+            var res;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (!this.connection) {
+                            throw new Error('no connection available');
+                        }
+                        return [4 /*yield*/, this.connection.run(sql, phs)];
+                    case 1:
+                        res = _a.sent();
+                        return [2 /*return*/, res.rows];
+                }
+            });
+        });
+    };
+    DbClient.prototype.get = function (sql, phs) {
+        return __awaiter(this, void 0, void 0, function () {
+            var res;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (!this.connection) {
+                            throw new Error('no connection available');
+                        }
+                        return [4 /*yield*/, this.connection.run(sql, phs)];
+                    case 1:
+                        res = _a.sent();
+                        if (res.rows.length > 1)
+                            throw new Error('get returned more than one row');
+                        return [2 /*return*/, res.rows[0]];
+                }
+            });
+        });
+    };
+    DbClient.prototype.insert = function (sql, phs) {
+        return __awaiter(this, void 0, void 0, function () {
+            var res;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (!this.connection) {
+                            throw new Error('no connection available');
+                        }
+                        return [4 /*yield*/, this.connection.run(sql, phs)];
+                    case 1:
+                        res = _a.sent();
+                        return [2 /*return*/, res.rows.insertId || res.rows.affectedRows];
+                }
+            });
+        });
+    };
+    DbClient.prototype.update = function (sql, phs) {
+        return __awaiter(this, void 0, void 0, function () {
+            var res;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (!this.connection) {
+                            throw new Error('no connection available');
+                        }
+                        return [4 /*yield*/, this.connection.run(sql, phs)];
+                    case 1:
+                        res = _a.sent();
+                        return [2 /*return*/, res.rows.affectedRows];
+                }
+            });
+        });
+    };
+    DbClient.prototype.delete = function (sql, phs) {
+        return __awaiter(this, void 0, void 0, function () {
+            var res;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (!this.connection) {
+                            throw new Error('no connection available');
+                        }
+                        return [4 /*yield*/, this.connection.run(sql, phs)];
+                    case 1:
+                        res = _a.sent();
+                        return [2 /*return*/, res.rows.affectedRows];
+                }
+            });
+        });
+    };
+    return DbClient;
+}());
+export { DbClient };
+//# sourceMappingURL=DbClient.js.map

package/build/esm/DbClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DbClient.js","sourceRoot":"","sources":["../../src/DbClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,OAAO,EACL,gBAAgB,EAMjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,yBAAyB,EAAE,4BAA4B,EAAE,MAAM,UAAU,CAAC;AAanF;IAIE,kBAAY,yBAAsD;QAChE,IAAI,yBAAyB,EAAE;YAC7B,IAAI,OAAO,yBAAyB,KAAK,QAAQ,EAAE;gBACjD,IAAI,CAAC,iBAAiB,GAAG,yBAAyB,CAAC,yBAAyB,CAAC,CAAC;aAC/E;iBAAM;gBACL,IAAI,CAAC,iBAAiB,GAAG,yBAAyB,CAAC;aACpD;SACF;aAAM;YACL,IAAI,CAAC,iBAAiB,GAAG,yBAAyB,CAAC,EAAE,CAAC,CAAC;SACxD;IACH,CAAC;IAEK,uBAAI,GAAV;;;;;;;wBACE,KAAA,IAAI,CAAA;wBAAe,qBAAM,gBAAgB,CAAC,IAAI,CAAC,iBAAiB,CAAC,EAAA;;wBAAjE,GAAK,UAAU,GAAG,CAAC,SAA8C,CAAmB,CAAC;wBACrF,IAAI,CAAC,UAAU,CAAC,GAAG,GAAG,UAGpB,GAAW,EACX,GAAmC;;;;;wCAEnC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE;4CACpB,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;yCAC7D;wCACoB,qBAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAI,GAAG,EAAE,GAAG,CAAC,EAAA;;wCAAzD,KAAA,sBAAe,SAA0C,KAAA,EAAxD,IAAI,QAAA,EAAE,IAAI,QAAA;wCACjB,sBAAO;gDACL,IAAI,MAAA;gDACJ,IAAI,MAAA;6CACL,EAAC;;;6BACH,CAAC;;;;;KACH;IAED,gCAAa,GAAb;QACE,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAEK,wBAAK,GAAX;;;;;6BACM,IAAI,CAAC,UAAU,EAAf,wBAAe;wBACjB,qBAAM,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,EAAA;;wBAA3B,SAA2B,CAAC;;;;;;KAE/B;IAEK,mCAAgB,GAAtB;;;;;wBACE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE;4BACpB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;yBAC5C;6BACG,4BAA4B,EAA5B,wBAA4B;wBAC9B,qBAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,2CAA2C,CAAC,EAAA;;wBAA1E,SAA0E,CAAC;;4BAE7E,qBAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAA;;wBAAjD,SAAiD,CAAC;;;;;KACnD;IAEK,yBAAM,GAAZ,UAAa,gBAAuB;QAAvB,iCAAA,EAAA,uBAAuB;;;;;wBAClC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE;4BACpB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;yBAC5C;wBACD,qBAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAA;;wBAAvC,SAAuC,CAAC;6BACpC,gBAAgB,EAAhB,wBAAgB;wBAClB,qBAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAA;;wBAAjD,SAAiD,CAAC;;;;;;KAErD;IAEK,2BAAQ,GAAd,UAAe,gBAAuB;QAAvB,iCAAA,EAAA,uBAAuB;;;;;wBACpC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE;4BACpB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;yBAC5C;wBAED,qBAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,EAAA;;wBAAzC,SAAyC,CAAC;6BACtC,gBAAgB,EAAhB,wBAAgB;wBAClB,qBAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAA;;wBAAjD,SAAiD,CAAC;;;;;;KAErD;IAEK,sBAAG,GAAT,UAAU,GAAW,EAAE,GAAmC;;;;;;wBACxD,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE;4BACpB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;yBAC5C;wBACW,qBAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAkB,GAAG,EAAE,GAAG,CAAC,EAAA;;wBAA1D,GAAG,GAAG,SAAoD;wBAChE,sBAAO,GAAG,CAAC,IAAI,EAAC;;;;KACjB;IAEK,sBAAG,GAAT,UAAU,GAAW,EAAE,GAAmC;;;;;;wBACxD,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE;4BACpB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;yBAC5C;wBACW,qBAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAkB,GAAG,EAAE,GAAG,CAAC,EAAA;;wBAA1D,GAAG,GAAG,SAAoD;wBAChE,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;4BAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;wBAC3E,sBAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAC;;;;KACpB;IAEK,yBAAM,GAAZ,UAAa,GAAW,EAAE,GAAmC;;;;;;wBAC3D,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE;4BACpB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;yBAC5C;wBACW,qBAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAkB,GAAG,EAAE,GAAG,CAAC,EAAA;;wBAA1D,GAAG,GAAG,SAAoD;wBAChE,sBAAO,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,GAAG,CAAC,IAAI,CAAC,YAAY,EAAC;;;;KACnD;IAEK,yBAAM,GAAZ,UAAa,GAAW,EAAE,GAAmC;;;;;;wBAC3D,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE;4BACpB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;yBAC5C;wBACW,qBAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAkB,GAAG,EAAE,GAAG,CAAC,EAAA;;wBAA1D,GAAG,GAAG,SAAoD;wBAChE,sBAAO,GAAG,CAAC,IAAI,CAAC,YAAY,EAAC;;;;KAC9B;IAEK,yBAAM,GAAZ,UAAa,GAAW,EAAE,GAAmC;;;;;;wBAC3D,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE;4BACpB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;yBAC5C;wBACW,qBAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAkB,GAAG,EAAE,GAAG,CAAC,EAAA;;wBAA1D,GAAG,GAAG,SAAoD;wBAChE,sBAAO,GAAG,CAAC,IAAI,CAAC,YAAY,EAAC;;;;KAC9B;IACH,eAAC;AAAD,CAAC,AApHD,IAoHC","sourcesContent":["/*\n * Copyright Fluidware srl\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *      https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  createConnection,\n  Connection,\n  RowDataPacket,\n  ResultSetHeader,\n  ProcedureCallPacket,\n  FieldPacket\n} from 'mysql2/promise';\nimport { getMysqlConnectionOptions, USE_READ_COMMITTED_ISOLATION } from './Config';\nimport { ConnectionOptions } from 'mysql2';\n\ninterface ConnectionWrap extends Connection {\n  run<T extends ResultSetHeader | ResultSetHeader[] | RowDataPacket[] | RowDataPacket[][] | ProcedureCallPacket>(\n    sql: string,\n    phs?: (string | number | boolean)[]\n  ): Promise<{\n    rows: T;\n    cols: FieldPacket[];\n  }>;\n}\n\nexport class DbClient {\n  private connection?: ConnectionWrap;\n  private connectionOptions: ConnectionOptions;\n\n  constructor(connectionOptionsOrPrefix?: ConnectionOptions | string) {\n    if (connectionOptionsOrPrefix) {\n      if (typeof connectionOptionsOrPrefix === 'string') {\n        this.connectionOptions = getMysqlConnectionOptions(connectionOptionsOrPrefix);\n      } else {\n        this.connectionOptions = connectionOptionsOrPrefix;\n      }\n    } else {\n      this.connectionOptions = getMysqlConnectionOptions('');\n    }\n  }\n\n  async open() {\n    this.connection = (await createConnection(this.connectionOptions)) as ConnectionWrap;\n    this.connection.run = async <\n      T extends ResultSetHeader | ResultSetHeader[] | RowDataPacket[] | RowDataPacket[][] | ProcedureCallPacket\n    >(\n      sql: string,\n      phs?: (string | number | boolean)[]\n    ): Promise<{ rows: T; cols: FieldPacket[] }> => {\n      if (!this.connection) {\n        throw new Error('run() called but no connection available');\n      }\n      const [rows, cols] = await this.connection.execute<T>(sql, phs);\n      return {\n        rows,\n        cols\n      };\n    };\n  }\n\n  getConnection(): ConnectionWrap | undefined {\n    return this.connection;\n  }\n\n  async close() {\n    if (this.connection) {\n      await this.connection.end();\n    }\n  }\n\n  async startTransaction() {\n    if (!this.connection) {\n      throw new Error('no connection available');\n    }\n    if (USE_READ_COMMITTED_ISOLATION) {\n      await this.connection.execute(\"SET SESSION tx_isolation='read-committed'\");\n    }\n    await this.connection.execute('SET AUTOCOMMIT=0');\n  }\n\n  async commit(closeTransaction = true) {\n    if (!this.connection) {\n      throw new Error('no connection available');\n    }\n    await this.connection.execute('COMMIT');\n    if (closeTransaction) {\n      await this.connection.execute('SET AUTOCOMMIT=1');\n    }\n  }\n\n  async rollback(closeTransaction = true) {\n    if (!this.connection) {\n      throw new Error('no connection available');\n    }\n\n    await this.connection.execute('ROLLBACK');\n    if (closeTransaction) {\n      await this.connection.execute('SET AUTOCOMMIT=1');\n    }\n  }\n\n  async all(sql: string, phs?: (string | number | boolean)[]) {\n    if (!this.connection) {\n      throw new Error('no connection available');\n    }\n    const res = await this.connection.run<RowDataPacket[]>(sql, phs);\n    return res.rows;\n  }\n\n  async get(sql: string, phs?: (string | number | boolean)[]) {\n    if (!this.connection) {\n      throw new Error('no connection available');\n    }\n    const res = await this.connection.run<RowDataPacket[]>(sql, phs);\n    if (res.rows.length > 1) throw new Error('get returned more than one row');\n    return res.rows[0];\n  }\n\n  async insert(sql: string, phs?: (string | number | boolean)[]) {\n    if (!this.connection) {\n      throw new Error('no connection available');\n    }\n    const res = await this.connection.run<ResultSetHeader>(sql, phs);\n    return res.rows.insertId || res.rows.affectedRows;\n  }\n\n  async update(sql: string, phs?: (string | number | boolean)[]) {\n    if (!this.connection) {\n      throw new Error('no connection available');\n    }\n    const res = await this.connection.run<ResultSetHeader>(sql, phs);\n    return res.rows.affectedRows;\n  }\n\n  async delete(sql: string, phs?: (string | number | boolean)[]) {\n    if (!this.connection) {\n      throw new Error('no connection available');\n    }\n    const res = await this.connection.run<ResultSetHeader>(sql, phs);\n    return res.rows.affectedRows;\n  }\n}\n"]}

package/build/esm/index.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=index.d.ts.map

package/build/esm/index.js

@@ -0,0 +1,17 @@
+"use strict";
+/*
+ * Copyright Fluidware srl
+ *
+ * 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
+ *
+ *      https://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.
+ */
+//# sourceMappingURL=index.js.map

package/build/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG","sourcesContent":["/*\n * Copyright Fluidware srl\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *      https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n"]}

package/build/esnext/Config.d.ts

@@ -0,0 +1,4 @@
+import { ConnectionOptions } from 'mysql2';
+export declare const USE_READ_COMMITTED_ISOLATION: boolean;
+export declare function getMysqlConnectionOptions(prefix?: string): ConnectionOptions;
+//# sourceMappingURL=Config.d.ts.map

package/build/esnext/Config.js

@@ -0,0 +1,56 @@
+/*
+ * Copyright Fluidware srl
+ *
+ * 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
+ *
+ *      https://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.
+ */
+import { EnvParse } from '@fluidware-it/node-utils';
+import * as fs from 'fs';
+export const USE_READ_COMMITTED_ISOLATION = EnvParse.envBool('USE_READ_COMMITTED_ISOLATION', false);
+function getDbPassword(DB_PASSWORD_FILE, DB_PASSWORD) {
+    if (DB_PASSWORD_FILE) {
+        return fs.readFileSync(DB_PASSWORD_FILE, 'utf8');
+    }
+    else {
+        return DB_PASSWORD;
+    }
+}
+export function getMysqlConnectionOptions(prefix = '') {
+    const DB_HOST = EnvParse.envString(`${prefix}DB_HOST`, 'localhost');
+    const DB_PORT = EnvParse.envInt(`${prefix}DB_PORT`, 3306);
+    const DB_USER = EnvParse.envStringRequired(`${prefix}DB_USER`);
+    const DB_NAME = EnvParse.envString(`${prefix}DB_NAME`, DB_USER);
+    const DB_CONN_OPTIONS = EnvParse.envJSON(`${prefix}DB_NAME`, {});
+    const DB_PASSWORD = EnvParse.envString(`${prefix}DB_PASSWORD`, '');
+    const DB_PASSWORD_FILE = EnvParse.envString(`${prefix}DB_PASSWORD_FILE`, '');
+    if (!DB_PASSWORD && !DB_PASSWORD_FILE) {
+        throw new Error('DB_PASSWORD or DB_PASSWORD_FILE env is required');
+    }
+    const dbPassword = getDbPassword(DB_PASSWORD_FILE, DB_PASSWORD);
+    const dbName = DB_NAME || DB_USER;
+    const dbHost = DB_HOST || '127.0.0.1';
+    const dbPort = Number(DB_PORT) || 3306;
+    const dbOptions = {
+        host: dbHost,
+        port: dbPort,
+        user: DB_USER,
+        password: dbPassword,
+        database: dbName
+    };
+    if (DB_CONN_OPTIONS) {
+        // See https://github.com/mysqljs/mysql#connection-options for all possible options
+        const customOptions = JSON.parse(DB_CONN_OPTIONS);
+        Object.assign(dbOptions, customOptions);
+    }
+    return dbOptions;
+}
+//# sourceMappingURL=Config.js.map

package/build/esnext/Config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Config.js","sourceRoot":"","sources":["../../src/Config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAGzB,MAAM,CAAC,MAAM,4BAA4B,GAAG,QAAQ,CAAC,OAAO,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAC;AAEpG,SAAS,aAAa,CAAC,gBAAwB,EAAE,WAAmB;IAClE,IAAI,gBAAgB,EAAE;QACpB,OAAO,EAAE,CAAC,YAAY,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;KAClD;SAAM;QACL,OAAO,WAAW,CAAC;KACpB;AACH,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,MAAM,GAAG,EAAE;IACnD,MAAM,OAAO,GAAG,QAAQ,CAAC,SAAS,CAAC,GAAG,MAAM,SAAS,EAAE,WAAW,CAAC,CAAC;IACpE,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,SAAS,EAAE,IAAI,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,QAAQ,CAAC,iBAAiB,CAAC,GAAG,MAAM,SAAS,CAAC,CAAC;IAC/D,MAAM,OAAO,GAAG,QAAQ,CAAC,SAAS,CAAC,GAAG,MAAM,SAAS,EAAE,OAAO,CAAC,CAAC;IAChE,MAAM,eAAe,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,MAAM,SAAS,EAAE,EAAE,CAAC,CAAC;IACjE,MAAM,WAAW,GAAG,QAAQ,CAAC,SAAS,CAAC,GAAG,MAAM,aAAa,EAAE,EAAE,CAAC,CAAC;IACnE,MAAM,gBAAgB,GAAG,QAAQ,CAAC,SAAS,CAAC,GAAG,MAAM,kBAAkB,EAAE,EAAE,CAAC,CAAC;IAE7E,IAAI,CAAC,WAAW,IAAI,CAAC,gBAAgB,EAAE;QACrC,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;KACpE;IAED,MAAM,UAAU,GAAG,aAAa,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAC;IAChE,MAAM,MAAM,GAAG,OAAO,IAAI,OAAO,CAAC;IAClC,MAAM,MAAM,GAAG,OAAO,IAAI,WAAW,CAAC;IACtC,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;IAEvC,MAAM,SAAS,GAAG;QAChB,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,UAAU;QACpB,QAAQ,EAAE,MAAM;KACjB,CAAC;IACF,IAAI,eAAe,EAAE;QACnB,mFAAmF;QACnF,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QAClD,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;KACzC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC","sourcesContent":["/*\n * Copyright Fluidware srl\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *      https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { EnvParse } from '@fluidware-it/node-utils';\nimport * as fs from 'fs';\nimport { ConnectionOptions } from 'mysql2';\n\nexport const USE_READ_COMMITTED_ISOLATION = EnvParse.envBool('USE_READ_COMMITTED_ISOLATION', false);\n\nfunction getDbPassword(DB_PASSWORD_FILE: string, DB_PASSWORD: string): string {\n  if (DB_PASSWORD_FILE) {\n    return fs.readFileSync(DB_PASSWORD_FILE, 'utf8');\n  } else {\n    return DB_PASSWORD;\n  }\n}\n\nexport function getMysqlConnectionOptions(prefix = ''): ConnectionOptions {\n  const DB_HOST = EnvParse.envString(`${prefix}DB_HOST`, 'localhost');\n  const DB_PORT = EnvParse.envInt(`${prefix}DB_PORT`, 3306);\n  const DB_USER = EnvParse.envStringRequired(`${prefix}DB_USER`);\n  const DB_NAME = EnvParse.envString(`${prefix}DB_NAME`, DB_USER);\n  const DB_CONN_OPTIONS = EnvParse.envJSON(`${prefix}DB_NAME`, {});\n  const DB_PASSWORD = EnvParse.envString(`${prefix}DB_PASSWORD`, '');\n  const DB_PASSWORD_FILE = EnvParse.envString(`${prefix}DB_PASSWORD_FILE`, '');\n\n  if (!DB_PASSWORD && !DB_PASSWORD_FILE) {\n    throw new Error('DB_PASSWORD or DB_PASSWORD_FILE env is required');\n  }\n\n  const dbPassword = getDbPassword(DB_PASSWORD_FILE, DB_PASSWORD);\n  const dbName = DB_NAME || DB_USER;\n  const dbHost = DB_HOST || '127.0.0.1';\n  const dbPort = Number(DB_PORT) || 3306;\n\n  const dbOptions = {\n    host: dbHost,\n    port: dbPort,\n    user: DB_USER,\n    password: dbPassword,\n    database: dbName\n  };\n  if (DB_CONN_OPTIONS) {\n    // See https://github.com/mysqljs/mysql#connection-options for all possible options\n    const customOptions = JSON.parse(DB_CONN_OPTIONS);\n    Object.assign(dbOptions, customOptions);\n  }\n  return dbOptions;\n}\n"]}

package/build/esnext/DbClient.d.ts

@@ -0,0 +1,26 @@
+import { Connection, RowDataPacket, ResultSetHeader, ProcedureCallPacket, FieldPacket } from 'mysql2/promise';
+import { ConnectionOptions } from 'mysql2';
+interface ConnectionWrap extends Connection {
+    run<T extends ResultSetHeader | ResultSetHeader[] | RowDataPacket[] | RowDataPacket[][] | ProcedureCallPacket>(sql: string, phs?: (string | number | boolean)[]): Promise<{
+        rows: T;
+        cols: FieldPacket[];
+    }>;
+}
+export declare class DbClient {
+    private connection?;
+    private connectionOptions;
+    constructor(connectionOptionsOrPrefix?: ConnectionOptions | string);
+    open(): Promise<void>;
+    getConnection(): ConnectionWrap | undefined;
+    close(): Promise<void>;
+    startTransaction(): Promise<void>;
+    commit(closeTransaction?: boolean): Promise<void>;
+    rollback(closeTransaction?: boolean): Promise<void>;
+    all(sql: string, phs?: (string | number | boolean)[]): Promise<RowDataPacket[]>;
+    get(sql: string, phs?: (string | number | boolean)[]): Promise<RowDataPacket>;
+    insert(sql: string, phs?: (string | number | boolean)[]): Promise<number>;
+    update(sql: string, phs?: (string | number | boolean)[]): Promise<number>;
+    delete(sql: string, phs?: (string | number | boolean)[]): Promise<number>;
+}
+export {};
+//# sourceMappingURL=DbClient.d.ts.map

package/build/esnext/DbClient.js

@@ -0,0 +1,118 @@
+/*
+ * Copyright Fluidware srl
+ *
+ * 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
+ *
+ *      https://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.
+ */
+import { createConnection } from 'mysql2/promise';
+import { getMysqlConnectionOptions, USE_READ_COMMITTED_ISOLATION } from './Config';
+export class DbClient {
+    constructor(connectionOptionsOrPrefix) {
+        if (connectionOptionsOrPrefix) {
+            if (typeof connectionOptionsOrPrefix === 'string') {
+                this.connectionOptions = getMysqlConnectionOptions(connectionOptionsOrPrefix);
+            }
+            else {
+                this.connectionOptions = connectionOptionsOrPrefix;
+            }
+        }
+        else {
+            this.connectionOptions = getMysqlConnectionOptions('');
+        }
+    }
+    async open() {
+        this.connection = (await createConnection(this.connectionOptions));
+        this.connection.run = async (sql, phs) => {
+            if (!this.connection) {
+                throw new Error('run() called but no connection available');
+            }
+            const [rows, cols] = await this.connection.execute(sql, phs);
+            return {
+                rows,
+                cols
+            };
+        };
+    }
+    getConnection() {
+        return this.connection;
+    }
+    async close() {
+        if (this.connection) {
+            await this.connection.end();
+        }
+    }
+    async startTransaction() {
+        if (!this.connection) {
+            throw new Error('no connection available');
+        }
+        if (USE_READ_COMMITTED_ISOLATION) {
+            await this.connection.execute("SET SESSION tx_isolation='read-committed'");
+        }
+        await this.connection.execute('SET AUTOCOMMIT=0');
+    }
+    async commit(closeTransaction = true) {
+        if (!this.connection) {
+            throw new Error('no connection available');
+        }
+        await this.connection.execute('COMMIT');
+        if (closeTransaction) {
+            await this.connection.execute('SET AUTOCOMMIT=1');
+        }
+    }
+    async rollback(closeTransaction = true) {
+        if (!this.connection) {
+            throw new Error('no connection available');
+        }
+        await this.connection.execute('ROLLBACK');
+        if (closeTransaction) {
+            await this.connection.execute('SET AUTOCOMMIT=1');
+        }
+    }
+    async all(sql, phs) {
+        if (!this.connection) {
+            throw new Error('no connection available');
+        }
+        const res = await this.connection.run(sql, phs);
+        return res.rows;
+    }
+    async get(sql, phs) {
+        if (!this.connection) {
+            throw new Error('no connection available');
+        }
+        const res = await this.connection.run(sql, phs);
+        if (res.rows.length > 1)
+            throw new Error('get returned more than one row');
+        return res.rows[0];
+    }
+    async insert(sql, phs) {
+        if (!this.connection) {
+            throw new Error('no connection available');
+        }
+        const res = await this.connection.run(sql, phs);
+        return res.rows.insertId || res.rows.affectedRows;
+    }
+    async update(sql, phs) {
+        if (!this.connection) {
+            throw new Error('no connection available');
+        }
+        const res = await this.connection.run(sql, phs);
+        return res.rows.affectedRows;
+    }
+    async delete(sql, phs) {
+        if (!this.connection) {
+            throw new Error('no connection available');
+        }
+        const res = await this.connection.run(sql, phs);
+        return res.rows.affectedRows;
+    }
+}
+//# sourceMappingURL=DbClient.js.map

package/build/esnext/DbClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DbClient.js","sourceRoot":"","sources":["../../src/DbClient.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright Fluidware srl\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *      https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  createConnection,\n  Connection,\n  RowDataPacket,\n  ResultSetHeader,\n  ProcedureCallPacket,\n  FieldPacket\n} from 'mysql2/promise';\nimport { getMysqlConnectionOptions, USE_READ_COMMITTED_ISOLATION } from './Config';\nimport { ConnectionOptions } from 'mysql2';\n\ninterface ConnectionWrap extends Connection {\n  run<T extends ResultSetHeader | ResultSetHeader[] | RowDataPacket[] | RowDataPacket[][] | ProcedureCallPacket>(\n    sql: string,\n    phs?: (string | number | boolean)[]\n  ): Promise<{\n    rows: T;\n    cols: FieldPacket[];\n  }>;\n}\n\nexport class DbClient {\n  private connection?: ConnectionWrap;\n  private connectionOptions: ConnectionOptions;\n\n  constructor(connectionOptionsOrPrefix?: ConnectionOptions | string) {\n    if (connectionOptionsOrPrefix) {\n      if (typeof connectionOptionsOrPrefix === 'string') {\n        this.connectionOptions = getMysqlConnectionOptions(connectionOptionsOrPrefix);\n      } else {\n        this.connectionOptions = connectionOptionsOrPrefix;\n      }\n    } else {\n      this.connectionOptions = getMysqlConnectionOptions('');\n    }\n  }\n\n  async open() {\n    this.connection = (await createConnection(this.connectionOptions)) as ConnectionWrap;\n    this.connection.run = async <\n      T extends ResultSetHeader | ResultSetHeader[] | RowDataPacket[] | RowDataPacket[][] | ProcedureCallPacket\n    >(\n      sql: string,\n      phs?: (string | number | boolean)[]\n    ): Promise<{ rows: T; cols: FieldPacket[] }> => {\n      if (!this.connection) {\n        throw new Error('run() called but no connection available');\n      }\n      const [rows, cols] = await this.connection.execute<T>(sql, phs);\n      return {\n        rows,\n        cols\n      };\n    };\n  }\n\n  getConnection(): ConnectionWrap | undefined {\n    return this.connection;\n  }\n\n  async close() {\n    if (this.connection) {\n      await this.connection.end();\n    }\n  }\n\n  async startTransaction() {\n    if (!this.connection) {\n      throw new Error('no connection available');\n    }\n    if (USE_READ_COMMITTED_ISOLATION) {\n      await this.connection.execute(\"SET SESSION tx_isolation='read-committed'\");\n    }\n    await this.connection.execute('SET AUTOCOMMIT=0');\n  }\n\n  async commit(closeTransaction = true) {\n    if (!this.connection) {\n      throw new Error('no connection available');\n    }\n    await this.connection.execute('COMMIT');\n    if (closeTransaction) {\n      await this.connection.execute('SET AUTOCOMMIT=1');\n    }\n  }\n\n  async rollback(closeTransaction = true) {\n    if (!this.connection) {\n      throw new Error('no connection available');\n    }\n\n    await this.connection.execute('ROLLBACK');\n    if (closeTransaction) {\n      await this.connection.execute('SET AUTOCOMMIT=1');\n    }\n  }\n\n  async all(sql: string, phs?: (string | number | boolean)[]) {\n    if (!this.connection) {\n      throw new Error('no connection available');\n    }\n    const res = await this.connection.run<RowDataPacket[]>(sql, phs);\n    return res.rows;\n  }\n\n  async get(sql: string, phs?: (string | number | boolean)[]) {\n    if (!this.connection) {\n      throw new Error('no connection available');\n    }\n    const res = await this.connection.run<RowDataPacket[]>(sql, phs);\n    if (res.rows.length > 1) throw new Error('get returned more than one row');\n    return res.rows[0];\n  }\n\n  async insert(sql: string, phs?: (string | number | boolean)[]) {\n    if (!this.connection) {\n      throw new Error('no connection available');\n    }\n    const res = await this.connection.run<ResultSetHeader>(sql, phs);\n    return res.rows.insertId || res.rows.affectedRows;\n  }\n\n  async update(sql: string, phs?: (string | number | boolean)[]) {\n    if (!this.connection) {\n      throw new Error('no connection available');\n    }\n    const res = await this.connection.run<ResultSetHeader>(sql, phs);\n    return res.rows.affectedRows;\n  }\n\n  async delete(sql: string, phs?: (string | number | boolean)[]) {\n    if (!this.connection) {\n      throw new Error('no connection available');\n    }\n    const res = await this.connection.run<ResultSetHeader>(sql, phs);\n    return res.rows.affectedRows;\n  }\n}\n"]}

package/build/esnext/index.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=index.d.ts.map

package/build/esnext/index.js

@@ -0,0 +1,17 @@
+"use strict";
+/*
+ * Copyright Fluidware srl
+ *
+ * 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
+ *
+ *      https://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.
+ */
+//# sourceMappingURL=index.js.map

package/build/esnext/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG","sourcesContent":["/*\n * Copyright Fluidware srl\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *      https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n"]}

package/build/src/Config.d.ts

@@ -0,0 +1,4 @@
+import { ConnectionOptions } from 'mysql2';
+export declare const USE_READ_COMMITTED_ISOLATION: boolean;
+export declare function getMysqlConnectionOptions(prefix?: string): ConnectionOptions;
+//# sourceMappingURL=Config.d.ts.map

package/build/src/Config.js

@@ -0,0 +1,60 @@
+"use strict";
+/*
+ * Copyright Fluidware srl
+ *
+ * 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
+ *
+ *      https://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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMysqlConnectionOptions = exports.USE_READ_COMMITTED_ISOLATION = void 0;
+const node_utils_1 = require("@fluidware-it/node-utils");
+const fs = require("fs");
+exports.USE_READ_COMMITTED_ISOLATION = node_utils_1.EnvParse.envBool('USE_READ_COMMITTED_ISOLATION', false);
+function getDbPassword(DB_PASSWORD_FILE, DB_PASSWORD) {
+    if (DB_PASSWORD_FILE) {
+        return fs.readFileSync(DB_PASSWORD_FILE, 'utf8');
+    }
+    else {
+        return DB_PASSWORD;
+    }
+}
+function getMysqlConnectionOptions(prefix = '') {
+    const DB_HOST = node_utils_1.EnvParse.envString(`${prefix}DB_HOST`, 'localhost');
+    const DB_PORT = node_utils_1.EnvParse.envInt(`${prefix}DB_PORT`, 3306);
+    const DB_USER = node_utils_1.EnvParse.envStringRequired(`${prefix}DB_USER`);
+    const DB_NAME = node_utils_1.EnvParse.envString(`${prefix}DB_NAME`, DB_USER);
+    const DB_CONN_OPTIONS = node_utils_1.EnvParse.envJSON(`${prefix}DB_NAME`, {});
+    const DB_PASSWORD = node_utils_1.EnvParse.envString(`${prefix}DB_PASSWORD`, '');
+    const DB_PASSWORD_FILE = node_utils_1.EnvParse.envString(`${prefix}DB_PASSWORD_FILE`, '');
+    if (!DB_PASSWORD && !DB_PASSWORD_FILE) {
+        throw new Error('DB_PASSWORD or DB_PASSWORD_FILE env is required');
+    }
+    const dbPassword = getDbPassword(DB_PASSWORD_FILE, DB_PASSWORD);
+    const dbName = DB_NAME || DB_USER;
+    const dbHost = DB_HOST || '127.0.0.1';
+    const dbPort = Number(DB_PORT) || 3306;
+    const dbOptions = {
+        host: dbHost,
+        port: dbPort,
+        user: DB_USER,
+        password: dbPassword,
+        database: dbName
+    };
+    if (DB_CONN_OPTIONS) {
+        // See https://github.com/mysqljs/mysql#connection-options for all possible options
+        const customOptions = JSON.parse(DB_CONN_OPTIONS);
+        Object.assign(dbOptions, customOptions);
+    }
+    return dbOptions;
+}
+exports.getMysqlConnectionOptions = getMysqlConnectionOptions;
+//# sourceMappingURL=Config.js.map

package/build/src/Config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Config.js","sourceRoot":"","sources":["../../src/Config.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAEH,yDAAoD;AACpD,yBAAyB;AAGZ,QAAA,4BAA4B,GAAG,qBAAQ,CAAC,OAAO,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAC;AAEpG,SAAS,aAAa,CAAC,gBAAwB,EAAE,WAAmB;IAClE,IAAI,gBAAgB,EAAE;QACpB,OAAO,EAAE,CAAC,YAAY,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;KAClD;SAAM;QACL,OAAO,WAAW,CAAC;KACpB;AACH,CAAC;AAED,SAAgB,yBAAyB,CAAC,MAAM,GAAG,EAAE;IACnD,MAAM,OAAO,GAAG,qBAAQ,CAAC,SAAS,CAAC,GAAG,MAAM,SAAS,EAAE,WAAW,CAAC,CAAC;IACpE,MAAM,OAAO,GAAG,qBAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,SAAS,EAAE,IAAI,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,qBAAQ,CAAC,iBAAiB,CAAC,GAAG,MAAM,SAAS,CAAC,CAAC;IAC/D,MAAM,OAAO,GAAG,qBAAQ,CAAC,SAAS,CAAC,GAAG,MAAM,SAAS,EAAE,OAAO,CAAC,CAAC;IAChE,MAAM,eAAe,GAAG,qBAAQ,CAAC,OAAO,CAAC,GAAG,MAAM,SAAS,EAAE,EAAE,CAAC,CAAC;IACjE,MAAM,WAAW,GAAG,qBAAQ,CAAC,SAAS,CAAC,GAAG,MAAM,aAAa,EAAE,EAAE,CAAC,CAAC;IACnE,MAAM,gBAAgB,GAAG,qBAAQ,CAAC,SAAS,CAAC,GAAG,MAAM,kBAAkB,EAAE,EAAE,CAAC,CAAC;IAE7E,IAAI,CAAC,WAAW,IAAI,CAAC,gBAAgB,EAAE;QACrC,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;KACpE;IAED,MAAM,UAAU,GAAG,aAAa,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAC;IAChE,MAAM,MAAM,GAAG,OAAO,IAAI,OAAO,CAAC;IAClC,MAAM,MAAM,GAAG,OAAO,IAAI,WAAW,CAAC;IACtC,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;IAEvC,MAAM,SAAS,GAAG;QAChB,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,UAAU;QACpB,QAAQ,EAAE,MAAM;KACjB,CAAC;IACF,IAAI,eAAe,EAAE;QACnB,mFAAmF;QACnF,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QAClD,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;KACzC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AA/BD,8DA+BC","sourcesContent":["/*\n * Copyright Fluidware srl\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *      https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { EnvParse } from '@fluidware-it/node-utils';\nimport * as fs from 'fs';\nimport { ConnectionOptions } from 'mysql2';\n\nexport const USE_READ_COMMITTED_ISOLATION = EnvParse.envBool('USE_READ_COMMITTED_ISOLATION', false);\n\nfunction getDbPassword(DB_PASSWORD_FILE: string, DB_PASSWORD: string): string {\n  if (DB_PASSWORD_FILE) {\n    return fs.readFileSync(DB_PASSWORD_FILE, 'utf8');\n  } else {\n    return DB_PASSWORD;\n  }\n}\n\nexport function getMysqlConnectionOptions(prefix = ''): ConnectionOptions {\n  const DB_HOST = EnvParse.envString(`${prefix}DB_HOST`, 'localhost');\n  const DB_PORT = EnvParse.envInt(`${prefix}DB_PORT`, 3306);\n  const DB_USER = EnvParse.envStringRequired(`${prefix}DB_USER`);\n  const DB_NAME = EnvParse.envString(`${prefix}DB_NAME`, DB_USER);\n  const DB_CONN_OPTIONS = EnvParse.envJSON(`${prefix}DB_NAME`, {});\n  const DB_PASSWORD = EnvParse.envString(`${prefix}DB_PASSWORD`, '');\n  const DB_PASSWORD_FILE = EnvParse.envString(`${prefix}DB_PASSWORD_FILE`, '');\n\n  if (!DB_PASSWORD && !DB_PASSWORD_FILE) {\n    throw new Error('DB_PASSWORD or DB_PASSWORD_FILE env is required');\n  }\n\n  const dbPassword = getDbPassword(DB_PASSWORD_FILE, DB_PASSWORD);\n  const dbName = DB_NAME || DB_USER;\n  const dbHost = DB_HOST || '127.0.0.1';\n  const dbPort = Number(DB_PORT) || 3306;\n\n  const dbOptions = {\n    host: dbHost,\n    port: dbPort,\n    user: DB_USER,\n    password: dbPassword,\n    database: dbName\n  };\n  if (DB_CONN_OPTIONS) {\n    // See https://github.com/mysqljs/mysql#connection-options for all possible options\n    const customOptions = JSON.parse(DB_CONN_OPTIONS);\n    Object.assign(dbOptions, customOptions);\n  }\n  return dbOptions;\n}\n"]}

package/build/src/DbClient.d.ts

@@ -0,0 +1,26 @@
+import { Connection, RowDataPacket, ResultSetHeader, ProcedureCallPacket, FieldPacket } from 'mysql2/promise';
+import { ConnectionOptions } from 'mysql2';
+interface ConnectionWrap extends Connection {
+    run<T extends ResultSetHeader | ResultSetHeader[] | RowDataPacket[] | RowDataPacket[][] | ProcedureCallPacket>(sql: string, phs?: (string | number | boolean)[]): Promise<{
+        rows: T;
+        cols: FieldPacket[];
+    }>;
+}
+export declare class DbClient {
+    private connection?;
+    private connectionOptions;
+    constructor(connectionOptionsOrPrefix?: ConnectionOptions | string);
+    open(): Promise<void>;
+    getConnection(): ConnectionWrap | undefined;
+    close(): Promise<void>;
+    startTransaction(): Promise<void>;
+    commit(closeTransaction?: boolean): Promise<void>;
+    rollback(closeTransaction?: boolean): Promise<void>;
+    all(sql: string, phs?: (string | number | boolean)[]): Promise<RowDataPacket[]>;
+    get(sql: string, phs?: (string | number | boolean)[]): Promise<RowDataPacket>;
+    insert(sql: string, phs?: (string | number | boolean)[]): Promise<number>;
+    update(sql: string, phs?: (string | number | boolean)[]): Promise<number>;
+    delete(sql: string, phs?: (string | number | boolean)[]): Promise<number>;
+}
+export {};
+//# sourceMappingURL=DbClient.d.ts.map

package/build/src/DbClient.js

@@ -0,0 +1,122 @@
+"use strict";
+/*
+ * Copyright Fluidware srl
+ *
+ * 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
+ *
+ *      https://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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DbClient = void 0;
+const promise_1 = require("mysql2/promise");
+const Config_1 = require("./Config");
+class DbClient {
+    constructor(connectionOptionsOrPrefix) {
+        if (connectionOptionsOrPrefix) {
+            if (typeof connectionOptionsOrPrefix === 'string') {
+                this.connectionOptions = (0, Config_1.getMysqlConnectionOptions)(connectionOptionsOrPrefix);
+            }
+            else {
+                this.connectionOptions = connectionOptionsOrPrefix;
+            }
+        }
+        else {
+            this.connectionOptions = (0, Config_1.getMysqlConnectionOptions)('');
+        }
+    }
+    async open() {
+        this.connection = (await (0, promise_1.createConnection)(this.connectionOptions));
+        this.connection.run = async (sql, phs) => {
+            if (!this.connection) {
+                throw new Error('run() called but no connection available');
+            }
+            const [rows, cols] = await this.connection.execute(sql, phs);
+            return {
+                rows,
+                cols
+            };
+        };
+    }
+    getConnection() {
+        return this.connection;
+    }
+    async close() {
+        if (this.connection) {
+            await this.connection.end();
+        }
+    }
+    async startTransaction() {
+        if (!this.connection) {
+            throw new Error('no connection available');
+        }
+        if (Config_1.USE_READ_COMMITTED_ISOLATION) {
+            await this.connection.execute("SET SESSION tx_isolation='read-committed'");
+        }
+        await this.connection.execute('SET AUTOCOMMIT=0');
+    }
+    async commit(closeTransaction = true) {
+        if (!this.connection) {
+            throw new Error('no connection available');
+        }
+        await this.connection.execute('COMMIT');
+        if (closeTransaction) {
+            await this.connection.execute('SET AUTOCOMMIT=1');
+        }
+    }
+    async rollback(closeTransaction = true) {
+        if (!this.connection) {
+            throw new Error('no connection available');
+        }
+        await this.connection.execute('ROLLBACK');
+        if (closeTransaction) {
+            await this.connection.execute('SET AUTOCOMMIT=1');
+        }
+    }
+    async all(sql, phs) {
+        if (!this.connection) {
+            throw new Error('no connection available');
+        }
+        const res = await this.connection.run(sql, phs);
+        return res.rows;
+    }
+    async get(sql, phs) {
+        if (!this.connection) {
+            throw new Error('no connection available');
+        }
+        const res = await this.connection.run(sql, phs);
+        if (res.rows.length > 1)
+            throw new Error('get returned more than one row');
+        return res.rows[0];
+    }
+    async insert(sql, phs) {
+        if (!this.connection) {
+            throw new Error('no connection available');
+        }
+        const res = await this.connection.run(sql, phs);
+        return res.rows.insertId || res.rows.affectedRows;
+    }
+    async update(sql, phs) {
+        if (!this.connection) {
+            throw new Error('no connection available');
+        }
+        const res = await this.connection.run(sql, phs);
+        return res.rows.affectedRows;
+    }
+    async delete(sql, phs) {
+        if (!this.connection) {
+            throw new Error('no connection available');
+        }
+        const res = await this.connection.run(sql, phs);
+        return res.rows.affectedRows;
+    }
+}
+exports.DbClient = DbClient;
+//# sourceMappingURL=DbClient.js.map

package/build/src/DbClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DbClient.js","sourceRoot":"","sources":["../../src/DbClient.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright Fluidware srl\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *      https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  createConnection,\n  Connection,\n  RowDataPacket,\n  ResultSetHeader,\n  ProcedureCallPacket,\n  FieldPacket\n} from 'mysql2/promise';\nimport { getMysqlConnectionOptions, USE_READ_COMMITTED_ISOLATION } from './Config';\nimport { ConnectionOptions } from 'mysql2';\n\ninterface ConnectionWrap extends Connection {\n  run<T extends ResultSetHeader | ResultSetHeader[] | RowDataPacket[] | RowDataPacket[][] | ProcedureCallPacket>(\n    sql: string,\n    phs?: (string | number | boolean)[]\n  ): Promise<{\n    rows: T;\n    cols: FieldPacket[];\n  }>;\n}\n\nexport class DbClient {\n  private connection?: ConnectionWrap;\n  private connectionOptions: ConnectionOptions;\n\n  constructor(connectionOptionsOrPrefix?: ConnectionOptions | string) {\n    if (connectionOptionsOrPrefix) {\n      if (typeof connectionOptionsOrPrefix === 'string') {\n        this.connectionOptions = getMysqlConnectionOptions(connectionOptionsOrPrefix);\n      } else {\n        this.connectionOptions = connectionOptionsOrPrefix;\n      }\n    } else {\n      this.connectionOptions = getMysqlConnectionOptions('');\n    }\n  }\n\n  async open() {\n    this.connection = (await createConnection(this.connectionOptions)) as ConnectionWrap;\n    this.connection.run = async <\n      T extends ResultSetHeader | ResultSetHeader[] | RowDataPacket[] | RowDataPacket[][] | ProcedureCallPacket\n    >(\n      sql: string,\n      phs?: (string | number | boolean)[]\n    ): Promise<{ rows: T; cols: FieldPacket[] }> => {\n      if (!this.connection) {\n        throw new Error('run() called but no connection available');\n      }\n      const [rows, cols] = await this.connection.execute<T>(sql, phs);\n      return {\n        rows,\n        cols\n      };\n    };\n  }\n\n  getConnection(): ConnectionWrap | undefined {\n    return this.connection;\n  }\n\n  async close() {\n    if (this.connection) {\n      await this.connection.end();\n    }\n  }\n\n  async startTransaction() {\n    if (!this.connection) {\n      throw new Error('no connection available');\n    }\n    if (USE_READ_COMMITTED_ISOLATION) {\n      await this.connection.execute(\"SET SESSION tx_isolation='read-committed'\");\n    }\n    await this.connection.execute('SET AUTOCOMMIT=0');\n  }\n\n  async commit(closeTransaction = true) {\n    if (!this.connection) {\n      throw new Error('no connection available');\n    }\n    await this.connection.execute('COMMIT');\n    if (closeTransaction) {\n      await this.connection.execute('SET AUTOCOMMIT=1');\n    }\n  }\n\n  async rollback(closeTransaction = true) {\n    if (!this.connection) {\n      throw new Error('no connection available');\n    }\n\n    await this.connection.execute('ROLLBACK');\n    if (closeTransaction) {\n      await this.connection.execute('SET AUTOCOMMIT=1');\n    }\n  }\n\n  async all(sql: string, phs?: (string | number | boolean)[]) {\n    if (!this.connection) {\n      throw new Error('no connection available');\n    }\n    const res = await this.connection.run<RowDataPacket[]>(sql, phs);\n    return res.rows;\n  }\n\n  async get(sql: string, phs?: (string | number | boolean)[]) {\n    if (!this.connection) {\n      throw new Error('no connection available');\n    }\n    const res = await this.connection.run<RowDataPacket[]>(sql, phs);\n    if (res.rows.length > 1) throw new Error('get returned more than one row');\n    return res.rows[0];\n  }\n\n  async insert(sql: string, phs?: (string | number | boolean)[]) {\n    if (!this.connection) {\n      throw new Error('no connection available');\n    }\n    const res = await this.connection.run<ResultSetHeader>(sql, phs);\n    return res.rows.insertId || res.rows.affectedRows;\n  }\n\n  async update(sql: string, phs?: (string | number | boolean)[]) {\n    if (!this.connection) {\n      throw new Error('no connection available');\n    }\n    const res = await this.connection.run<ResultSetHeader>(sql, phs);\n    return res.rows.affectedRows;\n  }\n\n  async delete(sql: string, phs?: (string | number | boolean)[]) {\n    if (!this.connection) {\n      throw new Error('no connection available');\n    }\n    const res = await this.connection.run<ResultSetHeader>(sql, phs);\n    return res.rows.affectedRows;\n  }\n}\n"]}

package/build/src/index.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=index.d.ts.map

package/build/src/index.js

@@ -0,0 +1,17 @@
+"use strict";
+/*
+ * Copyright Fluidware srl
+ *
+ * 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
+ *
+ *      https://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.
+ */
+//# sourceMappingURL=index.js.map

package/build/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG","sourcesContent":["/*\n * Copyright Fluidware srl\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *      https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n"]}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@fluidware-it/mysql2-client",
+  "version": "0.0.0",
+  "main": "build/src/index.js",
+  "module": "build/esm/index.js",
+  "esnext": "build/esnext/index.js",
+  "types": "build/src/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "Fluidware srl",
+  "license": "Apache-2.0",
+  "scripts": {
+    "prepack": "npm run compile",
+    "compile": "npm run clean && tsc --build tsconfig.json tsconfig.esm.json tsconfig.esnext.json",
+    "clean": "tsc --build --clean tsconfig.json tsconfig.esm.json tsconfig.esnext.json",
+    "lint": "eslint src",
+    "lint:fix": "eslint --fix src",
+    "test": "jest"
+  },
+  "engines": {
+    "node": ">=18.4"
+  },
+  "dependencies": {
+    "@fluidware-it/node-utils": "^0.0.0",
+    "mysql2": "^3.6.2"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.6",
+    "@typescript-eslint/eslint-plugin": "^6.8.0",
+    "@typescript-eslint/parser": "^6.8.0",
+    "eslint": "^8.51.0",
+    "eslint-config-prettier": "^9.0.0",
+    "eslint-plugin-node": "^11.1.0",
+    "eslint-plugin-prettier": "^5.0.1",
+    "jest": "^29.7.0",
+    "prettier": "^3.0.3",
+    "ts-jest": "^29.1.1",
+    "typescript": "^5.2.2"
+  },
+  "files": [
+    "build/esm/**/*.js",
+    "build/esm/**/*.js.map",
+    "build/esm/**/*.d.ts",
+    "build/esnext/**/*.js",
+    "build/esnext/**/*.js.map",
+    "build/esnext/**/*.d.ts",
+    "build/src/**/*.js",
+    "build/src/**/*.js.map",
+    "build/src/**/*.d.ts",
+    "LICENSE",
+    "README.md"
+  ]
+}