@noego/wood 0.4.9 → 0.5.0

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;