emilsoftware-utilities 2.0.0-dev.22 → 2.0.0-dev.24

package/dist/Logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"Logger.js","sourceRoot":"","sources":["../src/Logger.ts"],"names":[],"mappings":"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","sourcesContent":["import winston from \"winston\";\nimport * as path from \"path\";\nimport { promises as fs } from \"fs\";\nimport { blue, red, magenta, green, cyan, yellow } from 'colorette';\n\nexport enum LogLevels {\n    INFO = \"INFO\",\n    ERROR = \"ERROR\",\n    WARNING = \"WARNING\",\n    DEBUG = \"DEBUG\",\n    LOG = \"LOG\",\n    DATABASE = \"DATABASE\",\n}\n\nexport class Logger {\n    private readonly winstonLogger: winston.Logger;\n    private readonly tag: string;\n    private readonly logDirectory: string;\n    private logFormat: winston.Logform.Format;\n\n    constructor(\n        tag: string,\n        config?: {\n            logDirectory?: string;\n            customFormat?: winston.Logform.Format;\n            transports?: winston.transport[];\n        }\n    ) {\n        this.tag = tag || \"[UNTAGGED]\";\n        this.logDirectory = config?.logDirectory || \"logs\";\n\n        // Default log format\n        this.logFormat =\n            config?.customFormat ||\n            winston.format.printf(({ timestamp, file, level, message, ...meta }) => {\n                return JSON.stringify({\n                    timestamp: timestamp || new Date().toISOString(),\n                    tag: this.tag,\n                    file: this.replaceAll(file + \"\", \"\\\\\", \"/\"),\n                    level,\n                    message,\n                    ...meta,\n                });\n            });\n\n        this.initializeDirectory();\n\n        // Configure logger\n        this.winstonLogger = winston.createLogger({\n            format: winston.format.combine(winston.format.timestamp(), this.logFormat),\n            transports: config?.transports || [\n                new winston.transports.File({\n                    filename: path.join(this.logDirectory, this.getFileName() + \".json\"),\n                }),\n            ],\n            levels: {\n                error: 1,\n                warning: 2,\n                info: 3,\n                http: 4,\n                verbose: 5,\n                debug: 6,\n                silly: 7,\n                database: 8,\n            },\n        });\n\n        // Add colors for console logging\n        winston.addColors({\n            database: \"green\",\n            error: \"red\",\n            warning: \"yellow\",\n            info: \"blue\",\n            debug: \"magenta\",\n            log: \"cyan\",\n        });\n    }\n\n    private async initializeDirectory() {\n        try {\n            const exists = await fs.access(this.logDirectory).then(() => true).catch(() => false);\n            if (!exists) {\n                await fs.mkdir(this.logDirectory);\n            }\n        } catch (err) {\n            console.error(\"Error initializing log directory:\", err);\n        }\n    }\n\n    private getFileName(): string {\n        const now = new Date();\n        const dateString = now.toISOString().split(\"T\")[0]; // YYYY-MM-DD\n        return dateString;\n    }\n\n    private replaceAll(string: string, match: string, replacer: string) {\n        return string.split(match).join(replacer);\n    }\n\n    public execStart(prefix: string = \"\"): number {\n        this.print(LogLevels.INFO, `${prefix} - Execution started`);\n        return performance.now();\n    }\n\n    public execStop(prefix: string = \"\", startTime: number, error: boolean = false): void {\n        const executionTime = performance.now() - startTime;\n        const message = `${prefix} - Execution ended ${error ? \"due to an error\" : \"successfully\"\n            }. Execution time: ${executionTime.toFixed(2)} ms`;\n        this.print(error ? LogLevels.ERROR : LogLevels.INFO, message);\n    }\n\n    public info(...data: Object[]): void {\n        this.print(LogLevels.INFO, ...data);\n    }\n\n    public dbLog(...data: Object[]): void {\n        this.print(LogLevels.DATABASE, ...data);\n    }\n\n    public debug(...data: Object[]): void {\n        this.print(LogLevels.DEBUG, ...data);\n    }\n\n    public warning(...data: Object[]): void {\n        this.print(LogLevels.WARNING, ...data);\n    }\n\n    public log(...data: Object[]): void {\n        this.print(LogLevels.LOG, ...data);\n    }\n\n    public error(...data: Object[]): void {\n        this.print(LogLevels.ERROR, ...data);\n    }\n\n    private print(level: LogLevels, ...data: Object[]): void {\n        const now: Date = new Date();\n        const fileName = this.tag.split(\"\\\\\").pop() || this.tag;\n\n        // Attach metadata to Winston logger\n        this.winstonLogger.defaultMeta = {\n            file: fileName,\n            time: now,\n            level,\n        };\n\n        const logEntry: winston.LogEntry = {\n            level: level.toLowerCase(),\n            message: [...data].join(\",\"),\n        };\n\n        // Log to console with colors\n        switch (level) {\n            case LogLevels.INFO:\n                console.info(blue(`[INFO][${now}][${fileName}]`), logEntry.message);\n                break;\n            case LogLevels.ERROR:\n                console.error(red(`[ERROR][${now}][${fileName}]`), logEntry.message);\n                break;\n            case LogLevels.DEBUG:\n                console.debug(magenta(`[DEBUG][${now}][${fileName}]`), logEntry.message);\n                break;\n            case LogLevels.WARNING:\n                console.debug(yellow(`[WARNING][${now}][${fileName}]`), logEntry.message);\n                break;\n            case LogLevels.LOG:\n                console.log(cyan(`[LOG][${now}][${fileName}]`), logEntry.message);\n                break;\n            case LogLevels.DATABASE:\n                console.log(green(`[DATABASE][${now}][${fileName}]`), logEntry.message);\n                break;\n        }\n\n        // Log to file\n        this.winstonLogger.log(logEntry);\n    }\n\n    public static createLogger(tag: string, config?: { logDirectory?: string }): Logger {\n        return new Logger(tag, config);\n    }\n}\n"]}
+{"version":3,"file":"Logger.js","sourceRoot":"","sources":["../src/Logger.ts"],"names":[],"mappings":"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","sourcesContent":["import winston from \"winston\";\nimport { DailyFileTransport } from './DailyFileTransport';\nimport { blue, red, magenta, green, cyan, yellow } from 'colorette';\n\nexport enum LogLevels {\n    INFO = \"INFO\",\n    ERROR = \"ERROR\",\n    WARNING = \"WARNING\",\n    DEBUG = \"DEBUG\",\n    LOG = \"LOG\",\n    DATABASE = \"DATABASE\",\n}\n\n/** Livelli winston usati dal logger (comprende `database` e `general`). */\nconst WIN_LEVELS = {\n    error: 1,\n    warning: 2,\n    info: 3,\n    general: 3,\n    http: 4,\n    verbose: 5,\n    debug: 6,\n    silly: 7,\n    database: 8,\n};\n\n/** Chiavi i cui valori non devono mai finire nei log. */\nconst SENSITIVE_KEY_PATTERN = /(password|passwd|pwd|secret|token|authorization|apikey|api_key|cookie)/i;\nconst REDACTED = '[REDACTED]';\n\n/**\n * Serializza un valore per il log, redigendo i campi sensibili e risolvendo\n * `Error` e riferimenti circolari (che altrimenti diventano `[object Object]`).\n */\nfunction serializeLogValue(value: unknown, seen: WeakSet<object>): unknown {\n    if (value instanceof Error) {\n        return { name: value.name, message: value.message, stack: value.stack };\n    }\n\n    if (Array.isArray(value)) {\n        return value.map((item) => serializeLogValue(item, seen));\n    }\n\n    if (value && typeof value === 'object') {\n        if (seen.has(value)) {\n            return '[Circular]';\n        }\n        seen.add(value);\n\n        const result: Record<string, unknown> = {};\n        for (const [key, nested] of Object.entries(value as Record<string, unknown>)) {\n            result[key] = SENSITIVE_KEY_PATTERN.test(key) ? REDACTED : serializeLogValue(nested, seen);\n        }\n        return result;\n    }\n\n    return value;\n}\n\n/** Costruisce il messaggio testuale del log a partire dagli argomenti. */\nfunction stringifyLogData(data: unknown[]): string {\n    return data.map((value) => {\n        if (typeof value === 'string') {\n            return value;\n        }\n        if (value instanceof Error) {\n            return value.stack ?? `${value.name}: ${value.message}`;\n        }\n        if (value === undefined) {\n            return 'undefined';\n        }\n        if (value === null) {\n            return 'null';\n        }\n        try {\n            return JSON.stringify(serializeLogValue(value, new WeakSet()));\n        } catch {\n            return String(value);\n        }\n    }).join(', ');\n}\n\n/** Formato condiviso: JSON a una riga, con tag/file/level/messaggio. */\nfunction defaultFormat(): winston.Logform.Format {\n    return winston.format.printf(({ timestamp, tag, file, level, message, ...meta }) => JSON.stringify({\n        timestamp: timestamp || new Date().toISOString(),\n        tag,\n        file: String(file ?? '').split('\\\\').join('/'),\n        level: level === 'general' ? 'log' : level,\n        message,\n        ...meta,\n    }));\n}\n\n/**\n * Logger strutturato dell'applicazione.\n *\n * - I log finiscono su console (colorati) e su file JSON giornaliero.\n * - Le istanze con la stessa `logDirectory` condividono un unico logger winston\n *   (un solo transport/timer), evitando di crearne uno per classe.\n * - I campi sensibili (password, token, secret, ...) sono redatti automaticamente.\n */\nexport class Logger {\n    private readonly winstonLogger: winston.Logger;\n    private readonly tag: string;\n    private readonly logDirectory: string;\n    private readonly maxLevel: number;\n\n    /** Logger winston condivisi per directory, così da non moltiplicare transport e timer. */\n    private static readonly sharedLoggers = new Map<string, winston.Logger>();\n    private static colorsRegistered = false;\n\n    constructor(\n        tag: string,\n        config?: {\n            logDirectory?: string;\n            customFormat?: winston.Logform.Format;\n            transports?: winston.transport[];\n            /** Livello minimo loggato: `error`..`database` (default `database`, ovvero tutto). Override con `LOG_LEVEL`. */\n            level?: string;\n        }\n    ) {\n        this.tag = tag || \"[UNTAGGED]\";\n        this.logDirectory = config?.logDirectory || \"logs\";\n\n        const configuredLevel = (config?.level ?? process.env.LOG_LEVEL ?? 'database').toLowerCase();\n        this.maxLevel = WIN_LEVELS[configuredLevel as keyof typeof WIN_LEVELS] ?? WIN_LEVELS.database;\n\n        const format = winston.format.combine(\n            winston.format.timestamp(),\n            config?.customFormat || defaultFormat(),\n        );\n\n        this.winstonLogger = config?.transports\n            ? winston.createLogger({ level: 'database', format, transports: config.transports, levels: WIN_LEVELS })\n            : Logger.resolveSharedLogger(this.logDirectory, format);\n\n        if (!Logger.colorsRegistered) {\n            winston.addColors({\n                database: \"green\",\n                error: \"red\",\n                warning: \"yellow\",\n                info: \"blue\",\n                debug: \"magenta\",\n                log: \"cyan\",\n            });\n            Logger.colorsRegistered = true;\n        }\n    }\n\n    private static resolveSharedLogger(logDirectory: string, format: winston.Logform.Format): winston.Logger {\n        const existing = Logger.sharedLoggers.get(logDirectory);\n        if (existing) {\n            return existing;\n        }\n\n        const logger = winston.createLogger({\n            level: 'database',\n            format,\n            transports: [new DailyFileTransport(logDirectory)],\n            levels: WIN_LEVELS,\n        });\n        Logger.sharedLoggers.set(logDirectory, logger);\n        return logger;\n    }\n\n    public execStart(prefix: string = \"\"): number {\n        this.print(LogLevels.INFO, `${prefix} - Execution started`);\n        return performance.now();\n    }\n\n    public execStop(prefix: string = \"\", startTime: number, error: boolean = false): void {\n        const executionTime = performance.now() - startTime;\n        const message = `${prefix} - Execution ended ${error ? \"due to an error\" : \"successfully\"\n            }. Execution time: ${executionTime.toFixed(2)} ms`;\n        this.print(error ? LogLevels.ERROR : LogLevels.INFO, message);\n    }\n\n    public info(...data: unknown[]): void {\n        this.print(LogLevels.INFO, ...data);\n    }\n\n    public dbLog(...data: unknown[]): void {\n        this.print(LogLevels.DATABASE, ...data);\n    }\n\n    public debug(...data: unknown[]): void {\n        this.print(LogLevels.DEBUG, ...data);\n    }\n\n    public warning(...data: unknown[]): void {\n        this.print(LogLevels.WARNING, ...data);\n    }\n\n    public log(...data: unknown[]): void {\n        this.print(LogLevels.LOG, ...data);\n    }\n\n    public error(...data: unknown[]): void {\n        this.print(LogLevels.ERROR, ...data);\n    }\n\n    private print(level: LogLevels, ...data: unknown[]): void {\n        const rank = level === LogLevels.LOG ? WIN_LEVELS.general : (WIN_LEVELS[level.toLowerCase() as keyof typeof WIN_LEVELS] ?? WIN_LEVELS.database);\n        if (rank > this.maxLevel) {\n            return;\n        }\n\n        const now: Date = new Date();\n        const fileName = this.tag.split(\"\\\\\").pop() || this.tag;\n        const message = stringifyLogData(data);\n\n        // Console colorata (il livello file resta strutturato).\n        switch (level) {\n            case LogLevels.INFO:\n                console.info(blue(`[INFO][${now}][${fileName}]`), message);\n                break;\n            case LogLevels.ERROR:\n                console.error(red(`[ERROR][${now}][${fileName}]`), message);\n                break;\n            case LogLevels.DEBUG:\n                console.debug(magenta(`[DEBUG][${now}][${fileName}]`), message);\n                break;\n            case LogLevels.WARNING:\n                console.debug(yellow(`[WARNING][${now}][${fileName}]`), message);\n                break;\n            case LogLevels.LOG:\n                console.log(cyan(`[LOG][${now}][${fileName}]`), message);\n                break;\n            case LogLevels.DATABASE:\n                console.log(green(`[DATABASE][${now}][${fileName}]`), message);\n                break;\n        }\n\n        this.winstonLogger.log({\n            level: level === LogLevels.LOG ? 'general' : level.toLowerCase(),\n            message,\n            tag: this.tag,\n            file: fileName,\n            time: now,\n        });\n    }\n\n    public static createLogger(tag: string, config?: { logDirectory?: string }): Logger {\n        return new Logger(tag, config);\n    }\n}\n"]}

package/dist/Orm.d.ts

@@ -1,7 +1,19 @@
-import { Database, Options, Transaction } from "node-firebird";
+import { Database, Options, QueryParams, Transaction } from "node-firebird";
 export declare class Orm {
     private static logger;
+    private static pools;
     static quote(value: string): string;
+    /** Dimensione pool: default 5 (pool attivo); `poolSize: 0` disabilita e torna all'attach per query. */
+    private static getPoolSize;
+    private static shouldLogQueryParameters;
+    private static formatQueryForLog;
+    private static buildPoolKey;
+    /**
+     * 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(): Promise<void>;
+    private static getPool;
     private static getTimeoutMs;
     private static createTimeoutError;
     private static detachQuietly;
@@ -9,16 +21,24 @@ export declare class Orm {
     private static normalizeResultValue;
     private static attachWithTimeout;
     static testConnection(options: Options): Promise<boolean>;
-    static query(options: Options, query: string, parameters?: any[], logQuery?: boolean): Promise<any>;
-    static execute(options: Options, query: string, parameters?: any, logQuery?: boolean): Promise<any>;
-    static trimParam(param: any): string;
+    static query<T = Record<string, unknown>>(options: Options, query: string, parameters?: QueryParams, logQuery?: boolean): Promise<T[]>;
+    static execute<T = Record<string, unknown>>(options: Options, query: string, parameters?: QueryParams, logQuery?: boolean): Promise<T[]>;
+    static trimParam<T>(param: T): string | T;
     static connect(options: Options): Promise<Database>;
+    /**
+     * 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<T>(options: Options, operation: (transaction: Transaction) => Promise<T>): Promise<T>;
+    /** Esegue una query su una transazione esistente e ne restituisce il risultato. */
+    static transactionQuery<T = unknown>(transaction: Transaction, query: string, parameters?: QueryParams): Promise<T>;
     static startTransaction(db: Database): Promise<Transaction>;
     static commitTransaction(transaction: Transaction): Promise<string>;
     static rollbackTransaction(transaction: Transaction): Promise<string>;
     static executeMultiple(options: Options, queriesWithParams: {
         query: string;
-        params: any[];
+        params: QueryParams;
     }[]): Promise<string>;
-    static executeQueries(transaction: Transaction, queries: string[], params: any[]): Promise<any>;
+    static executeQueries(transaction: Transaction, queries: string[], params: QueryParams[]): Promise<unknown>;
 }

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) {
@@ -79,8 +142,7 @@ class Orm {
         });
     }
     static shouldTrimStringResults(options) {
-        const normalizedOptions = (0, firebird_compat_1.normalizeFirebirdOptions)(options);
-        return normalizedOptions.trimStringResults !== false;
+        return options.trimStringResults !== false;
     }
     static normalizeResultValue(value, trimStringResults) {
         if (!trimStringResults || value === undefined || value === null) {
@@ -96,8 +158,9 @@ class Orm {
             return value;
         }
         if (typeof value === "object") {
-            return Object.keys(value).reduce((normalized, key) => {
-                normalized[key] = this.normalizeResultValue(value[key], trimStringResults);
+            const source = value;
+            return Object.keys(source).reduce((normalized, key) => {
+                normalized[key] = this.normalizeResultValue(source[key], trimStringResults);
                 return normalized;
             }, {});
         }
@@ -107,6 +170,7 @@ class Orm {
         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) {
@@ -115,8 +179,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;
@@ -127,7 +190,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) {
@@ -151,7 +230,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;
@@ -164,7 +243,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) {
@@ -192,7 +271,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;
@@ -205,7 +284,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) {
@@ -231,7 +310,7 @@ class Orm {
     }
     static trimParam(param) {
         if (typeof param === "string" || param instanceof String) {
-            return param.trim();
+            return String(param).trim();
         }
         return param;
     }
@@ -240,6 +319,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) => {
@@ -278,32 +400,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) {
@@ -311,7 +413,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);
                             }
@@ -321,7 +424,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);
@@ -335,4 +438,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 shouldTrimStringResults(options: Options): boolean {\n        const normalizedOptions = normalizeFirebirdOptions(options);\n        return normalizedOptions.trimStringResults !== false;\n    }\n\n    private static normalizeResultValue(value: any, trimStringResults: boolean): any {\n        if (!trimStringResults || value === undefined || value === null) {\n            return value;\n        }\n\n        if (typeof value === \"string\" || value instanceof String) {\n            return String(value).trimEnd();\n        }\n\n        if (Array.isArray(value)) {\n            return value.map((item) => this.normalizeResultValue(item, trimStringResults));\n        }\n\n        if (value instanceof Date || Buffer.isBuffer(value)) {\n            return value;\n        }\n\n        if (typeof value === \"object\") {\n            return Object.keys(value).reduce((normalized: Record<string, any>, key: string) => {\n                normalized[key] = this.normalizeResultValue(value[key], trimStringResults);\n                return normalized;\n            }, {});\n        }\n\n        return value;\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(this.normalizeResultValue(result, this.shouldTrimStringResults(normalizedOptions)));\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(this.normalizeResultValue(result, this.shouldTrimStringResults(normalizedOptions)));\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\";\r\nimport { ConnectionPool, Database, Options, QueryParams, Transaction } from \"node-firebird\";\r\nimport { Logger } from \"./Logger\";\r\nimport { RestUtilities } from \"./Utilities\";\r\nimport {\r\n    describeFirebirdCompatibilityOptions,\r\n    enhanceFirebirdError,\r\n    FirebirdOptions,\r\n    normalizeFirebirdOptions,\r\n} from \"./firebird-compat\";\r\n\r\nexport class Orm {\r\n    private static logger: Logger = new Logger(Orm.name);\r\n    private static pools: Map<string, ConnectionPool> = new Map();\r\n\r\n    public static quote(value: string): string {\r\n        return \"\\\"\" + value + \"\\\"\";\r\n    }\r\n\r\n    /** Dimensione pool: default 5 (pool attivo); `poolSize: 0` disabilita e torna all'attach per query. */\r\n    private static getPoolSize(options: Options): number {\r\n        const raw = (options as FirebirdOptions).poolSize;\r\n        if (raw === 0) {\r\n            return 0;\r\n        }\r\n        const size = raw === undefined ? 5 : Number(raw);\r\n        return Number.isFinite(size) && size > 0 ? Math.trunc(size) : 0;\r\n    }\r\n\r\n    private static shouldLogQueryParameters(options: Options): boolean {\r\n        return (options as FirebirdOptions).logQueryParameters === true;\r\n    }\r\n\r\n    private static formatQueryForLog(query: string, parameters: QueryParams, includeValues: boolean): string {\r\n        const parameterList = Array.isArray(parameters) ? parameters : Object.values(parameters ?? {});\r\n        if (includeValues) {\r\n            return RestUtilities.printQueryWithParams(query, parameterList);\r\n        }\r\n        return `${query.replace(/\\s+/g, \" \").trim()} [params=${parameterList.length}]`;\r\n    }\r\n\r\n    private static buildPoolKey(options: Options, size: number): string {\r\n        const normalized = normalizeFirebirdOptions(options);\r\n        return [\r\n            size,\r\n            normalized.host ?? \"\",\r\n            normalized.port ?? \"\",\r\n            normalized.database ?? \"\",\r\n            normalized.user ?? \"\",\r\n            normalized.pluginName ?? \"\",\r\n            String(normalized.wireCrypt ?? \"\"),\r\n        ].join(\"|\");\r\n    }\r\n\r\n    /**\r\n     * Chiude tutti i pool creati (opt-in `poolSize`). Utile a fine processo o nei test,\r\n     * perché i pool mantengono connessioni e timer attivi.\r\n     */\r\n    public static async closePools(): Promise<void> {\r\n        const pools = Array.from(this.pools.values());\r\n        this.pools.clear();\r\n        await Promise.all(pools.map((pool) => new Promise<void>((resolve) => {\r\n            try {\r\n                pool.destroy(() => resolve());\r\n            } catch {\r\n                resolve();\r\n            }\r\n        })));\r\n    }\r\n\r\n    private static getPool(options: Options, size: number): ConnectionPool {\r\n        const normalized = normalizeFirebirdOptions(options);\r\n        const key = this.buildPoolKey(normalized, size);\r\n        let pool = this.pools.get(key);\r\n        if (!pool) {\r\n            this.logger.info(`Firebird pool created (max=${size}) using ${describeFirebirdCompatibilityOptions(normalized)}`);\r\n            pool = Firebird.pool(size, normalized);\r\n            pool.on(\"error\", (error: Error) => {\r\n                this.logger.error(`Firebird pool error: ${error.message}`);\r\n            });\r\n            this.pools.set(key, pool);\r\n        }\r\n        return pool;\r\n    }\r\n\r\n    private static getTimeoutMs(options: Options): number {\r\n        const candidate = (options as FirebirdOptions).connectTimeout ?? 15000;\r\n        return Number.isFinite(candidate) && candidate > 0 ? Math.trunc(candidate) : 15000;\r\n    }\r\n\r\n    private static createTimeoutError(stage: string, timeoutMs: number, options: Options, query?: string): Error {\r\n        const target = `${options.host ?? \"?\"}:${options.port ?? \"?\"} -> ${options.database ?? \"?\"}`;\r\n        const suffix = query ? ` | sql=${query.replace(/\\s+/g, \" \").trim()}` : \"\";\r\n        return new Error(`Timeout during Firebird ${stage} after ${timeoutMs} ms on ${target}${suffix}`);\r\n    }\r\n\r\n    private static async detachQuietly(db: Database | undefined): Promise<void> {\r\n        if (!db) {\r\n            return;\r\n        }\r\n\r\n        await new Promise<void>((resolve) => {\r\n            try {\r\n                db.detach(() => resolve());\r\n            } catch {\r\n                resolve();\r\n            }\r\n        });\r\n    }\r\n\r\n    private static shouldTrimStringResults(options: FirebirdOptions): boolean {\r\n        return options.trimStringResults !== false;\r\n    }\r\n\r\n    private static normalizeResultValue(value: unknown, trimStringResults: boolean): unknown {\r\n        if (!trimStringResults || value === undefined || value === null) {\r\n            return value;\r\n        }\r\n\r\n        if (typeof value === \"string\" || value instanceof String) {\r\n            return String(value).trimEnd();\r\n        }\r\n\r\n        if (Array.isArray(value)) {\r\n            return value.map((item) => this.normalizeResultValue(item, trimStringResults));\r\n        }\r\n\r\n        if (value instanceof Date || Buffer.isBuffer(value)) {\r\n            return value;\r\n        }\r\n\r\n        if (typeof value === \"object\") {\r\n            const source = value as Record<string, unknown>;\r\n            return Object.keys(source).reduce((normalized: Record<string, unknown>, key: string) => {\r\n                normalized[key] = this.normalizeResultValue(source[key], trimStringResults);\r\n                return normalized;\r\n            }, {});\r\n        }\r\n\r\n        return value;\r\n    }\r\n\r\n    private static attachWithTimeout(options: Options): Promise<Database> {\r\n        return new Promise((resolve, reject): void => {\r\n            const normalizedOptions = normalizeFirebirdOptions(options);\r\n            const timeoutMs = this.getTimeoutMs(normalizedOptions);\r\n            const poolSize = this.getPoolSize(options);\r\n            let settled = false;\r\n            const timeoutId = setTimeout(() => {\r\n                if (settled) {\r\n                    return;\r\n                }\r\n\r\n                settled = true;\r\n                reject(\r\n                    enhanceFirebirdError(\r\n                        this.createTimeoutError(\"attach\", timeoutMs, normalizedOptions),\r\n                        normalizedOptions,\r\n                        { stage: \"attach\" },\r\n                    ),\r\n                );\r\n            }, timeoutMs);\r\n\r\n            const handle = async (err: unknown, db: Database): Promise<void> => {\r\n                if (settled) {\r\n                    await this.detachQuietly(db);\r\n                    return;\r\n                }\r\n\r\n                settled = true;\r\n                clearTimeout(timeoutId);\r\n\r\n                if (err) {\r\n                    return reject(enhanceFirebirdError(err, normalizedOptions, { stage: \"attach\" }));\r\n                }\r\n\r\n                return resolve(db);\r\n            };\r\n\r\n            try {\r\n                if (poolSize > 0) {\r\n                    this.getPool(options, poolSize).get(handle);\r\n                    return;\r\n                }\r\n\r\n                this.logger.info(`Firebird attach using ${describeFirebirdCompatibilityOptions(normalizedOptions)}`);\r\n\r\n                Firebird.attach(normalizedOptions, handle);\r\n            } catch (error) {\r\n                // Attach/get sincrono fallito: evita di lasciare il timer di timeout pendente.\r\n                if (!settled) {\r\n                    settled = true;\r\n                    clearTimeout(timeoutId);\r\n                    reject(enhanceFirebirdError(error, normalizedOptions, { stage: \"attach\" }));\r\n                }\r\n            }\r\n        });\r\n    }\r\n\r\n    public static async testConnection(options: Options): Promise<boolean> {\r\n        return new Promise((resolve): void => {\r\n            this.attachWithTimeout(options)\r\n                .then(async (db: Database): Promise<void> => {\r\n                    this.logger.info(\"DATABASE connesso.\");\r\n                    await this.detachQuietly(db);\r\n                    resolve(true);\r\n                })\r\n                .catch((err: Error): void => {\r\n                    this.logger.error(\"La connessione con il DATABASE non e andata a buon fine.\");\r\n                    this.logger.error(err);\r\n                    resolve(false);\r\n                });\r\n        });\r\n    }\r\n\r\n    public static async query<T = Record<string, unknown>>(\r\n        options: Options,\r\n        query: string,\r\n        parameters: QueryParams = [],\r\n        logQuery = true,\r\n    ): Promise<T[]> {\r\n        try {\r\n            const normalizedOptions = normalizeFirebirdOptions(options);\r\n            const db = await this.attachWithTimeout(options);\r\n\r\n            return await new Promise<T[]>((resolve, reject): void => {\r\n                const timeoutMs = this.getTimeoutMs(normalizedOptions);\r\n                let settled = false;\r\n                const timeoutId = setTimeout(async () => {\r\n                    if (settled) {\r\n                        return;\r\n                    }\r\n\r\n                    settled = true;\r\n                    await this.detachQuietly(db);\r\n                    reject(\r\n                        enhanceFirebirdError(\r\n                            this.createTimeoutError(\"query\", timeoutMs, normalizedOptions, query),\r\n                            normalizedOptions,\r\n                            { stage: \"query\", sql: query },\r\n                        ),\r\n                    );\r\n                }, timeoutMs);\r\n\r\n                if (logQuery) {\r\n                    this.logger.info(this.formatQueryForLog(query, parameters, this.shouldLogQueryParameters(options)));\r\n                }\r\n\r\n                db.query<unknown>(query, parameters, async (error: unknown, result: unknown[]) => {\r\n                    if (settled) {\r\n                        await this.detachQuietly(db);\r\n                        return;\r\n                    }\r\n\r\n                    settled = true;\r\n                    clearTimeout(timeoutId);\r\n                    await this.detachQuietly(db);\r\n\r\n                    if (error) {\r\n                        return reject(enhanceFirebirdError(error, normalizedOptions, { stage: \"query\", sql: query }));\r\n                    }\r\n\r\n                    return resolve(this.normalizeResultValue(result, this.shouldTrimStringResults(normalizedOptions)) as T[]);\r\n                });\r\n            });\r\n        } catch (error) {\r\n            const normalizedError = enhanceFirebirdError(error, options, { stage: \"query\", sql: query });\r\n            this.logger.error(normalizedError);\r\n            throw normalizedError;\r\n        }\r\n    }\r\n\r\n    public static async execute<T = Record<string, unknown>>(\r\n        options: Options,\r\n        query: string,\r\n        parameters: QueryParams = [],\r\n        logQuery = true,\r\n    ): Promise<T[]> {\r\n        try {\r\n            const normalizedOptions = normalizeFirebirdOptions(options);\r\n            const db = await this.attachWithTimeout(options);\r\n\r\n            return await new Promise<T[]>((resolve, reject): void => {\r\n                const timeoutMs = this.getTimeoutMs(normalizedOptions);\r\n                let settled = false;\r\n                const timeoutId = setTimeout(async () => {\r\n                    if (settled) {\r\n                        return;\r\n                    }\r\n\r\n                    settled = true;\r\n                    await this.detachQuietly(db);\r\n                    reject(\r\n                        enhanceFirebirdError(\r\n                            this.createTimeoutError(\"execute\", timeoutMs, normalizedOptions, query),\r\n                            normalizedOptions,\r\n                            { stage: \"execute\", sql: query },\r\n                        ),\r\n                    );\r\n                }, timeoutMs);\r\n\r\n                if (logQuery) {\r\n                    this.logger.info(this.formatQueryForLog(query, parameters, this.shouldLogQueryParameters(options)));\r\n                }\r\n\r\n                db.execute<unknown>(query, parameters, async (error: unknown, result: unknown[]) => {\r\n                    if (settled) {\r\n                        await this.detachQuietly(db);\r\n                        return;\r\n                    }\r\n\r\n                    settled = true;\r\n                    clearTimeout(timeoutId);\r\n                    await this.detachQuietly(db);\r\n\r\n                    if (error) {\r\n                        return reject(enhanceFirebirdError(error, normalizedOptions, { stage: \"execute\", sql: query }));\r\n                    }\r\n\r\n                    return resolve(this.normalizeResultValue(result, this.shouldTrimStringResults(normalizedOptions)) as T[]);\r\n                });\r\n            });\r\n        } catch (error) {\r\n            const normalizedError = enhanceFirebirdError(error, options, { stage: \"execute\", sql: query });\r\n            this.logger.error(normalizedError);\r\n            throw normalizedError;\r\n        }\r\n    }\r\n\r\n    public static trimParam<T>(param: T): string | T {\r\n        if (typeof param === \"string\" || param instanceof String) {\r\n            return String(param).trim();\r\n        }\r\n        return param;\r\n    }\r\n\r\n    public static async connect(options: Options): Promise<Database> {\r\n        return this.attachWithTimeout(options);\r\n    }\r\n\r\n    /**\r\n     * Runs `operation` inside a single Firebird transaction: commit on success,\r\n     * rollback on failure, detach in every case. Use it to make multi-statement\r\n     * writes atomic instead of relying on auto-commit per statement.\r\n     */\r\n    public static async withTransaction<T>(\r\n        options: Options,\r\n        operation: (transaction: Transaction) => Promise<T>,\r\n    ): Promise<T> {\r\n        const db = await this.connect(options);\r\n        let transaction: Transaction | undefined;\r\n\r\n        try {\r\n            transaction = await this.startTransaction(db);\r\n            const result = await operation(transaction);\r\n            await this.commitTransaction(transaction);\r\n            return result;\r\n        } catch (error) {\r\n            if (transaction) {\r\n                try {\r\n                    await this.rollbackTransaction(transaction);\r\n                } catch {\r\n                    // Se la rollback fallisce (connessione persa) l'errore originale resta quello rilevante.\r\n                }\r\n            }\r\n            throw error;\r\n        } finally {\r\n            await this.detachQuietly(db);\r\n        }\r\n    }\r\n\r\n    /** Esegue una query su una transazione esistente e ne restituisce il risultato. */\r\n    public static transactionQuery<T = unknown>(\r\n        transaction: Transaction,\r\n        query: string,\r\n        parameters: QueryParams = [],\r\n    ): Promise<T> {\r\n        return new Promise<T>((resolve, reject): void => {\r\n            transaction.query(query, parameters, (error: unknown, result: unknown[]): void => {\r\n                if (error) {\r\n                    reject(error);\r\n                    return;\r\n                }\r\n\r\n                resolve(result as T);\r\n            });\r\n        });\r\n    }\r\n\r\n    public static async startTransaction(db: Database): Promise<Transaction> {\r\n        return new Promise((resolve, reject): void => {\r\n            db.transaction(Firebird.ISOLATION_READ_COMMITTED, function (err: unknown, transaction: Transaction): void {\r\n                if (err) {\r\n                    return reject(err);\r\n                }\r\n\r\n                return resolve(transaction);\r\n            });\r\n        });\r\n    }\r\n\r\n    public static async commitTransaction(transaction: Transaction): Promise<string> {\r\n        return new Promise((resolve, reject): void => {\r\n            transaction.commit((err: unknown): void => {\r\n                if (err) {\r\n                    return reject(err);\r\n                }\r\n\r\n                return resolve(\"Transaction committed successfully.\");\r\n            });\r\n        });\r\n    }\r\n\r\n    public static async rollbackTransaction(transaction: Transaction): Promise<string> {\r\n        return new Promise((resolve, reject): void => {\r\n            transaction.rollback((err: unknown): void => {\r\n                if (err) {\r\n                    return reject(err);\r\n                }\r\n\r\n                return resolve(\"Transaction rolled back successfully.\");\r\n            });\r\n        });\r\n    }\r\n\r\n    public static async executeMultiple(options: Options, queriesWithParams: { query: string, params: QueryParams }[]): Promise<string> {\r\n        await Orm.withTransaction(options, async (transaction) => {\r\n            for (const qwp of queriesWithParams) {\r\n                await Orm.transactionQuery(transaction, qwp.query, qwp.params);\r\n            }\r\n        });\r\n\r\n        return \"OK\";\r\n    }\r\n\r\n    public static async executeQueries(transaction: Transaction, queries: string[], params: QueryParams[]): Promise<unknown> {\r\n        try {\r\n            return await queries.reduce((promiseChain: Promise<unknown>, currentQuery: string, index: number) => {\r\n                return promiseChain.then(() => new Promise((resolve, reject) => {\r\n                    transaction.query(currentQuery, params[index] ?? [], (err: unknown, result: unknown[]): void => {\r\n                        if (err) {\r\n                            return reject(err);\r\n                        }\r\n\r\n                        return resolve(result);\r\n                    });\r\n                }));\r\n            }, Promise.resolve());\r\n        } catch (error) {\r\n            return await new Promise((_resolve, reject) => {\r\n                transaction.rollback((rollbackErr: unknown): void => {\r\n                    if (rollbackErr) {\r\n                        return reject(rollbackErr);\r\n                    }\r\n\r\n                    return reject(error);\r\n                });\r\n            });\r\n        }\r\n    }\r\n}\r\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\";\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"]}
+{"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"]}

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, 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;