actor-ts 0.9.1 → 0.11.0

package/dist/io/broker/AmqpActor.d.ts

@@ -1,7 +1,8 @@
 import type { Config } from '../../config/Config.js';
 import type { ActorRef } from '../../ActorRef.js';
 import { BrokerActor, type OutboundEnvelope } from './BrokerActor.js';
-import type { BrokerCommonSettings } from './BrokerSettings.js';
+import { AmqpOptionsValidator } from './AmqpOptions.js';
+import type { AmqpOptions, AmqpOptionsType } from './AmqpOptions.js';
 /** Inbound AMQP delivery handed to subscribers. */
 export interface AmqpDelivery {
     readonly queue: string;
@@ -24,18 +25,21 @@ export interface AmqpQueueBinding {
     readonly exchange?: string;
     readonly routingKey?: string;
     readonly target: ActorRef<AmqpDelivery>;
+    /**
+     * Queue-assertion options applied at connect time.  Defaults to
+     * `{ durable: true }` for safety (matches amqplib's own defaults).
+     * Override when the queue was pre-declared with different
+     * properties — RabbitMQ rejects a re-assert with mismatched
+     * params (PRECONDITION_FAILED) and closes the channel, which
+     * masks every subsequent consume/publish as a silent timeout.
+     */
+    readonly queueOptions?: {
+        readonly durable?: boolean;
+        readonly autoDelete?: boolean;
+        readonly exclusive?: boolean;
+    };
 }
-export interface AmqpActorSettings extends BrokerCommonSettings {
-    /** AMQP URL (`amqp://user:pass@host:5672/vhost`). */
-    readonly url?: string;
-    /** Number of unacked messages a consumer holds at once.  Default: 1. */
-    readonly prefetch?: number;
-    /** Queues + bindings + targets to set up after connect. */
-    readonly bindings?: ReadonlyArray<AmqpQueueBinding>;
-    /** Whether to auto-ack consumed deliveries.  Default: true. */
-    readonly autoAck?: boolean;
-}
-export type AmqpCmd = {
+export type AmqpCommand = {
     readonly kind: 'publish';
     readonly publish: AmqpPublish;
 } | {
@@ -49,7 +53,7 @@ export type AmqpCmd = {
 /**
  * AMQP 0.9.1 actor backed by `amqplib`.  One connection, one channel
  * shared by producer + consumers.  Bindings (queue↔exchange↔routingKey)
- * are configured up-front in settings; runtime additions go through
+ * are configured up-front in options; runtime additions go through
  * `tell({ kind: 'subscribe', ... })` (currently out-of-scope — add when
  * needed).
  *
@@ -58,21 +62,22 @@ export type AmqpCmd = {
  * processing.  For at-least-once-with-processing, set autoAck=false
  * and have your handler tell back `{ kind: 'ack' / 'nack', delivery }`.
  */
-export declare class AmqpActor extends BrokerActor<AmqpActorSettings, AmqpCmd, AmqpPublish> {
+export declare class AmqpActor extends BrokerActor<AmqpOptionsType, AmqpCommand, AmqpPublish> {
     private connection;
     private channel;
     /** Map ackToken → underlying amqplib message object (we never expose amqplib types upward). */
     private readonly pendingAcks;
     private nextAckToken;
-    constructor(settings?: Partial<AmqpActorSettings>);
+    constructor(options?: AmqpOptions);
     protected configKey(): string;
-    protected builtInDefaults(): Partial<AmqpActorSettings>;
-    protected readSettingsFromConfig(c: Config): Partial<AmqpActorSettings>;
-    protected requiredSettings(): ReadonlyArray<keyof AmqpActorSettings>;
+    protected builtInDefaultOptions(): Partial<AmqpOptionsType>;
+    protected readOptionsFromConfig(config: Config): Partial<AmqpOptionsType>;
+    protected requiredOptions(): ReadonlyArray<keyof AmqpOptionsType>;
+    protected optionsValidator(): AmqpOptionsValidator;
     protected endpointLabel(): string;
-    protected connectImpl(): Promise<void>;
-    protected disconnectImpl(): Promise<void>;
+    protected connectImplementation(): Promise<void>;
+    protected disconnectImplementation(): Promise<void>;
     protected dispatchOutgoing(env: OutboundEnvelope<AmqpPublish>): Promise<void>;
-    onReceive(cmd: AmqpCmd): void;
+    onReceive(cmd: AmqpCommand): void;
 }
 //# sourceMappingURL=AmqpActor.d.ts.map

package/dist/io/broker/AmqpActor.d.ts.map

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

package/dist/io/broker/AmqpActor.js

@@ -2,10 +2,11 @@ import { ConfigKeys } from '../../config/ConfigKeys.js';
 import { Lazy } from '../../util/Lazy.js';
 import { lazyImportModule } from '../../util/LazyImport.js';
 import { BrokerActor } from './BrokerActor.js';
+import { AmqpOptionsValidator } from './AmqpOptions.js';
 /**
  * AMQP 0.9.1 actor backed by `amqplib`.  One connection, one channel
  * shared by producer + consumers.  Bindings (queue↔exchange↔routingKey)
- * are configured up-front in settings; runtime additions go through
+ * are configured up-front in options; runtime additions go through
  * `tell({ kind: 'subscribe', ... })` (currently out-of-scope — add when
  * needed).
  *
@@ -20,42 +21,43 @@ export class AmqpActor extends BrokerActor {
     /** Map ackToken → underlying amqplib message object (we never expose amqplib types upward). */
     pendingAcks = new Map();
     nextAckToken = 1;
-    constructor(settings = {}) { super(settings); }
+    constructor(options = {}) { super(options); }
     configKey() { return ConfigKeys.io.broker.amqp; }
-    builtInDefaults() {
+    builtInDefaultOptions() {
         return { prefetch: 1, autoAck: true };
     }
-    readSettingsFromConfig(c) {
+    readOptionsFromConfig(config) {
         const out = {};
-        if (c.hasPath('url'))
-            out.url = c.getString('url');
-        if (c.hasPath('prefetch'))
-            out.prefetch = c.getInt('prefetch');
-        if (c.hasPath('autoAck'))
-            out.autoAck = c.getBoolean('autoAck');
+        if (config.hasPath('url'))
+            out.url = config.getString('url');
+        if (config.hasPath('prefetch'))
+            out.prefetch = config.getInt('prefetch');
+        if (config.hasPath('autoAck'))
+            out.autoAck = config.getBoolean('autoAck');
         return out;
     }
-    requiredSettings() { return ['url']; }
-    endpointLabel() { return this.settings.url ?? '<unknown>'; }
-    async connectImpl() {
+    requiredOptions() { return ['url']; }
+    optionsValidator() { return new AmqpOptionsValidator(); }
+    endpointLabel() { return this.options.url ?? '<unknown>'; }
+    async connectImplementation() {
         const amqp = await amqpLazy.get();
-        this.connection = await amqp.connect(this.settings.url);
+        this.connection = await amqp.connect(this.options.url);
         this.channel = await this.connection.createChannel();
-        await this.channel.prefetch(this.settings.prefetch ?? 1);
+        await this.channel.prefetch(this.options.prefetch ?? 1);
         this.connection.on('error', (e) => this.handleConnectionLost(e));
         this.connection.on('close', () => this.handleConnectionLost(new Error('amqp connection closed')));
-        for (const b of this.settings.bindings ?? []) {
-            await this.channel.assertQueue(b.queue, { durable: true });
-            if (b.exchange) {
-                await this.channel.bindQueue(b.queue, b.exchange, b.routingKey ?? '');
+        for (const binding of this.options.bindings ?? []) {
+            await this.channel.assertQueue(binding.queue, binding.queueOptions ?? { durable: true });
+            if (binding.exchange) {
+                await this.channel.bindQueue(binding.queue, binding.exchange, binding.routingKey ?? '');
             }
-            const target = b.target;
-            const queueName = b.queue;
+            const target = binding.target;
+            const queueName = binding.queue;
             await this.channel.consume(queueName, (msg) => {
                 if (!msg)
                     return;
                 const ackToken = this.nextAckToken++;
-                if (this.settings.autoAck) {
+                if (this.options.autoAck) {
                     try {
                         this.channel?.ack(msg);
                     }
@@ -73,7 +75,7 @@ export class AmqpActor extends BrokerActor {
             }, { noAck: false });
         }
     }
-    async disconnectImpl() {
+    async disconnectImplementation() {
         this.pendingAcks.clear();
         try {
             await this.channel?.close();
@@ -89,14 +91,22 @@ export class AmqpActor extends BrokerActor {
     async dispatchOutgoing(env) {
         if (!this.channel)
             throw new Error('AmqpActor: channel not open');
-        const p = env.payload;
-        const content = p.content instanceof Uint8Array
-            ? p.content
-            : new TextEncoder().encode(p.content);
-        const ok = this.channel.publish(p.exchange, p.routingKey, content, {
-            persistent: p.persistent ?? true,
-            headers: p.headers,
-            contentType: p.contentType,
+        const publish = env.payload;
+        // amqplib's channel.publish needs a Buffer specifically — a
+        // plain Uint8Array (which our public `AmqpPublish.content`
+        // contract accepts) trips internal buffer-length checks and
+        // makes the publish fail SILENTLY: amqplib emits a `channel
+        // close` event (caught by handleConnectionLost → reconnect),
+        // but never throws back from `publish()`.  We surface that
+        // here by coercing to Buffer; Buffer IS a Uint8Array subclass
+        // so the public contract still holds.
+        const content = typeof publish.content === 'string'
+            ? Buffer.from(publish.content)
+            : Buffer.isBuffer(publish.content) ? publish.content : Buffer.from(publish.content);
+        const ok = this.channel.publish(publish.exchange, publish.routingKey, content, {
+            persistent: publish.persistent ?? true,
+            headers: publish.headers,
+            contentType: publish.contentType,
         });
         if (!ok) {
             // Channel-side backpressure — the buffer in amqplib is full.

package/dist/io/broker/AmqpActor.js.map

@@ -1 +1 @@
-{"version":3,"file":"AmqpActor.js","sourceRoot":"","sources":["../../../src/io/broker/AmqpActor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAExD,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAyB,MAAM,kBAAkB,CAAC;AA6CtE;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,SAAU,SAAQ,WAAoD;IACzE,UAAU,GAA8B,IAAI,CAAC;IAC7C,OAAO,GAA2B,IAAI,CAAC;IAC/C,+FAA+F;IAC9E,WAAW,GAAG,IAAI,GAAG,EAA0B,CAAC;IACzD,YAAY,GAAG,CAAC,CAAC;IAEzB,YAAY,WAAuC,EAAE,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEjE,SAAS,KAAa,OAAO,UAAU,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IACzD,eAAe;QACvB,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACxC,CAAC;IACS,sBAAsB,CAAC,CAAS;QACxC,MAAM,GAAG,GAAwE,EAAE,CAAC;QACpF,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACnD,IAAI,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;YAAE,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC/D,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;YAAE,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAChE,OAAO,GAAG,CAAC;IACb,CAAC;IACS,gBAAgB,KAA6C,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9E,aAAa,KAAa,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI,WAAW,CAAC,CAAC,CAAC;IAEpE,KAAK,CAAC,WAAW;QACzB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,CAAC;QAClC,IAAI,CAAC,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAI,CAAC,CAAC;QACzD,IAAI,CAAC,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC;QACrD,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC;QACzD,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC;QACxE,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,oBAAoB,CAAC,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC;QAElG,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;YAC7C,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3D,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;gBACf,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;YACxE,CAAC;YACD,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;YACxB,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC;YAC1B,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE;gBAC5C,IAAI,CAAC,GAAG;oBAAE,OAAO;gBACjB,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;gBACrC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;oBAC1B,IAAI,CAAC;wBAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;oBAAC,CAAC;oBAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;gBACxD,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;gBACtC,CAAC;gBACD,MAAM,CAAC,IAAI,CAAC;oBACV,KAAK,EAAE,SAAS;oBAChB,OAAO,EAAE,GAAG,CAAC,OAAO;oBACpB,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,EAAE;oBAChC,QAAQ;iBACT,CAAC,CAAC;YACL,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAES,KAAK,CAAC,cAAc;QAC5B,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YAAC,MAAM,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QAC3D,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC;YAAC,MAAM,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QAC9D,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;IACzB,CAAC;IAES,KAAK,CAAC,gBAAgB,CAAC,GAAkC;QACjE,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAClE,MAAM,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC;QACtB,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,YAAY,UAAU;YAC7C,CAAC,CAAC,CAAC,CAAC,OAAO;YACX,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACxC,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,UAAU,EAAE,OAAO,EAAE;YACjE,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,IAAI;YAChC,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,WAAW,EAAE,CAAC,CAAC,WAAW;SAC3B,CAAC,CAAC;QACH,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,6DAA6D;YAC7D,sEAAsE;YACtE,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBAClC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;YAC/C,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAEQ,SAAS,CAAC,GAAY;QAC7B,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC3B,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAClC,OAAO;QACT,CAAC;QACD,IAAI,GAAG,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;YACvB,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACxD,IAAI,GAAG,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACxB,IAAI,CAAC;oBAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;gBACrD,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACjD,CAAC;YACD,OAAO;QACT,CAAC;QACD,OAAO;QACP,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACxD,IAAI,GAAG,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACxB,IAAI,CAAC;gBAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;YAClF,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;CACF;AAsCD,MAAM,QAAQ,GAAiC,IAAI,CAAC,EAAE,CACpD,GAAG,EAAE,CAAC,gBAAgB,CAAgB,SAAS,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAC3E,CAAC"}
+{"version":3,"file":"AmqpActor.js","sourceRoot":"","sources":["../../../src/io/broker/AmqpActor.ts"],"names":[],"mappings":"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"}

package/dist/io/broker/AmqpOptions.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Fluent builder for {@link AmqpOptionsType}.  Protocol-specific
+ * methods only; the common broker fields (`withReconnect` /
+ * `withCircuitBreaker` / `withOutboundBuffer`) come from
+ * {@link BrokerOptionsBuilder}.  `build()` snapshots the accumulated partial
+ * and feeds the same three-layer merge (constructor > HOCON under
+ * `actor-ts.io.broker.amqp` > built-in defaults).
+ */
+import { BrokerOptionsBuilder, BrokerOptionsValidator } from './BrokerOptions.js';
+import type { BrokerCommonOptionsType } from './BrokerOptions.js';
+import type { AmqpQueueBinding } from './AmqpActor.js';
+export interface AmqpOptionsType extends BrokerCommonOptionsType {
+    /** AMQP URL (`amqp://user:pass@host:5672/vhost`). */
+    readonly url?: string;
+    /** Number of unacked messages a consumer holds at once.  Default: 1. */
+    readonly prefetch?: number;
+    /** Queues + bindings + targets to set up after connect. */
+    readonly bindings?: ReadonlyArray<AmqpQueueBinding>;
+    /** Whether to auto-ack consumed deliveries.  Default: true. */
+    readonly autoAck?: boolean;
+}
+export declare class AmqpOptionsBuilder extends BrokerOptionsBuilder<AmqpOptionsType> {
+    /** Start a fresh builder.  Equivalent to `new AmqpOptionsBuilder()`. */
+    static create(): AmqpOptionsBuilder;
+    /** AMQP URL (`amqp://user:pass@host:5672/vhost`). */
+    withUrl(url: string): this;
+    /** Unacked messages a consumer holds at once.  Default 1. */
+    withPrefetch(count: number): this;
+    /** Queues + bindings + targets to set up after connect. */
+    withBindings(bindings: ReadonlyArray<AmqpQueueBinding>): this;
+    /** Auto-ack consumed deliveries.  Default `true`. */
+    withAutoAck(on?: boolean): this;
+}
+/** Validates resolved {@link AmqpOptionsType} settings. */
+export declare class AmqpOptionsValidator extends BrokerOptionsValidator<AmqpOptionsType> {
+    constructor();
+    protected rules(s: Partial<AmqpOptionsType>): void;
+}
+/**
+ * Accepted input for any AMQP-configurable constructor: the fluent
+ * {@link AmqpOptionsBuilder} OR a plain {@link AmqpOptionsType} object.
+ */
+export type AmqpOptions = AmqpOptionsBuilder | Partial<AmqpOptionsType>;
+/** Value alias so `AmqpOptions.create()` / `new AmqpOptions()` resolve to the builder. */
+export declare const AmqpOptions: typeof AmqpOptionsBuilder;
+//# sourceMappingURL=AmqpOptions.d.ts.map

package/dist/io/broker/AmqpOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AmqpOptions.d.ts","sourceRoot":"","sources":["../../../src/io/broker/AmqpOptions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,MAAM,WAAW,eAAgB,SAAQ,uBAAuB;IAC9D,qDAAqD;IACrD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;IACpD,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,qBAAa,kBAAmB,SAAQ,oBAAoB,CAAC,eAAe,CAAC;IAC3E,wEAAwE;IACxE,MAAM,CAAC,MAAM,IAAI,kBAAkB;IAInC,qDAAqD;IACrD,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI1B,6DAA6D;IAC7D,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIjC,2DAA2D;IAC3D,YAAY,CAAC,QAAQ,EAAE,aAAa,CAAC,gBAAgB,CAAC,GAAG,IAAI;IAI7D,qDAAqD;IACrD,WAAW,CAAC,EAAE,UAAO,GAAG,IAAI;CAG7B;AAED,2DAA2D;AAC3D,qBAAa,oBAAqB,SAAQ,sBAAsB,CAAC,eAAe,CAAC;;IAI/E,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;CAKnD;AAED;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;AACxE,0FAA0F;AAC1F,eAAO,MAAM,WAAW,2BAAqB,CAAC"}

package/dist/io/broker/AmqpOptions.js

@@ -0,0 +1,45 @@
+/**
+ * Fluent builder for {@link AmqpOptionsType}.  Protocol-specific
+ * methods only; the common broker fields (`withReconnect` /
+ * `withCircuitBreaker` / `withOutboundBuffer`) come from
+ * {@link BrokerOptionsBuilder}.  `build()` snapshots the accumulated partial
+ * and feeds the same three-layer merge (constructor > HOCON under
+ * `actor-ts.io.broker.amqp` > built-in defaults).
+ */
+import { BrokerOptionsBuilder, BrokerOptionsValidator } from './BrokerOptions.js';
+export class AmqpOptionsBuilder extends BrokerOptionsBuilder {
+    /** Start a fresh builder.  Equivalent to `new AmqpOptionsBuilder()`. */
+    static create() {
+        return new AmqpOptionsBuilder();
+    }
+    /** AMQP URL (`amqp://user:pass@host:5672/vhost`). */
+    withUrl(url) {
+        return this.set('url', url);
+    }
+    /** Unacked messages a consumer holds at once.  Default 1. */
+    withPrefetch(count) {
+        return this.set('prefetch', count);
+    }
+    /** Queues + bindings + targets to set up after connect. */
+    withBindings(bindings) {
+        return this.set('bindings', bindings);
+    }
+    /** Auto-ack consumed deliveries.  Default `true`. */
+    withAutoAck(on = true) {
+        return this.set('autoAck', on);
+    }
+}
+/** Validates resolved {@link AmqpOptionsType} settings. */
+export class AmqpOptionsValidator extends BrokerOptionsValidator {
+    constructor() {
+        super('AmqpOptions');
+    }
+    rules(s) {
+        this.commonRules(s);
+        this.url('url', ['amqp', 'amqps']);
+        this.nonNegativeInt('prefetch'); // 0 = unlimited (AMQP semantics)
+    }
+}
+/** Value alias so `AmqpOptions.create()` / `new AmqpOptions()` resolve to the builder. */
+export const AmqpOptions = AmqpOptionsBuilder;
+//# sourceMappingURL=AmqpOptions.js.map

package/dist/io/broker/AmqpOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AmqpOptions.js","sourceRoot":"","sources":["../../../src/io/broker/AmqpOptions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAelF,MAAM,OAAO,kBAAmB,SAAQ,oBAAqC;IAC3E,wEAAwE;IACxE,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,kBAAkB,EAAE,CAAC;IAClC,CAAC;IAED,qDAAqD;IACrD,OAAO,CAAC,GAAW;QACjB,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,6DAA6D;IAC7D,YAAY,CAAC,KAAa;QACxB,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IACrC,CAAC;IAED,2DAA2D;IAC3D,YAAY,CAAC,QAAyC;QACpD,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,qDAAqD;IACrD,WAAW,CAAC,EAAE,GAAG,IAAI;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IACjC,CAAC;CACF;AAED,2DAA2D;AAC3D,MAAM,OAAO,oBAAqB,SAAQ,sBAAuC;IAC/E;QACE,KAAK,CAAC,aAAa,CAAC,CAAC;IACvB,CAAC;IACS,KAAK,CAAC,CAA2B;QACzC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QACnC,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,iCAAiC;IACpE,CAAC;CACF;AAOD,0FAA0F;AAC1F,MAAM,CAAC,MAAM,WAAW,GAAG,kBAAkB,CAAC"}

package/dist/io/broker/BrokerActor.d.ts

@@ -1,7 +1,9 @@
 import { Actor } from '../../Actor.js';
 import type { ActorRef } from '../../ActorRef.js';
 import type { Config } from '../../config/Config.js';
-import { type BrokerCommonSettings } from './BrokerSettings.js';
+import type { OptionsBuilder } from '../../util/OptionsBuilder.js';
+import type { OptionsValidator } from '../../util/OptionsValidator.js';
+import { type BrokerCommonOptionsType } from './BrokerOptions.js';
 /**
  * Connection-lifecycle state machine.  Transitions are linear:
  *   disconnected → connecting → connected → disconnecting → disconnected
@@ -25,26 +27,26 @@ export interface OutboundEnvelope<P = unknown> {
 /**
  * Base class for actors that bridge external messaging systems
  * (MQTT, WebSocket, Kafka, …) into the actor system.  Subclasses
- * implement three protocol hooks (`connectImpl`, `disconnectImpl`,
+ * implement three protocol hooks (`connectImplementation`, `disconnectImplementation`,
  * `dispatchOutgoing`); the base class owns the lifecycle, reconnect-
  * backoff, outbound buffer, subscriber fan-out, and lifecycle-event
  * publishing.
  *
- * **Settings precedence (highest first):**
+ * **Options precedence (highest first):**
  *   1. Constructor argument (per-instance overrides).
  *   2. HOCON config under `configKey()` (system-wide defaults).
- *   3. Built-in defaults from `builtInDefaults()`.
+ *   3. Built-in defaults from `builtInDefaultOptions()`.
  *
- * Subclasses pass their constructor settings via `super(settings)` and
- * implement `configKey()`, `builtInDefaults()`, `readSettingsFromConfig()`,
- * and `requiredSettings()` so the base class can resolve and validate
- * the effective settings before `connectImpl()` runs.
+ * Subclasses pass their constructor options via `super(options)` and
+ * implement `configKey()`, `builtInDefaultOptions()`, `readOptionsFromConfig()`,
+ * and `requiredOptions()` so the base class can resolve and validate
+ * the effective options before `connectImplementation()` runs.
  */
-export declare abstract class BrokerActor<S extends BrokerCommonSettings, Cmd = unknown, P = unknown> extends Actor<Cmd> {
-    /** Constructor settings — partial; merged with HOCON + defaults in preStart. */
-    private readonly _ctorSettings;
-    /** Final, fully resolved settings.  `null` until preStart() ran. */
-    private _settings;
+export declare abstract class BrokerActor<S extends BrokerCommonOptionsType, Cmd = unknown, P = unknown> extends Actor<Cmd> {
+    /** Constructor options — partial; merged with HOCON + defaults in preStart. */
+    private readonly _ctorOptions;
+    /** Final, fully resolved options.  `null` until preStart() ran. */
+    private _options;
     private _state;
     private _outboundBuffer;
     /** topic → set of subscriber ActorRefs (deathwatched). */
@@ -56,17 +58,25 @@ export declare abstract class BrokerActor<S extends BrokerCommonSettings, Cmd =
     /** Circuit-breaker counters.  Zero-cost when no breaker is configured. */
     private _consecutiveFailures;
     private _breakerOpenUntil;
-    protected constructor(settings: Partial<S>);
-    /** Final resolved settings — only valid after `preStart`. */
-    protected get settings(): S;
+    protected constructor(options?: OptionsBuilder<S> | Partial<S>);
+    /** Final resolved options — only valid after `preStart`. */
+    protected get options(): S;
     /** Subclass: HOCON config path, e.g. `'actor-ts.io.broker.mqtt'`. */
     protected abstract configKey(): string;
     /** Subclass: defaults for everything not provided elsewhere. */
-    protected abstract builtInDefaults(): Partial<S>;
-    /** Subclass: parse a Config block into a partial settings object. */
-    protected abstract readSettingsFromConfig(config: Config): Partial<S>;
-    /** Subclass: list of fields that MUST be present in the resolved settings. */
-    protected abstract requiredSettings(): ReadonlyArray<keyof S>;
+    protected abstract builtInDefaultOptions(): Partial<S>;
+    /** Subclass: parse a Config block into a partial options object. */
+    protected abstract readOptionsFromConfig(config: Config): Partial<S>;
+    /** Subclass: list of fields that MUST be present in the resolved options. */
+    protected abstract requiredOptions(): ReadonlyArray<keyof S>;
+    /**
+     * Subclass: validator for the resolved settings, run once at `preStart`
+     * (after the required-field check).  Default: no value validation.  Return
+     * a `new XOptionsValidator()` to enforce field/cross-field rules on the
+     * merged settings, regardless of whether they came from the builder, a
+     * plain object, or HOCON.
+     */
+    protected optionsValidator(): OptionsValidator<S> | undefined;
     /** Subclass: human-readable label for the connection (used in events). */
     protected abstract endpointLabel(): string;
     /**
@@ -74,9 +84,9 @@ export declare abstract class BrokerActor<S extends BrokerCommonSettings, Cmd =
      * reconnect; throwing during steady-state operation is also fine
      * (the base class will start a reconnect cycle).
      */
-    protected abstract connectImpl(): Promise<void>;
+    protected abstract connectImplementation(): Promise<void>;
     /** Close it.  Best-effort — exceptions are logged and swallowed. */
-    protected abstract disconnectImpl(): Promise<void>;
+    protected abstract disconnectImplementation(): Promise<void>;
     /**
      * Send a single outbound envelope.  Only invoked when state is
      * `connected`.  Throwing here is treated as a connection failure
@@ -109,7 +119,7 @@ export declare abstract class BrokerActor<S extends BrokerCommonSettings, Cmd =
     protected get outboundBufferSize(): number;
     preStart(): Promise<void>;
     postStop(): Promise<void>;
-    private _resolveSettings;
+    private _resolveOptions;
     private _validateRequired;
     /** Begin (or restart after a disconnect) the connect cycle. */
     private _beginConnect;

package/dist/io/broker/BrokerActor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BrokerActor.d.ts","sourceRoot":"","sources":["../../../src/io/broker/BrokerActor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AASrD,OAAO,EAML,KAAK,oBAAoB,EAC1B,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,eAAe,CAAC;AAE5F;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,OAAO;IAC3C,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,2EAA2E;IAC3E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,8BAAsB,WAAW,CAAC,CAAC,SAAS,oBAAoB,EAAE,GAAG,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,CAC1F,SAAQ,KAAK,CAAC,GAAG,CAAC;IAClB,gFAAgF;IAChF,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAa;IAC3C,oEAAoE;IACpE,OAAO,CAAC,SAAS,CAAkB;IAEnC,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,eAAe,CAA6B;IAEpD,0DAA0D;IAC1D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6C;IAC1E,oDAAoD;IACpD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiD;IAE7E,uFAAuF;IACvF,OAAO,CAAC,iBAAiB,CAAK;IAE9B,0EAA0E;IAC1E,OAAO,CAAC,oBAAoB,CAAK;IACjC,OAAO,CAAC,iBAAiB,CAAK;IAE9B,SAAS,aAAa,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IAO1C,6DAA6D;IAC7D,SAAS,KAAK,QAAQ,IAAI,CAAC,CAK1B;IAED,qEAAqE;IACrE,SAAS,CAAC,QAAQ,CAAC,SAAS,IAAI,MAAM;IAEtC,gEAAgE;IAChE,SAAS,CAAC,QAAQ,CAAC,eAAe,IAAI,OAAO,CAAC,CAAC,CAAC;IAEhD,qEAAqE;IACrE,SAAS,CAAC,QAAQ,CAAC,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAErE,8EAA8E;IAC9E,SAAS,CAAC,QAAQ,CAAC,gBAAgB,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;IAE7D,0EAA0E;IAC1E,SAAS,CAAC,QAAQ,CAAC,aAAa,IAAI,MAAM;IAI1C;;;;OAIG;IACH,SAAS,CAAC,QAAQ,CAAC,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAE/C,oEAAoE;IACpE,SAAS,CAAC,QAAQ,CAAC,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAElD;;;;OAIG;IACH,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjF;;;;OAIG;IACH,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,IAAI;IAgBnE,2DAA2D;IAC3D,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,IAAI;IAgBrE,iEAAiE;IACjE,SAAS,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI;IAM1D,2EAA2E;IAC3E,SAAS,CAAC,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAMxD;;;;;;OAMG;IACH,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC,GAAG,OAAO;IAiC9C,oEAAoE;IACpE,SAAS,KAAK,eAAe,IAAI,eAAe,CAAwB;IAExE,uCAAuC;IACvC,SAAS,KAAK,kBAAkB,IAAI,MAAM,CAAwC;IAInE,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAMzB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAexC,OAAO,CAAC,gBAAgB;YAWV,iBAAiB;IAiB/B,+DAA+D;YACjD,aAAa;YAKb,WAAW;IAgCzB,4FAA4F;IAC5F,SAAS,CAAC,oBAAoB,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI;IASnD,OAAO,CAAC,gBAAgB;IAsBxB,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,yBAAyB,CAA6B;YAEhD,YAAY;YAcZ,YAAY;CAQ3B"}
+{"version":3,"file":"BrokerActor.d.ts","sourceRoot":"","sources":["../../../src/io/broker/BrokerActor.ts"],"names":[],"mappings":"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"}