actor-ts 0.9.0 → 0.10.0

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

@@ -0,0 +1,46 @@
+/**
+ * Fluent builder for {@link TcpSocketOptionsType}.  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.tcp` > built-in defaults).
+ */
+import { BrokerOptionsBuilder } from './BrokerOptions.js';
+import type { BrokerCommonOptionsType } from './BrokerSettings.js';
+import type { ActorRef } from '../../ActorRef.js';
+import type { TcpFraming } from './TcpSocketActor.js';
+export interface TcpSocketOptionsType extends BrokerCommonOptionsType {
+    /** Remote host. */
+    readonly host?: string;
+    /** Remote port. */
+    readonly port?: number;
+    /** Frame extraction.  Default: `{ kind: 'bytes' }`. */
+    readonly framing?: TcpFraming;
+    /**
+     * Subscriber that receives every inbound frame.  Required — the actor
+     * has no useful behaviour without one.  Receives `Uint8Array` for
+     * `bytes` / `length-prefixed`, `string` for `lines`.
+     */
+    readonly target?: ActorRef<unknown>;
+}
+export declare class TcpSocketOptionsBuilder extends BrokerOptionsBuilder<TcpSocketOptionsType> {
+    /** Start a fresh builder.  Equivalent to `new TcpSocketOptionsBuilder()`. */
+    static create(): TcpSocketOptionsBuilder;
+    /** Remote host. */
+    withHost(host: string): this;
+    /** Remote port. */
+    withPort(port: number): this;
+    /** Frame extraction strategy.  Default `{ kind: 'bytes' }`. */
+    withFraming(framing: TcpFraming): this;
+    /** Subscriber that receives every inbound frame.  Required. */
+    withTarget(target: ActorRef<unknown>): this;
+}
+/**
+ * Accepted input for any TCP-socket-configurable constructor: the fluent
+ * {@link TcpSocketOptionsBuilder} OR a plain {@link TcpSocketOptionsType} object.
+ */
+export type TcpSocketOptions = TcpSocketOptionsBuilder | Partial<TcpSocketOptionsType>;
+/** Value alias so `TcpSocketOptions.create()` / `new TcpSocketOptions()` resolve to the builder. */
+export declare const TcpSocketOptions: typeof TcpSocketOptionsBuilder;
+//# sourceMappingURL=TcpSocketOptions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TcpSocketOptions.d.ts","sourceRoot":"","sources":["../../../src/io/broker/TcpSocketOptions.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,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,WAAW,oBAAqB,SAAQ,uBAAuB;IACnE,mBAAmB;IACnB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB;IACnB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,QAAQ,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;CACrC;AAED,qBAAa,uBAAwB,SAAQ,oBAAoB,CAAC,oBAAoB,CAAC;IACrF,6EAA6E;IAC7E,MAAM,CAAC,MAAM,IAAI,uBAAuB;IAIxC,mBAAmB;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI5B,mBAAmB;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI5B,+DAA+D;IAC/D,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI;IAItC,+DAA+D;IAC/D,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,IAAI;CAG5C;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/TcpSocketOptions.js

@@ -0,0 +1,34 @@
+/**
+ * Fluent builder for {@link TcpSocketOptionsType}.  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.tcp` > built-in defaults).
+ */
+import { BrokerOptionsBuilder } from './BrokerOptions.js';
+export class TcpSocketOptionsBuilder extends BrokerOptionsBuilder {
+    /** Start a fresh builder.  Equivalent to `new TcpSocketOptionsBuilder()`. */
+    static create() {
+        return new TcpSocketOptionsBuilder();
+    }
+    /** Remote host. */
+    withHost(host) {
+        return this.set('host', host);
+    }
+    /** Remote port. */
+    withPort(port) {
+        return this.set('port', port);
+    }
+    /** Frame extraction strategy.  Default `{ kind: 'bytes' }`. */
+    withFraming(framing) {
+        return this.set('framing', framing);
+    }
+    /** Subscriber that receives every inbound frame.  Required. */
+    withTarget(target) {
+        return this.set('target', target);
+    }
+}
+/** Value alias so `TcpSocketOptions.create()` / `new TcpSocketOptions()` resolve to the builder. */
+export const TcpSocketOptions = TcpSocketOptionsBuilder;
+//# sourceMappingURL=TcpSocketOptions.js.map

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

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

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

@@ -1,7 +1,6 @@
 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 type { UdpSocketOptions, UdpSocketOptionsType } from './UdpSocketOptions.js';
 /** Inbound datagram delivered to the target actor. */
 export interface UdpDatagram {
     readonly payload: Uint8Array;
@@ -14,16 +13,6 @@ export interface UdpOutbound {
     readonly host: string;
     readonly port: number;
 }
-export interface UdpSocketActorSettings extends BrokerCommonSettings {
-    /** Local bind address.  Default: `'0.0.0.0'`. */
-    readonly bindHost?: string;
-    /** Local port.  `0` (default) lets the OS pick. */
-    readonly bindPort?: number;
-    /** IPv4 (`'udp4'`) or IPv6 (`'udp6'`).  Default: `'udp4'`. */
-    readonly type?: 'udp4' | 'udp6';
-    /** Subscriber for inbound datagrams.  Required. */
-    readonly target?: ActorRef<UdpDatagram>;
-}
 export type UdpSocketCmd = {
     readonly kind: 'send';
     readonly datagram: UdpOutbound;
@@ -35,14 +24,14 @@ export type UdpSocketCmd = {
  * lifecycle events still apply (`BrokerConnected` fires once the
  * socket is bound).
  */
-export declare class UdpSocketActor extends BrokerActor<UdpSocketActorSettings, UdpSocketCmd, UdpOutbound> {
+export declare class UdpSocketActor extends BrokerActor<UdpSocketOptionsType, UdpSocketCmd, UdpOutbound> {
     private socket;
     private actualPort;
-    constructor(settings?: Partial<UdpSocketActorSettings>);
+    constructor(options?: UdpSocketOptions);
     protected configKey(): string;
-    protected builtInDefaults(): Partial<UdpSocketActorSettings>;
-    protected readSettingsFromConfig(c: Config): Partial<UdpSocketActorSettings>;
-    protected requiredSettings(): ReadonlyArray<keyof UdpSocketActorSettings>;
+    protected builtInDefaults(): Partial<UdpSocketOptionsType>;
+    protected readSettingsFromConfig(c: Config): Partial<UdpSocketOptionsType>;
+    protected requiredSettings(): ReadonlyArray<keyof UdpSocketOptionsType>;
     protected endpointLabel(): string;
     /** OS-assigned port after `bind` (0 before, real number after). */
     get boundPort(): number;

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;AAErD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,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,WAAW,sBAAuB,SAAQ,oBAAoB;IAClE,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,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,sBAAsB,EAAE,YAAY,EAAE,WAAW,CAAC;IACtE,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,UAAU,CAAK;gBAEX,QAAQ,GAAE,OAAO,CAAC,sBAAsB,CAAM;IAE1D,SAAS,CAAC,SAAS,IAAI,MAAM;IAC7B,SAAS,CAAC,eAAe,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAG5D,SAAS,CAAC,sBAAsB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAO5E,SAAS,CAAC,gBAAgB,IAAI,aAAa,CAAC,MAAM,sBAAsB,CAAC;IAGzE,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,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"}

package/dist/io/broker/UdpSocketActor.js

@@ -11,7 +11,7 @@ import { BrokerActor } from './BrokerActor.js';
 export class UdpSocketActor extends BrokerActor {
     socket = null;
     actualPort = 0;
-    constructor(settings = {}) { super(settings); }
+    constructor(options = {}) { super(options); }
     configKey() { return ConfigKeys.io.broker.udp; }
     builtInDefaults() {
         return { bindHost: '0.0.0.0', bindPort: 0, type: 'udp4' };

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

@@ -0,0 +1,42 @@
+/**
+ * Fluent builder for {@link UdpSocketOptionsType}.  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.udp` > built-in defaults).
+ */
+import { BrokerOptionsBuilder } from './BrokerOptions.js';
+import type { BrokerCommonOptionsType } from './BrokerSettings.js';
+import type { ActorRef } from '../../ActorRef.js';
+import type { UdpDatagram } from './UdpSocketActor.js';
+export interface UdpSocketOptionsType extends BrokerCommonOptionsType {
+    /** Local bind address.  Default: `'0.0.0.0'`. */
+    readonly bindHost?: string;
+    /** Local port.  `0` (default) lets the OS pick. */
+    readonly bindPort?: number;
+    /** IPv4 (`'udp4'`) or IPv6 (`'udp6'`).  Default: `'udp4'`. */
+    readonly type?: 'udp4' | 'udp6';
+    /** Subscriber for inbound datagrams.  Required. */
+    readonly target?: ActorRef<UdpDatagram>;
+}
+export declare class UdpSocketOptionsBuilder extends BrokerOptionsBuilder<UdpSocketOptionsType> {
+    /** Start a fresh builder.  Equivalent to `new UdpSocketOptionsBuilder()`. */
+    static create(): UdpSocketOptionsBuilder;
+    /** Local bind address.  Default `'0.0.0.0'`. */
+    withBindHost(host: string): this;
+    /** Local port.  `0` (default) lets the OS pick. */
+    withBindPort(port: number): this;
+    /** IPv4 (`'udp4'`, default) or IPv6 (`'udp6'`). */
+    withType(type: 'udp4' | 'udp6'): this;
+    /** Subscriber for inbound datagrams.  Required. */
+    withTarget(target: ActorRef<UdpDatagram>): this;
+}
+/**
+ * Accepted input for any UDP-socket-configurable constructor: the fluent
+ * {@link UdpSocketOptionsBuilder} OR a plain {@link UdpSocketOptionsType} object.
+ */
+export type UdpSocketOptions = UdpSocketOptionsBuilder | Partial<UdpSocketOptionsType>;
+/** Value alias so `UdpSocketOptions.create()` / `new UdpSocketOptions()` resolve to the builder. */
+export declare const UdpSocketOptions: typeof UdpSocketOptionsBuilder;
+//# sourceMappingURL=UdpSocketOptions.d.ts.map

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

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

package/dist/io/broker/UdpSocketOptions.js

@@ -0,0 +1,34 @@
+/**
+ * Fluent builder for {@link UdpSocketOptionsType}.  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.udp` > built-in defaults).
+ */
+import { BrokerOptionsBuilder } from './BrokerOptions.js';
+export class UdpSocketOptionsBuilder extends BrokerOptionsBuilder {
+    /** Start a fresh builder.  Equivalent to `new UdpSocketOptionsBuilder()`. */
+    static create() {
+        return new UdpSocketOptionsBuilder();
+    }
+    /** Local bind address.  Default `'0.0.0.0'`. */
+    withBindHost(host) {
+        return this.set('bindHost', host);
+    }
+    /** Local port.  `0` (default) lets the OS pick. */
+    withBindPort(port) {
+        return this.set('bindPort', port);
+    }
+    /** IPv4 (`'udp4'`, default) or IPv6 (`'udp6'`). */
+    withType(type) {
+        return this.set('type', type);
+    }
+    /** Subscriber for inbound datagrams.  Required. */
+    withTarget(target) {
+        return this.set('target', target);
+    }
+}
+/** 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

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

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

@@ -1,32 +1,52 @@
 export { BrokerActor, type ConnectionState, type OutboundEnvelope, } from './BrokerActor.js';
-export { type BrokerCommonSettings, BrokerSettingsError, DEFAULT_RECONNECT, DEFAULT_OUTBOUND_BUFFER, } from './BrokerSettings.js';
+export { type BrokerCommonOptionsType, BrokerSettingsError, DEFAULT_RECONNECT, DEFAULT_OUTBOUND_BUFFER, } from './BrokerSettings.js';
 export { BrokerConnected, BrokerDisconnected, BrokerReconnectAttempt, BrokerReconnectFailed, BrokerBufferOverflow, BrokerNotConnected, } from './BrokerEvents.js';
 export { TcpSocketActor } from './TcpSocketActor.js';
-export type { TcpSocketActorSettings, TcpSocketCmd, TcpFraming, TcpOutbound, } from './TcpSocketActor.js';
+export type { TcpSocketCmd, TcpFraming, TcpOutbound, } from './TcpSocketActor.js';
+export { TcpSocketOptions, TcpSocketOptionsBuilder } from './TcpSocketOptions.js';
+export type { TcpSocketOptionsType } from './TcpSocketOptions.js';
 export { UdpSocketActor } from './UdpSocketActor.js';
-export type { UdpSocketActorSettings, UdpSocketCmd, UdpDatagram, UdpOutbound, } from './UdpSocketActor.js';
-export { MqttActor, matchesMqttPattern } from './MqttActor.js';
-export type { MqttActorSettings, MqttCmd, MqttMessage, MqttPublish, MqttQos, MqttSubscription, MqttCredentials, } from './MqttActor.js';
-export { WebSocketActor } from './WebSocketActor.js';
-export type { WebSocketActorSettings, WebSocketCmd, WebSocketFrame, } from './WebSocketActor.js';
-export { ServerWebSocketActor } from './ServerWebSocketActor.js';
-export type { ServerWebSocketActorOptions, ServerWebSocketLike, } from './ServerWebSocketActor.js';
-export { serverWebSocketActorOf, bunWebSocketHandlers, } from './WebSocketServerAdapters.js';
-export type { BunServerWebSocketLike, BunWebSocketHandlerOptions, BunWebSocketSlot, } from './WebSocketServerAdapters.js';
+export type { UdpSocketCmd, UdpDatagram, UdpOutbound, } from './UdpSocketActor.js';
+export { UdpSocketOptions, UdpSocketOptionsBuilder } 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 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 { mqttJsonCodec, MqttDecodeError, MqttEncodeError } from './MqttCodec.js';
+export type { MqttCodec } from './MqttCodec.js';
 export { KafkaActor } from './KafkaActor.js';
-export type { KafkaActorSettings, KafkaCmd, KafkaRecord, KafkaPublish, } from './KafkaActor.js';
+export type { KafkaCmd, KafkaRecord, KafkaPublish, } from './KafkaActor.js';
+export { KafkaOptions, KafkaOptionsBuilder } from './KafkaOptions.js';
+export type { KafkaOptionsType } from './KafkaOptions.js';
 export { AmqpActor } from './AmqpActor.js';
-export type { AmqpActorSettings, AmqpCmd, AmqpDelivery, AmqpPublish, AmqpQueueBinding, } from './AmqpActor.js';
+export type { AmqpCmd, AmqpDelivery, AmqpPublish, AmqpQueueBinding, } from './AmqpActor.js';
+export { AmqpOptions, AmqpOptionsBuilder } from './AmqpOptions.js';
+export type { AmqpOptionsType } from './AmqpOptions.js';
 export { GrpcClientActor } from './GrpcClientActor.js';
-export type { GrpcClientActorSettings, GrpcClientCmd, GrpcInbound, GrpcCredentials, } from './GrpcClientActor.js';
+export type { GrpcClientCmd, GrpcInbound, GrpcCredentials, } from './GrpcClientActor.js';
+export { GrpcClientOptions, GrpcClientOptionsBuilder } from './GrpcClientOptions.js';
+export type { GrpcClientOptionsType } from './GrpcClientOptions.js';
 export { GrpcServerActor } from './GrpcServerActor.js';
-export type { GrpcServerSettings, GrpcHandler, GrpcUnaryCall, GrpcServerStreamCall, GrpcBidiCall, } 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 { NatsActorSettings, NatsCmd, NatsMessage, NatsPublish, } from './NatsActor.js';
+export type { NatsCmd, NatsMessage, NatsPublish, } from './NatsActor.js';
+export { NatsOptions, NatsOptionsBuilder } from './NatsOptions.js';
+export type { NatsOptionsType } from './NatsOptions.js';
 export { JetStreamActor } from './JetStreamActor.js';
-export type { JetStreamActorSettings, JetStreamCmd, JetStreamMessage, JetStreamPublish, JetStreamStreamConfig, JetStreamConsumerConfig, NatsConnectionLike, JetStreamClientLike, JetStreamSubscriptionLike, JetStreamMsgHandleLike, JetStreamMsgInfoLike, JetStreamManagerLike, } 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 { JetStreamOptionsType } from './JetStreamOptions.js';
 export { RedisStreamsActor } from './RedisStreamsActor.js';
-export type { RedisStreamsActorSettings, RedisStreamsCmd, RedisStreamEntry, RedisStreamPublish, } from './RedisStreamsActor.js';
+export type { RedisStreamsCmd, RedisStreamEntry, RedisStreamPublish, } from './RedisStreamsActor.js';
+export { RedisStreamsOptions, RedisStreamsOptionsBuilder } from './RedisStreamsOptions.js';
+export type { RedisStreamsOptionsType } from './RedisStreamsOptions.js';
 export { SseActor } from './SseActor.js';
-export type { SseActorSettings, SseCmd, SseEvent, } from './SseActor.js';
+export type { SseCmd, SseEvent, } from './SseActor.js';
+export { SseOptions, SseOptionsBuilder } 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

@@ -4,19 +4,36 @@ export { BrokerSettingsError, DEFAULT_RECONNECT, DEFAULT_OUTBOUND_BUFFER, } from
 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 { UdpSocketActor } from './UdpSocketActor.js';
-export { MqttActor, matchesMqttPattern } from './MqttActor.js';
-export { WebSocketActor } from './WebSocketActor.js';
-export { ServerWebSocketActor } from './ServerWebSocketActor.js';
-export { serverWebSocketActorOf, bunWebSocketHandlers, } from './WebSocketServerAdapters.js';
+export { UdpSocketOptions, UdpSocketOptionsBuilder } 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';
+// 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
+// `websocket()` routing directive.  The old frame-level
+// `WebSocketActor` / `ServerWebSocketActor` were removed.
 // Phase 2 actors — enterprise / RPC.
 export { KafkaActor } from './KafkaActor.js';
+export { KafkaOptions, KafkaOptionsBuilder } from './KafkaOptions.js';
 export { AmqpActor } from './AmqpActor.js';
+export { AmqpOptions, AmqpOptionsBuilder } from './AmqpOptions.js';
 export { GrpcClientActor } from './GrpcClientActor.js';
+export { GrpcClientOptions, GrpcClientOptionsBuilder } 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 { JetStreamActor } from './JetStreamActor.js';
+export { JetStreamOptions, JetStreamOptionsBuilder } from './JetStreamOptions.js';
 export { RedisStreamsActor } from './RedisStreamsActor.js';
+export { RedisStreamsOptions, RedisStreamsOptionsBuilder } from './RedisStreamsOptions.js';
 export { SseActor } from './SseActor.js';
+export { SseOptions, SseOptionsBuilder } 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;AAOrD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAOrD,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAU/D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAMrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAKjE,OAAO,EACL,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,8BAA8B,CAAC;AAOtC,qCAAqC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAO7C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAQ3C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAOvD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AASvD,yCAAyC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAO3C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAgBrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAO3D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,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,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"}

package/dist/mailbox/BoundedMailbox.d.ts

@@ -9,6 +9,17 @@ export type BoundedMailboxOverflow =
 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);
@@ -20,6 +31,7 @@ export declare class MailboxFullError extends Error {
 export declare class BoundedMailbox<T = unknown> extends Mailbox<T> {
     private readonly capacity;
     private readonly overflow;
+    private readonly onDrop?;
     /** Number of messages dropped by the overflow policy — useful for metrics. */
     droppedCount: number;
     constructor(settings: BoundedMailboxSettings);

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;CAC5C;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,8EAA8E;IAC9E,YAAY,SAAK;gBAEL,QAAQ,EAAE,sBAAsB;IAOnC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI;CAezC"}
+{"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"}

package/dist/mailbox/BoundedMailbox.js

@@ -13,6 +13,7 @@ export class MailboxFullError extends Error {
 export class BoundedMailbox extends Mailbox {
     capacity;
     overflow;
+    onDrop;
     /** Number of messages dropped by the overflow policy — useful for metrics. */
     droppedCount = 0;
     constructor(settings) {
@@ -21,6 +22,7 @@ export class BoundedMailbox extends Mailbox {
             throw new Error('BoundedMailbox: capacity must be >= 1');
         this.capacity = settings.capacity;
         this.overflow = settings.overflow ?? 'reject';
+        this.onDrop = settings.onDrop;
     }
     enqueue(env) {
         if (this.size >= this.capacity) {
@@ -28,9 +30,13 @@ export class BoundedMailbox extends Mailbox {
                 .with('drop-head', () => {
                 super.dequeueUser();
                 this.droppedCount++;
+                this.onDrop?.('drop-head');
                 super.enqueue(env);
             })
-                .with('drop-new', () => { this.droppedCount++; })
+                .with('drop-new', () => {
+                this.droppedCount++;
+                this.onDrop?.('drop-new');
+            })
                 .with('reject', () => { throw new MailboxFullError(this.capacity); })
                 .exhaustive();
             return;

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;AAehE,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;IAClD,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;IAChD,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,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACrB,CAAC,CAAC;iBACD,IAAI,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC;iBAChD,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;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"}

package/dist/management/HttpManagement.d.ts

@@ -1,6 +1,6 @@
 import type { ActorSystem } from '../ActorSystem.js';
 import type { Cluster } from '../cluster/Cluster.js';
-import { type Route } from '../http/index.js';
+import { type Middleware, type Route } from '../http/index.js';
 import type { HealthCheckResult } from './HealthCheck.js';
 import { HealthCheckRegistry } from './HealthCheck.js';
 export interface ManagementRoutesSettings {
@@ -19,6 +19,39 @@ export interface ManagementRoutesSettings {
      * because most deployments scrape metrics from a separate port.
      */
     readonly enableMetricsEndpoint?: boolean;
+    /**
+     * Optional authentication middleware applied to the privileged
+     * subset of management routes (#312).  When set, every privileged
+     * endpoint requires the auth — typically `BearerTokenAuth({...})`
+     * or a stack composed via nested `withMiddleware`.
+     *
+     * Privileged = `/cluster/leave`, `/cluster/down`.  The membership
+     * read-only routes (`/cluster/members`, `/cluster/leader`,
+     * `/cluster/shards`) are also covered.  Health-check probes
+     * (`/health`, `/ready`) are deliberately exempt — Kubernetes
+     * liveness/readiness probes cannot easily attach an
+     * Authorization header.
+     *
+     *     auth: BearerTokenAuth({ tokens: [process.env.MGMT_TOKEN!] })
+     */
+    readonly auth?: Middleware;
+    /**
+     * Optional IP-allowlist middleware applied to every management
+     * endpoint INCLUDING `/health` and `/ready` (#312).  Use this for
+     * network-level isolation: only allow probes from inside the
+     * cluster's pod CIDR or from the operator's bastion.
+     *
+     *     ipAllowlist: IpAllowlist({ allow: ['10.0.0.0/8', '127.0.0.1/32'] })
+     */
+    readonly ipAllowlist?: Middleware;
+    /**
+     * Set to true to apply the `auth` middleware to `/health` and
+     * `/ready` as well (#312).  Default: false — those endpoints are
+     * standard liveness/readiness probes and should answer anonymously.
+     * Flip this only when the deployment guarantees the probes can
+     * present credentials.
+     */
+    readonly authProtectHealth?: boolean;
 }
 /**
  * Build a Route tree exposing cluster-management HTTP endpoints.  The

package/dist/management/HttpManagement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HttpManagement.d.ts","sourceRoot":"","sources":["../../src/management/HttpManagement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAGrD,OAAO,EAQL,KAAK,KAAK,EACX,MAAM,kBAAkB,CAAC;AAG1B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,WAAW,wBAAwB;IACvC,mEAAmE;IACnE,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC;;;;;OAKG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IACtC;;;;OAIG;IACH,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;CAC1C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,OAAO,GAAG,IAAI,EACvB,QAAQ,GAAE,wBAA6B,GACtC;IAAE,MAAM,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,mBAAmB,CAAA;CAAE,CA+JhD;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAE/D"}
+{"version":3,"file":"HttpManagement.d.ts","sourceRoot":"","sources":["../../src/management/HttpManagement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAGrD,OAAO,EASL,KAAK,UAAU,EACf,KAAK,KAAK,EACX,MAAM,kBAAkB,CAAC;AAG1B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,WAAW,wBAAwB;IACvC,mEAAmE;IACnE,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC;;;;;OAKG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IACtC;;;;OAIG;IACH,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IACzC;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAC3B;;;;;;;OAOG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,UAAU,CAAC;IAClC;;;;;;OAMG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CACtC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,OAAO,GAAG,IAAI,EACvB,QAAQ,GAAE,wBAA6B,GACtC;IAAE,MAAM,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,mBAAmB,CAAA;CAAE,CA2LhD;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAE/D"}

package/dist/management/HttpManagement.js

@@ -1,5 +1,5 @@
 import { DistributedDataId } from '../crdt/DistributedData.js';
-import { complete, completeJson, concat, get, path, post, Status, } from '../http/index.js';
+import { complete, completeJson, concat, get, path, post, Status, withMiddleware, } from '../http/index.js';
 import { exportPrometheus } from '../metrics/PrometheusExporter.js';
 import { metricsOf } from '../metrics/MetricsExtension.js';
 import { HealthCheckRegistry } from './HealthCheck.js';
@@ -145,9 +145,35 @@ export function managementRoutes(system, cluster, settings = {}) {
             contentType: 'text/plain; version=0.0.4; charset=utf-8',
         }))
         : get(async () => complete(Status.NotFound, 'metrics endpoint disabled'));
-    const routes = path('cluster', concat(path('members', clusterMembers), path('leader', clusterLeader), path('shards', clusterShards), path('leave', leaveRoute), path('down', downRoute)));
-    // Compose with the top-level health endpoints.
-    const all = concat(routes, path('health', liveness), path('ready', readiness), path('metrics', metricsRoute));
+    let clusterSubtree = path('cluster', concat(path('members', clusterMembers), path('leader', clusterLeader), path('shards', clusterShards), path('leave', leaveRoute), path('down', downRoute)));
+    // Apply bearer-token (or similar) auth to the cluster subtree if
+    // configured.  Health/ready stay anonymous by default (Kubernetes
+    // probes can't attach credentials); `authProtectHealth: true`
+    // flips that for deployments where probes do present a token.
+    if (settings.auth) {
+        clusterSubtree = withMiddleware(settings.auth, clusterSubtree);
+    }
+    let healthSubtree = concat(path('health', liveness), path('ready', readiness));
+    if (settings.auth && settings.authProtectHealth === true) {
+        healthSubtree = withMiddleware(settings.auth, healthSubtree);
+    }
+    // Compose with the top-level health endpoints.  Metrics endpoint
+    // sits OUTSIDE the cluster subtree historically, so it gets the
+    // auth wrap only when explicitly configured (no policy distinction
+    // between metrics and cluster routes).
+    let metricsSubtree = path('metrics', metricsRoute);
+    if (settings.auth) {
+        metricsSubtree = withMiddleware(settings.auth, metricsSubtree);
+    }
+    let all = concat(clusterSubtree, healthSubtree, metricsSubtree);
+    // IP allowlist wraps EVERY management endpoint, including health/
+    // ready — network-level isolation is independent of who's allowed
+    // to authenticate.  Probes that should reach the endpoint despite
+    // the allowlist must come from an allowed network or the operator
+    // must override `getClientIp` to inspect a trusted header.
+    if (settings.ipAllowlist) {
+        all = withMiddleware(settings.ipAllowlist, all);
+    }
     // Suppress unused warning in case the caller doesn't use the system reference.
     void system;
     return { routes: all, health };