@generazioneai/events 0.0.1 → 0.1.0

package/dist/metrics.d.ts

@@ -0,0 +1,18 @@
+type Labels = Record<string, string>;
+/**
+ * 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}.
+ */
+export declare class EventsMetrics {
+    private counters;
+    private gauges;
+    private static key;
+    inc(name: string, labels?: Labels, by?: number): void;
+    set(name: string, value: number, labels?: Labels): void;
+    get(name: string, labels?: Labels): number;
+    render(): string;
+}
+export {};
+//# sourceMappingURL=metrics.d.ts.map

package/dist/metrics.d.ts.map

@@ -0,0 +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"}

package/dist/metrics.js

@@ -0,0 +1,64 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var EventsMetrics_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventsMetrics = void 0;
+const common_1 = require("@nestjs/common");
+/**
+ * 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}.
+ */
+let EventsMetrics = EventsMetrics_1 = class EventsMetrics {
+    constructor() {
+        this.counters = new Map();
+        this.gauges = new Map();
+    }
+    static key(l) {
+        if (!l)
+            return '';
+        return Object.keys(l)
+            .sort()
+            .map((k) => `${k}="${String(l[k]).replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`)
+            .join(',');
+    }
+    inc(name, labels, by = 1) {
+        const m = this.counters.get(name) ?? new Map();
+        const k = EventsMetrics_1.key(labels);
+        m.set(k, (m.get(k) ?? 0) + by);
+        this.counters.set(name, m);
+    }
+    set(name, value, labels) {
+        const m = this.gauges.get(name) ?? new Map();
+        m.set(EventsMetrics_1.key(labels), value);
+        this.gauges.set(name, m);
+    }
+    get(name, labels) {
+        const k = EventsMetrics_1.key(labels);
+        return this.counters.get(name)?.get(k) ?? this.gauges.get(name)?.get(k) ?? 0;
+    }
+    render() {
+        const out = [];
+        const dump = (type, src) => {
+            for (const [name, series] of src) {
+                out.push(`# TYPE ${name} ${type}`);
+                for (const [k, v] of series)
+                    out.push(`${name}${k ? `{${k}}` : ''} ${v}`);
+            }
+        };
+        dump('counter', this.counters);
+        dump('gauge', this.gauges);
+        return out.join('\n') + '\n';
+    }
+};
+exports.EventsMetrics = EventsMetrics;
+exports.EventsMetrics = EventsMetrics = EventsMetrics_1 = __decorate([
+    (0, common_1.Injectable)()
+], EventsMetrics);
+//# sourceMappingURL=metrics.js.map

package/dist/metrics.js.map

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

package/dist/outbox.service.d.ts

@@ -0,0 +1,24 @@
+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)";
+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);
+    /**
+     * 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».
+     *
+     * 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>;
+}
+//# sourceMappingURL=outbox.service.d.ts.map

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

@@ -0,0 +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"}

package/dist/outbox.service.js

@@ -0,0 +1,88 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+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 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)`;
+let OutboxService = class OutboxService {
+    constructor(opts) {
+        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();
+    }
+    /**
+     * 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);
+    }
+    /**
+     * 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».
+     *
+     * 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) {
+        if (this.opts.mode !== 'off')
+            await this.assertInTransaction(tx, p?.subject);
+        else if (!tx || typeof tx.$executeRawUnsafe !== 'function')
+            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}.`);
+        if (!ok) {
+            // evt.<svc>.* va sullo stream EVT_<SVC>; audit.<svc>[.*] sullo stream AUDIT (lo sceglie NATS dal subject)
+            throw new errors_1.EventsError('EVENTS_INVALID', `il subject «${p.subject}» deve iniziare con evt.${svc}. oppure essere audit.${svc}[.…]`);
+        }
+        if (!p.aggregate?.type || !p.aggregate?.id || !Number.isInteger(p.aggregate.version)) {
+            throw new errors_1.EventsError('EVENTS_INVALID', 'aggregate { type, id, version } è obbligatorio');
+        }
+        if (this.opts.mode === 'off')
+            return null;
+        const id = (0, uuid_1.uuidv7)();
+        const headers = { occurredAt: new Date().toISOString() };
+        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));
+        return id;
+    }
+};
+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])
+], OutboxService);
+//# sourceMappingURL=outbox.service.js.map

package/dist/outbox.service.js.map

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

package/dist/prisma-resolver.d.ts

@@ -0,0 +1,11 @@
+import { ModuleRef } from '@nestjs/core';
+import type { EventsModuleOptions, PrismaLike } from './types';
+/** Risolve `PrismaService` quando serve (non alla costruzione: il suo modulo può non essere ancora pronto). */
+export declare class PrismaResolver {
+    private readonly ref;
+    private readonly raw;
+    private cached?;
+    constructor(ref: ModuleRef, raw: EventsModuleOptions);
+    get(): PrismaLike;
+}
+//# sourceMappingURL=prisma-resolver.d.ts.map

package/dist/prisma-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prisma-resolver.d.ts","sourceRoot":"","sources":["../src/prisma-resolver.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE/D,+GAA+G;AAC/G,qBACa,cAAc;IAGvB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACQ,OAAO,CAAC,QAAQ,CAAC,GAAG;IAHlD,OAAO,CAAC,MAAM,CAAC,CAAa;gBAET,GAAG,EAAE,SAAS,EACc,GAAG,EAAE,mBAAmB;IAGvE,GAAG,IAAI,UAAU;CAYlB"}

package/dist/prisma-resolver.js

@@ -0,0 +1,46 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PrismaResolver = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const errors_1 = require("./errors");
+const tokens_1 = require("./tokens");
+/** Risolve `PrismaService` quando serve (non alla costruzione: il suo modulo può non essere ancora pronto). */
+let PrismaResolver = class PrismaResolver {
+    constructor(ref, raw) {
+        this.ref = ref;
+        this.raw = raw;
+    }
+    get() {
+        if (this.cached)
+            return this.cached;
+        const p = this.raw.prisma;
+        const inst = (typeof p === 'function' || typeof p === 'string' || typeof p === 'symbol'
+            ? this.ref.get(p, { strict: false })
+            : p);
+        if (!inst || typeof inst.$transaction !== 'function') {
+            throw new errors_1.EventsError('EVENTS_CONFIG', 'EventsModule.forRoot({ prisma }) non risolve a un PrismaService con $transaction');
+        }
+        this.cached = inst;
+        return inst;
+    }
+};
+exports.PrismaResolver = PrismaResolver;
+exports.PrismaResolver = PrismaResolver = __decorate([
+    (0, common_1.Injectable)(),
+    __param(1, (0, common_1.Inject)(tokens_1.EVENTS_RAW_OPTIONS)),
+    __metadata("design:paramtypes", [core_1.ModuleRef, Object])
+], PrismaResolver);
+//# sourceMappingURL=prisma-resolver.js.map

package/dist/prisma-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prisma-resolver.js","sourceRoot":"","sources":["../src/prisma-resolver.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAAoD;AACpD,uCAAyC;AACzC,qCAAuC;AACvC,qCAA8C;AAG9C,+GAA+G;AAExG,IAAM,cAAc,GAApB,MAAM,cAAc;IAEzB,YACmB,GAAc,EACc,GAAwB;QADpD,QAAG,GAAH,GAAG,CAAW;QACc,QAAG,GAAH,GAAG,CAAqB;IACpE,CAAC;IAEJ,GAAG;QACD,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC,MAAM,CAAC;QACpC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;QAC1B,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,UAAU,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,QAAQ;YACrF,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAQ,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;YAC3C,CAAC,CAAC,CAAC,CAA2B,CAAC;QACjC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,YAAY,KAAK,UAAU,EAAE,CAAC;YACrD,MAAM,IAAI,oBAAW,CAAC,eAAe,EAAE,kFAAkF,CAAC,CAAC;QAC7H,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAA;AAnBY,wCAAc;yBAAd,cAAc;IAD1B,IAAA,mBAAU,GAAE;IAKR,WAAA,IAAA,eAAM,EAAC,2BAAkB,CAAC,CAAA;qCADL,gBAAS;GAHtB,cAAc,CAmB1B"}

package/dist/relay.service.d.ts

@@ -0,0 +1,32 @@
+import { EventsConnection } from './connection';
+import { EventsMetrics } from './metrics';
+import { PrismaResolver } from './prisma-resolver';
+import type { ResolvedEventsOptions } from './types';
+/**
+ * Relay dell'outbox: prende fino a `relayBatchSize` righe con `FOR UPDATE SKIP LOCKED` (più repliche non si pestano i piedi),
+ * pubblica con `Nats-Msg-Id` = id, aspetta il PubAck e segna `publishedAt`, tutto nella stessa transazione. Se la pubblicazione
+ * fallisce si ferma (l'ordine del giro si conserva), conta il tentativo e riprova al giro dopo. L'ordine fra transazioni che
+ * committano fuori ordine, e fra repliche, NON è garantito: chi consuma usa `aggregateVersion`.
+ */
+export declare class OutboxRelay {
+    private readonly opts;
+    private readonly conn;
+    private readonly prisma;
+    private readonly metrics;
+    private readonly log;
+    private timer?;
+    private stopped;
+    private running;
+    private lastGauges;
+    private lastPrune;
+    constructor(opts: ResolvedEventsOptions, conn: EventsConnection, prisma: PrismaResolver, metrics: EventsMetrics);
+    start(): void;
+    stop(): Promise<void>;
+    private schedule;
+    private tick;
+    /** Un giro. Restituisce quante righe ha pubblicato. Usato anche dai test. */
+    drainOnce(): Promise<number>;
+    private publish;
+    private housekeeping;
+}
+//# sourceMappingURL=relay.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"relay.service.d.ts","sourceRoot":"","sources":["../src/relay.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,KAAK,EAA2B,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAa9E;;;;;GAKG;AACH,qBACa,WAAW;IASI,OAAO,CAAC,QAAQ,CAAC,IAAI;IAC7C,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAX1B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA6B;IACjD,OAAO,CAAC,KAAK,CAAC,CAAiB;IAC/B,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,SAAS,CAAK;gBAGqB,IAAI,EAAE,qBAAqB,EACnD,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,aAAa;IAGzC,KAAK,IAAI,IAAI;IAMP,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,OAAO,CAAC,QAAQ;YAKF,IAAI;IAYlB,6EAA6E;IACvE,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;YA0CpB,OAAO;YAuBP,YAAY;CAsB3B"}

package/dist/relay.service.js

@@ -0,0 +1,153 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OutboxRelay = void 0;
+const common_1 = require("@nestjs/common");
+const transport_node_1 = require("@nats-io/transport-node");
+const connection_1 = require("./connection");
+const metrics_1 = require("./metrics");
+const prisma_resolver_1 = require("./prisma-resolver");
+const tokens_1 = require("./tokens");
+/**
+ * Relay dell'outbox: prende fino a `relayBatchSize` righe con `FOR UPDATE SKIP LOCKED` (più repliche non si pestano i piedi),
+ * pubblica con `Nats-Msg-Id` = id, aspetta il PubAck e segna `publishedAt`, tutto nella stessa transazione. Se la pubblicazione
+ * fallisce si ferma (l'ordine del giro si conserva), conta il tentativo e riprova al giro dopo. L'ordine fra transazioni che
+ * committano fuori ordine, e fra repliche, NON è garantito: chi consuma usa `aggregateVersion`.
+ */
+let OutboxRelay = class OutboxRelay {
+    constructor(opts, conn, prisma, metrics) {
+        this.opts = opts;
+        this.conn = conn;
+        this.prisma = prisma;
+        this.metrics = metrics;
+        this.log = new common_1.Logger('EventsRelay');
+        this.stopped = true;
+        this.running = false;
+        this.lastGauges = 0;
+        this.lastPrune = 0;
+    }
+    start() {
+        if (!this.stopped)
+            return;
+        this.stopped = false;
+        this.schedule(0);
+    }
+    async stop() {
+        this.stopped = true;
+        if (this.timer)
+            clearTimeout(this.timer);
+        while (this.running)
+            await new Promise((r) => setTimeout(r, 10));
+    }
+    schedule(ms) {
+        if (this.stopped)
+            return;
+        this.timer = setTimeout(() => void this.tick(), ms);
+    }
+    async tick() {
+        let again = false;
+        try {
+            const n = await this.drainOnce();
+            again = n >= this.opts.relayBatchSize;
+            await this.housekeeping();
+        }
+        catch (e) {
+            this.log.warn(`giro del relay fallito: ${e?.message ?? e}`);
+        }
+        this.schedule(again ? 0 : this.opts.relayIntervalMs);
+    }
+    /** Un giro. Restituisce quante righe ha pubblicato. Usato anche dai test. */
+    async drainOnce() {
+        if (this.running)
+            return 0;
+        this.running = true;
+        try {
+            if (!this.conn.connected)
+                return 0;
+            const prisma = this.prisma.get();
+            return await prisma.$transaction(async (tx) => {
+                const rows = await tx.$queryRawUnsafe(`SELECT "id","subject","aggregateType","aggregateId","aggregateVersion","juridicalId","payload","headers"
+               FROM outbox_events WHERE "publishedAt" IS NULL ORDER BY "id" LIMIT ${Math.floor(this.opts.relayBatchSize)}
+               FOR UPDATE SKIP LOCKED`);
+                let done = 0;
+                for (const r of rows) {
+                    try {
+                        await this.publish(r);
+                    }
+                    catch (e) {
+                        await tx.$executeRawUnsafe(`UPDATE outbox_events SET "attempts" = "attempts" + 1, "lastError" = $2 WHERE "id" = $1::uuid`, r.id, String(e?.message ?? e).slice(0, 500));
+                        this.log.warn(`pubblicazione di ${r.subject} (${r.id}) fallita: ${e?.message ?? e}`);
+                        break;
+                    }
+                    await tx.$executeRawUnsafe(`UPDATE outbox_events SET "publishedAt" = CURRENT_TIMESTAMP, "attempts" = "attempts" + 1, "lastError" = NULL WHERE "id" = $1::uuid`, r.id);
+                    this.metrics.inc('events_published_total', { subject: r.subject });
+                    done++;
+                }
+                return done;
+            }, { timeout: 60_000, maxWait: 10_000 });
+        }
+        finally {
+            this.running = false;
+        }
+    }
+    async publish(r) {
+        const envelope = {
+            v: 1,
+            id: r.id,
+            subject: r.subject,
+            aggregateType: r.aggregateType,
+            aggregateId: r.aggregateId,
+            aggregateVersion: r.aggregateVersion,
+            occurredAt: r.headers?.occurredAt ?? new Date().toISOString(),
+            ...(r.juridicalId ? { juridicalId: r.juridicalId } : {}),
+            data: r.payload,
+        };
+        const h = (0, transport_node_1.headers)();
+        h.set('Nats-Msg-Id', r.id);
+        h.set('Gen-Event-Version', '1');
+        if (r.juridicalId)
+            h.set('Gen-Tenant', r.juridicalId);
+        if (r.headers?.traceparent)
+            h.set('traceparent', r.headers.traceparent);
+        if (this.opts.signatureMode !== 'off' && this.opts.signer) {
+            h.set('Gen-Sig', await this.opts.signer({ eventId: r.id, subject: r.subject, juridicalId: r.juridicalId }));
+        }
+        await this.conn.jetstream.publish(r.subject, JSON.stringify(envelope), { msgID: r.id, headers: h, timeout: 10_000 });
+    }
+    async housekeeping() {
+        const now = Date.now();
+        const prisma = this.prisma.get();
+        if (now - this.lastGauges > 5_000) {
+            this.lastGauges = now;
+            const [row] = await prisma.$queryRawUnsafe(`SELECT COUNT(*) AS pending, EXTRACT(EPOCH FROM (CURRENT_TIMESTAMP - MIN("createdAt")))::float8 AS oldest
+           FROM outbox_events WHERE "publishedAt" IS NULL`);
+            this.metrics.set('events_outbox_pending', Number(row?.pending ?? 0));
+            this.metrics.set('events_outbox_oldest_seconds', Number(row?.oldest ?? 0));
+        }
+        if (now - this.lastPrune > 600_000) {
+            this.lastPrune = now;
+            await prisma.$executeRawUnsafe(`DELETE FROM outbox_events WHERE "publishedAt" IS NOT NULL AND "publishedAt" < CURRENT_TIMESTAMP - make_interval(days => ${Math.floor(this.opts.outboxRetentionDays)})`);
+            await prisma.$executeRawUnsafe(`DELETE FROM inbox_processed WHERE "processedAt" < CURRENT_TIMESTAMP - make_interval(days => ${Math.floor(this.opts.inboxRetentionDays)})`);
+        }
+    }
+};
+exports.OutboxRelay = OutboxRelay;
+exports.OutboxRelay = OutboxRelay = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(tokens_1.EVENTS_OPTIONS)),
+    __metadata("design:paramtypes", [Object, connection_1.EventsConnection,
+        prisma_resolver_1.PrismaResolver,
+        metrics_1.EventsMetrics])
+], OutboxRelay);
+//# sourceMappingURL=relay.service.js.map

package/dist/relay.service.js.map

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

package/dist/tokens.d.ts

@@ -0,0 +1,4 @@
+export declare const EVENTS_OPTIONS: unique symbol;
+export declare const EVENTS_RAW_OPTIONS: unique symbol;
+export declare const ON_EVENT_METADATA = "genai:events:on-event";
+//# sourceMappingURL=tokens.d.ts.map

package/dist/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,eAAiC,CAAC;AAC7D,eAAO,MAAM,kBAAkB,eAAqC,CAAC;AACrE,eAAO,MAAM,iBAAiB,0BAA0B,CAAC"}

package/dist/tokens.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ON_EVENT_METADATA = exports.EVENTS_RAW_OPTIONS = exports.EVENTS_OPTIONS = void 0;
+exports.EVENTS_OPTIONS = Symbol('GENAI_EVENTS_OPTIONS');
+exports.EVENTS_RAW_OPTIONS = Symbol('GENAI_EVENTS_RAW_OPTIONS');
+exports.ON_EVENT_METADATA = 'genai:events:on-event';
+//# sourceMappingURL=tokens.js.map

package/dist/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":";;;AAAa,QAAA,cAAc,GAAG,MAAM,CAAC,sBAAsB,CAAC,CAAC;AAChD,QAAA,kBAAkB,GAAG,MAAM,CAAC,0BAA0B,CAAC,CAAC;AACxD,QAAA,iBAAiB,GAAG,uBAAuB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,116 @@
+/** Busta di ogni evento (versione 1). Il corpo del messaggio NATS è questo oggetto in JSON. */
+export interface EventEnvelope<T = unknown> {
+    v: 1;
+    /** UUID v7, uguale a `Nats-Msg-Id`. */
+    id: string;
+    subject: string;
+    aggregateType: string;
+    aggregateId: string;
+    aggregateVersion: number;
+    /** ISO 8601 UTC del momento in cui l'evento è stato scritto nell'outbox. */
+    occurredAt: string;
+    /** Azienda di riferimento (anche in `Gen-Tenant`). */
+    juridicalId?: string;
+    /** Solo id e stati, mai dati personali. */
+    data: T;
+}
+/** Servizi che pubblicano o consumano eventi (contratto del treno 3+4). */
+export type EventsService = 'id' | 'hr' | 'train' | 'ops' | 'notify' | 'ai' | 'sign' | 'bill' | 'audit';
+/** `EVENTS_MODE`: off = niente; outbox = si scrive l'outbox ma non si pubblica né si consuma; on = tutto. */
+export type EventsMode = 'off' | 'outbox' | 'on';
+/** `EVENTS_SIGNATURE`: off = nessuna firma; shadow = firma e verifica senza rifiutare; enforce = rifiuta le firme assenti o errate. */
+export type EventsSignatureMode = 'off' | 'shadow' | 'enforce';
+/** Il pezzo di Prisma che serve alla libreria dentro una transazione (il `tx` di `$transaction(async tx => …)`). */
+export interface PrismaTx {
+    $executeRawUnsafe(query: string, ...values: any[]): Promise<number>;
+    $queryRawUnsafe<T = unknown>(query: string, ...values: any[]): Promise<T>;
+}
+/** Il pezzo di `PrismaService` che serve alla libreria. Un client di transazione NON ha `$transaction`: così si riconosce. */
+export interface PrismaLike extends PrismaTx {
+    $transaction<R>(fn: (tx: PrismaTx) => Promise<R>, options?: {
+        timeout?: number;
+        maxWait?: number;
+    }): Promise<R>;
+}
+export interface SignParams {
+    eventId: string;
+    subject: string;
+    juridicalId?: string | null;
+}
+/** Produce il JWT di `Gen-Sig` (audience `events`). Con authz 0.7: `(p) => signEventToken(ctx, { eventId: p.eventId, subject: p.subject })`. */
+export type EventSigner = (params: SignParams) => string | Promise<string>;
+export interface VerifyParams {
+    eventId: string;
+    subject: string;
+    mode: Exclude<EventsSignatureMode, 'off'>;
+}
+/** Verifica `Gen-Sig`; lancia se non valida. Con authz 0.7: `(t, p) => verifyEventToken(t, p)`. `token` è `undefined` se manca. */
+export type EventVerifier = (token: string | undefined, params: VerifyParams) => void | Promise<void>;
+export interface OnEventOptions {
+    /** Nome del consumer durevole: `<servizio>.<gestore>` (es. `hr.employment-changed`). Unico nel cluster. */
+    consumer: string;
+    /** Messaggi senza ack tollerati dal consumer (default 100). */
+    maxAckPending?: number;
+}
+export type EventHandler<T = any> = (evt: EventEnvelope<T>, tx: PrismaTx) => Promise<void>;
+export interface EnqueueParams<T = unknown> {
+    /** `evt.<servizio>.<entità>.<fatto>` al passato. */
+    subject: string;
+    aggregate: {
+        type: string;
+        id: string;
+        version: number;
+    };
+    juridicalId?: string | null;
+    /** Diventa `data` della busta. Solo id e stati. */
+    data: T;
+}
+export interface EventsModuleOptions {
+    service: EventsService;
+    /** Default `EVT_<SERVICE>`. */
+    stream?: string;
+    /** La classe (o il token) di `PrismaService` da risolvere dal contenitore di Nest, oppure direttamente l'istanza. */
+    prisma: unknown;
+    /** Default: `EVENTS_MODE` o `off`. */
+    mode?: EventsMode;
+    /** Default: `EVENTS_SIGNATURE` o `off`. */
+    signatureMode?: EventsSignatureMode;
+    signer?: EventSigner;
+    verifier?: EventVerifier;
+    /** Default: `EVENTS_NATS_URL` o `NATS_URL`. */
+    natsUrl?: string;
+    /** Opzioni di connessione aggiuntive (`@nats-io/transport-node`); di serie `NATS_NKEY_SEED` → autenticazione nkey. */
+    connection?: Record<string, unknown>;
+    /** Se creare lo stream del servizio all'avvio (default true). */
+    createStream?: boolean;
+    /** Repliche dello stream (default 3; 1 in sviluppo). Env `EVENTS_STREAM_REPLICAS`. */
+    streamReplicas?: number;
+    /**
+     * Tetto in byte dello stream (default 5 GiB). JetStream lo **riserva** sul `max_file_store` del server alla creazione: con un NATS
+     * piccolo (sviluppo, staging, CI) due stream da 5 GiB possono non starci e l'avvio degli eventi resta a riprovare. Env `EVENTS_STREAM_MAX_BYTES`.
+     */
+    streamMaxBytes?: number;
+    /** Attese fra le consegne: default 10s, 1m, 5m, 30m, 2h, 6h, 12h (8 consegne). */
+    retryScheduleMs?: number[];
+    /** Intervallo del relay (default 500 ms). */
+    relayIntervalMs?: number;
+    /** Durata di ogni attesa del consumer prima di ricontrollare lo stop (default 5000 ms, minimo 1000 imposto da JetStream). */
+    pollMs?: number;
+    /** Righe dell'outbox per giro (default 100). */
+    relayBatchSize?: number;
+    /** Giorni di conservazione delle righe pubblicate (default 7) e dell'inbox (default 30). */
+    outboxRetentionDays?: number;
+    inboxRetentionDays?: number;
+    /** Per leggere il `traceparent` corrente al momento di `enqueue` (lo fornisce `@generazioneai/telemetry`). */
+    traceparent?: () => string | undefined;
+}
+export declare const DEFAULT_RETRY_SCHEDULE_MS: number[];
+export interface ResolvedEventsOptions extends Required<Pick<EventsModuleOptions, 'service' | 'stream' | 'mode' | 'signatureMode' | 'createStream' | 'streamReplicas' | 'streamMaxBytes' | 'retryScheduleMs' | 'relayIntervalMs' | 'relayBatchSize' | 'pollMs' | 'outboxRetentionDays' | 'inboxRetentionDays'>> {
+    natsUrl?: string;
+    signer?: EventSigner;
+    verifier?: EventVerifier;
+    connection?: Record<string, unknown>;
+    traceparent?: () => string | undefined;
+}
+export declare function resolveOptions(o: EventsModuleOptions, env?: NodeJS.ProcessEnv): ResolvedEventsOptions;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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