@statewalker/cellb 0.0.0-stage → 0.1.1

package/dist/transport/cells-http.js

@@ -0,0 +1,141 @@
+import { serializeError } from "@statewalker/webrun-streams";
+import { toAnotherNode } from "../core/handles.js";
+import { DurableObjectNamespace } from "../core/namespace.js";
+import { withUrl } from "../core/request-body.js";
+import { v8Codec } from "../v8/codec.js";
+import { takeClientPort } from "../ws/server.js";
+import { withHeaders, withUpgrade } from "../ws/upgrade.js";
+import { control, H, httpEndpoint, keepUpgrade, postVia, withScheme, } from "./cells-link.js";
+/**
+ * Everything a remote caller can do with a cell host is expressed as HTTP:
+ * worker ingress, `stub.fetch()`, JS-RPC calls and the bindings descriptor.
+ * The resulting `(Request) ⇒ Response` handler can then ride ANY webrun-wire
+ * transport: a MessagePort (webrun-rpc), a WebSocket (webrun-streams-ws),
+ * WebRTC / libp2p peers (httpeers) — via webrun-http-streams' Duplex seam.
+ *
+ * Control headers mark internal requests. TRUST MODEL: this handler is for an
+ * internal link (page ⇄ worker, owner ⇄ forwarder). Public ingress must call
+ * `runtime.fetch` directly, never this handler, or clients could address
+ * objects without going through the Worker's own routing.
+ */
+const CT_VALUES = "application/x-cellb-values";
+/** Server side: exposes a runtime as one HTTP handler. */
+export function errorResponse(e, status = 500) {
+    return Response.json(serializeError(e), { status, headers: { [H.kind]: "error" } });
+}
+export function cellsHttpHandler(runtime, opts = {}) {
+    const codec = opts.codec ?? v8Codec; // the runtime's default: V8 serialization
+    return async (incoming) => {
+        const req = await restoreScheme(incoming);
+        const kind = req.headers.get(H.kind);
+        if (!kind) {
+            const cookie = req.headers.get(H.cookie);
+            if (cookie === null)
+                return runtime.fetch(stripControl(req));
+            // From a ServiceWorker: the cookies in, the Worker's Set-Cookie out, under H.cookie and
+            // H.setCookie (a browser drops both headers from every Request and Response it builds).
+            const inner = cookie ? withHeaders(stripControl(req), { cookie }) : stripControl(req);
+            return tunnelSetCookies(await runtime.fetch(inner));
+        }
+        try {
+            if (kind === "describe")
+                return Response.json({
+                    bindings: runtime.durableObjectBindings,
+                    // The far side derives the same ids only with the same namespace keys.
+                    keys: Object.fromEntries(Object.keys(runtime.durableObjectBindings).map((b) => [
+                        b,
+                        runtime.env[b].namespaceKey,
+                    ])),
+                });
+            const stub = stubOf(runtime, req.headers.get(H.binding) ?? "", req.headers.get(H.target) ?? "");
+            if (kind === "fetch") {
+                const wsId = req.headers.get(H.ws);
+                let inner = stripControl(req);
+                const upgrade = req.headers.get(H.upgrade);
+                if (upgrade) {
+                    const offered = req.headers.get(H.wsProtocol);
+                    inner = withUpgrade(inner, upgrade, offered ? { "Sec-WebSocket-Protocol": offered } : undefined);
+                }
+                const res = (await stub.fetch(inner));
+                if (res.status !== 101 || !res.webSocket)
+                    return res;
+                if (!wsId || !opts.onUpgrade)
+                    throw new Error("WebSocket upgrade cannot cross this link (no control channel)");
+                const protocol = res.headers.get("Sec-WebSocket-Protocol") ?? undefined;
+                opts.onUpgrade(wsId, takeClientPort(res.webSocket), protocol);
+                return new Response(null, {
+                    status: 200,
+                    headers: {
+                        [H.wsAccepted]: wsId,
+                        ...(protocol ? { "Sec-WebSocket-Protocol": protocol } : {}),
+                    },
+                });
+            }
+            if (kind === "rpc") {
+                const args = codec.decode(new Uint8Array(await req.arrayBuffer()));
+                const result = await stub[req.headers.get(H.method) ?? ""](...args);
+                return new Response(codec.encode(toAnotherNode(result)), {
+                    headers: { "content-type": CT_VALUES },
+                });
+            }
+            throw new Error(`Unknown cellb request kind "${kind}"`);
+        }
+        catch (e) {
+            return errorResponse(e);
+        }
+    };
+}
+function stubOf(runtime, binding, target) {
+    const ns = runtime.env[binding];
+    if (!(ns instanceof DurableObjectNamespace))
+        throw new Error(`Unknown Durable Object binding "${binding}"`);
+    if (target.startsWith("name:"))
+        return ns.getByName(target.slice(5));
+    if (target.startsWith("id:"))
+        return ns.get(ns.idFromString(target.slice(3)));
+    throw new Error(`Invalid Durable Object target "${target}"`);
+}
+/** Client side over any `send` (fetchOverDuplex over a port / WebSocket / peer, or the handler itself). */
+export async function remoteRuntime(send, opts = {}) {
+    const codec = opts.codec ?? v8Codec; // the runtime's default: V8 serialization
+    const post = postVia(send);
+    const described = await post(control("describe", {}));
+    const { bindings, keys } = (await described.json());
+    const env = {};
+    for (const [binding, className] of Object.entries(bindings))
+        env[binding] = new DurableObjectNamespace(keys?.[binding] ?? className, (id) => () => httpEndpoint(post, codec, binding, className, id));
+    return { env, fetch: (req) => send(withScheme(req)) };
+}
+async function restoreScheme(req) {
+    const proto = req.headers.get(H.proto);
+    if (!proto)
+        return req;
+    const url = new URL(req.url);
+    if (url.protocol === `${proto}:`)
+        return req;
+    url.protocol = `${proto}:`;
+    return keepUpgrade(req, await withUrl(req, url));
+}
+/** The Set-Cookie values of a response as one H.setCookie header (status 101 left as it is). */
+function tunnelSetCookies(res) {
+    const cookies = res.status === 101 ? [] : (res.headers.getSetCookie?.() ?? []);
+    if (!cookies.length)
+        return res;
+    const headers = new Headers();
+    for (const [k, v] of res.headers)
+        if (k !== "set-cookie")
+            headers.append(k, v);
+    headers.set(H.setCookie, cookies.map(encodeURIComponent).join(","));
+    return new Response(res.body, { status: res.status, statusText: res.statusText, headers });
+}
+export function stripControl(req, keep = []) {
+    const headers = new Headers(req.headers);
+    let changed = false;
+    for (const h of Object.values(H))
+        if (headers.has(h) && !keep.includes(h))
+            headers.delete(h), (changed = true);
+    if (!changed)
+        return req;
+    return keepUpgrade(req, new Request(req, { headers })); // keeps the body in Firefox too (addHeaders)
+}
+//# sourceMappingURL=cells-http.js.map

package/dist/transport/cells-http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cells-http.js","sourceRoot":"","sources":["../../src/transport/cells-http.ts"],"names":[],"mappings":"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","sourcesContent":["import { serializeError } from \"@statewalker/webrun-streams\";\nimport { toAnotherNode } from \"../core/handles.js\";\nimport { DurableObjectNamespace, type DurableObjectStub } from \"../core/namespace.js\";\nimport { withUrl } from \"../core/request-body.js\";\nimport type { CellRuntime } from \"../core/runtime.js\";\nimport type { ValueCodec } from \"../ports.js\";\nimport { v8Codec } from \"../v8/codec.js\";\nimport { type CfWebSocket, takeClientPort } from \"../ws/server.js\";\nimport { withHeaders, withUpgrade } from \"../ws/upgrade.js\";\nimport {\n  control,\n  H,\n  httpEndpoint,\n  keepUpgrade,\n  postVia,\n  type Send,\n  withScheme,\n} from \"./cells-link.js\";\n\n/**\n * Everything a remote caller can do with a cell host is expressed as HTTP:\n * worker ingress, `stub.fetch()`, JS-RPC calls and the bindings descriptor.\n * The resulting `(Request) ⇒ Response` handler can then ride ANY webrun-wire\n * transport: a MessagePort (webrun-rpc), a WebSocket (webrun-streams-ws),\n * WebRTC / libp2p peers (httpeers) — via webrun-http-streams' Duplex seam.\n *\n * Control headers mark internal requests. TRUST MODEL: this handler is for an\n * internal link (page ⇄ worker, owner ⇄ forwarder). Public ingress must call\n * `runtime.fetch` directly, never this handler, or clients could address\n * objects without going through the Worker's own routing.\n */\nconst CT_VALUES = \"application/x-cellb-values\";\n\nexport interface CellsHttpOptions {\n  codec?: ValueCodec;\n  /**\n   * A stub.fetch answered 101 with a WebSocket: hand the client end's port to the\n   * caller out of band (the HTTP link cannot carry ports). Without it, WebSocket\n   * upgrades cannot cross this link.\n   */\n  onUpgrade?: (id: string, port: MessagePort, protocol?: string) => void;\n}\n\n/** Server side: exposes a runtime as one HTTP handler. */\nexport function errorResponse(e: unknown, status = 500): Response {\n  return Response.json(serializeError(e), { status, headers: { [H.kind]: \"error\" } });\n}\n\nexport function cellsHttpHandler(\n  runtime: CellRuntime,\n  opts: CellsHttpOptions = {},\n): (req: Request) => Promise<Response> {\n  const codec = opts.codec ?? v8Codec; // the runtime's default: V8 serialization\n  return async (incoming) => {\n    const req = await restoreScheme(incoming);\n    const kind = req.headers.get(H.kind);\n    if (!kind) {\n      const cookie = req.headers.get(H.cookie);\n      if (cookie === null) return runtime.fetch(stripControl(req));\n      // From a ServiceWorker: the cookies in, the Worker's Set-Cookie out, under H.cookie and\n      // H.setCookie (a browser drops both headers from every Request and Response it builds).\n      const inner = cookie ? withHeaders(stripControl(req), { cookie }) : stripControl(req);\n      return tunnelSetCookies(await runtime.fetch(inner));\n    }\n    try {\n      if (kind === \"describe\")\n        return Response.json({\n          bindings: runtime.durableObjectBindings,\n          // The far side derives the same ids only with the same namespace keys.\n          keys: Object.fromEntries(\n            Object.keys(runtime.durableObjectBindings).map((b) => [\n              b,\n              (runtime.env[b] as { namespaceKey?: string }).namespaceKey,\n            ]),\n          ),\n        });\n      const stub = stubOf(\n        runtime,\n        req.headers.get(H.binding) ?? \"\",\n        req.headers.get(H.target) ?? \"\",\n      );\n      if (kind === \"fetch\") {\n        const wsId = req.headers.get(H.ws);\n        let inner = stripControl(req);\n        const upgrade = req.headers.get(H.upgrade);\n        if (upgrade) {\n          const offered = req.headers.get(H.wsProtocol);\n          inner = withUpgrade(\n            inner,\n            upgrade,\n            offered ? { \"Sec-WebSocket-Protocol\": offered } : undefined,\n          );\n        }\n        const res = (await stub.fetch(inner)) as Response & { webSocket?: CfWebSocket | null };\n        if (res.status !== 101 || !res.webSocket) return res;\n        if (!wsId || !opts.onUpgrade)\n          throw new Error(\"WebSocket upgrade cannot cross this link (no control channel)\");\n        const protocol = res.headers.get(\"Sec-WebSocket-Protocol\") ?? undefined;\n        opts.onUpgrade(wsId, takeClientPort(res.webSocket), protocol);\n        return new Response(null, {\n          status: 200,\n          headers: {\n            [H.wsAccepted]: wsId,\n            ...(protocol ? { \"Sec-WebSocket-Protocol\": protocol } : {}),\n          },\n        });\n      }\n      if (kind === \"rpc\") {\n        const args = codec.decode(new Uint8Array(await req.arrayBuffer())) as unknown[];\n        const result = await stub[req.headers.get(H.method) ?? \"\"](...args);\n        return new Response(codec.encode(toAnotherNode(result)) as BodyInit, {\n          headers: { \"content-type\": CT_VALUES },\n        });\n      }\n      throw new Error(`Unknown cellb request kind \"${kind}\"`);\n    } catch (e) {\n      return errorResponse(e);\n    }\n  };\n}\n\nfunction stubOf(runtime: CellRuntime, binding: string, target: string): DurableObjectStub {\n  const ns = runtime.env[binding];\n  if (!(ns instanceof DurableObjectNamespace))\n    throw new Error(`Unknown Durable Object binding \"${binding}\"`);\n  if (target.startsWith(\"name:\")) return ns.getByName(target.slice(5));\n  if (target.startsWith(\"id:\")) return ns.get(ns.idFromString(target.slice(3)));\n  throw new Error(`Invalid Durable Object target \"${target}\"`);\n}\n\nexport interface RemoteRuntime {\n  /** Ingress into the remote Worker's default fetch handler. */\n  fetch(req: Request): Promise<Response>;\n  /** Namespaces whose stubs send HTTP over the link (idFromName computed locally). */\n  readonly env: Record<string, DurableObjectNamespace>;\n}\n\n/** Client side over any `send` (fetchOverDuplex over a port / WebSocket / peer, or the handler itself). */\nexport async function remoteRuntime(\n  send: Send,\n  opts: CellsHttpOptions = {},\n): Promise<RemoteRuntime> {\n  const codec = opts.codec ?? v8Codec; // the runtime's default: V8 serialization\n  const post = postVia(send);\n  const described = await post(control(\"describe\", {}));\n  const { bindings, keys } = (await described.json()) as {\n    bindings: Record<string, string>;\n    keys?: Record<string, string>;\n  };\n  const env: Record<string, DurableObjectNamespace> = {};\n  for (const [binding, className] of Object.entries(bindings))\n    env[binding] = new DurableObjectNamespace(\n      keys?.[binding] ?? className,\n      (id) => () => httpEndpoint(post, codec, binding, className, id),\n    );\n  return { env, fetch: (req) => send(withScheme(req)) };\n}\n\nasync function restoreScheme(req: Request): Promise<Request> {\n  const proto = req.headers.get(H.proto);\n  if (!proto) return req;\n  const url = new URL(req.url);\n  if (url.protocol === `${proto}:`) return req;\n  url.protocol = `${proto}:`;\n  return keepUpgrade(req, await withUrl(req, url));\n}\n\n/** The Set-Cookie values of a response as one H.setCookie header (status 101 left as it is). */\nfunction tunnelSetCookies(res: Response): Response {\n  const cookies = res.status === 101 ? [] : (res.headers.getSetCookie?.() ?? []);\n  if (!cookies.length) return res;\n  const headers = new Headers();\n  for (const [k, v] of res.headers) if (k !== \"set-cookie\") headers.append(k, v);\n  headers.set(H.setCookie, cookies.map(encodeURIComponent).join(\",\"));\n  return new Response(res.body, { status: res.status, statusText: res.statusText, headers });\n}\n\nexport function stripControl(req: Request, keep: string[] = []): Request {\n  const headers = new Headers(req.headers);\n  let changed = false;\n  for (const h of Object.values(H))\n    if (headers.has(h) && !keep.includes(h)) headers.delete(h), (changed = true);\n  if (!changed) return req;\n  return keepUpgrade(req, new Request(req, { headers })); // keeps the body in Firefox too (addHeaders)\n}\n"]}

package/dist/transport/cells-link.d.ts

@@ -0,0 +1,27 @@
+import type { DurableObjectId } from "../core/id.js";
+import type { ObjectEndpoint } from "../core/namespace.js";
+import type { ValueCodec } from "../ports.js";
+/** Control headers that mark internal requests on a cells-http link (see cells-http.ts). */
+export declare const H: {
+    readonly kind: "x-cellb";
+    readonly binding: "x-cellb-binding";
+    readonly target: "x-cellb-target";
+    readonly method: "x-cellb-method";
+    readonly proto: "x-cellb-proto";
+    readonly ws: "x-cellb-ws";
+    readonly wsAccepted: "x-cellb-ws-accepted";
+    readonly upgrade: "x-cellb-upgrade";
+    readonly wsProtocol: "x-cellb-ws-protocol";
+    readonly shard: "x-cellb-shard";
+    readonly cookie: "x-cellb-cookie";
+    readonly setCookie: "x-cellb-set-cookie";
+};
+export type Send = (req: Request) => Promise<Response>;
+/** A `send` that carries the scheme and turns `x-cellb: error` responses back into exceptions. */
+export declare function postVia(send: Send): Send;
+/** Stub endpoint whose object lives behind `post` (another worker, tab or peer). */
+export declare function httpEndpoint(post: Send, codec: ValueCodec, binding: string, className: string, id: DurableObjectId): ObjectEndpoint;
+export declare function control(kind: string, headers: Record<string, string>, body?: Uint8Array): Request;
+/** Browsers drop the forbidden `Upgrade` header from every rebuilt Request: carry it over. */
+export declare function keepUpgrade(from: Request, to: Request): Request;
+export declare function withScheme(req: Request): Request;

package/dist/transport/cells-link.js

@@ -0,0 +1,71 @@
+import { deserializeError } from "@statewalker/webrun-streams";
+import { toAnotherNode } from "../core/handles.js";
+import { carryWebSocketHeaders } from "../ws/upgrade.js";
+/** Control headers that mark internal requests on a cells-http link (see cells-http.ts). */
+export const H = {
+    kind: "x-cellb", // "describe" | "fetch" | "rpc" | "error" (response)
+    binding: "x-cellb-binding",
+    target: "x-cellb-target", // "name:<n>" | "id:<hex>"
+    method: "x-cellb-method",
+    proto: "x-cellb-proto", // original scheme (the HTTP/1.1 wire drops it)
+    ws: "x-cellb-ws", // request: id under which the caller awaits a WebSocket port
+    wsAccepted: "x-cellb-ws-accepted", // response: the port was handed over (control channel)
+    upgrade: "x-cellb-upgrade", // `Upgrade` is hop-by-hop: dropped by the HTTP/1.1 wire, carried here
+    wsProtocol: "x-cellb-ws-protocol", // `Sec-WebSocket-Protocol` is forbidden in browser Requests
+    shard: "x-cellb-shard", // the shard that owns the target, as the sending shard computed it
+    // Ingress from a browser (a ServiceWorker): `Cookie` is forbidden in browser Requests and
+    // `Set-Cookie` in browser Responses, so the page's cookies travel here, and the Worker's
+    // Set-Cookie values come back URI-encoded and comma-separated (browser-cookies.ts).
+    cookie: "x-cellb-cookie",
+    setCookie: "x-cellb-set-cookie",
+};
+/** A `send` that carries the scheme and turns `x-cellb: error` responses back into exceptions. */
+export function postVia(send) {
+    return async (req) => {
+        const res = await send(withScheme(req));
+        if (res.headers.get(H.kind) === "error")
+            throw deserializeError(await res.json());
+        return res;
+    };
+}
+/** Stub endpoint whose object lives behind `post` (another worker, tab or peer). */
+export function httpEndpoint(post, codec, binding, className, id) {
+    // By name when the id came from one (only idFromName() sets `name`): keeps ctx.id.name
+    // on the far side, which derives the same id with the same namespace key.
+    const target = id.name !== undefined ? `name:${id.name}` : `id:${id}`;
+    const base = { [H.binding]: binding, [H.target]: target };
+    return {
+        // Not the caller's abort signal: an aborted caller does not cancel a local object's
+        // fetch() either (the object answers, nobody reads), so neither does a remote one.
+        fetch: (req) => post(addHeaders(req, { [H.kind]: "fetch", ...base }, { detach: true })),
+        async call(method, args) {
+            const res = await post(control("rpc", { ...base, [H.method]: method }, codec.encode(toAnotherNode(args))));
+            return codec.decode(new Uint8Array(await res.arrayBuffer()));
+        },
+    };
+}
+export function control(kind, headers, body) {
+    return new Request("http://cellb.internal/", {
+        method: body ? "POST" : "GET",
+        headers: { [H.kind]: kind, ...headers },
+        body: body,
+    });
+}
+/**
+ * Re-creates a request with extra headers, streaming its body through. The request itself is the
+ * source, not `body: req.body`: Firefox has no `Request.body`, so that would drop the body there.
+ */
+function addHeaders(req, extra, opts = {}) {
+    const headers = new Headers(req.headers);
+    for (const [k, v] of Object.entries(extra))
+        headers.set(k, v);
+    return keepUpgrade(req, new Request(req, opts.detach ? { headers, signal: null } : { headers }));
+}
+/** Browsers drop the forbidden `Upgrade` header from every rebuilt Request: carry it over. */
+export function keepUpgrade(from, to) {
+    return carryWebSocketHeaders(from.headers, to);
+}
+export function withScheme(req) {
+    return addHeaders(req, { [H.proto]: new URL(req.url).protocol.replace(":", "") });
+}
+//# sourceMappingURL=cells-link.js.map

package/dist/transport/cells-link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cells-link.js","sourceRoot":"","sources":["../../src/transport/cells-link.ts"],"names":[],"mappings":"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","sourcesContent":["import { deserializeError } from \"@statewalker/webrun-streams\";\nimport { toAnotherNode } from \"../core/handles.js\";\nimport type { DurableObjectId } from \"../core/id.js\";\nimport type { ObjectEndpoint } from \"../core/namespace.js\";\nimport type { ValueCodec } from \"../ports.js\";\nimport { carryWebSocketHeaders } from \"../ws/upgrade.js\";\n\n/** Control headers that mark internal requests on a cells-http link (see cells-http.ts). */\nexport const H = {\n  kind: \"x-cellb\", // \"describe\" | \"fetch\" | \"rpc\" | \"error\" (response)\n  binding: \"x-cellb-binding\",\n  target: \"x-cellb-target\", // \"name:<n>\" | \"id:<hex>\"\n  method: \"x-cellb-method\",\n  proto: \"x-cellb-proto\", // original scheme (the HTTP/1.1 wire drops it)\n  ws: \"x-cellb-ws\", // request: id under which the caller awaits a WebSocket port\n  wsAccepted: \"x-cellb-ws-accepted\", // response: the port was handed over (control channel)\n  upgrade: \"x-cellb-upgrade\", // `Upgrade` is hop-by-hop: dropped by the HTTP/1.1 wire, carried here\n  wsProtocol: \"x-cellb-ws-protocol\", // `Sec-WebSocket-Protocol` is forbidden in browser Requests\n  shard: \"x-cellb-shard\", // the shard that owns the target, as the sending shard computed it\n  // Ingress from a browser (a ServiceWorker): `Cookie` is forbidden in browser Requests and\n  // `Set-Cookie` in browser Responses, so the page's cookies travel here, and the Worker's\n  // Set-Cookie values come back URI-encoded and comma-separated (browser-cookies.ts).\n  cookie: \"x-cellb-cookie\",\n  setCookie: \"x-cellb-set-cookie\",\n} as const;\n\nexport type Send = (req: Request) => Promise<Response>;\n\n/** A `send` that carries the scheme and turns `x-cellb: error` responses back into exceptions. */\nexport function postVia(send: Send): Send {\n  return async (req) => {\n    const res = await send(withScheme(req));\n    if (res.headers.get(H.kind) === \"error\") throw deserializeError(await res.json());\n    return res;\n  };\n}\n\n/** Stub endpoint whose object lives behind `post` (another worker, tab or peer). */\nexport function httpEndpoint(\n  post: Send,\n  codec: ValueCodec,\n  binding: string,\n  className: string,\n  id: DurableObjectId,\n): ObjectEndpoint {\n  // By name when the id came from one (only idFromName() sets `name`): keeps ctx.id.name\n  // on the far side, which derives the same id with the same namespace key.\n  const target = id.name !== undefined ? `name:${id.name}` : `id:${id}`;\n  const base = { [H.binding]: binding, [H.target]: target };\n  return {\n    // Not the caller's abort signal: an aborted caller does not cancel a local object's\n    // fetch() either (the object answers, nobody reads), so neither does a remote one.\n    fetch: (req) => post(addHeaders(req, { [H.kind]: \"fetch\", ...base }, { detach: true })),\n    async call(method, args) {\n      const res = await post(\n        control(\"rpc\", { ...base, [H.method]: method }, codec.encode(toAnotherNode(args))),\n      );\n      return codec.decode(new Uint8Array(await res.arrayBuffer()));\n    },\n  };\n}\n\nexport function control(kind: string, headers: Record<string, string>, body?: Uint8Array): Request {\n  return new Request(\"http://cellb.internal/\", {\n    method: body ? \"POST\" : \"GET\",\n    headers: { [H.kind]: kind, ...headers },\n    body: body as BodyInit | undefined,\n  });\n}\n\n/**\n * Re-creates a request with extra headers, streaming its body through. The request itself is the\n * source, not `body: req.body`: Firefox has no `Request.body`, so that would drop the body there.\n */\nfunction addHeaders(\n  req: Request,\n  extra: Record<string, string>,\n  opts: { detach?: boolean } = {},\n): Request {\n  const headers = new Headers(req.headers);\n  for (const [k, v] of Object.entries(extra)) headers.set(k, v);\n  return keepUpgrade(req, new Request(req, opts.detach ? { headers, signal: null } : { headers }));\n}\n\n/** Browsers drop the forbidden `Upgrade` header from every rebuilt Request: carry it over. */\nexport function keepUpgrade(from: Request, to: Request): Request {\n  return carryWebSocketHeaders(from.headers, to);\n}\n\nexport function withScheme(req: Request): Request {\n  return addHeaders(req, { [H.proto]: new URL(req.url).protocol.replace(\":\", \"\") });\n}\n"]}

package/dist/transport/port.d.ts

@@ -0,0 +1,26 @@
+import { overPipe } from "@statewalker/webrun-rpc";
+import type { CellRuntime } from "../core/runtime.js";
+import { type CellsHttpOptions, type RemoteRuntime } from "./cells-http.js";
+import { type Send } from "./cells-link.js";
+/**
+ * A DEDICATED message pipe (MessagePort, or a worker_threads port). Don't pass a
+ * Worker object that also carries other messages — transfer a MessageChannel port.
+ */
+export type CellPort = Parameters<typeof overPipe>[0];
+/**
+ * Cell-host side: serves the runtime's HTTP surface over a port with
+ * webrun-rpc (mux + backpressure) and webrun-http-streams (HTTP/1.1 on the
+ * Duplex, streaming bodies). Resolves to an async disposer.
+ */
+export declare function serveRuntime(port: CellPort, runtime: CellRuntime, opts?: CellsHttpOptions): Promise<() => Promise<void>>;
+/** Front side (page, SW bridge, another tab): a RemoteRuntime over a port. */
+export declare function connectRuntime(port: CellPort, opts?: CellsHttpOptions): Promise<RemoteRuntime & {
+    close(): Promise<void>;
+}>;
+/** Serves any HTTP handler over a port (responder side of a link). */
+export declare function serveHandlerOverPort(port: CellPort, handler: Send): Promise<() => Promise<void>>;
+/** A `send` over a port (initiator side of a link); the scheme rides in a header. */
+export declare function linkOverPort(port: CellPort): Promise<{
+    send: Send;
+    close(): Promise<void>;
+}>;

package/dist/transport/port.js

@@ -0,0 +1,100 @@
+import { fetchOverDuplex, serveFetchOverDuplex } from "@statewalker/webrun-http-streams";
+import { connect, overPipe, serve, structuredCodec } from "@statewalker/webrun-rpc";
+import { cellsHttpHandler, remoteRuntime, } from "./cells-http.js";
+import { withScheme } from "./cells-link.js";
+/**
+ * Multiplexed ports per link: one per exchange in flight (they are released when an exchange
+ * ends, is cancelled or has no body: fetchClosing, servingClosing; p31-port-leak.test.ts).
+ * `globalThis.__cellbMaxPorts` overrides it (tests that check nothing leaks set it low).
+ */
+const maxPorts = () => globalThis.__cellbMaxPorts ?? 4096;
+/**
+ * Cell-host side: serves the runtime's HTTP surface over a port with
+ * webrun-rpc (mux + backpressure) and webrun-http-streams (HTTP/1.1 on the
+ * Duplex, streaming bodies). Resolves to an async disposer.
+ */
+export function serveRuntime(port, runtime, opts) {
+    return serve({ mux: overPipe(port, { codec: structuredCodec, side: "responder", maxPorts: maxPorts() }) }, servingClosing(serveFetchOverDuplex(cellsHttpHandler(runtime, opts))));
+}
+async function fetchClosing(call, req) {
+    let output;
+    const res = await fetchOverDuplex(((input) => {
+        output = call(input);
+        return output;
+    }), req);
+    const drain = () => void (async () => {
+        try {
+            for await (const _ of output)
+                ;
+        }
+        catch { }
+    })();
+    if (!output)
+        return res;
+    if (res.body === null) {
+        drain();
+        return res;
+    }
+    // The same once the body is read to its end, or cancelled by its reader (then the exchange
+    // is abandoned: the call's iterator is returned, which closes its port).
+    const reader = res.body.getReader();
+    const body = new ReadableStream({
+        async pull(ctl) {
+            const r = await reader.read();
+            if (r.done) {
+                ctl.close();
+                drain();
+            }
+            else
+                ctl.enqueue(r.value);
+        },
+        async cancel(reason) {
+            await reader.cancel(reason).catch(() => { });
+            await output.return?.(undefined).catch?.(() => { });
+        },
+    });
+    return Object.assign(new Response(body, res), {
+        webSocket: res.webSocket ?? null,
+    });
+}
+function servingClosing(duplex) {
+    return async function* (input) {
+        const it = input[Symbol.asyncIterator]();
+        const rest = { [Symbol.asyncIterator]: () => it };
+        try {
+            yield* duplex(rest);
+        }
+        finally {
+            void (async () => {
+                try {
+                    for (let r = await it.next(); !r.done; r = await it.next())
+                        ;
+                }
+                catch { }
+            })();
+        }
+    };
+}
+/** Front side (page, SW bridge, another tab): a RemoteRuntime over a port. */
+export async function connectRuntime(port, opts) {
+    const { call, close } = await connect({
+        mux: overPipe(port, { codec: structuredCodec, side: "initiator", maxPorts: maxPorts() }),
+    });
+    const remote = await remoteRuntime((req) => fetchClosing(call, req), opts);
+    return Object.assign(remote, { close: async () => void (await close()) });
+}
+/** Serves any HTTP handler over a port (responder side of a link). */
+export function serveHandlerOverPort(port, handler) {
+    return serve({ mux: overPipe(port, { codec: structuredCodec, side: "responder", maxPorts: maxPorts() }) }, servingClosing(serveFetchOverDuplex(handler)));
+}
+/** A `send` over a port (initiator side of a link); the scheme rides in a header. */
+export async function linkOverPort(port) {
+    const { call, close } = await connect({
+        mux: overPipe(port, { codec: structuredCodec, side: "initiator", maxPorts: maxPorts() }),
+    });
+    return {
+        send: (req) => fetchClosing(call, withScheme(req)),
+        close: async () => void (await close()),
+    };
+}
+//# sourceMappingURL=port.js.map

package/dist/transport/port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"port.js","sourceRoot":"","sources":["../../src/transport/port.ts"],"names":[],"mappings":"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","sourcesContent":["import { fetchOverDuplex, serveFetchOverDuplex } from \"@statewalker/webrun-http-streams\";\nimport { connect, overPipe, serve, structuredCodec } from \"@statewalker/webrun-rpc\";\nimport type { CellRuntime } from \"../core/runtime.js\";\nimport {\n  type CellsHttpOptions,\n  cellsHttpHandler,\n  type RemoteRuntime,\n  remoteRuntime,\n} from \"./cells-http.js\";\nimport { type Send, withScheme } from \"./cells-link.js\";\n\n/**\n * Multiplexed ports per link: one per exchange in flight (they are released when an exchange\n * ends, is cancelled or has no body: fetchClosing, servingClosing; p31-port-leak.test.ts).\n * `globalThis.__cellbMaxPorts` overrides it (tests that check nothing leaks set it low).\n */\nconst maxPorts = () => (globalThis as { __cellbMaxPorts?: number }).__cellbMaxPorts ?? 4096;\n\n/**\n * A DEDICATED message pipe (MessagePort, or a worker_threads port). Don't pass a\n * Worker object that also carries other messages — transfer a MessageChannel port.\n */\nexport type CellPort = Parameters<typeof overPipe>[0];\n\n/**\n * Cell-host side: serves the runtime's HTTP surface over a port with\n * webrun-rpc (mux + backpressure) and webrun-http-streams (HTTP/1.1 on the\n * Duplex, streaming bodies). Resolves to an async disposer.\n */\nexport function serveRuntime(\n  port: CellPort,\n  runtime: CellRuntime,\n  opts?: CellsHttpOptions,\n): Promise<() => Promise<void>> {\n  return serve(\n    { mux: overPipe(port, { codec: structuredCodec, side: \"responder\", maxPorts: maxPorts() }) },\n    servingClosing(serveFetchOverDuplex(cellsHttpHandler(runtime, opts))),\n  ) as Promise<() => Promise<void>>;\n}\n\n/**\n * fetchOverDuplex, draining the call's output when the response has no body (HEAD, 204, 304…):\n * webrun-http-streams then returns without reading the exchange to its end, and the call's\n * multiplexed port stayed open, one per such request, until `maxPorts` (1024) refused calls.\n */\ntype Call = Parameters<typeof fetchOverDuplex>[0];\nasync function fetchClosing(call: Call, req: Request): Promise<Response> {\n  let output: AsyncIterable<unknown> | undefined;\n  const res = await fetchOverDuplex(\n    ((input: unknown) => {\n      output = (call as (i: unknown) => AsyncIterable<unknown>)(input);\n      return output;\n    }) as Call,\n    req,\n  );\n  const drain = () =>\n    void (async () => {\n      try {\n        for await (const _ of output as AsyncIterable<unknown>);\n      } catch {}\n    })();\n  if (!output) return res;\n  if (res.body === null) {\n    drain();\n    return res;\n  }\n  // The same once the body is read to its end, or cancelled by its reader (then the exchange\n  // is abandoned: the call's iterator is returned, which closes its port).\n  const reader = (res.body as ReadableStream<Uint8Array>).getReader();\n  const body = new ReadableStream<Uint8Array>({\n    async pull(ctl) {\n      const r = await reader.read();\n      if (r.done) {\n        ctl.close();\n        drain();\n      } else ctl.enqueue(r.value);\n    },\n    async cancel(reason) {\n      await reader.cancel(reason).catch(() => {});\n      await (output as AsyncGenerator<unknown>).return?.(undefined).catch?.(() => {});\n    },\n  });\n  return Object.assign(new Response(body, res), {\n    webSocket: (res as { webSocket?: unknown }).webSocket ?? null,\n  });\n}\n\n/**\n * serveFetchOverDuplex, draining what is left of the request side once the response is out:\n * a handler that does not read the request body (a GET) left the exchange half open, and its\n * multiplexed port open, one per request.\n */\ntype Duplex = ReturnType<typeof serveFetchOverDuplex>;\nfunction servingClosing(duplex: Duplex): Duplex {\n  return async function* (input: AsyncIterable<unknown>) {\n    const it = input[Symbol.asyncIterator]();\n    const rest: AsyncIterable<unknown> = { [Symbol.asyncIterator]: () => it };\n    try {\n      yield* (duplex as (i: AsyncIterable<unknown>) => AsyncIterable<unknown>)(rest);\n    } finally {\n      void (async () => {\n        try {\n          for (let r = await it.next(); !r.done; r = await it.next());\n        } catch {}\n      })();\n    }\n  } as unknown as Duplex;\n}\n\n/** Front side (page, SW bridge, another tab): a RemoteRuntime over a port. */\nexport async function connectRuntime(\n  port: CellPort,\n  opts?: CellsHttpOptions,\n): Promise<RemoteRuntime & { close(): Promise<void> }> {\n  const { call, close } = await connect({\n    mux: overPipe(port, { codec: structuredCodec, side: \"initiator\", maxPorts: maxPorts() }),\n  });\n  const remote = await remoteRuntime((req) => fetchClosing(call, req), opts);\n  return Object.assign(remote, { close: async () => void (await close()) });\n}\n\n/** Serves any HTTP handler over a port (responder side of a link). */\nexport function serveHandlerOverPort(port: CellPort, handler: Send): Promise<() => Promise<void>> {\n  return serve(\n    { mux: overPipe(port, { codec: structuredCodec, side: \"responder\", maxPorts: maxPorts() }) },\n    servingClosing(serveFetchOverDuplex(handler)),\n  ) as Promise<() => Promise<void>>;\n}\n\n/** A `send` over a port (initiator side of a link); the scheme rides in a header. */\nexport async function linkOverPort(\n  port: CellPort,\n): Promise<{ send: Send; close(): Promise<void> }> {\n  const { call, close } = await connect({\n    mux: overPipe(port, { codec: structuredCodec, side: \"initiator\", maxPorts: maxPorts() }),\n  });\n  return {\n    send: (req) => fetchClosing(call, withScheme(req)),\n    close: async () => void (await close()),\n  };\n}\n"]}

package/dist/v8/codec.d.ts

@@ -0,0 +1,6 @@
+import type { ValueCodec } from "../ports.js";
+import { type HostObjects } from "./serialize.js";
+/** Storage values in V8's serialization format — what celld (and workerd) store. */
+export declare const v8Codec: ValueCodec;
+/** V8 serialization with an embedder's own objects (e.g. stored stubs). */
+export declare const v8CodecWith: (host: HostObjects) => ValueCodec;

package/dist/v8/codec.js

@@ -0,0 +1,9 @@
+import { deserialize, serialize } from "./serialize.js";
+/** Storage values in V8's serialization format — what celld (and workerd) store. */
+export const v8Codec = { encode: serialize, decode: deserialize };
+/** V8 serialization with an embedder's own objects (e.g. stored stubs). */
+export const v8CodecWith = (host) => ({
+    encode: (v) => serialize(v, host),
+    decode: (b) => deserialize(b, host),
+});
+//# sourceMappingURL=codec.js.map

package/dist/v8/codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.js","sourceRoot":"","sources":["../../src/v8/codec.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAoB,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE1E,oFAAoF;AACpF,MAAM,CAAC,MAAM,OAAO,GAAe,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;AAE9E,2EAA2E;AAC3E,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAiB,EAAc,EAAE,CAAC,CAAC;IAC7D,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC;IACjC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC;CACpC,CAAC,CAAC","sourcesContent":["import type { ValueCodec } from \"../ports.js\";\nimport { deserialize, type HostObjects, serialize } from \"./serialize.js\";\n\n/** Storage values in V8's serialization format — what celld (and workerd) store. */\nexport const v8Codec: ValueCodec = { encode: serialize, decode: deserialize };\n\n/** V8 serialization with an embedder's own objects (e.g. stored stubs). */\nexport const v8CodecWith = (host: HostObjects): ValueCodec => ({\n  encode: (v) => serialize(v, host),\n  decode: (b) => deserialize(b, host),\n});\n"]}

package/dist/v8/serialize.d.ts

@@ -0,0 +1,10 @@
+/**
+ * An embedder's own objects (V8's host objects, tag `\`), written as a length and bytes:
+ * `encode` claims a value (bytes) or leaves it (undefined); `decode` restores it.
+ */
+export interface HostObjects {
+    encode(v: object): Uint8Array | undefined;
+    decode(bytes: Uint8Array): unknown;
+}
+export declare function serialize(value: unknown, host?: HostObjects): Uint8Array;
+export declare function deserialize(bytes: Uint8Array, host?: HostObjects): unknown;