@noego/wood 0.4.10 → 0.5.0

package/dist/client/renderer_log_transport.cjs

@@ -0,0 +1,151 @@
+"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 renderer_log_transport_exports = {};
+__export(renderer_log_transport_exports, {
+  RendererLogTransport: () => RendererLogTransport,
+  clearRendererLogTransportForTests: () => clearRendererLogTransportForTests,
+  configureRendererLogTransport: () => configureRendererLogTransport,
+  flushRendererLogs: () => flushRendererLogs,
+  getRendererLogTransport: () => getRendererLogTransport
+});
+module.exports = __toCommonJS(renderer_log_transport_exports);
+var import_logger = require("@noego/logger");
+var import_stream = require("@noego/trace/stream");
+const TRANSPORT_SYMBOL = /* @__PURE__ */ Symbol.for("@noego/wood.client.renderer-log-transport");
+const DEFAULT_BUFFER = { mode: "buffered", intervalMs: 500, maxRecords: 500 };
+function randomSuffix() {
+  return Math.random().toString(36).slice(2, 10);
+}
+class RendererLogTransport {
+  constructor(config = {}) {
+    this.sequence = 0;
+    this.sender = null;
+    this.fallback = null;
+    const c = globalThis.crypto;
+    this.producerId = `renderer:${c && typeof c.randomUUID === "function" ? c.randomUUID() : randomSuffix()}`;
+    this.config = config;
+    this.pipe = this.buildPipe();
+  }
+  /** Rebuilds the pipe with new buffering config; pending records are flushed first. */
+  configure(config) {
+    this.pipe.flush();
+    void this.pipe.close();
+    this.config = config;
+    this.pipe = this.buildPipe();
+  }
+  /** Installs the batch sender (the preload bridge's __logBatch). */
+  setSender(sender) {
+    this.sender = sender;
+  }
+  /** Installs the per-record fallback used when no batch sender is available. */
+  setFallback(fallback) {
+    this.fallback = fallback;
+  }
+  /** Admits one renderer log call: stamps identity + time, enters the pipe. */
+  admit(level, logger, message, context) {
+    const record = Object.freeze({
+      id: this.nextId(),
+      occurredAtMs: Date.now(),
+      producerId: this.producerId,
+      sequence: ++this.sequence,
+      level,
+      logger,
+      message,
+      service: "renderer",
+      environment: "renderer",
+      ...context !== void 0 ? { context: sanitizeContext(context) } : {}
+    });
+    this.pipe.accept(record);
+    return record;
+  }
+  /** Drains buffered records across the boundary now. */
+  flush() {
+    this.pipe.flush();
+  }
+  buildPipe() {
+    const pipe = (0, import_logger.createLogPipe)({
+      buffer: this.config.buffer ?? DEFAULT_BUFFER,
+      flushOnLevels: this.config.flushOnLevels ?? ["error"],
+      name: "renderer-log-ipc"
+    });
+    pipe.to((records) => this.send(records));
+    return pipe;
+  }
+  send(records) {
+    if (this.sender) {
+      try {
+        this.sender((0, import_stream.createRecordBatch)(records));
+        return;
+      } catch {
+      }
+    }
+    if (this.fallback) {
+      for (const record of records) this.fallback(record);
+    }
+  }
+  nextId() {
+    const c = globalThis.crypto;
+    if (c && typeof c.randomUUID === "function") return c.randomUUID();
+    return `${this.producerId}-${this.sequence + 1}-${randomSuffix()}`;
+  }
+}
+function sanitizeContext(value) {
+  const seen = /* @__PURE__ */ new WeakSet();
+  try {
+    const json = JSON.stringify(value, (_key, val) => {
+      if (typeof val === "bigint") return val.toString();
+      if (typeof val === "object" && val !== null) {
+        if (seen.has(val)) return "[Circular]";
+        seen.add(val);
+      }
+      if (val instanceof Error) {
+        return { name: val.name, message: val.message, stack: val.stack };
+      }
+      return val;
+    });
+    return json === void 0 ? void 0 : JSON.parse(json);
+  } catch {
+    return "[Unserializable]";
+  }
+}
+function getRendererLogTransport() {
+  const globalObj = globalThis;
+  if (!globalObj[TRANSPORT_SYMBOL]) {
+    globalObj[TRANSPORT_SYMBOL] = new RendererLogTransport();
+  }
+  return globalObj[TRANSPORT_SYMBOL];
+}
+function configureRendererLogTransport(config) {
+  getRendererLogTransport().configure(config);
+}
+function flushRendererLogs() {
+  getRendererLogTransport().flush();
+}
+function clearRendererLogTransportForTests() {
+  delete globalThis[TRANSPORT_SYMBOL];
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  RendererLogTransport,
+  clearRendererLogTransportForTests,
+  configureRendererLogTransport,
+  flushRendererLogs,
+  getRendererLogTransport
+});
+//# sourceMappingURL=renderer_log_transport.cjs.map

package/dist/client/renderer_log_transport.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/client/renderer_log_transport.ts"],"sourcesContent":["import { createLogPipe, type LogPipe, type LogPipeBuffer, type LogRecord } from '@noego/logger';\nimport { createRecordBatch } from '@noego/trace/stream';\n\nconst TRANSPORT_SYMBOL = Symbol.for('@noego/wood.client.renderer-log-transport');\n\n/**\n * Per-pipe buffering configuration for renderer logs crossing the IPC\n * boundary. Batching is a property of the pipe, not of the record: records\n * are admitted (identity + occurredAtMs stamped) the moment they are logged,\n * and buffering only affects when they travel.\n */\nexport interface RendererLogTransportConfig {\n  buffer?: LogPipeBuffer;\n  /** Levels that flush the pipe immediately (default ['error']). */\n  flushOnLevels?: readonly string[];\n}\n\nexport type RendererLogBatchSender = (batch: unknown) => void;\n\ntype FallbackWriter = (record: LogRecord) => void;\n\nconst DEFAULT_BUFFER: LogPipeBuffer = { mode: 'buffered', intervalMs: 500, maxRecords: 500 };\n\nfunction randomSuffix(): string {\n  return Math.random().toString(36).slice(2, 10);\n}\n\n/**\n * The renderer's admission point and IPC-facing pipe.\n *\n * Admission happens here, in the renderer, at creation time: each record gets\n * this window's producerId, a strictly increasing sequence, and occurredAtMs\n * stamped when the log call ran. Everything downstream — the pipe's buffer,\n * the batch envelope, the main-process receiver, the database — transports\n * the frozen record unchanged.\n */\nexport class RendererLogTransport {\n  private readonly producerId: string;\n  private sequence = 0;\n  private pipe: LogPipe;\n  private sender: RendererLogBatchSender | null = null;\n  private fallback: FallbackWriter | null = null;\n  private config: RendererLogTransportConfig;\n\n  constructor(config: RendererLogTransportConfig = {}) {\n    const c = globalThis.crypto;\n    this.producerId = `renderer:${c && typeof c.randomUUID === 'function' ? c.randomUUID() : randomSuffix()}`;\n    this.config = config;\n    this.pipe = this.buildPipe();\n  }\n\n  /** Rebuilds the pipe with new buffering config; pending records are flushed first. */\n  configure(config: RendererLogTransportConfig): void {\n    this.pipe.flush();\n    void this.pipe.close();\n    this.config = config;\n    this.pipe = this.buildPipe();\n  }\n\n  /** Installs the batch sender (the preload bridge's __logBatch). */\n  setSender(sender: RendererLogBatchSender | null): void {\n    this.sender = sender;\n  }\n\n  /** Installs the per-record fallback used when no batch sender is available. */\n  setFallback(fallback: FallbackWriter | null): void {\n    this.fallback = fallback;\n  }\n\n  /** Admits one renderer log call: stamps identity + time, enters the pipe. */\n  admit(level: string, logger: string, message: string, context?: unknown): LogRecord {\n    const record = Object.freeze({\n      id: this.nextId(),\n      occurredAtMs: Date.now(),\n      producerId: this.producerId,\n      sequence: ++this.sequence,\n      level,\n      logger,\n      message,\n      service: 'renderer',\n      environment: 'renderer',\n      ...(context !== undefined ? { context: sanitizeContext(context) } : {}),\n    });\n    this.pipe.accept(record);\n    return record;\n  }\n\n  /** Drains buffered records across the boundary now. */\n  flush(): void {\n    this.pipe.flush();\n  }\n\n  private buildPipe(): LogPipe {\n    const pipe = createLogPipe({\n      buffer: this.config.buffer ?? DEFAULT_BUFFER,\n      flushOnLevels: this.config.flushOnLevels ?? ['error'],\n      name: 'renderer-log-ipc',\n    });\n    pipe.to((records) => this.send(records));\n    return pipe;\n  }\n\n  private send(records: readonly LogRecord[]): void {\n    if (this.sender) {\n      try {\n        this.sender(createRecordBatch(records));\n        return;\n      } catch {\n        // Fall through to per-record fallback below.\n      }\n    }\n    if (this.fallback) {\n      for (const record of records) this.fallback(record);\n    }\n  }\n\n  private nextId(): string {\n    const c = globalThis.crypto;\n    if (c && typeof c.randomUUID === 'function') return c.randomUUID();\n    return `${this.producerId}-${this.sequence + 1}-${randomSuffix()}`;\n  }\n}\n\n/**\n * Context crossing IPC must survive structured clone: snapshot through JSON\n * with circular/bigint/Error handling. The original object stays untouched.\n */\nfunction sanitizeContext(value: unknown): unknown {\n  const seen = new WeakSet<object>();\n  try {\n    const json = JSON.stringify(value, (_key, val: unknown) => {\n      if (typeof val === 'bigint') return val.toString();\n      if (typeof val === 'object' && val !== null) {\n        if (seen.has(val)) return '[Circular]';\n        seen.add(val);\n      }\n      if (val instanceof Error) {\n        return { name: val.name, message: val.message, stack: val.stack };\n      }\n      return val;\n    });\n    return json === undefined ? undefined : JSON.parse(json);\n  } catch {\n    return '[Unserializable]';\n  }\n}\n\ntype GlobalWithTransport = typeof globalThis & {\n  [TRANSPORT_SYMBOL]?: RendererLogTransport;\n};\n\nexport function getRendererLogTransport(): RendererLogTransport {\n  const globalObj = globalThis as GlobalWithTransport;\n  if (!globalObj[TRANSPORT_SYMBOL]) {\n    globalObj[TRANSPORT_SYMBOL] = new RendererLogTransport();\n  }\n  return globalObj[TRANSPORT_SYMBOL];\n}\n\n/** Reconfigures the renderer→main log pipe (buffer interval, flush levels). */\nexport function configureRendererLogTransport(config: RendererLogTransportConfig): void {\n  getRendererLogTransport().configure(config);\n}\n\n/** Flushes all buffered renderer logs across the IPC boundary now. */\nexport function flushRendererLogs(): void {\n  getRendererLogTransport().flush();\n}\n\nexport function clearRendererLogTransportForTests(): void {\n  delete (globalThis as GlobalWithTransport)[TRANSPORT_SYMBOL];\n}\n"],"mappings":"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","names":[]}

package/dist/client/renderer_log_transport.d.cts

@@ -0,0 +1,54 @@
+import { LogPipeBuffer, LogRecord } from '@noego/logger';
+
+/**
+ * Per-pipe buffering configuration for renderer logs crossing the IPC
+ * boundary. Batching is a property of the pipe, not of the record: records
+ * are admitted (identity + occurredAtMs stamped) the moment they are logged,
+ * and buffering only affects when they travel.
+ */
+interface RendererLogTransportConfig {
+    buffer?: LogPipeBuffer;
+    /** Levels that flush the pipe immediately (default ['error']). */
+    flushOnLevels?: readonly string[];
+}
+type RendererLogBatchSender = (batch: unknown) => void;
+type FallbackWriter = (record: LogRecord) => void;
+/**
+ * The renderer's admission point and IPC-facing pipe.
+ *
+ * Admission happens here, in the renderer, at creation time: each record gets
+ * this window's producerId, a strictly increasing sequence, and occurredAtMs
+ * stamped when the log call ran. Everything downstream — the pipe's buffer,
+ * the batch envelope, the main-process receiver, the database — transports
+ * the frozen record unchanged.
+ */
+declare class RendererLogTransport {
+    private readonly producerId;
+    private sequence;
+    private pipe;
+    private sender;
+    private fallback;
+    private config;
+    constructor(config?: RendererLogTransportConfig);
+    /** Rebuilds the pipe with new buffering config; pending records are flushed first. */
+    configure(config: RendererLogTransportConfig): void;
+    /** Installs the batch sender (the preload bridge's __logBatch). */
+    setSender(sender: RendererLogBatchSender | null): void;
+    /** Installs the per-record fallback used when no batch sender is available. */
+    setFallback(fallback: FallbackWriter | null): void;
+    /** Admits one renderer log call: stamps identity + time, enters the pipe. */
+    admit(level: string, logger: string, message: string, context?: unknown): LogRecord;
+    /** Drains buffered records across the boundary now. */
+    flush(): void;
+    private buildPipe;
+    private send;
+    private nextId;
+}
+declare function getRendererLogTransport(): RendererLogTransport;
+/** Reconfigures the renderer→main log pipe (buffer interval, flush levels). */
+declare function configureRendererLogTransport(config: RendererLogTransportConfig): void;
+/** Flushes all buffered renderer logs across the IPC boundary now. */
+declare function flushRendererLogs(): void;
+declare function clearRendererLogTransportForTests(): void;
+
+export { type RendererLogBatchSender, RendererLogTransport, type RendererLogTransportConfig, clearRendererLogTransportForTests, configureRendererLogTransport, flushRendererLogs, getRendererLogTransport };

package/dist/client/renderer_log_transport.d.ts

@@ -0,0 +1,54 @@
+import { LogPipeBuffer, LogRecord } from '@noego/logger';
+
+/**
+ * Per-pipe buffering configuration for renderer logs crossing the IPC
+ * boundary. Batching is a property of the pipe, not of the record: records
+ * are admitted (identity + occurredAtMs stamped) the moment they are logged,
+ * and buffering only affects when they travel.
+ */
+interface RendererLogTransportConfig {
+    buffer?: LogPipeBuffer;
+    /** Levels that flush the pipe immediately (default ['error']). */
+    flushOnLevels?: readonly string[];
+}
+type RendererLogBatchSender = (batch: unknown) => void;
+type FallbackWriter = (record: LogRecord) => void;
+/**
+ * The renderer's admission point and IPC-facing pipe.
+ *
+ * Admission happens here, in the renderer, at creation time: each record gets
+ * this window's producerId, a strictly increasing sequence, and occurredAtMs
+ * stamped when the log call ran. Everything downstream — the pipe's buffer,
+ * the batch envelope, the main-process receiver, the database — transports
+ * the frozen record unchanged.
+ */
+declare class RendererLogTransport {
+    private readonly producerId;
+    private sequence;
+    private pipe;
+    private sender;
+    private fallback;
+    private config;
+    constructor(config?: RendererLogTransportConfig);
+    /** Rebuilds the pipe with new buffering config; pending records are flushed first. */
+    configure(config: RendererLogTransportConfig): void;
+    /** Installs the batch sender (the preload bridge's __logBatch). */
+    setSender(sender: RendererLogBatchSender | null): void;
+    /** Installs the per-record fallback used when no batch sender is available. */
+    setFallback(fallback: FallbackWriter | null): void;
+    /** Admits one renderer log call: stamps identity + time, enters the pipe. */
+    admit(level: string, logger: string, message: string, context?: unknown): LogRecord;
+    /** Drains buffered records across the boundary now. */
+    flush(): void;
+    private buildPipe;
+    private send;
+    private nextId;
+}
+declare function getRendererLogTransport(): RendererLogTransport;
+/** Reconfigures the renderer→main log pipe (buffer interval, flush levels). */
+declare function configureRendererLogTransport(config: RendererLogTransportConfig): void;
+/** Flushes all buffered renderer logs across the IPC boundary now. */
+declare function flushRendererLogs(): void;
+declare function clearRendererLogTransportForTests(): void;
+
+export { type RendererLogBatchSender, RendererLogTransport, type RendererLogTransportConfig, clearRendererLogTransportForTests, configureRendererLogTransport, flushRendererLogs, getRendererLogTransport };

package/dist/client/renderer_log_transport.js

@@ -0,0 +1,123 @@
+import { createLogPipe } from "@noego/logger";
+import { createRecordBatch } from "@noego/trace/stream";
+const TRANSPORT_SYMBOL = /* @__PURE__ */ Symbol.for("@noego/wood.client.renderer-log-transport");
+const DEFAULT_BUFFER = { mode: "buffered", intervalMs: 500, maxRecords: 500 };
+function randomSuffix() {
+  return Math.random().toString(36).slice(2, 10);
+}
+class RendererLogTransport {
+  constructor(config = {}) {
+    this.sequence = 0;
+    this.sender = null;
+    this.fallback = null;
+    const c = globalThis.crypto;
+    this.producerId = `renderer:${c && typeof c.randomUUID === "function" ? c.randomUUID() : randomSuffix()}`;
+    this.config = config;
+    this.pipe = this.buildPipe();
+  }
+  /** Rebuilds the pipe with new buffering config; pending records are flushed first. */
+  configure(config) {
+    this.pipe.flush();
+    void this.pipe.close();
+    this.config = config;
+    this.pipe = this.buildPipe();
+  }
+  /** Installs the batch sender (the preload bridge's __logBatch). */
+  setSender(sender) {
+    this.sender = sender;
+  }
+  /** Installs the per-record fallback used when no batch sender is available. */
+  setFallback(fallback) {
+    this.fallback = fallback;
+  }
+  /** Admits one renderer log call: stamps identity + time, enters the pipe. */
+  admit(level, logger, message, context) {
+    const record = Object.freeze({
+      id: this.nextId(),
+      occurredAtMs: Date.now(),
+      producerId: this.producerId,
+      sequence: ++this.sequence,
+      level,
+      logger,
+      message,
+      service: "renderer",
+      environment: "renderer",
+      ...context !== void 0 ? { context: sanitizeContext(context) } : {}
+    });
+    this.pipe.accept(record);
+    return record;
+  }
+  /** Drains buffered records across the boundary now. */
+  flush() {
+    this.pipe.flush();
+  }
+  buildPipe() {
+    const pipe = createLogPipe({
+      buffer: this.config.buffer ?? DEFAULT_BUFFER,
+      flushOnLevels: this.config.flushOnLevels ?? ["error"],
+      name: "renderer-log-ipc"
+    });
+    pipe.to((records) => this.send(records));
+    return pipe;
+  }
+  send(records) {
+    if (this.sender) {
+      try {
+        this.sender(createRecordBatch(records));
+        return;
+      } catch {
+      }
+    }
+    if (this.fallback) {
+      for (const record of records) this.fallback(record);
+    }
+  }
+  nextId() {
+    const c = globalThis.crypto;
+    if (c && typeof c.randomUUID === "function") return c.randomUUID();
+    return `${this.producerId}-${this.sequence + 1}-${randomSuffix()}`;
+  }
+}
+function sanitizeContext(value) {
+  const seen = /* @__PURE__ */ new WeakSet();
+  try {
+    const json = JSON.stringify(value, (_key, val) => {
+      if (typeof val === "bigint") return val.toString();
+      if (typeof val === "object" && val !== null) {
+        if (seen.has(val)) return "[Circular]";
+        seen.add(val);
+      }
+      if (val instanceof Error) {
+        return { name: val.name, message: val.message, stack: val.stack };
+      }
+      return val;
+    });
+    return json === void 0 ? void 0 : JSON.parse(json);
+  } catch {
+    return "[Unserializable]";
+  }
+}
+function getRendererLogTransport() {
+  const globalObj = globalThis;
+  if (!globalObj[TRANSPORT_SYMBOL]) {
+    globalObj[TRANSPORT_SYMBOL] = new RendererLogTransport();
+  }
+  return globalObj[TRANSPORT_SYMBOL];
+}
+function configureRendererLogTransport(config) {
+  getRendererLogTransport().configure(config);
+}
+function flushRendererLogs() {
+  getRendererLogTransport().flush();
+}
+function clearRendererLogTransportForTests() {
+  delete globalThis[TRANSPORT_SYMBOL];
+}
+export {
+  RendererLogTransport,
+  clearRendererLogTransportForTests,
+  configureRendererLogTransport,
+  flushRendererLogs,
+  getRendererLogTransport
+};
+//# sourceMappingURL=renderer_log_transport.js.map

package/dist/client/renderer_log_transport.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/client/renderer_log_transport.ts"],"sourcesContent":["import { createLogPipe, type LogPipe, type LogPipeBuffer, type LogRecord } from '@noego/logger';\nimport { createRecordBatch } from '@noego/trace/stream';\n\nconst TRANSPORT_SYMBOL = Symbol.for('@noego/wood.client.renderer-log-transport');\n\n/**\n * Per-pipe buffering configuration for renderer logs crossing the IPC\n * boundary. Batching is a property of the pipe, not of the record: records\n * are admitted (identity + occurredAtMs stamped) the moment they are logged,\n * and buffering only affects when they travel.\n */\nexport interface RendererLogTransportConfig {\n  buffer?: LogPipeBuffer;\n  /** Levels that flush the pipe immediately (default ['error']). */\n  flushOnLevels?: readonly string[];\n}\n\nexport type RendererLogBatchSender = (batch: unknown) => void;\n\ntype FallbackWriter = (record: LogRecord) => void;\n\nconst DEFAULT_BUFFER: LogPipeBuffer = { mode: 'buffered', intervalMs: 500, maxRecords: 500 };\n\nfunction randomSuffix(): string {\n  return Math.random().toString(36).slice(2, 10);\n}\n\n/**\n * The renderer's admission point and IPC-facing pipe.\n *\n * Admission happens here, in the renderer, at creation time: each record gets\n * this window's producerId, a strictly increasing sequence, and occurredAtMs\n * stamped when the log call ran. Everything downstream — the pipe's buffer,\n * the batch envelope, the main-process receiver, the database — transports\n * the frozen record unchanged.\n */\nexport class RendererLogTransport {\n  private readonly producerId: string;\n  private sequence = 0;\n  private pipe: LogPipe;\n  private sender: RendererLogBatchSender | null = null;\n  private fallback: FallbackWriter | null = null;\n  private config: RendererLogTransportConfig;\n\n  constructor(config: RendererLogTransportConfig = {}) {\n    const c = globalThis.crypto;\n    this.producerId = `renderer:${c && typeof c.randomUUID === 'function' ? c.randomUUID() : randomSuffix()}`;\n    this.config = config;\n    this.pipe = this.buildPipe();\n  }\n\n  /** Rebuilds the pipe with new buffering config; pending records are flushed first. */\n  configure(config: RendererLogTransportConfig): void {\n    this.pipe.flush();\n    void this.pipe.close();\n    this.config = config;\n    this.pipe = this.buildPipe();\n  }\n\n  /** Installs the batch sender (the preload bridge's __logBatch). */\n  setSender(sender: RendererLogBatchSender | null): void {\n    this.sender = sender;\n  }\n\n  /** Installs the per-record fallback used when no batch sender is available. */\n  setFallback(fallback: FallbackWriter | null): void {\n    this.fallback = fallback;\n  }\n\n  /** Admits one renderer log call: stamps identity + time, enters the pipe. */\n  admit(level: string, logger: string, message: string, context?: unknown): LogRecord {\n    const record = Object.freeze({\n      id: this.nextId(),\n      occurredAtMs: Date.now(),\n      producerId: this.producerId,\n      sequence: ++this.sequence,\n      level,\n      logger,\n      message,\n      service: 'renderer',\n      environment: 'renderer',\n      ...(context !== undefined ? { context: sanitizeContext(context) } : {}),\n    });\n    this.pipe.accept(record);\n    return record;\n  }\n\n  /** Drains buffered records across the boundary now. */\n  flush(): void {\n    this.pipe.flush();\n  }\n\n  private buildPipe(): LogPipe {\n    const pipe = createLogPipe({\n      buffer: this.config.buffer ?? DEFAULT_BUFFER,\n      flushOnLevels: this.config.flushOnLevels ?? ['error'],\n      name: 'renderer-log-ipc',\n    });\n    pipe.to((records) => this.send(records));\n    return pipe;\n  }\n\n  private send(records: readonly LogRecord[]): void {\n    if (this.sender) {\n      try {\n        this.sender(createRecordBatch(records));\n        return;\n      } catch {\n        // Fall through to per-record fallback below.\n      }\n    }\n    if (this.fallback) {\n      for (const record of records) this.fallback(record);\n    }\n  }\n\n  private nextId(): string {\n    const c = globalThis.crypto;\n    if (c && typeof c.randomUUID === 'function') return c.randomUUID();\n    return `${this.producerId}-${this.sequence + 1}-${randomSuffix()}`;\n  }\n}\n\n/**\n * Context crossing IPC must survive structured clone: snapshot through JSON\n * with circular/bigint/Error handling. The original object stays untouched.\n */\nfunction sanitizeContext(value: unknown): unknown {\n  const seen = new WeakSet<object>();\n  try {\n    const json = JSON.stringify(value, (_key, val: unknown) => {\n      if (typeof val === 'bigint') return val.toString();\n      if (typeof val === 'object' && val !== null) {\n        if (seen.has(val)) return '[Circular]';\n        seen.add(val);\n      }\n      if (val instanceof Error) {\n        return { name: val.name, message: val.message, stack: val.stack };\n      }\n      return val;\n    });\n    return json === undefined ? undefined : JSON.parse(json);\n  } catch {\n    return '[Unserializable]';\n  }\n}\n\ntype GlobalWithTransport = typeof globalThis & {\n  [TRANSPORT_SYMBOL]?: RendererLogTransport;\n};\n\nexport function getRendererLogTransport(): RendererLogTransport {\n  const globalObj = globalThis as GlobalWithTransport;\n  if (!globalObj[TRANSPORT_SYMBOL]) {\n    globalObj[TRANSPORT_SYMBOL] = new RendererLogTransport();\n  }\n  return globalObj[TRANSPORT_SYMBOL];\n}\n\n/** Reconfigures the renderer→main log pipe (buffer interval, flush levels). */\nexport function configureRendererLogTransport(config: RendererLogTransportConfig): void {\n  getRendererLogTransport().configure(config);\n}\n\n/** Flushes all buffered renderer logs across the IPC boundary now. */\nexport function flushRendererLogs(): void {\n  getRendererLogTransport().flush();\n}\n\nexport function clearRendererLogTransportForTests(): void {\n  delete (globalThis as GlobalWithTransport)[TRANSPORT_SYMBOL];\n}\n"],"mappings":"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","names":[]}

package/dist/codegen/controller_registration_generator.cjs

@@ -28,7 +28,9 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var controller_registration_generator_exports = {};
 __export(controller_registration_generator_exports, {
-  generateControllerRegistration: () => generateControllerRegistration
+  controllerFileCandidates: () => controllerFileCandidates,
+  generateControllerRegistration: () => generateControllerRegistration,
+  resolveControllerFile: () => resolveControllerFile
 });
 module.exports = __toCommonJS(controller_registration_generator_exports);
 var import_fs = require("fs");
@@ -48,6 +50,13 @@ const INDEX_CANDIDATES = [
   "index.ts",
   "index.js"
 ];
+function controllerFileCandidates(controllerName, controllersDir) {
+  const basePath = import_path.default.resolve(controllersDir, controllerName);
+  return [
+    ...CANDIDATE_SUFFIXES.map((suffix) => basePath + suffix),
+    ...INDEX_CANDIDATES.map((indexFile) => import_path.default.resolve(controllersDir, controllerName, indexFile))
+  ];
+}
 function resolveControllerFile(controllerName, controllersDir) {
   const basePath = import_path.default.resolve(controllersDir, controllerName);
   for (const suffix of CANDIDATE_SUFFIXES) {
@@ -138,6 +147,8 @@ Ensure each controller file exists with one of these suffixes: .ts, .controller.
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  generateControllerRegistration
+  controllerFileCandidates,
+  generateControllerRegistration,
+  resolveControllerFile
 });
 //# sourceMappingURL=controller_registration_generator.cjs.map

package/dist/codegen/controller_registration_generator.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/codegen/controller_registration_generator.ts"],"sourcesContent":["import { existsSync } from 'fs';\nimport path from 'path';\nimport type { OperationDef } from '../types/index.cjs';\nimport { generatedFileNotice } from './generated_file_notice.cjs';\n\nconst CONTROLLER_REGISTRATION_SOURCE_INSTRUCTIONS = [\n  'To change controller registration, edit the operations YAML configured by',\n  'wood.config.yml main.openapi and the matching controller files.',\n] as const;\n\n/**\n * Candidate file extensions to search when resolving a controller name to a file.\n * Matches the order used by ControllerResolver.resolveClass().\n */\nconst CANDIDATE_SUFFIXES = [\n  '.ts',\n  '.controller.ts',\n  '.js',\n  '.controller.js',\n] as const;\n\nconst INDEX_CANDIDATES = [\n  'index.ts',\n  'index.js',\n] as const;\n\n/**\n * Resolve a controller name to a file path on disk.\n * Returns the first candidate that exists, or undefined if none match.\n */\nfunction resolveControllerFile(controllerName: string, controllersDir: string): string | undefined {\n  const basePath = path.resolve(controllersDir, controllerName);\n\n  for (const suffix of CANDIDATE_SUFFIXES) {\n    const candidate = basePath + suffix;\n    if (existsSync(candidate)) return candidate;\n  }\n\n  for (const indexFile of INDEX_CANDIDATES) {\n    const candidate = path.resolve(controllersDir, controllerName, indexFile);\n    if (existsSync(candidate)) return candidate;\n  }\n\n  return undefined;\n}\n\n/**\n * Compute a relative import path from the generated file's directory to the\n * resolved controller file. Strips `.ts` extensions since TypeScript imports\n * should not include them.\n */\nfunction computeImportPath(fromDir: string, toFile: string): string {\n  let rel = path.relative(fromDir, toFile);\n\n  // Ensure the path starts with ./ or ../\n  if (!rel.startsWith('.')) {\n    rel = './' + rel;\n  }\n\n  // Strip .ts extension (TypeScript convention)\n  if (rel.endsWith('.ts')) {\n    rel = rel.slice(0, -3);\n  }\n\n  // Normalize path separators to forward slashes (Windows compat)\n  return rel.replace(/\\\\/g, '/');\n}\n\n/**\n * Convert a controller name to a valid PascalCase identifier for the import.\n * e.g. \"chat\" -> \"ChatController\", \"multi_agent\" -> \"MultiAgentController\"\n */\nfunction toControllerClassName(controllerName: string): string {\n  const pascal = controllerName\n    .split(/[_\\-.]/)\n    .map((segment) => segment.charAt(0).toUpperCase() + segment.slice(1))\n    .join('');\n\n  return pascal + 'Controller';\n}\n\n/**\n * Extract all unique controller names from a set of parsed operations.\n */\nfunction extractControllerNames(operations: Map<string, OperationDef>): string[] {\n  const names = new Set<string>();\n\n  operations.forEach((op) => {\n    names.add(op.controller);\n  });\n\n  return Array.from(names).sort();\n}\n\nexport interface ControllerRegistrationOptions {\n  /** Directory where controller source files live */\n  controllersDir: string;\n  /** Directory where the generated file will be written */\n  outDir: string;\n  /** If true, unresolved controllers emit a warning comment instead of throwing. Default: false. */\n  allowUnresolved?: boolean;\n}\n\n/**\n * Generate a TypeScript registration file that statically imports every\n * controller referenced in operations and exports a function to register\n * them with a WoodRouter.\n */\nexport function generateControllerRegistration(\n  operations: Map<string, OperationDef>,\n  options: ControllerRegistrationOptions,\n): string {\n  const controllerNames = extractControllerNames(operations);\n  const outDirResolved = path.resolve(options.outDir);\n\n  const imports: string[] = [];\n  const registrations: string[] = [];\n  const unresolved: string[] = [];\n\n  for (const name of controllerNames) {\n    const filePath = resolveControllerFile(name, options.controllersDir);\n\n    if (!filePath) {\n      unresolved.push(name);\n      continue;\n    }\n\n    const importPath = computeImportPath(outDirResolved, filePath);\n    const className = toControllerClassName(name);\n\n    imports.push(`import ${className} from '${importPath}';`);\n    registrations.push(`  router.registerController('${name}', ${className});`);\n  }\n\n  // Fail by default when controllers cannot be resolved\n  if (unresolved.length > 0 && !options.allowUnresolved) {\n    throw new Error(\n      `Controller registration codegen failed: ${unresolved.length} controller(s) not found on disk:\\n` +\n      unresolved.map(name => `  - \"${name}\" (searched in ${options.controllersDir})`).join('\\n') +\n      `\\n\\nEnsure each controller file exists with one of these suffixes: .ts, .controller.ts, .js, .controller.js`\n    );\n  }\n\n  const lines: string[] = [\n    generatedFileNotice(CONTROLLER_REGISTRATION_SOURCE_INSTRUCTIONS),\n    '//',\n    '// Static imports ensure all controllers are bundled and available at startup.',\n    '// registerController() puts each class directly in the router\\'s cache.',\n  ];\n\n  if (unresolved.length > 0) {\n    lines.push(\n      '',\n      '// WARNING: The following controllers could not be resolved on disk:',\n      ...unresolved.map((name) => `//   - ${name}`),\n    );\n  }\n\n  // Static imports\n  lines.push('');\n  for (const imp of imports) {\n    lines.push(imp);\n  }\n\n  // Registration function\n  lines.push(\n    '',\n    'export function registerControllers(router: { registerController(name: string, cls: any): void }) {',\n  );\n  for (const reg of registrations) {\n    lines.push(reg);\n  }\n  lines.push(\n    '}',\n    '',\n  );\n\n  return lines.join('\\n');\n}\n"],"mappings":"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","names":["path"]}
+{"version":3,"sources":["../../src/codegen/controller_registration_generator.ts"],"sourcesContent":["import { existsSync } from 'fs';\nimport path from 'path';\nimport type { OperationDef } from '../types/index.cjs';\nimport { generatedFileNotice } from './generated_file_notice.cjs';\n\nconst CONTROLLER_REGISTRATION_SOURCE_INSTRUCTIONS = [\n  'To change controller registration, edit the operations YAML configured by',\n  'wood.config.yml main.openapi and the matching controller files.',\n] as const;\n\n/**\n * Candidate file extensions to search when resolving a controller name to a file.\n * Matches the order used by ControllerResolver.resolveClass().\n */\nconst CANDIDATE_SUFFIXES = [\n  '.ts',\n  '.controller.ts',\n  '.js',\n  '.controller.js',\n] as const;\n\nconst INDEX_CANDIDATES = [\n  'index.ts',\n  'index.js',\n] as const;\n\n/**\n * Every file a controller identity may live at, in resolution order —\n * shared by codegen and by test-time auto-binding so both agree on where an\n * identity resolves and on what to report when it does not.\n */\nexport function controllerFileCandidates(controllerName: string, controllersDir: string): string[] {\n  const basePath = path.resolve(controllersDir, controllerName);\n  return [\n    ...CANDIDATE_SUFFIXES.map((suffix) => basePath + suffix),\n    ...INDEX_CANDIDATES.map((indexFile) => path.resolve(controllersDir, controllerName, indexFile)),\n  ];\n}\n\n/**\n * Resolve a controller name to a file path on disk.\n * Returns the first candidate that exists, or undefined if none match.\n */\nexport function resolveControllerFile(controllerName: string, controllersDir: string): string | undefined {\n  const basePath = path.resolve(controllersDir, controllerName);\n\n  for (const suffix of CANDIDATE_SUFFIXES) {\n    const candidate = basePath + suffix;\n    if (existsSync(candidate)) return candidate;\n  }\n\n  for (const indexFile of INDEX_CANDIDATES) {\n    const candidate = path.resolve(controllersDir, controllerName, indexFile);\n    if (existsSync(candidate)) return candidate;\n  }\n\n  return undefined;\n}\n\n/**\n * Compute a relative import path from the generated file's directory to the\n * resolved controller file. Strips `.ts` extensions since TypeScript imports\n * should not include them.\n */\nfunction computeImportPath(fromDir: string, toFile: string): string {\n  let rel = path.relative(fromDir, toFile);\n\n  // Ensure the path starts with ./ or ../\n  if (!rel.startsWith('.')) {\n    rel = './' + rel;\n  }\n\n  // Strip .ts extension (TypeScript convention)\n  if (rel.endsWith('.ts')) {\n    rel = rel.slice(0, -3);\n  }\n\n  // Normalize path separators to forward slashes (Windows compat)\n  return rel.replace(/\\\\/g, '/');\n}\n\n/**\n * Convert a controller name to a valid PascalCase identifier for the import.\n * e.g. \"chat\" -> \"ChatController\", \"multi_agent\" -> \"MultiAgentController\"\n */\nfunction toControllerClassName(controllerName: string): string {\n  const pascal = controllerName\n    .split(/[_\\-.]/)\n    .map((segment) => segment.charAt(0).toUpperCase() + segment.slice(1))\n    .join('');\n\n  return pascal + 'Controller';\n}\n\n/**\n * Extract all unique controller names from a set of parsed operations.\n */\nfunction extractControllerNames(operations: Map<string, OperationDef>): string[] {\n  const names = new Set<string>();\n\n  operations.forEach((op) => {\n    names.add(op.controller);\n  });\n\n  return Array.from(names).sort();\n}\n\nexport interface ControllerRegistrationOptions {\n  /** Directory where controller source files live */\n  controllersDir: string;\n  /** Directory where the generated file will be written */\n  outDir: string;\n  /** If true, unresolved controllers emit a warning comment instead of throwing. Default: false. */\n  allowUnresolved?: boolean;\n}\n\n/**\n * Generate a TypeScript registration file that statically imports every\n * controller referenced in operations and exports a function to register\n * them with a WoodRouter.\n */\nexport function generateControllerRegistration(\n  operations: Map<string, OperationDef>,\n  options: ControllerRegistrationOptions,\n): string {\n  const controllerNames = extractControllerNames(operations);\n  const outDirResolved = path.resolve(options.outDir);\n\n  const imports: string[] = [];\n  const registrations: string[] = [];\n  const unresolved: string[] = [];\n\n  for (const name of controllerNames) {\n    const filePath = resolveControllerFile(name, options.controllersDir);\n\n    if (!filePath) {\n      unresolved.push(name);\n      continue;\n    }\n\n    const importPath = computeImportPath(outDirResolved, filePath);\n    const className = toControllerClassName(name);\n\n    imports.push(`import ${className} from '${importPath}';`);\n    registrations.push(`  router.registerController('${name}', ${className});`);\n  }\n\n  // Fail by default when controllers cannot be resolved\n  if (unresolved.length > 0 && !options.allowUnresolved) {\n    throw new Error(\n      `Controller registration codegen failed: ${unresolved.length} controller(s) not found on disk:\\n` +\n      unresolved.map(name => `  - \"${name}\" (searched in ${options.controllersDir})`).join('\\n') +\n      `\\n\\nEnsure each controller file exists with one of these suffixes: .ts, .controller.ts, .js, .controller.js`\n    );\n  }\n\n  const lines: string[] = [\n    generatedFileNotice(CONTROLLER_REGISTRATION_SOURCE_INSTRUCTIONS),\n    '//',\n    '// Static imports ensure all controllers are bundled and available at startup.',\n    '// registerController() puts each class directly in the router\\'s cache.',\n  ];\n\n  if (unresolved.length > 0) {\n    lines.push(\n      '',\n      '// WARNING: The following controllers could not be resolved on disk:',\n      ...unresolved.map((name) => `//   - ${name}`),\n    );\n  }\n\n  // Static imports\n  lines.push('');\n  for (const imp of imports) {\n    lines.push(imp);\n  }\n\n  // Registration function\n  lines.push(\n    '',\n    'export function registerControllers(router: { registerController(name: string, cls: any): void }) {',\n  );\n  for (const reg of registrations) {\n    lines.push(reg);\n  }\n  lines.push(\n    '}',\n    '',\n  );\n\n  return lines.join('\\n');\n}\n"],"mappings":"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","names":["path"]}

package/dist/codegen/controller_registration_generator.d.cts

@@ -1,5 +1,16 @@
 import { OperationDef } from '../types/operations.cjs';
 
+/**
+ * Every file a controller identity may live at, in resolution order —
+ * shared by codegen and by test-time auto-binding so both agree on where an
+ * identity resolves and on what to report when it does not.
+ */
+declare function controllerFileCandidates(controllerName: string, controllersDir: string): string[];
+/**
+ * Resolve a controller name to a file path on disk.
+ * Returns the first candidate that exists, or undefined if none match.
+ */
+declare function resolveControllerFile(controllerName: string, controllersDir: string): string | undefined;
 interface ControllerRegistrationOptions {
     /** Directory where controller source files live */
     controllersDir: string;
@@ -15,4 +26,4 @@ interface ControllerRegistrationOptions {
  */
 declare function generateControllerRegistration(operations: Map<string, OperationDef>, options: ControllerRegistrationOptions): string;
 
-export { type ControllerRegistrationOptions, generateControllerRegistration };
+export { type ControllerRegistrationOptions, controllerFileCandidates, generateControllerRegistration, resolveControllerFile };

package/dist/codegen/controller_registration_generator.d.ts

@@ -1,5 +1,16 @@
 import { OperationDef } from '../types/operations.js';
 
+/**
+ * Every file a controller identity may live at, in resolution order —
+ * shared by codegen and by test-time auto-binding so both agree on where an
+ * identity resolves and on what to report when it does not.
+ */
+declare function controllerFileCandidates(controllerName: string, controllersDir: string): string[];
+/**
+ * Resolve a controller name to a file path on disk.
+ * Returns the first candidate that exists, or undefined if none match.
+ */
+declare function resolveControllerFile(controllerName: string, controllersDir: string): string | undefined;
 interface ControllerRegistrationOptions {
     /** Directory where controller source files live */
     controllersDir: string;
@@ -15,4 +26,4 @@ interface ControllerRegistrationOptions {
  */
 declare function generateControllerRegistration(operations: Map<string, OperationDef>, options: ControllerRegistrationOptions): string;
 
-export { type ControllerRegistrationOptions, generateControllerRegistration };
+export { type ControllerRegistrationOptions, controllerFileCandidates, generateControllerRegistration, resolveControllerFile };

package/dist/codegen/controller_registration_generator.js

@@ -15,6 +15,13 @@ const INDEX_CANDIDATES = [
   "index.ts",
   "index.js"
 ];
+function controllerFileCandidates(controllerName, controllersDir) {
+  const basePath = path.resolve(controllersDir, controllerName);
+  return [
+    ...CANDIDATE_SUFFIXES.map((suffix) => basePath + suffix),
+    ...INDEX_CANDIDATES.map((indexFile) => path.resolve(controllersDir, controllerName, indexFile))
+  ];
+}
 function resolveControllerFile(controllerName, controllersDir) {
   const basePath = path.resolve(controllersDir, controllerName);
   for (const suffix of CANDIDATE_SUFFIXES) {
@@ -104,6 +111,8 @@ Ensure each controller file exists with one of these suffixes: .ts, .controller.
   return lines.join("\n");
 }
 export {
-  generateControllerRegistration
+  controllerFileCandidates,
+  generateControllerRegistration,
+  resolveControllerFile
 };
 //# sourceMappingURL=controller_registration_generator.js.map

package/dist/codegen/controller_registration_generator.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/codegen/controller_registration_generator.ts"],"sourcesContent":["import { existsSync } from 'fs';\nimport path from 'path';\nimport type { OperationDef } from '../types/index.js';\nimport { generatedFileNotice } from './generated_file_notice.js';\n\nconst CONTROLLER_REGISTRATION_SOURCE_INSTRUCTIONS = [\n  'To change controller registration, edit the operations YAML configured by',\n  'wood.config.yml main.openapi and the matching controller files.',\n] as const;\n\n/**\n * Candidate file extensions to search when resolving a controller name to a file.\n * Matches the order used by ControllerResolver.resolveClass().\n */\nconst CANDIDATE_SUFFIXES = [\n  '.ts',\n  '.controller.ts',\n  '.js',\n  '.controller.js',\n] as const;\n\nconst INDEX_CANDIDATES = [\n  'index.ts',\n  'index.js',\n] as const;\n\n/**\n * Resolve a controller name to a file path on disk.\n * Returns the first candidate that exists, or undefined if none match.\n */\nfunction resolveControllerFile(controllerName: string, controllersDir: string): string | undefined {\n  const basePath = path.resolve(controllersDir, controllerName);\n\n  for (const suffix of CANDIDATE_SUFFIXES) {\n    const candidate = basePath + suffix;\n    if (existsSync(candidate)) return candidate;\n  }\n\n  for (const indexFile of INDEX_CANDIDATES) {\n    const candidate = path.resolve(controllersDir, controllerName, indexFile);\n    if (existsSync(candidate)) return candidate;\n  }\n\n  return undefined;\n}\n\n/**\n * Compute a relative import path from the generated file's directory to the\n * resolved controller file. Strips `.ts` extensions since TypeScript imports\n * should not include them.\n */\nfunction computeImportPath(fromDir: string, toFile: string): string {\n  let rel = path.relative(fromDir, toFile);\n\n  // Ensure the path starts with ./ or ../\n  if (!rel.startsWith('.')) {\n    rel = './' + rel;\n  }\n\n  // Strip .ts extension (TypeScript convention)\n  if (rel.endsWith('.ts')) {\n    rel = rel.slice(0, -3);\n  }\n\n  // Normalize path separators to forward slashes (Windows compat)\n  return rel.replace(/\\\\/g, '/');\n}\n\n/**\n * Convert a controller name to a valid PascalCase identifier for the import.\n * e.g. \"chat\" -> \"ChatController\", \"multi_agent\" -> \"MultiAgentController\"\n */\nfunction toControllerClassName(controllerName: string): string {\n  const pascal = controllerName\n    .split(/[_\\-.]/)\n    .map((segment) => segment.charAt(0).toUpperCase() + segment.slice(1))\n    .join('');\n\n  return pascal + 'Controller';\n}\n\n/**\n * Extract all unique controller names from a set of parsed operations.\n */\nfunction extractControllerNames(operations: Map<string, OperationDef>): string[] {\n  const names = new Set<string>();\n\n  operations.forEach((op) => {\n    names.add(op.controller);\n  });\n\n  return Array.from(names).sort();\n}\n\nexport interface ControllerRegistrationOptions {\n  /** Directory where controller source files live */\n  controllersDir: string;\n  /** Directory where the generated file will be written */\n  outDir: string;\n  /** If true, unresolved controllers emit a warning comment instead of throwing. Default: false. */\n  allowUnresolved?: boolean;\n}\n\n/**\n * Generate a TypeScript registration file that statically imports every\n * controller referenced in operations and exports a function to register\n * them with a WoodRouter.\n */\nexport function generateControllerRegistration(\n  operations: Map<string, OperationDef>,\n  options: ControllerRegistrationOptions,\n): string {\n  const controllerNames = extractControllerNames(operations);\n  const outDirResolved = path.resolve(options.outDir);\n\n  const imports: string[] = [];\n  const registrations: string[] = [];\n  const unresolved: string[] = [];\n\n  for (const name of controllerNames) {\n    const filePath = resolveControllerFile(name, options.controllersDir);\n\n    if (!filePath) {\n      unresolved.push(name);\n      continue;\n    }\n\n    const importPath = computeImportPath(outDirResolved, filePath);\n    const className = toControllerClassName(name);\n\n    imports.push(`import ${className} from '${importPath}';`);\n    registrations.push(`  router.registerController('${name}', ${className});`);\n  }\n\n  // Fail by default when controllers cannot be resolved\n  if (unresolved.length > 0 && !options.allowUnresolved) {\n    throw new Error(\n      `Controller registration codegen failed: ${unresolved.length} controller(s) not found on disk:\\n` +\n      unresolved.map(name => `  - \"${name}\" (searched in ${options.controllersDir})`).join('\\n') +\n      `\\n\\nEnsure each controller file exists with one of these suffixes: .ts, .controller.ts, .js, .controller.js`\n    );\n  }\n\n  const lines: string[] = [\n    generatedFileNotice(CONTROLLER_REGISTRATION_SOURCE_INSTRUCTIONS),\n    '//',\n    '// Static imports ensure all controllers are bundled and available at startup.',\n    '// registerController() puts each class directly in the router\\'s cache.',\n  ];\n\n  if (unresolved.length > 0) {\n    lines.push(\n      '',\n      '// WARNING: The following controllers could not be resolved on disk:',\n      ...unresolved.map((name) => `//   - ${name}`),\n    );\n  }\n\n  // Static imports\n  lines.push('');\n  for (const imp of imports) {\n    lines.push(imp);\n  }\n\n  // Registration function\n  lines.push(\n    '',\n    'export function registerControllers(router: { registerController(name: string, cls: any): void }) {',\n  );\n  for (const reg of registrations) {\n    lines.push(reg);\n  }\n  lines.push(\n    '}',\n    '',\n  );\n\n  return lines.join('\\n');\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/codegen/controller_registration_generator.ts"],"sourcesContent":["import { existsSync } from 'fs';\nimport path from 'path';\nimport type { OperationDef } from '../types/index.js';\nimport { generatedFileNotice } from './generated_file_notice.js';\n\nconst CONTROLLER_REGISTRATION_SOURCE_INSTRUCTIONS = [\n  'To change controller registration, edit the operations YAML configured by',\n  'wood.config.yml main.openapi and the matching controller files.',\n] as const;\n\n/**\n * Candidate file extensions to search when resolving a controller name to a file.\n * Matches the order used by ControllerResolver.resolveClass().\n */\nconst CANDIDATE_SUFFIXES = [\n  '.ts',\n  '.controller.ts',\n  '.js',\n  '.controller.js',\n] as const;\n\nconst INDEX_CANDIDATES = [\n  'index.ts',\n  'index.js',\n] as const;\n\n/**\n * Every file a controller identity may live at, in resolution order —\n * shared by codegen and by test-time auto-binding so both agree on where an\n * identity resolves and on what to report when it does not.\n */\nexport function controllerFileCandidates(controllerName: string, controllersDir: string): string[] {\n  const basePath = path.resolve(controllersDir, controllerName);\n  return [\n    ...CANDIDATE_SUFFIXES.map((suffix) => basePath + suffix),\n    ...INDEX_CANDIDATES.map((indexFile) => path.resolve(controllersDir, controllerName, indexFile)),\n  ];\n}\n\n/**\n * Resolve a controller name to a file path on disk.\n * Returns the first candidate that exists, or undefined if none match.\n */\nexport function resolveControllerFile(controllerName: string, controllersDir: string): string | undefined {\n  const basePath = path.resolve(controllersDir, controllerName);\n\n  for (const suffix of CANDIDATE_SUFFIXES) {\n    const candidate = basePath + suffix;\n    if (existsSync(candidate)) return candidate;\n  }\n\n  for (const indexFile of INDEX_CANDIDATES) {\n    const candidate = path.resolve(controllersDir, controllerName, indexFile);\n    if (existsSync(candidate)) return candidate;\n  }\n\n  return undefined;\n}\n\n/**\n * Compute a relative import path from the generated file's directory to the\n * resolved controller file. Strips `.ts` extensions since TypeScript imports\n * should not include them.\n */\nfunction computeImportPath(fromDir: string, toFile: string): string {\n  let rel = path.relative(fromDir, toFile);\n\n  // Ensure the path starts with ./ or ../\n  if (!rel.startsWith('.')) {\n    rel = './' + rel;\n  }\n\n  // Strip .ts extension (TypeScript convention)\n  if (rel.endsWith('.ts')) {\n    rel = rel.slice(0, -3);\n  }\n\n  // Normalize path separators to forward slashes (Windows compat)\n  return rel.replace(/\\\\/g, '/');\n}\n\n/**\n * Convert a controller name to a valid PascalCase identifier for the import.\n * e.g. \"chat\" -> \"ChatController\", \"multi_agent\" -> \"MultiAgentController\"\n */\nfunction toControllerClassName(controllerName: string): string {\n  const pascal = controllerName\n    .split(/[_\\-.]/)\n    .map((segment) => segment.charAt(0).toUpperCase() + segment.slice(1))\n    .join('');\n\n  return pascal + 'Controller';\n}\n\n/**\n * Extract all unique controller names from a set of parsed operations.\n */\nfunction extractControllerNames(operations: Map<string, OperationDef>): string[] {\n  const names = new Set<string>();\n\n  operations.forEach((op) => {\n    names.add(op.controller);\n  });\n\n  return Array.from(names).sort();\n}\n\nexport interface ControllerRegistrationOptions {\n  /** Directory where controller source files live */\n  controllersDir: string;\n  /** Directory where the generated file will be written */\n  outDir: string;\n  /** If true, unresolved controllers emit a warning comment instead of throwing. Default: false. */\n  allowUnresolved?: boolean;\n}\n\n/**\n * Generate a TypeScript registration file that statically imports every\n * controller referenced in operations and exports a function to register\n * them with a WoodRouter.\n */\nexport function generateControllerRegistration(\n  operations: Map<string, OperationDef>,\n  options: ControllerRegistrationOptions,\n): string {\n  const controllerNames = extractControllerNames(operations);\n  const outDirResolved = path.resolve(options.outDir);\n\n  const imports: string[] = [];\n  const registrations: string[] = [];\n  const unresolved: string[] = [];\n\n  for (const name of controllerNames) {\n    const filePath = resolveControllerFile(name, options.controllersDir);\n\n    if (!filePath) {\n      unresolved.push(name);\n      continue;\n    }\n\n    const importPath = computeImportPath(outDirResolved, filePath);\n    const className = toControllerClassName(name);\n\n    imports.push(`import ${className} from '${importPath}';`);\n    registrations.push(`  router.registerController('${name}', ${className});`);\n  }\n\n  // Fail by default when controllers cannot be resolved\n  if (unresolved.length > 0 && !options.allowUnresolved) {\n    throw new Error(\n      `Controller registration codegen failed: ${unresolved.length} controller(s) not found on disk:\\n` +\n      unresolved.map(name => `  - \"${name}\" (searched in ${options.controllersDir})`).join('\\n') +\n      `\\n\\nEnsure each controller file exists with one of these suffixes: .ts, .controller.ts, .js, .controller.js`\n    );\n  }\n\n  const lines: string[] = [\n    generatedFileNotice(CONTROLLER_REGISTRATION_SOURCE_INSTRUCTIONS),\n    '//',\n    '// Static imports ensure all controllers are bundled and available at startup.',\n    '// registerController() puts each class directly in the router\\'s cache.',\n  ];\n\n  if (unresolved.length > 0) {\n    lines.push(\n      '',\n      '// WARNING: The following controllers could not be resolved on disk:',\n      ...unresolved.map((name) => `//   - ${name}`),\n    );\n  }\n\n  // Static imports\n  lines.push('');\n  for (const imp of imports) {\n    lines.push(imp);\n  }\n\n  // Registration function\n  lines.push(\n    '',\n    'export function registerControllers(router: { registerController(name: string, cls: any): void }) {',\n  );\n  for (const reg of registrations) {\n    lines.push(reg);\n  }\n  lines.push(\n    '}',\n    '',\n  );\n\n  return lines.join('\\n');\n}\n"],"mappings":"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","names":[]}

package/dist/codegen/index.d.cts

@@ -7,5 +7,6 @@ export { RuntimeGeneratorOptions, generateRuntime } from './runtime_generator.cj
 export { RendererViewManifestGeneratorOptions, generateRendererViewManifest } from './renderer_view_manifest_generator.cjs';
 export { RendererControllerRegistrationOptions, generateRendererControllerRegistration } from './renderer_controller_registration_generator.cjs';
 export { RendererAppGeneratorOptions, generateRendererApp } from './renderer_app_generator.cjs';
+import '../types/config.cjs';
 import '../types/operations.cjs';
 import '../types/views.cjs';

package/dist/codegen/index.d.ts

@@ -7,5 +7,6 @@ export { RuntimeGeneratorOptions, generateRuntime } from './runtime_generator.js
 export { RendererViewManifestGeneratorOptions, generateRendererViewManifest } from './renderer_view_manifest_generator.js';
 export { RendererControllerRegistrationOptions, generateRendererControllerRegistration } from './renderer_controller_registration_generator.js';
 export { RendererAppGeneratorOptions, generateRendererApp } from './renderer_app_generator.js';
+import '../types/config.js';
 import '../types/operations.js';
 import '../types/views.js';