emilsoftware-utilities 2.0.0-dev.3 → 2.0.0-dev.31

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

package/dist/RoutesLoggerMiddleware.js.map

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

package/dist/Utilities.d.ts

@@ -50,9 +50,10 @@ export declare class RestUtilities {
      * Sends an OK message as a response.
      * @param res - Express Response object.
      * @param message - The success message.
+     * @param status - HTTP success status. Defaults to 200; pass 201 only after creating a resource.
      * @returns The Response object.
      */
-    static sendOKMessage(res: Response, message: string): Response;
+    static sendOKMessage(res: Response, message: string, status?: number): Response;
     /**
      * Sends an error message as a response.
      * @param res - Express Response object.
@@ -61,7 +62,9 @@ export declare class RestUtilities {
      * @param status - HTTP status code (default: 500).
      * @returns The Response object.
      */
-    static sendErrorMessage(res: Response, error: any, tag?: string, status?: number): Response;
+    static sendErrorMessage(res: Response, error: unknown, _tag?: string, status?: number): Response;
+    /** Riconosce errori di metadata Firebird che richiedono una migrazione. */
+    static isDatabaseSchemaError(error: unknown): boolean;
     static sendUnauthorized(res: Response): Response;
     static sendInvalidCredentials(res: Response): Response;
     static sendPasswordExpired(res: Response): Response;
@@ -69,27 +72,32 @@ export declare class RestUtilities {
      * Sends a base response with a payload.
      * @param res - Express Response object.
      * @param payload - The payload to include in the response.
+     * @param status - HTTP success status. Defaults to 200; pass 201 only after creating a resource.
      * @returns The Response object.
      */
-    static sendBaseResponse(res: Response, payload: any): Response;
+    static sendBaseResponse(res: Response, payload: unknown, 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;

package/dist/Utilities.js

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DatabaseUtilities = exports.PasswordUtilities = exports.CryptUtilities = exports.RestUtilities = exports.DateUtilities = exports.StatusCode = void 0;
 exports.Deprecated = Deprecated;
+const Logger_1 = require("./Logger");
 const crypto_1 = __importDefault(require("crypto"));
 var StatusCode;
 (function (StatusCode) {
@@ -97,12 +98,13 @@ 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, message) {
-        return res.send({
+    static sendOKMessage(res, message, status = 200) {
+        return res.status(status).send({
             severity: "success",
-            status: 200,
+            status,
             statusCode: StatusCode.Ok,
             message,
         });
@@ -115,34 +117,87 @@ class RestUtilities {
      * @param status - HTTP status code (default: 500).
      * @returns The Response object.
      */
-    static sendErrorMessage(res, error, tag = "[BASE ERROR]", status = 500) {
-        return res.status(status).send({
-            severity: "error",
-            status,
-            statusCode: StatusCode.Error,
-            message: "An error occurred",
-            error: `${tag}: ${error}`,
-        });
+    static sendErrorMessage(res, error, _tag = "[BASE ERROR]", status = 500) {
+        var _a, _b;
+        const rawMessage = error instanceof Error ? error.message : String(error !== null && error !== void 0 ? error : "");
+        const errorWithResponse = error;
+        const exceptionResponse = typeof (errorWithResponse === null || errorWithResponse === void 0 ? void 0 : errorWithResponse.getResponse) === "function"
+            ? errorWithResponse.getResponse()
+            : undefined;
+        const exceptionPayload = exceptionResponse && typeof exceptionResponse === "object"
+            ? exceptionResponse
+            : undefined;
+        const explicitCode = typeof (exceptionPayload === null || exceptionPayload === void 0 ? void 0 : exceptionPayload.code) === "string" ? exceptionPayload.code : undefined;
+        const explicitMessage = typeof (exceptionPayload === null || exceptionPayload === void 0 ? void 0 : exceptionPayload.message) === "string" ? exceptionPayload.message : undefined;
+        const explicitDetails = Array.isArray(exceptionPayload === null || exceptionPayload === void 0 ? void 0 : exceptionPayload.details)
+            ? exceptionPayload.details.filter((detail) => typeof detail === "string")
+            : undefined;
+        const schemaError = this.isDatabaseSchemaError(error);
+        // Per le HttpException lo status corretto e quello dell'eccezione (es. 400 di validazione),
+        // anche quando il chiamante non lo passa esplicitamente. Lo status esplicito vale per gli altri errori.
+        const exceptionStatus = typeof (errorWithResponse === null || errorWithResponse === void 0 ? void 0 : errorWithResponse.getResponse) === "function"
+            ? Number((_b = (_a = error).getStatus) === null || _b === void 0 ? void 0 : _b.call(_a))
+            : undefined;
+        const effectiveStatus = schemaError
+            ? 503
+            : Number.isInteger(exceptionStatus) && exceptionStatus >= 400
+                ? exceptionStatus
+                : status;
+        const code = schemaError
+            ? "ACCESSI_DATABASE_SCHEMA_OUTDATED"
+            : explicitCode !== null && explicitCode !== void 0 ? explicitCode : (effectiveStatus >= 500
+                ? "ACCESSI_INTERNAL_ERROR"
+                : effectiveStatus === 401
+                    ? "ACCESSI_UNAUTHORIZED"
+                    : effectiveStatus === 403
+                        ? "ACCESSI_FORBIDDEN"
+                        : "ACCESSI_REQUEST_ERROR");
+        const message = schemaError
+            ? "Lo schema del database Accessi non e aggiornato. Eseguire la migrazione database e riprovare."
+            : explicitMessage !== null && explicitMessage !== void 0 ? explicitMessage : (effectiveStatus >= 500
+                ? "Errore interno del modulo Accessi."
+                : effectiveStatus === 401
+                    ? "Autenticazione non valida o scaduta."
+                    : effectiveStatus === 403
+                        ? "Operazione non autorizzata."
+                        : rawMessage || "Richiesta non valida.");
+        return res.status(effectiveStatus).send(Object.assign({ severity: "error", status: effectiveStatus, statusCode: StatusCode.Error, code,
+            message, 
+            // Compatibilita: il campo storico resta presente, ma non espone SQL, stack o dati sensibili.
+            error: code }, ((explicitDetails === null || explicitDetails === void 0 ? void 0 : explicitDetails.length) ? { details: explicitDetails } : {})));
+    }
+    /** Riconosce errori di metadata Firebird che richiedono una migrazione. */
+    static isDatabaseSchemaError(error) {
+        const message = error instanceof Error ? error.message : String(error !== null && error !== void 0 ? error : "");
+        return /column unknown|table unknown|dynamic sql error|unsuccessful metadata update|invalid request blr/i.test(message);
     }
     static sendUnauthorized(res) {
         return res.status(401).send({
             severity: "error",
+            status: 401,
             statusCode: StatusCode.Error,
-            message: "Non sei autorizzato",
+            code: "ACCESSI_UNAUTHORIZED",
+            error: "ACCESSI_UNAUTHORIZED",
+            message: "Autenticazione non valida o scaduta.",
         });
     }
     static sendInvalidCredentials(res) {
         return res.status(401).send({
             severity: "error",
+            status: 401,
             statusCode: StatusCode.Error,
-            message: "Credenziali non valide"
+            code: "ACCESSI_INVALID_CREDENTIALS",
+            error: "ACCESSI_INVALID_CREDENTIALS",
+            message: "Credenziali non valide",
         });
     }
     static sendPasswordExpired(res) {
         return res.status(403).send({
             severity: "warning",
+            status: 403,
             statusCode: StatusCode.Warning,
             code: "PASSWORD_EXPIRED",
+            error: "PASSWORD_EXPIRED",
             message: "Password scaduta. E' necessario aggiornarla"
         });
     }
@@ -150,9 +205,10 @@ 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, payload) {
+    static sendBaseResponse(res, payload, status = 200) {
         try {
             payload = JSON.parse(JSON.stringify(payload));
             const response = {
@@ -163,7 +219,7 @@ class RestUtilities {
                 Result: payload,
                 Message: "Dati recuperati con successo.",
             };
-            return res.send(response);
+            return res.status(status).send(response);
         }
         catch (error) {
             return this.sendErrorMessage(res, `Error sending response: ${error}`, "[UTILITIES]", 500);
@@ -174,9 +230,10 @@ class RestUtilities {
      * @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, executionObject, title) {
+    static sendExecMessage(res, executionObject, title, status = 200) {
         try {
             const response = {
                 Status: {
@@ -188,36 +245,39 @@ class RestUtilities {
                 data: executionObject,
                 Title: title,
             };
-            return res.send(response);
+            return res.status(status).send(response);
         }
         catch (error) {
             return this.sendErrorMessage(res, `Error sending execution message: ${error}`, title, 500);
         }
     }
     /**
-     * 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 = "", params) {
-        try {
-            params.forEach(param => {
-                query = query.replace("?", param);
-            });
-            return query;
-        }
-        catch (error) {
-            throw error;
-        }
+    static printQueryWithParams(query = "", params = []) {
+        let index = 0;
+        return query.replace(/\?/g, () => {
+            if (index >= params.length) {
+                return "?";
+            }
+            const param = params[index++];
+            return param === undefined || param === null ? "NULL" : String(param);
+        });
     }
     static convertKeysToCamelCase(obj) {
-        if (obj !== null && obj.constructor === Object) {
-            return Object.keys(obj).reduce((acc, key) => {
-                const camelCaseKey = key.toLowerCase().replace(/_([a-z])/g, g => g[1].toUpperCase());
-                acc[camelCaseKey] = obj[key];
+        if (obj !== null && typeof obj === "object" && obj.constructor === Object) {
+            const source = obj;
+            const converted = Object.keys(source).reduce((acc, key) => {
+                const camelCaseKey = key.toLowerCase().replace(/_([a-z])/g, g => { var _a; return ((_a = g[1]) !== null && _a !== void 0 ? _a : '').toUpperCase(); });
+                acc[camelCaseKey] = source[key];
                 return acc;
             }, {});
+            return converted;
         }
         return obj;
     }
@@ -247,7 +307,8 @@ class CryptUtilities {
         }
         catch (error) {
             // Gestisce eventuali errori di cifratura
-            throw new Error(`Errore durante la cifratura: ${error.message}`);
+            const message = error instanceof Error ? error.message : String(error);
+            throw new Error(`Errore durante la cifratura: ${message}`);
         }
     }
     /**
@@ -271,12 +332,13 @@ class CryptUtilities {
             return decoded;
         }
         catch (error) {
-            console.error("Errore durante la decifratura:", error);
+            CryptUtilities.logger.error("Errore durante la decifratura:", error);
             return null;
         }
     }
 }
 exports.CryptUtilities = CryptUtilities;
+CryptUtilities.logger = new Logger_1.Logger(CryptUtilities.name);
 class PasswordUtilities {
     static hashSecret(secretValue, prefix) {
         if (typeof secretValue !== "string" || secretValue.length === 0) {
@@ -352,6 +414,20 @@ class PasswordUtilities {
     static isLegacyPasswordHash(value) {
         return this.hasPrefix(value, this.LEGACY_HASH_PREFIX);
     }
+    /** Confronto a tempo costante tra due stringhe (per dati legacy non hashati). */
+    static timingSafeStringEquals(value, candidate) {
+        if (typeof value !== "string" || typeof candidate !== "string") {
+            return false;
+        }
+        const valueBuffer = Buffer.from(value, "utf8");
+        const candidateBuffer = Buffer.from(candidate, "utf8");
+        if (valueBuffer.length !== candidateBuffer.length) {
+            // Confronta comunque per non rivelare la lunghezza tramite timing.
+            crypto_1.default.timingSafeEqual(valueBuffer, valueBuffer);
+            return false;
+        }
+        return crypto_1.default.timingSafeEqual(valueBuffer, candidateBuffer);
+    }
     static verifyPassword(plainPassword, storedPassword) {
         return this.verifySecret(plainPassword, storedPassword, this.HASH_PREFIX);
     }
@@ -403,17 +479,20 @@ class DatabaseUtilities {
             pageSize: 100000, // The page size for database transactions. Default: 100,000.
             retryConnectionInterval: 1000, // The interval (in ms) to retry a failed connection. Default: 1,000 ms.
             blobAsText: true, // Determines if BLOB fields should be treated as text. Default: true.
-            wireCrypt: 'enabled',
-            pluginName: 'Srp',
-            authPlugins: ['Srp256', 'Srp', 'Legacy_Auth'],
+            connectTimeout: 15000,
             connectTimeoutMs: 15000,
+            trimStringResults: true,
         };
     }
 }
 exports.DatabaseUtilities = DatabaseUtilities;
+const deprecationLogger = new Logger_1.Logger('Deprecated');
 function Deprecated(message) {
     return function (target, key, descriptor) {
-        console.warn(`[DEPRECATED] ${message}`);
+        void target;
+        void key;
+        void descriptor;
+        deprecationLogger.warning(`[DEPRECATED] ${message}`);
     };
 }
 //# sourceMappingURL=Utilities.js.map