actor-ts 0.10.0 → 0.11.0

package/dist/io/broker/AmqpOptions.js

@@ -6,7 +6,7 @@
  * and feeds the same three-layer merge (constructor > HOCON under
  * `actor-ts.io.broker.amqp` > built-in defaults).
  */
-import { BrokerOptionsBuilder } from './BrokerOptions.js';
+import { BrokerOptionsBuilder, BrokerOptionsValidator } from './BrokerOptions.js';
 export class AmqpOptionsBuilder extends BrokerOptionsBuilder {
     /** Start a fresh builder.  Equivalent to `new AmqpOptionsBuilder()`. */
     static create() {
@@ -29,6 +29,17 @@ export class AmqpOptionsBuilder extends BrokerOptionsBuilder {
         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

@@ -1 +1 @@
-{"version":3,"file":"AmqpOptions.js","sourceRoot":"","sources":["../../../src/io/broker/AmqpOptions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAe1D,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;AAOD,0FAA0F;AAC1F,MAAM,CAAC,MAAM,WAAW,GAAG,kBAAkB,CAAC"}
+{"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

@@ -2,7 +2,8 @@ import { Actor } from '../../Actor.js';
 import type { ActorRef } from '../../ActorRef.js';
 import type { Config } from '../../config/Config.js';
 import type { OptionsBuilder } from '../../util/OptionsBuilder.js';
-import { type BrokerCommonOptionsType } from './BrokerSettings.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
@@ -26,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 BrokerCommonOptionsType, 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;
+    /** 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). */
@@ -58,16 +59,24 @@ export declare abstract class BrokerActor<S extends BrokerCommonOptionsType, Cmd
     private _consecutiveFailures;
     private _breakerOpenUntil;
     protected constructor(options?: OptionsBuilder<S> | Partial<S>);
-    /** Final resolved settings — only valid after `preStart`. */
-    protected get settings(): 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;
     /**
@@ -75,9 +84,9 @@ export declare abstract class BrokerActor<S extends BrokerCommonOptionsType, 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
@@ -110,7 +119,7 @@ export declare abstract class BrokerActor<S extends BrokerCommonOptionsType, 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;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AASnE,OAAO,EAML,KAAK,uBAAuB,EAC7B,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,uBAAuB,EAAE,GAAG,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,CAC7F,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,OAAO,GAAE,cAAc,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAM;IASlE,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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"}

package/dist/io/broker/BrokerActor.js

@@ -1,30 +1,30 @@
 import { match } from 'ts-pattern';
 import { Actor } from '../../Actor.js';
 import { BrokerBufferOverflow, BrokerConnected, BrokerDisconnected, BrokerNotConnected, BrokerReconnectAttempt, BrokerReconnectFailed, } from './BrokerEvents.js';
-import { BrokerSettingsError, DEFAULT_OUTBOUND_BUFFER, DEFAULT_RECONNECT, mergeSettings, readCommonSettings, } from './BrokerSettings.js';
+import { BrokerOptionsError, DEFAULT_OUTBOUND_BUFFER, DEFAULT_RECONNECT, mergeOptions, readCommonOptions, } from './BrokerOptions.js';
 /**
  * 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 class BrokerActor extends Actor {
-    /** Constructor settings — partial; merged with HOCON + defaults in preStart. */
-    _ctorSettings;
-    /** Final, fully resolved settings.  `null` until preStart() ran. */
-    _settings = null;
+    /** Constructor options — partial; merged with HOCON + defaults in preStart. */
+    _ctorOptions;
+    /** Final, fully resolved options.  `null` until preStart() ran. */
+    _options = null;
     _state = 'disconnected';
     _outboundBuffer = [];
     /** topic → set of subscriber ActorRefs (deathwatched). */
@@ -40,15 +40,25 @@ export class BrokerActor extends Actor {
         super();
         // A builder instance carries its set fields as own enumerable props, so
         // spreading normalizes builder OR plain object to a `Partial<S>` snapshot.
-        this._ctorSettings = { ...options };
+        this._ctorOptions = { ...options };
     }
-    /* ------------------------------- Settings ------------------------------- */
-    /** Final resolved settings — only valid after `preStart`. */
-    get settings() {
-        if (!this._settings) {
-            throw new Error(`BrokerActor.settings accessed before preStart`);
+    /* ------------------------------- Options ------------------------------- */
+    /** Final resolved options — only valid after `preStart`. */
+    get options() {
+        if (!this._options) {
+            throw new Error(`BrokerActor.options accessed before preStart`);
         }
-        return this._settings;
+        return this._options;
+    }
+    /**
+     * 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.
+     */
+    optionsValidator() {
+        return undefined;
     }
     /* ------------------------------- Subscribers ---------------------------- */
     /**
@@ -114,7 +124,7 @@ export class BrokerActor extends Actor {
      */
     enqueueOutbound(payload) {
         const env = { payload, enqueuedAt: Date.now() };
-        const limit = this.settings.outboundBuffer ?? DEFAULT_OUTBOUND_BUFFER;
+        const limit = this.options.outboundBuffer ?? DEFAULT_OUTBOUND_BUFFER;
         // Dispatch on connection state with compile-time exhaustiveness:
         // adding a new state to `ConnectionState` forces every site that
         // matches on it (including this one) to handle the new variant.
@@ -149,8 +159,11 @@ export class BrokerActor extends Actor {
     get outboundBufferSize() { return this._outboundBuffer.length; }
     /* ------------------------------- Lifecycle ------------------------------ */
     async preStart() {
-        this._settings = this._resolveSettings();
+        this._options = this._resolveOptions();
         await this._validateRequired();
+        // Value validation runs after the required-field check so a missing
+        // field still surfaces as BrokerSettingsError, not a rule failure.
+        this.optionsValidator()?.validate(this._options);
         await this._beginConnect();
     }
     async postStop() {
@@ -159,10 +172,10 @@ export class BrokerActor extends Actor {
         if (this._state !== 'disconnected') {
             this._state = 'disconnecting';
             try {
-                await this.disconnectImpl();
+                await this.disconnectImplementation();
             }
             catch (e) {
-                this.log.warn(`broker disconnectImpl threw: ${e.message}`);
+                this.log.warn(`broker disconnectImplementation threw: ${e.message}`);
             }
         }
         this._state = 'disconnected';
@@ -170,26 +183,26 @@ export class BrokerActor extends Actor {
         this._subscribers.clear();
     }
     /* ----------------------------- Internal flow ---------------------------- */
-    _resolveSettings() {
-        const defaults = this.builtInDefaults();
+    _resolveOptions() {
+        const defaults = this.builtInDefaultOptions();
         const cfg = this.system.config.hasPath(this.configKey())
             ? this.system.config.getConfig(this.configKey())
             : null;
         const fromConfig = cfg
-            ? { ...readCommonSettings(cfg), ...this.readSettingsFromConfig(cfg) }
+            ? { ...readCommonOptions(cfg), ...this.readOptionsFromConfig(cfg) }
             : {};
-        return mergeSettings(defaults, fromConfig, this._ctorSettings);
+        return mergeOptions(defaults, fromConfig, this._ctorOptions);
     }
     async _validateRequired() {
-        const required = this.requiredSettings();
+        const required = this.requiredOptions();
         const missing = [];
-        for (const k of required) {
-            if (this._settings[k] === undefined || this._settings[k] === null) {
-                missing.push(String(k));
+        for (const key of required) {
+            if (this._options[key] === undefined || this._options[key] === null) {
+                missing.push(String(key));
             }
         }
         if (missing.length > 0) {
-            throw new BrokerSettingsError(`${this.constructor.name} missing required settings: ${missing.join(', ')}.  `
+            throw new BrokerOptionsError(`${this.constructor.name} missing required options: ${missing.join(', ')}.  `
                 + `Pass them in the constructor or under HOCON path '${this.configKey()}'.`, this.configKey());
         }
     }
@@ -200,7 +213,7 @@ export class BrokerActor extends Actor {
     }
     async _tryConnect() {
         // Honour an open circuit breaker.
-        const breaker = this.settings.circuitBreaker;
+        const breaker = this.options.circuitBreaker;
         if (breaker && Date.now() < this._breakerOpenUntil) {
             const remaining = this._breakerOpenUntil - Date.now();
             this._scheduleReconnect(remaining);
@@ -208,7 +221,7 @@ export class BrokerActor extends Actor {
         }
         this._state = 'connecting';
         try {
-            await this.connectImpl();
+            await this.connectImplementation();
             this._state = 'connected';
             this._reconnectAttempt = 0;
             this._consecutiveFailures = 0;
@@ -236,7 +249,7 @@ export class BrokerActor extends Actor {
         this._handleReconnect(cause ?? new Error('connection lost'));
     }
     _handleReconnect(cause) {
-        const policy = this.settings.reconnect;
+        const policy = this.options.reconnect;
         if (policy === false)
             return;
         const initial = policy?.initialDelayMs ?? DEFAULT_RECONNECT.initialDelayMs;

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

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

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

@@ -1,18 +1,93 @@
 /**
- * Shared builder base for every broker options type.  Captures the
- * `BrokerCommonOptionsType` fields (reconnect / circuit-breaker / outbound
- * buffer) that all broker actors accept, so each concrete `<X>Options`
- * (e.g. {@link MqttOptions}) only declares its protocol-specific
- * methods.  This is the "übergeordnete Klasse für gemeinsame Use-Cases"
- * layer between {@link OptionsBuilder} and the concrete builders.
+ * Shared configuration for every broker actor: the common options type
+ * (reconnect / circuit-breaker / outbound buffer) that all broker actors
+ * accept, the read/merge helpers that resolve it, the error raised when a
+ * required option is missing, and the builder base that concrete
+ * `<X>Options` extend.
+ *
+ * The builder base is the "übergeordnete Klasse für gemeinsame Use-Cases"
+ * layer between {@link OptionsBuilder} and the concrete builders, so each
+ * concrete `<X>Options` (e.g. {@link MqttOptions}) only declares its
+ * protocol-specific methods.
  *
  * The `as keyof T` / `as T[keyof T]` casts are the price of writing these
  * setters once against the generic `T extends BrokerCommonOptionsType`;
  * they are confined to this file — concrete subclasses stay fully
  * type-safe because their own methods target concrete field types.
  */
+import type { Config } from '../../config/Config.js';
 import { OptionsBuilder } from '../../util/OptionsBuilder.js';
-import type { BrokerCommonOptionsType } from './BrokerSettings.js';
+import { OptionsValidator } from '../../util/OptionsValidator.js';
+/**
+ * Common options every broker actor accepts on top of its protocol-
+ * specific options.  Subclasses extend this interface with their own
+ * required fields (e.g. `brokerUrl`, `topics`).
+ */
+export interface BrokerCommonOptionsType {
+    /**
+     * Reconnect strategy applied when the underlying connection drops or
+     * `connectImplementation` throws.  Default: exponential backoff starting at
+     * `200ms`, doubling, capped at `30s`, infinite attempts.  Set to
+     * `false` to disable auto-reconnect (one-shot connections).
+     */
+    readonly reconnect?: false | {
+        readonly initialDelayMs?: number;
+        readonly maxDelayMs?: number;
+        readonly factor?: number;
+        /** Cap on retry attempts.  Default: `Infinity` (retry forever). */
+        readonly maxAttempts?: number;
+    };
+    /**
+     * Optional circuit-breaker around `connectImplementation`.  After
+     * `failureThreshold` consecutive failed connect attempts the breaker
+     * opens for `resetMs` and rejects new attempts immediately.
+     */
+    readonly circuitBreaker?: {
+        readonly failureThreshold: number;
+        readonly resetMs: number;
+    };
+    /**
+     * Maximum number of outbound messages buffered while the connection
+     * is `connecting` or `disconnected`.  When the buffer is full the
+     * oldest message is dropped (FIFO eviction) and a
+     * `BrokerBufferOverflow` event is published.  Default: `1000`.  Set
+     * to `0` to fail-fast (publish a `BrokerNotConnected` event and drop
+     * the message).
+     */
+    readonly outboundBuffer?: number;
+}
+export declare const DEFAULT_RECONNECT: {
+    readonly initialDelayMs: 200;
+    readonly maxDelayMs: 30000;
+    readonly factor: 2;
+    readonly maxAttempts: number;
+};
+export declare const DEFAULT_OUTBOUND_BUFFER = 1000;
+/**
+ * Read the common reconnect / circuit-breaker / buffer fields from a
+ * Config block.  Subclass-specific fields are read by the subclass'
+ * own `readOptionsFromConfig()` method.
+ *
+ * Note: to *disable* reconnect via HOCON, set the leaf
+ * `reconnect.maxAttempts = 1` (one connect attempt, no retry).  The
+ * boolean `false` form is only supported via the constructor argument.
+ */
+export declare function readCommonOptions(config: Config): BrokerCommonOptionsType;
+/**
+ * Merge options in the documented precedence order:
+ *   1. constructor args  (highest)
+ *   2. HOCON config under `configKey`
+ *   3. built-in defaults  (lowest)
+ *
+ * Falsy / undefined values from a higher layer don't shadow lower
+ * layers — `undefined` means "not set", not "explicitly clear".
+ */
+export declare function mergeOptions<S extends object>(builtInDefaultOptions: Partial<S>, fromConfig: Partial<S>, fromConstructor: Partial<S>): S;
+/** Raised when required options are missing from every layer. */
+export declare class BrokerOptionsError extends Error {
+    readonly configKey: string;
+    constructor(message: string, configKey: string);
+}
 export declare abstract class BrokerOptionsBuilder<T extends BrokerCommonOptionsType> extends OptionsBuilder<T> {
     /** Reconnect policy (or `false` to disable auto-reconnect). */
     withReconnect(policy: BrokerCommonOptionsType['reconnect']): this;
@@ -21,4 +96,30 @@ export declare abstract class BrokerOptionsBuilder<T extends BrokerCommonOptions
     /** Outbound buffer size (messages held while disconnected).  Default 1000; 0 = fail-fast. */
     withOutboundBuffer(limit: number): this;
 }
+/**
+ * Shared validator base for every broker options type — the counterpart to
+ * {@link BrokerOptionsBuilder}.  Concrete broker validators call
+ * {@link commonRules} at the top of their own `rules()` to cover the
+ * reconnect / circuit-breaker / outbound-buffer fields, then add their
+ * protocol-specific checks.
+ *
+ * The common fields include nested objects (`reconnect`, `circuitBreaker`)
+ * whose leaves are not top-level settings, so they are checked imperatively
+ * against the known `BrokerCommonOptionsType` shape rather than via the
+ * field-name helpers (which only address top-level keys).
+ */
+export declare abstract class BrokerOptionsValidator<T extends BrokerCommonOptionsType> extends OptionsValidator<T> {
+    protected commonRules(s: Partial<T>): void;
+    /**
+     * Positive-finite check for a nested or union-typed numeric leaf that the
+     * field-name helpers can't address (e.g. `circuitBreaker.resetMs`,
+     * `consumer.commitTimeoutMs`).  No-op if unset.
+     */
+    protected nestedPositive(field: string, v: number | undefined): void;
+    /**
+     * Non-empty check for a `string | string[]` field (Kafka `brokers`, NATS
+     * `servers`) — a union the typed helpers can't address.  No-op if unset.
+     */
+    protected nonEmptyStringOrArray(field: string, v: string | ReadonlyArray<string> | undefined): void;
+}
 //# sourceMappingURL=BrokerOptions.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"BrokerOptions.d.ts","sourceRoot":"","sources":["../../../src/io/broker/BrokerOptions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAEnE,8BAAsB,oBAAoB,CAAC,CAAC,SAAS,uBAAuB,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAC;IACrG,+DAA+D;IAC/D,aAAa,CAAC,MAAM,EAAE,uBAAuB,CAAC,WAAW,CAAC,GAAG,IAAI;IAIjE,+CAA+C;IAC/C,kBAAkB,CAAC,gBAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAInE,6FAA6F;IAC7F,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAGxC"}
+{"version":3,"file":"BrokerOptions.d.ts","sourceRoot":"","sources":["../../../src/io/broker/BrokerOptions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAElE;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,GAAG;QAC3B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;QACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QACzB,mEAAmE;QACnE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;KAC/B,CAAC;IAEF;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE;QACxB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;QAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;KAC1B,CAAC;IAEF;;;;;;;OAOG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,eAAO,MAAM,iBAAiB;;;;;CAKpB,CAAC;AAEX,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAE5C;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,uBAAuB,CA0BzE;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAC3C,qBAAqB,EAAE,OAAO,CAAC,CAAC,CAAC,EACjC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,EACtB,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC,GAC1B,CAAC,CAMH;AAUD,iEAAiE;AACjE,qBAAa,kBAAmB,SAAQ,KAAK;aACE,SAAS,EAAE,MAAM;gBAAlD,OAAO,EAAE,MAAM,EAAkB,SAAS,EAAE,MAAM;CAI/D;AAED,8BAAsB,oBAAoB,CAAC,CAAC,SAAS,uBAAuB,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAC;IACrG,+DAA+D;IAC/D,aAAa,CAAC,MAAM,EAAE,uBAAuB,CAAC,WAAW,CAAC,GAAG,IAAI;IAIjE,+CAA+C;IAC/C,kBAAkB,CAAC,gBAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAInE,6FAA6F;IAC7F,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAGxC;AAED;;;;;;;;;;;GAWG;AACH,8BAAsB,sBAAsB,CAAC,CAAC,SAAS,uBAAuB,CAAE,SAAQ,gBAAgB,CAAC,CAAC,CAAC;IACzG,SAAS,CAAC,WAAW,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAmC1C;;;;OAIG;IACH,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAMpE;;;OAGG;IACH,SAAS,CAAC,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,SAAS,GAAG,IAAI;CAKpG"}