@noego/wood 0.4.5 → 0.4.7

package/dist/transport/index.js

@@ -0,0 +1,19 @@
+import { InProcessRouterTransport } from "./in_process_router_transport.js";
+import {
+  LoopbackRemoteTransport,
+  LoopbackRemoteTransportServer
+} from "./loopback_remote_transport.js";
+import {
+  assertLoopbackSerializable,
+  LoopbackSerializationError
+} from "./loopback_serialization.js";
+import { buildTransportBridge } from "./build_transport_bridge.js";
+export {
+  InProcessRouterTransport,
+  LoopbackRemoteTransport,
+  LoopbackRemoteTransportServer,
+  LoopbackSerializationError,
+  assertLoopbackSerializable,
+  buildTransportBridge
+};
+//# sourceMappingURL=index.js.map

package/dist/transport/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/transport/index.ts"],"sourcesContent":["export type {\n  WoodRpcTransport,\n  WoodChannelContract,\n  WoodChannelMapLike,\n  WoodChannelInput,\n  WoodChannelOutput,\n  TypedCall,\n} from './wood_rpc_transport.js';\nexport { InProcessRouterTransport } from './in_process_router_transport.js';\nexport {\n  LoopbackRemoteTransport,\n  LoopbackRemoteTransportServer,\n} from './loopback_remote_transport.js';\nexport {\n  assertLoopbackSerializable,\n  LoopbackSerializationError,\n} from './loopback_serialization.js';\nexport { buildTransportBridge, type TransportBridgeResult } from './build_transport_bridge.js';\n"],"mappings":"AAQA,SAAS,gCAAgC;AACzC;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP,SAAS,4BAAwD;","names":[]}

package/dist/transport/loopback_remote_transport.cjs

@@ -0,0 +1,270 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var loopback_remote_transport_exports = {};
+__export(loopback_remote_transport_exports, {
+  LoopbackRemoteTransport: () => LoopbackRemoteTransport,
+  LoopbackRemoteTransportServer: () => LoopbackRemoteTransportServer,
+  LoopbackSerializationError: () => import_loopback_serialization.LoopbackSerializationError
+});
+module.exports = __toCommonJS(loopback_remote_transport_exports);
+var import_node_http = __toESM(require("node:http"), 1);
+var import_loopback_serialization = require("./loopback_serialization.js");
+const LONG_POLL_TIMEOUT_MS = 25e3;
+const LOOPBACK_HOST = "127.0.0.1";
+function readJsonBody(req) {
+  return new Promise((resolve, reject) => {
+    const chunks = [];
+    req.on("data", (chunk) => chunks.push(chunk));
+    req.on("error", reject);
+    req.on("end", () => {
+      const raw = Buffer.concat(chunks).toString("utf-8");
+      if (raw.length === 0) {
+        resolve(void 0);
+        return;
+      }
+      try {
+        resolve(JSON.parse(raw));
+      } catch (error) {
+        reject(error);
+      }
+    });
+  });
+}
+function sendJson(res, status, body) {
+  const payload = JSON.stringify(body ?? null);
+  res.writeHead(status, { "content-type": "application/json" });
+  res.end(payload);
+}
+class LoopbackRemoteTransportServer {
+  constructor(transport) {
+    this.eventLog = [];
+    this.waiters = /* @__PURE__ */ new Set();
+    this.seq = 0;
+    this.listening = false;
+    this.transport = transport;
+    this.server = import_node_http.default.createServer((req, res) => {
+      this.handle(req, res).catch((error) => {
+        sendJson(res, 500, { message: error instanceof Error ? error.message : String(error) });
+      });
+    });
+  }
+  get port() {
+    const address = this.server.address();
+    if (!address || typeof address === "string") {
+      throw new Error("Loopback server is not listening.");
+    }
+    return address.port;
+  }
+  get url() {
+    return `http://${LOOPBACK_HOST}:${this.port}`;
+  }
+  async listen() {
+    if (this.listening) return this.url;
+    await new Promise((resolve, reject) => {
+      this.server.once("error", reject);
+      this.server.listen(0, LOOPBACK_HOST, () => {
+        this.server.off("error", reject);
+        resolve();
+      });
+    });
+    this.listening = true;
+    return this.url;
+  }
+  /**
+   * Push-event sink. Matches the `WindowEventService` sender signature: the
+   * channel arrives with the `__event:` prefix, which is stripped here.
+   */
+  emit(channel, data) {
+    const stripped = channel.startsWith("__event:") ? channel.slice("__event:".length) : channel;
+    (0, import_loopback_serialization.assertLoopbackSerializable)(data, `event:${stripped}`);
+    const event = { seq: ++this.seq, channel: stripped, data };
+    this.eventLog.push(event);
+    for (const waiter of this.waiters) {
+      waiter([event]);
+    }
+    this.waiters.clear();
+  }
+  async close() {
+    for (const waiter of this.waiters) {
+      waiter([]);
+    }
+    this.waiters.clear();
+    if (!this.listening) return;
+    await new Promise((resolve, reject) => {
+      this.server.close((error) => error ? reject(error) : resolve());
+    });
+    this.listening = false;
+  }
+  async handle(req, res) {
+    const url = new URL(req.url ?? "/", this.url);
+    if (req.method === "POST" && url.pathname === "/invoke") {
+      await this.handleInvoke(req, res);
+      return;
+    }
+    if (req.method === "GET" && url.pathname === "/events") {
+      await this.handleEvents(url, res);
+      return;
+    }
+    sendJson(res, 404, { message: `No loopback route for ${req.method} ${url.pathname}` });
+  }
+  async handleInvoke(req, res) {
+    const body = await readJsonBody(req);
+    if (!body || typeof body.channel !== "string") {
+      sendJson(res, 400, { message: 'Loopback invoke requires a "channel".' });
+      return;
+    }
+    try {
+      const result = await this.transport.invoke(body.channel, body.payload);
+      (0, import_loopback_serialization.assertLoopbackSerializable)(result, `result:${body.channel}`);
+      sendJson(res, 200, { ok: true, result: result ?? null });
+    } catch (error) {
+      const errorBody = {
+        message: error instanceof Error ? error.message : String(error),
+        name: error instanceof Error ? error.name : "Error"
+      };
+      sendJson(res, 200, { ok: false, error: errorBody });
+    }
+  }
+  handleEvents(url, res) {
+    const cursor = Number.parseInt(url.searchParams.get("cursor") ?? "0", 10) || 0;
+    const pending = this.eventLog.filter((event) => event.seq > cursor);
+    if (pending.length > 0) {
+      sendJson(res, 200, { events: pending });
+      return Promise.resolve();
+    }
+    return new Promise((resolve) => {
+      const timer = setTimeout(() => {
+        this.waiters.delete(waiter);
+        sendJson(res, 200, { events: [] });
+        resolve();
+      }, LONG_POLL_TIMEOUT_MS);
+      const waiter = (events) => {
+        clearTimeout(timer);
+        sendJson(res, 200, { events });
+        resolve();
+      };
+      this.waiters.add(waiter);
+      res.on("close", () => {
+        clearTimeout(timer);
+        this.waiters.delete(waiter);
+        resolve();
+      });
+    });
+  }
+}
+class LoopbackRemoteTransport {
+  constructor(baseUrl) {
+    this.listeners = /* @__PURE__ */ new Map();
+    this.cursor = 0;
+    this.polling = false;
+    this.closed = false;
+    this.pollController = null;
+    this.baseUrl = baseUrl.replace(/\/$/, "");
+  }
+  async invoke(channel, payload) {
+    (0, import_loopback_serialization.assertLoopbackSerializable)(payload, `payload:${channel}`);
+    const response = await fetch(`${this.baseUrl}/invoke`, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({ channel, payload })
+    });
+    const body = await response.json();
+    if (body.ok) {
+      return body.result;
+    }
+    const error = new Error(body.error.message);
+    error.name = body.error.name;
+    throw error;
+  }
+  subscribe(channel, listener) {
+    let set = this.listeners.get(channel);
+    if (!set) {
+      set = /* @__PURE__ */ new Set();
+      this.listeners.set(channel, set);
+    }
+    set.add(listener);
+    this.ensurePolling();
+    return () => {
+      set?.delete(listener);
+      if (set && set.size === 0) {
+        this.listeners.delete(channel);
+      }
+    };
+  }
+  /** Stop the long-poll loop and release the in-flight request. Call in teardown. */
+  close() {
+    this.closed = true;
+    this.listeners.clear();
+    this.pollController?.abort();
+  }
+  ensurePolling() {
+    if (this.polling || this.closed) return;
+    this.polling = true;
+    void this.pollLoop();
+  }
+  async pollLoop() {
+    while (!this.closed && this.hasListeners()) {
+      try {
+        await this.pollOnce();
+      } catch (error) {
+        if (this.closed || error?.name === "AbortError") break;
+        await new Promise((resolve) => setTimeout(resolve, 10));
+      }
+    }
+    this.polling = false;
+  }
+  async pollOnce() {
+    this.pollController = new AbortController();
+    const response = await fetch(`${this.baseUrl}/events?cursor=${this.cursor}`, {
+      signal: this.pollController.signal
+    });
+    const body = await response.json();
+    for (const event of body.events) {
+      this.cursor = Math.max(this.cursor, event.seq);
+      this.dispatch(event.channel, event.data);
+    }
+  }
+  dispatch(channel, data) {
+    const set = this.listeners.get(channel);
+    if (!set) return;
+    for (const listener of set) {
+      listener(data);
+    }
+  }
+  hasListeners() {
+    return this.listeners.size > 0;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  LoopbackRemoteTransport,
+  LoopbackRemoteTransportServer,
+  LoopbackSerializationError
+});
+//# sourceMappingURL=loopback_remote_transport.cjs.map

package/dist/transport/loopback_remote_transport.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/transport/loopback_remote_transport.ts"],"sourcesContent":["import http from 'node:http';\nimport type { AddressInfo } from 'node:net';\nimport type { WoodRpcTransport } from './wood_rpc_transport.js';\nimport {\n  assertLoopbackSerializable,\n  LoopbackSerializationError,\n} from './loopback_serialization.js';\n\n/**\n * Loopback (127.0.0.1) HTTP transport — TEST ONLY.\n *\n * `invoke` is a plain HTTP request/response. Push events use HTTP long-polling\n * (no WebSocket dependency: `ws` is not a wood dependency and the loopback\n * transport is not a product feature, so long-polling over `node:http` is the\n * simplest faithful choice). JSON is the wire format, so both ends run the\n * strict `assertLoopbackSerializable` guard: anything JSON would coerce or drop\n * (Date, undefined, binary, class instances, non-finite numbers) is rejected\n * with a clear error rather than silently mangled. Electron structured-clone is\n * the ground-truth contract this guard defends.\n *\n * The server binds to `127.0.0.1` only and is never wired into production\n * startup (exported solely from the transport/testing entry points, which the\n * main runtime does not import).\n */\n\nconst LONG_POLL_TIMEOUT_MS = 25_000;\nconst LOOPBACK_HOST = '127.0.0.1';\n\ninterface PushEvent {\n  seq: number;\n  channel: string;\n  data: unknown;\n}\n\ninterface InvokeErrorBody {\n  message: string;\n  name: string;\n}\n\nfunction readJsonBody(req: http.IncomingMessage): Promise<unknown> {\n  return new Promise((resolve, reject) => {\n    const chunks: Buffer[] = [];\n    req.on('data', (chunk: Buffer) => chunks.push(chunk));\n    req.on('error', reject);\n    req.on('end', () => {\n      const raw = Buffer.concat(chunks).toString('utf-8');\n      if (raw.length === 0) {\n        resolve(undefined);\n        return;\n      }\n      try {\n        resolve(JSON.parse(raw));\n      } catch (error) {\n        reject(error);\n      }\n    });\n  });\n}\n\nfunction sendJson(res: http.ServerResponse, status: number, body: unknown): void {\n  const payload = JSON.stringify(body ?? null);\n  res.writeHead(status, { 'content-type': 'application/json' });\n  res.end(payload);\n}\n\n/**\n * The loopback server. Wraps a `WoodRpcTransport` for `invoke` and acts as the\n * push-event sink: wire `WindowEventService.configure((ch, data) => server.emit(ch, data))`.\n */\nexport class LoopbackRemoteTransportServer {\n  private readonly transport: WoodRpcTransport;\n  private readonly server: http.Server;\n  private readonly eventLog: PushEvent[] = [];\n  private readonly waiters = new Set<(events: PushEvent[]) => void>();\n  private seq = 0;\n  private listening = false;\n\n  constructor(transport: WoodRpcTransport) {\n    this.transport = transport;\n    this.server = http.createServer((req, res) => {\n      this.handle(req, res).catch((error) => {\n        sendJson(res, 500, { message: error instanceof Error ? error.message : String(error) });\n      });\n    });\n  }\n\n  get port(): number {\n    const address = this.server.address() as AddressInfo | null;\n    if (!address || typeof address === 'string') {\n      throw new Error('Loopback server is not listening.');\n    }\n    return address.port;\n  }\n\n  get url(): string {\n    return `http://${LOOPBACK_HOST}:${this.port}`;\n  }\n\n  async listen(): Promise<string> {\n    if (this.listening) return this.url;\n    await new Promise<void>((resolve, reject) => {\n      this.server.once('error', reject);\n      this.server.listen(0, LOOPBACK_HOST, () => {\n        this.server.off('error', reject);\n        resolve();\n      });\n    });\n    this.listening = true;\n    return this.url;\n  }\n\n  /**\n   * Push-event sink. Matches the `WindowEventService` sender signature: the\n   * channel arrives with the `__event:` prefix, which is stripped here.\n   */\n  emit(channel: string, data: unknown): void {\n    const stripped = channel.startsWith('__event:')\n      ? channel.slice('__event:'.length)\n      : channel;\n    assertLoopbackSerializable(data, `event:${stripped}`);\n    const event: PushEvent = { seq: ++this.seq, channel: stripped, data };\n    this.eventLog.push(event);\n    for (const waiter of this.waiters) {\n      waiter([event]);\n    }\n    this.waiters.clear();\n  }\n\n  async close(): Promise<void> {\n    for (const waiter of this.waiters) {\n      waiter([]);\n    }\n    this.waiters.clear();\n    if (!this.listening) return;\n    await new Promise<void>((resolve, reject) => {\n      this.server.close((error) => (error ? reject(error) : resolve()));\n    });\n    this.listening = false;\n  }\n\n  private async handle(req: http.IncomingMessage, res: http.ServerResponse): Promise<void> {\n    const url = new URL(req.url ?? '/', this.url);\n    if (req.method === 'POST' && url.pathname === '/invoke') {\n      await this.handleInvoke(req, res);\n      return;\n    }\n    if (req.method === 'GET' && url.pathname === '/events') {\n      await this.handleEvents(url, res);\n      return;\n    }\n    sendJson(res, 404, { message: `No loopback route for ${req.method} ${url.pathname}` });\n  }\n\n  private async handleInvoke(req: http.IncomingMessage, res: http.ServerResponse): Promise<void> {\n    const body = (await readJsonBody(req)) as { channel?: string; payload?: unknown } | undefined;\n    if (!body || typeof body.channel !== 'string') {\n      sendJson(res, 400, { message: 'Loopback invoke requires a \"channel\".' });\n      return;\n    }\n\n    try {\n      const result = await this.transport.invoke(body.channel, body.payload);\n      assertLoopbackSerializable(result, `result:${body.channel}`);\n      sendJson(res, 200, { ok: true, result: result ?? null });\n    } catch (error) {\n      const errorBody: InvokeErrorBody = {\n        message: error instanceof Error ? error.message : String(error),\n        name: error instanceof Error ? error.name : 'Error',\n      };\n      sendJson(res, 200, { ok: false, error: errorBody });\n    }\n  }\n\n  private handleEvents(url: URL, res: http.ServerResponse): Promise<void> {\n    const cursor = Number.parseInt(url.searchParams.get('cursor') ?? '0', 10) || 0;\n    const pending = this.eventLog.filter((event) => event.seq > cursor);\n    if (pending.length > 0) {\n      sendJson(res, 200, { events: pending });\n      return Promise.resolve();\n    }\n\n    return new Promise<void>((resolve) => {\n      const timer = setTimeout(() => {\n        this.waiters.delete(waiter);\n        sendJson(res, 200, { events: [] });\n        resolve();\n      }, LONG_POLL_TIMEOUT_MS);\n\n      const waiter = (events: PushEvent[]): void => {\n        clearTimeout(timer);\n        sendJson(res, 200, { events });\n        resolve();\n      };\n\n      this.waiters.add(waiter);\n      res.on('close', () => {\n        clearTimeout(timer);\n        this.waiters.delete(waiter);\n        resolve();\n      });\n    });\n  }\n}\n\n/** Client-side loopback transport. Talks to a `LoopbackRemoteTransportServer`. */\nexport class LoopbackRemoteTransport implements WoodRpcTransport {\n  private readonly baseUrl: string;\n  private readonly listeners = new Map<string, Set<(payload: unknown) => void>>();\n  private cursor = 0;\n  private polling = false;\n  private closed = false;\n  private pollController: AbortController | null = null;\n\n  constructor(baseUrl: string) {\n    this.baseUrl = baseUrl.replace(/\\/$/, '');\n  }\n\n  async invoke(channel: string, payload?: unknown): Promise<unknown> {\n    assertLoopbackSerializable(payload, `payload:${channel}`);\n    const response = await fetch(`${this.baseUrl}/invoke`, {\n      method: 'POST',\n      headers: { 'content-type': 'application/json' },\n      body: JSON.stringify({ channel, payload }),\n    });\n    const body = (await response.json()) as\n      | { ok: true; result: unknown }\n      | { ok: false; error: InvokeErrorBody };\n\n    if (body.ok) {\n      return body.result;\n    }\n    const error = new Error(body.error.message);\n    error.name = body.error.name;\n    throw error;\n  }\n\n  subscribe(channel: string, listener: (payload: unknown) => void): () => void {\n    let set = this.listeners.get(channel);\n    if (!set) {\n      set = new Set();\n      this.listeners.set(channel, set);\n    }\n    set.add(listener);\n    this.ensurePolling();\n\n    return () => {\n      set?.delete(listener);\n      if (set && set.size === 0) {\n        this.listeners.delete(channel);\n      }\n    };\n  }\n\n  /** Stop the long-poll loop and release the in-flight request. Call in teardown. */\n  close(): void {\n    this.closed = true;\n    this.listeners.clear();\n    this.pollController?.abort();\n  }\n\n  private ensurePolling(): void {\n    if (this.polling || this.closed) return;\n    this.polling = true;\n    void this.pollLoop();\n  }\n\n  private async pollLoop(): Promise<void> {\n    while (!this.closed && this.hasListeners()) {\n      try {\n        await this.pollOnce();\n      } catch (error) {\n        if (this.closed || (error as Error)?.name === 'AbortError') break;\n        // Transient loopback error: yield a tick and retry.\n        await new Promise((resolve) => setTimeout(resolve, 10));\n      }\n    }\n    this.polling = false;\n  }\n\n  private async pollOnce(): Promise<void> {\n    this.pollController = new AbortController();\n    const response = await fetch(`${this.baseUrl}/events?cursor=${this.cursor}`, {\n      signal: this.pollController.signal,\n    });\n    const body = (await response.json()) as { events: PushEvent[] };\n    for (const event of body.events) {\n      this.cursor = Math.max(this.cursor, event.seq);\n      this.dispatch(event.channel, event.data);\n    }\n  }\n\n  private dispatch(channel: string, data: unknown): void {\n    const set = this.listeners.get(channel);\n    if (!set) return;\n    for (const listener of set) {\n      listener(data);\n    }\n  }\n\n  private hasListeners(): boolean {\n    return this.listeners.size > 0;\n  }\n}\n\nexport { LoopbackSerializationError };\n"],"mappings":"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","names":["http"]}

package/dist/transport/loopback_remote_transport.d.cts

@@ -0,0 +1,49 @@
+import { WoodRpcTransport } from './wood_rpc_transport.cjs';
+export { LoopbackSerializationError } from './loopback_serialization.cjs';
+
+/**
+ * The loopback server. Wraps a `WoodRpcTransport` for `invoke` and acts as the
+ * push-event sink: wire `WindowEventService.configure((ch, data) => server.emit(ch, data))`.
+ */
+declare class LoopbackRemoteTransportServer {
+    private readonly transport;
+    private readonly server;
+    private readonly eventLog;
+    private readonly waiters;
+    private seq;
+    private listening;
+    constructor(transport: WoodRpcTransport);
+    get port(): number;
+    get url(): string;
+    listen(): Promise<string>;
+    /**
+     * Push-event sink. Matches the `WindowEventService` sender signature: the
+     * channel arrives with the `__event:` prefix, which is stripped here.
+     */
+    emit(channel: string, data: unknown): void;
+    close(): Promise<void>;
+    private handle;
+    private handleInvoke;
+    private handleEvents;
+}
+/** Client-side loopback transport. Talks to a `LoopbackRemoteTransportServer`. */
+declare class LoopbackRemoteTransport implements WoodRpcTransport {
+    private readonly baseUrl;
+    private readonly listeners;
+    private cursor;
+    private polling;
+    private closed;
+    private pollController;
+    constructor(baseUrl: string);
+    invoke(channel: string, payload?: unknown): Promise<unknown>;
+    subscribe(channel: string, listener: (payload: unknown) => void): () => void;
+    /** Stop the long-poll loop and release the in-flight request. Call in teardown. */
+    close(): void;
+    private ensurePolling;
+    private pollLoop;
+    private pollOnce;
+    private dispatch;
+    private hasListeners;
+}
+
+export { LoopbackRemoteTransport, LoopbackRemoteTransportServer };

package/dist/transport/loopback_remote_transport.d.ts

@@ -0,0 +1,49 @@
+import { WoodRpcTransport } from './wood_rpc_transport.js';
+export { LoopbackSerializationError } from './loopback_serialization.js';
+
+/**
+ * The loopback server. Wraps a `WoodRpcTransport` for `invoke` and acts as the
+ * push-event sink: wire `WindowEventService.configure((ch, data) => server.emit(ch, data))`.
+ */
+declare class LoopbackRemoteTransportServer {
+    private readonly transport;
+    private readonly server;
+    private readonly eventLog;
+    private readonly waiters;
+    private seq;
+    private listening;
+    constructor(transport: WoodRpcTransport);
+    get port(): number;
+    get url(): string;
+    listen(): Promise<string>;
+    /**
+     * Push-event sink. Matches the `WindowEventService` sender signature: the
+     * channel arrives with the `__event:` prefix, which is stripped here.
+     */
+    emit(channel: string, data: unknown): void;
+    close(): Promise<void>;
+    private handle;
+    private handleInvoke;
+    private handleEvents;
+}
+/** Client-side loopback transport. Talks to a `LoopbackRemoteTransportServer`. */
+declare class LoopbackRemoteTransport implements WoodRpcTransport {
+    private readonly baseUrl;
+    private readonly listeners;
+    private cursor;
+    private polling;
+    private closed;
+    private pollController;
+    constructor(baseUrl: string);
+    invoke(channel: string, payload?: unknown): Promise<unknown>;
+    subscribe(channel: string, listener: (payload: unknown) => void): () => void;
+    /** Stop the long-poll loop and release the in-flight request. Call in teardown. */
+    close(): void;
+    private ensurePolling;
+    private pollLoop;
+    private pollOnce;
+    private dispatch;
+    private hasListeners;
+}
+
+export { LoopbackRemoteTransport, LoopbackRemoteTransportServer };

package/dist/transport/loopback_remote_transport.js

@@ -0,0 +1,237 @@
+import http from "node:http";
+import {
+  assertLoopbackSerializable,
+  LoopbackSerializationError
+} from "./loopback_serialization.js";
+const LONG_POLL_TIMEOUT_MS = 25e3;
+const LOOPBACK_HOST = "127.0.0.1";
+function readJsonBody(req) {
+  return new Promise((resolve, reject) => {
+    const chunks = [];
+    req.on("data", (chunk) => chunks.push(chunk));
+    req.on("error", reject);
+    req.on("end", () => {
+      const raw = Buffer.concat(chunks).toString("utf-8");
+      if (raw.length === 0) {
+        resolve(void 0);
+        return;
+      }
+      try {
+        resolve(JSON.parse(raw));
+      } catch (error) {
+        reject(error);
+      }
+    });
+  });
+}
+function sendJson(res, status, body) {
+  const payload = JSON.stringify(body ?? null);
+  res.writeHead(status, { "content-type": "application/json" });
+  res.end(payload);
+}
+class LoopbackRemoteTransportServer {
+  constructor(transport) {
+    this.eventLog = [];
+    this.waiters = /* @__PURE__ */ new Set();
+    this.seq = 0;
+    this.listening = false;
+    this.transport = transport;
+    this.server = http.createServer((req, res) => {
+      this.handle(req, res).catch((error) => {
+        sendJson(res, 500, { message: error instanceof Error ? error.message : String(error) });
+      });
+    });
+  }
+  get port() {
+    const address = this.server.address();
+    if (!address || typeof address === "string") {
+      throw new Error("Loopback server is not listening.");
+    }
+    return address.port;
+  }
+  get url() {
+    return `http://${LOOPBACK_HOST}:${this.port}`;
+  }
+  async listen() {
+    if (this.listening) return this.url;
+    await new Promise((resolve, reject) => {
+      this.server.once("error", reject);
+      this.server.listen(0, LOOPBACK_HOST, () => {
+        this.server.off("error", reject);
+        resolve();
+      });
+    });
+    this.listening = true;
+    return this.url;
+  }
+  /**
+   * Push-event sink. Matches the `WindowEventService` sender signature: the
+   * channel arrives with the `__event:` prefix, which is stripped here.
+   */
+  emit(channel, data) {
+    const stripped = channel.startsWith("__event:") ? channel.slice("__event:".length) : channel;
+    assertLoopbackSerializable(data, `event:${stripped}`);
+    const event = { seq: ++this.seq, channel: stripped, data };
+    this.eventLog.push(event);
+    for (const waiter of this.waiters) {
+      waiter([event]);
+    }
+    this.waiters.clear();
+  }
+  async close() {
+    for (const waiter of this.waiters) {
+      waiter([]);
+    }
+    this.waiters.clear();
+    if (!this.listening) return;
+    await new Promise((resolve, reject) => {
+      this.server.close((error) => error ? reject(error) : resolve());
+    });
+    this.listening = false;
+  }
+  async handle(req, res) {
+    const url = new URL(req.url ?? "/", this.url);
+    if (req.method === "POST" && url.pathname === "/invoke") {
+      await this.handleInvoke(req, res);
+      return;
+    }
+    if (req.method === "GET" && url.pathname === "/events") {
+      await this.handleEvents(url, res);
+      return;
+    }
+    sendJson(res, 404, { message: `No loopback route for ${req.method} ${url.pathname}` });
+  }
+  async handleInvoke(req, res) {
+    const body = await readJsonBody(req);
+    if (!body || typeof body.channel !== "string") {
+      sendJson(res, 400, { message: 'Loopback invoke requires a "channel".' });
+      return;
+    }
+    try {
+      const result = await this.transport.invoke(body.channel, body.payload);
+      assertLoopbackSerializable(result, `result:${body.channel}`);
+      sendJson(res, 200, { ok: true, result: result ?? null });
+    } catch (error) {
+      const errorBody = {
+        message: error instanceof Error ? error.message : String(error),
+        name: error instanceof Error ? error.name : "Error"
+      };
+      sendJson(res, 200, { ok: false, error: errorBody });
+    }
+  }
+  handleEvents(url, res) {
+    const cursor = Number.parseInt(url.searchParams.get("cursor") ?? "0", 10) || 0;
+    const pending = this.eventLog.filter((event) => event.seq > cursor);
+    if (pending.length > 0) {
+      sendJson(res, 200, { events: pending });
+      return Promise.resolve();
+    }
+    return new Promise((resolve) => {
+      const timer = setTimeout(() => {
+        this.waiters.delete(waiter);
+        sendJson(res, 200, { events: [] });
+        resolve();
+      }, LONG_POLL_TIMEOUT_MS);
+      const waiter = (events) => {
+        clearTimeout(timer);
+        sendJson(res, 200, { events });
+        resolve();
+      };
+      this.waiters.add(waiter);
+      res.on("close", () => {
+        clearTimeout(timer);
+        this.waiters.delete(waiter);
+        resolve();
+      });
+    });
+  }
+}
+class LoopbackRemoteTransport {
+  constructor(baseUrl) {
+    this.listeners = /* @__PURE__ */ new Map();
+    this.cursor = 0;
+    this.polling = false;
+    this.closed = false;
+    this.pollController = null;
+    this.baseUrl = baseUrl.replace(/\/$/, "");
+  }
+  async invoke(channel, payload) {
+    assertLoopbackSerializable(payload, `payload:${channel}`);
+    const response = await fetch(`${this.baseUrl}/invoke`, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({ channel, payload })
+    });
+    const body = await response.json();
+    if (body.ok) {
+      return body.result;
+    }
+    const error = new Error(body.error.message);
+    error.name = body.error.name;
+    throw error;
+  }
+  subscribe(channel, listener) {
+    let set = this.listeners.get(channel);
+    if (!set) {
+      set = /* @__PURE__ */ new Set();
+      this.listeners.set(channel, set);
+    }
+    set.add(listener);
+    this.ensurePolling();
+    return () => {
+      set?.delete(listener);
+      if (set && set.size === 0) {
+        this.listeners.delete(channel);
+      }
+    };
+  }
+  /** Stop the long-poll loop and release the in-flight request. Call in teardown. */
+  close() {
+    this.closed = true;
+    this.listeners.clear();
+    this.pollController?.abort();
+  }
+  ensurePolling() {
+    if (this.polling || this.closed) return;
+    this.polling = true;
+    void this.pollLoop();
+  }
+  async pollLoop() {
+    while (!this.closed && this.hasListeners()) {
+      try {
+        await this.pollOnce();
+      } catch (error) {
+        if (this.closed || error?.name === "AbortError") break;
+        await new Promise((resolve) => setTimeout(resolve, 10));
+      }
+    }
+    this.polling = false;
+  }
+  async pollOnce() {
+    this.pollController = new AbortController();
+    const response = await fetch(`${this.baseUrl}/events?cursor=${this.cursor}`, {
+      signal: this.pollController.signal
+    });
+    const body = await response.json();
+    for (const event of body.events) {
+      this.cursor = Math.max(this.cursor, event.seq);
+      this.dispatch(event.channel, event.data);
+    }
+  }
+  dispatch(channel, data) {
+    const set = this.listeners.get(channel);
+    if (!set) return;
+    for (const listener of set) {
+      listener(data);
+    }
+  }
+  hasListeners() {
+    return this.listeners.size > 0;
+  }
+}
+export {
+  LoopbackRemoteTransport,
+  LoopbackRemoteTransportServer,
+  LoopbackSerializationError
+};
+//# sourceMappingURL=loopback_remote_transport.js.map