emilsoftware-utilities 2.0.0-dev.4 → 2.0.0-dev.41

package/dist/allegati-module/security/allegatiAuthorizationGuard.js

@@ -0,0 +1,70 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AllegatiAuthorizationGuard = void 0;
+const common_1 = require("@nestjs/common");
+/**
+ * Guard opt-in per i controller Allegati.
+ *
+ * Senza `authorize` configurato nelle `AllegatiOptions` il guard e un no-op, cosi da
+ * preservare la retrocompatibilita. Quando configurato, delega la decisione
+ * all'applicazione host (tipicamente il controllo di autenticazione/ownership).
+ */
+let AllegatiAuthorizationGuard = class AllegatiAuthorizationGuard {
+    constructor(options) {
+        this.options = options;
+    }
+    canActivate(context) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            // Opt-out esplicito: ripristina il comportamento storico (endpoint aperti).
+            if (((_a = this.options) === null || _a === void 0 ? void 0 : _a.requireAuthorization) === false) {
+                return true;
+            }
+            const authorize = (_b = this.options) === null || _b === void 0 ? void 0 : _b.authorize;
+            if (!authorize) {
+                // Secure by default: senza un controllo configurato l'accesso e negato.
+                throw new common_1.ForbiddenException({
+                    code: 'ALLEGATI_AUTHORIZATION_NOT_CONFIGURED',
+                    message: 'Allegati: nessun controllo di autorizzazione configurato. Definire allegatiOptions.authorize oppure impostare requireAuthorization: false per il comportamento storico.',
+                });
+            }
+            const request = context.switchToHttp().getRequest();
+            const allowed = yield authorize(request);
+            if (!allowed) {
+                throw new common_1.ForbiddenException({
+                    code: 'ALLEGATI_FORBIDDEN',
+                    message: 'Operazione non autorizzata.',
+                });
+            }
+            return true;
+        });
+    }
+};
+exports.AllegatiAuthorizationGuard = AllegatiAuthorizationGuard;
+exports.AllegatiAuthorizationGuard = AllegatiAuthorizationGuard = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)('ALLEGATI_OPTIONS')),
+    __metadata("design:paramtypes", [Object])
+], AllegatiAuthorizationGuard);
+//# sourceMappingURL=allegatiAuthorizationGuard.js.map

package/dist/allegati-module/security/allegatiAuthorizationGuard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"allegatiAuthorizationGuard.js","sourceRoot":"","sources":["../../../src/allegati-module/security/allegatiAuthorizationGuard.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAAA,2CAAuG;AAIvG;;;;;;GAMG;AAEI,IAAM,0BAA0B,GAAhC,MAAM,0BAA0B;IACnC,YAAyD,OAAwB;QAAxB,YAAO,GAAP,OAAO,CAAiB;IAAG,CAAC;IAE/E,WAAW,CAAC,OAAyB;;;YACvC,4EAA4E;YAC5E,IAAI,CAAA,MAAA,IAAI,CAAC,OAAO,0CAAE,oBAAoB,MAAK,KAAK,EAAE,CAAC;gBAC/C,OAAO,IAAI,CAAC;YAChB,CAAC;YAED,MAAM,SAAS,GAAG,MAAA,IAAI,CAAC,OAAO,0CAAE,SAAS,CAAC;YAC1C,IAAI,CAAC,SAAS,EAAE,CAAC;gBACb,wEAAwE;gBACxE,MAAM,IAAI,2BAAkB,CAAC;oBACzB,IAAI,EAAE,uCAAuC;oBAC7C,OAAO,EAAE,yKAAyK;iBACrL,CAAC,CAAC;YACP,CAAC;YAED,MAAM,OAAO,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,UAAU,EAAW,CAAC;YAC7D,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;YACzC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACX,MAAM,IAAI,2BAAkB,CAAC;oBACzB,IAAI,EAAE,oBAAoB;oBAC1B,OAAO,EAAE,6BAA6B;iBACzC,CAAC,CAAC;YACP,CAAC;YAED,OAAO,IAAI,CAAC;QAChB,CAAC;KAAA;CACJ,CAAA;AA7BY,gEAA0B;qCAA1B,0BAA0B;IADtC,IAAA,mBAAU,GAAE;IAEI,WAAA,IAAA,eAAM,EAAC,kBAAkB,CAAC,CAAA;;GAD9B,0BAA0B,CA6BtC","sourcesContent":["import { CanActivate, ExecutionContext, ForbiddenException, Inject, Injectable } from \"@nestjs/common\";\nimport type { Request } from \"express\";\nimport type { AllegatiOptions } from \"../AllegatiModule\";\n\n/**\n * Guard opt-in per i controller Allegati.\n *\n * Senza `authorize` configurato nelle `AllegatiOptions` il guard e un no-op, cosi da\n * preservare la retrocompatibilita. Quando configurato, delega la decisione\n * all'applicazione host (tipicamente il controllo di autenticazione/ownership).\n */\n@Injectable()\nexport class AllegatiAuthorizationGuard implements CanActivate {\n    constructor(@Inject('ALLEGATI_OPTIONS') private readonly options: AllegatiOptions) {}\n\n    async canActivate(context: ExecutionContext): Promise<boolean> {\n        // Opt-out esplicito: ripristina il comportamento storico (endpoint aperti).\n        if (this.options?.requireAuthorization === false) {\n            return true;\n        }\n\n        const authorize = this.options?.authorize;\n        if (!authorize) {\n            // Secure by default: senza un controllo configurato l'accesso e negato.\n            throw new ForbiddenException({\n                code: 'ALLEGATI_AUTHORIZATION_NOT_CONFIGURED',\n                message: 'Allegati: nessun controllo di autorizzazione configurato. Definire allegatiOptions.authorize oppure impostare requireAuthorization: false per il comportamento storico.',\n            });\n        }\n\n        const request = context.switchToHttp().getRequest<Request>();\n        const allowed = await authorize(request);\n        if (!allowed) {\n            throw new ForbiddenException({\n                code: 'ALLEGATI_FORBIDDEN',\n                message: 'Operazione non autorizzata.',\n            });\n        }\n\n        return true;\n    }\n}\n"]}

package/dist/autobind.d.ts

@@ -1,3 +1,10 @@
-export declare function autobind<T extends {
-    new (...args: any[]): any;
-}>(constructor: T): T;
+type AutobindConstructor = new (...args: never[]) => object;
+/**
+ * Class decorator that binds every prototype method to the instance.
+ *
+ * Uses `Reflect.construct` instead of a class-expression mixin because
+ * TypeScript requires mixin constructors to use `any[]`, which this codebase
+ * avoids.
+ */
+export declare function autobind<T extends AutobindConstructor>(constructor: T): T;
+export {};

package/dist/autobind.js

@@ -1,17 +1,32 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.autobind = autobind;
+/**
+ * Class decorator that binds every prototype method to the instance.
+ *
+ * Uses `Reflect.construct` instead of a class-expression mixin because
+ * TypeScript requires mixin constructors to use `any[]`, which this codebase
+ * avoids.
+ */
 function autobind(constructor) {
-    return class extends constructor {
-        constructor(...args) {
-            super(...args);
-            Object.getOwnPropertyNames(constructor.prototype).forEach(key => {
-                const descriptor = Object.getOwnPropertyDescriptor(constructor.prototype, key);
-                if (descriptor && typeof descriptor.value === 'function' && key !== 'constructor') {
-                    this[key] = this[key].bind(this);
+    const boundConstructor = function (...args) {
+        const instance = Reflect.construct(constructor, args);
+        Object.getOwnPropertyNames(constructor.prototype).forEach(key => {
+            const descriptor = Object.getOwnPropertyDescriptor(constructor.prototype, key);
+            if (descriptor && typeof descriptor.value === 'function' && key !== 'constructor') {
+                const method = instance[key];
+                if (typeof method === 'function') {
+                    instance[key] = method.bind(instance);
                 }
-            });
-        }
+            }
+        });
+        return instance;
     };
+    // Mirror `class extends`: the constructor's prototype chain must point at the
+    // original class so reflect-metadata (design:paramtypes) stays reachable and
+    // NestJS dependency injection keeps working.
+    Object.setPrototypeOf(boundConstructor, constructor);
+    boundConstructor.prototype = constructor.prototype;
+    return boundConstructor;
 }
 //# sourceMappingURL=autobind.js.map

package/dist/autobind.js.map

@@ -1 +1 @@
-{"version":3,"file":"autobind.js","sourceRoot":"","sources":["../src/autobind.ts"],"names":[],"mappings":";;AAAA,4BAYC;AAZD,SAAgB,QAAQ,CAA0C,WAAc;IAC5E,OAAO,KAAM,SAAQ,WAAW;QAC5B,YAAY,GAAG,IAAW;YACtB,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;YACf,MAAM,CAAC,mBAAmB,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;gBAC5D,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,WAAW,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;gBAC/E,IAAI,UAAU,IAAI,OAAO,UAAU,CAAC,KAAK,KAAK,UAAU,IAAI,GAAG,KAAK,aAAa,EAAE,CAAC;oBAChF,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACrC,CAAC;YACL,CAAC,CAAC,CAAC;QACP,CAAC;KACJ,CAAC;AACN,CAAC","sourcesContent":["export function autobind<T extends { new (...args: any[]): any }>(constructor: T): T {\r\n    return class extends constructor {\r\n        constructor(...args: any[]) {\r\n            super(...args);\r\n            Object.getOwnPropertyNames(constructor.prototype).forEach(key => {\r\n                const descriptor = Object.getOwnPropertyDescriptor(constructor.prototype, key);\r\n                if (descriptor && typeof descriptor.value === 'function' && key !== 'constructor') {\r\n                    this[key] = this[key].bind(this);\r\n                }\r\n            });\r\n        }\r\n    };\r\n}\r\n"]}
+{"version":3,"file":"autobind.js","sourceRoot":"","sources":["../src/autobind.ts"],"names":[],"mappings":";;AASA,4BAuBC;AA9BD;;;;;;GAMG;AACH,SAAgB,QAAQ,CAAgC,WAAc;IAClE,MAAM,gBAAgB,GAAG,UAAyB,GAAG,IAAe;QAChE,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,CAA4B,CAAC;QAEjF,MAAM,CAAC,mBAAmB,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;YAC5D,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,WAAW,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;YAC/E,IAAI,UAAU,IAAI,OAAO,UAAU,CAAC,KAAK,KAAK,UAAU,IAAI,GAAG,KAAK,aAAa,EAAE,CAAC;gBAChF,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;gBAC7B,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;oBAC/B,QAAQ,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC1C,CAAC;YACL,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,OAAO,QAAQ,CAAC;IACpB,CAAC,CAAC;IAEF,8EAA8E;IAC9E,6EAA6E;IAC7E,6CAA6C;IAC7C,MAAM,CAAC,cAAc,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAC;IACrD,gBAAgB,CAAC,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC;IACnD,OAAO,gBAAgC,CAAC;AAC5C,CAAC","sourcesContent":["type AutobindConstructor = new (...args: never[]) => object;\n\n/**\n * Class decorator that binds every prototype method to the instance.\n *\n * Uses `Reflect.construct` instead of a class-expression mixin because\n * TypeScript requires mixin constructors to use `any[]`, which this codebase\n * avoids.\n */\nexport function autobind<T extends AutobindConstructor>(constructor: T): T {\n    const boundConstructor = function (this: unknown, ...args: unknown[]): object {\n        const instance = Reflect.construct(constructor, args) as Record<string, unknown>;\n\n        Object.getOwnPropertyNames(constructor.prototype).forEach(key => {\n            const descriptor = Object.getOwnPropertyDescriptor(constructor.prototype, key);\n            if (descriptor && typeof descriptor.value === 'function' && key !== 'constructor') {\n                const method = instance[key];\n                if (typeof method === 'function') {\n                    instance[key] = method.bind(instance);\n                }\n            }\n        });\n\n        return instance;\n    };\n\n    // Mirror `class extends`: the constructor's prototype chain must point at the\n    // original class so reflect-metadata (design:paramtypes) stays reachable and\n    // NestJS dependency injection keeps working.\n    Object.setPrototypeOf(boundConstructor, constructor);\n    boundConstructor.prototype = constructor.prototype;\n    return boundConstructor as unknown as T;\n}\n"]}

package/dist/firebird-compat.d.ts

@@ -1,17 +1,38 @@
-import { Options } from "es-node-firebird";
+import type { Options } from "node-firebird";
 export type FirebirdWireCryptMode = "disabled" | "enabled" | "required";
-export type FirebirdAuthPlugin = "Legacy_Auth" | "Srp" | "Srp256";
+export type FirebirdAuthPlugin = "Legacy_Auth" | "Srp" | "Srp256" | "Srp384" | "Srp512";
+export type FirebirdDriverStrategy = "modern";
 export type FirebirdOptions = Options & {
-    wireCrypt?: FirebirdWireCryptMode;
+    wireCrypt?: FirebirdWireCryptMode | number;
     pluginName?: FirebirdAuthPlugin;
     authPlugins?: FirebirdAuthPlugin[];
     connectTimeoutMs?: number;
-    connectTimeout?: number;
     compatibilityProbeTimeoutMs?: number;
     compatibilityTotalTimeoutMs?: number;
+    firebirdDriver?: FirebirdDriverStrategy;
+    trimStringResults?: boolean;
+    /**
+     * When `true`, query parameters are interpolated into the logged SQL. Off by
+     * default so that secrets, credentials and personal data are not written to
+     * the console or to the daily log files.
+     */
+    logQueryParameters?: boolean;
+    /**
+     * When greater than zero, enables an opt-in connection pool of the given
+     * maximum size for this connection target instead of attaching/detaching a
+     * physical connection for every query. Default `0` keeps the historic
+     * one-connection-per-query behaviour.
+     */
+    poolSize?: number;
+};
+type FirebirdErrorContext = {
+    stage: "attach" | "query" | "execute" | "transaction";
+    sql?: string;
 };
 export declare function normalizeFirebirdOptions(options: Options): FirebirdOptions;
-export declare function buildFirebirdCompatibilityCandidates(options: Options): FirebirdOptions[];
-export declare function shouldRetryFirebirdCompatibility(error: unknown): boolean;
 export declare function describeFirebirdCompatibilityOptions(options: Options): string;
+export declare function enhanceFirebirdError(error: unknown, options: Options, context: FirebirdErrorContext): Error;
+export declare function buildFirebirdCompatibilityCandidates(options: Options): FirebirdOptions[];
+export declare function shouldRetryFirebirdCompatibility(): boolean;
 export declare function ensureEsNodeFirebirdCompatibilityPatch(): void;
+export {};

package/dist/firebird-compat.js

@@ -32,173 +32,188 @@ var __importStar = (this && this.__importStar) || (function () {
         return result;
     };
 })();
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.normalizeFirebirdOptions = normalizeFirebirdOptions;
+exports.describeFirebirdCompatibilityOptions = describeFirebirdCompatibilityOptions;
+exports.enhanceFirebirdError = enhanceFirebirdError;
 exports.buildFirebirdCompatibilityCandidates = buildFirebirdCompatibilityCandidates;
 exports.shouldRetryFirebirdCompatibility = shouldRetryFirebirdCompatibility;
-exports.describeFirebirdCompatibilityOptions = describeFirebirdCompatibilityOptions;
 exports.ensureEsNodeFirebirdCompatibilityPatch = ensureEsNodeFirebirdCompatibilityPatch;
-const Firebird = __importStar(require("es-node-firebird"));
-const CNCT_PLUGIN_NAME = 8;
-const CNCT_PLUGIN_LIST = 10;
-const CNCT_CLIENT_CRYPT = 11;
-const WIRE_CRYPT_DISABLE = 0;
-const WIRE_CRYPT_ENABLE = 1;
-const WIRE_CRYPT_REQUIRED = 2;
-const DEFAULT_AUTH_PLUGIN_LIST = ["Srp256", "Srp", "Legacy_Auth"];
+const Firebird = __importStar(require("node-firebird"));
+function isBlank(value) {
+    return value === undefined || value === null || (typeof value === "string" && value.trim() === "");
+}
 function normalizeWireCryptMode(value) {
-    const normalized = String(value !== null && value !== void 0 ? value : "").trim().toLowerCase();
-    if (normalized === "required") {
-        return "required";
+    if (isBlank(value)) {
+        return undefined;
     }
+    if (typeof value === "number") {
+        return value;
+    }
+    const normalized = String(value).trim().toLowerCase();
     if (normalized === "disabled") {
-        return "disabled";
+        return Firebird.WIRE_CRYPT_DISABLE;
     }
-    return "enabled";
+    return Firebird.WIRE_CRYPT_ENABLE;
 }
 function normalizeAuthPlugin(value) {
-    const normalized = String(value !== null && value !== void 0 ? value : "").trim().toLowerCase();
-    if (normalized === "legacy_auth" || normalized === "legacy") {
+    if (isBlank(value)) {
+        return undefined;
+    }
+    const normalized = String(value).trim().toLowerCase();
+    if (normalized === "legacy" || normalized === "legacy_auth") {
         return "Legacy_Auth";
     }
     if (normalized === "srp256") {
         return "Srp256";
     }
+    if (normalized === "srp384") {
+        return "Srp384";
+    }
+    if (normalized === "srp512") {
+        return "Srp512";
+    }
     return "Srp";
 }
-function toWireCryptFlag(mode) {
-    switch (mode) {
-        case "required":
-            return WIRE_CRYPT_REQUIRED;
-        case "disabled":
-            return WIRE_CRYPT_DISABLE;
-        default:
-            return WIRE_CRYPT_ENABLE;
+function formatWireCryptValue(value) {
+    if (isBlank(value)) {
+        return "auto";
+    }
+    if (typeof value === "number") {
+        if (value === Firebird.WIRE_CRYPT_DISABLE) {
+            return "disabled";
+        }
+        if (value === Firebird.WIRE_CRYPT_ENABLE) {
+            return "enabled";
+        }
+        return String(value);
     }
+    return String(value);
 }
-function normalizeAuthPluginList(value) {
-    if (!Array.isArray(value) || value.length === 0) {
-        return [...DEFAULT_AUTH_PLUGIN_LIST];
-    }
-    const normalized = value
-        .map((entry) => normalizeAuthPlugin(entry))
-        .filter((entry, index, source) => source.indexOf(entry) === index);
-    return normalized.length > 0 ? normalized : [...DEFAULT_AUTH_PLUGIN_LIST];
+function formatTarget(options) {
+    var _a, _b, _c;
+    return `${(_a = options.host) !== null && _a !== void 0 ? _a : "?"}:${(_b = options.port) !== null && _b !== void 0 ? _b : "?"} -> ${(_c = options.database) !== null && _c !== void 0 ? _c : "?"}`;
 }
-function normalizeFirebirdOptions(options) {
-    const compatibilityOptions = options;
-    return Object.assign(Object.assign({}, options), { wireCrypt: normalizeWireCryptMode(compatibilityOptions.wireCrypt), pluginName: normalizeAuthPlugin(compatibilityOptions.pluginName), authPlugins: normalizeAuthPluginList(compatibilityOptions.authPlugins) });
+function uniqueDiagnostics(values) {
+    return values.filter((value, index) => values.indexOf(value) === index);
 }
-function isRetryableCompatibilityError(error) {
-    var _a, _b;
-    const message = String((_b = (_a = error === null || error === void 0 ? void 0 : error.message) !== null && _a !== void 0 ? _a : error) !== null && _b !== void 0 ? _b : "").toLowerCase();
-    return message.includes("incompatible wire encryption")
-        || message.includes("no matching plugins on server")
-        || message.includes("unknown auth plugin")
-        || message.includes("unknow auth plugin")
-        || message.includes("timeout during firebird attach");
-}
-function pushUniqueCandidate(target, candidate) {
+function buildDiagnostics(message, options) {
     var _a;
-    const normalized = normalizeFirebirdOptions(candidate);
-    const key = `${normalized.pluginName}|${normalized.wireCrypt}|${((_a = normalized.authPlugins) !== null && _a !== void 0 ? _a : []).join(",")}`;
-    const alreadyPresent = target.some((entry) => {
-        var _a;
-        const normalizedEntry = normalizeFirebirdOptions(entry);
-        return `${normalizedEntry.pluginName}|${normalizedEntry.wireCrypt}|${((_a = normalizedEntry.authPlugins) !== null && _a !== void 0 ? _a : []).join(",")}` === key;
-    });
-    if (!alreadyPresent) {
-        target.push(normalized);
+    const diagnostics = [];
+    const pluginMismatch = message.match(/Server don't accept plugin\s*:\s*([^,]+),\s*but support\s*:\s*(.+)$/i);
+    if (pluginMismatch) {
+        const supportedPlugins = ((_a = pluginMismatch[2]) !== null && _a !== void 0 ? _a : "")
+            .split(",")
+            .map((plugin) => plugin.trim())
+            .filter((plugin) => plugin.length > 0);
+        const supportedMessage = supportedPlugins.length === 1
+            ? `The server explicitly reported that only the "${supportedPlugins[0]}" authentication plugin is supported.`
+            : `The server explicitly reported the supported authentication plugins: ${supportedPlugins.join(", ")}.`;
+        diagnostics.push(supportedMessage);
+    }
+    if (/Incompatible wire encryption levels requested on client and server/i.test(message)) {
+        diagnostics.push("The server rejected the requested wire encryption mode. Keep wire encryption auto-enabled unless the server is known to allow disabled encryption.");
+    }
+    if (/No matching plugins on server/i.test(message)) {
+        diagnostics.push("The server did not find a common authentication plugin with the client configuration.");
+    }
+    if (/Connection timeout after \d+ms/i.test(message) || /Timeout during Firebird attach after \d+ ms/i.test(message)) {
+        diagnostics.push("The TCP connection was accepted but the Firebird wire-protocol attach did not complete in time.");
     }
+    if (options.pluginName) {
+        diagnostics.push(`Client authentication plugin was forced to "${options.pluginName}". Leave pluginName empty to let the driver auto-negotiate when possible.`);
+    }
+    if (!isBlank(options.wireCrypt)) {
+        diagnostics.push(`Client wire encryption was forced to "${formatWireCryptValue(options.wireCrypt)}".`);
+    }
+    return uniqueDiagnostics(diagnostics);
 }
-function appendPluginCandidates(target, base, pluginName, wireCryptModes) {
-    wireCryptModes.forEach((wireCrypt) => {
-        pushUniqueCandidate(target, Object.assign(Object.assign({}, base), { pluginName, wireCrypt }));
-    });
+function copyFirebirdMetadata(target, source) {
+    if (!source || typeof source !== "object") {
+        return;
+    }
+    const firebirdSource = source;
+    if ("gdscode" in firebirdSource) {
+        target.gdscode = firebirdSource.gdscode;
+    }
+    if ("gdsparams" in firebirdSource) {
+        target.gdsparams = firebirdSource.gdsparams;
+    }
 }
-function buildFirebirdCompatibilityCandidates(options) {
-    const normalized = normalizeFirebirdOptions(options);
-    const compatibilityOptions = options;
-    const hasExplicitPlugin = compatibilityOptions.pluginName !== undefined;
-    const hasExplicitWireCrypt = compatibilityOptions.wireCrypt !== undefined;
-    const candidates = [];
-    pushUniqueCandidate(candidates, normalized);
-    if (hasExplicitPlugin && hasExplicitWireCrypt) {
-        return candidates;
-    }
-    if (hasExplicitPlugin) {
-        const wireCryptModes = normalized.pluginName === "Legacy_Auth"
-            ? ["disabled", "enabled"]
-            : ["enabled", "required", "disabled"];
-        appendPluginCandidates(candidates, normalized, normalized.pluginName, wireCryptModes);
-        return candidates;
-    }
-    if (hasExplicitWireCrypt) {
-        appendPluginCandidates(candidates, normalized, "Srp256", [normalized.wireCrypt]);
-        appendPluginCandidates(candidates, normalized, "Srp", [normalized.wireCrypt]);
-        appendPluginCandidates(candidates, normalized, "Legacy_Auth", [normalized.wireCrypt]);
-        return candidates;
-    }
-    appendPluginCandidates(candidates, normalized, "Srp256", ["enabled", "required", "disabled"]);
-    appendPluginCandidates(candidates, normalized, "Srp", ["enabled", "required", "disabled"]);
-    appendPluginCandidates(candidates, normalized, "Legacy_Auth", ["disabled", "enabled"]);
-    return candidates;
+function formatFirebirdMetadata(source) {
+    if (!source || typeof source !== "object") {
+        return "";
+    }
+    const firebirdSource = source;
+    const metadata = [];
+    if (typeof firebirdSource.gdscode === "number") {
+        metadata.push(`gdscode=${firebirdSource.gdscode}`);
+    }
+    if (firebirdSource.gdsparams !== undefined) {
+        try {
+            metadata.push(`gdsparams=${JSON.stringify(firebirdSource.gdsparams)}`);
+        }
+        catch (_a) {
+            metadata.push(`gdsparams=${String(firebirdSource.gdsparams)}`);
+        }
+    }
+    return metadata.length > 0 ? ` Metadata: ${metadata.join(", ")}.` : "";
 }
-function shouldRetryFirebirdCompatibility(error) {
-    return isRetryableCompatibilityError(error);
+function normalizeFirebirdOptions(options) {
+    var _a, _b;
+    const compatibilityOptions = options;
+    const { authPlugins: _authPlugins, compatibilityProbeTimeoutMs: _compatibilityProbeTimeoutMs, compatibilityTotalTimeoutMs, connectTimeoutMs, firebirdDriver: _firebirdDriver, logQueryParameters: _logQueryParameters, poolSize: _poolSize, trimStringResults } = compatibilityOptions, baseOptions = __rest(compatibilityOptions, ["authPlugins", "compatibilityProbeTimeoutMs", "compatibilityTotalTimeoutMs", "connectTimeoutMs", "firebirdDriver", "logQueryParameters", "poolSize", "trimStringResults"]);
+    const normalizedOptions = Object.assign(Object.assign({}, baseOptions), { pluginName: normalizeAuthPlugin(compatibilityOptions.pluginName), trimStringResults, wireCrypt: normalizeWireCryptMode(compatibilityOptions.wireCrypt) });
+    const timeoutCandidate = (_b = (_a = compatibilityOptions.connectTimeout) !== null && _a !== void 0 ? _a : connectTimeoutMs) !== null && _b !== void 0 ? _b : compatibilityTotalTimeoutMs;
+    if (Number.isFinite(timeoutCandidate) && Number(timeoutCandidate) > 0) {
+        normalizedOptions.connectTimeout = Math.trunc(Number(timeoutCandidate));
+    }
+    return normalizedOptions;
 }
 function describeFirebirdCompatibilityOptions(options) {
-    var _a;
+    var _a, _b;
     const normalized = normalizeFirebirdOptions(options);
-    return `plugin=${normalized.pluginName}, wireCrypt=${normalized.wireCrypt}, authPlugins=${((_a = normalized.authPlugins) !== null && _a !== void 0 ? _a : []).join("/")}`;
+    return `plugin=${(_a = normalized.pluginName) !== null && _a !== void 0 ? _a : "auto"}, wireCrypt=${formatWireCryptValue(normalized.wireCrypt)}, connectTimeout=${(_b = normalized.connectTimeout) !== null && _b !== void 0 ? _b : "default"}`;
 }
-function ensureEsNodeFirebirdCompatibilityPatch() {
+function enhanceFirebirdError(error, options, context) {
     var _a;
-    const firebird = Firebird;
-    const connectionPrototype = (_a = firebird.Connection) === null || _a === void 0 ? void 0 : _a.prototype;
-    if (!(connectionPrototype === null || connectionPrototype === void 0 ? void 0 : connectionPrototype.connect) || connectionPrototype.__emilsoftwareWireCryptPatched) {
-        return;
+    if (error instanceof Error && error.__emilsoftwareFirebirdEnhanced) {
+        return error;
     }
-    const originalConnect = connectionPrototype.connect;
-    connectionPrototype.connect = function patchedConnect(options, callback) {
-        var _a, _b;
-        const normalizedOptions = normalizeFirebirdOptions(options);
-        const wireCryptFlag = toWireCryptFlag(normalizedOptions.wireCrypt);
-        const authPlugin = normalizedOptions.pluginName;
-        const authPlugins = (_a = normalizedOptions.authPlugins) !== null && _a !== void 0 ? _a : DEFAULT_AUTH_PLUGIN_LIST;
-        (_b = this.accept) !== null && _b !== void 0 ? _b : (this.accept = { protocolMinimumType: 0, pluginName: authPlugin });
-        const blr = this._blr;
-        const originalAddBytes = blr === null || blr === void 0 ? void 0 : blr.addBytes;
-        const originalAddString = blr === null || blr === void 0 ? void 0 : blr.addString;
-        if (!blr || !originalAddBytes || !originalAddString) {
-            return originalConnect.call(this, normalizedOptions, callback);
-        }
-        const patchedOptions = authPlugin === "Srp256"
-            ? Object.assign(Object.assign({}, normalizedOptions), { pluginName: "Srp" }) : normalizedOptions;
-        blr.addBytes = function patchedAddBytes(bytes, ...args) {
-            if (Array.isArray(bytes) && bytes.length === 6 && bytes[0] === CNCT_CLIENT_CRYPT && bytes[1] === 4) {
-                return originalAddBytes.call(this, [bytes[0], bytes[1], wireCryptFlag, 0, 0, 0], ...args);
-            }
-            return originalAddBytes.call(this, bytes, ...args);
-        };
-        blr.addString = function patchedAddString(code, value, encoding) {
-            if (code === CNCT_PLUGIN_NAME) {
-                return originalAddString.call(this, code, authPlugin, encoding);
-            }
-            if (code === CNCT_PLUGIN_LIST) {
-                return originalAddString.call(this, code, authPlugins.join(","), encoding);
-            }
-            return originalAddString.call(this, code, value, encoding);
-        };
-        try {
-            return originalConnect.call(this, patchedOptions, callback);
-        }
-        finally {
-            blr.addBytes = originalAddBytes;
-            blr.addString = originalAddString;
-        }
-    };
-    connectionPrototype.__emilsoftwareWireCryptPatched = true;
+    const normalizedOptions = normalizeFirebirdOptions(options);
+    const target = formatTarget(normalizedOptions);
+    const original = error instanceof Error ? error : new Error(String(error));
+    const diagnostics = buildDiagnostics(original.message, normalizedOptions);
+    const sqlSuffix = context.sql ? ` SQL: ${context.sql.replace(/\s+/g, " ").trim()}` : "";
+    const diagnosticsSuffix = diagnostics.length > 0 ? ` Diagnostics: ${diagnostics.join(" ")}` : "";
+    const metadataSuffix = formatFirebirdMetadata(original);
+    const enhanced = new Error(`Firebird ${context.stage} failed on ${target}: ${original.message}.${diagnosticsSuffix}${metadataSuffix}${sqlSuffix}`);
+    enhanced.cause = original;
+    enhanced.__emilsoftwareFirebirdEnhanced = true;
+    copyFirebirdMetadata(enhanced, original);
+    enhanced.stack = `${enhanced.name}: ${enhanced.message}\nCaused by: ${(_a = original.stack) !== null && _a !== void 0 ? _a : original.message}`;
+    return enhanced;
+}
+function buildFirebirdCompatibilityCandidates(options) {
+    return [normalizeFirebirdOptions(options)];
+}
+function shouldRetryFirebirdCompatibility() {
+    return false;
+}
+function ensureEsNodeFirebirdCompatibilityPatch() {
+    // No-op kept for backward compatibility. The library now relies on the
+    // official node-firebird driver, which handles Firebird 2.5+ protocol
+    // negotiation natively.
 }
-ensureEsNodeFirebirdCompatibilityPatch();
 //# sourceMappingURL=firebird-compat.js.map

package/dist/firebird-compat.js.map

@@ -1 +1 @@
-{"version":3,"file":"firebird-compat.js","sourceRoot":"","sources":["../src/firebird-compat.ts"],"names":[],"mappings":"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","sourcesContent":["import * as Firebird from \"es-node-firebird\";\nimport { Options } from \"es-node-firebird\";\n\nexport type FirebirdWireCryptMode = \"disabled\" | \"enabled\" | \"required\";\nexport type FirebirdAuthPlugin = \"Legacy_Auth\" | \"Srp\" | \"Srp256\";\n\nexport type FirebirdOptions = Options & {\n    wireCrypt?: FirebirdWireCryptMode;\n    pluginName?: FirebirdAuthPlugin;\n    authPlugins?: FirebirdAuthPlugin[];\n    connectTimeoutMs?: number;\n    connectTimeout?: number;\n    compatibilityProbeTimeoutMs?: number;\n    compatibilityTotalTimeoutMs?: number;\n};\n\nconst CNCT_PLUGIN_NAME = 8;\nconst CNCT_PLUGIN_LIST = 10;\nconst CNCT_CLIENT_CRYPT = 11;\nconst WIRE_CRYPT_DISABLE = 0;\nconst WIRE_CRYPT_ENABLE = 1;\nconst WIRE_CRYPT_REQUIRED = 2;\nconst DEFAULT_AUTH_PLUGIN_LIST: FirebirdAuthPlugin[] = [\"Srp256\", \"Srp\", \"Legacy_Auth\"];\n\ntype BlrWriterLike = {\n    addBytes: (bytes: number[], ...args: unknown[]) => unknown;\n    addString: (code: number, value: string, encoding?: string) => unknown;\n};\n\ntype ConnectionLike = {\n    _blr?: BlrWriterLike;\n    accept?: {\n        protocolMinimumType?: number;\n        pluginName?: string;\n    };\n};\n\ntype FirebirdModuleLike = {\n    Connection?: {\n        prototype?: {\n            connect?: (this: ConnectionLike, options: FirebirdOptions, callback: unknown) => unknown;\n            __emilsoftwareWireCryptPatched?: boolean;\n        };\n    };\n};\n\nfunction normalizeWireCryptMode(value: unknown): FirebirdWireCryptMode {\n    const normalized = String(value ?? \"\").trim().toLowerCase();\n    if (normalized === \"required\") {\n        return \"required\";\n    }\n\n    if (normalized === \"disabled\") {\n        return \"disabled\";\n    }\n\n    return \"enabled\";\n}\n\nfunction normalizeAuthPlugin(value: unknown): FirebirdAuthPlugin {\n    const normalized = String(value ?? \"\").trim().toLowerCase();\n\n    if (normalized === \"legacy_auth\" || normalized === \"legacy\") {\n        return \"Legacy_Auth\";\n    }\n\n    if (normalized === \"srp256\") {\n        return \"Srp256\";\n    }\n\n    return \"Srp\";\n}\n\nfunction toWireCryptFlag(mode: FirebirdWireCryptMode): number {\n    switch (mode) {\n        case \"required\":\n            return WIRE_CRYPT_REQUIRED;\n        case \"disabled\":\n            return WIRE_CRYPT_DISABLE;\n        default:\n            return WIRE_CRYPT_ENABLE;\n    }\n}\n\nfunction normalizeAuthPluginList(value: unknown): FirebirdAuthPlugin[] {\n    if (!Array.isArray(value) || value.length === 0) {\n        return [...DEFAULT_AUTH_PLUGIN_LIST];\n    }\n\n    const normalized = value\n        .map((entry: unknown) => normalizeAuthPlugin(entry))\n        .filter((entry: FirebirdAuthPlugin, index: number, source: FirebirdAuthPlugin[]) => source.indexOf(entry) === index);\n\n    return normalized.length > 0 ? normalized : [...DEFAULT_AUTH_PLUGIN_LIST];\n}\n\nexport function normalizeFirebirdOptions(options: Options): FirebirdOptions {\n    const compatibilityOptions = options as FirebirdOptions;\n    return {\n        ...options,\n        wireCrypt: normalizeWireCryptMode(compatibilityOptions.wireCrypt),\n        pluginName: normalizeAuthPlugin(compatibilityOptions.pluginName),\n        authPlugins: normalizeAuthPluginList(compatibilityOptions.authPlugins),\n    };\n}\n\nfunction isRetryableCompatibilityError(error: unknown): boolean {\n    const message = String((error as { message?: unknown })?.message ?? error ?? \"\").toLowerCase();\n    return message.includes(\"incompatible wire encryption\")\n        || message.includes(\"no matching plugins on server\")\n        || message.includes(\"unknown auth plugin\")\n        || message.includes(\"unknow auth plugin\")\n        || message.includes(\"timeout during firebird attach\");\n}\n\nfunction pushUniqueCandidate(target: FirebirdOptions[], candidate: FirebirdOptions): void {\n    const normalized = normalizeFirebirdOptions(candidate);\n    const key = `${normalized.pluginName}|${normalized.wireCrypt}|${(normalized.authPlugins ?? []).join(\",\")}`;\n    const alreadyPresent = target.some((entry) => {\n        const normalizedEntry = normalizeFirebirdOptions(entry);\n        return `${normalizedEntry.pluginName}|${normalizedEntry.wireCrypt}|${(normalizedEntry.authPlugins ?? []).join(\",\")}` === key;\n    });\n\n    if (!alreadyPresent) {\n        target.push(normalized);\n    }\n}\n\nfunction appendPluginCandidates(\n    target: FirebirdOptions[],\n    base: FirebirdOptions,\n    pluginName: FirebirdAuthPlugin,\n    wireCryptModes: FirebirdWireCryptMode[],\n): void {\n    wireCryptModes.forEach((wireCrypt) => {\n        pushUniqueCandidate(target, { ...base, pluginName, wireCrypt });\n    });\n}\n\nexport function buildFirebirdCompatibilityCandidates(options: Options): FirebirdOptions[] {\n    const normalized = normalizeFirebirdOptions(options);\n    const compatibilityOptions = options as FirebirdOptions;\n    const hasExplicitPlugin = compatibilityOptions.pluginName !== undefined;\n    const hasExplicitWireCrypt = compatibilityOptions.wireCrypt !== undefined;\n    const candidates: FirebirdOptions[] = [];\n\n    pushUniqueCandidate(candidates, normalized);\n\n    if (hasExplicitPlugin && hasExplicitWireCrypt) {\n        return candidates;\n    }\n\n    if (hasExplicitPlugin) {\n        const wireCryptModes = normalized.pluginName === \"Legacy_Auth\"\n            ? [\"disabled\", \"enabled\"] as FirebirdWireCryptMode[]\n            : [\"enabled\", \"required\", \"disabled\"] as FirebirdWireCryptMode[];\n\n        appendPluginCandidates(candidates, normalized, normalized.pluginName!, wireCryptModes);\n        return candidates;\n    }\n\n    if (hasExplicitWireCrypt) {\n        appendPluginCandidates(candidates, normalized, \"Srp256\", [normalized.wireCrypt!]);\n        appendPluginCandidates(candidates, normalized, \"Srp\", [normalized.wireCrypt!]);\n        appendPluginCandidates(candidates, normalized, \"Legacy_Auth\", [normalized.wireCrypt!]);\n        return candidates;\n    }\n\n    appendPluginCandidates(candidates, normalized, \"Srp256\", [\"enabled\", \"required\", \"disabled\"]);\n    appendPluginCandidates(candidates, normalized, \"Srp\", [\"enabled\", \"required\", \"disabled\"]);\n    appendPluginCandidates(candidates, normalized, \"Legacy_Auth\", [\"disabled\", \"enabled\"]);\n    return candidates;\n}\n\nexport function shouldRetryFirebirdCompatibility(error: unknown): boolean {\n    return isRetryableCompatibilityError(error);\n}\n\nexport function describeFirebirdCompatibilityOptions(options: Options): string {\n    const normalized = normalizeFirebirdOptions(options);\n    return `plugin=${normalized.pluginName}, wireCrypt=${normalized.wireCrypt}, authPlugins=${(normalized.authPlugins ?? []).join(\"/\")}`;\n}\n\nexport function ensureEsNodeFirebirdCompatibilityPatch(): void {\n    const firebird = Firebird as FirebirdModuleLike;\n    const connectionPrototype = firebird.Connection?.prototype;\n\n    if (!connectionPrototype?.connect || connectionPrototype.__emilsoftwareWireCryptPatched) {\n        return;\n    }\n\n    const originalConnect = connectionPrototype.connect;\n\n    connectionPrototype.connect = function patchedConnect(\n        this: ConnectionLike,\n        options: FirebirdOptions,\n        callback: unknown,\n    ) {\n        const normalizedOptions = normalizeFirebirdOptions(options);\n        const wireCryptFlag = toWireCryptFlag(normalizedOptions.wireCrypt);\n        const authPlugin = normalizedOptions.pluginName;\n        const authPlugins = normalizedOptions.authPlugins ?? DEFAULT_AUTH_PLUGIN_LIST;\n\n        this.accept ??= { protocolMinimumType: 0, pluginName: authPlugin };\n\n        const blr = this._blr;\n        const originalAddBytes = blr?.addBytes;\n        const originalAddString = blr?.addString;\n\n        if (!blr || !originalAddBytes || !originalAddString) {\n            return originalConnect.call(this, normalizedOptions, callback);\n        }\n\n        const patchedOptions = authPlugin === \"Srp256\"\n            ? { ...normalizedOptions, pluginName: \"Srp\" as FirebirdAuthPlugin }\n            : normalizedOptions;\n\n        blr.addBytes = function patchedAddBytes(bytes: number[], ...args: unknown[]) {\n            if (Array.isArray(bytes) && bytes.length === 6 && bytes[0] === CNCT_CLIENT_CRYPT && bytes[1] === 4) {\n                return originalAddBytes.call(this, [bytes[0], bytes[1], wireCryptFlag, 0, 0, 0], ...args);\n            }\n\n            return originalAddBytes.call(this, bytes, ...args);\n        };\n\n        blr.addString = function patchedAddString(code: number, value: string, encoding?: string) {\n            if (code === CNCT_PLUGIN_NAME) {\n                return originalAddString.call(this, code, authPlugin, encoding);\n            }\n\n            if (code === CNCT_PLUGIN_LIST) {\n                return originalAddString.call(this, code, authPlugins.join(\",\"), encoding);\n            }\n\n            return originalAddString.call(this, code, value, encoding);\n        };\n\n        try {\n            return originalConnect.call(this, patchedOptions, callback);\n        } finally {\n            blr.addBytes = originalAddBytes;\n            blr.addString = originalAddString;\n        }\n    };\n\n    connectionPrototype.__emilsoftwareWireCryptPatched = true;\n}\n\nensureEsNodeFirebirdCompatibilityPatch();\n"]}
+{"version":3,"file":"firebird-compat.js","sourceRoot":"","sources":["../src/firebird-compat.ts"],"names":[],"mappings":"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","sourcesContent":["import * as Firebird from \"node-firebird\";\nimport type { Options } from \"node-firebird\";\n\nexport type FirebirdWireCryptMode = \"disabled\" | \"enabled\" | \"required\";\nexport type FirebirdAuthPlugin = \"Legacy_Auth\" | \"Srp\" | \"Srp256\" | \"Srp384\" | \"Srp512\";\nexport type FirebirdDriverStrategy = \"modern\";\n\nexport type FirebirdOptions = Options & {\n    wireCrypt?: FirebirdWireCryptMode | number;\n    pluginName?: FirebirdAuthPlugin;\n    authPlugins?: FirebirdAuthPlugin[];\n    connectTimeoutMs?: number;\n    compatibilityProbeTimeoutMs?: number;\n    compatibilityTotalTimeoutMs?: number;\n    firebirdDriver?: FirebirdDriverStrategy;\n    trimStringResults?: boolean;\n    /**\n     * When `true`, query parameters are interpolated into the logged SQL. Off by\n     * default so that secrets, credentials and personal data are not written to\n     * the console or to the daily log files.\n     */\n    logQueryParameters?: boolean;\n    /**\n     * When greater than zero, enables an opt-in connection pool of the given\n     * maximum size for this connection target instead of attaching/detaching a\n     * physical connection for every query. Default `0` keeps the historic\n     * one-connection-per-query behaviour.\n     */\n    poolSize?: number;\n};\n\ntype FirebirdErrorContext = {\n    stage: \"attach\" | \"query\" | \"execute\" | \"transaction\";\n    sql?: string;\n};\n\ntype EnhancedFirebirdError = Error & {\n    cause?: unknown;\n    gdscode?: number;\n    gdsparams?: unknown;\n    __emilsoftwareFirebirdEnhanced?: boolean;\n};\n\nfunction isBlank(value: unknown): boolean {\n    return value === undefined || value === null || (typeof value === \"string\" && value.trim() === \"\");\n}\n\nfunction normalizeWireCryptMode(value: FirebirdOptions[\"wireCrypt\"]): number | undefined {\n    if (isBlank(value)) {\n        return undefined;\n    }\n\n    if (typeof value === \"number\") {\n        return value;\n    }\n\n    const normalized = String(value).trim().toLowerCase();\n    if (normalized === \"disabled\") {\n        return Firebird.WIRE_CRYPT_DISABLE;\n    }\n\n    return Firebird.WIRE_CRYPT_ENABLE;\n}\n\nfunction normalizeAuthPlugin(value: unknown): FirebirdAuthPlugin | undefined {\n    if (isBlank(value)) {\n        return undefined;\n    }\n\n    const normalized = String(value).trim().toLowerCase();\n    if (normalized === \"legacy\" || normalized === \"legacy_auth\") {\n        return \"Legacy_Auth\";\n    }\n\n    if (normalized === \"srp256\") {\n        return \"Srp256\";\n    }\n\n    if (normalized === \"srp384\") {\n        return \"Srp384\";\n    }\n\n    if (normalized === \"srp512\") {\n        return \"Srp512\";\n    }\n\n    return \"Srp\";\n}\n\nfunction formatWireCryptValue(value: FirebirdOptions[\"wireCrypt\"]): string {\n    if (isBlank(value)) {\n        return \"auto\";\n    }\n\n    if (typeof value === \"number\") {\n        if (value === Firebird.WIRE_CRYPT_DISABLE) {\n            return \"disabled\";\n        }\n\n        if (value === Firebird.WIRE_CRYPT_ENABLE) {\n            return \"enabled\";\n        }\n\n        return String(value);\n    }\n\n    return String(value);\n}\n\nfunction formatTarget(options: Options): string {\n    return `${options.host ?? \"?\"}:${options.port ?? \"?\"} -> ${options.database ?? \"?\"}`;\n}\n\nfunction uniqueDiagnostics(values: string[]): string[] {\n    return values.filter((value, index) => values.indexOf(value) === index);\n}\n\nfunction buildDiagnostics(message: string, options: FirebirdOptions): string[] {\n    const diagnostics: string[] = [];\n    const pluginMismatch = message.match(/Server don't accept plugin\\s*:\\s*([^,]+),\\s*but support\\s*:\\s*(.+)$/i);\n\n    if (pluginMismatch) {\n        const supportedPlugins = (pluginMismatch[2] ?? \"\")\n            .split(\",\")\n            .map((plugin) => plugin.trim())\n            .filter((plugin) => plugin.length > 0);\n        const supportedMessage = supportedPlugins.length === 1\n            ? `The server explicitly reported that only the \"${supportedPlugins[0]}\" authentication plugin is supported.`\n            : `The server explicitly reported the supported authentication plugins: ${supportedPlugins.join(\", \")}.`;\n        diagnostics.push(supportedMessage);\n    }\n\n    if (/Incompatible wire encryption levels requested on client and server/i.test(message)) {\n        diagnostics.push(\"The server rejected the requested wire encryption mode. Keep wire encryption auto-enabled unless the server is known to allow disabled encryption.\");\n    }\n\n    if (/No matching plugins on server/i.test(message)) {\n        diagnostics.push(\"The server did not find a common authentication plugin with the client configuration.\");\n    }\n\n    if (/Connection timeout after \\d+ms/i.test(message) || /Timeout during Firebird attach after \\d+ ms/i.test(message)) {\n        diagnostics.push(\"The TCP connection was accepted but the Firebird wire-protocol attach did not complete in time.\");\n    }\n\n    if (options.pluginName) {\n        diagnostics.push(`Client authentication plugin was forced to \"${options.pluginName}\". Leave pluginName empty to let the driver auto-negotiate when possible.`);\n    }\n\n    if (!isBlank(options.wireCrypt)) {\n        diagnostics.push(`Client wire encryption was forced to \"${formatWireCryptValue(options.wireCrypt)}\".`);\n    }\n\n    return uniqueDiagnostics(diagnostics);\n}\n\nfunction copyFirebirdMetadata(target: EnhancedFirebirdError, source: unknown): void {\n    if (!source || typeof source !== \"object\") {\n        return;\n    }\n\n    const firebirdSource = source as Record<string, unknown>;\n    if (\"gdscode\" in firebirdSource) {\n        target.gdscode = firebirdSource.gdscode as number;\n    }\n\n    if (\"gdsparams\" in firebirdSource) {\n        target.gdsparams = firebirdSource.gdsparams;\n    }\n}\n\nfunction formatFirebirdMetadata(source: unknown): string {\n    if (!source || typeof source !== \"object\") {\n        return \"\";\n    }\n\n    const firebirdSource = source as Record<string, unknown>;\n    const metadata: string[] = [];\n\n    if (typeof firebirdSource.gdscode === \"number\") {\n        metadata.push(`gdscode=${firebirdSource.gdscode}`);\n    }\n\n    if (firebirdSource.gdsparams !== undefined) {\n        try {\n            metadata.push(`gdsparams=${JSON.stringify(firebirdSource.gdsparams)}`);\n        } catch {\n            metadata.push(`gdsparams=${String(firebirdSource.gdsparams)}`);\n        }\n    }\n\n    return metadata.length > 0 ? ` Metadata: ${metadata.join(\", \")}.` : \"\";\n}\n\nexport function normalizeFirebirdOptions(options: Options): FirebirdOptions {\n    const compatibilityOptions = options as FirebirdOptions;\n    const {\n        authPlugins: _authPlugins,\n        compatibilityProbeTimeoutMs: _compatibilityProbeTimeoutMs,\n        compatibilityTotalTimeoutMs,\n        connectTimeoutMs,\n        firebirdDriver: _firebirdDriver,\n        logQueryParameters: _logQueryParameters,\n        poolSize: _poolSize,\n        trimStringResults,\n        ...baseOptions\n    } = compatibilityOptions;\n\n    const normalizedOptions: FirebirdOptions = {\n        ...baseOptions,\n        pluginName: normalizeAuthPlugin(compatibilityOptions.pluginName),\n        trimStringResults,\n        wireCrypt: normalizeWireCryptMode(compatibilityOptions.wireCrypt),\n    };\n\n    const timeoutCandidate = compatibilityOptions.connectTimeout\n        ?? connectTimeoutMs\n        ?? compatibilityTotalTimeoutMs;\n\n    if (Number.isFinite(timeoutCandidate) && Number(timeoutCandidate) > 0) {\n        normalizedOptions.connectTimeout = Math.trunc(Number(timeoutCandidate));\n    }\n\n    return normalizedOptions;\n}\n\nexport function describeFirebirdCompatibilityOptions(options: Options): string {\n    const normalized = normalizeFirebirdOptions(options);\n    return `plugin=${normalized.pluginName ?? \"auto\"}, wireCrypt=${formatWireCryptValue(normalized.wireCrypt)}, connectTimeout=${normalized.connectTimeout ?? \"default\"}`;\n}\n\nexport function enhanceFirebirdError(error: unknown, options: Options, context: FirebirdErrorContext): Error {\n    if (error instanceof Error && (error as EnhancedFirebirdError).__emilsoftwareFirebirdEnhanced) {\n        return error;\n    }\n\n    const normalizedOptions = normalizeFirebirdOptions(options);\n    const target = formatTarget(normalizedOptions);\n    const original = error instanceof Error ? error : new Error(String(error));\n    const diagnostics = buildDiagnostics(original.message, normalizedOptions);\n    const sqlSuffix = context.sql ? ` SQL: ${context.sql.replace(/\\s+/g, \" \").trim()}` : \"\";\n    const diagnosticsSuffix = diagnostics.length > 0 ? ` Diagnostics: ${diagnostics.join(\" \")}` : \"\";\n    const metadataSuffix = formatFirebirdMetadata(original);\n    const enhanced = new Error(\n        `Firebird ${context.stage} failed on ${target}: ${original.message}.${diagnosticsSuffix}${metadataSuffix}${sqlSuffix}`\n    ) as EnhancedFirebirdError;\n\n    enhanced.cause = original;\n    enhanced.__emilsoftwareFirebirdEnhanced = true;\n    copyFirebirdMetadata(enhanced, original);\n    enhanced.stack = `${enhanced.name}: ${enhanced.message}\\nCaused by: ${original.stack ?? original.message}`;\n    return enhanced;\n}\n\nexport function buildFirebirdCompatibilityCandidates(options: Options): FirebirdOptions[] {\n    return [normalizeFirebirdOptions(options)];\n}\n\nexport function shouldRetryFirebirdCompatibility(): boolean {\n    return false;\n}\n\nexport function ensureEsNodeFirebirdCompatibilityPatch(): void {\n    // No-op kept for backward compatibility. The library now relies on the\n    // official node-firebird driver, which handles Firebird 2.5+ protocol\n    // negotiation natively.\n}\n"]}

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { DatabaseUpdater } from "./DatabaseUpdater";
 import { ExecutionTimeLogger } from "./ExecutionTimeLogger";
-import * as Firebird from "es-node-firebird";
+import * as Firebird from "node-firebird";
 import { LogLevels, Logger } from "./Logger";
 import { Orm } from "./Orm";
 import { DateUtilities, RestUtilities, DatabaseUtilities, StatusCode } from "./Utilities";
@@ -18,7 +18,7 @@ export * from "./DatabaseUpdater";
 export * from "./firebird-compat";
 export * from "./accessi-module";
 export * from "./allegati-module";
-export * from "es-node-firebird";
+export * from "node-firebird";
 export { autobind, ExecutionTimeLogger, Logger, LogLevels, Orm, DateUtilities, RestUtilities, DatabaseUtilities, DatabaseUpdater, StatusCode, DocumentGenerator, Firebird };
 export * from "./swagger/SwaggerConfig";
 export * from "./initEmilsoftwareModule";