actor-ts 0.9.0 → 0.10.0

package/dist/http/ws/WsMessages.js

@@ -0,0 +1,90 @@
+/**
+ * Ask the hub to spawn a per-connection actor as its own child.  Sent by
+ * the wiring layer at upgrade time; the hub does `context.spawn(props,
+ * name)` so the connection actor is a genuine sub-actor of the server.
+ */
+export class WsAcceptSignal {
+    props;
+    name;
+    _wsSignal = 'accept';
+    constructor(props, name) {
+        this.props = props;
+        this.name = name;
+    }
+}
+export class WsConnectedSignal {
+    connection;
+    _wsSignal = 'connected';
+    constructor(connection) {
+        this.connection = connection;
+    }
+}
+export class WsDataSignal {
+    connection;
+    message;
+    _wsSignal = 'data';
+    constructor(connection, message) {
+        this.connection = connection;
+        this.message = message;
+    }
+}
+export class WsDisconnectedSignal {
+    connection;
+    info;
+    _wsSignal = 'disconnected';
+    constructor(connection, info) {
+        this.connection = connection;
+        this.info = info;
+    }
+}
+export class WsInvalidSignal {
+    connection;
+    error;
+    _wsSignal = 'invalid';
+    constructor(connection, error) {
+        this.connection = connection;
+        this.error = error;
+    }
+}
+/* -------------------------- client-side signals -------------------------- */
+/** Outbound send pushed into a client actor's mailbox by another actor. */
+export class WsClientSend {
+    msg;
+    _wsClient = 'send';
+    constructor(msg) {
+        this.msg = msg;
+    }
+}
+/** A decoded inbound message from the server (delivered to the actor's mailbox). */
+export class WsClientInbound {
+    msg;
+    _wsClient = 'inbound';
+    constructor(msg) {
+        this.msg = msg;
+    }
+}
+/** An inbound frame that failed to decode. */
+export class WsClientInvalid {
+    error;
+    _wsClient = 'invalid';
+    constructor(error) {
+        this.error = error;
+    }
+}
+/** The connection (re)opened. */
+export class WsClientConnected {
+    _wsClient = 'connected';
+}
+/** The connection dropped (a reconnect cycle may follow). */
+export class WsClientDisconnected {
+    cause;
+    _wsClient = 'disconnected';
+    constructor(cause) {
+        this.cause = cause;
+    }
+}
+/** Push a typed outbound message through a client actor's ref: `ref.tell(wsSend(m))`. */
+export function wsSend(msg) {
+    return new WsClientSend(msg);
+}
+//# sourceMappingURL=WsMessages.js.map

package/dist/http/ws/WsMessages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WsMessages.js","sourceRoot":"","sources":["../../../src/http/ws/WsMessages.ts"],"names":[],"mappings":"AAeA;;;;GAIG;AACH,MAAM,OAAO,cAAc;IAGd;IACA;IAHF,SAAS,GAAG,QAAiB,CAAC;IACvC,YACW,KAAqB,EACrB,IAAY;QADZ,UAAK,GAAL,KAAK,CAAgB;QACrB,SAAI,GAAJ,IAAI,CAAQ;IACpB,CAAC;CACL;AAED,MAAM,OAAO,iBAAiB;IAEP;IADZ,SAAS,GAAG,WAAoB,CAAC;IAC1C,YAAqB,UAA8B;QAA9B,eAAU,GAAV,UAAU,CAAoB;IAAG,CAAC;CACxD;AAED,MAAM,OAAO,YAAY;IAGZ;IACA;IAHF,SAAS,GAAG,MAAe,CAAC;IACrC,YACW,UAA8B,EAC9B,OAAY;QADZ,eAAU,GAAV,UAAU,CAAoB;QAC9B,YAAO,GAAP,OAAO,CAAK;IACpB,CAAC;CACL;AAED,MAAM,OAAO,oBAAoB;IAGpB;IACA;IAHF,SAAS,GAAG,cAAuB,CAAC;IAC7C,YACW,UAA8B,EAC9B,IAAiB;QADjB,eAAU,GAAV,UAAU,CAAoB;QAC9B,SAAI,GAAJ,IAAI,CAAa;IACzB,CAAC;CACL;AAED,MAAM,OAAO,eAAe;IAGf;IACA;IAHF,SAAS,GAAG,SAAkB,CAAC;IACxC,YACW,UAA8B,EAC9B,KAAoB;QADpB,eAAU,GAAV,UAAU,CAAoB;QAC9B,UAAK,GAAL,KAAK,CAAe;IAC5B,CAAC;CACL;AAmBD,+EAA+E;AAE/E,2EAA2E;AAC3E,MAAM,OAAO,YAAY;IAEF;IADZ,SAAS,GAAG,MAAe,CAAC;IACrC,YAAqB,GAAS;QAAT,QAAG,GAAH,GAAG,CAAM;IAAG,CAAC;CACnC;AACD,oFAAoF;AACpF,MAAM,OAAO,eAAe;IAEL;IADZ,SAAS,GAAG,SAAkB,CAAC;IACxC,YAAqB,GAAQ;QAAR,QAAG,GAAH,GAAG,CAAK;IAAG,CAAC;CAClC;AACD,8CAA8C;AAC9C,MAAM,OAAO,eAAe;IAEL;IADZ,SAAS,GAAG,SAAkB,CAAC;IACxC,YAAqB,KAAoB;QAApB,UAAK,GAAL,KAAK,CAAe;IAAG,CAAC;CAC9C;AACD,iCAAiC;AACjC,MAAM,OAAO,iBAAiB;IACnB,SAAS,GAAG,WAAoB,CAAC;CAC3C;AACD,6DAA6D;AAC7D,MAAM,OAAO,oBAAoB;IAEV;IADZ,SAAS,GAAG,cAAuB,CAAC;IAC7C,YAAqB,KAAa;QAAb,UAAK,GAAL,KAAK,CAAQ;IAAG,CAAC;CACvC;AAYD,yFAAyF;AACzF,MAAM,UAAU,MAAM,CAAO,GAAS;IACpC,OAAO,IAAI,YAAY,CAAC,GAAG,CAAC,CAAC;AAC/B,CAAC"}

package/dist/http/ws/WsPolicy.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Per-connection WebSocket policy — the knobs that govern inbound frame
+ * limits and outbound backpressure.  Resolved once per route (on the
+ * first connection) as: route options > HOCON (`actor-ts.http.websocket`)
+ * > built-in defaults.  The codec and target ref are code, never config.
+ */
+import type { ActorSystem } from '../../ActorSystem.js';
+/** What to do with an inbound frame that exceeds `maxFrameBytes`. */
+export type OversizeFramePolicy = 'close' | 'drop';
+/** What to do with an inbound frame the codec can't decode. */
+export type InvalidMessagePolicy = 'close' | 'drop' | 'hook';
+/** What to do when a slow consumer's send buffer exceeds `maxBufferedBytes`. */
+export type BackpressurePolicy = 'drop' | 'close';
+export interface ResolvedWsPolicy {
+    readonly maxFrameBytes: number;
+    readonly onOversizeFrame: OversizeFramePolicy;
+    readonly onInvalidMessage: InvalidMessagePolicy;
+    readonly maxBufferedBytes: number;
+    readonly onBackpressure: BackpressurePolicy;
+}
+/** Fields a `websocket()` route may override; everything else falls back. */
+export interface WebSocketPolicyOptions {
+    readonly maxFrameBytes?: number;
+    readonly onOversizeFrame?: OversizeFramePolicy;
+    readonly onInvalidMessage?: InvalidMessagePolicy;
+    readonly maxBufferedBytes?: number;
+    readonly onBackpressure?: BackpressurePolicy;
+}
+export declare const DEFAULT_WS_POLICY: ResolvedWsPolicy;
+/** Merge built-in defaults, HOCON server defaults, and per-route options. */
+export declare function resolveWsPolicy(system: ActorSystem, options: WebSocketPolicyOptions): ResolvedWsPolicy;
+//# sourceMappingURL=WsPolicy.d.ts.map

package/dist/http/ws/WsPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WsPolicy.d.ts","sourceRoot":"","sources":["../../../src/http/ws/WsPolicy.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAIxD,qEAAqE;AACrE,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,MAAM,CAAC;AACnD,+DAA+D;AAC/D,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAC7D,gFAAgF;AAChF,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,OAAO,CAAC;AAElD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,mBAAmB,CAAC;IAC9C,QAAQ,CAAC,gBAAgB,EAAE,oBAAoB,CAAC;IAChD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,cAAc,EAAE,kBAAkB,CAAC;CAC7C;AAED,6EAA6E;AAC7E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,CAAC,EAAE,mBAAmB,CAAC;IAC/C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;IACjD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,cAAc,CAAC,EAAE,kBAAkB,CAAC;CAC9C;AAED,eAAO,MAAM,iBAAiB,EAAE,gBAM/B,CAAC;AASF,6EAA6E;AAC7E,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,sBAAsB,GAAG,gBAAgB,CA0BtG"}

package/dist/http/ws/WsPolicy.js

@@ -0,0 +1,43 @@
+import { ConfigKeys } from '../../config/ConfigKeys.js';
+import { DEFAULT_WS_MAX_FRAME_BYTES } from './types.js';
+export const DEFAULT_WS_POLICY = {
+    maxFrameBytes: DEFAULT_WS_MAX_FRAME_BYTES,
+    onOversizeFrame: 'close',
+    onInvalidMessage: 'close',
+    maxBufferedBytes: 4 * 1024 * 1024,
+    onBackpressure: 'drop',
+};
+function oneOf(value, allowed, key) {
+    if (allowed.includes(value))
+        return value;
+    throw new Error(`Invalid config value for actor-ts.http.websocket.${key}: "${value}" (expected one of ${allowed.join(', ')})`);
+}
+/** Merge built-in defaults, HOCON server defaults, and per-route options. */
+export function resolveWsPolicy(system, options) {
+    let base = DEFAULT_WS_POLICY;
+    const key = ConfigKeys.http.websocket;
+    if (system.config.hasPath(key)) {
+        const c = system.config.getConfig(key);
+        base = {
+            maxFrameBytes: c.hasPath('maxFrameBytes') ? c.getBytes('maxFrameBytes') : base.maxFrameBytes,
+            onOversizeFrame: c.hasPath('onOversizeFrame')
+                ? oneOf(c.getString('onOversizeFrame'), ['close', 'drop'], 'onOversizeFrame')
+                : base.onOversizeFrame,
+            onInvalidMessage: c.hasPath('onInvalidMessage')
+                ? oneOf(c.getString('onInvalidMessage'), ['close', 'drop', 'hook'], 'onInvalidMessage')
+                : base.onInvalidMessage,
+            maxBufferedBytes: c.hasPath('maxBufferedBytes') ? c.getBytes('maxBufferedBytes') : base.maxBufferedBytes,
+            onBackpressure: c.hasPath('onBackpressure')
+                ? oneOf(c.getString('onBackpressure'), ['drop', 'close'], 'onBackpressure')
+                : base.onBackpressure,
+        };
+    }
+    return {
+        maxFrameBytes: options.maxFrameBytes ?? base.maxFrameBytes,
+        onOversizeFrame: options.onOversizeFrame ?? base.onOversizeFrame,
+        onInvalidMessage: options.onInvalidMessage ?? base.onInvalidMessage,
+        maxBufferedBytes: options.maxBufferedBytes ?? base.maxBufferedBytes,
+        onBackpressure: options.onBackpressure ?? base.onBackpressure,
+    };
+}
+//# sourceMappingURL=WsPolicy.js.map

package/dist/http/ws/WsPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WsPolicy.js","sourceRoot":"","sources":["../../../src/http/ws/WsPolicy.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AA0BxD,MAAM,CAAC,MAAM,iBAAiB,GAAqB;IACjD,aAAa,EAAE,0BAA0B;IACzC,eAAe,EAAE,OAAO;IACxB,gBAAgB,EAAE,OAAO;IACzB,gBAAgB,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;IACjC,cAAc,EAAE,MAAM;CACvB,CAAC;AAEF,SAAS,KAAK,CAAmB,KAAa,EAAE,OAAqB,EAAE,GAAW;IAChF,IAAK,OAA6B,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAU,CAAC;IACtE,MAAM,IAAI,KAAK,CACb,oDAAoD,GAAG,MAAM,KAAK,sBAAsB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC9G,CAAC;AACJ,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,eAAe,CAAC,MAAmB,EAAE,OAA+B;IAClF,IAAI,IAAI,GAAG,iBAAiB,CAAC;IAC7B,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC;IACtC,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/B,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,GAAG;YACL,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa;YAC5F,eAAe,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC;gBAC3C,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAU,EAAE,iBAAiB,CAAC;gBACtF,CAAC,CAAC,IAAI,CAAC,eAAe;YACxB,gBAAgB,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC;gBAC7C,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAU,EAAE,kBAAkB,CAAC;gBAChG,CAAC,CAAC,IAAI,CAAC,gBAAgB;YACzB,gBAAgB,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB;YACxG,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC;gBACzC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAU,EAAE,gBAAgB,CAAC;gBACpF,CAAC,CAAC,IAAI,CAAC,cAAc;SACxB,CAAC;IACJ,CAAC;IACD,OAAO;QACL,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,IAAI,CAAC,aAAa;QAC1D,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,IAAI,CAAC,eAAe;QAChE,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,IAAI,CAAC,gBAAgB;QACnE,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,IAAI,CAAC,gBAAgB;QACnE,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,IAAI,CAAC,cAAc;KAC9D,CAAC;AACJ,CAAC"}

package/dist/http/ws/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Public WebSocket API surface.  Internals (session actor, connection
+ * impl, wiring, socket adapter, message signals) are intentionally NOT
+ * re-exported — users interact only through `websocket()`,
+ * `WebSocketServerActor`, the `WsConnection` handle, and the codecs.
+ */
+export { websocket } from './WebSocketRoute.js';
+export { WebSocketRouteOptions, WebSocketRouteOptionsBuilder } from './WebSocketRouteOptions.js';
+export type { WebSocketRouteOptionsType } from './WebSocketRouteOptions.js';
+export { WebSocketServerActor } from './WebSocketServerActor.js';
+export { WebSocketClientActor } from './WebSocketClientActor.js';
+export { WebSocketClientOptions, WebSocketClientOptionsBuilder } from './WebSocketClientOptions.js';
+export type { WebSocketClientOptionsType } from './WebSocketClientOptions.js';
+export type { WsConnection } from './WsConnection.js';
+export { wsSend } from './WsMessages.js';
+export type { WsServerMessage, WsServerRef, WsClientMessage } from './WsMessages.js';
+export { jsonCodec, rawCodec, WsDecodeError, WsEncodeError, } from './WsCodec.js';
+export type { WsCodec } from './WsCodec.js';
+export type { OversizeFramePolicy, InvalidMessagePolicy, BackpressurePolicy, } from './WsPolicy.js';
+export { DEFAULT_WS_MAX_FRAME_BYTES, } from './types.js';
+export type { WsFrame, WsUpgradeInfo, WsCloseInfo } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/http/ws/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/http/ws/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AACjG,YAAY,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAE5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AACpG,YAAY,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAE9E,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAErF,OAAO,EACL,SAAS,EACT,QAAQ,EACR,aAAa,EACb,aAAa,GACd,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,0BAA0B,GAC3B,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/http/ws/index.js

@@ -0,0 +1,15 @@
+/**
+ * Public WebSocket API surface.  Internals (session actor, connection
+ * impl, wiring, socket adapter, message signals) are intentionally NOT
+ * re-exported — users interact only through `websocket()`,
+ * `WebSocketServerActor`, the `WsConnection` handle, and the codecs.
+ */
+export { websocket } from './WebSocketRoute.js';
+export { WebSocketRouteOptions, WebSocketRouteOptionsBuilder } from './WebSocketRouteOptions.js';
+export { WebSocketServerActor } from './WebSocketServerActor.js';
+export { WebSocketClientActor } from './WebSocketClientActor.js';
+export { WebSocketClientOptions, WebSocketClientOptionsBuilder } from './WebSocketClientOptions.js';
+export { wsSend } from './WsMessages.js';
+export { jsonCodec, rawCodec, WsDecodeError, WsEncodeError, } from './WsCodec.js';
+export { DEFAULT_WS_MAX_FRAME_BYTES, } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/http/ws/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/http/ws/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAGjG,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AAIpG,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAGzC,OAAO,EACL,SAAS,EACT,QAAQ,EACR,aAAa,EACb,aAAa,GACd,MAAM,cAAc,CAAC;AAStB,OAAO,EACL,0BAA0B,GAC3B,MAAM,YAAY,CAAC"}

package/dist/http/ws/matchPattern.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Minimal `:param`-style path matcher for WebSocket upgrade routing.
+ *
+ * The Express backend can't use its router for upgrades (the `upgrade`
+ * event bypasses the router entirely, and path-to-regexp drifted between
+ * Express 4 and 5), so we match the compiled pattern ourselves — the
+ * same dialect as `RouteRegistration.pattern` (`/room/:id`).  No
+ * wildcards in v1.
+ */
+/** Returns captured params if `pathname` matches `pattern`, else `null`. */
+export declare function matchWsPattern(pattern: string, pathname: string): Record<string, string> | null;
+//# sourceMappingURL=matchPattern.d.ts.map

package/dist/http/ws/matchPattern.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matchPattern.d.ts","sourceRoot":"","sources":["../../../src/http/ws/matchPattern.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAe/F"}

package/dist/http/ws/matchPattern.js

@@ -0,0 +1,29 @@
+/**
+ * Minimal `:param`-style path matcher for WebSocket upgrade routing.
+ *
+ * The Express backend can't use its router for upgrades (the `upgrade`
+ * event bypasses the router entirely, and path-to-regexp drifted between
+ * Express 4 and 5), so we match the compiled pattern ourselves — the
+ * same dialect as `RouteRegistration.pattern` (`/room/:id`).  No
+ * wildcards in v1.
+ */
+/** Returns captured params if `pathname` matches `pattern`, else `null`. */
+export function matchWsPattern(pattern, pathname) {
+    const pSegs = pattern.split('/').filter((s) => s.length > 0);
+    const uSegs = pathname.split('/').filter((s) => s.length > 0);
+    if (pSegs.length !== uSegs.length)
+        return null;
+    const params = {};
+    for (let i = 0; i < pSegs.length; i++) {
+        const p = pSegs[i];
+        const u = uSegs[i];
+        if (p.startsWith(':')) {
+            params[p.slice(1)] = decodeURIComponent(u);
+        }
+        else if (p !== u) {
+            return null;
+        }
+    }
+    return params;
+}
+//# sourceMappingURL=matchPattern.js.map

package/dist/http/ws/matchPattern.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matchPattern.js","sourceRoot":"","sources":["../../../src/http/ws/matchPattern.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,4EAA4E;AAC5E,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,QAAgB;IAC9D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC9D,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAC/C,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACpB,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACpB,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC;QAC7C,CAAC;aAAM,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/http/ws/rawResponse.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Write a plain HTTP/1.1 response onto a raw upgrade socket, then close
+ * it.  Used by the Express backend to reject a WebSocket upgrade before
+ * the handshake completes (404 for an unknown path, or the response an
+ * authorize guard returned).  Since no `101` was sent, the client is
+ * still speaking HTTP and sees a normal error response.
+ */
+import type { HttpResponse } from '../types.js';
+/** The minimal raw-socket surface we write to (a `node:net` Socket). */
+export interface RawUpgradeSocket {
+    write(data: string): unknown;
+    destroy(): void;
+}
+export declare function writeRawHttpResponse(socket: RawUpgradeSocket, res: HttpResponse): void;
+//# sourceMappingURL=rawResponse.d.ts.map

package/dist/http/ws/rawResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rawResponse.d.ts","sourceRoot":"","sources":["../../../src/http/ws/rawResponse.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,wEAAwE;AACxE,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,OAAO,IAAI,IAAI,CAAC;CACjB;AAcD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,EAAE,YAAY,GAAG,IAAI,CAoCtF"}

package/dist/http/ws/rawResponse.js

@@ -0,0 +1,54 @@
+const STATUS_TEXT = {
+    400: 'Bad Request',
+    401: 'Unauthorized',
+    403: 'Forbidden',
+    404: 'Not Found',
+    405: 'Method Not Allowed',
+    426: 'Upgrade Required',
+    429: 'Too Many Requests',
+    500: 'Internal Server Error',
+    503: 'Service Unavailable',
+};
+export function writeRawHttpResponse(socket, res) {
+    let body;
+    let contentType = res.contentType;
+    if (res.body === undefined || res.body === null) {
+        body = '';
+    }
+    else if (typeof res.body === 'string') {
+        body = res.body;
+        contentType ??= 'text/plain; charset=utf-8';
+    }
+    else if (res.body instanceof Uint8Array) {
+        body = Buffer.from(res.body).toString('utf8');
+        contentType ??= 'application/octet-stream';
+    }
+    else {
+        body = JSON.stringify(res.body);
+        contentType ??= 'application/json; charset=utf-8';
+    }
+    const statusText = STATUS_TEXT[res.status] ?? '';
+    const lines = [
+        `HTTP/1.1 ${res.status} ${statusText}`,
+        `content-type: ${contentType ?? 'text/plain; charset=utf-8'}`,
+        `content-length: ${Buffer.byteLength(body)}`,
+        'connection: close',
+    ];
+    if (res.headers) {
+        for (const [k, v] of Object.entries(res.headers))
+            lines.push(`${k}: ${v}`);
+    }
+    try {
+        socket.write(lines.join('\r\n') + '\r\n\r\n' + body);
+    }
+    catch {
+        /* peer already gone */
+    }
+    try {
+        socket.destroy();
+    }
+    catch {
+        /* already destroyed */
+    }
+}
+//# sourceMappingURL=rawResponse.js.map

package/dist/http/ws/rawResponse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rawResponse.js","sourceRoot":"","sources":["../../../src/http/ws/rawResponse.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,GAA2B;IAC1C,GAAG,EAAE,aAAa;IAClB,GAAG,EAAE,cAAc;IACnB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,oBAAoB;IACzB,GAAG,EAAE,kBAAkB;IACvB,GAAG,EAAE,mBAAmB;IACxB,GAAG,EAAE,uBAAuB;IAC5B,GAAG,EAAE,qBAAqB;CAC3B,CAAC;AAEF,MAAM,UAAU,oBAAoB,CAAC,MAAwB,EAAE,GAAiB;IAC9E,IAAI,IAAY,CAAC;IACjB,IAAI,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;IAClC,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QAChD,IAAI,GAAG,EAAE,CAAC;IACZ,CAAC;SAAM,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACxC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;QAChB,WAAW,KAAK,2BAA2B,CAAC;IAC9C,CAAC;SAAM,IAAI,GAAG,CAAC,IAAI,YAAY,UAAU,EAAE,CAAC;QAC1C,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC9C,WAAW,KAAK,0BAA0B,CAAC;IAC7C,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAChC,WAAW,KAAK,iCAAiC,CAAC;IACpD,CAAC;IAED,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACjD,MAAM,KAAK,GAAG;QACZ,YAAY,GAAG,CAAC,MAAM,IAAI,UAAU,EAAE;QACtC,iBAAiB,WAAW,IAAI,2BAA2B,EAAE;QAC7D,mBAAmB,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE;QAC5C,mBAAmB;KACpB,CAAC;IACF,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;QAChB,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,UAAU,GAAG,IAAI,CAAC,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,uBAAuB;IACzB,CAAC;IACD,IAAI,CAAC;QACH,MAAM,CAAC,OAAO,EAAE,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,uBAAuB;IACzB,CAAC;AACH,CAAC"}

package/dist/http/ws/types.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Core WebSocket wire types + frame helpers, shared by the server-side
+ * routing directive (`websocket()`), the internal per-connection session
+ * actor, and the client-side `WebSocketClientActor`.
+ *
+ * Kept dependency-free (no actor / http imports) so every layer can pull
+ * it in without a cycle.
+ */
+/** A single WebSocket frame — either a UTF-8 text frame or a binary frame. */
+export type WsFrame = {
+    readonly kind: 'text';
+    readonly data: string;
+} | {
+    readonly kind: 'binary';
+    readonly data: Uint8Array;
+};
+/**
+ * Snapshot of the HTTP upgrade request, exposed on every connection so
+ * handlers can read the path, params, query, headers and negotiated
+ * subprotocol without holding a backend-specific request object.
+ */
+export interface WsUpgradeInfo {
+    readonly path: string;
+    /** Path parameters extracted from `/room/:id`-style patterns. */
+    readonly params: Readonly<Record<string, string>>;
+    readonly query: Readonly<Record<string, string | string[] | undefined>>;
+    readonly headers: Readonly<Record<string, string>>;
+    /** Remote peer address as the server saw it (not `x-forwarded-for`). */
+    readonly remoteAddress?: string;
+    /** Negotiated `Sec-WebSocket-Protocol`, if any. */
+    readonly subprotocol?: string;
+}
+/** Why/how a connection closed — delivered to disconnect hooks. */
+export interface WsCloseInfo {
+    readonly code: number;
+    readonly reason: string;
+    readonly initiatedBy: 'client' | 'server' | 'error';
+}
+/**
+ * Default cap on a single inbound WebSocket frame — 1 MiB.
+ *
+ * **Why this exists (security):** a malicious or compromised peer can
+ * send arbitrarily-large frames.  Without a cap, a stalled downstream
+ * consumer plus one 100-MiB frame exhausts the process.  The cap is
+ * enforced on the raw frame *before* the codec decodes it.
+ */
+export declare const DEFAULT_WS_MAX_FRAME_BYTES: number;
+/**
+ * UTF-8 byte length of a string without allocating a `Uint8Array`.
+ * `TextEncoder.encode` would allocate a buffer we'd immediately discard;
+ * for the size check alone we hand-roll the byte count, which is the
+ * common (small-message) case.
+ */
+export declare function utf8ByteLength(s: string): number;
+/** Payload size of a frame in bytes (UTF-8 length for text). */
+export declare function frameByteLength(frame: WsFrame): number;
+/**
+ * Normalise a raw inbound payload from any backend socket into a
+ * {@link WsFrame}.  Handles every shape the supported backends deliver:
+ *
+ *   - `string`                      → text frame
+ *   - `ArrayBuffer`                 → binary frame
+ *   - `Uint8Array` / Node `Buffer`  → binary frame
+ *   - `Array<Buffer>` (fragmented)  → merged binary frame (the `ws`
+ *                                     package delivers fragments this way)
+ *
+ * Returns `null` for shapes we don't recognise (caller logs + drops).
+ */
+export declare function normalizeInbound(data: unknown): WsFrame | null;
+//# sourceMappingURL=types.d.ts.map

package/dist/http/ws/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/http/ws/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,8EAA8E;AAC9E,MAAM,MAAM,OAAO,GACf;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AAE3D;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAClD,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC;IACxE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,wEAAwE;IACxE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,mDAAmD;IACnD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,mEAAmE;AACnE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;CACrD;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,QAAkB,CAAC;AAE1D;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAahD;AAED,gEAAgE;AAChE,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEtD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAmB9D"}

package/dist/http/ws/types.js

@@ -0,0 +1,81 @@
+/**
+ * Core WebSocket wire types + frame helpers, shared by the server-side
+ * routing directive (`websocket()`), the internal per-connection session
+ * actor, and the client-side `WebSocketClientActor`.
+ *
+ * Kept dependency-free (no actor / http imports) so every layer can pull
+ * it in without a cycle.
+ */
+/**
+ * Default cap on a single inbound WebSocket frame — 1 MiB.
+ *
+ * **Why this exists (security):** a malicious or compromised peer can
+ * send arbitrarily-large frames.  Without a cap, a stalled downstream
+ * consumer plus one 100-MiB frame exhausts the process.  The cap is
+ * enforced on the raw frame *before* the codec decodes it.
+ */
+export const DEFAULT_WS_MAX_FRAME_BYTES = 1 * 1024 * 1024;
+/**
+ * UTF-8 byte length of a string without allocating a `Uint8Array`.
+ * `TextEncoder.encode` would allocate a buffer we'd immediately discard;
+ * for the size check alone we hand-roll the byte count, which is the
+ * common (small-message) case.
+ */
+export function utf8ByteLength(s) {
+    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) {
+            // High surrogate → 4-byte sequence; consume the low surrogate too.
+            bytes += 4;
+            i += 1;
+        }
+        else
+            bytes += 3;
+    }
+    return bytes;
+}
+/** Payload size of a frame in bytes (UTF-8 length for text). */
+export function frameByteLength(frame) {
+    return frame.kind === 'text' ? utf8ByteLength(frame.data) : frame.data.byteLength;
+}
+/**
+ * Normalise a raw inbound payload from any backend socket into a
+ * {@link WsFrame}.  Handles every shape the supported backends deliver:
+ *
+ *   - `string`                      → text frame
+ *   - `ArrayBuffer`                 → binary frame
+ *   - `Uint8Array` / Node `Buffer`  → binary frame
+ *   - `Array<Buffer>` (fragmented)  → merged binary frame (the `ws`
+ *                                     package delivers fragments this way)
+ *
+ * Returns `null` for shapes we don't recognise (caller logs + drops).
+ */
+export function normalizeInbound(data) {
+    if (typeof data === 'string')
+        return { kind: 'text', data };
+    if (data instanceof ArrayBuffer)
+        return { kind: 'binary', data: new Uint8Array(data) };
+    if (data instanceof Uint8Array)
+        return { kind: 'binary', data };
+    if (Array.isArray(data)) {
+        const total = data.reduce((n, b) => n + b.byteLength, 0);
+        const merged = new Uint8Array(total);
+        let off = 0;
+        for (const part of data) {
+            const u8 = new Uint8Array(part);
+            merged.set(u8, off);
+            off += u8.byteLength;
+        }
+        return { kind: 'binary', data: merged };
+    }
+    if (data && typeof data.byteLength === 'number') {
+        return { kind: 'binary', data: new Uint8Array(data) };
+    }
+    return null;
+}
+//# sourceMappingURL=types.js.map

package/dist/http/ws/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/http/ws/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA+BH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,CAAS;IACtC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,MAAM,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,CAAC,GAAG,IAAI;YAAE,KAAK,IAAI,CAAC,CAAC;aACpB,IAAI,CAAC,GAAG,KAAK;YAAE,KAAK,IAAI,CAAC,CAAC;aAC1B,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,MAAM,EAAE,CAAC;YACpC,mEAAmE;YACnE,KAAK,IAAI,CAAC,CAAC;YACX,CAAC,IAAI,CAAC,CAAC;QACT,CAAC;;YAAM,KAAK,IAAI,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC;AACpF,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAa;IAC5C,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC5D,IAAI,IAAI,YAAY,WAAW;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;IACvF,IAAI,IAAI,YAAY,UAAU;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAChE,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAS,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAI,CAA4B,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;QAC7F,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,GAAG,GAAG,CAAC,CAAC;QACZ,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;YACxB,MAAM,EAAE,GAAG,IAAI,UAAU,CAAC,IAAuB,CAAC,CAAC;YACnD,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;YACpB,GAAG,IAAI,EAAE,CAAC,UAAU,CAAC;QACvB,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1C,CAAC;IACD,IAAI,IAAI,IAAI,OAAQ,IAAgC,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;QAC7E,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,UAAU,CAAC,IAAuB,CAAC,EAAE,CAAC;IAC3E,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/http/ws/wsCtor.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Runtime-agnostic WebSocket **client** constructor selection.
+ *
+ * Picks the native `WebSocket` global (Bun, Deno, Node ≥ 22) when
+ * available; otherwise lazy-imports the optional `ws` peer-dependency
+ * (Node < 22).  Used by {@link WebSocketClientActor}.  Server-side
+ * upgrades never touch this — the HTTP backends own those.
+ */
+import { Lazy } from '../../util/Lazy.js';
+/** Minimal surface of a client WebSocket the client actor depends on. */
+export interface WebSocketLike {
+    addEventListener(event: 'open' | 'close', cb: () => void): void;
+    addEventListener(event: 'error', cb: (ev: unknown) => void): void;
+    addEventListener(event: 'message', cb: (ev: {
+        data: unknown;
+    }) => void): void;
+    send(data: string | Uint8Array): void;
+    close(code?: number, reason?: string): void;
+    ping?(): void;
+}
+export interface WsClientCtorOptions {
+    readonly protocols?: string | ReadonlyArray<string>;
+    /** Custom request headers — Node/`ws` only; browsers/native ignore them. */
+    readonly headers?: Readonly<Record<string, string>>;
+}
+export interface WsClientCtor {
+    create(url: string, opts?: WsClientCtorOptions): WebSocketLike;
+}
+/**
+ * Lazy ctor — resolves once, caches the resolved factory.  Native
+ * `WebSocket` first; `ws` peer-dep fallback with a clear install hint.
+ */
+export declare const wsClientCtor: Lazy<Promise<WsClientCtor>>;
+//# sourceMappingURL=wsCtor.d.ts.map

package/dist/http/ws/wsCtor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wsCtor.d.ts","sourceRoot":"","sources":["../../../src/http/ws/wsCtor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE1C,yEAAyE;AACzE,MAAM,WAAW,aAAa;IAC5B,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAChE,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;IAClE,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IAC9E,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;IACtC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,IAAI,CAAC,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACpD,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,mBAAmB,GAAG,aAAa,CAAC;CAChE;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CA+BnD,CAAC"}

package/dist/http/ws/wsCtor.js

@@ -0,0 +1,38 @@
+/**
+ * Runtime-agnostic WebSocket **client** constructor selection.
+ *
+ * Picks the native `WebSocket` global (Bun, Deno, Node ≥ 22) when
+ * available; otherwise lazy-imports the optional `ws` peer-dependency
+ * (Node < 22).  Used by {@link WebSocketClientActor}.  Server-side
+ * upgrades never touch this — the HTTP backends own those.
+ */
+import { Lazy } from '../../util/Lazy.js';
+/**
+ * Lazy ctor — resolves once, caches the resolved factory.  Native
+ * `WebSocket` first; `ws` peer-dep fallback with a clear install hint.
+ */
+export const wsClientCtor = 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('WebSocketClientActor needs either a native global `WebSocket` (Bun/Deno/Node ≥ 22) '
+            + 'or the "ws" peer-dep installed.  Install it with: bun add ws\n'
+            + 'Original error: '
+            + (e instanceof Error ? e.message : String(e)));
+    }
+});
+//# sourceMappingURL=wsCtor.js.map

package/dist/http/ws/wsCtor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wsCtor.js","sourceRoot":"","sources":["../../../src/http/ws/wsCtor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAsB1C;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAgC,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE;IAC1E,IAAI,OAAO,UAAU,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;QAC/C,MAAM,QAAQ,GAAG,UAAU,CAAC,SAGV,CAAC;QACnB,OAAO;YACL,MAAM,EAAE,CAAC,GAAW,EAAE,IAA0B,EAAiB,EAAE,CACjE,IAAI,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC;SACrC,CAAC;IACJ,CAAC;IACD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC;QAClB,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAG9B,CAAC;QACF,MAAM,IAAI,GAAG,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,OAAO,CAAC;QAC1C,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAC1D,OAAO;YACL,MAAM,EAAE,CAAC,GAAW,EAAE,IAA0B,EAAiB,EAAE,CACjE,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;SAC7D,CAAC;IACJ,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,qFAAqF;cACjF,gEAAgE;cAChE,kBAAkB;cAClB,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CACjD,CAAC;IACJ,CAAC;AACH,CAAC,CAAC,CAAC"}