emilsoftware-utilities 2.0.0-dev.1 → 2.0.0-dev.11

package/dist/firebird-compat.js

@@ -0,0 +1,218 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        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.ensureEsNodeFirebirdCompatibilityPatch = ensureEsNodeFirebirdCompatibilityPatch;
+const Firebird = __importStar(require("node-firebird"));
+function isBlank(value) {
+    return value === undefined || value === null || (typeof value === "string" && value.trim() === "");
+}
+function normalizeWireCryptMode(value) {
+    if (isBlank(value)) {
+        return undefined;
+    }
+    if (typeof value === "number") {
+        return value;
+    }
+    const normalized = String(value).trim().toLowerCase();
+    if (normalized === "disabled") {
+        return Firebird.WIRE_CRYPT_DISABLE;
+    }
+    return Firebird.WIRE_CRYPT_ENABLE;
+}
+function normalizeAuthPlugin(value) {
+    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 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 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 uniqueDiagnostics(values) {
+    return values.filter((value, index) => values.indexOf(value) === index);
+}
+function buildDiagnostics(message, options) {
+    const diagnostics = [];
+    const pluginMismatch = message.match(/Server don't accept plugin\s*:\s*([^,]+),\s*but support\s*:\s*(.+)$/i);
+    if (pluginMismatch) {
+        const supportedPlugins = pluginMismatch[2]
+            .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 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 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 normalizeFirebirdOptions(options) {
+    var _a, _b;
+    const compatibilityOptions = options;
+    const { authPlugins: _authPlugins, compatibilityProbeTimeoutMs: _compatibilityProbeTimeoutMs, compatibilityTotalTimeoutMs, connectTimeoutMs, firebirdDriver: _firebirdDriver } = compatibilityOptions, baseOptions = __rest(compatibilityOptions, ["authPlugins", "compatibilityProbeTimeoutMs", "compatibilityTotalTimeoutMs", "connectTimeoutMs", "firebirdDriver"]);
+    const normalizedOptions = Object.assign(Object.assign({}, baseOptions), { pluginName: normalizeAuthPlugin(compatibilityOptions.pluginName), 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, _b;
+    const normalized = normalizeFirebirdOptions(options);
+    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 enhanceFirebirdError(error, options, context) {
+    var _a;
+    if (error instanceof Error && error.__emilsoftwareFirebirdEnhanced) {
+        return error;
+    }
+    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.
+}
+//# sourceMappingURL=firebird-compat.js.map

package/dist/firebird-compat.js.map

@@ -0,0 +1 @@
+{"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};\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        ...baseOptions\n    } = compatibilityOptions;\n\n    const normalizedOptions: FirebirdOptions = {\n        ...baseOptions,\n        pluginName: normalizeAuthPlugin(compatibilityOptions.pluginName),\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,10 +1,12 @@
 import { DatabaseUpdater } from "./DatabaseUpdater";
 import { ExecutionTimeLogger } from "./ExecutionTimeLogger";
+import * as Firebird from "node-firebird";
 import { LogLevels, Logger } from "./Logger";
 import { Orm } from "./Orm";
 import { DateUtilities, RestUtilities, DatabaseUtilities, StatusCode } from "./Utilities";
 import { autobind } from "./autobind";
 import { DocumentGenerator } from "./ContractGenerator";
+import "./firebird-compat";
 export * from "./Orm";
 export * from "./Utilities";
 export * from "./Logger";
@@ -13,9 +15,10 @@ export * from "./ExecutionTimeLogger";
 export * from "./RoutesLoggerMiddleware";
 export * from "./ContractGenerator";
 export * from "./DatabaseUpdater";
+export * from "./firebird-compat";
 export * from "./accessi-module";
 export * from "./allegati-module";
-export * from "es-node-firebird";
-export { autobind, ExecutionTimeLogger, Logger, LogLevels, Orm, DateUtilities, RestUtilities, DatabaseUtilities, DatabaseUpdater, StatusCode, DocumentGenerator };
+export * from "node-firebird";
+export { autobind, ExecutionTimeLogger, Logger, LogLevels, Orm, DateUtilities, RestUtilities, DatabaseUtilities, DatabaseUpdater, StatusCode, DocumentGenerator, Firebird };
 export * from "./swagger/SwaggerConfig";
 export * from "./initEmilsoftwareModule";

package/dist/index.js

@@ -10,15 +10,39 @@ var __createBinding = (this && this.__createBinding) || (Object.create ? (functi
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];
 }));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DocumentGenerator = exports.StatusCode = exports.DatabaseUpdater = exports.DatabaseUtilities = exports.RestUtilities = exports.DateUtilities = exports.Orm = exports.LogLevels = exports.Logger = exports.ExecutionTimeLogger = exports.autobind = void 0;
+exports.Firebird = exports.DocumentGenerator = exports.StatusCode = exports.DatabaseUpdater = exports.DatabaseUtilities = exports.RestUtilities = exports.DateUtilities = exports.Orm = exports.LogLevels = exports.Logger = exports.ExecutionTimeLogger = exports.autobind = void 0;
 const DatabaseUpdater_1 = require("./DatabaseUpdater");
 Object.defineProperty(exports, "DatabaseUpdater", { enumerable: true, get: function () { return DatabaseUpdater_1.DatabaseUpdater; } });
 const ExecutionTimeLogger_1 = require("./ExecutionTimeLogger");
 Object.defineProperty(exports, "ExecutionTimeLogger", { enumerable: true, get: function () { return ExecutionTimeLogger_1.ExecutionTimeLogger; } });
+const Firebird = __importStar(require("node-firebird"));
+exports.Firebird = Firebird;
 const Logger_1 = require("./Logger");
 Object.defineProperty(exports, "LogLevels", { enumerable: true, get: function () { return Logger_1.LogLevels; } });
 Object.defineProperty(exports, "Logger", { enumerable: true, get: function () { return Logger_1.Logger; } });
@@ -33,6 +57,7 @@ const autobind_1 = require("./autobind");
 Object.defineProperty(exports, "autobind", { enumerable: true, get: function () { return autobind_1.autobind; } });
 const ContractGenerator_1 = require("./ContractGenerator");
 Object.defineProperty(exports, "DocumentGenerator", { enumerable: true, get: function () { return ContractGenerator_1.DocumentGenerator; } });
+require("./firebird-compat");
 __exportStar(require("./Orm"), exports);
 __exportStar(require("./Utilities"), exports);
 __exportStar(require("./Logger"), exports);
@@ -41,9 +66,10 @@ __exportStar(require("./ExecutionTimeLogger"), exports);
 __exportStar(require("./RoutesLoggerMiddleware"), exports);
 __exportStar(require("./ContractGenerator"), exports);
 __exportStar(require("./DatabaseUpdater"), exports);
+__exportStar(require("./firebird-compat"), exports);
 __exportStar(require("./accessi-module"), exports);
 __exportStar(require("./allegati-module"), exports);
-__exportStar(require("es-node-firebird"), exports);
+__exportStar(require("node-firebird"), exports);
 // Unified module exports
 __exportStar(require("./swagger/SwaggerConfig"), exports);
 __exportStar(require("./initEmilsoftwareModule"), exports);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,uDAAoD;AAoB6D,gGApBxG,iCAAe,OAoBwG;AAnBhI,+DAA2D;AAmBxC,oGAnBV,yCAAmB,OAmBU;AAlBtC,qCAA6C;AAkBG,0FAlBvC,kBAAS,OAkBuC;AAAjB,uFAlBpB,eAAM,OAkBoB;AAjB9C,+BAA4B;AAiB+B,oFAjBlD,SAAG,OAiBkD;AAhB9D,2CAA0F;AAgB1B,8FAhBvD,yBAAa,OAgBuD;AAAE,8FAhBvD,yBAAa,OAgBuD;AAAE,kGAhBvD,6BAAiB,OAgBuD;AAAmB,2FAhBxE,sBAAU,OAgBwE;AAf5I,yCAAsC;AAe7B,yFAfA,mBAAQ,OAeA;AAdjB,2DAAwD;AAcsF,kGAdrI,qCAAiB,OAcqI;AAZ/J,wCAAsB;AACtB,8CAA4B;AAC5B,2CAAyB;AACzB,6CAA2B;AAC3B,wDAAsC;AACtC,2DAAyC;AACzC,sDAAoC;AACpC,oDAAkC;AAElC,mDAAiC;AACjC,oDAAkC;AAClC,mDAAiC;AAEjC,yBAAyB;AACzB,0DAAwC;AACxC,2DAAyC","sourcesContent":["import { DatabaseUpdater } from \"./DatabaseUpdater\";\nimport { ExecutionTimeLogger } from \"./ExecutionTimeLogger\"\nimport { LogLevels, Logger } from \"./Logger\";\nimport { Orm } from \"./Orm\";\nimport { DateUtilities, RestUtilities, DatabaseUtilities, StatusCode } from \"./Utilities\";\nimport { autobind } from \"./autobind\";\nimport { DocumentGenerator } from \"./ContractGenerator\";\n\nexport * from \"./Orm\";\nexport * from \"./Utilities\";\nexport * from \"./Logger\";\nexport * from \"./autobind\";\nexport * from \"./ExecutionTimeLogger\";\nexport * from \"./RoutesLoggerMiddleware\";\nexport * from \"./ContractGenerator\";\nexport * from \"./DatabaseUpdater\";\n\nexport * from \"./accessi-module\";\nexport * from \"./allegati-module\";\nexport * from \"es-node-firebird\";\nexport { autobind, ExecutionTimeLogger, Logger, LogLevels, Orm, DateUtilities, RestUtilities, DatabaseUtilities, DatabaseUpdater, StatusCode, DocumentGenerator };\n// Unified module exports\nexport * from \"./swagger/SwaggerConfig\";\nexport * from \"./initEmilsoftwareModule\";"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uDAAoD;AAuB6D,gGAvBxG,iCAAe,OAuBwG;AAtBhI,+DAA2D;AAsBxC,oGAtBV,yCAAmB,OAsBU;AArBtC,wDAA0C;AAqBuH,4BAAQ;AApBzK,qCAA6C;AAoBG,0FApBvC,kBAAS,OAoBuC;AAAjB,uFApBpB,eAAM,OAoBoB;AAnB9C,+BAA4B;AAmB+B,oFAnBlD,SAAG,OAmBkD;AAlB9D,2CAA0F;AAkB1B,8FAlBvD,yBAAa,OAkBuD;AAAE,8FAlBvD,yBAAa,OAkBuD;AAAE,kGAlBvD,6BAAiB,OAkBuD;AAAmB,2FAlBxE,sBAAU,OAkBwE;AAjB5I,yCAAsC;AAiB7B,yFAjBA,mBAAQ,OAiBA;AAhBjB,2DAAwD;AAgBsF,kGAhBrI,qCAAiB,OAgBqI;AAf/J,6BAA2B;AAE3B,wCAAsB;AACtB,8CAA4B;AAC5B,2CAAyB;AACzB,6CAA2B;AAC3B,wDAAsC;AACtC,2DAAyC;AACzC,sDAAoC;AACpC,oDAAkC;AAClC,oDAAkC;AAElC,mDAAiC;AACjC,oDAAkC;AAClC,gDAA8B;AAE9B,yBAAyB;AACzB,0DAAwC;AACxC,2DAAyC","sourcesContent":["import { DatabaseUpdater } from \"./DatabaseUpdater\";\nimport { ExecutionTimeLogger } from \"./ExecutionTimeLogger\"\nimport * as Firebird from \"node-firebird\";\nimport { LogLevels, Logger } from \"./Logger\";\nimport { Orm } from \"./Orm\";\nimport { DateUtilities, RestUtilities, DatabaseUtilities, StatusCode } from \"./Utilities\";\nimport { autobind } from \"./autobind\";\nimport { DocumentGenerator } from \"./ContractGenerator\";\nimport \"./firebird-compat\";\n\nexport * from \"./Orm\";\nexport * from \"./Utilities\";\nexport * from \"./Logger\";\nexport * from \"./autobind\";\nexport * from \"./ExecutionTimeLogger\";\nexport * from \"./RoutesLoggerMiddleware\";\nexport * from \"./ContractGenerator\";\nexport * from \"./DatabaseUpdater\";\nexport * from \"./firebird-compat\";\n\nexport * from \"./accessi-module\";\nexport * from \"./allegati-module\";\nexport * from \"node-firebird\";\nexport { autobind, ExecutionTimeLogger, Logger, LogLevels, Orm, DateUtilities, RestUtilities, DatabaseUtilities, DatabaseUpdater, StatusCode, DocumentGenerator, Firebird };\n// Unified module exports\nexport * from \"./swagger/SwaggerConfig\";\nexport * from \"./initEmilsoftwareModule\";\n"]}

package/dist/swagger/SwaggerConfig.d.ts

@@ -1,2 +1,8 @@
 import { INestApplication } from "@nestjs/common";
-export declare function setupSwagger(app: INestApplication): void;
+export type SwaggerSetupOptions = {
+    swaggerPath?: string;
+    swaggerJsonPath?: string;
+    title?: string;
+    description?: string;
+};
+export declare function setupSwagger(app: INestApplication, options?: SwaggerSetupOptions): void;

package/dist/swagger/SwaggerConfig.js

@@ -3,14 +3,18 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.setupSwagger = setupSwagger;
 const swagger_1 = require("@nestjs/swagger");
 const Logger_1 = require("../Logger");
-function setupSwagger(app) {
-    var _a, _b;
+function setupSwagger(app, options) {
+    var _a, _b, _c, _d, _e, _f;
     const logger = new Logger_1.Logger("SwaggerConfig");
-    const swaggerPath = "swagger";
-    const swaggerJsonPath = `${swaggerPath}-json`;
+    const swaggerPath = (_a = options === null || options === void 0 ? void 0 : options.swaggerPath) !== null && _a !== void 0 ? _a : "swagger";
+    const defaultSwaggerJsonPath = swaggerPath.includes("/")
+        ? `${swaggerPath.substring(0, swaggerPath.lastIndexOf("/") + 1)}swagger.json`
+        : "swagger.json";
+    const swaggerJsonPath = (_b = options === null || options === void 0 ? void 0 : options.swaggerJsonPath) !== null && _b !== void 0 ? _b : defaultSwaggerJsonPath;
+    const legacySwaggerJsonPath = `${swaggerPath}-json`;
     const config = new swagger_1.DocumentBuilder()
-        .setTitle("API Documentation")
-        .setDescription("API per la gestione di accessi utenti e allegati")
+        .setTitle((_c = options === null || options === void 0 ? void 0 : options.title) !== null && _c !== void 0 ? _c : "API Documentation")
+        .setDescription((_d = options === null || options === void 0 ? void 0 : options.description) !== null && _d !== void 0 ? _d : "API per la gestione di accessi utenti e allegati")
         .setVersion("1.0")
         .addBearerAuth() // Per abilitare l'autenticazione JWT
         .build();
@@ -20,7 +24,14 @@ function setupSwagger(app) {
         res.setHeader("Content-Type", "application/json");
         res.send(document);
     });
-    let port = ((_b = (_a = app.getHttpServer()) === null || _a === void 0 ? void 0 : _a.address) === null || _b === void 0 ? void 0 : _b.port) || 3000;
+    if (legacySwaggerJsonPath !== swaggerJsonPath) {
+        app.use(`/${legacySwaggerJsonPath}`, (_, res) => {
+            res.setHeader("Content-Type", "application/json");
+            res.send(document);
+        });
+    }
+    let port = ((_f = (_e = app.getHttpServer()) === null || _e === void 0 ? void 0 : _e.address) === null || _f === void 0 ? void 0 : _f.port) || 3000;
     logger.info(`Swagger documentation available at: http://localhost:${port}/${swaggerPath}`);
+    logger.info(`Swagger OpenAPI JSON available at: http://localhost:${port}/${swaggerJsonPath}`);
 }
 //# sourceMappingURL=SwaggerConfig.js.map

package/dist/swagger/SwaggerConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"SwaggerConfig.js","sourceRoot":"","sources":["../../src/swagger/SwaggerConfig.ts"],"names":[],"mappings":";;AAIA,oCAyBC;AA5BD,6CAAiE;AACjE,sCAAmC;AAEnC,SAAgB,YAAY,CAAC,GAAqB;;IAC9C,MAAM,MAAM,GAAW,IAAI,eAAM,CAAC,eAAe,CAAC,CAAC;IACnD,MAAM,WAAW,GAAG,SAAS,CAAC;IAC9B,MAAM,eAAe,GAAG,GAAG,WAAW,OAAO,CAAC;IAE9C,MAAM,MAAM,GAAG,IAAI,yBAAe,EAAE;SAC/B,QAAQ,CAAC,mBAAmB,CAAC;SAC7B,cAAc,CAAC,kDAAkD,CAAC;SAClE,UAAU,CAAC,KAAK,CAAC;SACjB,aAAa,EAAE,CAAC,qCAAqC;SACrD,KAAK,EAAE,CAAC;IAEb,MAAM,QAAQ,GAAG,uBAAa,CAAC,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC3D,uBAAa,CAAC,KAAK,CAAC,WAAW,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;IAEhD,GAAG,CAAC,GAAG,CAAC,IAAI,eAAe,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;QACtC,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;QAClD,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,IAAI,IAAI,GAAG,CAAA,MAAA,MAAA,GAAG,CAAC,aAAa,EAAE,0CAAE,OAAO,0CAAE,IAAI,KAAI,IAAI,CAAC;IAEtD,MAAM,CAAC,IAAI,CACP,wDAAwD,IAAI,IAAI,WAAW,EAAE,CAChF,CAAC;AACN,CAAC","sourcesContent":["import { INestApplication } from \"@nestjs/common\";\nimport { DocumentBuilder, SwaggerModule } from \"@nestjs/swagger\";\nimport { Logger } from \"../Logger\";\n\nexport function setupSwagger(app: INestApplication) {\n    const logger: Logger = new Logger(\"SwaggerConfig\");\n    const swaggerPath = \"swagger\";\n    const swaggerJsonPath = `${swaggerPath}-json`;\n\n    const config = new DocumentBuilder()\n        .setTitle(\"API Documentation\")\n        .setDescription(\"API per la gestione di accessi utenti e allegati\")\n        .setVersion(\"1.0\")\n        .addBearerAuth() // Per abilitare l'autenticazione JWT\n        .build();\n\n    const document = SwaggerModule.createDocument(app, config);\n    SwaggerModule.setup(swaggerPath, app, document);\n\n    app.use(`/${swaggerJsonPath}`, (_, res) => {\n        res.setHeader(\"Content-Type\", \"application/json\");\n        res.send(document);\n    });\n\n    let port = app.getHttpServer()?.address?.port || 3000;\n\n    logger.info(\n        `Swagger documentation available at: http://localhost:${port}/${swaggerPath}`\n    );\n} "]}
+{"version":3,"file":"SwaggerConfig.js","sourceRoot":"","sources":["../../src/swagger/SwaggerConfig.ts"],"names":[],"mappings":";;AAWA,oCAuCC;AAjDD,6CAAiE;AACjE,sCAAmC;AASnC,SAAgB,YAAY,CAAC,GAAqB,EAAE,OAA6B;;IAC7E,MAAM,MAAM,GAAW,IAAI,eAAM,CAAC,eAAe,CAAC,CAAC;IACnD,MAAM,WAAW,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,WAAW,mCAAI,SAAS,CAAC;IACtD,MAAM,sBAAsB,GAAG,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC;QACpD,CAAC,CAAC,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,WAAW,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,cAAc;QAC7E,CAAC,CAAC,cAAc,CAAC;IACrB,MAAM,eAAe,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,eAAe,mCAAI,sBAAsB,CAAC;IAC3E,MAAM,qBAAqB,GAAG,GAAG,WAAW,OAAO,CAAC;IAEpD,MAAM,MAAM,GAAG,IAAI,yBAAe,EAAE;SAC/B,QAAQ,CAAC,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,KAAK,mCAAI,mBAAmB,CAAC;SAC/C,cAAc,CAAC,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,WAAW,mCAAI,kDAAkD,CAAC;SAC1F,UAAU,CAAC,KAAK,CAAC;SACjB,aAAa,EAAE,CAAC,qCAAqC;SACrD,KAAK,EAAE,CAAC;IAEb,MAAM,QAAQ,GAAG,uBAAa,CAAC,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC3D,uBAAa,CAAC,KAAK,CAAC,WAAW,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;IAEhD,GAAG,CAAC,GAAG,CAAC,IAAI,eAAe,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;QACtC,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;QAClD,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,IAAI,qBAAqB,KAAK,eAAe,EAAE,CAAC;QAC5C,GAAG,CAAC,GAAG,CAAC,IAAI,qBAAqB,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;YAC5C,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;YAClD,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;IACP,CAAC;IAED,IAAI,IAAI,GAAG,CAAA,MAAA,MAAA,GAAG,CAAC,aAAa,EAAE,0CAAE,OAAO,0CAAE,IAAI,KAAI,IAAI,CAAC;IAEtD,MAAM,CAAC,IAAI,CACP,wDAAwD,IAAI,IAAI,WAAW,EAAE,CAChF,CAAC;IACF,MAAM,CAAC,IAAI,CACP,uDAAuD,IAAI,IAAI,eAAe,EAAE,CACnF,CAAC;AACN,CAAC","sourcesContent":["import { INestApplication } from \"@nestjs/common\";\nimport { DocumentBuilder, SwaggerModule } from \"@nestjs/swagger\";\nimport { Logger } from \"../Logger\";\n\nexport type SwaggerSetupOptions = {\n    swaggerPath?: string;\n    swaggerJsonPath?: string;\n    title?: string;\n    description?: string;\n};\n\nexport function setupSwagger(app: INestApplication, options?: SwaggerSetupOptions) {\n    const logger: Logger = new Logger(\"SwaggerConfig\");\n    const swaggerPath = options?.swaggerPath ?? \"swagger\";\n    const defaultSwaggerJsonPath = swaggerPath.includes(\"/\")\n        ? `${swaggerPath.substring(0, swaggerPath.lastIndexOf(\"/\") + 1)}swagger.json`\n        : \"swagger.json\";\n    const swaggerJsonPath = options?.swaggerJsonPath ?? defaultSwaggerJsonPath;\n    const legacySwaggerJsonPath = `${swaggerPath}-json`;\n\n    const config = new DocumentBuilder()\n        .setTitle(options?.title ?? \"API Documentation\")\n        .setDescription(options?.description ?? \"API per la gestione di accessi utenti e allegati\")\n        .setVersion(\"1.0\")\n        .addBearerAuth() // Per abilitare l'autenticazione JWT\n        .build();\n\n    const document = SwaggerModule.createDocument(app, config);\n    SwaggerModule.setup(swaggerPath, app, document);\n\n    app.use(`/${swaggerJsonPath}`, (_, res) => {\n        res.setHeader(\"Content-Type\", \"application/json\");\n        res.send(document);\n    });\n\n    if (legacySwaggerJsonPath !== swaggerJsonPath) {\n        app.use(`/${legacySwaggerJsonPath}`, (_, res) => {\n            res.setHeader(\"Content-Type\", \"application/json\");\n            res.send(document);\n        });\n    }\n\n    let port = app.getHttpServer()?.address?.port || 3000;\n\n    logger.info(\n        `Swagger documentation available at: http://localhost:${port}/${swaggerPath}`\n    );\n    logger.info(\n        `Swagger OpenAPI JSON available at: http://localhost:${port}/${swaggerJsonPath}`\n    );\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "emilsoftware-utilities",
-  "version": "2.0.0-dev.1",
+  "version": "2.0.0-dev.11",
   "description": "Utilities for EmilSoftware",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -37,12 +37,12 @@
     "class-transformer": "^0.5.1",
     "class-validator": "^0.14.1",
     "colorette": "^2.0.20",
-    "es-node-firebird": "^1.2.9",
     "jsonwebtoken": "^9.0.2",
     "jspdf": "^3.0.0",
     "jspdf-autotable": "^5.0.2",
     "multer": "^1.4.5-lts.2",
     "node-fetch": "^3.3.2",
+    "node-firebird": "^2.15.0",
     "nodemailer": "^6.10.0",
     "reflect-metadata": "^0.2.2",
     "swagger-jsdoc": "^6.2.8",