actor-ts 0.9.1 → 0.11.0

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, 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 { TcpSocketActorSettings, TcpSocketCmd, TcpFraming, TcpOutbound, } from './TcpSocketActor.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 { 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 { 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, MqttOptionsValidator } from './MqttOptions.js';
+export type { MqttOptionsType, MqttCredentials } from './MqttOptions.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 { KafkaActorSettings, KafkaCmd, KafkaRecord, KafkaPublish, } from './KafkaActor.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 { AmqpActorSettings, AmqpCmd, AmqpDelivery, AmqpPublish, AmqpQueueBinding, } from './AmqpActor.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 { GrpcClientActorSettings, GrpcClientCmd, GrpcInbound, GrpcCredentials, } from './GrpcClientActor.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 { 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 { 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 { JetStreamActorSettings, JetStreamCmd, JetStreamMessage, JetStreamPublish, JetStreamStreamConfig, JetStreamConsumerConfig, NatsConnectionLike, JetStreamClientLike, JetStreamSubscriptionLike, JetStreamMsgHandleLike, JetStreamMsgInfoLike, JetStreamManagerLike, } from './JetStreamActor.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 { RedisStreamsActorSettings, RedisStreamsCmd, RedisStreamEntry, RedisStreamPublish, } from './RedisStreamsActor.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 { SseActorSettings, SseCmd, SseEvent, } from './SseActor.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,22 +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, TcpSocketOptionsValidator } 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, UdpSocketOptionsValidator } from './UdpSocketOptions.js';
+// Subclass-first typed MQTT actor.
+export { MqttActor, matchesMqttPattern, buildPublishProperties } from './MqttActor.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/websocket/`
+// 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, KafkaOptionsValidator } from './KafkaOptions.js';
 export { AmqpActor } from './AmqpActor.js';
+export { AmqpOptions, AmqpOptionsBuilder, AmqpOptionsValidator } from './AmqpOptions.js';
 export { GrpcClientActor } from './GrpcClientActor.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, NatsOptionsValidator } from './NatsOptions.js';
 export { JetStreamActor } from './JetStreamActor.js';
+export { JetStreamOptions, JetStreamOptionsBuilder, JetStreamOptionsValidator } from './JetStreamOptions.js';
 export { RedisStreamsActor } from './RedisStreamsActor.js';
+export { RedisStreamsOptions, RedisStreamsOptionsBuilder, RedisStreamsOptionsValidator } from './RedisStreamsOptions.js';
 export { SseActor } from './SseActor.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;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,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,10 +7,6 @@ export type BoundedMailboxOverflow =
  | 'drop-new'
 /** Throw a MailboxFullError — caller can surface it. */
  | 'reject';
-export interface BoundedMailboxSettings {
-    readonly capacity: number;
-    readonly overflow?: BoundedMailboxOverflow;
-}
 export declare class MailboxFullError extends Error {
     constructor(capacity: number);
 }
@@ -20,9 +17,10 @@ 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);
+    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;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;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})`);
@@ -13,14 +14,16 @@ 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) {
+    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;
     }
     enqueue(env) {
         if (this.size >= this.capacity) {
@@ -28,9 +31,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;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;

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

@@ -1 +1 @@
-{"version":3,"file":"PriorityMailbox.d.ts","sourceRoot":"","sources":["../../src/mailbox/PriorityMailbox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEhE;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,MAAM,CAAC;AAEzD,MAAM,WAAW,uBAAuB,CAAC,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;CAC3C;AAED;;;;;GAKG;AACH,qBAAa,eAAe,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,OAAO,CAAC,CAAC,CAAC;IAC1D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsB;IAClD,qFAAqF;IACrF,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkE;gBAE9E,QAAQ,EAAE,uBAAuB,CAAC,CAAC,CAAC;IAKvC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI;IAkB/B,WAAW,IAAI,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS;IAK/C,IAAa,IAAI,IAAI,MAAM,CAAgC;IAElD,eAAe,IAAI,OAAO;IAE1B,SAAS,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE;IAM1B,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAMpD,4EAA4E;IACnE,WAAW,IAAI,OAAO;CAGhC"}
+{"version":3,"file":"PriorityMailbox.d.ts","sourceRoot":"","sources":["../../src/mailbox/PriorityMailbox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,sBAAsB,EAA8B,MAAM,6BAA6B,CAAC;AAEtG;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,MAAM,CAAC;AAEzD;;;;;GAKG;AACH,qBAAa,eAAe,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,OAAO,CAAC,CAAC,CAAC;IAC1D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsB;IAClD,qFAAqF;IACrF,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkE;gBAE9E,OAAO,EAAE,sBAAsB,CAAC,CAAC,CAAC;IAKrC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI;IAkB/B,WAAW,IAAI,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS;IAK/C,IAAa,IAAI,IAAI,MAAM,CAAgC;IAElD,eAAe,IAAI,OAAO;IAE1B,SAAS,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE;IAM1B,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAMpD,4EAA4E;IACnE,WAAW,IAAI,OAAO;CAGhC"}

package/dist/mailbox/PriorityMailbox.js

@@ -10,9 +10,9 @@ export class PriorityMailbox extends Mailbox {
     /** Monotonic counter — tie-breaker preserving FIFO among equal-priority messages. */
     seq = 0;
     ordered = [];
-    constructor(settings) {
+    constructor(options) {
         super();
-        this.priorityFor = settings.priorityFor;
+        this.priorityFor = options.priorityFor;
     }
     enqueue(env) {
         const priority = this.priorityFor(env.message);
@@ -47,8 +47,8 @@ export class PriorityMailbox extends Mailbox {
     prependUser(envs) {
         // Reinsert via enqueue — priority is re-computed, which is the correct
         // behaviour (unstashed messages rejoin their priority tier).
-        for (const e of envs)
-            this.enqueue(e);
+        for (const envelope of envs)
+            this.enqueue(envelope);
     }
     /** Peek at the next message that would be dequeued, without removing it. */
     hasMessages() {

package/dist/mailbox/PriorityMailbox.js.map

@@ -1 +1 @@
-{"version":3,"file":"PriorityMailbox.js","sourceRoot":"","sources":["../../src/mailbox/PriorityMailbox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAiB,MAAM,wBAAwB,CAAC;AAahE;;;;;GAKG;AACH,MAAM,OAAO,eAA6B,SAAQ,OAAU;IACzC,WAAW,CAAsB;IAClD,qFAAqF;IAC7E,GAAG,GAAG,CAAC,CAAC;IACC,OAAO,GAA+D,EAAE,CAAC;IAE1F,YAAY,QAAoC;QAC9C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,WAAW,GAAG,QAAQ,CAAC,WAAW,CAAC;IAC1C,CAAC;IAEQ,OAAO,CAAC,GAAgB;QAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC/C,MAAM,KAAK,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QACjD,oEAAoE;QACpE,sDAAsD;QACtD,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QACrC,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;YAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAE,CAAC;YAChC,IAAI,IAAI,CAAC,QAAQ,GAAG,QAAQ,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,QAAQ,IAAI,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrF,EAAE,GAAG,GAAG,GAAG,CAAC,CAAC;YACf,CAAC;iBAAM,CAAC;gBACN,EAAE,GAAG,GAAG,CAAC;YACX,CAAC;QACH,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC;IAEQ,WAAW;QAClB,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO,SAAS,CAAC;QACrC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,GAAG,CAAC;IACnC,CAAC;IAED,IAAa,IAAI,KAAa,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAElD,eAAe,KAAc,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IAE9D,SAAS;QAChB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;QACxB,OAAO,GAAG,CAAC;IACb,CAAC;IAEQ,WAAW,CAAC,IAAwB;QAC3C,uEAAuE;QACvE,6DAA6D;QAC7D,KAAK,MAAM,CAAC,IAAI,IAAI;YAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,4EAA4E;IACnE,WAAW;QAClB,OAAO,IAAI,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAClF,CAAC;CACF"}
+{"version":3,"file":"PriorityMailbox.js","sourceRoot":"","sources":["../../src/mailbox/PriorityMailbox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAiB,MAAM,wBAAwB,CAAC;AAUhE;;;;;GAKG;AACH,MAAM,OAAO,eAA6B,SAAQ,OAAU;IACzC,WAAW,CAAsB;IAClD,qFAAqF;IAC7E,GAAG,GAAG,CAAC,CAAC;IACC,OAAO,GAA+D,EAAE,CAAC;IAE1F,YAAY,OAAkC;QAC5C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,WAAW,GAAI,OAAyC,CAAC,WAAW,CAAC;IAC5E,CAAC;IAEQ,OAAO,CAAC,GAAgB;QAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC/C,MAAM,KAAK,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QACjD,oEAAoE;QACpE,sDAAsD;QACtD,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QACrC,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;YAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAE,CAAC;YAChC,IAAI,IAAI,CAAC,QAAQ,GAAG,QAAQ,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,QAAQ,IAAI,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrF,EAAE,GAAG,GAAG,GAAG,CAAC,CAAC;YACf,CAAC;iBAAM,CAAC;gBACN,EAAE,GAAG,GAAG,CAAC;YACX,CAAC;QACH,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC;IAEQ,WAAW;QAClB,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO,SAAS,CAAC;QACrC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,GAAG,CAAC;IACnC,CAAC;IAED,IAAa,IAAI,KAAa,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAElD,eAAe,KAAc,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IAE9D,SAAS;QAChB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;QACxB,OAAO,GAAG,CAAC;IACb,CAAC;IAEQ,WAAW,CAAC,IAAwB;QAC3C,uEAAuE;QACvE,6DAA6D;QAC7D,KAAK,MAAM,QAAQ,IAAI,IAAI;YAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACtD,CAAC;IAED,4EAA4E;IACnE,WAAW;QAClB,OAAO,IAAI,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAClF,CAAC;CACF"}

package/dist/mailbox/PriorityMailboxOptions.d.ts

@@ -0,0 +1,27 @@
+import { OptionsBuilder } from '../util/OptionsBuilder.js';
+import type { PriorityFunction } from './PriorityMailbox.js';
+/** Plain options-object shape accepted by a {@link PriorityMailbox}. */
+export interface PriorityMailboxOptionsType<T> {
+    readonly priorityFor: PriorityFunction<T>;
+}
+/**
+ * Fluent builder for {@link PriorityMailboxOptionsType}:
+ *
+ *     new PriorityMailbox(PriorityMailboxOptions.create<Command>()
+ *       .withPriorityFor((m) => m.urgent ? 0 : 10));
+ */
+export declare class PriorityMailboxOptionsBuilder<T> extends OptionsBuilder<PriorityMailboxOptionsType<T>> {
+    /** Start a fresh builder.  Equivalent to `new PriorityMailboxOptionsBuilder<T>()`. */
+    static create<T>(): PriorityMailboxOptionsBuilder<T>;
+    /** Priority function: lower numbers are dequeued first (0 = highest).  Required. */
+    withPriorityFor(priorityFor: PriorityFunction<T>): this;
+}
+/**
+ * Accepted input for a {@link PriorityMailbox}: the fluent
+ * {@link PriorityMailboxOptionsBuilder} OR a plain
+ * {@link PriorityMailboxOptionsType} object.
+ */
+export type PriorityMailboxOptions<T> = PriorityMailboxOptionsBuilder<T> | Partial<PriorityMailboxOptionsType<T>>;
+/** Value alias so `PriorityMailboxOptions.create()` / `new PriorityMailboxOptions()` resolve to the builder. */
+export declare const PriorityMailboxOptions: typeof PriorityMailboxOptionsBuilder;
+//# sourceMappingURL=PriorityMailboxOptions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PriorityMailboxOptions.d.ts","sourceRoot":"","sources":["../../src/mailbox/PriorityMailboxOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,wEAAwE;AACxE,MAAM,WAAW,0BAA0B,CAAC,CAAC;IAC3C,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;CAC3C;AAED;;;;;GAKG;AACH,qBAAa,6BAA6B,CAAC,CAAC,CAAE,SAAQ,cAAc,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC;IACjG,sFAAsF;IACtF,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,6BAA6B,CAAC,CAAC,CAAC;IAIpD,oFAAoF;IACpF,eAAe,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI;CAGxD;AAED;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,CAAC,CAAC,IAChC,6BAA6B,CAAC,CAAC,CAAC,GAChC,OAAO,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3C,gHAAgH;AAChH,eAAO,MAAM,sBAAsB,sCAAgC,CAAC"}

package/dist/mailbox/PriorityMailboxOptions.js

@@ -0,0 +1,20 @@
+import { OptionsBuilder } from '../util/OptionsBuilder.js';
+/**
+ * Fluent builder for {@link PriorityMailboxOptionsType}:
+ *
+ *     new PriorityMailbox(PriorityMailboxOptions.create<Command>()
+ *       .withPriorityFor((m) => m.urgent ? 0 : 10));
+ */
+export class PriorityMailboxOptionsBuilder extends OptionsBuilder {
+    /** Start a fresh builder.  Equivalent to `new PriorityMailboxOptionsBuilder<T>()`. */
+    static create() {
+        return new PriorityMailboxOptionsBuilder();
+    }
+    /** Priority function: lower numbers are dequeued first (0 = highest).  Required. */
+    withPriorityFor(priorityFor) {
+        return this.set('priorityFor', priorityFor);
+    }
+}
+/** Value alias so `PriorityMailboxOptions.create()` / `new PriorityMailboxOptions()` resolve to the builder. */
+export const PriorityMailboxOptions = PriorityMailboxOptionsBuilder;
+//# sourceMappingURL=PriorityMailboxOptions.js.map

package/dist/mailbox/PriorityMailboxOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PriorityMailboxOptions.js","sourceRoot":"","sources":["../../src/mailbox/PriorityMailboxOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAQ3D;;;;;GAKG;AACH,MAAM,OAAO,6BAAiC,SAAQ,cAA6C;IACjG,sFAAsF;IACtF,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,6BAA6B,EAAK,CAAC;IAChD,CAAC;IAED,oFAAoF;IACpF,eAAe,CAAC,WAAgC;QAC9C,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IAC9C,CAAC;CACF;AAUD,gHAAgH;AAChH,MAAM,CAAC,MAAM,sBAAsB,GAAG,6BAA6B,CAAC"}

package/dist/mailbox/index.d.ts

@@ -1,5 +1,9 @@
 export { BoundedMailbox, MailboxFullError } from './BoundedMailbox.js';
-export type { BoundedMailboxSettings, BoundedMailboxOverflow, } from './BoundedMailbox.js';
+export { BoundedMailboxOptions, BoundedMailboxOptionsBuilder, BoundedMailboxOptionsValidator } from './BoundedMailboxOptions.js';
+export type { BoundedMailboxOptionsType } from './BoundedMailboxOptions.js';
+export type { BoundedMailboxOverflow } from './BoundedMailbox.js';
 export { PriorityMailbox } from './PriorityMailbox.js';
-export type { PriorityMailboxSettings, PriorityFunction, } from './PriorityMailbox.js';
+export { PriorityMailboxOptions, PriorityMailboxOptionsBuilder } from './PriorityMailboxOptions.js';
+export type { PriorityMailboxOptionsType } from './PriorityMailboxOptions.js';
+export type { PriorityFunction } from './PriorityMailbox.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mailbox/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvE,YAAY,EACV,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EACV,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mailbox/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,8BAA8B,EAAE,MAAM,4BAA4B,CAAC;AACjI,YAAY,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAC5E,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AACpG,YAAY,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAC9E,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/mailbox/index.js

@@ -1,3 +1,5 @@
 export { BoundedMailbox, MailboxFullError } from './BoundedMailbox.js';
+export { BoundedMailboxOptions, BoundedMailboxOptionsBuilder, BoundedMailboxOptionsValidator } from './BoundedMailboxOptions.js';
 export { PriorityMailbox } from './PriorityMailbox.js';
+export { PriorityMailboxOptions, PriorityMailboxOptionsBuilder } from './PriorityMailboxOptions.js';
 //# sourceMappingURL=index.js.map

package/dist/mailbox/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mailbox/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAKvE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mailbox/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,8BAA8B,EAAE,MAAM,4BAA4B,CAAC;AAGjI,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/management/HttpManagement.d.ts

@@ -1,25 +1,9 @@
+import type { ManagementRoutesOptions } from './ManagementRoutesOptions.js';
 import type { ActorSystem } from '../ActorSystem.js';
 import type { Cluster } from '../cluster/Cluster.js';
 import { type Route } from '../http/index.js';
 import type { HealthCheckResult } from './HealthCheck.js';
 import { HealthCheckRegistry } from './HealthCheck.js';
-export interface ManagementRoutesSettings {
-    /** Set to true to allow POST /cluster/leave (requires cluster). */
-    readonly enableLeaveEndpoint?: boolean;
-    /**
-     * Set to true to allow POST /cluster/down (#56).  Operator-initiated
-     * force-down of a remote member by address.  Off by default —
-     * production deployments typically gate this behind an auth proxy
-     * because it's a destructive action.
-     */
-    readonly enableDownEndpoint?: boolean;
-    /**
-     * Set to true to expose `GET /metrics` in Prometheus text format
-     * (#56).  Reads from the system's `MetricsRegistry`.  Off by default
-     * because most deployments scrape metrics from a separate port.
-     */
-    readonly enableMetricsEndpoint?: boolean;
-}
 /**
  * Build a Route tree exposing cluster-management HTTP endpoints.  The
  * caller binds the returned routes into their HTTP server — management
@@ -35,7 +19,7 @@ export interface ManagementRoutesSettings {
  *   - `POST /cluster/down`  body `{address}`  →  force-down a peer (optional, off by default) (#56)
  *   - `GET /metrics`                          →  Prometheus text format (optional, off by default) (#56)
  */
-export declare function managementRoutes(system: ActorSystem, cluster: Cluster | null, settings?: ManagementRoutesSettings): {
+export declare function managementRoutes(system: ActorSystem, cluster: Cluster | null, optionsInput?: ManagementRoutesOptions): {
     routes: Route;
     health: HealthCheckRegistry;
 };

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,uBAAuB,EAA+B,MAAM,8BAA8B,CAAC;AACzG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAGrD,OAAO,EAUL,KAAK,KAAK,EACX,MAAM,kBAAkB,CAAC;AAG1B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAGvD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,OAAO,GAAG,IAAI,EACvB,YAAY,GAAE,uBAA4B,GACzC;IAAE,MAAM,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,mBAAmB,CAAA;CAAE,CA4LhD;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAE/D"}