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

package/dist/firebird-compat.d.ts

@@ -11,6 +11,19 @@ export type FirebirdOptions = Options & {
     compatibilityTotalTimeoutMs?: number;
     firebirdDriver?: FirebirdDriverStrategy;
     trimStringResults?: boolean;
+    /**
+     * When `true`, query parameters are interpolated into the logged SQL. Off by
+     * default so that secrets, credentials and personal data are not written to
+     * the console or to the daily log files.
+     */
+    logQueryParameters?: boolean;
+    /**
+     * When greater than zero, enables an opt-in connection pool of the given
+     * maximum size for this connection target instead of attaching/detaching a
+     * physical connection for every query. Default `0` keeps the historic
+     * one-connection-per-query behaviour.
+     */
+    poolSize?: number;
 };
 type FirebirdErrorContext = {
     stage: "attach" | "query" | "execute" | "transaction";

package/dist/firebird-compat.js

@@ -109,10 +109,11 @@ function uniqueDiagnostics(values) {
     return values.filter((value, index) => values.indexOf(value) === index);
 }
 function buildDiagnostics(message, options) {
+    var _a;
     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]
+        const supportedPlugins = ((_a = pluginMismatch[2]) !== null && _a !== void 0 ? _a : "")
             .split(",")
             .map((plugin) => plugin.trim())
             .filter((plugin) => plugin.length > 0);
@@ -172,7 +173,7 @@ function formatFirebirdMetadata(source) {
 function normalizeFirebirdOptions(options) {
     var _a, _b;
     const compatibilityOptions = options;
-    const { authPlugins: _authPlugins, compatibilityProbeTimeoutMs: _compatibilityProbeTimeoutMs, compatibilityTotalTimeoutMs, connectTimeoutMs, firebirdDriver: _firebirdDriver, trimStringResults } = compatibilityOptions, baseOptions = __rest(compatibilityOptions, ["authPlugins", "compatibilityProbeTimeoutMs", "compatibilityTotalTimeoutMs", "connectTimeoutMs", "firebirdDriver", "trimStringResults"]);
+    const { authPlugins: _authPlugins, compatibilityProbeTimeoutMs: _compatibilityProbeTimeoutMs, compatibilityTotalTimeoutMs, connectTimeoutMs, firebirdDriver: _firebirdDriver, logQueryParameters: _logQueryParameters, poolSize: _poolSize, trimStringResults } = compatibilityOptions, baseOptions = __rest(compatibilityOptions, ["authPlugins", "compatibilityProbeTimeoutMs", "compatibilityTotalTimeoutMs", "connectTimeoutMs", "firebirdDriver", "logQueryParameters", "poolSize", "trimStringResults"]);
     const normalizedOptions = Object.assign(Object.assign({}, baseOptions), { pluginName: normalizeAuthPlugin(compatibilityOptions.pluginName), trimStringResults, wireCrypt: normalizeWireCryptMode(compatibilityOptions.wireCrypt) });
     const timeoutCandidate = (_b = (_a = compatibilityOptions.connectTimeout) !== null && _a !== void 0 ? _a : connectTimeoutMs) !== null && _b !== void 0 ? _b : compatibilityTotalTimeoutMs;
     if (Number.isFinite(timeoutCandidate) && Number(timeoutCandidate) > 0) {

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\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        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`, query parameters are interpolated into the logged SQL. Off by\n     * default so that secrets, credentials and personal data are not written to\n     * the console or to the daily log files.\n     */\n    logQueryParameters?: boolean;\n    /**\n     * When greater than zero, enables an opt-in connection pool of the given\n     * maximum size for this connection target instead of attaching/detaching a\n     * physical connection for every query. Default `0` keeps the historic\n     * one-connection-per-query behaviour.\n     */\n    poolSize?: number;\n};\n\ntype FirebirdErrorContext = {\n    stage: \"attach\" | \"query\" | \"execute\" | \"transaction\";\n    sql?: string;\n};\n\ntype EnhancedFirebirdError = Error & {\n    cause?: unknown;\n    gdscode?: number;\n    gdsparams?: unknown;\n    __emilsoftwareFirebirdEnhanced?: boolean;\n};\n\nfunction isBlank(value: unknown): boolean {\n    return value === undefined || value === null || (typeof value === \"string\" && value.trim() === \"\");\n}\n\nfunction normalizeWireCryptMode(value: FirebirdOptions[\"wireCrypt\"]): number | undefined {\n    if (isBlank(value)) {\n        return undefined;\n    }\n\n    if (typeof value === \"number\") {\n        return value;\n    }\n\n    const normalized = String(value).trim().toLowerCase();\n    if (normalized === \"disabled\") {\n        return Firebird.WIRE_CRYPT_DISABLE;\n    }\n\n    return Firebird.WIRE_CRYPT_ENABLE;\n}\n\nfunction normalizeAuthPlugin(value: unknown): FirebirdAuthPlugin | undefined {\n    if (isBlank(value)) {\n        return undefined;\n    }\n\n    const normalized = String(value).trim().toLowerCase();\n    if (normalized === \"legacy\" || normalized === \"legacy_auth\") {\n        return \"Legacy_Auth\";\n    }\n\n    if (normalized === \"srp256\") {\n        return \"Srp256\";\n    }\n\n    if (normalized === \"srp384\") {\n        return \"Srp384\";\n    }\n\n    if (normalized === \"srp512\") {\n        return \"Srp512\";\n    }\n\n    return \"Srp\";\n}\n\nfunction formatWireCryptValue(value: FirebirdOptions[\"wireCrypt\"]): string {\n    if (isBlank(value)) {\n        return \"auto\";\n    }\n\n    if (typeof value === \"number\") {\n        if (value === Firebird.WIRE_CRYPT_DISABLE) {\n            return \"disabled\";\n        }\n\n        if (value === Firebird.WIRE_CRYPT_ENABLE) {\n            return \"enabled\";\n        }\n\n        return String(value);\n    }\n\n    return String(value);\n}\n\nfunction formatTarget(options: Options): string {\n    return `${options.host ?? \"?\"}:${options.port ?? \"?\"} -> ${options.database ?? \"?\"}`;\n}\n\nfunction uniqueDiagnostics(values: string[]): string[] {\n    return values.filter((value, index) => values.indexOf(value) === index);\n}\n\nfunction buildDiagnostics(message: string, options: FirebirdOptions): string[] {\n    const diagnostics: string[] = [];\n    const pluginMismatch = message.match(/Server don't accept plugin\\s*:\\s*([^,]+),\\s*but support\\s*:\\s*(.+)$/i);\n\n    if (pluginMismatch) {\n        const supportedPlugins = (pluginMismatch[2] ?? \"\")\n            .split(\",\")\n            .map((plugin) => plugin.trim())\n            .filter((plugin) => plugin.length > 0);\n        const supportedMessage = supportedPlugins.length === 1\n            ? `The server explicitly reported that only the \"${supportedPlugins[0]}\" authentication plugin is supported.`\n            : `The server explicitly reported the supported authentication plugins: ${supportedPlugins.join(\", \")}.`;\n        diagnostics.push(supportedMessage);\n    }\n\n    if (/Incompatible wire encryption levels requested on client and server/i.test(message)) {\n        diagnostics.push(\"The server rejected the requested wire encryption mode. Keep wire encryption auto-enabled unless the server is known to allow disabled encryption.\");\n    }\n\n    if (/No matching plugins on server/i.test(message)) {\n        diagnostics.push(\"The server did not find a common authentication plugin with the client configuration.\");\n    }\n\n    if (/Connection timeout after \\d+ms/i.test(message) || /Timeout during Firebird attach after \\d+ ms/i.test(message)) {\n        diagnostics.push(\"The TCP connection was accepted but the Firebird wire-protocol attach did not complete in time.\");\n    }\n\n    if (options.pluginName) {\n        diagnostics.push(`Client authentication plugin was forced to \"${options.pluginName}\". Leave pluginName empty to let the driver auto-negotiate when possible.`);\n    }\n\n    if (!isBlank(options.wireCrypt)) {\n        diagnostics.push(`Client wire encryption was forced to \"${formatWireCryptValue(options.wireCrypt)}\".`);\n    }\n\n    return uniqueDiagnostics(diagnostics);\n}\n\nfunction copyFirebirdMetadata(target: EnhancedFirebirdError, source: unknown): void {\n    if (!source || typeof source !== \"object\") {\n        return;\n    }\n\n    const firebirdSource = source as Record<string, unknown>;\n    if (\"gdscode\" in firebirdSource) {\n        target.gdscode = firebirdSource.gdscode as number;\n    }\n\n    if (\"gdsparams\" in firebirdSource) {\n        target.gdsparams = firebirdSource.gdsparams;\n    }\n}\n\nfunction formatFirebirdMetadata(source: unknown): string {\n    if (!source || typeof source !== \"object\") {\n        return \"\";\n    }\n\n    const firebirdSource = source as Record<string, unknown>;\n    const metadata: string[] = [];\n\n    if (typeof firebirdSource.gdscode === \"number\") {\n        metadata.push(`gdscode=${firebirdSource.gdscode}`);\n    }\n\n    if (firebirdSource.gdsparams !== undefined) {\n        try {\n            metadata.push(`gdsparams=${JSON.stringify(firebirdSource.gdsparams)}`);\n        } catch {\n            metadata.push(`gdsparams=${String(firebirdSource.gdsparams)}`);\n        }\n    }\n\n    return metadata.length > 0 ? ` Metadata: ${metadata.join(\", \")}.` : \"\";\n}\n\nexport function normalizeFirebirdOptions(options: Options): FirebirdOptions {\n    const compatibilityOptions = options as FirebirdOptions;\n    const {\n        authPlugins: _authPlugins,\n        compatibilityProbeTimeoutMs: _compatibilityProbeTimeoutMs,\n        compatibilityTotalTimeoutMs,\n        connectTimeoutMs,\n        firebirdDriver: _firebirdDriver,\n        logQueryParameters: _logQueryParameters,\n        poolSize: _poolSize,\n        trimStringResults,\n        ...baseOptions\n    } = compatibilityOptions;\n\n    const normalizedOptions: FirebirdOptions = {\n        ...baseOptions,\n        pluginName: normalizeAuthPlugin(compatibilityOptions.pluginName),\n        trimStringResults,\n        wireCrypt: normalizeWireCryptMode(compatibilityOptions.wireCrypt),\n    };\n\n    const timeoutCandidate = compatibilityOptions.connectTimeout\n        ?? connectTimeoutMs\n        ?? compatibilityTotalTimeoutMs;\n\n    if (Number.isFinite(timeoutCandidate) && Number(timeoutCandidate) > 0) {\n        normalizedOptions.connectTimeout = Math.trunc(Number(timeoutCandidate));\n    }\n\n    return normalizedOptions;\n}\n\nexport function describeFirebirdCompatibilityOptions(options: Options): string {\n    const normalized = normalizeFirebirdOptions(options);\n    return `plugin=${normalized.pluginName ?? \"auto\"}, wireCrypt=${formatWireCryptValue(normalized.wireCrypt)}, connectTimeout=${normalized.connectTimeout ?? \"default\"}`;\n}\n\nexport function enhanceFirebirdError(error: unknown, options: Options, context: FirebirdErrorContext): Error {\n    if (error instanceof Error && (error as EnhancedFirebirdError).__emilsoftwareFirebirdEnhanced) {\n        return error;\n    }\n\n    const normalizedOptions = normalizeFirebirdOptions(options);\n    const target = formatTarget(normalizedOptions);\n    const original = error instanceof Error ? error : new Error(String(error));\n    const diagnostics = buildDiagnostics(original.message, normalizedOptions);\n    const sqlSuffix = context.sql ? ` SQL: ${context.sql.replace(/\\s+/g, \" \").trim()}` : \"\";\n    const diagnosticsSuffix = diagnostics.length > 0 ? ` Diagnostics: ${diagnostics.join(\" \")}` : \"\";\n    const metadataSuffix = formatFirebirdMetadata(original);\n    const enhanced = new Error(\n        `Firebird ${context.stage} failed on ${target}: ${original.message}.${diagnosticsSuffix}${metadataSuffix}${sqlSuffix}`\n    ) as EnhancedFirebirdError;\n\n    enhanced.cause = original;\n    enhanced.__emilsoftwareFirebirdEnhanced = true;\n    copyFirebirdMetadata(enhanced, original);\n    enhanced.stack = `${enhanced.name}: ${enhanced.message}\\nCaused by: ${original.stack ?? original.message}`;\n    return enhanced;\n}\n\nexport function buildFirebirdCompatibilityCandidates(options: Options): FirebirdOptions[] {\n    return [normalizeFirebirdOptions(options)];\n}\n\nexport function shouldRetryFirebirdCompatibility(): boolean {\n    return false;\n}\n\nexport function ensureEsNodeFirebirdCompatibilityPatch(): void {\n    // No-op kept for backward compatibility. The library now relies on the\n    // official node-firebird driver, which handles Firebird 2.5+ protocol\n    // negotiation natively.\n}\n"]}

package/dist/scripts/generateAccessiWiki.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/scripts/generateAccessiWiki.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Genera la Wiki in Markdown per GitHub a partire dalla stessa fonte usata
+ * dalla console: `src/accessi-module/Console/wiki.ts`.
+ *
+ * Output:
+ * - WIKI.md      documentazione completa con indice
+ * - WIKI.ai.md   digest compatto pensato per l'IA
+ *
+ * La wiki della console e questi file non possono divergere: entrambi derivano
+ * dagli stessi dati. Non modificare WIKI.md a mano, esegui `npm run generate:accessi-wiki`.
+ */
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const wiki_1 = require("../accessi-module/Console/wiki");
+const REPO_ROOT = (0, node_path_1.join)(__dirname, '..', '..');
+/** Riproduce la slug dei titoli usata da GitHub per generare gli anchor. */
+function githubSlug(title) {
+    return title
+        .toLowerCase()
+        .trim()
+        .replace(/[^\p{L}\p{N}\s_-]/gu, '')
+        .replace(/\s+/g, '-');
+}
+/**
+ * Escapa i caratteri che Markdown interpreterebbe come formattazione.
+ * Serve per token come `/api/accessi/*`, `ACCESSI_*` o `<jwt>`: senza escaping
+ * gli asterischi diventano corsivo e `<...>` viene scambiato per un tag HTML.
+ */
+function escapeMd(text) {
+    return text.replace(/([\\`*_{}[\]<>#])/g, '\\$1');
+}
+const ALERT = {
+    info: 'NOTE',
+    ok: 'TIP',
+    warn: 'WARNING',
+    danger: 'CAUTION',
+};
+function renderCode(block) {
+    const label = block.variant === 'good'
+        ? `**Esempio corretto${block.title ? ` — ${block.title}` : ''}**`
+        : block.variant === 'bad'
+            ? `**Esempio da evitare${block.title ? ` — ${block.title}` : ''}**`
+            : block.title
+                ? `**${block.title}**`
+                : '';
+    const fence = '```' + block.language;
+    return [...(label ? [label, ''] : []), fence, block.code, '```'].join('\n');
+}
+function renderBlock(block) {
+    switch (block.kind) {
+        case 'p':
+            return escapeMd(block.text);
+        case 'h':
+            return `### ${escapeMd(block.text)}`;
+        case 'list':
+            return block.items
+                .map((item, index) => `${block.ordered ? `${index + 1}.` : '-'} ${escapeMd(item)}`)
+                .join('\n');
+        case 'code':
+            return renderCode(block);
+        case 'callout':
+            return [
+                `> [!${ALERT[block.tone]}]`,
+                ...(block.title ? [`> **${escapeMd(block.title)}**`] : []),
+                `> ${escapeMd(block.text)}`,
+            ].join('\n');
+        case 'table': {
+            const head = `| ${block.head.map(escapeMd).join(' | ')} |`;
+            const separator = `| ${block.head.map(() => '---').join(' | ')} |`;
+            const rows = block.rows.map((row) => `| ${row.map((cell) => escapeMd(cell).replace(/\|/g, '\\|')).join(' | ')} |`);
+            return [head, separator, ...rows].join('\n');
+        }
+        default:
+            return '';
+    }
+}
+function buildMarkdown() {
+    const groups = (0, wiki_1.wikiGroups)();
+    const toc = groups
+        .map(({ group, sections }) => [
+        `**${group}**`,
+        '',
+        ...sections.map((section) => `- [${escapeMd(section.title)}](#${githubSlug(section.title)})`),
+        '',
+    ].join('\n'))
+        .join('\n');
+    const body = wiki_1.WIKI_SECTIONS
+        .map((section) => [
+        `## ${escapeMd(section.title)}`,
+        '',
+        `_${escapeMd(section.summary)}_`,
+        '',
+        section.blocks.map(renderBlock).join('\n\n'),
+        '',
+    ].join('\n'))
+        .join('\n---\n\n');
+    return [
+        '# Wiki del modulo Accessi',
+        '',
+        '> Documento generato automaticamente da `src/accessi-module/Console/wiki.ts` (la stessa fonte della Wiki nella console).',
+        '> Non modificarlo a mano: esegui `npm run generate:accessi-wiki`.',
+        '',
+        'La stessa documentazione è disponibile, resa in modo interattivo, nella console Accessi su `/api/accessi/console/wiki`.',
+        'Per una versione compatta da fornire a un\'IA che costruisce il backend integratore, vedi [`WIKI.ai.md`](WIKI.ai.md).',
+        '',
+        '## Indice',
+        '',
+        toc,
+        '---',
+        '',
+        body,
+    ].join('\n').replace(/\n{3,}/g, '\n\n');
+}
+const aiHeader = [
+    '<!-- Documento generato automaticamente da src/accessi-module/Console/wiki.ts. Non modificare a mano: npm run generate:accessi-wiki. -->',
+    '',
+    '# Guida compatta per l\'IA',
+    '',
+    'Versione sintetica della wiki, pensata per essere incollata a un\'IA che costruisce il backend integratore.',
+    'Disponibile anche nella console con il pulsante "Copia per AI" (`/api/accessi/console/wiki`).',
+    '',
+    'Il contenuto è racchiuso in un blocco di codice per essere copiato verbatim, senza interpretazione Markdown.',
+    '',
+].join('\n');
+// Fence a quattro backtick: il digest contiene fence a tre backtick che restano letterali.
+(0, node_fs_1.writeFileSync)((0, node_path_1.join)(REPO_ROOT, 'WIKI.md'), buildMarkdown(), 'utf8');
+(0, node_fs_1.writeFileSync)((0, node_path_1.join)(REPO_ROOT, 'WIKI.ai.md'), `${aiHeader}\n\`\`\`\`text\n${(0, wiki_1.buildAiDigest)()}\n\`\`\`\`\n`, 'utf8');
+process.stdout.write('Wiki generata: WIKI.md e WIKI.ai.md\n');
+//# sourceMappingURL=generateAccessiWiki.js.map

package/dist/scripts/generateAccessiWiki.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateAccessiWiki.js","sourceRoot":"","sources":["../../src/scripts/generateAccessiWiki.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Genera la Wiki in Markdown per GitHub a partire dalla stessa fonte usata\n * dalla console: `src/accessi-module/Console/wiki.ts`.\n *\n * Output:\n * - WIKI.md      documentazione completa con indice\n * - WIKI.ai.md   digest compatto pensato per l'IA\n *\n * La wiki della console e questi file non possono divergere: entrambi derivano\n * dagli stessi dati. Non modificare WIKI.md a mano, esegui `npm run generate:accessi-wiki`.\n */\nimport { writeFileSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { WIKI_SECTIONS, wikiGroups, buildAiDigest } from '../accessi-module/Console/wiki';\nimport type { WikiBlock, WikiTone } from '../accessi-module/Console/wiki';\n\nconst REPO_ROOT = join(__dirname, '..', '..');\n\n/** Riproduce la slug dei titoli usata da GitHub per generare gli anchor. */\nfunction githubSlug(title: string): string {\n  return title\n    .toLowerCase()\n    .trim()\n    .replace(/[^\\p{L}\\p{N}\\s_-]/gu, '')\n    .replace(/\\s+/g, '-');\n}\n\n/**\n * Escapa i caratteri che Markdown interpreterebbe come formattazione.\n * Serve per token come `/api/accessi/*`, `ACCESSI_*` o `<jwt>`: senza escaping\n * gli asterischi diventano corsivo e `<...>` viene scambiato per un tag HTML.\n */\nfunction escapeMd(text: string): string {\n  return text.replace(/([\\\\`*_{}[\\]<>#])/g, '\\\\$1');\n}\n\nconst ALERT: Record<WikiTone, string> = {\n  info: 'NOTE',\n  ok: 'TIP',\n  warn: 'WARNING',\n  danger: 'CAUTION',\n};\n\nfunction renderCode(block: Extract<WikiBlock, { kind: 'code' }>): string {\n  const label = block.variant === 'good'\n    ? `**Esempio corretto${block.title ? ` — ${block.title}` : ''}**`\n    : block.variant === 'bad'\n      ? `**Esempio da evitare${block.title ? ` — ${block.title}` : ''}**`\n      : block.title\n        ? `**${block.title}**`\n        : '';\n  const fence = '```' + block.language;\n  return [...(label ? [label, ''] : []), fence, block.code, '```'].join('\\n');\n}\n\nfunction renderBlock(block: WikiBlock): string {\n  switch (block.kind) {\n    case 'p':\n      return escapeMd(block.text);\n    case 'h':\n      return `### ${escapeMd(block.text)}`;\n    case 'list':\n      return block.items\n        .map((item, index) => `${block.ordered ? `${index + 1}.` : '-'} ${escapeMd(item)}`)\n        .join('\\n');\n    case 'code':\n      return renderCode(block);\n    case 'callout':\n      return [\n        `> [!${ALERT[block.tone]}]`,\n        ...(block.title ? [`> **${escapeMd(block.title)}**`] : []),\n        `> ${escapeMd(block.text)}`,\n      ].join('\\n');\n    case 'table': {\n      const head = `| ${block.head.map(escapeMd).join(' | ')} |`;\n      const separator = `| ${block.head.map(() => '---').join(' | ')} |`;\n      const rows = block.rows.map((row) => `| ${row.map((cell) => escapeMd(cell).replace(/\\|/g, '\\\\|')).join(' | ')} |`);\n      return [head, separator, ...rows].join('\\n');\n    }\n    default:\n      return '';\n  }\n}\n\nfunction buildMarkdown(): string {\n  const groups = wikiGroups();\n  const toc = groups\n    .map(({ group, sections }) => [\n      `**${group}**`,\n      '',\n      ...sections.map((section) => `- [${escapeMd(section.title)}](#${githubSlug(section.title)})`),\n      '',\n    ].join('\\n'))\n    .join('\\n');\n\n  const body = WIKI_SECTIONS\n    .map((section) => [\n      `## ${escapeMd(section.title)}`,\n      '',\n      `_${escapeMd(section.summary)}_`,\n      '',\n      section.blocks.map(renderBlock).join('\\n\\n'),\n      '',\n    ].join('\\n'))\n    .join('\\n---\\n\\n');\n\n  return [\n    '# Wiki del modulo Accessi',\n    '',\n    '> Documento generato automaticamente da `src/accessi-module/Console/wiki.ts` (la stessa fonte della Wiki nella console).',\n    '> Non modificarlo a mano: esegui `npm run generate:accessi-wiki`.',\n    '',\n    'La stessa documentazione è disponibile, resa in modo interattivo, nella console Accessi su `/api/accessi/console/wiki`.',\n    'Per una versione compatta da fornire a un\\'IA che costruisce il backend integratore, vedi [`WIKI.ai.md`](WIKI.ai.md).',\n    '',\n    '## Indice',\n    '',\n    toc,\n    '---',\n    '',\n    body,\n  ].join('\\n').replace(/\\n{3,}/g, '\\n\\n');\n}\n\nconst aiHeader = [\n  '<!-- Documento generato automaticamente da src/accessi-module/Console/wiki.ts. Non modificare a mano: npm run generate:accessi-wiki. -->',\n  '',\n  '# Guida compatta per l\\'IA',\n  '',\n  'Versione sintetica della wiki, pensata per essere incollata a un\\'IA che costruisce il backend integratore.',\n  'Disponibile anche nella console con il pulsante \"Copia per AI\" (`/api/accessi/console/wiki`).',\n  '',\n  'Il contenuto è racchiuso in un blocco di codice per essere copiato verbatim, senza interpretazione Markdown.',\n  '',\n].join('\\n');\n\n// Fence a quattro backtick: il digest contiene fence a tre backtick che restano letterali.\nwriteFileSync(join(REPO_ROOT, 'WIKI.md'), buildMarkdown(), 'utf8');\nwriteFileSync(join(REPO_ROOT, 'WIKI.ai.md'), `${aiHeader}\\n\\`\\`\\`\\`text\\n${buildAiDigest()}\\n\\`\\`\\`\\`\\n`, 'utf8');\nprocess.stdout.write('Wiki generata: WIKI.md e WIKI.ai.md\\n');\n"]}

package/dist/swagger/SwaggerConfig.js

@@ -20,17 +20,20 @@ function setupSwagger(app, options) {
         .build();
     const document = swagger_1.SwaggerModule.createDocument(app, config);
     swagger_1.SwaggerModule.setup(swaggerPath, app, document);
-    app.use(`/${swaggerJsonPath}`, (_, res) => {
+    app.use(`/${swaggerJsonPath}`, (_req, res) => {
         res.setHeader("Content-Type", "application/json");
         res.send(document);
     });
     if (legacySwaggerJsonPath !== swaggerJsonPath) {
-        app.use(`/${legacySwaggerJsonPath}`, (_, res) => {
+        app.use(`/${legacySwaggerJsonPath}`, (_req, 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;
+    const serverAddress = (_f = (_e = app.getHttpServer()) === null || _e === void 0 ? void 0 : _e.address) === null || _f === void 0 ? void 0 : _f.call(_e);
+    const port = serverAddress && typeof serverAddress === "object"
+        ? serverAddress.port
+        : 3000;
     logger.info(`Swagger documentation available at: http://localhost:${port}/${swaggerPath}`);
     logger.info(`Swagger OpenAPI JSON available at: http://localhost:${port}/${swaggerJsonPath}`);
 }

package/dist/swagger/SwaggerConfig.js.map

@@ -1 +1 @@
-{"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"]}
+{"version":3,"file":"SwaggerConfig.js","sourceRoot":"","sources":["../../src/swagger/SwaggerConfig.ts"],"names":[],"mappings":";;AAaA,oCA0CC;AAtDD,6CAAiE;AAGjE,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,IAAa,EAAE,GAAa,EAAE,EAAE;QAC5D,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,IAAa,EAAE,GAAa,EAAE,EAAE;YAClE,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;YAClD,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;IACP,CAAC;IAED,MAAM,aAAa,GAAG,MAAA,MAAA,GAAG,CAAC,aAAa,EAAE,0CAAE,OAAO,kDAAI,CAAC;IACvD,MAAM,IAAI,GAAG,aAAa,IAAI,OAAO,aAAa,KAAK,QAAQ;QAC3D,CAAC,CAAE,aAA6B,CAAC,IAAI;QACrC,CAAC,CAAC,IAAI,CAAC;IAEX,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 { Request, Response } from \"express\";\nimport { AddressInfo } from \"net\";\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}`, (_req: Request, res: Response) => {\n        res.setHeader(\"Content-Type\", \"application/json\");\n        res.send(document);\n    });\n\n    if (legacySwaggerJsonPath !== swaggerJsonPath) {\n        app.use(`/${legacySwaggerJsonPath}`, (_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        `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,23 +1,35 @@
 {
   "name": "emilsoftware-utilities",
-  "version": "2.0.0-dev.23",
+  "version": "2.0.0-dev.25",
   "description": "Utilities for EmilSoftware",
   "main": "dist/index.js",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
     "release": "semantic-release",
-    "build": "tsc && npm run generate:accessi-openapi && npm run generate:accessi-client && tsc && tsc -p tsconfig.console.json --noEmit && npm run build:accessi-console && npm run copy-views",
-    "generate:accessi-openapi": "node dist/scripts/generateAccessiOpenApi.js",
+    "build": "npm run generate:accessi-openapi && npm run generate:accessi-client && npm run generate:accessi-wiki && tsc && tsc -p tsconfig.console.json --noEmit && npm run build:accessi-console && npm run copy-views",
+    "generate:accessi-openapi": "ts-node --transpile-only src/scripts/generateAccessiOpenApi.ts",
     "generate:accessi-client": "orval --config orval.config.ts",
+    "generate:accessi-wiki": "ts-node --transpile-only src/scripts/generateAccessiWiki.ts",
     "build:accessi-console": "esbuild src/accessi-module/Console/console.ts --bundle --platform=browser --format=esm --target=es2020 --outfile=dist/accessi-module/Console/console.js",
     "copy-views": "node copy-views.js",
     "db:update:accessi": "ts-node src/accessi-module/database-updates/runAccessiDbUpdate.ts",
     "db:update:accessi:dist": "npm run build && node dist/accessi-module/database-updates/runAccessiDbUpdate.js",
     "prepublishOnly": "npm run build",
-    "test:allegati": "ts-node src/tests/allegati/allegati.ts",
-    "test:accessi": "npm run build && node --test test/accessi-regressions.cjs test/password-reset-regressions.cjs test/two-factor.cjs",
+    "typecheck": "tsc --noEmit",
+    "lint": "node scripts/lint.cjs",
+    "test": "npm run typecheck && npm run lint && npm run test:unit",
+    "test:unit": "node --test test/accessi-regressions.cjs test/password-reset-regressions.cjs test/two-factor.cjs test/accessi-schema.cjs test/utilities-regressions.cjs test/service-token-regressions.cjs",
+    "test:coverage": "node --experimental-test-coverage --test-coverage-lines=50 --test-coverage-functions=60 --test-coverage-branches=60 --test test/accessi-regressions.cjs test/password-reset-regressions.cjs test/two-factor.cjs test/accessi-schema.cjs test/utilities-regressions.cjs test/service-token-regressions.cjs",
+    "test:accessi": "npm run test:unit",
+    "test:all": "npm test && npm run test:integration",
+    "test:integration": "node test/integration/run-firebird.cjs 5",
+    "test:integration:fb5": "node test/integration/run-firebird.cjs 5",
+    "test:integration:fb3": "node test/integration/run-firebird.cjs 3",
+    "test:integration:fb25": "node test/integration/run-firebird.cjs 2.5",
     "test:accessi-console": "npm run build && node test/console-two-factor.cjs",
+    "accessi:seed-admin": "node scripts/seed-accessi-admin.cjs",
+    "accessi:console": "node scripts/run-accessi-console.cjs",
     "test:accessi-schema": "node --test test/accessi-schema.cjs",
     "db:check:accessi": "ts-node src/accessi-module/database-updates/runAccessiDbUpdate.ts --check"
   },
@@ -61,8 +73,7 @@
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/commit-analyzer": "^13.0.1",
     "@semantic-release/git": "^10.0.1",
-    "@semantic-release/github": "^11.0.3",
-    "@semantic-release/npm": "^12.0.2",
+    "@semantic-release/github": "^12.0.0",
     "@semantic-release/release-notes-generator": "^14.0.3",
     "@types/express": "^5.0.0",
     "@types/jsonwebtoken": "^9.0.7",
@@ -77,7 +88,7 @@
     "esbuild": "^0.28.2",
     "fs-extra": "^11.3.0",
     "orval": "^6.31.0",
-    "semantic-release": "^24.2.7",
+    "semantic-release": "^25.0.9",
     "ts-node": "^10.9.2",
     "typescript": "^5.8.3"
   },