emilsoftware-utilities 2.0.0-dev.82 → 2.0.0-dev.84

package/docs/multi-tenancy.md

@@ -126,8 +126,25 @@ Avvia un processo figlio per ogni tenant abilitato:
 - non riavvia automaticamente un figlio: un loop su configurazione rotta è
   peggio di un processo che resta giù; usare systemd/docker/Kubernetes.
 
-Il supervisore legge la cartella all'avvio: **aggiungere o rimuovere un tenant
-richiede un riavvio**. Non c'è hot reload (Nest non smonta moduli a caldo).
+Il supervisore legge la cartella all'avvio. Con `--watch` osserva i file
+`*.environment.ts` e riapplica la configurazione:
+
+```bash
+npm run accessi:tenants -- --dir ./tenants --serve --watch
+```
+
+Regole:
+
+- un file invalido annulla il reload e lascia attivi i tenant correnti;
+- i tenant invariati non vengono riavviati;
+- un tenant modificato viene riavviato sulla stessa porta (breve interruzione);
+- aggiunte e rimozioni avviano/fermano solo il tenant interessato;
+- il polling è di 1 secondo con debounce di 200 ms (`pollIntervalMs`/
+  `debounceMs` nell'API del supervisore).
+
+Senza `--watch` un cambiamento richiede il riavvio del supervisore. Non c'è
+montaggio/smontaggio di moduli Nest a caldo: il reload riavvia i processi
+interessati, non l'intero servizio.
 
 ### systemd (consigliato in produzione)
 
@@ -258,6 +275,54 @@ proxy_set_header X-Accessi-Tenant acme;
 e avviare il router con `allowHeader: true` solo nel servizio che si fida del
 proxy.
 
+## Router in-process (opt-in, fase 4)
+
+In alternativa al processo per tenant, un host può montare più app Accessi nello
+stesso processo e usare `createAccessiTenantRouter`:
+
+```ts
+import {
+  configureAccessiTenantAudit,
+  createAccessiService,
+  createAccessiTenantRouter,
+  loadAccessiTenants,
+} from 'emilsoftware-utilities/accessi/server';
+
+const registry = loadAccessiTenants({ directory: './tenants' });
+const acmeService = await createAccessiService({ accessiOptions: acmeOptions });
+const betaService = await createAccessiService({ accessiOptions: betaOptions });
+
+configureAccessiTenantAudit('acme', { store: acmeAuditStore, logger: false });
+configureAccessiTenantAudit('beta', { store: betaAuditStore, logger: false });
+
+const router = createAccessiTenantRouter({
+  registry,
+  handlers: { acme: acmeService.app, beta: betaService.app },
+  allowHeader: false,
+});
+app.use('/api/accessi', router);
+```
+
+Comportamento:
+
+- risoluzione host → path → header fidato, senza fallback;
+- `req.accessiTenant` contiene il tenant risolto;
+- il handler gira dentro `runWithAccessiTenant`, quindi audit e metriche
+  ricevono il label `tenant`;
+- tenant sconosciuto → `404 ACCESSI_TENANT_NOT_FOUND`;
+- tenant senza handler → `501 ACCESSI_TENANT_HANDLER_MISSING`.
+
+Limiti importanti:
+
+- le app devono essere indipendenti (un `createAccessiService` per tenant);
+- le API globali `authorizeAccessi` e `setAccessiAuthService` usano l'ultima
+  istanza inizializzata: in modalità router non sono tenant-aware e vanno
+  evitate; usare i guard/middleware dell'app del tenant;
+- audit e metriche di background (fuori da una richiesta) usano la
+  configurazione di default del processo;
+- il processo-per-tenant resta il default raccomandato: il router è opt-in e
+  non riduce i pool Firebird se le app sono comunque tutte inizializzate.
+
 ## Store Redis condivisi
 
 Con Redis condiviso usare l'helper: crea tutti gli store con prefissi
@@ -332,7 +397,8 @@ schema.
 ## Limiti
 
 - Un processo per tenant: più RAM, più pool Firebird, più connessioni SMTP.
-- Nessun hot reload: aggiunta/rimozione richiede restart.
+- Il reload con `--watch` riavvia i processi modificati sulla stessa porta: c'è
+  una breve interruzione per il singolo tenant, non per gli altri.
 - Migrazioni e backup per database.
 - La risoluzione via header è ammessa solo dietro proxy fidato; il client non
   deve poter scegliere il tenant.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "emilsoftware-utilities",
-  "version": "2.0.0-dev.82",
+  "version": "2.0.0-dev.84",
   "description": "Utilities for EmilSoftware",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -141,8 +141,8 @@
     "lint": "node scripts/lint.cjs",
     "check:deploy": "node scripts/check-deploy-templates.cjs",
     "test": "npm run typecheck && npm run lint && npm run test:unit",
-    "test:unit": "node --test test/angular-components.cjs test/menus-catalog.mjs test/menu-scopes.cjs 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-email-config.cjs test/accessi-catalog-scripts.cjs test/openapi-config.cjs test/resource-server.cjs test/accessi-security-standards.cjs test/accessi-service.cjs test/refresh-token.cjs test/token-revocation.cjs test/accessi-client.cjs test/accessi-client-scopes.cjs test/openapi-semantic-diff.cjs test/proxy-ip.cjs test/readiness.cjs test/jwt-key-rotation.cjs test/security-headers.cjs test/auth-cookies.cjs test/metrics.cjs test/audit.cjs test/import-entrypoints.cjs test/tenants.cjs test/tenant-stores.cjs test/deploy-templates.cjs",
-    "test:coverage": "node --experimental-test-coverage --test-coverage-lines=50 --test-coverage-functions=60 --test-coverage-branches=60 --test test/angular-components.cjs test/menus-catalog.mjs test/menu-scopes.cjs 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-email-config.cjs test/accessi-catalog-scripts.cjs test/openapi-config.cjs test/resource-server.cjs test/accessi-security-standards.cjs test/accessi-service.cjs test/refresh-token.cjs test/token-revocation.cjs test/accessi-client.cjs test/accessi-client-scopes.cjs test/openapi-semantic-diff.cjs test/proxy-ip.cjs test/readiness.cjs test/jwt-key-rotation.cjs test/security-headers.cjs test/auth-cookies.cjs test/metrics.cjs test/audit.cjs test/import-entrypoints.cjs test/tenants.cjs test/tenant-stores.cjs test/deploy-templates.cjs",
+    "test:unit": "node --test test/angular-components.cjs test/menus-catalog.mjs test/menu-scopes.cjs 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-email-config.cjs test/accessi-catalog-scripts.cjs test/openapi-config.cjs test/resource-server.cjs test/accessi-security-standards.cjs test/accessi-service.cjs test/refresh-token.cjs test/token-revocation.cjs test/accessi-client.cjs test/accessi-client-scopes.cjs test/openapi-semantic-diff.cjs test/proxy-ip.cjs test/readiness.cjs test/jwt-key-rotation.cjs test/security-headers.cjs test/auth-cookies.cjs test/metrics.cjs test/audit.cjs test/import-entrypoints.cjs test/tenants.cjs test/tenant-stores.cjs test/deploy-templates.cjs test/tenant-supervisor.cjs test/tenant-router.cjs",
+    "test:coverage": "node --experimental-test-coverage --test-coverage-lines=50 --test-coverage-functions=60 --test-coverage-branches=60 --test test/angular-components.cjs test/menus-catalog.mjs test/menu-scopes.cjs 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-email-config.cjs test/accessi-catalog-scripts.cjs test/openapi-config.cjs test/resource-server.cjs test/accessi-security-standards.cjs test/accessi-service.cjs test/refresh-token.cjs test/token-revocation.cjs test/accessi-client.cjs test/accessi-client-scopes.cjs test/openapi-semantic-diff.cjs test/proxy-ip.cjs test/readiness.cjs test/jwt-key-rotation.cjs test/security-headers.cjs test/auth-cookies.cjs test/metrics.cjs test/audit.cjs test/import-entrypoints.cjs test/tenants.cjs test/tenant-stores.cjs test/deploy-templates.cjs test/tenant-supervisor.cjs test/tenant-router.cjs",
     "test:accessi": "npm run test:unit",
     "test:all": "npm test && npm run test:integration && npm run test:integration:redis",
     "test:integration": "node test/integration/run-firebird.cjs 5",