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

package/README.MD

@@ -116,6 +116,48 @@ 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.
 
+### Packaging
+
+Il pacchetto e pubblicato come **CommonJS** (build `tsc` in `dist/`) con export map esplicita per
+ogni entry point; gli `import` ESM funzionano tramite interop Node. La scelta CJS e intenzionale:
+il pacchetto gira in host Nest/Express e non esiste un bundle ESM separato da mantenere.
+
+- `sideEffects` elenca solo i moduli con effetti collaterali (root barrel, `firebird-compat`,
+  bundle console), tutto il resto resta tree-shakable.
+- `typesVersions` copre i TypeScript precedenti al campo `exports`.
+- `npm run test:pack` crea il tarball con `npm pack`, lo installa in un progetto temporaneo e
+  verifica ogni subpath (`accessi/server`, `resource-server/*`, `client/*`, `contracts`, `openapi`,
+  `console`, `ui`), l'assenza di dipendenze server-side in `contracts` e l'interop ESM. La CI lo
+  esegue in un job dedicato dopo la build.
+
+La decisione di mantenere un pacchetto singolo (con entry point per scope) e il piano per un
+eventuale split futuro sono documentati nell'[ADR 0001](docs/adr/0001-split-package.md).
+
+### OpenAPI semantic diff
+
+`docs/accessi-openapi-fingerprint.json` blocca la rimozione di operation e schema, ma non i cambi
+di tipo o le nuove restrizioni. Il build esegue anche un diff semantico contro
+`docs/accessi-openapi-baseline.json`:
+
+```bash
+npm run check:accessi-openapi-diff     # verifica (eseguita dal build e dalla CI)
+npm run accessi:update-openapi-baseline  # accetta il contratto corrente come nuova baseline
+```
+
+Sono **breaking**: operation/parametri/risposte rimosse, cambi di tipo o formato, `required` aggiunto
+in input o rimosso in output, valori enum rimossi, `security` cambiata e vincoli piu stretti
+sull'input. Aggiungere campi opzionali (input o output) non e breaking.
+
+Un breaking change intenzionale va dichiarato in
+`docs/accessi-openapi-breaking-allowlist.json` con `id`, `reason` (obbligatoria) e, se esiste, `issue`:
+
+```json
+[{ "id": "operation:legacyLogin:removed", "reason": "Rimosso nella major 3.0", "issue": "#123" }]
+```
+
+La CI fallisce se un breaking change non e coperto, se un'eccezione non ha `reason` o se l'eccezione
+e diventata obsoleta (il cambio non esiste piu).
+
 ### Integration test su Redis reale
 
 Gli store condivisi (rate limit, ticket console, revoca sessioni, revoca `jti`, rotazione refresh
@@ -226,6 +268,7 @@ lista utenti apre un pannello in cui inserire l'URL dell'applicazione e generare
 | 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"]}