actor-ts 0.10.0 → 0.11.0

package/dist/delivery/ConsumerController.d.ts

@@ -1,13 +1,6 @@
 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>;
-}
+import type { ConsumerControllerOptions, ConsumerControllerOptionsType } from './ConsumerControllerOptions.js';
 /**
  * Consumer side of the reliable-delivery protocol.  Accepts Delivery
  * envelopes, dedups them per (producerId, seq), invokes the user handler,
@@ -15,14 +8,14 @@ export interface ConsumerControllerSettings<T> {
  * 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>);
+    readonly options: ConsumerControllerOptionsType<T>;
+    constructor(options: ConsumerControllerOptions<T>);
     onReceive(msg: Delivery<T>): void;
     private handleDelivery;
     private dedupStateFor;
     private markDelivered;
-    private sendAck;
+    private sendAcknowledgment;
 }
 //# sourceMappingURL=ConsumerController.d.ts.map

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

@@ -1 +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"}
+{"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,EAAkB,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,KAAK,EAAE,yBAAyB,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AAY/G;;;;;GAKG;AACH,qBAAa,kBAAkB,CAAC,CAAC,CAAE,SAAQ,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC3D,gCAAgC;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IAEvD,SAAgB,OAAO,EAAE,6BAA6B,CAAC,CAAC,CAAC,CAAC;gBAE9C,OAAO,EAAE,yBAAyB,CAAC,CAAC,CAAC;IAKxC,SAAS,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI;YAK5B,cAAc;IAmB5B,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,kBAAkB;CAI3B"}

package/dist/delivery/ConsumerController.js

@@ -6,12 +6,12 @@ import { Actor } from '../Actor.js';
  * 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) {
+    options;
+    constructor(options) {
         super();
-        this.settings = settings;
+        this.options = options;
     }
     onReceive(msg) {
         if (msg.kind !== 'reliable-delivery.delivery')
@@ -23,11 +23,11 @@ export class ConsumerController extends Actor {
         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);
+            this.sendAcknowledgment(msg);
             return;
         }
         try {
-            await this.settings.handler(msg.body);
+            await this.options.handler(msg.body);
         }
         catch (err) {
             this.log.warn(`consumer handler threw on seq=${msg.seq}`, err);
@@ -35,15 +35,15 @@ export class ConsumerController extends Actor {
             return;
         }
         this.markDelivered(state, msg.seq);
-        this.sendAck(msg);
+        this.sendAcknowledgment(msg);
     }
     dedupStateFor(producerId) {
-        let s = this.dedup.get(producerId);
-        if (!s) {
-            s = { contiguous: 0, above: new Set() };
-            this.dedup.set(producerId, s);
+        let dedupState = this.dedup.get(producerId);
+        if (!dedupState) {
+            dedupState = { contiguous: 0, above: new Set() };
+            this.dedup.set(producerId, dedupState);
         }
-        return s;
+        return dedupState;
     }
     markDelivered(state, seq) {
         if (seq === state.contiguous + 1) {
@@ -56,7 +56,7 @@ export class ConsumerController extends Actor {
             state.above.add(seq);
         }
     }
-    sendAck(msg) {
+    sendAcknowledgment(msg) {
         const ack = { kind: 'reliable-delivery.ack', producerId: msg.producerId, seq: msg.seq };
         msg.replyTo.tell(ack);
     }

package/dist/delivery/ConsumerController.js.map

@@ -1 +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"}
+{"version":3,"file":"ConsumerController.js","sourceRoot":"","sources":["../../src/delivery/ConsumerController.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAepC;;;;;GAKG;AACH,MAAM,OAAO,kBAAsB,SAAQ,KAAkB;IAC3D,gCAAgC;IACf,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;IAEvC,OAAO,CAAmC;IAE1D,YAAY,OAAqC;QAC/C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,OAAO,GAAG,OAA2C,CAAC;IAC7D,CAAC;IAEQ,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,kBAAkB,CAAC,GAAG,CAAC,CAAC;YAC7B,OAAO;QACT,CAAC;QACD,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACvC,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,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAEO,aAAa,CAAC,UAAkB;QACtC,IAAI,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC5C,IAAI,CAAC,UAAU,EAAE,CAAC;YAAC,UAAU,GAAG,EAAE,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;YAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QAAC,CAAC;QAC9G,OAAO,UAAU,CAAC;IACpB,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,kBAAkB,CAAC,GAAgB;QACzC,MAAM,GAAG,GAAmB,EAAE,IAAI,EAAE,uBAAuB,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC;QACvG,GAAG,CAAC,OAAoC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtD,CAAC;CACF"}

package/dist/delivery/ConsumerControllerOptions.d.ts

@@ -0,0 +1,32 @@
+import { OptionsBuilder } from '../util/OptionsBuilder.js';
+/** Plain options-object shape accepted by a {@link ConsumerController}. */
+export interface ConsumerControllerOptionsType<T> {
+    /**
+     * Invoked for every successfully delivered (un-duplicated) message.  The
+     * controller Acks AFTER the handler returns — if the handler returns a
+     * Promise, the Acknowledgment is delayed until it settles.
+     */
+    readonly handler: (body: T) => void | Promise<void>;
+}
+/**
+ * Fluent builder for {@link ConsumerControllerOptionsType}.  The `handler`
+ * is required — pass it via {@link withHandler} before `build()`.
+ *
+ *     ConsumerControllerOptions.create<Cmd>()
+ *       .withHandler(async (body) => { … });
+ */
+export declare class ConsumerControllerOptionsBuilder<T> extends OptionsBuilder<ConsumerControllerOptionsType<T>> {
+    /** Start a fresh builder.  Equivalent to `new ConsumerControllerOptionsBuilder<T>()`. */
+    static create<T>(): ConsumerControllerOptionsBuilder<T>;
+    /** Handler invoked for every delivered (un-duplicated) message.  Required. */
+    withHandler(handler: (body: T) => void | Promise<void>): this;
+}
+/**
+ * Accepted input for a {@link ConsumerController}: the fluent
+ * {@link ConsumerControllerOptionsBuilder} OR a plain
+ * {@link ConsumerControllerOptionsType} object.
+ */
+export type ConsumerControllerOptions<T> = ConsumerControllerOptionsBuilder<T> | Partial<ConsumerControllerOptionsType<T>>;
+/** Value alias so `ConsumerControllerOptions.create()` / `new ConsumerControllerOptions()` resolve to the builder. */
+export declare const ConsumerControllerOptions: typeof ConsumerControllerOptionsBuilder;
+//# sourceMappingURL=ConsumerControllerOptions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ConsumerControllerOptions.d.ts","sourceRoot":"","sources":["../../src/delivery/ConsumerControllerOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,2EAA2E;AAC3E,MAAM,WAAW,6BAA6B,CAAC,CAAC;IAC9C;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD;AAED;;;;;;GAMG;AACH,qBAAa,gCAAgC,CAAC,CAAC,CAAE,SAAQ,cAAc,CAAC,6BAA6B,CAAC,CAAC,CAAC,CAAC;IACvG,yFAAyF;IACzF,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,gCAAgC,CAAC,CAAC,CAAC;IAIvD,8EAA8E;IAC9E,WAAW,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;CAG9D;AAED;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,CAAC,CAAC,IACnC,gCAAgC,CAAC,CAAC,CAAC,GACnC,OAAO,CAAC,6BAA6B,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9C,sHAAsH;AACtH,eAAO,MAAM,yBAAyB,yCAAmC,CAAC"}

package/dist/delivery/ConsumerControllerOptions.js

@@ -0,0 +1,21 @@
+import { OptionsBuilder } from '../util/OptionsBuilder.js';
+/**
+ * Fluent builder for {@link ConsumerControllerOptionsType}.  The `handler`
+ * is required — pass it via {@link withHandler} before `build()`.
+ *
+ *     ConsumerControllerOptions.create<Cmd>()
+ *       .withHandler(async (body) => { … });
+ */
+export class ConsumerControllerOptionsBuilder extends OptionsBuilder {
+    /** Start a fresh builder.  Equivalent to `new ConsumerControllerOptionsBuilder<T>()`. */
+    static create() {
+        return new ConsumerControllerOptionsBuilder();
+    }
+    /** Handler invoked for every delivered (un-duplicated) message.  Required. */
+    withHandler(handler) {
+        return this.set('handler', handler);
+    }
+}
+/** Value alias so `ConsumerControllerOptions.create()` / `new ConsumerControllerOptions()` resolve to the builder. */
+export const ConsumerControllerOptions = ConsumerControllerOptionsBuilder;
+//# sourceMappingURL=ConsumerControllerOptions.js.map

package/dist/delivery/ConsumerControllerOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsumerControllerOptions.js","sourceRoot":"","sources":["../../src/delivery/ConsumerControllerOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAY3D;;;;;;GAMG;AACH,MAAM,OAAO,gCAAoC,SAAQ,cAAgD;IACvG,yFAAyF;IACzF,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,gCAAgC,EAAK,CAAC;IACnD,CAAC;IAED,8EAA8E;IAC9E,WAAW,CAAC,OAA0C;QACpD,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;CACF;AAUD,sHAAsH;AACtH,MAAM,CAAC,MAAM,yBAAyB,GAAG,gCAAgC,CAAC"}

package/dist/delivery/Messages.d.ts

@@ -10,10 +10,10 @@ export interface Delivery<T> {
     readonly seq: number;
     readonly body: T;
     /** Reply address — the consumer Acks back here. */
-    readonly replyTo: ActorRef<Ack>;
+    readonly replyTo: ActorRef<Acknowledgment>;
 }
 /** Sent from Consumer back to Producer after successful handling. */
-export interface Ack {
+export interface Acknowledgment {
     readonly kind: 'reliable-delivery.ack';
     readonly producerId: string;
     readonly seq: number;

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

@@ -1 +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"}
+{"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,cAAc,CAAC,CAAC;CAC5C;AAED,qEAAqE;AACrE,MAAM,WAAW,cAAc;IAC7B,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/ProducerController.d.ts

@@ -1,6 +1,6 @@
 import { Actor } from '../Actor.js';
 import type { ProducerControllerOptions, ProducerControllerOptionsType } from './ProducerControllerOptions.js';
-import type { Ack, ConfirmationCallback } from './Messages.js';
+import type { Acknowledgment, ConfirmationCallback } from './Messages.js';
 /** Message sent to the ProducerController by the publishing user code. */
 export interface ProducerSend<T> {
     readonly kind: 'reliable-delivery.send';
@@ -10,22 +10,22 @@ export interface ProducerSend<T> {
 /**
  * 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.
+ * actor keeps retrying until it gets an Acknowledgment back.
  */
-export declare class ProducerController<T> extends Actor<ProducerSend<T> | Ack> {
+export declare class ProducerController<T> extends Actor<ProducerSend<T> | Acknowledgment> {
     private readonly inflight;
     private readonly pending;
     private nextSeq;
     private readonly id;
     private readonly resendTimeoutMs;
     private readonly windowSize;
-    readonly settings: ProducerControllerOptionsType<T>;
+    readonly options: ProducerControllerOptionsType<T>;
     constructor(options: ProducerControllerOptions<T>);
     postStop(): void;
-    onReceive(msg: ProducerSend<T> | Ack): void;
+    onReceive(msg: ProducerSend<T> | Acknowledgment): void;
     private handleSend;
     private dispatch;
     private send;
-    private handleAck;
+    private handleAcknowledgment;
 }
 //# sourceMappingURL=ProducerController.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ProducerController.d.ts","sourceRoot":"","sources":["../../src/delivery/ProducerController.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGpC,OAAO,KAAK,EAAE,yBAAyB,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AAC/G,OAAO,KAAK,EAAE,GAAG,EAAE,oBAAoB,EAAY,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;AAUD;;;;GAIG;AACH,qBAAa,kBAAkB,CAAC,CAAC,CAAE,SAAQ,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;IACrE,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;IAEpC,SAAgB,QAAQ,EAAE,6BAA6B,CAAC,CAAC,CAAC,CAAC;gBAE/C,OAAO,EAAE,yBAAyB,CAAC,CAAC,CAAC;IASxC,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"}
+{"version":3,"file":"ProducerController.d.ts","sourceRoot":"","sources":["../../src/delivery/ProducerController.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAIpC,OAAO,KAAK,EAAE,yBAAyB,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AAC/G,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAY,MAAM,eAAe,CAAC;AAKpF,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;AAUD;;;;GAIG;AACH,qBAAa,kBAAkB,CAAC,CAAC,CAAE,SAAQ,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC;IAChF,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;IAEpC,SAAgB,OAAO,EAAE,6BAA6B,CAAC,CAAC,CAAC,CAAC;gBAE9C,OAAO,EAAE,yBAAyB,CAAC,CAAC,CAAC;IAUxC,QAAQ,IAAI,IAAI;IAOhB,SAAS,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,cAAc,GAAG,IAAI;IAK/D,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,IAAI;IAqBZ,OAAO,CAAC,oBAAoB;CAY7B"}

package/dist/delivery/ProducerController.js

@@ -1,10 +1,11 @@
 import { Actor } from '../Actor.js';
+import { ProducerControllerOptionsValidator } from './ProducerControllerOptions.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.
+ * actor keeps retrying until it gets an Acknowledgment back.
  */
 export class ProducerController extends Actor {
     inflight = new Map();
@@ -13,26 +14,27 @@ export class ProducerController extends Actor {
     id;
     resendTimeoutMs;
     windowSize;
-    settings;
+    options;
     constructor(options) {
         super();
-        const settings = options;
-        this.settings = settings;
-        this.id = settings.producerId ?? nextProducerId();
-        this.resendTimeoutMs = settings.resendTimeout ?? 500;
-        this.windowSize = settings.windowSize ?? 16;
+        const resolvedOptions = options;
+        new ProducerControllerOptionsValidator().validate(resolvedOptions);
+        this.options = resolvedOptions;
+        this.id = resolvedOptions.producerId ?? nextProducerId();
+        this.resendTimeoutMs = resolvedOptions.resendTimeout ?? 500;
+        this.windowSize = resolvedOptions.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'));
+        for (const inflight of this.inflight.values())
+            inflight.timer?.cancel();
+        for (const pending of this.pending)
+            pending.confirm?.(new Error('producer stopped'));
         this.pending.length = 0;
         this.inflight.clear();
     }
     onReceive(msg) {
         if (msg.kind === 'reliable-delivery.ack')
-            return this.handleAck(msg);
+            return this.handleAcknowledgment(msg);
         if (msg.kind === 'reliable-delivery.send')
             return this.handleSend(msg);
     }
@@ -45,37 +47,37 @@ export class ProducerController extends Actor {
     }
     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);
+        const inflight = { seq, body: msg.body, confirm: msg.confirm, attempts: 0, timer: null };
+        this.inflight.set(seq, inflight);
+        this.send(inflight);
     }
-    send(f) {
-        f.attempts++;
+    send(inflight) {
+        inflight.attempts++;
         const delivery = {
             kind: 'reliable-delivery.delivery',
             producerId: this.id,
-            seq: f.seq,
-            body: f.body,
+            seq: inflight.seq,
+            body: inflight.body,
             replyTo: this.self,
         };
-        this.settings.consumer.tell(delivery);
-        f.timer = this.system.scheduler.scheduleOnceFn(this.resendTimeoutMs, () => {
+        this.options.consumer.tell(delivery);
+        inflight.timer = this.system.scheduler.scheduleOnceFn(this.resendTimeoutMs, () => {
             // Only resend if still un-acked.
-            const current = this.inflight.get(f.seq);
+            const current = this.inflight.get(inflight.seq);
             if (!current)
                 return;
             this.send(current);
         });
     }
-    handleAck(msg) {
+    handleAcknowledgment(msg) {
         if (msg.producerId !== this.id)
             return;
-        const f = this.inflight.get(msg.seq);
-        if (!f)
+        const inflight = this.inflight.get(msg.seq);
+        if (!inflight)
             return;
-        f.timer?.cancel();
+        inflight.timer?.cancel();
         this.inflight.delete(msg.seq);
-        f.confirm?.(null);
+        inflight.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());

package/dist/delivery/ProducerController.js.map

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

package/dist/delivery/ProducerControllerOptions.d.ts

@@ -1,11 +1,12 @@
 import { OptionsBuilder } from '../util/OptionsBuilder.js';
+import { OptionsValidator } from '../util/OptionsValidator.js';
 import type { ActorRef } from '../ActorRef.js';
 import type { Delivery } from './Messages.js';
-/** Plain settings-object shape accepted by a {@link ProducerController}. */
+/** Plain options-object shape accepted by a {@link ProducerController}. */
 export interface ProducerControllerOptionsType<T> {
     readonly consumer: ActorRef<Delivery<T>>;
     /**
-     * How long to wait for an Ack before re-sending.  Default 500ms.
+     * How long to wait for an Acknowledgment before re-sending.  Default 500ms.
      */
     readonly resendTimeout?: number;
     /**
@@ -32,13 +33,18 @@ export declare class ProducerControllerOptionsBuilder<T> extends OptionsBuilder<
     static create<T>(): ProducerControllerOptionsBuilder<T>;
     /** Consumer that receives the deliveries and Acks back.  Required. */
     withConsumer(consumer: ActorRef<Delivery<T>>): this;
-    /** How long to wait for an Ack before re-sending, in ms.  Default 500. */
+    /** How long to wait for an Acknowledgment before re-sending, in ms.  Default 500. */
     withResendTimeout(ms: number): this;
     /** Flow-control window: max in-flight (un-acked) messages.  Default 16. */
     withWindowSize(size: number): this;
     /** Stable identifier used by consumers to dedup across restarts. */
     withProducerId(producerId: string): this;
 }
+/** Validates resolved {@link ProducerControllerOptionsType} settings. */
+export declare class ProducerControllerOptionsValidator<T> extends OptionsValidator<ProducerControllerOptionsType<T>> {
+    constructor();
+    protected rules(_s: Partial<ProducerControllerOptionsType<T>>): void;
+}
 /**
  * Accepted input for a {@link ProducerController}: the fluent
  * {@link ProducerControllerOptionsBuilder} OR a plain

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

@@ -1 +1 @@
-{"version":3,"file":"ProducerControllerOptions.d.ts","sourceRoot":"","sources":["../../src/delivery/ProducerControllerOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,4EAA4E;AAC5E,MAAM,WAAW,6BAA6B,CAAC,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACzC;;OAEG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;;GASG;AACH,qBAAa,gCAAgC,CAAC,CAAC,CAAE,SAAQ,cAAc,CAAC,6BAA6B,CAAC,CAAC,CAAC,CAAC;IACvG,yFAAyF;IACzF,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,gCAAgC,CAAC,CAAC,CAAC;IAIvD,sEAAsE;IACtE,YAAY,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAInD,0EAA0E;IAC1E,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAInC,2EAA2E;IAC3E,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIlC,oEAAoE;IACpE,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;CAGzC;AAED;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,CAAC,CAAC,IACnC,gCAAgC,CAAC,CAAC,CAAC,GACnC,OAAO,CAAC,6BAA6B,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9C,sHAAsH;AACtH,eAAO,MAAM,yBAAyB,yCAAmC,CAAC"}
+{"version":3,"file":"ProducerControllerOptions.d.ts","sourceRoot":"","sources":["../../src/delivery/ProducerControllerOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,2EAA2E;AAC3E,MAAM,WAAW,6BAA6B,CAAC,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACzC;;OAEG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;;GASG;AACH,qBAAa,gCAAgC,CAAC,CAAC,CAAE,SAAQ,cAAc,CAAC,6BAA6B,CAAC,CAAC,CAAC,CAAC;IACvG,yFAAyF;IACzF,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,gCAAgC,CAAC,CAAC,CAAC;IAIvD,sEAAsE;IACtE,YAAY,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAInD,qFAAqF;IACrF,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAInC,2EAA2E;IAC3E,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIlC,oEAAoE;IACpE,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;CAGzC;AAED,yEAAyE;AACzE,qBAAa,kCAAkC,CAAC,CAAC,CAAE,SAAQ,gBAAgB,CAAC,6BAA6B,CAAC,CAAC,CAAC,CAAC;;IAI3G,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,CAAC,6BAA6B,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;CAIrE;AAED;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,CAAC,CAAC,IACnC,gCAAgC,CAAC,CAAC,CAAC,GACnC,OAAO,CAAC,6BAA6B,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9C,sHAAsH;AACtH,eAAO,MAAM,yBAAyB,yCAAmC,CAAC"}

package/dist/delivery/ProducerControllerOptions.js

@@ -1,4 +1,5 @@
 import { OptionsBuilder } from '../util/OptionsBuilder.js';
+import { OptionsValidator } from '../util/OptionsValidator.js';
 /**
  * Fluent builder for {@link ProducerControllerOptionsType}.  The
  * `consumer` ref is required — pass it via {@link withConsumer} before
@@ -18,7 +19,7 @@ export class ProducerControllerOptionsBuilder extends OptionsBuilder {
     withConsumer(consumer) {
         return this.set('consumer', consumer);
     }
-    /** How long to wait for an Ack before re-sending, in ms.  Default 500. */
+    /** How long to wait for an Acknowledgment before re-sending, in ms.  Default 500. */
     withResendTimeout(ms) {
         return this.set('resendTimeout', ms);
     }
@@ -31,6 +32,16 @@ export class ProducerControllerOptionsBuilder extends OptionsBuilder {
         return this.set('producerId', producerId);
     }
 }
+/** Validates resolved {@link ProducerControllerOptionsType} settings. */
+export class ProducerControllerOptionsValidator extends OptionsValidator {
+    constructor() {
+        super('ProducerControllerOptions');
+    }
+    rules(_s) {
+        this.positiveNumber('resendTimeout');
+        this.positiveInt('windowSize');
+    }
+}
 /** Value alias so `ProducerControllerOptions.create()` / `new ProducerControllerOptions()` resolve to the builder. */
 export const ProducerControllerOptions = ProducerControllerOptionsBuilder;
 //# sourceMappingURL=ProducerControllerOptions.js.map

package/dist/delivery/ProducerControllerOptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"ProducerControllerOptions.js","sourceRoot":"","sources":["../../src/delivery/ProducerControllerOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAqB3D;;;;;;;;;GASG;AACH,MAAM,OAAO,gCAAoC,SAAQ,cAAgD;IACvG,yFAAyF;IACzF,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,gCAAgC,EAAK,CAAC;IACnD,CAAC;IAED,sEAAsE;IACtE,YAAY,CAAC,QAA+B;QAC1C,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,0EAA0E;IAC1E,iBAAiB,CAAC,EAAU;QAC1B,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,2EAA2E;IAC3E,cAAc,CAAC,IAAY;QACzB,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,oEAAoE;IACpE,cAAc,CAAC,UAAkB;QAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IAC5C,CAAC;CACF;AAUD,sHAAsH;AACtH,MAAM,CAAC,MAAM,yBAAyB,GAAG,gCAAgC,CAAC"}
+{"version":3,"file":"ProducerControllerOptions.js","sourceRoot":"","sources":["../../src/delivery/ProducerControllerOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAqB/D;;;;;;;;;GASG;AACH,MAAM,OAAO,gCAAoC,SAAQ,cAAgD;IACvG,yFAAyF;IACzF,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,gCAAgC,EAAK,CAAC;IACnD,CAAC;IAED,sEAAsE;IACtE,YAAY,CAAC,QAA+B;QAC1C,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,qFAAqF;IACrF,iBAAiB,CAAC,EAAU;QAC1B,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,2EAA2E;IAC3E,cAAc,CAAC,IAAY;QACzB,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,oEAAoE;IACpE,cAAc,CAAC,UAAkB;QAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IAC5C,CAAC;CACF;AAED,yEAAyE;AACzE,MAAM,OAAO,kCAAsC,SAAQ,gBAAkD;IAC3G;QACE,KAAK,CAAC,2BAA2B,CAAC,CAAC;IACrC,CAAC;IACS,KAAK,CAAC,EAA6C;QAC3D,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC;QACrC,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IACjC,CAAC;CACF;AAUD,sHAAsH;AACtH,MAAM,CAAC,MAAM,yBAAyB,GAAG,gCAAgC,CAAC"}

package/dist/delivery/ReliableDelivery.d.ts

@@ -1,6 +1,6 @@
 import type { ActorRef } from '../ActorRef.js';
 import type { ActorSystem } from '../ActorSystem.js';
-import { type ConsumerControllerSettings } from './ConsumerController.js';
+import type { ConsumerControllerOptionsType } from './ConsumerControllerOptions.js';
 import type { ConfirmationCallback, Delivery } from './Messages.js';
 import { type ProducerSend } from './ProducerController.js';
 import type { ProducerControllerOptions } from './ProducerControllerOptions.js';
@@ -30,8 +30,8 @@ export interface ConsumerHandle {
  */
 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 consumer<T>(system: ActorSystem, options: ConsumerControllerOptionsType<T>, name?: string): ConsumerHandle;
+    /** Spawn a ProducerController aimed at `options.consumer`. */
     static producer<T>(system: ActorSystem, options: ProducerControllerOptions<T>, name?: string): ProducerHandle<T>;
 }
 //# sourceMappingURL=ReliableDelivery.d.ts.map

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

@@ -1 +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,YAAY,EAClB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAEhF;;;;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,OAAO,EAAE,yBAAyB,CAAC,CAAC,CAAC,EACrC,IAAI,CAAC,EAAE,MAAM,GACZ,cAAc,CAAC,CAAC,CAAC;CAarB"}
+{"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;AAGrD,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AACpF,OAAO,KAAK,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EAEL,KAAK,YAAY,EAClB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAEhF;;;;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,OAAO,EAAE,6BAA6B,CAAC,CAAC,CAAC,EACzC,IAAI,CAAC,EAAE,MAAM,GACZ,cAAc;IAQjB,8DAA8D;IAC9D,MAAM,CAAC,QAAQ,CAAC,CAAC,EACf,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,yBAAyB,CAAC,CAAC,CAAC,EACrC,IAAI,CAAC,EAAE,MAAM,GACZ,cAAc,CAAC,CAAC,CAAC;CAarB"}

package/dist/delivery/ReliableDelivery.js

@@ -1,5 +1,5 @@
 import { Props } from '../Props.js';
-import { ConsumerController, } from './ConsumerController.js';
+import { ConsumerController } from './ConsumerController.js';
 import { ProducerController, } from './ProducerController.js';
 /**
  * Point-to-point at-least-once delivery between a Producer and a Consumer.
@@ -12,11 +12,11 @@ import { ProducerController, } from './ProducerController.js';
  */
 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}`);
+    static consumer(system, options, name) {
+        const ref = system.spawn(Props.create(() => new ConsumerController(options)), name ?? `reliable-consumer-${++counter}`);
         return { ref, stop() { ref.stop(); } };
     }
-    /** Spawn a ProducerController aimed at `settings.consumer`. */
+    /** Spawn a ProducerController aimed at `options.consumer`. */
     static producer(system, options, name) {
         const ref = system.spawn(Props.create(() => new ProducerController(options)), name ?? `reliable-producer-${++counter}`);
         return {

package/dist/delivery/ReliableDelivery.js.map

@@ -1 +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,GAEnB,MAAM,yBAAyB,CAAC;AAoBjC;;;;;;;;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,OAAqC,EACrC,IAAa;QAEb,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CACtB,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,kBAAkB,CAAI,OAAO,CAA4D,CAAC,EACjH,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"}
+{"version":3,"file":"ReliableDelivery.js","sourceRoot":"","sources":["../../src/delivery/ReliableDelivery.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,EACL,kBAAkB,GAEnB,MAAM,yBAAyB,CAAC;AAoBjC;;;;;;;;GAQG;AACH,MAAM,OAAO,gBAAgB;IAC3B,kFAAkF;IAClF,MAAM,CAAC,QAAQ,CACb,MAAmB,EACnB,OAAyC,EACzC,IAAa;QAEb,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CACtB,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,kBAAkB,CAAI,OAAO,CAA8D,CAAC,EACnH,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,8DAA8D;IAC9D,MAAM,CAAC,QAAQ,CACb,MAAmB,EACnB,OAAqC,EACrC,IAAa;QAEb,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CACtB,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,kBAAkB,CAAI,OAAO,CAA4D,CAAC,EACjH,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

@@ -1,10 +1,11 @@
 export { ProducerController } from './ProducerController.js';
-export { ProducerControllerOptions, ProducerControllerOptionsBuilder } from './ProducerControllerOptions.js';
+export { ProducerControllerOptions, ProducerControllerOptionsBuilder, ProducerControllerOptionsValidator } from './ProducerControllerOptions.js';
 export type { ProducerControllerOptionsType } from './ProducerControllerOptions.js';
 export type { ProducerSend } from './ProducerController.js';
 export { ConsumerController } from './ConsumerController.js';
-export type { ConsumerControllerSettings } from './ConsumerController.js';
+export { ConsumerControllerOptions, ConsumerControllerOptionsBuilder } from './ConsumerControllerOptions.js';
+export type { ConsumerControllerOptionsType } from './ConsumerControllerOptions.js';
 export { ReliableDelivery } from './ReliableDelivery.js';
 export type { ProducerHandle, ConsumerHandle } from './ReliableDelivery.js';
-export type { Delivery, Ack, ConfirmationCallback } from './Messages.js';
+export type { Delivery, Acknowledgment, ConfirmationCallback } from './Messages.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/delivery/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,gCAAgC,EAAE,MAAM,gCAAgC,CAAC;AAC7G,YAAY,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AACpF,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/delivery/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,gCAAgC,EAAE,kCAAkC,EAAE,MAAM,gCAAgC,CAAC;AACjJ,YAAY,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AACpF,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,gCAAgC,EAAE,MAAM,gCAAgC,CAAC;AAC7G,YAAY,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AACpF,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5E,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC"}

package/dist/delivery/index.js

@@ -1,5 +1,6 @@
 export { ProducerController } from './ProducerController.js';
-export { ProducerControllerOptions, ProducerControllerOptionsBuilder } from './ProducerControllerOptions.js';
+export { ProducerControllerOptions, ProducerControllerOptionsBuilder, ProducerControllerOptionsValidator } from './ProducerControllerOptions.js';
 export { ConsumerController } from './ConsumerController.js';
+export { ConsumerControllerOptions, ConsumerControllerOptionsBuilder } from './ConsumerControllerOptions.js';
 export { ReliableDelivery } from './ReliableDelivery.js';
 //# sourceMappingURL=index.js.map

package/dist/delivery/index.js.map

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

package/dist/discovery/AutoDiscoveryOptions.d.ts

@@ -1,4 +1,5 @@
 import { OptionsBuilder } from '../util/OptionsBuilder.js';
+import { OptionsValidator } from '../util/OptionsValidator.js';
 /**
  * Env-driven defaults for the standard production deployment shapes.
  * Recognised environment variables (none required — every layer is
@@ -61,6 +62,11 @@ export declare class AutoDiscoveryOptionsBuilder extends OptionsBuilder<AutoDisc
     /** Logger for individual provider failures.  Default: no-op. */
     withLog(log: (msg: string, err?: unknown) => void): this;
 }
+/** Validates resolved {@link AutoDiscoveryOptionsType} settings. */
+export declare class AutoDiscoveryOptionsValidator extends OptionsValidator<AutoDiscoveryOptionsType> {
+    constructor();
+    protected rules(_s: Partial<AutoDiscoveryOptionsType>): void;
+}
 /**
  * Accepted input for {@link autoDiscovery} / {@link singleProviderDiscovery}:
  * the fluent {@link AutoDiscoveryOptionsBuilder} OR a plain

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

@@ -1 +1 @@
-{"version":3,"file":"AutoDiscoveryOptions.d.ts","sourceRoot":"","sources":["../../src/discovery/AutoDiscoveryOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,wBAAwB;IACvC,6DAA6D;IAC7D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAClD,gEAAgE;IAChE,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;CACrD;AAED;;;;;;;GAOG;AACH,qBAAa,2BAA4B,SAAQ,cAAc,CAAC,wBAAwB,CAAC;IACvF,iFAAiF;IACjF,MAAM,CAAC,MAAM,IAAI,2BAA2B;IAI5C,6DAA6D;IAC7D,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIxC,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI5B,sEAAsE;IACtE,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,IAAI;IAItD,gEAAgE;IAChE,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;CAGzD;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,2BAA2B,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;AACnG,4GAA4G;AAC5G,eAAO,MAAM,oBAAoB,oCAA8B,CAAC"}
+{"version":3,"file":"AutoDiscoveryOptions.d.ts","sourceRoot":"","sources":["../../src/discovery/AutoDiscoveryOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,wBAAwB;IACvC,6DAA6D;IAC7D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAClD,gEAAgE;IAChE,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;CACrD;AAED;;;;;;;GAOG;AACH,qBAAa,2BAA4B,SAAQ,cAAc,CAAC,wBAAwB,CAAC;IACvF,iFAAiF;IACjF,MAAM,CAAC,MAAM,IAAI,2BAA2B;IAI5C,6DAA6D;IAC7D,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIxC,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI5B,sEAAsE;IACtE,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,IAAI;IAItD,gEAAgE;IAChE,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;CAGzD;AAED,oEAAoE;AACpE,qBAAa,6BAA8B,SAAQ,gBAAgB,CAAC,wBAAwB,CAAC;;IAI3F,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,CAAC,wBAAwB,CAAC,GAAG,IAAI;CAI7D;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,2BAA2B,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;AACnG,4GAA4G;AAC5G,eAAO,MAAM,oBAAoB,oCAA8B,CAAC"}

package/dist/discovery/AutoDiscoveryOptions.js

@@ -1,4 +1,5 @@
 import { OptionsBuilder } from '../util/OptionsBuilder.js';
+import { OptionsValidator } from '../util/OptionsValidator.js';
 /**
  * Fluent builder for {@link AutoDiscoveryOptionsType} — the input to
  * {@link autoDiscovery} and {@link singleProviderDiscovery}.
@@ -29,6 +30,16 @@ export class AutoDiscoveryOptionsBuilder extends OptionsBuilder {
         return this.set('log', log);
     }
 }
+/** Validates resolved {@link AutoDiscoveryOptionsType} settings. */
+export class AutoDiscoveryOptionsValidator extends OptionsValidator {
+    constructor() {
+        super('AutoDiscoveryOptions');
+    }
+    rules(_s) {
+        this.nonEmptyString('systemName');
+        this.positiveInt('port'); // node-address port (transport-agnostic — see ClusterOptions.port)
+    }
+}
 /** Value alias so `AutoDiscoveryOptions.create()` / `new AutoDiscoveryOptions()` resolve to the builder. */
 export const AutoDiscoveryOptions = AutoDiscoveryOptionsBuilder;
 //# sourceMappingURL=AutoDiscoveryOptions.js.map

package/dist/discovery/AutoDiscoveryOptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"AutoDiscoveryOptions.js","sourceRoot":"","sources":["../../src/discovery/AutoDiscoveryOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AA6C3D;;;;;;;GAOG;AACH,MAAM,OAAO,2BAA4B,SAAQ,cAAwC;IACvF,iFAAiF;IACjF,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,2BAA2B,EAAE,CAAC;IAC3C,CAAC;IAED,6DAA6D;IAC7D,cAAc,CAAC,UAAkB;QAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IAC5C,CAAC;IAED,6DAA6D;IAC7D,QAAQ,CAAC,IAAY;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,sEAAsE;IACtE,OAAO,CAAC,GAAuC;QAC7C,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,gEAAgE;IAChE,OAAO,CAAC,GAAyC;QAC/C,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC9B,CAAC;CACF;AAQD,4GAA4G;AAC5G,MAAM,CAAC,MAAM,oBAAoB,GAAG,2BAA2B,CAAC"}
+{"version":3,"file":"AutoDiscoveryOptions.js","sourceRoot":"","sources":["../../src/discovery/AutoDiscoveryOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AA6C/D;;;;;;;GAOG;AACH,MAAM,OAAO,2BAA4B,SAAQ,cAAwC;IACvF,iFAAiF;IACjF,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,2BAA2B,EAAE,CAAC;IAC3C,CAAC;IAED,6DAA6D;IAC7D,cAAc,CAAC,UAAkB;QAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IAC5C,CAAC;IAED,6DAA6D;IAC7D,QAAQ,CAAC,IAAY;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,sEAAsE;IACtE,OAAO,CAAC,GAAuC;QAC7C,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,gEAAgE;IAChE,OAAO,CAAC,GAAyC;QAC/C,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC9B,CAAC;CACF;AAED,oEAAoE;AACpE,MAAM,OAAO,6BAA8B,SAAQ,gBAA0C;IAC3F;QACE,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAChC,CAAC;IACS,KAAK,CAAC,EAAqC;QACnD,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;QAClC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,mEAAmE;IAC/F,CAAC;CACF;AAQD,4GAA4G;AAC5G,MAAM,CAAC,MAAM,oBAAoB,GAAG,2BAA2B,CAAC"}