emilsoftware-utilities 2.0.0-dev.70 → 2.0.0-dev.72

package/README.MD

@@ -82,6 +82,7 @@ temi light/dark e i token Bootstrap 5.3.
 | `npm run test:coverage` | Test unitari con report e **soglie minime** di copertura |
 | `npm run test:integration` | Integration test su Firebird reale (default: porta 3055) |
 | `npm run test:integration:fb5` / `:fb3` / `:fb25` | Integration test su Firebird 5 / 3 / 2.5 |
+| `npm run test:integration:redis` | Integration test degli store Redis (opt-in, salta senza `ACCESSI_TEST_REDIS_URL`) |
 | `npm run test:accessi-console` | Test end-to-end della console (richiede un browser Chromium e la build) |
 
 ### Integration test su Firebird reale
@@ -115,6 +116,33 @@ La CI (`.github/workflows/ci.yml`) esegue typecheck, test con coverage e build,
 integration test in matrice su Firebird 5 e 3. Il workflow di release (`publish.yml`) esegue
 typecheck e test prima di build e pubblicazione.
 
+### Integration test su Redis reale
+
+Gli store condivisi (rate limit, ticket console, revoca sessioni, revoca `jti`, rotazione refresh
+token) hanno adapter Redis che nei test unitari girano su fake in memoria. La suite di integrazione
+li verifica contro un Redis reale, inclusi i `consume` atomici in concorrenza e gli `healthCheck()`.
+
+E' **opt-in**: senza la variabile `ACCESSI_TEST_REDIS_URL` i test vengono marcati come `skip`.
+
+```bash
+docker run --rm -d --name accessi-test-redis -p 6380:6379 redis:7-alpine
+npm run test:integration:redis
+docker stop accessi-test-redis
+```
+
+Su PowerShell:
+
+```powershell
+$env:ACCESSI_TEST_REDIS_URL = 'redis://127.0.0.1:6380'
+npm run test:integration:redis
+```
+
+Variabili: `ACCESSI_TEST_REDIS_URL` (formato `redis://[:password@]host:port[/db]`) e
+`ACCESSI_TEST_REQUIRE_REDIS=1` per fallire invece di saltare quando Redis non e raggiungibile
+(usato dalla CI). I test usano chiavi con prefisso per processo e cancellano solo quelle, quindi
+possono girare anche su un Redis condiviso. `docker-compose.test.yml` resta dedicato solo a
+Firebird: la CI avvia Redis come service del job `Redis stores`.
+
 ## Firebird: drop-in di `es-node-firebird`
 
 La libreria **ri-esporta l'intera API di `node-firebird`** (`export * from "node-firebird"` piu il
@@ -197,6 +225,8 @@ lista utenti apre un pannello in cui inserire l'URL dell'applicazione e generare
 | Backend Express esistente | `await initializeAccessiModule(app, accessiOptions)` monta le rotte `/api/accessi` su un host Nest isolato |
 | Applicazione NestJS | importa `AccessiModule.forRoot(accessiOptions)` (e/o `AllegatiModule.forRoot(allegatiOptions)`) |
 | Accessi + Allegati insieme | `EmilsoftwareModule.forRoot({ accessiOptions, allegatiOptions })` |
+| Client multi-istanza / multi-tenant | `createAccessiClient({ baseUrl, getToken })` isola base URL e token per istanza (concorrenza sicura); `configureAccessiClient` resta il default globale |
+| Client per scope | `accessi/client/public` (frontend), `accessi/client/admin` (tool admin), `accessi/client/service` (backend fratelli): stesse tipi del client completo, nessuna operazione fuori scope |
 
 Tutta la configurazione e riservata al backend: segreti JWT/SMTP/DB non devono mai raggiungere il browser.
 

package/dist/accessi/client/admin/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Client per le API amministrative di Accessi: utenti, ruoli, menu, scope,
+ * filtri, configurazione console, provider federati e schema.
+ *
+ * Richiede un token con privilegi admin. Per login e reset password usare
+ * `accessi/client/public`.
+ */
+import * as generated from '../generated/admin';
+import type { AccessiClientConfig } from '../../../accessi-module/Console/accessiFetch';
+import { type AccessiScopedClient } from '../createAccessiClient';
+export * from '../generated/admin';
+export * from '../../../accessi-module/Console/generated/model';
+export { AccessiRequestError } from '../../../accessi-module/Console/accessiFetch';
+export type { AccessiClientConfig } from '../../../accessi-module/Console/accessiFetch';
+/** Client admin con configurazione isolata per istanza. */
+export type AccessiAdminClient = AccessiScopedClient<typeof generated>;
+/** Crea un client delle sole API amministrative, con base URL e token propri. */
+export declare function createAccessiAdminClient(config?: AccessiClientConfig): AccessiAdminClient;

package/dist/accessi/client/admin/index.js

@@ -0,0 +1,58 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AccessiRequestError = void 0;
+exports.createAccessiAdminClient = createAccessiAdminClient;
+/**
+ * Client per le API amministrative di Accessi: utenti, ruoli, menu, scope,
+ * filtri, configurazione console, provider federati e schema.
+ *
+ * Richiede un token con privilegi admin. Per login e reset password usare
+ * `accessi/client/public`.
+ */
+const generated = __importStar(require("../generated/admin"));
+const createAccessiClient_1 = require("../createAccessiClient");
+__exportStar(require("../generated/admin"), exports);
+__exportStar(require("../../../accessi-module/Console/generated/model"), exports);
+var accessiFetch_1 = require("../../../accessi-module/Console/accessiFetch");
+Object.defineProperty(exports, "AccessiRequestError", { enumerable: true, get: function () { return accessiFetch_1.AccessiRequestError; } });
+/** Crea un client delle sole API amministrative, con base URL e token propri. */
+function createAccessiAdminClient(config = {}) {
+    return (0, createAccessiClient_1.createAccessiClientFromModule)(generated, config);
+}
+//# sourceMappingURL=index.js.map

package/dist/accessi/client/admin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/accessi/client/admin/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuBA,4DAIC;AA3BD;;;;;;GAMG;AACH,8DAAgD;AAEhD,gEAGgC;AAEhC,qDAAmC;AACnC,kFAAgE;AAChE,6EAAmF;AAA1E,mHAAA,mBAAmB,OAAA;AAM5B,iFAAiF;AACjF,SAAgB,wBAAwB,CACtC,SAA8B,EAAE;IAEhC,OAAO,IAAA,mDAA6B,EAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AAC1D,CAAC","sourcesContent":["/**\n * Client per le API amministrative di Accessi: utenti, ruoli, menu, scope,\n * filtri, configurazione console, provider federati e schema.\n *\n * Richiede un token con privilegi admin. Per login e reset password usare\n * `accessi/client/public`.\n */\nimport * as generated from '../generated/admin';\nimport type { AccessiClientConfig } from '../../../accessi-module/Console/accessiFetch';\nimport {\n  createAccessiClientFromModule,\n  type AccessiScopedClient,\n} from '../createAccessiClient';\n\nexport * from '../generated/admin';\nexport * from '../../../accessi-module/Console/generated/model';\nexport { AccessiRequestError } from '../../../accessi-module/Console/accessiFetch';\nexport type { AccessiClientConfig } from '../../../accessi-module/Console/accessiFetch';\n\n/** Client admin con configurazione isolata per istanza. */\nexport type AccessiAdminClient = AccessiScopedClient<typeof generated>;\n\n/** Crea un client delle sole API amministrative, con base URL e token propri. */\nexport function createAccessiAdminClient(\n  config: AccessiClientConfig = {},\n): AccessiAdminClient {\n  return createAccessiClientFromModule(generated, config);\n}\n"]}

package/dist/accessi/client/createAccessiClient.d.ts

@@ -0,0 +1,21 @@
+import { type AccessiClientConfig } from '../../accessi-module/Console/accessiFetch';
+/**
+ * Client generato con configurazione isolata per istanza.
+ *
+ * `TModule` e il modulo generato da Orval per lo scope: il client espone solo
+ * le operazioni di quello scope (pubblico, admin o service token).
+ */
+export type AccessiScopedClient<TModule extends object> = TModule & {
+    /** Sostituisce la configurazione dell'istanza senza toccare quella globale. */
+    configure(config: AccessiClientConfig): void;
+    /** Copia della configurazione corrente dell'istanza. */
+    getConfig(): AccessiClientConfig;
+};
+/**
+ * Avvolge un modulo generato da Orval con una configurazione per istanza.
+ *
+ * La configurazione viene applicata alla singola chiamata tramite
+ * `runWithAccessiClient`, quindi istanze diverse possono chiamare in concorrenza
+ * senza sovrascriversi. Le funzioni in `TModule` sono le sole esposte.
+ */
+export declare function createAccessiClientFromModule<TModule extends object>(api: TModule, config?: AccessiClientConfig): AccessiScopedClient<TModule>;

package/dist/accessi/client/createAccessiClient.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAccessiClientFromModule = createAccessiClientFromModule;
+const accessiFetch_1 = require("../../accessi-module/Console/accessiFetch");
+/**
+ * Avvolge un modulo generato da Orval con una configurazione per istanza.
+ *
+ * La configurazione viene applicata alla singola chiamata tramite
+ * `runWithAccessiClient`, quindi istanze diverse possono chiamare in concorrenza
+ * senza sovrascriversi. Le funzioni in `TModule` sono le sole esposte.
+ */
+function createAccessiClientFromModule(api, config = {}) {
+    let current = Object.assign({}, config);
+    return new Proxy(api, {
+        get(target, property, receiver) {
+            if (property === 'configure') {
+                return (next) => {
+                    current = Object.assign({}, next);
+                };
+            }
+            if (property === 'getConfig') {
+                return () => (Object.assign({}, current));
+            }
+            const value = Reflect.get(target, property, receiver);
+            if (typeof value !== 'function')
+                return value;
+            return (...args) => (0, accessiFetch_1.runWithAccessiClient)(current, () => value(...args));
+        },
+    });
+}
+//# sourceMappingURL=createAccessiClient.js.map

package/dist/accessi/client/createAccessiClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAccessiClient.js","sourceRoot":"","sources":["../../../src/accessi/client/createAccessiClient.ts"],"names":[],"mappings":";;AAyBA,sEAwBC;AAjDD,4EAGmD;AAenD;;;;;;GAMG;AACH,SAAgB,6BAA6B,CAC3C,GAAY,EACZ,SAA8B,EAAE;IAEhC,IAAI,OAAO,qBAA6B,MAAM,CAAE,CAAC;IAEjD,OAAO,IAAI,KAAK,CAAC,GAAmC,EAAE;QACpD,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ;YAC5B,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;gBAC7B,OAAO,CAAC,IAAyB,EAAE,EAAE;oBACnC,OAAO,qBAAQ,IAAI,CAAE,CAAC;gBACxB,CAAC,CAAC;YACJ,CAAC;YACD,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;gBAC7B,OAAO,GAAG,EAAE,CAAC,mBAAM,OAAO,EAAG,CAAC;YAChC,CAAC;YAED,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAY,CAAC;YACjE,IAAI,OAAO,KAAK,KAAK,UAAU;gBAAE,OAAO,KAAK,CAAC;YAE9C,OAAO,CAAC,GAAG,IAAe,EAAE,EAAE,CAC5B,IAAA,mCAAoB,EAAC,OAAO,EAAE,GAAG,EAAE,CAAE,KAA6C,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;QACjG,CAAC;KACF,CAAC,CAAC;AACL,CAAC","sourcesContent":["import {\n  runWithAccessiClient,\n  type AccessiClientConfig,\n} from '../../accessi-module/Console/accessiFetch';\n\n/**\n * Client generato con configurazione isolata per istanza.\n *\n * `TModule` e il modulo generato da Orval per lo scope: il client espone solo\n * le operazioni di quello scope (pubblico, admin o service token).\n */\nexport type AccessiScopedClient<TModule extends object> = TModule & {\n  /** Sostituisce la configurazione dell'istanza senza toccare quella globale. */\n  configure(config: AccessiClientConfig): void;\n  /** Copia della configurazione corrente dell'istanza. */\n  getConfig(): AccessiClientConfig;\n};\n\n/**\n * Avvolge un modulo generato da Orval con una configurazione per istanza.\n *\n * La configurazione viene applicata alla singola chiamata tramite\n * `runWithAccessiClient`, quindi istanze diverse possono chiamare in concorrenza\n * senza sovrascriversi. Le funzioni in `TModule` sono le sole esposte.\n */\nexport function createAccessiClientFromModule<TModule extends object>(\n  api: TModule,\n  config: AccessiClientConfig = {},\n): AccessiScopedClient<TModule> {\n  let current: AccessiClientConfig = { ...config };\n\n  return new Proxy(api as AccessiScopedClient<TModule>, {\n    get(target, property, receiver) {\n      if (property === 'configure') {\n        return (next: AccessiClientConfig) => {\n          current = { ...next };\n        };\n      }\n      if (property === 'getConfig') {\n        return () => ({ ...current });\n      }\n\n      const value = Reflect.get(target, property, receiver) as unknown;\n      if (typeof value !== 'function') return value;\n\n      return (...args: unknown[]) =>\n        runWithAccessiClient(current, () => (value as (...callArgs: unknown[]) => unknown)(...args));\n    },\n  });\n}\n"]}