actor-ts 0.10.0 → 0.11.0

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

@@ -1 +1 @@
-{"version":3,"file":"TcpSocketOptions.js","sourceRoot":"","sources":["../../../src/io/broker/TcpSocketOptions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAoB1D,MAAM,OAAO,uBAAwB,SAAQ,oBAA0C;IACrF,6EAA6E;IAC7E,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,uBAAuB,EAAE,CAAC;IACvC,CAAC;IAED,mBAAmB;IACnB,QAAQ,CAAC,IAAY;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,mBAAmB;IACnB,QAAQ,CAAC,IAAY;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,+DAA+D;IAC/D,WAAW,CAAC,OAAmB;QAC7B,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,+DAA+D;IAC/D,UAAU,CAAC,MAAyB;QAClC,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;CACF;AAOD,oGAAoG;AACpG,MAAM,CAAC,MAAM,gBAAgB,GAAG,uBAAuB,CAAC"}
+{"version":3,"file":"TcpSocketOptions.js","sourceRoot":"","sources":["../../../src/io/broker/TcpSocketOptions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAoBlF,MAAM,OAAO,uBAAwB,SAAQ,oBAA0C;IACrF,6EAA6E;IAC7E,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,uBAAuB,EAAE,CAAC;IACvC,CAAC;IAED,mBAAmB;IACnB,QAAQ,CAAC,IAAY;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,mBAAmB;IACnB,QAAQ,CAAC,IAAY;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,+DAA+D;IAC/D,WAAW,CAAC,OAAmB;QAC7B,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,+DAA+D;IAC/D,UAAU,CAAC,MAAyB;QAClC,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;CACF;AAED,gEAAgE;AAChE,MAAM,OAAO,yBAA0B,SAAQ,sBAA4C;IACzF;QACE,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAC5B,CAAC;IACS,KAAK,CAAC,EAAiC;QAC/C,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACrB,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAC5B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpB,CAAC;CACF;AAOD,oGAAoG;AACpG,MAAM,CAAC,MAAM,gBAAgB,GAAG,uBAAuB,CAAC"}

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

@@ -1,5 +1,6 @@
 import type { Config } from '../../config/Config.js';
 import { BrokerActor, type OutboundEnvelope } from './BrokerActor.js';
+import { UdpSocketOptionsValidator } from './UdpSocketOptions.js';
 import type { UdpSocketOptions, UdpSocketOptionsType } from './UdpSocketOptions.js';
 /** Inbound datagram delivered to the target actor. */
 export interface UdpDatagram {
@@ -13,7 +14,7 @@ export interface UdpOutbound {
     readonly host: string;
     readonly port: number;
 }
-export type UdpSocketCmd = {
+export type UdpSocketCommand = {
     readonly kind: 'send';
     readonly datagram: UdpOutbound;
 };
@@ -24,20 +25,21 @@ export type UdpSocketCmd = {
  * lifecycle events still apply (`BrokerConnected` fires once the
  * socket is bound).
  */
-export declare class UdpSocketActor extends BrokerActor<UdpSocketOptionsType, UdpSocketCmd, UdpOutbound> {
+export declare class UdpSocketActor extends BrokerActor<UdpSocketOptionsType, UdpSocketCommand, UdpOutbound> {
     private socket;
     private actualPort;
     constructor(options?: UdpSocketOptions);
     protected configKey(): string;
-    protected builtInDefaults(): Partial<UdpSocketOptionsType>;
-    protected readSettingsFromConfig(c: Config): Partial<UdpSocketOptionsType>;
-    protected requiredSettings(): ReadonlyArray<keyof UdpSocketOptionsType>;
+    protected builtInDefaultOptions(): Partial<UdpSocketOptionsType>;
+    protected readOptionsFromConfig(config: Config): Partial<UdpSocketOptionsType>;
+    protected requiredOptions(): ReadonlyArray<keyof UdpSocketOptionsType>;
+    protected optionsValidator(): UdpSocketOptionsValidator;
     protected endpointLabel(): string;
     /** OS-assigned port after `bind` (0 before, real number after). */
     get boundPort(): number;
-    protected connectImpl(): Promise<void>;
-    protected disconnectImpl(): Promise<void>;
+    protected connectImplementation(): Promise<void>;
+    protected disconnectImplementation(): Promise<void>;
     protected dispatchOutgoing(env: OutboundEnvelope<UdpOutbound>): Promise<void>;
-    onReceive(cmd: UdpSocketCmd): void;
+    onReceive(cmd: UdpSocketCommand): void;
 }
 //# sourceMappingURL=UdpSocketActor.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"UdpSocketActor.d.ts","sourceRoot":"","sources":["../../../src/io/broker/UdpSocketActor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAGrD,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAEpF,sDAAsD;AACtD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,iFAAiF;AACjF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,YAAY,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAA;CAAE,CAAC;AAErF;;;;;;GAMG;AACH,qBAAa,cACX,SAAQ,WAAW,CAAC,oBAAoB,EAAE,YAAY,EAAE,WAAW,CAAC;IACpE,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,UAAU,CAAK;gBAEX,OAAO,GAAE,gBAAqB;IAE1C,SAAS,CAAC,SAAS,IAAI,MAAM;IAC7B,SAAS,CAAC,eAAe,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAG1D,SAAS,CAAC,sBAAsB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAO1E,SAAS,CAAC,gBAAgB,IAAI,aAAa,CAAC,MAAM,oBAAoB,CAAC;IAGvE,SAAS,CAAC,aAAa,IAAI,MAAM;IAIjC,mEAAmE;IACnE,IAAI,SAAS,IAAI,MAAM,CAA4B;cAEnC,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;cA6B5B,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;cAY/B,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAY1E,SAAS,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI;CAG5C"}
+{"version":3,"file":"UdpSocketActor.d.ts","sourceRoot":"","sources":["../../../src/io/broker/UdpSocketActor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAGrD,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAEpF,sDAAsD;AACtD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,iFAAiF;AACjF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,gBAAgB,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAA;CAAE,CAAC;AAEzF;;;;;;GAMG;AACH,qBAAa,cACX,SAAQ,WAAW,CAAC,oBAAoB,EAAE,gBAAgB,EAAE,WAAW,CAAC;IACxE,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,UAAU,CAAK;gBAEX,OAAO,GAAE,gBAAqB;IAE1C,SAAS,CAAC,SAAS,IAAI,MAAM;IAC7B,SAAS,CAAC,qBAAqB,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAGhE,SAAS,CAAC,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAO9E,SAAS,CAAC,eAAe,IAAI,aAAa,CAAC,MAAM,oBAAoB,CAAC;cAGnD,gBAAgB,IAAI,yBAAyB;IAChE,SAAS,CAAC,aAAa,IAAI,MAAM;IAIjC,mEAAmE;IACnE,IAAI,SAAS,IAAI,MAAM,CAA4B;cAEnC,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;cA6BtC,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC;cAYzC,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAY1E,SAAS,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI;CAGhD"}

package/dist/io/broker/UdpSocketActor.js

@@ -1,6 +1,7 @@
 import { ConfigKeys } from '../../config/ConfigKeys.js';
 import { Lazy } from '../../util/Lazy.js';
 import { BrokerActor } from './BrokerActor.js';
+import { UdpSocketOptionsValidator } from './UdpSocketOptions.js';
 /**
  * UDP-socket actor.  Uses `node:dgram` (built-in everywhere).  No
  * connection lifecycle in the TCP sense; we treat "bound" as
@@ -13,30 +14,31 @@ export class UdpSocketActor extends BrokerActor {
     actualPort = 0;
     constructor(options = {}) { super(options); }
     configKey() { return ConfigKeys.io.broker.udp; }
-    builtInDefaults() {
+    builtInDefaultOptions() {
         return { bindHost: '0.0.0.0', bindPort: 0, type: 'udp4' };
     }
-    readSettingsFromConfig(c) {
+    readOptionsFromConfig(config) {
         const out = {};
-        if (c.hasPath('bindHost'))
-            out.bindHost = c.getString('bindHost');
-        if (c.hasPath('bindPort'))
-            out.bindPort = c.getInt('bindPort');
-        if (c.hasPath('type'))
-            out.type = c.getString('type');
+        if (config.hasPath('bindHost'))
+            out.bindHost = config.getString('bindHost');
+        if (config.hasPath('bindPort'))
+            out.bindPort = config.getInt('bindPort');
+        if (config.hasPath('type'))
+            out.type = config.getString('type');
         return out;
     }
-    requiredSettings() {
+    requiredOptions() {
         return ['target'];
     }
+    optionsValidator() { return new UdpSocketOptionsValidator(); }
     endpointLabel() {
-        return `${this.settings.type}://${this.settings.bindHost}:${this.actualPort || this.settings.bindPort}`;
+        return `${this.options.type}://${this.options.bindHost}:${this.actualPort || this.options.bindPort}`;
     }
     /** OS-assigned port after `bind` (0 before, real number after). */
     get boundPort() { return this.actualPort; }
-    async connectImpl() {
+    async connectImplementation() {
         const dgram = await dgramLazy.get();
-        const sock = dgram.createSocket(this.settings.type ?? 'udp4');
+        const sock = dgram.createSocket(this.options.type ?? 'udp4');
         return new Promise((resolve, reject) => {
             let done = false;
             sock.once('listening', () => {
@@ -48,7 +50,7 @@ export class UdpSocketActor extends BrokerActor {
                 const addr = sock.address();
                 this.actualPort = addr.port;
                 sock.on('message', (msg, rinfo) => {
-                    this.settings.target?.tell({
+                    this.options.target?.tell({
                         payload: msg, remoteHost: rinfo.address, remotePort: rinfo.port,
                     });
                 });
@@ -61,10 +63,10 @@ export class UdpSocketActor extends BrokerActor {
                 done = true;
                 reject(e);
             });
-            sock.bind(this.settings.bindPort ?? 0, this.settings.bindHost);
+            sock.bind(this.options.bindPort ?? 0, this.options.bindHost);
         });
     }
-    async disconnectImpl() {
+    async disconnectImplementation() {
         if (!this.socket)
             return;
         const sock = this.socket;

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

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

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

@@ -6,8 +6,8 @@
  * and feeds the same three-layer merge (constructor > HOCON under
  * `actor-ts.io.broker.udp` > built-in defaults).
  */
-import { BrokerOptionsBuilder } from './BrokerOptions.js';
-import type { BrokerCommonOptionsType } from './BrokerSettings.js';
+import { BrokerOptionsBuilder, BrokerOptionsValidator } from './BrokerOptions.js';
+import type { BrokerCommonOptionsType } from './BrokerOptions.js';
 import type { ActorRef } from '../../ActorRef.js';
 import type { UdpDatagram } from './UdpSocketActor.js';
 export interface UdpSocketOptionsType extends BrokerCommonOptionsType {
@@ -32,6 +32,11 @@ export declare class UdpSocketOptionsBuilder extends BrokerOptionsBuilder<UdpSoc
     /** Subscriber for inbound datagrams.  Required. */
     withTarget(target: ActorRef<UdpDatagram>): this;
 }
+/** Validates resolved {@link UdpSocketOptionsType} settings. */
+export declare class UdpSocketOptionsValidator extends BrokerOptionsValidator<UdpSocketOptionsType> {
+    constructor();
+    protected rules(s: Partial<UdpSocketOptionsType>): void;
+}
 /**
  * Accepted input for any UDP-socket-configurable constructor: the fluent
  * {@link UdpSocketOptionsBuilder} OR a plain {@link UdpSocketOptionsType} object.

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

@@ -1 +1 @@
-{"version":3,"file":"UdpSocketOptions.d.ts","sourceRoot":"","sources":["../../../src/io/broker/UdpSocketOptions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,WAAW,oBAAqB,SAAQ,uBAAuB;IACnE,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,mDAAmD;IACnD,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;CACzC;AAED,qBAAa,uBAAwB,SAAQ,oBAAoB,CAAC,oBAAoB,CAAC;IACrF,6EAA6E;IAC7E,MAAM,CAAC,MAAM,IAAI,uBAAuB;IAIxC,gDAAgD;IAChD,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIhC,mDAAmD;IACnD,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIhC,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIrC,mDAAmD;IACnD,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,IAAI;CAGhD;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,uBAAuB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;AACvF,oGAAoG;AACpG,eAAO,MAAM,gBAAgB,gCAA0B,CAAC"}
+{"version":3,"file":"UdpSocketOptions.d.ts","sourceRoot":"","sources":["../../../src/io/broker/UdpSocketOptions.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,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,WAAW,oBAAqB,SAAQ,uBAAuB;IACnE,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,mDAAmD;IACnD,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;CACzC;AAED,qBAAa,uBAAwB,SAAQ,oBAAoB,CAAC,oBAAoB,CAAC;IACrF,6EAA6E;IAC7E,MAAM,CAAC,MAAM,IAAI,uBAAuB;IAIxC,gDAAgD;IAChD,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIhC,mDAAmD;IACnD,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIhC,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIrC,mDAAmD;IACnD,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,IAAI;CAGhD;AAED,gEAAgE;AAChE,qBAAa,yBAA0B,SAAQ,sBAAsB,CAAC,oBAAoB,CAAC;;IAIzF,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,IAAI;CAWxD;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,uBAAuB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;AACvF,oGAAoG;AACpG,eAAO,MAAM,gBAAgB,gCAA0B,CAAC"}

package/dist/io/broker/UdpSocketOptions.js

@@ -6,7 +6,7 @@
  * and feeds the same three-layer merge (constructor > HOCON under
  * `actor-ts.io.broker.udp` > built-in defaults).
  */
-import { BrokerOptionsBuilder } from './BrokerOptions.js';
+import { BrokerOptionsBuilder, BrokerOptionsValidator } from './BrokerOptions.js';
 export class UdpSocketOptionsBuilder extends BrokerOptionsBuilder {
     /** Start a fresh builder.  Equivalent to `new UdpSocketOptionsBuilder()`. */
     static create() {
@@ -29,6 +29,21 @@ export class UdpSocketOptionsBuilder extends BrokerOptionsBuilder {
         return this.set('target', target);
     }
 }
+/** Validates resolved {@link UdpSocketOptionsType} settings. */
+export class UdpSocketOptionsValidator extends BrokerOptionsValidator {
+    constructor() {
+        super('UdpSocketOptions');
+    }
+    rules(s) {
+        this.commonRules(s);
+        this.oneOf('type', ['udp4', 'udp6']);
+        // bindPort allows 0 ("let the OS pick"), so port() (min 1) is too strict.
+        if (s.bindPort !== undefined &&
+            (!Number.isInteger(s.bindPort) || s.bindPort < 0 || s.bindPort > 65535)) {
+            this.fail('bindPort', 'must be an integer in [0, 65535]', s.bindPort);
+        }
+    }
+}
 /** Value alias so `UdpSocketOptions.create()` / `new UdpSocketOptions()` resolve to the builder. */
 export const UdpSocketOptions = UdpSocketOptionsBuilder;
 //# sourceMappingURL=UdpSocketOptions.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"UdpSocketOptions.js","sourceRoot":"","sources":["../../../src/io/broker/UdpSocketOptions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAgB1D,MAAM,OAAO,uBAAwB,SAAQ,oBAA0C;IACrF,6EAA6E;IAC7E,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,uBAAuB,EAAE,CAAC;IACvC,CAAC;IAED,gDAAgD;IAChD,YAAY,CAAC,IAAY;QACvB,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,mDAAmD;IACnD,YAAY,CAAC,IAAY;QACvB,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,mDAAmD;IACnD,QAAQ,CAAC,IAAqB;QAC5B,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,mDAAmD;IACnD,UAAU,CAAC,MAA6B;QACtC,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;CACF;AAOD,oGAAoG;AACpG,MAAM,CAAC,MAAM,gBAAgB,GAAG,uBAAuB,CAAC"}
+{"version":3,"file":"UdpSocketOptions.js","sourceRoot":"","sources":["../../../src/io/broker/UdpSocketOptions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAgBlF,MAAM,OAAO,uBAAwB,SAAQ,oBAA0C;IACrF,6EAA6E;IAC7E,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,uBAAuB,EAAE,CAAC;IACvC,CAAC;IAED,gDAAgD;IAChD,YAAY,CAAC,IAAY;QACvB,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,mDAAmD;IACnD,YAAY,CAAC,IAAY;QACvB,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,mDAAmD;IACnD,QAAQ,CAAC,IAAqB;QAC5B,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,mDAAmD;IACnD,UAAU,CAAC,MAA6B;QACtC,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;CACF;AAED,gEAAgE;AAChE,MAAM,OAAO,yBAA0B,SAAQ,sBAA4C;IACzF;QACE,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAC5B,CAAC;IACS,KAAK,CAAC,CAAgC;QAC9C,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QACrC,0EAA0E;QAC1E,IACE,CAAC,CAAC,QAAQ,KAAK,SAAS;YACxB,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,GAAG,KAAK,CAAC,EACvE,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,kCAAkC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;CACF;AAOD,oGAAoG;AACpG,MAAM,CAAC,MAAM,gBAAgB,GAAG,uBAAuB,CAAC"}

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

@@ -1,52 +1,52 @@
 export { BrokerActor, type ConnectionState, type OutboundEnvelope, } from './BrokerActor.js';
-export { type BrokerCommonOptionsType, BrokerSettingsError, DEFAULT_RECONNECT, DEFAULT_OUTBOUND_BUFFER, } from './BrokerSettings.js';
+export { type BrokerCommonOptionsType, BrokerOptionsError, DEFAULT_RECONNECT, DEFAULT_OUTBOUND_BUFFER, } from './BrokerOptions.js';
 export { BrokerConnected, BrokerDisconnected, BrokerReconnectAttempt, BrokerReconnectFailed, BrokerBufferOverflow, BrokerNotConnected, } from './BrokerEvents.js';
 export { TcpSocketActor } from './TcpSocketActor.js';
-export type { TcpSocketCmd, TcpFraming, TcpOutbound, } from './TcpSocketActor.js';
-export { TcpSocketOptions, TcpSocketOptionsBuilder } from './TcpSocketOptions.js';
+export type { TcpSocketCommand, TcpFraming, TcpOutbound, } from './TcpSocketActor.js';
+export { TcpSocketOptions, TcpSocketOptionsBuilder, TcpSocketOptionsValidator } from './TcpSocketOptions.js';
 export type { TcpSocketOptionsType } from './TcpSocketOptions.js';
 export { UdpSocketActor } from './UdpSocketActor.js';
-export type { UdpSocketCmd, UdpDatagram, UdpOutbound, } from './UdpSocketActor.js';
-export { UdpSocketOptions, UdpSocketOptionsBuilder } from './UdpSocketOptions.js';
+export type { UdpSocketCommand, UdpDatagram, UdpOutbound, } from './UdpSocketActor.js';
+export { UdpSocketOptions, UdpSocketOptionsBuilder, UdpSocketOptionsValidator } from './UdpSocketOptions.js';
 export type { UdpSocketOptionsType } from './UdpSocketOptions.js';
 export { MqttActor, matchesMqttPattern, buildPublishProperties } from './MqttActor.js';
 export type { MqttPublishOptions, MqttClientLike, MqttModuleLike, MqttInboundPacketLike, } from './MqttActor.js';
-export { MqttOptions, MqttOptionsBuilder } from './MqttOptions.js';
+export { MqttOptions, MqttOptionsBuilder, MqttOptionsValidator } from './MqttOptions.js';
 export type { MqttOptionsType, MqttCredentials } from './MqttOptions.js';
-export { MqttPayload, MqttInboundSignal, MqttConnectedSignal, MqttDisconnectedSignal, } from './MqttMessages.js';
-export type { MqttMessage, MqttPublish, MqttCmd, MqttQos, MqttUserProperties, MqttSignal, MqttActorMessage, MqttRef, } from './MqttMessages.js';
+export { MqttPayload } from './MqttMessages.js';
+export type { MqttMessage, MqttPublish, MqttCommand, MqttQos, MqttUserProperties, MqttInboundSignal, MqttConnectedSignal, MqttDisconnectedSignal, MqttSignal, MqttActorMessage, MqttRef, } from './MqttMessages.js';
 export { mqttJsonCodec, MqttDecodeError, MqttEncodeError } from './MqttCodec.js';
 export type { MqttCodec } from './MqttCodec.js';
 export { KafkaActor } from './KafkaActor.js';
-export type { KafkaCmd, KafkaRecord, KafkaPublish, } from './KafkaActor.js';
-export { KafkaOptions, KafkaOptionsBuilder } from './KafkaOptions.js';
+export type { KafkaCommand, KafkaRecord, KafkaPublish, } from './KafkaActor.js';
+export { KafkaOptions, KafkaOptionsBuilder, KafkaOptionsValidator } from './KafkaOptions.js';
 export type { KafkaOptionsType } from './KafkaOptions.js';
 export { AmqpActor } from './AmqpActor.js';
-export type { AmqpCmd, AmqpDelivery, AmqpPublish, AmqpQueueBinding, } from './AmqpActor.js';
-export { AmqpOptions, AmqpOptionsBuilder } from './AmqpOptions.js';
+export type { AmqpCommand, AmqpDelivery, AmqpPublish, AmqpQueueBinding, } from './AmqpActor.js';
+export { AmqpOptions, AmqpOptionsBuilder, AmqpOptionsValidator } from './AmqpOptions.js';
 export type { AmqpOptionsType } from './AmqpOptions.js';
 export { GrpcClientActor } from './GrpcClientActor.js';
-export type { GrpcClientCmd, GrpcInbound, GrpcCredentials, } from './GrpcClientActor.js';
-export { GrpcClientOptions, GrpcClientOptionsBuilder } from './GrpcClientOptions.js';
+export type { GrpcClientCommand, GrpcInbound, GrpcCredentials, } from './GrpcClientActor.js';
+export { GrpcClientOptions, GrpcClientOptionsBuilder, GrpcClientOptionsValidator } from './GrpcClientOptions.js';
 export type { GrpcClientOptionsType } from './GrpcClientOptions.js';
 export { GrpcServerActor } from './GrpcServerActor.js';
 export type { GrpcHandler, GrpcUnaryCall, GrpcServerStreamCall, GrpcBidiCall, } from './GrpcServerActor.js';
 export { GrpcServerOptions, GrpcServerOptionsBuilder } from './GrpcServerOptions.js';
 export type { GrpcServerOptionsType } from './GrpcServerOptions.js';
 export { NatsActor } from './NatsActor.js';
-export type { NatsCmd, NatsMessage, NatsPublish, } from './NatsActor.js';
-export { NatsOptions, NatsOptionsBuilder } from './NatsOptions.js';
+export type { NatsCommand, NatsMessage, NatsPublish, } from './NatsActor.js';
+export { NatsOptions, NatsOptionsBuilder, NatsOptionsValidator } from './NatsOptions.js';
 export type { NatsOptionsType } from './NatsOptions.js';
 export { JetStreamActor } from './JetStreamActor.js';
-export type { JetStreamCmd, JetStreamMessage, JetStreamPublish, JetStreamStreamConfig, JetStreamConsumerConfig, NatsConnectionLike, JetStreamClientLike, JetStreamSubscriptionLike, JetStreamMsgHandleLike, JetStreamMsgInfoLike, JetStreamManagerLike, } from './JetStreamActor.js';
-export { JetStreamOptions, JetStreamOptionsBuilder } from './JetStreamOptions.js';
+export type { JetStreamCommand, JetStreamMessage, JetStreamPublish, JetStreamStreamConfig, JetStreamConsumerConfig, NatsConnectionLike, JetStreamClientLike, JetStreamSubscriptionLike, JetStreamMsgHandleLike, JetStreamMsgInfoLike, JetStreamManagerLike, } from './JetStreamActor.js';
+export { JetStreamOptions, JetStreamOptionsBuilder, JetStreamOptionsValidator } from './JetStreamOptions.js';
 export type { JetStreamOptionsType } from './JetStreamOptions.js';
 export { RedisStreamsActor } from './RedisStreamsActor.js';
-export type { RedisStreamsCmd, RedisStreamEntry, RedisStreamPublish, } from './RedisStreamsActor.js';
-export { RedisStreamsOptions, RedisStreamsOptionsBuilder } from './RedisStreamsOptions.js';
+export type { RedisStreamsCommand, RedisStreamEntry, RedisStreamPublish, } from './RedisStreamsActor.js';
+export { RedisStreamsOptions, RedisStreamsOptionsBuilder, RedisStreamsOptionsValidator } from './RedisStreamsOptions.js';
 export type { RedisStreamsOptionsType } from './RedisStreamsOptions.js';
 export { SseActor } from './SseActor.js';
-export type { SseCmd, SseEvent, } from './SseActor.js';
-export { SseOptions, SseOptionsBuilder } from './SseOptions.js';
+export type { SseCommand, SseEvent, } from './SseActor.js';
+export { SseOptions, SseOptionsBuilder, SseOptionsValidator } from './SseOptions.js';
 export type { SseOptionsType } from './SseOptions.js';
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/io/broker/index.js

@@ -1,39 +1,39 @@
 // Base class + supporting types
 export { BrokerActor, } from './BrokerActor.js';
-export { BrokerSettingsError, DEFAULT_RECONNECT, DEFAULT_OUTBOUND_BUFFER, } from './BrokerSettings.js';
+export { BrokerOptionsError, DEFAULT_RECONNECT, DEFAULT_OUTBOUND_BUFFER, } from './BrokerOptions.js';
 export { BrokerConnected, BrokerDisconnected, BrokerReconnectAttempt, BrokerReconnectFailed, BrokerBufferOverflow, BrokerNotConnected, } from './BrokerEvents.js';
 // Phase 1 actors
 export { TcpSocketActor } from './TcpSocketActor.js';
-export { TcpSocketOptions, TcpSocketOptionsBuilder } from './TcpSocketOptions.js';
+export { TcpSocketOptions, TcpSocketOptionsBuilder, TcpSocketOptionsValidator } from './TcpSocketOptions.js';
 export { UdpSocketActor } from './UdpSocketActor.js';
-export { UdpSocketOptions, UdpSocketOptionsBuilder } from './UdpSocketOptions.js';
+export { UdpSocketOptions, UdpSocketOptionsBuilder, UdpSocketOptionsValidator } from './UdpSocketOptions.js';
 // Subclass-first typed MQTT actor.
 export { MqttActor, matchesMqttPattern, buildPublishProperties } from './MqttActor.js';
-export { MqttOptions, MqttOptionsBuilder } from './MqttOptions.js';
-// Message types, payload wrapper, and mailbox signals.
-export { MqttPayload, MqttInboundSignal, MqttConnectedSignal, MqttDisconnectedSignal, } from './MqttMessages.js';
+export { MqttOptions, MqttOptionsBuilder, MqttOptionsValidator } from './MqttOptions.js';
+// Message types, payload wrapper, and mailbox signals (kind-tagged).
+export { MqttPayload } from './MqttMessages.js';
 // Payload codec seam.
 export { mqttJsonCodec, MqttDecodeError, MqttEncodeError } from './MqttCodec.js';
-// NOTE: the client-side WebSocket actor now lives in `src/http/ws/`
-// as the typed `WebSocketClientActor`; the server side is the
+// NOTE: the client-side WebSocket actor now lives in `src/http/websocket/`
+// as the typed `WebsocketClientActor`; the server side is the
 // `websocket()` routing directive.  The old frame-level
-// `WebSocketActor` / `ServerWebSocketActor` were removed.
+// `WebsocketActor` / `ServerWebsocketActor` were removed.
 // Phase 2 actors — enterprise / RPC.
 export { KafkaActor } from './KafkaActor.js';
-export { KafkaOptions, KafkaOptionsBuilder } from './KafkaOptions.js';
+export { KafkaOptions, KafkaOptionsBuilder, KafkaOptionsValidator } from './KafkaOptions.js';
 export { AmqpActor } from './AmqpActor.js';
-export { AmqpOptions, AmqpOptionsBuilder } from './AmqpOptions.js';
+export { AmqpOptions, AmqpOptionsBuilder, AmqpOptionsValidator } from './AmqpOptions.js';
 export { GrpcClientActor } from './GrpcClientActor.js';
-export { GrpcClientOptions, GrpcClientOptionsBuilder } from './GrpcClientOptions.js';
+export { GrpcClientOptions, GrpcClientOptionsBuilder, GrpcClientOptionsValidator } from './GrpcClientOptions.js';
 export { GrpcServerActor } from './GrpcServerActor.js';
 export { GrpcServerOptions, GrpcServerOptionsBuilder } from './GrpcServerOptions.js';
 // Phase 3 actors — cloud-native / niche.
 export { NatsActor } from './NatsActor.js';
-export { NatsOptions, NatsOptionsBuilder } from './NatsOptions.js';
+export { NatsOptions, NatsOptionsBuilder, NatsOptionsValidator } from './NatsOptions.js';
 export { JetStreamActor } from './JetStreamActor.js';
-export { JetStreamOptions, JetStreamOptionsBuilder } from './JetStreamOptions.js';
+export { JetStreamOptions, JetStreamOptionsBuilder, JetStreamOptionsValidator } from './JetStreamOptions.js';
 export { RedisStreamsActor } from './RedisStreamsActor.js';
-export { RedisStreamsOptions, RedisStreamsOptionsBuilder } from './RedisStreamsOptions.js';
+export { RedisStreamsOptions, RedisStreamsOptionsBuilder, RedisStreamsOptionsValidator } from './RedisStreamsOptions.js';
 export { SseActor } from './SseActor.js';
-export { SseOptions, SseOptionsBuilder } from './SseOptions.js';
+export { SseOptions, SseOptionsBuilder, SseOptionsValidator } from './SseOptions.js';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/io/broker/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,OAAO,EACL,WAAW,GAGZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAEL,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,iBAAiB;AACjB,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAMrD,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAElF,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAMrD,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAElF,mCAAmC;AACnC,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAQvF,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEnE,uDAAuD;AACvD,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAW3B,sBAAsB;AACtB,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjF,oEAAoE;AACpE,8DAA8D;AAC9D,wDAAwD;AACxD,0DAA0D;AAE1D,qCAAqC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAM7C,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAEtE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAO3C,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEnE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAMvD,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAErF,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAOvD,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAGrF,yCAAyC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAM3C,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEnE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAerD,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAElF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAM3D,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAE3F,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAKzC,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/io/broker/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,OAAO,EACL,WAAW,GAGZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAEL,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,iBAAiB;AACjB,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAMrD,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAE7G,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAMrD,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAE7G,mCAAmC;AACnC,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAQvF,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAEzF,qEAAqE;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAchD,sBAAsB;AACtB,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjF,2EAA2E;AAC3E,8DAA8D;AAC9D,wDAAwD;AACxD,0DAA0D;AAE1D,qCAAqC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAM7C,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE7F,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAO3C,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAEzF,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAMvD,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAEjH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAOvD,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAGrF,yCAAyC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAM3C,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAEzF,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAerD,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAE7G,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAM3D,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAEzH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAKzC,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/mailbox/BoundedMailbox.d.ts

@@ -1,4 +1,5 @@
 import { Mailbox, type Envelope } from '../internal/Mailbox.js';
+import { type BoundedMailboxOptions } from './BoundedMailboxOptions.js';
 export type BoundedMailboxOverflow = 
 /** Drop the oldest message in the queue to make room for the new one. */
 'drop-head'
@@ -6,21 +7,6 @@ export type BoundedMailboxOverflow =
  | 'drop-new'
 /** Throw a MailboxFullError — caller can surface it. */
  | 'reject';
-export interface BoundedMailboxSettings {
-    readonly capacity: number;
-    readonly overflow?: BoundedMailboxOverflow;
-    /**
-     * Optional hook fired each time a message is dropped by the
-     * overflow policy.  Receives the policy that triggered the drop
-     * so the consumer can label metrics ("reason": "drop-head" /
-     * "drop-new").  Never fires for `reject` — that throws instead.
-     *
-     * Mailboxes constructed by `ActorCell`'s default factory wire
-     * this to the `actor_mailbox_dropped_total` Counter so operators
-     * can spot slow-consumer signals without code changes.
-     */
-    readonly onDrop?: (reason: 'drop-head' | 'drop-new') => void;
-}
 export declare class MailboxFullError extends Error {
     constructor(capacity: number);
 }
@@ -34,7 +20,7 @@ export declare class BoundedMailbox<T = unknown> extends Mailbox<T> {
     private readonly onDrop?;
     /** Number of messages dropped by the overflow policy — useful for metrics. */
     droppedCount: number;
-    constructor(settings: BoundedMailboxSettings);
+    constructor(options: BoundedMailboxOptions);
     enqueue(env: Envelope<T>): void;
 }
 //# sourceMappingURL=BoundedMailbox.d.ts.map

package/dist/mailbox/BoundedMailbox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BoundedMailbox.d.ts","sourceRoot":"","sources":["../../src/mailbox/BoundedMailbox.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEhE,MAAM,MAAM,sBAAsB;AAChC,yEAAyE;AACvE,WAAW;AACb,uCAAuC;GACrC,UAAU;AACZ,wDAAwD;GACtD,QAAQ,CAAC;AAEb,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAC3C;;;;;;;;;OASG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,GAAG,UAAU,KAAK,IAAI,CAAC;CAC9D;AAED,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,QAAQ,EAAE,MAAM;CAI7B;AAED;;;GAGG;AACH,qBAAa,cAAc,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,OAAO,CAAC,CAAC,CAAC;IACzD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAA6C;IACrE,8EAA8E;IAC9E,YAAY,SAAK;gBAEL,QAAQ,EAAE,sBAAsB;IAQnC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI;CAmBzC"}
+{"version":3,"file":"BoundedMailbox.d.ts","sourceRoot":"","sources":["../../src/mailbox/BoundedMailbox.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAkC,KAAK,qBAAqB,EAAkC,MAAM,4BAA4B,CAAC;AAExI,MAAM,MAAM,sBAAsB;AAChC,yEAAyE;AACvE,WAAW;AACb,uCAAuC;GACrC,UAAU;AACZ,wDAAwD;GACtD,QAAQ,CAAC;AAEb,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,QAAQ,EAAE,MAAM;CAI7B;AAED;;;GAGG;AACH,qBAAa,cAAc,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,OAAO,CAAC,CAAC,CAAC;IACzD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAA6C;IACrE,8EAA8E;IAC9E,YAAY,SAAK;gBAEL,OAAO,EAAE,qBAAqB;IASjC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI;CAmBzC"}

package/dist/mailbox/BoundedMailbox.js

@@ -1,5 +1,6 @@
 import { match } from 'ts-pattern';
 import { Mailbox } from '../internal/Mailbox.js';
+import { BoundedMailboxOptionsValidator } from './BoundedMailboxOptions.js';
 export class MailboxFullError extends Error {
     constructor(capacity) {
         super(`bounded mailbox full (capacity=${capacity})`);
@@ -16,10 +17,10 @@ export class BoundedMailbox extends Mailbox {
     onDrop;
     /** Number of messages dropped by the overflow policy — useful for metrics. */
     droppedCount = 0;
-    constructor(settings) {
+    constructor(options) {
         super();
-        if (settings.capacity < 1)
-            throw new Error('BoundedMailbox: capacity must be >= 1');
+        const settings = { ...options };
+        new BoundedMailboxOptionsValidator().validate(settings);
         this.capacity = settings.capacity;
         this.overflow = settings.overflow ?? 'reject';
         this.onDrop = settings.onDrop;

package/dist/mailbox/BoundedMailbox.js.map

@@ -1 +1 @@
-{"version":3,"file":"BoundedMailbox.js","sourceRoot":"","sources":["../../src/mailbox/BoundedMailbox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,OAAO,EAAiB,MAAM,wBAAwB,CAAC;AA0BhE,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC,YAAY,QAAgB;QAC1B,KAAK,CAAC,kCAAkC,QAAQ,GAAG,CAAC,CAAC;QACrD,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,cAA4B,SAAQ,OAAU;IACxC,QAAQ,CAAS;IACjB,QAAQ,CAAyB;IACjC,MAAM,CAA8C;IACrE,8EAA8E;IAC9E,YAAY,GAAG,CAAC,CAAC;IAEjB,YAAY,QAAgC;QAC1C,KAAK,EAAE,CAAC;QACR,IAAI,QAAQ,CAAC,QAAQ,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QACpF,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;QAClC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC;QAC9C,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;IAChC,CAAC;IAEQ,OAAO,CAAC,GAAgB;QAC/B,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC;iBACjB,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE;gBACtB,KAAK,CAAC,WAAW,EAAE,CAAC;gBACpB,IAAI,CAAC,YAAY,EAAE,CAAC;gBACpB,IAAI,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,CAAC;gBAC3B,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACrB,CAAC,CAAC;iBACD,IAAI,CAAC,UAAU,EAAE,GAAG,EAAE;gBACrB,IAAI,CAAC,YAAY,EAAE,CAAC;gBACpB,IAAI,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,CAAC;YAC5B,CAAC,CAAC;iBACD,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,MAAM,IAAI,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;iBACpE,UAAU,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;CACF"}
+{"version":3,"file":"BoundedMailbox.js","sourceRoot":"","sources":["../../src/mailbox/BoundedMailbox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,OAAO,EAAiB,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,8BAA8B,EAA8D,MAAM,4BAA4B,CAAC;AAUxI,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC,YAAY,QAAgB;QAC1B,KAAK,CAAC,kCAAkC,QAAQ,GAAG,CAAC,CAAC;QACrD,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,cAA4B,SAAQ,OAAU;IACxC,QAAQ,CAAS;IACjB,QAAQ,CAAyB;IACjC,MAAM,CAA8C;IACrE,8EAA8E;IAC9E,YAAY,GAAG,CAAC,CAAC;IAEjB,YAAY,OAA8B;QACxC,KAAK,EAAE,CAAC;QACR,MAAM,QAAQ,GAAG,EAAE,GAAI,OAA8C,EAAE,CAAC;QACxE,IAAI,8BAA8B,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACxD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,QAAS,CAAC;QACnC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC;QAC9C,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;IAChC,CAAC;IAEQ,OAAO,CAAC,GAAgB;QAC/B,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC;iBACjB,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE;gBACtB,KAAK,CAAC,WAAW,EAAE,CAAC;gBACpB,IAAI,CAAC,YAAY,EAAE,CAAC;gBACpB,IAAI,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,CAAC;gBAC3B,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACrB,CAAC,CAAC;iBACD,IAAI,CAAC,UAAU,EAAE,GAAG,EAAE;gBACrB,IAAI,CAAC,YAAY,EAAE,CAAC;gBACpB,IAAI,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,CAAC;YAC5B,CAAC,CAAC;iBACD,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,MAAM,IAAI,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;iBACpE,UAAU,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;CACF"}

package/dist/mailbox/BoundedMailboxOptions.d.ts

@@ -0,0 +1,49 @@
+import { OptionsBuilder } from '../util/OptionsBuilder.js';
+import { OptionsValidator } from '../util/OptionsValidator.js';
+import type { BoundedMailboxOverflow } from './BoundedMailbox.js';
+/** Plain options-object shape accepted by a {@link BoundedMailbox}. */
+export interface BoundedMailboxOptionsType {
+    readonly capacity: number;
+    readonly overflow?: BoundedMailboxOverflow;
+    /**
+     * Optional hook fired each time a message is dropped by the overflow
+     * policy.  Receives the policy that triggered the drop so the consumer
+     * can label metrics.  Never fires for `reject` — that throws instead.
+     */
+    readonly onDrop?: (reason: 'drop-head' | 'drop-new') => void;
+}
+/**
+ * Fluent builder for {@link BoundedMailboxOptionsType}:
+ *
+ *     new BoundedMailbox(BoundedMailboxOptions.create()
+ *       .withCapacity(1000)
+ *       .withOverflow('drop-head'));
+ */
+export declare class BoundedMailboxOptionsBuilder extends OptionsBuilder<BoundedMailboxOptionsType> {
+    /** Start a fresh builder. */
+    static create(): BoundedMailboxOptionsBuilder;
+    /** Maximum queued user messages.  Must be >= 1. */
+    withCapacity(capacity: number): this;
+    /** What to do when a message arrives on a full mailbox.  Default `reject`. */
+    withOverflow(overflow: BoundedMailboxOverflow): this;
+    /** Hook fired on each overflow drop (for metrics). */
+    withOnDrop(onDrop: (reason: 'drop-head' | 'drop-new') => void): this;
+}
+/**
+ * Validates resolved {@link BoundedMailboxOptionsType} settings.  `capacity`
+ * is required at runtime too — without it the "bounded" mailbox would
+ * silently be unbounded.
+ */
+export declare class BoundedMailboxOptionsValidator extends OptionsValidator<BoundedMailboxOptionsType> {
+    constructor();
+    protected rules(s: Partial<BoundedMailboxOptionsType>): void;
+}
+/**
+ * Accepted input for a {@link BoundedMailbox}: the fluent
+ * {@link BoundedMailboxOptionsBuilder} OR a plain
+ * {@link BoundedMailboxOptionsType} object.
+ */
+export type BoundedMailboxOptions = BoundedMailboxOptionsBuilder | Partial<BoundedMailboxOptionsType>;
+/** Value alias so `BoundedMailboxOptions.create()` / `new BoundedMailboxOptions()` resolve to the builder. */
+export declare const BoundedMailboxOptions: typeof BoundedMailboxOptionsBuilder;
+//# sourceMappingURL=BoundedMailboxOptions.d.ts.map

package/dist/mailbox/BoundedMailboxOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BoundedMailboxOptions.d.ts","sourceRoot":"","sources":["../../src/mailbox/BoundedMailboxOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE,uEAAuE;AACvE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAC3C;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,GAAG,UAAU,KAAK,IAAI,CAAC;CAC9D;AAED;;;;;;GAMG;AACH,qBAAa,4BAA6B,SAAQ,cAAc,CAAC,yBAAyB,CAAC;IACzF,6BAA6B;IAC7B,MAAM,CAAC,MAAM,IAAI,4BAA4B;IAI7C,mDAAmD;IACnD,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIpC,8EAA8E;IAC9E,YAAY,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI;IAIpD,sDAAsD;IACtD,UAAU,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,WAAW,GAAG,UAAU,KAAK,IAAI,GAAG,IAAI;CAGrE;AAED;;;;GAIG;AACH,qBAAa,8BAA+B,SAAQ,gBAAgB,CAAC,yBAAyB,CAAC;;IAI7F,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,yBAAyB,CAAC,GAAG,IAAI;CAK7D;AAED;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,4BAA4B,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;AACtG,8GAA8G;AAC9G,eAAO,MAAM,qBAAqB,qCAA+B,CAAC"}

package/dist/mailbox/BoundedMailboxOptions.js

@@ -0,0 +1,46 @@
+import { OptionsBuilder } from '../util/OptionsBuilder.js';
+import { OptionsValidator } from '../util/OptionsValidator.js';
+/**
+ * Fluent builder for {@link BoundedMailboxOptionsType}:
+ *
+ *     new BoundedMailbox(BoundedMailboxOptions.create()
+ *       .withCapacity(1000)
+ *       .withOverflow('drop-head'));
+ */
+export class BoundedMailboxOptionsBuilder extends OptionsBuilder {
+    /** Start a fresh builder. */
+    static create() {
+        return new BoundedMailboxOptionsBuilder();
+    }
+    /** Maximum queued user messages.  Must be >= 1. */
+    withCapacity(capacity) {
+        return this.set('capacity', capacity);
+    }
+    /** What to do when a message arrives on a full mailbox.  Default `reject`. */
+    withOverflow(overflow) {
+        return this.set('overflow', overflow);
+    }
+    /** Hook fired on each overflow drop (for metrics). */
+    withOnDrop(onDrop) {
+        return this.set('onDrop', onDrop);
+    }
+}
+/**
+ * Validates resolved {@link BoundedMailboxOptionsType} settings.  `capacity`
+ * is required at runtime too — without it the "bounded" mailbox would
+ * silently be unbounded.
+ */
+export class BoundedMailboxOptionsValidator extends OptionsValidator {
+    constructor() {
+        super('BoundedMailboxOptions');
+    }
+    rules(s) {
+        if (s.capacity === undefined)
+            this.fail('capacity', 'is required');
+        this.positiveInt('capacity');
+        this.oneOf('overflow', ['drop-head', 'drop-new', 'reject']);
+    }
+}
+/** Value alias so `BoundedMailboxOptions.create()` / `new BoundedMailboxOptions()` resolve to the builder. */
+export const BoundedMailboxOptions = BoundedMailboxOptionsBuilder;
+//# sourceMappingURL=BoundedMailboxOptions.js.map

package/dist/mailbox/BoundedMailboxOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BoundedMailboxOptions.js","sourceRoot":"","sources":["../../src/mailbox/BoundedMailboxOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAe/D;;;;;;GAMG;AACH,MAAM,OAAO,4BAA6B,SAAQ,cAAyC;IACzF,6BAA6B;IAC7B,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,4BAA4B,EAAE,CAAC;IAC5C,CAAC;IAED,mDAAmD;IACnD,YAAY,CAAC,QAAgB;QAC3B,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,8EAA8E;IAC9E,YAAY,CAAC,QAAgC;QAC3C,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,sDAAsD;IACtD,UAAU,CAAC,MAAkD;QAC3D,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,8BAA+B,SAAQ,gBAA2C;IAC7F;QACE,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACjC,CAAC;IACS,KAAK,CAAC,CAAqC;QACnD,IAAI,CAAC,CAAC,QAAQ,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;QACnE,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC9D,CAAC;CACF;AAQD,8GAA8G;AAC9G,MAAM,CAAC,MAAM,qBAAqB,GAAG,4BAA4B,CAAC"}

package/dist/mailbox/PriorityMailbox.d.ts

@@ -1,13 +1,11 @@
 import { Mailbox, type Envelope } from '../internal/Mailbox.js';
+import type { PriorityMailboxOptions } from './PriorityMailboxOptions.js';
 /**
  * Priority order for user messages.  Lower numeric priority values are
  * dequeued first — `0` is highest priority.  Ties are broken by FIFO
  * insertion order.
  */
 export type PriorityFunction<T> = (message: T) => number;
-export interface PriorityMailboxSettings<T> {
-    readonly priorityFor: PriorityFunction<T>;
-}
 /**
  * User messages are dequeued in priority order (ascending priority value,
  * then FIFO).  System messages still take strict precedence over any user
@@ -19,7 +17,7 @@ export declare class PriorityMailbox<T = unknown> extends Mailbox<T> {
     /** Monotonic counter — tie-breaker preserving FIFO among equal-priority messages. */
     private seq;
     private readonly ordered;
-    constructor(settings: PriorityMailboxSettings<T>);
+    constructor(options: PriorityMailboxOptions<T>);
     enqueue(env: Envelope<T>): void;
     dequeueUser(): Envelope<T> | undefined;
     get size(): number;