@noego/wood 0.4.5 → 0.4.7

package/dist/router/wood_router.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/router/wood_router.ts"],"sourcesContent":["import type { OperationDef, IpcContext, WoodMiddlewareContext } from '../types/index.cjs';\nimport { WoodValidationError } from '../types/index.cjs';\nimport { SchemaValidator } from '../validation/schema_validator.cjs';\nimport { MiddlewareResolver } from '../middleware/middleware_resolver.cjs';\nimport { buildMiddlewareContext, executeMiddleware } from '../middleware/middleware_pipeline.cjs';\nimport { ControllerResolver, buildControllerArgs } from '../controller/controller_resolver.cjs';\nimport { disposeControllerLifecycle } from '../controller/controller_lifecycle.cjs';\nimport { getLogger } from '@noego/logger';\nimport { publishMainTrace } from '../tracing/index.js';\n\nconst logger = getLogger('wood:router');\n\nfunction extractTraceConversationId(value: unknown): number | string | undefined {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) {\n    return undefined;\n  }\n\n  const record = value as Record<string, unknown>;\n  if (typeof record.conversationId === 'number' || typeof record.conversationId === 'string') {\n    return record.conversationId;\n  }\n  if (typeof record.threadId === 'number' || typeof record.threadId === 'string') {\n    return record.threadId;\n  }\n\n  return undefined;\n}\n\n/** Reserved internal channels prefixed with __ to avoid collisions with user operations. */\nexport const RESERVED_CHANNELS = ['__load', '__navigate', '__window', '__debug', '__contextMenu', '__woodConfig'] as const;\nexport type ReservedChannel = (typeof RESERVED_CHANNELS)[number];\n\n/** Handler signature for reserved channels. */\nexport type ReservedChannelHandler = (data: unknown, event?: any) => Promise<unknown>;\n\nexport class WoodRouter {\n  private operations = new Map<string, OperationDef>();\n  private reservedHandlers = new Map<ReservedChannel, ReservedChannelHandler>();\n  private validator: SchemaValidator;\n  private middlewareResolver: MiddlewareResolver;\n  private controllerResolver: ControllerResolver;\n  private container: any; // IoC Container\n\n  constructor(options: {\n    container: any;\n    controllersDir: string;\n    middlewareDir: string;\n    mode?: 'bundled' | 'dev';\n  }) {\n    this.container = options.container;\n    this.validator = new SchemaValidator();\n    this.middlewareResolver = new MiddlewareResolver(options.middlewareDir);\n    this.controllerResolver = new ControllerResolver(options.controllersDir, {\n      mode: options.mode,\n    });\n  }\n\n  /**\n   * Load operations from a parsed operations map.\n   */\n  loadOperations(operations: Map<string, OperationDef>): void {\n    for (const [channel, opDef] of operations) {\n      this.operations.set(channel, opDef);\n    }\n    logger.debug(`Loaded ${operations.size} operations`);\n  }\n\n  /**\n   * Register a handler for a reserved channel (__load, __navigate, __window).\n   * These channels are internal to Wood and serve as extension points for\n   * the loader runner, navigation system, and window manager.\n   */\n  registerReservedHandler(channel: ReservedChannel, handler: ReservedChannelHandler): void {\n    this.reservedHandlers.set(channel, handler);\n    logger.debug(`Registered reserved handler for \"${channel}\"`);\n  }\n\n  /**\n   * Register IPC handlers for all operations and reserved channels.\n   * In production: registers with ipcMain.handle\n   * In testing/bridge mode: handlers are callable via dispatch()\n   */\n  registerIpcHandlers(ipcMain: any): void {\n    for (const channel of this.operations.keys()) {\n      ipcMain.handle(channel, async (_event: any, data: unknown) => {\n        return this.dispatch(channel, data, _event);\n      });\n    }\n\n    // Register reserved channels\n    for (const channel of RESERVED_CHANNELS) {\n      ipcMain.handle(channel, async (_event: any, data: unknown) => {\n        const handler = this.reservedHandlers.get(channel);\n        if (!handler) {\n          throw new Error(`No handler registered for reserved channel \"${channel}\"`);\n        }\n        return handler(data, _event);\n      });\n    }\n\n    logger.debug(\n      `Registered ${this.operations.size} operation handlers and ${RESERVED_CHANNELS.length} reserved channels`\n    );\n  }\n\n  /**\n   * The request lifecycle -- mirrors Dinner's pipeline.\n   *\n   * channel -> build context -> middleware -> validate -> resolve controller\n   * -> create instance -> build args -> call action -> return result\n   */\n  async dispatch(channel: string, data: unknown, event?: any): Promise<unknown> {\n    const opDef = this.operations.get(channel);\n    if (!opDef) {\n      throw new Error(`Unknown operation: \"${channel}\"`);\n    }\n\n    const conversationId = extractTraceConversationId(data);\n    publishMainTrace('debug', {\n      source: 'wood.router',\n      type: 'dispatch.start',\n      ...(conversationId !== undefined ? { conversationId } : {}),\n      payload: {\n        channel,\n        controller: opDef.controller,\n        action: opDef.action,\n      },\n    });\n\n    // 1. Build IPC context\n    const ipcContext: IpcContext = {\n      body: data ?? {},\n      params: (data as any) ?? {},\n      query: {},\n      context: {},\n      sender: event?.sender,\n      windowId: undefined,\n    };\n\n    // 2. Execute middleware sequentially\n    if (opDef.middleware.length > 0) {\n      const mwContext = buildMiddlewareContext(ipcContext, channel);\n      const middlewareFns = await Promise.all(\n        opDef.middleware.map(spec => this.middlewareResolver.resolve(spec))\n      );\n      await executeMiddleware(middlewareFns, mwContext);\n    }\n\n    // 3. Validate input (if schema defined)\n    if (opDef.inputSchema) {\n      const result = this.validator.validate(\n        channel,\n        opDef.inputSchema as Record<string, unknown>,\n        ipcContext.body\n      );\n      if (!result.valid) {\n        publishMainTrace('error', {\n          source: 'wood.router',\n          type: 'dispatch.validation_error',\n          message: 'Request validation failed',\n          ...(conversationId !== undefined ? { conversationId } : {}),\n          payload: {\n            channel,\n            controller: opDef.controller,\n            action: opDef.action,\n            errorCount: result.errors?.length ?? 0,\n          },\n        });\n        throw new WoodValidationError('Request validation failed', result.errors ?? []);\n      }\n    }\n\n    // 4. Resolve controller class (cached)\n    const ControllerClass = await this.controllerResolver.resolveClass(opDef.controller);\n\n    // 5. Create instance via IoC (per-request scoped container)\n    const scopedContainer = this.container.extend();\n    const instance = await scopedContainer.instance(ControllerClass);\n\n    // 6. Build controller args (fake req/res)\n    const args = buildControllerArgs(ipcContext, scopedContainer);\n\n    // 7. Call action, always dispose controller afterward\n    const action = instance[opDef.action];\n    let result: unknown;\n    let actionError: unknown;\n\n    try {\n      if (typeof action !== 'function') {\n        throw new Error(\n          `Controller \"${opDef.controller}\" has no action \"${opDef.action}\"`\n        );\n      }\n\n      result = await action.call(instance, args);\n      publishMainTrace('debug', {\n        source: 'wood.router',\n        type: 'dispatch.success',\n        ...(conversationId !== undefined ? { conversationId } : {}),\n        payload: {\n          channel,\n          controller: opDef.controller,\n          action: opDef.action,\n        },\n      });\n    } catch (error) {\n      actionError = error;\n      publishMainTrace('error', {\n        source: 'wood.router',\n        type: 'dispatch.error',\n        message: error instanceof Error ? error.message : String(error),\n        ...(conversationId !== undefined ? { conversationId } : {}),\n        payload: {\n          channel,\n          controller: opDef.controller,\n          action: opDef.action,\n        },\n      });\n    } finally {\n      try {\n        await disposeControllerLifecycle(instance);\n      } catch (disposeError) {\n        publishMainTrace('error', {\n          source: 'wood.router',\n          type: 'dispatch.dispose.error',\n          message: disposeError instanceof Error ? disposeError.message : String(disposeError),\n          ...(conversationId !== undefined ? { conversationId } : {}),\n          payload: {\n            channel,\n            controller: opDef.controller,\n            action: opDef.action,\n          },\n        });\n\n        if (!actionError) {\n          actionError = disposeError;\n        }\n      }\n    }\n\n    if (actionError) {\n      throw actionError;\n    }\n\n    return result;\n  }\n\n  /**\n   * Pre-register a controller class by name so it is resolved from\n   * the in-memory cache instead of the filesystem.\n   * This is the public API used by the generated registration file.\n   */\n  registerController(name: string, ControllerClass: any): void {\n    this.controllerResolver.register(name, ControllerClass);\n  }\n\n  /**\n   * Register an import path for a controller. The controller will be lazily\n   * imported from this path when first needed, avoiding circular dependencies.\n   */\n  registerControllerPath(name: string, importPath: string): void {\n    this.controllerResolver.registerPath(name, importPath);\n  }\n\n  /**\n   * Validate that every controller referenced in loaded operations is\n   * pre-registered in the controller resolver. Call this after\n   * loadOperations() + registerControllers() but before registerIpcHandlers().\n   *\n   * Throws with a clear error listing all missing controllers if any\n   * operation references a controller that was not pre-registered.\n   */\n  validateControllers(): void {\n    const missing: Array<{ channel: string; controller: string }> = [];\n\n    for (const [channel, opDef] of this.operations) {\n      if (!this.controllerResolver.has(opDef.controller)) {\n        missing.push({ channel, controller: opDef.controller });\n      }\n    }\n\n    if (missing.length > 0) {\n      const details = missing\n        .map(m => `  - channel \"${m.channel}\" requires controller \"${m.controller}\"`)\n        .join('\\n');\n\n      throw new Error(\n        `WoodRouter: ${missing.length} operation(s) reference controllers that are not registered.\\n` +\n        `This usually means controllers.generated.ts is missing or out of date.\\n` +\n        `Run \"npx wood build\" or \"npx wood dev\" to regenerate it.\\n\\n` +\n        `Missing controllers:\\n${details}`\n      );\n    }\n\n    logger.info(`All ${this.operations.size} operations have registered controllers`);\n  }\n\n  /**\n   * Eagerly compile every operation's inputSchema so a malformed schema fails\n   * at startup (with the offending channel named) instead of throwing an opaque\n   * ajv error on the first request to that channel. Call after loadOperations().\n   */\n  precompileSchemas(): void {\n    let compiled = 0;\n    for (const [channel, opDef] of this.operations) {\n      if (opDef.inputSchema) {\n        this.validator.precompile(channel, opDef.inputSchema as Record<string, unknown>);\n        compiled += 1;\n      }\n    }\n    logger.info(`Pre-compiled ${compiled} operation input schema(s)`);\n  }\n\n  /** Get all registered operation channels. */\n  getChannels(): string[] {\n    return Array.from(this.operations.keys());\n  }\n\n  /** Get a specific operation definition. */\n  getOperation(channel: string): OperationDef | undefined {\n    return this.operations.get(channel);\n  }\n}\n"],"mappings":"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","names":["result"]}
+{"version":3,"sources":["../../src/router/wood_router.ts"],"sourcesContent":["import type { OperationDef, IpcContext, WoodMiddlewareContext } from '../types/index.cjs';\nimport { WoodValidationError } from '../types/index.cjs';\nimport { SchemaValidator } from '../validation/schema_validator.cjs';\nimport { MiddlewareResolver } from '../middleware/middleware_resolver.cjs';\nimport { buildMiddlewareContext, executeMiddleware } from '../middleware/middleware_pipeline.cjs';\nimport { ControllerResolver, buildControllerArgs } from '../controller/controller_resolver.cjs';\nimport { disposeControllerLifecycle } from '../controller/controller_lifecycle.cjs';\nimport { getLogger } from '@noego/logger';\nimport { publishMainTrace } from '../tracing/index.js';\n\nconst logger = getLogger('wood:router');\n\nfunction extractTraceConversationId(value: unknown): number | string | undefined {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) {\n    return undefined;\n  }\n\n  const record = value as Record<string, unknown>;\n  if (typeof record.conversationId === 'number' || typeof record.conversationId === 'string') {\n    return record.conversationId;\n  }\n  if (typeof record.threadId === 'number' || typeof record.threadId === 'string') {\n    return record.threadId;\n  }\n\n  return undefined;\n}\n\n/** Reserved internal channels prefixed with __ to avoid collisions with user operations. */\nexport const RESERVED_CHANNELS = [\n  '__load',\n  '__navigate',\n  '__window',\n  '__debug',\n  '__contextMenu',\n  '__woodConfig',\n  '__traceBatch',\n] as const;\nexport type ReservedChannel = (typeof RESERVED_CHANNELS)[number];\n\n/** Handler signature for reserved channels. */\nexport type ReservedChannelHandler = (data: unknown, event?: any) => Promise<unknown>;\n\nexport class WoodRouter {\n  private operations = new Map<string, OperationDef>();\n  private reservedHandlers = new Map<ReservedChannel, ReservedChannelHandler>();\n  private validator: SchemaValidator;\n  private middlewareResolver: MiddlewareResolver;\n  private controllerResolver: ControllerResolver;\n  private container: any; // IoC Container\n\n  constructor(options: {\n    container: any;\n    controllersDir: string;\n    middlewareDir: string;\n    mode?: 'bundled' | 'dev';\n  }) {\n    this.container = options.container;\n    this.validator = new SchemaValidator();\n    this.middlewareResolver = new MiddlewareResolver(options.middlewareDir);\n    this.controllerResolver = new ControllerResolver(options.controllersDir, {\n      mode: options.mode,\n    });\n  }\n\n  /**\n   * Load operations from a parsed operations map.\n   */\n  loadOperations(operations: Map<string, OperationDef>): void {\n    for (const [channel, opDef] of operations) {\n      this.operations.set(channel, opDef);\n    }\n    logger.debug(`Loaded ${operations.size} operations`);\n  }\n\n  /**\n   * Register a handler for a reserved channel (__load, __navigate, __window).\n   * These channels are internal to Wood and serve as extension points for\n   * the loader runner, navigation system, and window manager.\n   */\n  registerReservedHandler(channel: ReservedChannel, handler: ReservedChannelHandler): void {\n    this.reservedHandlers.set(channel, handler);\n    logger.debug(`Registered reserved handler for \"${channel}\"`);\n  }\n\n  /**\n   * Register IPC handlers for all operations and reserved channels.\n   * In production: registers with ipcMain.handle\n   * In testing/bridge mode: handlers are callable via dispatch()\n   */\n  registerIpcHandlers(ipcMain: any): void {\n    for (const channel of this.operations.keys()) {\n      ipcMain.handle(channel, async (_event: any, data: unknown) => {\n        return this.dispatch(channel, data, _event);\n      });\n    }\n\n    // Register reserved channels\n    for (const channel of RESERVED_CHANNELS) {\n      ipcMain.handle(channel, async (_event: any, data: unknown) => {\n        const handler = this.reservedHandlers.get(channel);\n        if (!handler) {\n          throw new Error(`No handler registered for reserved channel \"${channel}\"`);\n        }\n        return handler(data, _event);\n      });\n    }\n\n    logger.debug(\n      `Registered ${this.operations.size} operation handlers and ${RESERVED_CHANNELS.length} reserved channels`\n    );\n  }\n\n  /**\n   * The request lifecycle -- mirrors Dinner's pipeline.\n   *\n   * channel -> build context -> middleware -> validate -> resolve controller\n   * -> create instance -> build args -> call action -> return result\n   */\n  async dispatch(channel: string, data: unknown, event?: any): Promise<unknown> {\n    const opDef = this.operations.get(channel);\n    if (!opDef) {\n      throw new Error(`Unknown operation: \"${channel}\"`);\n    }\n\n    const conversationId = extractTraceConversationId(data);\n    publishMainTrace('debug', {\n      source: 'wood.router',\n      type: 'dispatch.start',\n      ...(conversationId !== undefined ? { conversationId } : {}),\n      payload: {\n        channel,\n        controller: opDef.controller,\n        action: opDef.action,\n      },\n    });\n\n    // 1. Build IPC context\n    const ipcContext: IpcContext = {\n      body: data ?? {},\n      params: (data as any) ?? {},\n      query: {},\n      context: {},\n      sender: event?.sender,\n      windowId: undefined,\n    };\n\n    // 2. Execute middleware sequentially\n    if (opDef.middleware.length > 0) {\n      const mwContext = buildMiddlewareContext(ipcContext, channel);\n      const middlewareFns = await Promise.all(\n        opDef.middleware.map(spec => this.middlewareResolver.resolve(spec))\n      );\n      await executeMiddleware(middlewareFns, mwContext);\n    }\n\n    // 3. Validate input (if schema defined)\n    if (opDef.inputSchema) {\n      const result = this.validator.validate(\n        channel,\n        opDef.inputSchema as Record<string, unknown>,\n        ipcContext.body\n      );\n      if (!result.valid) {\n        publishMainTrace('error', {\n          source: 'wood.router',\n          type: 'dispatch.validation_error',\n          message: 'Request validation failed',\n          ...(conversationId !== undefined ? { conversationId } : {}),\n          payload: {\n            channel,\n            controller: opDef.controller,\n            action: opDef.action,\n            errorCount: result.errors?.length ?? 0,\n          },\n        });\n        throw new WoodValidationError('Request validation failed', result.errors ?? []);\n      }\n    }\n\n    // 4. Resolve controller class (cached)\n    const ControllerClass = await this.controllerResolver.resolveClass(opDef.controller);\n\n    // 5. Create instance via IoC (per-request scoped container)\n    const scopedContainer = this.container.extend();\n    const instance = await scopedContainer.instance(ControllerClass);\n\n    // 6. Build controller args (fake req/res)\n    const args = buildControllerArgs(ipcContext, scopedContainer);\n\n    // 7. Call action, always dispose controller afterward\n    const action = instance[opDef.action];\n    let result: unknown;\n    let actionError: unknown;\n\n    try {\n      if (typeof action !== 'function') {\n        throw new Error(\n          `Controller \"${opDef.controller}\" has no action \"${opDef.action}\"`\n        );\n      }\n\n      result = await action.call(instance, args);\n      publishMainTrace('debug', {\n        source: 'wood.router',\n        type: 'dispatch.success',\n        ...(conversationId !== undefined ? { conversationId } : {}),\n        payload: {\n          channel,\n          controller: opDef.controller,\n          action: opDef.action,\n        },\n      });\n    } catch (error) {\n      actionError = error;\n      publishMainTrace('error', {\n        source: 'wood.router',\n        type: 'dispatch.error',\n        message: error instanceof Error ? error.message : String(error),\n        ...(conversationId !== undefined ? { conversationId } : {}),\n        payload: {\n          channel,\n          controller: opDef.controller,\n          action: opDef.action,\n        },\n      });\n    } finally {\n      try {\n        await disposeControllerLifecycle(instance);\n      } catch (disposeError) {\n        publishMainTrace('error', {\n          source: 'wood.router',\n          type: 'dispatch.dispose.error',\n          message: disposeError instanceof Error ? disposeError.message : String(disposeError),\n          ...(conversationId !== undefined ? { conversationId } : {}),\n          payload: {\n            channel,\n            controller: opDef.controller,\n            action: opDef.action,\n          },\n        });\n\n        if (!actionError) {\n          actionError = disposeError;\n        }\n      }\n    }\n\n    if (actionError) {\n      throw actionError;\n    }\n\n    return result;\n  }\n\n  /**\n   * Pre-register a controller class by name so it is resolved from\n   * the in-memory cache instead of the filesystem.\n   * This is the public API used by the generated registration file.\n   */\n  registerController(name: string, ControllerClass: any): void {\n    this.controllerResolver.register(name, ControllerClass);\n  }\n\n  /**\n   * Register an import path for a controller. The controller will be lazily\n   * imported from this path when first needed, avoiding circular dependencies.\n   */\n  registerControllerPath(name: string, importPath: string): void {\n    this.controllerResolver.registerPath(name, importPath);\n  }\n\n  /**\n   * Validate that every controller referenced in loaded operations is\n   * pre-registered in the controller resolver. Call this after\n   * loadOperations() + registerControllers() but before registerIpcHandlers().\n   *\n   * Throws with a clear error listing all missing controllers if any\n   * operation references a controller that was not pre-registered.\n   */\n  validateControllers(): void {\n    const missing: Array<{ channel: string; controller: string }> = [];\n\n    for (const [channel, opDef] of this.operations) {\n      if (!this.controllerResolver.has(opDef.controller)) {\n        missing.push({ channel, controller: opDef.controller });\n      }\n    }\n\n    if (missing.length > 0) {\n      const details = missing\n        .map(m => `  - channel \"${m.channel}\" requires controller \"${m.controller}\"`)\n        .join('\\n');\n\n      throw new Error(\n        `WoodRouter: ${missing.length} operation(s) reference controllers that are not registered.\\n` +\n        `This usually means controllers.generated.ts is missing or out of date.\\n` +\n        `Run \"npx wood build\" or \"npx wood dev\" to regenerate it.\\n\\n` +\n        `Missing controllers:\\n${details}`\n      );\n    }\n\n    logger.info(`All ${this.operations.size} operations have registered controllers`);\n  }\n\n  /**\n   * Eagerly compile every operation's inputSchema so a malformed schema fails\n   * at startup (with the offending channel named) instead of throwing an opaque\n   * ajv error on the first request to that channel. Call after loadOperations().\n   */\n  precompileSchemas(): void {\n    let compiled = 0;\n    for (const [channel, opDef] of this.operations) {\n      if (opDef.inputSchema) {\n        this.validator.precompile(channel, opDef.inputSchema as Record<string, unknown>);\n        compiled += 1;\n      }\n    }\n    logger.info(`Pre-compiled ${compiled} operation input schema(s)`);\n  }\n\n  /** Get all registered operation channels. */\n  getChannels(): string[] {\n    return Array.from(this.operations.keys());\n  }\n\n  /** Get a specific operation definition. */\n  getOperation(channel: string): OperationDef | undefined {\n    return this.operations.get(channel);\n  }\n}\n"],"mappings":"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","names":["result"]}

package/dist/router/wood_router.d.cts

@@ -1,7 +1,7 @@
 import { OperationDef } from '../types/operations.cjs';
 
 /** Reserved internal channels prefixed with __ to avoid collisions with user operations. */
-declare const RESERVED_CHANNELS: readonly ["__load", "__navigate", "__window", "__debug", "__contextMenu", "__woodConfig"];
+declare const RESERVED_CHANNELS: readonly ["__load", "__navigate", "__window", "__debug", "__contextMenu", "__woodConfig", "__traceBatch"];
 type ReservedChannel = (typeof RESERVED_CHANNELS)[number];
 /** Handler signature for reserved channels. */
 type ReservedChannelHandler = (data: unknown, event?: any) => Promise<unknown>;

package/dist/router/wood_router.d.ts

@@ -1,7 +1,7 @@
 import { OperationDef } from '../types/operations.js';
 
 /** Reserved internal channels prefixed with __ to avoid collisions with user operations. */
-declare const RESERVED_CHANNELS: readonly ["__load", "__navigate", "__window", "__debug", "__contextMenu", "__woodConfig"];
+declare const RESERVED_CHANNELS: readonly ["__load", "__navigate", "__window", "__debug", "__contextMenu", "__woodConfig", "__traceBatch"];
 type ReservedChannel = (typeof RESERVED_CHANNELS)[number];
 /** Handler signature for reserved channels. */
 type ReservedChannelHandler = (data: unknown, event?: any) => Promise<unknown>;

package/dist/router/wood_router.js

@@ -20,7 +20,15 @@ function extractTraceConversationId(value) {
   }
   return void 0;
 }
-const RESERVED_CHANNELS = ["__load", "__navigate", "__window", "__debug", "__contextMenu", "__woodConfig"];
+const RESERVED_CHANNELS = [
+  "__load",
+  "__navigate",
+  "__window",
+  "__debug",
+  "__contextMenu",
+  "__woodConfig",
+  "__traceBatch"
+];
 class WoodRouter {
   // IoC Container
   constructor(options) {

package/dist/router/wood_router.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/router/wood_router.ts"],"sourcesContent":["import type { OperationDef, IpcContext, WoodMiddlewareContext } from '../types/index.js';\nimport { WoodValidationError } from '../types/index.js';\nimport { SchemaValidator } from '../validation/schema_validator.js';\nimport { MiddlewareResolver } from '../middleware/middleware_resolver.js';\nimport { buildMiddlewareContext, executeMiddleware } from '../middleware/middleware_pipeline.js';\nimport { ControllerResolver, buildControllerArgs } from '../controller/controller_resolver.js';\nimport { disposeControllerLifecycle } from '../controller/controller_lifecycle.js';\nimport { getLogger } from '@noego/logger';\nimport { publishMainTrace } from '../tracing/index.js';\n\nconst logger = getLogger('wood:router');\n\nfunction extractTraceConversationId(value: unknown): number | string | undefined {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) {\n    return undefined;\n  }\n\n  const record = value as Record<string, unknown>;\n  if (typeof record.conversationId === 'number' || typeof record.conversationId === 'string') {\n    return record.conversationId;\n  }\n  if (typeof record.threadId === 'number' || typeof record.threadId === 'string') {\n    return record.threadId;\n  }\n\n  return undefined;\n}\n\n/** Reserved internal channels prefixed with __ to avoid collisions with user operations. */\nexport const RESERVED_CHANNELS = ['__load', '__navigate', '__window', '__debug', '__contextMenu', '__woodConfig'] as const;\nexport type ReservedChannel = (typeof RESERVED_CHANNELS)[number];\n\n/** Handler signature for reserved channels. */\nexport type ReservedChannelHandler = (data: unknown, event?: any) => Promise<unknown>;\n\nexport class WoodRouter {\n  private operations = new Map<string, OperationDef>();\n  private reservedHandlers = new Map<ReservedChannel, ReservedChannelHandler>();\n  private validator: SchemaValidator;\n  private middlewareResolver: MiddlewareResolver;\n  private controllerResolver: ControllerResolver;\n  private container: any; // IoC Container\n\n  constructor(options: {\n    container: any;\n    controllersDir: string;\n    middlewareDir: string;\n    mode?: 'bundled' | 'dev';\n  }) {\n    this.container = options.container;\n    this.validator = new SchemaValidator();\n    this.middlewareResolver = new MiddlewareResolver(options.middlewareDir);\n    this.controllerResolver = new ControllerResolver(options.controllersDir, {\n      mode: options.mode,\n    });\n  }\n\n  /**\n   * Load operations from a parsed operations map.\n   */\n  loadOperations(operations: Map<string, OperationDef>): void {\n    for (const [channel, opDef] of operations) {\n      this.operations.set(channel, opDef);\n    }\n    logger.debug(`Loaded ${operations.size} operations`);\n  }\n\n  /**\n   * Register a handler for a reserved channel (__load, __navigate, __window).\n   * These channels are internal to Wood and serve as extension points for\n   * the loader runner, navigation system, and window manager.\n   */\n  registerReservedHandler(channel: ReservedChannel, handler: ReservedChannelHandler): void {\n    this.reservedHandlers.set(channel, handler);\n    logger.debug(`Registered reserved handler for \"${channel}\"`);\n  }\n\n  /**\n   * Register IPC handlers for all operations and reserved channels.\n   * In production: registers with ipcMain.handle\n   * In testing/bridge mode: handlers are callable via dispatch()\n   */\n  registerIpcHandlers(ipcMain: any): void {\n    for (const channel of this.operations.keys()) {\n      ipcMain.handle(channel, async (_event: any, data: unknown) => {\n        return this.dispatch(channel, data, _event);\n      });\n    }\n\n    // Register reserved channels\n    for (const channel of RESERVED_CHANNELS) {\n      ipcMain.handle(channel, async (_event: any, data: unknown) => {\n        const handler = this.reservedHandlers.get(channel);\n        if (!handler) {\n          throw new Error(`No handler registered for reserved channel \"${channel}\"`);\n        }\n        return handler(data, _event);\n      });\n    }\n\n    logger.debug(\n      `Registered ${this.operations.size} operation handlers and ${RESERVED_CHANNELS.length} reserved channels`\n    );\n  }\n\n  /**\n   * The request lifecycle -- mirrors Dinner's pipeline.\n   *\n   * channel -> build context -> middleware -> validate -> resolve controller\n   * -> create instance -> build args -> call action -> return result\n   */\n  async dispatch(channel: string, data: unknown, event?: any): Promise<unknown> {\n    const opDef = this.operations.get(channel);\n    if (!opDef) {\n      throw new Error(`Unknown operation: \"${channel}\"`);\n    }\n\n    const conversationId = extractTraceConversationId(data);\n    publishMainTrace('debug', {\n      source: 'wood.router',\n      type: 'dispatch.start',\n      ...(conversationId !== undefined ? { conversationId } : {}),\n      payload: {\n        channel,\n        controller: opDef.controller,\n        action: opDef.action,\n      },\n    });\n\n    // 1. Build IPC context\n    const ipcContext: IpcContext = {\n      body: data ?? {},\n      params: (data as any) ?? {},\n      query: {},\n      context: {},\n      sender: event?.sender,\n      windowId: undefined,\n    };\n\n    // 2. Execute middleware sequentially\n    if (opDef.middleware.length > 0) {\n      const mwContext = buildMiddlewareContext(ipcContext, channel);\n      const middlewareFns = await Promise.all(\n        opDef.middleware.map(spec => this.middlewareResolver.resolve(spec))\n      );\n      await executeMiddleware(middlewareFns, mwContext);\n    }\n\n    // 3. Validate input (if schema defined)\n    if (opDef.inputSchema) {\n      const result = this.validator.validate(\n        channel,\n        opDef.inputSchema as Record<string, unknown>,\n        ipcContext.body\n      );\n      if (!result.valid) {\n        publishMainTrace('error', {\n          source: 'wood.router',\n          type: 'dispatch.validation_error',\n          message: 'Request validation failed',\n          ...(conversationId !== undefined ? { conversationId } : {}),\n          payload: {\n            channel,\n            controller: opDef.controller,\n            action: opDef.action,\n            errorCount: result.errors?.length ?? 0,\n          },\n        });\n        throw new WoodValidationError('Request validation failed', result.errors ?? []);\n      }\n    }\n\n    // 4. Resolve controller class (cached)\n    const ControllerClass = await this.controllerResolver.resolveClass(opDef.controller);\n\n    // 5. Create instance via IoC (per-request scoped container)\n    const scopedContainer = this.container.extend();\n    const instance = await scopedContainer.instance(ControllerClass);\n\n    // 6. Build controller args (fake req/res)\n    const args = buildControllerArgs(ipcContext, scopedContainer);\n\n    // 7. Call action, always dispose controller afterward\n    const action = instance[opDef.action];\n    let result: unknown;\n    let actionError: unknown;\n\n    try {\n      if (typeof action !== 'function') {\n        throw new Error(\n          `Controller \"${opDef.controller}\" has no action \"${opDef.action}\"`\n        );\n      }\n\n      result = await action.call(instance, args);\n      publishMainTrace('debug', {\n        source: 'wood.router',\n        type: 'dispatch.success',\n        ...(conversationId !== undefined ? { conversationId } : {}),\n        payload: {\n          channel,\n          controller: opDef.controller,\n          action: opDef.action,\n        },\n      });\n    } catch (error) {\n      actionError = error;\n      publishMainTrace('error', {\n        source: 'wood.router',\n        type: 'dispatch.error',\n        message: error instanceof Error ? error.message : String(error),\n        ...(conversationId !== undefined ? { conversationId } : {}),\n        payload: {\n          channel,\n          controller: opDef.controller,\n          action: opDef.action,\n        },\n      });\n    } finally {\n      try {\n        await disposeControllerLifecycle(instance);\n      } catch (disposeError) {\n        publishMainTrace('error', {\n          source: 'wood.router',\n          type: 'dispatch.dispose.error',\n          message: disposeError instanceof Error ? disposeError.message : String(disposeError),\n          ...(conversationId !== undefined ? { conversationId } : {}),\n          payload: {\n            channel,\n            controller: opDef.controller,\n            action: opDef.action,\n          },\n        });\n\n        if (!actionError) {\n          actionError = disposeError;\n        }\n      }\n    }\n\n    if (actionError) {\n      throw actionError;\n    }\n\n    return result;\n  }\n\n  /**\n   * Pre-register a controller class by name so it is resolved from\n   * the in-memory cache instead of the filesystem.\n   * This is the public API used by the generated registration file.\n   */\n  registerController(name: string, ControllerClass: any): void {\n    this.controllerResolver.register(name, ControllerClass);\n  }\n\n  /**\n   * Register an import path for a controller. The controller will be lazily\n   * imported from this path when first needed, avoiding circular dependencies.\n   */\n  registerControllerPath(name: string, importPath: string): void {\n    this.controllerResolver.registerPath(name, importPath);\n  }\n\n  /**\n   * Validate that every controller referenced in loaded operations is\n   * pre-registered in the controller resolver. Call this after\n   * loadOperations() + registerControllers() but before registerIpcHandlers().\n   *\n   * Throws with a clear error listing all missing controllers if any\n   * operation references a controller that was not pre-registered.\n   */\n  validateControllers(): void {\n    const missing: Array<{ channel: string; controller: string }> = [];\n\n    for (const [channel, opDef] of this.operations) {\n      if (!this.controllerResolver.has(opDef.controller)) {\n        missing.push({ channel, controller: opDef.controller });\n      }\n    }\n\n    if (missing.length > 0) {\n      const details = missing\n        .map(m => `  - channel \"${m.channel}\" requires controller \"${m.controller}\"`)\n        .join('\\n');\n\n      throw new Error(\n        `WoodRouter: ${missing.length} operation(s) reference controllers that are not registered.\\n` +\n        `This usually means controllers.generated.ts is missing or out of date.\\n` +\n        `Run \"npx wood build\" or \"npx wood dev\" to regenerate it.\\n\\n` +\n        `Missing controllers:\\n${details}`\n      );\n    }\n\n    logger.info(`All ${this.operations.size} operations have registered controllers`);\n  }\n\n  /**\n   * Eagerly compile every operation's inputSchema so a malformed schema fails\n   * at startup (with the offending channel named) instead of throwing an opaque\n   * ajv error on the first request to that channel. Call after loadOperations().\n   */\n  precompileSchemas(): void {\n    let compiled = 0;\n    for (const [channel, opDef] of this.operations) {\n      if (opDef.inputSchema) {\n        this.validator.precompile(channel, opDef.inputSchema as Record<string, unknown>);\n        compiled += 1;\n      }\n    }\n    logger.info(`Pre-compiled ${compiled} operation input schema(s)`);\n  }\n\n  /** Get all registered operation channels. */\n  getChannels(): string[] {\n    return Array.from(this.operations.keys());\n  }\n\n  /** Get a specific operation definition. */\n  getOperation(channel: string): OperationDef | undefined {\n    return this.operations.get(channel);\n  }\n}\n"],"mappings":"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","names":["result"]}
+{"version":3,"sources":["../../src/router/wood_router.ts"],"sourcesContent":["import type { OperationDef, IpcContext, WoodMiddlewareContext } from '../types/index.js';\nimport { WoodValidationError } from '../types/index.js';\nimport { SchemaValidator } from '../validation/schema_validator.js';\nimport { MiddlewareResolver } from '../middleware/middleware_resolver.js';\nimport { buildMiddlewareContext, executeMiddleware } from '../middleware/middleware_pipeline.js';\nimport { ControllerResolver, buildControllerArgs } from '../controller/controller_resolver.js';\nimport { disposeControllerLifecycle } from '../controller/controller_lifecycle.js';\nimport { getLogger } from '@noego/logger';\nimport { publishMainTrace } from '../tracing/index.js';\n\nconst logger = getLogger('wood:router');\n\nfunction extractTraceConversationId(value: unknown): number | string | undefined {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) {\n    return undefined;\n  }\n\n  const record = value as Record<string, unknown>;\n  if (typeof record.conversationId === 'number' || typeof record.conversationId === 'string') {\n    return record.conversationId;\n  }\n  if (typeof record.threadId === 'number' || typeof record.threadId === 'string') {\n    return record.threadId;\n  }\n\n  return undefined;\n}\n\n/** Reserved internal channels prefixed with __ to avoid collisions with user operations. */\nexport const RESERVED_CHANNELS = [\n  '__load',\n  '__navigate',\n  '__window',\n  '__debug',\n  '__contextMenu',\n  '__woodConfig',\n  '__traceBatch',\n] as const;\nexport type ReservedChannel = (typeof RESERVED_CHANNELS)[number];\n\n/** Handler signature for reserved channels. */\nexport type ReservedChannelHandler = (data: unknown, event?: any) => Promise<unknown>;\n\nexport class WoodRouter {\n  private operations = new Map<string, OperationDef>();\n  private reservedHandlers = new Map<ReservedChannel, ReservedChannelHandler>();\n  private validator: SchemaValidator;\n  private middlewareResolver: MiddlewareResolver;\n  private controllerResolver: ControllerResolver;\n  private container: any; // IoC Container\n\n  constructor(options: {\n    container: any;\n    controllersDir: string;\n    middlewareDir: string;\n    mode?: 'bundled' | 'dev';\n  }) {\n    this.container = options.container;\n    this.validator = new SchemaValidator();\n    this.middlewareResolver = new MiddlewareResolver(options.middlewareDir);\n    this.controllerResolver = new ControllerResolver(options.controllersDir, {\n      mode: options.mode,\n    });\n  }\n\n  /**\n   * Load operations from a parsed operations map.\n   */\n  loadOperations(operations: Map<string, OperationDef>): void {\n    for (const [channel, opDef] of operations) {\n      this.operations.set(channel, opDef);\n    }\n    logger.debug(`Loaded ${operations.size} operations`);\n  }\n\n  /**\n   * Register a handler for a reserved channel (__load, __navigate, __window).\n   * These channels are internal to Wood and serve as extension points for\n   * the loader runner, navigation system, and window manager.\n   */\n  registerReservedHandler(channel: ReservedChannel, handler: ReservedChannelHandler): void {\n    this.reservedHandlers.set(channel, handler);\n    logger.debug(`Registered reserved handler for \"${channel}\"`);\n  }\n\n  /**\n   * Register IPC handlers for all operations and reserved channels.\n   * In production: registers with ipcMain.handle\n   * In testing/bridge mode: handlers are callable via dispatch()\n   */\n  registerIpcHandlers(ipcMain: any): void {\n    for (const channel of this.operations.keys()) {\n      ipcMain.handle(channel, async (_event: any, data: unknown) => {\n        return this.dispatch(channel, data, _event);\n      });\n    }\n\n    // Register reserved channels\n    for (const channel of RESERVED_CHANNELS) {\n      ipcMain.handle(channel, async (_event: any, data: unknown) => {\n        const handler = this.reservedHandlers.get(channel);\n        if (!handler) {\n          throw new Error(`No handler registered for reserved channel \"${channel}\"`);\n        }\n        return handler(data, _event);\n      });\n    }\n\n    logger.debug(\n      `Registered ${this.operations.size} operation handlers and ${RESERVED_CHANNELS.length} reserved channels`\n    );\n  }\n\n  /**\n   * The request lifecycle -- mirrors Dinner's pipeline.\n   *\n   * channel -> build context -> middleware -> validate -> resolve controller\n   * -> create instance -> build args -> call action -> return result\n   */\n  async dispatch(channel: string, data: unknown, event?: any): Promise<unknown> {\n    const opDef = this.operations.get(channel);\n    if (!opDef) {\n      throw new Error(`Unknown operation: \"${channel}\"`);\n    }\n\n    const conversationId = extractTraceConversationId(data);\n    publishMainTrace('debug', {\n      source: 'wood.router',\n      type: 'dispatch.start',\n      ...(conversationId !== undefined ? { conversationId } : {}),\n      payload: {\n        channel,\n        controller: opDef.controller,\n        action: opDef.action,\n      },\n    });\n\n    // 1. Build IPC context\n    const ipcContext: IpcContext = {\n      body: data ?? {},\n      params: (data as any) ?? {},\n      query: {},\n      context: {},\n      sender: event?.sender,\n      windowId: undefined,\n    };\n\n    // 2. Execute middleware sequentially\n    if (opDef.middleware.length > 0) {\n      const mwContext = buildMiddlewareContext(ipcContext, channel);\n      const middlewareFns = await Promise.all(\n        opDef.middleware.map(spec => this.middlewareResolver.resolve(spec))\n      );\n      await executeMiddleware(middlewareFns, mwContext);\n    }\n\n    // 3. Validate input (if schema defined)\n    if (opDef.inputSchema) {\n      const result = this.validator.validate(\n        channel,\n        opDef.inputSchema as Record<string, unknown>,\n        ipcContext.body\n      );\n      if (!result.valid) {\n        publishMainTrace('error', {\n          source: 'wood.router',\n          type: 'dispatch.validation_error',\n          message: 'Request validation failed',\n          ...(conversationId !== undefined ? { conversationId } : {}),\n          payload: {\n            channel,\n            controller: opDef.controller,\n            action: opDef.action,\n            errorCount: result.errors?.length ?? 0,\n          },\n        });\n        throw new WoodValidationError('Request validation failed', result.errors ?? []);\n      }\n    }\n\n    // 4. Resolve controller class (cached)\n    const ControllerClass = await this.controllerResolver.resolveClass(opDef.controller);\n\n    // 5. Create instance via IoC (per-request scoped container)\n    const scopedContainer = this.container.extend();\n    const instance = await scopedContainer.instance(ControllerClass);\n\n    // 6. Build controller args (fake req/res)\n    const args = buildControllerArgs(ipcContext, scopedContainer);\n\n    // 7. Call action, always dispose controller afterward\n    const action = instance[opDef.action];\n    let result: unknown;\n    let actionError: unknown;\n\n    try {\n      if (typeof action !== 'function') {\n        throw new Error(\n          `Controller \"${opDef.controller}\" has no action \"${opDef.action}\"`\n        );\n      }\n\n      result = await action.call(instance, args);\n      publishMainTrace('debug', {\n        source: 'wood.router',\n        type: 'dispatch.success',\n        ...(conversationId !== undefined ? { conversationId } : {}),\n        payload: {\n          channel,\n          controller: opDef.controller,\n          action: opDef.action,\n        },\n      });\n    } catch (error) {\n      actionError = error;\n      publishMainTrace('error', {\n        source: 'wood.router',\n        type: 'dispatch.error',\n        message: error instanceof Error ? error.message : String(error),\n        ...(conversationId !== undefined ? { conversationId } : {}),\n        payload: {\n          channel,\n          controller: opDef.controller,\n          action: opDef.action,\n        },\n      });\n    } finally {\n      try {\n        await disposeControllerLifecycle(instance);\n      } catch (disposeError) {\n        publishMainTrace('error', {\n          source: 'wood.router',\n          type: 'dispatch.dispose.error',\n          message: disposeError instanceof Error ? disposeError.message : String(disposeError),\n          ...(conversationId !== undefined ? { conversationId } : {}),\n          payload: {\n            channel,\n            controller: opDef.controller,\n            action: opDef.action,\n          },\n        });\n\n        if (!actionError) {\n          actionError = disposeError;\n        }\n      }\n    }\n\n    if (actionError) {\n      throw actionError;\n    }\n\n    return result;\n  }\n\n  /**\n   * Pre-register a controller class by name so it is resolved from\n   * the in-memory cache instead of the filesystem.\n   * This is the public API used by the generated registration file.\n   */\n  registerController(name: string, ControllerClass: any): void {\n    this.controllerResolver.register(name, ControllerClass);\n  }\n\n  /**\n   * Register an import path for a controller. The controller will be lazily\n   * imported from this path when first needed, avoiding circular dependencies.\n   */\n  registerControllerPath(name: string, importPath: string): void {\n    this.controllerResolver.registerPath(name, importPath);\n  }\n\n  /**\n   * Validate that every controller referenced in loaded operations is\n   * pre-registered in the controller resolver. Call this after\n   * loadOperations() + registerControllers() but before registerIpcHandlers().\n   *\n   * Throws with a clear error listing all missing controllers if any\n   * operation references a controller that was not pre-registered.\n   */\n  validateControllers(): void {\n    const missing: Array<{ channel: string; controller: string }> = [];\n\n    for (const [channel, opDef] of this.operations) {\n      if (!this.controllerResolver.has(opDef.controller)) {\n        missing.push({ channel, controller: opDef.controller });\n      }\n    }\n\n    if (missing.length > 0) {\n      const details = missing\n        .map(m => `  - channel \"${m.channel}\" requires controller \"${m.controller}\"`)\n        .join('\\n');\n\n      throw new Error(\n        `WoodRouter: ${missing.length} operation(s) reference controllers that are not registered.\\n` +\n        `This usually means controllers.generated.ts is missing or out of date.\\n` +\n        `Run \"npx wood build\" or \"npx wood dev\" to regenerate it.\\n\\n` +\n        `Missing controllers:\\n${details}`\n      );\n    }\n\n    logger.info(`All ${this.operations.size} operations have registered controllers`);\n  }\n\n  /**\n   * Eagerly compile every operation's inputSchema so a malformed schema fails\n   * at startup (with the offending channel named) instead of throwing an opaque\n   * ajv error on the first request to that channel. Call after loadOperations().\n   */\n  precompileSchemas(): void {\n    let compiled = 0;\n    for (const [channel, opDef] of this.operations) {\n      if (opDef.inputSchema) {\n        this.validator.precompile(channel, opDef.inputSchema as Record<string, unknown>);\n        compiled += 1;\n      }\n    }\n    logger.info(`Pre-compiled ${compiled} operation input schema(s)`);\n  }\n\n  /** Get all registered operation channels. */\n  getChannels(): string[] {\n    return Array.from(this.operations.keys());\n  }\n\n  /** Get a specific operation definition. */\n  getOperation(channel: string): OperationDef | undefined {\n    return this.operations.get(channel);\n  }\n}\n"],"mappings":"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","names":["result"]}

package/dist/runtime/app_env.cjs

@@ -0,0 +1,52 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var app_env_exports = {};
+__export(app_env_exports, {
+  resolveWoodAppEnv: () => resolveWoodAppEnv
+});
+module.exports = __toCommonJS(app_env_exports);
+async function resolveWoodAppEnv(env = process.env) {
+  if (env.WOOD_MODE === "development" || env.ELECTRON_RENDERER_URL) {
+    return "dev";
+  }
+  try {
+    const electron = await import("electron");
+    const app = electron.app;
+    if (app && app.isPackaged === false) {
+      return "local";
+    }
+  } catch {
+  }
+  return "packaged";
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  resolveWoodAppEnv
+});
+//# sourceMappingURL=app_env.cjs.map

package/dist/runtime/app_env.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/runtime/app_env.ts"],"sourcesContent":["export type WoodAppEnv = 'dev' | 'local' | 'packaged';\n\n/**\n * Resolve the runtime environment tier for the running app:\n * - 'dev'      — launched via `wood dev` (WOOD_MODE=development in the env)\n * - 'local'    — built output run directly (`electron .`), not packaged\n * - 'packaged' — installed/packaged app (electron-forge etc.)\n */\nexport async function resolveWoodAppEnv(\n  env: NodeJS.ProcessEnv = process.env,\n): Promise<WoodAppEnv> {\n  // ELECTRON_RENDERER_URL is set by electron-vite dev (same signal wood uses to\n  // choose loadURL vs loadFile); WOOD_MODE covers the wood CLI child env.\n  if (env.WOOD_MODE === 'development' || env.ELECTRON_RENDERER_URL) {\n    return 'dev';\n  }\n  try {\n    const electron = await import('electron');\n    const app = (electron as { app?: { isPackaged?: boolean } }).app;\n    if (app && app.isPackaged === false) {\n      return 'local';\n    }\n  } catch {\n    // Electron unavailable (tests/node) — treat as packaged so no ribbon shows.\n  }\n  return 'packaged';\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAQA,eAAsB,kBACpB,MAAyB,QAAQ,KACZ;AAGrB,MAAI,IAAI,cAAc,iBAAiB,IAAI,uBAAuB;AAChE,WAAO;AAAA,EACT;AACA,MAAI;AACF,UAAM,WAAW,MAAM,OAAO,UAAU;AACxC,UAAM,MAAO,SAAgD;AAC7D,QAAI,OAAO,IAAI,eAAe,OAAO;AACnC,aAAO;AAAA,IACT;AAAA,EACF,QAAQ;AAAA,EAER;AACA,SAAO;AACT;","names":[]}

package/dist/runtime/app_env.d.cts

@@ -0,0 +1,10 @@
+type WoodAppEnv = 'dev' | 'local' | 'packaged';
+/**
+ * Resolve the runtime environment tier for the running app:
+ * - 'dev'      — launched via `wood dev` (WOOD_MODE=development in the env)
+ * - 'local'    — built output run directly (`electron .`), not packaged
+ * - 'packaged' — installed/packaged app (electron-forge etc.)
+ */
+declare function resolveWoodAppEnv(env?: NodeJS.ProcessEnv): Promise<WoodAppEnv>;
+
+export { type WoodAppEnv, resolveWoodAppEnv };

package/dist/runtime/app_env.d.ts

@@ -0,0 +1,10 @@
+type WoodAppEnv = 'dev' | 'local' | 'packaged';
+/**
+ * Resolve the runtime environment tier for the running app:
+ * - 'dev'      — launched via `wood dev` (WOOD_MODE=development in the env)
+ * - 'local'    — built output run directly (`electron .`), not packaged
+ * - 'packaged' — installed/packaged app (electron-forge etc.)
+ */
+declare function resolveWoodAppEnv(env?: NodeJS.ProcessEnv): Promise<WoodAppEnv>;
+
+export { type WoodAppEnv, resolveWoodAppEnv };

package/dist/runtime/app_env.js

@@ -0,0 +1,18 @@
+async function resolveWoodAppEnv(env = process.env) {
+  if (env.WOOD_MODE === "development" || env.ELECTRON_RENDERER_URL) {
+    return "dev";
+  }
+  try {
+    const electron = await import("electron");
+    const app = electron.app;
+    if (app && app.isPackaged === false) {
+      return "local";
+    }
+  } catch {
+  }
+  return "packaged";
+}
+export {
+  resolveWoodAppEnv
+};
+//# sourceMappingURL=app_env.js.map

package/dist/runtime/app_env.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/runtime/app_env.ts"],"sourcesContent":["export type WoodAppEnv = 'dev' | 'local' | 'packaged';\n\n/**\n * Resolve the runtime environment tier for the running app:\n * - 'dev'      — launched via `wood dev` (WOOD_MODE=development in the env)\n * - 'local'    — built output run directly (`electron .`), not packaged\n * - 'packaged' — installed/packaged app (electron-forge etc.)\n */\nexport async function resolveWoodAppEnv(\n  env: NodeJS.ProcessEnv = process.env,\n): Promise<WoodAppEnv> {\n  // ELECTRON_RENDERER_URL is set by electron-vite dev (same signal wood uses to\n  // choose loadURL vs loadFile); WOOD_MODE covers the wood CLI child env.\n  if (env.WOOD_MODE === 'development' || env.ELECTRON_RENDERER_URL) {\n    return 'dev';\n  }\n  try {\n    const electron = await import('electron');\n    const app = (electron as { app?: { isPackaged?: boolean } }).app;\n    if (app && app.isPackaged === false) {\n      return 'local';\n    }\n  } catch {\n    // Electron unavailable (tests/node) — treat as packaged so no ribbon shows.\n  }\n  return 'packaged';\n}\n"],"mappings":"AAQA,eAAsB,kBACpB,MAAyB,QAAQ,KACZ;AAGrB,MAAI,IAAI,cAAc,iBAAiB,IAAI,uBAAuB;AAChE,WAAO;AAAA,EACT;AACA,MAAI;AACF,UAAM,WAAW,MAAM,OAAO,UAAU;AACxC,UAAM,MAAO,SAAgD;AAC7D,QAAI,OAAO,IAAI,eAAe,OAAO;AACnC,aAAO;AAAA,IACT;AAAA,EACF,QAAQ;AAAA,EAER;AACA,SAAO;AACT;","names":[]}

package/dist/runtime/index.cjs

@@ -21,29 +21,36 @@ __export(runtime_exports, {
   clearApplicationRootForTests: () => import_application_root.clearApplicationRootForTests,
   clearContainerRegistryForTests: () => import_get_container.clearContainerRegistryForTests,
   clearRendererLogDispatcherForTests: () => import_renderer_log_dispatcher.clearRendererLogDispatcherForTests,
+  clearRendererTraceBatchReceiverForTests: () => import_renderer_trace_batch_receiver_registry.clearRendererTraceBatchReceiverForTests,
   dispatchRendererTracePayload: () => import_tracing.dispatchRendererTracePayload,
   getApplicationRoot: () => import_application_root.getApplicationRoot,
   getContainer: () => import_get_container.getContainer,
   getRendererLogDispatcher: () => import_renderer_log_dispatcher.getRendererLogDispatcher,
+  getRendererTraceBatchReceiver: () => import_renderer_trace_batch_receiver_registry.getRendererTraceBatchReceiver,
   runtime: () => import_runtime.runtime,
-  setApplicationRoot: () => import_application_root.setApplicationRoot
+  setApplicationRoot: () => import_application_root.setApplicationRoot,
+  setRendererTraceBatchReceiver: () => import_renderer_trace_batch_receiver_registry.setRendererTraceBatchReceiver
 });
 module.exports = __toCommonJS(runtime_exports);
 var import_get_container = require("./get_container.js");
 var import_application_root = require("./application_root.js");
 var import_runtime = require("./runtime.js");
 var import_renderer_log_dispatcher = require("./renderer_log_dispatcher.js");
+var import_renderer_trace_batch_receiver_registry = require("./renderer_trace_batch_receiver_registry.js");
 var import_tracing = require("../tracing/index.js");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   clearApplicationRootForTests,
   clearContainerRegistryForTests,
   clearRendererLogDispatcherForTests,
+  clearRendererTraceBatchReceiverForTests,
   dispatchRendererTracePayload,
   getApplicationRoot,
   getContainer,
   getRendererLogDispatcher,
+  getRendererTraceBatchReceiver,
   runtime,
-  setApplicationRoot
+  setApplicationRoot,
+  setRendererTraceBatchReceiver
 });
 //# sourceMappingURL=index.cjs.map

package/dist/runtime/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/runtime/index.ts"],"sourcesContent":["export { getContainer, clearContainerRegistryForTests } from './get_container.js';\nexport type { GetContainerOptions } from './get_container.js';\n\nexport {\n  getApplicationRoot,\n  setApplicationRoot,\n  clearApplicationRootForTests,\n} from './application_root.js';\n\nexport { runtime } from './runtime.js';\nexport type { RuntimeOptions, RuntimeResult, RegisterRuntimeRouter } from './runtime.js';\n\nexport {\n  getRendererLogDispatcher,\n  clearRendererLogDispatcherForTests,\n} from './renderer_log_dispatcher.js';\nexport type {\n  RendererLogLevel,\n  RendererLogEntry,\n  RendererLogCallback,\n  RendererLogDispatchResult,\n} from './renderer_log_dispatcher.js';\n\nexport { dispatchRendererTracePayload } from '../tracing/index.js';\nexport type { TraceDispatchResult } from '../tracing/index.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,2BAA6D;AAG7D,8BAIO;AAEP,qBAAwB;AAGxB,qCAGO;AAQP,qBAA6C;","names":[]}
+{"version":3,"sources":["../../src/runtime/index.ts"],"sourcesContent":["export { getContainer, clearContainerRegistryForTests } from './get_container.js';\nexport type { GetContainerOptions } from './get_container.js';\n\nexport {\n  getApplicationRoot,\n  setApplicationRoot,\n  clearApplicationRootForTests,\n} from './application_root.js';\n\nexport { runtime } from './runtime.js';\nexport type { RuntimeOptions, RuntimeResult, RegisterRuntimeRouter } from './runtime.js';\n\nexport {\n  getRendererLogDispatcher,\n  clearRendererLogDispatcherForTests,\n} from './renderer_log_dispatcher.js';\nexport type {\n  RendererLogLevel,\n  RendererLogEntry,\n  RendererLogCallback,\n  RendererLogDispatchResult,\n} from './renderer_log_dispatcher.js';\n\nexport {\n  clearRendererTraceBatchReceiverForTests,\n  getRendererTraceBatchReceiver,\n  setRendererTraceBatchReceiver,\n} from './renderer_trace_batch_receiver_registry.js';\n\nexport { dispatchRendererTracePayload } from '../tracing/index.js';\nexport type { TraceDispatchResult } from '../tracing/index.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,2BAA6D;AAG7D,8BAIO;AAEP,qBAAwB;AAGxB,qCAGO;AAQP,oDAIO;AAEP,qBAA6C;","names":[]}

package/dist/runtime/index.d.cts

@@ -2,7 +2,11 @@ export { GetContainerOptions, clearContainerRegistryForTests, getContainer } fro
 export { clearApplicationRootForTests, getApplicationRoot, setApplicationRoot } from './application_root.cjs';
 export { RegisterRuntimeRouter, RuntimeOptions, RuntimeResult, runtime } from './runtime.cjs';
 export { RendererLogCallback, RendererLogDispatchResult, RendererLogEntry, RendererLogLevel, clearRendererLogDispatcherForTests, getRendererLogDispatcher } from './renderer_log_dispatcher.cjs';
-export { TraceDispatchResult, dispatchRendererTracePayload } from '../tracing/trace_hub.cjs';
+export { clearRendererTraceBatchReceiverForTests, getRendererTraceBatchReceiver, setRendererTraceBatchReceiver } from './renderer_trace_batch_receiver_registry.cjs';
+export { T as TraceDispatchResult, l as dispatchRendererTracePayload } from '../trace_hub-Cob54qRx.cjs';
 import '../router/wood_router.cjs';
 import '../types/operations.cjs';
+import '../tracing/types/wood_trace_batch.types.cjs';
+import '@noego/telemetry/core';
+import './app_env.cjs';
 import 'rxjs';

package/dist/runtime/index.d.ts

@@ -2,7 +2,11 @@ export { GetContainerOptions, clearContainerRegistryForTests, getContainer } fro
 export { clearApplicationRootForTests, getApplicationRoot, setApplicationRoot } from './application_root.js';
 export { RegisterRuntimeRouter, RuntimeOptions, RuntimeResult, runtime } from './runtime.js';
 export { RendererLogCallback, RendererLogDispatchResult, RendererLogEntry, RendererLogLevel, clearRendererLogDispatcherForTests, getRendererLogDispatcher } from './renderer_log_dispatcher.js';
-export { TraceDispatchResult, dispatchRendererTracePayload } from '../tracing/trace_hub.js';
+export { clearRendererTraceBatchReceiverForTests, getRendererTraceBatchReceiver, setRendererTraceBatchReceiver } from './renderer_trace_batch_receiver_registry.js';
+export { T as TraceDispatchResult, l as dispatchRendererTracePayload } from '../trace_hub-Cob54qRx.js';
 import '../router/wood_router.js';
 import '../types/operations.js';
+import '../tracing/types/wood_trace_batch.types.js';
+import '@noego/telemetry/core';
+import './app_env.js';
 import 'rxjs';

package/dist/runtime/index.js

@@ -9,16 +9,24 @@ import {
   getRendererLogDispatcher,
   clearRendererLogDispatcherForTests
 } from "./renderer_log_dispatcher.js";
+import {
+  clearRendererTraceBatchReceiverForTests,
+  getRendererTraceBatchReceiver,
+  setRendererTraceBatchReceiver
+} from "./renderer_trace_batch_receiver_registry.js";
 import { dispatchRendererTracePayload } from "../tracing/index.js";
 export {
   clearApplicationRootForTests,
   clearContainerRegistryForTests,
   clearRendererLogDispatcherForTests,
+  clearRendererTraceBatchReceiverForTests,
   dispatchRendererTracePayload,
   getApplicationRoot,
   getContainer,
   getRendererLogDispatcher,
+  getRendererTraceBatchReceiver,
   runtime,
-  setApplicationRoot
+  setApplicationRoot,
+  setRendererTraceBatchReceiver
 };
 //# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/runtime/index.ts"],"sourcesContent":["export { getContainer, clearContainerRegistryForTests } from './get_container.js';\nexport type { GetContainerOptions } from './get_container.js';\n\nexport {\n  getApplicationRoot,\n  setApplicationRoot,\n  clearApplicationRootForTests,\n} from './application_root.js';\n\nexport { runtime } from './runtime.js';\nexport type { RuntimeOptions, RuntimeResult, RegisterRuntimeRouter } from './runtime.js';\n\nexport {\n  getRendererLogDispatcher,\n  clearRendererLogDispatcherForTests,\n} from './renderer_log_dispatcher.js';\nexport type {\n  RendererLogLevel,\n  RendererLogEntry,\n  RendererLogCallback,\n  RendererLogDispatchResult,\n} from './renderer_log_dispatcher.js';\n\nexport { dispatchRendererTracePayload } from '../tracing/index.js';\nexport type { TraceDispatchResult } from '../tracing/index.js';\n"],"mappings":"AAAA,SAAS,cAAc,sCAAsC;AAG7D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,SAAS,eAAe;AAGxB;AAAA,EACE;AAAA,EACA;AAAA,OACK;AAQP,SAAS,oCAAoC;","names":[]}
+{"version":3,"sources":["../../src/runtime/index.ts"],"sourcesContent":["export { getContainer, clearContainerRegistryForTests } from './get_container.js';\nexport type { GetContainerOptions } from './get_container.js';\n\nexport {\n  getApplicationRoot,\n  setApplicationRoot,\n  clearApplicationRootForTests,\n} from './application_root.js';\n\nexport { runtime } from './runtime.js';\nexport type { RuntimeOptions, RuntimeResult, RegisterRuntimeRouter } from './runtime.js';\n\nexport {\n  getRendererLogDispatcher,\n  clearRendererLogDispatcherForTests,\n} from './renderer_log_dispatcher.js';\nexport type {\n  RendererLogLevel,\n  RendererLogEntry,\n  RendererLogCallback,\n  RendererLogDispatchResult,\n} from './renderer_log_dispatcher.js';\n\nexport {\n  clearRendererTraceBatchReceiverForTests,\n  getRendererTraceBatchReceiver,\n  setRendererTraceBatchReceiver,\n} from './renderer_trace_batch_receiver_registry.js';\n\nexport { dispatchRendererTracePayload } from '../tracing/index.js';\nexport type { TraceDispatchResult } from '../tracing/index.js';\n"],"mappings":"AAAA,SAAS,cAAc,sCAAsC;AAG7D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,SAAS,eAAe;AAGxB;AAAA,EACE;AAAA,EACA;AAAA,OACK;AAQP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,SAAS,oCAAoC;","names":[]}

package/dist/runtime/renderer_log_dispatcher.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/runtime/renderer_log_dispatcher.ts"],"sourcesContent":["const RENDERER_LOG_DISPATCHER_SYMBOL = Symbol.for('@noego/wood.runtime.renderer-log-dispatcher');\n\nexport type RendererLogLevel = 'debug' | 'info' | 'warn' | 'error';\n\nexport type RendererLogEntry = {\n  level: RendererLogLevel;\n  logger: string;\n  message: string;\n  context?: unknown;\n  timestamp: string;\n  senderId?: number | null;\n};\n\nexport type RendererLogCallback = (entry: RendererLogEntry) => void | Promise<void>;\n\nexport type RendererLogDispatchResult = {\n  ok: boolean;\n  forwarded: boolean;\n  configured: boolean;\n  reason?: 'unconfigured' | 'callback-error';\n  errorMessage?: string;\n};\n\nclass RendererLogDispatcher {\n  private callback: RendererLogCallback | null = null;\n\n  setCallback(callback: RendererLogCallback | null): void {\n    this.callback = callback;\n  }\n\n  getCallback(): RendererLogCallback | null {\n    return this.callback;\n  }\n\n  async dispatch(entry: RendererLogEntry): Promise<RendererLogDispatchResult> {\n    if (!this.callback) {\n      return {\n        ok: true,\n        forwarded: false,\n        configured: false,\n        reason: 'unconfigured',\n      };\n    }\n\n    try {\n      await this.callback(entry);\n      return {\n        ok: true,\n        forwarded: true,\n        configured: true,\n      };\n    } catch (error) {\n      return {\n        ok: false,\n        forwarded: false,\n        configured: true,\n        reason: 'callback-error',\n        errorMessage: error instanceof Error ? error.message : String(error),\n      };\n    }\n  }\n}\n\ntype GlobalWithRendererLogDispatcher = typeof globalThis & {\n  [RENDERER_LOG_DISPATCHER_SYMBOL]?: RendererLogDispatcher;\n};\n\nexport function getRendererLogDispatcher(): RendererLogDispatcher {\n  const globalObj = globalThis as GlobalWithRendererLogDispatcher;\n  if (!globalObj[RENDERER_LOG_DISPATCHER_SYMBOL]) {\n    globalObj[RENDERER_LOG_DISPATCHER_SYMBOL] = new RendererLogDispatcher();\n  }\n  return globalObj[RENDERER_LOG_DISPATCHER_SYMBOL] as RendererLogDispatcher;\n}\n\nexport function clearRendererLogDispatcherForTests(): void {\n  const globalObj = globalThis as GlobalWithRendererLogDispatcher;\n  delete globalObj[RENDERER_LOG_DISPATCHER_SYMBOL];\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAAM,iCAAiC,uBAAO,IAAI,6CAA6C;AAuB/F,MAAM,sBAAsB;AAAA,EAA5B;AACE,SAAQ,WAAuC;AAAA;AAAA,EAE/C,YAAY,UAA4C;AACtD,SAAK,WAAW;AAAA,EAClB;AAAA,EAEA,cAA0C;AACxC,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,MAAM,SAAS,OAA6D;AAC1E,QAAI,CAAC,KAAK,UAAU;AAClB,aAAO;AAAA,QACL,IAAI;AAAA,QACJ,WAAW;AAAA,QACX,YAAY;AAAA,QACZ,QAAQ;AAAA,MACV;AAAA,IACF;AAEA,QAAI;AACF,YAAM,KAAK,SAAS,KAAK;AACzB,aAAO;AAAA,QACL,IAAI;AAAA,QACJ,WAAW;AAAA,QACX,YAAY;AAAA,MACd;AAAA,IACF,SAAS,OAAO;AACd,aAAO;AAAA,QACL,IAAI;AAAA,QACJ,WAAW;AAAA,QACX,YAAY;AAAA,QACZ,QAAQ;AAAA,QACR,cAAc,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,MACrE;AAAA,IACF;AAAA,EACF;AACF;AAMO,SAAS,2BAAkD;AAChE,QAAM,YAAY;AAClB,MAAI,CAAC,UAAU,8BAA8B,GAAG;AAC9C,cAAU,8BAA8B,IAAI,IAAI,sBAAsB;AAAA,EACxE;AACA,SAAO,UAAU,8BAA8B;AACjD;AAEO,SAAS,qCAA2C;AACzD,QAAM,YAAY;AAClB,SAAO,UAAU,8BAA8B;AACjD;","names":[]}
+{"version":3,"sources":["../../src/runtime/renderer_log_dispatcher.ts"],"sourcesContent":["const RENDERER_LOG_DISPATCHER_SYMBOL = Symbol.for('@noego/wood.runtime.renderer-log-dispatcher');\n\nexport type RendererLogLevel = 'debug' | 'info' | 'warn' | 'error' | (string & {});\n\nexport type RendererLogEntry = {\n  level: RendererLogLevel;\n  logger: string;\n  message: string;\n  context?: unknown;\n  timestamp: string;\n  senderId?: number | null;\n};\n\nexport type RendererLogCallback = (entry: RendererLogEntry) => void | Promise<void>;\n\nexport type RendererLogDispatchResult = {\n  ok: boolean;\n  forwarded: boolean;\n  configured: boolean;\n  reason?: 'unconfigured' | 'callback-error';\n  errorMessage?: string;\n};\n\nclass RendererLogDispatcher {\n  private callback: RendererLogCallback | null = null;\n\n  setCallback(callback: RendererLogCallback | null): void {\n    this.callback = callback;\n  }\n\n  getCallback(): RendererLogCallback | null {\n    return this.callback;\n  }\n\n  async dispatch(entry: RendererLogEntry): Promise<RendererLogDispatchResult> {\n    if (!this.callback) {\n      return {\n        ok: true,\n        forwarded: false,\n        configured: false,\n        reason: 'unconfigured',\n      };\n    }\n\n    try {\n      await this.callback(entry);\n      return {\n        ok: true,\n        forwarded: true,\n        configured: true,\n      };\n    } catch (error) {\n      return {\n        ok: false,\n        forwarded: false,\n        configured: true,\n        reason: 'callback-error',\n        errorMessage: error instanceof Error ? error.message : String(error),\n      };\n    }\n  }\n}\n\ntype GlobalWithRendererLogDispatcher = typeof globalThis & {\n  [RENDERER_LOG_DISPATCHER_SYMBOL]?: RendererLogDispatcher;\n};\n\nexport function getRendererLogDispatcher(): RendererLogDispatcher {\n  const globalObj = globalThis as GlobalWithRendererLogDispatcher;\n  if (!globalObj[RENDERER_LOG_DISPATCHER_SYMBOL]) {\n    globalObj[RENDERER_LOG_DISPATCHER_SYMBOL] = new RendererLogDispatcher();\n  }\n  return globalObj[RENDERER_LOG_DISPATCHER_SYMBOL] as RendererLogDispatcher;\n}\n\nexport function clearRendererLogDispatcherForTests(): void {\n  const globalObj = globalThis as GlobalWithRendererLogDispatcher;\n  delete globalObj[RENDERER_LOG_DISPATCHER_SYMBOL];\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAAM,iCAAiC,uBAAO,IAAI,6CAA6C;AAuB/F,MAAM,sBAAsB;AAAA,EAA5B;AACE,SAAQ,WAAuC;AAAA;AAAA,EAE/C,YAAY,UAA4C;AACtD,SAAK,WAAW;AAAA,EAClB;AAAA,EAEA,cAA0C;AACxC,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,MAAM,SAAS,OAA6D;AAC1E,QAAI,CAAC,KAAK,UAAU;AAClB,aAAO;AAAA,QACL,IAAI;AAAA,QACJ,WAAW;AAAA,QACX,YAAY;AAAA,QACZ,QAAQ;AAAA,MACV;AAAA,IACF;AAEA,QAAI;AACF,YAAM,KAAK,SAAS,KAAK;AACzB,aAAO;AAAA,QACL,IAAI;AAAA,QACJ,WAAW;AAAA,QACX,YAAY;AAAA,MACd;AAAA,IACF,SAAS,OAAO;AACd,aAAO;AAAA,QACL,IAAI;AAAA,QACJ,WAAW;AAAA,QACX,YAAY;AAAA,QACZ,QAAQ;AAAA,QACR,cAAc,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,MACrE;AAAA,IACF;AAAA,EACF;AACF;AAMO,SAAS,2BAAkD;AAChE,QAAM,YAAY;AAClB,MAAI,CAAC,UAAU,8BAA8B,GAAG;AAC9C,cAAU,8BAA8B,IAAI,IAAI,sBAAsB;AAAA,EACxE;AACA,SAAO,UAAU,8BAA8B;AACjD;AAEO,SAAS,qCAA2C;AACzD,QAAM,YAAY;AAClB,SAAO,UAAU,8BAA8B;AACjD;","names":[]}

package/dist/runtime/renderer_log_dispatcher.d.cts

@@ -1,4 +1,4 @@
-type RendererLogLevel = 'debug' | 'info' | 'warn' | 'error';
+type RendererLogLevel = 'debug' | 'info' | 'warn' | 'error' | (string & {});
 type RendererLogEntry = {
     level: RendererLogLevel;
     logger: string;

package/dist/runtime/renderer_log_dispatcher.d.ts

@@ -1,4 +1,4 @@
-type RendererLogLevel = 'debug' | 'info' | 'warn' | 'error';
+type RendererLogLevel = 'debug' | 'info' | 'warn' | 'error' | (string & {});
 type RendererLogEntry = {
     level: RendererLogLevel;
     logger: string;

package/dist/runtime/renderer_log_dispatcher.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/runtime/renderer_log_dispatcher.ts"],"sourcesContent":["const RENDERER_LOG_DISPATCHER_SYMBOL = Symbol.for('@noego/wood.runtime.renderer-log-dispatcher');\n\nexport type RendererLogLevel = 'debug' | 'info' | 'warn' | 'error';\n\nexport type RendererLogEntry = {\n  level: RendererLogLevel;\n  logger: string;\n  message: string;\n  context?: unknown;\n  timestamp: string;\n  senderId?: number | null;\n};\n\nexport type RendererLogCallback = (entry: RendererLogEntry) => void | Promise<void>;\n\nexport type RendererLogDispatchResult = {\n  ok: boolean;\n  forwarded: boolean;\n  configured: boolean;\n  reason?: 'unconfigured' | 'callback-error';\n  errorMessage?: string;\n};\n\nclass RendererLogDispatcher {\n  private callback: RendererLogCallback | null = null;\n\n  setCallback(callback: RendererLogCallback | null): void {\n    this.callback = callback;\n  }\n\n  getCallback(): RendererLogCallback | null {\n    return this.callback;\n  }\n\n  async dispatch(entry: RendererLogEntry): Promise<RendererLogDispatchResult> {\n    if (!this.callback) {\n      return {\n        ok: true,\n        forwarded: false,\n        configured: false,\n        reason: 'unconfigured',\n      };\n    }\n\n    try {\n      await this.callback(entry);\n      return {\n        ok: true,\n        forwarded: true,\n        configured: true,\n      };\n    } catch (error) {\n      return {\n        ok: false,\n        forwarded: false,\n        configured: true,\n        reason: 'callback-error',\n        errorMessage: error instanceof Error ? error.message : String(error),\n      };\n    }\n  }\n}\n\ntype GlobalWithRendererLogDispatcher = typeof globalThis & {\n  [RENDERER_LOG_DISPATCHER_SYMBOL]?: RendererLogDispatcher;\n};\n\nexport function getRendererLogDispatcher(): RendererLogDispatcher {\n  const globalObj = globalThis as GlobalWithRendererLogDispatcher;\n  if (!globalObj[RENDERER_LOG_DISPATCHER_SYMBOL]) {\n    globalObj[RENDERER_LOG_DISPATCHER_SYMBOL] = new RendererLogDispatcher();\n  }\n  return globalObj[RENDERER_LOG_DISPATCHER_SYMBOL] as RendererLogDispatcher;\n}\n\nexport function clearRendererLogDispatcherForTests(): void {\n  const globalObj = globalThis as GlobalWithRendererLogDispatcher;\n  delete globalObj[RENDERER_LOG_DISPATCHER_SYMBOL];\n}\n"],"mappings":"AAAA,MAAM,iCAAiC,uBAAO,IAAI,6CAA6C;AAuB/F,MAAM,sBAAsB;AAAA,EAA5B;AACE,SAAQ,WAAuC;AAAA;AAAA,EAE/C,YAAY,UAA4C;AACtD,SAAK,WAAW;AAAA,EAClB;AAAA,EAEA,cAA0C;AACxC,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,MAAM,SAAS,OAA6D;AAC1E,QAAI,CAAC,KAAK,UAAU;AAClB,aAAO;AAAA,QACL,IAAI;AAAA,QACJ,WAAW;AAAA,QACX,YAAY;AAAA,QACZ,QAAQ;AAAA,MACV;AAAA,IACF;AAEA,QAAI;AACF,YAAM,KAAK,SAAS,KAAK;AACzB,aAAO;AAAA,QACL,IAAI;AAAA,QACJ,WAAW;AAAA,QACX,YAAY;AAAA,MACd;AAAA,IACF,SAAS,OAAO;AACd,aAAO;AAAA,QACL,IAAI;AAAA,QACJ,WAAW;AAAA,QACX,YAAY;AAAA,QACZ,QAAQ;AAAA,QACR,cAAc,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,MACrE;AAAA,IACF;AAAA,EACF;AACF;AAMO,SAAS,2BAAkD;AAChE,QAAM,YAAY;AAClB,MAAI,CAAC,UAAU,8BAA8B,GAAG;AAC9C,cAAU,8BAA8B,IAAI,IAAI,sBAAsB;AAAA,EACxE;AACA,SAAO,UAAU,8BAA8B;AACjD;AAEO,SAAS,qCAA2C;AACzD,QAAM,YAAY;AAClB,SAAO,UAAU,8BAA8B;AACjD;","names":[]}
+{"version":3,"sources":["../../src/runtime/renderer_log_dispatcher.ts"],"sourcesContent":["const RENDERER_LOG_DISPATCHER_SYMBOL = Symbol.for('@noego/wood.runtime.renderer-log-dispatcher');\n\nexport type RendererLogLevel = 'debug' | 'info' | 'warn' | 'error' | (string & {});\n\nexport type RendererLogEntry = {\n  level: RendererLogLevel;\n  logger: string;\n  message: string;\n  context?: unknown;\n  timestamp: string;\n  senderId?: number | null;\n};\n\nexport type RendererLogCallback = (entry: RendererLogEntry) => void | Promise<void>;\n\nexport type RendererLogDispatchResult = {\n  ok: boolean;\n  forwarded: boolean;\n  configured: boolean;\n  reason?: 'unconfigured' | 'callback-error';\n  errorMessage?: string;\n};\n\nclass RendererLogDispatcher {\n  private callback: RendererLogCallback | null = null;\n\n  setCallback(callback: RendererLogCallback | null): void {\n    this.callback = callback;\n  }\n\n  getCallback(): RendererLogCallback | null {\n    return this.callback;\n  }\n\n  async dispatch(entry: RendererLogEntry): Promise<RendererLogDispatchResult> {\n    if (!this.callback) {\n      return {\n        ok: true,\n        forwarded: false,\n        configured: false,\n        reason: 'unconfigured',\n      };\n    }\n\n    try {\n      await this.callback(entry);\n      return {\n        ok: true,\n        forwarded: true,\n        configured: true,\n      };\n    } catch (error) {\n      return {\n        ok: false,\n        forwarded: false,\n        configured: true,\n        reason: 'callback-error',\n        errorMessage: error instanceof Error ? error.message : String(error),\n      };\n    }\n  }\n}\n\ntype GlobalWithRendererLogDispatcher = typeof globalThis & {\n  [RENDERER_LOG_DISPATCHER_SYMBOL]?: RendererLogDispatcher;\n};\n\nexport function getRendererLogDispatcher(): RendererLogDispatcher {\n  const globalObj = globalThis as GlobalWithRendererLogDispatcher;\n  if (!globalObj[RENDERER_LOG_DISPATCHER_SYMBOL]) {\n    globalObj[RENDERER_LOG_DISPATCHER_SYMBOL] = new RendererLogDispatcher();\n  }\n  return globalObj[RENDERER_LOG_DISPATCHER_SYMBOL] as RendererLogDispatcher;\n}\n\nexport function clearRendererLogDispatcherForTests(): void {\n  const globalObj = globalThis as GlobalWithRendererLogDispatcher;\n  delete globalObj[RENDERER_LOG_DISPATCHER_SYMBOL];\n}\n"],"mappings":"AAAA,MAAM,iCAAiC,uBAAO,IAAI,6CAA6C;AAuB/F,MAAM,sBAAsB;AAAA,EAA5B;AACE,SAAQ,WAAuC;AAAA;AAAA,EAE/C,YAAY,UAA4C;AACtD,SAAK,WAAW;AAAA,EAClB;AAAA,EAEA,cAA0C;AACxC,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,MAAM,SAAS,OAA6D;AAC1E,QAAI,CAAC,KAAK,UAAU;AAClB,aAAO;AAAA,QACL,IAAI;AAAA,QACJ,WAAW;AAAA,QACX,YAAY;AAAA,QACZ,QAAQ;AAAA,MACV;AAAA,IACF;AAEA,QAAI;AACF,YAAM,KAAK,SAAS,KAAK;AACzB,aAAO;AAAA,QACL,IAAI;AAAA,QACJ,WAAW;AAAA,QACX,YAAY;AAAA,MACd;AAAA,IACF,SAAS,OAAO;AACd,aAAO;AAAA,QACL,IAAI;AAAA,QACJ,WAAW;AAAA,QACX,YAAY;AAAA,QACZ,QAAQ;AAAA,QACR,cAAc,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,MACrE;AAAA,IACF;AAAA,EACF;AACF;AAMO,SAAS,2BAAkD;AAChE,QAAM,YAAY;AAClB,MAAI,CAAC,UAAU,8BAA8B,GAAG;AAC9C,cAAU,8BAA8B,IAAI,IAAI,sBAAsB;AAAA,EACxE;AACA,SAAO,UAAU,8BAA8B;AACjD;AAEO,SAAS,qCAA2C;AACzD,QAAM,YAAY;AAClB,SAAO,UAAU,8BAA8B;AACjD;","names":[]}

package/dist/runtime/renderer_trace_batch_receiver_registry.cjs

@@ -0,0 +1,50 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var renderer_trace_batch_receiver_registry_exports = {};
+__export(renderer_trace_batch_receiver_registry_exports, {
+  clearRendererTraceBatchReceiverForTests: () => clearRendererTraceBatchReceiverForTests,
+  getRendererTraceBatchReceiver: () => getRendererTraceBatchReceiver,
+  setRendererTraceBatchReceiver: () => setRendererTraceBatchReceiver
+});
+module.exports = __toCommonJS(renderer_trace_batch_receiver_registry_exports);
+const RENDERER_TRACE_BATCH_RECEIVER_SYMBOL = /* @__PURE__ */ Symbol.for(
+  "@noego/wood.renderer-trace-batch-receiver"
+);
+function setRendererTraceBatchReceiver(receiver) {
+  const globalObj = globalThis;
+  if (receiver === null) {
+    delete globalObj[RENDERER_TRACE_BATCH_RECEIVER_SYMBOL];
+    return;
+  }
+  globalObj[RENDERER_TRACE_BATCH_RECEIVER_SYMBOL] = receiver;
+}
+function getRendererTraceBatchReceiver() {
+  const globalObj = globalThis;
+  return globalObj[RENDERER_TRACE_BATCH_RECEIVER_SYMBOL] ?? null;
+}
+function clearRendererTraceBatchReceiverForTests() {
+  setRendererTraceBatchReceiver(null);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  clearRendererTraceBatchReceiverForTests,
+  getRendererTraceBatchReceiver,
+  setRendererTraceBatchReceiver
+});
+//# sourceMappingURL=renderer_trace_batch_receiver_registry.cjs.map

package/dist/runtime/renderer_trace_batch_receiver_registry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/runtime/renderer_trace_batch_receiver_registry.ts"],"sourcesContent":["import type { WoodTraceBatchReceiver } from '../tracing/types/wood_trace_batch.types.js';\n\nconst RENDERER_TRACE_BATCH_RECEIVER_SYMBOL = Symbol.for(\n  '@noego/wood.renderer-trace-batch-receiver',\n);\n\ntype GlobalWithRendererTraceBatchReceiver = typeof globalThis & {\n  [RENDERER_TRACE_BATCH_RECEIVER_SYMBOL]?: WoodTraceBatchReceiver;\n};\n\nexport function setRendererTraceBatchReceiver(receiver: WoodTraceBatchReceiver | null): void {\n  const globalObj = globalThis as GlobalWithRendererTraceBatchReceiver;\n  if (receiver === null) {\n    delete globalObj[RENDERER_TRACE_BATCH_RECEIVER_SYMBOL];\n    return;\n  }\n  globalObj[RENDERER_TRACE_BATCH_RECEIVER_SYMBOL] = receiver;\n}\n\nexport function getRendererTraceBatchReceiver(): WoodTraceBatchReceiver | null {\n  const globalObj = globalThis as GlobalWithRendererTraceBatchReceiver;\n  return globalObj[RENDERER_TRACE_BATCH_RECEIVER_SYMBOL] ?? null;\n}\n\nexport function clearRendererTraceBatchReceiverForTests(): void {\n  setRendererTraceBatchReceiver(null);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAEA,MAAM,uCAAuC,uBAAO;AAAA,EAClD;AACF;AAMO,SAAS,8BAA8B,UAA+C;AAC3F,QAAM,YAAY;AAClB,MAAI,aAAa,MAAM;AACrB,WAAO,UAAU,oCAAoC;AACrD;AAAA,EACF;AACA,YAAU,oCAAoC,IAAI;AACpD;AAEO,SAAS,gCAA+D;AAC7E,QAAM,YAAY;AAClB,SAAO,UAAU,oCAAoC,KAAK;AAC5D;AAEO,SAAS,0CAAgD;AAC9D,gCAA8B,IAAI;AACpC;","names":[]}

package/dist/runtime/renderer_trace_batch_receiver_registry.d.cts

@@ -0,0 +1,10 @@
+import { WoodTraceBatchReceiver } from '../tracing/types/wood_trace_batch.types.cjs';
+import '@noego/telemetry/core';
+import '../trace_hub-Cob54qRx.cjs';
+import 'rxjs';
+
+declare function setRendererTraceBatchReceiver(receiver: WoodTraceBatchReceiver | null): void;
+declare function getRendererTraceBatchReceiver(): WoodTraceBatchReceiver | null;
+declare function clearRendererTraceBatchReceiverForTests(): void;
+
+export { clearRendererTraceBatchReceiverForTests, getRendererTraceBatchReceiver, setRendererTraceBatchReceiver };

package/dist/runtime/renderer_trace_batch_receiver_registry.d.ts

@@ -0,0 +1,10 @@
+import { WoodTraceBatchReceiver } from '../tracing/types/wood_trace_batch.types.js';
+import '@noego/telemetry/core';
+import '../trace_hub-Cob54qRx.js';
+import 'rxjs';
+
+declare function setRendererTraceBatchReceiver(receiver: WoodTraceBatchReceiver | null): void;
+declare function getRendererTraceBatchReceiver(): WoodTraceBatchReceiver | null;
+declare function clearRendererTraceBatchReceiverForTests(): void;
+
+export { clearRendererTraceBatchReceiverForTests, getRendererTraceBatchReceiver, setRendererTraceBatchReceiver };

package/dist/runtime/renderer_trace_batch_receiver_registry.js

@@ -0,0 +1,24 @@
+const RENDERER_TRACE_BATCH_RECEIVER_SYMBOL = /* @__PURE__ */ Symbol.for(
+  "@noego/wood.renderer-trace-batch-receiver"
+);
+function setRendererTraceBatchReceiver(receiver) {
+  const globalObj = globalThis;
+  if (receiver === null) {
+    delete globalObj[RENDERER_TRACE_BATCH_RECEIVER_SYMBOL];
+    return;
+  }
+  globalObj[RENDERER_TRACE_BATCH_RECEIVER_SYMBOL] = receiver;
+}
+function getRendererTraceBatchReceiver() {
+  const globalObj = globalThis;
+  return globalObj[RENDERER_TRACE_BATCH_RECEIVER_SYMBOL] ?? null;
+}
+function clearRendererTraceBatchReceiverForTests() {
+  setRendererTraceBatchReceiver(null);
+}
+export {
+  clearRendererTraceBatchReceiverForTests,
+  getRendererTraceBatchReceiver,
+  setRendererTraceBatchReceiver
+};
+//# sourceMappingURL=renderer_trace_batch_receiver_registry.js.map

package/dist/runtime/renderer_trace_batch_receiver_registry.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/runtime/renderer_trace_batch_receiver_registry.ts"],"sourcesContent":["import type { WoodTraceBatchReceiver } from '../tracing/types/wood_trace_batch.types.js';\n\nconst RENDERER_TRACE_BATCH_RECEIVER_SYMBOL = Symbol.for(\n  '@noego/wood.renderer-trace-batch-receiver',\n);\n\ntype GlobalWithRendererTraceBatchReceiver = typeof globalThis & {\n  [RENDERER_TRACE_BATCH_RECEIVER_SYMBOL]?: WoodTraceBatchReceiver;\n};\n\nexport function setRendererTraceBatchReceiver(receiver: WoodTraceBatchReceiver | null): void {\n  const globalObj = globalThis as GlobalWithRendererTraceBatchReceiver;\n  if (receiver === null) {\n    delete globalObj[RENDERER_TRACE_BATCH_RECEIVER_SYMBOL];\n    return;\n  }\n  globalObj[RENDERER_TRACE_BATCH_RECEIVER_SYMBOL] = receiver;\n}\n\nexport function getRendererTraceBatchReceiver(): WoodTraceBatchReceiver | null {\n  const globalObj = globalThis as GlobalWithRendererTraceBatchReceiver;\n  return globalObj[RENDERER_TRACE_BATCH_RECEIVER_SYMBOL] ?? null;\n}\n\nexport function clearRendererTraceBatchReceiverForTests(): void {\n  setRendererTraceBatchReceiver(null);\n}\n"],"mappings":"AAEA,MAAM,uCAAuC,uBAAO;AAAA,EAClD;AACF;AAMO,SAAS,8BAA8B,UAA+C;AAC3F,QAAM,YAAY;AAClB,MAAI,aAAa,MAAM;AACrB,WAAO,UAAU,oCAAoC;AACrD;AAAA,EACF;AACA,YAAU,oCAAoC,IAAI;AACpD;AAEO,SAAS,gCAA+D;AAC7E,QAAM,YAAY;AAClB,SAAO,UAAU,oCAAoC,KAAK;AAC5D;AAEO,SAAS,0CAAgD;AAC9D,gCAA8B,IAAI;AACpC;","names":[]}