@meekojs/meeko 0.0.3 → 0.1.0

package/dist/framework-server/node-upgrade.d.ts

@@ -0,0 +1,23 @@
+import type { IncomingMessage } from "node:http";
+import type { Duplex } from "node:stream";
+import type { SocketHub, SocketPeer } from "./socket.js";
+/** A WebSocket server library owns framing and the HTTP 101 response. */
+export interface NodeAcceptedSocket {
+    peer: SocketPeer;
+    onMessage(listener: (message: string | Uint8Array) => void): void;
+    onClose(listener: () => void): void;
+}
+export interface NodeSocketUpgradeOptions {
+    hub: SocketHub;
+    /** Fixed public origin; never infer security policy from an untrusted Host header. */
+    publicOrigin: string;
+    pathnamePrefix?: string;
+    upgrade(incoming: IncomingMessage, socket: Duplex, head: Buffer): Promise<NodeAcceptedSocket> | NodeAcceptedSocket;
+    reject?(incoming: IncomingMessage, socket: Duplex, status: number): void;
+    onError?(error: unknown): void;
+}
+/**
+ * Handles the Node `upgrade` event after policy preflight. The host supplies a
+ * WebSocket implementation; this adapter does not implement wire framing.
+ */
+export declare function createNodeSocketUpgradeHandler(options: NodeSocketUpgradeOptions): (incoming: IncomingMessage, socket: Duplex, head: Buffer) => Promise<boolean>;

package/dist/framework-server/node-upgrade.js

@@ -0,0 +1,96 @@
+import { normalizeServerError, observeErrorCallback } from "./contracts.js";
+/**
+ * Handles the Node `upgrade` event after policy preflight. The host supplies a
+ * WebSocket implementation; this adapter does not implement wire framing.
+ */
+export function createNodeSocketUpgradeHandler(options) {
+    const origin = new URL(options.publicOrigin);
+    if (origin.protocol !== "http:" && origin.protocol !== "https:")
+        throw new TypeError("Socket publicOrigin must use HTTP or HTTPS");
+    const prefix = options.pathnamePrefix ?? "/_meeko/socket";
+    if (!prefix.startsWith("/") || prefix.endsWith("/"))
+        throw new TypeError("Invalid socket pathname prefix");
+    const observeError = (error) => observeErrorCallback(error, options.onError);
+    return async (incoming, socket, head) => {
+        let url;
+        try {
+            url = new URL(incoming.url ?? "", origin);
+        }
+        catch {
+            return false;
+        }
+        if (!url.pathname.startsWith(`${prefix}/`))
+            return false;
+        const reject = (status) => { if (options.reject)
+            options.reject(incoming, socket, status);
+        else
+            socket.destroy(); };
+        const name = url.pathname.slice(prefix.length + 1);
+        if (url.origin !== origin.origin || !/^[A-Za-z_$][\w$-]*$/.test(name)) {
+            reject(400);
+            return true;
+        }
+        if (incoming.method !== "GET" || incoming.headers.upgrade?.toLowerCase() !== "websocket") {
+            reject(400);
+            return true;
+        }
+        const headers = new Headers();
+        for (const [key, value] of Object.entries(incoming.headers)) {
+            if (value !== undefined)
+                headers.set(key, Array.isArray(value) ? value.join(", ") : value);
+        }
+        const request = new Request(url, { headers });
+        const roomId = url.searchParams.get("room") ?? undefined;
+        try {
+            await options.hub.preflight(name, request, roomId);
+        }
+        catch (error) {
+            reject(normalizeServerError(error).status);
+            observeError(error);
+            return true;
+        }
+        let accepted;
+        try {
+            accepted = await options.upgrade(incoming, socket, head);
+        }
+        catch (error) {
+            socket.destroy();
+            observeError(error);
+            return true;
+        }
+        try {
+            const connection = await options.hub.accept(name, request, accepted.peer, roomId);
+            let delivery = Promise.resolve();
+            accepted.onMessage((message) => {
+                delivery = delivery.then(() => connection.receive(message)).catch((error) => {
+                    observeError(error);
+                    try {
+                        connection.close(normalizeServerError(error).status < 500 ? 1008 : 1011);
+                    }
+                    catch (closeError) {
+                        observeError(closeError);
+                    }
+                });
+            });
+            accepted.onClose(() => {
+                try {
+                    connection.close();
+                }
+                catch (error) {
+                    observeError(error);
+                }
+            });
+        }
+        catch (error) {
+            try {
+                accepted.peer.close(1008, "Unauthorized");
+            }
+            catch (closeError) {
+                observeError(closeError);
+            }
+            observeError(error);
+        }
+        return true;
+    };
+}
+//# sourceMappingURL=node-upgrade.js.map

package/dist/framework-server/node-upgrade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-upgrade.js","sourceRoot":"","sources":["../../src/framework-server/node-upgrade.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAmB5E;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAAC,OAAiC;IAC9E,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7C,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ;QAAE,MAAM,IAAI,SAAS,CAAC,4CAA4C,CAAC,CAAC;IACnI,MAAM,MAAM,GAAG,OAAO,CAAC,cAAc,IAAI,gBAAgB,CAAC;IAC1D,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,gCAAgC,CAAC,CAAC;IAC3G,MAAM,YAAY,GAAG,CAAC,KAAc,EAAQ,EAAE,CAAC,oBAAoB,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;QACtC,IAAI,GAAQ,CAAC;QACb,IAAI,CAAC;YAAC,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;QAAC,CAAC;QAClD,MAAM,CAAC;YAAC,OAAO,KAAK,CAAC;QAAC,CAAC;QACvB,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QACzD,MAAM,MAAM,GAAG,CAAC,MAAc,EAAE,EAAE,GAAG,IAAI,OAAO,CAAC,MAAM;YAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;;YAAM,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;QAC5H,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACnD,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAAC,OAAO,IAAI,CAAC;QAAC,CAAC;QACpG,IAAI,QAAQ,CAAC,MAAM,KAAK,KAAK,IAAI,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,CAAC;YAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAAC,OAAO,IAAI,CAAC;QAAC,CAAC;QACvH,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;QAC9B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5D,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC7F,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC;QACzD,IAAI,CAAC;YAAC,MAAM,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAAC,CAAC;QAC3D,OAAO,KAAK,EAAE,CAAC;YAAC,MAAM,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC;YAAC,YAAY,CAAC,KAAK,CAAC,CAAC;YAAC,OAAO,IAAI,CAAC;QAAC,CAAC;QAC/F,IAAI,QAA4B,CAAC;QACjC,IAAI,CAAC;YAAC,QAAQ,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QAAC,CAAC;QACjE,OAAO,KAAK,EAAE,CAAC;YAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAAC,YAAY,CAAC,KAAK,CAAC,CAAC;YAAC,OAAO,IAAI,CAAC;QAAC,CAAC;QACrE,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAClF,IAAI,QAAQ,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;YACjC,QAAQ,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE;gBAC7B,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;oBACnF,YAAY,CAAC,KAAK,CAAC,CAAC;oBACpB,IAAI,CAAC;wBAAC,UAAU,CAAC,KAAK,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;oBAAC,CAAC;oBACjF,OAAO,UAAU,EAAE,CAAC;wBAAC,YAAY,CAAC,UAAU,CAAC,CAAC;oBAAC,CAAC;gBAClD,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YACH,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE;gBACpB,IAAI,CAAC;oBAAC,UAAU,CAAC,KAAK,EAAE,CAAC;gBAAC,CAAC;gBAC3B,OAAO,KAAK,EAAE,CAAC;oBAAC,YAAY,CAAC,KAAK,CAAC,CAAC;gBAAC,CAAC;YACxC,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC;gBAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;YAAC,CAAC;YAClD,OAAO,UAAU,EAAE,CAAC;gBAAC,YAAY,CAAC,UAAU,CAAC,CAAC;YAAC,CAAC;YAChD,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import type { IncomingMessage } from \"node:http\";\nimport type { Duplex } from \"node:stream\";\nimport type { SocketHub, SocketPeer } from \"./socket.js\";\nimport { normalizeServerError, observeErrorCallback } from \"./contracts.js\";\n\n/** A WebSocket server library owns framing and the HTTP 101 response. */\nexport interface NodeAcceptedSocket {\n  peer: SocketPeer;\n  onMessage(listener: (message: string | Uint8Array) => void): void;\n  onClose(listener: () => void): void;\n}\n\nexport interface NodeSocketUpgradeOptions {\n  hub: SocketHub;\n  /** Fixed public origin; never infer security policy from an untrusted Host header. */\n  publicOrigin: string;\n  pathnamePrefix?: string;\n  upgrade(incoming: IncomingMessage, socket: Duplex, head: Buffer): Promise<NodeAcceptedSocket> | NodeAcceptedSocket;\n  reject?(incoming: IncomingMessage, socket: Duplex, status: number): void;\n  onError?(error: unknown): void;\n}\n\n/**\n * Handles the Node `upgrade` event after policy preflight. The host supplies a\n * WebSocket implementation; this adapter does not implement wire framing.\n */\nexport function createNodeSocketUpgradeHandler(options: NodeSocketUpgradeOptions): (incoming: IncomingMessage, socket: Duplex, head: Buffer) => Promise<boolean> {\n  const origin = new URL(options.publicOrigin);\n  if (origin.protocol !== \"http:\" && origin.protocol !== \"https:\") throw new TypeError(\"Socket publicOrigin must use HTTP or HTTPS\");\n  const prefix = options.pathnamePrefix ?? \"/_meeko/socket\";\n  if (!prefix.startsWith(\"/\") || prefix.endsWith(\"/\")) throw new TypeError(\"Invalid socket pathname prefix\");\n  const observeError = (error: unknown): void => observeErrorCallback(error, options.onError);\n  return async (incoming, socket, head) => {\n    let url: URL;\n    try { url = new URL(incoming.url ?? \"\", origin); }\n    catch { return false; }\n    if (!url.pathname.startsWith(`${prefix}/`)) return false;\n    const reject = (status: number) => { if (options.reject) options.reject(incoming, socket, status); else socket.destroy(); };\n    const name = url.pathname.slice(prefix.length + 1);\n    if (url.origin !== origin.origin || !/^[A-Za-z_$][\\w$-]*$/.test(name)) { reject(400); return true; }\n    if (incoming.method !== \"GET\" || incoming.headers.upgrade?.toLowerCase() !== \"websocket\") { reject(400); return true; }\n    const headers = new Headers();\n    for (const [key, value] of Object.entries(incoming.headers)) {\n      if (value !== undefined) headers.set(key, Array.isArray(value) ? value.join(\", \") : value);\n    }\n    const request = new Request(url, { headers });\n    const roomId = url.searchParams.get(\"room\") ?? undefined;\n    try { await options.hub.preflight(name, request, roomId); }\n    catch (error) { reject(normalizeServerError(error).status); observeError(error); return true; }\n    let accepted: NodeAcceptedSocket;\n    try { accepted = await options.upgrade(incoming, socket, head); }\n    catch (error) { socket.destroy(); observeError(error); return true; }\n    try {\n      const connection = await options.hub.accept(name, request, accepted.peer, roomId);\n      let delivery = Promise.resolve();\n      accepted.onMessage((message) => {\n        delivery = delivery.then(() => connection.receive(message)).catch((error: unknown) => {\n          observeError(error);\n          try { connection.close(normalizeServerError(error).status < 500 ? 1008 : 1011); }\n          catch (closeError) { observeError(closeError); }\n        });\n      });\n      accepted.onClose(() => {\n        try { connection.close(); }\n        catch (error) { observeError(error); }\n      });\n    } catch (error) {\n      try { accepted.peer.close(1008, \"Unauthorized\"); }\n      catch (closeError) { observeError(closeError); }\n      observeError(error);\n    }\n    return true;\n  };\n}\n"]}

package/dist/framework-server/node-websocket.d.ts

@@ -0,0 +1,16 @@
+import { type Server as HttpServer } from "node:http";
+import type { NodeSocketUpgradeOptions } from "./node-upgrade.js";
+export interface NodeWebSocketOptions extends Omit<NodeSocketUpgradeOptions, "upgrade" | "reject"> {
+    /** The same HTTP server used by the Fetch handler. */
+    server: HttpServer;
+    /** Maximum WebSocket frame payload, enforced before decoding. Defaults to 64 KiB. */
+    maxMessageBytes?: number;
+    /** Ping interval and idle timeout. Defaults to 30 seconds. */
+    heartbeatMs?: number;
+}
+export interface NodeWebSocketServer {
+    /** Detaches the upgrade listener and closes all peers. The HTTP server remains owned by its caller. */
+    close(): Promise<void>;
+}
+/** Attach Meeko channels to a Node HTTP server using ws for protocol framing. */
+export declare function attachNodeWebSocketServer(options: NodeWebSocketOptions): NodeWebSocketServer;

package/dist/framework-server/node-websocket.js

@@ -0,0 +1,127 @@
+import { STATUS_CODES } from "node:http";
+import { createRequire } from "node:module";
+import { createNodeSocketUpgradeHandler } from "./node-upgrade.js";
+import { observeErrorCallback } from "./contracts.js";
+/** Attach Meeko channels to a Node HTTP server using ws for protocol framing. */
+export function attachNodeWebSocketServer(options) {
+    const maxPayload = options.maxMessageBytes ?? 64 * 1024;
+    const heartbeatMs = options.heartbeatMs ?? 30_000;
+    if (!Number.isSafeInteger(maxPayload) || maxPayload <= 0)
+        throw new RangeError("Invalid socket message limit");
+    if (!Number.isSafeInteger(heartbeatMs) || heartbeatMs <= 0)
+        throw new RangeError("Invalid socket heartbeat interval");
+    // Keep the optional server transport out of engine-only and HTTP-only imports.
+    const { WebSocket: WebSocketClass, WebSocketServer } = createRequire(import.meta.url)("ws");
+    const webSockets = new WebSocketServer({ noServer: true, maxPayload, perMessageDeflate: false });
+    const observeError = (error) => observeErrorCallback(error, options.onError);
+    const alive = new WeakMap();
+    let closing = false;
+    let closePromise;
+    const upgrade = (incoming, socket, head) => new Promise((resolve, reject) => {
+        try {
+            webSockets.handleUpgrade(incoming, socket, head, (peer) => {
+                alive.set(peer, true);
+                peer.on("pong", () => alive.set(peer, true));
+                peer.on("error", observeError);
+                const pending = [];
+                let pendingBytes = 0;
+                let messageListener;
+                let closeListener;
+                let didClose = false;
+                peer.on("message", (data, isBinary) => {
+                    if (isBinary) {
+                        peer.close(1003, "Text messages required");
+                        return;
+                    }
+                    const bytes = Array.isArray(data) ? Buffer.concat(data) : Buffer.isBuffer(data) ? data : Buffer.from(data);
+                    if (messageListener) {
+                        messageListener(bytes);
+                        return;
+                    }
+                    pendingBytes += bytes.byteLength;
+                    if (pendingBytes > maxPayload) {
+                        peer.close(1009, "Message buffer exceeded");
+                        return;
+                    }
+                    pending.push(bytes);
+                });
+                peer.once("close", () => { didClose = true; closeListener?.(); });
+                resolve({
+                    peer: {
+                        send(message) {
+                            if (peer.readyState !== WebSocketClass.OPEN)
+                                throw new Error("Socket is disconnected");
+                            peer.send(message);
+                        },
+                        close(code, reason) { if (peer.readyState === WebSocketClass.OPEN)
+                            peer.close(code, reason); },
+                        get bufferedAmount() { return peer.bufferedAmount; },
+                    },
+                    onMessage(listener) {
+                        messageListener = listener;
+                        for (const message of pending)
+                            listener(message);
+                        pending.length = 0;
+                        pendingBytes = 0;
+                    },
+                    onClose(listener) { closeListener = listener; if (didClose)
+                        listener(); },
+                });
+            });
+        }
+        catch (error) {
+            reject(error);
+        }
+    });
+    const bridge = createNodeSocketUpgradeHandler({
+        hub: options.hub,
+        publicOrigin: options.publicOrigin,
+        ...(options.pathnamePrefix ? { pathnamePrefix: options.pathnamePrefix } : {}),
+        upgrade,
+        reject(_incoming, socket, status) {
+            if (!socket.destroyed)
+                socket.end(`HTTP/1.1 ${status} ${STATUS_CODES[status] ?? "Error"}\r\nConnection: close\r\nContent-Length: 0\r\n\r\n`);
+        },
+        ...(options.onError ? { onError: options.onError } : {}),
+    });
+    const onUpgrade = (incoming, socket, head) => {
+        if (closing) {
+            socket.destroy();
+            return;
+        }
+        void bridge(incoming, socket, head).then((handled) => {
+            if (!handled)
+                socket.destroy();
+        }).catch((error) => {
+            observeError(error);
+            socket.destroy();
+        });
+    };
+    options.server.on("upgrade", onUpgrade);
+    const heartbeat = setInterval(() => {
+        for (const peer of webSockets.clients) {
+            if (alive.get(peer) === false) {
+                peer.terminate();
+                continue;
+            }
+            alive.set(peer, false);
+            if (peer.readyState === WebSocketClass.OPEN)
+                peer.ping();
+        }
+    }, heartbeatMs);
+    heartbeat.unref();
+    return {
+        close() {
+            if (closePromise)
+                return closePromise;
+            closing = true;
+            options.server.off("upgrade", onUpgrade);
+            clearInterval(heartbeat);
+            for (const peer of webSockets.clients)
+                peer.terminate();
+            closePromise = new Promise((resolve, reject) => webSockets.close((error) => error ? reject(error) : resolve()));
+            return closePromise;
+        },
+    };
+}
+//# sourceMappingURL=node-websocket.js.map

package/dist/framework-server/node-websocket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-websocket.js","sourceRoot":"","sources":["../../src/framework-server/node-websocket.ts"],"names":[],"mappings":"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","sourcesContent":["import { STATUS_CODES, type IncomingMessage, type Server as HttpServer } from \"node:http\";\nimport { createRequire } from \"node:module\";\nimport type { Duplex } from \"node:stream\";\nimport type WebSocket from \"ws\";\nimport { createNodeSocketUpgradeHandler } from \"./node-upgrade.js\";\nimport { observeErrorCallback } from \"./contracts.js\";\nimport type { NodeAcceptedSocket, NodeSocketUpgradeOptions } from \"./node-upgrade.js\";\n\nexport interface NodeWebSocketOptions extends Omit<NodeSocketUpgradeOptions, \"upgrade\" | \"reject\"> {\n  /** The same HTTP server used by the Fetch handler. */\n  server: HttpServer;\n  /** Maximum WebSocket frame payload, enforced before decoding. Defaults to 64 KiB. */\n  maxMessageBytes?: number;\n  /** Ping interval and idle timeout. Defaults to 30 seconds. */\n  heartbeatMs?: number;\n}\n\nexport interface NodeWebSocketServer {\n  /** Detaches the upgrade listener and closes all peers. The HTTP server remains owned by its caller. */\n  close(): Promise<void>;\n}\n\n/** Attach Meeko channels to a Node HTTP server using ws for protocol framing. */\nexport function attachNodeWebSocketServer(options: NodeWebSocketOptions): NodeWebSocketServer {\n  const maxPayload = options.maxMessageBytes ?? 64 * 1024;\n  const heartbeatMs = options.heartbeatMs ?? 30_000;\n  if (!Number.isSafeInteger(maxPayload) || maxPayload <= 0) throw new RangeError(\"Invalid socket message limit\");\n  if (!Number.isSafeInteger(heartbeatMs) || heartbeatMs <= 0) throw new RangeError(\"Invalid socket heartbeat interval\");\n  // Keep the optional server transport out of engine-only and HTTP-only imports.\n  const { WebSocket: WebSocketClass, WebSocketServer } = createRequire(import.meta.url)(\"ws\") as typeof import(\"ws\");\n  const webSockets = new WebSocketServer({ noServer: true, maxPayload, perMessageDeflate: false });\n  const observeError = (error: unknown): void => observeErrorCallback(error, options.onError);\n  const alive = new WeakMap<WebSocket, boolean>();\n  let closing = false;\n  let closePromise: Promise<void> | undefined;\n\n  const upgrade = (incoming: IncomingMessage, socket: Duplex, head: Buffer): Promise<NodeAcceptedSocket> =>\n    new Promise((resolve, reject) => {\n      try {\n        webSockets.handleUpgrade(incoming, socket, head, (peer) => {\n          alive.set(peer, true);\n          peer.on(\"pong\", () => alive.set(peer, true));\n          peer.on(\"error\", observeError);\n          const pending: Uint8Array[] = [];\n          let pendingBytes = 0;\n          let messageListener: ((message: string | Uint8Array) => void) | undefined;\n          let closeListener: (() => void) | undefined;\n          let didClose = false;\n          peer.on(\"message\", (data, isBinary) => {\n            if (isBinary) { peer.close(1003, \"Text messages required\"); return; }\n            const bytes = Array.isArray(data) ? Buffer.concat(data) : Buffer.isBuffer(data) ? data : Buffer.from(data);\n            if (messageListener) { messageListener(bytes); return; }\n            pendingBytes += bytes.byteLength;\n            if (pendingBytes > maxPayload) { peer.close(1009, \"Message buffer exceeded\"); return; }\n            pending.push(bytes);\n          });\n          peer.once(\"close\", () => { didClose = true; closeListener?.(); });\n          resolve({\n            peer: {\n              send(message) {\n                if (peer.readyState !== WebSocketClass.OPEN) throw new Error(\"Socket is disconnected\");\n                peer.send(message);\n              },\n              close(code, reason) { if (peer.readyState === WebSocketClass.OPEN) peer.close(code, reason); },\n              get bufferedAmount() { return peer.bufferedAmount; },\n            },\n            onMessage(listener) {\n              messageListener = listener;\n              for (const message of pending) listener(message);\n              pending.length = 0;\n              pendingBytes = 0;\n            },\n            onClose(listener) { closeListener = listener; if (didClose) listener(); },\n          });\n        });\n      } catch (error) { reject(error); }\n    });\n\n  const bridge = createNodeSocketUpgradeHandler({\n    hub: options.hub,\n    publicOrigin: options.publicOrigin,\n    ...(options.pathnamePrefix ? { pathnamePrefix: options.pathnamePrefix } : {}),\n    upgrade,\n    reject(_incoming, socket, status) {\n      if (!socket.destroyed) socket.end(`HTTP/1.1 ${status} ${STATUS_CODES[status] ?? \"Error\"}\\r\\nConnection: close\\r\\nContent-Length: 0\\r\\n\\r\\n`);\n    },\n    ...(options.onError ? { onError: options.onError } : {}),\n  });\n  const onUpgrade = (incoming: IncomingMessage, socket: Duplex, head: Buffer): void => {\n    if (closing) { socket.destroy(); return; }\n    void bridge(incoming, socket, head).then((handled) => {\n      if (!handled) socket.destroy();\n    }).catch((error: unknown) => {\n      observeError(error);\n      socket.destroy();\n    });\n  };\n  options.server.on(\"upgrade\", onUpgrade);\n  const heartbeat = setInterval(() => {\n    for (const peer of webSockets.clients) {\n      if (alive.get(peer) === false) { peer.terminate(); continue; }\n      alive.set(peer, false);\n      if (peer.readyState === WebSocketClass.OPEN) peer.ping();\n    }\n  }, heartbeatMs);\n  heartbeat.unref();\n\n  return {\n    close() {\n      if (closePromise) return closePromise;\n      closing = true;\n      options.server.off(\"upgrade\", onUpgrade);\n      clearInterval(heartbeat);\n      for (const peer of webSockets.clients) peer.terminate();\n      closePromise = new Promise<void>((resolve, reject) => webSockets.close((error) => error ? reject(error) : resolve()));\n      return closePromise;\n    },\n  };\n}\n"]}

package/dist/framework-server/openapi.d.ts

@@ -0,0 +1,17 @@
+import type { Schema } from "./contracts.js";
+import type { ServerManifest } from "./discovery.js";
+export interface OpenApiOptions {
+    manifest: ServerManifest;
+    info: {
+        title: string;
+        version: string;
+    };
+    /** Only schemas explicitly exported from shared/schemas belong here. */
+    publicSchemas: Readonly<Record<string, Schema>>;
+    /** For Valibot, supply a converter from @valibot/to-json-schema. */
+    toJsonSchema(schema: Schema): unknown;
+    load?: (file: string) => Promise<unknown>;
+    cookieName?: string;
+}
+/** Generates OpenAPI only from a caller-provided public schema registry. */
+export declare function generateOpenApi(options: OpenApiOptions): Promise<Record<string, unknown>>;

package/dist/framework-server/openapi.js

@@ -0,0 +1,118 @@
+import { pathToFileURL } from "node:url";
+import { serializeJson } from "../server.js";
+function asSchema(value, name) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new Error(`OpenAPI schema ${name} is not representable as JSON Schema`);
+    serializeJson(value);
+    return value;
+}
+function properties(value, name) {
+    if (value.type !== "object" || !value.properties || typeof value.properties !== "object" || Array.isArray(value.properties))
+        throw new Error(`OpenAPI ${name} must convert to an object schema with properties`);
+    const entries = Object.entries(value.properties);
+    const result = {};
+    for (const [key, schema] of entries)
+        result[key] = asSchema(schema, `${name}.${key}`);
+    const required = new Set(Array.isArray(value.required) ? value.required.filter((key) => typeof key === "string") : []);
+    return { properties: result, required };
+}
+function publicPath(pathname) {
+    return pathname.replace(/\[\.\.\.[^\]]+\]/g, () => { throw new Error(`OpenAPI cannot represent catch-all route ${pathname}`); })
+        .replace(/\[([A-Za-z_$][\w$]*)\]/g, "{$1}");
+}
+/** Generates OpenAPI only from a caller-provided public schema registry. */
+export async function generateOpenApi(options) {
+    const load = options.load ?? (async (file) => import(pathToFileURL(file).href));
+    const registry = new Map();
+    for (const [name, schema] of Object.entries(options.publicSchemas)) {
+        if (!/^[A-Za-z_$][\w$]*$/.test(name))
+            throw new Error(`Invalid public schema name: ${name}`);
+        if (registry.has(schema))
+            throw new Error(`Duplicate public schema instance: ${name}`);
+        registry.set(schema, name);
+    }
+    const schemas = {};
+    const ref = (schema, label) => {
+        if (!schema)
+            throw new Error(`OpenAPI ${label} requires a schema`);
+        const name = registry.get(schema);
+        if (!name)
+            throw new Error(`OpenAPI ${label} uses a schema outside publicSchemas`);
+        if (!schemas[name]) {
+            let converted;
+            try {
+                converted = options.toJsonSchema(schema);
+            }
+            catch (error) {
+                throw new Error(`OpenAPI schema ${name} cannot be converted: ${error instanceof Error ? error.message : String(error)}`);
+            }
+            schemas[name] = asSchema(converted, name);
+        }
+        return { $ref: `#/components/schemas/${name}` };
+    };
+    const paths = {};
+    const usePath = (path) => paths[path] ??= {};
+    const requireDefinition = async (file) => {
+        const module = await load(file);
+        if (!module || typeof module !== "object" || !("default" in module) || !module.default || typeof module.default !== "object")
+            throw new Error(`OpenAPI handler has no default definition: ${file}`);
+        return module.default;
+    };
+    for (const endpoint of options.manifest.api) {
+        const definition = await requireDefinition(endpoint.file);
+        if (definition.contentType === "response")
+            throw new Error(`OpenAPI non-JSON response requires an explicit representation: ${endpoint.file}`);
+        const operation = { operationId: `${endpoint.clientKey.replaceAll(".", "_")}_${endpoint.method.toLowerCase()}`, responses: { "200": { description: "OK", content: { "application/json": { schema: ref(definition.response, `${endpoint.file} response`) } } } } };
+        const parameters = [];
+        const routeParams = [...endpoint.pathname.matchAll(/\[([A-Za-z_$][\w$]*)\]/g)].map((match) => match[1]);
+        if (routeParams.length) {
+            const { $ref } = ref(definition.params, `${endpoint.file} params`);
+            const converted = schemas[$ref.slice("#/components/schemas/".length)];
+            const object = properties(converted, `${endpoint.file} params`);
+            for (const name of routeParams) {
+                const schema = object.properties[name];
+                if (!schema)
+                    throw new Error(`OpenAPI path parameter ${name} is missing from ${endpoint.file} params schema`);
+                parameters.push({ in: "path", name, required: true, schema });
+            }
+        }
+        if (definition.query) {
+            const { $ref } = ref(definition.query, `${endpoint.file} query`);
+            const converted = schemas[$ref.slice("#/components/schemas/".length)];
+            const object = properties(converted, `${endpoint.file} query`);
+            for (const [name, schema] of Object.entries(object.properties))
+                parameters.push({ in: "query", name, required: object.required.has(name), schema });
+        }
+        if (parameters.length)
+            operation.parameters = parameters;
+        if (definition.body)
+            operation.requestBody = { required: true, content: { "application/json": { schema: ref(definition.body, `${endpoint.file} body`) } } };
+        if (definition.auth === "required")
+            operation.security = [{ sessionCookie: [] }];
+        const path = publicPath(endpoint.pathname);
+        const item = usePath(path);
+        const method = endpoint.method.toLowerCase();
+        if (item[method])
+            throw new Error(`OpenAPI duplicate operation: ${endpoint.method} ${path}`);
+        item[method] = operation;
+    }
+    for (const endpoint of options.manifest.rpc) {
+        const definition = await requireDefinition(endpoint.file);
+        const item = usePath(endpoint.pathname);
+        if (item.post)
+            throw new Error(`OpenAPI duplicate operation: POST ${endpoint.pathname}`);
+        item.post = {
+            operationId: `rpc_${endpoint.id.replaceAll(".", "_")}`,
+            requestBody: { required: true, content: { "application/json": { schema: ref(definition.input, `${endpoint.file} input`) } } },
+            responses: { "200": { description: "OK", content: { "application/json": { schema: ref(definition.output, `${endpoint.file} output`) } } } },
+            ...(definition.auth === "required" ? { security: [{ sessionCookie: [] }] } : {}),
+        };
+    }
+    return {
+        openapi: "3.1.0",
+        info: options.info,
+        paths,
+        components: { schemas, securitySchemes: { sessionCookie: { type: "apiKey", in: "cookie", name: options.cookieName ?? "__Host-meeko.sid" } } },
+    };
+}
+//# sourceMappingURL=openapi.js.map

package/dist/framework-server/openapi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.js","sourceRoot":"","sources":["../../src/framework-server/openapi.ts"],"names":[],"mappings":"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","sourcesContent":["import { pathToFileURL } from \"node:url\";\nimport type { ApiRouteDefinition, RpcDefinition, Schema } from \"./contracts.js\";\nimport type { ServerManifest } from \"./discovery.js\";\nimport { serializeJson } from \"../server.js\";\n\nexport interface OpenApiOptions {\n  manifest: ServerManifest;\n  info: { title: string; version: string };\n  /** Only schemas explicitly exported from shared/schemas belong here. */\n  publicSchemas: Readonly<Record<string, Schema>>;\n  /** For Valibot, supply a converter from @valibot/to-json-schema. */\n  toJsonSchema(schema: Schema): unknown;\n  load?: (file: string) => Promise<unknown>;\n  cookieName?: string;\n}\n\ntype JsonSchema = Record<string, unknown>;\ntype PathItem = Record<string, unknown>;\n\nfunction asSchema(value: unknown, name: string): JsonSchema {\n  if (!value || typeof value !== \"object\" || Array.isArray(value)) throw new Error(`OpenAPI schema ${name} is not representable as JSON Schema`);\n  serializeJson(value);\n  return value as JsonSchema;\n}\n\nfunction properties(value: JsonSchema, name: string): { properties: Record<string, JsonSchema>; required: Set<string> } {\n  if (value.type !== \"object\" || !value.properties || typeof value.properties !== \"object\" || Array.isArray(value.properties)) throw new Error(`OpenAPI ${name} must convert to an object schema with properties`);\n  const entries = Object.entries(value.properties as Record<string, unknown>);\n  const result: Record<string, JsonSchema> = {};\n  for (const [key, schema] of entries) result[key] = asSchema(schema, `${name}.${key}`);\n  const required = new Set(Array.isArray(value.required) ? value.required.filter((key): key is string => typeof key === \"string\") : []);\n  return { properties: result, required };\n}\n\nfunction publicPath(pathname: string): string {\n  return pathname.replace(/\\[\\.\\.\\.[^\\]]+\\]/g, () => { throw new Error(`OpenAPI cannot represent catch-all route ${pathname}`); })\n    .replace(/\\[([A-Za-z_$][\\w$]*)\\]/g, \"{$1}\");\n}\n\n/** Generates OpenAPI only from a caller-provided public schema registry. */\nexport async function generateOpenApi(options: OpenApiOptions): Promise<Record<string, unknown>> {\n  const load = options.load ?? (async (file: string) => import(pathToFileURL(file).href) as Promise<unknown>);\n  const registry = new Map<Schema, string>();\n  for (const [name, schema] of Object.entries(options.publicSchemas)) {\n    if (!/^[A-Za-z_$][\\w$]*$/.test(name)) throw new Error(`Invalid public schema name: ${name}`);\n    if (registry.has(schema)) throw new Error(`Duplicate public schema instance: ${name}`);\n    registry.set(schema, name);\n  }\n  const schemas: Record<string, JsonSchema> = {};\n  const ref = (schema: Schema | undefined, label: string): { $ref: string } => {\n    if (!schema) throw new Error(`OpenAPI ${label} requires a schema`);\n    const name = registry.get(schema);\n    if (!name) throw new Error(`OpenAPI ${label} uses a schema outside publicSchemas`);\n    if (!schemas[name]) {\n      let converted: unknown;\n      try { converted = options.toJsonSchema(schema); }\n      catch (error) { throw new Error(`OpenAPI schema ${name} cannot be converted: ${error instanceof Error ? error.message : String(error)}`); }\n      schemas[name] = asSchema(converted, name);\n    }\n    return { $ref: `#/components/schemas/${name}` };\n  };\n  const paths: Record<string, PathItem> = {};\n  const usePath = (path: string): PathItem => paths[path] ??= {};\n  const requireDefinition = async (file: string): Promise<Record<string, unknown>> => {\n    const module = await load(file);\n    if (!module || typeof module !== \"object\" || !(\"default\" in module) || !module.default || typeof module.default !== \"object\") throw new Error(`OpenAPI handler has no default definition: ${file}`);\n    return module.default as Record<string, unknown>;\n  };\n  for (const endpoint of options.manifest.api) {\n    const definition = await requireDefinition(endpoint.file) as unknown as ApiRouteDefinition<Schema | undefined, Schema | undefined, Schema | undefined, Schema | undefined>;\n    if (definition.contentType === \"response\") throw new Error(`OpenAPI non-JSON response requires an explicit representation: ${endpoint.file}`);\n    const operation: Record<string, unknown> = { operationId: `${endpoint.clientKey.replaceAll(\".\", \"_\")}_${endpoint.method.toLowerCase()}`, responses: { \"200\": { description: \"OK\", content: { \"application/json\": { schema: ref(definition.response, `${endpoint.file} response`) } } } } };\n    const parameters: Array<Record<string, unknown>> = [];\n    const routeParams = [...endpoint.pathname.matchAll(/\\[([A-Za-z_$][\\w$]*)\\]/g)].map((match) => match[1]!);\n    if (routeParams.length) {\n      const { $ref } = ref(definition.params, `${endpoint.file} params`);\n      const converted = schemas[$ref.slice(\"#/components/schemas/\".length)]!;\n      const object = properties(converted, `${endpoint.file} params`);\n      for (const name of routeParams) {\n        const schema = object.properties[name];\n        if (!schema) throw new Error(`OpenAPI path parameter ${name} is missing from ${endpoint.file} params schema`);\n        parameters.push({ in: \"path\", name, required: true, schema });\n      }\n    }\n    if (definition.query) {\n      const { $ref } = ref(definition.query, `${endpoint.file} query`);\n      const converted = schemas[$ref.slice(\"#/components/schemas/\".length)]!;\n      const object = properties(converted, `${endpoint.file} query`);\n      for (const [name, schema] of Object.entries(object.properties)) parameters.push({ in: \"query\", name, required: object.required.has(name), schema });\n    }\n    if (parameters.length) operation.parameters = parameters;\n    if (definition.body) operation.requestBody = { required: true, content: { \"application/json\": { schema: ref(definition.body, `${endpoint.file} body`) } } };\n    if (definition.auth === \"required\") operation.security = [{ sessionCookie: [] }];\n    const path = publicPath(endpoint.pathname);\n    const item = usePath(path);\n    const method = endpoint.method.toLowerCase();\n    if (item[method]) throw new Error(`OpenAPI duplicate operation: ${endpoint.method} ${path}`);\n    item[method] = operation;\n  }\n  for (const endpoint of options.manifest.rpc) {\n    const definition = await requireDefinition(endpoint.file) as unknown as RpcDefinition<Schema, Schema>;\n    const item = usePath(endpoint.pathname);\n    if (item.post) throw new Error(`OpenAPI duplicate operation: POST ${endpoint.pathname}`);\n    item.post = {\n      operationId: `rpc_${endpoint.id.replaceAll(\".\", \"_\")}`,\n      requestBody: { required: true, content: { \"application/json\": { schema: ref(definition.input, `${endpoint.file} input`) } } },\n      responses: { \"200\": { description: \"OK\", content: { \"application/json\": { schema: ref(definition.output, `${endpoint.file} output`) } } } },\n      ...(definition.auth === \"required\" ? { security: [{ sessionCookie: [] }] } : {}),\n    };\n  }\n  return {\n    openapi: \"3.1.0\",\n    info: options.info,\n    paths,\n    components: { schemas, securitySchemes: { sessionCookie: { type: \"apiKey\", in: \"cookie\", name: options.cookieName ?? \"__Host-meeko.sid\" } } },\n  };\n}\n"]}

package/dist/framework-server/session-stores.d.ts

@@ -0,0 +1,73 @@
+import type { SessionRecord, SessionStore } from "./sessions.js";
+/** Small interface compatible with Redis clients that support SET PX. */
+export interface RedisSessionClient {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, options: {
+        PX: number;
+    }): Promise<unknown>;
+    del(key: string): Promise<unknown>;
+    eval(script: string, options: {
+        keys: string[];
+        arguments: string[];
+    }): Promise<unknown>;
+    quit?(): Promise<unknown>;
+}
+export interface RedisSessionStoreOptions {
+    /** Use a unique prefix for each application and environment. */
+    prefix: string;
+    /** Close the Redis client when this store owns its connection. */
+    closeClient?: boolean;
+}
+/** Persistent store with Redis-managed expiration and explicit connection ownership. */
+export declare class RedisSessionStore<T = unknown> implements SessionStore<T> {
+    private readonly client;
+    private readonly options;
+    readonly persistent = true;
+    constructor(client: RedisSessionClient, options: RedisSessionStoreOptions);
+    private key;
+    private familyKey;
+    get(id: string): Promise<SessionRecord<T> | undefined>;
+    set(record: SessionRecord<T>): Promise<void>;
+    delete(id: string): Promise<void>;
+    replace(previousId: string, record: SessionRecord<T>): Promise<boolean>;
+    revokeFamily(familyId: string): Promise<void>;
+    close(): Promise<void>;
+}
+/** A driver can implement these operations using any SQL client and dialect. */
+export interface SqlSessionRow {
+    id: string;
+    /** Migrate existing rows by setting family_id = id before deploying this driver. */
+    familyId: string;
+    csrfToken: string;
+    dataJson: string;
+    createdAt: number;
+    expiresAt: number;
+}
+export interface SqlSessionDriver {
+    read(id: string): Promise<SqlSessionRow | undefined>;
+    /** Insert or update one row, keyed by its opaque id; enforce one active id per family. */
+    write(row: SqlSessionRow): Promise<void>;
+    remove(id: string): Promise<void>;
+    /** Atomically replace an unexpired row of the same family in one transaction. */
+    replace(previousId: string, row: SqlSessionRow, now: number): Promise<boolean>;
+    /** Delete the active row for this family in one atomic operation, including stale-handle logout. */
+    revokeFamily(familyId: string): Promise<void>;
+    close?(): Promise<void>;
+}
+export interface SqlSessionStoreOptions {
+    /** Close the SQL driver when this store owns its connection. */
+    closeDriver?: boolean;
+}
+/** Generic SQL store. The application supplies SQL statements through its driver. */
+export declare class SqlSessionStore<T = unknown> implements SessionStore<T> {
+    private readonly driver;
+    private readonly options;
+    readonly persistent = true;
+    constructor(driver: SqlSessionDriver, options?: SqlSessionStoreOptions);
+    get(id: string): Promise<SessionRecord<T> | undefined>;
+    set(record: SessionRecord<T>): Promise<void>;
+    delete(id: string): Promise<void>;
+    replace(previousId: string, record: SessionRecord<T>): Promise<boolean>;
+    revokeFamily(familyId: string): Promise<void>;
+    close(): Promise<void>;
+}