@noego/wood 0.4.6 → 0.4.7

package/dist/transport/loopback_remote_transport.js.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":[]}

package/dist/transport/loopback_serialization.cjs

@@ -0,0 +1,116 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var loopback_serialization_exports = {};
+__export(loopback_serialization_exports, {
+  LoopbackSerializationError: () => LoopbackSerializationError,
+  assertLoopbackSerializable: () => assertLoopbackSerializable
+});
+module.exports = __toCommonJS(loopback_serialization_exports);
+class LoopbackSerializationError extends Error {
+  constructor(message, path) {
+    super(message);
+    this.path = path;
+    this.name = "LoopbackSerializationError";
+  }
+}
+function describe(value) {
+  if (value === null) return "null";
+  if (Array.isArray(value)) return "array";
+  const t = typeof value;
+  if (t === "object") {
+    const ctor = value.constructor;
+    return ctor && ctor.name ? `${ctor.name} instance` : "object";
+  }
+  return t;
+}
+function isPlainObject(value) {
+  const proto = Object.getPrototypeOf(value);
+  return proto === Object.prototype || proto === null;
+}
+function reject(reason, path) {
+  throw new LoopbackSerializationError(
+    `Loopback transport cannot faithfully serialize value at ${path}: ${reason}. The loopback transport uses JSON; use InProcessRouterTransport (or the real Electron transport) for values that require structured clone.`,
+    path
+  );
+}
+function assertNode(value, path, seen) {
+  if (value === null) return;
+  const t = typeof value;
+  if (t === "string" || t === "boolean") return;
+  if (t === "number") {
+    if (!Number.isFinite(value)) {
+      reject("non-finite number (NaN/Infinity) \u2014 JSON coerces it to null", path);
+    }
+    return;
+  }
+  if (t === "undefined") {
+    reject("undefined \u2014 JSON drops it silently", path);
+  }
+  if (t === "bigint") {
+    reject("bigint \u2014 JSON cannot represent it", path);
+  }
+  if (t === "function") {
+    reject("function \u2014 JSON drops it silently", path);
+  }
+  if (t === "symbol") {
+    reject("symbol \u2014 JSON drops it silently", path);
+  }
+  const obj = value;
+  if (seen.has(obj)) {
+    reject("circular reference \u2014 JSON cannot represent it", path);
+  }
+  if (value instanceof Date) {
+    reject("Date \u2014 JSON coerces it to a string, losing the Date type", path);
+  }
+  if (value instanceof RegExp) {
+    reject("RegExp \u2014 JSON coerces it to an empty object", path);
+  }
+  if (value instanceof Map || value instanceof Set) {
+    reject(`${describe(value)} \u2014 JSON coerces it to an empty object`, path);
+  }
+  if (ArrayBuffer.isView(value) || value instanceof ArrayBuffer || typeof Buffer !== "undefined" && Buffer.isBuffer(value)) {
+    reject(`${describe(value)} (binary) \u2014 JSON does not represent binary faithfully`, path);
+  }
+  seen.add(obj);
+  if (Array.isArray(value)) {
+    value.forEach((item, index) => assertNode(item, `${path}[${index}]`, seen));
+    seen.delete(obj);
+    return;
+  }
+  if (!isPlainObject(obj)) {
+    reject(
+      `${describe(value)} \u2014 only plain objects survive JSON; class instances collapse to plain objects`,
+      path
+    );
+  }
+  for (const [key, child] of Object.entries(value)) {
+    assertNode(child, path === "root" ? key : `${path}.${key}`, seen);
+  }
+  seen.delete(obj);
+}
+function assertLoopbackSerializable(value, label = "root") {
+  if (value === void 0) return;
+  assertNode(value, label, /* @__PURE__ */ new WeakSet());
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  LoopbackSerializationError,
+  assertLoopbackSerializable
+});
+//# sourceMappingURL=loopback_serialization.cjs.map

package/dist/transport/loopback_serialization.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/transport/loopback_serialization.ts"],"sourcesContent":["/**\n * Strict JSON serialization guard for the loopback transport.\n *\n * The loopback transport moves payloads over HTTP as JSON. JSON cannot\n * faithfully represent many values that Electron's structured-clone IPC can\n * (or that it round-trips differently): `Date` becomes a string, `undefined`\n * keys silently vanish, `NaN`/`Infinity` become `null`, binary is lost, class\n * instances collapse to plain objects. Electron structured-clone is the\n * ground-truth contract; rather than let the loopback transport silently\n * diverge from it, we REJECT anything JSON would coerce or drop, with a clear,\n * path-annotated error.\n *\n * This is deliberately stricter than `JSON.stringify` (which merely drops\n * `undefined`/functions and throws only on `bigint`): faithful representation,\n * not \"did not crash\", is the bar.\n */\n\nexport class LoopbackSerializationError extends Error {\n  constructor(\n    message: string,\n    readonly path: string,\n  ) {\n    super(message);\n    this.name = 'LoopbackSerializationError';\n  }\n}\n\nfunction describe(value: unknown): string {\n  if (value === null) return 'null';\n  if (Array.isArray(value)) return 'array';\n  const t = typeof value;\n  if (t === 'object') {\n    const ctor = (value as object).constructor;\n    return ctor && ctor.name ? `${ctor.name} instance` : 'object';\n  }\n  return t;\n}\n\nfunction isPlainObject(value: object): boolean {\n  const proto = Object.getPrototypeOf(value);\n  return proto === Object.prototype || proto === null;\n}\n\nfunction reject(reason: string, path: string): never {\n  throw new LoopbackSerializationError(\n    `Loopback transport cannot faithfully serialize value at ${path}: ${reason}. ` +\n      `The loopback transport uses JSON; use InProcessRouterTransport (or the real ` +\n      `Electron transport) for values that require structured clone.`,\n    path,\n  );\n}\n\nfunction assertNode(value: unknown, path: string, seen: WeakSet<object>): void {\n  if (value === null) return;\n\n  const t = typeof value;\n\n  if (t === 'string' || t === 'boolean') return;\n\n  if (t === 'number') {\n    if (!Number.isFinite(value as number)) {\n      reject('non-finite number (NaN/Infinity) — JSON coerces it to null', path);\n    }\n    return;\n  }\n\n  if (t === 'undefined') {\n    reject('undefined — JSON drops it silently', path);\n  }\n  if (t === 'bigint') {\n    reject('bigint — JSON cannot represent it', path);\n  }\n  if (t === 'function') {\n    reject('function — JSON drops it silently', path);\n  }\n  if (t === 'symbol') {\n    reject('symbol — JSON drops it silently', path);\n  }\n\n  // From here, t === 'object'.\n  const obj = value as object;\n\n  if (seen.has(obj)) {\n    reject('circular reference — JSON cannot represent it', path);\n  }\n\n  if (value instanceof Date) {\n    reject('Date — JSON coerces it to a string, losing the Date type', path);\n  }\n  if (value instanceof RegExp) {\n    reject('RegExp — JSON coerces it to an empty object', path);\n  }\n  if (value instanceof Map || value instanceof Set) {\n    reject(`${describe(value)} — JSON coerces it to an empty object`, path);\n  }\n  if (\n    ArrayBuffer.isView(value) ||\n    value instanceof ArrayBuffer ||\n    (typeof Buffer !== 'undefined' && Buffer.isBuffer(value))\n  ) {\n    reject(`${describe(value)} (binary) — JSON does not represent binary faithfully`, path);\n  }\n\n  seen.add(obj);\n\n  if (Array.isArray(value)) {\n    value.forEach((item, index) => assertNode(item, `${path}[${index}]`, seen));\n    seen.delete(obj);\n    return;\n  }\n\n  if (!isPlainObject(obj)) {\n    reject(\n      `${describe(value)} — only plain objects survive JSON; class instances collapse to plain objects`,\n      path,\n    );\n  }\n\n  for (const [key, child] of Object.entries(value as Record<string, unknown>)) {\n    assertNode(child, path === 'root' ? key : `${path}.${key}`, seen);\n  }\n  seen.delete(obj);\n}\n\n/**\n * Throw `LoopbackSerializationError` if `value` cannot be faithfully carried\n * over the JSON loopback transport. A top-level `undefined` is allowed because\n * it means \"no payload\" for inputless operations; nested `undefined` is not.\n */\nexport function assertLoopbackSerializable(value: unknown, label = 'root'): void {\n  if (value === undefined) return; // \"no payload\" sentinel at the top level only.\n  assertNode(value, label, new WeakSet<object>());\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAiBO,MAAM,mCAAmC,MAAM;AAAA,EACpD,YACE,SACS,MACT;AACA,UAAM,OAAO;AAFJ;AAGT,SAAK,OAAO;AAAA,EACd;AACF;AAEA,SAAS,SAAS,OAAwB;AACxC,MAAI,UAAU,KAAM,QAAO;AAC3B,MAAI,MAAM,QAAQ,KAAK,EAAG,QAAO;AACjC,QAAM,IAAI,OAAO;AACjB,MAAI,MAAM,UAAU;AAClB,UAAM,OAAQ,MAAiB;AAC/B,WAAO,QAAQ,KAAK,OAAO,GAAG,KAAK,IAAI,cAAc;AAAA,EACvD;AACA,SAAO;AACT;AAEA,SAAS,cAAc,OAAwB;AAC7C,QAAM,QAAQ,OAAO,eAAe,KAAK;AACzC,SAAO,UAAU,OAAO,aAAa,UAAU;AACjD;AAEA,SAAS,OAAO,QAAgB,MAAqB;AACnD,QAAM,IAAI;AAAA,IACR,2DAA2D,IAAI,KAAK,MAAM;AAAA,IAG1E;AAAA,EACF;AACF;AAEA,SAAS,WAAW,OAAgB,MAAc,MAA6B;AAC7E,MAAI,UAAU,KAAM;AAEpB,QAAM,IAAI,OAAO;AAEjB,MAAI,MAAM,YAAY,MAAM,UAAW;AAEvC,MAAI,MAAM,UAAU;AAClB,QAAI,CAAC,OAAO,SAAS,KAAe,GAAG;AACrC,aAAO,mEAA8D,IAAI;AAAA,IAC3E;AACA;AAAA,EACF;AAEA,MAAI,MAAM,aAAa;AACrB,WAAO,2CAAsC,IAAI;AAAA,EACnD;AACA,MAAI,MAAM,UAAU;AAClB,WAAO,0CAAqC,IAAI;AAAA,EAClD;AACA,MAAI,MAAM,YAAY;AACpB,WAAO,0CAAqC,IAAI;AAAA,EAClD;AACA,MAAI,MAAM,UAAU;AAClB,WAAO,wCAAmC,IAAI;AAAA,EAChD;AAGA,QAAM,MAAM;AAEZ,MAAI,KAAK,IAAI,GAAG,GAAG;AACjB,WAAO,sDAAiD,IAAI;AAAA,EAC9D;AAEA,MAAI,iBAAiB,MAAM;AACzB,WAAO,iEAA4D,IAAI;AAAA,EACzE;AACA,MAAI,iBAAiB,QAAQ;AAC3B,WAAO,oDAA+C,IAAI;AAAA,EAC5D;AACA,MAAI,iBAAiB,OAAO,iBAAiB,KAAK;AAChD,WAAO,GAAG,SAAS,KAAK,CAAC,8CAAyC,IAAI;AAAA,EACxE;AACA,MACE,YAAY,OAAO,KAAK,KACxB,iBAAiB,eAChB,OAAO,WAAW,eAAe,OAAO,SAAS,KAAK,GACvD;AACA,WAAO,GAAG,SAAS,KAAK,CAAC,8DAAyD,IAAI;AAAA,EACxF;AAEA,OAAK,IAAI,GAAG;AAEZ,MAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,UAAM,QAAQ,CAAC,MAAM,UAAU,WAAW,MAAM,GAAG,IAAI,IAAI,KAAK,KAAK,IAAI,CAAC;AAC1E,SAAK,OAAO,GAAG;AACf;AAAA,EACF;AAEA,MAAI,CAAC,cAAc,GAAG,GAAG;AACvB;AAAA,MACE,GAAG,SAAS,KAAK,CAAC;AAAA,MAClB;AAAA,IACF;AAAA,EACF;AAEA,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,KAAgC,GAAG;AAC3E,eAAW,OAAO,SAAS,SAAS,MAAM,GAAG,IAAI,IAAI,GAAG,IAAI,IAAI;AAAA,EAClE;AACA,OAAK,OAAO,GAAG;AACjB;AAOO,SAAS,2BAA2B,OAAgB,QAAQ,QAAc;AAC/E,MAAI,UAAU,OAAW;AACzB,aAAW,OAAO,OAAO,oBAAI,QAAgB,CAAC;AAChD;","names":[]}

package/dist/transport/loopback_serialization.d.cts

@@ -0,0 +1,28 @@
+/**
+ * Strict JSON serialization guard for the loopback transport.
+ *
+ * The loopback transport moves payloads over HTTP as JSON. JSON cannot
+ * faithfully represent many values that Electron's structured-clone IPC can
+ * (or that it round-trips differently): `Date` becomes a string, `undefined`
+ * keys silently vanish, `NaN`/`Infinity` become `null`, binary is lost, class
+ * instances collapse to plain objects. Electron structured-clone is the
+ * ground-truth contract; rather than let the loopback transport silently
+ * diverge from it, we REJECT anything JSON would coerce or drop, with a clear,
+ * path-annotated error.
+ *
+ * This is deliberately stricter than `JSON.stringify` (which merely drops
+ * `undefined`/functions and throws only on `bigint`): faithful representation,
+ * not "did not crash", is the bar.
+ */
+declare class LoopbackSerializationError extends Error {
+    readonly path: string;
+    constructor(message: string, path: string);
+}
+/**
+ * Throw `LoopbackSerializationError` if `value` cannot be faithfully carried
+ * over the JSON loopback transport. A top-level `undefined` is allowed because
+ * it means "no payload" for inputless operations; nested `undefined` is not.
+ */
+declare function assertLoopbackSerializable(value: unknown, label?: string): void;
+
+export { LoopbackSerializationError, assertLoopbackSerializable };

package/dist/transport/loopback_serialization.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Strict JSON serialization guard for the loopback transport.
+ *
+ * The loopback transport moves payloads over HTTP as JSON. JSON cannot
+ * faithfully represent many values that Electron's structured-clone IPC can
+ * (or that it round-trips differently): `Date` becomes a string, `undefined`
+ * keys silently vanish, `NaN`/`Infinity` become `null`, binary is lost, class
+ * instances collapse to plain objects. Electron structured-clone is the
+ * ground-truth contract; rather than let the loopback transport silently
+ * diverge from it, we REJECT anything JSON would coerce or drop, with a clear,
+ * path-annotated error.
+ *
+ * This is deliberately stricter than `JSON.stringify` (which merely drops
+ * `undefined`/functions and throws only on `bigint`): faithful representation,
+ * not "did not crash", is the bar.
+ */
+declare class LoopbackSerializationError extends Error {
+    readonly path: string;
+    constructor(message: string, path: string);
+}
+/**
+ * Throw `LoopbackSerializationError` if `value` cannot be faithfully carried
+ * over the JSON loopback transport. A top-level `undefined` is allowed because
+ * it means "no payload" for inputless operations; nested `undefined` is not.
+ */
+declare function assertLoopbackSerializable(value: unknown, label?: string): void;
+
+export { LoopbackSerializationError, assertLoopbackSerializable };

package/dist/transport/loopback_serialization.js

@@ -0,0 +1,91 @@
+class LoopbackSerializationError extends Error {
+  constructor(message, path) {
+    super(message);
+    this.path = path;
+    this.name = "LoopbackSerializationError";
+  }
+}
+function describe(value) {
+  if (value === null) return "null";
+  if (Array.isArray(value)) return "array";
+  const t = typeof value;
+  if (t === "object") {
+    const ctor = value.constructor;
+    return ctor && ctor.name ? `${ctor.name} instance` : "object";
+  }
+  return t;
+}
+function isPlainObject(value) {
+  const proto = Object.getPrototypeOf(value);
+  return proto === Object.prototype || proto === null;
+}
+function reject(reason, path) {
+  throw new LoopbackSerializationError(
+    `Loopback transport cannot faithfully serialize value at ${path}: ${reason}. The loopback transport uses JSON; use InProcessRouterTransport (or the real Electron transport) for values that require structured clone.`,
+    path
+  );
+}
+function assertNode(value, path, seen) {
+  if (value === null) return;
+  const t = typeof value;
+  if (t === "string" || t === "boolean") return;
+  if (t === "number") {
+    if (!Number.isFinite(value)) {
+      reject("non-finite number (NaN/Infinity) \u2014 JSON coerces it to null", path);
+    }
+    return;
+  }
+  if (t === "undefined") {
+    reject("undefined \u2014 JSON drops it silently", path);
+  }
+  if (t === "bigint") {
+    reject("bigint \u2014 JSON cannot represent it", path);
+  }
+  if (t === "function") {
+    reject("function \u2014 JSON drops it silently", path);
+  }
+  if (t === "symbol") {
+    reject("symbol \u2014 JSON drops it silently", path);
+  }
+  const obj = value;
+  if (seen.has(obj)) {
+    reject("circular reference \u2014 JSON cannot represent it", path);
+  }
+  if (value instanceof Date) {
+    reject("Date \u2014 JSON coerces it to a string, losing the Date type", path);
+  }
+  if (value instanceof RegExp) {
+    reject("RegExp \u2014 JSON coerces it to an empty object", path);
+  }
+  if (value instanceof Map || value instanceof Set) {
+    reject(`${describe(value)} \u2014 JSON coerces it to an empty object`, path);
+  }
+  if (ArrayBuffer.isView(value) || value instanceof ArrayBuffer || typeof Buffer !== "undefined" && Buffer.isBuffer(value)) {
+    reject(`${describe(value)} (binary) \u2014 JSON does not represent binary faithfully`, path);
+  }
+  seen.add(obj);
+  if (Array.isArray(value)) {
+    value.forEach((item, index) => assertNode(item, `${path}[${index}]`, seen));
+    seen.delete(obj);
+    return;
+  }
+  if (!isPlainObject(obj)) {
+    reject(
+      `${describe(value)} \u2014 only plain objects survive JSON; class instances collapse to plain objects`,
+      path
+    );
+  }
+  for (const [key, child] of Object.entries(value)) {
+    assertNode(child, path === "root" ? key : `${path}.${key}`, seen);
+  }
+  seen.delete(obj);
+}
+function assertLoopbackSerializable(value, label = "root") {
+  if (value === void 0) return;
+  assertNode(value, label, /* @__PURE__ */ new WeakSet());
+}
+export {
+  LoopbackSerializationError,
+  assertLoopbackSerializable
+};
+//# sourceMappingURL=loopback_serialization.js.map

package/dist/transport/loopback_serialization.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/transport/loopback_serialization.ts"],"sourcesContent":["/**\n * Strict JSON serialization guard for the loopback transport.\n *\n * The loopback transport moves payloads over HTTP as JSON. JSON cannot\n * faithfully represent many values that Electron's structured-clone IPC can\n * (or that it round-trips differently): `Date` becomes a string, `undefined`\n * keys silently vanish, `NaN`/`Infinity` become `null`, binary is lost, class\n * instances collapse to plain objects. Electron structured-clone is the\n * ground-truth contract; rather than let the loopback transport silently\n * diverge from it, we REJECT anything JSON would coerce or drop, with a clear,\n * path-annotated error.\n *\n * This is deliberately stricter than `JSON.stringify` (which merely drops\n * `undefined`/functions and throws only on `bigint`): faithful representation,\n * not \"did not crash\", is the bar.\n */\n\nexport class LoopbackSerializationError extends Error {\n  constructor(\n    message: string,\n    readonly path: string,\n  ) {\n    super(message);\n    this.name = 'LoopbackSerializationError';\n  }\n}\n\nfunction describe(value: unknown): string {\n  if (value === null) return 'null';\n  if (Array.isArray(value)) return 'array';\n  const t = typeof value;\n  if (t === 'object') {\n    const ctor = (value as object).constructor;\n    return ctor && ctor.name ? `${ctor.name} instance` : 'object';\n  }\n  return t;\n}\n\nfunction isPlainObject(value: object): boolean {\n  const proto = Object.getPrototypeOf(value);\n  return proto === Object.prototype || proto === null;\n}\n\nfunction reject(reason: string, path: string): never {\n  throw new LoopbackSerializationError(\n    `Loopback transport cannot faithfully serialize value at ${path}: ${reason}. ` +\n      `The loopback transport uses JSON; use InProcessRouterTransport (or the real ` +\n      `Electron transport) for values that require structured clone.`,\n    path,\n  );\n}\n\nfunction assertNode(value: unknown, path: string, seen: WeakSet<object>): void {\n  if (value === null) return;\n\n  const t = typeof value;\n\n  if (t === 'string' || t === 'boolean') return;\n\n  if (t === 'number') {\n    if (!Number.isFinite(value as number)) {\n      reject('non-finite number (NaN/Infinity) — JSON coerces it to null', path);\n    }\n    return;\n  }\n\n  if (t === 'undefined') {\n    reject('undefined — JSON drops it silently', path);\n  }\n  if (t === 'bigint') {\n    reject('bigint — JSON cannot represent it', path);\n  }\n  if (t === 'function') {\n    reject('function — JSON drops it silently', path);\n  }\n  if (t === 'symbol') {\n    reject('symbol — JSON drops it silently', path);\n  }\n\n  // From here, t === 'object'.\n  const obj = value as object;\n\n  if (seen.has(obj)) {\n    reject('circular reference — JSON cannot represent it', path);\n  }\n\n  if (value instanceof Date) {\n    reject('Date — JSON coerces it to a string, losing the Date type', path);\n  }\n  if (value instanceof RegExp) {\n    reject('RegExp — JSON coerces it to an empty object', path);\n  }\n  if (value instanceof Map || value instanceof Set) {\n    reject(`${describe(value)} — JSON coerces it to an empty object`, path);\n  }\n  if (\n    ArrayBuffer.isView(value) ||\n    value instanceof ArrayBuffer ||\n    (typeof Buffer !== 'undefined' && Buffer.isBuffer(value))\n  ) {\n    reject(`${describe(value)} (binary) — JSON does not represent binary faithfully`, path);\n  }\n\n  seen.add(obj);\n\n  if (Array.isArray(value)) {\n    value.forEach((item, index) => assertNode(item, `${path}[${index}]`, seen));\n    seen.delete(obj);\n    return;\n  }\n\n  if (!isPlainObject(obj)) {\n    reject(\n      `${describe(value)} — only plain objects survive JSON; class instances collapse to plain objects`,\n      path,\n    );\n  }\n\n  for (const [key, child] of Object.entries(value as Record<string, unknown>)) {\n    assertNode(child, path === 'root' ? key : `${path}.${key}`, seen);\n  }\n  seen.delete(obj);\n}\n\n/**\n * Throw `LoopbackSerializationError` if `value` cannot be faithfully carried\n * over the JSON loopback transport. A top-level `undefined` is allowed because\n * it means \"no payload\" for inputless operations; nested `undefined` is not.\n */\nexport function assertLoopbackSerializable(value: unknown, label = 'root'): void {\n  if (value === undefined) return; // \"no payload\" sentinel at the top level only.\n  assertNode(value, label, new WeakSet<object>());\n}\n"],"mappings":"AAiBO,MAAM,mCAAmC,MAAM;AAAA,EACpD,YACE,SACS,MACT;AACA,UAAM,OAAO;AAFJ;AAGT,SAAK,OAAO;AAAA,EACd;AACF;AAEA,SAAS,SAAS,OAAwB;AACxC,MAAI,UAAU,KAAM,QAAO;AAC3B,MAAI,MAAM,QAAQ,KAAK,EAAG,QAAO;AACjC,QAAM,IAAI,OAAO;AACjB,MAAI,MAAM,UAAU;AAClB,UAAM,OAAQ,MAAiB;AAC/B,WAAO,QAAQ,KAAK,OAAO,GAAG,KAAK,IAAI,cAAc;AAAA,EACvD;AACA,SAAO;AACT;AAEA,SAAS,cAAc,OAAwB;AAC7C,QAAM,QAAQ,OAAO,eAAe,KAAK;AACzC,SAAO,UAAU,OAAO,aAAa,UAAU;AACjD;AAEA,SAAS,OAAO,QAAgB,MAAqB;AACnD,QAAM,IAAI;AAAA,IACR,2DAA2D,IAAI,KAAK,MAAM;AAAA,IAG1E;AAAA,EACF;AACF;AAEA,SAAS,WAAW,OAAgB,MAAc,MAA6B;AAC7E,MAAI,UAAU,KAAM;AAEpB,QAAM,IAAI,OAAO;AAEjB,MAAI,MAAM,YAAY,MAAM,UAAW;AAEvC,MAAI,MAAM,UAAU;AAClB,QAAI,CAAC,OAAO,SAAS,KAAe,GAAG;AACrC,aAAO,mEAA8D,IAAI;AAAA,IAC3E;AACA;AAAA,EACF;AAEA,MAAI,MAAM,aAAa;AACrB,WAAO,2CAAsC,IAAI;AAAA,EACnD;AACA,MAAI,MAAM,UAAU;AAClB,WAAO,0CAAqC,IAAI;AAAA,EAClD;AACA,MAAI,MAAM,YAAY;AACpB,WAAO,0CAAqC,IAAI;AAAA,EAClD;AACA,MAAI,MAAM,UAAU;AAClB,WAAO,wCAAmC,IAAI;AAAA,EAChD;AAGA,QAAM,MAAM;AAEZ,MAAI,KAAK,IAAI,GAAG,GAAG;AACjB,WAAO,sDAAiD,IAAI;AAAA,EAC9D;AAEA,MAAI,iBAAiB,MAAM;AACzB,WAAO,iEAA4D,IAAI;AAAA,EACzE;AACA,MAAI,iBAAiB,QAAQ;AAC3B,WAAO,oDAA+C,IAAI;AAAA,EAC5D;AACA,MAAI,iBAAiB,OAAO,iBAAiB,KAAK;AAChD,WAAO,GAAG,SAAS,KAAK,CAAC,8CAAyC,IAAI;AAAA,EACxE;AACA,MACE,YAAY,OAAO,KAAK,KACxB,iBAAiB,eAChB,OAAO,WAAW,eAAe,OAAO,SAAS,KAAK,GACvD;AACA,WAAO,GAAG,SAAS,KAAK,CAAC,8DAAyD,IAAI;AAAA,EACxF;AAEA,OAAK,IAAI,GAAG;AAEZ,MAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,UAAM,QAAQ,CAAC,MAAM,UAAU,WAAW,MAAM,GAAG,IAAI,IAAI,KAAK,KAAK,IAAI,CAAC;AAC1E,SAAK,OAAO,GAAG;AACf;AAAA,EACF;AAEA,MAAI,CAAC,cAAc,GAAG,GAAG;AACvB;AAAA,MACE,GAAG,SAAS,KAAK,CAAC;AAAA,MAClB;AAAA,IACF;AAAA,EACF;AAEA,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,KAAgC,GAAG;AAC3E,eAAW,OAAO,SAAS,SAAS,MAAM,GAAG,IAAI,IAAI,GAAG,IAAI,IAAI;AAAA,EAClE;AACA,OAAK,OAAO,GAAG;AACjB;AAOO,SAAS,2BAA2B,OAAgB,QAAQ,QAAc;AAC/E,MAAI,UAAU,OAAW;AACzB,aAAW,OAAO,OAAO,oBAAI,QAAgB,CAAC;AAChD;","names":[]}

package/dist/transport/transport_contract_suite.cjs

@@ -0,0 +1,110 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var transport_contract_suite_exports = {};
+__export(transport_contract_suite_exports, {
+  CONTRACT_OPERATIONS_YAML: () => CONTRACT_OPERATIONS_YAML,
+  runTransportContractSuite: () => runTransportContractSuite
+});
+module.exports = __toCommonJS(transport_contract_suite_exports);
+var import_vitest = require("vitest");
+const CONTRACT_OPERATIONS_YAML = `
+operations:
+  test.hello:
+    controller: test
+    action: hello
+  chat.send:
+    controller: chat
+    action: sendMessage
+    input:
+      type: object
+      additionalProperties: false
+      required: [message]
+      properties:
+        message:
+          type: string
+`;
+async function waitFor(predicate, timeoutMs = 1e3) {
+  const deadline = Date.now() + timeoutMs;
+  while (!predicate()) {
+    if (Date.now() > deadline) {
+      throw new Error("waitFor timed out");
+    }
+    await new Promise((resolve) => setTimeout(resolve, 5));
+  }
+}
+function runTransportContractSuite(name, createSetup) {
+  (0, import_vitest.describe)(`WoodRpcTransport contract: ${name}`, () => {
+    let setup;
+    (0, import_vitest.beforeEach)(async () => {
+      setup = await createSetup();
+    });
+    (0, import_vitest.afterEach)(async () => {
+      await setup.destroy();
+    });
+    (0, import_vitest.test)("invokes an inputless operation", async () => {
+      const result = await setup.transport.invoke("test.hello");
+      (0, import_vitest.expect)(result).toEqual({ greeting: "Hello from test controller" });
+    });
+    (0, import_vitest.test)("invokes an input-bearing operation", async () => {
+      const result = await setup.transport.invoke("chat.send", { message: "Hi" });
+      (0, import_vitest.expect)(result).toMatchObject({ reply: "Echo: Hi" });
+    });
+    (0, import_vitest.test)("rejects an unknown/additional property via router schema validation", async () => {
+      await (0, import_vitest.expect)(
+        setup.transport.invoke("chat.send", { message: "Hi", bogus: true })
+      ).rejects.toThrow(/validation/i);
+    });
+    (0, import_vitest.test)("propagates controller/router errors as rejected promises", async () => {
+      await (0, import_vitest.expect)(setup.transport.invoke("does.not.exist")).rejects.toThrow(
+        /unknown operation/i
+      );
+    });
+    (0, import_vitest.test)("delivers push events to a subscriber and stops after unsubscribe", async () => {
+      const received = [];
+      const unsubscribe = setup.transport.subscribe("thread.created", (payload) => {
+        received.push(payload);
+      });
+      setup.emit("thread.created", { threadId: 7 });
+      await waitFor(() => received.length === 1);
+      (0, import_vitest.expect)(received[0]).toEqual({ threadId: 7 });
+      unsubscribe();
+      setup.emit("thread.created", { threadId: 8 });
+      await new Promise((resolve) => setTimeout(resolve, 40));
+      (0, import_vitest.expect)(received).toHaveLength(1);
+    });
+    (0, import_vitest.test)("supports multiple independent subscribers on one channel", async () => {
+      const a = [];
+      const b = [];
+      const unsubA = setup.transport.subscribe("thread.updated", (p) => a.push(p));
+      const unsubB = setup.transport.subscribe("thread.updated", (p) => b.push(p));
+      setup.emit("thread.updated", { threadId: 1 });
+      await waitFor(() => a.length === 1 && b.length === 1);
+      (0, import_vitest.expect)(a[0]).toEqual({ threadId: 1 });
+      (0, import_vitest.expect)(b[0]).toEqual({ threadId: 1 });
+      unsubA();
+      unsubB();
+    });
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CONTRACT_OPERATIONS_YAML,
+  runTransportContractSuite
+});
+//# sourceMappingURL=transport_contract_suite.cjs.map

package/dist/transport/transport_contract_suite.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/transport/transport_contract_suite.ts"],"sourcesContent":["import { afterEach, beforeEach, describe, expect, test } from 'vitest';\nimport type { WoodRpcTransport } from './wood_rpc_transport.js';\n\n/**\n * The serialization/transport contract shared by every `WoodRpcTransport`.\n *\n * This module is intentionally NOT a `*.test.ts` file: it defines a reusable\n * suite that each transport's own test file runs, so `InProcessRouterTransport`\n * and `LoopbackRemoteTransport` are held to byte-identical behavior. Only the\n * loopback JSON edge-case rejections differ, and those live in the loopback\n * test file.\n */\n\n/** Operations used by the contract suite. `chat.send` locks `additionalProperties: false`. */\nexport const CONTRACT_OPERATIONS_YAML = `\noperations:\n  test.hello:\n    controller: test\n    action: hello\n  chat.send:\n    controller: chat\n    action: sendMessage\n    input:\n      type: object\n      additionalProperties: false\n      required: [message]\n      properties:\n        message:\n          type: string\n`;\n\nexport interface TransportContractSetup {\n  transport: WoodRpcTransport;\n  /** Simulate a `WindowEventService.send(channel, data)` push (prefix added internally). */\n  emit: (channel: string, data: unknown) => void;\n  destroy: () => Promise<void> | void;\n}\n\nexport type TransportContractFactory = () =>\n  | Promise<TransportContractSetup>\n  | TransportContractSetup;\n\nasync function waitFor(predicate: () => boolean, timeoutMs = 1000): Promise<void> {\n  const deadline = Date.now() + timeoutMs;\n  while (!predicate()) {\n    if (Date.now() > deadline) {\n      throw new Error('waitFor timed out');\n    }\n    await new Promise((resolve) => setTimeout(resolve, 5));\n  }\n}\n\nexport function runTransportContractSuite(\n  name: string,\n  createSetup: TransportContractFactory,\n): void {\n  describe(`WoodRpcTransport contract: ${name}`, () => {\n    let setup: TransportContractSetup;\n\n    beforeEach(async () => {\n      setup = await createSetup();\n    });\n\n    afterEach(async () => {\n      await setup.destroy();\n    });\n\n    test('invokes an inputless operation', async () => {\n      const result = await setup.transport.invoke('test.hello');\n      expect(result).toEqual({ greeting: 'Hello from test controller' });\n    });\n\n    test('invokes an input-bearing operation', async () => {\n      const result = await setup.transport.invoke('chat.send', { message: 'Hi' });\n      expect(result).toMatchObject({ reply: 'Echo: Hi' });\n    });\n\n    test('rejects an unknown/additional property via router schema validation', async () => {\n      await expect(\n        setup.transport.invoke('chat.send', { message: 'Hi', bogus: true }),\n      ).rejects.toThrow(/validation/i);\n    });\n\n    test('propagates controller/router errors as rejected promises', async () => {\n      await expect(setup.transport.invoke('does.not.exist')).rejects.toThrow(\n        /unknown operation/i,\n      );\n    });\n\n    test('delivers push events to a subscriber and stops after unsubscribe', async () => {\n      const received: unknown[] = [];\n      const unsubscribe = setup.transport.subscribe('thread.created', (payload) => {\n        received.push(payload);\n      });\n\n      setup.emit('thread.created', { threadId: 7 });\n      await waitFor(() => received.length === 1);\n      expect(received[0]).toEqual({ threadId: 7 });\n\n      unsubscribe();\n      setup.emit('thread.created', { threadId: 8 });\n      await new Promise((resolve) => setTimeout(resolve, 40));\n      expect(received).toHaveLength(1);\n    });\n\n    test('supports multiple independent subscribers on one channel', async () => {\n      const a: unknown[] = [];\n      const b: unknown[] = [];\n      const unsubA = setup.transport.subscribe('thread.updated', (p) => a.push(p));\n      const unsubB = setup.transport.subscribe('thread.updated', (p) => b.push(p));\n\n      setup.emit('thread.updated', { threadId: 1 });\n      await waitFor(() => a.length === 1 && b.length === 1);\n      expect(a[0]).toEqual({ threadId: 1 });\n      expect(b[0]).toEqual({ threadId: 1 });\n\n      unsubA();\n      unsubB();\n    });\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,oBAA8D;AAcvD,MAAM,2BAA2B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA4BxC,eAAe,QAAQ,WAA0B,YAAY,KAAqB;AAChF,QAAM,WAAW,KAAK,IAAI,IAAI;AAC9B,SAAO,CAAC,UAAU,GAAG;AACnB,QAAI,KAAK,IAAI,IAAI,UAAU;AACzB,YAAM,IAAI,MAAM,mBAAmB;AAAA,IACrC;AACA,UAAM,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,CAAC,CAAC;AAAA,EACvD;AACF;AAEO,SAAS,0BACd,MACA,aACM;AACN,8BAAS,8BAA8B,IAAI,IAAI,MAAM;AACnD,QAAI;AAEJ,kCAAW,YAAY;AACrB,cAAQ,MAAM,YAAY;AAAA,IAC5B,CAAC;AAED,iCAAU,YAAY;AACpB,YAAM,MAAM,QAAQ;AAAA,IACtB,CAAC;AAED,4BAAK,kCAAkC,YAAY;AACjD,YAAM,SAAS,MAAM,MAAM,UAAU,OAAO,YAAY;AACxD,gCAAO,MAAM,EAAE,QAAQ,EAAE,UAAU,6BAA6B,CAAC;AAAA,IACnE,CAAC;AAED,4BAAK,sCAAsC,YAAY;AACrD,YAAM,SAAS,MAAM,MAAM,UAAU,OAAO,aAAa,EAAE,SAAS,KAAK,CAAC;AAC1E,gCAAO,MAAM,EAAE,cAAc,EAAE,OAAO,WAAW,CAAC;AAAA,IACpD,CAAC;AAED,4BAAK,uEAAuE,YAAY;AACtF,gBAAM;AAAA,QACJ,MAAM,UAAU,OAAO,aAAa,EAAE,SAAS,MAAM,OAAO,KAAK,CAAC;AAAA,MACpE,EAAE,QAAQ,QAAQ,aAAa;AAAA,IACjC,CAAC;AAED,4BAAK,4DAA4D,YAAY;AAC3E,gBAAM,sBAAO,MAAM,UAAU,OAAO,gBAAgB,CAAC,EAAE,QAAQ;AAAA,QAC7D;AAAA,MACF;AAAA,IACF,CAAC;AAED,4BAAK,oEAAoE,YAAY;AACnF,YAAM,WAAsB,CAAC;AAC7B,YAAM,cAAc,MAAM,UAAU,UAAU,kBAAkB,CAAC,YAAY;AAC3E,iBAAS,KAAK,OAAO;AAAA,MACvB,CAAC;AAED,YAAM,KAAK,kBAAkB,EAAE,UAAU,EAAE,CAAC;AAC5C,YAAM,QAAQ,MAAM,SAAS,WAAW,CAAC;AACzC,gCAAO,SAAS,CAAC,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;AAE3C,kBAAY;AACZ,YAAM,KAAK,kBAAkB,EAAE,UAAU,EAAE,CAAC;AAC5C,YAAM,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,EAAE,CAAC;AACtD,gCAAO,QAAQ,EAAE,aAAa,CAAC;AAAA,IACjC,CAAC;AAED,4BAAK,4DAA4D,YAAY;AAC3E,YAAM,IAAe,CAAC;AACtB,YAAM,IAAe,CAAC;AACtB,YAAM,SAAS,MAAM,UAAU,UAAU,kBAAkB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAC3E,YAAM,SAAS,MAAM,UAAU,UAAU,kBAAkB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAE3E,YAAM,KAAK,kBAAkB,EAAE,UAAU,EAAE,CAAC;AAC5C,YAAM,QAAQ,MAAM,EAAE,WAAW,KAAK,EAAE,WAAW,CAAC;AACpD,gCAAO,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;AACpC,gCAAO,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;AAEpC,aAAO;AACP,aAAO;AAAA,IACT,CAAC;AAAA,EACH,CAAC;AACH;","names":[]}

package/dist/transport/transport_contract_suite.d.cts

@@ -0,0 +1,23 @@
+import { WoodRpcTransport } from './wood_rpc_transport.cjs';
+
+/**
+ * The serialization/transport contract shared by every `WoodRpcTransport`.
+ *
+ * This module is intentionally NOT a `*.test.ts` file: it defines a reusable
+ * suite that each transport's own test file runs, so `InProcessRouterTransport`
+ * and `LoopbackRemoteTransport` are held to byte-identical behavior. Only the
+ * loopback JSON edge-case rejections differ, and those live in the loopback
+ * test file.
+ */
+/** Operations used by the contract suite. `chat.send` locks `additionalProperties: false`. */
+declare const CONTRACT_OPERATIONS_YAML = "\noperations:\n  test.hello:\n    controller: test\n    action: hello\n  chat.send:\n    controller: chat\n    action: sendMessage\n    input:\n      type: object\n      additionalProperties: false\n      required: [message]\n      properties:\n        message:\n          type: string\n";
+interface TransportContractSetup {
+    transport: WoodRpcTransport;
+    /** Simulate a `WindowEventService.send(channel, data)` push (prefix added internally). */
+    emit: (channel: string, data: unknown) => void;
+    destroy: () => Promise<void> | void;
+}
+type TransportContractFactory = () => Promise<TransportContractSetup> | TransportContractSetup;
+declare function runTransportContractSuite(name: string, createSetup: TransportContractFactory): void;
+
+export { CONTRACT_OPERATIONS_YAML, type TransportContractFactory, type TransportContractSetup, runTransportContractSuite };

package/dist/transport/transport_contract_suite.d.ts

@@ -0,0 +1,23 @@
+import { WoodRpcTransport } from './wood_rpc_transport.js';
+
+/**
+ * The serialization/transport contract shared by every `WoodRpcTransport`.
+ *
+ * This module is intentionally NOT a `*.test.ts` file: it defines a reusable
+ * suite that each transport's own test file runs, so `InProcessRouterTransport`
+ * and `LoopbackRemoteTransport` are held to byte-identical behavior. Only the
+ * loopback JSON edge-case rejections differ, and those live in the loopback
+ * test file.
+ */
+/** Operations used by the contract suite. `chat.send` locks `additionalProperties: false`. */
+declare const CONTRACT_OPERATIONS_YAML = "\noperations:\n  test.hello:\n    controller: test\n    action: hello\n  chat.send:\n    controller: chat\n    action: sendMessage\n    input:\n      type: object\n      additionalProperties: false\n      required: [message]\n      properties:\n        message:\n          type: string\n";
+interface TransportContractSetup {
+    transport: WoodRpcTransport;
+    /** Simulate a `WindowEventService.send(channel, data)` push (prefix added internally). */
+    emit: (channel: string, data: unknown) => void;
+    destroy: () => Promise<void> | void;
+}
+type TransportContractFactory = () => Promise<TransportContractSetup> | TransportContractSetup;
+declare function runTransportContractSuite(name: string, createSetup: TransportContractFactory): void;
+
+export { CONTRACT_OPERATIONS_YAML, type TransportContractFactory, type TransportContractSetup, runTransportContractSuite };

package/dist/transport/transport_contract_suite.js

@@ -0,0 +1,85 @@
+import { afterEach, beforeEach, describe, expect, test } from "vitest";
+const CONTRACT_OPERATIONS_YAML = `
+operations:
+  test.hello:
+    controller: test
+    action: hello
+  chat.send:
+    controller: chat
+    action: sendMessage
+    input:
+      type: object
+      additionalProperties: false
+      required: [message]
+      properties:
+        message:
+          type: string
+`;
+async function waitFor(predicate, timeoutMs = 1e3) {
+  const deadline = Date.now() + timeoutMs;
+  while (!predicate()) {
+    if (Date.now() > deadline) {
+      throw new Error("waitFor timed out");
+    }
+    await new Promise((resolve) => setTimeout(resolve, 5));
+  }
+}
+function runTransportContractSuite(name, createSetup) {
+  describe(`WoodRpcTransport contract: ${name}`, () => {
+    let setup;
+    beforeEach(async () => {
+      setup = await createSetup();
+    });
+    afterEach(async () => {
+      await setup.destroy();
+    });
+    test("invokes an inputless operation", async () => {
+      const result = await setup.transport.invoke("test.hello");
+      expect(result).toEqual({ greeting: "Hello from test controller" });
+    });
+    test("invokes an input-bearing operation", async () => {
+      const result = await setup.transport.invoke("chat.send", { message: "Hi" });
+      expect(result).toMatchObject({ reply: "Echo: Hi" });
+    });
+    test("rejects an unknown/additional property via router schema validation", async () => {
+      await expect(
+        setup.transport.invoke("chat.send", { message: "Hi", bogus: true })
+      ).rejects.toThrow(/validation/i);
+    });
+    test("propagates controller/router errors as rejected promises", async () => {
+      await expect(setup.transport.invoke("does.not.exist")).rejects.toThrow(
+        /unknown operation/i
+      );
+    });
+    test("delivers push events to a subscriber and stops after unsubscribe", async () => {
+      const received = [];
+      const unsubscribe = setup.transport.subscribe("thread.created", (payload) => {
+        received.push(payload);
+      });
+      setup.emit("thread.created", { threadId: 7 });
+      await waitFor(() => received.length === 1);
+      expect(received[0]).toEqual({ threadId: 7 });
+      unsubscribe();
+      setup.emit("thread.created", { threadId: 8 });
+      await new Promise((resolve) => setTimeout(resolve, 40));
+      expect(received).toHaveLength(1);
+    });
+    test("supports multiple independent subscribers on one channel", async () => {
+      const a = [];
+      const b = [];
+      const unsubA = setup.transport.subscribe("thread.updated", (p) => a.push(p));
+      const unsubB = setup.transport.subscribe("thread.updated", (p) => b.push(p));
+      setup.emit("thread.updated", { threadId: 1 });
+      await waitFor(() => a.length === 1 && b.length === 1);
+      expect(a[0]).toEqual({ threadId: 1 });
+      expect(b[0]).toEqual({ threadId: 1 });
+      unsubA();
+      unsubB();
+    });
+  });
+}
+export {
+  CONTRACT_OPERATIONS_YAML,
+  runTransportContractSuite
+};
+//# sourceMappingURL=transport_contract_suite.js.map

package/dist/transport/transport_contract_suite.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/transport/transport_contract_suite.ts"],"sourcesContent":["import { afterEach, beforeEach, describe, expect, test } from 'vitest';\nimport type { WoodRpcTransport } from './wood_rpc_transport.js';\n\n/**\n * The serialization/transport contract shared by every `WoodRpcTransport`.\n *\n * This module is intentionally NOT a `*.test.ts` file: it defines a reusable\n * suite that each transport's own test file runs, so `InProcessRouterTransport`\n * and `LoopbackRemoteTransport` are held to byte-identical behavior. Only the\n * loopback JSON edge-case rejections differ, and those live in the loopback\n * test file.\n */\n\n/** Operations used by the contract suite. `chat.send` locks `additionalProperties: false`. */\nexport const CONTRACT_OPERATIONS_YAML = `\noperations:\n  test.hello:\n    controller: test\n    action: hello\n  chat.send:\n    controller: chat\n    action: sendMessage\n    input:\n      type: object\n      additionalProperties: false\n      required: [message]\n      properties:\n        message:\n          type: string\n`;\n\nexport interface TransportContractSetup {\n  transport: WoodRpcTransport;\n  /** Simulate a `WindowEventService.send(channel, data)` push (prefix added internally). */\n  emit: (channel: string, data: unknown) => void;\n  destroy: () => Promise<void> | void;\n}\n\nexport type TransportContractFactory = () =>\n  | Promise<TransportContractSetup>\n  | TransportContractSetup;\n\nasync function waitFor(predicate: () => boolean, timeoutMs = 1000): Promise<void> {\n  const deadline = Date.now() + timeoutMs;\n  while (!predicate()) {\n    if (Date.now() > deadline) {\n      throw new Error('waitFor timed out');\n    }\n    await new Promise((resolve) => setTimeout(resolve, 5));\n  }\n}\n\nexport function runTransportContractSuite(\n  name: string,\n  createSetup: TransportContractFactory,\n): void {\n  describe(`WoodRpcTransport contract: ${name}`, () => {\n    let setup: TransportContractSetup;\n\n    beforeEach(async () => {\n      setup = await createSetup();\n    });\n\n    afterEach(async () => {\n      await setup.destroy();\n    });\n\n    test('invokes an inputless operation', async () => {\n      const result = await setup.transport.invoke('test.hello');\n      expect(result).toEqual({ greeting: 'Hello from test controller' });\n    });\n\n    test('invokes an input-bearing operation', async () => {\n      const result = await setup.transport.invoke('chat.send', { message: 'Hi' });\n      expect(result).toMatchObject({ reply: 'Echo: Hi' });\n    });\n\n    test('rejects an unknown/additional property via router schema validation', async () => {\n      await expect(\n        setup.transport.invoke('chat.send', { message: 'Hi', bogus: true }),\n      ).rejects.toThrow(/validation/i);\n    });\n\n    test('propagates controller/router errors as rejected promises', async () => {\n      await expect(setup.transport.invoke('does.not.exist')).rejects.toThrow(\n        /unknown operation/i,\n      );\n    });\n\n    test('delivers push events to a subscriber and stops after unsubscribe', async () => {\n      const received: unknown[] = [];\n      const unsubscribe = setup.transport.subscribe('thread.created', (payload) => {\n        received.push(payload);\n      });\n\n      setup.emit('thread.created', { threadId: 7 });\n      await waitFor(() => received.length === 1);\n      expect(received[0]).toEqual({ threadId: 7 });\n\n      unsubscribe();\n      setup.emit('thread.created', { threadId: 8 });\n      await new Promise((resolve) => setTimeout(resolve, 40));\n      expect(received).toHaveLength(1);\n    });\n\n    test('supports multiple independent subscribers on one channel', async () => {\n      const a: unknown[] = [];\n      const b: unknown[] = [];\n      const unsubA = setup.transport.subscribe('thread.updated', (p) => a.push(p));\n      const unsubB = setup.transport.subscribe('thread.updated', (p) => b.push(p));\n\n      setup.emit('thread.updated', { threadId: 1 });\n      await waitFor(() => a.length === 1 && b.length === 1);\n      expect(a[0]).toEqual({ threadId: 1 });\n      expect(b[0]).toEqual({ threadId: 1 });\n\n      unsubA();\n      unsubB();\n    });\n  });\n}\n"],"mappings":"AAAA,SAAS,WAAW,YAAY,UAAU,QAAQ,YAAY;AAcvD,MAAM,2BAA2B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA4BxC,eAAe,QAAQ,WAA0B,YAAY,KAAqB;AAChF,QAAM,WAAW,KAAK,IAAI,IAAI;AAC9B,SAAO,CAAC,UAAU,GAAG;AACnB,QAAI,KAAK,IAAI,IAAI,UAAU;AACzB,YAAM,IAAI,MAAM,mBAAmB;AAAA,IACrC;AACA,UAAM,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,CAAC,CAAC;AAAA,EACvD;AACF;AAEO,SAAS,0BACd,MACA,aACM;AACN,WAAS,8BAA8B,IAAI,IAAI,MAAM;AACnD,QAAI;AAEJ,eAAW,YAAY;AACrB,cAAQ,MAAM,YAAY;AAAA,IAC5B,CAAC;AAED,cAAU,YAAY;AACpB,YAAM,MAAM,QAAQ;AAAA,IACtB,CAAC;AAED,SAAK,kCAAkC,YAAY;AACjD,YAAM,SAAS,MAAM,MAAM,UAAU,OAAO,YAAY;AACxD,aAAO,MAAM,EAAE,QAAQ,EAAE,UAAU,6BAA6B,CAAC;AAAA,IACnE,CAAC;AAED,SAAK,sCAAsC,YAAY;AACrD,YAAM,SAAS,MAAM,MAAM,UAAU,OAAO,aAAa,EAAE,SAAS,KAAK,CAAC;AAC1E,aAAO,MAAM,EAAE,cAAc,EAAE,OAAO,WAAW,CAAC;AAAA,IACpD,CAAC;AAED,SAAK,uEAAuE,YAAY;AACtF,YAAM;AAAA,QACJ,MAAM,UAAU,OAAO,aAAa,EAAE,SAAS,MAAM,OAAO,KAAK,CAAC;AAAA,MACpE,EAAE,QAAQ,QAAQ,aAAa;AAAA,IACjC,CAAC;AAED,SAAK,4DAA4D,YAAY;AAC3E,YAAM,OAAO,MAAM,UAAU,OAAO,gBAAgB,CAAC,EAAE,QAAQ;AAAA,QAC7D;AAAA,MACF;AAAA,IACF,CAAC;AAED,SAAK,oEAAoE,YAAY;AACnF,YAAM,WAAsB,CAAC;AAC7B,YAAM,cAAc,MAAM,UAAU,UAAU,kBAAkB,CAAC,YAAY;AAC3E,iBAAS,KAAK,OAAO;AAAA,MACvB,CAAC;AAED,YAAM,KAAK,kBAAkB,EAAE,UAAU,EAAE,CAAC;AAC5C,YAAM,QAAQ,MAAM,SAAS,WAAW,CAAC;AACzC,aAAO,SAAS,CAAC,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;AAE3C,kBAAY;AACZ,YAAM,KAAK,kBAAkB,EAAE,UAAU,EAAE,CAAC;AAC5C,YAAM,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,EAAE,CAAC;AACtD,aAAO,QAAQ,EAAE,aAAa,CAAC;AAAA,IACjC,CAAC;AAED,SAAK,4DAA4D,YAAY;AAC3E,YAAM,IAAe,CAAC;AACtB,YAAM,IAAe,CAAC;AACtB,YAAM,SAAS,MAAM,UAAU,UAAU,kBAAkB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAC3E,YAAM,SAAS,MAAM,UAAU,UAAU,kBAAkB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAE3E,YAAM,KAAK,kBAAkB,EAAE,UAAU,EAAE,CAAC;AAC5C,YAAM,QAAQ,MAAM,EAAE,WAAW,KAAK,EAAE,WAAW,CAAC;AACpD,aAAO,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;AACpC,aAAO,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;AAEpC,aAAO;AACP,aAAO;AAAA,IACT,CAAC;AAAA,EACH,CAAC;AACH;","names":[]}

package/dist/transport/wood_rpc_transport.cjs

@@ -0,0 +1,17 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var wood_rpc_transport_exports = {};
+module.exports = __toCommonJS(wood_rpc_transport_exports);
+//# sourceMappingURL=wood_rpc_transport.cjs.map

package/dist/transport/wood_rpc_transport.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/transport/wood_rpc_transport.ts"],"sourcesContent":["/**\n * The single seam every test-mode RPC path is built on.\n *\n * Production uses the Electron preload bridge (`ipcRenderer.invoke` +\n * `ipcRenderer.on('__event:...')`). Tests use one of the in-process or loopback\n * implementations. The generated bridge client is built over whichever transport\n * is supplied, so application code never knows which one is active.\n *\n * IMPORTANT (fast-tier isolation): this module and `InProcessRouterTransport`\n * must never import `electron` or `playwright`. Keep this file dependency-free.\n */\nexport interface WoodRpcTransport {\n  /**\n   * Dispatch a request/response call to a channel. `payload` is optional so\n   * inputless operations can be called as `invoke(channel)`.\n   */\n  invoke(channel: string, payload?: unknown): Promise<unknown>;\n\n  /**\n   * Subscribe to a main-process push channel (the `__event:`-prefixed events\n   * emitted by `WindowEventService`). Returns an unsubscribe function.\n   */\n  subscribe(channel: string, listener: (payload: unknown) => void): () => void;\n}\n\n/** One channel's input/output contract. The generated channel map is a record of these. */\nexport interface WoodChannelContract {\n  input: unknown;\n  output: unknown;\n}\n\n/** Shape a generated channel map conforms to: channel name -> { input, output }. */\nexport type WoodChannelMapLike = Record<string, WoodChannelContract>;\n\n/** Extract the input type for a channel in a generated map. */\nexport type WoodChannelInput<\n  M extends WoodChannelMapLike,\n  C extends keyof M,\n> = M[C]['input'];\n\n/** Extract the output type for a channel in a generated map. */\nexport type WoodChannelOutput<\n  M extends WoodChannelMapLike,\n  C extends keyof M,\n> = M[C]['output'];\n\n/**\n * A `call()` typed from a generated channel map. Harness `api.call` is this,\n * parameterized on the app's generated `WoodChannelMap`:\n *\n *   const call: TypedCall<WoodChannelMap> = ...;\n *   await call('messages.send', { threadId, text });  // fully typed\n */\nexport type TypedCall<M extends WoodChannelMapLike> = <C extends keyof M & string>(\n  channel: C,\n  ...payload: M[C]['input'] extends void ? [] : [M[C]['input']]\n) => Promise<M[C]['output']>;\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}