@workglow/util 0.2.21 → 0.2.23

package/dist/worker-node.js.map

@@ -6,7 +6,7 @@
     "/**\n * @license\n * Copyright 2025 Steven Roussey <sroussey@gmail.com>\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { Container, globalContainer } from \"./Container\";\n\n/**\n * Service token type for type-safe dependency injection\n */\nexport interface ServiceToken<T> {\n  readonly _type: T;\n  readonly id: string;\n}\n\n/**\n * Create a typed service token\n * @param id Unique identifier for the service\n * @returns A typed service token\n */\nexport function createServiceToken<T>(id: string): ServiceToken<T> {\n  return { id, _type: null as any };\n}\n\n/**\n * Service registry for managing and accessing services\n */\nexport class ServiceRegistry {\n  public container: Container;\n\n  /**\n   * Create a new service registry\n   * @param container Optional container to use (defaults to global container)\n   */\n  constructor(container: Container = globalContainer) {\n    this.container = container;\n  }\n\n  /**\n   * Register a service factory\n   * @param token Service token\n   * @param factory Factory function to create the service\n   * @param singleton Whether the service should be a singleton\n   */\n  register<T>(token: ServiceToken<T>, factory: () => T, singleton = true): void {\n    this.container.register(token.id, factory, singleton);\n  }\n\n  /**\n   * Register a service factory only if the token is not already registered.\n   * @param token Service token\n   * @param factory Factory function to create the service\n   * @param singleton Whether the service should be a singleton\n   */\n  registerIfAbsent<T>(token: ServiceToken<T>, factory: () => T, singleton = true): void {\n    this.container.registerIfAbsent(token.id, factory, singleton);\n  }\n\n  /**\n   * Register a service instance\n   * @param token Service token\n   * @param instance Service instance to register\n   */\n  registerInstance<T>(token: ServiceToken<T>, instance: T): void {\n    this.container.registerInstance(token.id, instance);\n  }\n\n  /**\n   * Get a service by its token\n   * @param token Service token\n   * @returns The service instance\n   */\n  get<T>(token: ServiceToken<T>): T {\n    return this.container.get<T>(token.id);\n  }\n\n  /**\n   * Check if a service is registered\n   * @param token Service token\n   * @returns True if the service is registered\n   */\n  has<T>(token: ServiceToken<T>): boolean {\n    return this.container.has(token.id);\n  }\n\n  /**\n   * Dispose all instantiated services and clear registrations.\n   */\n  async dispose(): Promise<void> {\n    await this.container.dispose();\n  }\n}\n\n/**\n * Global service registry instance\n */\nexport const globalServiceRegistry = new ServiceRegistry(globalContainer);\n",
     "/**\n * @license\n * Copyright 2025 Steven Roussey <sroussey@gmail.com>\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport type { ServiceRegistry } from \"./ServiceRegistry\";\nimport { createServiceToken, globalServiceRegistry } from \"./ServiceRegistry\";\n\n/**\n * A compactor function that converts a resolved instance back to its string ID.\n * Returns undefined if the value cannot be compacted (e.g., missing ID field).\n *\n * @param value The resolved instance to compact\n * @param format The full format string (e.g., \"model:TextEmbedding\", \"storage:tabular\")\n * @param registry The service registry to use for lookups\n */\nexport type InputCompactorFn = (\n  value: unknown,\n  format: string,\n  registry: ServiceRegistry\n) => string | undefined | Promise<string | undefined>;\n\n/**\n * Service token for the input compactor registry.\n * Maps format prefixes to compactor functions.\n */\nexport const INPUT_COMPACTORS =\n  createServiceToken<Map<string, InputCompactorFn>>(\"task.input.compactors\");\n\n// Register default factory if not already registered\nglobalServiceRegistry.registerIfAbsent(\n  INPUT_COMPACTORS,\n  (): Map<string, InputCompactorFn> => new Map(),\n  true\n);\n\n/**\n * Gets the global input compactor registry\n * @returns Map of format prefix to compactor function\n */\nexport function getInputCompactors(): Map<string, InputCompactorFn> {\n  return globalServiceRegistry.get(INPUT_COMPACTORS);\n}\n\n/**\n * Registers an input compactor for a format prefix.\n * The compactor will be called to convert resolved instances back to string IDs.\n *\n * @param formatPrefix The format prefix to match (e.g., \"model\", \"knowledge-base\")\n * @param compactor The compactor function\n *\n * @example\n * ```typescript\n * // Register model compactor — extracts model_id from a ModelConfig\n * registerInputCompactor(\"model\", (value) => {\n *   if (typeof value === \"object\" && value !== null && \"model_id\" in value) {\n *     const id = (value as Record<string, unknown>).model_id;\n *     return typeof id === \"string\" ? id : undefined;\n *   }\n *   return undefined;\n * });\n * ```\n */\nexport function registerInputCompactor(formatPrefix: string, compactor: InputCompactorFn): void {\n  const compactors = getInputCompactors();\n  compactors.set(formatPrefix, compactor);\n}\n",
     "/**\n * @license\n * Copyright 2025 Steven Roussey <sroussey@gmail.com>\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport type { ServiceRegistry } from \"./ServiceRegistry\";\nimport { createServiceToken, globalServiceRegistry } from \"./ServiceRegistry\";\n\n/**\n * A resolver function that converts a string ID to an instance.\n * Returns undefined if the resolver cannot handle this format.\n * Throws an error if the ID is not found.\n *\n * @param id The string ID to resolve\n * @param format The full format string (e.g., \"model:TextEmbedding\", \"storage:tabular\")\n * @param registry The service registry to use for lookups\n */\nexport type InputResolverFn = (\n  id: string,\n  format: string,\n  registry: ServiceRegistry\n) => unknown | Promise<unknown>;\n\n/**\n * Service token for the input resolver registry.\n * Maps format prefixes to resolver functions.\n */\nexport const INPUT_RESOLVERS =\n  createServiceToken<Map<string, InputResolverFn>>(\"task.input.resolvers\");\n\n// Register default factory if not already registered\nglobalServiceRegistry.registerIfAbsent(\n  INPUT_RESOLVERS,\n  (): Map<string, InputResolverFn> => new Map(),\n  true\n);\n\n/**\n * Gets the global input resolver registry\n * @returns Map of format prefix to resolver function\n */\nexport function getInputResolvers(): Map<string, InputResolverFn> {\n  return globalServiceRegistry.get(INPUT_RESOLVERS);\n}\n\n/**\n * Registers an input resolver for a format prefix.\n * The resolver will be called for any format that starts with this prefix.\n *\n * @param formatPrefix The format prefix to match (e.g., \"model\", \"dataset\")\n * @param resolver The resolver function\n *\n * @example\n * ```typescript\n * // Register model resolver\n * registerInputResolver(\"model\", async (id, format, registry) => {\n *   const modelRepo = registry.get(MODEL_REPOSITORY);\n *   const model = await modelRepo.findByName(id);\n *   if (!model) throw new Error(`Model \"${id}\" not found`);\n *   return model;\n * });\n *\n * // Register dataset resolver\n * registerInputResolver(\"dataset\", (id, format, registry) => {\n *   const datasetType = format.split(\":\")[1]; // \"tabular\", \"vector\", etc.\n *   if (datasetType === \"tabular\") {\n *     const datasets = registry.get(TABULAR_DATASETS);\n *     const dataset = datasets.get(id);\n *     if (!dataset) throw new Error(`Dataset \"${id}\" not found`);\n *     return dataset;\n *   }\n *   throw new Error(`Unknown dataset type: ${datasetType}`);\n * });\n * ```\n */\nexport function registerInputResolver(formatPrefix: string, resolver: InputResolverFn): void {\n  const resolvers = getInputResolvers();\n  resolvers.set(formatPrefix, resolver);\n}\n",
-    "/**\n * @copyright\n * Copyright 2026 Steven Roussey\n * All Rights Reserved\n */\n\nexport interface PortCodec<Live = unknown, Wire = unknown> {\n  serialize(value: Live): Promise<Wire>;\n  deserialize(value: Wire): Promise<Live>;\n}\n\n/**\n * Codec registry shared across bundle copies via a Symbol.for key — same pattern\n * as globalContainer. Without this, split entry points (e.g. @workglow/util,\n * @workglow/util/media, @workglow/task-graph) could each see their own Map and\n * fail to find codecs registered by sibling entries.\n */\nconst GLOBAL_CODECS_KEY = Symbol.for(\"@workglow/util/di/portCodecs\");\nconst _g = globalThis as Record<symbol, unknown>;\nif (!_g[GLOBAL_CODECS_KEY]) {\n  _g[GLOBAL_CODECS_KEY] = new Map<string, PortCodec>();\n}\nconst codecs = _g[GLOBAL_CODECS_KEY] as Map<string, PortCodec>;\n\nexport function registerPortCodec<Live = unknown, Wire = unknown>(\n  formatPrefix: string,\n  codec: PortCodec<Live, Wire>,\n): void {\n  codecs.set(formatPrefix, codec as PortCodec);\n}\n\nexport function getPortCodec(format: string): PortCodec | undefined {\n  if (codecs.has(format)) return codecs.get(format);\n  const colon = format.indexOf(\":\");\n  if (colon > 0) {\n    const prefix = format.slice(0, colon);\n    return codecs.get(prefix);\n  }\n  return undefined;\n}\n\n/** @internal — test affordance only. */\nexport function _resetPortCodecsForTests(): void {\n  codecs.clear();\n}\n",
+    "/**\n * @copyright\n * Copyright 2026 Steven Roussey\n * All Rights Reserved\n */\n\nexport interface PortCodec<Live = unknown, Wire = unknown> {\n  serialize(value: Live): Promise<Wire>;\n  deserialize(value: Wire): Promise<Live>;\n}\n\n/**\n * Codec registry shared across bundle copies via a Symbol.for key — same pattern\n * as globalContainer. Without this, split entry points (e.g. @workglow/util,\n * @workglow/util/media, @workglow/task-graph) could each see their own Map and\n * fail to find codecs registered by sibling entries.\n */\nconst GLOBAL_CODECS_KEY = Symbol.for(\"@workglow/util/di/portCodecs\");\nconst _g = globalThis as Record<symbol, unknown>;\nif (!_g[GLOBAL_CODECS_KEY]) {\n  _g[GLOBAL_CODECS_KEY] = new Map<string, PortCodec>();\n}\nconst codecs = _g[GLOBAL_CODECS_KEY] as Map<string, PortCodec>;\n\nexport function registerPortCodec<Live = unknown, Wire = unknown>(\n  formatPrefix: string,\n  codec: PortCodec<Live, Wire>\n): void {\n  codecs.set(formatPrefix, codec as PortCodec);\n}\n\nexport function getPortCodec(format: string): PortCodec | undefined {\n  if (codecs.has(format)) return codecs.get(format);\n  const colon = format.indexOf(\":\");\n  if (colon > 0) {\n    const prefix = format.slice(0, colon);\n    return codecs.get(prefix);\n  }\n  return undefined;\n}\n\n/** @internal — test affordance only. */\nexport function _resetPortCodecsForTests(): void {\n  codecs.clear();\n}\n",
     "/**\n * @license\n * Copyright 2025 Steven Roussey <sroussey@gmail.com>\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport type { ILogger } from \"./ILogger\";\n\n/**\n * Log-level names in ascending severity order.\n */\nexport type LogLevel = \"debug\" | \"info\" | \"warn\" | \"error\" | \"fatal\";\n\nconst LOG_LEVEL_ORDER: Record<LogLevel, number> = {\n  debug: 0,\n  info: 1,\n  warn: 2,\n  error: 3,\n  fatal: 4,\n};\n\nexport interface ConsoleLoggerOptions {\n  readonly bindings?: Record<string, unknown>;\n  readonly level?: LogLevel;\n  readonly timings?: boolean;\n}\n\n/**\n * Logger that delegates to the global `console` object.\n * When created via {@link child}, accumulated bindings are passed\n * as a second argument to every console call.\n *\n * Supports optional level filtering (messages below the configured\n * level are silently discarded) and an opt-in `timings` flag that\n * controls whether {@link time}/{@link timeEnd} produce output.\n */\nexport class ConsoleLogger implements ILogger {\n  private readonly bindings: Record<string, unknown>;\n  private readonly level: LogLevel;\n  private readonly timings: boolean;\n\n  constructor(options: ConsoleLoggerOptions = {}) {\n    this.bindings = options.bindings ?? {};\n    this.level = options.level ?? \"debug\";\n    this.timings = options.timings ?? false;\n  }\n\n  private enabled(level: LogLevel): boolean {\n    return LOG_LEVEL_ORDER[level] >= LOG_LEVEL_ORDER[this.level];\n  }\n\n  info(message: string, meta?: Record<string, unknown>): void {\n    if (!this.enabled(\"info\")) return;\n    const merged = this.merge(meta);\n    if (merged) {\n      console.info(message, merged);\n    } else {\n      console.info(message);\n    }\n  }\n\n  warn(message: string, meta?: Record<string, unknown>): void {\n    if (!this.enabled(\"warn\")) return;\n    const merged = this.merge(meta);\n    if (merged) {\n      console.warn(message, merged);\n    } else {\n      console.warn(message);\n    }\n  }\n\n  error(message: string, meta?: Record<string, unknown>): void {\n    if (!this.enabled(\"error\")) return;\n    const merged = this.merge(meta);\n    if (merged) {\n      console.error(message, merged);\n    } else {\n      console.error(message);\n    }\n  }\n\n  debug(message: string, meta?: Record<string, unknown>): void {\n    if (!this.enabled(\"debug\")) return;\n    const merged = this.merge(meta);\n    if (merged) {\n      console.debug(message, merged);\n    } else {\n      console.debug(message);\n    }\n  }\n\n  fatal(err: Error, message: string, meta?: Record<string, unknown>): void {\n    if (!this.enabled(\"fatal\")) return;\n    const merged = this.merge(meta);\n    if (merged) {\n      console.error(message, { ...merged, error: err });\n    } else {\n      console.error(message, { error: err });\n    }\n  }\n\n  time(label: string, meta?: Record<string, unknown>): void {\n    if (!this.timings) return;\n    const merged = this.merge(meta);\n    if (merged) {\n      console.info(`[time] ${label}`, merged);\n    }\n    console.time(label);\n  }\n\n  timeEnd(label: string, meta?: Record<string, unknown>): void {\n    if (!this.timings) return;\n    console.timeEnd(label);\n    const merged = this.merge(meta);\n    if (merged) {\n      console.info(`[timeEnd] ${label}`, merged);\n    }\n  }\n\n  group(label: string, meta?: Record<string, unknown>): void {\n    const merged = this.merge(meta);\n    if (merged) {\n      console.group(label, merged);\n    } else {\n      console.group(label);\n    }\n  }\n\n  groupEnd(): void {\n    console.groupEnd();\n  }\n\n  child(bindings: Record<string, unknown>): ILogger {\n    return new ConsoleLogger({\n      bindings: { ...this.bindings, ...bindings },\n      level: this.level,\n      timings: this.timings,\n    });\n  }\n\n  private merge(meta: Record<string, unknown> | undefined): Record<string, unknown> | undefined {\n    const hasBindings = Object.keys(this.bindings).length > 0;\n    if (!hasBindings && !meta) return undefined;\n    if (!hasBindings) return meta;\n    if (!meta) return this.bindings;\n    return { ...this.bindings, ...meta };\n  }\n}\n",
     "/**\n * @license\n * Copyright 2025 Steven Roussey <sroussey@gmail.com>\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport type { ILogger } from \"./ILogger\";\n\n/**\n * Silent logger that discards all output.\n * Useful for suppressing log noise in tests.\n */\nexport class NullLogger implements ILogger {\n  info(_message: string, _meta?: Record<string, unknown>): void {}\n  error(_message: string, _meta?: Record<string, unknown>): void {}\n  warn(_message: string, _meta?: Record<string, unknown>): void {}\n  debug(_message: string, _meta?: Record<string, unknown>): void {}\n  fatal(_err: Error, _message: string, _meta?: Record<string, unknown>): void {}\n  time(_label: string, _meta?: Record<string, unknown>): void {}\n  timeEnd(_label: string, _meta?: Record<string, unknown>): void {}\n  group(_label: string, _meta?: Record<string, unknown>): void {}\n  groupEnd(): void {}\n  child(_bindings: Record<string, unknown>): ILogger {\n    return this;\n  }\n}\n",
     "/**\n * @license\n * Copyright 2026 Steven Roussey <sroussey@gmail.com>\n * SPDX-License-Identifier: Apache-2.0\n */\n\n/**\n * Read an environment value from Node `process.env` when defined, otherwise from\n * Vite/browser `import.meta.env`.\n *\n * In Vite dev, `process` is often polyfilled without `DEV`, so reading only\n * `process.env` misses `import.meta.env.DEV` and disables dev-only features\n * (e.g. console telemetry).\n *\n * Boolean `import.meta.env` flags become `\"true\"` or are treated as unset when false\n * so callers using simple truthiness behave as expected.\n */\nexport function readRuntimeEnv(name: string): string | undefined {\n  if (typeof process !== \"undefined\" && process.env) {\n    const fromProcess = process.env[name];\n    if (fromProcess !== undefined) {\n      return fromProcess;\n    }\n  }\n\n  const meta = (import.meta as ImportMeta & { env?: Record<string, string | boolean | undefined> })\n    .env;\n  if (!meta) {\n    return undefined;\n  }\n\n  const value = meta[name];\n  if (value === undefined || value === null) {\n    return undefined;\n  }\n  if (typeof value === \"boolean\") {\n    return value ? \"true\" : undefined;\n  }\n  return String(value);\n}\n",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@workglow/util",
   "type": "module",
-  "version": "0.2.21",
+  "version": "0.2.23",
   "repository": {
     "type": "git",
     "url": "https://github.com/workglow-dev/workglow.git",