actor-ts 0.9.0

package/dist/crdt/PNCounter.js

@@ -0,0 +1,51 @@
+import { GCounter } from './GCounter.js';
+/**
+ * Positive/Negative counter — supports both increments and decrements
+ * by tracking two grow-only counters: `p` (sum of increments) and
+ * `n` (sum of decrements).  Final value = `p.value() - n.value()`.
+ *
+ * Use this when the count can go up AND down — items in a cart,
+ * connected sessions, available inventory.  For pure-increment
+ * workloads use the lighter {@link GCounter}.
+ *
+ *   const a = PNCounter.empty().increment('node-a', 5);
+ *   const b = PNCounter.empty().decrement('node-b', 2);
+ *   a.merge(b).value()                          // → 3
+ */
+export class PNCounter {
+    p;
+    n;
+    constructor(p, n) {
+        this.p = p;
+        this.n = n;
+    }
+    static empty() {
+        return new PNCounter(GCounter.empty(), GCounter.empty());
+    }
+    increment(replica, delta = 1) {
+        if (delta < 0)
+            throw new Error(`PNCounter.increment requires delta >= 0, got ${delta}`);
+        return new PNCounter(this.p.increment(replica, delta), this.n);
+    }
+    decrement(replica, delta = 1) {
+        if (delta < 0)
+            throw new Error(`PNCounter.decrement requires delta >= 0, got ${delta}`);
+        return new PNCounter(this.p, this.n.increment(replica, delta));
+    }
+    value() { return this.p.value() - this.n.value(); }
+    merge(other) {
+        return new PNCounter(this.p.merge(other.p), this.n.merge(other.n));
+    }
+    toJSON() {
+        return { kind: 'PNCounter', p: this.p.toJSON(), n: this.n.toJSON() };
+    }
+    static fromJSON(json) {
+        if (json.kind !== 'PNCounter')
+            throw new Error(`PNCounter.fromJSON: unexpected kind ${json.kind}`);
+        return new PNCounter(GCounter.fromJSON(json.p), GCounter.fromJSON(json.n));
+    }
+    equals(other) {
+        return this.p.equals(other.p) && this.n.equals(other.n);
+    }
+}
+//# sourceMappingURL=PNCounter.js.map

package/dist/crdt/PNCounter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PNCounter.js","sourceRoot":"","sources":["../../src/crdt/PNCounter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAqB,MAAM,eAAe,CAAC;AAE5D;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,SAAS;IAED;IACA;IAFnB,YACmB,CAAW,EACX,CAAW;QADX,MAAC,GAAD,CAAC,CAAU;QACX,MAAC,GAAD,CAAC,CAAU;IAC3B,CAAC;IAEJ,MAAM,CAAC,KAAK;QACV,OAAO,IAAI,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,SAAS,CAAC,OAAkB,EAAE,QAAgB,CAAC;QAC7C,IAAI,KAAK,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,KAAK,EAAE,CAAC,CAAC;QACxF,OAAO,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACjE,CAAC;IAED,SAAS,CAAC,OAAkB,EAAE,QAAgB,CAAC;QAC7C,IAAI,KAAK,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,KAAK,EAAE,CAAC,CAAC;QACxF,OAAO,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;IACjE,CAAC;IAED,KAAK,KAAa,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAE3D,KAAK,CAAC,KAAgB;QACpB,OAAO,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACrE,CAAC;IAED,MAAM;QACJ,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;IACvE,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,IAAmB;QACjC,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW;YAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACnG,OAAO,IAAI,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,CAAC,KAAgB;QACrB,OAAO,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1D,CAAC;CACF"}

package/dist/crdt/index.d.ts

@@ -0,0 +1,23 @@
+export type { Crdt, ReplicaId } from './Crdt.js';
+export { GCounter } from './GCounter.js';
+export type { GCounterJson } from './GCounter.js';
+export { PNCounter } from './PNCounter.js';
+export type { PNCounterJson } from './PNCounter.js';
+export { GSet } from './GSet.js';
+export type { GSetJson } from './GSet.js';
+export { ORSet } from './ORSet.js';
+export type { ORSetJson } from './ORSet.js';
+export { LWWRegister } from './LWWRegister.js';
+export type { LWWRegisterJson } from './LWWRegister.js';
+export { GCounterMap } from './GCounterMap.js';
+export type { GCounterMapJson, GCounterMapOptions } from './GCounterMap.js';
+export { LWWMap } from './LWWMap.js';
+export type { LWWMapJson, LWWMapOptions } from './LWWMap.js';
+export { MVRegister } from './MVRegister.js';
+export type { MVRegisterJson } from './MVRegister.js';
+export { ORMap } from './ORMap.js';
+export type { ORMapJson, ORMapOptions } from './ORMap.js';
+export { DistributedData, DistributedDataId, decodeCrdt, } from './DistributedData.js';
+export type { DistributedDataSettings, CrdtFactory, CrdtJson, WriteConsistency, ReadConsistency, } from './DistributedData.js';
+export { DurableDistributedDataStore } from './DurableDistributedDataStore.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/crdt/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/crdt/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,YAAY,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,UAAU,GACX,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,uBAAuB,EACvB,WAAW,EACX,QAAQ,EACR,gBAAgB,EAChB,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/crdt/index.js

@@ -0,0 +1,12 @@
+export { GCounter } from './GCounter.js';
+export { PNCounter } from './PNCounter.js';
+export { GSet } from './GSet.js';
+export { ORSet } from './ORSet.js';
+export { LWWRegister } from './LWWRegister.js';
+export { GCounterMap } from './GCounterMap.js';
+export { LWWMap } from './LWWMap.js';
+export { MVRegister } from './MVRegister.js';
+export { ORMap } from './ORMap.js';
+export { DistributedData, DistributedDataId, decodeCrdt, } from './DistributedData.js';
+export { DurableDistributedDataStore } from './DurableDistributedDataStore.js';
+//# sourceMappingURL=index.js.map

package/dist/crdt/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/crdt/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,UAAU,GACX,MAAM,sBAAsB,CAAC;AAQ9B,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/delivery/ConsumerController.d.ts

@@ -0,0 +1,28 @@
+import { Actor } from '../Actor.js';
+import type { Delivery } from './Messages.js';
+export interface ConsumerControllerSettings<T> {
+    /**
+     * Invoked for every successfully delivered (un-duplicated) message.  The
+     * controller Acks AFTER the handler returns — if the handler returns a
+     * Promise, the Ack is delayed until it settles.
+     */
+    readonly handler: (body: T) => void | Promise<void>;
+}
+/**
+ * Consumer side of the reliable-delivery protocol.  Accepts Delivery
+ * envelopes, dedups them per (producerId, seq), invokes the user handler,
+ * and Acks back to the producer.  Handles out-of-order redelivery
+ * correctly by tracking each delivered seq, not just the highest one.
+ */
+export declare class ConsumerController<T> extends Actor<Delivery<T>> {
+    readonly settings: ConsumerControllerSettings<T>;
+    /** producerId → dedup state. */
+    private readonly dedup;
+    constructor(settings: ConsumerControllerSettings<T>);
+    onReceive(msg: Delivery<T>): void;
+    private handleDelivery;
+    private dedupStateFor;
+    private markDelivered;
+    private sendAck;
+}
+//# sourceMappingURL=ConsumerController.d.ts.map

package/dist/delivery/ConsumerController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsumerController.d.ts","sourceRoot":"","sources":["../../src/delivery/ConsumerController.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,OAAO,KAAK,EAAO,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,WAAW,0BAA0B,CAAC,CAAC;IAC3C;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD;AAYD;;;;;GAKG;AACH,qBAAa,kBAAkB,CAAC,CAAC,CAAE,SAAQ,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;aAI/B,QAAQ,EAAE,0BAA0B,CAAC,CAAC,CAAC;IAHnE,gCAAgC;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;gBAE3B,QAAQ,EAAE,0BAA0B,CAAC,CAAC,CAAC;IAE1D,SAAS,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI;YAK5B,cAAc;IAmB5B,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,OAAO;CAIhB"}

package/dist/delivery/ConsumerController.js

@@ -0,0 +1,64 @@
+import { Actor } from '../Actor.js';
+/**
+ * Consumer side of the reliable-delivery protocol.  Accepts Delivery
+ * envelopes, dedups them per (producerId, seq), invokes the user handler,
+ * and Acks back to the producer.  Handles out-of-order redelivery
+ * correctly by tracking each delivered seq, not just the highest one.
+ */
+export class ConsumerController extends Actor {
+    settings;
+    /** producerId → dedup state. */
+    dedup = new Map();
+    constructor(settings) {
+        super();
+        this.settings = settings;
+    }
+    onReceive(msg) {
+        if (msg.kind !== 'reliable-delivery.delivery')
+            return;
+        void this.handleDelivery(msg);
+    }
+    async handleDelivery(msg) {
+        const state = this.dedupStateFor(msg.producerId);
+        if (msg.seq <= state.contiguous || state.above.has(msg.seq)) {
+            // Duplicate — re-ack so the producer can release its slot, but don't
+            // re-run the user handler.
+            this.sendAck(msg);
+            return;
+        }
+        try {
+            await this.settings.handler(msg.body);
+        }
+        catch (err) {
+            this.log.warn(`consumer handler threw on seq=${msg.seq}`, err);
+            // Do NOT ack — let the producer retry.
+            return;
+        }
+        this.markDelivered(state, msg.seq);
+        this.sendAck(msg);
+    }
+    dedupStateFor(producerId) {
+        let s = this.dedup.get(producerId);
+        if (!s) {
+            s = { contiguous: 0, above: new Set() };
+            this.dedup.set(producerId, s);
+        }
+        return s;
+    }
+    markDelivered(state, seq) {
+        if (seq === state.contiguous + 1) {
+            state.contiguous++;
+            // Slide the contiguous window as far up as the above-set lets us.
+            while (state.above.delete(state.contiguous + 1))
+                state.contiguous++;
+        }
+        else {
+            state.above.add(seq);
+        }
+    }
+    sendAck(msg) {
+        const ack = { kind: 'reliable-delivery.ack', producerId: msg.producerId, seq: msg.seq };
+        msg.replyTo.tell(ack);
+    }
+}
+//# sourceMappingURL=ConsumerController.js.map

package/dist/delivery/ConsumerController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsumerController.js","sourceRoot":"","sources":["../../src/delivery/ConsumerController.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAuBpC;;;;;GAKG;AACH,MAAM,OAAO,kBAAsB,SAAQ,KAAkB;IAI/B;IAH5B,gCAAgC;IACf,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;IAEvD,YAA4B,QAAuC;QAAI,KAAK,EAAE,CAAC;QAAnD,aAAQ,GAAR,QAAQ,CAA+B;IAAa,CAAC;IAExE,SAAS,CAAC,GAAgB;QACjC,IAAI,GAAG,CAAC,IAAI,KAAK,4BAA4B;YAAE,OAAO;QACtD,KAAK,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAEO,KAAK,CAAC,cAAc,CAAC,GAAgB;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACjD,IAAI,GAAG,CAAC,GAAG,IAAI,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5D,qEAAqE;YACrE,2BAA2B;YAC3B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAClB,OAAO;QACT,CAAC;QACD,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACxC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,iCAAiC,GAAG,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC;YAC/D,uCAAuC;YACvC,OAAO;QACT,CAAC;QACD,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC;IAEO,aAAa,CAAC,UAAkB;QACtC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACnC,IAAI,CAAC,CAAC,EAAE,CAAC;YAAC,CAAC,GAAG,EAAE,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;YAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;QAAC,CAAC;QACnF,OAAO,CAAC,CAAC;IACX,CAAC;IAEO,aAAa,CAAC,KAAiB,EAAE,GAAW;QAClD,IAAI,GAAG,KAAK,KAAK,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;YACjC,KAAK,CAAC,UAAU,EAAE,CAAC;YACnB,kEAAkE;YAClE,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC;gBAAE,KAAK,CAAC,UAAU,EAAE,CAAC;QACtE,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAEO,OAAO,CAAC,GAAgB;QAC9B,MAAM,GAAG,GAAQ,EAAE,IAAI,EAAE,uBAAuB,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC;QAC5F,GAAG,CAAC,OAAyB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3C,CAAC;CACF"}

package/dist/delivery/Messages.d.ts

@@ -0,0 +1,23 @@
+import type { ActorRef } from '../ActorRef.js';
+/**
+ * Wire-shape sent from Producer to Consumer.  Each envelope carries the
+ * producer id (used by consumers to dedup across producers) and a
+ * monotonically increasing sequence number per producer-consumer pair.
+ */
+export interface Delivery<T> {
+    readonly kind: 'reliable-delivery.delivery';
+    readonly producerId: string;
+    readonly seq: number;
+    readonly body: T;
+    /** Reply address — the consumer Acks back here. */
+    readonly replyTo: ActorRef<Ack>;
+}
+/** Sent from Consumer back to Producer after successful handling. */
+export interface Ack {
+    readonly kind: 'reliable-delivery.ack';
+    readonly producerId: string;
+    readonly seq: number;
+}
+/** Delivery callback handed to the producer — resolves once the consumer Acks. */
+export type ConfirmationCallback = (err: Error | null) => void;
+//# sourceMappingURL=Messages.d.ts.map

package/dist/delivery/Messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Messages.d.ts","sourceRoot":"","sources":["../../src/delivery/Messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;;;GAIG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAC;IAC5C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,mDAAmD;IACnD,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC;CACjC;AAED,qEAAqE;AACrE,MAAM,WAAW,GAAG;IAClB,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,kFAAkF;AAClF,MAAM,MAAM,oBAAoB,GAAG,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,KAAK,IAAI,CAAC"}

package/dist/delivery/Messages.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Messages.js.map

package/dist/delivery/Messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Messages.js","sourceRoot":"","sources":["../../src/delivery/Messages.ts"],"names":[],"mappings":""}

package/dist/delivery/ProducerController.d.ts

@@ -0,0 +1,46 @@
+import { Actor } from '../Actor.js';
+import type { ActorRef } from '../ActorRef.js';
+import type { Ack, ConfirmationCallback, Delivery } from './Messages.js';
+/** Message sent to the ProducerController by the publishing user code. */
+export interface ProducerSend<T> {
+    readonly kind: 'reliable-delivery.send';
+    readonly body: T;
+    readonly confirm?: ConfirmationCallback;
+}
+export interface ProducerControllerSettings<T> {
+    readonly consumer: ActorRef<Delivery<T>>;
+    /**
+     * How long to wait for an Ack before re-sending.  Default 500ms.
+     */
+    readonly resendTimeoutMs?: number;
+    /**
+     * Flow-control window: at most `windowSize` messages may be in-flight
+     * (un-acked) at any moment.  Additional Sends queue until room opens up.
+     * Default: 16.
+     */
+    readonly windowSize?: number;
+    /** Stable identifier used by consumers to dedup across restarts. */
+    readonly producerId?: string;
+}
+/**
+ * Producer side of the reliable-delivery protocol.  Messages sent to this
+ * actor are assigned sequence numbers and shipped to the consumer; the
+ * actor keeps retrying until it gets an Ack back.
+ */
+export declare class ProducerController<T> extends Actor<ProducerSend<T> | Ack> {
+    readonly settings: ProducerControllerSettings<T>;
+    private readonly inflight;
+    private readonly pending;
+    private nextSeq;
+    private readonly id;
+    private readonly resendTimeoutMs;
+    private readonly windowSize;
+    constructor(settings: ProducerControllerSettings<T>);
+    postStop(): void;
+    onReceive(msg: ProducerSend<T> | Ack): void;
+    private handleSend;
+    private dispatch;
+    private send;
+    private handleAck;
+}
+//# sourceMappingURL=ProducerController.d.ts.map

package/dist/delivery/ProducerController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProducerController.d.ts","sourceRoot":"","sources":["../../src/delivery/ProducerController.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,KAAK,EAAE,GAAG,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAKzE,0EAA0E;AAC1E,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,QAAQ,CAAC,OAAO,CAAC,EAAE,oBAAoB,CAAC;CACzC;AAED,MAAM,WAAW,0BAA0B,CAAC,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACzC;;OAEG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAUD;;;;GAIG;AACH,qBAAa,kBAAkB,CAAC,CAAC,CAAE,SAAQ,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;aAQzC,QAAQ,EAAE,0BAA0B,CAAC,CAAC,CAAC;IAPnE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAC3D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAER,QAAQ,EAAE,0BAA0B,CAAC,CAAC,CAAC;IAO1D,QAAQ,IAAI,IAAI;IAOhB,SAAS,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,IAAI;IAKpD,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,IAAI;IAqBZ,OAAO,CAAC,SAAS;CAYlB"}

package/dist/delivery/ProducerController.js

@@ -0,0 +1,84 @@
+import { Actor } from '../Actor.js';
+let producerSeed = 0;
+const nextProducerId = () => `producer-${++producerSeed}`;
+/**
+ * Producer side of the reliable-delivery protocol.  Messages sent to this
+ * actor are assigned sequence numbers and shipped to the consumer; the
+ * actor keeps retrying until it gets an Ack back.
+ */
+export class ProducerController extends Actor {
+    settings;
+    inflight = new Map();
+    pending = [];
+    nextSeq = 1;
+    id;
+    resendTimeoutMs;
+    windowSize;
+    constructor(settings) {
+        super();
+        this.settings = settings;
+        this.id = settings.producerId ?? nextProducerId();
+        this.resendTimeoutMs = settings.resendTimeoutMs ?? 500;
+        this.windowSize = settings.windowSize ?? 16;
+    }
+    postStop() {
+        for (const f of this.inflight.values())
+            f.timer?.cancel();
+        for (const p of this.pending)
+            p.confirm?.(new Error('producer stopped'));
+        this.pending.length = 0;
+        this.inflight.clear();
+    }
+    onReceive(msg) {
+        if (msg.kind === 'reliable-delivery.ack')
+            return this.handleAck(msg);
+        if (msg.kind === 'reliable-delivery.send')
+            return this.handleSend(msg);
+    }
+    handleSend(msg) {
+        if (this.inflight.size >= this.windowSize) {
+            this.pending.push(msg);
+            return;
+        }
+        this.dispatch(msg);
+    }
+    dispatch(msg) {
+        const seq = this.nextSeq++;
+        const f = { seq, body: msg.body, confirm: msg.confirm, attempts: 0, timer: null };
+        this.inflight.set(seq, f);
+        this.send(f);
+    }
+    send(f) {
+        f.attempts++;
+        const delivery = {
+            kind: 'reliable-delivery.delivery',
+            producerId: this.id,
+            seq: f.seq,
+            body: f.body,
+            replyTo: this.self,
+        };
+        this.settings.consumer.tell(delivery);
+        f.timer = this.system.scheduler.scheduleOnceFn(this.resendTimeoutMs, () => {
+            // Only resend if still un-acked.
+            const current = this.inflight.get(f.seq);
+            if (!current)
+                return;
+            this.send(current);
+        });
+    }
+    handleAck(msg) {
+        if (msg.producerId !== this.id)
+            return;
+        const f = this.inflight.get(msg.seq);
+        if (!f)
+            return;
+        f.timer?.cancel();
+        this.inflight.delete(msg.seq);
+        f.confirm?.(null);
+        // Drain queued sends while the window is open.
+        while (this.inflight.size < this.windowSize && this.pending.length > 0) {
+            this.dispatch(this.pending.shift());
+        }
+    }
+}
+//# sourceMappingURL=ProducerController.js.map

package/dist/delivery/ProducerController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProducerController.js","sourceRoot":"","sources":["../../src/delivery/ProducerController.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAKpC,IAAI,YAAY,GAAG,CAAC,CAAC;AACrB,MAAM,cAAc,GAAG,GAAW,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,CAAC;AAiClE;;;;GAIG;AACH,MAAM,OAAO,kBAAsB,SAAQ,KAA4B;IAQzC;IAPX,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC1C,OAAO,GAAsB,EAAE,CAAC;IACzC,OAAO,GAAG,CAAC,CAAC;IACH,EAAE,CAAS;IACX,eAAe,CAAS;IACxB,UAAU,CAAS;IAEpC,YAA4B,QAAuC;QACjE,KAAK,EAAE,CAAC;QADkB,aAAQ,GAAR,QAAQ,CAA+B;QAEjE,IAAI,CAAC,EAAE,GAAG,QAAQ,CAAC,UAAU,IAAI,cAAc,EAAE,CAAC;QAClD,IAAI,CAAC,eAAe,GAAG,QAAQ,CAAC,eAAe,IAAI,GAAG,CAAC;QACvD,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC,UAAU,IAAI,EAAE,CAAC;IAC9C,CAAC;IAEQ,QAAQ;QACf,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE;YAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;QAC1D,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO;YAAE,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC;QACzE,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;QACxB,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAEQ,SAAS,CAAC,GAA0B;QAC3C,IAAK,GAAW,CAAC,IAAI,KAAK,uBAAuB;YAAE,OAAO,IAAI,CAAC,SAAS,CAAC,GAAU,CAAC,CAAC;QACrF,IAAK,GAAuB,CAAC,IAAI,KAAK,wBAAwB;YAAE,OAAO,IAAI,CAAC,UAAU,CAAC,GAAsB,CAAC,CAAC;IACjH,CAAC;IAEO,UAAU,CAAC,GAAoB;QACrC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAC1C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACvB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IAEO,QAAQ,CAAC,GAAoB;QACnC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAgB,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAC/F,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACf,CAAC;IAEO,IAAI,CAAC,CAAc;QACzB,CAAC,CAAC,QAAQ,EAAE,CAAC;QACb,MAAM,QAAQ,GAAgB;YAC5B,IAAI,EAAE,4BAA4B;YAClC,UAAU,EAAE,IAAI,CAAC,EAAE;YACnB,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,OAAO,EAAE,IAAI,CAAC,IAAgC;SAC/C,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAC5C,IAAI,CAAC,eAAe,EACpB,GAAG,EAAE;YACH,iCAAiC;YACjC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACzC,IAAI,CAAC,OAAO;gBAAE,OAAO;YACrB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrB,CAAC,CACF,CAAC;IACJ,CAAC;IAEO,SAAS,CAAC,GAAQ;QACxB,IAAI,GAAG,CAAC,UAAU,KAAK,IAAI,CAAC,EAAE;YAAE,OAAO;QACvC,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC,CAAC;YAAE,OAAO;QACf,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;QAClB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9B,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;QAClB,+CAA+C;QAC/C,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAG,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;CACF"}

package/dist/delivery/ReliableDelivery.d.ts

@@ -0,0 +1,36 @@
+import type { ActorRef } from '../ActorRef.js';
+import type { ActorSystem } from '../ActorSystem.js';
+import { type ConsumerControllerSettings } from './ConsumerController.js';
+import type { ConfirmationCallback, Delivery } from './Messages.js';
+import { type ProducerControllerSettings, type ProducerSend } from './ProducerController.js';
+/**
+ * Handle returned to the publishing user code.  `tell` enqueues a message
+ * for reliable delivery; an optional `confirm` callback fires once the
+ * consumer has Acked (or on producer shutdown with an Error).
+ */
+export interface ProducerHandle<T> {
+    tell(body: T, confirm?: ConfirmationCallback): void;
+    /** Underlying actor ref — mostly for testing / inspection. */
+    readonly ref: ActorRef<ProducerSend<T>>;
+    stop(): void;
+}
+export interface ConsumerHandle {
+    readonly ref: ActorRef<Delivery<unknown>>;
+    stop(): void;
+}
+/**
+ * Point-to-point at-least-once delivery between a Producer and a Consumer.
+ * Messages are assigned monotonic sequence numbers; the consumer Acks back
+ * after handling, the producer retries on timeout, and duplicates are
+ * silently absorbed on the consumer side.
+ *
+ * For work-pulling (multiple consumers, one producer) see the WorkPulling
+ * companion (follow-up feature).
+ */
+export declare class ReliableDelivery {
+    /** Spawn a ConsumerController — pass the returned ref to a ProducerController. */
+    static consumer<T>(system: ActorSystem, settings: ConsumerControllerSettings<T>, name?: string): ConsumerHandle;
+    /** Spawn a ProducerController aimed at `settings.consumer`. */
+    static producer<T>(system: ActorSystem, settings: ProducerControllerSettings<T>, name?: string): ProducerHandle<T>;
+}
+//# sourceMappingURL=ReliableDelivery.d.ts.map

package/dist/delivery/ReliableDelivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReliableDelivery.d.ts","sourceRoot":"","sources":["../../src/delivery/ReliableDelivery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EAEL,KAAK,0BAA0B,EAC/B,KAAK,YAAY,EAClB,MAAM,yBAAyB,CAAC;AAEjC;;;;GAIG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACpD,8DAA8D;IAC9D,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,IAAI,IAAI,IAAI,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1C,IAAI,IAAI,IAAI,CAAC;CACd;AAED;;;;;;;;GAQG;AACH,qBAAa,gBAAgB;IAC3B,kFAAkF;IAClF,MAAM,CAAC,QAAQ,CAAC,CAAC,EACf,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,0BAA0B,CAAC,CAAC,CAAC,EACvC,IAAI,CAAC,EAAE,MAAM,GACZ,cAAc;IAQjB,+DAA+D;IAC/D,MAAM,CAAC,QAAQ,CAAC,CAAC,EACf,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,0BAA0B,CAAC,CAAC,CAAC,EACvC,IAAI,CAAC,EAAE,MAAM,GACZ,cAAc,CAAC,CAAC,CAAC;CAarB"}

package/dist/delivery/ReliableDelivery.js

@@ -0,0 +1,32 @@
+import { Props } from '../Props.js';
+import { ConsumerController, } from './ConsumerController.js';
+import { ProducerController, } from './ProducerController.js';
+/**
+ * Point-to-point at-least-once delivery between a Producer and a Consumer.
+ * Messages are assigned monotonic sequence numbers; the consumer Acks back
+ * after handling, the producer retries on timeout, and duplicates are
+ * silently absorbed on the consumer side.
+ *
+ * For work-pulling (multiple consumers, one producer) see the WorkPulling
+ * companion (follow-up feature).
+ */
+export class ReliableDelivery {
+    /** Spawn a ConsumerController — pass the returned ref to a ProducerController. */
+    static consumer(system, settings, name) {
+        const ref = system.spawn(Props.create(() => new ConsumerController(settings)), name ?? `reliable-consumer-${++counter}`);
+        return { ref, stop() { ref.stop(); } };
+    }
+    /** Spawn a ProducerController aimed at `settings.consumer`. */
+    static producer(system, settings, name) {
+        const ref = system.spawn(Props.create(() => new ProducerController(settings)), name ?? `reliable-producer-${++counter}`);
+        return {
+            ref,
+            tell(body, confirm) {
+                ref.tell({ kind: 'reliable-delivery.send', body, confirm });
+            },
+            stop() { ref.stop(); },
+        };
+    }
+}
+let counter = 0;
+//# sourceMappingURL=ReliableDelivery.js.map

package/dist/delivery/ReliableDelivery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReliableDelivery.js","sourceRoot":"","sources":["../../src/delivery/ReliableDelivery.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EACL,kBAAkB,GAEnB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,kBAAkB,GAGnB,MAAM,yBAAyB,CAAC;AAmBjC;;;;;;;;GAQG;AACH,MAAM,OAAO,gBAAgB;IAC3B,kFAAkF;IAClF,MAAM,CAAC,QAAQ,CACb,MAAmB,EACnB,QAAuC,EACvC,IAAa;QAEb,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CACtB,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,kBAAkB,CAAI,QAAQ,CAA8D,CAAC,EACpH,IAAI,IAAI,qBAAqB,EAAE,OAAO,EAAE,CACzC,CAAC;QACF,OAAO,EAAE,GAAG,EAAE,IAAI,KAAW,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/C,CAAC;IAED,+DAA+D;IAC/D,MAAM,CAAC,QAAQ,CACb,MAAmB,EACnB,QAAuC,EACvC,IAAa;QAEb,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CACtB,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,kBAAkB,CAAI,QAAQ,CAA4D,CAAC,EAClH,IAAI,IAAI,qBAAqB,EAAE,OAAO,EAAE,CACzC,CAAC;QACF,OAAO;YACL,GAAG;YACH,IAAI,CAAC,IAAO,EAAE,OAA8B;gBAC1C,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,wBAAwB,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;YAC9D,CAAC;YACD,IAAI,KAAW,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;SAC7B,CAAC;IACJ,CAAC;CACF;AAED,IAAI,OAAO,GAAG,CAAC,CAAC"}

package/dist/delivery/index.d.ts

@@ -0,0 +1,8 @@
+export { ProducerController } from './ProducerController.js';
+export type { ProducerControllerSettings, ProducerSend, } from './ProducerController.js';
+export { ConsumerController } from './ConsumerController.js';
+export type { ConsumerControllerSettings } from './ConsumerController.js';
+export { ReliableDelivery } from './ReliableDelivery.js';
+export type { ProducerHandle, ConsumerHandle } from './ReliableDelivery.js';
+export type { Delivery, Ack, ConfirmationCallback } from './Messages.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/delivery/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/delivery/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EACV,0BAA0B,EAC1B,YAAY,GACb,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5E,YAAY,EAAE,QAAQ,EAAE,GAAG,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC"}

package/dist/delivery/index.js

@@ -0,0 +1,4 @@
+export { ProducerController } from './ProducerController.js';
+export { ConsumerController } from './ConsumerController.js';
+export { ReliableDelivery } from './ReliableDelivery.js';
+//# sourceMappingURL=index.js.map

package/dist/delivery/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/delivery/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAK7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/discovery/AggregateSeedProvider.d.ts

@@ -0,0 +1,15 @@
+import { NodeAddress } from '../cluster/NodeAddress.js';
+import type { SeedProvider } from './SeedProvider.js';
+/**
+ * Chain multiple providers — first provider that returns a non-empty list
+ * wins.  If all providers fail or return empty, the aggregate returns an
+ * empty array (the caller can choose to retry).  Individual provider
+ * failures are logged but don't abort the chain.
+ */
+export declare class AggregateSeedProvider implements SeedProvider {
+    private readonly providers;
+    private readonly log;
+    constructor(providers: ReadonlyArray<SeedProvider>, log?: (msg: string, err?: unknown) => void);
+    lookup(): Promise<NodeAddress[]>;
+}
+//# sourceMappingURL=AggregateSeedProvider.d.ts.map

package/dist/discovery/AggregateSeedProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AggregateSeedProvider.d.ts","sourceRoot":"","sources":["../../src/discovery/AggregateSeedProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;;;GAKG;AACH,qBAAa,qBAAsB,YAAW,YAAY;IAEtD,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,GAAG;gBADH,SAAS,EAAE,aAAa,CAAC,YAAY,CAAC,EACtC,GAAG,GAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,KAAK,IAAe;IAGjE,MAAM,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;CAWvC"}

package/dist/discovery/AggregateSeedProvider.js

@@ -0,0 +1,28 @@
+/**
+ * Chain multiple providers — first provider that returns a non-empty list
+ * wins.  If all providers fail or return empty, the aggregate returns an
+ * empty array (the caller can choose to retry).  Individual provider
+ * failures are logged but don't abort the chain.
+ */
+export class AggregateSeedProvider {
+    providers;
+    log;
+    constructor(providers, log = () => { }) {
+        this.providers = providers;
+        this.log = log;
+    }
+    async lookup() {
+        for (const provider of this.providers) {
+            try {
+                const seeds = await provider.lookup();
+                if (seeds.length > 0)
+                    return seeds;
+            }
+            catch (err) {
+                this.log(`seed provider threw — falling through to next`, err);
+            }
+        }
+        return [];
+    }
+}
+//# sourceMappingURL=AggregateSeedProvider.js.map

package/dist/discovery/AggregateSeedProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AggregateSeedProvider.js","sourceRoot":"","sources":["../../src/discovery/AggregateSeedProvider.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,OAAO,qBAAqB;IAEb;IACA;IAFnB,YACmB,SAAsC,EACtC,MAA4C,GAAG,EAAE,GAAE,CAAC;QADpD,cAAS,GAAT,SAAS,CAA6B;QACtC,QAAG,GAAH,GAAG,CAAiD;IACpE,CAAC;IAEJ,KAAK,CAAC,MAAM;QACV,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE,CAAC;gBACtC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;oBAAE,OAAO,KAAK,CAAC;YACrC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,GAAG,CAAC,+CAA+C,EAAE,GAAG,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;CACF"}

package/dist/discovery/ConfigSeedProvider.d.ts

@@ -0,0 +1,20 @@
+import { NodeAddress } from '../cluster/NodeAddress.js';
+import type { SeedProvider } from './SeedProvider.js';
+export interface ConfigSeedProviderSettings {
+    /** Static list of "system@host:port" or "host:port" strings. */
+    readonly seeds: string[];
+    /** Default system name used when a seed string omits it. */
+    readonly systemName: string;
+}
+/**
+ * Simplest `SeedProvider`: returns a fixed list of addresses passed at
+ * construction time (typically sourced from config or ENV).
+ */
+export declare class ConfigSeedProvider implements SeedProvider {
+    private readonly settings;
+    constructor(settings: ConfigSeedProviderSettings);
+    lookup(): Promise<NodeAddress[]>;
+}
+/** Read seeds from an environment variable (comma-separated). */
+export declare function seedsFromEnv(varName: string, systemName: string): ConfigSeedProvider;
+//# sourceMappingURL=ConfigSeedProvider.d.ts.map

package/dist/discovery/ConfigSeedProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigSeedProvider.d.ts","sourceRoot":"","sources":["../../src/discovery/ConfigSeedProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,WAAW,0BAA0B;IACzC,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IACzB,4DAA4D;IAC5D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,YAAY;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,0BAA0B;IAE3D,MAAM,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;CAMvC;AAED,iEAAiE;AACjE,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,kBAAkB,CAIpF"}

package/dist/discovery/ConfigSeedProvider.js

@@ -0,0 +1,24 @@
+import { NodeAddress } from '../cluster/NodeAddress.js';
+/**
+ * Simplest `SeedProvider`: returns a fixed list of addresses passed at
+ * construction time (typically sourced from config or ENV).
+ */
+export class ConfigSeedProvider {
+    settings;
+    constructor(settings) {
+        this.settings = settings;
+    }
+    async lookup() {
+        return this.settings.seeds.map((raw) => {
+            const text = raw.includes('@') ? raw : `${this.settings.systemName}@${raw}`;
+            return NodeAddress.parse(text);
+        });
+    }
+}
+/** Read seeds from an environment variable (comma-separated). */
+export function seedsFromEnv(varName, systemName) {
+    const raw = process.env[varName] ?? '';
+    const seeds = raw.split(',').map(s => s.trim()).filter(Boolean);
+    return new ConfigSeedProvider({ seeds, systemName });
+}
+//# sourceMappingURL=ConfigSeedProvider.js.map

package/dist/discovery/ConfigSeedProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigSeedProvider.js","sourceRoot":"","sources":["../../src/discovery/ConfigSeedProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAUxD;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IACA;IAA7B,YAA6B,QAAoC;QAApC,aAAQ,GAAR,QAAQ,CAA4B;IAAG,CAAC;IAErE,KAAK,CAAC,MAAM;QACV,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YACrC,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,IAAI,GAAG,EAAE,CAAC;YAC5E,OAAO,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAED,iEAAiE;AACjE,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,UAAkB;IAC9D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACvC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAChE,OAAO,IAAI,kBAAkB,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;AACvD,CAAC"}