actor-ts 0.9.1 → 0.11.0

package/dist/delivery/ProducerControllerOptions.d.ts

@@ -0,0 +1,56 @@
+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 options-object shape accepted by a {@link ProducerController}. */
+export interface ProducerControllerOptionsType<T> {
+    readonly consumer: ActorRef<Delivery<T>>;
+    /**
+     * How long to wait for an Acknowledgment before re-sending.  Default 500ms.
+     */
+    readonly resendTimeout?: 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;
+}
+/**
+ * Fluent builder for {@link ProducerControllerOptionsType}.  The
+ * `consumer` ref is required — pass it via {@link withConsumer} before
+ * `build()`; the remaining fields default (resend 500 ms, window 16,
+ * generated producer id) when left unset.
+ *
+ *     ProducerControllerOptions.create<Cmd>()
+ *       .withConsumer(consumerRef)
+ *       .withWindowSize(32);
+ */
+export declare class ProducerControllerOptionsBuilder<T> extends OptionsBuilder<ProducerControllerOptionsType<T>> {
+    /** Start a fresh builder.  Equivalent to `new ProducerControllerOptionsBuilder<T>()`. */
+    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 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
+ * {@link ProducerControllerOptionsType} object.
+ */
+export type ProducerControllerOptions<T> = ProducerControllerOptionsBuilder<T> | Partial<ProducerControllerOptionsType<T>>;
+/** Value alias so `ProducerControllerOptions.create()` / `new ProducerControllerOptions()` resolve to the builder. */
+export declare const ProducerControllerOptions: typeof ProducerControllerOptionsBuilder;
+//# sourceMappingURL=ProducerControllerOptions.d.ts.map

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

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

@@ -0,0 +1,47 @@
+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
+ * `build()`; the remaining fields default (resend 500 ms, window 16,
+ * generated producer id) when left unset.
+ *
+ *     ProducerControllerOptions.create<Cmd>()
+ *       .withConsumer(consumerRef)
+ *       .withWindowSize(32);
+ */
+export class ProducerControllerOptionsBuilder extends OptionsBuilder {
+    /** Start a fresh builder.  Equivalent to `new ProducerControllerOptionsBuilder<T>()`. */
+    static create() {
+        return new ProducerControllerOptionsBuilder();
+    }
+    /** Consumer that receives the deliveries and Acks back.  Required. */
+    withConsumer(consumer) {
+        return this.set('consumer', consumer);
+    }
+    /** How long to wait for an Acknowledgment before re-sending, in ms.  Default 500. */
+    withResendTimeout(ms) {
+        return this.set('resendTimeout', ms);
+    }
+    /** Flow-control window: max in-flight (un-acked) messages.  Default 16. */
+    withWindowSize(size) {
+        return this.set('windowSize', size);
+    }
+    /** Stable identifier used by consumers to dedup across restarts. */
+    withProducerId(producerId) {
+        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

@@ -0,0 +1 @@
+{"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,8 +1,9 @@
 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 ProducerControllerSettings, type ProducerSend } from './ProducerController.js';
+import { type ProducerSend } from './ProducerController.js';
+import type { ProducerControllerOptions } from './ProducerControllerOptions.js';
 /**
  * Handle returned to the publishing user code.  `tell` enqueues a message
  * for reliable delivery; an optional `confirm` callback fires once the
@@ -29,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 producer<T>(system: ActorSystem, settings: ProducerControllerSettings<T>, name?: string): ProducerHandle<T>;
+    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,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"}
+{"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,13 +12,13 @@ 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`. */
-    static producer(system, settings, name) {
-        const ref = system.spawn(Props.create(() => new ProducerController(settings)), name ?? `reliable-producer-${++counter}`);
+    /** 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 {
             ref,
             tell(body, confirm) {

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,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"}
+{"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,8 +1,11 @@
 export { ProducerController } from './ProducerController.js';
-export type { ProducerControllerSettings, ProducerSend, } from './ProducerController.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,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"}
+{"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,4 +1,6 @@
 export { ProducerController } from './ProducerController.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;AAK7D,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

@@ -0,0 +1,78 @@
+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
+ * optional, the helper returns whatever providers the env supports):
+ *
+ *   - `CLUSTER_SEEDS`         — comma-separated `[system@]host:port` list.
+ *                               Strongest signal; if present, the
+ *                               `ConfigSeedProvider` is preferred over the
+ *                               service-discovery layers.
+ *   - `CLUSTER_SERVICE_NAME`  — name of the service whose members are
+ *                               this cluster's peers.  Drives both the
+ *                               `KubernetesApiSeedProvider` (when running
+ *                               in-pod) and the `DnsSeedProvider`.
+ *   - `CLUSTER_NAMESPACE`     — K8s namespace.  Default: `default`.
+ *   - `KUBERNETES_SERVICE_HOST` — set automatically inside every K8s pod;
+ *                                used as the detection signal for adding
+ *                                the K8s-API provider to the chain.
+ *
+ * Chain order (first non-empty wins):
+ *
+ *   1. `CLUSTER_SEEDS` (ConfigSeedProvider)        — most explicit
+ *   2. K8s API endpoints                            — service mesh
+ *   3. DNS resolve of `CLUSTER_SERVICE_NAME`        — fallback
+ *
+ * If none of the env vars are set, the returned provider's `lookup()`
+ * resolves to `[]` — the cluster boots as the first node in a
+ * single-node topology, which is exactly what local dev wants.
+ */
+export interface AutoDiscoveryOptionsType {
+    /** ActorSystem name to stamp on discovered NodeAddresses. */
+    readonly systemName: string;
+    /** Cluster remoting port to pair each discovered IP with. */
+    readonly port: number;
+    /**
+     * Optional pre-mapped env lookup — useful for tests that want to
+     * exercise the provider chain without mutating `process.env`.
+     * Defaults to `process.env` at call time.
+     */
+    readonly env?: Record<string, string | undefined>;
+    /** Logger for individual provider failures.  Default: no-op. */
+    readonly log?: (msg: string, err?: unknown) => void;
+}
+/**
+ * Fluent builder for {@link AutoDiscoveryOptionsType} — the input to
+ * {@link autoDiscovery} and {@link singleProviderDiscovery}.
+ *
+ *     autoDiscovery(
+ *       AutoDiscoveryOptions.create().withSystemName('my-system').withPort(2552),
+ *     );
+ */
+export declare class AutoDiscoveryOptionsBuilder extends OptionsBuilder<AutoDiscoveryOptionsType> {
+    /** Start a fresh builder.  Equivalent to `new AutoDiscoveryOptionsBuilder()`. */
+    static create(): AutoDiscoveryOptionsBuilder;
+    /** ActorSystem name to stamp on discovered NodeAddresses. */
+    withSystemName(systemName: string): this;
+    /** Cluster remoting port to pair each discovered IP with. */
+    withPort(port: number): this;
+    /** Pre-mapped env lookup (defaults to `process.env` at call time). */
+    withEnv(env: Record<string, string | undefined>): this;
+    /** 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
+ * {@link AutoDiscoveryOptionsType} object.
+ */
+export type AutoDiscoveryOptions = AutoDiscoveryOptionsBuilder | Partial<AutoDiscoveryOptionsType>;
+/** Value alias so `AutoDiscoveryOptions.create()` / `new AutoDiscoveryOptions()` resolve to the builder. */
+export declare const AutoDiscoveryOptions: typeof AutoDiscoveryOptionsBuilder;
+//# sourceMappingURL=AutoDiscoveryOptions.d.ts.map

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

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

@@ -0,0 +1,45 @@
+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}.
+ *
+ *     autoDiscovery(
+ *       AutoDiscoveryOptions.create().withSystemName('my-system').withPort(2552),
+ *     );
+ */
+export class AutoDiscoveryOptionsBuilder extends OptionsBuilder {
+    /** Start a fresh builder.  Equivalent to `new AutoDiscoveryOptionsBuilder()`. */
+    static create() {
+        return new AutoDiscoveryOptionsBuilder();
+    }
+    /** ActorSystem name to stamp on discovered NodeAddresses. */
+    withSystemName(systemName) {
+        return this.set('systemName', systemName);
+    }
+    /** Cluster remoting port to pair each discovered IP with. */
+    withPort(port) {
+        return this.set('port', port);
+    }
+    /** Pre-mapped env lookup (defaults to `process.env` at call time). */
+    withEnv(env) {
+        return this.set('env', env);
+    }
+    /** Logger for individual provider failures.  Default: no-op. */
+    withLog(log) {
+        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

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

package/dist/discovery/ConfigSeedProvider.d.ts

@@ -1,18 +1,13 @@
 import { NodeAddress } from '../cluster/NodeAddress.js';
+import { ConfigSeedProviderOptions } from './ConfigSeedProviderOptions.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);
+    private readonly options;
+    constructor(options?: ConfigSeedProviderOptions);
     lookup(): Promise<NodeAddress[]>;
 }
 /** Read seeds from an environment variable (comma-separated). */

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

@@ -1 +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"}
+{"version":3,"file":"ConfigSeedProvider.d.ts","sourceRoot":"","sources":["../../src/discovery/ConfigSeedProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAsC,MAAM,gCAAgC,CAAC;AAE/G,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,YAAY;IACrD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;gBAE5C,OAAO,GAAE,yBAA8B;IAK7C,MAAM,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;CAMvC;AAED,iEAAiE;AACjE,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,kBAAkB,CAMpF"}

package/dist/discovery/ConfigSeedProvider.js

@@ -1,16 +1,18 @@
 import { NodeAddress } from '../cluster/NodeAddress.js';
+import { ConfigSeedProviderOptions, ConfigSeedProviderOptionsValidator } from './ConfigSeedProviderOptions.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;
+    options;
+    constructor(options = {}) {
+        this.options = options;
+        new ConfigSeedProviderOptionsValidator().validate(this.options);
     }
     async lookup() {
-        return this.settings.seeds.map((raw) => {
-            const text = raw.includes('@') ? raw : `${this.settings.systemName}@${raw}`;
+        return this.options.seeds.map((raw) => {
+            const text = raw.includes('@') ? raw : `${this.options.systemName}@${raw}`;
             return NodeAddress.parse(text);
         });
     }
@@ -19,6 +21,6 @@ export class ConfigSeedProvider {
 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 });
+    return new ConfigSeedProvider(ConfigSeedProviderOptions.create().withSeeds(seeds).withSystemName(systemName));
 }
 //# sourceMappingURL=ConfigSeedProvider.js.map

package/dist/discovery/ConfigSeedProvider.js.map

@@ -1 +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"}
+{"version":3,"file":"ConfigSeedProvider.js","sourceRoot":"","sources":["../../src/discovery/ConfigSeedProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,kCAAkC,EAAE,MAAM,gCAAgC,CAAC;AAI/G;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IACZ,OAAO,CAAgC;IAExD,YAAY,UAAqC,EAAE;QACjD,IAAI,CAAC,OAAO,GAAG,OAAwC,CAAC;QACxD,IAAI,kCAAkC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,MAAM;QACV,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YACpC,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,GAAG,EAAE,CAAC;YAC3E,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,CAC3B,yBAAyB,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,UAAU,CAAC,CAC/E,CAAC;AACJ,CAAC"}

package/dist/discovery/ConfigSeedProviderOptions.d.ts

@@ -0,0 +1,40 @@
+import { OptionsBuilder } from '../util/OptionsBuilder.js';
+import { OptionsValidator } from '../util/OptionsValidator.js';
+/** Plain options-object shape accepted by a {@link ConfigSeedProvider}. */
+export interface ConfigSeedProviderOptionsType {
+    /** 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;
+}
+/**
+ * Fluent builder for {@link ConfigSeedProviderOptionsType}.
+ *
+ *     new ConfigSeedProvider(
+ *       ConfigSeedProviderOptions.create()
+ *         .withSeeds(['a@host1:2552', 'host2:2552'])
+ *         .withSystemName('my-system'),
+ *     );
+ */
+export declare class ConfigSeedProviderOptionsBuilder extends OptionsBuilder<ConfigSeedProviderOptionsType> {
+    /** Start a fresh builder.  Equivalent to `new ConfigSeedProviderOptionsBuilder()`. */
+    static create(): ConfigSeedProviderOptionsBuilder;
+    /** Static list of "system@host:port" or "host:port" strings. */
+    withSeeds(seeds: string[]): this;
+    /** Default system name used when a seed string omits it. */
+    withSystemName(systemName: string): this;
+}
+/** Validates resolved {@link ConfigSeedProviderOptionsType} settings. */
+export declare class ConfigSeedProviderOptionsValidator extends OptionsValidator<ConfigSeedProviderOptionsType> {
+    constructor();
+    protected rules(_s: Partial<ConfigSeedProviderOptionsType>): void;
+}
+/**
+ * Accepted input for the {@link ConfigSeedProvider} constructor: the fluent
+ * {@link ConfigSeedProviderOptionsBuilder} OR a plain
+ * {@link ConfigSeedProviderOptionsType} object.
+ */
+export type ConfigSeedProviderOptions = ConfigSeedProviderOptionsBuilder | Partial<ConfigSeedProviderOptionsType>;
+/** Value alias so `ConfigSeedProviderOptions.create()` / `new ConfigSeedProviderOptions()` resolve to the builder. */
+export declare const ConfigSeedProviderOptions: typeof ConfigSeedProviderOptionsBuilder;
+//# sourceMappingURL=ConfigSeedProviderOptions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigSeedProviderOptions.d.ts","sourceRoot":"","sources":["../../src/discovery/ConfigSeedProviderOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,2EAA2E;AAC3E,MAAM,WAAW,6BAA6B;IAC5C,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IACzB,4DAA4D;IAC5D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;GAQG;AACH,qBAAa,gCAAiC,SAAQ,cAAc,CAAC,6BAA6B,CAAC;IACjG,sFAAsF;IACtF,MAAM,CAAC,MAAM,IAAI,gCAAgC;IAIjD,gEAAgE;IAChE,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAIhC,4DAA4D;IAC5D,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;CAGzC;AAED,yEAAyE;AACzE,qBAAa,kCAAmC,SAAQ,gBAAgB,CAAC,6BAA6B,CAAC;;IAIrG,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,CAAC,6BAA6B,CAAC,GAAG,IAAI;CAIlE;AAED;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG,gCAAgC,GAAG,OAAO,CAAC,6BAA6B,CAAC,CAAC;AAClH,sHAAsH;AACtH,eAAO,MAAM,yBAAyB,yCAAmC,CAAC"}

package/dist/discovery/ConfigSeedProviderOptions.js

@@ -0,0 +1,38 @@
+import { OptionsBuilder } from '../util/OptionsBuilder.js';
+import { OptionsValidator } from '../util/OptionsValidator.js';
+/**
+ * Fluent builder for {@link ConfigSeedProviderOptionsType}.
+ *
+ *     new ConfigSeedProvider(
+ *       ConfigSeedProviderOptions.create()
+ *         .withSeeds(['a@host1:2552', 'host2:2552'])
+ *         .withSystemName('my-system'),
+ *     );
+ */
+export class ConfigSeedProviderOptionsBuilder extends OptionsBuilder {
+    /** Start a fresh builder.  Equivalent to `new ConfigSeedProviderOptionsBuilder()`. */
+    static create() {
+        return new ConfigSeedProviderOptionsBuilder();
+    }
+    /** Static list of "system@host:port" or "host:port" strings. */
+    withSeeds(seeds) {
+        return this.set('seeds', seeds);
+    }
+    /** Default system name used when a seed string omits it. */
+    withSystemName(systemName) {
+        return this.set('systemName', systemName);
+    }
+}
+/** Validates resolved {@link ConfigSeedProviderOptionsType} settings. */
+export class ConfigSeedProviderOptionsValidator extends OptionsValidator {
+    constructor() {
+        super('ConfigSeedProviderOptions');
+    }
+    rules(_s) {
+        this.nonEmptyArray('seeds');
+        this.nonEmptyString('systemName');
+    }
+}
+/** Value alias so `ConfigSeedProviderOptions.create()` / `new ConfigSeedProviderOptions()` resolve to the builder. */
+export const ConfigSeedProviderOptions = ConfigSeedProviderOptionsBuilder;
+//# sourceMappingURL=ConfigSeedProviderOptions.js.map

package/dist/discovery/ConfigSeedProviderOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigSeedProviderOptions.js","sourceRoot":"","sources":["../../src/discovery/ConfigSeedProviderOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAU/D;;;;;;;;GAQG;AACH,MAAM,OAAO,gCAAiC,SAAQ,cAA6C;IACjG,sFAAsF;IACtF,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,gCAAgC,EAAE,CAAC;IAChD,CAAC;IAED,gEAAgE;IAChE,SAAS,CAAC,KAAe;QACvB,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,4DAA4D;IAC5D,cAAc,CAAC,UAAkB;QAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IAC5C,CAAC;CACF;AAED,yEAAyE;AACzE,MAAM,OAAO,kCAAmC,SAAQ,gBAA+C;IACrG;QACE,KAAK,CAAC,2BAA2B,CAAC,CAAC;IACrC,CAAC;IACS,KAAK,CAAC,EAA0C;QACxD,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAC5B,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;IACpC,CAAC;CACF;AAQD,sHAAsH;AACtH,MAAM,CAAC,MAAM,yBAAyB,GAAG,gCAAgC,CAAC"}

package/dist/discovery/DnsSeedProvider.d.ts

@@ -1,35 +1,11 @@
 import { NodeAddress } from '../cluster/NodeAddress.js';
+import type { DnsSeedProviderOptions } from './DnsSeedProviderOptions.js';
 import type { SeedProvider } from './SeedProvider.js';
-export interface DnsSeedProviderSettings {
-    /** Hostname to resolve (e.g. `my-cluster.default.svc.cluster.local`). */
-    readonly hostname: string;
-    /** System name to stamp on discovered NodeAddresses. */
-    readonly systemName: string;
-    /** Port each discovered IP should be paired with. */
-    readonly port: number;
-    /** Override the DNS-resolve function — defaults to `node:dns/promises`. */
-    readonly resolve?: (hostname: string) => Promise<string[]>;
-    /** When using SRV records, override `resolveSrv` similarly. */
-    readonly resolveSrv?: (hostname: string) => Promise<Array<{
-        name: string;
-        port: number;
-    }>>;
-    /** If true, prefer SRV records (which carry a port) over A. */
-    readonly useSrv?: boolean;
-    /**
-     * In-process TTL cache for DNS lookups.  Deliberately *not* a
-     * distributed cache — DNS resolution is a per-process concern, and a
-     * Redis hop here would cost more than the lookup itself.  Default:
-     * 60_000 ms.  Set `0` to disable.  Failures are NOT cached: a query
-     * that throws will retry on the next call.
-     */
-    readonly cacheTtlMs?: number;
-}
 /**
  * Seed provider backed by DNS.  Default mode resolves A records and pairs
  * each IP with the configured port; SRV mode picks up `name:port` directly.
  *
- * The actual DNS functions are injected via settings so tests can stub them
+ * The actual DNS functions are injected via options so tests can stub them
  * without touching the network.  The real impl uses `node:dns/promises`.
  *
  * **TTL cache:** repeated lookups inside the configured `cacheTtlMs`
@@ -37,10 +13,10 @@ export interface DnsSeedProviderSettings {
  * DNS load on large clusters where each node polls the same name.
  */
 export declare class DnsSeedProvider implements SeedProvider {
-    private readonly settings;
     private cached;
     private readonly cacheTtlMs;
-    constructor(settings: DnsSeedProviderSettings);
+    private readonly options;
+    constructor(options?: DnsSeedProviderOptions);
     lookup(): Promise<NodeAddress[]>;
     /** Test hook — drop the cached entry so the next `lookup()` re-queries DNS. */
     invalidateCacheForTest(): void;

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

@@ -1 +1 @@
-{"version":3,"file":"DnsSeedProvider.d.ts","sourceRoot":"","sources":["../../src/discovery/DnsSeedProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,WAAW,uBAAuB;IACtC,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,wDAAwD;IACxD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3D,+DAA+D;IAC/D,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAC3F,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;;;GAUG;AACH,qBAAa,eAAgB,YAAW,YAAY;IAItC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAHrC,OAAO,CAAC,MAAM,CAA4D;IAC1E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAEP,QAAQ,EAAE,uBAAuB;IAOxD,MAAM,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAYtC,+EAA+E;IAC/E,sBAAsB,IAAI,IAAI;YAEhB,QAAQ;CAUvB"}
+{"version":3,"file":"DnsSeedProvider.d.ts","sourceRoot":"","sources":["../../src/discovery/DnsSeedProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,OAAO,KAAK,EAAE,sBAAsB,EAA8B,MAAM,6BAA6B,CAAC;AACtG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;;;;;;;;GAUG;AACH,qBAAa,eAAgB,YAAW,YAAY;IAClD,OAAO,CAAC,MAAM,CAA4D;IAC1E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAEpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;gBAEzC,OAAO,GAAE,sBAA2B;IAM1C,MAAM,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAYtC,+EAA+E;IAC/E,sBAAsB,IAAI,IAAI;YAEhB,QAAQ;CAUvB"}