emilsoftware-utilities 2.0.0-dev.23 → 2.0.0-dev.25

package/dist/Logger.d.ts

@@ -7,25 +7,38 @@ export declare enum LogLevels {
     LOG = "LOG",
     DATABASE = "DATABASE"
 }
+/**
+ * Logger strutturato dell'applicazione.
+ *
+ * - I log finiscono su console (colorati) e su file JSON giornaliero.
+ * - Le istanze con la stessa `logDirectory` condividono un unico logger winston
+ *   (un solo transport/timer), evitando di crearne uno per classe.
+ * - I campi sensibili (password, token, secret, ...) sono redatti automaticamente.
+ */
 export declare class Logger {
     private readonly winstonLogger;
     private readonly tag;
     private readonly logDirectory;
-    private logFormat;
+    private readonly maxLevel;
+    /** Logger winston condivisi per directory, così da non moltiplicare transport e timer. */
+    private static readonly sharedLoggers;
+    private static colorsRegistered;
     constructor(tag: string, config?: {
         logDirectory?: string;
         customFormat?: winston.Logform.Format;
         transports?: winston.transport[];
+        /** Livello minimo loggato: `error`..`database` (default `database`, ovvero tutto). Override con `LOG_LEVEL`. */
+        level?: string;
     });
-    private replaceAll;
+    private static resolveSharedLogger;
     execStart(prefix?: string): number;
-    execStop(prefix: string, startTime: number, error?: boolean): void;
-    info(...data: Object[]): void;
-    dbLog(...data: Object[]): void;
-    debug(...data: Object[]): void;
-    warning(...data: Object[]): void;
-    log(...data: Object[]): void;
-    error(...data: Object[]): void;
+    execStop(prefix: string | undefined, startTime: number, error?: boolean): void;
+    info(...data: unknown[]): void;
+    dbLog(...data: unknown[]): void;
+    debug(...data: unknown[]): void;
+    warning(...data: unknown[]): void;
+    log(...data: unknown[]): void;
+    error(...data: unknown[]): void;
     private print;
     static createLogger(tag: string, config?: {
         logDirectory?: string;

package/dist/Logger.js

@@ -27,48 +27,120 @@ var LogLevels;
     LogLevels["LOG"] = "LOG";
     LogLevels["DATABASE"] = "DATABASE";
 })(LogLevels || (exports.LogLevels = LogLevels = {}));
+/** Livelli winston usati dal logger (comprende `database` e `general`). */
+const WIN_LEVELS = {
+    error: 1,
+    warning: 2,
+    info: 3,
+    general: 3,
+    http: 4,
+    verbose: 5,
+    debug: 6,
+    silly: 7,
+    database: 8,
+};
+/** Chiavi i cui valori non devono mai finire nei log. */
+const SENSITIVE_KEY_PATTERN = /(password|passwd|pwd|secret|token|authorization|apikey|api_key|cookie)/i;
+const REDACTED = '[REDACTED]';
+/**
+ * Serializza un valore per il log, redigendo i campi sensibili e risolvendo
+ * `Error` e riferimenti circolari (che altrimenti diventano `[object Object]`).
+ */
+function serializeLogValue(value, seen) {
+    if (value instanceof Error) {
+        return { name: value.name, message: value.message, stack: value.stack };
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => serializeLogValue(item, seen));
+    }
+    if (value && typeof value === 'object') {
+        if (seen.has(value)) {
+            return '[Circular]';
+        }
+        seen.add(value);
+        const result = {};
+        for (const [key, nested] of Object.entries(value)) {
+            result[key] = SENSITIVE_KEY_PATTERN.test(key) ? REDACTED : serializeLogValue(nested, seen);
+        }
+        return result;
+    }
+    return value;
+}
+/** Costruisce il messaggio testuale del log a partire dagli argomenti. */
+function stringifyLogData(data) {
+    return data.map((value) => {
+        var _a;
+        if (typeof value === 'string') {
+            return value;
+        }
+        if (value instanceof Error) {
+            return (_a = value.stack) !== null && _a !== void 0 ? _a : `${value.name}: ${value.message}`;
+        }
+        if (value === undefined) {
+            return 'undefined';
+        }
+        if (value === null) {
+            return 'null';
+        }
+        try {
+            return JSON.stringify(serializeLogValue(value, new WeakSet()));
+        }
+        catch (_b) {
+            return String(value);
+        }
+    }).join(', ');
+}
+/** Formato condiviso: JSON a una riga, con tag/file/level/messaggio. */
+function defaultFormat() {
+    return winston_1.default.format.printf((_a) => {
+        var { timestamp, tag, file, level, message } = _a, meta = __rest(_a, ["timestamp", "tag", "file", "level", "message"]);
+        return JSON.stringify(Object.assign({ timestamp: timestamp || new Date().toISOString(), tag, file: String(file !== null && file !== void 0 ? file : '').split('\\').join('/'), level: level === 'general' ? 'log' : level, message }, meta));
+    });
+}
+/**
+ * Logger strutturato dell'applicazione.
+ *
+ * - I log finiscono su console (colorati) e su file JSON giornaliero.
+ * - Le istanze con la stessa `logDirectory` condividono un unico logger winston
+ *   (un solo transport/timer), evitando di crearne uno per classe.
+ * - I campi sensibili (password, token, secret, ...) sono redatti automaticamente.
+ */
 class Logger {
     constructor(tag, config) {
+        var _a, _b, _c;
         this.tag = tag || "[UNTAGGED]";
         this.logDirectory = (config === null || config === void 0 ? void 0 : config.logDirectory) || "logs";
-        // Default log format
-        this.logFormat =
-            (config === null || config === void 0 ? void 0 : config.customFormat) ||
-                winston_1.default.format.printf((_a) => {
-                    var { timestamp, file, level, message } = _a, meta = __rest(_a, ["timestamp", "file", "level", "message"]);
-                    return JSON.stringify(Object.assign({ timestamp: timestamp || new Date().toISOString(), tag: this.tag, file: this.replaceAll(file + "", "\\", "/"), level: level === 'general' ? 'log' : level, message }, meta));
-                });
-        // Configure logger
-        this.winstonLogger = winston_1.default.createLogger({
+        const configuredLevel = ((_b = (_a = config === null || config === void 0 ? void 0 : config.level) !== null && _a !== void 0 ? _a : process.env.LOG_LEVEL) !== null && _b !== void 0 ? _b : 'database').toLowerCase();
+        this.maxLevel = (_c = WIN_LEVELS[configuredLevel]) !== null && _c !== void 0 ? _c : WIN_LEVELS.database;
+        const format = winston_1.default.format.combine(winston_1.default.format.timestamp(), (config === null || config === void 0 ? void 0 : config.customFormat) || defaultFormat());
+        this.winstonLogger = (config === null || config === void 0 ? void 0 : config.transports)
+            ? winston_1.default.createLogger({ level: 'database', format, transports: config.transports, levels: WIN_LEVELS })
+            : Logger.resolveSharedLogger(this.logDirectory, format);
+        if (!Logger.colorsRegistered) {
+            winston_1.default.addColors({
+                database: "green",
+                error: "red",
+                warning: "yellow",
+                info: "blue",
+                debug: "magenta",
+                log: "cyan",
+            });
+            Logger.colorsRegistered = true;
+        }
+    }
+    static resolveSharedLogger(logDirectory, format) {
+        const existing = Logger.sharedLoggers.get(logDirectory);
+        if (existing) {
+            return existing;
+        }
+        const logger = winston_1.default.createLogger({
             level: 'database',
-            format: winston_1.default.format.combine(winston_1.default.format.timestamp(), this.logFormat),
-            transports: (config === null || config === void 0 ? void 0 : config.transports) || [
-                new DailyFileTransport_1.DailyFileTransport(this.logDirectory),
-            ],
-            levels: {
-                error: 1,
-                warning: 2,
-                info: 3,
-                general: 3,
-                http: 4,
-                verbose: 5,
-                debug: 6,
-                silly: 7,
-                database: 8,
-            },
+            format,
+            transports: [new DailyFileTransport_1.DailyFileTransport(logDirectory)],
+            levels: WIN_LEVELS,
         });
-        // Add colors for console logging
-        winston_1.default.addColors({
-            database: "green",
-            error: "red",
-            warning: "yellow",
-            info: "blue",
-            debug: "magenta",
-            log: "cyan",
-        });
-    }
-    replaceAll(string, match, replacer) {
-        return string.split(match).join(replacer);
+        Logger.sharedLoggers.set(logDirectory, logger);
+        return logger;
     }
     execStart(prefix = "") {
         this.print(LogLevels.INFO, `${prefix} - Execution started`);
@@ -98,44 +170,49 @@ class Logger {
         this.print(LogLevels.ERROR, ...data);
     }
     print(level, ...data) {
+        var _a;
+        const rank = level === LogLevels.LOG ? WIN_LEVELS.general : ((_a = WIN_LEVELS[level.toLowerCase()]) !== null && _a !== void 0 ? _a : WIN_LEVELS.database);
+        if (rank > this.maxLevel) {
+            return;
+        }
         const now = new Date();
         const fileName = this.tag.split("\\").pop() || this.tag;
-        // Attach metadata to Winston logger
-        this.winstonLogger.defaultMeta = {
-            file: fileName,
-            time: now,
-        };
-        const logEntry = {
-            level: level === LogLevels.LOG ? 'general' : level.toLowerCase(),
-            message: [...data].join(","),
-        };
-        // Log to console with colors
+        const message = stringifyLogData(data);
+        // Console colorata (il livello file resta strutturato).
         switch (level) {
             case LogLevels.INFO:
-                console.info((0, colorette_1.blue)(`[INFO][${now}][${fileName}]`), logEntry.message);
+                console.info((0, colorette_1.blue)(`[INFO][${now}][${fileName}]`), message);
                 break;
             case LogLevels.ERROR:
-                console.error((0, colorette_1.red)(`[ERROR][${now}][${fileName}]`), logEntry.message);
+                console.error((0, colorette_1.red)(`[ERROR][${now}][${fileName}]`), message);
                 break;
             case LogLevels.DEBUG:
-                console.debug((0, colorette_1.magenta)(`[DEBUG][${now}][${fileName}]`), logEntry.message);
+                console.debug((0, colorette_1.magenta)(`[DEBUG][${now}][${fileName}]`), message);
                 break;
             case LogLevels.WARNING:
-                console.debug((0, colorette_1.yellow)(`[WARNING][${now}][${fileName}]`), logEntry.message);
+                console.debug((0, colorette_1.yellow)(`[WARNING][${now}][${fileName}]`), message);
                 break;
             case LogLevels.LOG:
-                console.log((0, colorette_1.cyan)(`[LOG][${now}][${fileName}]`), logEntry.message);
+                console.log((0, colorette_1.cyan)(`[LOG][${now}][${fileName}]`), message);
                 break;
             case LogLevels.DATABASE:
-                console.log((0, colorette_1.green)(`[DATABASE][${now}][${fileName}]`), logEntry.message);
+                console.log((0, colorette_1.green)(`[DATABASE][${now}][${fileName}]`), message);
                 break;
         }
-        // Log to file
-        this.winstonLogger.log(logEntry);
+        this.winstonLogger.log({
+            level: level === LogLevels.LOG ? 'general' : level.toLowerCase(),
+            message,
+            tag: this.tag,
+            file: fileName,
+            time: now,
+        });
     }
     static createLogger(tag, config) {
         return new Logger(tag, config);
     }
 }
 exports.Logger = Logger;
+/** Logger winston condivisi per directory, così da non moltiplicare transport e timer. */
+Logger.sharedLoggers = new Map();
+Logger.colorsRegistered = false;
 //# sourceMappingURL=Logger.js.map

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 { 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\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: level === 'general' ? 'log' : level,\n                    message,\n                    ...meta,\n                });\n            });\n\n        // Configure logger\n        this.winstonLogger = winston.createLogger({\n            level: 'database',\n            format: winston.format.combine(winston.format.timestamp(), this.logFormat),\n            transports: config?.transports || [\n                new DailyFileTransport(this.logDirectory),\n            ],\n            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\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 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        };\n\n        const logEntry: winston.LogEntry = {\n            level: level === LogLevels.LOG ? 'general' : 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>;
 }