@nextage/era-lib 1.0.176 → 1.0.178

package/build/events/base-event.controller.d.ts

@@ -3,14 +3,42 @@ import { BaseMongoDoc } from '@nextage/nx-frame-be/build/common/base/base.interf
 import { BaseController } from '@nextage/nx-frame-be/build/common/base/base.controller';
 import { NxContext } from '@nextage/nx-frame-be';
 import { Event, IPublisher } from './interfaces';
+import { PublisherProvider } from './types/relay.interfaces';
 import { QueueEventType } from './types/enums';
-export declare abstract class BaseEventCtrl<TCreate extends Event, TUpdate extends Event, TRemove extends Event, TAttrs, TDoc extends BaseMongoDoc, TModel extends BaseModel<TAttrs, TDoc, any>> extends BaseController<TAttrs, TDoc, TModel> {
-    protected abstract parsePubCreateItem(item: TAttrs, type: QueueEventType): TCreate['data'];
-    protected abstract parsePubUpdateItem(item: TAttrs, type: QueueEventType): TUpdate['data'];
-    protected abstract parsePubRemoveItem(item: TAttrs, type: QueueEventType): TRemove['data'];
+export declare abstract class BaseEventCtrl<TCreate extends Event, TUpdate extends Event, TRemove extends Event, TAttrs, TDoc extends BaseMongoDoc, TModel extends BaseModel<TAttrs, TDoc, any>> extends BaseController<TAttrs, TDoc, TModel> implements PublisherProvider {
+    /**
+     * Declarative publish field-map (Step 3.4c). The default parsePub* methods pick
+     * exactly these keys from the entity, replacing the ~57 hand-written per-controller
+     * parsers. `pubFields` drives BOTH create and update; set `pubUpdateFields` only
+     * for the rare create ≠ update case; `pubRemoveFields` is the leaner remove subset.
+     * A subclass may still OVERRIDE parsePub* directly for non-pick (computed) payloads.
+     */
+    protected pubFields: (keyof TAttrs)[];
+    protected pubUpdateFields?: (keyof TAttrs)[];
+    protected pubRemoveFields: (keyof TAttrs)[];
+    /**
+     * Default create/update/remove parsers: a pure pick over the declared field-map.
+     * Overridable when a payload needs computed values (see e.g. i18n-shaped events).
+     *
+     * @param item
+     * @param type
+     */
+    protected parsePubCreateItem(item: TAttrs, type: QueueEventType): TCreate['data'];
+    protected parsePubUpdateItem(item: TAttrs, type: QueueEventType): TUpdate['data'];
+    protected parsePubRemoveItem(item: TAttrs, type: QueueEventType): TRemove['data'];
     protected abstract createPublisher: IPublisher<TCreate>[];
     protected abstract updatePublisher: IPublisher<TUpdate>[];
     protected abstract removePublisher: IPublisher<TRemove>[];
+    constructor(config: {
+        model: TModel;
+        mergeUpdate?: boolean;
+    });
+    /**
+     * All publishers this controller owns (create + update + remove). Read LAZILY by
+     * the relay's publisher registry to route a `sent:false` outbox row back to its
+     * publisher family by subject — so it runs after the subclass field initialisers.
+     */
+    eventPublishers(): IPublisher<Event>[];
     private publishConfig?;
     /**
      * Inizializza la configurazione dei publisher (lazy initialization)
@@ -23,12 +51,24 @@ export declare abstract class BaseEventCtrl<TCreate extends Event, TUpdate exten
      * @param context
      */
     /**
+     * Build the parsed, ready-to-publish message for a write: parse the payload,
+     * resolve the subject (shared by every publisher of the type — same event on
+     * NATS + msg) and stamp the OUTGOING cascade meta from `context._event` (root
+     * when absent). Returns undefined when the type has no publisher/parser. Built
+     * ONCE and reused for both the outbox row and the immediate dispatch.
      *
      * @param item
      * @param type
      * @param context
      */
-    publish(item: TAttrs, type: QueueEventType, context: NxContext): Promise<void>;
+    private buildMessage;
+    /**
+     * Dispatch a prepared message on every publisher of its type. Shared by the
+     * immediate post-commit dispatch and the relay replay.
+     *
+     * @param msg
+     */
+    private publishMessage;
     /**
      * Overridable post-write / post-read enrichment of the RETURNED document (e.g.
      * populate references, attach a joined aggregate). Runs AFTER the atomic write
@@ -81,22 +121,23 @@ export declare abstract class BaseEventCtrl<TCreate extends Event, TUpdate exten
      */
     remove(id: string, context: NxContext): Promise<TDoc>;
     /**
-     * Persist an outbox row (sent:false) for `item` inside the caller's transaction.
-     * Returns the row id, or undefined when no outbox is registered (the event is
-     * then still published, just not tracked).
+     * Persist an outbox row (sent:false) for the prepared message inside the
+     * caller's transaction. The row carries the subject + parsed payload + cascade
+     * meta, so the relay can replay it faithfully. Returns the row id, or undefined
+     * when there is no message or no outbox registered (the event is then still
+     * dispatched, just not tracked).
      *
-     * @param item
-     * @param type
+     * @param msg
      * @param context
      */
     private enqueueOutbox;
     /**
-     * Dispatch the event to the broker, then mark the outbox row as sent. Runs AFTER
-     * the transaction commits, so `publish` (a non-DB side effect) is never retried
-     * by `withTransaction` and a broker failure leaves a recoverable sent:false row.
+     * Dispatch the prepared message to the broker, then mark the outbox row as sent.
+     * Runs AFTER the transaction commits, so `publish` (a non-DB side effect) is
+     * never retried by `withTransaction` and a broker failure leaves a recoverable
+     * sent:false row for the relay (Step 3.5).
      *
-     * @param item
-     * @param type
+     * @param msg
      * @param outboxId
      * @param context
      */

package/build/events/base-event.controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-event.controller.d.ts","sourceRoot":"","sources":["../../src/events/base-event.controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAc,mDAAmD,CAAC;AACtF,OAAO,EAAE,YAAY,EAAE,MAAW,wDAAwD,CAAC;AAC3F,OAAO,EAAE,cAAc,EAAE,MAAS,wDAAwD,CAAC;AAE3F,OAAO,EAAE,SAAS,EAAE,MAAc,sBAAsB,CAAC;AAGzD,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAKjD,OAAO,EAAE,cAAc,EAAE,MAAS,eAAe,CAAC;AAOlD,8BAAsB,aAAa,CAAC,OAAO,SAAS,KAAK,EAAE,OAAO,SAAS,KAAK,EAAE,OAAO,SAAS,KAAK,EAAE,MAAM,EAAE,IAAI,SAAS,YAAY,EAAE,MAAM,SAAS,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAE,SAAQ,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC;IAMnO,SAAS,CAAC,QAAQ,CAAC,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAI,OAAO,CAAC,MAAM,CAAC;IAC3F,SAAS,CAAC,QAAQ,CAAC,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAI,OAAO,CAAC,MAAM,CAAC;IAC3F,SAAS,CAAC,QAAQ,CAAC,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAI,OAAO,CAAC,MAAM,CAAC;IAE3F,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;IAC1D,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;IAC1D,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;IAK1D,OAAO,CAAC,aAAa,CAAC,CAAmD;IAEzE;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAqBxB;;;;;OAKG;IAoBH;;;;;OAKG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAWpF;;;;;;;;;OASG;cACa,WAAW,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzE;;;;;OAKG;IACY,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAMzE;;;;;OAKG;IACH;;;;;;;;;;OAUG;IACY,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBtE;;;;;;OAMG;IACY,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBlF;;;;;OAKG;IACY,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBpE;;;;;;;;OAQG;YACW,aAAa;IAY3B;;;;;;;;;OASG;YACW,cAAc;CAQ7B"}
+{"version":3,"file":"base-event.controller.d.ts","sourceRoot":"","sources":["../../src/events/base-event.controller.ts"],"names":[],"mappings":"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"}

package/build/events/base-event.controller.js

@@ -5,8 +5,53 @@ const base_controller_1 = require("@nextage/nx-frame-be/build/common/base/base.c
 const mongo_utils_1 = require("@nextage/nx-frame-be/build/common/base/mongo-utils");
 const outbox_1 = require("./outbox");
 const cascade_1 = require("./cascade");
+const field_map_1 = require("./field-map");
+const publisher_registry_1 = require("./publisher-registry");
 const enums_1 = require("./types/enums");
 class BaseEventCtrl extends base_controller_1.BaseController {
+    /**
+     * Default create/update/remove parsers: a pure pick over the declared field-map.
+     * Overridable when a payload needs computed values (see e.g. i18n-shaped events).
+     *
+     * @param item
+     * @param type
+     */
+    parsePubCreateItem(item, type) {
+        return (0, field_map_1.pickPubFields)(item, this.pubFields);
+    }
+    parsePubUpdateItem(item, type) {
+        return (0, field_map_1.pickPubFields)(item, this.pubUpdateFields ?? this.pubFields);
+    }
+    parsePubRemoveItem(item, type) {
+        return (0, field_map_1.pickPubFields)(item, this.pubRemoveFields);
+    }
+    // protected abstract createPublisher: Publisher<TCreate> | NatsPublisher<TCreate>;
+    // protected abstract updatePublisher: Publisher<TUpdate> | NatsPublisher<TUpdate>;
+    // protected abstract removePublisher: Publisher<TRemove> | NatsPublisher<TRemove>;
+    constructor(config) {
+        super(config);
+        // protected abstract CreatePublisher: new (client: MsgClientInterface) => Publisher<TCreate> | NatsPublisher<TCreate>;
+        // protected abstract UpdatePublisher: new (client: MsgClientInterface) => Publisher<TUpdate> | NatsPublisher<TUpdate>;
+        // protected abstract RemovePublisher: new (client: MsgClientInterface) => Publisher<TRemove> | NatsPublisher<TRemove>;
+        /**
+         * Declarative publish field-map (Step 3.4c). The default parsePub* methods pick
+         * exactly these keys from the entity, replacing the ~57 hand-written per-controller
+         * parsers. `pubFields` drives BOTH create and update; set `pubUpdateFields` only
+         * for the rare create ≠ update case; `pubRemoveFields` is the leaner remove subset.
+         * A subclass may still OVERRIDE parsePub* directly for non-pick (computed) payloads.
+         */
+        this.pubFields = [];
+        this.pubRemoveFields = [];
+        (0, publisher_registry_1.registerPublisherProvider)(this);
+    }
+    /**
+     * All publishers this controller owns (create + update + remove). Read LAZILY by
+     * the relay's publisher registry to route a `sent:false` outbox row back to its
+     * publisher family by subject — so it runs after the subclass field initialisers.
+     */
+    eventPublishers() {
+        return [...this.createPublisher, ...this.updatePublisher, ...this.removePublisher];
+    }
     /**
      * Inizializza la configurazione dei publisher (lazy initialization)
      */
@@ -52,18 +97,36 @@ class BaseEventCtrl extends base_controller_1.BaseController {
     //   }
     // }
     /**
+     * Build the parsed, ready-to-publish message for a write: parse the payload,
+     * resolve the subject (shared by every publisher of the type — same event on
+     * NATS + msg) and stamp the OUTGOING cascade meta from `context._event` (root
+     * when absent). Returns undefined when the type has no publisher/parser. Built
+     * ONCE and reused for both the outbox row and the immediate dispatch.
      *
      * @param item
      * @param type
      * @param context
      */
-    async publish(item, type, context) {
+    buildMessage(item, type, context) {
         const { publishers, parser } = this.getPublishConfig()[type] ?? {};
         if (!publishers?.length || !parser)
-            return;
-        const data = parser(item, type);
-        const meta = (0, cascade_1.outgoingMeta)(context?._event);
-        await Promise.all(publishers.map(pub => pub.publish(data, meta)));
+            return undefined;
+        return {
+            type,
+            subject: publishers[0].subject,
+            data: parser(item, type),
+            meta: (0, cascade_1.outgoingMeta)(context?._event),
+        };
+    }
+    /**
+     * Dispatch a prepared message on every publisher of its type. Shared by the
+     * immediate post-commit dispatch and the relay replay.
+     *
+     * @param msg
+     */
+    async publishMessage(msg) {
+        const publishers = this.getPublishConfig()[msg.type]?.publishers ?? [];
+        await Promise.all(publishers.map(pub => pub.publish(msg.data, msg.meta)));
     }
     /**
      * Overridable post-write / post-read enrichment of the RETURNED document (e.g.
@@ -106,15 +169,15 @@ class BaseEventCtrl extends base_controller_1.BaseController {
      * @returns
      */
     async create(item, context) {
-        let payload;
+        let msg;
         let outboxId;
         const res = await this.withTransaction(context, async (ctx) => {
             const created = await super.create(item, ctx);
-            payload = created.toJSON();
-            outboxId = await this.enqueueOutbox(payload, enums_1.QueueEventType.create, ctx);
+            msg = this.buildMessage(created.toJSON(), enums_1.QueueEventType.create, context);
+            outboxId = await this.enqueueOutbox(msg, ctx);
             return created;
         });
-        await this.dispatchOutbox(payload, enums_1.QueueEventType.create, outboxId, context);
+        await this.dispatchOutbox(msg, outboxId, context);
         return this.decorateDoc(res, context);
     }
     /**
@@ -125,15 +188,15 @@ class BaseEventCtrl extends base_controller_1.BaseController {
      * @returns
      */
     async update(id, item, context) {
-        let payload;
+        let msg;
         let outboxId;
         const res = await this.withTransaction(context, async (ctx) => {
             const updated = await super.update(id, item, ctx);
-            payload = { id, ...updated.toObject() };
-            outboxId = await this.enqueueOutbox(payload, enums_1.QueueEventType.update, ctx);
+            msg = this.buildMessage({ id, ...updated.toObject() }, enums_1.QueueEventType.update, context);
+            outboxId = await this.enqueueOutbox(msg, ctx);
             return updated;
         });
-        await this.dispatchOutbox(payload, enums_1.QueueEventType.update, outboxId, context);
+        await this.dispatchOutbox(msg, outboxId, context);
         return this.decorateDoc(res, context);
     }
     /**
@@ -143,47 +206,50 @@ class BaseEventCtrl extends base_controller_1.BaseController {
      * @returns
      */
     async remove(id, context) {
-        let payload;
+        let msg;
         let outboxId;
         const res = await this.withTransaction(context, async (ctx) => {
             const removed = await this.model.remove(id, ctx);
-            payload = { id, ...removed.toObject() };
-            outboxId = await this.enqueueOutbox(payload, enums_1.QueueEventType.remove, ctx);
+            msg = this.buildMessage({ id, ...removed.toObject() }, enums_1.QueueEventType.remove, context);
+            outboxId = await this.enqueueOutbox(msg, ctx);
             return removed;
         });
-        await this.dispatchOutbox(payload, enums_1.QueueEventType.remove, outboxId, context);
+        await this.dispatchOutbox(msg, outboxId, context);
         return res;
     }
     /**
-     * Persist an outbox row (sent:false) for `item` inside the caller's transaction.
-     * Returns the row id, or undefined when no outbox is registered (the event is
-     * then still published, just not tracked).
+     * Persist an outbox row (sent:false) for the prepared message inside the
+     * caller's transaction. The row carries the subject + parsed payload + cascade
+     * meta, so the relay can replay it faithfully. Returns the row id, or undefined
+     * when there is no message or no outbox registered (the event is then still
+     * dispatched, just not tracked).
      *
-     * @param item
-     * @param type
+     * @param msg
      * @param context
      */
-    async enqueueOutbox(item, type, context) {
+    async enqueueOutbox(msg, context) {
         const outbox = (0, outbox_1.getOutbox)();
-        if (!outbox)
+        if (!outbox || !msg)
             return undefined;
         const id = (0, mongo_utils_1.genObjectId)().toString();
-        const evt = { id, type, data: item };
+        const evt = { id, type: msg.type, subject: msg.subject, data: msg.data, meta: msg.meta };
         await outbox.create(evt, context);
         return id;
     }
     /**
-     * Dispatch the event to the broker, then mark the outbox row as sent. Runs AFTER
-     * the transaction commits, so `publish` (a non-DB side effect) is never retried
-     * by `withTransaction` and a broker failure leaves a recoverable sent:false row.
+     * Dispatch the prepared message to the broker, then mark the outbox row as sent.
+     * Runs AFTER the transaction commits, so `publish` (a non-DB side effect) is
+     * never retried by `withTransaction` and a broker failure leaves a recoverable
+     * sent:false row for the relay (Step 3.5).
      *
-     * @param item
-     * @param type
+     * @param msg
      * @param outboxId
      * @param context
      */
-    async dispatchOutbox(item, type, outboxId, context) {
-        await this.publish(item, type, context);
+    async dispatchOutbox(msg, outboxId, context) {
+        if (!msg)
+            return;
+        await this.publishMessage(msg);
         const outbox = (0, outbox_1.getOutbox)();
         if (outbox && outboxId)
             await outbox.markSent(outboxId, context);

package/build/events/base-event.controller.js.map

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

package/build/events/event-relay.d.ts

@@ -0,0 +1,26 @@
+import { EventRelayOptions } from './types/relay.interfaces';
+export declare class EventRelay {
+    private readonly batchSize;
+    private readonly intervalMs;
+    private readonly onError;
+    private readonly onSkip;
+    private timer?;
+    private draining;
+    constructor(opts?: EventRelayOptions);
+    /**
+     * Drain one batch: the oldest `sent:false` rows → re-publish each on every
+     * publisher registered for its subject → mark it sent. A row whose subject has
+     * no registered publisher (controller not loaded) is skipped and retried on the
+     * next tick. Returns the number of rows successfully re-published. Never throws
+     * for a single row/broker failure — that row simply stays `sent:false`.
+     */
+    drainOnce(): Promise<number>;
+    /**
+     * Start the relay: an immediate startup drain, then a periodic sweep every
+     * `intervalMs`. The timer is `unref`'d so it never keeps the process alive.
+     */
+    start(): void;
+    /** Stop the periodic sweep (graceful shutdown / test teardown). */
+    stop(): void;
+}
+//# sourceMappingURL=event-relay.d.ts.map

package/build/events/event-relay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-relay.d.ts","sourceRoot":"","sources":["../../src/events/event-relay.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,iBAAiB,EAAE,MAAwC,0BAA0B,CAAC;AAG/F,qBAAa,UAAU;IAErB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4C;IAEnE,OAAO,CAAC,KAAK,CAAC,CAAmC;IACjD,OAAO,CAAC,QAAQ,CAAS;gBAEb,IAAI,GAAE,iBAAsB;IAQxC;;;;;;OAMG;IACG,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;IA2ClC;;;OAGG;IACH,KAAK,IAAI,IAAI;IAab,mEAAmE;IACnE,IAAI,IAAI,IAAI;CAOb"}

package/build/events/event-relay.js

@@ -0,0 +1,95 @@
+"use strict";
+/* ────────────────────────────────────────────────────────────────────────────
+ * EVENT RELAY — at-least-once redelivery of `sent:false` outbox rows (Step 3.5)
+ *
+ * Closes finding E1: with the atomic outbox (3.4) an entity + its outbox row are
+ * committed together, then published post-commit; if the broker is down or the
+ * process crashes in that window the row stays `sent:false` and — until now — was
+ * never re-published. The relay drains those rows:
+ *   • at startup  → recover events accumulated while THIS service was down;
+ *   • periodically → recover from a transient broker/network outage while the
+ *     process stays up (the publish failed but we did not crash).
+ *
+ * Re-publish is safe (at-least-once): downstream consumers are version-guarded
+ * (3.3), so a duplicate delivery is idempotent. Routing back to the publisher is
+ * via the subject persisted on the row + the publisher registry.
+ * ──────────────────────────────────────────────────────────────────────────── */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventRelay = void 0;
+const outbox_1 = require("./outbox");
+const publisher_registry_1 = require("./publisher-registry");
+const relay_constants_1 = require("./types/relay.constants");
+class EventRelay {
+    constructor(opts = {}) {
+        this.draining = false;
+        this.batchSize = opts.batchSize ?? relay_constants_1.DEFAULT_RELAY_BATCH_SIZE;
+        this.intervalMs = opts.intervalMs ?? relay_constants_1.DEFAULT_RELAY_INTERVAL_MS;
+        this.onError = opts.onError ?? (() => { });
+        this.onSkip = opts.onSkip ?? (() => { });
+    }
+    /**
+     * Drain one batch: the oldest `sent:false` rows → re-publish each on every
+     * publisher registered for its subject → mark it sent. A row whose subject has
+     * no registered publisher (controller not loaded) is skipped and retried on the
+     * next tick. Returns the number of rows successfully re-published. Never throws
+     * for a single row/broker failure — that row simply stays `sent:false`.
+     */
+    async drainOnce() {
+        const outbox = (0, outbox_1.getOutbox)();
+        if (!outbox)
+            return 0;
+        // Re-entrancy guard: a slow batch must not overlap the periodic tick.
+        if (this.draining)
+            return 0;
+        this.draining = true;
+        let sent = 0;
+        try {
+            const rows = await outbox.findUnsent(this.batchSize);
+            for (const row of rows) {
+                const publishers = (0, publisher_registry_1.resolvePublishers)(row.subject);
+                if (!publishers.length) {
+                    this.onSkip(row.subject, row.id);
+                    continue;
+                }
+                try {
+                    await Promise.all(publishers.map(pub => pub.publish(row.data, row.meta)));
+                    await outbox.markSent(row.id, {});
+                    sent++;
+                }
+                catch (err) {
+                    // Leave the row sent:false for the next tick; do not abort the batch.
+                    this.onError(err);
+                }
+            }
+        }
+        catch (err) {
+            this.onError(err);
+        }
+        finally {
+            this.draining = false;
+        }
+        return sent;
+    }
+    /**
+     * Start the relay: an immediate startup drain, then a periodic sweep every
+     * `intervalMs`. The timer is `unref`'d so it never keeps the process alive.
+     */
+    start() {
+        if (this.timer)
+            return;
+        void this.drainOnce().catch(err => this.onError(err));
+        this.timer = setInterval(() => {
+            void this.drainOnce().catch(err => this.onError(err));
+        }, this.intervalMs);
+        this.timer.unref?.();
+    }
+    /** Stop the periodic sweep (graceful shutdown / test teardown). */
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = undefined;
+        }
+    }
+}
+exports.EventRelay = EventRelay;
+//# sourceMappingURL=event-relay.js.map

package/build/events/event-relay.js.map

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

package/build/events/field-map.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Build a new object holding exactly `keys` picked from `item`, preserving
+ * `undefined` values for absent fields (parity with a hand-written literal).
+ *
+ * @param item source entity
+ * @param keys published field set
+ */
+export declare function pickPubFields<T>(item: T, keys: readonly (keyof T)[]): Record<string, unknown>;
+//# sourceMappingURL=field-map.d.ts.map

package/build/events/field-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-map.d.ts","sourceRoot":"","sources":["../../src/events/field-map.ts"],"names":[],"mappings":"AASA;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAS7F"}

package/build/events/field-map.js

@@ -0,0 +1,26 @@
+"use strict";
+/* ────────────────────────────────────────────────────────────────────────────
+ * FIELD-MAP — declarative publish payload picker (Step 3.4c)
+ *
+ * Backs the default parsePub{Create,Update,Remove}Item of BaseEventCtrl: a pure
+ * key-pick that replaces ~57 hand-written per-controller parsers. Keys are copied
+ * UNCONDITIONALLY (a missing value lands as `undefined`) so the produced payload
+ * is byte-for-byte identical to the old `{ a: item.a, b: item.b }` object literal.
+ * ──────────────────────────────────────────────────────────────────────────── */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pickPubFields = pickPubFields;
+/**
+ * Build a new object holding exactly `keys` picked from `item`, preserving
+ * `undefined` values for absent fields (parity with a hand-written literal).
+ *
+ * @param item source entity
+ * @param keys published field set
+ */
+function pickPubFields(item, keys) {
+    const out = {};
+    for (const key of keys) {
+        out[key] = item?.[key];
+    }
+    return out;
+}
+//# sourceMappingURL=field-map.js.map

package/build/events/field-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-map.js","sourceRoot":"","sources":["../../src/events/field-map.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;AASlF,sCASC;AAhBD;;;;;;GAMG;AACH,SAAgB,aAAa,CAAI,IAAO,EAAE,IAA0B;IAElE,MAAM,GAAG,GAA4B,EAAE,CAAC;IAExC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,GAAG,CAAC,GAAa,CAAC,GAAI,IAAY,EAAE,CAAC,GAAG,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/build/events/index.d.ts

@@ -3,7 +3,10 @@ export * from './interfaces';
 export * from './types';
 export * from './base-event.controller';
 export * from './cascade';
+export * from './event-relay';
+export * from './field-map';
 export * from './outbox';
+export * from './publisher-registry';
 export * from './msg-client-manager';
 export * from './msg-wrapper';
 export * from './base-listener';

package/build/events/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AAExB,cAAc,yBAAyB,CAAC;AACxC,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AAGzB,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,QAAQ,CAAC;AAGvB,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAGhC,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AAGjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AAExB,cAAc,yBAAyB,CAAC;AACxC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,sBAAsB,CAAC;AAGrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,QAAQ,CAAC;AAGvB,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAGhC,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AAGjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC"}

package/build/events/index.js

@@ -19,7 +19,10 @@ __exportStar(require("./interfaces"), exports);
 __exportStar(require("./types"), exports);
 __exportStar(require("./base-event.controller"), exports);
 __exportStar(require("./cascade"), exports);
+__exportStar(require("./event-relay"), exports);
+__exportStar(require("./field-map"), exports);
 __exportStar(require("./outbox"), exports);
+__exportStar(require("./publisher-registry"), exports);
 // messages on memory
 __exportStar(require("./msg-client-manager"), exports);
 __exportStar(require("./msg-wrapper"), exports);

package/build/events/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B;AAC9B,+CAA6B;AAC7B,0CAAwB;AAExB,0DAAwC;AACxC,4CAA0B;AAC1B,2CAAyB;AAEzB,qBAAqB;AACrB,uDAAqC;AACrC,gDAA8B;AAC9B,kDAAgC;AAChC,mDAAiC;AAEjC,mBAAmB;AACnB,wDAAsC;AACtC,iDAA+B;AAC/B,uDAAqC;AACrC,wDAAsC;AAEtC,YAAY;AACZ,iDAA+B;AAC/B,yCAAuB;AAEvB,aAAa;AACb,kDAAgC;AAChC,gDAA8B;AAC9B,6CAA2B;AAC3B,mDAAiC;AACjC,iDAA+B;AAC/B,4CAA0B;AAC1B,sDAAoC;AACpC,2CAAyB;AACzB,kDAAgC;AAEhC,cAAc;AACd,4CAA0B;AAC1B,kDAAgC;AAChC,oDAAkC;AAClC,qDAAmC;AACnC,qDAAmC;AACnC,oDAAkC;AAClC,iDAA+B;AAC/B,mDAAiC;AAEjC,oBAAoB;AACpB,kDAAgC;AAChC,+CAA6B;AAE7B,kBAAkB;AAClB,mCAAmC;AAEnC,cAAc"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B;AAC9B,+CAA6B;AAC7B,0CAAwB;AAExB,0DAAwC;AACxC,4CAA0B;AAC1B,gDAA8B;AAC9B,8CAA4B;AAC5B,2CAAyB;AACzB,uDAAqC;AAErC,qBAAqB;AACrB,uDAAqC;AACrC,gDAA8B;AAC9B,kDAAgC;AAChC,mDAAiC;AAEjC,mBAAmB;AACnB,wDAAsC;AACtC,iDAA+B;AAC/B,uDAAqC;AACrC,wDAAsC;AAEtC,YAAY;AACZ,iDAA+B;AAC/B,yCAAuB;AAEvB,aAAa;AACb,kDAAgC;AAChC,gDAA8B;AAC9B,6CAA2B;AAC3B,mDAAiC;AACjC,iDAA+B;AAC/B,4CAA0B;AAC1B,sDAAoC;AACpC,2CAAyB;AACzB,kDAAgC;AAEhC,cAAc;AACd,4CAA0B;AAC1B,kDAAgC;AAChC,oDAAkC;AAClC,qDAAmC;AACnC,qDAAmC;AACnC,oDAAkC;AAClC,iDAA+B;AAC/B,mDAAiC;AAEjC,oBAAoB;AACpB,kDAAgC;AAChC,+CAA6B;AAE7B,kBAAkB;AAClB,mCAAmC;AAEnC,cAAc"}

package/build/events/publisher-registry.d.ts

@@ -0,0 +1,21 @@
+import { Event, IPublisher } from './interfaces';
+import { PublisherProvider } from './types/relay.interfaces';
+/**
+ * Register a controller as a publisher provider. Idempotent (Set-backed): a
+ * singleton controller constructed once registers once. Called from the
+ * BaseEventCtrl constructor with `this`.
+ *
+ * @param provider
+ */
+export declare function registerPublisherProvider(provider: PublisherProvider): void;
+/**
+ * All registered publishers whose `subject` matches, gathered across every
+ * provider. Read lazily at call time, so a provider registered in a constructor
+ * (before its publisher fields are initialised) still resolves correctly later.
+ *
+ * @param subject
+ */
+export declare function resolvePublishers(subject: string): IPublisher<Event>[];
+/** Clear all registered providers (test isolation). */
+export declare function clearPublisherProviders(): void;
+//# sourceMappingURL=publisher-registry.d.ts.map

package/build/events/publisher-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publisher-registry.d.ts","sourceRoot":"","sources":["../../src/events/publisher-registry.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAI7D;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAG3E;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,EAAE,CAStE;AAED,uDAAuD;AACvD,wBAAgB,uBAAuB,IAAI,IAAI,CAG9C"}

package/build/events/publisher-registry.js

@@ -0,0 +1,46 @@
+"use strict";
+/* ────────────────────────────────────────────────────────────────────────────
+ * PUBLISHER REGISTRY — subject → publisher resolution for the relay (Step 3.5)
+ *
+ * The relay reads a `sent:false` outbox row and must re-publish it, but the
+ * concrete publisher lives PER-CONTROLLER (create/update/removePublisher on each
+ * BaseEventCtrl). A controller registers ITSELF as a provider in its constructor;
+ * the relay later asks `resolvePublishers(subject)`, which reads each provider's
+ * `eventPublishers()` LAZILY — so it runs at relay-time (fields initialised), not
+ * at construction-time (subclass field initialisers run AFTER super()).
+ * ──────────────────────────────────────────────────────────────────────────── */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerPublisherProvider = registerPublisherProvider;
+exports.resolvePublishers = resolvePublishers;
+exports.clearPublisherProviders = clearPublisherProviders;
+const _providers = new Set();
+/**
+ * Register a controller as a publisher provider. Idempotent (Set-backed): a
+ * singleton controller constructed once registers once. Called from the
+ * BaseEventCtrl constructor with `this`.
+ *
+ * @param provider
+ */
+function registerPublisherProvider(provider) {
+    _providers.add(provider);
+}
+/**
+ * All registered publishers whose `subject` matches, gathered across every
+ * provider. Read lazily at call time, so a provider registered in a constructor
+ * (before its publisher fields are initialised) still resolves correctly later.
+ *
+ * @param subject
+ */
+function resolvePublishers(subject) {
+    const out = [];
+    for (const provider of _providers)
+        for (const pub of provider.eventPublishers())
+            if (pub.subject === subject)
+                out.push(pub);
+    return out;
+}
+/** Clear all registered providers (test isolation). */
+function clearPublisherProviders() {
+    _providers.clear();
+}
+//# sourceMappingURL=publisher-registry.js.map

package/build/events/publisher-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publisher-registry.js","sourceRoot":"","sources":["../../src/events/publisher-registry.ts"],"names":[],"mappings":";AAAA;;;;;;;;;kFASkF;;AAclF,8DAGC;AASD,8CASC;AAGD,0DAGC;AApCD,MAAM,UAAU,GAAG,IAAI,GAAG,EAAqB,CAAC;AAEhD;;;;;;GAMG;AACH,SAAgB,yBAAyB,CAAC,QAA2B;IAEnE,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AAC3B,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,iBAAiB,CAAC,OAAe;IAE/C,MAAM,GAAG,GAAwB,EAAE,CAAC;IAEpC,KAAK,MAAM,QAAQ,IAAI,UAAU;QAC/B,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,eAAe,EAAE;YAC1C,IAAI,GAAG,CAAC,OAAO,KAAK,OAAO;gBAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAE/C,OAAO,GAAG,CAAC;AACb,CAAC;AAED,uDAAuD;AACvD,SAAgB,uBAAuB;IAErC,UAAU,CAAC,KAAK,EAAE,CAAC;AACrB,CAAC"}

package/build/events/types/index.d.ts

@@ -15,12 +15,14 @@ export * from './vulnerability.enums';
 export * from './asset.constants';
 export * from './dlq.constants';
 export * from './event-envelope.constants';
+export * from './relay.constants';
 export * from './asset.interfaces';
 export * from './control.interfaces';
 export * from './dlq.interfaces';
 export * from './event-envelope.interfaces';
 export * from './events.interfaces';
 export * from './outbox.interfaces';
+export * from './relay.interfaces';
 export * from './risk-analysis.interfaces';
 export * from './threat.interfaces';
 export * from './vulnerability.interfaces';

package/build/events/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/events/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AAExB,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AAEtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,4BAA4B,CAAC;AAE3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAG3C,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/events/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AAExB,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AAEtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAElC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAG3C,cAAc,kBAAkB,CAAC"}

package/build/events/types/index.js

@@ -31,12 +31,14 @@ __exportStar(require("./vulnerability.enums"), exports);
 __exportStar(require("./asset.constants"), exports);
 __exportStar(require("./dlq.constants"), exports);
 __exportStar(require("./event-envelope.constants"), exports);
+__exportStar(require("./relay.constants"), exports);
 __exportStar(require("./asset.interfaces"), exports);
 __exportStar(require("./control.interfaces"), exports);
 __exportStar(require("./dlq.interfaces"), exports);
 __exportStar(require("./event-envelope.interfaces"), exports);
 __exportStar(require("./events.interfaces"), exports);
 __exportStar(require("./outbox.interfaces"), exports);
+__exportStar(require("./relay.interfaces"), exports);
 __exportStar(require("./risk-analysis.interfaces"), exports);
 __exportStar(require("./threat.interfaces"), exports);
 __exportStar(require("./vulnerability.interfaces"), exports);

package/build/events/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/events/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AAExB,wDAAsC;AACtC,gDAA8B;AAC9B,sDAAoC;AACpC,wDAAsC;AACtC,uDAAqC;AACrC,kDAAgC;AAChC,4DAA0C;AAC1C,iDAA+B;AAC/B,uDAAqC;AACrC,wDAAsC;AACtC,iDAA+B;AAC/B,oDAAkC;AAClC,wDAAsC;AAEtC,oDAAkC;AAClC,kDAAgC;AAChC,6DAA2C;AAE3C,qDAAmC;AACnC,uDAAqC;AACrC,mDAAiC;AACjC,8DAA4C;AAC5C,sDAAoC;AACpC,sDAAoC;AACpC,6DAA2C;AAC3C,sDAAoC;AACpC,6DAA2C;AAE3C,YAAY;AACZ,mDAAiC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/events/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AAExB,wDAAsC;AACtC,gDAA8B;AAC9B,sDAAoC;AACpC,wDAAsC;AACtC,uDAAqC;AACrC,kDAAgC;AAChC,4DAA0C;AAC1C,iDAA+B;AAC/B,uDAAqC;AACrC,wDAAsC;AACtC,iDAA+B;AAC/B,oDAAkC;AAClC,wDAAsC;AAEtC,oDAAkC;AAClC,kDAAgC;AAChC,6DAA2C;AAC3C,oDAAkC;AAElC,qDAAmC;AACnC,uDAAqC;AACrC,mDAAiC;AACjC,8DAA4C;AAC5C,sDAAoC;AACpC,sDAAoC;AACpC,qDAAmC;AACnC,6DAA2C;AAC3C,sDAAoC;AACpC,6DAA2C;AAE3C,YAAY;AACZ,mDAAiC"}

package/build/events/types/outbox.interfaces.d.ts

@@ -1,12 +1,22 @@
 import { NxContext } from '@nextage/nx-frame-be';
 import { QueueEventType } from './enums';
+import { EventMeta } from './event-envelope.interfaces';
 export interface OutboxEvent {
     id: string;
     type: QueueEventType;
+    subject: string;
     data: any;
+    meta?: EventMeta;
+}
+export interface OutboxMessage {
+    type: QueueEventType;
+    subject: string;
+    data: any;
+    meta: EventMeta;
 }
 export interface OutboxPort {
     create(evt: OutboxEvent, context: NxContext): Promise<void>;
     markSent(id: string, context: NxContext): Promise<void>;
+    findUnsent(limit: number): Promise<OutboxEvent[]>;
 }
 //# sourceMappingURL=outbox.interfaces.d.ts.map

package/build/events/types/outbox.interfaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"outbox.interfaces.d.ts","sourceRoot":"","sources":["../../../src/events/types/outbox.interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAW,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAKzC,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAI,MAAM,CAAC;IACb,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,EAAE,GAAG,CAAC;CACX;AASD,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,GAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,GAAQ,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9D"}
+{"version":3,"file":"outbox.interfaces.d.ts","sourceRoot":"","sources":["../../../src/events/types/outbox.interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAW,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAW,6BAA6B,CAAC;AAS7D,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAO,MAAM,CAAC;IAChB,IAAI,EAAK,cAAc,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAK,GAAG,CAAC;IACb,IAAI,CAAC,EAAI,SAAS,CAAC;CACpB;AAQD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAK,cAAc,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAK,GAAG,CAAC;IACb,IAAI,EAAK,SAAS,CAAC;CACpB;AAUD,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,GAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,GAAQ,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,UAAU,CAAC,KAAK,EAAE,MAAM,GAAuB,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;CACvE"}

package/build/events/types/relay.constants.d.ts

@@ -0,0 +1,3 @@
+export declare const DEFAULT_RELAY_BATCH_SIZE = 100;
+export declare const DEFAULT_RELAY_INTERVAL_MS = 30000;
+//# sourceMappingURL=relay.constants.d.ts.map

package/build/events/types/relay.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay.constants.d.ts","sourceRoot":"","sources":["../../../src/events/types/relay.constants.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,wBAAwB,MAAO,CAAC;AAC7C,eAAO,MAAM,yBAAyB,QAAS,CAAC"}

package/build/events/types/relay.constants.js

@@ -0,0 +1,9 @@
+"use strict";
+// Relay (Step 3.5) tuning defaults. The relay redelivers `sent:false` outbox rows
+// at startup (recover from a previous crash) and periodically (recover from a
+// transient broker/network outage while the process stays up).
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_RELAY_INTERVAL_MS = exports.DEFAULT_RELAY_BATCH_SIZE = void 0;
+exports.DEFAULT_RELAY_BATCH_SIZE = 100; // rows drained per tick
+exports.DEFAULT_RELAY_INTERVAL_MS = 30000; // 30s periodic sweep
+//# sourceMappingURL=relay.constants.js.map

package/build/events/types/relay.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay.constants.js","sourceRoot":"","sources":["../../../src/events/types/relay.constants.ts"],"names":[],"mappings":";AAAA,kFAAkF;AAClF,8EAA8E;AAC9E,+DAA+D;;;AAElD,QAAA,wBAAwB,GAAI,GAAG,CAAC,CAAI,wBAAwB;AAC5D,QAAA,yBAAyB,GAAG,KAAM,CAAC,CAAC,qBAAqB"}

package/build/events/types/relay.interfaces.d.ts

@@ -0,0 +1,11 @@
+import { Event, IPublisher } from '../interfaces';
+export interface EventRelayOptions {
+    batchSize?: number;
+    intervalMs?: number;
+    onError?: (err: unknown) => void;
+    onSkip?: (subject: string, id: string) => void;
+}
+export interface PublisherProvider {
+    eventPublishers(): IPublisher<Event>[];
+}
+//# sourceMappingURL=relay.interfaces.d.ts.map

package/build/events/types/relay.interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay.interfaces.d.ts","sourceRoot":"","sources":["../../../src/events/types/relay.interfaces.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAIlD,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAG,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAK,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IACpC,MAAM,CAAC,EAAM,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CACpD;AAKD,MAAM,WAAW,iBAAiB;IAChC,eAAe,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;CACxC"}

package/build/events/types/relay.interfaces.js

@@ -0,0 +1,5 @@
+"use strict";
+// Relay (Step 3.5) contracts. Kept separate from the relay/registry logic that
+// consumes them (house rule: types live in `<concern>.interfaces.ts`).
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=relay.interfaces.js.map

package/build/events/types/relay.interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay.interfaces.js","sourceRoot":"","sources":["../../../src/events/types/relay.interfaces.ts"],"names":[],"mappings":";AAAA,+EAA+E;AAC/E,uEAAuE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextage/era-lib",
-  "version": "1.0.176",
+  "version": "1.0.178",
   "main": "./build/index.js",
   "types": "./build/index.d.ts",
   "files": [