@noego/wood 0.1.0 → 0.1.2

package/dist/tracing/trace_hub.js

@@ -8,6 +8,7 @@ const LEVEL_ORDER = {
   error: 3
 };
 let rendererMinLevel = "debug";
+let rendererEnabled = false;
 let customRendererTraceTransport = null;
 function normalizeTraceInput(raw) {
   const input = raw ?? {};
@@ -104,13 +105,17 @@ class TraceHub {
     this.subject = new Subject();
     this.shared$ = this.subject.asObservable().pipe(share());
     this.nextTraceSeq = 1;
-    this.minLevel = "debug";
+    this.minLevels = {
+      main: "debug",
+      renderer: "debug",
+      test: "debug"
+    };
   }
   get events$() {
     return this.shared$;
   }
-  setMinLevel(level) {
-    this.minLevel = level;
+  setMinLevel(process, level) {
+    this.minLevels[process] = level;
   }
   publish(process, level, input) {
     const normalized = normalizeTraceInput(input);
@@ -121,7 +126,7 @@ class TraceHub {
       timestamp: (/* @__PURE__ */ new Date()).toISOString(),
       traceSeq: this.nextTraceSeq++
     };
-    if (LEVEL_ORDER[level] >= LEVEL_ORDER[this.minLevel]) {
+    if (LEVEL_ORDER[level] >= LEVEL_ORDER[this.minLevels[process]]) {
       this.subject.next(event);
     }
     return event;
@@ -141,10 +146,14 @@ function getTraceEvents$() {
   return getGlobalTraceHub().events$;
 }
 function setMainTraceMinLevel(level) {
-  getGlobalTraceHub().setMinLevel(level);
+  getGlobalTraceHub().setMinLevel("main", level);
 }
 function setRendererTraceMinLevel(level) {
   rendererMinLevel = level;
+  getGlobalTraceHub().setMinLevel("renderer", level);
+}
+function setRendererTraceEnabled(enabled) {
+  rendererEnabled = enabled;
 }
 function publishMainTrace(level, input) {
   return getGlobalTraceHub().publish("main", level, input);
@@ -165,6 +174,9 @@ function setRendererTraceTransport(fn) {
   customRendererTraceTransport = fn;
 }
 function emitRendererTrace(level, input) {
+  if (!rendererEnabled) {
+    return;
+  }
   if (LEVEL_ORDER[level] < LEVEL_ORDER[rendererMinLevel]) {
     return;
   }
@@ -192,6 +204,7 @@ function clearTraceHubForTests() {
   const globalObj = globalThis;
   delete globalObj[TRACE_HUB_SYMBOL];
   rendererMinLevel = "debug";
+  rendererEnabled = false;
   customRendererTraceTransport = null;
 }
 export {
@@ -204,6 +217,7 @@ export {
   publishMainTrace,
   publishTestTrace,
   setMainTraceMinLevel,
+  setRendererTraceEnabled,
   setRendererTraceMinLevel,
   setRendererTraceTransport
 };

package/dist/tracing/trace_hub.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/tracing/trace_hub.ts"],"sourcesContent":["import { Observable, Subject, Subscription } from 'rxjs';\nimport { share } from 'rxjs/operators';\n\nexport type TraceLevel = 'debug' | 'info' | 'warn' | 'error';\nexport type TraceProcess = 'main' | 'renderer' | 'test';\n\nexport type TraceInput = {\n  source: string;\n  type: string;\n  message?: string;\n  conversationId?: number | string;\n  payload?: Record<string, unknown>;\n};\n\nexport type TraceEvent = TraceInput & {\n  level: TraceLevel;\n  process: TraceProcess;\n  timestamp: string;\n  traceSeq: number;\n};\n\nexport type TraceDispatchResult = {\n  ok: boolean;\n  forwarded: boolean;\n};\n\nexport type TraceCaptureOptions = {\n  maxEvents?: number;\n};\n\nexport type TraceWaitOptions = {\n  timeoutMs?: number;\n};\n\nconst TRACE_HUB_SYMBOL = Symbol.for('@noego/wood.trace.hub');\n\nconst LEVEL_ORDER: Record<TraceLevel, number> = {\n  debug: 0,\n  info: 1,\n  warn: 2,\n  error: 3,\n};\n\nlet rendererMinLevel: TraceLevel = 'debug';\nlet customRendererTraceTransport: ((payload: unknown) => void) | null = null;\n\ntype PendingWaiter = {\n  predicate: (event: TraceEvent) => boolean;\n  resolve: (event: TraceEvent) => void;\n  reject: (error: Error) => void;\n  timeoutId?: ReturnType<typeof setTimeout>;\n};\n\ntype GlobalWithTraceHub = typeof globalThis & {\n  [TRACE_HUB_SYMBOL]?: TraceHub;\n};\n\ntype TraceBridgeLike = Record<string, unknown> & {\n  __trace?: (payload: unknown) => void;\n};\n\ntype GlobalWithTraceBridge = typeof globalThis & {\n  __NOEGO_WOOD_BRIDGE__?: unknown;\n  wood?: unknown;\n  window?: {\n    __NOEGO_WOOD_BRIDGE__?: unknown;\n    wood?: unknown;\n  };\n};\n\nfunction normalizeTraceInput(raw: unknown): TraceInput {\n  const input = (raw ?? {}) as Partial<TraceInput> & Record<string, unknown>;\n  const source = typeof input.source === 'string' && input.source.trim().length > 0\n    ? input.source\n    : 'unknown';\n  const type = typeof input.type === 'string' && input.type.trim().length > 0\n    ? input.type\n    : 'unknown';\n  const message = typeof input.message === 'string' ? input.message : undefined;\n  const conversationId = typeof input.conversationId === 'number' || typeof input.conversationId === 'string'\n    ? input.conversationId\n    : undefined;\n  const payload = isRecord(input.payload) ? { ...input.payload } : undefined;\n\n  return {\n    source,\n    type,\n    ...(message ? { message } : {}),\n    ...(conversationId !== undefined ? { conversationId } : {}),\n    ...(payload ? { payload } : {}),\n  };\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction resolveTraceBridge(): TraceBridgeLike | null {\n  const globalObj = globalThis as GlobalWithTraceBridge;\n  const bridge = globalObj.__NOEGO_WOOD_BRIDGE__\n    ?? globalObj.window?.__NOEGO_WOOD_BRIDGE__\n    ?? globalObj.wood\n    ?? globalObj.window?.wood;\n  if (!bridge || typeof bridge !== 'object') {\n    return null;\n  }\n  return bridge as TraceBridgeLike;\n}\n\nexport class TraceCapture {\n  private readonly buffer: TraceEvent[] = [];\n  private readonly pending = new Set<PendingWaiter>();\n  private readonly maxEvents: number;\n  private subscription: Subscription;\n\n  constructor(\n    source$: Observable<TraceEvent>,\n    options: TraceCaptureOptions = {},\n  ) {\n    this.maxEvents = Math.max(1, options.maxEvents ?? 1000);\n    this.subscription = source$.subscribe((event) => {\n      this.buffer.push(event);\n      if (this.buffer.length > this.maxEvents) {\n        this.buffer.splice(0, this.buffer.length - this.maxEvents);\n      }\n      for (const waiter of Array.from(this.pending)) {\n        if (!waiter.predicate(event)) {\n          continue;\n        }\n        if (waiter.timeoutId) {\n          clearTimeout(waiter.timeoutId);\n        }\n        this.pending.delete(waiter);\n        waiter.resolve(event);\n      }\n    });\n  }\n\n  events(): TraceEvent[] {\n    return [...this.buffer];\n  }\n\n  async waitFor(\n    predicate: (event: TraceEvent) => boolean,\n    options: TraceWaitOptions = {},\n  ): Promise<TraceEvent> {\n    const existing = this.buffer.find(predicate);\n    if (existing) {\n      return existing;\n    }\n\n    return new Promise<TraceEvent>((resolve, reject) => {\n      const waiter: PendingWaiter = {\n        predicate,\n        resolve,\n        reject,\n      };\n      const timeoutMs = options.timeoutMs ?? 5000;\n      waiter.timeoutId = setTimeout(() => {\n        this.pending.delete(waiter);\n        reject(new Error(`Timed out waiting for trace event after ${timeoutMs}ms`));\n      }, timeoutMs);\n      this.pending.add(waiter);\n    });\n  }\n\n  async writeArtifact(targetPath: string): Promise<void> {\n    const [{ mkdir, writeFile }, pathModule] = await Promise.all([\n      import('node:fs/promises'),\n      import('node:path'),\n    ]);\n    await mkdir(pathModule.dirname(targetPath), { recursive: true });\n    const lines = this.buffer.map((event) => JSON.stringify(event)).join('\\n');\n    await writeFile(targetPath, `${lines}${lines.length > 0 ? '\\n' : ''}`, 'utf8');\n  }\n\n  stop(): void {\n    for (const waiter of this.pending) {\n      if (waiter.timeoutId) {\n        clearTimeout(waiter.timeoutId);\n      }\n      waiter.reject(new Error('Trace capture stopped before predicate matched'));\n    }\n    this.pending.clear();\n    this.subscription.unsubscribe();\n  }\n}\n\nclass TraceHub {\n  private readonly subject = new Subject<TraceEvent>();\n  private readonly shared$ = this.subject.asObservable().pipe(share());\n  private nextTraceSeq = 1;\n  private minLevel: TraceLevel = 'debug';\n\n  get events$(): Observable<TraceEvent> {\n    return this.shared$;\n  }\n\n  setMinLevel(level: TraceLevel): void {\n    this.minLevel = level;\n  }\n\n  publish(process: TraceProcess, level: TraceLevel, input: unknown): TraceEvent {\n    const normalized = normalizeTraceInput(input);\n    const event: TraceEvent = {\n      ...normalized,\n      level,\n      process,\n      timestamp: new Date().toISOString(),\n      traceSeq: this.nextTraceSeq++,\n    };\n    if (LEVEL_ORDER[level] >= LEVEL_ORDER[this.minLevel]) {\n      this.subject.next(event);\n    }\n    return event;\n  }\n\n  capture(options: TraceCaptureOptions = {}): TraceCapture {\n    return new TraceCapture(this.events$, options);\n  }\n}\n\nfunction getGlobalTraceHub(): TraceHub {\n  const globalObj = globalThis as GlobalWithTraceHub;\n  if (!globalObj[TRACE_HUB_SYMBOL]) {\n    globalObj[TRACE_HUB_SYMBOL] = new TraceHub();\n  }\n  return globalObj[TRACE_HUB_SYMBOL] as TraceHub;\n}\n\nexport function getTraceEvents$(): Observable<TraceEvent> {\n  return getGlobalTraceHub().events$;\n}\n\nexport function setMainTraceMinLevel(level: TraceLevel): void {\n  getGlobalTraceHub().setMinLevel(level);\n}\n\nexport function setRendererTraceMinLevel(level: TraceLevel): void {\n  rendererMinLevel = level;\n}\n\nexport function publishMainTrace(level: TraceLevel, input: unknown): TraceEvent {\n  return getGlobalTraceHub().publish('main', level, input);\n}\n\nexport function publishTestTrace(process: TraceProcess, level: TraceLevel, input: unknown): TraceEvent {\n  return getGlobalTraceHub().publish(process, level, input);\n}\n\nexport function dispatchRendererTracePayload(rawPayload: unknown): TraceDispatchResult {\n  const payload = (rawPayload ?? {}) as Partial<TraceInput> & { level?: TraceLevel };\n  const level = payload.level === 'debug' || payload.level === 'info' || payload.level === 'warn' || payload.level === 'error'\n    ? payload.level\n    : 'info';\n  getGlobalTraceHub().publish('renderer', level, payload);\n  return {\n    ok: true,\n    forwarded: true,\n  };\n}\n\nexport function setRendererTraceTransport(fn: ((payload: unknown) => void) | null): void {\n  customRendererTraceTransport = fn;\n}\n\nexport function emitRendererTrace(level: TraceLevel, input: TraceInput): void {\n  if (LEVEL_ORDER[level] < LEVEL_ORDER[rendererMinLevel]) {\n    return;\n  }\n  const normalized = { ...normalizeTraceInput(input), level };\n\n  if (customRendererTraceTransport) {\n    try {\n      customRendererTraceTransport(normalized);\n      return;\n    } catch {\n      // Fall through to bridge.__trace\n    }\n  }\n\n  const bridge = resolveTraceBridge();\n  if (!bridge || typeof bridge.__trace !== 'function') {\n    return;\n  }\n  try {\n    bridge.__trace(normalized);\n  } catch {\n    // Tracing is observational and must never break the caller.\n  }\n}\n\nexport function createTraceCapture(options: TraceCaptureOptions = {}): TraceCapture {\n  return getGlobalTraceHub().capture(options);\n}\n\nexport function clearTraceHubForTests(): void {\n  const globalObj = globalThis as GlobalWithTraceHub;\n  delete globalObj[TRACE_HUB_SYMBOL];\n  rendererMinLevel = 'debug';\n  customRendererTraceTransport = null;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/tracing/trace_hub.ts"],"sourcesContent":["import { Observable, Subject, Subscription } from 'rxjs';\nimport { share } from 'rxjs/operators';\n\nexport type TraceLevel = 'debug' | 'info' | 'warn' | 'error';\nexport type TraceProcess = 'main' | 'renderer' | 'test';\n\nexport type TraceInput = {\n  source: string;\n  type: string;\n  message?: string;\n  conversationId?: number | string;\n  payload?: Record<string, unknown>;\n};\n\nexport type TraceEvent = TraceInput & {\n  level: TraceLevel;\n  process: TraceProcess;\n  timestamp: string;\n  traceSeq: number;\n};\n\nexport type TraceDispatchResult = {\n  ok: boolean;\n  forwarded: boolean;\n};\n\nexport type TraceCaptureOptions = {\n  maxEvents?: number;\n};\n\nexport type TraceWaitOptions = {\n  timeoutMs?: number;\n};\n\nconst TRACE_HUB_SYMBOL = Symbol.for('@noego/wood.trace.hub');\n\nconst LEVEL_ORDER: Record<TraceLevel, number> = {\n  debug: 0,\n  info: 1,\n  warn: 2,\n  error: 3,\n};\n\nlet rendererMinLevel: TraceLevel = 'debug';\nlet rendererEnabled = false;\nlet customRendererTraceTransport: ((payload: unknown) => void) | null = null;\n\ntype PendingWaiter = {\n  predicate: (event: TraceEvent) => boolean;\n  resolve: (event: TraceEvent) => void;\n  reject: (error: Error) => void;\n  timeoutId?: ReturnType<typeof setTimeout>;\n};\n\ntype GlobalWithTraceHub = typeof globalThis & {\n  [TRACE_HUB_SYMBOL]?: TraceHub;\n};\n\ntype TraceBridgeLike = Record<string, unknown> & {\n  __trace?: (payload: unknown) => void;\n};\n\ntype GlobalWithTraceBridge = typeof globalThis & {\n  __NOEGO_WOOD_BRIDGE__?: unknown;\n  wood?: unknown;\n  window?: {\n    __NOEGO_WOOD_BRIDGE__?: unknown;\n    wood?: unknown;\n  };\n};\n\nfunction normalizeTraceInput(raw: unknown): TraceInput {\n  const input = (raw ?? {}) as Partial<TraceInput> & Record<string, unknown>;\n  const source = typeof input.source === 'string' && input.source.trim().length > 0\n    ? input.source\n    : 'unknown';\n  const type = typeof input.type === 'string' && input.type.trim().length > 0\n    ? input.type\n    : 'unknown';\n  const message = typeof input.message === 'string' ? input.message : undefined;\n  const conversationId = typeof input.conversationId === 'number' || typeof input.conversationId === 'string'\n    ? input.conversationId\n    : undefined;\n  const payload = isRecord(input.payload) ? { ...input.payload } : undefined;\n\n  return {\n    source,\n    type,\n    ...(message ? { message } : {}),\n    ...(conversationId !== undefined ? { conversationId } : {}),\n    ...(payload ? { payload } : {}),\n  };\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction resolveTraceBridge(): TraceBridgeLike | null {\n  const globalObj = globalThis as GlobalWithTraceBridge;\n  const bridge = globalObj.__NOEGO_WOOD_BRIDGE__\n    ?? globalObj.window?.__NOEGO_WOOD_BRIDGE__\n    ?? globalObj.wood\n    ?? globalObj.window?.wood;\n  if (!bridge || typeof bridge !== 'object') {\n    return null;\n  }\n  return bridge as TraceBridgeLike;\n}\n\nexport class TraceCapture {\n  private readonly buffer: TraceEvent[] = [];\n  private readonly pending = new Set<PendingWaiter>();\n  private readonly maxEvents: number;\n  private subscription: Subscription;\n\n  constructor(\n    source$: Observable<TraceEvent>,\n    options: TraceCaptureOptions = {},\n  ) {\n    this.maxEvents = Math.max(1, options.maxEvents ?? 1000);\n    this.subscription = source$.subscribe((event) => {\n      this.buffer.push(event);\n      if (this.buffer.length > this.maxEvents) {\n        this.buffer.splice(0, this.buffer.length - this.maxEvents);\n      }\n      for (const waiter of Array.from(this.pending)) {\n        if (!waiter.predicate(event)) {\n          continue;\n        }\n        if (waiter.timeoutId) {\n          clearTimeout(waiter.timeoutId);\n        }\n        this.pending.delete(waiter);\n        waiter.resolve(event);\n      }\n    });\n  }\n\n  events(): TraceEvent[] {\n    return [...this.buffer];\n  }\n\n  async waitFor(\n    predicate: (event: TraceEvent) => boolean,\n    options: TraceWaitOptions = {},\n  ): Promise<TraceEvent> {\n    const existing = this.buffer.find(predicate);\n    if (existing) {\n      return existing;\n    }\n\n    return new Promise<TraceEvent>((resolve, reject) => {\n      const waiter: PendingWaiter = {\n        predicate,\n        resolve,\n        reject,\n      };\n      const timeoutMs = options.timeoutMs ?? 5000;\n      waiter.timeoutId = setTimeout(() => {\n        this.pending.delete(waiter);\n        reject(new Error(`Timed out waiting for trace event after ${timeoutMs}ms`));\n      }, timeoutMs);\n      this.pending.add(waiter);\n    });\n  }\n\n  async writeArtifact(targetPath: string): Promise<void> {\n    const [{ mkdir, writeFile }, pathModule] = await Promise.all([\n      import('node:fs/promises'),\n      import('node:path'),\n    ]);\n    await mkdir(pathModule.dirname(targetPath), { recursive: true });\n    const lines = this.buffer.map((event) => JSON.stringify(event)).join('\\n');\n    await writeFile(targetPath, `${lines}${lines.length > 0 ? '\\n' : ''}`, 'utf8');\n  }\n\n  stop(): void {\n    for (const waiter of this.pending) {\n      if (waiter.timeoutId) {\n        clearTimeout(waiter.timeoutId);\n      }\n      waiter.reject(new Error('Trace capture stopped before predicate matched'));\n    }\n    this.pending.clear();\n    this.subscription.unsubscribe();\n  }\n}\n\nclass TraceHub {\n  private readonly subject = new Subject<TraceEvent>();\n  private readonly shared$ = this.subject.asObservable().pipe(share());\n  private nextTraceSeq = 1;\n  private minLevels: Record<TraceProcess, TraceLevel> = {\n    main: 'debug',\n    renderer: 'debug',\n    test: 'debug',\n  };\n\n  get events$(): Observable<TraceEvent> {\n    return this.shared$;\n  }\n\n  setMinLevel(process: TraceProcess, level: TraceLevel): void {\n    this.minLevels[process] = level;\n  }\n\n  publish(process: TraceProcess, level: TraceLevel, input: unknown): TraceEvent {\n    const normalized = normalizeTraceInput(input);\n    const event: TraceEvent = {\n      ...normalized,\n      level,\n      process,\n      timestamp: new Date().toISOString(),\n      traceSeq: this.nextTraceSeq++,\n    };\n    if (LEVEL_ORDER[level] >= LEVEL_ORDER[this.minLevels[process]]) {\n      this.subject.next(event);\n    }\n    return event;\n  }\n\n  capture(options: TraceCaptureOptions = {}): TraceCapture {\n    return new TraceCapture(this.events$, options);\n  }\n}\n\nfunction getGlobalTraceHub(): TraceHub {\n  const globalObj = globalThis as GlobalWithTraceHub;\n  if (!globalObj[TRACE_HUB_SYMBOL]) {\n    globalObj[TRACE_HUB_SYMBOL] = new TraceHub();\n  }\n  return globalObj[TRACE_HUB_SYMBOL] as TraceHub;\n}\n\nexport function getTraceEvents$(): Observable<TraceEvent> {\n  return getGlobalTraceHub().events$;\n}\n\nexport function setMainTraceMinLevel(level: TraceLevel): void {\n  getGlobalTraceHub().setMinLevel('main', level);\n}\n\nexport function setRendererTraceMinLevel(level: TraceLevel): void {\n  rendererMinLevel = level;\n  getGlobalTraceHub().setMinLevel('renderer', level);\n}\n\nexport function setRendererTraceEnabled(enabled: boolean): void {\n  rendererEnabled = enabled;\n}\n\nexport function publishMainTrace(level: TraceLevel, input: unknown): TraceEvent {\n  return getGlobalTraceHub().publish('main', level, input);\n}\n\nexport function publishTestTrace(process: TraceProcess, level: TraceLevel, input: unknown): TraceEvent {\n  return getGlobalTraceHub().publish(process, level, input);\n}\n\nexport function dispatchRendererTracePayload(rawPayload: unknown): TraceDispatchResult {\n  const payload = (rawPayload ?? {}) as Partial<TraceInput> & { level?: TraceLevel };\n  const level = payload.level === 'debug' || payload.level === 'info' || payload.level === 'warn' || payload.level === 'error'\n    ? payload.level\n    : 'info';\n  getGlobalTraceHub().publish('renderer', level, payload);\n  return {\n    ok: true,\n    forwarded: true,\n  };\n}\n\nexport function setRendererTraceTransport(fn: ((payload: unknown) => void) | null): void {\n  customRendererTraceTransport = fn;\n}\n\nexport function emitRendererTrace(level: TraceLevel, input: TraceInput): void {\n  if (!rendererEnabled) {\n    return;\n  }\n  if (LEVEL_ORDER[level] < LEVEL_ORDER[rendererMinLevel]) {\n    return;\n  }\n  const normalized = { ...normalizeTraceInput(input), level };\n\n  if (customRendererTraceTransport) {\n    try {\n      customRendererTraceTransport(normalized);\n      return;\n    } catch {\n      // Fall through to bridge.__trace\n    }\n  }\n\n  const bridge = resolveTraceBridge();\n  if (!bridge || typeof bridge.__trace !== 'function') {\n    return;\n  }\n  try {\n    bridge.__trace(normalized);\n  } catch {\n    // Tracing is observational and must never break the caller.\n  }\n}\n\nexport function createTraceCapture(options: TraceCaptureOptions = {}): TraceCapture {\n  return getGlobalTraceHub().capture(options);\n}\n\nexport function clearTraceHubForTests(): void {\n  const globalObj = globalThis as GlobalWithTraceHub;\n  delete globalObj[TRACE_HUB_SYMBOL];\n  rendererMinLevel = 'debug';\n  rendererEnabled = false;\n  customRendererTraceTransport = null;\n}\n"],"mappings":"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","names":[]}

package/dist/tracing/trace_provider.cjs

@@ -38,29 +38,68 @@ module.exports = __toCommonJS(trace_provider_exports);
 var import_ioc = require("@noego/ioc");
 var import_trace_hub = require("./trace_hub.js");
 class FrameworkTracer {
+  extend(context) {
+    return new ContextualTracer(this, context);
+  }
   capture(options = {}) {
     return (0, import_trace_hub.createTraceCapture)(options);
   }
 }
+class ContextualTracer extends FrameworkTracer {
+  constructor(parent, context) {
+    super();
+    this.parent = parent;
+    this.context = context;
+  }
+  get mode() {
+    return this.parent.mode;
+  }
+  get process() {
+    return this.parent.process;
+  }
+  get events$() {
+    return this.parent.events$;
+  }
+  debug(event) {
+    this.parent.debug(this.mergeEvent(event));
+  }
+  info(event) {
+    this.parent.info(this.mergeEvent(event));
+  }
+  warn(event) {
+    this.parent.warn(this.mergeEvent(event));
+  }
+  error(event) {
+    this.parent.error(this.mergeEvent(event));
+  }
+  mergeEvent(event) {
+    return {
+      ...this.context,
+      ...event
+    };
+  }
+}
 let TraceProviderConfiguration = class {
   constructor() {
     this.mode = "live";
     this.runtime = "main";
     this.minLevel = "debug";
+    this.enabled = null;
   }
   configureMode(mode) {
     this.mode = mode;
   }
   configureRuntime(runtime) {
     this.runtime = runtime;
+    this.applyRuntimeConfiguration();
   }
   configureMinLevel(level) {
     this.minLevel = level;
-    if (this.runtime === "renderer") {
-      (0, import_trace_hub.setRendererTraceMinLevel)(level);
-    } else {
-      (0, import_trace_hub.setMainTraceMinLevel)(level);
-    }
+    this.applyRuntimeConfiguration();
+  }
+  configureEnabled(enabled) {
+    this.enabled = enabled;
+    this.applyRuntimeConfiguration();
   }
   getMode() {
     return this.mode;
@@ -71,6 +110,17 @@ let TraceProviderConfiguration = class {
   getMinLevel() {
     return this.minLevel;
   }
+  getEnabled() {
+    return this.enabled ?? (this.runtime === "renderer" ? false : true);
+  }
+  applyRuntimeConfiguration() {
+    if (this.runtime === "renderer") {
+      (0, import_trace_hub.setRendererTraceEnabled)(this.getEnabled());
+      (0, import_trace_hub.setRendererTraceMinLevel)(this.minLevel);
+      return;
+    }
+    (0, import_trace_hub.setMainTraceMinLevel)(this.minLevel);
+  }
 };
 TraceProviderConfiguration = __decorateClass([
   (0, import_ioc.Component)({ scope: import_ioc.LoadAs.Singleton })
@@ -154,11 +204,18 @@ TestTracer = __decorateClass([
   (0, import_ioc.Component)({ scope: import_ioc.LoadAs.Singleton }),
   __decorateParam(0, (0, import_ioc.Inject)(TraceProviderConfiguration))
 ], TestTracer);
-let TraceProvider = class {
+let TraceProvider = class extends FrameworkTracer {
   constructor(configuration, container) {
+    super();
     this.configuration = configuration;
     this.container = container;
   }
+  get mode() {
+    return this.resolveImplementation().mode;
+  }
+  get process() {
+    return this.resolveImplementation().process;
+  }
   get events$() {
     return this.resolveImplementation().events$;
   }

package/dist/tracing/trace_provider.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/tracing/trace_provider.ts"],"sourcesContent":["import { Component, Inject, LoadAs, Provider, SCOPED_CONTAINER, type IContainer } from '@noego/ioc';\nimport type { Observable } from 'rxjs';\nimport {\n  createTraceCapture,\n  emitRendererTrace,\n  getTraceEvents$,\n  publishMainTrace,\n  publishTestTrace,\n  setMainTraceMinLevel,\n  setRendererTraceMinLevel,\n  type TraceCapture,\n  type TraceCaptureOptions,\n  type TraceEvent,\n  type TraceInput,\n  type TraceLevel,\n  type TraceProcess,\n} from './trace_hub.js';\n\nexport type TraceProviderMode = 'live' | 'test';\nexport type TraceRuntime = 'main' | 'renderer' | 'test';\n\nexport abstract class FrameworkTracer {\n  abstract readonly mode: TraceProviderMode;\n  abstract readonly process: TraceProcess;\n  abstract readonly events$: Observable<TraceEvent>;\n  abstract debug(event: TraceInput): void;\n  abstract info(event: TraceInput): void;\n  abstract warn(event: TraceInput): void;\n  abstract error(event: TraceInput): void;\n\n  capture(options: TraceCaptureOptions = {}): TraceCapture {\n    return createTraceCapture(options);\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class TraceProviderConfiguration {\n  private mode: TraceProviderMode = 'live';\n  private runtime: TraceRuntime = 'main';\n  private minLevel: TraceLevel = 'debug';\n\n  configureMode(mode: TraceProviderMode): void {\n    this.mode = mode;\n  }\n\n  configureRuntime(runtime: TraceRuntime): void {\n    this.runtime = runtime;\n  }\n\n  configureMinLevel(level: TraceLevel): void {\n    this.minLevel = level;\n    if (this.runtime === 'renderer') {\n      setRendererTraceMinLevel(level);\n    } else {\n      setMainTraceMinLevel(level);\n    }\n  }\n\n  getMode(): TraceProviderMode {\n    return this.mode;\n  }\n\n  getRuntime(): TraceRuntime {\n    return this.runtime;\n  }\n\n  getMinLevel(): TraceLevel {\n    return this.minLevel;\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class MainTracer extends FrameworkTracer {\n  readonly mode = 'live' as const;\n  readonly process = 'main' as const;\n  readonly events$ = getTraceEvents$();\n\n  debug(event: TraceInput): void {\n    publishMainTrace('debug', event);\n  }\n\n  info(event: TraceInput): void {\n    publishMainTrace('info', event);\n  }\n\n  warn(event: TraceInput): void {\n    publishMainTrace('warn', event);\n  }\n\n  error(event: TraceInput): void {\n    publishMainTrace('error', event);\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class RendererTracer extends FrameworkTracer {\n  readonly mode = 'live' as const;\n  readonly process = 'renderer' as const;\n  readonly events$ = getTraceEvents$();\n\n  debug(event: TraceInput): void {\n    emitRendererTrace('debug', event);\n  }\n\n  info(event: TraceInput): void {\n    emitRendererTrace('info', event);\n  }\n\n  warn(event: TraceInput): void {\n    emitRendererTrace('warn', event);\n  }\n\n  error(event: TraceInput): void {\n    emitRendererTrace('error', event);\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class TestTracer extends FrameworkTracer {\n  readonly mode = 'test' as const;\n  readonly events$ = getTraceEvents$();\n\n  constructor(\n    @Inject(TraceProviderConfiguration) private readonly configuration: TraceProviderConfiguration,\n  ) {\n    super();\n  }\n\n  get process(): TraceProcess {\n    const runtime = this.configuration.getRuntime();\n    if (runtime === 'renderer') return 'renderer';\n    if (runtime === 'main') return 'main';\n    return 'test';\n  }\n\n  debug(event: TraceInput): void {\n    this.publish('debug', event);\n  }\n\n  info(event: TraceInput): void {\n    this.publish('info', event);\n  }\n\n  warn(event: TraceInput): void {\n    this.publish('warn', event);\n  }\n\n  error(event: TraceInput): void {\n    this.publish('error', event);\n  }\n\n  private publish(level: TraceLevel, event: TraceInput): void {\n    publishTestTrace(this.process, level, event);\n  }\n}\n\n@Provider()\nexport class TraceProvider {\n  constructor(\n    @Inject(TraceProviderConfiguration) private readonly configuration: TraceProviderConfiguration,\n    @Inject(SCOPED_CONTAINER) private readonly container: IContainer,\n  ) {}\n\n  get events$(): Observable<TraceEvent> {\n    return this.resolveImplementation().events$;\n  }\n\n  debug(event: TraceInput): void {\n    this.resolveImplementation().debug(event);\n  }\n\n  info(event: TraceInput): void {\n    this.resolveImplementation().info(event);\n  }\n\n  warn(event: TraceInput): void {\n    this.resolveImplementation().warn(event);\n  }\n\n  error(event: TraceInput): void {\n    this.resolveImplementation().error(event);\n  }\n\n  capture(options: TraceCaptureOptions = {}): TraceCapture {\n    return this.resolveImplementation().capture(options);\n  }\n\n  private resolveImplementation(): FrameworkTracer {\n    const mode = this.configuration.getMode();\n    if (mode === 'test') {\n      return this.resolveSync(TestTracer);\n    }\n\n    if (this.configuration.getRuntime() === 'renderer') {\n      return this.resolveSync(RendererTracer);\n    }\n\n    return this.resolveSync(MainTracer);\n  }\n\n  private resolveSync<T>(token: new (...args: any[]) => T): T {\n    const resolved = this.container.instance<T, true>(token);\n    if (resolved instanceof Promise) {\n      throw new Error(`${token.name} must resolve synchronously`);\n    }\n    return resolved;\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/tracing/trace_provider.ts"],"sourcesContent":["import { Component, Inject, LoadAs, Provider, SCOPED_CONTAINER, type IContainer } from '@noego/ioc';\nimport type { Observable } from 'rxjs';\nimport {\n  createTraceCapture,\n  emitRendererTrace,\n  getTraceEvents$,\n  publishMainTrace,\n  publishTestTrace,\n  setMainTraceMinLevel,\n  setRendererTraceEnabled,\n  setRendererTraceMinLevel,\n  type TraceCapture,\n  type TraceCaptureOptions,\n  type TraceEvent,\n  type TraceInput,\n  type TraceLevel,\n  type TraceProcess,\n} from './trace_hub.js';\n\nexport type TraceProviderMode = 'live' | 'test';\nexport type TraceRuntime = 'main' | 'renderer' | 'test';\nexport type TraceContext = Partial<TraceInput>;\n\nexport abstract class FrameworkTracer {\n  abstract readonly mode: TraceProviderMode;\n  abstract readonly process: TraceProcess;\n  abstract readonly events$: Observable<TraceEvent>;\n  abstract debug(event: TraceInput): void;\n  abstract info(event: TraceInput): void;\n  abstract warn(event: TraceInput): void;\n  abstract error(event: TraceInput): void;\n\n  extend(context: TraceContext): FrameworkTracer {\n    return new ContextualTracer(this, context);\n  }\n\n  capture(options: TraceCaptureOptions = {}): TraceCapture {\n    return createTraceCapture(options);\n  }\n}\n\nclass ContextualTracer extends FrameworkTracer {\n  constructor(\n    private readonly parent: FrameworkTracer,\n    private readonly context: TraceContext,\n  ) {\n    super();\n  }\n\n  get mode(): TraceProviderMode {\n    return this.parent.mode;\n  }\n\n  get process(): TraceProcess {\n    return this.parent.process;\n  }\n\n  get events$(): Observable<TraceEvent> {\n    return this.parent.events$;\n  }\n\n  debug(event: TraceInput): void {\n    this.parent.debug(this.mergeEvent(event));\n  }\n\n  info(event: TraceInput): void {\n    this.parent.info(this.mergeEvent(event));\n  }\n\n  warn(event: TraceInput): void {\n    this.parent.warn(this.mergeEvent(event));\n  }\n\n  error(event: TraceInput): void {\n    this.parent.error(this.mergeEvent(event));\n  }\n\n  private mergeEvent(event: TraceInput): TraceInput {\n    return {\n      ...this.context,\n      ...event,\n    };\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class TraceProviderConfiguration {\n  private mode: TraceProviderMode = 'live';\n  private runtime: TraceRuntime = 'main';\n  private minLevel: TraceLevel = 'debug';\n  private enabled: boolean | null = null;\n\n  configureMode(mode: TraceProviderMode): void {\n    this.mode = mode;\n  }\n\n  configureRuntime(runtime: TraceRuntime): void {\n    this.runtime = runtime;\n    this.applyRuntimeConfiguration();\n  }\n\n  configureMinLevel(level: TraceLevel): void {\n    this.minLevel = level;\n    this.applyRuntimeConfiguration();\n  }\n\n  configureEnabled(enabled: boolean): void {\n    this.enabled = enabled;\n    this.applyRuntimeConfiguration();\n  }\n\n  getMode(): TraceProviderMode {\n    return this.mode;\n  }\n\n  getRuntime(): TraceRuntime {\n    return this.runtime;\n  }\n\n  getMinLevel(): TraceLevel {\n    return this.minLevel;\n  }\n\n  getEnabled(): boolean {\n    return this.enabled ?? (this.runtime === 'renderer' ? false : true);\n  }\n\n  private applyRuntimeConfiguration(): void {\n    if (this.runtime === 'renderer') {\n      setRendererTraceEnabled(this.getEnabled());\n      setRendererTraceMinLevel(this.minLevel);\n      return;\n    }\n\n    setMainTraceMinLevel(this.minLevel);\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class MainTracer extends FrameworkTracer {\n  readonly mode = 'live' as const;\n  readonly process = 'main' as const;\n  readonly events$ = getTraceEvents$();\n\n  debug(event: TraceInput): void {\n    publishMainTrace('debug', event);\n  }\n\n  info(event: TraceInput): void {\n    publishMainTrace('info', event);\n  }\n\n  warn(event: TraceInput): void {\n    publishMainTrace('warn', event);\n  }\n\n  error(event: TraceInput): void {\n    publishMainTrace('error', event);\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class RendererTracer extends FrameworkTracer {\n  readonly mode = 'live' as const;\n  readonly process = 'renderer' as const;\n  readonly events$ = getTraceEvents$();\n\n  debug(event: TraceInput): void {\n    emitRendererTrace('debug', event);\n  }\n\n  info(event: TraceInput): void {\n    emitRendererTrace('info', event);\n  }\n\n  warn(event: TraceInput): void {\n    emitRendererTrace('warn', event);\n  }\n\n  error(event: TraceInput): void {\n    emitRendererTrace('error', event);\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class TestTracer extends FrameworkTracer {\n  readonly mode = 'test' as const;\n  readonly events$ = getTraceEvents$();\n\n  constructor(\n    @Inject(TraceProviderConfiguration) private readonly configuration: TraceProviderConfiguration,\n  ) {\n    super();\n  }\n\n  get process(): TraceProcess {\n    const runtime = this.configuration.getRuntime();\n    if (runtime === 'renderer') return 'renderer';\n    if (runtime === 'main') return 'main';\n    return 'test';\n  }\n\n  debug(event: TraceInput): void {\n    this.publish('debug', event);\n  }\n\n  info(event: TraceInput): void {\n    this.publish('info', event);\n  }\n\n  warn(event: TraceInput): void {\n    this.publish('warn', event);\n  }\n\n  error(event: TraceInput): void {\n    this.publish('error', event);\n  }\n\n  private publish(level: TraceLevel, event: TraceInput): void {\n    publishTestTrace(this.process, level, event);\n  }\n}\n\n@Provider()\nexport class TraceProvider extends FrameworkTracer {\n  constructor(\n    @Inject(TraceProviderConfiguration) private readonly configuration: TraceProviderConfiguration,\n    @Inject(SCOPED_CONTAINER) private readonly container: IContainer,\n  ) {\n    super();\n  }\n\n  get mode(): TraceProviderMode {\n    return this.resolveImplementation().mode;\n  }\n\n  get process(): TraceProcess {\n    return this.resolveImplementation().process;\n  }\n\n  get events$(): Observable<TraceEvent> {\n    return this.resolveImplementation().events$;\n  }\n\n  debug(event: TraceInput): void {\n    this.resolveImplementation().debug(event);\n  }\n\n  info(event: TraceInput): void {\n    this.resolveImplementation().info(event);\n  }\n\n  warn(event: TraceInput): void {\n    this.resolveImplementation().warn(event);\n  }\n\n  error(event: TraceInput): void {\n    this.resolveImplementation().error(event);\n  }\n\n  capture(options: TraceCaptureOptions = {}): TraceCapture {\n    return this.resolveImplementation().capture(options);\n  }\n\n  private resolveImplementation(): FrameworkTracer {\n    const mode = this.configuration.getMode();\n    if (mode === 'test') {\n      return this.resolveSync(TestTracer);\n    }\n\n    if (this.configuration.getRuntime() === 'renderer') {\n      return this.resolveSync(RendererTracer);\n    }\n\n    return this.resolveSync(MainTracer);\n  }\n\n  private resolveSync<T>(token: new (...args: any[]) => T): T {\n    const resolved = this.container.instance<T, true>(token);\n    if (resolved instanceof Promise) {\n      throw new Error(`${token.name} must resolve synchronously`);\n    }\n    return resolved;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/tracing/trace_provider.d.cts

@@ -4,6 +4,7 @@ import { Observable } from 'rxjs';
 
 type TraceProviderMode = 'live' | 'test';
 type TraceRuntime = 'main' | 'renderer' | 'test';
+type TraceContext = Partial<TraceInput>;
 declare abstract class FrameworkTracer {
     abstract readonly mode: TraceProviderMode;
     abstract readonly process: TraceProcess;
@@ -12,18 +13,23 @@ declare abstract class FrameworkTracer {
     abstract info(event: TraceInput): void;
     abstract warn(event: TraceInput): void;
     abstract error(event: TraceInput): void;
+    extend(context: TraceContext): FrameworkTracer;
     capture(options?: TraceCaptureOptions): TraceCapture;
 }
 declare class TraceProviderConfiguration {
     private mode;
     private runtime;
     private minLevel;
+    private enabled;
     configureMode(mode: TraceProviderMode): void;
     configureRuntime(runtime: TraceRuntime): void;
     configureMinLevel(level: TraceLevel): void;
+    configureEnabled(enabled: boolean): void;
     getMode(): TraceProviderMode;
     getRuntime(): TraceRuntime;
     getMinLevel(): TraceLevel;
+    getEnabled(): boolean;
+    private applyRuntimeConfiguration;
 }
 declare class MainTracer extends FrameworkTracer {
     readonly mode: "live";
@@ -55,10 +61,12 @@ declare class TestTracer extends FrameworkTracer {
     error(event: TraceInput): void;
     private publish;
 }
-declare class TraceProvider {
+declare class TraceProvider extends FrameworkTracer {
     private readonly configuration;
     private readonly container;
     constructor(configuration: TraceProviderConfiguration, container: IContainer);
+    get mode(): TraceProviderMode;
+    get process(): TraceProcess;
     get events$(): Observable<TraceEvent>;
     debug(event: TraceInput): void;
     info(event: TraceInput): void;
@@ -69,4 +77,4 @@ declare class TraceProvider {
     private resolveSync;
 }
 
-export { FrameworkTracer, MainTracer, RendererTracer, TestTracer, TraceProvider, TraceProviderConfiguration, type TraceProviderMode, type TraceRuntime };
+export { FrameworkTracer, MainTracer, RendererTracer, TestTracer, type TraceContext, TraceProvider, TraceProviderConfiguration, type TraceProviderMode, type TraceRuntime };

package/dist/tracing/trace_provider.d.ts

@@ -4,6 +4,7 @@ import { Observable } from 'rxjs';
 
 type TraceProviderMode = 'live' | 'test';
 type TraceRuntime = 'main' | 'renderer' | 'test';
+type TraceContext = Partial<TraceInput>;
 declare abstract class FrameworkTracer {
     abstract readonly mode: TraceProviderMode;
     abstract readonly process: TraceProcess;
@@ -12,18 +13,23 @@ declare abstract class FrameworkTracer {
     abstract info(event: TraceInput): void;
     abstract warn(event: TraceInput): void;
     abstract error(event: TraceInput): void;
+    extend(context: TraceContext): FrameworkTracer;
     capture(options?: TraceCaptureOptions): TraceCapture;
 }
 declare class TraceProviderConfiguration {
     private mode;
     private runtime;
     private minLevel;
+    private enabled;
     configureMode(mode: TraceProviderMode): void;
     configureRuntime(runtime: TraceRuntime): void;
     configureMinLevel(level: TraceLevel): void;
+    configureEnabled(enabled: boolean): void;
     getMode(): TraceProviderMode;
     getRuntime(): TraceRuntime;
     getMinLevel(): TraceLevel;
+    getEnabled(): boolean;
+    private applyRuntimeConfiguration;
 }
 declare class MainTracer extends FrameworkTracer {
     readonly mode: "live";
@@ -55,10 +61,12 @@ declare class TestTracer extends FrameworkTracer {
     error(event: TraceInput): void;
     private publish;
 }
-declare class TraceProvider {
+declare class TraceProvider extends FrameworkTracer {
     private readonly configuration;
     private readonly container;
     constructor(configuration: TraceProviderConfiguration, container: IContainer);
+    get mode(): TraceProviderMode;
+    get process(): TraceProcess;
     get events$(): Observable<TraceEvent>;
     debug(event: TraceInput): void;
     info(event: TraceInput): void;
@@ -69,4 +77,4 @@ declare class TraceProvider {
     private resolveSync;
 }
 
-export { FrameworkTracer, MainTracer, RendererTracer, TestTracer, TraceProvider, TraceProviderConfiguration, type TraceProviderMode, type TraceRuntime };
+export { FrameworkTracer, MainTracer, RendererTracer, TestTracer, type TraceContext, TraceProvider, TraceProviderConfiguration, type TraceProviderMode, type TraceRuntime };

package/dist/tracing/trace_provider.js

@@ -17,32 +17,72 @@ import {
   publishMainTrace,
   publishTestTrace,
   setMainTraceMinLevel,
+  setRendererTraceEnabled,
   setRendererTraceMinLevel
 } from "./trace_hub.js";
 class FrameworkTracer {
+  extend(context) {
+    return new ContextualTracer(this, context);
+  }
   capture(options = {}) {
     return createTraceCapture(options);
   }
 }
+class ContextualTracer extends FrameworkTracer {
+  constructor(parent, context) {
+    super();
+    this.parent = parent;
+    this.context = context;
+  }
+  get mode() {
+    return this.parent.mode;
+  }
+  get process() {
+    return this.parent.process;
+  }
+  get events$() {
+    return this.parent.events$;
+  }
+  debug(event) {
+    this.parent.debug(this.mergeEvent(event));
+  }
+  info(event) {
+    this.parent.info(this.mergeEvent(event));
+  }
+  warn(event) {
+    this.parent.warn(this.mergeEvent(event));
+  }
+  error(event) {
+    this.parent.error(this.mergeEvent(event));
+  }
+  mergeEvent(event) {
+    return {
+      ...this.context,
+      ...event
+    };
+  }
+}
 let TraceProviderConfiguration = class {
   constructor() {
     this.mode = "live";
     this.runtime = "main";
     this.minLevel = "debug";
+    this.enabled = null;
   }
   configureMode(mode) {
     this.mode = mode;
   }
   configureRuntime(runtime) {
     this.runtime = runtime;
+    this.applyRuntimeConfiguration();
   }
   configureMinLevel(level) {
     this.minLevel = level;
-    if (this.runtime === "renderer") {
-      setRendererTraceMinLevel(level);
-    } else {
-      setMainTraceMinLevel(level);
-    }
+    this.applyRuntimeConfiguration();
+  }
+  configureEnabled(enabled) {
+    this.enabled = enabled;
+    this.applyRuntimeConfiguration();
   }
   getMode() {
     return this.mode;
@@ -53,6 +93,17 @@ let TraceProviderConfiguration = class {
   getMinLevel() {
     return this.minLevel;
   }
+  getEnabled() {
+    return this.enabled ?? (this.runtime === "renderer" ? false : true);
+  }
+  applyRuntimeConfiguration() {
+    if (this.runtime === "renderer") {
+      setRendererTraceEnabled(this.getEnabled());
+      setRendererTraceMinLevel(this.minLevel);
+      return;
+    }
+    setMainTraceMinLevel(this.minLevel);
+  }
 };
 TraceProviderConfiguration = __decorateClass([
   Component({ scope: LoadAs.Singleton })
@@ -136,11 +187,18 @@ TestTracer = __decorateClass([
   Component({ scope: LoadAs.Singleton }),
   __decorateParam(0, Inject(TraceProviderConfiguration))
 ], TestTracer);
-let TraceProvider = class {
+let TraceProvider = class extends FrameworkTracer {
   constructor(configuration, container) {
+    super();
     this.configuration = configuration;
     this.container = container;
   }
+  get mode() {
+    return this.resolveImplementation().mode;
+  }
+  get process() {
+    return this.resolveImplementation().process;
+  }
   get events$() {
     return this.resolveImplementation().events$;
   }

package/dist/tracing/trace_provider.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/tracing/trace_provider.ts"],"sourcesContent":["import { Component, Inject, LoadAs, Provider, SCOPED_CONTAINER, type IContainer } from '@noego/ioc';\nimport type { Observable } from 'rxjs';\nimport {\n  createTraceCapture,\n  emitRendererTrace,\n  getTraceEvents$,\n  publishMainTrace,\n  publishTestTrace,\n  setMainTraceMinLevel,\n  setRendererTraceMinLevel,\n  type TraceCapture,\n  type TraceCaptureOptions,\n  type TraceEvent,\n  type TraceInput,\n  type TraceLevel,\n  type TraceProcess,\n} from './trace_hub.js';\n\nexport type TraceProviderMode = 'live' | 'test';\nexport type TraceRuntime = 'main' | 'renderer' | 'test';\n\nexport abstract class FrameworkTracer {\n  abstract readonly mode: TraceProviderMode;\n  abstract readonly process: TraceProcess;\n  abstract readonly events$: Observable<TraceEvent>;\n  abstract debug(event: TraceInput): void;\n  abstract info(event: TraceInput): void;\n  abstract warn(event: TraceInput): void;\n  abstract error(event: TraceInput): void;\n\n  capture(options: TraceCaptureOptions = {}): TraceCapture {\n    return createTraceCapture(options);\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class TraceProviderConfiguration {\n  private mode: TraceProviderMode = 'live';\n  private runtime: TraceRuntime = 'main';\n  private minLevel: TraceLevel = 'debug';\n\n  configureMode(mode: TraceProviderMode): void {\n    this.mode = mode;\n  }\n\n  configureRuntime(runtime: TraceRuntime): void {\n    this.runtime = runtime;\n  }\n\n  configureMinLevel(level: TraceLevel): void {\n    this.minLevel = level;\n    if (this.runtime === 'renderer') {\n      setRendererTraceMinLevel(level);\n    } else {\n      setMainTraceMinLevel(level);\n    }\n  }\n\n  getMode(): TraceProviderMode {\n    return this.mode;\n  }\n\n  getRuntime(): TraceRuntime {\n    return this.runtime;\n  }\n\n  getMinLevel(): TraceLevel {\n    return this.minLevel;\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class MainTracer extends FrameworkTracer {\n  readonly mode = 'live' as const;\n  readonly process = 'main' as const;\n  readonly events$ = getTraceEvents$();\n\n  debug(event: TraceInput): void {\n    publishMainTrace('debug', event);\n  }\n\n  info(event: TraceInput): void {\n    publishMainTrace('info', event);\n  }\n\n  warn(event: TraceInput): void {\n    publishMainTrace('warn', event);\n  }\n\n  error(event: TraceInput): void {\n    publishMainTrace('error', event);\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class RendererTracer extends FrameworkTracer {\n  readonly mode = 'live' as const;\n  readonly process = 'renderer' as const;\n  readonly events$ = getTraceEvents$();\n\n  debug(event: TraceInput): void {\n    emitRendererTrace('debug', event);\n  }\n\n  info(event: TraceInput): void {\n    emitRendererTrace('info', event);\n  }\n\n  warn(event: TraceInput): void {\n    emitRendererTrace('warn', event);\n  }\n\n  error(event: TraceInput): void {\n    emitRendererTrace('error', event);\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class TestTracer extends FrameworkTracer {\n  readonly mode = 'test' as const;\n  readonly events$ = getTraceEvents$();\n\n  constructor(\n    @Inject(TraceProviderConfiguration) private readonly configuration: TraceProviderConfiguration,\n  ) {\n    super();\n  }\n\n  get process(): TraceProcess {\n    const runtime = this.configuration.getRuntime();\n    if (runtime === 'renderer') return 'renderer';\n    if (runtime === 'main') return 'main';\n    return 'test';\n  }\n\n  debug(event: TraceInput): void {\n    this.publish('debug', event);\n  }\n\n  info(event: TraceInput): void {\n    this.publish('info', event);\n  }\n\n  warn(event: TraceInput): void {\n    this.publish('warn', event);\n  }\n\n  error(event: TraceInput): void {\n    this.publish('error', event);\n  }\n\n  private publish(level: TraceLevel, event: TraceInput): void {\n    publishTestTrace(this.process, level, event);\n  }\n}\n\n@Provider()\nexport class TraceProvider {\n  constructor(\n    @Inject(TraceProviderConfiguration) private readonly configuration: TraceProviderConfiguration,\n    @Inject(SCOPED_CONTAINER) private readonly container: IContainer,\n  ) {}\n\n  get events$(): Observable<TraceEvent> {\n    return this.resolveImplementation().events$;\n  }\n\n  debug(event: TraceInput): void {\n    this.resolveImplementation().debug(event);\n  }\n\n  info(event: TraceInput): void {\n    this.resolveImplementation().info(event);\n  }\n\n  warn(event: TraceInput): void {\n    this.resolveImplementation().warn(event);\n  }\n\n  error(event: TraceInput): void {\n    this.resolveImplementation().error(event);\n  }\n\n  capture(options: TraceCaptureOptions = {}): TraceCapture {\n    return this.resolveImplementation().capture(options);\n  }\n\n  private resolveImplementation(): FrameworkTracer {\n    const mode = this.configuration.getMode();\n    if (mode === 'test') {\n      return this.resolveSync(TestTracer);\n    }\n\n    if (this.configuration.getRuntime() === 'renderer') {\n      return this.resolveSync(RendererTracer);\n    }\n\n    return this.resolveSync(MainTracer);\n  }\n\n  private resolveSync<T>(token: new (...args: any[]) => T): T {\n    const resolved = this.container.instance<T, true>(token);\n    if (resolved instanceof Promise) {\n      throw new Error(`${token.name} must resolve synchronously`);\n    }\n    return resolved;\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/tracing/trace_provider.ts"],"sourcesContent":["import { Component, Inject, LoadAs, Provider, SCOPED_CONTAINER, type IContainer } from '@noego/ioc';\nimport type { Observable } from 'rxjs';\nimport {\n  createTraceCapture,\n  emitRendererTrace,\n  getTraceEvents$,\n  publishMainTrace,\n  publishTestTrace,\n  setMainTraceMinLevel,\n  setRendererTraceEnabled,\n  setRendererTraceMinLevel,\n  type TraceCapture,\n  type TraceCaptureOptions,\n  type TraceEvent,\n  type TraceInput,\n  type TraceLevel,\n  type TraceProcess,\n} from './trace_hub.js';\n\nexport type TraceProviderMode = 'live' | 'test';\nexport type TraceRuntime = 'main' | 'renderer' | 'test';\nexport type TraceContext = Partial<TraceInput>;\n\nexport abstract class FrameworkTracer {\n  abstract readonly mode: TraceProviderMode;\n  abstract readonly process: TraceProcess;\n  abstract readonly events$: Observable<TraceEvent>;\n  abstract debug(event: TraceInput): void;\n  abstract info(event: TraceInput): void;\n  abstract warn(event: TraceInput): void;\n  abstract error(event: TraceInput): void;\n\n  extend(context: TraceContext): FrameworkTracer {\n    return new ContextualTracer(this, context);\n  }\n\n  capture(options: TraceCaptureOptions = {}): TraceCapture {\n    return createTraceCapture(options);\n  }\n}\n\nclass ContextualTracer extends FrameworkTracer {\n  constructor(\n    private readonly parent: FrameworkTracer,\n    private readonly context: TraceContext,\n  ) {\n    super();\n  }\n\n  get mode(): TraceProviderMode {\n    return this.parent.mode;\n  }\n\n  get process(): TraceProcess {\n    return this.parent.process;\n  }\n\n  get events$(): Observable<TraceEvent> {\n    return this.parent.events$;\n  }\n\n  debug(event: TraceInput): void {\n    this.parent.debug(this.mergeEvent(event));\n  }\n\n  info(event: TraceInput): void {\n    this.parent.info(this.mergeEvent(event));\n  }\n\n  warn(event: TraceInput): void {\n    this.parent.warn(this.mergeEvent(event));\n  }\n\n  error(event: TraceInput): void {\n    this.parent.error(this.mergeEvent(event));\n  }\n\n  private mergeEvent(event: TraceInput): TraceInput {\n    return {\n      ...this.context,\n      ...event,\n    };\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class TraceProviderConfiguration {\n  private mode: TraceProviderMode = 'live';\n  private runtime: TraceRuntime = 'main';\n  private minLevel: TraceLevel = 'debug';\n  private enabled: boolean | null = null;\n\n  configureMode(mode: TraceProviderMode): void {\n    this.mode = mode;\n  }\n\n  configureRuntime(runtime: TraceRuntime): void {\n    this.runtime = runtime;\n    this.applyRuntimeConfiguration();\n  }\n\n  configureMinLevel(level: TraceLevel): void {\n    this.minLevel = level;\n    this.applyRuntimeConfiguration();\n  }\n\n  configureEnabled(enabled: boolean): void {\n    this.enabled = enabled;\n    this.applyRuntimeConfiguration();\n  }\n\n  getMode(): TraceProviderMode {\n    return this.mode;\n  }\n\n  getRuntime(): TraceRuntime {\n    return this.runtime;\n  }\n\n  getMinLevel(): TraceLevel {\n    return this.minLevel;\n  }\n\n  getEnabled(): boolean {\n    return this.enabled ?? (this.runtime === 'renderer' ? false : true);\n  }\n\n  private applyRuntimeConfiguration(): void {\n    if (this.runtime === 'renderer') {\n      setRendererTraceEnabled(this.getEnabled());\n      setRendererTraceMinLevel(this.minLevel);\n      return;\n    }\n\n    setMainTraceMinLevel(this.minLevel);\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class MainTracer extends FrameworkTracer {\n  readonly mode = 'live' as const;\n  readonly process = 'main' as const;\n  readonly events$ = getTraceEvents$();\n\n  debug(event: TraceInput): void {\n    publishMainTrace('debug', event);\n  }\n\n  info(event: TraceInput): void {\n    publishMainTrace('info', event);\n  }\n\n  warn(event: TraceInput): void {\n    publishMainTrace('warn', event);\n  }\n\n  error(event: TraceInput): void {\n    publishMainTrace('error', event);\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class RendererTracer extends FrameworkTracer {\n  readonly mode = 'live' as const;\n  readonly process = 'renderer' as const;\n  readonly events$ = getTraceEvents$();\n\n  debug(event: TraceInput): void {\n    emitRendererTrace('debug', event);\n  }\n\n  info(event: TraceInput): void {\n    emitRendererTrace('info', event);\n  }\n\n  warn(event: TraceInput): void {\n    emitRendererTrace('warn', event);\n  }\n\n  error(event: TraceInput): void {\n    emitRendererTrace('error', event);\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class TestTracer extends FrameworkTracer {\n  readonly mode = 'test' as const;\n  readonly events$ = getTraceEvents$();\n\n  constructor(\n    @Inject(TraceProviderConfiguration) private readonly configuration: TraceProviderConfiguration,\n  ) {\n    super();\n  }\n\n  get process(): TraceProcess {\n    const runtime = this.configuration.getRuntime();\n    if (runtime === 'renderer') return 'renderer';\n    if (runtime === 'main') return 'main';\n    return 'test';\n  }\n\n  debug(event: TraceInput): void {\n    this.publish('debug', event);\n  }\n\n  info(event: TraceInput): void {\n    this.publish('info', event);\n  }\n\n  warn(event: TraceInput): void {\n    this.publish('warn', event);\n  }\n\n  error(event: TraceInput): void {\n    this.publish('error', event);\n  }\n\n  private publish(level: TraceLevel, event: TraceInput): void {\n    publishTestTrace(this.process, level, event);\n  }\n}\n\n@Provider()\nexport class TraceProvider extends FrameworkTracer {\n  constructor(\n    @Inject(TraceProviderConfiguration) private readonly configuration: TraceProviderConfiguration,\n    @Inject(SCOPED_CONTAINER) private readonly container: IContainer,\n  ) {\n    super();\n  }\n\n  get mode(): TraceProviderMode {\n    return this.resolveImplementation().mode;\n  }\n\n  get process(): TraceProcess {\n    return this.resolveImplementation().process;\n  }\n\n  get events$(): Observable<TraceEvent> {\n    return this.resolveImplementation().events$;\n  }\n\n  debug(event: TraceInput): void {\n    this.resolveImplementation().debug(event);\n  }\n\n  info(event: TraceInput): void {\n    this.resolveImplementation().info(event);\n  }\n\n  warn(event: TraceInput): void {\n    this.resolveImplementation().warn(event);\n  }\n\n  error(event: TraceInput): void {\n    this.resolveImplementation().error(event);\n  }\n\n  capture(options: TraceCaptureOptions = {}): TraceCapture {\n    return this.resolveImplementation().capture(options);\n  }\n\n  private resolveImplementation(): FrameworkTracer {\n    const mode = this.configuration.getMode();\n    if (mode === 'test') {\n      return this.resolveSync(TestTracer);\n    }\n\n    if (this.configuration.getRuntime() === 'renderer') {\n      return this.resolveSync(RendererTracer);\n    }\n\n    return this.resolveSync(MainTracer);\n  }\n\n  private resolveSync<T>(token: new (...args: any[]) => T): T {\n    const resolved = this.container.instance<T, true>(token);\n    if (resolved instanceof Promise) {\n      throw new Error(`${token.name} must resolve synchronously`);\n    }\n    return resolved;\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noego/wood",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -18,8 +18,10 @@
     "dist",
     "bin",
     "loaders",
-    "src/stick/WoodRecursiveRender.svelte",
-    "src/components/"
+    "src/components/",
+    "src/client/controller_contract.ts",
+    "src/controller/controller_lifecycle.ts",
+    "src/navigation/navigation_identity.ts"
   ],
   "exports": {
     ".": {
@@ -84,21 +86,21 @@
     "prepublishOnly": "npm run build && npm run typecheck && npm test"
   },
   "dependencies": {
-    "@noego/ioc": "^0.2.3",
-    "@noego/stitch": "^1.0.3",
+    "@noego/ioc": "^0.3.1",
     "@noego/logger": "^0.0.2",
+    "@noego/stitch": "^1.0.3",
     "ajv": "^8.x",
     "ajv-formats": "^3.x",
-    "js-yaml": "^4.x",
     "chokidar": "^4.x",
-    "rxjs": "^7.x",
+    "glob": "^11.x",
+    "js-yaml": "^4.x",
     "path-to-regexp": "^8.x",
-    "glob": "^11.x"
+    "rxjs": "^7.x"
   },
   "peerDependencies": {
-    "svelte": "^5.x",
     "electron": ">=28.0.0",
-    "playwright": "^1.40.0"
+    "playwright": "^1.40.0",
+    "svelte": "^5.x"
   },
   "peerDependenciesMeta": {
     "playwright": {
@@ -106,14 +108,14 @@
     }
   },
   "devDependencies": {
-    "tsup": "^8.5.0",
-    "typescript": "^5.8.3",
-    "@types/node": "^20.10.4",
     "@types/js-yaml": "^4.x",
-    "vitest": "^3.x",
-    "electron-vite": "^2.x",
+    "@types/node": "^20.10.4",
     "electron-builder": "^25.x",
+    "electron-vite": "^2.x",
     "esbuild": "^0.25.x",
-    "playwright": "^1.40.0"
+    "playwright": "^1.40.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.8.3",
+    "vitest": "^3.x"
   }
 }