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

package/dist/scripts/generateAccessiOpenApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateAccessiOpenApi.js","sourceRoot":"","sources":["../../src/scripts/generateAccessiOpenApi.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAAA,6CAAiE;AACjE,uCAA2C;AAC3C,+DAA0D;AAC1D,sDAA8B;AAC9B,0CAA+C;AAC/C,+BAA4B;AAC5B,mEAAgF;AAEhF;;;GAGG;AACH,SAAe,sBAAsB;;QACnC,MAAM,OAAO,GAAmB;YAC9B,eAAe,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE;YACvF,oBAAoB,EAAE,uBAAuB;YAC7C,0BAA0B,EAAE,uBAAuB;YACnD,aAAa,EAAE,yBAAyB;YACxC,YAAY,EAAE,KAAK;YACnB,kBAAkB,EAAE,KAAK;YACzB,gCAAgC,EAAE,KAAK;YACvC,UAAU,EAAE,EAAE,MAAM,EAAE,yBAAyB,EAAE,SAAS,EAAE,IAAI,EAAE;YAClE,YAAY,EAAE;gBACZ,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK;gBAC7D,GAAG,EAAE,EAAE,kBAAkB,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,uBAAuB,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;aAC/F;YACD,uBAAuB,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE;SAC5C,CAAC;QAEF,MAAM,GAAG,GAAG,MAAM,kBAAW,CAAC,MAAM,CAClC,6BAAa,CAAC,OAAO,CAAC,OAAO,CAAC,EAC9B,IAAI,iCAAc,CAAC,IAAA,iBAAO,GAAE,CAAC,EAC7B,EAAE,MAAM,EAAE,KAAK,EAAE,CAClB,CAAC;QACF,GAAG,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QAC3B,2EAA2E;QAE3E,MAAM,QAAQ,GAAG,uBAAa,CAAC,cAAc,CAC3C,GAAG,EACH,IAAI,yBAAe,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,CACxF,CAAC;QACF,MAAM,eAAe,GAAG,IAAA,WAAI,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,SAAS,CAAC,CAAC;QAChF,MAAM,IAAA,gBAAK,EAAC,eAAe,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,MAAM,IAAA,oBAAS,EAAC,IAAA,WAAI,EAAC,eAAe,EAAE,sBAAsB,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QACzG,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;CAAA;AAED,sBAAsB,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACvC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC","sourcesContent":["import { DocumentBuilder, SwaggerModule } from '@nestjs/swagger';\nimport { NestFactory } from '@nestjs/core';\nimport { ExpressAdapter } from '@nestjs/platform-express';\nimport express from 'express';\nimport { mkdir, writeFile } from 'fs/promises';\nimport { join } from 'path';\nimport { AccessiModule, AccessiOptions } from '../accessi-module/AccessiModule';\n\n/**\n * Esporta il contratto OpenAPI dai decorator Nest senza avviare il database.\n * Il file risultante e l'unica sorgente per il client Orval della console.\n */\nasync function generateAccessiOpenApi(): Promise<void> {\n  const options: AccessiOptions = {\n    databaseOptions: { host: 'openapi-generation', database: 'not-used', user: 'not-used' },\n    confirmationEmailUrl: 'https://invalid.local',\n    confirmationEmailReturnUrl: 'https://invalid.local',\n    encryptionKey: 'openapi-generation-only',\n    mockDemoUser: false,\n    autoUpdateDatabase: false,\n    legacyPasswordMigrationOnStartup: false,\n    jwtOptions: { secret: 'openapi-generation-only', expiresIn: '1h' },\n    emailOptions: {\n      host: 'localhost', port: 25, secure: false, requireTLS: false,\n      tls: { rejectUnauthorized: true }, from: 'openapi@invalid.local', auth: { user: '', pass: '' },\n    },\n    federatedAuthentication: { enabled: false },\n  };\n\n  const app = await NestFactory.create(\n    AccessiModule.forRoot(options),\n    new ExpressAdapter(express()),\n    { logger: false },\n  );\n  app.setGlobalPrefix('api');\n  // Decorator inspection requires no lifecycle hooks or database connection.\n\n  const document = SwaggerModule.createDocument(\n    app,\n    new DocumentBuilder().setTitle('Accessi API').setVersion('1.0').addBearerAuth().build(),\n  );\n  const outputDirectory = join(process.cwd(), 'src', 'accessi-module', 'openapi');\n  await mkdir(outputDirectory, { recursive: true });\n  await writeFile(join(outputDirectory, 'accessi.openapi.json'), `${JSON.stringify(document, null, 2)}\\n`);\n  await app.close();\n}\n\ngenerateAccessiOpenApi().catch((error) => {\n  console.error(error);\n  process.exitCode = 1;\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/scripts/startAccessiService.d.ts

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

package/dist/scripts/startAccessiService.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const server_1 = require("../accessi/server");
+const Logger_1 = require("../Logger");
+(0, server_1.startAccessiService)().catch((error) => {
+    new Logger_1.Logger('startAccessiService').error('Avvio Accessi Service fallito:', error instanceof Error
+        ? { name: error.name, message: error.message, stack: error.stack }
+        : { error: String(error) });
+    process.exitCode = 1;
+});
+//# sourceMappingURL=startAccessiService.js.map

package/dist/scripts/startAccessiService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startAccessiService.js","sourceRoot":"","sources":["../../src/scripts/startAccessiService.ts"],"names":[],"mappings":";;AAAA,8CAAwD;AACxD,sCAAmC;AAEnC,IAAA,4BAAmB,GAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC7C,IAAI,eAAM,CAAC,qBAAqB,CAAC,CAAC,KAAK,CACrC,gCAAgC,EAChC,KAAK,YAAY,KAAK;QACpB,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE;QAClE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAC7B,CAAC;IACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC","sourcesContent":["import { startAccessiService } from '../accessi/server';\nimport { Logger } from '../Logger';\n\nstartAccessiService().catch((error: unknown) => {\n  new Logger('startAccessiService').error(\n    'Avvio Accessi Service fallito:',\n    error instanceof Error\n      ? { name: error.name, message: error.message, stack: error.stack }\n      : { error: String(error) },\n  );\n  process.exitCode = 1;\n});\n"]}

package/docs/accessi-openapi-fingerprint.json

@@ -0,0 +1,192 @@
+{
+  "paths": [
+    "DELETE /api/accessi/federated-auth/identities/{identityKey} disableFederatedIdentity",
+    "DELETE /api/accessi/federated-auth/providers/{provider} deleteFederatedProvider",
+    "DELETE /api/accessi/federated-auth/users/{codiceUtente}/identities/{identityKey} deleteFederatedIdentityPermanently",
+    "DELETE /api/accessi/filtri/tipi/{tipFil} deleteTipoFiltro",
+    "DELETE /api/accessi/permission/delete-role/{codiceRuolo} deleteRole",
+    "DELETE /api/accessi/permission/menu-groups/{codiceGruppo} deleteMenuGroup",
+    "DELETE /api/accessi/permission/menu-types/{codiceTipo} deleteMenuType",
+    "DELETE /api/accessi/permission/menus/{codiceMenu} deleteMenu",
+    "DELETE /api/accessi/permission/scopes/{codiceScope} deleteScope",
+    "DELETE /api/accessi/service-token/{tokenId} revokeServiceToken",
+    "DELETE /api/accessi/user/delete-user-permanent/{codiceUtente} deleteUserPermanently",
+    "DELETE /api/accessi/user/delete-user/{codiceUtente} deleteUser",
+    "GET /api/accessi/auth/bootstrap-admin/status getAdminBootstrapStatus",
+    "GET /api/accessi/email/reset-password-page/{token} serveResetPasswordPage",
+    "GET /api/accessi/federated-auth/providers getFederatedProviders",
+    "GET /api/accessi/federated-auth/users/{codiceUtente}/identities getFederatedIdentities",
+    "GET /api/accessi/filtri/tipi getTipiFiltro",
+    "GET /api/accessi/filtri/utente getFiltriUtente",
+    "GET /api/accessi/permission/grants/{codiceUtente} getUserRolesAndGrants",
+    "GET /api/accessi/permission/groups-with-menus getGroupsWithMenus",
+    "GET /api/accessi/permission/menu-types getMenuTypes",
+    "GET /api/accessi/permission/menus getMenus",
+    "GET /api/accessi/permission/menus/{codiceMenu}/scopes getMenuScopes",
+    "GET /api/accessi/permission/roles getRoles",
+    "GET /api/accessi/permission/scopes getScopes",
+    "GET /api/accessi/schema getSchema",
+    "GET /api/accessi/service-token getServiceTokens",
+    "GET /api/accessi/user/get-users getUsers",
+    "GET /api/accessi/user/reset-password/{token} serveResetPasswordPageUser",
+    "PATCH /api/accessi/configurator/groups/{codiceGruppo}/enabled setGroupEnabled",
+    "PATCH /api/accessi/configurator/menus/{codiceMenu}/enabled setMenuEnabled",
+    "PATCH /api/accessi/federated-auth/identities/{identityKey} updateFederatedIdentity",
+    "PATCH /api/accessi/federated-auth/providers/{provider} updateFederatedProvider",
+    "PATCH /api/accessi/federated-auth/users/{codiceUtente}/password-login setPasswordLoginPolicy",
+    "PATCH /api/accessi/user/set-gdpr/{codiceUtente} setGdpr",
+    "POST /api/accessi/auth/bootstrap-admin bootstrapAdmin",
+    "POST /api/accessi/auth/confirm-reset-password/{token} resetPassword",
+    "POST /api/accessi/auth/get-user-by-token getUserByToken",
+    "POST /api/accessi/auth/introspect introspectAccessiToken",
+    "POST /api/accessi/auth/login login",
+    "POST /api/accessi/auth/refresh refreshAccessToken",
+    "POST /api/accessi/auth/revoke-sessions revokeSessions",
+    "POST /api/accessi/auth/revoke-token revokeToken",
+    "POST /api/accessi/auth/two-factor/resend resendTwoFactor",
+    "POST /api/accessi/auth/two-factor/verify verifyTwoFactor",
+    "POST /api/accessi/console/entry createConsoleEntryTicket",
+    "POST /api/accessi/console/entry/exchange exchangeConsoleEntryTicket",
+    "POST /api/accessi/email/send-reset-password-email sendPasswordResetEmail",
+    "POST /api/accessi/federated-auth/exchange exchangeFederatedIdentity",
+    "POST /api/accessi/federated-auth/providers createFederatedProvider",
+    "POST /api/accessi/federated-auth/users createFederatedUser",
+    "POST /api/accessi/federated-auth/users/{codiceUtente}/identities linkFederatedIdentity",
+    "POST /api/accessi/filtri/tipi createTipoFiltro",
+    "POST /api/accessi/filtri/utente saveFiltriUtente",
+    "POST /api/accessi/permission/assign-permissions/{codiceUtente} assignPermissionsToUser",
+    "POST /api/accessi/permission/assign-roles/{codiceUtente} assignRolesToUser",
+    "POST /api/accessi/permission/create-role createRole",
+    "POST /api/accessi/permission/menu-groups createMenuGroup",
+    "POST /api/accessi/permission/menu-types createMenuType",
+    "POST /api/accessi/permission/menus createMenu",
+    "POST /api/accessi/permission/scopes createScope",
+    "POST /api/accessi/service-token createServiceToken",
+    "POST /api/accessi/service-token/{tokenId}/rotate rotateServiceToken",
+    "POST /api/accessi/user/create-managed-user createManagedUser",
+    "POST /api/accessi/user/force-password-reset-legacy forcePasswordResetLegacy",
+    "POST /api/accessi/user/force-password-reset/{codiceUtente} forcePasswordReset",
+    "POST /api/accessi/user/login-as/{codiceUtente} createLoginAsUrl",
+    "POST /api/accessi/user/register register",
+    "POST /api/accessi/user/set-password/{codiceUtente} setUserPassword",
+    "POST /api/accessi/user/set-stato setStatoRegistrazione",
+    "PUT /api/accessi/filtri/tipi/{tipFil} updateTipoFiltro",
+    "PUT /api/accessi/permission/menu-groups/{codiceGruppo} updateMenuGroup",
+    "PUT /api/accessi/permission/menu-types/{codiceTipo} updateMenuType",
+    "PUT /api/accessi/permission/menus/{codiceMenu} updateMenu",
+    "PUT /api/accessi/permission/menus/{codiceMenu}/scopes setMenuScopes",
+    "PUT /api/accessi/permission/scopes/{codiceScope} updateScope",
+    "PUT /api/accessi/permission/scopes/{codiceScope}/menus setScopeMenus",
+    "PUT /api/accessi/permission/update-role/{codiceRuolo} updateRole",
+    "PUT /api/accessi/user/update-user/{codiceUtente} updateUtente"
+  ],
+  "schemas": [
+    "AbilitazioneMenu",
+    "AccessiIntrospectionResultDto",
+    "ActionResponse",
+    "AdminBootstrapStatusResponse",
+    "AdminBootstrapStatusResult",
+    "AssignPermissionsToUserRequest",
+    "AssignRolesToUserRequest",
+    "AuthenticatedTokenPayloadDto",
+    "AuthenticatedUserPayloadDto",
+    "BootstrapAdminRequest",
+    "BootstrapAdminResponse",
+    "BootstrapAdminResultDto",
+    "ConfirmResetPasswordRequest",
+    "ConsoleEntryExchangeRequest",
+    "ConsoleEntrySessionResponse",
+    "ConsoleEntrySessionResult",
+    "ConsoleEntryTicketResponse",
+    "ConsoleEntryTicketResult",
+    "ConsoleEntryTokenResult",
+    "CreateFederatedIdentityRequest",
+    "CreateFederatedProviderRequest",
+    "CreateFederatedUserRequest",
+    "CreateFilterTypeRequest",
+    "CreateMenuGroupRequest",
+    "CreateMenuRequest",
+    "CreateMenuTypeRequest",
+    "CreateScopeRequest",
+    "CreateServiceTokenRequest",
+    "CreateServiceTokenResponse",
+    "ErrorResponse",
+    "ExchangeFederatedIdentityRequest",
+    "FederatedAuthenticationResultDto",
+    "FederatedExchangeResponse",
+    "FederatedIdentityListResponse",
+    "FederatedIdentityResponse",
+    "FederatedIdentityResponseDto",
+    "FederatedProviderListResponse",
+    "FederatedProviderResponse",
+    "FederatedProviderResponseDto",
+    "FiltriUtente",
+    "GetFiltriResponse",
+    "GetFiltriUtenteResponse",
+    "GetGroupsWithMenusResponse",
+    "GetMenuScopesResponse",
+    "GetMenuTypesResponse",
+    "GetMenusResponse",
+    "GetRolesResponse",
+    "GetSchemaResponse",
+    "GetScopesResponse",
+    "GetServiceTokensResponse",
+    "GetUserByTokenRequest",
+    "GetUserByTokenResponse",
+    "GetUsersResponse",
+    "GetUsersResult",
+    "GroupWithMenusEntity",
+    "IntrospectAccessiTokenRequest",
+    "IntrospectAccessiTokenResponse",
+    "IssuedServiceTokenDto",
+    "LoginAsRequest",
+    "LoginAsResponse",
+    "LoginAsResult",
+    "LoginRequest",
+    "LoginResponse",
+    "LoginResult",
+    "MenuEntity",
+    "MenuTypeEntity",
+    "PasswordExpiredResponse",
+    "Permission",
+    "PublicRegisterRequest",
+    "RefreshTokenRequest",
+    "RefreshTokenResponse",
+    "RefreshTokenResult",
+    "RegisterRequest",
+    "RegisterResponse",
+    "ResendTwoFactorRequest",
+    "RevokeTokenRequest",
+    "Role",
+    "RuoliMenu",
+    "SchemaDdlResult",
+    "SchemaDdlSection",
+    "ScopeEntity",
+    "SendResetPasswordEmailRequest",
+    "ServiceTokenDto",
+    "SetMenuScopesRequest",
+    "SetPasswordLoginPolicyRequest",
+    "SetScopeMenusRequest",
+    "SetStatoRegistrazioneDto",
+    "SetUserPasswordRequest",
+    "Status",
+    "TipoFiltro",
+    "TokenResult",
+    "TwoFactorChallengeDto",
+    "UpdateEnabledStatusRequest",
+    "UpdateFederatedIdentityRequest",
+    "UpdateFederatedProviderRequest",
+    "UpdateFilterTypeRequest",
+    "UpdateMenuGroupRequest",
+    "UpdateMenuRequest",
+    "UpdateMenuTypeRequest",
+    "UpdateScopeRequest",
+    "UserDto",
+    "UserGrantsDto",
+    "UserGrantsResponse",
+    "VerifyTwoFactorRequest"
+  ],
+  "securitySchemes": [
+    "bearer"
+  ]
+}

package/docs/gateway-rate-limit.md

@@ -0,0 +1,98 @@
+# Gateway rate limit per Accessi Service
+
+Il rate limit applicativo di Accessi protegge login, 2FA, reset password, console entry e service token. Il gateway/API gateway resta utile per una protezione per IP, connessioni e bot prima che la richiesta raggiunga Node.
+
+Regole consigliate:
+
+- `/api/accessi/auth/*`: soglia bassa, burst contenuto
+- `/api/accessi/console/entry/exchange`: soglia bassa
+- `/api/accessi/*`: soglia media
+- `/accessi/openapi*` e `/accessi/.well-known/jwks.json`: soglia alta o cache CDN
+
+## Nginx
+
+```nginx
+limit_req_zone $binary_remote_addr zone=accessi_auth:10m rate=2r/s;
+limit_req_zone $binary_remote_addr zone=accessi_api:10m rate=10r/s;
+limit_conn_zone $binary_remote_addr zone=accessi_conn:10m;
+
+server {
+    # Se Accessi e dietro un proxy/load balancer, configura real_ip
+    # prima di usare $binary_remote_addr.
+
+    location /api/accessi/auth/ {
+        limit_req zone=accessi_auth burst=10 nodelay;
+        limit_conn accessi_conn 20;
+        proxy_pass http://accessi_service;
+    }
+
+    location /api/accessi/ {
+        limit_req zone=accessi_api burst=50 nodelay;
+        limit_conn accessi_conn 20;
+        proxy_pass http://accessi_service;
+    }
+
+    location /accessi/ {
+        limit_req zone=accessi_api burst=50 nodelay;
+        proxy_pass http://accessi_service;
+    }
+}
+```
+
+## Traefik
+
+```yaml
+http:
+  middlewares:
+    accessi-auth-ratelimit:
+      rateLimit:
+        average: 2
+        burst: 10
+        period: 1s
+    accessi-api-ratelimit:
+      rateLimit:
+        average: 10
+        burst: 50
+        period: 1s
+  routers:
+    accessi-auth:
+      rule: PathPrefix(`/api/accessi/auth/`)
+      middlewares: [accessi-auth-ratelimit]
+      service: accessi
+    accessi-api:
+      rule: PathPrefix(`/api/accessi/`) || PathPrefix(`/accessi/`)
+      middlewares: [accessi-api-ratelimit]
+      service: accessi
+```
+
+## Cloudflare
+
+Regole di rate limiting:
+
+- path `/api/accessi/auth/*`: 10 richieste/minuto per IP, azione `managed challenge`
+- path `/api/accessi/console/entry/exchange`: 30 richieste/5 minuti per IP
+- path `/api/accessi/*`: 300 richieste/minuto per IP, azione `block`
+- path `/accessi/.well-known/jwks.json`: cache CDN, limite alto
+
+Aggiungere bot fight mode/WAF secondo il piano disponibile.
+
+## AWS WAF / API Gateway
+
+- rate-based rule: 300 richieste/5 minuti per IP
+- scope-down statement: `URI starts with /api/accessi`
+- regola più severa su `/api/accessi/auth/*`
+- AWS Shield/WAF Bot Control se disponibile
+
+## Rapporto con `edgeRateLimit` della libreria
+
+`edgeRateLimit` e un ultimo livello applicativo:
+
+- usa lo stesso `RateLimitStore` Redis dei rate limit per account;
+- copre Accessi anche se il gateway non ha regole specifiche;
+- non sostituisce WAF, bot protection, limiti di connessione o protezione DDoS.
+
+In produzione usare entrambi:
+
+```text
+Client -> CDN/WAF -> API gateway -> edgeRateLimit Accessi -> rate limit per account
+```

package/docs/standalone-service.md

@@ -0,0 +1,176 @@
+# Accessi Service standalone
+
+Accessi puo girare come servizio autonomo, senza un backend ospitante.
+
+## Avvio da codice
+
+```ts
+import { startAccessiService } from "emilsoftware-utilities/accessi/server";
+
+await startAccessiService({
+  port: Number(process.env.PORT ?? 3000),
+  healthPath: "/health",
+  metrics: true,
+});
+```
+
+`startAccessiService`:
+
+- valida `AccessiOptions` con `assertValidAccessiOptions`
+- crea l'app Express
+- monta `/health/live`, `/health/ready`, `/health/metrics`
+- inizializza Accessi
+- avvia il server
+- registra `SIGTERM`/`SIGINT` per lo shutdown graceful
+- chiude Nest e i pool Firebird
+
+Per un controllo manuale usare `createAccessiService`, che restituisce `start()` e `stop()`.
+
+## Avvio da CLI
+
+```bash
+npm run accessi:serve
+npm run accessi:serve:dist
+```
+
+La configurazione viene letta da `createAccessiOptionsFromEnv()`.
+
+## Health
+
+```text
+GET /health/live      -> 200 se il processo e vivo
+GET /health/ready     -> 200 se DB e store configurati sono pronti
+GET /health/metrics   -> metriche Prometheus testuali
+```
+
+`/health/ready` controlla:
+
+- bootstrap completato
+- database Accessi raggiungibile e schema inizializzato
+- `healthCheck()` degli store Redis configurati
+- `readinessChecks` aggiuntivi passati dal chiamante
+
+## Esecuzione come processo
+
+In produzione il servizio viene eseguito come processo Node gestito da systemd, PM2 o dal supervisor del cliente:
+
+```bash
+npm run accessi:serve:dist
+# oppure
+node dist/scripts/startAccessiService.js
+```
+
+Esempio systemd minimale:
+
+```ini
+[Unit]
+Description=Accessi Service
+After=network.target
+
+[Service]
+WorkingDirectory=/opt/accessi-service
+EnvironmentFile=/etc/accessi/accessi.env
+ExecStart=/usr/bin/node dist/scripts/startAccessiService.js
+Restart=on-failure
+RestartSec=5
+KillSignal=SIGTERM
+TimeoutStopSec=15
+
+[Install]
+WantedBy=multi-user.target
+```
+
+Il readiness endpoint `/health/ready` va usato dal load balancer o dal supervisore per decidere quando inviare traffico.
+
+## Configurazione consigliata
+
+- `ACCESSI_DB_*`
+- `ACCESSI_ENCRYPTION_KEY`
+- `ACCESSI_JWT_SECRET`
+- `ACCESSI_JWT_ISSUER`
+- `ACCESSI_JWT_AUDIENCE`
+- `ACCESSI_JWT_ALGORITHM`, `ACCESSI_JWT_PRIVATE_KEY`, `ACCESSI_JWT_PUBLIC_KEY`, `ACCESSI_JWT_KEY_ID` per RS/ES
+- `ACCESSI_JWKS_PATH`
+- SMTP
+- `PORT`
+
+Per Redis, passare gli store nel bootstrap applicativo:
+
+```ts
+import { createRedisRateLimitStore, createRedisConsoleEntryStore } from "emilsoftware-utilities/accessi/server";
+```
+
+## Generazione chiavi JWT
+
+```bash
+npm run accessi:generate-jwt-keys -- --algorithm RS256 --out ./keys
+```
+
+Genera:
+
+- `jwt-private.pem`
+- `jwt-public.pem`
+- `jwks.json`
+- `jwt-keys.json` con `algorithm` e `keyId`
+
+Configurare poi:
+
+```env
+ACCESSI_JWT_ALGORITHM=RS256
+ACCESSI_JWT_PRIVATE_KEY=<contenuto jwt-private.pem>
+ACCESSI_JWT_PUBLIC_KEY=<contenuto jwt-public.pem>
+ACCESSI_JWT_KEY_ID=<keyId>
+```
+
+## Revoca sessioni
+
+```ts
+import { createRedisSessionRevocationStore } from "emilsoftware-utilities/accessi/server";
+
+sessionRevocation: {
+  store: createRedisSessionRevocationStore({
+    client: redis,
+    ttlMs: 30 * 24 * 60 * 60 * 1000, // maggiore della durata massima dei token
+  }),
+}
+```
+
+Endpoint utente:
+
+```http
+POST /api/accessi/auth/revoke-sessions
+Authorization: Bearer <access-token>
+```
+
+I resource server fratelli devono ricevere lo stesso store in `revocation.store`.
+
+## Console su dominio separato
+
+Se la console è servita da un dominio diverso dall’API:
+
+```ts
+accessiOptions: {
+  ...options,
+  consoleApiBaseUrl: "https://accessi.example.com",
+}
+```
+
+Accessi inietta `window.__ACCESSI_API_BASE_URL__` nella pagina della console.
+
+## CORS e proxy
+
+```ts
+accessiOptions: {
+  ...options,
+  http: {
+    cors: {
+      origin: ["https://app.example.com"],
+      credentials: false,
+    },
+    trustProxy: 1, // load balancer/reverse proxy
+    securityHeaders: true,
+  },
+}
+```
+
+Con Bearer token non serve CSRF. Se in futuro si passasse a cookie httpOnly, aggiungere CSRF e configurazione cookie same-site.