@lovrozagar/honey 0.6.8 → 0.7.0

package/dist/ws/cloudflare.js

@@ -0,0 +1,117 @@
+import "./session.js";
+import { invokeUser } from "../invoke-user.js";
+import { truncateUtf8 } from "../realtime/route.js";
+import { bufferedAmountOf, CLOSE_TOO_BIG, CLOSE_TRY_AGAIN, exceedsPayload, MAX_CLOSE_REASON, resolveWSOptions, selectProtocol, sendableCloseCode, } from "./shared.js";
+export const WS_SEND_BUFFER_MAX = 32;
+export class WSContextImpl {
+    raw;
+    sendBuffer = [];
+    limits;
+    constructor(raw, opts) {
+        this.raw = raw;
+        this.limits = opts ?? null;
+        const target = raw;
+        if (raw.readyState !== 1 && typeof target.addEventListener === "function") {
+            target.addEventListener("open", () => this.flush());
+        }
+    }
+    get bufferedAmount() {
+        return bufferedAmountOf(this.raw);
+    }
+    get readyState() {
+        return this.raw.readyState;
+    }
+    /** Send what was queued while the socket was opening (adapters without an `open` event call this). */
+    flush() {
+        const queued = this.sendBuffer;
+        this.sendBuffer = [];
+        for (const msg of queued)
+            this.send(msg);
+    }
+    close(code, reason) {
+        this.sendBuffer = [];
+        this.raw.close(code, reason === undefined ? undefined : truncateUtf8(reason, MAX_CLOSE_REASON));
+    }
+    send(data) {
+        const payload = typeof data === "string" || data instanceof ArrayBuffer || data instanceof Uint8Array
+            ? data
+            : JSON.stringify(data);
+        const state = this.raw.readyState;
+        if (state === 1) {
+            const limits = this.limits;
+            if (limits !== null && limits.backpressureLimit > 0 && this.bufferedAmount > limits.backpressureLimit) {
+                if (limits.backpressurePolicy === "close")
+                    this.close(CLOSE_TRY_AGAIN, "slow consumer");
+                return;
+            }
+            this.raw.send(payload);
+            return;
+        }
+        /* closing or closed: nothing will ever send it */
+        if (state !== 0)
+            return;
+        if (this.sendBuffer.length >= WS_SEND_BUFFER_MAX)
+            this.sendBuffer.shift();
+        this.sendBuffer.push(payload);
+    }
+}
+/** Call an adapter event on the handler; whatever it throws is logged, never thrown into the runtime. */
+export function fireHandler(phase, fn) {
+    void invokeUser(fn, { phase: `websocket ${phase}` });
+}
+/**
+ * Cloudflare Workers WebSocket adapter.
+ * Uses WebSocketPair + server.accept() + addEventListener. `idleTimeout` is not enforced:
+ * Workers has no ping API and evicts idle sockets itself.
+ */
+export function cfWebSocket(opts) {
+    const options = resolveWSOptions(opts);
+    return {
+        options,
+        upgrade(req, _env, handler) {
+            const Ctor = globalThis["WebSocketPair"];
+            const [client, server] = new Ctor();
+            server.accept();
+            const socket = new WSContextImpl(server, options);
+            const raw = server;
+            if ("addEventListener" in raw) {
+                raw.addEventListener("message", (evt) => {
+                    const data = evt.data;
+                    if (exceedsPayload(data, options.maxPayload)) {
+                        socket.close(CLOSE_TOO_BIG, "message too big");
+                        return;
+                    }
+                    fireHandler("message", () => handler.onMessage?.(undefined, socket, data));
+                });
+                raw.addEventListener("close", (evt) => {
+                    const closeEvt = evt;
+                    fireHandler("close", () => handler.onClose?.(undefined, socket, closeEvt.code, closeEvt.reason));
+                    /* echo the close frame so the client's handshake completes; 1005 and 1006 are never sent */
+                    try {
+                        server.close(sendableCloseCode(closeEvt.code), closeEvt.reason);
+                    }
+                    catch {
+                        /* already closed */
+                    }
+                });
+                raw.addEventListener("error", (evt) => {
+                    fireHandler("error", () => handler.onError?.(undefined, socket, evt));
+                });
+            }
+            fireHandler("open", () => handler.onOpen?.(undefined, socket));
+            const headers = { upgrade: "websocket" };
+            const protocol = selectProtocol(req, options);
+            if (protocol !== null)
+                headers["sec-websocket-protocol"] = protocol;
+            return {
+                response: new Response(null, {
+                    headers,
+                    status: 101,
+                    webSocket: client,
+                }),
+                socket,
+            };
+        },
+    };
+}
+//# sourceMappingURL=cloudflare.js.map

package/dist/ws/cloudflare.js.map

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

package/dist/ws/deno.d.ts

@@ -1,13 +1,13 @@
-export { type RawSocket, type WSAdapter, type WSContext, type WSPreUpgrade, WSContextImpl, type WSHandler, } from "./cloudflare.ts";
+export { type RawSocket, type WSAdapter, type WSAdapterOptions, type WSContext, type WSPreUpgrade, WSContextImpl, type WSHandler, } from "./cloudflare.ts";
 import type { WSAdapter } from "./cloudflare.ts";
+import { type WSAdapterOptions } from "./shared.ts";
 /**
  * Deno WebSocket adapter.
  * Uses Deno.upgradeWebSocket() and addEventListener for event binding.
- * Keepalive is not supported — Deno's WebSocket lacks a ping() method.
- * Use nodeWebSocket() for keepalive support.
+ * Deno pings idle sockets itself (`idleTimeout`, whole seconds); there is no `keepalive` option.
  *
  * `preUpgrade` calls `Deno.upgradeWebSocket` in the same turn as the serve
  * callback (Deno rejects upgrades performed after the first await).
  */
-export declare function denoWebSocket(): WSAdapter;
+export declare function denoWebSocket(opts?: WSAdapterOptions): WSAdapter;
 //# sourceMappingURL=deno.d.ts.map

package/dist/ws/deno.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deno.d.ts","sourceRoot":"","sources":["../../src/ws/deno.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,aAAa,EACb,KAAK,SAAS,GACd,MAAM,iBAAiB,CAAA;AAExB,OAAO,KAAK,EAAE,SAAS,EAA2B,MAAM,iBAAiB,CAAA;AAuCzE;;;;;;;;GAQG;AACH,wBAAgB,aAAa,IAAI,SAAS,CA0CzC"}
+{"version":3,"file":"deno.d.ts","sourceRoot":"","sources":["../../src/ws/deno.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,aAAa,EACb,KAAK,SAAS,GACd,MAAM,iBAAiB,CAAA;AAExB,OAAO,KAAK,EAAE,SAAS,EAA2B,MAAM,iBAAiB,CAAA;AAEzE,OAAO,EAON,KAAK,gBAAgB,EACrB,MAAM,aAAa,CAAA;AAmGpB;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE,gBAAgB,GAAG,SAAS,CA4DhE"}

package/dist/ws/deno.js

@@ -0,0 +1,133 @@
+export { WSContextImpl, } from "./cloudflare.js";
+import { fireHandler, WSContextImpl } from "./cloudflare.js";
+import { CLOSE_POLICY, CLOSE_TOO_BIG, exceedsPayload, resolveWSOptions, selectProtocol, } from "./shared.js";
+/** Events that arrive before the route's handler is bound (the `preUpgrade` path). */
+const EARLY_EVENTS_MAX = 64;
+/**
+ * Listen on a Deno socket right away and deliver events to a handler bound later. Until then up
+ * to 64 events wait (frames the client sends between the 101 and the end of the middleware
+ * chain); more close the connection with 1008.
+ */
+function listen(raw, socket, options) {
+    let handler = null;
+    let early = [];
+    const deliver = (evt, h) => {
+        switch (evt.type) {
+            case "open":
+                fireHandler("open", () => h.onOpen?.(undefined, socket));
+                return;
+            case "message":
+                fireHandler("message", () => h.onMessage?.(undefined, socket, evt.data));
+                return;
+            case "close":
+                fireHandler("close", () => h.onClose?.(undefined, socket, evt.code, evt.reason));
+                return;
+            case "error":
+                fireHandler("error", () => h.onError?.(undefined, socket, evt.error));
+        }
+    };
+    const push = (evt) => {
+        if (handler !== null) {
+            deliver(evt, handler);
+            return;
+        }
+        if (early === null)
+            return;
+        if (early.length >= EARLY_EVENTS_MAX && evt.type === "message") {
+            early = null;
+            socket.close(CLOSE_POLICY, "too many messages before the handler was ready");
+            return;
+        }
+        early.push(evt);
+    };
+    raw.addEventListener("open", () => push({ type: "open" }));
+    raw.addEventListener("message", (evt) => {
+        if (exceedsPayload(evt.data, options.maxPayload)) {
+            socket.close(CLOSE_TOO_BIG, "message too big");
+            return;
+        }
+        push({ data: evt.data, type: "message" });
+    });
+    raw.addEventListener("close", (evt) => push({ code: evt.code, reason: evt.reason, type: "close" }));
+    raw.addEventListener("error", (evt) => push({ error: evt, type: "error" }));
+    return {
+        bind(h) {
+            handler = h;
+            const queued = early ?? [];
+            early = null;
+            for (const evt of queued)
+                deliver(evt, h);
+        },
+    };
+}
+/**
+ * Deno WebSocket adapter.
+ * Uses Deno.upgradeWebSocket() and addEventListener for event binding.
+ * Deno pings idle sockets itself (`idleTimeout`, whole seconds); there is no `keepalive` option.
+ *
+ * `preUpgrade` calls `Deno.upgradeWebSocket` in the same turn as the serve
+ * callback (Deno rejects upgrades performed after the first await).
+ */
+export function denoWebSocket(opts) {
+    const options = resolveWSOptions(opts);
+    const pending = new WeakMap();
+    const open = new Set();
+    const start = (req) => {
+        const denoNs = globalThis;
+        const protocol = selectProtocol(req, options);
+        const upgradeOpts = {};
+        if (protocol !== null)
+            upgradeOpts.protocol = protocol;
+        if (options.idleTimeout > 0)
+            upgradeOpts.idleTimeout = Math.max(Math.ceil(options.idleTimeout / 1000), 1);
+        const { response, socket: rawSocket } = denoNs.Deno.upgradeWebSocket(req, upgradeOpts);
+        /* binary frames arrive as ArrayBuffer, as on every other runtime (Deno's default is Blob) */
+        rawSocket.binaryType = "arraybuffer";
+        const socket = new WSContextImpl(rawSocket, options);
+        open.add(socket);
+        rawSocket.addEventListener("close", () => open.delete(socket));
+        const listener = listen(rawSocket, socket, options);
+        return { listener, rawSocket, response, socket };
+    };
+    return {
+        closeAll(code, reason) {
+            for (const socket of open) {
+                try {
+                    socket.close(code, reason);
+                }
+                catch {
+                    /* already closing */
+                }
+            }
+        },
+        options,
+        preUpgrade(req) {
+            const { listener, rawSocket, response, socket } = start(req);
+            const pre = {
+                response,
+                socket,
+                whenOpen(fn) {
+                    if (rawSocket.readyState === 1) {
+                        fn();
+                        return;
+                    }
+                    rawSocket.addEventListener("open", () => fn());
+                },
+            };
+            pending.set(req, { bind: listener.bind, pre });
+            return pre;
+        },
+        upgrade(req, _env, handler) {
+            const held = pending.get(req);
+            if (held) {
+                pending.delete(req);
+                held.bind(handler);
+                return held.pre;
+            }
+            const { listener, response, socket } = start(req);
+            listener.bind(handler);
+            return { response, socket };
+        },
+    };
+}
+//# sourceMappingURL=deno.js.map

package/dist/ws/deno.js.map

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

package/dist/ws/node.d.ts

@@ -1,10 +1,27 @@
-export { type RawSocket, type WSAdapter, type WSContext, WSContextImpl, type WSHandler } from "./cloudflare.ts";
+export { type RawSocket, type WSAdapter, type WSAdapterOptions, type WSContext, WSContextImpl, type WSHandler, } from "./cloudflare.ts";
 import type { WSAdapter } from "./cloudflare.ts";
+import { type WSAdapterOptions } from "./shared.ts";
+/**
+ * What the Node adapter (`serve()`) puts on `env.__nodeUpgrade`. `upgraded` turns true once the
+ * 101 is written: from then on the socket belongs to `ws`, and the adapter must not write to it.
+ */
+export type NodeUpgradeData = {
+    head: Buffer;
+    req: unknown;
+    socket: unknown;
+    upgraded: boolean;
+};
 type KeepaliveConfig = {
     interval: number;
     timeout: number;
 };
-export declare function nodeWebSocket(opts?: {
+export type NodeWebSocketOptions = WSAdapterOptions & {
+    /** Ping every `interval` ms; a pong missing after `timeout` ms terminates the connection. */
     keepalive?: KeepaliveConfig;
-}): WSAdapter;
+};
+/**
+ * Node.js WebSocket adapter, on the `ws` package (an optional peer dependency). It reads
+ * `env.__nodeUpgrade`, which honey's `serve()` puts there for an upgrade request.
+ */
+export declare function nodeWebSocket(opts?: NodeWebSocketOptions): WSAdapter;
 //# sourceMappingURL=node.d.ts.map

package/dist/ws/node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/ws/node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE/G,OAAO,KAAK,EAAE,SAAS,EAAa,MAAM,iBAAiB,CAAA;AAmC3D,KAAK,eAAe,GAAG;IACtB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;CACf,CAAA;AAED,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,eAAe,CAAA;CAAE,GAAG,SAAS,CAuG/E"}
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/ws/node.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,aAAa,EACb,KAAK,SAAS,GACd,MAAM,iBAAiB,CAAA;AAExB,OAAO,KAAK,EAAE,SAAS,EAAa,MAAM,iBAAiB,CAAA;AAE3D,OAAO,EAKN,KAAK,gBAAgB,EACrB,MAAM,aAAa,CAAA;AA2BpB;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,OAAO,CAAA;IACZ,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,EAAE,OAAO,CAAA;CACjB,CAAA;AAMD,KAAK,eAAe,GAAG;IACtB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;CACf,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,GAAG;IACrD,6FAA6F;IAC7F,SAAS,CAAC,EAAE,eAAe,CAAA;CAC3B,CAAA;AAKD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAmKpE"}

package/dist/ws/node.js

@@ -0,0 +1,173 @@
+export { WSContextImpl, } from "./cloudflare.js";
+import { fireHandler, WSContextImpl } from "./cloudflare.js";
+import { resolveWSOptions, selectProtocol, toArrayBuffer, } from "./shared.js";
+const WS_MISSING = 'WebSocket routes on Node need the "ws" package, which is an optional peer dependency of honey. Install it: npm install ws';
+/**
+ * Node.js WebSocket adapter, on the `ws` package (an optional peer dependency). It reads
+ * `env.__nodeUpgrade`, which honey's `serve()` puts there for an upgrade request.
+ */
+export function nodeWebSocket(opts) {
+    const options = resolveWSOptions(opts);
+    const keepalive = opts?.keepalive;
+    if (keepalive !== undefined && !(keepalive.interval > 0 && keepalive.timeout > 0)) {
+        throw new TypeError("nodeWebSocket: keepalive.interval and keepalive.timeout must be positive");
+    }
+    let wss = null;
+    let wssReady = null;
+    const open = new Set();
+    /* the Request being upgraded, for the protocol callback (ws hands it the IncomingMessage) */
+    let upgrading = null;
+    const ensureWss = () => {
+        if (wss)
+            return Promise.resolve(wss);
+        if (!wssReady) {
+            wssReady = import("ws").then((mod) => {
+                const wsModule = mod;
+                wss = new wsModule.WebSocketServer({
+                    handleProtocols: (protocols) => {
+                        if (protocols.size === 0 || upgrading === null)
+                            return false;
+                        return selectProtocol(upgrading, options) ?? false;
+                    },
+                    maxPayload: options.maxPayload,
+                    noServer: true,
+                    perMessageDeflate: false,
+                });
+                return wss;
+            }, (err) => {
+                /* not cached: installing ws later works without a restart */
+                wssReady = null;
+                throw new Error(WS_MISSING, { cause: err });
+            });
+        }
+        return wssReady;
+    };
+    const watch = (ws) => {
+        let pingTimer;
+        let pongTimeout;
+        let idleTimer;
+        let lastSeen = Date.now();
+        const seen = () => {
+            lastSeen = Date.now();
+        };
+        ws.on("pong", () => {
+            seen();
+            if (pongTimeout !== undefined) {
+                clearTimeout(pongTimeout);
+                pongTimeout = undefined;
+            }
+        });
+        ws.on("ping", seen);
+        if (keepalive) {
+            pingTimer = setInterval(() => {
+                if (ws.readyState !== 1)
+                    return;
+                /* one pong outstanding at a time: a slow pong must not stack timers */
+                if (pongTimeout !== undefined)
+                    return;
+                ws.ping();
+                pongTimeout = setTimeout(() => ws.terminate(), keepalive.timeout);
+            }, keepalive.interval);
+        }
+        const idle = options.idleTimeout;
+        if (idle > 0) {
+            const tick = Math.max(Math.floor(idle / 2), 1);
+            idleTimer = setInterval(() => {
+                if (ws.readyState !== 1)
+                    return;
+                const quiet = Date.now() - lastSeen;
+                if (quiet >= idle)
+                    ws.terminate();
+                else if (quiet >= tick)
+                    ws.ping();
+            }, tick);
+        }
+        const stop = () => {
+            if (pingTimer !== undefined)
+                clearInterval(pingTimer);
+            if (pongTimeout !== undefined)
+                clearTimeout(pongTimeout);
+            if (idleTimer !== undefined)
+                clearInterval(idleTimer);
+            pingTimer = pongTimeout = idleTimer = undefined;
+        };
+        ws.on("close", stop);
+        ws.on("error", stop);
+    };
+    return {
+        closeAll(code, reason) {
+            for (const ws of open) {
+                try {
+                    ws.close(code, reason);
+                }
+                catch {
+                    ws.terminate();
+                }
+            }
+        },
+        options,
+        async upgrade(req, env, handler) {
+            const server = await ensureWss();
+            const upgrade = env.__nodeUpgrade;
+            if (upgrade === undefined) {
+                throw new Error("nodeWebSocket: no upgrade socket; serve the app with honey's serve() on Node");
+            }
+            return new Promise((resolve, reject) => {
+                /* ws answers a malformed handshake itself and never calls back: fail instead of hanging */
+                const sock = upgrade.socket;
+                sock.once?.("close", () => {
+                    if (!upgrade.upgraded)
+                        reject(new Error("WebSocket handshake failed"));
+                });
+                upgrading = req;
+                try {
+                    server.handleUpgrade(upgrade.req, upgrade.socket, upgrade.head, (ws) => {
+                        upgrade.upgraded = true;
+                        ws.binaryType = "arraybuffer";
+                        open.add(ws);
+                        const socket = new WSContextImpl(ws, options);
+                        ws.on("message", (data, isBinary) => {
+                            let payload;
+                            if (!isBinary) {
+                                /* text frame: a string, as on every other runtime */
+                                payload = Buffer.isBuffer(data)
+                                    ? data.toString("utf-8")
+                                    : data instanceof ArrayBuffer
+                                        ? Buffer.from(data).toString("utf-8")
+                                        : Buffer.concat(data).toString("utf-8");
+                            }
+                            else if (data instanceof ArrayBuffer) {
+                                payload = data;
+                            }
+                            else {
+                                payload = toArrayBuffer(Array.isArray(data) ? Buffer.concat(data) : data);
+                            }
+                            fireHandler("message", () => handler.onMessage?.(undefined, socket, payload));
+                        });
+                        watch(ws);
+                        ws.on("close", (code, reason) => {
+                            open.delete(ws);
+                            fireHandler("close", () => handler.onClose?.(undefined, socket, code, reason.toString()));
+                        });
+                        ws.on("error", (err) => {
+                            fireHandler("error", () => handler.onError?.(undefined, socket, err));
+                        });
+                        fireHandler("open", () => handler.onOpen?.(undefined, socket));
+                        /* Node's Response rejects status 101 (Fetch spec: 200-599 only).
+                           Create a valid Response and override status for the sentinel check. */
+                        const resp = new Response(null);
+                        Object.defineProperty(resp, "status", { value: 101 });
+                        resolve({ response: resp, socket });
+                    });
+                }
+                catch (err) {
+                    reject(err);
+                }
+                finally {
+                    upgrading = null;
+                }
+            });
+        },
+    };
+}
+//# sourceMappingURL=node.js.map

package/dist/ws/node.js.map

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

package/dist/ws/session.d.ts

@@ -0,0 +1,11 @@
+import { type InvokeLogger } from "../invoke-user.ts";
+import type { WSHandler } from "./cloudflare.ts";
+/** `callbacks` are the route's own; each receives the route's request context `ctx` first. */
+export declare function createWsSession(opts: {
+    callbacks: WSHandler<unknown>;
+    ctx: unknown;
+    log: InvokeLogger | null;
+    reconnectToken: string | null;
+    route: string;
+}): WSHandler<unknown>;
+//# sourceMappingURL=session.d.ts.map

package/dist/ws/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/ws/session.ts"],"names":[],"mappings":"AAOA,OAAO,EAAgC,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAEnF,OAAO,KAAK,EAAa,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAK3D,8FAA8F;AAC9F,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACrC,SAAS,EAAE,SAAS,CAAC,OAAO,CAAC,CAAA;IAC7B,GAAG,EAAE,OAAO,CAAA;IACZ,GAAG,EAAE,YAAY,GAAG,IAAI,CAAA;IACxB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,KAAK,EAAE,MAAM,CAAA;CACb,GAAG,SAAS,CAAC,OAAO,CAAC,CAiDrB"}

package/dist/ws/session.js

@@ -0,0 +1,60 @@
+/**
+ * The server side of one websocket route connection: the user's callbacks run on one ordered
+ * queue (open, then messages, then close), each contained, with a cap on waiting messages.
+ * Every honey adapter imports this module, which registers it, so the core never bundles it
+ * for an app without websockets.
+ */
+import { registerFeature } from "../feature-slots.js";
+import { createEventQueue, invokeUser } from "../invoke-user.js";
+import { originAllowed } from "../ws-origin.js";
+/** Messages one websocket connection may have waiting for its handler; more close it with 1008. */
+const WS_PENDING_MAX = 1024;
+/** `callbacks` are the route's own; each receives the route's request context `ctx` first. */
+export function createWsSession(opts) {
+    const { callbacks, ctx, log, reconnectToken, route } = opts;
+    const { onClose, onError, onMessage, onOpen, onReconnect } = callbacks;
+    const queue = createEventQueue();
+    let pending = 0;
+    const run = (phase, ws, fn) => invokeUser(fn, {
+        fields: { route },
+        log,
+        onError: onError ? (err) => onError(ctx, ws, err) : null,
+        phase: `websocket ${phase}`,
+    });
+    return {
+        onClose: (_ctx, ws, code, reason) => {
+            if (onClose)
+                void queue.push(() => run("close", ws, () => onClose(ctx, ws, code, reason)));
+        },
+        /* a transport error: tell onError once; if onError throws, that is logged */
+        onError: (_ctx, ws, error) => {
+            void queue.push(() => invokeUser(() => (onError ? onError(ctx, ws, error) : Promise.reject(error)), {
+                fields: { route },
+                log,
+                phase: "websocket error",
+            }));
+        },
+        onMessage: (_ctx, ws, data) => {
+            if (!onMessage)
+                return;
+            if (pending >= WS_PENDING_MAX) {
+                ws.close(1008, "too many pending messages");
+                return;
+            }
+            pending++;
+            void queue.push(() => run("message", ws, () => onMessage(ctx, ws, data)).finally(() => {
+                pending--;
+            }));
+        },
+        onOpen: (_ctx, ws) => {
+            if (reconnectToken && onReconnect) {
+                void queue.push(() => run("open", ws, () => onReconnect(ctx, ws, reconnectToken)));
+            }
+            else if (onOpen) {
+                void queue.push(() => run("open", ws, () => onOpen(ctx, ws)));
+            }
+        },
+    };
+}
+registerFeature("ws", { createWsSession, originAllowed });
+//# sourceMappingURL=session.js.map

package/dist/ws/session.js.map

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