emilsoftware-utilities 2.0.0-dev.73 → 2.0.0-dev.75

package/docs/standalone-service.md

@@ -50,6 +50,31 @@ GET /health/metrics   -> metriche Prometheus testuali
 - `healthCheck()` degli store Redis configurati
 - `readinessChecks` aggiuntivi passati dal chiamante
 
+### Host Nest con `AccessiModule.forRoot`
+
+Un'app Nest che monta Accessi in-process ottiene gli stessi endpoint con il modulo di health:
+
+```ts
+import { AccessiModule, createAccessiHealthModule } from "emilsoftware-utilities/accessi/server";
+
+@Module({
+  imports: [
+    AccessiModule.forRoot(accessiOptions),
+    createAccessiHealthModule({
+      accessiOptions,
+      readinessChecks: [{ name: "coda", check: async () => queue.isReady() }],
+      path: "/health", // default
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+Il contratto e identico al servizio standalone (200/503, `checks` con `bootstrap`, `database`,
+store configurati e check aggiuntivi). Per un uso programmatico (senza controller) ci sono
+`checkAccessiReadiness(accessiOptions, checks)`, `createAccessiLiveReport()` e
+`readinessHttpStatus(report)`.
+
 ## Esecuzione come processo
 
 In produzione il servizio viene eseguito come processo Node gestito da systemd, PM2 o dal supervisor del cliente:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "emilsoftware-utilities",
-  "version": "2.0.0-dev.73",
+  "version": "2.0.0-dev.75",
   "description": "Utilities for EmilSoftware",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -132,14 +132,15 @@
     "accessi:serve": "ts-node src/scripts/startAccessiService.ts",
     "accessi:serve:dist": "node dist/scripts/startAccessiService.js",
     "accessi:generate-jwt-keys": "node scripts/generate-accessi-jwt-keys.cjs",
+    "accessi:rotate-jwt-keys": "node scripts/rotate-accessi-jwt-keys.cjs",
     "db:catalog:accessi": "ts-node src/accessi-module/database-updates/runAccessiCatalogMigrations.ts",
     "db:catalog:accessi:check": "ts-node src/accessi-module/database-updates/runAccessiCatalogMigrations.ts --check",
     "prepublishOnly": "npm run build",
     "typecheck": "tsc --noEmit",
     "lint": "node scripts/lint.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: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: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: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: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",
@@ -149,6 +150,7 @@
     "test:integration:fb25": "node test/integration/run-firebird.cjs 2.5",
     "test:accessi-console": "npm run build && node test/console-two-factor.cjs",
     "test:pack": "node scripts/pack-smoke-test.cjs",
+    "test:proxy-ip": "node --test test/proxy-ip.cjs test/readiness.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",