@noego/wood 0.0.1

package/dist/bridge/backend_bridge.cjs

@@ -0,0 +1,186 @@
+"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 backend_bridge_exports = {};
+__export(backend_bridge_exports, {
+  BackendBridge: () => BackendBridge
+});
+module.exports = __toCommonJS(backend_bridge_exports);
+var import_child_process = require("child_process");
+var import_crypto = __toESM(require("crypto"), 1);
+var import_logger = require("@noego/logger");
+const logger = (0, import_logger.getLogger)("wood:bridge");
+class BackendBridge {
+  constructor(options) {
+    this.child = null;
+    this.pending = /* @__PURE__ */ new Map();
+    this._state = "stopped";
+    this.options = options;
+    this.timeoutMs = options.timeout ?? 3e4;
+  }
+  get state() {
+    return this._state;
+  }
+  /** Start the backend process and wait for the ready signal. */
+  async start() {
+    this._state = "starting";
+    this.child = (0, import_child_process.fork)(this.options.backendEntry, [], {
+      stdio: ["pipe", "pipe", "pipe", "ipc"]
+    });
+    this.child.on("message", (msg) => this.onMessage(msg));
+    this.child.on("exit", (code, signal) => {
+      this._state = "stopped";
+      this.rejectAllPending(new Error("Backend process exited"));
+      logger.debug(`backend exited code=${code} signal=${signal}`);
+      this.options.onExit?.(code, signal);
+    });
+    this.child.stdout?.pipe(process.stdout);
+    this.child.stderr?.pipe(process.stderr);
+    await this.waitForReady();
+    this.options.onReady?.();
+  }
+  /** Stop the backend process gracefully (SIGTERM then SIGKILL). */
+  async stop() {
+    if (!this.child || this.child.killed) return;
+    this._state = "stopped";
+    this.rejectAllPending(new Error("Backend is stopping"));
+    return new Promise((resolve) => {
+      const killTimer = setTimeout(() => {
+        if (this.child && !this.child.killed) {
+          this.child.kill("SIGKILL");
+          logger.warn("backend did not exit in time, sent SIGKILL");
+        }
+        resolve();
+      }, 2e3);
+      this.child.once("exit", () => {
+        clearTimeout(killTimer);
+        resolve();
+      });
+      this.child.kill("SIGTERM");
+    });
+  }
+  /** Restart the backend process. */
+  async restart() {
+    this._state = "restarting";
+    logger.info("restarting backend");
+    await this.stop();
+    await this.start();
+  }
+  /** Send a request to the backend and return the result. */
+  call(channel, data) {
+    if (this._state !== "ready") {
+      return Promise.reject(new Error(`Backend not ready (state: ${this._state})`));
+    }
+    const id = import_crypto.default.randomUUID();
+    return new Promise((resolve, reject) => {
+      const timer = setTimeout(() => {
+        this.pending.delete(id);
+        reject(new Error(`Backend timeout: ${channel}`));
+      }, this.timeoutMs);
+      this.pending.set(id, { resolve, reject, timer });
+      this.child.send({
+        type: "request",
+        id,
+        channel,
+        data
+      });
+      logger.debug(`call ${id}: ${channel}`);
+    });
+  }
+  // -- Private --
+  waitForReady() {
+    return new Promise((resolve, reject) => {
+      const timer = setTimeout(() => {
+        reject(new Error("Backend failed to send ready signal within timeout"));
+      }, this.timeoutMs);
+      const readyHandler = (msg) => {
+        if (msg?.type === "ready") {
+          clearTimeout(timer);
+          this.child?.removeListener("message", readyHandler);
+          this._state = "ready";
+          logger.info("backend ready");
+          resolve();
+        }
+      };
+      this.child.on("message", readyHandler);
+    });
+  }
+  onMessage(msg) {
+    const message = msg;
+    if (message.type === "response") {
+      const resp = message;
+      const entry = this.pending.get(resp.id);
+      if (entry) {
+        clearTimeout(entry.timer);
+        this.pending.delete(resp.id);
+        if (resp.error) {
+          entry.reject(new Error(resp.error.message ?? "Backend error"));
+        } else {
+          entry.resolve(resp.result);
+        }
+      }
+    }
+    if (message.type === "push") {
+      const push = message;
+      this.options.onPush?.(push.channel, push.data);
+    }
+    if (message.type === "electron-api") {
+      this.handleElectronProxy(message);
+    }
+  }
+  async handleElectronProxy(msg) {
+    if (!this.options.onElectronApi) return;
+    try {
+      const result = await this.options.onElectronApi(msg.id, msg.api, msg.args);
+      this.child?.send({
+        type: "electron-api-response",
+        id: msg.id,
+        result
+      });
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error(String(err));
+      this.child?.send({
+        type: "electron-api-response",
+        id: msg.id,
+        error: { message: error.message, name: error.name }
+      });
+    }
+  }
+  rejectAllPending(error) {
+    for (const [, entry] of this.pending) {
+      clearTimeout(entry.timer);
+      entry.reject(error);
+    }
+    this.pending.clear();
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BackendBridge
+});
+//# sourceMappingURL=backend_bridge.cjs.map

package/dist/bridge/backend_bridge.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/bridge/backend_bridge.ts"],"sourcesContent":["import { fork, type ChildProcess } from 'child_process';\nimport crypto from 'crypto';\nimport { getLogger } from '@noego/logger';\nimport type {\n  BridgeRequest,\n  BridgeResponse,\n  BridgeReady,\n  BridgePush,\n  BridgeElectronApi,\n} from '../types/bridge';\n\nconst logger = getLogger('wood:bridge');\n\ninterface PendingCall {\n  resolve: (value: unknown) => void;\n  reject: (error: Error) => void;\n  timer: NodeJS.Timeout;\n}\n\nexport interface BridgeOptions {\n  backendEntry: string;\n  timeout?: number;\n  onReady?: () => void;\n  onPush?: (channel: string, data: unknown) => void;\n  onElectronApi?: (id: string, api: string, args: unknown[]) => Promise<unknown>;\n  onExit?: (code: number | null, signal: string | null) => void;\n}\n\ntype BridgeState = 'stopped' | 'starting' | 'ready' | 'restarting';\n\nexport class BackendBridge {\n  private child: ChildProcess | null = null;\n  private pending = new Map<string, PendingCall>();\n  private readonly options: BridgeOptions;\n  private readonly timeoutMs: number;\n  private _state: BridgeState = 'stopped';\n\n  constructor(options: BridgeOptions) {\n    this.options = options;\n    this.timeoutMs = options.timeout ?? 30_000;\n  }\n\n  get state(): BridgeState {\n    return this._state;\n  }\n\n  /** Start the backend process and wait for the ready signal. */\n  async start(): Promise<void> {\n    this._state = 'starting';\n\n    this.child = fork(this.options.backendEntry, [], {\n      stdio: ['pipe', 'pipe', 'pipe', 'ipc'],\n    });\n\n    this.child.on('message', (msg: unknown) => this.onMessage(msg));\n    this.child.on('exit', (code, signal) => {\n      this._state = 'stopped';\n      this.rejectAllPending(new Error('Backend process exited'));\n      logger.debug(`backend exited code=${code} signal=${signal}`);\n      this.options.onExit?.(code, signal);\n    });\n\n    this.child.stdout?.pipe(process.stdout);\n    this.child.stderr?.pipe(process.stderr);\n\n    await this.waitForReady();\n    this.options.onReady?.();\n  }\n\n  /** Stop the backend process gracefully (SIGTERM then SIGKILL). */\n  async stop(): Promise<void> {\n    if (!this.child || this.child.killed) return;\n\n    this._state = 'stopped';\n    this.rejectAllPending(new Error('Backend is stopping'));\n\n    return new Promise<void>((resolve) => {\n      const killTimer = setTimeout(() => {\n        if (this.child && !this.child.killed) {\n          this.child.kill('SIGKILL');\n          logger.warn('backend did not exit in time, sent SIGKILL');\n        }\n        resolve();\n      }, 2000);\n\n      this.child!.once('exit', () => {\n        clearTimeout(killTimer);\n        resolve();\n      });\n\n      this.child!.kill('SIGTERM');\n    });\n  }\n\n  /** Restart the backend process. */\n  async restart(): Promise<void> {\n    this._state = 'restarting';\n    logger.info('restarting backend');\n    await this.stop();\n    await this.start();\n  }\n\n  /** Send a request to the backend and return the result. */\n  call(channel: string, data: unknown): Promise<unknown> {\n    if (this._state !== 'ready') {\n      return Promise.reject(new Error(`Backend not ready (state: ${this._state})`));\n    }\n\n    const id = crypto.randomUUID();\n\n    return new Promise((resolve, reject) => {\n      const timer = setTimeout(() => {\n        this.pending.delete(id);\n        reject(new Error(`Backend timeout: ${channel}`));\n      }, this.timeoutMs);\n\n      this.pending.set(id, { resolve, reject, timer });\n\n      this.child!.send({\n        type: 'request',\n        id,\n        channel,\n        data,\n      } satisfies BridgeRequest);\n\n      logger.debug(`call ${id}: ${channel}`);\n    });\n  }\n\n  // -- Private --\n\n  private waitForReady(): Promise<void> {\n    return new Promise<void>((resolve, reject) => {\n      const timer = setTimeout(() => {\n        reject(new Error('Backend failed to send ready signal within timeout'));\n      }, this.timeoutMs);\n\n      const readyHandler = (msg: unknown) => {\n        if ((msg as BridgeReady)?.type === 'ready') {\n          clearTimeout(timer);\n          this.child?.removeListener('message', readyHandler);\n          this._state = 'ready';\n          logger.info('backend ready');\n          resolve();\n        }\n      };\n\n      this.child!.on('message', readyHandler);\n    });\n  }\n\n  private onMessage(msg: unknown): void {\n    const message = msg as BridgeResponse | BridgePush | BridgeElectronApi;\n\n    if (message.type === 'response') {\n      const resp = message as BridgeResponse;\n      const entry = this.pending.get(resp.id);\n      if (entry) {\n        clearTimeout(entry.timer);\n        this.pending.delete(resp.id);\n        if (resp.error) {\n          entry.reject(new Error(resp.error.message ?? 'Backend error'));\n        } else {\n          entry.resolve(resp.result);\n        }\n      }\n    }\n\n    if (message.type === 'push') {\n      const push = message as BridgePush;\n      this.options.onPush?.(push.channel, push.data);\n    }\n\n    if (message.type === 'electron-api') {\n      this.handleElectronProxy(message as BridgeElectronApi);\n    }\n  }\n\n  private async handleElectronProxy(msg: BridgeElectronApi): Promise<void> {\n    if (!this.options.onElectronApi) return;\n\n    try {\n      const result = await this.options.onElectronApi(msg.id, msg.api, msg.args);\n      this.child?.send({\n        type: 'electron-api-response',\n        id: msg.id,\n        result,\n      });\n    } catch (err: unknown) {\n      const error = err instanceof Error ? err : new Error(String(err));\n      this.child?.send({\n        type: 'electron-api-response',\n        id: msg.id,\n        error: { message: error.message, name: error.name },\n      });\n    }\n  }\n\n  private rejectAllPending(error: Error): void {\n    for (const [, entry] of this.pending) {\n      clearTimeout(entry.timer);\n      entry.reject(error);\n    }\n    this.pending.clear();\n  }\n}\n"],"mappings":"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","names":["crypto"]}

package/dist/bridge/backend_bridge.d.cts

@@ -0,0 +1,32 @@
+interface BridgeOptions {
+    backendEntry: string;
+    timeout?: number;
+    onReady?: () => void;
+    onPush?: (channel: string, data: unknown) => void;
+    onElectronApi?: (id: string, api: string, args: unknown[]) => Promise<unknown>;
+    onExit?: (code: number | null, signal: string | null) => void;
+}
+type BridgeState = 'stopped' | 'starting' | 'ready' | 'restarting';
+declare class BackendBridge {
+    private child;
+    private pending;
+    private readonly options;
+    private readonly timeoutMs;
+    private _state;
+    constructor(options: BridgeOptions);
+    get state(): BridgeState;
+    /** Start the backend process and wait for the ready signal. */
+    start(): Promise<void>;
+    /** Stop the backend process gracefully (SIGTERM then SIGKILL). */
+    stop(): Promise<void>;
+    /** Restart the backend process. */
+    restart(): Promise<void>;
+    /** Send a request to the backend and return the result. */
+    call(channel: string, data: unknown): Promise<unknown>;
+    private waitForReady;
+    private onMessage;
+    private handleElectronProxy;
+    private rejectAllPending;
+}
+
+export { BackendBridge, type BridgeOptions };

package/dist/bridge/backend_bridge.d.ts

@@ -0,0 +1,32 @@
+interface BridgeOptions {
+    backendEntry: string;
+    timeout?: number;
+    onReady?: () => void;
+    onPush?: (channel: string, data: unknown) => void;
+    onElectronApi?: (id: string, api: string, args: unknown[]) => Promise<unknown>;
+    onExit?: (code: number | null, signal: string | null) => void;
+}
+type BridgeState = 'stopped' | 'starting' | 'ready' | 'restarting';
+declare class BackendBridge {
+    private child;
+    private pending;
+    private readonly options;
+    private readonly timeoutMs;
+    private _state;
+    constructor(options: BridgeOptions);
+    get state(): BridgeState;
+    /** Start the backend process and wait for the ready signal. */
+    start(): Promise<void>;
+    /** Stop the backend process gracefully (SIGTERM then SIGKILL). */
+    stop(): Promise<void>;
+    /** Restart the backend process. */
+    restart(): Promise<void>;
+    /** Send a request to the backend and return the result. */
+    call(channel: string, data: unknown): Promise<unknown>;
+    private waitForReady;
+    private onMessage;
+    private handleElectronProxy;
+    private rejectAllPending;
+}
+
+export { BackendBridge, type BridgeOptions };

package/dist/bridge/backend_bridge.js

@@ -0,0 +1,152 @@
+import { fork } from "child_process";
+import crypto from "crypto";
+import { getLogger } from "@noego/logger";
+const logger = getLogger("wood:bridge");
+class BackendBridge {
+  constructor(options) {
+    this.child = null;
+    this.pending = /* @__PURE__ */ new Map();
+    this._state = "stopped";
+    this.options = options;
+    this.timeoutMs = options.timeout ?? 3e4;
+  }
+  get state() {
+    return this._state;
+  }
+  /** Start the backend process and wait for the ready signal. */
+  async start() {
+    this._state = "starting";
+    this.child = fork(this.options.backendEntry, [], {
+      stdio: ["pipe", "pipe", "pipe", "ipc"]
+    });
+    this.child.on("message", (msg) => this.onMessage(msg));
+    this.child.on("exit", (code, signal) => {
+      this._state = "stopped";
+      this.rejectAllPending(new Error("Backend process exited"));
+      logger.debug(`backend exited code=${code} signal=${signal}`);
+      this.options.onExit?.(code, signal);
+    });
+    this.child.stdout?.pipe(process.stdout);
+    this.child.stderr?.pipe(process.stderr);
+    await this.waitForReady();
+    this.options.onReady?.();
+  }
+  /** Stop the backend process gracefully (SIGTERM then SIGKILL). */
+  async stop() {
+    if (!this.child || this.child.killed) return;
+    this._state = "stopped";
+    this.rejectAllPending(new Error("Backend is stopping"));
+    return new Promise((resolve) => {
+      const killTimer = setTimeout(() => {
+        if (this.child && !this.child.killed) {
+          this.child.kill("SIGKILL");
+          logger.warn("backend did not exit in time, sent SIGKILL");
+        }
+        resolve();
+      }, 2e3);
+      this.child.once("exit", () => {
+        clearTimeout(killTimer);
+        resolve();
+      });
+      this.child.kill("SIGTERM");
+    });
+  }
+  /** Restart the backend process. */
+  async restart() {
+    this._state = "restarting";
+    logger.info("restarting backend");
+    await this.stop();
+    await this.start();
+  }
+  /** Send a request to the backend and return the result. */
+  call(channel, data) {
+    if (this._state !== "ready") {
+      return Promise.reject(new Error(`Backend not ready (state: ${this._state})`));
+    }
+    const id = crypto.randomUUID();
+    return new Promise((resolve, reject) => {
+      const timer = setTimeout(() => {
+        this.pending.delete(id);
+        reject(new Error(`Backend timeout: ${channel}`));
+      }, this.timeoutMs);
+      this.pending.set(id, { resolve, reject, timer });
+      this.child.send({
+        type: "request",
+        id,
+        channel,
+        data
+      });
+      logger.debug(`call ${id}: ${channel}`);
+    });
+  }
+  // -- Private --
+  waitForReady() {
+    return new Promise((resolve, reject) => {
+      const timer = setTimeout(() => {
+        reject(new Error("Backend failed to send ready signal within timeout"));
+      }, this.timeoutMs);
+      const readyHandler = (msg) => {
+        if (msg?.type === "ready") {
+          clearTimeout(timer);
+          this.child?.removeListener("message", readyHandler);
+          this._state = "ready";
+          logger.info("backend ready");
+          resolve();
+        }
+      };
+      this.child.on("message", readyHandler);
+    });
+  }
+  onMessage(msg) {
+    const message = msg;
+    if (message.type === "response") {
+      const resp = message;
+      const entry = this.pending.get(resp.id);
+      if (entry) {
+        clearTimeout(entry.timer);
+        this.pending.delete(resp.id);
+        if (resp.error) {
+          entry.reject(new Error(resp.error.message ?? "Backend error"));
+        } else {
+          entry.resolve(resp.result);
+        }
+      }
+    }
+    if (message.type === "push") {
+      const push = message;
+      this.options.onPush?.(push.channel, push.data);
+    }
+    if (message.type === "electron-api") {
+      this.handleElectronProxy(message);
+    }
+  }
+  async handleElectronProxy(msg) {
+    if (!this.options.onElectronApi) return;
+    try {
+      const result = await this.options.onElectronApi(msg.id, msg.api, msg.args);
+      this.child?.send({
+        type: "electron-api-response",
+        id: msg.id,
+        result
+      });
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error(String(err));
+      this.child?.send({
+        type: "electron-api-response",
+        id: msg.id,
+        error: { message: error.message, name: error.name }
+      });
+    }
+  }
+  rejectAllPending(error) {
+    for (const [, entry] of this.pending) {
+      clearTimeout(entry.timer);
+      entry.reject(error);
+    }
+    this.pending.clear();
+  }
+}
+export {
+  BackendBridge
+};
+//# sourceMappingURL=backend_bridge.js.map

package/dist/bridge/backend_bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/bridge/backend_bridge.ts"],"sourcesContent":["import { fork, type ChildProcess } from 'child_process';\nimport crypto from 'crypto';\nimport { getLogger } from '@noego/logger';\nimport type {\n  BridgeRequest,\n  BridgeResponse,\n  BridgeReady,\n  BridgePush,\n  BridgeElectronApi,\n} from '../types/bridge';\n\nconst logger = getLogger('wood:bridge');\n\ninterface PendingCall {\n  resolve: (value: unknown) => void;\n  reject: (error: Error) => void;\n  timer: NodeJS.Timeout;\n}\n\nexport interface BridgeOptions {\n  backendEntry: string;\n  timeout?: number;\n  onReady?: () => void;\n  onPush?: (channel: string, data: unknown) => void;\n  onElectronApi?: (id: string, api: string, args: unknown[]) => Promise<unknown>;\n  onExit?: (code: number | null, signal: string | null) => void;\n}\n\ntype BridgeState = 'stopped' | 'starting' | 'ready' | 'restarting';\n\nexport class BackendBridge {\n  private child: ChildProcess | null = null;\n  private pending = new Map<string, PendingCall>();\n  private readonly options: BridgeOptions;\n  private readonly timeoutMs: number;\n  private _state: BridgeState = 'stopped';\n\n  constructor(options: BridgeOptions) {\n    this.options = options;\n    this.timeoutMs = options.timeout ?? 30_000;\n  }\n\n  get state(): BridgeState {\n    return this._state;\n  }\n\n  /** Start the backend process and wait for the ready signal. */\n  async start(): Promise<void> {\n    this._state = 'starting';\n\n    this.child = fork(this.options.backendEntry, [], {\n      stdio: ['pipe', 'pipe', 'pipe', 'ipc'],\n    });\n\n    this.child.on('message', (msg: unknown) => this.onMessage(msg));\n    this.child.on('exit', (code, signal) => {\n      this._state = 'stopped';\n      this.rejectAllPending(new Error('Backend process exited'));\n      logger.debug(`backend exited code=${code} signal=${signal}`);\n      this.options.onExit?.(code, signal);\n    });\n\n    this.child.stdout?.pipe(process.stdout);\n    this.child.stderr?.pipe(process.stderr);\n\n    await this.waitForReady();\n    this.options.onReady?.();\n  }\n\n  /** Stop the backend process gracefully (SIGTERM then SIGKILL). */\n  async stop(): Promise<void> {\n    if (!this.child || this.child.killed) return;\n\n    this._state = 'stopped';\n    this.rejectAllPending(new Error('Backend is stopping'));\n\n    return new Promise<void>((resolve) => {\n      const killTimer = setTimeout(() => {\n        if (this.child && !this.child.killed) {\n          this.child.kill('SIGKILL');\n          logger.warn('backend did not exit in time, sent SIGKILL');\n        }\n        resolve();\n      }, 2000);\n\n      this.child!.once('exit', () => {\n        clearTimeout(killTimer);\n        resolve();\n      });\n\n      this.child!.kill('SIGTERM');\n    });\n  }\n\n  /** Restart the backend process. */\n  async restart(): Promise<void> {\n    this._state = 'restarting';\n    logger.info('restarting backend');\n    await this.stop();\n    await this.start();\n  }\n\n  /** Send a request to the backend and return the result. */\n  call(channel: string, data: unknown): Promise<unknown> {\n    if (this._state !== 'ready') {\n      return Promise.reject(new Error(`Backend not ready (state: ${this._state})`));\n    }\n\n    const id = crypto.randomUUID();\n\n    return new Promise((resolve, reject) => {\n      const timer = setTimeout(() => {\n        this.pending.delete(id);\n        reject(new Error(`Backend timeout: ${channel}`));\n      }, this.timeoutMs);\n\n      this.pending.set(id, { resolve, reject, timer });\n\n      this.child!.send({\n        type: 'request',\n        id,\n        channel,\n        data,\n      } satisfies BridgeRequest);\n\n      logger.debug(`call ${id}: ${channel}`);\n    });\n  }\n\n  // -- Private --\n\n  private waitForReady(): Promise<void> {\n    return new Promise<void>((resolve, reject) => {\n      const timer = setTimeout(() => {\n        reject(new Error('Backend failed to send ready signal within timeout'));\n      }, this.timeoutMs);\n\n      const readyHandler = (msg: unknown) => {\n        if ((msg as BridgeReady)?.type === 'ready') {\n          clearTimeout(timer);\n          this.child?.removeListener('message', readyHandler);\n          this._state = 'ready';\n          logger.info('backend ready');\n          resolve();\n        }\n      };\n\n      this.child!.on('message', readyHandler);\n    });\n  }\n\n  private onMessage(msg: unknown): void {\n    const message = msg as BridgeResponse | BridgePush | BridgeElectronApi;\n\n    if (message.type === 'response') {\n      const resp = message as BridgeResponse;\n      const entry = this.pending.get(resp.id);\n      if (entry) {\n        clearTimeout(entry.timer);\n        this.pending.delete(resp.id);\n        if (resp.error) {\n          entry.reject(new Error(resp.error.message ?? 'Backend error'));\n        } else {\n          entry.resolve(resp.result);\n        }\n      }\n    }\n\n    if (message.type === 'push') {\n      const push = message as BridgePush;\n      this.options.onPush?.(push.channel, push.data);\n    }\n\n    if (message.type === 'electron-api') {\n      this.handleElectronProxy(message as BridgeElectronApi);\n    }\n  }\n\n  private async handleElectronProxy(msg: BridgeElectronApi): Promise<void> {\n    if (!this.options.onElectronApi) return;\n\n    try {\n      const result = await this.options.onElectronApi(msg.id, msg.api, msg.args);\n      this.child?.send({\n        type: 'electron-api-response',\n        id: msg.id,\n        result,\n      });\n    } catch (err: unknown) {\n      const error = err instanceof Error ? err : new Error(String(err));\n      this.child?.send({\n        type: 'electron-api-response',\n        id: msg.id,\n        error: { message: error.message, name: error.name },\n      });\n    }\n  }\n\n  private rejectAllPending(error: Error): void {\n    for (const [, entry] of this.pending) {\n      clearTimeout(entry.timer);\n      entry.reject(error);\n    }\n    this.pending.clear();\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/bridge/backend_entry.cjs

@@ -0,0 +1,64 @@
+"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 backend_entry_exports = {};
+__export(backend_entry_exports, {
+  pushEvent: () => pushEvent,
+  startBackendLoop: () => startBackendLoop
+});
+module.exports = __toCommonJS(backend_entry_exports);
+function startBackendLoop(handler) {
+  process.on("message", async (msg) => {
+    const message = msg;
+    if (message.type === "request") {
+      try {
+        const result = await handler.dispatch(message.channel, message.data);
+        process.send({
+          type: "response",
+          id: message.id,
+          result
+        });
+      } catch (err) {
+        const error = err instanceof Error ? err : new Error(String(err));
+        process.send({
+          type: "response",
+          id: message.id,
+          error: {
+            message: error.message,
+            name: error.name,
+            stack: error.stack
+          }
+        });
+      }
+    }
+  });
+  process.send({ type: "ready" });
+}
+function pushEvent(channel, data) {
+  process.send({
+    type: "push",
+    channel,
+    data
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  pushEvent,
+  startBackendLoop
+});
+//# sourceMappingURL=backend_entry.cjs.map

package/dist/bridge/backend_entry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/bridge/backend_entry.ts"],"sourcesContent":["import type { BridgeRequest, BridgePush, BridgeResponse, BridgeReady } from '../types/bridge.cjs';\n\nexport interface BackendHandler {\n  dispatch(channel: string, data: unknown): Promise<unknown>;\n}\n\n/**\n * Start the backend message loop.\n * Called from the backend entry point after initialization.\n */\nexport function startBackendLoop(handler: BackendHandler): void {\n  process.on('message', async (msg: unknown) => {\n    const message = msg as BridgeRequest;\n\n    if (message.type === 'request') {\n      try {\n        const result = await handler.dispatch(message.channel, message.data);\n        process.send!({\n          type: 'response',\n          id: message.id,\n          result,\n        } satisfies BridgeResponse);\n      } catch (err: unknown) {\n        const error = err instanceof Error ? err : new Error(String(err));\n        process.send!({\n          type: 'response',\n          id: message.id,\n          error: {\n            message: error.message,\n            name: error.name,\n            stack: error.stack,\n          },\n        } satisfies BridgeResponse);\n      }\n    }\n  });\n\n  // Signal ready to the shell process\n  process.send!({ type: 'ready' } satisfies BridgeReady);\n}\n\n/**\n * Push an event to the shell (forwarded to all renderers).\n */\nexport function pushEvent(channel: string, data: unknown): void {\n  process.send!({\n    type: 'push',\n    channel,\n    data,\n  } satisfies BridgePush);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAUO,SAAS,iBAAiB,SAA+B;AAC9D,UAAQ,GAAG,WAAW,OAAO,QAAiB;AAC5C,UAAM,UAAU;AAEhB,QAAI,QAAQ,SAAS,WAAW;AAC9B,UAAI;AACF,cAAM,SAAS,MAAM,QAAQ,SAAS,QAAQ,SAAS,QAAQ,IAAI;AACnE,gBAAQ,KAAM;AAAA,UACZ,MAAM;AAAA,UACN,IAAI,QAAQ;AAAA,UACZ;AAAA,QACF,CAA0B;AAAA,MAC5B,SAAS,KAAc;AACrB,cAAM,QAAQ,eAAe,QAAQ,MAAM,IAAI,MAAM,OAAO,GAAG,CAAC;AAChE,gBAAQ,KAAM;AAAA,UACZ,MAAM;AAAA,UACN,IAAI,QAAQ;AAAA,UACZ,OAAO;AAAA,YACL,SAAS,MAAM;AAAA,YACf,MAAM,MAAM;AAAA,YACZ,OAAO,MAAM;AAAA,UACf;AAAA,QACF,CAA0B;AAAA,MAC5B;AAAA,IACF;AAAA,EACF,CAAC;AAGD,UAAQ,KAAM,EAAE,MAAM,QAAQ,CAAuB;AACvD;AAKO,SAAS,UAAU,SAAiB,MAAqB;AAC9D,UAAQ,KAAM;AAAA,IACZ,MAAM;AAAA,IACN;AAAA,IACA;AAAA,EACF,CAAsB;AACxB;","names":[]}

package/dist/bridge/backend_entry.d.cts

@@ -0,0 +1,14 @@
+interface BackendHandler {
+    dispatch(channel: string, data: unknown): Promise<unknown>;
+}
+/**
+ * Start the backend message loop.
+ * Called from the backend entry point after initialization.
+ */
+declare function startBackendLoop(handler: BackendHandler): void;
+/**
+ * Push an event to the shell (forwarded to all renderers).
+ */
+declare function pushEvent(channel: string, data: unknown): void;
+
+export { type BackendHandler, pushEvent, startBackendLoop };

package/dist/bridge/backend_entry.d.ts

@@ -0,0 +1,14 @@
+interface BackendHandler {
+    dispatch(channel: string, data: unknown): Promise<unknown>;
+}
+/**
+ * Start the backend message loop.
+ * Called from the backend entry point after initialization.
+ */
+declare function startBackendLoop(handler: BackendHandler): void;
+/**
+ * Push an event to the shell (forwarded to all renderers).
+ */
+declare function pushEvent(channel: string, data: unknown): void;
+
+export { type BackendHandler, pushEvent, startBackendLoop };

package/dist/bridge/backend_entry.js

@@ -0,0 +1,39 @@
+function startBackendLoop(handler) {
+  process.on("message", async (msg) => {
+    const message = msg;
+    if (message.type === "request") {
+      try {
+        const result = await handler.dispatch(message.channel, message.data);
+        process.send({
+          type: "response",
+          id: message.id,
+          result
+        });
+      } catch (err) {
+        const error = err instanceof Error ? err : new Error(String(err));
+        process.send({
+          type: "response",
+          id: message.id,
+          error: {
+            message: error.message,
+            name: error.name,
+            stack: error.stack
+          }
+        });
+      }
+    }
+  });
+  process.send({ type: "ready" });
+}
+function pushEvent(channel, data) {
+  process.send({
+    type: "push",
+    channel,
+    data
+  });
+}
+export {
+  pushEvent,
+  startBackendLoop
+};
+//# sourceMappingURL=backend_entry.js.map

package/dist/bridge/backend_entry.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/bridge/backend_entry.ts"],"sourcesContent":["import type { BridgeRequest, BridgePush, BridgeResponse, BridgeReady } from '../types/bridge.js';\n\nexport interface BackendHandler {\n  dispatch(channel: string, data: unknown): Promise<unknown>;\n}\n\n/**\n * Start the backend message loop.\n * Called from the backend entry point after initialization.\n */\nexport function startBackendLoop(handler: BackendHandler): void {\n  process.on('message', async (msg: unknown) => {\n    const message = msg as BridgeRequest;\n\n    if (message.type === 'request') {\n      try {\n        const result = await handler.dispatch(message.channel, message.data);\n        process.send!({\n          type: 'response',\n          id: message.id,\n          result,\n        } satisfies BridgeResponse);\n      } catch (err: unknown) {\n        const error = err instanceof Error ? err : new Error(String(err));\n        process.send!({\n          type: 'response',\n          id: message.id,\n          error: {\n            message: error.message,\n            name: error.name,\n            stack: error.stack,\n          },\n        } satisfies BridgeResponse);\n      }\n    }\n  });\n\n  // Signal ready to the shell process\n  process.send!({ type: 'ready' } satisfies BridgeReady);\n}\n\n/**\n * Push an event to the shell (forwarded to all renderers).\n */\nexport function pushEvent(channel: string, data: unknown): void {\n  process.send!({\n    type: 'push',\n    channel,\n    data,\n  } satisfies BridgePush);\n}\n"],"mappings":"AAUO,SAAS,iBAAiB,SAA+B;AAC9D,UAAQ,GAAG,WAAW,OAAO,QAAiB;AAC5C,UAAM,UAAU;AAEhB,QAAI,QAAQ,SAAS,WAAW;AAC9B,UAAI;AACF,cAAM,SAAS,MAAM,QAAQ,SAAS,QAAQ,SAAS,QAAQ,IAAI;AACnE,gBAAQ,KAAM;AAAA,UACZ,MAAM;AAAA,UACN,IAAI,QAAQ;AAAA,UACZ;AAAA,QACF,CAA0B;AAAA,MAC5B,SAAS,KAAc;AACrB,cAAM,QAAQ,eAAe,QAAQ,MAAM,IAAI,MAAM,OAAO,GAAG,CAAC;AAChE,gBAAQ,KAAM;AAAA,UACZ,MAAM;AAAA,UACN,IAAI,QAAQ;AAAA,UACZ,OAAO;AAAA,YACL,SAAS,MAAM;AAAA,YACf,MAAM,MAAM;AAAA,YACZ,OAAO,MAAM;AAAA,UACf;AAAA,QACF,CAA0B;AAAA,MAC5B;AAAA,IACF;AAAA,EACF,CAAC;AAGD,UAAQ,KAAM,EAAE,MAAM,QAAQ,CAAuB;AACvD;AAKO,SAAS,UAAU,SAAiB,MAAqB;AAC9D,UAAQ,KAAM;AAAA,IACZ,MAAM;AAAA,IACN;AAAA,IACA;AAAA,EACF,CAAsB;AACxB;","names":[]}

package/dist/bridge/index.cjs

@@ -0,0 +1,34 @@
+"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 bridge_exports = {};
+__export(bridge_exports, {
+  BackendBridge: () => import_backend_bridge.BackendBridge,
+  pushEvent: () => import_backend_entry.pushEvent,
+  startBackendLoop: () => import_backend_entry.startBackendLoop
+});
+module.exports = __toCommonJS(bridge_exports);
+var import_backend_bridge = require("./backend_bridge.cjs");
+var import_backend_entry = require("./backend_entry.cjs");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BackendBridge,
+  pushEvent,
+  startBackendLoop
+});
+//# sourceMappingURL=index.cjs.map

package/dist/bridge/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/bridge/index.ts"],"sourcesContent":["export { BackendBridge, type BridgeOptions } from './backend_bridge.cjs';\nexport { startBackendLoop, pushEvent, type BackendHandler } from './backend_entry.cjs';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,4BAAkD;AAClD,2BAAiE;","names":[]}

package/dist/bridge/index.d.cts

@@ -0,0 +1,2 @@
+export { BackendBridge, BridgeOptions } from './backend_bridge.cjs';
+export { BackendHandler, pushEvent, startBackendLoop } from './backend_entry.cjs';

package/dist/bridge/index.d.ts

@@ -0,0 +1,2 @@
+export { BackendBridge, BridgeOptions } from './backend_bridge.js';
+export { BackendHandler, pushEvent, startBackendLoop } from './backend_entry.js';

package/dist/bridge/index.js

@@ -0,0 +1,8 @@
+import { BackendBridge } from "./backend_bridge.js";
+import { startBackendLoop, pushEvent } from "./backend_entry.js";
+export {
+  BackendBridge,
+  pushEvent,
+  startBackendLoop
+};
+//# sourceMappingURL=index.js.map

package/dist/bridge/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/bridge/index.ts"],"sourcesContent":["export { BackendBridge, type BridgeOptions } from './backend_bridge.js';\nexport { startBackendLoop, pushEvent, type BackendHandler } from './backend_entry.js';\n"],"mappings":"AAAA,SAAS,qBAAyC;AAClD,SAAS,kBAAkB,iBAAsC;","names":[]}