@noego/wood 0.4.6 → 0.4.8

package/dist/codegen/channel_map_generator.cjs

@@ -0,0 +1,102 @@
+"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 channel_map_generator_exports = {};
+__export(channel_map_generator_exports, {
+  generateChannelMap: () => generateChannelMap
+});
+module.exports = __toCommonJS(channel_map_generator_exports);
+var import_generated_file_notice = require("./generated_file_notice.cjs");
+const CHANNEL_MAP_SOURCE_INSTRUCTIONS = [
+  "To change IPC channels or their input/output types, edit the operations YAML configured by",
+  "wood.config.yml main.openapi and regenerate with `wood dev` or `wood build`."
+];
+function operationHasInput(op) {
+  return Boolean(
+    op.inputSchema && op.inputSchema.type === "object" && Object.keys(
+      op.inputSchema.properties ?? {}
+    ).length > 0
+  );
+}
+function jsonSchemaToTS(schema, indent) {
+  if (!schema) return "unknown";
+  const type = schema.type;
+  if (type === "string") {
+    if (schema.enum) {
+      return schema.enum.map((v) => `'${v}'`).join(" | ");
+    }
+    return "string";
+  }
+  if (type === "number" || type === "integer") return "number";
+  if (type === "boolean") return "boolean";
+  if (type === "array") {
+    return `Array<${jsonSchemaToTS(schema.items, indent)}>`;
+  }
+  if (type === "object") {
+    const props = schema.properties ?? {};
+    const required = new Set(schema.required ?? []);
+    const entries = Object.entries(props);
+    if (entries.length === 0) return "Record<string, unknown>";
+    const lines = entries.map(([key, val]) => {
+      const optional = required.has(key) ? "" : "?";
+      const valType = jsonSchemaToTS(val, indent + "  ");
+      const safeKey = /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(key) ? key : JSON.stringify(key);
+      return `${indent}    ${safeKey}${optional}: ${valType};`;
+    });
+    return `{
+${lines.join("\n")}
+${indent}  }`;
+  }
+  return "unknown";
+}
+function generateChannelMap(operations) {
+  const channels = Array.from(operations.values()).sort(
+    (a, b) => a.channel.localeCompare(b.channel)
+  );
+  const entries = channels.map((op) => {
+    const inputType = operationHasInput(op) ? jsonSchemaToTS(op.inputSchema, "  ") : "void";
+    const outputType = jsonSchemaToTS(op.outputSchema, "  ");
+    return `  ${JSON.stringify(op.channel)}: { input: ${inputType}; output: ${outputType} };`;
+  });
+  return `${(0, import_generated_file_notice.generatedFileNotice)(CHANNEL_MAP_SOURCE_INSTRUCTIONS)}
+import type { TypedCall } from '@noego/wood/transport';
+
+/**
+ * Channel -> { input, output } lookup, generated from the operations YAML.
+ * Inputless operations have \`input: void\`.
+ *
+ * Emitted as a \`type\` (not \`interface\`) so it satisfies the
+ * \`WoodChannelMapLike\` (= \`Record<string, WoodChannelContract>\`) constraint on
+ * \`TypedCall\`: an interface has no implicit index signature, a type alias does.
+ */
+export type WoodChannelMap = {
+${entries.join("\n")}
+};
+
+/** All channel names as a string-literal union. */
+export type WoodChannelName = keyof WoodChannelMap;
+
+/** The typed \`call\` signature for the test harness, bound to this app's channels. */
+export type WoodTypedCall = TypedCall<WoodChannelMap>;
+`;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  generateChannelMap
+});
+//# sourceMappingURL=channel_map_generator.cjs.map

package/dist/codegen/channel_map_generator.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/codegen/channel_map_generator.ts"],"sourcesContent":["import type { OperationDef } from '../types/index.cjs';\nimport { generatedFileNotice } from './generated_file_notice.cjs';\n\nconst CHANNEL_MAP_SOURCE_INSTRUCTIONS = [\n  'To change IPC channels or their input/output types, edit the operations YAML configured by',\n  'wood.config.yml main.openapi and regenerate with `wood dev` or `wood build`.',\n] as const;\n\n/**\n * A boring, generated lookup interface mapping channel name -> { input, output }.\n *\n * This is the source of truth for the harness `call(channel, payload)` typing —\n * the same operations map that drives `ui/generated/wood.d.ts`. No conditional\n * type machinery: one flat interface literal keyed by channel string, consumed\n * by `WoodChannelInput`/`WoodChannelOutput`/`TypedCall` from `@noego/wood`.\n */\n\nfunction operationHasInput(op: OperationDef): boolean {\n  return Boolean(\n    op.inputSchema &&\n      (op.inputSchema as Record<string, unknown>).type === 'object' &&\n      Object.keys(\n        (op.inputSchema as Record<string, Record<string, unknown>>).properties ?? {},\n      ).length > 0,\n  );\n}\n\nfunction jsonSchemaToTS(schema: Record<string, unknown> | undefined, indent: string): string {\n  if (!schema) return 'unknown';\n\n  const type = schema.type as string | undefined;\n\n  if (type === 'string') {\n    if (schema.enum) {\n      return (schema.enum as string[]).map((v) => `'${v}'`).join(' | ');\n    }\n    return 'string';\n  }\n  if (type === 'number' || type === 'integer') return 'number';\n  if (type === 'boolean') return 'boolean';\n  if (type === 'array') {\n    return `Array<${jsonSchemaToTS(schema.items as Record<string, unknown>, indent)}>`;\n  }\n  if (type === 'object') {\n    const props = (schema.properties ?? {}) as Record<string, Record<string, unknown>>;\n    const required = new Set((schema.required as string[]) ?? []);\n    const entries = Object.entries(props);\n    if (entries.length === 0) return 'Record<string, unknown>';\n\n    const lines = entries.map(([key, val]) => {\n      const optional = required.has(key) ? '' : '?';\n      const valType = jsonSchemaToTS(val, indent + '  ');\n      const safeKey = /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(key) ? key : JSON.stringify(key);\n      return `${indent}    ${safeKey}${optional}: ${valType};`;\n    });\n    return `{\\n${lines.join('\\n')}\\n${indent}  }`;\n  }\n\n  return 'unknown';\n}\n\n/** Generate the `WoodChannelMap` lookup interface plus its typed `call` alias. */\nexport function generateChannelMap(operations: Map<string, OperationDef>): string {\n  const channels = Array.from(operations.values()).sort((a, b) =>\n    a.channel.localeCompare(b.channel),\n  );\n\n  const entries = channels.map((op) => {\n    const inputType = operationHasInput(op)\n      ? jsonSchemaToTS(op.inputSchema as Record<string, unknown>, '  ')\n      : 'void';\n    const outputType = jsonSchemaToTS(op.outputSchema as Record<string, unknown>, '  ');\n    return `  ${JSON.stringify(op.channel)}: { input: ${inputType}; output: ${outputType} };`;\n  });\n\n  return `${generatedFileNotice(CHANNEL_MAP_SOURCE_INSTRUCTIONS)}\nimport type { TypedCall } from '@noego/wood/transport';\n\n/**\n * Channel -> { input, output } lookup, generated from the operations YAML.\n * Inputless operations have \\`input: void\\`.\n *\n * Emitted as a \\`type\\` (not \\`interface\\`) so it satisfies the\n * \\`WoodChannelMapLike\\` (= \\`Record<string, WoodChannelContract>\\`) constraint on\n * \\`TypedCall\\`: an interface has no implicit index signature, a type alias does.\n */\nexport type WoodChannelMap = {\n${entries.join('\\n')}\n};\n\n/** All channel names as a string-literal union. */\nexport type WoodChannelName = keyof WoodChannelMap;\n\n/** The typed \\`call\\` signature for the test harness, bound to this app's channels. */\nexport type WoodTypedCall = TypedCall<WoodChannelMap>;\n`;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,mCAAoC;AAEpC,MAAM,kCAAkC;AAAA,EACtC;AAAA,EACA;AACF;AAWA,SAAS,kBAAkB,IAA2B;AACpD,SAAO;AAAA,IACL,GAAG,eACA,GAAG,YAAwC,SAAS,YACrD,OAAO;AAAA,MACJ,GAAG,YAAwD,cAAc,CAAC;AAAA,IAC7E,EAAE,SAAS;AAAA,EACf;AACF;AAEA,SAAS,eAAe,QAA6C,QAAwB;AAC3F,MAAI,CAAC,OAAQ,QAAO;AAEpB,QAAM,OAAO,OAAO;AAEpB,MAAI,SAAS,UAAU;AACrB,QAAI,OAAO,MAAM;AACf,aAAQ,OAAO,KAAkB,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,KAAK,KAAK;AAAA,IAClE;AACA,WAAO;AAAA,EACT;AACA,MAAI,SAAS,YAAY,SAAS,UAAW,QAAO;AACpD,MAAI,SAAS,UAAW,QAAO;AAC/B,MAAI,SAAS,SAAS;AACpB,WAAO,SAAS,eAAe,OAAO,OAAkC,MAAM,CAAC;AAAA,EACjF;AACA,MAAI,SAAS,UAAU;AACrB,UAAM,QAAS,OAAO,cAAc,CAAC;AACrC,UAAM,WAAW,IAAI,IAAK,OAAO,YAAyB,CAAC,CAAC;AAC5D,UAAM,UAAU,OAAO,QAAQ,KAAK;AACpC,QAAI,QAAQ,WAAW,EAAG,QAAO;AAEjC,UAAM,QAAQ,QAAQ,IAAI,CAAC,CAAC,KAAK,GAAG,MAAM;AACxC,YAAM,WAAW,SAAS,IAAI,GAAG,IAAI,KAAK;AAC1C,YAAM,UAAU,eAAe,KAAK,SAAS,IAAI;AACjD,YAAM,UAAU,6BAA6B,KAAK,GAAG,IAAI,MAAM,KAAK,UAAU,GAAG;AACjF,aAAO,GAAG,MAAM,OAAO,OAAO,GAAG,QAAQ,KAAK,OAAO;AAAA,IACvD,CAAC;AACD,WAAO;AAAA,EAAM,MAAM,KAAK,IAAI,CAAC;AAAA,EAAK,MAAM;AAAA,EAC1C;AAEA,SAAO;AACT;AAGO,SAAS,mBAAmB,YAA+C;AAChF,QAAM,WAAW,MAAM,KAAK,WAAW,OAAO,CAAC,EAAE;AAAA,IAAK,CAAC,GAAG,MACxD,EAAE,QAAQ,cAAc,EAAE,OAAO;AAAA,EACnC;AAEA,QAAM,UAAU,SAAS,IAAI,CAAC,OAAO;AACnC,UAAM,YAAY,kBAAkB,EAAE,IAClC,eAAe,GAAG,aAAwC,IAAI,IAC9D;AACJ,UAAM,aAAa,eAAe,GAAG,cAAyC,IAAI;AAClF,WAAO,KAAK,KAAK,UAAU,GAAG,OAAO,CAAC,cAAc,SAAS,aAAa,UAAU;AAAA,EACtF,CAAC;AAED,SAAO,OAAG,kDAAoB,+BAA+B,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAY9D,QAAQ,KAAK,IAAI,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AASpB;","names":[]}

package/dist/codegen/channel_map_generator.d.cts

@@ -0,0 +1,6 @@
+import { OperationDef } from '../types/operations.cjs';
+
+/** Generate the `WoodChannelMap` lookup interface plus its typed `call` alias. */
+declare function generateChannelMap(operations: Map<string, OperationDef>): string;
+
+export { generateChannelMap };

package/dist/codegen/channel_map_generator.d.ts

@@ -0,0 +1,6 @@
+import { OperationDef } from '../types/operations.js';
+
+/** Generate the `WoodChannelMap` lookup interface plus its typed `call` alias. */
+declare function generateChannelMap(operations: Map<string, OperationDef>): string;
+
+export { generateChannelMap };

package/dist/codegen/channel_map_generator.js

@@ -0,0 +1,78 @@
+import { generatedFileNotice } from "./generated_file_notice.js";
+const CHANNEL_MAP_SOURCE_INSTRUCTIONS = [
+  "To change IPC channels or their input/output types, edit the operations YAML configured by",
+  "wood.config.yml main.openapi and regenerate with `wood dev` or `wood build`."
+];
+function operationHasInput(op) {
+  return Boolean(
+    op.inputSchema && op.inputSchema.type === "object" && Object.keys(
+      op.inputSchema.properties ?? {}
+    ).length > 0
+  );
+}
+function jsonSchemaToTS(schema, indent) {
+  if (!schema) return "unknown";
+  const type = schema.type;
+  if (type === "string") {
+    if (schema.enum) {
+      return schema.enum.map((v) => `'${v}'`).join(" | ");
+    }
+    return "string";
+  }
+  if (type === "number" || type === "integer") return "number";
+  if (type === "boolean") return "boolean";
+  if (type === "array") {
+    return `Array<${jsonSchemaToTS(schema.items, indent)}>`;
+  }
+  if (type === "object") {
+    const props = schema.properties ?? {};
+    const required = new Set(schema.required ?? []);
+    const entries = Object.entries(props);
+    if (entries.length === 0) return "Record<string, unknown>";
+    const lines = entries.map(([key, val]) => {
+      const optional = required.has(key) ? "" : "?";
+      const valType = jsonSchemaToTS(val, indent + "  ");
+      const safeKey = /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(key) ? key : JSON.stringify(key);
+      return `${indent}    ${safeKey}${optional}: ${valType};`;
+    });
+    return `{
+${lines.join("\n")}
+${indent}  }`;
+  }
+  return "unknown";
+}
+function generateChannelMap(operations) {
+  const channels = Array.from(operations.values()).sort(
+    (a, b) => a.channel.localeCompare(b.channel)
+  );
+  const entries = channels.map((op) => {
+    const inputType = operationHasInput(op) ? jsonSchemaToTS(op.inputSchema, "  ") : "void";
+    const outputType = jsonSchemaToTS(op.outputSchema, "  ");
+    return `  ${JSON.stringify(op.channel)}: { input: ${inputType}; output: ${outputType} };`;
+  });
+  return `${generatedFileNotice(CHANNEL_MAP_SOURCE_INSTRUCTIONS)}
+import type { TypedCall } from '@noego/wood/transport';
+
+/**
+ * Channel -> { input, output } lookup, generated from the operations YAML.
+ * Inputless operations have \`input: void\`.
+ *
+ * Emitted as a \`type\` (not \`interface\`) so it satisfies the
+ * \`WoodChannelMapLike\` (= \`Record<string, WoodChannelContract>\`) constraint on
+ * \`TypedCall\`: an interface has no implicit index signature, a type alias does.
+ */
+export type WoodChannelMap = {
+${entries.join("\n")}
+};
+
+/** All channel names as a string-literal union. */
+export type WoodChannelName = keyof WoodChannelMap;
+
+/** The typed \`call\` signature for the test harness, bound to this app's channels. */
+export type WoodTypedCall = TypedCall<WoodChannelMap>;
+`;
+}
+export {
+  generateChannelMap
+};
+//# sourceMappingURL=channel_map_generator.js.map

package/dist/codegen/channel_map_generator.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/codegen/channel_map_generator.ts"],"sourcesContent":["import type { OperationDef } from '../types/index.js';\nimport { generatedFileNotice } from './generated_file_notice.js';\n\nconst CHANNEL_MAP_SOURCE_INSTRUCTIONS = [\n  'To change IPC channels or their input/output types, edit the operations YAML configured by',\n  'wood.config.yml main.openapi and regenerate with `wood dev` or `wood build`.',\n] as const;\n\n/**\n * A boring, generated lookup interface mapping channel name -> { input, output }.\n *\n * This is the source of truth for the harness `call(channel, payload)` typing —\n * the same operations map that drives `ui/generated/wood.d.ts`. No conditional\n * type machinery: one flat interface literal keyed by channel string, consumed\n * by `WoodChannelInput`/`WoodChannelOutput`/`TypedCall` from `@noego/wood`.\n */\n\nfunction operationHasInput(op: OperationDef): boolean {\n  return Boolean(\n    op.inputSchema &&\n      (op.inputSchema as Record<string, unknown>).type === 'object' &&\n      Object.keys(\n        (op.inputSchema as Record<string, Record<string, unknown>>).properties ?? {},\n      ).length > 0,\n  );\n}\n\nfunction jsonSchemaToTS(schema: Record<string, unknown> | undefined, indent: string): string {\n  if (!schema) return 'unknown';\n\n  const type = schema.type as string | undefined;\n\n  if (type === 'string') {\n    if (schema.enum) {\n      return (schema.enum as string[]).map((v) => `'${v}'`).join(' | ');\n    }\n    return 'string';\n  }\n  if (type === 'number' || type === 'integer') return 'number';\n  if (type === 'boolean') return 'boolean';\n  if (type === 'array') {\n    return `Array<${jsonSchemaToTS(schema.items as Record<string, unknown>, indent)}>`;\n  }\n  if (type === 'object') {\n    const props = (schema.properties ?? {}) as Record<string, Record<string, unknown>>;\n    const required = new Set((schema.required as string[]) ?? []);\n    const entries = Object.entries(props);\n    if (entries.length === 0) return 'Record<string, unknown>';\n\n    const lines = entries.map(([key, val]) => {\n      const optional = required.has(key) ? '' : '?';\n      const valType = jsonSchemaToTS(val, indent + '  ');\n      const safeKey = /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(key) ? key : JSON.stringify(key);\n      return `${indent}    ${safeKey}${optional}: ${valType};`;\n    });\n    return `{\\n${lines.join('\\n')}\\n${indent}  }`;\n  }\n\n  return 'unknown';\n}\n\n/** Generate the `WoodChannelMap` lookup interface plus its typed `call` alias. */\nexport function generateChannelMap(operations: Map<string, OperationDef>): string {\n  const channels = Array.from(operations.values()).sort((a, b) =>\n    a.channel.localeCompare(b.channel),\n  );\n\n  const entries = channels.map((op) => {\n    const inputType = operationHasInput(op)\n      ? jsonSchemaToTS(op.inputSchema as Record<string, unknown>, '  ')\n      : 'void';\n    const outputType = jsonSchemaToTS(op.outputSchema as Record<string, unknown>, '  ');\n    return `  ${JSON.stringify(op.channel)}: { input: ${inputType}; output: ${outputType} };`;\n  });\n\n  return `${generatedFileNotice(CHANNEL_MAP_SOURCE_INSTRUCTIONS)}\nimport type { TypedCall } from '@noego/wood/transport';\n\n/**\n * Channel -> { input, output } lookup, generated from the operations YAML.\n * Inputless operations have \\`input: void\\`.\n *\n * Emitted as a \\`type\\` (not \\`interface\\`) so it satisfies the\n * \\`WoodChannelMapLike\\` (= \\`Record<string, WoodChannelContract>\\`) constraint on\n * \\`TypedCall\\`: an interface has no implicit index signature, a type alias does.\n */\nexport type WoodChannelMap = {\n${entries.join('\\n')}\n};\n\n/** All channel names as a string-literal union. */\nexport type WoodChannelName = keyof WoodChannelMap;\n\n/** The typed \\`call\\` signature for the test harness, bound to this app's channels. */\nexport type WoodTypedCall = TypedCall<WoodChannelMap>;\n`;\n}\n"],"mappings":"AACA,SAAS,2BAA2B;AAEpC,MAAM,kCAAkC;AAAA,EACtC;AAAA,EACA;AACF;AAWA,SAAS,kBAAkB,IAA2B;AACpD,SAAO;AAAA,IACL,GAAG,eACA,GAAG,YAAwC,SAAS,YACrD,OAAO;AAAA,MACJ,GAAG,YAAwD,cAAc,CAAC;AAAA,IAC7E,EAAE,SAAS;AAAA,EACf;AACF;AAEA,SAAS,eAAe,QAA6C,QAAwB;AAC3F,MAAI,CAAC,OAAQ,QAAO;AAEpB,QAAM,OAAO,OAAO;AAEpB,MAAI,SAAS,UAAU;AACrB,QAAI,OAAO,MAAM;AACf,aAAQ,OAAO,KAAkB,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,KAAK,KAAK;AAAA,IAClE;AACA,WAAO;AAAA,EACT;AACA,MAAI,SAAS,YAAY,SAAS,UAAW,QAAO;AACpD,MAAI,SAAS,UAAW,QAAO;AAC/B,MAAI,SAAS,SAAS;AACpB,WAAO,SAAS,eAAe,OAAO,OAAkC,MAAM,CAAC;AAAA,EACjF;AACA,MAAI,SAAS,UAAU;AACrB,UAAM,QAAS,OAAO,cAAc,CAAC;AACrC,UAAM,WAAW,IAAI,IAAK,OAAO,YAAyB,CAAC,CAAC;AAC5D,UAAM,UAAU,OAAO,QAAQ,KAAK;AACpC,QAAI,QAAQ,WAAW,EAAG,QAAO;AAEjC,UAAM,QAAQ,QAAQ,IAAI,CAAC,CAAC,KAAK,GAAG,MAAM;AACxC,YAAM,WAAW,SAAS,IAAI,GAAG,IAAI,KAAK;AAC1C,YAAM,UAAU,eAAe,KAAK,SAAS,IAAI;AACjD,YAAM,UAAU,6BAA6B,KAAK,GAAG,IAAI,MAAM,KAAK,UAAU,GAAG;AACjF,aAAO,GAAG,MAAM,OAAO,OAAO,GAAG,QAAQ,KAAK,OAAO;AAAA,IACvD,CAAC;AACD,WAAO;AAAA,EAAM,MAAM,KAAK,IAAI,CAAC;AAAA,EAAK,MAAM;AAAA,EAC1C;AAEA,SAAO;AACT;AAGO,SAAS,mBAAmB,YAA+C;AAChF,QAAM,WAAW,MAAM,KAAK,WAAW,OAAO,CAAC,EAAE;AAAA,IAAK,CAAC,GAAG,MACxD,EAAE,QAAQ,cAAc,EAAE,OAAO;AAAA,EACnC;AAEA,QAAM,UAAU,SAAS,IAAI,CAAC,OAAO;AACnC,UAAM,YAAY,kBAAkB,EAAE,IAClC,eAAe,GAAG,aAAwC,IAAI,IAC9D;AACJ,UAAM,aAAa,eAAe,GAAG,cAAyC,IAAI;AAClF,WAAO,KAAK,KAAK,UAAU,GAAG,OAAO,CAAC,cAAc,SAAS,aAAa,UAAU;AAAA,EACtF,CAAC;AAED,SAAO,GAAG,oBAAoB,+BAA+B,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAY9D,QAAQ,KAAK,IAAI,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AASpB;","names":[]}

package/dist/codegen/controller_registration_generator.cjs

@@ -33,6 +33,11 @@ __export(controller_registration_generator_exports, {
 module.exports = __toCommonJS(controller_registration_generator_exports);
 var import_fs = require("fs");
 var import_path = __toESM(require("path"), 1);
+var import_generated_file_notice = require("./generated_file_notice.cjs");
+const CONTROLLER_REGISTRATION_SOURCE_INSTRUCTIONS = [
+  "To change controller registration, edit the operations YAML configured by",
+  "wood.config.yml main.openapi and the matching controller files."
+];
 const CANDIDATE_SUFFIXES = [
   ".ts",
   ".controller.ts",
@@ -102,7 +107,7 @@ Ensure each controller file exists with one of these suffixes: .ts, .controller.
     );
   }
   const lines = [
-    "// AUTO-GENERATED by @noego/wood -- do not edit",
+    (0, import_generated_file_notice.generatedFileNotice)(CONTROLLER_REGISTRATION_SOURCE_INSTRUCTIONS),
     "//",
     "// Static imports ensure all controllers are bundled and available at startup.",
     "// registerController() puts each class directly in the router's cache."

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';\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    '// AUTO-GENERATED by @noego/wood -- do not edit',\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 * 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"]}

package/dist/codegen/controller_registration_generator.js

@@ -1,5 +1,10 @@
 import { existsSync } from "fs";
 import path from "path";
+import { generatedFileNotice } from "./generated_file_notice.js";
+const CONTROLLER_REGISTRATION_SOURCE_INSTRUCTIONS = [
+  "To change controller registration, edit the operations YAML configured by",
+  "wood.config.yml main.openapi and the matching controller files."
+];
 const CANDIDATE_SUFFIXES = [
   ".ts",
   ".controller.ts",
@@ -69,7 +74,7 @@ Ensure each controller file exists with one of these suffixes: .ts, .controller.
     );
   }
   const lines = [
-    "// AUTO-GENERATED by @noego/wood -- do not edit",
+    generatedFileNotice(CONTROLLER_REGISTRATION_SOURCE_INSTRUCTIONS),
     "//",
     "// Static imports ensure all controllers are bundled and available at startup.",
     "// registerController() puts each class directly in the router's cache."

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';\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    '// AUTO-GENERATED by @noego/wood -- do not edit',\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 * 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":[]}

package/dist/codegen/generated_file_notice.cjs

@@ -0,0 +1,40 @@
+"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 generated_file_notice_exports = {};
+__export(generated_file_notice_exports, {
+  generatedFileNotice: () => generatedFileNotice
+});
+module.exports = __toCommonJS(generated_file_notice_exports);
+const BASE_NOTICE_LINES = [
+  "// AUTO-GENERATED by @noego/wood -- do not edit.",
+  "//",
+  "// Changes here are overwritten by `wood dev` and `wood build`.",
+  "// Update the source files that feed Wood codegen instead."
+];
+function generatedFileNotice(sourceInstructions) {
+  return [
+    ...BASE_NOTICE_LINES,
+    ...sourceInstructions.map((instruction) => `// ${instruction}`)
+  ].join("\n");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  generatedFileNotice
+});
+//# sourceMappingURL=generated_file_notice.cjs.map

package/dist/codegen/generated_file_notice.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/codegen/generated_file_notice.ts"],"sourcesContent":["const BASE_NOTICE_LINES = [\n  '// AUTO-GENERATED by @noego/wood -- do not edit.',\n  '//',\n  '// Changes here are overwritten by `wood dev` and `wood build`.',\n  '// Update the source files that feed Wood codegen instead.',\n] as const;\n\nexport function generatedFileNotice(sourceInstructions: readonly string[]): string {\n  return [\n    ...BASE_NOTICE_LINES,\n    ...sourceInstructions.map((instruction) => `// ${instruction}`),\n  ].join('\\n');\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAAM,oBAAoB;AAAA,EACxB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,SAAS,oBAAoB,oBAA+C;AACjF,SAAO;AAAA,IACL,GAAG;AAAA,IACH,GAAG,mBAAmB,IAAI,CAAC,gBAAgB,MAAM,WAAW,EAAE;AAAA,EAChE,EAAE,KAAK,IAAI;AACb;","names":[]}

package/dist/codegen/generated_file_notice.d.cts

@@ -0,0 +1,3 @@
+declare function generatedFileNotice(sourceInstructions: readonly string[]): string;
+
+export { generatedFileNotice };

package/dist/codegen/generated_file_notice.d.ts

@@ -0,0 +1,3 @@
+declare function generatedFileNotice(sourceInstructions: readonly string[]): string;
+
+export { generatedFileNotice };

package/dist/codegen/generated_file_notice.js

@@ -0,0 +1,16 @@
+const BASE_NOTICE_LINES = [
+  "// AUTO-GENERATED by @noego/wood -- do not edit.",
+  "//",
+  "// Changes here are overwritten by `wood dev` and `wood build`.",
+  "// Update the source files that feed Wood codegen instead."
+];
+function generatedFileNotice(sourceInstructions) {
+  return [
+    ...BASE_NOTICE_LINES,
+    ...sourceInstructions.map((instruction) => `// ${instruction}`)
+  ].join("\n");
+}
+export {
+  generatedFileNotice
+};
+//# sourceMappingURL=generated_file_notice.js.map

package/dist/codegen/generated_file_notice.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/codegen/generated_file_notice.ts"],"sourcesContent":["const BASE_NOTICE_LINES = [\n  '// AUTO-GENERATED by @noego/wood -- do not edit.',\n  '//',\n  '// Changes here are overwritten by `wood dev` and `wood build`.',\n  '// Update the source files that feed Wood codegen instead.',\n] as const;\n\nexport function generatedFileNotice(sourceInstructions: readonly string[]): string {\n  return [\n    ...BASE_NOTICE_LINES,\n    ...sourceInstructions.map((instruction) => `// ${instruction}`),\n  ].join('\\n');\n}\n"],"mappings":"AAAA,MAAM,oBAAoB;AAAA,EACxB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,SAAS,oBAAoB,oBAA+C;AACjF,SAAO;AAAA,IACL,GAAG;AAAA,IACH,GAAG,mBAAmB,IAAI,CAAC,gBAAgB,MAAM,WAAW,EAAE;AAAA,EAChE,EAAE,KAAK,IAAI;AACb;","names":[]}

package/dist/codegen/index.cjs

@@ -18,6 +18,7 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var codegen_exports = {};
 __export(codegen_exports, {
+  generateChannelMap: () => import_channel_map_generator.generateChannelMap,
   generateControllerRegistration: () => import_controller_registration_generator.generateControllerRegistration,
   generatePreload: () => import_preload_generator.generatePreload,
   generateRendererApp: () => import_renderer_app_generator.generateRendererApp,
@@ -30,6 +31,7 @@ __export(codegen_exports, {
 module.exports = __toCommonJS(codegen_exports);
 var import_preload_generator = require("./preload_generator.cjs");
 var import_type_generator = require("./type_generator.cjs");
+var import_channel_map_generator = require("./channel_map_generator.cjs");
 var import_test_mock_generator = require("./test_mock_generator.cjs");
 var import_controller_registration_generator = require("./controller_registration_generator.cjs");
 var import_runtime_generator = require("./runtime_generator.cjs");
@@ -38,6 +40,7 @@ var import_renderer_controller_registration_generator = require("./renderer_cont
 var import_renderer_app_generator = require("./renderer_app_generator.cjs");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  generateChannelMap,
   generateControllerRegistration,
   generatePreload,
   generateRendererApp,

package/dist/codegen/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/codegen/index.ts"],"sourcesContent":["export { generatePreload } from './preload_generator.cjs';\nexport { generateTypes } from './type_generator.cjs';\nexport { generateTestMock } from './test_mock_generator.cjs';\nexport { generateControllerRegistration } from './controller_registration_generator.cjs';\nexport type { ControllerRegistrationOptions } from './controller_registration_generator.cjs';\nexport { generateRuntime } from './runtime_generator.cjs';\nexport type { RuntimeGeneratorOptions } from './runtime_generator.cjs';\nexport { generateRendererViewManifest } from './renderer_view_manifest_generator.cjs';\nexport type { RendererViewManifestGeneratorOptions } from './renderer_view_manifest_generator.cjs';\nexport { generateRendererControllerRegistration } from './renderer_controller_registration_generator.cjs';\nexport type { RendererControllerRegistrationOptions } from './renderer_controller_registration_generator.cjs';\nexport { generateRendererApp } from './renderer_app_generator.cjs';\nexport type { RendererAppGeneratorOptions } from './renderer_app_generator.cjs';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,+BAAgC;AAChC,4BAA8B;AAC9B,iCAAiC;AACjC,+CAA+C;AAE/C,+BAAgC;AAEhC,8CAA6C;AAE7C,wDAAuD;AAEvD,oCAAoC;","names":[]}
+{"version":3,"sources":["../../src/codegen/index.ts"],"sourcesContent":["export { generatePreload } from './preload_generator.cjs';\nexport { generateTypes } from './type_generator.cjs';\nexport { generateChannelMap } from './channel_map_generator.cjs';\nexport { generateTestMock } from './test_mock_generator.cjs';\nexport { generateControllerRegistration } from './controller_registration_generator.cjs';\nexport type { ControllerRegistrationOptions } from './controller_registration_generator.cjs';\nexport { generateRuntime } from './runtime_generator.cjs';\nexport type { RuntimeGeneratorOptions } from './runtime_generator.cjs';\nexport { generateRendererViewManifest } from './renderer_view_manifest_generator.cjs';\nexport type { RendererViewManifestGeneratorOptions } from './renderer_view_manifest_generator.cjs';\nexport { generateRendererControllerRegistration } from './renderer_controller_registration_generator.cjs';\nexport type { RendererControllerRegistrationOptions } from './renderer_controller_registration_generator.cjs';\nexport { generateRendererApp } from './renderer_app_generator.cjs';\nexport type { RendererAppGeneratorOptions } from './renderer_app_generator.cjs';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,+BAAgC;AAChC,4BAA8B;AAC9B,mCAAmC;AACnC,iCAAiC;AACjC,+CAA+C;AAE/C,+BAAgC;AAEhC,8CAA6C;AAE7C,wDAAuD;AAEvD,oCAAoC;","names":[]}

package/dist/codegen/index.d.cts

@@ -1,5 +1,6 @@
 export { generatePreload } from './preload_generator.cjs';
 export { generateTypes } from './type_generator.cjs';
+export { generateChannelMap } from './channel_map_generator.cjs';
 export { generateTestMock } from './test_mock_generator.cjs';
 export { ControllerRegistrationOptions, generateControllerRegistration } from './controller_registration_generator.cjs';
 export { RuntimeGeneratorOptions, generateRuntime } from './runtime_generator.cjs';

package/dist/codegen/index.d.ts

@@ -1,5 +1,6 @@
 export { generatePreload } from './preload_generator.js';
 export { generateTypes } from './type_generator.js';
+export { generateChannelMap } from './channel_map_generator.js';
 export { generateTestMock } from './test_mock_generator.js';
 export { ControllerRegistrationOptions, generateControllerRegistration } from './controller_registration_generator.js';
 export { RuntimeGeneratorOptions, generateRuntime } from './runtime_generator.js';

package/dist/codegen/index.js

@@ -1,5 +1,6 @@
 import { generatePreload } from "./preload_generator.js";
 import { generateTypes } from "./type_generator.js";
+import { generateChannelMap } from "./channel_map_generator.js";
 import { generateTestMock } from "./test_mock_generator.js";
 import { generateControllerRegistration } from "./controller_registration_generator.js";
 import { generateRuntime } from "./runtime_generator.js";
@@ -7,6 +8,7 @@ import { generateRendererViewManifest } from "./renderer_view_manifest_generator
 import { generateRendererControllerRegistration } from "./renderer_controller_registration_generator.js";
 import { generateRendererApp } from "./renderer_app_generator.js";
 export {
+  generateChannelMap,
   generateControllerRegistration,
   generatePreload,
   generateRendererApp,

package/dist/codegen/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/codegen/index.ts"],"sourcesContent":["export { generatePreload } from './preload_generator.js';\nexport { generateTypes } from './type_generator.js';\nexport { generateTestMock } from './test_mock_generator.js';\nexport { generateControllerRegistration } from './controller_registration_generator.js';\nexport type { ControllerRegistrationOptions } from './controller_registration_generator.js';\nexport { generateRuntime } from './runtime_generator.js';\nexport type { RuntimeGeneratorOptions } from './runtime_generator.js';\nexport { generateRendererViewManifest } from './renderer_view_manifest_generator.js';\nexport type { RendererViewManifestGeneratorOptions } from './renderer_view_manifest_generator.js';\nexport { generateRendererControllerRegistration } from './renderer_controller_registration_generator.js';\nexport type { RendererControllerRegistrationOptions } from './renderer_controller_registration_generator.js';\nexport { generateRendererApp } from './renderer_app_generator.js';\nexport type { RendererAppGeneratorOptions } from './renderer_app_generator.js';\n"],"mappings":"AAAA,SAAS,uBAAuB;AAChC,SAAS,qBAAqB;AAC9B,SAAS,wBAAwB;AACjC,SAAS,sCAAsC;AAE/C,SAAS,uBAAuB;AAEhC,SAAS,oCAAoC;AAE7C,SAAS,8CAA8C;AAEvD,SAAS,2BAA2B;","names":[]}
+{"version":3,"sources":["../../src/codegen/index.ts"],"sourcesContent":["export { generatePreload } from './preload_generator.js';\nexport { generateTypes } from './type_generator.js';\nexport { generateChannelMap } from './channel_map_generator.js';\nexport { generateTestMock } from './test_mock_generator.js';\nexport { generateControllerRegistration } from './controller_registration_generator.js';\nexport type { ControllerRegistrationOptions } from './controller_registration_generator.js';\nexport { generateRuntime } from './runtime_generator.js';\nexport type { RuntimeGeneratorOptions } from './runtime_generator.js';\nexport { generateRendererViewManifest } from './renderer_view_manifest_generator.js';\nexport type { RendererViewManifestGeneratorOptions } from './renderer_view_manifest_generator.js';\nexport { generateRendererControllerRegistration } from './renderer_controller_registration_generator.js';\nexport type { RendererControllerRegistrationOptions } from './renderer_controller_registration_generator.js';\nexport { generateRendererApp } from './renderer_app_generator.js';\nexport type { RendererAppGeneratorOptions } from './renderer_app_generator.js';\n"],"mappings":"AAAA,SAAS,uBAAuB;AAChC,SAAS,qBAAqB;AAC9B,SAAS,0BAA0B;AACnC,SAAS,wBAAwB;AACjC,SAAS,sCAAsC;AAE/C,SAAS,uBAAuB;AAEhC,SAAS,oCAAoC;AAE7C,SAAS,8CAA8C;AAEvD,SAAS,2BAA2B;","names":[]}

package/dist/codegen/preload_generator.cjs

@@ -21,6 +21,11 @@ __export(preload_generator_exports, {
   generatePreload: () => generatePreload
 });
 module.exports = __toCommonJS(preload_generator_exports);
+var import_generated_file_notice = require("./generated_file_notice.cjs");
+const PRELOAD_SOURCE_INSTRUCTIONS = [
+  "To change IPC channels or preload bridge methods, edit the operations YAML configured by",
+  "wood.config.yml main.openapi and regenerate with `wood dev` or `wood build`."
+];
 function operationHasInput(op) {
   return Boolean(
     op.inputSchema && op.inputSchema.type === "object" && Object.keys(op.inputSchema.properties ?? {}).length > 0
@@ -82,8 +87,15 @@ function generatePreload(operations) {
   const tree = buildNestedTree(operations);
   const operationsCode = generateTreeCode(tree);
   const rpcManifestCode = generateRpcManifestCode(operations);
-  return `// AUTO-GENERATED by @noego/wood -- do not edit
+  return `${(0, import_generated_file_notice.generatedFileNotice)(PRELOAD_SOURCE_INSTRUCTIONS)}
 import { contextBridge, ipcRenderer } from 'electron';
+import {
+  RendererTraceBatchTransport,
+  type WoodRendererTraceInput,
+  type WoodTraceBatch,
+  type WoodTraceBatchAcknowledgement,
+  type WoodTraceBatchPort,
+} from '@noego/wood/trace-transport';
 
 ${rpcManifestCode}
 
@@ -152,6 +164,8 @@ ${operationsCode}
 // Trace transport via MessagePort (activated when main process sends a port)
 let __tracePort: MessagePort | null = null;
 const __traceBuffer: unknown[] = [];
+const __TRACE_BUFFER_CAPACITY = 256;
+let __traceDroppedCapacity = 0;
 
 function __traceFlush(): void {
   while (__traceBuffer.length > 0 && __tracePort) {
@@ -169,10 +183,92 @@ contextBridge.exposeInMainWorld('__NOEGO_TRACE__', {
   send: (data: unknown) => {
     if (__tracePort) {
       __tracePort.postMessage(data);
+    } else if (__traceBuffer.length >= __TRACE_BUFFER_CAPACITY) {
+      __traceDroppedCapacity += 1;
     } else {
       __traceBuffer.push(data);
     }
   },
+  status: () => ({
+    queuedEvents: __traceBuffer.length,
+    droppedCapacity: __traceDroppedCapacity,
+  }),
+});
+
+const __traceBatchProducerId = typeof globalThis.crypto?.randomUUID === 'function'
+  ? globalThis.crypto.randomUUID()
+  : \`wood-renderer-\${Date.now()}-\${Math.random().toString(16).slice(2)}\`;
+let __traceBatchListener: ((message: unknown) => void) | null = null;
+
+const __traceBatchPort: WoodTraceBatchPort = {
+  postMessage: (batch: WoodTraceBatch) => {
+    void ipcRenderer.invoke('__traceBatch', batch)
+      .then((acknowledgement: WoodTraceBatchAcknowledgement) => {
+        __traceBatchListener?.(acknowledgement);
+      })
+      .catch((error: unknown) => {
+        __traceBatchListener?.({
+          kind: 'retryable',
+          batchId: batch.batchId,
+          reason: error instanceof Error ? error.message : String(error),
+          retryAfterMs: 100,
+        });
+      });
+  },
+  subscribe: (listener: (message: unknown) => void) => {
+    __traceBatchListener = listener;
+    return () => {
+      if (__traceBatchListener === listener) {
+        __traceBatchListener = null;
+      }
+    };
+  },
+  close: () => {
+    __traceBatchListener = null;
+  },
+};
+
+const __traceBatchTransport = new RendererTraceBatchTransport({
+  producerId: __traceBatchProducerId,
+  maxQueuedEvents: 256,
+  maxBatchEvents: 32,
+  acknowledgementTimeoutMs: 1_000,
+  retryLimit: 3,
+  retryBaseDelayMs: 25,
+  now: () => Date.now(),
+  schedule: (work: () => void) => queueMicrotask(work),
+  delay: (durationMs: number) => new Promise((resolve) => setTimeout(resolve, durationMs)),
+});
+__traceBatchTransport.attachPort(__traceBatchPort);
+
+contextBridge.exposeInMainWorld('__NOEGO_WOOD_TRACE_BATCH__', {
+  send: (event: WoodRendererTraceInput) => __traceBatchTransport.admit(event),
+  status: () => __traceBatchTransport.status(),
+  flush: (deadlineMs: number) => __traceBatchTransport.flush(deadlineMs),
+  close: (deadlineMs: number) => __traceBatchTransport.close(deadlineMs),
+});
+
+ipcRenderer.on('__woodTraceDrainRequest', (_event, payload: unknown) => {
+  if (typeof payload !== 'object' || payload === null || Array.isArray(payload)) {
+    return;
+  }
+  const requestId = Reflect.get(payload, 'requestId');
+  const deadlineMs = Reflect.get(payload, 'deadlineMs');
+  if (typeof requestId !== 'string'
+    || typeof deadlineMs !== 'number'
+    || !Number.isFinite(deadlineMs)) {
+    return;
+  }
+  void __traceBatchTransport.close(deadlineMs).finally(() => {
+    ipcRenderer.send('__woodTraceDrainAck', {
+      requestId,
+      status: __traceBatchTransport.status(),
+    });
+  });
+});
+
+globalThis.addEventListener?.('pagehide', () => {
+  void __traceBatchTransport.flush(Date.now() + 100);
 });
 `;
 }