emilsoftware-utilities 2.0.0-dev.65 → 2.0.0-dev.67

package/dist/firebird-compat.js

@@ -44,6 +44,8 @@ var __rest = (this && this.__rest) || function (s, e) {
     return t;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.toUtcDate = toUtcDate;
+exports.normalizeFirebirdResult = normalizeFirebirdResult;
 exports.normalizeFirebirdOptions = normalizeFirebirdOptions;
 exports.describeFirebirdCompatibilityOptions = describeFirebirdCompatibilityOptions;
 exports.enhanceFirebirdError = enhanceFirebirdError;
@@ -54,6 +56,53 @@ const Firebird = __importStar(require("node-firebird"));
 function isBlank(value) {
     return value === undefined || value === null || (typeof value === "string" && value.trim() === "");
 }
+/**
+ * Reinterprets a Date's local wall-clock components as UTC.
+ *
+ * `node-firebird` 2.x decodes Firebird DATE/TIME/TIMESTAMP (which are
+ * timezone-less) as *local* time via `setMilliseconds(... + getTimezoneOffset())`.
+ * The legacy `es-node-firebird` fork instead decoded them as UTC
+ * (`setUTCMilliseconds`). This helper reproduces that legacy behaviour by
+ * taking the local wall-clock fields and rebuilding the Date as if they were
+ * UTC, so existing applications keep seeing the same values.
+ */
+function toUtcDate(date) {
+    return new Date(Date.UTC(date.getFullYear(), date.getMonth(), date.getDate(), date.getHours(), date.getMinutes(), date.getSeconds(), date.getMilliseconds()));
+}
+/**
+ * Normalizes a decoded Firebird result value to reproduce the legacy
+ * `es-node-firebird` fork behaviour:
+ *
+ * - strings are trimmed (the fork called `.trim()` on every text field);
+ * - `Date` values are reinterpreted as UTC (the fork used `setUTCMilliseconds`);
+ * - arrays and plain objects are normalized recursively;
+ * - `Buffer`, `null` and `undefined` are left untouched.
+ */
+function normalizeFirebirdResult(value, trimStringResults, utcDates) {
+    if (value === undefined || value === null) {
+        return value;
+    }
+    if (typeof value === "string" || value instanceof String) {
+        return trimStringResults ? String(value).trim() : value;
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => normalizeFirebirdResult(item, trimStringResults, utcDates));
+    }
+    if (value instanceof Date) {
+        return utcDates ? toUtcDate(value) : value;
+    }
+    if (Buffer.isBuffer(value)) {
+        return value;
+    }
+    if (typeof value === "object") {
+        const source = value;
+        return Object.keys(source).reduce((normalized, key) => {
+            normalized[key] = normalizeFirebirdResult(source[key], trimStringResults, utcDates);
+            return normalized;
+        }, {});
+    }
+    return value;
+}
 function normalizeWireCryptMode(value) {
     if (isBlank(value)) {
         return undefined;
@@ -173,8 +222,9 @@ function formatFirebirdMetadata(source) {
 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 { authPlugins: _authPlugins, compatibilityProbeTimeoutMs: _compatibilityProbeTimeoutMs, compatibilityTotalTimeoutMs, connectTimeoutMs, firebirdDriver: _firebirdDriver, logQueryParameters: _logQueryParameters, poolSize: _poolSize, trimStringResults, utcDates } = compatibilityOptions, baseOptions = __rest(compatibilityOptions, ["authPlugins", "compatibilityProbeTimeoutMs", "compatibilityTotalTimeoutMs", "connectTimeoutMs", "firebirdDriver", "logQueryParameters", "poolSize", "trimStringResults", "utcDates"]);
+    const normalizedOptions = Object.assign(Object.assign({}, baseOptions), { pluginName: normalizeAuthPlugin(compatibilityOptions.pluginName), trimStringResults,
+        utcDates, 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));

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 \"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"]}
+{"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` (default), DATE/TIME/TIMESTAMP values are returned as UTC,\n     * reproducing the legacy `es-node-firebird` fork behaviour. When `false`,\n     * the values are left as decoded by `node-firebird` (local time).\n     */\n    utcDates?: 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\n/**\n * Reinterprets a Date's local wall-clock components as UTC.\n *\n * `node-firebird` 2.x decodes Firebird DATE/TIME/TIMESTAMP (which are\n * timezone-less) as *local* time via `setMilliseconds(... + getTimezoneOffset())`.\n * The legacy `es-node-firebird` fork instead decoded them as UTC\n * (`setUTCMilliseconds`). This helper reproduces that legacy behaviour by\n * taking the local wall-clock fields and rebuilding the Date as if they were\n * UTC, so existing applications keep seeing the same values.\n */\nexport function toUtcDate(date: Date): Date {\n    return new Date(Date.UTC(\n        date.getFullYear(),\n        date.getMonth(),\n        date.getDate(),\n        date.getHours(),\n        date.getMinutes(),\n        date.getSeconds(),\n        date.getMilliseconds(),\n    ));\n}\n\n/**\n * Normalizes a decoded Firebird result value to reproduce the legacy\n * `es-node-firebird` fork behaviour:\n *\n * - strings are trimmed (the fork called `.trim()` on every text field);\n * - `Date` values are reinterpreted as UTC (the fork used `setUTCMilliseconds`);\n * - arrays and plain objects are normalized recursively;\n * - `Buffer`, `null` and `undefined` are left untouched.\n */\nexport function normalizeFirebirdResult(\n    value: unknown,\n    trimStringResults: boolean,\n    utcDates: boolean,\n): unknown {\n    if (value === undefined || value === null) {\n        return value;\n    }\n\n    if (typeof value === \"string\" || value instanceof String) {\n        return trimStringResults ? String(value).trim() : value;\n    }\n\n    if (Array.isArray(value)) {\n        return value.map((item) => normalizeFirebirdResult(item, trimStringResults, utcDates));\n    }\n\n    if (value instanceof Date) {\n        return utcDates ? toUtcDate(value) : value;\n    }\n\n    if (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] = normalizeFirebirdResult(source[key], trimStringResults, utcDates);\n            return normalized;\n        }, {});\n    }\n\n    return value;\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        utcDates,\n        ...baseOptions\n    } = compatibilityOptions;\n\n    const normalizedOptions: FirebirdOptions = {\n        ...baseOptions,\n        pluginName: normalizeAuthPlugin(compatibilityOptions.pluginName),\n        trimStringResults,\n        utcDates,\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

@@ -20,5 +20,6 @@ export * from "./accessi-module";
 export * from "./allegati-module";
 export * from "node-firebird";
 export { autobind, ExecutionTimeLogger, Logger, LogLevels, Orm, DateUtilities, RestUtilities, DatabaseUtilities, DatabaseUpdater, StatusCode, DocumentGenerator, Firebird };
-export * from "./swagger/SwaggerConfig";
+export * from "./openapi/OpenApiConfig";
+export * from "./openapi/OpenApiMerge";
 export * from "./initEmilsoftwareModule";

package/dist/index.js

@@ -71,6 +71,7 @@ __exportStar(require("./accessi-module"), exports);
 __exportStar(require("./allegati-module"), exports);
 __exportStar(require("node-firebird"), exports);
 // Unified module exports
-__exportStar(require("./swagger/SwaggerConfig"), exports);
+__exportStar(require("./openapi/OpenApiConfig"), exports);
+__exportStar(require("./openapi/OpenApiMerge"), exports);
 __exportStar(require("./initEmilsoftwareModule"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"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"]}
+{"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,yDAAuC;AACvC,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 \"./openapi/OpenApiConfig\";\nexport * from \"./openapi/OpenApiMerge\";\nexport * from \"./initEmilsoftwareModule\";\n"]}

package/dist/initEmilsoftwareModule.d.ts

@@ -1,8 +1,18 @@
 import { Application } from "express";
+import type { INestApplication } from "@nestjs/common";
+import type { OpenAPIObject } from "@nestjs/swagger";
 import { EmilsoftwareOptions } from "./EmilsoftwareModule";
+/** Esito del bootstrap del modulo unificato. */
+export interface EmilsoftwareModuleInitializationResult {
+    /** Sotto-app Nest che serve Accessi, Allegati e la documentazione. */
+    nestApp: INestApplication;
+    /** Documento OpenAPI generato, mergiabile nel documento unico dell'host. */
+    document: OpenAPIObject;
+}
 /**
  * Initializes the unified module that combines Accessi and Allegati functionality
  * @param app Express application instance
  * @param options Configuration options for both modules
+ * @returns Il sotto-app Nest e il documento OpenAPI generato.
  */
-export declare function initEmilsoftwareModule(app: Application, options: EmilsoftwareOptions): Promise<void>;
+export declare function initEmilsoftwareModule(app: Application, options: EmilsoftwareOptions): Promise<EmilsoftwareModuleInitializationResult>;

package/dist/initEmilsoftwareModule.js

@@ -16,7 +16,7 @@ exports.initEmilsoftwareModule = initEmilsoftwareModule;
 const express_1 = __importDefault(require("express"));
 const core_1 = require("@nestjs/core");
 const platform_express_1 = require("@nestjs/platform-express");
-const SwaggerConfig_1 = require("./swagger/SwaggerConfig");
+const OpenApiConfig_1 = require("./openapi/OpenApiConfig");
 const Logger_1 = require("./Logger");
 const EmilsoftwareModule_1 = require("./EmilsoftwareModule");
 const authenticateGen_1 = require("./accessi-module/middleware/authenticateGen");
@@ -28,10 +28,11 @@ const AccessiHttpExceptionFilter_1 = require("./accessi-module/security/AccessiH
  * Initializes the unified module that combines Accessi and Allegati functionality
  * @param app Express application instance
  * @param options Configuration options for both modules
+ * @returns Il sotto-app Nest e il documento OpenAPI generato.
  */
 function initEmilsoftwareModule(app, options) {
     return __awaiter(this, void 0, void 0, function* () {
-        var _a, _b, _c, _d, _e, _f;
+        var _a;
         const logger = new Logger_1.Logger(initEmilsoftwareModule.name);
         if (options === null || options === void 0 ? void 0 : options.accessiOptions) {
             (0, authenticateGen_1.beginAccessiAuthInitialization)();
@@ -42,19 +43,12 @@ function initEmilsoftwareModule(app, options) {
             // Prefisso OpenAPI configurabile (default `accessi/openapi`), cosi' piu'
             // documentazioni possono convivere (backend su `/openapi`, moduli sotto
             // `/<modulo>/openapi`).
-            const swaggerPath = ((_b = (_a = options === null || options === void 0 ? void 0 : options.swagger) === null || _a === void 0 ? void 0 : _a.swaggerPath) !== null && _b !== void 0 ? _b : "accessi/openapi").replace(/^\/+|\/+$/g, "");
-            const swaggerJsonPath = ((_d = (_c = options === null || options === void 0 ? void 0 : options.swagger) === null || _c === void 0 ? void 0 : _c.swaggerJsonPath) !== null && _d !== void 0 ? _d : `${swaggerPath}.json`).replace(/^\/+/, "");
-            const legacySwaggerJsonPath = `${swaggerPath}-json`;
-            const swaggerRoutePaths = [
-                `/${swaggerPath}`,
-                `/${swaggerPath}/`,
-                `/${swaggerJsonPath}`,
-                `/${legacySwaggerJsonPath}`,
-            ];
+            // Precedenza: EmilsoftwareOptions.openapi > AccessiOptions.openapi > default.
+            const resolvedOpenApi = (0, OpenApiConfig_1.resolveAccessiOpenApiOptions)((_a = options === null || options === void 0 ? void 0 : options.accessiOptions) === null || _a === void 0 ? void 0 : _a.openapi, options === null || options === void 0 ? void 0 : options.openapi);
             const nestHostApp = (0, express_1.default)();
             const isNestRoute = (path) => path === "/api" ||
                 path.startsWith("/api/") ||
-                swaggerRoutePaths.some((routePath) => path === routePath || path.startsWith(`${routePath.replace(/\/$/, "")}/`));
+                (0, OpenApiConfig_1.isOpenApiRequestPath)(path, resolvedOpenApi);
             app.use((req, res, next) => {
                 if (!isNestRoute(req.path)) {
                     return next();
@@ -62,9 +56,7 @@ function initEmilsoftwareModule(app, options) {
                 return nestHostApp(req, res, next);
             });
             const nestExpressInstance = new platform_express_1.ExpressAdapter(nestHostApp);
-            const nestApp = yield core_1.NestFactory.create(EmilsoftwareModule_1.EmilsoftwareModule.forRoot(options), nestExpressInstance, {
-                bufferLogs: true
-            });
+            const nestApp = yield core_1.NestFactory.create(EmilsoftwareModule_1.EmilsoftwareModule.forRoot(options), nestExpressInstance, Object.assign({ bufferLogs: (options === null || options === void 0 ? void 0 : options.bufferLogs) !== false }, ((options === null || options === void 0 ? void 0 : options.logger) ? { logger: options.logger } : {})));
             nestApp.enableCors();
             if (options === null || options === void 0 ? void 0 : options.accessiOptions) {
                 // Keep the Accessi API contract identical for standalone and unified bootstraps.
@@ -72,23 +64,19 @@ function initEmilsoftwareModule(app, options) {
                 nestApp.useGlobalFilters(new AccessiHttpExceptionFilter_1.AccessiHttpExceptionFilter());
             }
             nestApp.setGlobalPrefix('api', {
-                exclude: [`/${swaggerPath}`, `/${swaggerPath}/(.*)`]
+                exclude: (0, OpenApiConfig_1.buildOpenApiExcludePaths)(resolvedOpenApi)
             });
             // Documentazione OpenAPI del modulo unificato (Accessi + Allegati).
-            (0, SwaggerConfig_1.setupSwagger)(nestApp, {
-                swaggerPath,
-                swaggerJsonPath,
-                title: (_e = options === null || options === void 0 ? void 0 : options.swagger) === null || _e === void 0 ? void 0 : _e.title,
-                description: (_f = options === null || options === void 0 ? void 0 : options.swagger) === null || _f === void 0 ? void 0 : _f.description,
-            });
+            const document = (0, OpenApiConfig_1.setupOpenApi)(nestApp, resolvedOpenApi);
             yield nestApp.init();
             if (options === null || options === void 0 ? void 0 : options.accessiOptions) {
                 const accessiServices = (0, accessiRuntime_1.registerAccessiModuleServices)(app, nestApp);
                 app.locals.accessiAuthService = accessiServices.authenticateGenService;
                 (0, authenticateGen_1.setAccessiAuthService)(accessiServices.authenticateGenService);
-                (0, startupLog_1.logAccessiStartup)(options.accessiOptions);
+                (0, startupLog_1.logAccessiStartup)(options.accessiOptions, resolvedOpenApi);
             }
             logger.info("Emilsoftware module initialized successfully");
+            return { nestApp, document };
         }
         catch (error) {
             if (options === null || options === void 0 ? void 0 : options.accessiOptions) {

package/dist/initEmilsoftwareModule.js.map

@@ -1 +1 @@
-{"version":3,"file":"initEmilsoftwareModule.js","sourceRoot":"","sources":["../src/initEmilsoftwareModule.ts"],"names":[],"mappings":"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","sourcesContent":["import express, { Application, Request } from \"express\";\nimport { NestFactory } from \"@nestjs/core\";\nimport { ExpressAdapter } from \"@nestjs/platform-express\";\nimport { setupSwagger } from \"./swagger/SwaggerConfig\";\nimport { Logger } from \"./Logger\";\nimport { EmilsoftwareModule, EmilsoftwareOptions } from \"./EmilsoftwareModule\";\nimport {\n    beginAccessiAuthInitialization,\n    failAccessiAuthInitialization,\n    setAccessiAuthService\n} from \"./accessi-module/middleware/authenticateGen\";\nimport { registerAccessiModuleServices } from \"./accessi-module/accessiRuntime\";\nimport { logAccessiStartup } from \"./accessi-module/startupLog\";\nimport { createAccessiValidationPipe } from './accessi-module/security/accessiValidation';\nimport { AccessiHttpExceptionFilter } from './accessi-module/security/AccessiHttpExceptionFilter';\n\n/**\n * Initializes the unified module that combines Accessi and Allegati functionality\n * @param app Express application instance\n * @param options Configuration options for both modules\n */\nexport async function initEmilsoftwareModule(app: Application, options: EmilsoftwareOptions) {\n    const logger: Logger = new Logger(initEmilsoftwareModule.name);\n    if (options?.accessiOptions) {\n        beginAccessiAuthInitialization();\n    }\n\n    try {\n        // Isolate Nest on a dedicated Express instance and dispatch only module routes.\n        // This keeps pre-existing routes/middlewares on the host app untouched.\n        // Prefisso OpenAPI configurabile (default `accessi/openapi`), cosi' piu'\n        // documentazioni possono convivere (backend su `/openapi`, moduli sotto\n        // `/<modulo>/openapi`).\n        const swaggerPath = (options?.swagger?.swaggerPath ?? \"accessi/openapi\").replace(/^\\/+|\\/+$/g, \"\");\n        const swaggerJsonPath = (options?.swagger?.swaggerJsonPath ?? `${swaggerPath}.json`).replace(/^\\/+/, \"\");\n        const legacySwaggerJsonPath = `${swaggerPath}-json`;\n        const swaggerRoutePaths = [\n            `/${swaggerPath}`,\n            `/${swaggerPath}/`,\n            `/${swaggerJsonPath}`,\n            `/${legacySwaggerJsonPath}`,\n        ];\n\n        const nestHostApp = express();\n        const isNestRoute = (path: string) =>\n            path === \"/api\" ||\n            path.startsWith(\"/api/\") ||\n            swaggerRoutePaths.some(\n                (routePath) => path === routePath || path.startsWith(`${routePath.replace(/\\/$/, \"\")}/`)\n            );\n\n        app.use((req: Request, res, next) => {\n            if (!isNestRoute(req.path)) {\n                return next();\n            }\n            return nestHostApp(req, res, next);\n        });\n\n        const nestExpressInstance = new ExpressAdapter(nestHostApp);\n        const nestApp = await NestFactory.create(EmilsoftwareModule.forRoot(options), nestExpressInstance, {\n            bufferLogs: true\n        });\n\n        nestApp.enableCors();\n        if (options?.accessiOptions) {\n            // Keep the Accessi API contract identical for standalone and unified bootstraps.\n            nestApp.useGlobalPipes(createAccessiValidationPipe());\n            nestApp.useGlobalFilters(new AccessiHttpExceptionFilter());\n        }\n\n        nestApp.setGlobalPrefix('api', {\n            exclude: [`/${swaggerPath}`, `/${swaggerPath}/(.*)`]\n        });\n\n        // Documentazione OpenAPI del modulo unificato (Accessi + Allegati).\n        setupSwagger(nestApp, {\n            swaggerPath,\n            swaggerJsonPath,\n            title: options?.swagger?.title,\n            description: options?.swagger?.description,\n        });\n\n        await nestApp.init();\n        if (options?.accessiOptions) {\n            const accessiServices = registerAccessiModuleServices(app, nestApp);\n            app.locals.accessiAuthService = accessiServices.authenticateGenService;\n            setAccessiAuthService(accessiServices.authenticateGenService);\n            logAccessiStartup(options.accessiOptions);\n        }\n\n        logger.info(\"Emilsoftware module initialized successfully\");\n\n    } catch (error) {\n        if (options?.accessiOptions) {\n            failAccessiAuthInitialization(error);\n        }\n        logger.error(\"Error initializing Emilsoftware Module:\", error);\n        throw error;\n    }\n}\n"]}
+{"version":3,"file":"initEmilsoftwareModule.js","sourceRoot":"","sources":["../src/initEmilsoftwareModule.ts"],"names":[],"mappings":"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","sourcesContent":["import express, { Application, Request } from \"express\";\nimport { NestFactory } from \"@nestjs/core\";\nimport { ExpressAdapter } from \"@nestjs/platform-express\";\nimport type { INestApplication } from \"@nestjs/common\";\nimport type { OpenAPIObject } from \"@nestjs/swagger\";\nimport {\n    buildOpenApiExcludePaths,\n    isOpenApiRequestPath,\n    resolveAccessiOpenApiOptions,\n    setupOpenApi\n} from \"./openapi/OpenApiConfig\";\nimport { Logger } from \"./Logger\";\nimport { EmilsoftwareModule, EmilsoftwareOptions } from \"./EmilsoftwareModule\";\nimport {\n    beginAccessiAuthInitialization,\n    failAccessiAuthInitialization,\n    setAccessiAuthService\n} from \"./accessi-module/middleware/authenticateGen\";\nimport { registerAccessiModuleServices } from \"./accessi-module/accessiRuntime\";\nimport { logAccessiStartup } from \"./accessi-module/startupLog\";\nimport { createAccessiValidationPipe } from './accessi-module/security/accessiValidation';\nimport { AccessiHttpExceptionFilter } from './accessi-module/security/AccessiHttpExceptionFilter';\n\n/** Esito del bootstrap del modulo unificato. */\nexport interface EmilsoftwareModuleInitializationResult {\n    /** Sotto-app Nest che serve Accessi, Allegati e la documentazione. */\n    nestApp: INestApplication;\n    /** Documento OpenAPI generato, mergiabile nel documento unico dell'host. */\n    document: OpenAPIObject;\n}\n\n/**\n * Initializes the unified module that combines Accessi and Allegati functionality\n * @param app Express application instance\n * @param options Configuration options for both modules\n * @returns Il sotto-app Nest e il documento OpenAPI generato.\n */\nexport async function initEmilsoftwareModule(\n    app: Application,\n    options: EmilsoftwareOptions\n): Promise<EmilsoftwareModuleInitializationResult> {\n    const logger: Logger = new Logger(initEmilsoftwareModule.name);\n    if (options?.accessiOptions) {\n        beginAccessiAuthInitialization();\n    }\n\n    try {\n        // Isolate Nest on a dedicated Express instance and dispatch only module routes.\n        // This keeps pre-existing routes/middlewares on the host app untouched.\n        // Prefisso OpenAPI configurabile (default `accessi/openapi`), cosi' piu'\n        // documentazioni possono convivere (backend su `/openapi`, moduli sotto\n        // `/<modulo>/openapi`).\n        // Precedenza: EmilsoftwareOptions.openapi > AccessiOptions.openapi > default.\n        const resolvedOpenApi = resolveAccessiOpenApiOptions(\n            options?.accessiOptions?.openapi,\n            options?.openapi\n        );\n\n        const nestHostApp = express();\n        const isNestRoute = (path: string) =>\n            path === \"/api\" ||\n            path.startsWith(\"/api/\") ||\n            isOpenApiRequestPath(path, resolvedOpenApi);\n\n        app.use((req: Request, res, next) => {\n            if (!isNestRoute(req.path)) {\n                return next();\n            }\n            return nestHostApp(req, res, next);\n        });\n\n        const nestExpressInstance = new ExpressAdapter(nestHostApp);\n        const nestApp = await NestFactory.create(EmilsoftwareModule.forRoot(options), nestExpressInstance, {\n            bufferLogs: options?.bufferLogs !== false,\n            ...(options?.logger ? { logger: options.logger } : {})\n        });\n\n        nestApp.enableCors();\n        if (options?.accessiOptions) {\n            // Keep the Accessi API contract identical for standalone and unified bootstraps.\n            nestApp.useGlobalPipes(createAccessiValidationPipe());\n            nestApp.useGlobalFilters(new AccessiHttpExceptionFilter());\n        }\n\n        nestApp.setGlobalPrefix('api', {\n            exclude: buildOpenApiExcludePaths(resolvedOpenApi)\n        });\n\n        // Documentazione OpenAPI del modulo unificato (Accessi + Allegati).\n        const document = setupOpenApi(nestApp, resolvedOpenApi);\n\n        await nestApp.init();\n        if (options?.accessiOptions) {\n            const accessiServices = registerAccessiModuleServices(app, nestApp);\n            app.locals.accessiAuthService = accessiServices.authenticateGenService;\n            setAccessiAuthService(accessiServices.authenticateGenService);\n            logAccessiStartup(options.accessiOptions, resolvedOpenApi);\n        }\n\n        logger.info(\"Emilsoftware module initialized successfully\");\n\n        return { nestApp, document };\n    } catch (error) {\n        if (options?.accessiOptions) {\n            failAccessiAuthInitialization(error);\n        }\n        logger.error(\"Error initializing Emilsoftware Module:\", error);\n        throw error;\n    }\n}\n"]}

package/dist/openapi/OpenApiConfig.d.ts

@@ -0,0 +1,68 @@
+import { INestApplication } from "@nestjs/common";
+import type { OpenAPIObject } from "@nestjs/swagger";
+/**
+ * Opzioni di setup della documentazione OpenAPI.
+ *
+ * `enabled: false` disabilita UI e JSON ma non il documento generato, che resta
+ * disponibile al chiamante per essere mergiato nel documento OpenAPI dell'host.
+ */
+export type OpenApiSetupOptions = {
+    enabled?: boolean;
+    openApiPath?: string;
+    openApiJsonPath?: string;
+    title?: string;
+    description?: string;
+    /** Callback invocata subito dopo la generazione del documento OpenAPI. */
+    onDocument?: (document: OpenAPIObject) => void;
+};
+/** Opzioni OpenAPI risolte: nessun campo opzionale salvo il callback. */
+export interface ResolvedOpenApiSetupOptions {
+    enabled: boolean;
+    openApiPath: string;
+    openApiJsonPath: string;
+    title: string;
+    description: string;
+    onDocument?: (document: OpenAPIObject) => void;
+}
+/**
+ * Default storici della documentazione Accessi.
+ *
+ * I consumer esistenti non devono cambiare comportamento: senza override la UI
+ * resta su `accessi/openapi` e la spec su `accessi/openapi.json`.
+ */
+export declare const DEFAULT_ACCESSI_OPENAPI: {
+    readonly enabled: true;
+    readonly openApiPath: "accessi/openapi";
+    readonly openApiJsonPath: "accessi/openapi.json";
+    readonly title: "Accessi API Documentation";
+    readonly description: "API del modulo accessi";
+};
+/**
+ * Risolve i default e i vari livelli di override in un'unica configurazione.
+ *
+ * L'ordine dei livelli e esplicito: i parametri successivi vincono sui precedenti.
+ */
+export declare function resolveOpenApiSetupOptions(defaults?: OpenApiSetupOptions, ...overrides: Array<OpenApiSetupOptions | undefined>): ResolvedOpenApiSetupOptions;
+/**
+ * Risolve la configurazione OpenAPI di Accessi.
+ *
+ * I livelli successivi vincono sui precedenti, quindi la variante unificata puo
+ * usare `resolveAccessiOpenApiOptions(accessiOptions.openapi, emilsoftwareOptions.openapi)`.
+ */
+export declare function resolveAccessiOpenApiOptions(...overrides: Array<OpenApiSetupOptions | undefined>): ResolvedOpenApiSetupOptions;
+/**
+ * Path da passare a `setGlobalPrefix` per escludere la documentazione.
+ *
+ * Usa la sintassi wildcard di path-to-regexp v8 (`{*path}`) per evitare il
+ * LegacyRouteConverter warning di Nest.
+ */
+export declare function buildOpenApiExcludePaths(options: ResolvedOpenApiSetupOptions): string[];
+/** True se il path Express appartiene alla documentazione OpenAPI configurata. */
+export declare function isOpenApiRequestPath(path: string, options: ResolvedOpenApiSetupOptions): boolean;
+/**
+ * Genera il documento OpenAPI e, se `enabled` non e false, monta UI e JSON.
+ *
+ * Il documento viene sempre restituito: questo permette all'host di mergiarlo
+ * nel proprio documento unico anche quando la UI del modulo e disabilitata.
+ */
+export declare function setupOpenApi(app: INestApplication, options?: OpenApiSetupOptions): OpenAPIObject;

package/dist/openapi/OpenApiConfig.js

@@ -0,0 +1,157 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_ACCESSI_OPENAPI = void 0;
+exports.resolveOpenApiSetupOptions = resolveOpenApiSetupOptions;
+exports.resolveAccessiOpenApiOptions = resolveAccessiOpenApiOptions;
+exports.buildOpenApiExcludePaths = buildOpenApiExcludePaths;
+exports.isOpenApiRequestPath = isOpenApiRequestPath;
+exports.setupOpenApi = setupOpenApi;
+const swagger_1 = require("@nestjs/swagger");
+const Logger_1 = require("../Logger");
+/**
+ * Default storici della documentazione Accessi.
+ *
+ * I consumer esistenti non devono cambiare comportamento: senza override la UI
+ * resta su `accessi/openapi` e la spec su `accessi/openapi.json`.
+ */
+exports.DEFAULT_ACCESSI_OPENAPI = {
+    enabled: true,
+    openApiPath: "accessi/openapi",
+    openApiJsonPath: "accessi/openapi.json",
+    title: "Accessi API Documentation",
+    description: "API del modulo accessi",
+};
+/** Default del setup OpenAPI generico (usato direttamente da `setupOpenApi`). */
+const DEFAULT_OPENAPI_SETUP = {
+    enabled: true,
+    openApiPath: "openapi",
+    openApiJsonPath: "openapi.json",
+    title: "API Documentation",
+    description: "API per la gestione di accessi utenti e allegati",
+};
+function normalizeOpenApiPath(value) {
+    return value.replace(/^\/+|\/+$/g, "");
+}
+function normalizeOpenApiJsonPath(value) {
+    return value.replace(/^\/+|\/+$/g, "");
+}
+/**
+ * Unisce i livelli di configurazione ignorando le proprieta `undefined`.
+ *
+ * A differenza dello spread semplice, un `{ openApiPath: undefined }` esplicito
+ * non cancella il default del livello precedente.
+ */
+function mergeOpenApiSetupOptions(defaults, ...overrides) {
+    const merged = Object.assign({}, defaults);
+    for (const override of overrides) {
+        if (!override)
+            continue;
+        if (override.enabled !== undefined)
+            merged.enabled = override.enabled;
+        if (override.openApiPath !== undefined)
+            merged.openApiPath = override.openApiPath;
+        if (override.openApiJsonPath !== undefined)
+            merged.openApiJsonPath = override.openApiJsonPath;
+        if (override.title !== undefined)
+            merged.title = override.title;
+        if (override.description !== undefined)
+            merged.description = override.description;
+        if (override.onDocument !== undefined)
+            merged.onDocument = override.onDocument;
+    }
+    return merged;
+}
+/**
+ * Risolve i default e i vari livelli di override in un'unica configurazione.
+ *
+ * L'ordine dei livelli e esplicito: i parametri successivi vincono sui precedenti.
+ */
+function resolveOpenApiSetupOptions(defaults = DEFAULT_OPENAPI_SETUP, ...overrides) {
+    var _a, _b, _c, _d, _e, _f;
+    const merged = mergeOpenApiSetupOptions(defaults, ...overrides);
+    const defaultOpenApiPath = normalizeOpenApiPath((_a = defaults.openApiPath) !== null && _a !== void 0 ? _a : "openapi") || "openapi";
+    const openApiPath = normalizeOpenApiPath((_b = merged.openApiPath) !== null && _b !== void 0 ? _b : defaultOpenApiPath) || defaultOpenApiPath;
+    // Storico: se si cambia solo `openApiPath`, il JSON segue il nuovo path
+    // (`<path>.json`). Un `openApiJsonPath` esplicito in un override vince sempre.
+    const explicitJsonPath = (_c = [...overrides]
+        .reverse()
+        .find((override) => (override === null || override === void 0 ? void 0 : override.openApiJsonPath) !== undefined)) === null || _c === void 0 ? void 0 : _c.openApiJsonPath;
+    const hasOverrides = overrides.some((override) => override !== undefined);
+    const jsonPathCandidate = explicitJsonPath !== null && explicitJsonPath !== void 0 ? explicitJsonPath : (hasOverrides ? `${openApiPath}.json` : ((_d = merged.openApiJsonPath) !== null && _d !== void 0 ? _d : `${openApiPath}.json`));
+    const openApiJsonPath = normalizeOpenApiJsonPath(jsonPathCandidate) || `${openApiPath}.json`;
+    return Object.assign({ enabled: merged.enabled !== false, openApiPath,
+        openApiJsonPath, title: (_e = merged.title) !== null && _e !== void 0 ? _e : "API Documentation", description: (_f = merged.description) !== null && _f !== void 0 ? _f : "API per la gestione di accessi utenti e allegati" }, (merged.onDocument ? { onDocument: merged.onDocument } : {}));
+}
+/**
+ * Risolve la configurazione OpenAPI di Accessi.
+ *
+ * I livelli successivi vincono sui precedenti, quindi la variante unificata puo
+ * usare `resolveAccessiOpenApiOptions(accessiOptions.openapi, emilsoftwareOptions.openapi)`.
+ */
+function resolveAccessiOpenApiOptions(...overrides) {
+    return resolveOpenApiSetupOptions(exports.DEFAULT_ACCESSI_OPENAPI, ...overrides);
+}
+/**
+ * Path da passare a `setGlobalPrefix` per escludere la documentazione.
+ *
+ * Usa la sintassi wildcard di path-to-regexp v8 (`{*path}`) per evitare il
+ * LegacyRouteConverter warning di Nest.
+ */
+function buildOpenApiExcludePaths(options) {
+    if (!options.enabled)
+        return [];
+    return [`/${options.openApiPath}`, `/${options.openApiPath}/{*path}`];
+}
+/** True se il path Express appartiene alla documentazione OpenAPI configurata. */
+function isOpenApiRequestPath(path, options) {
+    if (!options.enabled)
+        return false;
+    const uiPath = `/${options.openApiPath}`;
+    if (path === uiPath || path.startsWith(`${uiPath}/`))
+        return true;
+    return path === `/${options.openApiJsonPath}` || path === `/${options.openApiPath}-json`;
+}
+/**
+ * Genera il documento OpenAPI e, se `enabled` non e false, monta UI e JSON.
+ *
+ * Il documento viene sempre restituito: questo permette all'host di mergiarlo
+ * nel proprio documento unico anche quando la UI del modulo e disabilitata.
+ */
+function setupOpenApi(app, options) {
+    var _a, _b, _c;
+    const logger = new Logger_1.Logger("OpenApiConfig");
+    const resolved = resolveOpenApiSetupOptions(DEFAULT_OPENAPI_SETUP, options);
+    const config = new swagger_1.DocumentBuilder()
+        .setTitle(resolved.title)
+        .setDescription(resolved.description)
+        .setVersion("1.0")
+        .addBearerAuth() // Per abilitare l'autenticazione JWT
+        .build();
+    const document = swagger_1.SwaggerModule.createDocument(app, config);
+    (_a = resolved.onDocument) === null || _a === void 0 ? void 0 : _a.call(resolved, document);
+    if (!resolved.enabled) {
+        logger.info("OpenAPI disabilitato: UI e JSON non montati.");
+        return document;
+    }
+    swagger_1.SwaggerModule.setup(resolved.openApiPath, app, document);
+    app.use(`/${resolved.openApiJsonPath}`, (_req, res) => {
+        res.setHeader("Content-Type", "application/json");
+        res.send(document);
+    });
+    // Manteniamo l'alias storico `<path>-json` per non rompere i consumer esistenti.
+    const legacyOpenApiJsonPath = `${resolved.openApiPath}-json`;
+    if (legacyOpenApiJsonPath !== resolved.openApiJsonPath) {
+        app.use(`/${legacyOpenApiJsonPath}`, (_req, res) => {
+            res.setHeader("Content-Type", "application/json");
+            res.send(document);
+        });
+    }
+    const serverAddress = (_c = (_b = app.getHttpServer()) === null || _b === void 0 ? void 0 : _b.address) === null || _c === void 0 ? void 0 : _c.call(_b);
+    const port = serverAddress && typeof serverAddress === "object"
+        ? serverAddress.port
+        : 3000;
+    logger.info(`OpenAPI documentation available at: http://localhost:${port}/${resolved.openApiPath}`);
+    logger.info(`OpenAPI JSON available at: http://localhost:${port}/${resolved.openApiJsonPath}`);
+    return document;
+}
+//# sourceMappingURL=OpenApiConfig.js.map

package/dist/openapi/OpenApiConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenApiConfig.js","sourceRoot":"","sources":["../../src/openapi/OpenApiConfig.ts"],"names":[],"mappings":"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","sourcesContent":["import { INestApplication } from \"@nestjs/common\";\nimport { DocumentBuilder, SwaggerModule } from \"@nestjs/swagger\";\nimport type { OpenAPIObject } from \"@nestjs/swagger\";\nimport { Request, Response } from \"express\";\nimport { AddressInfo } from \"net\";\nimport { Logger } from \"../Logger\";\n\n/**\n * Opzioni di setup della documentazione OpenAPI.\n *\n * `enabled: false` disabilita UI e JSON ma non il documento generato, che resta\n * disponibile al chiamante per essere mergiato nel documento OpenAPI dell'host.\n */\nexport type OpenApiSetupOptions = {\n    enabled?: boolean;\n    openApiPath?: string;\n    openApiJsonPath?: string;\n    title?: string;\n    description?: string;\n    /** Callback invocata subito dopo la generazione del documento OpenAPI. */\n    onDocument?: (document: OpenAPIObject) => void;\n};\n\n/** Opzioni OpenAPI risolte: nessun campo opzionale salvo il callback. */\nexport interface ResolvedOpenApiSetupOptions {\n    enabled: boolean;\n    openApiPath: string;\n    openApiJsonPath: string;\n    title: string;\n    description: string;\n    onDocument?: (document: OpenAPIObject) => void;\n}\n\n/**\n * Default storici della documentazione Accessi.\n *\n * I consumer esistenti non devono cambiare comportamento: senza override la UI\n * resta su `accessi/openapi` e la spec su `accessi/openapi.json`.\n */\nexport const DEFAULT_ACCESSI_OPENAPI = {\n    enabled: true,\n    openApiPath: \"accessi/openapi\",\n    openApiJsonPath: \"accessi/openapi.json\",\n    title: \"Accessi API Documentation\",\n    description: \"API del modulo accessi\",\n} as const satisfies ResolvedOpenApiSetupOptions;\n\n/** Default del setup OpenAPI generico (usato direttamente da `setupOpenApi`). */\nconst DEFAULT_OPENAPI_SETUP = {\n    enabled: true,\n    openApiPath: \"openapi\",\n    openApiJsonPath: \"openapi.json\",\n    title: \"API Documentation\",\n    description: \"API per la gestione di accessi utenti e allegati\",\n} as const satisfies ResolvedOpenApiSetupOptions;\n\nfunction normalizeOpenApiPath(value: string): string {\n    return value.replace(/^\\/+|\\/+$/g, \"\");\n}\n\nfunction normalizeOpenApiJsonPath(value: string): string {\n    return value.replace(/^\\/+|\\/+$/g, \"\");\n}\n\n/**\n * Unisce i livelli di configurazione ignorando le proprieta `undefined`.\n *\n * A differenza dello spread semplice, un `{ openApiPath: undefined }` esplicito\n * non cancella il default del livello precedente.\n */\nfunction mergeOpenApiSetupOptions(\n    defaults: OpenApiSetupOptions,\n    ...overrides: Array<OpenApiSetupOptions | undefined>\n): OpenApiSetupOptions {\n    const merged: OpenApiSetupOptions = { ...defaults };\n    for (const override of overrides) {\n        if (!override) continue;\n        if (override.enabled !== undefined) merged.enabled = override.enabled;\n        if (override.openApiPath !== undefined) merged.openApiPath = override.openApiPath;\n        if (override.openApiJsonPath !== undefined) merged.openApiJsonPath = override.openApiJsonPath;\n        if (override.title !== undefined) merged.title = override.title;\n        if (override.description !== undefined) merged.description = override.description;\n        if (override.onDocument !== undefined) merged.onDocument = override.onDocument;\n    }\n    return merged;\n}\n\n/**\n * Risolve i default e i vari livelli di override in un'unica configurazione.\n *\n * L'ordine dei livelli e esplicito: i parametri successivi vincono sui precedenti.\n */\nexport function resolveOpenApiSetupOptions(\n    defaults: OpenApiSetupOptions = DEFAULT_OPENAPI_SETUP,\n    ...overrides: Array<OpenApiSetupOptions | undefined>\n): ResolvedOpenApiSetupOptions {\n    const merged = mergeOpenApiSetupOptions(defaults, ...overrides);\n    const defaultOpenApiPath = normalizeOpenApiPath(defaults.openApiPath ?? \"openapi\") || \"openapi\";\n    const openApiPath = normalizeOpenApiPath(merged.openApiPath ?? defaultOpenApiPath) || defaultOpenApiPath;\n\n    // Storico: se si cambia solo `openApiPath`, il JSON segue il nuovo path\n    // (`<path>.json`). Un `openApiJsonPath` esplicito in un override vince sempre.\n    const explicitJsonPath = [...overrides]\n        .reverse()\n        .find((override) => override?.openApiJsonPath !== undefined)\n        ?.openApiJsonPath;\n    const hasOverrides = overrides.some((override) => override !== undefined);\n    const jsonPathCandidate = explicitJsonPath\n        ?? (hasOverrides ? `${openApiPath}.json` : (merged.openApiJsonPath ?? `${openApiPath}.json`));\n    const openApiJsonPath = normalizeOpenApiJsonPath(jsonPathCandidate) || `${openApiPath}.json`;\n\n    return {\n        enabled: merged.enabled !== false,\n        openApiPath,\n        openApiJsonPath,\n        title: merged.title ?? \"API Documentation\",\n        description: merged.description ?? \"API per la gestione di accessi utenti e allegati\",\n        ...(merged.onDocument ? { onDocument: merged.onDocument } : {}),\n    };\n}\n\n/**\n * Risolve la configurazione OpenAPI di Accessi.\n *\n * I livelli successivi vincono sui precedenti, quindi la variante unificata puo\n * usare `resolveAccessiOpenApiOptions(accessiOptions.openapi, emilsoftwareOptions.openapi)`.\n */\nexport function resolveAccessiOpenApiOptions(\n    ...overrides: Array<OpenApiSetupOptions | undefined>\n): ResolvedOpenApiSetupOptions {\n    return resolveOpenApiSetupOptions(DEFAULT_ACCESSI_OPENAPI, ...overrides);\n}\n\n/**\n * Path da passare a `setGlobalPrefix` per escludere la documentazione.\n *\n * Usa la sintassi wildcard di path-to-regexp v8 (`{*path}`) per evitare il\n * LegacyRouteConverter warning di Nest.\n */\nexport function buildOpenApiExcludePaths(options: ResolvedOpenApiSetupOptions): string[] {\n    if (!options.enabled) return [];\n    return [`/${options.openApiPath}`, `/${options.openApiPath}/{*path}`];\n}\n\n/** True se il path Express appartiene alla documentazione OpenAPI configurata. */\nexport function isOpenApiRequestPath(path: string, options: ResolvedOpenApiSetupOptions): boolean {\n    if (!options.enabled) return false;\n\n    const uiPath = `/${options.openApiPath}`;\n    if (path === uiPath || path.startsWith(`${uiPath}/`)) return true;\n\n    return path === `/${options.openApiJsonPath}` || path === `/${options.openApiPath}-json`;\n}\n\n/**\n * Genera il documento OpenAPI e, se `enabled` non e false, monta UI e JSON.\n *\n * Il documento viene sempre restituito: questo permette all'host di mergiarlo\n * nel proprio documento unico anche quando la UI del modulo e disabilitata.\n */\nexport function setupOpenApi(app: INestApplication, options?: OpenApiSetupOptions): OpenAPIObject {\n    const logger: Logger = new Logger(\"OpenApiConfig\");\n    const resolved = resolveOpenApiSetupOptions(DEFAULT_OPENAPI_SETUP, options);\n\n    const config = new DocumentBuilder()\n        .setTitle(resolved.title)\n        .setDescription(resolved.description)\n        .setVersion(\"1.0\")\n        .addBearerAuth() // Per abilitare l'autenticazione JWT\n        .build();\n\n    const document = SwaggerModule.createDocument(app, config);\n    resolved.onDocument?.(document);\n\n    if (!resolved.enabled) {\n        logger.info(\"OpenAPI disabilitato: UI e JSON non montati.\");\n        return document;\n    }\n\n    SwaggerModule.setup(resolved.openApiPath, app, document);\n\n    app.use(`/${resolved.openApiJsonPath}`, (_req: Request, res: Response) => {\n        res.setHeader(\"Content-Type\", \"application/json\");\n        res.send(document);\n    });\n\n    // Manteniamo l'alias storico `<path>-json` per non rompere i consumer esistenti.\n    const legacyOpenApiJsonPath = `${resolved.openApiPath}-json`;\n    if (legacyOpenApiJsonPath !== resolved.openApiJsonPath) {\n        app.use(`/${legacyOpenApiJsonPath}`, (_req: Request, res: Response) => {\n            res.setHeader(\"Content-Type\", \"application/json\");\n            res.send(document);\n        });\n    }\n\n    const serverAddress = app.getHttpServer()?.address?.();\n    const port = serverAddress && typeof serverAddress === \"object\"\n        ? (serverAddress as AddressInfo).port\n        : 3000;\n\n    logger.info(\n        `OpenAPI documentation available at: http://localhost:${port}/${resolved.openApiPath}`\n    );\n    logger.info(\n        `OpenAPI JSON available at: http://localhost:${port}/${resolved.openApiJsonPath}`\n    );\n\n    return document;\n}\n"]}

package/dist/openapi/OpenApiMerge.d.ts

@@ -0,0 +1,15 @@
+import type { OpenAPIObject } from "@nestjs/swagger";
+/** Politica di risoluzione quando due documenti definiscono la stessa chiave. */
+export type OpenApiMergeConflictPolicy = "error" | "keep" | "overwrite";
+export interface MergeOpenApiOptions {
+    /** Default: `error`. */
+    conflict?: OpenApiMergeConflictPolicy;
+}
+/**
+ * Unisce il documento Accessi nel documento OpenAPI dell'host.
+ *
+ * Per default un conflitto su path, schema o security scheme produce errore:
+ * e meglio accorgersi subito di due contratti incompatibili. Usare
+ * `conflict: "overwrite"` solo quando il documento host deve vincere.
+ */
+export declare function mergeOpenApiDocuments(target: OpenAPIObject, source: OpenAPIObject, options?: MergeOpenApiOptions): OpenAPIObject;