@noego/wood 0.4.10 → 0.5.0

package/dist/types/config.d.cts

@@ -13,6 +13,7 @@ interface WoodConfig {
         middleware: string;
         openapi: string;
         watch: string[];
+        testing?: MainTestingConfig;
     };
     renderer: {
         openapi: string;
@@ -20,6 +21,7 @@ interface WoodConfig {
         controllers: string;
         entry?: string;
         watch?: string[];
+        testing?: RendererTestingConfig;
     };
     windows: Record<string, WindowDef>;
     database?: {
@@ -29,6 +31,50 @@ interface WoodConfig {
     assets?: string[];
     dev?: DevConfig;
     build?: ElectronBuilderConfig;
+    observability?: ObservabilityConfig;
+}
+/**
+ * Test-composition hooks for the main process (`main.testing`). Only the
+ * application can know how its backend composes on a fresh IoC root; the
+ * config names the module so `@noego/wood/testing`'s `testWood(configPath)`
+ * finds it without any test-site wiring.
+ */
+interface MainTestingConfig {
+    /**
+     * Module (config-relative path) whose default export composes the app's
+     * backend on the root the test builder hands it. See `WoodComposeMain`
+     * in `@noego/wood/testing`.
+     */
+    compose?: string;
+}
+/** Test-composition hooks for the renderer (`renderer.testing`). */
+interface RendererTestingConfig {
+    /**
+     * Module (config-relative path) whose default export mounts a page's real
+     * component for a controller under a DOM driver. See `WoodPageHost` in
+     * `@noego/wood/testing`.
+     */
+    host?: string;
+}
+/**
+ * Renderer→main IPC trace batching policy. Owned here (wood.config.yml) per
+ * the NoEgo observability architecture: the generated preload embeds the
+ * resolved values but is not the configuration owner, and changing this policy
+ * never changes instrumentation call sites or record semantics.
+ */
+interface RendererTraceBatchingConfig {
+    maxQueuedEvents: number;
+    maxBatchEvents: number;
+    acknowledgementTimeoutMs: number;
+    retryLimit: number;
+    retryBaseDelayMs: number;
+}
+interface ObservabilityConfig {
+    trace?: {
+        rendererToMain?: {
+            batching?: RendererTraceBatchingConfig;
+        };
+    };
 }
 /** BrowserWindow definition from the `windows` section of wood.config.yml */
 interface WindowDef {
@@ -83,4 +129,4 @@ interface ElectronBuilderConfig {
     [key: string]: unknown;
 }
 
-export type { DevConfig, ElectronBuilderConfig, WindowDef, WoodConfig };
+export type { DevConfig, ElectronBuilderConfig, MainTestingConfig, ObservabilityConfig, RendererTestingConfig, RendererTraceBatchingConfig, WindowDef, WoodConfig };

package/dist/types/config.d.ts

@@ -13,6 +13,7 @@ interface WoodConfig {
         middleware: string;
         openapi: string;
         watch: string[];
+        testing?: MainTestingConfig;
     };
     renderer: {
         openapi: string;
@@ -20,6 +21,7 @@ interface WoodConfig {
         controllers: string;
         entry?: string;
         watch?: string[];
+        testing?: RendererTestingConfig;
     };
     windows: Record<string, WindowDef>;
     database?: {
@@ -29,6 +31,50 @@ interface WoodConfig {
     assets?: string[];
     dev?: DevConfig;
     build?: ElectronBuilderConfig;
+    observability?: ObservabilityConfig;
+}
+/**
+ * Test-composition hooks for the main process (`main.testing`). Only the
+ * application can know how its backend composes on a fresh IoC root; the
+ * config names the module so `@noego/wood/testing`'s `testWood(configPath)`
+ * finds it without any test-site wiring.
+ */
+interface MainTestingConfig {
+    /**
+     * Module (config-relative path) whose default export composes the app's
+     * backend on the root the test builder hands it. See `WoodComposeMain`
+     * in `@noego/wood/testing`.
+     */
+    compose?: string;
+}
+/** Test-composition hooks for the renderer (`renderer.testing`). */
+interface RendererTestingConfig {
+    /**
+     * Module (config-relative path) whose default export mounts a page's real
+     * component for a controller under a DOM driver. See `WoodPageHost` in
+     * `@noego/wood/testing`.
+     */
+    host?: string;
+}
+/**
+ * Renderer→main IPC trace batching policy. Owned here (wood.config.yml) per
+ * the NoEgo observability architecture: the generated preload embeds the
+ * resolved values but is not the configuration owner, and changing this policy
+ * never changes instrumentation call sites or record semantics.
+ */
+interface RendererTraceBatchingConfig {
+    maxQueuedEvents: number;
+    maxBatchEvents: number;
+    acknowledgementTimeoutMs: number;
+    retryLimit: number;
+    retryBaseDelayMs: number;
+}
+interface ObservabilityConfig {
+    trace?: {
+        rendererToMain?: {
+            batching?: RendererTraceBatchingConfig;
+        };
+    };
 }
 /** BrowserWindow definition from the `windows` section of wood.config.yml */
 interface WindowDef {
@@ -83,4 +129,4 @@ interface ElectronBuilderConfig {
     [key: string]: unknown;
 }
 
-export type { DevConfig, ElectronBuilderConfig, WindowDef, WoodConfig };
+export type { DevConfig, ElectronBuilderConfig, MainTestingConfig, ObservabilityConfig, RendererTestingConfig, RendererTraceBatchingConfig, WindowDef, WoodConfig };

package/dist/types/context.cjs

@@ -3,6 +3,10 @@ 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))
@@ -13,5 +17,13 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var context_exports = {};
+__export(context_exports, {
+  WOOD_CONTEXT_OPERATION: () => WOOD_CONTEXT_OPERATION
+});
 module.exports = __toCommonJS(context_exports);
+const WOOD_CONTEXT_OPERATION = "operation";
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  WOOD_CONTEXT_OPERATION
+});
 //# sourceMappingURL=context.cjs.map

package/dist/types/context.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/context.ts"],"sourcesContent":["/** Types for IPC context, middleware, loaders, and controller arguments */\n\n/** Raw IPC context constructed from an incoming IPC invoke */\nexport interface IpcContext {\n  body: unknown;\n  params: Record<string, string>;\n  query: Record<string, string>;\n  context: Record<string, unknown>;\n  sender?: unknown;\n  windowId?: string;\n}\n\n/** Context object passed to Wood middleware functions */\nexport interface WoodMiddlewareContext {\n  body: unknown;\n  params: Record<string, string>;\n  query: Record<string, string>;\n  context: Record<string, unknown>;\n  sender?: unknown;\n  windowId?: string;\n  operationName: string;\n\n  /** Set a value on context (shorthand for context[key] = value) */\n  set(key: string, value: unknown): void;\n\n  /** Get a value from context */\n  get<T>(key: string): T | undefined;\n\n  /** Access the app's session store */\n  getSession(): unknown;\n}\n\n/** Signature for a Wood middleware function */\nexport type WoodMiddlewareFn = (context: WoodMiddlewareContext) => void | Promise<void>;\n\n/** Request data passed to loaders (compatible with Forge's RequestData shape) */\nexport interface RequestData {\n  url: string;\n  params: Record<string, string>;\n  query: Record<string, string>;\n  context: Record<string, unknown>;\n  headers: Record<string, string>;\n  body?: unknown;\n}\n\n/** Arguments passed to controller action methods */\nexport interface ControllerArgs {\n  req: {\n    body: unknown;\n    params: Record<string, string>;\n    query: Record<string, string>;\n    context: Record<string, unknown>;\n    headers: Record<string, string>;\n  };\n  res: {\n    status(code: number): void;\n    cookie(name: string, value: string, opts?: unknown): void;\n    clearCookie(name: string, opts?: unknown): void;\n    set(header: string, value: string): void;\n  };\n  container: unknown;\n}\n\n/** Result returned from loader orchestration (layout + view data) */\nexport interface LoaderResult {\n  layoutData: unknown[];\n  viewData: unknown;\n}\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}
+{"version":3,"sources":["../../src/types/context.ts"],"sourcesContent":["/** Types for IPC context, middleware, loaders, and controller arguments */\n\n/** Raw IPC context constructed from an incoming IPC invoke */\nexport interface IpcContext {\n  body: unknown;\n  params: Record<string, string>;\n  query: Record<string, string>;\n  context: Record<string, unknown>;\n  sender?: unknown;\n  windowId?: string;\n}\n\n/** Context object passed to Wood middleware functions */\nexport interface WoodMiddlewareContext {\n  body: unknown;\n  params: Record<string, string>;\n  query: Record<string, string>;\n  context: Record<string, unknown>;\n  sender?: unknown;\n  windowId?: string;\n  operationName: string;\n\n  /** Set a value on context (shorthand for context[key] = value) */\n  set(key: string, value: unknown): void;\n\n  /** Get a value from context */\n  get<T>(key: string): T | undefined;\n\n  /** Access the app's session store */\n  getSession(): unknown;\n}\n\n/** Signature for a Wood middleware function */\nexport type WoodMiddlewareFn = (context: WoodMiddlewareContext) => void | Promise<void>;\n\n/** Request data passed to loaders (compatible with Forge's RequestData shape) */\nexport interface RequestData {\n  url: string;\n  params: Record<string, string>;\n  query: Record<string, string>;\n  context: Record<string, unknown>;\n  headers: Record<string, string>;\n  body?: unknown;\n}\n\n/** Arguments passed to controller action methods */\nexport interface ControllerArgs {\n  req: {\n    body: unknown;\n    params: Record<string, string>;\n    query: Record<string, string>;\n    context: Record<string, unknown>;\n    headers: Record<string, string>;\n  };\n  res: {\n    status(code: number): void;\n    cookie(name: string, value: string, opts?: unknown): void;\n    clearCookie(name: string, opts?: unknown): void;\n    set(header: string, value: string): void;\n  };\n  container: unknown;\n}\n\n/**\n * Native Wood operation context — the Desktop-shaped controller boundary.\n *\n * New controllers opt in by declaring `static woodContext = 'operation'`;\n * their actions then receive this single argument instead of the legacy\n * fake-HTTP `ControllerArgs` pair. It represents the operation honestly:\n * validated input, the operation identity, middleware-populated state, and\n * the Desktop sender/window — no fabricated req/res, and no container\n * (dependencies are constructor-injected).\n */\nexport interface WoodOperationContext<Input = unknown> {\n  /** Source-owned operation identity, e.g. `chat.message.send`. */\n  operation: string;\n  /** Schema-validated operation input. */\n  input: Input;\n  /** Middleware-populated per-operation state (same map middleware `set()` writes). */\n  state: Record<string, unknown>;\n  /** Electron sender (WebContents) when dispatched over real IPC. */\n  sender?: unknown;\n  /** Originating window identity when known. */\n  windowId?: string;\n  /** Read a value middleware placed on the operation state. */\n  get<T>(key: string): T | undefined;\n}\n\n/** Marker native controllers declare to receive WoodOperationContext. */\nexport const WOOD_CONTEXT_OPERATION = 'operation' as const;\n\n/** Result returned from loader orchestration (layout + view data) */\nexport interface LoaderResult {\n  layoutData: unknown[];\n  viewData: unknown;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAyFO,MAAM,yBAAyB;","names":[]}

package/dist/types/context.d.cts

@@ -52,10 +52,36 @@ interface ControllerArgs {
     };
     container: unknown;
 }
+/**
+ * Native Wood operation context — the Desktop-shaped controller boundary.
+ *
+ * New controllers opt in by declaring `static woodContext = 'operation'`;
+ * their actions then receive this single argument instead of the legacy
+ * fake-HTTP `ControllerArgs` pair. It represents the operation honestly:
+ * validated input, the operation identity, middleware-populated state, and
+ * the Desktop sender/window — no fabricated req/res, and no container
+ * (dependencies are constructor-injected).
+ */
+interface WoodOperationContext<Input = unknown> {
+    /** Source-owned operation identity, e.g. `chat.message.send`. */
+    operation: string;
+    /** Schema-validated operation input. */
+    input: Input;
+    /** Middleware-populated per-operation state (same map middleware `set()` writes). */
+    state: Record<string, unknown>;
+    /** Electron sender (WebContents) when dispatched over real IPC. */
+    sender?: unknown;
+    /** Originating window identity when known. */
+    windowId?: string;
+    /** Read a value middleware placed on the operation state. */
+    get<T>(key: string): T | undefined;
+}
+/** Marker native controllers declare to receive WoodOperationContext. */
+declare const WOOD_CONTEXT_OPERATION: "operation";
 /** Result returned from loader orchestration (layout + view data) */
 interface LoaderResult {
     layoutData: unknown[];
     viewData: unknown;
 }
 
-export type { ControllerArgs, IpcContext, LoaderResult, RequestData, WoodMiddlewareContext, WoodMiddlewareFn };
+export { type ControllerArgs, type IpcContext, type LoaderResult, type RequestData, WOOD_CONTEXT_OPERATION, type WoodMiddlewareContext, type WoodMiddlewareFn, type WoodOperationContext };

package/dist/types/context.d.ts

@@ -52,10 +52,36 @@ interface ControllerArgs {
     };
     container: unknown;
 }
+/**
+ * Native Wood operation context — the Desktop-shaped controller boundary.
+ *
+ * New controllers opt in by declaring `static woodContext = 'operation'`;
+ * their actions then receive this single argument instead of the legacy
+ * fake-HTTP `ControllerArgs` pair. It represents the operation honestly:
+ * validated input, the operation identity, middleware-populated state, and
+ * the Desktop sender/window — no fabricated req/res, and no container
+ * (dependencies are constructor-injected).
+ */
+interface WoodOperationContext<Input = unknown> {
+    /** Source-owned operation identity, e.g. `chat.message.send`. */
+    operation: string;
+    /** Schema-validated operation input. */
+    input: Input;
+    /** Middleware-populated per-operation state (same map middleware `set()` writes). */
+    state: Record<string, unknown>;
+    /** Electron sender (WebContents) when dispatched over real IPC. */
+    sender?: unknown;
+    /** Originating window identity when known. */
+    windowId?: string;
+    /** Read a value middleware placed on the operation state. */
+    get<T>(key: string): T | undefined;
+}
+/** Marker native controllers declare to receive WoodOperationContext. */
+declare const WOOD_CONTEXT_OPERATION: "operation";
 /** Result returned from loader orchestration (layout + view data) */
 interface LoaderResult {
     layoutData: unknown[];
     viewData: unknown;
 }
 
-export type { ControllerArgs, IpcContext, LoaderResult, RequestData, WoodMiddlewareContext, WoodMiddlewareFn };
+export { type ControllerArgs, type IpcContext, type LoaderResult, type RequestData, WOOD_CONTEXT_OPERATION, type WoodMiddlewareContext, type WoodMiddlewareFn, type WoodOperationContext };

package/dist/types/context.js

@@ -1 +1,5 @@
+const WOOD_CONTEXT_OPERATION = "operation";
+export {
+  WOOD_CONTEXT_OPERATION
+};
 //# sourceMappingURL=context.js.map

package/dist/types/context.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
+{"version":3,"sources":["../../src/types/context.ts"],"sourcesContent":["/** Types for IPC context, middleware, loaders, and controller arguments */\n\n/** Raw IPC context constructed from an incoming IPC invoke */\nexport interface IpcContext {\n  body: unknown;\n  params: Record<string, string>;\n  query: Record<string, string>;\n  context: Record<string, unknown>;\n  sender?: unknown;\n  windowId?: string;\n}\n\n/** Context object passed to Wood middleware functions */\nexport interface WoodMiddlewareContext {\n  body: unknown;\n  params: Record<string, string>;\n  query: Record<string, string>;\n  context: Record<string, unknown>;\n  sender?: unknown;\n  windowId?: string;\n  operationName: string;\n\n  /** Set a value on context (shorthand for context[key] = value) */\n  set(key: string, value: unknown): void;\n\n  /** Get a value from context */\n  get<T>(key: string): T | undefined;\n\n  /** Access the app's session store */\n  getSession(): unknown;\n}\n\n/** Signature for a Wood middleware function */\nexport type WoodMiddlewareFn = (context: WoodMiddlewareContext) => void | Promise<void>;\n\n/** Request data passed to loaders (compatible with Forge's RequestData shape) */\nexport interface RequestData {\n  url: string;\n  params: Record<string, string>;\n  query: Record<string, string>;\n  context: Record<string, unknown>;\n  headers: Record<string, string>;\n  body?: unknown;\n}\n\n/** Arguments passed to controller action methods */\nexport interface ControllerArgs {\n  req: {\n    body: unknown;\n    params: Record<string, string>;\n    query: Record<string, string>;\n    context: Record<string, unknown>;\n    headers: Record<string, string>;\n  };\n  res: {\n    status(code: number): void;\n    cookie(name: string, value: string, opts?: unknown): void;\n    clearCookie(name: string, opts?: unknown): void;\n    set(header: string, value: string): void;\n  };\n  container: unknown;\n}\n\n/**\n * Native Wood operation context — the Desktop-shaped controller boundary.\n *\n * New controllers opt in by declaring `static woodContext = 'operation'`;\n * their actions then receive this single argument instead of the legacy\n * fake-HTTP `ControllerArgs` pair. It represents the operation honestly:\n * validated input, the operation identity, middleware-populated state, and\n * the Desktop sender/window — no fabricated req/res, and no container\n * (dependencies are constructor-injected).\n */\nexport interface WoodOperationContext<Input = unknown> {\n  /** Source-owned operation identity, e.g. `chat.message.send`. */\n  operation: string;\n  /** Schema-validated operation input. */\n  input: Input;\n  /** Middleware-populated per-operation state (same map middleware `set()` writes). */\n  state: Record<string, unknown>;\n  /** Electron sender (WebContents) when dispatched over real IPC. */\n  sender?: unknown;\n  /** Originating window identity when known. */\n  windowId?: string;\n  /** Read a value middleware placed on the operation state. */\n  get<T>(key: string): T | undefined;\n}\n\n/** Marker native controllers declare to receive WoodOperationContext. */\nexport const WOOD_CONTEXT_OPERATION = 'operation' as const;\n\n/** Result returned from loader orchestration (layout + view data) */\nexport interface LoaderResult {\n  layoutData: unknown[];\n  viewData: unknown;\n}\n"],"mappings":"AAyFO,MAAM,yBAAyB;","names":[]}

package/dist/types/index.d.cts

@@ -1,6 +1,6 @@
-export { DevConfig, ElectronBuilderConfig, WindowDef, WoodConfig } from './config.cjs';
+export { DevConfig, ElectronBuilderConfig, MainTestingConfig, ObservabilityConfig, RendererTestingConfig, RendererTraceBatchingConfig, WindowDef, WoodConfig } from './config.cjs';
 export { OperationDef, RawModuleDef, RawModuleOperationEntry, RawOperationEntry, RawOperationsDocument } from './operations.cjs';
 export { ParameterDef, RawLayoutConfig, RawLayoutEntry, RawLayoutGroupEntry, RawLayoutObjectEntry, RawViewEntry, RawViewsDocument, ViewDef } from './views.cjs';
-export { ControllerArgs, IpcContext, LoaderResult, RequestData, WoodMiddlewareContext, WoodMiddlewareFn } from './context.cjs';
+export { ControllerArgs, IpcContext, LoaderResult, RequestData, WOOD_CONTEXT_OPERATION, WoodMiddlewareContext, WoodMiddlewareFn, WoodOperationContext } from './context.cjs';
 export { BackendRestartingError, BridgeElectronApi, BridgeMessage, BridgePush, BridgeReady, BridgeRequest, BridgeResponse, SerializedError, WoodAuthError, WoodValidationError } from './bridge.cjs';
 export { ContextMenuContext, ContextMenuEvent, ContextMenuItem } from './context_menu.cjs';

package/dist/types/index.d.ts

@@ -1,6 +1,6 @@
-export { DevConfig, ElectronBuilderConfig, WindowDef, WoodConfig } from './config.js';
+export { DevConfig, ElectronBuilderConfig, MainTestingConfig, ObservabilityConfig, RendererTestingConfig, RendererTraceBatchingConfig, WindowDef, WoodConfig } from './config.js';
 export { OperationDef, RawModuleDef, RawModuleOperationEntry, RawOperationEntry, RawOperationsDocument } from './operations.js';
 export { ParameterDef, RawLayoutConfig, RawLayoutEntry, RawLayoutGroupEntry, RawLayoutObjectEntry, RawViewEntry, RawViewsDocument, ViewDef } from './views.js';
-export { ControllerArgs, IpcContext, LoaderResult, RequestData, WoodMiddlewareContext, WoodMiddlewareFn } from './context.js';
+export { ControllerArgs, IpcContext, LoaderResult, RequestData, WOOD_CONTEXT_OPERATION, WoodMiddlewareContext, WoodMiddlewareFn, WoodOperationContext } from './context.js';
 export { BackendRestartingError, BridgeElectronApi, BridgeMessage, BridgePush, BridgeReady, BridgeRequest, BridgeResponse, SerializedError, WoodAuthError, WoodValidationError } from './bridge.js';
 export { ContextMenuContext, ContextMenuEvent, ContextMenuItem } from './context_menu.js';

package/dist/types/operations.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/operations.ts"],"sourcesContent":["/** Types for operations YAML (backend IPC contract) */\n\n/** Fully resolved operation definition after YAML parsing and module expansion */\nexport interface OperationDef {\n  channel: string;\n  controller: string;\n  action: string;\n  middleware: string[];\n  inputSchema?: Record<string, unknown>;\n  outputSchema?: Record<string, unknown>;\n}\n\n/** Raw operations YAML document before expansion */\nexport interface RawOperationsDocument {\n  operations?: Record<string, RawOperationEntry>;\n  module?: Record<string, RawModuleDef>;\n}\n\n/** A single top-level operation entry in the YAML */\nexport interface RawOperationEntry {\n  controller: string;\n  action: string;\n  middleware?: string[];\n  input?: Record<string, unknown>;\n  output?: Record<string, unknown>;\n}\n\n/** A module grouping operations under a shared namespace and defaults */\nexport interface RawModuleDef {\n  controller?: string;\n  middleware?: string[];\n  operations: Record<string, RawModuleOperationEntry>;\n}\n\n/** An operation entry within a module */\nexport interface RawModuleOperationEntry {\n  action: string;\n  controller?: string;\n  middleware?: string[] | null;\n  input?: Record<string, unknown>;\n  output?: Record<string, unknown>;\n}\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}
+{"version":3,"sources":["../../src/types/operations.ts"],"sourcesContent":["/** Types for operations YAML (backend IPC contract) */\n\n/** Fully resolved operation definition after YAML parsing and module expansion */\nexport interface OperationDef {\n  /** Owning module name for module-declared operations. */\n  module?: string;\n  channel: string;\n  controller: string;\n  action: string;\n  middleware: string[];\n  inputSchema?: Record<string, unknown>;\n  outputSchema?: Record<string, unknown>;\n}\n\n/** Raw operations YAML document before expansion */\nexport interface RawOperationsDocument {\n  operations?: Record<string, RawOperationEntry>;\n  module?: Record<string, RawModuleDef>;\n}\n\n/** A single top-level operation entry in the YAML */\nexport interface RawOperationEntry {\n  controller: string;\n  action: string;\n  middleware?: string[];\n  input?: Record<string, unknown>;\n  output?: Record<string, unknown>;\n}\n\n/** A module grouping operations under a shared namespace and defaults */\nexport interface RawModuleDef {\n  controller?: string;\n  middleware?: string[];\n  operations: Record<string, RawModuleOperationEntry>;\n}\n\n/** An operation entry within a module */\nexport interface RawModuleOperationEntry {\n  action: string;\n  controller?: string;\n  middleware?: string[] | null;\n  input?: Record<string, unknown>;\n  output?: Record<string, unknown>;\n}\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/types/operations.d.cts

@@ -1,6 +1,8 @@
 /** Types for operations YAML (backend IPC contract) */
 /** Fully resolved operation definition after YAML parsing and module expansion */
 interface OperationDef {
+    /** Owning module name for module-declared operations. */
+    module?: string;
     channel: string;
     controller: string;
     action: string;

package/dist/types/operations.d.ts

@@ -1,6 +1,8 @@
 /** Types for operations YAML (backend IPC contract) */
 /** Fully resolved operation definition after YAML parsing and module expansion */
 interface OperationDef {
+    /** Owning module name for module-declared operations. */
+    module?: string;
     channel: string;
     controller: string;
     action: string;