actor-ts 0.9.0

package/dist/io/broker/WebSocketActor.js

@@ -0,0 +1,217 @@
+import { ConfigKeys } from '../../config/ConfigKeys.js';
+import { Lazy } from '../../util/Lazy.js';
+import { BrokerActor } from './BrokerActor.js';
+/**
+ * WebSocket-client actor.  Picks up the native `WebSocket` API on
+ * Bun + Deno; on Node, lazy-imports the `ws` peer-dep.  Either way
+ * inbound text/binary frames are routed to `target`; outbound is the
+ * standard `enqueueOutbound` path so messages buffered while
+ * disconnected are resent after reconnect.
+ *
+ * Server-side WebSocket upgrades (Hono/Fastify integration) are out of
+ * scope for v1 — those need access to the underlying HTTP request,
+ * which is backend-specific.
+ */
+export class WebSocketActor extends BrokerActor {
+    socket = null;
+    pingTimer = null;
+    constructor(settings = {}) { super(settings); }
+    configKey() { return ConfigKeys.io.broker.websocket; }
+    builtInDefaults() { return {}; }
+    readSettingsFromConfig(c) {
+        const out = {};
+        if (c.hasPath('url'))
+            out.url = c.getString('url');
+        if (c.hasPath('protocols'))
+            out.protocols = c.getStringList('protocols');
+        if (c.hasPath('pingIntervalMs'))
+            out.pingIntervalMs = c.getDuration('pingIntervalMs');
+        if (c.hasPath('headers')) {
+            const obj = c.getObject('headers');
+            const headers = {};
+            for (const [k, v] of Object.entries(obj)) {
+                if (typeof v === 'string')
+                    headers[k] = v;
+            }
+            out.headers = headers;
+        }
+        return out;
+    }
+    requiredSettings() {
+        return ['url', 'target'];
+    }
+    endpointLabel() { return this.settings.url ?? '<unknown>'; }
+    async connectImpl() {
+        const ctor = await wsCtorLazy.get();
+        const ws = ctor.create(this.settings.url, {
+            protocols: this.settings.protocols,
+            headers: this.settings.headers,
+        });
+        return new Promise((resolve, reject) => {
+            let done = false;
+            ws.addEventListener('open', () => {
+                if (done)
+                    return;
+                done = true;
+                this.socket = ws;
+                ws.addEventListener('message', (ev) => {
+                    this.handleMessage(ev.data);
+                });
+                ws.addEventListener('close', () => this.handleConnectionLost(new Error('websocket closed')));
+                ws.addEventListener('error', (_ev) => this.handleConnectionLost(new Error('websocket error')));
+                if (this.settings.pingIntervalMs && this.settings.pingIntervalMs > 0) {
+                    this.pingTimer = setInterval(() => {
+                        try {
+                            ws.ping?.();
+                        }
+                        catch { /* ignore */ }
+                    }, this.settings.pingIntervalMs);
+                }
+                resolve();
+            });
+            ws.addEventListener('error', (_ev) => {
+                if (done)
+                    return;
+                done = true;
+                try {
+                    ws.close();
+                }
+                catch { /* ignore */ }
+                reject(new Error('websocket connect error'));
+            });
+        });
+    }
+    async disconnectImpl() {
+        if (this.pingTimer) {
+            clearInterval(this.pingTimer);
+            this.pingTimer = null;
+        }
+        if (!this.socket)
+            return;
+        const sock = this.socket;
+        this.socket = null;
+        try {
+            sock.close();
+        }
+        catch { /* ignore */ }
+    }
+    async dispatchOutgoing(env) {
+        if (!this.socket)
+            throw new Error('WebSocketActor: not open');
+        const f = env.payload;
+        if (f.kind === 'text')
+            this.socket.send(f.data);
+        else
+            this.socket.send(f.data);
+    }
+    onReceive(cmd) {
+        if (cmd.kind === 'send')
+            this.enqueueOutbound(cmd.frame);
+        else if (cmd.kind === 'sendText')
+            this.enqueueOutbound({ kind: 'text', data: cmd.data });
+        else
+            this.enqueueOutbound({ kind: 'binary', data: cmd.data });
+    }
+    /* ------------------------------ inbound ----------------------------- */
+    handleMessage(data) {
+        const target = this.settings.target;
+        if (!target)
+            return;
+        const cap = this.settings.maxInboundFrameBytes ?? DEFAULT_WS_MAX_INBOUND_FRAME_BYTES;
+        if (typeof data === 'string') {
+            // For text, use byte length (UTF-8 worst case is 4× char count
+            // but most messages are ASCII-heavy; checking utf8 byte length
+            // is the precise measure for "memory consumed").
+            const size = utf8ByteLength(data);
+            if (size > cap) {
+                this.log.warn(`WebSocketActor: dropped oversize inbound text frame (${size} > maxInboundFrameBytes ${cap}) ` +
+                    `from ${this.settings.url}`);
+                return;
+            }
+            target.tell({ kind: 'text', data });
+            return;
+        }
+        if (data instanceof ArrayBuffer) {
+            if (data.byteLength > cap) {
+                this.log.warn(`WebSocketActor: dropped oversize inbound binary frame (${data.byteLength} > maxInboundFrameBytes ${cap}) ` +
+                    `from ${this.settings.url}`);
+                return;
+            }
+            target.tell({ kind: 'binary', data: new Uint8Array(data) });
+            return;
+        }
+        if (data instanceof Uint8Array) {
+            if (data.byteLength > cap) {
+                this.log.warn(`WebSocketActor: dropped oversize inbound binary frame (${data.byteLength} > maxInboundFrameBytes ${cap}) ` +
+                    `from ${this.settings.url}`);
+                return;
+            }
+            target.tell({ kind: 'binary', data });
+            return;
+        }
+        // ws-lib delivers Buffer; coerce.
+        if (data && typeof data.byteLength === 'number') {
+            const bl = data.byteLength;
+            if (bl > cap) {
+                this.log.warn(`WebSocketActor: dropped oversize inbound binary frame (${bl} > maxInboundFrameBytes ${cap}) ` +
+                    `from ${this.settings.url}`);
+                return;
+            }
+            const u8 = new Uint8Array(data);
+            target.tell({ kind: 'binary', data: u8 });
+            return;
+        }
+        this.log.warn(`WebSocketActor: unrecognised inbound frame type (${typeof data})`);
+    }
+}
+/** Default cap on a single inbound WebSocket frame — 1 MiB. */
+export const DEFAULT_WS_MAX_INBOUND_FRAME_BYTES = 1 * 1024 * 1024;
+function utf8ByteLength(s) {
+    // TextEncoder's encode allocates a Uint8Array, which we'd discard;
+    // for the size check alone, hand-roll the UTF-8 byte count.  Saves
+    // an allocation in the common case (small messages well under cap).
+    let bytes = 0;
+    for (let i = 0; i < s.length; i++) {
+        const c = s.charCodeAt(i);
+        if (c < 0x80)
+            bytes += 1;
+        else if (c < 0x800)
+            bytes += 2;
+        else if (c >= 0xD800 && c <= 0xDBFF) {
+            // Surrogate pair → 4-byte sequence; skip the low surrogate.
+            bytes += 4;
+            i += 1;
+        }
+        else
+            bytes += 3;
+    }
+    return bytes;
+}
+/**
+ * Lazy ctor — picks the native `WebSocket` (Bun, Deno, modern Node 22+)
+ * if available; otherwise lazy-imports the `ws` peer-dep.
+ */
+const wsCtorLazy = Lazy.of(async () => {
+    if (typeof globalThis.WebSocket === 'function') {
+        const NativeWS = globalThis.WebSocket;
+        return {
+            create: (url, opts) => new NativeWS(url, opts?.protocols),
+        };
+    }
+    try {
+        const name = 'ws';
+        const mod = await import(name);
+        const Ctor = mod.WebSocket ?? mod.default;
+        if (!Ctor)
+            throw new Error('ws: no constructor exported');
+        return {
+            create: (url, opts) => new Ctor(url, opts?.protocols, { headers: opts?.headers }),
+        };
+    }
+    catch (e) {
+        throw new Error('WebSocketActor needs either a native global `WebSocket` (Bun/Deno/Node ≥22) '
+            + 'or the "ws" peer-dep installed.  npm install ws\n'
+            + 'Original error: ' + (e instanceof Error ? e.message : String(e)));
+    }
+});
+//# sourceMappingURL=WebSocketActor.js.map

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

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

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

@@ -0,0 +1,140 @@
+import type { ActorRef } from '../../ActorRef.js';
+import type { ActorSystem } from '../../ActorSystem.js';
+import { type ServerWebSocketActorOptions, type ServerWebSocketLike, type WebSocketCmd, type WebSocketFrame } from './ServerWebSocketActor.js';
+/**
+ * Backend adapters for {@link ServerWebSocketActor} (#1) — the bits
+ * that make a server-side WebSocket from `Bun.serve`, the `ws`
+ * package, or `@fastify/websocket` look like the
+ * `ServerWebSocketLike` shape the actor expects.
+ *
+ * The `ws`-package family (used by `@fastify/websocket`,
+ * `@hono/node-ws`, plain `new WebSocketServer({ ... })`) already
+ * exposes a W3C-compatible `addEventListener` interface, so those
+ * sockets can be handed straight to `ServerWebSocketActor` —
+ * `serverWebSocketActorOf(system, socket, opts)` is the convenience
+ * spawn for that case.
+ *
+ * Bun's native `ServerWebSocket` uses callback-style handlers
+ * configured at server-construction time (`Bun.serve({ websocket:
+ * { open, message, close } })`).  `bunWebSocketHandlers` adapts that
+ * style to our event-listener shape and returns the four
+ * callbacks pre-wired so each new connection spins up its own
+ * actor.
+ */
+/**
+ * Spawn a {@link ServerWebSocketActor} bound to an already-upgraded
+ * socket.  Use this from a Fastify-websocket handler:
+ *
+ *   fastify.register(import('@fastify/websocket'));
+ *   fastify.get('/ws', { websocket: true }, (conn, _req) => {
+ *     const ref = serverWebSocketActorOf(system, conn.socket, {
+ *       target: chatRoom,
+ *       name: () => `ws-${nextId()}`,
+ *     });
+ *     chatRoom.tell({ kind: 'join', client: ref });
+ *   });
+ *
+ * `socket` must satisfy {@link ServerWebSocketLike} — Fastify's
+ * `conn.socket`, the `ws` package's `WebSocket`, and Hono's
+ * Node-WS-bound socket all do.
+ */
+export declare function serverWebSocketActorOf(system: ActorSystem, socket: ServerWebSocketLike, opts?: ServerWebSocketActorOptions & {
+    readonly name?: string;
+}): ActorRef<WebSocketCmd>;
+/**
+ * The minimum surface of a Bun `ServerWebSocket<T>` we depend on.
+ * Bun's native type is generic over the per-connection `data` slot;
+ * we typedef it loosely so the adapter compiles without a Bun-types
+ * dependency.
+ */
+export interface BunServerWebSocketLike<T = unknown> {
+    send(data: string | Uint8Array | ArrayBuffer): number;
+    close(code?: number, reason?: string): void;
+    data: T;
+    readyState?: number;
+}
+/**
+ * Internal shape stored in `ws.data` so each Bun.serve websocket
+ * callback can look up the actor + adapter that drives the actor's
+ * event listeners.
+ */
+export interface BunWebSocketSlot<UserData = unknown> {
+    /** The bridge that translates Bun callbacks into addEventListener calls. */
+    readonly bridge: BunWebSocketBridge;
+    /** Per-connection actor reference returned to user code via `onOpen`. */
+    readonly ref: ActorRef<WebSocketCmd>;
+    /** Whatever per-connection state user code attached during upgrade. */
+    readonly user: UserData;
+}
+/** Wrapper that captures listeners registered by the actor and
+ *  exposes setter-callbacks the Bun handlers drive. */
+declare class BunWebSocketBridge implements ServerWebSocketLike {
+    private readonly ws;
+    private messageCb;
+    private closeCb;
+    private errorCb;
+    constructor(ws: BunServerWebSocketLike);
+    send(data: string | Uint8Array | ArrayBuffer): void;
+    close(code?: number, reason?: string): void;
+    get readyState(): number | undefined;
+    addEventListener(event: 'message' | 'close' | 'error', cb: never): void;
+    removeEventListener(event: string): void;
+    deliverMessage(data: unknown): void;
+    deliverClose(): void;
+    deliverError(ev: unknown): void;
+}
+export interface BunWebSocketHandlerOptions<UserData = unknown> {
+    /**
+     * Per-connection setup.  Receives the freshly-spawned actor ref so
+     * caller code can register it with chatrooms, persistence layers,
+     * routers, etc.  The optional return value is forwarded as
+     * `target` for the actor — handy if you build the target lazily
+     * from the upgrade context (e.g. one room actor per URL path).
+     */
+    readonly onOpen?: (ws: BunServerWebSocketLike<BunWebSocketSlot<UserData>>, ref: ActorRef<WebSocketCmd>) => void;
+    /** Per-connection cleanup.  Called after the actor has stopped. */
+    readonly onClose?: (ws: BunServerWebSocketLike<BunWebSocketSlot<UserData>>, ref: ActorRef<WebSocketCmd>, code: number, reason: string) => void;
+    /**
+     * Static target for every actor spawned by this handler set.  If
+     * omitted, callers register the per-connection target inside
+     * `onOpen` via `ref.tell(...)` to a router that knows where to
+     * forward.
+     */
+    readonly target?: ActorRef<WebSocketFrame>;
+    /** Stop the actor when the bun socket closes.  Default true. */
+    readonly stopOnSocketClose?: boolean;
+    /** Custom actor name per connection.  Defaults to a counter. */
+    readonly actorName?: (ws: BunServerWebSocketLike<BunWebSocketSlot<UserData>>) => string;
+}
+/**
+ * Build the four `Bun.serve({ websocket: ... })` callbacks pre-wired
+ * to spawn a `ServerWebSocketActor` per connection.  Pair with
+ * `bunUpgrade(req, server, { initialUserData })` from your `fetch`
+ * handler:
+ *
+ *   const wsHandlers = bunWebSocketHandlers(system, {
+ *     target: chatRoom,
+ *     onOpen:  (_ws, ref) => chatRoom.tell({ kind: 'join', client: ref }),
+ *     onClose: (_ws, ref) => chatRoom.tell({ kind: 'leave', client: ref }),
+ *   });
+ *
+ *   Bun.serve({
+ *     port: 3000,
+ *     fetch(req, server) {
+ *       if (new URL(req.url).pathname === '/ws') {
+ *         if (server.upgrade(req, { data: { user: 'alice' } })) return undefined;
+ *         return new Response('upgrade failed', { status: 400 });
+ *       }
+ *       return new Response('not found', { status: 404 });
+ *     },
+ *     websocket: wsHandlers,
+ *   });
+ */
+export declare function bunWebSocketHandlers<UserData = unknown>(system: ActorSystem, opts?: BunWebSocketHandlerOptions<UserData>): {
+    open(ws: BunServerWebSocketLike<UserData>): void;
+    message(ws: BunServerWebSocketLike<BunWebSocketSlot<UserData>>, message: string | Buffer): void;
+    close(ws: BunServerWebSocketLike<BunWebSocketSlot<UserData>>, code: number, reason: string): void;
+    drain(ws: BunServerWebSocketLike<BunWebSocketSlot<UserData>>): void;
+};
+export {};
+//# sourceMappingURL=WebSocketServerAdapters.d.ts.map

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

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

package/dist/io/broker/WebSocketServerAdapters.js

@@ -0,0 +1,155 @@
+import { Props } from '../../Props.js';
+import { ServerWebSocketActor, } from './ServerWebSocketActor.js';
+/**
+ * Backend adapters for {@link ServerWebSocketActor} (#1) — the bits
+ * that make a server-side WebSocket from `Bun.serve`, the `ws`
+ * package, or `@fastify/websocket` look like the
+ * `ServerWebSocketLike` shape the actor expects.
+ *
+ * The `ws`-package family (used by `@fastify/websocket`,
+ * `@hono/node-ws`, plain `new WebSocketServer({ ... })`) already
+ * exposes a W3C-compatible `addEventListener` interface, so those
+ * sockets can be handed straight to `ServerWebSocketActor` —
+ * `serverWebSocketActorOf(system, socket, opts)` is the convenience
+ * spawn for that case.
+ *
+ * Bun's native `ServerWebSocket` uses callback-style handlers
+ * configured at server-construction time (`Bun.serve({ websocket:
+ * { open, message, close } })`).  `bunWebSocketHandlers` adapts that
+ * style to our event-listener shape and returns the four
+ * callbacks pre-wired so each new connection spins up its own
+ * actor.
+ */
+/* ------------------- generic / ws-package adapter --------------------- */
+/**
+ * Spawn a {@link ServerWebSocketActor} bound to an already-upgraded
+ * socket.  Use this from a Fastify-websocket handler:
+ *
+ *   fastify.register(import('@fastify/websocket'));
+ *   fastify.get('/ws', { websocket: true }, (conn, _req) => {
+ *     const ref = serverWebSocketActorOf(system, conn.socket, {
+ *       target: chatRoom,
+ *       name: () => `ws-${nextId()}`,
+ *     });
+ *     chatRoom.tell({ kind: 'join', client: ref });
+ *   });
+ *
+ * `socket` must satisfy {@link ServerWebSocketLike} — Fastify's
+ * `conn.socket`, the `ws` package's `WebSocket`, and Hono's
+ * Node-WS-bound socket all do.
+ */
+export function serverWebSocketActorOf(system, socket, opts = {}) {
+    const { name, ...actorOpts } = opts;
+    const props = Props.create(() => new ServerWebSocketActor(socket, actorOpts));
+    return name !== undefined ? system.spawn(props, name) : system.spawnAnonymous(props);
+}
+/** Wrapper that captures listeners registered by the actor and
+ *  exposes setter-callbacks the Bun handlers drive. */
+class BunWebSocketBridge {
+    ws;
+    messageCb = null;
+    closeCb = null;
+    errorCb = null;
+    constructor(ws) {
+        this.ws = ws;
+    }
+    send(data) { this.ws.send(data); }
+    close(code, reason) { this.ws.close(code, reason); }
+    get readyState() { return this.ws.readyState; }
+    addEventListener(event, cb) {
+        if (event === 'message')
+            this.messageCb = cb;
+        else if (event === 'close')
+            this.closeCb = cb;
+        else
+            this.errorCb = cb;
+    }
+    removeEventListener(event) {
+        if (event === 'message')
+            this.messageCb = null;
+        else if (event === 'close')
+            this.closeCb = null;
+        else if (event === 'error')
+            this.errorCb = null;
+    }
+    /* Driven by Bun.serve handlers. */
+    deliverMessage(data) { this.messageCb?.({ data }); }
+    deliverClose() { this.closeCb?.(); }
+    deliverError(ev) { this.errorCb?.(ev); }
+}
+/**
+ * Build the four `Bun.serve({ websocket: ... })` callbacks pre-wired
+ * to spawn a `ServerWebSocketActor` per connection.  Pair with
+ * `bunUpgrade(req, server, { initialUserData })` from your `fetch`
+ * handler:
+ *
+ *   const wsHandlers = bunWebSocketHandlers(system, {
+ *     target: chatRoom,
+ *     onOpen:  (_ws, ref) => chatRoom.tell({ kind: 'join', client: ref }),
+ *     onClose: (_ws, ref) => chatRoom.tell({ kind: 'leave', client: ref }),
+ *   });
+ *
+ *   Bun.serve({
+ *     port: 3000,
+ *     fetch(req, server) {
+ *       if (new URL(req.url).pathname === '/ws') {
+ *         if (server.upgrade(req, { data: { user: 'alice' } })) return undefined;
+ *         return new Response('upgrade failed', { status: 400 });
+ *       }
+ *       return new Response('not found', { status: 404 });
+ *     },
+ *     websocket: wsHandlers,
+ *   });
+ */
+export function bunWebSocketHandlers(system, opts = {}) {
+    let counter = 0;
+    return {
+        open(ws) {
+            const bridge = new BunWebSocketBridge(ws);
+            const slotName = opts.actorName?.(ws)
+                ?? `ws-${++counter}`;
+            const ref = system.spawn(Props.create(() => new ServerWebSocketActor(bridge, {
+                target: opts.target,
+                stopOnSocketClose: opts.stopOnSocketClose,
+            })), slotName);
+            // Stash the bridge + ref on the bun socket so subsequent
+            // callbacks can find it.  The original user data is preserved
+            // under `.user` for downstream code.
+            const userData = ws.data;
+            ws.data = { bridge, ref, user: userData };
+            try {
+                opts.onOpen?.(ws, ref);
+            }
+            catch (err) {
+                system.log.warn('bunWebSocketHandlers.onOpen threw', err);
+            }
+        },
+        message(ws, message) {
+            const slot = ws.data;
+            if (!slot)
+                return;
+            // Bun delivers strings as-is and binary as Buffer (Uint8Array
+            // subclass) — both pass through to the actor's frame
+            // dispatcher unchanged.
+            slot.bridge.deliverMessage(message);
+        },
+        close(ws, code, reason) {
+            const slot = ws.data;
+            if (!slot)
+                return;
+            slot.bridge.deliverClose();
+            try {
+                opts.onClose?.(ws, slot.ref, code, reason);
+            }
+            catch (err) {
+                system.log.warn('bunWebSocketHandlers.onClose threw', err);
+            }
+        },
+        drain(_ws) {
+            // Backpressure hook — Bun calls this when the socket's send
+            // buffer drains.  We don't queue at the actor layer, so this
+            // is a no-op for v1.  Document so users know it's available.
+        },
+    };
+}
+//# sourceMappingURL=WebSocketServerAdapters.js.map

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

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

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

@@ -0,0 +1,32 @@
+export { BrokerActor, type ConnectionState, type OutboundEnvelope, } from './BrokerActor.js';
+export { type BrokerCommonSettings, 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 { 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 { KafkaActor } from './KafkaActor.js';
+export type { KafkaActorSettings, KafkaCmd, KafkaRecord, KafkaPublish, } from './KafkaActor.js';
+export { AmqpActor } from './AmqpActor.js';
+export type { AmqpActorSettings, AmqpCmd, AmqpDelivery, AmqpPublish, AmqpQueueBinding, } from './AmqpActor.js';
+export { GrpcClientActor } from './GrpcClientActor.js';
+export type { GrpcClientActorSettings, GrpcClientCmd, GrpcInbound, GrpcCredentials, } from './GrpcClientActor.js';
+export { GrpcServerActor } from './GrpcServerActor.js';
+export type { GrpcServerSettings, GrpcHandler, GrpcUnaryCall, GrpcServerStreamCall, GrpcBidiCall, } from './GrpcServerActor.js';
+export { NatsActor } from './NatsActor.js';
+export type { NatsActorSettings, NatsCmd, NatsMessage, NatsPublish, } from './NatsActor.js';
+export { JetStreamActor } from './JetStreamActor.js';
+export type { JetStreamActorSettings, JetStreamCmd, JetStreamMessage, JetStreamPublish, JetStreamStreamConfig, JetStreamConsumerConfig, NatsConnectionLike, JetStreamClientLike, JetStreamSubscriptionLike, JetStreamMsgHandleLike, JetStreamMsgInfoLike, JetStreamManagerLike, } from './JetStreamActor.js';
+export { RedisStreamsActor } from './RedisStreamsActor.js';
+export type { RedisStreamsActorSettings, RedisStreamsCmd, RedisStreamEntry, RedisStreamPublish, } from './RedisStreamsActor.js';
+export { SseActor } from './SseActor.js';
+export type { SseActorSettings, SseCmd, SseEvent, } from './SseActor.js';
+//# sourceMappingURL=index.d.ts.map

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

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

@@ -0,0 +1,22 @@
+// Base class + supporting types
+export { BrokerActor, } from './BrokerActor.js';
+export { BrokerSettingsError, DEFAULT_RECONNECT, DEFAULT_OUTBOUND_BUFFER, } from './BrokerSettings.js';
+export { BrokerConnected, BrokerDisconnected, BrokerReconnectAttempt, BrokerReconnectFailed, BrokerBufferOverflow, BrokerNotConnected, } from './BrokerEvents.js';
+// Phase 1 actors
+export { TcpSocketActor } from './TcpSocketActor.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';
+// Phase 2 actors — enterprise / RPC.
+export { KafkaActor } from './KafkaActor.js';
+export { AmqpActor } from './AmqpActor.js';
+export { GrpcClientActor } from './GrpcClientActor.js';
+export { GrpcServerActor } from './GrpcServerActor.js';
+// Phase 3 actors — cloud-native / niche.
+export { NatsActor } from './NatsActor.js';
+export { JetStreamActor } from './JetStreamActor.js';
+export { RedisStreamsActor } from './RedisStreamsActor.js';
+export { SseActor } from './SseActor.js';
+//# sourceMappingURL=index.js.map

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

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

package/dist/io/index.d.ts

@@ -0,0 +1,2 @@
+export * from './broker/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/io/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/dist/io/index.js

@@ -0,0 +1,2 @@
+export * from './broker/index.js';
+//# sourceMappingURL=index.js.map

package/dist/io/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/io/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/dist/mailbox/BoundedMailbox.d.ts

@@ -0,0 +1,28 @@
+import { Mailbox, type Envelope } from '../internal/Mailbox.js';
+export type BoundedMailboxOverflow = 
+/** Drop the oldest message in the queue to make room for the new one. */
+'drop-head'
+/** Drop the message being enqueued. */
+ | '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);
+}
+/**
+ * Mailbox with a fixed upper bound on queued user messages.  Policy for
+ * what happens when a message arrives on a full mailbox is configurable.
+ */
+export declare class BoundedMailbox<T = unknown> extends Mailbox<T> {
+    private readonly capacity;
+    private readonly overflow;
+    /** Number of messages dropped by the overflow policy — useful for metrics. */
+    droppedCount: number;
+    constructor(settings: BoundedMailboxSettings);
+    enqueue(env: Envelope<T>): void;
+}
+//# sourceMappingURL=BoundedMailbox.d.ts.map