emilsoftware-utilities 2.0.0-dev.7 → 2.0.0-dev.70

package/dist/Orm.js

@@ -51,10 +51,73 @@ class Orm {
     static quote(value) {
         return "\"" + value + "\"";
     }
+    /** Dimensione pool: default 5 (pool attivo); `poolSize: 0` disabilita e torna all'attach per query. */
+    static getPoolSize(options) {
+        const raw = options.poolSize;
+        if (raw === 0) {
+            return 0;
+        }
+        const size = raw === undefined ? 5 : Number(raw);
+        return Number.isFinite(size) && size > 0 ? Math.trunc(size) : 0;
+    }
+    static shouldLogQueryParameters(options) {
+        return options.logQueryParameters === true;
+    }
+    static formatQueryForLog(query, parameters, includeValues) {
+        const parameterList = Array.isArray(parameters) ? parameters : Object.values(parameters !== null && parameters !== void 0 ? parameters : {});
+        if (includeValues) {
+            return Utilities_1.RestUtilities.printQueryWithParams(query, parameterList);
+        }
+        return `${query.replace(/\s+/g, " ").trim()} [params=${parameterList.length}]`;
+    }
+    static buildPoolKey(options, size) {
+        var _a, _b, _c, _d, _e, _f;
+        const normalized = (0, firebird_compat_1.normalizeFirebirdOptions)(options);
+        return [
+            size,
+            (_a = normalized.host) !== null && _a !== void 0 ? _a : "",
+            (_b = normalized.port) !== null && _b !== void 0 ? _b : "",
+            (_c = normalized.database) !== null && _c !== void 0 ? _c : "",
+            (_d = normalized.user) !== null && _d !== void 0 ? _d : "",
+            (_e = normalized.pluginName) !== null && _e !== void 0 ? _e : "",
+            String((_f = normalized.wireCrypt) !== null && _f !== void 0 ? _f : ""),
+        ].join("|");
+    }
+    /**
+     * Chiude tutti i pool creati (opt-in `poolSize`). Utile a fine processo o nei test,
+     * perché i pool mantengono connessioni e timer attivi.
+     */
+    static closePools() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const pools = Array.from(this.pools.values());
+            this.pools.clear();
+            yield Promise.all(pools.map((pool) => new Promise((resolve) => {
+                try {
+                    pool.destroy(() => resolve());
+                }
+                catch (_a) {
+                    resolve();
+                }
+            })));
+        });
+    }
+    static getPool(options, size) {
+        const normalized = (0, firebird_compat_1.normalizeFirebirdOptions)(options);
+        const key = this.buildPoolKey(normalized, size);
+        let pool = this.pools.get(key);
+        if (!pool) {
+            this.logger.info(`Firebird pool created (max=${size}) using ${(0, firebird_compat_1.describeFirebirdCompatibilityOptions)(normalized)}`);
+            pool = Firebird.pool(size, normalized);
+            pool.on("error", (error) => {
+                this.logger.error(`Firebird pool error: ${error.message}`);
+            });
+            this.pools.set(key, pool);
+        }
+        return pool;
+    }
     static getTimeoutMs(options) {
         var _a;
-        const normalizedOptions = (0, firebird_compat_1.normalizeFirebirdOptions)(options);
-        const candidate = (_a = normalizedOptions.connectTimeout) !== null && _a !== void 0 ? _a : 15000;
+        const candidate = (_a = options.connectTimeout) !== null && _a !== void 0 ? _a : 15000;
         return Number.isFinite(candidate) && candidate > 0 ? Math.trunc(candidate) : 15000;
     }
     static createTimeoutError(stage, timeoutMs, options, query) {
@@ -78,10 +141,17 @@ class Orm {
             });
         });
     }
+    static shouldTrimStringResults(options) {
+        return options.trimStringResults !== false;
+    }
+    static shouldConvertDatesToUtc(options) {
+        return options.utcDates !== false;
+    }
     static attachWithTimeout(options) {
         return new Promise((resolve, reject) => {
             const normalizedOptions = (0, firebird_compat_1.normalizeFirebirdOptions)(options);
             const timeoutMs = this.getTimeoutMs(normalizedOptions);
+            const poolSize = this.getPoolSize(options);
             let settled = false;
             const timeoutId = setTimeout(() => {
                 if (settled) {
@@ -90,8 +160,7 @@ class Orm {
                 settled = true;
                 reject((0, firebird_compat_1.enhanceFirebirdError)(this.createTimeoutError("attach", timeoutMs, normalizedOptions), normalizedOptions, { stage: "attach" }));
             }, timeoutMs);
-            this.logger.info(`Firebird attach using ${(0, firebird_compat_1.describeFirebirdCompatibilityOptions)(normalizedOptions)}`);
-            Firebird.attach(normalizedOptions, (err, db) => __awaiter(this, void 0, void 0, function* () {
+            const handle = (err, db) => __awaiter(this, void 0, void 0, function* () {
                 if (settled) {
                     yield this.detachQuietly(db);
                     return;
@@ -102,7 +171,23 @@ class Orm {
                     return reject((0, firebird_compat_1.enhanceFirebirdError)(err, normalizedOptions, { stage: "attach" }));
                 }
                 return resolve(db);
-            }));
+            });
+            try {
+                if (poolSize > 0) {
+                    this.getPool(options, poolSize).get(handle);
+                    return;
+                }
+                this.logger.info(`Firebird attach using ${(0, firebird_compat_1.describeFirebirdCompatibilityOptions)(normalizedOptions)}`);
+                Firebird.attach(normalizedOptions, handle);
+            }
+            catch (error) {
+                // Attach/get sincrono fallito: evita di lasciare il timer di timeout pendente.
+                if (!settled) {
+                    settled = true;
+                    clearTimeout(timeoutId);
+                    reject((0, firebird_compat_1.enhanceFirebirdError)(error, normalizedOptions, { stage: "attach" }));
+                }
+            }
         });
     }
     static testConnection(options) {
@@ -126,7 +211,7 @@ class Orm {
         return __awaiter(this, arguments, void 0, function* (options, query, parameters = [], logQuery = true) {
             try {
                 const normalizedOptions = (0, firebird_compat_1.normalizeFirebirdOptions)(options);
-                const db = yield this.attachWithTimeout(normalizedOptions);
+                const db = yield this.attachWithTimeout(options);
                 return yield new Promise((resolve, reject) => {
                     const timeoutMs = this.getTimeoutMs(normalizedOptions);
                     let settled = false;
@@ -139,7 +224,7 @@ class Orm {
                         reject((0, firebird_compat_1.enhanceFirebirdError)(this.createTimeoutError("query", timeoutMs, normalizedOptions, query), normalizedOptions, { stage: "query", sql: query }));
                     }), timeoutMs);
                     if (logQuery) {
-                        this.logger.info(Utilities_1.RestUtilities.printQueryWithParams(query, parameters));
+                        this.logger.info(this.formatQueryForLog(query, parameters, this.shouldLogQueryParameters(options)));
                     }
                     db.query(query, parameters, (error, result) => __awaiter(this, void 0, void 0, function* () {
                         if (settled) {
@@ -152,7 +237,7 @@ class Orm {
                         if (error) {
                             return reject((0, firebird_compat_1.enhanceFirebirdError)(error, normalizedOptions, { stage: "query", sql: query }));
                         }
-                        return resolve(result);
+                        return resolve((0, firebird_compat_1.normalizeFirebirdResult)(result, this.shouldTrimStringResults(normalizedOptions), this.shouldConvertDatesToUtc(normalizedOptions)));
                     }));
                 });
             }
@@ -167,7 +252,7 @@ class Orm {
         return __awaiter(this, arguments, void 0, function* (options, query, parameters = [], logQuery = true) {
             try {
                 const normalizedOptions = (0, firebird_compat_1.normalizeFirebirdOptions)(options);
-                const db = yield this.attachWithTimeout(normalizedOptions);
+                const db = yield this.attachWithTimeout(options);
                 return yield new Promise((resolve, reject) => {
                     const timeoutMs = this.getTimeoutMs(normalizedOptions);
                     let settled = false;
@@ -180,7 +265,7 @@ class Orm {
                         reject((0, firebird_compat_1.enhanceFirebirdError)(this.createTimeoutError("execute", timeoutMs, normalizedOptions, query), normalizedOptions, { stage: "execute", sql: query }));
                     }), timeoutMs);
                     if (logQuery) {
-                        this.logger.info(Utilities_1.RestUtilities.printQueryWithParams(query, parameters));
+                        this.logger.info(this.formatQueryForLog(query, parameters, this.shouldLogQueryParameters(options)));
                     }
                     db.execute(query, parameters, (error, result) => __awaiter(this, void 0, void 0, function* () {
                         if (settled) {
@@ -193,7 +278,7 @@ class Orm {
                         if (error) {
                             return reject((0, firebird_compat_1.enhanceFirebirdError)(error, normalizedOptions, { stage: "execute", sql: query }));
                         }
-                        return resolve(result);
+                        return resolve((0, firebird_compat_1.normalizeFirebirdResult)(result, this.shouldTrimStringResults(normalizedOptions), this.shouldConvertDatesToUtc(normalizedOptions)));
                     }));
                 });
             }
@@ -206,7 +291,7 @@ class Orm {
     }
     static trimParam(param) {
         if (typeof param === "string" || param instanceof String) {
-            return param.trim();
+            return String(param).trim();
         }
         return param;
     }
@@ -215,6 +300,49 @@ class Orm {
             return this.attachWithTimeout(options);
         });
     }
+    /**
+     * Runs `operation` inside a single Firebird transaction: commit on success,
+     * rollback on failure, detach in every case. Use it to make multi-statement
+     * writes atomic instead of relying on auto-commit per statement.
+     */
+    static withTransaction(options, operation) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const db = yield this.connect(options);
+            let transaction;
+            try {
+                transaction = yield this.startTransaction(db);
+                const result = yield operation(transaction);
+                yield this.commitTransaction(transaction);
+                return result;
+            }
+            catch (error) {
+                if (transaction) {
+                    try {
+                        yield this.rollbackTransaction(transaction);
+                    }
+                    catch (_a) {
+                        // Se la rollback fallisce (connessione persa) l'errore originale resta quello rilevante.
+                    }
+                }
+                throw error;
+            }
+            finally {
+                yield this.detachQuietly(db);
+            }
+        });
+    }
+    /** Esegue una query su una transazione esistente e ne restituisce il risultato. */
+    static transactionQuery(transaction, query, parameters = []) {
+        return new Promise((resolve, reject) => {
+            transaction.query(query, parameters, (error, result) => {
+                if (error) {
+                    reject(error);
+                    return;
+                }
+                resolve(result);
+            });
+        });
+    }
     static startTransaction(db) {
         return __awaiter(this, void 0, void 0, function* () {
             return new Promise((resolve, reject) => {
@@ -253,32 +381,12 @@ class Orm {
     }
     static executeMultiple(options, queriesWithParams) {
         return __awaiter(this, void 0, void 0, function* () {
-            let db;
-            let transaction;
-            try {
-                db = yield Orm.connect(options);
-                transaction = yield Orm.startTransaction(db);
+            yield Orm.withTransaction(options, (transaction) => __awaiter(this, void 0, void 0, function* () {
                 for (const qwp of queriesWithParams) {
-                    yield new Promise((resolve, reject) => {
-                        transaction.query(qwp.query, qwp.params, (err, result) => {
-                            if (err) {
-                                return reject(err);
-                            }
-                            return resolve(result);
-                        });
-                    });
+                    yield Orm.transactionQuery(transaction, qwp.query, qwp.params);
                 }
-                yield Orm.commitTransaction(transaction);
-                yield Orm.detachQuietly(db);
-                return "OK";
-            }
-            catch (error) {
-                if (transaction) {
-                    yield Orm.rollbackTransaction(transaction);
-                }
-                yield Orm.detachQuietly(db);
-                throw error;
-            }
+            }));
+            return "OK";
         });
     }
     static executeQueries(transaction, queries, params) {
@@ -286,7 +394,8 @@ class Orm {
             try {
                 return yield queries.reduce((promiseChain, currentQuery, index) => {
                     return promiseChain.then(() => new Promise((resolve, reject) => {
-                        transaction.query(currentQuery, params[index], (err, result) => {
+                        var _a;
+                        transaction.query(currentQuery, (_a = params[index]) !== null && _a !== void 0 ? _a : [], (err, result) => {
                             if (err) {
                                 return reject(err);
                             }
@@ -296,7 +405,7 @@ class Orm {
                 }, Promise.resolve());
             }
             catch (error) {
-                return yield new Promise((resolve, reject) => {
+                return yield new Promise((_resolve, reject) => {
                     transaction.rollback((rollbackErr) => {
                         if (rollbackErr) {
                             return reject(rollbackErr);
@@ -310,4 +419,5 @@ class Orm {
 }
 exports.Orm = Orm;
 Orm.logger = new Logger_1.Logger(Orm.name);
+Orm.pools = new Map();
 //# sourceMappingURL=Orm.js.map

package/dist/Orm.js.map

@@ -1 +1 @@
-{"version":3,"file":"Orm.js","sourceRoot":"","sources":["../src/Orm.ts"],"names":[],"mappings":"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","sourcesContent":["import * as Firebird from \"node-firebird\";\nimport { Database, Options, Transaction } from \"node-firebird\";\nimport { Logger } from \"./Logger\";\nimport { RestUtilities } from \"./Utilities\";\nimport {\n    describeFirebirdCompatibilityOptions,\n    enhanceFirebirdError,\n    FirebirdOptions,\n    normalizeFirebirdOptions,\n} from \"./firebird-compat\";\n\nexport class Orm {\n    private static logger: Logger = new Logger(Orm.name);\n\n    public static quote(value: string): string {\n        return \"\\\"\" + value + \"\\\"\";\n    }\n\n    private static getTimeoutMs(options: Options): number {\n        const normalizedOptions = normalizeFirebirdOptions(options);\n        const candidate = normalizedOptions.connectTimeout ?? 15000;\n        return Number.isFinite(candidate) && candidate > 0 ? Math.trunc(candidate) : 15000;\n    }\n\n    private static createTimeoutError(stage: string, timeoutMs: number, options: Options, query?: string): Error {\n        const target = `${options.host ?? \"?\"}:${options.port ?? \"?\"} -> ${options.database ?? \"?\"}`;\n        const suffix = query ? ` | sql=${query.replace(/\\s+/g, \" \").trim()}` : \"\";\n        return new Error(`Timeout during Firebird ${stage} after ${timeoutMs} ms on ${target}${suffix}`);\n    }\n\n    private static async detachQuietly(db: Database | undefined): Promise<void> {\n        if (!db) {\n            return;\n        }\n\n        await new Promise<void>((resolve) => {\n            try {\n                db.detach(() => resolve());\n            } catch {\n                resolve();\n            }\n        });\n    }\n\n    private static attachWithTimeout(options: Options): Promise<Database> {\n        return new Promise((resolve, reject): void => {\n            const normalizedOptions = normalizeFirebirdOptions(options);\n            const timeoutMs = this.getTimeoutMs(normalizedOptions);\n            let settled = false;\n            const timeoutId = setTimeout(() => {\n                if (settled) {\n                    return;\n                }\n\n                settled = true;\n                reject(\n                    enhanceFirebirdError(\n                        this.createTimeoutError(\"attach\", timeoutMs, normalizedOptions),\n                        normalizedOptions,\n                        { stage: \"attach\" },\n                    ),\n                );\n            }, timeoutMs);\n\n            this.logger.info(`Firebird attach using ${describeFirebirdCompatibilityOptions(normalizedOptions)}`);\n\n            Firebird.attach(normalizedOptions, async (err: any, db: Database): Promise<void> => {\n                if (settled) {\n                    await this.detachQuietly(db);\n                    return;\n                }\n\n                settled = true;\n                clearTimeout(timeoutId);\n\n                if (err) {\n                    return reject(enhanceFirebirdError(err, normalizedOptions, { stage: \"attach\" }));\n                }\n\n                return resolve(db);\n            });\n        });\n    }\n\n    public static async testConnection(options: Options): Promise<boolean> {\n        return new Promise((resolve): void => {\n            this.attachWithTimeout(options)\n                .then(async (db: Database): Promise<void> => {\n                    this.logger.info(\"DATABASE connesso.\");\n                    await this.detachQuietly(db);\n                    resolve(true);\n                })\n                .catch((err: Error): void => {\n                    this.logger.error(\"La connessione con il DATABASE non e andata a buon fine.\");\n                    this.logger.error(err);\n                    resolve(false);\n                });\n        });\n    }\n\n    public static async query(options: Options, query: string, parameters: any[] = [], logQuery = true): Promise<any> {\n        try {\n            const normalizedOptions = normalizeFirebirdOptions(options);\n            const db = await this.attachWithTimeout(normalizedOptions);\n\n            return await new Promise((resolve, reject): void => {\n                const timeoutMs = this.getTimeoutMs(normalizedOptions);\n                let settled = false;\n                const timeoutId = setTimeout(async () => {\n                    if (settled) {\n                        return;\n                    }\n\n                    settled = true;\n                    await this.detachQuietly(db);\n                    reject(\n                        enhanceFirebirdError(\n                            this.createTimeoutError(\"query\", timeoutMs, normalizedOptions, query),\n                            normalizedOptions,\n                            { stage: \"query\", sql: query },\n                        ),\n                    );\n                }, timeoutMs);\n\n                if (logQuery) {\n                    this.logger.info(RestUtilities.printQueryWithParams(query, parameters));\n                }\n\n                db.query(query, parameters, async (error: any, result: any) => {\n                    if (settled) {\n                        await this.detachQuietly(db);\n                        return;\n                    }\n\n                    settled = true;\n                    clearTimeout(timeoutId);\n                    await this.detachQuietly(db);\n\n                    if (error) {\n                        return reject(enhanceFirebirdError(error, normalizedOptions, { stage: \"query\", sql: query }));\n                    }\n\n                    return resolve(result);\n                });\n            });\n        } catch (error) {\n            const normalizedError = enhanceFirebirdError(error, options, { stage: \"query\", sql: query });\n            this.logger.error(normalizedError);\n            throw normalizedError;\n        }\n    }\n\n    public static async execute(options: Options, query: string, parameters: any = [], logQuery = true): Promise<any> {\n        try {\n            const normalizedOptions = normalizeFirebirdOptions(options);\n            const db = await this.attachWithTimeout(normalizedOptions);\n\n            return await new Promise((resolve, reject): void => {\n                const timeoutMs = this.getTimeoutMs(normalizedOptions);\n                let settled = false;\n                const timeoutId = setTimeout(async () => {\n                    if (settled) {\n                        return;\n                    }\n\n                    settled = true;\n                    await this.detachQuietly(db);\n                    reject(\n                        enhanceFirebirdError(\n                            this.createTimeoutError(\"execute\", timeoutMs, normalizedOptions, query),\n                            normalizedOptions,\n                            { stage: \"execute\", sql: query },\n                        ),\n                    );\n                }, timeoutMs);\n\n                if (logQuery) {\n                    this.logger.info(RestUtilities.printQueryWithParams(query, parameters));\n                }\n\n                db.execute(query, parameters, async (error: any, result: any) => {\n                    if (settled) {\n                        await this.detachQuietly(db);\n                        return;\n                    }\n\n                    settled = true;\n                    clearTimeout(timeoutId);\n                    await this.detachQuietly(db);\n\n                    if (error) {\n                        return reject(enhanceFirebirdError(error, normalizedOptions, { stage: \"execute\", sql: query }));\n                    }\n\n                    return resolve(result);\n                });\n            });\n        } catch (error) {\n            const normalizedError = enhanceFirebirdError(error, options, { stage: \"execute\", sql: query });\n            this.logger.error(normalizedError);\n            throw normalizedError;\n        }\n    }\n\n    public static trimParam(param: any): string {\n        if (typeof param === \"string\" || param instanceof String) {\n            return param.trim();\n        }\n        return param;\n    }\n\n    public static async connect(options: Options): Promise<Database> {\n        return this.attachWithTimeout(options);\n    }\n\n    public static async startTransaction(db: Database): Promise<Transaction> {\n        return new Promise((resolve, reject): void => {\n            db.transaction(Firebird.ISOLATION_READ_COMMITTED, function (err: any, transaction: Transaction): void {\n                if (err) {\n                    return reject(err);\n                }\n\n                return resolve(transaction);\n            });\n        });\n    }\n\n    public static async commitTransaction(transaction: Transaction): Promise<string> {\n        return new Promise((resolve, reject): void => {\n            transaction.commit((err: any): void => {\n                if (err) {\n                    return reject(err);\n                }\n\n                return resolve(\"Transaction committed successfully.\");\n            });\n        });\n    }\n\n    public static async rollbackTransaction(transaction: Transaction): Promise<string> {\n        return new Promise((resolve, reject): void => {\n            transaction.rollback((err: any): void => {\n                if (err) {\n                    return reject(err);\n                }\n\n                return resolve(\"Transaction rolled back successfully.\");\n            });\n        });\n    }\n\n    public static async executeMultiple(options: Options, queriesWithParams: { query: string, params: any[] }[]): Promise<string> {\n        let db: Database | undefined;\n        let transaction: Transaction | undefined;\n\n        try {\n            db = await Orm.connect(options);\n            transaction = await Orm.startTransaction(db);\n\n            for (const qwp of queriesWithParams) {\n                await new Promise((resolve, reject) => {\n                    transaction!.query(qwp.query, qwp.params, (err: any, result: any): void => {\n                        if (err) {\n                            return reject(err);\n                        }\n\n                        return resolve(result);\n                    });\n                });\n            }\n\n            await Orm.commitTransaction(transaction);\n            await Orm.detachQuietly(db);\n            return \"OK\";\n        } catch (error) {\n            if (transaction) {\n                await Orm.rollbackTransaction(transaction);\n            }\n\n            await Orm.detachQuietly(db);\n            throw error;\n        }\n    }\n\n    public static async executeQueries(transaction: Transaction, queries: string[], params: any[]): Promise<any> {\n        try {\n            return await queries.reduce((promiseChain: Promise<any>, currentQuery: string, index: number) => {\n                return promiseChain.then(() => new Promise((resolve, reject) => {\n                    transaction.query(currentQuery, params[index], (err: any, result: any): void => {\n                        if (err) {\n                            return reject(err);\n                        }\n\n                        return resolve(result);\n                    });\n                }));\n            }, Promise.resolve());\n        } catch (error) {\n            return await new Promise((resolve, reject) => {\n                transaction.rollback((rollbackErr: any): void => {\n                    if (rollbackErr) {\n                        return reject(rollbackErr);\n                    }\n\n                    return reject(error);\n                });\n            });\n        }\n    }\n}\n"]}
+{"version":3,"file":"Orm.js","sourceRoot":"","sources":["../src/Orm.ts"],"names":[],"mappings":"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","sourcesContent":["import * as Firebird from \"node-firebird\";\nimport { ConnectionPool, Database, Options, QueryParams, Transaction } from \"node-firebird\";\nimport { Logger } from \"./Logger\";\nimport { RestUtilities } from \"./Utilities\";\nimport {\n    describeFirebirdCompatibilityOptions,\n    enhanceFirebirdError,\n    FirebirdOptions,\n    normalizeFirebirdOptions,\n    normalizeFirebirdResult,\n} from \"./firebird-compat\";\n\n/** Valore scalare di una colonna Firebird (riga flat). */\nexport type DbValue = string | number | boolean | Date | Buffer | null | undefined;\n\n/** Riga generica restituita da `Orm.query`/`Orm.execute` quando non si specifica un tipo. */\nexport type Row = Record<string, DbValue>;\n\nexport class Orm {\n    private static logger: Logger = new Logger(Orm.name);\n    private static pools: Map<string, ConnectionPool> = new Map();\n\n    public static quote(value: string): string {\n        return \"\\\"\" + value + \"\\\"\";\n    }\n\n    /** Dimensione pool: default 5 (pool attivo); `poolSize: 0` disabilita e torna all'attach per query. */\n    private static getPoolSize(options: Options): number {\n        const raw = (options as FirebirdOptions).poolSize;\n        if (raw === 0) {\n            return 0;\n        }\n        const size = raw === undefined ? 5 : Number(raw);\n        return Number.isFinite(size) && size > 0 ? Math.trunc(size) : 0;\n    }\n\n    private static shouldLogQueryParameters(options: Options): boolean {\n        return (options as FirebirdOptions).logQueryParameters === true;\n    }\n\n    private static formatQueryForLog(query: string, parameters: QueryParams, includeValues: boolean): string {\n        const parameterList = Array.isArray(parameters) ? parameters : Object.values(parameters ?? {});\n        if (includeValues) {\n            return RestUtilities.printQueryWithParams(query, parameterList);\n        }\n        return `${query.replace(/\\s+/g, \" \").trim()} [params=${parameterList.length}]`;\n    }\n\n    private static buildPoolKey(options: Options, size: number): string {\n        const normalized = normalizeFirebirdOptions(options);\n        return [\n            size,\n            normalized.host ?? \"\",\n            normalized.port ?? \"\",\n            normalized.database ?? \"\",\n            normalized.user ?? \"\",\n            normalized.pluginName ?? \"\",\n            String(normalized.wireCrypt ?? \"\"),\n        ].join(\"|\");\n    }\n\n    /**\n     * Chiude tutti i pool creati (opt-in `poolSize`). Utile a fine processo o nei test,\n     * perché i pool mantengono connessioni e timer attivi.\n     */\n    public static async closePools(): Promise<void> {\n        const pools = Array.from(this.pools.values());\n        this.pools.clear();\n        await Promise.all(pools.map((pool) => new Promise<void>((resolve) => {\n            try {\n                pool.destroy(() => resolve());\n            } catch {\n                resolve();\n            }\n        })));\n    }\n\n    private static getPool(options: Options, size: number): ConnectionPool {\n        const normalized = normalizeFirebirdOptions(options);\n        const key = this.buildPoolKey(normalized, size);\n        let pool = this.pools.get(key);\n        if (!pool) {\n            this.logger.info(`Firebird pool created (max=${size}) using ${describeFirebirdCompatibilityOptions(normalized)}`);\n            pool = Firebird.pool(size, normalized);\n            pool.on(\"error\", (error: Error) => {\n                this.logger.error(`Firebird pool error: ${error.message}`);\n            });\n            this.pools.set(key, pool);\n        }\n        return pool;\n    }\n\n    private static getTimeoutMs(options: Options): number {\n        const candidate = (options as FirebirdOptions).connectTimeout ?? 15000;\n        return Number.isFinite(candidate) && candidate > 0 ? Math.trunc(candidate) : 15000;\n    }\n\n    private static createTimeoutError(stage: string, timeoutMs: number, options: Options, query?: string): Error {\n        const target = `${options.host ?? \"?\"}:${options.port ?? \"?\"} -> ${options.database ?? \"?\"}`;\n        const suffix = query ? ` | sql=${query.replace(/\\s+/g, \" \").trim()}` : \"\";\n        return new Error(`Timeout during Firebird ${stage} after ${timeoutMs} ms on ${target}${suffix}`);\n    }\n\n    private static async detachQuietly(db: Database | undefined): Promise<void> {\n        if (!db) {\n            return;\n        }\n\n        await new Promise<void>((resolve) => {\n            try {\n                db.detach(() => resolve());\n            } catch {\n                resolve();\n            }\n        });\n    }\n\n    private static shouldTrimStringResults(options: FirebirdOptions): boolean {\n        return options.trimStringResults !== false;\n    }\n\n    private static shouldConvertDatesToUtc(options: FirebirdOptions): boolean {\n        return options.utcDates !== false;\n    }\n\n    private static attachWithTimeout(options: Options): Promise<Database> {\n        return new Promise((resolve, reject): void => {\n            const normalizedOptions = normalizeFirebirdOptions(options);\n            const timeoutMs = this.getTimeoutMs(normalizedOptions);\n            const poolSize = this.getPoolSize(options);\n            let settled = false;\n            const timeoutId = setTimeout(() => {\n                if (settled) {\n                    return;\n                }\n\n                settled = true;\n                reject(\n                    enhanceFirebirdError(\n                        this.createTimeoutError(\"attach\", timeoutMs, normalizedOptions),\n                        normalizedOptions,\n                        { stage: \"attach\" },\n                    ),\n                );\n            }, timeoutMs);\n\n            const handle = async (err: unknown, db: Database): Promise<void> => {\n                if (settled) {\n                    await this.detachQuietly(db);\n                    return;\n                }\n\n                settled = true;\n                clearTimeout(timeoutId);\n\n                if (err) {\n                    return reject(enhanceFirebirdError(err, normalizedOptions, { stage: \"attach\" }));\n                }\n\n                return resolve(db);\n            };\n\n            try {\n                if (poolSize > 0) {\n                    this.getPool(options, poolSize).get(handle);\n                    return;\n                }\n\n                this.logger.info(`Firebird attach using ${describeFirebirdCompatibilityOptions(normalizedOptions)}`);\n\n                Firebird.attach(normalizedOptions, handle);\n            } catch (error) {\n                // Attach/get sincrono fallito: evita di lasciare il timer di timeout pendente.\n                if (!settled) {\n                    settled = true;\n                    clearTimeout(timeoutId);\n                    reject(enhanceFirebirdError(error, normalizedOptions, { stage: \"attach\" }));\n                }\n            }\n        });\n    }\n\n    public static async testConnection(options: Options): Promise<boolean> {\n        return new Promise((resolve): void => {\n            this.attachWithTimeout(options)\n                .then(async (db: Database): Promise<void> => {\n                    this.logger.info(\"DATABASE connesso.\");\n                    await this.detachQuietly(db);\n                    resolve(true);\n                })\n                .catch((err: Error): void => {\n                    this.logger.error(\"La connessione con il DATABASE non e andata a buon fine.\");\n                    this.logger.error(err);\n                    resolve(false);\n                });\n        });\n    }\n\n    public static async query<T = Row>(\n        options: Options,\n        query: string,\n        parameters: QueryParams = [],\n        logQuery = true,\n    ): Promise<T[]> {\n        try {\n            const normalizedOptions = normalizeFirebirdOptions(options);\n            const db = await this.attachWithTimeout(options);\n\n            return await new Promise<T[]>((resolve, reject): void => {\n                const timeoutMs = this.getTimeoutMs(normalizedOptions);\n                let settled = false;\n                const timeoutId = setTimeout(async () => {\n                    if (settled) {\n                        return;\n                    }\n\n                    settled = true;\n                    await this.detachQuietly(db);\n                    reject(\n                        enhanceFirebirdError(\n                            this.createTimeoutError(\"query\", timeoutMs, normalizedOptions, query),\n                            normalizedOptions,\n                            { stage: \"query\", sql: query },\n                        ),\n                    );\n                }, timeoutMs);\n\n                if (logQuery) {\n                    this.logger.info(this.formatQueryForLog(query, parameters, this.shouldLogQueryParameters(options)));\n                }\n\n                db.query<unknown>(query, parameters, async (error: unknown, result: unknown[]) => {\n                    if (settled) {\n                        await this.detachQuietly(db);\n                        return;\n                    }\n\n                    settled = true;\n                    clearTimeout(timeoutId);\n                    await this.detachQuietly(db);\n\n                    if (error) {\n                        return reject(enhanceFirebirdError(error, normalizedOptions, { stage: \"query\", sql: query }));\n                    }\n\n                    return resolve(normalizeFirebirdResult(result, this.shouldTrimStringResults(normalizedOptions), this.shouldConvertDatesToUtc(normalizedOptions)) as T[]);\n                });\n            });\n        } catch (error) {\n            const normalizedError = enhanceFirebirdError(error, options, { stage: \"query\", sql: query });\n            this.logger.error(normalizedError);\n            throw normalizedError;\n        }\n    }\n\n    public static async execute<T = Row>(\n        options: Options,\n        query: string,\n        parameters: QueryParams = [],\n        logQuery = true,\n    ): Promise<T[]> {\n        try {\n            const normalizedOptions = normalizeFirebirdOptions(options);\n            const db = await this.attachWithTimeout(options);\n\n            return await new Promise<T[]>((resolve, reject): void => {\n                const timeoutMs = this.getTimeoutMs(normalizedOptions);\n                let settled = false;\n                const timeoutId = setTimeout(async () => {\n                    if (settled) {\n                        return;\n                    }\n\n                    settled = true;\n                    await this.detachQuietly(db);\n                    reject(\n                        enhanceFirebirdError(\n                            this.createTimeoutError(\"execute\", timeoutMs, normalizedOptions, query),\n                            normalizedOptions,\n                            { stage: \"execute\", sql: query },\n                        ),\n                    );\n                }, timeoutMs);\n\n                if (logQuery) {\n                    this.logger.info(this.formatQueryForLog(query, parameters, this.shouldLogQueryParameters(options)));\n                }\n\n                db.execute<unknown>(query, parameters, async (error: unknown, result: unknown[]) => {\n                    if (settled) {\n                        await this.detachQuietly(db);\n                        return;\n                    }\n\n                    settled = true;\n                    clearTimeout(timeoutId);\n                    await this.detachQuietly(db);\n\n                    if (error) {\n                        return reject(enhanceFirebirdError(error, normalizedOptions, { stage: \"execute\", sql: query }));\n                    }\n\n                    return resolve(normalizeFirebirdResult(result, this.shouldTrimStringResults(normalizedOptions), this.shouldConvertDatesToUtc(normalizedOptions)) as T[]);\n                });\n            });\n        } catch (error) {\n            const normalizedError = enhanceFirebirdError(error, options, { stage: \"execute\", sql: query });\n            this.logger.error(normalizedError);\n            throw normalizedError;\n        }\n    }\n\n    public static trimParam<T>(param: T): string | T {\n        if (typeof param === \"string\" || param instanceof String) {\n            return String(param).trim();\n        }\n        return param;\n    }\n\n    public static async connect(options: Options): Promise<Database> {\n        return this.attachWithTimeout(options);\n    }\n\n    /**\n     * Runs `operation` inside a single Firebird transaction: commit on success,\n     * rollback on failure, detach in every case. Use it to make multi-statement\n     * writes atomic instead of relying on auto-commit per statement.\n     */\n    public static async withTransaction<T>(\n        options: Options,\n        operation: (transaction: Transaction) => Promise<T>,\n    ): Promise<T> {\n        const db = await this.connect(options);\n        let transaction: Transaction | undefined;\n\n        try {\n            transaction = await this.startTransaction(db);\n            const result = await operation(transaction);\n            await this.commitTransaction(transaction);\n            return result;\n        } catch (error) {\n            if (transaction) {\n                try {\n                    await this.rollbackTransaction(transaction);\n                } catch {\n                    // Se la rollback fallisce (connessione persa) l'errore originale resta quello rilevante.\n                }\n            }\n            throw error;\n        } finally {\n            await this.detachQuietly(db);\n        }\n    }\n\n    /** Esegue una query su una transazione esistente e ne restituisce il risultato. */\n    public static transactionQuery<T = Row[]>(\n        transaction: Transaction,\n        query: string,\n        parameters: QueryParams = [],\n    ): Promise<T> {\n        return new Promise<T>((resolve, reject): void => {\n            transaction.query(query, parameters, (error: unknown, result: unknown[]): void => {\n                if (error) {\n                    reject(error);\n                    return;\n                }\n\n                resolve(result as T);\n            });\n        });\n    }\n\n    public static async startTransaction(db: Database): Promise<Transaction> {\n        return new Promise((resolve, reject): void => {\n            db.transaction(Firebird.ISOLATION_READ_COMMITTED, function (err: unknown, transaction: Transaction): void {\n                if (err) {\n                    return reject(err);\n                }\n\n                return resolve(transaction);\n            });\n        });\n    }\n\n    public static async commitTransaction(transaction: Transaction): Promise<string> {\n        return new Promise((resolve, reject): void => {\n            transaction.commit((err: unknown): void => {\n                if (err) {\n                    return reject(err);\n                }\n\n                return resolve(\"Transaction committed successfully.\");\n            });\n        });\n    }\n\n    public static async rollbackTransaction(transaction: Transaction): Promise<string> {\n        return new Promise((resolve, reject): void => {\n            transaction.rollback((err: unknown): void => {\n                if (err) {\n                    return reject(err);\n                }\n\n                return resolve(\"Transaction rolled back successfully.\");\n            });\n        });\n    }\n\n    public static async executeMultiple(options: Options, queriesWithParams: { query: string, params: QueryParams }[]): Promise<string> {\n        await Orm.withTransaction(options, async (transaction) => {\n            for (const qwp of queriesWithParams) {\n                await Orm.transactionQuery(transaction, qwp.query, qwp.params);\n            }\n        });\n\n        return \"OK\";\n    }\n\n    public static async executeQueries(transaction: Transaction, queries: string[], params: QueryParams[]): Promise<unknown> {\n        try {\n            return await queries.reduce((promiseChain: Promise<unknown>, currentQuery: string, index: number) => {\n                return promiseChain.then(() => new Promise((resolve, reject) => {\n                    transaction.query(currentQuery, params[index] ?? [], (err: unknown, result: unknown[]): void => {\n                        if (err) {\n                            return reject(err);\n                        }\n\n                        return resolve(result);\n                    });\n                }));\n            }, Promise.resolve());\n        } catch (error) {\n            return await new Promise((_resolve, reject) => {\n                transaction.rollback((rollbackErr: unknown): void => {\n                    if (rollbackErr) {\n                        return reject(rollbackErr);\n                    }\n\n                    return reject(error);\n                });\n            });\n        }\n    }\n}\n"]}

package/dist/RoutesLoggerMiddleware.js.map

@@ -1 +1 @@
-{"version":3,"file":"RoutesLoggerMiddleware.js","sourceRoot":"","sources":["../src/RoutesLoggerMiddleware.ts"],"names":[],"mappings":";;;AAGA;;GAEG;AACH,MAAa,sBAAsB;IAG/B;;;OAGG;IACH,YAAY,MAAc;QACtB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAED;;;;;OAKG;IACH,gBAAgB,CAAC,GAAY,EAAE,GAAa,EAAE,IAAkB;QAC5D,MAAM,KAAK,GAAS,IAAI,IAAI,EAAE,CAAC,CAAC,wCAAwC;QAExE,0EAA0E;QAC1E,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAS,EAAE;YACxB,MAAM,GAAG,GAAS,IAAI,IAAI,EAAE,CAAC,CAAC,sCAAsC;YACpE,MAAM,OAAO,GAAW,GAAG,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,8CAA8C;YAEvG,gDAAgD;YAChD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,sBAAsB,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,WAAW,KAAK,OAAO,KAAK,CAAC,CAAC;QAC3F,CAAC,CAAC,CAAC;QAEH,yDAAyD;QACzD,IAAI,EAAE,CAAC;IACX,CAAC;CACJ;AAhCD,wDAgCC","sourcesContent":["import { NextFunction, Request, Response } from \"express\";\r\nimport { Logger } from \".\";\r\n\r\n/**\r\n * Middleware class for logging the execution time of routes.\r\n */\r\nexport class RoutesLoggerMiddleware {\r\n    private logger: Logger;\r\n\r\n    /**\r\n     * Initializes the logger instance to be used.\r\n     * @param logger - The logger instance.\r\n     */\r\n    constructor(logger: Logger) {\r\n        this.logger = logger;\r\n    }\r\n\r\n    /**\r\n     * Middleware function to log the execution time of each route.\r\n     * @param req - The incoming HTTP request.\r\n     * @param res - The HTTP response.\r\n     * @param next - The next middleware function in the chain.\r\n     */\r\n    logExecutionTime(req: Request, res: Response, next: NextFunction): void {\r\n        const start: Date = new Date(); // Record the start time of the request.\r\n\r\n        // Attach a listener to the response object to calculate the elapsed time.\r\n        res.on(\"finish\", (): void => {\r\n            const end: Date = new Date(); // Record the end time of the request.\r\n            const elapsed: number = end.getTime() - start.getTime(); // Calculate the elapsed time in milliseconds.\r\n\r\n            // Log the HTTP method, URL, and execution time.\r\n            this.logger.info(`Execution time for ${req.method} ${req.originalUrl}: ${elapsed} ms`);\r\n        });\r\n\r\n        // Continue to the next middleware function in the chain.\r\n        next();\r\n    }\r\n}\r\n"]}
+{"version":3,"file":"RoutesLoggerMiddleware.js","sourceRoot":"","sources":["../src/RoutesLoggerMiddleware.ts"],"names":[],"mappings":";;;AAGA;;GAEG;AACH,MAAa,sBAAsB;IAG/B;;;OAGG;IACH,YAAY,MAAc;QACtB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAED;;;;;OAKG;IACH,gBAAgB,CAAC,GAAY,EAAE,GAAa,EAAE,IAAkB;QAC5D,MAAM,KAAK,GAAS,IAAI,IAAI,EAAE,CAAC,CAAC,wCAAwC;QAExE,0EAA0E;QAC1E,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAS,EAAE;YACxB,MAAM,GAAG,GAAS,IAAI,IAAI,EAAE,CAAC,CAAC,sCAAsC;YACpE,MAAM,OAAO,GAAW,GAAG,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,8CAA8C;YAEvG,gDAAgD;YAChD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,sBAAsB,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,WAAW,KAAK,OAAO,KAAK,CAAC,CAAC;QAC3F,CAAC,CAAC,CAAC;QAEH,yDAAyD;QACzD,IAAI,EAAE,CAAC;IACX,CAAC;CACJ;AAhCD,wDAgCC","sourcesContent":["import { NextFunction, Request, Response } from \"express\";\nimport { Logger } from \".\";\n\n/**\n * Middleware class for logging the execution time of routes.\n */\nexport class RoutesLoggerMiddleware {\n    private logger: Logger;\n\n    /**\n     * Initializes the logger instance to be used.\n     * @param logger - The logger instance.\n     */\n    constructor(logger: Logger) {\n        this.logger = logger;\n    }\n\n    /**\n     * Middleware function to log the execution time of each route.\n     * @param req - The incoming HTTP request.\n     * @param res - The HTTP response.\n     * @param next - The next middleware function in the chain.\n     */\n    logExecutionTime(req: Request, res: Response, next: NextFunction): void {\n        const start: Date = new Date(); // Record the start time of the request.\n\n        // Attach a listener to the response object to calculate the elapsed time.\n        res.on(\"finish\", (): void => {\n            const end: Date = new Date(); // Record the end time of the request.\n            const elapsed: number = end.getTime() - start.getTime(); // Calculate the elapsed time in milliseconds.\n\n            // Log the HTTP method, URL, and execution time.\n            this.logger.info(`Execution time for ${req.method} ${req.originalUrl}: ${elapsed} ms`);\n        });\n\n        // Continue to the next middleware function in the chain.\n        next();\n    }\n}\n"]}

package/dist/Utilities.d.ts

@@ -50,9 +50,10 @@ export declare class RestUtilities {
      * Sends an OK message as a response.
      * @param res - Express Response object.
      * @param message - The success message.
+     * @param status - HTTP success status. Defaults to 200; pass 201 only after creating a resource.
      * @returns The Response object.
      */
-    static sendOKMessage(res: Response, message: string): Response;
+    static sendOKMessage(res: Response, message: string, status?: number): Response;
     /**
      * Sends an error message as a response.
      * @param res - Express Response object.
@@ -61,7 +62,9 @@ export declare class RestUtilities {
      * @param status - HTTP status code (default: 500).
      * @returns The Response object.
      */
-    static sendErrorMessage(res: Response, error: any, tag?: string, status?: number): Response;
+    static sendErrorMessage(res: Response, error: unknown, tag?: string, status?: number): Response;
+    /** Riconosce errori di metadata Firebird che richiedono una migrazione. */
+    static isDatabaseSchemaError(error: unknown): boolean;
     static sendUnauthorized(res: Response): Response;
     static sendInvalidCredentials(res: Response): Response;
     static sendPasswordExpired(res: Response): Response;
@@ -69,27 +72,32 @@ export declare class RestUtilities {
      * Sends a base response with a payload.
      * @param res - Express Response object.
      * @param payload - The payload to include in the response.
+     * @param status - HTTP success status. Defaults to 200; pass 201 only after creating a resource.
      * @returns The Response object.
      */
-    static sendBaseResponse(res: Response, payload: any): Response;
+    static sendBaseResponse(res: Response, payload: unknown, statusOrTag?: number | string, status?: number): Response;
     /**
      * Sends an execution message as a response.
      * @param res - Express Response object.
      * @param executionObject - The execution data.
      * @param title - The title of the response.
+     * @param status - HTTP success status. Defaults to 200.
      * @returns The Response object.
      */
-    static sendExecMessage(res: Response, executionObject: any, title: string): Response;
+    static sendExecMessage(res: Response, executionObject: unknown, title: string, status?: number): Response;
     /**
-     * Prints a SQL query with parameters replaced.
+     * Prints a SQL query with parameters replaced. Replacement is literal: values
+     * containing `?` or `$&` no longer corrupt the output as in the legacy
+     * `String.replace` implementation.
      * @param query - The SQL query.
      * @param params - The parameters to replace.
      * @returns The formatted query.
      */
-    static printQueryWithParams(query: string, params: any[]): string;
-    static convertKeysToCamelCase(obj: any): any;
+    static printQueryWithParams(query?: string, params?: unknown[]): string;
+    static convertKeysToCamelCase<T = Record<string, unknown>>(obj: unknown): T;
 }
 export declare class CryptUtilities {
+    private static readonly logger;
     /**
  * Cifra un testo in chiaro usando l'algoritmo AES-128 in modalità ECB.
  *
@@ -124,6 +132,8 @@ export declare class PasswordUtilities {
     static hashLegacyEncryptedPassword(legacyEncryptedPassword: string): string;
     static isPasswordHash(value: string): boolean;
     static isLegacyPasswordHash(value: string): boolean;
+    /** Confronto a tempo costante tra due stringhe (per dati legacy non hashati). */
+    static timingSafeStringEquals(value: string, candidate: string): boolean;
     static verifyPassword(plainPassword: string, storedPassword: string): boolean;
     static verifyLegacyEncryptedPassword(legacyEncryptedPassword: string, storedPassword: string): boolean;
 }
@@ -154,4 +164,4 @@ export declare class DatabaseUtilities {
      */
     static createOption(host: string, port: number, database: string, username?: string, password?: string): FirebirdOptions;
 }
-export declare function Deprecated(message: string): (target: any, key?: string, descriptor?: PropertyDescriptor) => void;
+export declare function Deprecated(message: string): (target: object, key?: string, descriptor?: PropertyDescriptor) => void;