@generazioneai/events 0.1.0 → 0.3.0

package/dist/drizzle/store.d.ts

@@ -0,0 +1,51 @@
+import { type SQL } from 'drizzle-orm';
+import { type OutboxInsert, type OutboxRow, type OutboxStore, type OutboxTransactionOptions } from '../store';
+/** Il pezzo di una transazione (o del client) di Drizzle che serve alla libreria: eseguire SQL. Vale per `postgres-js`, `node-postgres` e PGlite. */
+export interface DrizzleExecutor {
+    execute(query: SQL): PromiseLike<unknown>;
+}
+/** Il client di Drizzle (`drizzle(...)`) o un oggetto con la stessa forma, p.es. un wrapper che apre la transazione con lo scope che serve al servizio. */
+export interface DrizzleDbLike extends DrizzleExecutor {
+    transaction<R>(fn: (tx: any) => Promise<R>): Promise<R>;
+}
+export interface DrizzleOutboxStoreOptions {
+    /** Il client di Drizzle. Il relay e i consumer aprono `db.transaction(...)`: le tabelle dell'outbox non hanno azienda. */
+    db: DrizzleDbLike;
+    /**
+     * `snake` (di serie): `aggregate_type`, `published_at`, … come in `sql/002-events-outbox-inbox-snake.sql` e nello schema
+     * `outboxEvents`/`inboxProcessed`. `camel`: le colonne di `sql/001-events-outbox-inbox.sql` (le stesse di Prisma).
+     */
+    columns?: 'snake' | 'camel';
+}
+/**
+ * Lo store Drizzle (`@generazioneai/events/drizzle`): stesso SQL e stesse garanzie di quello di Prisma, scritto con `db.execute`.
+ * - **Nella transazione del chiamante**: `enqueue(tx, …)` riceve il `tx` di `db.transaction(async (tx) => …)`; fuori da una
+ *   transazione lancia `EVENTS_OUTSIDE_TX`.
+ * - **Indipendente dal driver**: JSON e UUID viaggiano come testo con il cast sul server (con `postgres-js` un oggetto JSON passato
+ *   a una colonna `jsonb` verrebbe serializzato due volte), e le righe si leggono sia come array (`postgres-js`) sia come `{ rows }`.
+ * - Drizzle non ha un timeout di transazione: `timeout` e `maxWait` delle opzioni non hanno effetto.
+ */
+export declare class DrizzleOutboxStore implements OutboxStore<DrizzleExecutor> {
+    readonly kind = "drizzle";
+    private readonly verified;
+    private readonly db;
+    private readonly c;
+    constructor(options: DrizzleOutboxStoreOptions);
+    accepts(tx: unknown): tx is DrizzleExecutor;
+    /** `SAVEPOINT` esiste solo dentro un blocco di transazione (altrimenti Postgres risponde 25P01): è il database a dire se `tx` lo è. */
+    assertInTransaction(tx: DrizzleExecutor, subject: string | undefined): Promise<void>;
+    insert(tx: DrizzleExecutor, r: OutboxInsert): Promise<void>;
+    transaction<R>(fn: (tx: DrizzleExecutor) => Promise<R>, _options?: OutboxTransactionOptions): Promise<R>;
+    claimPending(tx: DrizzleExecutor, limit: number): Promise<OutboxRow[]>;
+    markPublished(tx: DrizzleExecutor, id: string): Promise<void>;
+    markFailed(tx: DrizzleExecutor, id: string, error: string): Promise<void>;
+    claimInbox(tx: DrizzleExecutor, consumer: string, eventId: string): Promise<boolean>;
+    pendingStats(): Promise<{
+        pending: number;
+        oldestSeconds: number;
+    }>;
+    prune(outboxDays: number, inboxDays: number): Promise<void>;
+}
+/** `EventsModule.forRoot({ service: 'checkflow', store: createDrizzleOutboxStore({ db }), … })`. */
+export declare const createDrizzleOutboxStore: (options: DrizzleOutboxStoreOptions) => DrizzleOutboxStore;
+//# sourceMappingURL=store.d.ts.map

package/dist/drizzle/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/drizzle/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,GAAG,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,wBAAwB,EAC9B,MAAM,UAAU,CAAC;AAElB,qJAAqJ;AACrJ,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,KAAK,EAAE,GAAG,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;CAC3C;AAED,2JAA2J;AAC3J,MAAM,WAAW,aAAc,SAAQ,eAAe;IACpD,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,yBAAyB;IACxC,0HAA0H;IAC1H,EAAE,EAAE,aAAa,CAAC;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;CAC7B;AAMD;;;;;;;GAOG;AACH,qBAAa,kBAAmB,YAAW,WAAW,CAAC,eAAe,CAAC;IACrE,QAAQ,CAAC,IAAI,aAAa;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAClD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAgB;IACnC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAoP;gBAE1P,OAAO,EAAE,yBAAyB;IA0B9C,OAAO,CAAC,EAAE,EAAE,OAAO,GAAG,EAAE,IAAI,eAAe;IAI3C,uIAAuI;IACjI,mBAAmB,CAAC,EAAE,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAYpF,MAAM,CAAC,EAAE,EAAE,eAAe,EAAE,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAOjE,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,eAAe,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,CAAC,CAAC;IAIlG,YAAY,CAAC,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAmBtE,aAAa,CAAC,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO7D,UAAU,CAAC,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzE,UAAU,CAAC,EAAE,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQpF,YAAY,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IAWnE,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CASlE;AAED,oGAAoG;AACpG,eAAO,MAAM,wBAAwB,GAAI,SAAS,yBAAyB,KAAG,kBAAqD,CAAC"}

package/dist/drizzle/store.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDrizzleOutboxStore = exports.DrizzleOutboxStore = void 0;
+const drizzle_orm_1 = require("drizzle-orm");
+const store_1 = require("../store");
+const rowsOf = (res) => (Array.isArray(res) ? res : (res?.rows ?? []));
+const col = (name) => drizzle_orm_1.sql.raw(`"${name}"`);
+/**
+ * Lo store Drizzle (`@generazioneai/events/drizzle`): stesso SQL e stesse garanzie di quello di Prisma, scritto con `db.execute`.
+ * - **Nella transazione del chiamante**: `enqueue(tx, …)` riceve il `tx` di `db.transaction(async (tx) => …)`; fuori da una
+ *   transazione lancia `EVENTS_OUTSIDE_TX`.
+ * - **Indipendente dal driver**: JSON e UUID viaggiano come testo con il cast sul server (con `postgres-js` un oggetto JSON passato
+ *   a una colonna `jsonb` verrebbe serializzato due volte), e le righe si leggono sia come array (`postgres-js`) sia come `{ rows }`.
+ * - Drizzle non ha un timeout di transazione: `timeout` e `maxWait` delle opzioni non hanno effetto.
+ */
+class DrizzleOutboxStore {
+    constructor(options) {
+        this.kind = 'drizzle';
+        this.verified = new WeakSet();
+        if (!options?.db || typeof options.db.transaction !== 'function' || typeof options.db.execute !== 'function') {
+            throw new Error('createDrizzleOutboxStore({ db }): db deve avere transaction() ed execute() (il client di drizzle)');
+        }
+        this.db = options.db;
+        const snake = (options.columns ?? 'snake') === 'snake';
+        const n = (camel, sn) => col(snake ? sn : camel);
+        this.c = {
+            id: n('id', 'id'),
+            subject: n('subject', 'subject'),
+            aggregateType: n('aggregateType', 'aggregate_type'),
+            aggregateId: n('aggregateId', 'aggregate_id'),
+            aggregateVersion: n('aggregateVersion', 'aggregate_version'),
+            juridicalId: n('juridicalId', 'juridical_id'),
+            payload: n('payload', 'payload'),
+            headers: n('headers', 'headers'),
+            createdAt: n('createdAt', 'created_at'),
+            publishedAt: n('publishedAt', 'published_at'),
+            attempts: n('attempts', 'attempts'),
+            lastError: n('lastError', 'last_error'),
+            consumer: n('consumer', 'consumer'),
+            eventId: n('eventId', 'event_id'),
+            processedAt: n('processedAt', 'processed_at'),
+        };
+    }
+    accepts(tx) {
+        return !!tx && typeof tx.execute === 'function';
+    }
+    /** `SAVEPOINT` esiste solo dentro un blocco di transazione (altrimenti Postgres risponde 25P01): è il database a dire se `tx` lo è. */
+    async assertInTransaction(tx, subject) {
+        if (!this.accepts(tx))
+            throw (0, store_1.outsideTransaction)(subject, undefined, this.kind);
+        if (this.verified.has(tx))
+            return;
+        try {
+            await tx.execute((0, drizzle_orm_1.sql) `SAVEPOINT genai_events_probe`);
+            await tx.execute((0, drizzle_orm_1.sql) `RELEASE SAVEPOINT genai_events_probe`);
+        }
+        catch (e) {
+            throw (0, store_1.outsideTransaction)(subject, e);
+        }
+        this.verified.add(tx);
+    }
+    async insert(tx, r) {
+        const c = this.c;
+        await tx.execute((0, drizzle_orm_1.sql) `INSERT INTO outbox_events
+      (${c.id},${c.subject},${c.aggregateType},${c.aggregateId},${c.aggregateVersion},${c.juridicalId},${c.payload},${c.headers})
+      VALUES (${r.id}::uuid,${r.subject}::text,${r.aggregateType}::text,${r.aggregateId}::text,${r.aggregateVersion}::integer,${r.juridicalId}::text,${r.payload}::text::jsonb,${r.headers}::text::jsonb)`);
+    }
+    transaction(fn, _options) {
+        return this.db.transaction(fn);
+    }
+    async claimPending(tx, limit) {
+        const c = this.c;
+        const res = await tx.execute((0, drizzle_orm_1.sql) `SELECT ${c.id} AS "id", ${c.subject} AS "subject", ${c.aggregateType} AS "aggregateType",
+        ${c.aggregateId} AS "aggregateId", ${c.aggregateVersion} AS "aggregateVersion", ${c.juridicalId} AS "juridicalId",
+        ${c.payload}::text AS "payload", ${c.headers}::text AS "headers"
+      FROM outbox_events WHERE ${c.publishedAt} IS NULL ORDER BY ${c.id} LIMIT ${drizzle_orm_1.sql.raw(String(Math.floor(limit)))}
+      FOR UPDATE SKIP LOCKED`);
+        return rowsOf(res).map((r) => ({
+            id: String(r.id),
+            subject: r.subject,
+            aggregateType: r.aggregateType,
+            aggregateId: r.aggregateId,
+            aggregateVersion: Number(r.aggregateVersion),
+            juridicalId: r.juridicalId ?? null,
+            payload: JSON.parse(r.payload),
+            headers: r.headers == null ? null : JSON.parse(r.headers),
+        }));
+    }
+    async markPublished(tx, id) {
+        const c = this.c;
+        await tx.execute((0, drizzle_orm_1.sql) `UPDATE outbox_events SET ${c.publishedAt} = CURRENT_TIMESTAMP, ${c.attempts} = ${c.attempts} + 1, ${c.lastError} = NULL WHERE ${c.id} = ${id}::uuid`);
+    }
+    async markFailed(tx, id, error) {
+        const c = this.c;
+        await tx.execute((0, drizzle_orm_1.sql) `UPDATE outbox_events SET ${c.attempts} = ${c.attempts} + 1, ${c.lastError} = ${error}::text WHERE ${c.id} = ${id}::uuid`);
+    }
+    async claimInbox(tx, consumer, eventId) {
+        const c = this.c;
+        const res = await tx.execute((0, drizzle_orm_1.sql) `INSERT INTO inbox_processed (${c.consumer},${c.eventId}) VALUES (${consumer}::text,${eventId}::uuid) ON CONFLICT DO NOTHING RETURNING ${c.consumer} AS "consumer"`);
+        return rowsOf(res).length > 0;
+    }
+    async pendingStats() {
+        const c = this.c;
+        const [row] = rowsOf(await this.db.execute((0, drizzle_orm_1.sql) `SELECT COUNT(*)::float8 AS "pending", EXTRACT(EPOCH FROM (CURRENT_TIMESTAMP - MIN(${c.createdAt})))::float8 AS "oldest"
+          FROM outbox_events WHERE ${c.publishedAt} IS NULL`));
+        return { pending: Number(row?.pending ?? 0), oldestSeconds: Number(row?.oldest ?? 0) };
+    }
+    async prune(outboxDays, inboxDays) {
+        const c = this.c;
+        await this.db.execute((0, drizzle_orm_1.sql) `DELETE FROM outbox_events WHERE ${c.publishedAt} IS NOT NULL AND ${c.publishedAt} < CURRENT_TIMESTAMP - make_interval(days => ${drizzle_orm_1.sql.raw(String(Math.floor(outboxDays)))})`);
+        await this.db.execute((0, drizzle_orm_1.sql) `DELETE FROM inbox_processed WHERE ${c.processedAt} < CURRENT_TIMESTAMP - make_interval(days => ${drizzle_orm_1.sql.raw(String(Math.floor(inboxDays)))})`);
+    }
+}
+exports.DrizzleOutboxStore = DrizzleOutboxStore;
+/** `EventsModule.forRoot({ service: 'checkflow', store: createDrizzleOutboxStore({ db }), … })`. */
+const createDrizzleOutboxStore = (options) => new DrizzleOutboxStore(options);
+exports.createDrizzleOutboxStore = createDrizzleOutboxStore;
+//# sourceMappingURL=store.js.map

package/dist/drizzle/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/drizzle/store.ts"],"names":[],"mappings":"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"}

package/dist/events.module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.module.d.ts","sourceRoot":"","sources":["../src/events.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAkC,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE9H,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAItD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,OAAO,EAAkB,KAAK,mBAAmB,EAAE,KAAK,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAE/F,qBAEa,YAAa,YAAW,sBAAsB,EAAE,qBAAqB;IAKtD,OAAO,CAAC,QAAQ,CAAC,IAAI;IAC7C,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAP5B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAwB;IAC5C,OAAO,CAAC,SAAS,CAAS;gBAGiB,IAAI,EAAE,qBAAqB,EACnD,IAAI,EAAE,gBAAgB,EACtB,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,eAAe;IAG7C,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,mBAAmB,GAAG,aAAa;IAoB3D,4HAA4H;IAC5H,sBAAsB,IAAI,IAAI;YAWhB,IAAI;IAeZ,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;CAM7C"}
+{"version":3,"file":"events.module.d.ts","sourceRoot":"","sources":["../src/events.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAkC,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE9H,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAItD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,OAAO,EAAkB,KAAK,mBAAmB,EAAE,KAAK,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAE/F,qBAEa,YAAa,YAAW,sBAAsB,EAAE,qBAAqB;IAKtD,OAAO,CAAC,QAAQ,CAAC,IAAI;IAC7C,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAP5B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAwB;IAC5C,OAAO,CAAC,SAAS,CAAS;gBAGiB,IAAI,EAAE,qBAAqB,EACnD,IAAI,EAAE,gBAAgB,EACtB,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,eAAe;IAG7C,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,mBAAmB,GAAG,aAAa;IAoB3D,4HAA4H;IAC5H,sBAAsB,IAAI,IAAI;YAehB,IAAI;IAeZ,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;CAM7C"}

package/dist/events.module.js

@@ -56,8 +56,12 @@ let EventsModule = EventsModule_1 = class EventsModule {
     onApplicationBootstrap() {
         const { mode, signatureMode, verifier, signer } = this.opts;
         this.log.log(`EVENTS_MODE=${mode} EVENTS_SIGNATURE=${signatureMode}`);
-        if (signatureMode === 'enforce' && (!verifier || !signer)) {
-            throw new Error('EVENTS_SIGNATURE=enforce richiede signer e verifier in EventsModule.forRoot');
+        // 0.3 (via gli interruttori): la firma si fa e si verifica se il servizio passa signer e verifier; senza, una riga, mai un errore.
+        if (signatureMode !== 'off' && !signer) {
+            this.log.warn('firma degli eventi non configurata (manca signer in EventsModule.forRoot): gli eventi partono senza Gen-Sig');
+        }
+        if (signatureMode !== 'off' && !verifier) {
+            this.log.warn('verifica della firma non configurata (manca verifier in EventsModule.forRoot): gli eventi si accettano senza verifica');
         }
         if (mode !== 'on')
             return;

package/dist/events.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.module.js","sourceRoot":"","sources":["../src/events.module.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"events.module.js","sourceRoot":"","sources":["../src/events.module.ts"],"names":[],"mappings":"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"}

package/dist/final-mode.d.ts

@@ -0,0 +1,23 @@
+/** `true` solo in sviluppo locale o nei test: l'unico caso in cui le vecchie modalità contano ancora. */
+export declare function isLocalDevEnv(env?: NodeJS.ProcessEnv): boolean;
+export interface FinalModeOptions<T extends string> {
+    /** Nome della variabile (per l'avviso). */
+    name: string;
+    /** Il valore finale, quello che vale fuori dallo sviluppo locale. */
+    final: T;
+    /** I valori che lo sviluppo locale può ancora chiedere (il finale compreso). */
+    allowed: readonly T[];
+    /** Il valore chiesto (opzione o env); vuoto/assente = il finale. */
+    requested?: string | null;
+    env?: NodeJS.ProcessEnv;
+    /** Default `console.warn`. */
+    warn?: (message: string) => void;
+}
+/** Per i test: dimentica gli avvisi già dati. */
+export declare function resetFinalModeWarnings(): void;
+/**
+ * Il valore effettivo di una vecchia modalità: il finale, tranne in sviluppo locale dove si rispetta il valore chiesto (se è
+ * uno degli ammessi). Un valore sconosciuto o fuori posto non fa mai fallire l'avvio: vale il finale, con un avviso.
+ */
+export declare function finalMode<T extends string>(o: FinalModeOptions<T>): T;
+//# sourceMappingURL=final-mode.d.ts.map

package/dist/final-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"final-mode.d.ts","sourceRoot":"","sources":["../src/final-mode.ts"],"names":[],"mappings":"AAYA,yGAAyG;AACzG,wBAAgB,aAAa,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAM3E;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,MAAM;IAChD,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,KAAK,EAAE,CAAC,CAAC;IACT,gFAAgF;IAChF,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC;IACtB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,8BAA8B;IAC9B,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAID,iDAAiD;AACjD,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAQD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,CAAC,CAmBrE"}

package/dist/final-mode.js

@@ -0,0 +1,56 @@
+"use strict";
+// Valori finali fissi delle vecchie modalità di rilascio (decisione del CTO del 2026-11-10, «via gli interruttori»).
+//
+// Le variabili che sceglievano off/log/shadow/enforce (AUTHZ_ENFORCE_MODE, AUTHZ_INTERNAL_AUTH_MODE, AUTHZ_KEY_POLICY, …) non
+// scelgono più nulla: vale sempre il comportamento finale. Resta UNA via di fuga, solo per lo sviluppo locale e i test
+// (D-E del censimento): lì il valore dell'env (o dell'opzione) si rispetta ancora. In ogni altro ambiente un valore diverso
+// dal finale si ignora con un avviso, una volta per variabile e valore: mai un crash all'avvio.
+//
+// Sviluppo locale = nessun `KUBERNETES_SERVICE_HOST` (mai dentro un cluster) E (`SKILLERA_ENV` è `dev`/`local`, oppure
+// `SKILLERA_ENV` manca e `NODE_ENV` è `development`/`test`). Uno `SKILLERA_ENV` diverso (stg, prod, …) chiude sempre la via.
+//
+// Copia identica in authz, gateway-kit, events, telemetry e crypto (pacchetti pubblicati a parte, senza dipendenze fra loro).
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isLocalDevEnv = isLocalDevEnv;
+exports.resetFinalModeWarnings = resetFinalModeWarnings;
+exports.finalMode = finalMode;
+/** `true` solo in sviluppo locale o nei test: l'unico caso in cui le vecchie modalità contano ancora. */
+function isLocalDevEnv(env = process.env) {
+    if ((env.KUBERNETES_SERVICE_HOST ?? '').trim())
+        return false;
+    const skilleraEnv = (env.SKILLERA_ENV ?? '').trim().toLowerCase();
+    if (skilleraEnv)
+        return skilleraEnv === 'dev' || skilleraEnv === 'local';
+    const nodeEnv = (env.NODE_ENV ?? '').trim().toLowerCase();
+    return nodeEnv === 'development' || nodeEnv === 'test';
+}
+const warned = new Set();
+/** Per i test: dimentica gli avvisi già dati. */
+function resetFinalModeWarnings() {
+    warned.clear();
+}
+function warnOnce(key, message, warn) {
+    if (warned.has(key))
+        return;
+    warned.add(key);
+    (warn ?? ((m) => console.warn(m)))(message);
+}
+/**
+ * Il valore effettivo di una vecchia modalità: il finale, tranne in sviluppo locale dove si rispetta il valore chiesto (se è
+ * uno degli ammessi). Un valore sconosciuto o fuori posto non fa mai fallire l'avvio: vale il finale, con un avviso.
+ */
+function finalMode(o) {
+    const raw = (o.requested ?? '').toString().trim().toLowerCase();
+    if (!raw || raw === o.final)
+        return o.final;
+    const env = o.env ?? process.env;
+    if (!o.allowed.includes(raw)) {
+        warnOnce(`${o.name}|${raw}`, `[via-interruttori] ${o.name}=«${raw}» sconosciuto: vale «${o.final}» (ammessi solo in sviluppo locale: ${o.allowed.join(', ')})`, o.warn);
+        return o.final;
+    }
+    if (isLocalDevEnv(env))
+        return raw;
+    warnOnce(`${o.name}|${raw}`, `[via-interruttori] ${o.name}=«${raw}» ignorato: fuori dallo sviluppo locale vale sempre «${o.final}» (decisione 2026-11-10, via gli interruttori)`, o.warn);
+    return o.final;
+}
+//# sourceMappingURL=final-mode.js.map

package/dist/final-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"final-mode.js","sourceRoot":"","sources":["../src/final-mode.ts"],"names":[],"mappings":";AAAA,qHAAqH;AACrH,EAAE;AACF,8HAA8H;AAC9H,uHAAuH;AACvH,4HAA4H;AAC5H,gGAAgG;AAChG,EAAE;AACF,uHAAuH;AACvH,6HAA6H;AAC7H,EAAE;AACF,8HAA8H;;AAG9H,sCAMC;AAmBD,wDAEC;AAYD,8BAmBC;AA3DD,yGAAyG;AACzG,SAAgB,aAAa,CAAC,MAAyB,OAAO,CAAC,GAAG;IAChE,IAAI,CAAC,GAAG,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;QAAE,OAAO,KAAK,CAAC;IAC7D,MAAM,WAAW,GAAG,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAClE,IAAI,WAAW;QAAE,OAAO,WAAW,KAAK,KAAK,IAAI,WAAW,KAAK,OAAO,CAAC;IACzE,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC1D,OAAO,OAAO,KAAK,aAAa,IAAI,OAAO,KAAK,MAAM,CAAC;AACzD,CAAC;AAgBD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;AAEjC,iDAAiD;AACjD,SAAgB,sBAAsB;IACpC,MAAM,CAAC,KAAK,EAAE,CAAC;AACjB,CAAC;AAED,SAAS,QAAQ,CAAC,GAAW,EAAE,OAAe,EAAE,IAA0B;IACxE,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO;IAC5B,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChB,CAAC,IAAI,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AACtD,CAAC;AAED;;;GAGG;AACH,SAAgB,SAAS,CAAmB,CAAsB;IAChE,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAChE,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,CAAC,CAAC,KAAK;QAAE,OAAO,CAAC,CAAC,KAAK,CAAC;IAC5C,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACjC,IAAI,CAAE,CAAC,CAAC,OAA6B,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACpD,QAAQ,CACN,GAAG,CAAC,CAAC,IAAI,IAAI,GAAG,EAAE,EAClB,sBAAsB,CAAC,CAAC,IAAI,KAAK,GAAG,wBAAwB,CAAC,CAAC,KAAK,uCAAuC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EACjI,CAAC,CAAC,IAAI,CACP,CAAC;QACF,OAAO,CAAC,CAAC,KAAK,CAAC;IACjB,CAAC;IACD,IAAI,aAAa,CAAC,GAAG,CAAC;QAAE,OAAO,GAAQ,CAAC;IACxC,QAAQ,CACN,GAAG,CAAC,CAAC,IAAI,IAAI,GAAG,EAAE,EAClB,sBAAsB,CAAC,CAAC,IAAI,KAAK,GAAG,wDAAwD,CAAC,CAAC,KAAK,gDAAgD,EACnJ,CAAC,CAAC,IAAI,CACP,CAAC;IACF,OAAO,CAAC,CAAC,KAAK,CAAC;AACjB,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export { EventsModule } from './events.module';
 export { OutboxService, OUTBOX_INSERT } from './outbox.service';
+export { PrismaOutboxStore, type OutboxInsert, type OutboxRow, type OutboxStore, type OutboxTransactionOptions, } from './store';
 export { OutboxRelay } from './relay.service';
 export { EventsConsumers, durableName, streamForSubject } from './consumers.service';
 export { EventsConnection } from './connection';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EACL,yBAAyB,EACzB,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,YAAY,GAClB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EACL,iBAAiB,EACjB,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,wBAAwB,GAC9B,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EACL,yBAAyB,EACzB,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,YAAY,GAClB,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -1,11 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveOptions = exports.DEFAULT_RETRY_SCHEDULE_MS = exports.uuidv7 = exports.EventValidationError = exports.EventsError = exports.OnEvent = exports.EventsMetrics = exports.EventsConnection = exports.streamForSubject = exports.durableName = exports.EventsConsumers = exports.OutboxRelay = exports.OUTBOX_INSERT = exports.OutboxService = exports.EventsModule = void 0;
+exports.resolveOptions = exports.DEFAULT_RETRY_SCHEDULE_MS = exports.uuidv7 = exports.EventValidationError = exports.EventsError = exports.OnEvent = exports.EventsMetrics = exports.EventsConnection = exports.streamForSubject = exports.durableName = exports.EventsConsumers = exports.OutboxRelay = exports.PrismaOutboxStore = exports.OUTBOX_INSERT = exports.OutboxService = exports.EventsModule = void 0;
 var events_module_1 = require("./events.module");
 Object.defineProperty(exports, "EventsModule", { enumerable: true, get: function () { return events_module_1.EventsModule; } });
 var outbox_service_1 = require("./outbox.service");
 Object.defineProperty(exports, "OutboxService", { enumerable: true, get: function () { return outbox_service_1.OutboxService; } });
 Object.defineProperty(exports, "OUTBOX_INSERT", { enumerable: true, get: function () { return outbox_service_1.OUTBOX_INSERT; } });
+var store_1 = require("./store");
+Object.defineProperty(exports, "PrismaOutboxStore", { enumerable: true, get: function () { return store_1.PrismaOutboxStore; } });
 var relay_service_1 = require("./relay.service");
 Object.defineProperty(exports, "OutboxRelay", { enumerable: true, get: function () { return relay_service_1.OutboxRelay; } });
 var consumers_service_1 = require("./consumers.service");

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AACrB,mDAAgE;AAAvD,+GAAA,aAAa,OAAA;AAAE,+GAAA,aAAa,OAAA;AACrC,iDAA8C;AAArC,4GAAA,WAAW,OAAA;AACpB,yDAAqF;AAA5E,oHAAA,eAAe,OAAA;AAAE,gHAAA,WAAW,OAAA;AAAE,qHAAA,gBAAgB,OAAA;AACvD,2CAAgD;AAAvC,8GAAA,gBAAgB,OAAA;AACzB,qCAA0C;AAAjC,wGAAA,aAAa,OAAA;AACtB,2CAA6D;AAApD,qGAAA,OAAO,OAAA;AAChB,mCAA6D;AAApD,qGAAA,WAAW,OAAA;AAAE,8GAAA,oBAAoB,OAAA;AAC1C,+BAAgC;AAAvB,8FAAA,MAAM,OAAA;AACf,iCAiBiB;AAhBf,kHAAA,yBAAyB,OAAA;AACzB,uGAAA,cAAc,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AACrB,mDAAgE;AAAvD,+GAAA,aAAa,OAAA;AAAE,+GAAA,aAAa,OAAA;AACrC,iCAMiB;AALf,0GAAA,iBAAiB,OAAA;AAMnB,iDAA8C;AAArC,4GAAA,WAAW,OAAA;AACpB,yDAAqF;AAA5E,oHAAA,eAAe,OAAA;AAAE,gHAAA,WAAW,OAAA;AAAE,qHAAA,gBAAgB,OAAA;AACvD,2CAAgD;AAAvC,8GAAA,gBAAgB,OAAA;AACzB,qCAA0C;AAAjC,wGAAA,aAAa,OAAA;AACtB,2CAA6D;AAApD,qGAAA,OAAO,OAAA;AAChB,mCAA6D;AAApD,qGAAA,WAAW,OAAA;AAAE,8GAAA,oBAAoB,OAAA;AAC1C,+BAAgC;AAAvB,8FAAA,MAAM,OAAA;AACf,iCAiBiB;AAhBf,kHAAA,yBAAyB,OAAA;AACzB,uGAAA,cAAc,OAAA"}

package/dist/metrics.d.ts

@@ -4,10 +4,18 @@ type Labels = Record<string, string>;
  * endpoint delle metriche (o `@generazioneai/telemetry` lo legge). Nomi del contratto: events_outbox_pending,
  * events_outbox_oldest_seconds, events_published_total, events_delivered_total{consumer}, events_nak_total,
  * events_term_total, events_consumer_lag{consumer}.
+ *
+ * Le stesse serie passano anche all'API di OpenTelemetry (come fa `@generazioneai/jobs`): senza SDK sono no-op, con
+ * `@generazioneai/telemetry` le esporta il Collector e finiscono in VictoriaMetrics, dove le regole di allarme
+ * (`outbox-in-ritardo`, `consumer-in-ritardo`) le leggono. Nessun servizio deve aggiungere un endpoint.
  */
 export declare class EventsMetrics {
     private counters;
     private gauges;
+    private readonly gaugeLabels;
+    private readonly otelCounters;
+    private readonly otelGauges;
+    private readonly meter;
     private static key;
     inc(name: string, labels?: Labels, by?: number): void;
     set(name: string, value: number, labels?: Labels): void;

package/dist/metrics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAEA,KAAK,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAErC;;;;;GAKG;AACH,qBACa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAA0C;IAC1D,OAAO,CAAC,MAAM,CAA0C;IAExD,OAAO,CAAC,MAAM,CAAC,GAAG;IAQlB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,SAAI,GAAG,IAAI;IAOhD,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAMvD,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM;IAK1C,MAAM,IAAI,MAAM;CAYjB"}
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAGA,KAAK,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAErC;;;;;;;;;GASG;AACH,qBACa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAA0C;IAC1D,OAAO,CAAC,MAAM,CAA0C;IACxD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0C;IACtE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA8B;IAC3D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoD;IAE1E,OAAO,CAAC,MAAM,CAAC,GAAG;IAQlB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,SAAI,GAAG,IAAI;IAahD,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAmBvD,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM;IAK1C,MAAM,IAAI,MAAM;CAYjB"}

package/dist/metrics.js

@@ -9,16 +9,25 @@ var EventsMetrics_1;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EventsMetrics = void 0;
 const common_1 = require("@nestjs/common");
+const api_1 = require("@opentelemetry/api");
 /**
  * Registro minimo di metriche (nessuna dipendenza). `render()` produce il testo Prometheus: il servizio lo aggiunge al suo
  * endpoint delle metriche (o `@generazioneai/telemetry` lo legge). Nomi del contratto: events_outbox_pending,
  * events_outbox_oldest_seconds, events_published_total, events_delivered_total{consumer}, events_nak_total,
  * events_term_total, events_consumer_lag{consumer}.
+ *
+ * Le stesse serie passano anche all'API di OpenTelemetry (come fa `@generazioneai/jobs`): senza SDK sono no-op, con
+ * `@generazioneai/telemetry` le esporta il Collector e finiscono in VictoriaMetrics, dove le regole di allarme
+ * (`outbox-in-ritardo`, `consumer-in-ritardo`) le leggono. Nessun servizio deve aggiungere un endpoint.
  */
 let EventsMetrics = EventsMetrics_1 = class EventsMetrics {
     constructor() {
         this.counters = new Map();
         this.gauges = new Map();
+        this.gaugeLabels = new Map();
+        this.otelCounters = new Map();
+        this.otelGauges = new Set();
+        this.meter = api_1.metrics.getMeter('@generazioneai/events');
     }
     static key(l) {
         if (!l)
@@ -33,11 +42,30 @@ let EventsMetrics = EventsMetrics_1 = class EventsMetrics {
         const k = EventsMetrics_1.key(labels);
         m.set(k, (m.get(k) ?? 0) + by);
         this.counters.set(name, m);
+        let c = this.otelCounters.get(name);
+        if (!c) {
+            c = this.meter.createCounter(name);
+            this.otelCounters.set(name, c);
+        }
+        c.add(by, labels ?? {});
     }
     set(name, value, labels) {
         const m = this.gauges.get(name) ?? new Map();
         m.set(EventsMetrics_1.key(labels), value);
         this.gauges.set(name, m);
+        const k = EventsMetrics_1.key(labels);
+        const l = this.gaugeLabels.get(name) ?? new Map();
+        l.set(k, labels ?? {});
+        this.gaugeLabels.set(name, l);
+        if (!this.otelGauges.has(name)) {
+            this.otelGauges.add(name);
+            // Il callback legge i valori correnti al momento dell'esportazione.
+            this.meter.createObservableGauge(name).addCallback((result) => {
+                for (const [key, value] of this.gauges.get(name) ?? []) {
+                    result.observe(value, this.gaugeLabels.get(name)?.get(key) ?? {});
+                }
+            });
+        }
     }
     get(name, labels) {
         const k = EventsMetrics_1.key(labels);

package/dist/metrics.js.map

@@ -1 +1 @@
-{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"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"}

package/dist/outbox.service.d.ts

@@ -1,24 +1,20 @@
-import type { EnqueueParams, PrismaTx, ResolvedEventsOptions } from './types';
-export declare const OUTBOX_INSERT = "INSERT INTO outbox_events\n  (\"id\",\"subject\",\"aggregateType\",\"aggregateId\",\"aggregateVersion\",\"juridicalId\",\"payload\",\"headers\")\n  VALUES ($1::uuid,$2,$3,$4,$5,$6,$7::jsonb,$8::jsonb)";
+import { PrismaResolver } from './prisma-resolver';
+import { OUTBOX_INSERT } from './store';
+import type { EnqueueParams, ResolvedEventsOptions } from './types';
+export { OUTBOX_INSERT };
 export declare class OutboxService {
     private readonly opts;
-    /** Client di transazione già verificati (un `tx` vive quanto la sua transazione: la prova si fa una volta sola). */
-    private readonly verified;
-    constructor(opts: ResolvedEventsOptions);
+    private readonly persistence?;
+    constructor(opts: ResolvedEventsOptions, persistence?: PrismaResolver | undefined);
+    private get store();
     /**
-     * Riconosce una transazione dal lato del database, non dalla forma del client (in Prisma 7 il `tx` ha anch'esso `$transaction`):
-     * `SAVEPOINT` esiste solo dentro un blocco di transazione, altrimenti Postgres risponde 25P01. Con il client radice (una query
-     * in autocommit) fallisce → `EVENTS_OUTSIDE_TX`. Un `tx` verificato non si riprova.
-     */
-    private assertInTransaction;
-    /**
-     * Scrive l'evento nell'outbox, nella stessa transazione del dato. `tx` è il client del callback di
-     * `prisma.$transaction(async (tx) => …)`; fuori da una transazione (client radice, con `$transaction`) lancia
-     * `EVENTS_OUTSIDE_TX`: niente «pubblica e speriamo».
+     * Scrive l'evento nell'outbox, nella stessa transazione del dato. `tx` è il client del callback della transazione del chiamante
+     * (`prisma.$transaction(async (tx) => …)` oppure `db.transaction(async (tx) => …)` di Drizzle, secondo lo store); fuori da una
+     * transazione (client radice) lancia `EVENTS_OUTSIDE_TX`: niente «pubblica e speriamo».
      *
      * Con `EVENTS_MODE=off` non scrive nulla e restituisce `null` (il controllo della transazione resta, per trovare i bug prima
      * dell'accensione). Altrimenti restituisce l'id dell'evento (UUID v7).
      */
-    enqueue<T>(tx: PrismaTx, p: EnqueueParams<T>): Promise<string | null>;
+    enqueue<T>(tx: unknown, p: EnqueueParams<T>): Promise<string | null>;
 }
 //# sourceMappingURL=outbox.service.d.ts.map

package/dist/outbox.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"outbox.service.d.ts","sourceRoot":"","sources":["../src/outbox.service.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAG9E,eAAO,MAAM,aAAa,6MAE6B,CAAC;AAExD,qBACa,aAAa;IAIY,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHzD,oHAAoH;IACpH,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;gBAEG,IAAI,EAAE,qBAAqB;IAEhF;;;;OAIG;YACW,mBAAmB;IAiBjC;;;;;;;OAOG;IACG,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CA+B5E"}
+{"version":3,"file":"outbox.service.d.ts","sourceRoot":"","sources":["../src/outbox.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAuC,MAAM,SAAS,CAAC;AAE7E,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAGpE,OAAO,EAAE,aAAa,EAAE,CAAC;AAKzB,qBACa,aAAa;IAEE,OAAO,CAAC,QAAQ,CAAC,IAAI;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;gBADA,IAAI,EAAE,qBAAqB,EACvC,WAAW,CAAC,EAAE,cAAc,YAAA;IAG3D,OAAO,KAAK,KAAK,GAEhB;IAED;;;;;;;OAOG;IACG,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CA+B3E"}

package/dist/outbox.service.js

@@ -15,49 +15,34 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.OutboxService = exports.OUTBOX_INSERT = void 0;
 const common_1 = require("@nestjs/common");
 const errors_1 = require("./errors");
+const prisma_resolver_1 = require("./prisma-resolver");
+const store_1 = require("./store");
+Object.defineProperty(exports, "OUTBOX_INSERT", { enumerable: true, get: function () { return store_1.OUTBOX_INSERT; } });
 const tokens_1 = require("./tokens");
 const uuid_1 = require("./uuid");
-exports.OUTBOX_INSERT = `INSERT INTO outbox_events
-  ("id","subject","aggregateType","aggregateId","aggregateVersion","juridicalId","payload","headers")
-  VALUES ($1::uuid,$2,$3,$4,$5,$6,$7::jsonb,$8::jsonb)`;
+/** Senza modulo (prove, codice non Nest) `enqueue` lavora sul solo `tx` di Prisma: non serve il client radice. */
+const PRISMA_TX_ONLY = new store_1.PrismaOutboxStore();
 let OutboxService = class OutboxService {
-    constructor(opts) {
+    constructor(opts, persistence) {
         this.opts = opts;
-        /** Client di transazione già verificati (un `tx` vive quanto la sua transazione: la prova si fa una volta sola). */
-        this.verified = new WeakSet();
+        this.persistence = persistence;
     }
-    /**
-     * Riconosce una transazione dal lato del database, non dalla forma del client (in Prisma 7 il `tx` ha anch'esso `$transaction`):
-     * `SAVEPOINT` esiste solo dentro un blocco di transazione, altrimenti Postgres risponde 25P01. Con il client radice (una query
-     * in autocommit) fallisce → `EVENTS_OUTSIDE_TX`. Un `tx` verificato non si riprova.
-     */
-    async assertInTransaction(tx, subject) {
-        const outside = (cause) => new errors_1.EventsError('EVENTS_OUTSIDE_TX', `enqueue(${subject}) va chiamato dentro prisma.$transaction(async (tx) => …) passando il tx, non il client${cause ? ` (${cause?.message ?? cause})` : ''}`);
-        if (!tx || typeof tx.$executeRawUnsafe !== 'function')
-            throw outside();
-        if (this.verified.has(tx))
-            return;
-        try {
-            await tx.$executeRawUnsafe('SAVEPOINT genai_events_probe');
-            await tx.$executeRawUnsafe('RELEASE SAVEPOINT genai_events_probe');
-        }
-        catch (e) {
-            throw outside(e);
-        }
-        this.verified.add(tx);
+    get store() {
+        return this.persistence?.store() ?? PRISMA_TX_ONLY;
     }
     /**
-     * Scrive l'evento nell'outbox, nella stessa transazione del dato. `tx` è il client del callback di
-     * `prisma.$transaction(async (tx) => …)`; fuori da una transazione (client radice, con `$transaction`) lancia
-     * `EVENTS_OUTSIDE_TX`: niente «pubblica e speriamo».
+     * Scrive l'evento nell'outbox, nella stessa transazione del dato. `tx` è il client del callback della transazione del chiamante
+     * (`prisma.$transaction(async (tx) => …)` oppure `db.transaction(async (tx) => …)` di Drizzle, secondo lo store); fuori da una
+     * transazione (client radice) lancia `EVENTS_OUTSIDE_TX`: niente «pubblica e speriamo».
      *
      * Con `EVENTS_MODE=off` non scrive nulla e restituisce `null` (il controllo della transazione resta, per trovare i bug prima
      * dell'accensione). Altrimenti restituisce l'id dell'evento (UUID v7).
      */
     async enqueue(tx, p) {
+        const store = this.store;
         if (this.opts.mode !== 'off')
-            await this.assertInTransaction(tx, p?.subject);
-        else if (!tx || typeof tx.$executeRawUnsafe !== 'function')
+            await store.assertInTransaction(tx, p?.subject);
+        else if (!store.accepts(tx))
             return null; // off non lancia mai
         const svc = this.opts.service;
         const ok = p.subject?.startsWith(`evt.${svc}.`) || p.subject === `audit.${svc}` || p.subject?.startsWith(`audit.${svc}.`);
@@ -75,7 +60,16 @@ let OutboxService = class OutboxService {
         const tp = this.opts.traceparent?.();
         if (tp)
             headers.traceparent = tp;
-        await tx.$executeRawUnsafe(exports.OUTBOX_INSERT, id, p.subject, p.aggregate.type, p.aggregate.id, p.aggregate.version, p.juridicalId ?? null, JSON.stringify(p.data ?? null), JSON.stringify(headers));
+        await store.insert(tx, {
+            id,
+            subject: p.subject,
+            aggregateType: p.aggregate.type,
+            aggregateId: p.aggregate.id,
+            aggregateVersion: p.aggregate.version,
+            juridicalId: p.juridicalId ?? null,
+            payload: JSON.stringify(p.data ?? null),
+            headers: JSON.stringify(headers),
+        });
         return id;
     }
 };
@@ -83,6 +77,7 @@ exports.OutboxService = OutboxService;
 exports.OutboxService = OutboxService = __decorate([
     (0, common_1.Injectable)(),
     __param(0, (0, common_1.Inject)(tokens_1.EVENTS_OPTIONS)),
-    __metadata("design:paramtypes", [Object])
+    __param(1, (0, common_1.Optional)()),
+    __metadata("design:paramtypes", [Object, prisma_resolver_1.PrismaResolver])
 ], OutboxService);
 //# sourceMappingURL=outbox.service.js.map