emilsoftware-utilities 2.0.0-dev.7 → 2.0.0-dev.71

package/dist/accessi-module/database-updates/optionalColumns.js

@@ -0,0 +1,58 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearTableColumnsCache = clearTableColumnsCache;
+exports.getTableColumns = getTableColumns;
+exports.optionalColumn = optionalColumn;
+const Orm_1 = require("../../Orm");
+/**
+ * I metadati delle colonne sono letti di rado ma usati a ogni operazione. Una cache a breve TTL
+ * evita una query di introspezione per richiesta; il TTL limita la finestra di staleness se lo
+ * schema viene esteso a runtime (le migrazioni girano comunque al bootstrap).
+ */
+const COLUMN_CACHE_TTL_MS = 60000;
+const COLUMN_CACHE_MAX_ENTRIES = 100;
+const columnCache = new Map();
+function cacheKey(options, table) {
+    var _a, _b, _c;
+    const db = options.databaseOptions;
+    return [(_a = db.host) !== null && _a !== void 0 ? _a : '', (_b = db.port) !== null && _b !== void 0 ? _b : '', (_c = db.database) !== null && _c !== void 0 ? _c : '', table.toUpperCase()].join('|');
+}
+/** Invalida la cache dei metadati (usata dopo migrazioni o nei test). */
+function clearTableColumnsCache() {
+    columnCache.clear();
+}
+/** Metadata is read per operation so host-owned extensions can change without a stale global cache. */
+function getTableColumns(options, table) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const key = cacheKey(options, table);
+        const now = Date.now();
+        const cached = columnCache.get(key);
+        if (cached && cached.expiresAt > now) {
+            return cached.columns;
+        }
+        const rows = yield Orm_1.Orm.query(options.databaseOptions, 'SELECT TRIM(RDB$FIELD_NAME) AS COLUMN_NAME FROM RDB$RELATION_FIELDS WHERE RDB$RELATION_NAME = ?', [table], false);
+        const columns = new Set(rows.map((row) => { var _a; return String((_a = row.COLUMN_NAME) !== null && _a !== void 0 ? _a : '').trim(); }));
+        if (columnCache.size >= COLUMN_CACHE_MAX_ENTRIES) {
+            const oldestKey = columnCache.keys().next().value;
+            if (oldestKey !== undefined) {
+                columnCache.delete(oldestKey);
+            }
+        }
+        columnCache.set(key, { columns, expiresAt: now + COLUMN_CACHE_TTL_MS });
+        return columns;
+    });
+}
+/** Arguments come exclusively from the library's fixed field mappings, never HTTP input. */
+function optionalColumn(columns, name, tableAlias, outputAlias, numeric = true) {
+    return `${columns.has(name) ? `${tableAlias}.${name}` : `CAST(NULL AS ${numeric ? 'INTEGER' : 'VARCHAR(255)'})`} AS ${outputAlias}`;
+}
+//# sourceMappingURL=optionalColumns.js.map

package/dist/accessi-module/database-updates/optionalColumns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"optionalColumns.js","sourceRoot":"","sources":["../../../src/accessi-module/database-updates/optionalColumns.ts"],"names":[],"mappings":";;;;;;;;;;;AAoBA,wDAEC;AAGD,0CAqBC;AAGD,wCAEC;AAlDD,mCAAgC;AAIhC;;;;GAIG;AACH,MAAM,mBAAmB,GAAG,KAAM,CAAC;AACnC,MAAM,wBAAwB,GAAG,GAAG,CAAC;AACrC,MAAM,WAAW,GAAG,IAAI,GAAG,EAA4B,CAAC;AAExD,SAAS,QAAQ,CAAC,OAAuB,EAAE,KAAa;;IACtD,MAAM,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC;IACnC,OAAO,CAAC,MAAA,EAAE,CAAC,IAAI,mCAAI,EAAE,EAAE,MAAA,EAAE,CAAC,IAAI,mCAAI,EAAE,EAAE,MAAA,EAAE,CAAC,QAAQ,mCAAI,EAAE,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC1F,CAAC;AAED,yEAAyE;AACzE,SAAgB,sBAAsB;IACpC,WAAW,CAAC,KAAK,EAAE,CAAC;AACtB,CAAC;AAED,uGAAuG;AACvG,SAAsB,eAAe,CAAC,OAAuB,EAAE,KAAa;;QAC1E,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,MAAM,IAAI,MAAM,CAAC,SAAS,GAAG,GAAG,EAAE,CAAC;YACrC,OAAO,MAAM,CAAC,OAAO,CAAC;QACxB,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,SAAG,CAAC,KAAK,CAAC,OAAO,CAAC,eAAe,EAClD,iGAAiG,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;QACrH,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAA4B,EAAE,EAAE,WAAC,OAAA,MAAM,CAAC,MAAA,GAAG,CAAC,WAAW,mCAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA,EAAA,CAAC,CAAC,CAAC;QAE1G,IAAI,WAAW,CAAC,IAAI,IAAI,wBAAwB,EAAE,CAAC;YACjD,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YAClD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5B,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;QACD,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,GAAG,mBAAmB,EAAE,CAAC,CAAC;QAExE,OAAO,OAAO,CAAC;IACjB,CAAC;CAAA;AAED,4FAA4F;AAC5F,SAAgB,cAAc,CAAC,OAAoB,EAAE,IAAY,EAAE,UAAkB,EAAE,WAAmB,EAAE,OAAO,GAAG,IAAI;IACxH,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,gBAAgB,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,GAAG,OAAO,WAAW,EAAE,CAAC;AACtI,CAAC","sourcesContent":["import type { AccessiOptions } from '../AccessiModule';\nimport { Orm } from '../../Orm';\n\ntype ColumnCacheEntry = { columns: Set<string>; expiresAt: number };\n\n/**\n * I metadati delle colonne sono letti di rado ma usati a ogni operazione. Una cache a breve TTL\n * evita una query di introspezione per richiesta; il TTL limita la finestra di staleness se lo\n * schema viene esteso a runtime (le migrazioni girano comunque al bootstrap).\n */\nconst COLUMN_CACHE_TTL_MS = 60_000;\nconst COLUMN_CACHE_MAX_ENTRIES = 100;\nconst columnCache = new Map<string, ColumnCacheEntry>();\n\nfunction cacheKey(options: AccessiOptions, table: string): string {\n  const db = options.databaseOptions;\n  return [db.host ?? '', db.port ?? '', db.database ?? '', table.toUpperCase()].join('|');\n}\n\n/** Invalida la cache dei metadati (usata dopo migrazioni o nei test). */\nexport function clearTableColumnsCache(): void {\n  columnCache.clear();\n}\n\n/** Metadata is read per operation so host-owned extensions can change without a stale global cache. */\nexport async function getTableColumns(options: AccessiOptions, table: string): Promise<Set<string>> {\n  const key = cacheKey(options, table);\n  const now = Date.now();\n  const cached = columnCache.get(key);\n  if (cached && cached.expiresAt > now) {\n    return cached.columns;\n  }\n\n  const rows = await Orm.query(options.databaseOptions,\n    'SELECT TRIM(RDB$FIELD_NAME) AS COLUMN_NAME FROM RDB$RELATION_FIELDS WHERE RDB$RELATION_NAME = ?', [table], false);\n  const columns = new Set(rows.map((row: Record<string, unknown>) => String(row.COLUMN_NAME ?? '').trim()));\n\n  if (columnCache.size >= COLUMN_CACHE_MAX_ENTRIES) {\n    const oldestKey = columnCache.keys().next().value;\n    if (oldestKey !== undefined) {\n      columnCache.delete(oldestKey);\n    }\n  }\n  columnCache.set(key, { columns, expiresAt: now + COLUMN_CACHE_TTL_MS });\n\n  return columns;\n}\n\n/** Arguments come exclusively from the library's fixed field mappings, never HTTP input. */\nexport function optionalColumn(columns: Set<string>, name: string, tableAlias: string, outputAlias: string, numeric = true): string {\n  return `${columns.has(name) ? `${tableAlias}.${name}` : `CAST(NULL AS ${numeric ? 'INTEGER' : 'VARCHAR(255)'})`} AS ${outputAlias}`;\n}\n"]}

package/dist/accessi-module/database-updates/runAccessiCatalogMigrations.d.ts

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

package/dist/accessi-module/database-updates/runAccessiCatalogMigrations.js

@@ -0,0 +1,69 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const AccessiDatabaseUpdater_1 = require("./AccessiDatabaseUpdater");
+const AccessiCatalogMigrator_1 = require("./AccessiCatalogMigrator");
+const accessiOptionsFromEnv_1 = require("./accessiOptionsFromEnv");
+const Orm_1 = require("../../Orm");
+function main() {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const options = (0, accessiOptionsFromEnv_1.createAccessiOptionsFromEnv)();
+        if (!((_a = options.catalogScripts) === null || _a === void 0 ? void 0 : _a.folder)) {
+            throw new Error("Variabile ambiente mancante: ACCESSI_CATALOG_FOLDER (cartella delle catalog migrations).");
+        }
+        const checkOnly = process.argv.includes('--check');
+        console.log(`[Accessi Catalog] Target: ${options.databaseOptions.host}:${options.databaseOptions.port} -> ${options.databaseOptions.database}`);
+        console.log(`[Accessi Catalog] Cartella: ${options.catalogScripts.folder}`);
+        // Prima lo schema si adegua, poi si eseguono gli script di catalogo.
+        if (!checkOnly) {
+            console.log('[Accessi Catalog] Riconciliazione schema...');
+            yield AccessiDatabaseUpdater_1.AccessiDatabaseUpdater.run(options);
+        }
+        if (checkOnly) {
+            const pending = yield (0, AccessiCatalogMigrator_1.listPendingCatalogScripts)(options);
+            console.log(`[Accessi Catalog] Gia applicati: ${pending.applied.length}`);
+            console.log(`[Accessi Catalog] Da applicare: ${pending.pending.length}${pending.pending.length ? ` -> ${pending.pending.join(', ')}` : ''}`);
+            console.log(`[Accessi Catalog] Modificati (checksum diverso): ${pending.changed.length}${pending.changed.length ? ` -> ${pending.changed.join(', ')}` : ''}`);
+            console.log(`[Accessi Catalog] Non conformi (solo DML): ${pending.invalid.length}`);
+            for (const entry of pending.invalid) {
+                for (const violation of entry.violations)
+                    console.error(`[Accessi Catalog] Non conforme: ${entry.script} -> ${violation}`);
+            }
+            if (pending.invalid.length)
+                process.exitCode = 1;
+            return;
+        }
+        const report = yield (0, AccessiCatalogMigrator_1.applyCatalogScripts)(options);
+        console.log(`[Accessi Catalog] Scoperti: ${report.discovered} | Applicati: ${report.applied.length} | Saltati: ${report.skipped.length} | Non conformi: ${report.invalid.length} | Falliti: ${report.failed.length}`);
+        if (report.applied.length)
+            console.log(`[Accessi Catalog] Applicati: ${report.applied.join(', ')}`);
+        for (const entry of report.invalid) {
+            for (const violation of entry.violations)
+                console.error(`[Accessi Catalog] Non conforme: ${entry.script} -> ${violation}`);
+        }
+        if (report.failed.length) {
+            for (const failure of report.failed)
+                console.error(`[Accessi Catalog] Fallito: ${failure.script} -> ${failure.error}`);
+        }
+        if (report.failed.length || report.invalid.length)
+            process.exitCode = 1;
+    });
+}
+main()
+    .then(() => Orm_1.Orm.closePools())
+    .then(() => { var _a; return process.exit((_a = process.exitCode) !== null && _a !== void 0 ? _a : 0); })
+    .catch((error) => __awaiter(void 0, void 0, void 0, function* () {
+    console.error("[Accessi Catalog] Errore durante l'esecuzione:", error);
+    yield Orm_1.Orm.closePools().catch(() => undefined);
+    process.exit(1);
+}));
+//# sourceMappingURL=runAccessiCatalogMigrations.js.map

package/dist/accessi-module/database-updates/runAccessiCatalogMigrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runAccessiCatalogMigrations.js","sourceRoot":"","sources":["../../../src/accessi-module/database-updates/runAccessiCatalogMigrations.ts"],"names":[],"mappings":"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","sourcesContent":["import { AccessiDatabaseUpdater } from \"./AccessiDatabaseUpdater\";\nimport { applyCatalogScripts, listPendingCatalogScripts } from \"./AccessiCatalogMigrator\";\nimport { createAccessiOptionsFromEnv } from \"./accessiOptionsFromEnv\";\nimport { Orm } from \"../../Orm\";\n\nasync function main(): Promise<void> {\n  const options = createAccessiOptionsFromEnv();\n  if (!options.catalogScripts?.folder) {\n    throw new Error(\"Variabile ambiente mancante: ACCESSI_CATALOG_FOLDER (cartella delle catalog migrations).\");\n  }\n\n  const checkOnly = process.argv.includes('--check');\n  console.log(`[Accessi Catalog] Target: ${options.databaseOptions.host}:${options.databaseOptions.port} -> ${options.databaseOptions.database}`);\n  console.log(`[Accessi Catalog] Cartella: ${options.catalogScripts.folder}`);\n\n  // Prima lo schema si adegua, poi si eseguono gli script di catalogo.\n  if (!checkOnly) {\n    console.log('[Accessi Catalog] Riconciliazione schema...');\n    await AccessiDatabaseUpdater.run(options);\n  }\n\n  if (checkOnly) {\n    const pending = await listPendingCatalogScripts(options);\n    console.log(`[Accessi Catalog] Gia applicati: ${pending.applied.length}`);\n    console.log(`[Accessi Catalog] Da applicare: ${pending.pending.length}${pending.pending.length ? ` -> ${pending.pending.join(', ')}` : ''}`);\n    console.log(`[Accessi Catalog] Modificati (checksum diverso): ${pending.changed.length}${pending.changed.length ? ` -> ${pending.changed.join(', ')}` : ''}`);\n    console.log(`[Accessi Catalog] Non conformi (solo DML): ${pending.invalid.length}`);\n    for (const entry of pending.invalid) {\n      for (const violation of entry.violations) console.error(`[Accessi Catalog] Non conforme: ${entry.script} -> ${violation}`);\n    }\n    if (pending.invalid.length) process.exitCode = 1;\n    return;\n  }\n\n  const report = await applyCatalogScripts(options);\n  console.log(`[Accessi Catalog] Scoperti: ${report.discovered} | Applicati: ${report.applied.length} | Saltati: ${report.skipped.length} | Non conformi: ${report.invalid.length} | Falliti: ${report.failed.length}`);\n  if (report.applied.length) console.log(`[Accessi Catalog] Applicati: ${report.applied.join(', ')}`);\n  for (const entry of report.invalid) {\n    for (const violation of entry.violations) console.error(`[Accessi Catalog] Non conforme: ${entry.script} -> ${violation}`);\n  }\n  if (report.failed.length) {\n    for (const failure of report.failed) console.error(`[Accessi Catalog] Fallito: ${failure.script} -> ${failure.error}`);\n  }\n  if (report.failed.length || report.invalid.length) process.exitCode = 1;\n}\n\nmain()\n  .then(() => Orm.closePools())\n  .then(() => process.exit(process.exitCode ?? 0))\n  .catch(async (error) => {\n    console.error(\"[Accessi Catalog] Errore durante l'esecuzione:\", error);\n    await Orm.closePools().catch(() => undefined);\n    process.exit(1);\n  });\n"]}

package/dist/accessi-module/database-updates/runAccessiDbUpdate.js

@@ -10,66 +10,31 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const AccessiDatabaseUpdater_1 = require("./AccessiDatabaseUpdater");
-const Utilities_1 = require("../../Utilities");
-function getEnv(name, fallback) {
-    var _a;
-    const value = (_a = process.env[name]) !== null && _a !== void 0 ? _a : fallback;
-    if (!value) {
-        throw new Error(`Variabile ambiente mancante: ${name}`);
-    }
-    return value;
-}
-function getOptionalBoolean(name, fallback) {
-    const value = process.env[name];
-    if (value === undefined) {
-        return fallback;
-    }
-    return value.toLowerCase() === "true";
-}
-function createAccessiOptionsFromEnv() {
-    return {
-        databaseOptions: Utilities_1.DatabaseUtilities.createOption(getEnv("ACCESSI_DB_HOST"), Number(getEnv("ACCESSI_DB_PORT", "3050")), getEnv("ACCESSI_DB_DATABASE"), getEnv("ACCESSI_DB_USER", "SYSDBA"), getEnv("ACCESSI_DB_PASSWORD", "masterkey")),
-        confirmationEmailUrl: getEnv("ACCESSI_CONFIRMATION_EMAIL_URL", "http://localhost"),
-        confirmationEmailReturnUrl: getEnv("ACCESSI_CONFIRMATION_RETURN_EMAIL_URL", "http://localhost"),
-        confirmationEmailPrefix: process.env.ACCESSI_CONFIRMATION_EMAIL_PREFIX,
-        customResetPage: process.env.ACCESSI_CUSTOM_RESET_PAGE,
-        encryptionKey: getEnv("ACCESSI_ENCRYPTION_KEY", "1234567890ABCDEF"),
-        mockDemoUser: getOptionalBoolean("ACCESSI_MOCK_DEMO_USER", false),
-        passwordExpiration: getOptionalBoolean("ACCESSI_PASSWORD_EXPIRATION", false),
-        autoUpdateDatabase: true,
-        jwtOptions: {
-            secret: getEnv("ACCESSI_JWT_SECRET", "local-accessi-update"),
-            expiresIn: getEnv("ACCESSI_JWT_EXPIRES", "24h"),
-        },
-        emailOptions: {
-            host: getEnv("ACCESSI_EMAIL_HOST", "localhost"),
-            port: Number(getEnv("ACCESSI_EMAIL_PORT", "25")),
-            secure: getOptionalBoolean("ACCESSI_EMAIL_SECURE", false),
-            requireTLS: getOptionalBoolean("ACCESSI_EMAIL_REQUIRE_TLS", false),
-            tls: {
-                rejectUnauthorized: getOptionalBoolean("ACCESSI_EMAIL_TLS_REJECT_UNAUTHORIZED", false),
-            },
-            from: getEnv("ACCESSI_EMAIL_FROM", "noreply@example.local"),
-            auth: {
-                user: getEnv("ACCESSI_EMAIL_USER", "local-user"),
-                pass: getEnv("ACCESSI_EMAIL_PASSWORD", "local-password"),
-            },
-        },
-        extensionFieldsOptions: [],
-    };
-}
+const accessiOptionsFromEnv_1 = require("./accessiOptionsFromEnv");
+const Orm_1 = require("../../Orm");
+const menuScopeSeeder_1 = require("./menuScopeSeeder");
 function main() {
     return __awaiter(this, void 0, void 0, function* () {
-        const options = createAccessiOptionsFromEnv();
-        console.log("[Accessi DB Update] Avvio aggiornamento database...");
+        const options = (0, accessiOptionsFromEnv_1.createAccessiOptionsFromEnv)();
+        const checkOnly = process.argv.includes('--check');
+        console.log(checkOnly ? '[Accessi DB Update] Verifica schema in sola lettura...' : '[Accessi DB Update] Avvio aggiornamento database...');
         console.log(`[Accessi DB Update] Target: ${options.databaseOptions.host}:${options.databaseOptions.port} -> ${options.databaseOptions.database}`);
-        yield AccessiDatabaseUpdater_1.AccessiDatabaseUpdater.run(options);
+        if (checkOnly)
+            yield AccessiDatabaseUpdater_1.AccessiDatabaseUpdater.assertCompatible(options);
+        else {
+            yield AccessiDatabaseUpdater_1.AccessiDatabaseUpdater.run(options);
+            yield (0, menuScopeSeeder_1.applyMenuScopeSeeds)(options);
+        }
         const currentVersion = yield AccessiDatabaseUpdater_1.AccessiDatabaseUpdater.getCurrentVersion(options);
         console.log(`[Accessi DB Update] Completato. Versione corrente: ${currentVersion !== null && currentVersion !== void 0 ? currentVersion : "N/D"} | Ultima disponibile: ${AccessiDatabaseUpdater_1.AccessiDatabaseUpdater.getLatestVersion()}`);
     });
 }
-main().catch((error) => {
+main()
+    .then(() => Orm_1.Orm.closePools())
+    .then(() => process.exit(0))
+    .catch((error) => __awaiter(void 0, void 0, void 0, function* () {
     console.error("[Accessi DB Update] Errore durante l'aggiornamento:", error);
+    yield Orm_1.Orm.closePools().catch(() => undefined);
     process.exit(1);
-});
+}));
 //# sourceMappingURL=runAccessiDbUpdate.js.map

package/dist/accessi-module/database-updates/runAccessiDbUpdate.js.map

@@ -1 +1 @@
-{"version":3,"file":"runAccessiDbUpdate.js","sourceRoot":"","sources":["../../../src/accessi-module/database-updates/runAccessiDbUpdate.ts"],"names":[],"mappings":"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","sourcesContent":["import { AccessiOptions } from \"../AccessiModule\";\r\nimport { AccessiDatabaseUpdater } from \"./AccessiDatabaseUpdater\";\r\nimport { DatabaseUtilities } from \"../../Utilities\";\r\n\r\nfunction getEnv(name: string, fallback?: string): string {\r\n  const value = process.env[name] ?? fallback;\r\n  if (!value) {\r\n    throw new Error(`Variabile ambiente mancante: ${name}`);\r\n  }\r\n  return value;\r\n}\r\n\r\nfunction getOptionalBoolean(name: string, fallback: boolean): boolean {\r\n  const value = process.env[name];\r\n  if (value === undefined) {\r\n    return fallback;\r\n  }\r\n\r\n  return value.toLowerCase() === \"true\";\r\n}\r\n\r\nfunction createAccessiOptionsFromEnv(): AccessiOptions {\r\n  return {\r\n    databaseOptions: DatabaseUtilities.createOption(\r\n      getEnv(\"ACCESSI_DB_HOST\"),\r\n      Number(getEnv(\"ACCESSI_DB_PORT\", \"3050\")),\r\n      getEnv(\"ACCESSI_DB_DATABASE\"),\r\n      getEnv(\"ACCESSI_DB_USER\", \"SYSDBA\"),\r\n      getEnv(\"ACCESSI_DB_PASSWORD\", \"masterkey\")\r\n    ),\r\n    confirmationEmailUrl: getEnv(\"ACCESSI_CONFIRMATION_EMAIL_URL\", \"http://localhost\"),\r\n    confirmationEmailReturnUrl: getEnv(\"ACCESSI_CONFIRMATION_RETURN_EMAIL_URL\", \"http://localhost\"),\r\n    confirmationEmailPrefix: process.env.ACCESSI_CONFIRMATION_EMAIL_PREFIX,\r\n    customResetPage: process.env.ACCESSI_CUSTOM_RESET_PAGE,\r\n    encryptionKey: getEnv(\"ACCESSI_ENCRYPTION_KEY\", \"1234567890ABCDEF\"),\r\n    mockDemoUser: getOptionalBoolean(\"ACCESSI_MOCK_DEMO_USER\", false),\r\n    passwordExpiration: getOptionalBoolean(\"ACCESSI_PASSWORD_EXPIRATION\", false),\r\n    autoUpdateDatabase: true,\r\n    jwtOptions: {\r\n      secret: getEnv(\"ACCESSI_JWT_SECRET\", \"local-accessi-update\"),\r\n      expiresIn: getEnv(\"ACCESSI_JWT_EXPIRES\", \"24h\"),\r\n    },\r\n    emailOptions: {\r\n      host: getEnv(\"ACCESSI_EMAIL_HOST\", \"localhost\"),\r\n      port: Number(getEnv(\"ACCESSI_EMAIL_PORT\", \"25\")),\r\n      secure: getOptionalBoolean(\"ACCESSI_EMAIL_SECURE\", false),\r\n      requireTLS: getOptionalBoolean(\"ACCESSI_EMAIL_REQUIRE_TLS\", false),\r\n      tls: {\r\n        rejectUnauthorized: getOptionalBoolean(\"ACCESSI_EMAIL_TLS_REJECT_UNAUTHORIZED\", false),\r\n      },\r\n      from: getEnv(\"ACCESSI_EMAIL_FROM\", \"noreply@example.local\"),\r\n      auth: {\r\n        user: getEnv(\"ACCESSI_EMAIL_USER\", \"local-user\"),\r\n        pass: getEnv(\"ACCESSI_EMAIL_PASSWORD\", \"local-password\"),\r\n      },\r\n    },\r\n    extensionFieldsOptions: [],\r\n  };\r\n}\r\n\r\nasync function main(): Promise<void> {\r\n  const options = createAccessiOptionsFromEnv();\r\n\r\n  console.log(\"[Accessi DB Update] Avvio aggiornamento database...\");\r\n  console.log(\r\n    `[Accessi DB Update] Target: ${options.databaseOptions.host}:${options.databaseOptions.port} -> ${options.databaseOptions.database}`\r\n  );\r\n\r\n  await AccessiDatabaseUpdater.run(options);\r\n\r\n  const currentVersion = await AccessiDatabaseUpdater.getCurrentVersion(options);\r\n  console.log(\r\n    `[Accessi DB Update] Completato. Versione corrente: ${currentVersion ?? \"N/D\"} | Ultima disponibile: ${AccessiDatabaseUpdater.getLatestVersion()}`\r\n  );\r\n}\r\n\r\nmain().catch((error) => {\r\n  console.error(\"[Accessi DB Update] Errore durante l'aggiornamento:\", error);\r\n  process.exit(1);\r\n});\r\n"]}
+{"version":3,"file":"runAccessiDbUpdate.js","sourceRoot":"","sources":["../../../src/accessi-module/database-updates/runAccessiDbUpdate.ts"],"names":[],"mappings":";;;;;;;;;;;AAAA,qEAAkE;AAClE,mEAAsE;AACtE,mCAAgC;AAChC,uDAAwD;AAExD,SAAe,IAAI;;QACjB,MAAM,OAAO,GAAG,IAAA,mDAA2B,GAAE,CAAC;QAE9C,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,wDAAwD,CAAC,CAAC,CAAC,qDAAqD,CAAC,CAAC;QAC1I,OAAO,CAAC,GAAG,CACT,+BAA+B,OAAO,CAAC,eAAe,CAAC,IAAI,IAAI,OAAO,CAAC,eAAe,CAAC,IAAI,OAAO,OAAO,CAAC,eAAe,CAAC,QAAQ,EAAE,CACrI,CAAC;QAEF,IAAI,SAAS;YAAE,MAAM,+CAAsB,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;aACjE,CAAC;YACJ,MAAM,+CAAsB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC1C,MAAM,IAAA,qCAAmB,EAAC,OAAO,CAAC,CAAC;QACrC,CAAC;QAED,MAAM,cAAc,GAAG,MAAM,+CAAsB,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAC/E,OAAO,CAAC,GAAG,CACT,sDAAsD,cAAc,aAAd,cAAc,cAAd,cAAc,GAAI,KAAK,0BAA0B,+CAAsB,CAAC,gBAAgB,EAAE,EAAE,CACnJ,CAAC;IACJ,CAAC;CAAA;AAED,IAAI,EAAE;KACH,IAAI,CAAC,GAAG,EAAE,CAAC,SAAG,CAAC,UAAU,EAAE,CAAC;KAC5B,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;KAC3B,KAAK,CAAC,CAAO,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,qDAAqD,EAAE,KAAK,CAAC,CAAC;IAC5E,MAAM,SAAG,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAA,CAAC,CAAC","sourcesContent":["import { AccessiDatabaseUpdater } from \"./AccessiDatabaseUpdater\";\nimport { createAccessiOptionsFromEnv } from \"./accessiOptionsFromEnv\";\nimport { Orm } from \"../../Orm\";\nimport { applyMenuScopeSeeds } from \"./menuScopeSeeder\";\n\nasync function main(): Promise<void> {\n  const options = createAccessiOptionsFromEnv();\n\n  const checkOnly = process.argv.includes('--check');\n  console.log(checkOnly ? '[Accessi DB Update] Verifica schema in sola lettura...' : '[Accessi DB Update] Avvio aggiornamento database...');\n  console.log(\n    `[Accessi DB Update] Target: ${options.databaseOptions.host}:${options.databaseOptions.port} -> ${options.databaseOptions.database}`\n  );\n\n  if (checkOnly) await AccessiDatabaseUpdater.assertCompatible(options);\n  else {\n    await AccessiDatabaseUpdater.run(options);\n    await applyMenuScopeSeeds(options);\n  }\n\n  const currentVersion = await AccessiDatabaseUpdater.getCurrentVersion(options);\n  console.log(\n    `[Accessi DB Update] Completato. Versione corrente: ${currentVersion ?? \"N/D\"} | Ultima disponibile: ${AccessiDatabaseUpdater.getLatestVersion()}`\n  );\n}\n\nmain()\n  .then(() => Orm.closePools())\n  .then(() => process.exit(0))\n  .catch(async (error) => {\n    console.error(\"[Accessi DB Update] Errore durante l'aggiornamento:\", error);\n    await Orm.closePools().catch(() => undefined);\n    process.exit(1);\n  });\n"]}

package/dist/accessi-module/federated-auth/FederatedAuthController.d.ts

@@ -0,0 +1,33 @@
+import { Request, Response } from 'express';
+import { CreateFederatedIdentityRequest, CreateFederatedProviderRequest, CreateFederatedUserRequest, SetPasswordLoginPolicyRequest, UpdateFederatedIdentityRequest, UpdateFederatedProviderRequest } from '../Dtos/FederatedIdentityDtos';
+import { UserService } from '../Services/UserService/UserService';
+import { FederatedAuthService } from './FederatedAuthService';
+/**
+ * Master-only administration API. Authentication itself is intentionally not
+ * exposed over HTTP: the hosting backend validates its SSO and calls
+ * FederatedAuthService.authenticate({ provider, subject }) directly.
+ */
+export declare class FederatedAuthController {
+    private readonly federatedAuthService;
+    private readonly userService;
+    constructor(federatedAuthService: FederatedAuthService, userService: UserService);
+    /**
+     * Verifica che l'attore possa gestire il target (ADMIN > SUPER > utente):
+     * un superutente non puo' toccare le identita SSO di un admin.
+     */
+    private ensureManageableTarget;
+    /** Risolve il proprietario di un'identita SSO e verifica che l'attore possa gestirlo. */
+    private ensureManageableIdentity;
+    getProviders(request: Request, res: Response): Promise<Response<any, Record<string, any>>>;
+    createProvider(request: Request, body: CreateFederatedProviderRequest, res: Response): Promise<Response<any, Record<string, any>>>;
+    updateProvider(request: Request, provider: string, body: UpdateFederatedProviderRequest, res: Response): Promise<Response<any, Record<string, any>>>;
+    deleteProvider(request: Request, provider: string, res: Response): Promise<Response<any, Record<string, any>>>;
+    getIdentities(request: Request, codiceUtente: number, res: Response): Promise<Response<any, Record<string, any>>>;
+    linkIdentity(request: Request, codiceUtente: number, body: CreateFederatedIdentityRequest, res: Response): Promise<Response<any, Record<string, any>>>;
+    createUser(request: Request, body: CreateFederatedUserRequest, res: Response): Promise<Response<any, Record<string, any>>>;
+    setPasswordPolicy(request: Request, codiceUtente: number, body: SetPasswordLoginPolicyRequest, res: Response): Promise<Response<any, Record<string, any>>>;
+    disableIdentity(request: Request, identityKey: string, res: Response): Promise<Response<any, Record<string, any>>>;
+    deleteIdentity(request: Request, codiceUtente: number, identityKey: string, res: Response): Promise<Response<any, Record<string, any>>>;
+    updateIdentity(request: Request, identityKey: string, body: UpdateFederatedIdentityRequest, res: Response): Promise<Response<any, Record<string, any>>>;
+    private sendError;
+}