@vielzeug/rune 1.1.2 → 2.0.0

package/dist/transports.js.map

@@ -1 +1 @@
-{"version":3,"file":"transports.js","names":[],"sources":["../src/transports.ts"],"sourcesContent":["import type {\n  BatchHandle,\n  BatchTransportOptions,\n  Bindings,\n  JsonTransportOptions,\n  LogEntry,\n  PipeOptions,\n  RedactTransportOptions,\n  RemoteLogData,\n  RemoteTransportOptions,\n  SampleTransportOptions,\n  Transport,\n} from './types';\n\nimport { warn } from './_dev';\nimport { isUnsafeObjectKey } from './_prototype';\nimport { isLevelEnabled } from './types';\n\nexport type { RemoteLogData };\n\n/* ─── Environment detection ─── */\n\nfunction detectEnv(): 'development' | 'production' {\n  if (typeof window === 'undefined') {\n    return (globalThis as Record<string, unknown> & { process?: { env?: { NODE_ENV?: string } } }).process?.env\n      ?.NODE_ENV === 'production'\n      ? 'production'\n      : 'development';\n  }\n\n  return (import.meta as ImportMeta & { env?: { PROD?: boolean } }).env?.PROD ? 'production' : 'development';\n}\n\n/* ─── remoteTransport ─── */\n\n/**\n * Forwards log entries asynchronously to a remote handler.\n * The handler is fire-and-forget. Use onError to observe delivery failures.\n * Console and remote thresholds are fully independent.\n *\n * **Security note:** serialized `Error` objects include the full `stack` trace,\n * which may expose internal file paths. Use `redactTransport` or a middleware\n * to strip `err.stack` before forwarding in production if this is a concern.\n *\n * @example\n * remoteTransport({\n *   handler: async (type, data) => {\n *     await fetch('/api/logs', { body: JSON.stringify(data), method: 'POST' });\n *   },\n *   level: 'error',\n * })\n */\nexport function remoteTransport(options: RemoteTransportOptions): Transport {\n  const { handler } = options;\n  const level = options.level ?? 'debug';\n  const env = options.env ?? detectEnv();\n  const onError = options.onError ?? ((err: unknown) => warn(`remote transport error: ${String(err)}`));\n\n  return (entry: LogEntry): void => {\n    if (!isLevelEnabled(level, entry.level)) return;\n\n    const hasData = Object.keys(entry.data).length > 0;\n    const payload: RemoteLogData = {\n      data: hasData ? entry.data : undefined,\n      env,\n      level: entry.level,\n      message: entry.message,\n      namespace: entry.namespace || undefined,\n      timestamp: entry.timestamp.toISOString(),\n    };\n\n    Promise.resolve()\n      .then(() => handler(entry.level, payload))\n      .catch((err: unknown) => onError(err, payload));\n  };\n}\n\n/* ─── jsonTransport ─── */\n\nfunction makeCircularReplacer(): (_key: string, value: unknown) => unknown {\n  const seen = new WeakSet();\n\n  return (_key: string, value: unknown): unknown => {\n    if (typeof value === 'object' && value !== null) {\n      if (seen.has(value)) return '[Circular]';\n\n      seen.add(value);\n    }\n\n    return value;\n  };\n}\n\n/**\n * Writes newline-delimited JSON (NDJSON) to stdout or a custom output function.\n * Useful for structured log aggregation pipelines in Node.js (ELK, Datadog, etc.).\n *\n * @example\n * jsonTransport({ level: 'info' })\n * jsonTransport({ safe: true }) // handles circular references gracefully\n * jsonTransport({ output: (line) => fs.appendFileSync('app.log', line + '\\n') })\n */\nexport function jsonTransport(options: JsonTransportOptions = {}): Transport {\n  const level = options.level ?? 'debug';\n  const f = options.fields ?? {};\n  const fLevel = f.level ?? 'level';\n  const fTime = f.time ?? 'time';\n  const fNs = f.ns ?? 'ns';\n  const fMsg = f.msg ?? 'msg';\n  const safe = options.safe ?? false;\n  const output =\n    options.output ??\n    ((line: string) => {\n      (\n        globalThis as Record<string, unknown> & { process?: { stdout?: { write: (s: string) => void } } }\n      ).process?.stdout?.write(line + '\\n');\n    });\n\n  return (entry: LogEntry): void => {\n    if (!isLevelEnabled(level, entry.level)) return;\n\n    const record: Record<string, unknown> = {\n      ...entry.data,\n      [fLevel]: entry.level,\n      [fTime]: entry.timestamp.toISOString(),\n      ...(entry.namespace && { [fNs]: entry.namespace }),\n      ...(entry.message !== undefined && { [fMsg]: entry.message }),\n    };\n\n    output(JSON.stringify(record, safe ? makeCircularReplacer() : undefined));\n  };\n}\n\n/* ─── batchTransport ─── */\n\n/**\n * Buffers log entries and flushes them in batches, reducing I/O overhead.\n * Flushes when the buffer reaches maxSize or after the interval elapses.\n *\n * Returns a `BatchHandle` with `.transport`, `.flush()`, and `.dispose()` methods:\n * - `.transport` — pass to `createLogger({ transports: [handle.transport] })`\n * - `.flush()` — immediately send buffered entries without stopping the timer\n * - `.dispose()` — stop the interval and flush remaining entries (call on shutdown)\n *\n * Use `onFlushError` to observe or retry failed flushes (e.g. dead-letter queue).\n *\n * @example\n * const batch = batchTransport({\n *   onFlush: (entries) => sendToCollector(entries),\n *   onFlushError: (entries, err) => deadLetter.push(entries),\n *   interval: 10_000,\n *   maxSize: 100,\n * });\n * createLogger({ transports: [batch.transport] });\n * batch.dispose(); // call on app shutdown\n */\nexport function batchTransport(options: BatchTransportOptions): BatchHandle {\n  const level = options.level ?? 'debug';\n  const maxSize = options.maxSize ?? 50;\n  const maxBuffer = options.maxBuffer;\n  const interval = options.interval ?? 5000;\n\n  let buffer: LogEntry[] = [];\n  let timer: ReturnType<typeof setInterval> | undefined;\n  let batchDisposed = false;\n\n  function flush(): void {\n    if (buffer.length === 0) return;\n\n    const entries = buffer;\n\n    buffer = [];\n\n    Promise.resolve()\n      .then(() => options.onFlush(entries))\n      .catch((err: unknown) => options.onFlushError?.(entries, err));\n  }\n\n  const transportFn: Transport = (entry: LogEntry): void => {\n    if (batchDisposed) return;\n\n    if (!isLevelEnabled(level, entry.level)) return;\n\n    if (!timer) timer = setInterval(flush, interval);\n\n    buffer.push(entry);\n\n    if (maxBuffer !== undefined && buffer.length > maxBuffer) {\n      buffer = buffer.slice(buffer.length - maxBuffer);\n    }\n\n    if (buffer.length >= maxSize) flush();\n  };\n\n  const handle: BatchHandle = {\n    dispose(): void {\n      if (batchDisposed) return;\n\n      batchDisposed = true;\n\n      if (timer) {\n        clearInterval(timer);\n        timer = undefined;\n      }\n\n      flush();\n    },\n    get disposed(): boolean {\n      return batchDisposed;\n    },\n    flush,\n    [Symbol.dispose](): void {\n      handle.dispose();\n    },\n    transport: transportFn,\n  };\n\n  return handle;\n}\n\n/* ─── sampleTransport ─── */\n\n/**\n * Probabilistically forwards entries to a downstream transport.\n * Useful for reducing volume of high-frequency debug logs in production.\n *\n * @example\n * sampleTransport({ rate: 0.1, transport: remoteTransport({ handler }) })\n */\nexport function sampleTransport(options: SampleTransportOptions): Transport {\n  const { rate, transport } = options;\n  const level = options.level ?? 'debug';\n\n  return (entry: LogEntry): void => {\n    if (!isLevelEnabled(level, entry.level)) return;\n\n    if (Math.random() < rate) transport(entry);\n  };\n}\n\n/* ─── redactTransport ─── */\n\n/**\n * Strips sensitive fields from `data` before forwarding to a downstream transport.\n * Redaction is applied recursively at any depth, including inside arrays.\n *\n * @example\n * redactTransport({\n *   keys: ['password', 'token', 'ssn'],\n *   replacement: '[REDACTED]',\n *   transport: remoteTransport({ handler }),\n * })\n */\nexport function redactTransport(options: RedactTransportOptions): Transport {\n  const { keys, maxDepth = 20, replacement = '[REDACTED]', transport } = options;\n\n  for (const key of keys) {\n    if (key.includes('.')) {\n      warn(\n        `redactTransport: key \"${key}\" contains a dot. Dot-path notation is not supported — use the plain field name (e.g. 'password') to redact at any depth.`,\n      );\n    }\n  }\n\n  const keySet = new Set(keys);\n\n  function redactValue(v: unknown, depth = 0): unknown {\n    if (depth > maxDepth) {\n      warn(\n        `redactTransport: object nesting depth exceeded ${maxDepth} — redaction truncated at this level. Sensitive fields below depth ${maxDepth} may not be redacted.`,\n      );\n\n      return v;\n    }\n\n    if (Array.isArray(v)) return v.map((item) => redactValue(item, depth + 1));\n\n    if (typeof v === 'object' && v !== null) return redactObject(v as Bindings, depth + 1);\n\n    return v;\n  }\n\n  function redactObject(obj: Bindings, depth = 0): Bindings {\n    const result: Bindings = {};\n\n    for (const [k, v] of Object.entries(obj)) {\n      // Guard against a `__proto__`/`constructor`/`prototype` field name hijacking result's own\n      // prototype via the bracket-assignment accessor — see _prototype.ts.\n      if (isUnsafeObjectKey(k)) continue;\n\n      result[k] = keySet.has(k) ? replacement : redactValue(v, depth);\n    }\n\n    return result;\n  }\n\n  return (entry: LogEntry): void => {\n    transport({ ...entry, data: redactObject(entry.data as Bindings) });\n  };\n}\n\n/* ─── pipe — fault-tolerant fan-out ─── */\n\n/**\n * Fan-out: dispatches each entry to all provided transports independently.\n * A throw in one transport does not prevent others from receiving the entry.\n * Pass `onError` to observe individual transport failures; without it, errors are silently swallowed.\n *\n * @example\n * createLogger({\n *   transports: [pipe(consoleTransport(), remoteTransport({ handler }))],\n * })\n *\n * // With error observer:\n * pipe({ onError: (err) => console.error('[pipe]', err) }, consoleTransport(), remoteTransport({ handler }))\n */\nexport function pipe(...transports: Transport[]): Transport;\nexport function pipe(options: PipeOptions, ...transports: Transport[]): Transport;\nexport function pipe(optionsOrTransport: PipeOptions | Transport, ...rest: Transport[]): Transport {\n  let opts: PipeOptions;\n  let transports: Transport[];\n\n  if (typeof optionsOrTransport === 'function') {\n    opts = {};\n    transports = [optionsOrTransport, ...rest];\n  } else {\n    opts = optionsOrTransport;\n    transports = rest;\n  }\n\n  return (entry: LogEntry): void => {\n    for (const t of transports) {\n      try {\n        t(entry);\n      } catch (err) {\n        opts.onError?.(err, entry);\n      }\n    }\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"transports.js","names":[],"sources":["../src/transports.ts"],"sourcesContent":["import type {\n  BatchHandle,\n  BatchTransportOptions,\n  Bindings,\n  JsonTransportOptions,\n  LogEntry,\n  PipeOptions,\n  RedactTransportOptions,\n  RemoteLogData,\n  RemoteTransportOptions,\n  SampleTransportOptions,\n  Transport,\n} from './types';\n\nimport { warn } from './_dev';\nimport { isUnsafeObjectKey } from './_prototype';\nimport { isLevelEnabled } from './types';\n\nexport type { RemoteLogData };\n\n/* ─── Environment detection ─── */\n\nfunction detectEnv(): 'development' | 'production' {\n  if (typeof window === 'undefined') {\n    return (globalThis as Record<string, unknown> & { process?: { env?: { NODE_ENV?: string } } }).process?.env\n      ?.NODE_ENV === 'production'\n      ? 'production'\n      : 'development';\n  }\n\n  return (import.meta as ImportMeta & { env?: { PROD?: boolean } }).env?.PROD ? 'production' : 'development';\n}\n\n/* ─── remoteTransport ─── */\n\n/**\n * Forwards log entries asynchronously to a remote handler.\n * The handler is fire-and-forget. Use onError to observe delivery failures.\n * Console and remote thresholds are fully independent.\n *\n * **Security note:** serialized `Error` objects include the full `stack` trace,\n * which may expose internal file paths. Use `redactTransport` or a middleware\n * to strip `err.stack` before forwarding in production if this is a concern.\n *\n * @example\n * remoteTransport({\n *   handler: async (type, data) => {\n *     await fetch('/api/logs', { body: JSON.stringify(data), method: 'POST' });\n *   },\n *   level: 'error',\n * })\n */\nexport function remoteTransport(options: RemoteTransportOptions): Transport {\n  const { handler } = options;\n  const level = options.level ?? 'debug';\n  const env = options.env ?? detectEnv();\n  const onError = options.onError ?? ((err: unknown) => warn(`remote transport error: ${String(err)}`));\n\n  return (entry: LogEntry): void => {\n    if (!isLevelEnabled(level, entry.level)) return;\n\n    const hasData = Object.keys(entry.data).length > 0;\n    const payload: RemoteLogData = {\n      data: hasData ? entry.data : undefined,\n      env,\n      level: entry.level,\n      message: entry.message,\n      namespace: entry.namespace || undefined,\n      timestamp: entry.timestamp.toISOString(),\n    };\n\n    Promise.resolve()\n      .then(() => handler(entry.level, payload))\n      .catch((err: unknown) => onError(err, payload));\n  };\n}\n\n/* ─── jsonTransport ─── */\n\nfunction makeCircularReplacer(): (_key: string, value: unknown) => unknown {\n  const seen = new WeakSet();\n\n  return (_key: string, value: unknown): unknown => {\n    if (typeof value === 'object' && value !== null) {\n      if (seen.has(value)) return '[Circular]';\n\n      seen.add(value);\n    }\n\n    return value;\n  };\n}\n\n/**\n * Writes newline-delimited JSON (NDJSON) to stdout or a custom output function.\n * Useful for structured log aggregation pipelines in Node.js (ELK, Datadog, etc.).\n *\n * @example\n * jsonTransport({ level: 'info' })\n * jsonTransport({ safe: true }) // handles circular references gracefully\n * jsonTransport({ output: (line) => fs.appendFileSync('app.log', line + '\\n') })\n */\nexport function jsonTransport(options: JsonTransportOptions = {}): Transport {\n  const level = options.level ?? 'debug';\n  const f = options.fields ?? {};\n  const fLevel = f.level ?? 'level';\n  const fTime = f.time ?? 'time';\n  const fNs = f.ns ?? 'ns';\n  const fMsg = f.msg ?? 'msg';\n  const safe = options.safe ?? false;\n  const output =\n    options.output ??\n    ((line: string) => {\n      (\n        globalThis as Record<string, unknown> & { process?: { stdout?: { write: (s: string) => void } } }\n      ).process?.stdout?.write(line + '\\n');\n    });\n\n  return (entry: LogEntry): void => {\n    if (!isLevelEnabled(level, entry.level)) return;\n\n    const record: Record<string, unknown> = {\n      ...entry.data,\n      [fLevel]: entry.level,\n      [fTime]: entry.timestamp.toISOString(),\n      ...(entry.namespace && { [fNs]: entry.namespace }),\n      ...(entry.message !== undefined && { [fMsg]: entry.message }),\n    };\n\n    output(JSON.stringify(record, safe ? makeCircularReplacer() : undefined));\n  };\n}\n\n/* ─── Transport option validation ─── */\n\nfunction assertFiniteNumber(value: number, name: string): void {\n  if (!Number.isFinite(value)) throw new RangeError(`${name} must be a finite number`);\n}\n\nfunction assertNonNegativeInteger(value: number, name: string): void {\n  assertFiniteNumber(value, name);\n\n  if (!Number.isInteger(value) || value < 0) throw new RangeError(`${name} must be a non-negative integer`);\n}\n\nfunction assertPositiveInteger(value: number, name: string): void {\n  assertFiniteNumber(value, name);\n\n  if (!Number.isInteger(value) || value <= 0) throw new RangeError(`${name} must be a positive integer`);\n}\n\n/* ─── batchTransport ─── */\n\n/**\n * Buffers log entries and flushes them in batches, reducing I/O overhead.\n * Flushes when the buffer reaches maxSize or after the interval elapses.\n *\n * Returns a `BatchHandle` with `.transport`, `.flush()`, and `.dispose()` methods:\n * - `.transport` — pass to `createLogger({ transports: [handle.transport] })`\n * - `.flush()` — immediately send buffered entries and wait for delivery without stopping the timer\n * - `.dispose()` — stop the interval, flush remaining entries, and wait for delivery\n *\n * Use `onFlushError` to observe failed flushes (e.g. dead-letter queue).\n *\n * @example\n * const batch = batchTransport({\n *   onFlush: (entries) => sendToCollector(entries),\n *   onFlushError: (entries, err) => deadLetter.push(entries),\n *   interval: 10_000,\n *   maxSize: 100,\n * });\n * createLogger({ transports: [batch.transport] });\n * await batch.dispose(); // call during graceful shutdown\n */\nexport function batchTransport(options: BatchTransportOptions): BatchHandle {\n  const level = options.level ?? 'debug';\n  const maxSize = options.maxSize ?? 50;\n  const maxBuffer = options.maxBuffer;\n  const interval = options.interval ?? 5000;\n\n  assertFiniteNumber(interval, 'batchTransport interval');\n\n  if (interval <= 0) throw new RangeError('batchTransport interval must be greater than zero');\n\n  assertPositiveInteger(maxSize, 'batchTransport maxSize');\n\n  if (maxBuffer !== undefined) assertNonNegativeInteger(maxBuffer, 'batchTransport maxBuffer');\n\n  let buffer: LogEntry[] = [];\n  let timer: ReturnType<typeof setInterval> | undefined;\n  let automaticFailure: { error: unknown } | undefined;\n  let batchDisposed = false;\n  let deliveryTail: Promise<void> = Promise.resolve();\n  let disposePromise: Promise<void> | undefined;\n\n  const deliver = async (entries: LogEntry[]): Promise<void> => {\n    try {\n      await options.onFlush(entries);\n    } catch (err) {\n      try {\n        options.onFlushError?.(entries, err);\n      } catch (observerErr) {\n        warn(`batch transport error observer threw: ${String(observerErr)}`);\n      }\n\n      throw err;\n    }\n  };\n\n  const enqueue = (entries: LogEntry[]): Promise<void> => {\n    const delivery = deliveryTail.then(() => deliver(entries));\n\n    deliveryTail = delivery.catch(() => undefined);\n\n    return delivery;\n  };\n\n  const flush = (): Promise<void> => {\n    if (buffer.length === 0) return deliveryTail;\n\n    const entries = buffer;\n\n    buffer = [];\n\n    return enqueue(entries);\n  };\n\n  const flushAutomatically = (): void => {\n    void flush().catch((error: unknown) => {\n      automaticFailure ??= { error };\n    });\n  };\n\n  const transportFn: Transport = (entry: LogEntry): void => {\n    if (batchDisposed) return;\n\n    if (!isLevelEnabled(level, entry.level)) return;\n\n    if (!timer) timer = setInterval(flushAutomatically, interval);\n\n    buffer.push(entry);\n\n    if (maxBuffer !== undefined && buffer.length > maxBuffer) {\n      buffer = buffer.slice(buffer.length - maxBuffer);\n    }\n\n    if (buffer.length >= maxSize) flushAutomatically();\n  };\n\n  const handle: BatchHandle = {\n    dispose(): Promise<void> {\n      if (disposePromise) return disposePromise;\n\n      batchDisposed = true;\n\n      if (timer) {\n        clearInterval(timer);\n        timer = undefined;\n      }\n\n      disposePromise = flush().then(() => {\n        if (automaticFailure) throw automaticFailure.error;\n      });\n\n      return disposePromise;\n    },\n    get disposed(): boolean {\n      return batchDisposed;\n    },\n    flush,\n    [Symbol.asyncDispose](): Promise<void> {\n      return handle.dispose();\n    },\n    transport: transportFn,\n  };\n\n  return handle;\n}\n\n/* ─── sampleTransport ─── */\n\n/**\n * Probabilistically forwards entries to a downstream transport.\n * Useful for reducing volume of high-frequency debug logs in production.\n *\n * @example\n * sampleTransport({ rate: 0.1, transport: remoteTransport({ handler }) })\n */\nexport function sampleTransport(options: SampleTransportOptions): Transport {\n  const { rate, transport } = options;\n  const level = options.level ?? 'debug';\n\n  assertFiniteNumber(rate, 'sampleTransport rate');\n\n  if (rate < 0 || rate > 1) throw new RangeError('sampleTransport rate must be between zero and one');\n\n  return (entry: LogEntry): void => {\n    if (!isLevelEnabled(level, entry.level)) return;\n\n    if (Math.random() < rate) transport(entry);\n  };\n}\n\n/* ─── redactTransport ─── */\n\n/**\n * Strips sensitive fields from `data` before forwarding to a downstream transport.\n * Redaction is applied recursively at any depth, including inside arrays.\n *\n * @example\n * redactTransport({\n *   keys: ['password', 'token', 'ssn'],\n *   replacement: '[REDACTED]',\n *   transport: remoteTransport({ handler }),\n * })\n */\nexport function redactTransport(options: RedactTransportOptions): Transport {\n  const { keys, maxDepth = 20, replacement = '[REDACTED]', transport } = options;\n\n  assertNonNegativeInteger(maxDepth, 'redactTransport maxDepth');\n\n  for (const key of keys) {\n    if (key.includes('.')) {\n      warn(\n        `redactTransport: key \"${key}\" contains a dot. Dot-path notation is not supported — use the plain field name (e.g. 'password') to redact at any depth.`,\n      );\n    }\n  }\n\n  const keySet = new Set(keys);\n\n  function redactValue(v: unknown, depth = 0): unknown {\n    if (depth > maxDepth) {\n      warn(\n        `redactTransport: object nesting depth exceeded ${maxDepth} — redaction truncated at this level. Sensitive fields below depth ${maxDepth} may not be redacted.`,\n      );\n\n      return v;\n    }\n\n    if (Array.isArray(v)) return v.map((item) => redactValue(item, depth + 1));\n\n    if (typeof v === 'object' && v !== null) return redactObject(v as Bindings, depth + 1);\n\n    return v;\n  }\n\n  function redactObject(obj: Bindings, depth = 0): Bindings {\n    const result: Bindings = {};\n\n    for (const [k, v] of Object.entries(obj)) {\n      // Guard against a `__proto__`/`constructor`/`prototype` field name hijacking result's own\n      // prototype via the bracket-assignment accessor — see _prototype.ts.\n      if (isUnsafeObjectKey(k)) continue;\n\n      result[k] = keySet.has(k) ? replacement : redactValue(v, depth);\n    }\n\n    return result;\n  }\n\n  return (entry: LogEntry): void => {\n    transport({ ...entry, data: redactObject(entry.data as Bindings) });\n  };\n}\n\n/* ─── pipe — fault-tolerant fan-out ─── */\n\n/**\n * Fan-out: dispatches each entry to all provided transports independently.\n * A throw in one transport does not prevent others from receiving the entry.\n * Pass `onError` to observe individual transport failures; without it, errors are silently swallowed.\n *\n * @example\n * createLogger({\n *   transports: [pipe(consoleTransport(), remoteTransport({ handler }))],\n * })\n *\n * // With error observer:\n * pipe({ onError: (err) => console.error('[pipe]', err) }, consoleTransport(), remoteTransport({ handler }))\n */\nexport function pipe(...transports: Transport[]): Transport;\nexport function pipe(options: PipeOptions, ...transports: Transport[]): Transport;\nexport function pipe(optionsOrTransport: PipeOptions | Transport, ...rest: Transport[]): Transport {\n  let opts: PipeOptions;\n  let transports: Transport[];\n\n  if (typeof optionsOrTransport === 'function') {\n    opts = {};\n    transports = [optionsOrTransport, ...rest];\n  } else {\n    opts = optionsOrTransport;\n    transports = rest;\n  }\n\n  return (entry: LogEntry): void => {\n    for (const t of transports) {\n      try {\n        t(entry);\n      } catch (err) {\n        opts.onError?.(err, entry);\n      }\n    }\n  };\n}\n"],"mappings":"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"}

package/dist/types.cjs

@@ -1,2 +1,2 @@
-var e={debug:0,error:3,fatal:4,info:1,off:5,warn:2};function t(t,n){return n===`off`?!1:e[t]<=e[n]}exports.PRIORITY=e,exports.isLevelEnabled=t;
+var e={debug:0,error:3,fatal:4,info:1,off:5,warn:2};function t(t,n){return n!==`off`&&e[t]<=e[n]}exports.PRIORITY=e,exports.isLevelEnabled=t;
 //# sourceMappingURL=types.cjs.map

package/dist/types.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.cjs","names":[],"sources":["../src/types.ts"],"sourcesContent":["/* ─── Log levels ─── */\n\nexport type LogType = 'debug' | 'error' | 'fatal' | 'info' | 'warn';\nexport type LogLevel = LogType | 'off';\n\n/** Numeric priority for each level. Lower = more verbose. Exported for transport authors. */\nexport const PRIORITY: Record<LogLevel, number> = {\n  debug: 0,\n  error: 3,\n  fatal: 4,\n  info: 1,\n  off: 5,\n  warn: 2,\n};\n\n/** Returns true if `level` passes the `threshold`. Returns false when `level` is 'off'. Exported for transport/middleware authors. */\nexport function isLevelEnabled(threshold: LogLevel, level: LogLevel): boolean {\n  if (level === 'off') return false;\n\n  return PRIORITY[threshold] <= PRIORITY[level];\n}\n\n/* ─── Bindings ─── */\n\nexport type Bindings = Record<string, unknown>;\n\n/* ─── Log entry ─── */\n\n/**\n * The structured record produced by every log call and dispatched to all transports.\n * `data` is the merged result of pinned bindings and per-call context — transports\n * receive a single flat object and do not need to merge anything themselves.\n * Any `Error` instances — whether from a pinned binding (`bindings`/`withBindings()`) or\n * per-call context — are automatically serialized to `{ message, name, stack }`.\n * **Shallow only** — an `Error` nested inside a plain object (e.g. `{ meta: { err } }`) is left as-is;\n * only top-level fields of `data` are checked.\n */\nexport type LogEntry = {\n  /**\n   * Merged structured data: pinned bindings overlaid with per-call context.\n   * Already shallow-copied and immutable — do not mutate.\n   */\n  data: Readonly<Bindings>;\n  level: LogType;\n  message?: string;\n  namespace: string;\n  /** Exact moment of the log call — shared across all transports for the same entry. */\n  timestamp: Date;\n};\n\n/* ─── Transport ─── */\n\n/**\n * A transport receives a log entry and is responsible for its own delivery and formatting.\n * If a transport throws, the logger catches it, reports it via a dev-only warning (wrapped in\n * `RuneTransportError`), and continues dispatching the entry to remaining transports — a single\n * misbehaving transport can never crash the caller of `log.info()`/etc. or block its siblings.\n */\nexport type Transport = (entry: LogEntry) => void;\n\n/**\n * Middleware function that transforms or filters log entries before dispatch. Return null to drop the entry.\n * If middleware throws, the logger catches it, reports it via a dev-only warning, and drops the entry\n * (no transports run for it) rather than crashing the caller.\n */\nexport type LogMiddleware = (entry: LogEntry) => LogEntry | null;\n\n/* ─── Transport option types ─── */\n\nexport type RemoteLogData = {\n  data?: Bindings;\n  env: 'development' | 'production';\n  level: LogType;\n  message?: string;\n  namespace?: string;\n  timestamp: string;\n};\n\nexport type RemoteTransportOptions = {\n  /** Override the detected runtime environment. Default: auto-detected. */\n  env?: 'development' | 'production';\n  /** Remote delivery handler — receives the log type and structured payload. */\n  handler: (type: LogType, data: RemoteLogData) => void;\n  /** Minimum level to forward. Default: 'debug'. */\n  level?: LogLevel;\n  /**\n   * Called when the handler throws or rejects.\n   * The async error path is separate from any synchronous errors in the emit call stack.\n   * Default: a dev-only `console.warn` (gated by `__RUNE_PROD__`). In production builds,\n   * unhandled remote transport errors are silently swallowed — pass an explicit `onError`\n   * if you need delivery-failure observability in production.\n   */\n  onError?: (error: unknown, data: RemoteLogData) => void;\n};\n\nexport type JsonTransportOptions = {\n  /**\n   * Custom output field names. Useful for adapting to aggregator conventions\n   * (Datadog, ELK, Loki, etc.).\n   *\n   * @example\n   * jsonTransport({ fields: { level: 'severity', time: '@timestamp', msg: 'message' } })\n   */\n  fields?: {\n    level?: string;\n    msg?: string;\n    ns?: string;\n    time?: string;\n  };\n  /** Minimum level to output. Default: 'debug'. */\n  level?: LogLevel;\n  /** Custom output function. Default: process.stdout.write. */\n  output?: (line: string) => void;\n  /**\n   * Replace circular references with `'[Circular]'` instead of throwing a TypeError.\n   * Useful in environments where log payloads may contain complex object graphs.\n   * Default: false.\n   */\n  safe?: boolean;\n};\n\n/** Handle returned by `batchTransport()`. Pass `handle.transport` to `createLogger({ transports })`. */\nexport type BatchHandle = {\n  /** Delegates to `dispose()`. Enables `using` declarations. */\n  [Symbol.dispose]: () => void;\n  /** Stop the interval timer and flush remaining entries. Call on shutdown. Idempotent. */\n  dispose: () => void;\n  /** `true` after `dispose()` has been called. */\n  readonly disposed: boolean;\n  /** Immediately flush buffered entries to the downstream handler without stopping the timer. */\n  flush: () => void;\n  /** The transport function to pass to `createLogger({ transports: [handle.transport] })`. */\n  transport: Transport;\n};\n\nexport type BatchTransportOptions = {\n  /** Flush interval in milliseconds. Default: 5000. */\n  interval?: number;\n  /** Minimum level to buffer. Default: 'debug'. */\n  level?: LogLevel;\n  /**\n   * Hard limit on the in-memory buffer size. When the buffer exceeds this value,\n   * the oldest entries are dropped to prevent unbounded memory growth.\n   * Unlike `maxSize`, this does NOT trigger a flush — it silently drops.\n   * Default: unbounded.\n   */\n  maxBuffer?: number;\n  /** Maximum buffer size before an early flush. Default: 50. */\n  maxSize?: number;\n  /**\n   * Callback to receive flushed batches. May return a Promise — async rejections\n   * are forwarded to `onFlushError` in addition to synchronous throws.\n   */\n  onFlush: (entries: LogEntry[]) => void | Promise<void>;\n  /**\n   * Called when onFlush throws synchronously or rejects asynchronously.\n   * Allows retry/dead-letter logic. Default: silent.\n   */\n  onFlushError?: (entries: LogEntry[], error: unknown) => void;\n};\n\nexport type PipeOptions = {\n  /**\n   * Called when one of the piped transports throws.\n   * Receives the thrown error and the log entry that triggered it.\n   * Default: silent (errors are swallowed to protect remaining transports).\n   */\n  onError?: (error: unknown, entry: LogEntry) => void;\n};\n\nexport type SampleTransportOptions = {\n  /** Minimum level to sample. Default: 'debug'. */\n  level?: LogLevel;\n  /** Fraction of entries to forward (0–1). */\n  rate: number;\n  /** Downstream transport to receive sampled entries. */\n  transport: Transport;\n};\n\nexport type RedactTransportOptions = {\n  /**\n   * Field names to replace at any depth in `data`.\n   * Matched by exact field name — dot-path notation (e.g. `'user.password'`) is NOT supported.\n   * A key like `'password'` will redact every field named `'password'` at any nesting level.\n   */\n  keys: string[];\n  /**\n   * Maximum object nesting depth to traverse during redaction.\n   * Objects deeper than this limit are returned as-is (not redacted).\n   * A dev-only warning is emitted when the cap is hit.\n   * Default: 20.\n   * @security In production builds, the depth warning is suppressed — deeply-nested sensitive\n   * fields beyond `maxDepth` will pass through unredacted without any indication. Ensure that\n   * sensitive payloads are not nested beyond this limit, or lower `maxDepth` as needed.\n   */\n  maxDepth?: number;\n  /** Replacement value for redacted fields. Default: '[REDACTED]'. */\n  replacement?: string;\n  /** Downstream transport to receive the redacted entry. */\n  transport: Transport;\n};\n\n/* ─── Logger options ─── */\n\nexport type RuneOptions = {\n  /** Initial pinned bindings for this logger instance. `Error` values are auto-serialized, same as per-call context. */\n  bindings?: Bindings;\n  /** Minimum log level for this logger instance. Default: 'debug'. */\n  logLevel?: LogLevel;\n  /** Middleware pipeline applied to every entry before dispatch to transports. */\n  middleware?: LogMiddleware[];\n  /**\n   * Namespace for this logger. When passed to `child()`, it is automatically\n   * dot-joined to the parent namespace (e.g. parent `'api'` + child `'auth'` → `'api.auth'`).\n   */\n  namespace?: string;\n  /**\n   * Transport pipeline. Each transport receives every entry that passes the level threshold.\n   * Default: [consoleTransport()].\n   */\n  transports?: Transport[];\n};\n\n/* ─── Log method ─── */\n\n/**\n * Signature shared by all five log-level methods.\n *\n * - `log.info('message')` — string-only, most common.\n * - `log.info({ ...fields }, 'message')` — structured context + optional message.\n *   `Error` values in `fields` are automatically serialized to `{ message, name, stack }`.\n *   Serialization is shallow only — an `Error` nested inside a nested object is left as-is.\n * - `log.error(err, { ...fields }, 'message')` — Error first, then optional context + message.\n *   Shorthand for the pattern where an Error is the primary subject of the log call.\n *   The context object may be omitted entirely: `log.error(err, 'message')`.\n *\n * @example\n * log.error({ err: new Error('timeout'), requestId }, 'request failed')\n * log.error(new Error('timeout'), { requestId }, 'request failed')\n */\nexport type LogMethod = {\n  (message: string): void;\n  (error: Error, message?: string): void;\n  (error: Error, context: Bindings, message?: string): void;\n  (context: Bindings, message?: string): void;\n};\n\n/* ─── Logger interface ─── */\n\nexport type Logger = {\n  /** Delegates to `dispose()`. Enables `using` declarations. */\n  [Symbol.dispose]: () => void;\n  /** Snapshot of currently pinned bindings. */\n  readonly bindings: Readonly<Bindings>;\n  /** Create a child logger with config overrides. Inherits all config and bindings by default. */\n  child: (overrides?: RuneOptions) => Logger;\n  debug: LogMethod;\n  /** `AbortSignal` aborted when `dispose()` is called. Use to tie external lifetimes to this logger. */\n  readonly disposalSignal: AbortSignal;\n  /**\n   * Marks the logger as disposed — all subsequent log calls become no-ops.\n   * Aborts `disposalSignal`. Does NOT auto-discover or dispose batch transports;\n   * hold a direct reference to `batchTransport` and call its `dispose()` on shutdown.\n   * Idempotent — safe to call multiple times.\n   */\n  dispose: () => void;\n  /** `true` after `dispose()` has been called. */\n  readonly disposed: boolean;\n  /** Returns true if entries at this level will pass the configured threshold. */\n  enabled: (type: LogLevel) => boolean;\n  error: LogMethod;\n  fatal: LogMethod;\n  /**\n   * Wrap a callback in a console group, closing it even on throw/reject.\n   * Pass a `level` to gate the group header on the configured log threshold\n   * (e.g. `level: 'debug'` suppresses the group when `logLevel` is above `'debug'`).\n   * Default: always renders (unless `logLevel` is `'off'`).\n   */\n  group: <T>(label: string, fn: () => T, level?: LogType) => T;\n  /**\n   * Same as `group`, using `console.groupCollapsed`.\n   * Pass a `level` to gate the group on the configured log threshold.\n   */\n  groupCollapsed: <T>(label: string, fn: () => T, level?: LogType) => T;\n  info: LogMethod;\n  /** Active log level for this logger instance. */\n  readonly logLevel: LogLevel;\n  /** Middleware pipeline applied before dispatch. */\n  readonly middleware: readonly LogMiddleware[];\n  /** Namespace string for this logger instance. */\n  readonly namespace: string;\n  /**\n   * Measure execution time of `fn` and emit a structured log entry.\n   * The entry message is `label`; `data` contains `{ duration_ms }` (rounded to 2 dp).\n   * When `fn` throws or rejects, `data` also includes `{ err }` with the serialized error.\n   * @param label - Human-readable description of the operation.\n   * @param fn - Synchronous or async function to time.\n   * @param level - Log level for the timing entry. Default: `'debug'`.\n   */\n  time: <T>(label: string, fn: () => T, level?: LogType) => T;\n  /** Transport pipeline for this logger instance. */\n  readonly transports: readonly Transport[];\n  /**\n   * Add a middleware function to the pipeline. Returns a **new** logger — the original is unchanged.\n   * Discarding the return value is a common mistake: always assign the result.\n   * @example\n   * const log = baseLog.use(tracingMiddleware); // ✓ keep the result\n   */\n  use: (middleware: LogMiddleware) => Logger;\n  warn: LogMethod;\n  /**\n   * Derive a child logger with additional pinned bindings.\n   * The returned logger is fully independent — disposing it does not affect the parent,\n   * and disposing the parent does not affect child loggers.\n   */\n  withBindings: (bindings: Bindings) => Logger;\n};\n"],"mappings":"AAMA,IAAa,EAAqC,CAChD,MAAO,EACP,MAAO,EACP,MAAO,EACP,KAAM,EACN,IAAK,EACL,KAAM,CACR,EAGA,SAAgB,EAAe,EAAqB,EAA0B,CAG5E,OAFI,IAAU,MAAc,GAErB,EAAS,IAAc,EAAS,EACzC"}
+{"version":3,"file":"types.cjs","names":[],"sources":["../src/types.ts"],"sourcesContent":["/* ─── Log levels ─── */\n\nexport type LogType = 'debug' | 'error' | 'fatal' | 'info' | 'warn';\nexport type LogLevel = LogType | 'off';\n\n/** Numeric priority for each level. Lower = more verbose. Exported for transport authors. */\nexport const PRIORITY: Record<LogLevel, number> = {\n  debug: 0,\n  error: 3,\n  fatal: 4,\n  info: 1,\n  off: 5,\n  warn: 2,\n};\n\n/** Returns true if `level` passes the `threshold`. Returns false when `level` is 'off'. Exported for transport/middleware authors. */\nexport function isLevelEnabled(threshold: LogLevel, level: LogLevel): boolean {\n  if (level === 'off') return false;\n\n  return PRIORITY[threshold] <= PRIORITY[level];\n}\n\n/* ─── Bindings ─── */\n\nexport type Bindings = Record<string, unknown>;\n\n/* ─── Log entry ─── */\n\n/**\n * The structured record produced by every log call and dispatched to all transports.\n * `data` is the merged result of pinned bindings and per-call context — transports\n * receive a single flat object and do not need to merge anything themselves.\n * Any `Error` instances — whether from a pinned binding (`bindings`/`withBindings()`) or\n * per-call context — are automatically serialized to `{ message, name, stack }`.\n * **Shallow only** — an `Error` nested inside a plain object (e.g. `{ meta: { err } }`) is left as-is;\n * only top-level fields of `data` are checked.\n */\nexport type LogEntry = {\n  /**\n   * Merged structured data: pinned bindings overlaid with per-call context.\n   * Already shallow-copied and immutable — do not mutate.\n   */\n  data: Readonly<Bindings>;\n  level: LogType;\n  message?: string;\n  namespace: string;\n  /** Exact moment of the log call — shared across all transports for the same entry. */\n  timestamp: Date;\n};\n\n/* ─── Transport ─── */\n\n/**\n * A transport receives a log entry and is responsible for its own delivery and formatting.\n * If a transport throws, the logger catches it, reports it via a dev-only warning, and continues\n * dispatching the entry to remaining transports — a single misbehaving transport can never crash\n * the caller of `log.info()`/etc. or block its siblings.\n */\nexport type Transport = (entry: LogEntry) => void;\n\n/**\n * Middleware function that transforms or filters log entries before dispatch. Return null to drop the entry.\n * If middleware throws, the logger catches it, reports it via a dev-only warning, and drops the entry\n * (no transports run for it) rather than crashing the caller.\n */\nexport type LogMiddleware = (entry: LogEntry) => LogEntry | null;\n\n/* ─── Transport option types ─── */\n\nexport type RemoteLogData = {\n  data?: Bindings;\n  env: 'development' | 'production';\n  level: LogType;\n  message?: string;\n  namespace?: string;\n  timestamp: string;\n};\n\nexport type RemoteTransportOptions = {\n  /** Override the detected runtime environment. Default: auto-detected. */\n  env?: 'development' | 'production';\n  /** Remote delivery handler — receives the log type and structured payload. */\n  handler: (type: LogType, data: RemoteLogData) => void;\n  /** Minimum level to forward. Default: 'debug'. */\n  level?: LogLevel;\n  /**\n   * Called when the handler throws or rejects.\n   * The async error path is separate from any synchronous errors in the emit call stack.\n   * Default: a dev-only `console.warn` (gated by `__RUNE_PROD__`). In production builds,\n   * unhandled remote transport errors are silently swallowed — pass an explicit `onError`\n   * if you need delivery-failure observability in production.\n   */\n  onError?: (error: unknown, data: RemoteLogData) => void;\n};\n\nexport type JsonTransportOptions = {\n  /**\n   * Custom output field names. Useful for adapting to aggregator conventions\n   * (Datadog, ELK, Loki, etc.).\n   *\n   * @example\n   * jsonTransport({ fields: { level: 'severity', time: '@timestamp', msg: 'message' } })\n   */\n  fields?: {\n    level?: string;\n    msg?: string;\n    ns?: string;\n    time?: string;\n  };\n  /** Minimum level to output. Default: 'debug'. */\n  level?: LogLevel;\n  /** Custom output function. Default: process.stdout.write. */\n  output?: (line: string) => void;\n  /**\n   * Replace circular references with `'[Circular]'` instead of throwing a TypeError.\n   * Useful in environments where log payloads may contain complex object graphs.\n   * Default: false.\n   */\n  safe?: boolean;\n};\n\n/** Handle returned by `batchTransport()`. Pass `handle.transport` to `createLogger({ transports })`. */\nexport type BatchHandle = {\n  /** Delegates to `dispose()`. Enables `await using` declarations. */\n  [Symbol.asyncDispose]: () => Promise<void>;\n  /** Stop the interval timer, flush remaining entries, and wait for all accepted batches. Idempotent. */\n  dispose: () => Promise<void>;\n  /** `true` after `dispose()` has been called. */\n  readonly disposed: boolean;\n  /** Immediately flush buffered entries and wait for their downstream delivery without stopping the timer. */\n  flush: () => Promise<void>;\n  /** The transport function to pass to `createLogger({ transports: [handle.transport] })`. */\n  transport: Transport;\n};\n\nexport type BatchTransportOptions = {\n  /** Flush interval in milliseconds. Must be finite and greater than zero. Default: 5000. */\n  interval?: number;\n  /** Minimum level to buffer. Default: 'debug'. */\n  level?: LogLevel;\n  /**\n   * Hard limit on the in-memory buffer size. Must be a finite non-negative integer.\n   * When the buffer exceeds this value, the oldest entries are dropped to prevent\n   * unbounded memory growth. Unlike `maxSize`, this does NOT trigger a flush.\n   * Default: unbounded.\n   */\n  maxBuffer?: number;\n  /** Maximum buffer size before an early flush. Must be a finite positive integer. Default: 50. */\n  maxSize?: number;\n  /** Callback to receive flushed batches. May return a Promise. */\n  onFlush: (entries: LogEntry[]) => void | Promise<void>;\n  /**\n   * Called when onFlush throws synchronously or rejects asynchronously. Observes the\n   * failure; the corresponding `flush()` or `dispose()` promise still rejects.\n   */\n  onFlushError?: (entries: LogEntry[], error: unknown) => void;\n};\n\nexport type PipeOptions = {\n  /**\n   * Called when one of the piped transports throws.\n   * Receives the thrown error and the log entry that triggered it.\n   * Default: silent (errors are swallowed to protect remaining transports).\n   */\n  onError?: (error: unknown, entry: LogEntry) => void;\n};\n\nexport type SampleTransportOptions = {\n  /** Minimum level to sample. Default: 'debug'. */\n  level?: LogLevel;\n  /** Finite fraction of entries to forward (0–1). */\n  rate: number;\n  /** Downstream transport to receive sampled entries. */\n  transport: Transport;\n};\n\nexport type RedactTransportOptions = {\n  /**\n   * Field names to replace at any depth in `data`.\n   * Matched by exact field name — dot-path notation (e.g. `'user.password'`) is NOT supported.\n   * A key like `'password'` will redact every field named `'password'` at any nesting level.\n   */\n  keys: string[];\n  /**\n   * Finite non-negative integer maximum object nesting depth to traverse during redaction.\n   * Objects deeper than this limit are returned as-is (not redacted).\n   * A dev-only warning is emitted when the cap is hit.\n   * Default: 20.\n   * @security In production builds, the depth warning is suppressed — deeply-nested sensitive\n   * fields beyond `maxDepth` will pass through unredacted without any indication. Ensure that\n   * sensitive payloads are not nested beyond this limit, or lower `maxDepth` as needed.\n   */\n  maxDepth?: number;\n  /** Replacement value for redacted fields. Default: '[REDACTED]'. */\n  replacement?: string;\n  /** Downstream transport to receive the redacted entry. */\n  transport: Transport;\n};\n\n/* ─── Logger options ─── */\n\nexport type RuneOptions = {\n  /** Initial pinned bindings for this logger instance. `Error` values are auto-serialized, same as per-call context. */\n  bindings?: Bindings;\n  /** Minimum log level for this logger instance. Default: 'debug'. */\n  logLevel?: LogLevel;\n  /** Middleware pipeline applied to every entry before dispatch to transports. */\n  middleware?: LogMiddleware[];\n  /**\n   * Namespace for this logger. When passed to `child()`, it is automatically\n   * dot-joined to the parent namespace (e.g. parent `'api'` + child `'auth'` → `'api.auth'`).\n   */\n  namespace?: string;\n  /**\n   * Transport pipeline. Each transport receives every entry that passes the level threshold.\n   * Default: [consoleTransport()].\n   */\n  transports?: Transport[];\n};\n\n/* ─── Log method ─── */\n\n/**\n * Signature shared by all five log-level methods.\n *\n * - `log.info('message')` — string-only, most common.\n * - `log.info({ ...fields }, 'message')` — structured context + optional message.\n *   `Error` values in `fields` are automatically serialized to `{ message, name, stack }`.\n *   Serialization is shallow only — an `Error` nested inside a nested object is left as-is.\n * - `log.error(err, { ...fields }, 'message')` — Error first, then optional context + message.\n *   Shorthand for the pattern where an Error is the primary subject of the log call.\n *   The context object may be omitted entirely: `log.error(err, 'message')`.\n *\n * @example\n * log.error({ err: new Error('timeout'), requestId }, 'request failed')\n * log.error(new Error('timeout'), { requestId }, 'request failed')\n */\nexport type LogMethod = {\n  (message: string): void;\n  (error: Error, message?: string): void;\n  (error: Error, context: Bindings, message?: string): void;\n  (context: Bindings, message?: string): void;\n};\n\n/* ─── Logger interface ─── */\n\nexport type Logger = {\n  /** Delegates to `dispose()`. Enables `using` declarations. */\n  [Symbol.dispose]: () => void;\n  /** Snapshot of currently pinned bindings. */\n  readonly bindings: Readonly<Bindings>;\n  /** Create a child logger with config overrides. Inherits all config and bindings by default. */\n  child: (overrides?: RuneOptions) => Logger;\n  debug: LogMethod;\n  /** `AbortSignal` aborted when `dispose()` is called. Use to tie external lifetimes to this logger. */\n  readonly disposalSignal: AbortSignal;\n  /**\n   * Marks the logger as disposed — all subsequent log calls become no-ops.\n   * Aborts `disposalSignal`. Does NOT auto-discover or dispose batch transports;\n   * hold a direct reference to `batchTransport` and call its `dispose()` on shutdown.\n   * Idempotent — safe to call multiple times.\n   */\n  dispose: () => void;\n  /** `true` after `dispose()` has been called. */\n  readonly disposed: boolean;\n  /** Returns true if entries at this level will pass the configured threshold. */\n  enabled: (type: LogLevel) => boolean;\n  error: LogMethod;\n  fatal: LogMethod;\n  /**\n   * Wrap a callback in a console group, closing it even on throw/reject.\n   * Pass a `level` to gate the group header on the configured log threshold\n   * (e.g. `level: 'debug'` suppresses the group when `logLevel` is above `'debug'`).\n   * Default: always renders (unless `logLevel` is `'off'`).\n   */\n  group: <T>(label: string, fn: () => T, level?: LogType) => T;\n  /**\n   * Same as `group`, using `console.groupCollapsed`.\n   * Pass a `level` to gate the group on the configured log threshold.\n   */\n  groupCollapsed: <T>(label: string, fn: () => T, level?: LogType) => T;\n  info: LogMethod;\n  /** Active log level for this logger instance. */\n  readonly logLevel: LogLevel;\n  /** Middleware pipeline applied before dispatch. */\n  readonly middleware: readonly LogMiddleware[];\n  /** Namespace string for this logger instance. */\n  readonly namespace: string;\n  /**\n   * Measure execution time of `fn` and emit a structured log entry.\n   * The entry message is `label`; `data` contains `{ duration_ms }` (rounded to 2 dp).\n   * When `fn` throws or rejects, `data` also includes `{ err }` with the serialized error.\n   * @param label - Human-readable description of the operation.\n   * @param fn - Synchronous or async function to time.\n   * @param level - Log level for the timing entry. Default: `'debug'`.\n   */\n  time: <T>(label: string, fn: () => T, level?: LogType) => T;\n  /** Transport pipeline for this logger instance. */\n  readonly transports: readonly Transport[];\n  /**\n   * Add a middleware function to the pipeline. Returns a **new** logger — the original is unchanged.\n   * Discarding the return value is a common mistake: always assign the result.\n   * @example\n   * const log = baseLog.use(tracingMiddleware); // ✓ keep the result\n   */\n  use: (middleware: LogMiddleware) => Logger;\n  warn: LogMethod;\n  /**\n   * Derive a child logger with additional pinned bindings.\n   * The returned logger is fully independent — disposing it does not affect the parent,\n   * and disposing the parent does not affect child loggers.\n   */\n  withBindings: (bindings: Bindings) => Logger;\n};\n"],"mappings":"AAMA,IAAa,EAAqC,CAChD,MAAO,EACP,MAAO,EACP,MAAO,EACP,KAAM,EACN,IAAK,EACL,KAAM,CACR,EAGA,SAAgB,EAAe,EAAqB,EAA0B,CAG5E,OAFI,IAAU,OAEP,EAAS,IAAc,EAAS,EACzC"}

package/dist/types.d.ts

@@ -28,9 +28,9 @@ export type LogEntry = {
 };
 /**
  * A transport receives a log entry and is responsible for its own delivery and formatting.
- * If a transport throws, the logger catches it, reports it via a dev-only warning (wrapped in
- * `RuneTransportError`), and continues dispatching the entry to remaining transports — a single
- * misbehaving transport can never crash the caller of `log.info()`/etc. or block its siblings.
+ * If a transport throws, the logger catches it, reports it via a dev-only warning, and continues
+ * dispatching the entry to remaining transports — a single misbehaving transport can never crash
+ * the caller of `log.info()`/etc. or block its siblings.
  */
 export type Transport = (entry: LogEntry) => void;
 /**
@@ -90,39 +90,36 @@ export type JsonTransportOptions = {
 };
 /** Handle returned by `batchTransport()`. Pass `handle.transport` to `createLogger({ transports })`. */
 export type BatchHandle = {
-    /** Delegates to `dispose()`. Enables `using` declarations. */
-    [Symbol.dispose]: () => void;
-    /** Stop the interval timer and flush remaining entries. Call on shutdown. Idempotent. */
-    dispose: () => void;
+    /** Delegates to `dispose()`. Enables `await using` declarations. */
+    [Symbol.asyncDispose]: () => Promise<void>;
+    /** Stop the interval timer, flush remaining entries, and wait for all accepted batches. Idempotent. */
+    dispose: () => Promise<void>;
     /** `true` after `dispose()` has been called. */
     readonly disposed: boolean;
-    /** Immediately flush buffered entries to the downstream handler without stopping the timer. */
-    flush: () => void;
+    /** Immediately flush buffered entries and wait for their downstream delivery without stopping the timer. */
+    flush: () => Promise<void>;
     /** The transport function to pass to `createLogger({ transports: [handle.transport] })`. */
     transport: Transport;
 };
 export type BatchTransportOptions = {
-    /** Flush interval in milliseconds. Default: 5000. */
+    /** Flush interval in milliseconds. Must be finite and greater than zero. Default: 5000. */
     interval?: number;
     /** Minimum level to buffer. Default: 'debug'. */
     level?: LogLevel;
     /**
-     * Hard limit on the in-memory buffer size. When the buffer exceeds this value,
-     * the oldest entries are dropped to prevent unbounded memory growth.
-     * Unlike `maxSize`, this does NOT trigger a flush — it silently drops.
+     * Hard limit on the in-memory buffer size. Must be a finite non-negative integer.
+     * When the buffer exceeds this value, the oldest entries are dropped to prevent
+     * unbounded memory growth. Unlike `maxSize`, this does NOT trigger a flush.
      * Default: unbounded.
      */
     maxBuffer?: number;
-    /** Maximum buffer size before an early flush. Default: 50. */
+    /** Maximum buffer size before an early flush. Must be a finite positive integer. Default: 50. */
     maxSize?: number;
-    /**
-     * Callback to receive flushed batches. May return a Promise — async rejections
-     * are forwarded to `onFlushError` in addition to synchronous throws.
-     */
+    /** Callback to receive flushed batches. May return a Promise. */
     onFlush: (entries: LogEntry[]) => void | Promise<void>;
     /**
-     * Called when onFlush throws synchronously or rejects asynchronously.
-     * Allows retry/dead-letter logic. Default: silent.
+     * Called when onFlush throws synchronously or rejects asynchronously. Observes the
+     * failure; the corresponding `flush()` or `dispose()` promise still rejects.
      */
     onFlushError?: (entries: LogEntry[], error: unknown) => void;
 };
@@ -137,7 +134,7 @@ export type PipeOptions = {
 export type SampleTransportOptions = {
     /** Minimum level to sample. Default: 'debug'. */
     level?: LogLevel;
-    /** Fraction of entries to forward (0–1). */
+    /** Finite fraction of entries to forward (0–1). */
     rate: number;
     /** Downstream transport to receive sampled entries. */
     transport: Transport;
@@ -150,7 +147,7 @@ export type RedactTransportOptions = {
      */
     keys: string[];
     /**
-     * Maximum object nesting depth to traverse during redaction.
+     * Finite non-negative integer maximum object nesting depth to traverse during redaction.
      * Objects deeper than this limit are returned as-is (not redacted).
      * A dev-only warning is emitted when the cap is hit.
      * Default: 20.

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -8,7 +8,7 @@ var e = {
 	warn: 2
 };
 function t(t, n) {
-	return n === "off" ? !1 : e[t] <= e[n];
+	return n !== "off" && e[t] <= e[n];
 }
 //#endregion
 export { e as PRIORITY, t as isLevelEnabled };

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","names":[],"sources":["../src/types.ts"],"sourcesContent":["/* ─── Log levels ─── */\n\nexport type LogType = 'debug' | 'error' | 'fatal' | 'info' | 'warn';\nexport type LogLevel = LogType | 'off';\n\n/** Numeric priority for each level. Lower = more verbose. Exported for transport authors. */\nexport const PRIORITY: Record<LogLevel, number> = {\n  debug: 0,\n  error: 3,\n  fatal: 4,\n  info: 1,\n  off: 5,\n  warn: 2,\n};\n\n/** Returns true if `level` passes the `threshold`. Returns false when `level` is 'off'. Exported for transport/middleware authors. */\nexport function isLevelEnabled(threshold: LogLevel, level: LogLevel): boolean {\n  if (level === 'off') return false;\n\n  return PRIORITY[threshold] <= PRIORITY[level];\n}\n\n/* ─── Bindings ─── */\n\nexport type Bindings = Record<string, unknown>;\n\n/* ─── Log entry ─── */\n\n/**\n * The structured record produced by every log call and dispatched to all transports.\n * `data` is the merged result of pinned bindings and per-call context — transports\n * receive a single flat object and do not need to merge anything themselves.\n * Any `Error` instances — whether from a pinned binding (`bindings`/`withBindings()`) or\n * per-call context — are automatically serialized to `{ message, name, stack }`.\n * **Shallow only** — an `Error` nested inside a plain object (e.g. `{ meta: { err } }`) is left as-is;\n * only top-level fields of `data` are checked.\n */\nexport type LogEntry = {\n  /**\n   * Merged structured data: pinned bindings overlaid with per-call context.\n   * Already shallow-copied and immutable — do not mutate.\n   */\n  data: Readonly<Bindings>;\n  level: LogType;\n  message?: string;\n  namespace: string;\n  /** Exact moment of the log call — shared across all transports for the same entry. */\n  timestamp: Date;\n};\n\n/* ─── Transport ─── */\n\n/**\n * A transport receives a log entry and is responsible for its own delivery and formatting.\n * If a transport throws, the logger catches it, reports it via a dev-only warning (wrapped in\n * `RuneTransportError`), and continues dispatching the entry to remaining transports — a single\n * misbehaving transport can never crash the caller of `log.info()`/etc. or block its siblings.\n */\nexport type Transport = (entry: LogEntry) => void;\n\n/**\n * Middleware function that transforms or filters log entries before dispatch. Return null to drop the entry.\n * If middleware throws, the logger catches it, reports it via a dev-only warning, and drops the entry\n * (no transports run for it) rather than crashing the caller.\n */\nexport type LogMiddleware = (entry: LogEntry) => LogEntry | null;\n\n/* ─── Transport option types ─── */\n\nexport type RemoteLogData = {\n  data?: Bindings;\n  env: 'development' | 'production';\n  level: LogType;\n  message?: string;\n  namespace?: string;\n  timestamp: string;\n};\n\nexport type RemoteTransportOptions = {\n  /** Override the detected runtime environment. Default: auto-detected. */\n  env?: 'development' | 'production';\n  /** Remote delivery handler — receives the log type and structured payload. */\n  handler: (type: LogType, data: RemoteLogData) => void;\n  /** Minimum level to forward. Default: 'debug'. */\n  level?: LogLevel;\n  /**\n   * Called when the handler throws or rejects.\n   * The async error path is separate from any synchronous errors in the emit call stack.\n   * Default: a dev-only `console.warn` (gated by `__RUNE_PROD__`). In production builds,\n   * unhandled remote transport errors are silently swallowed — pass an explicit `onError`\n   * if you need delivery-failure observability in production.\n   */\n  onError?: (error: unknown, data: RemoteLogData) => void;\n};\n\nexport type JsonTransportOptions = {\n  /**\n   * Custom output field names. Useful for adapting to aggregator conventions\n   * (Datadog, ELK, Loki, etc.).\n   *\n   * @example\n   * jsonTransport({ fields: { level: 'severity', time: '@timestamp', msg: 'message' } })\n   */\n  fields?: {\n    level?: string;\n    msg?: string;\n    ns?: string;\n    time?: string;\n  };\n  /** Minimum level to output. Default: 'debug'. */\n  level?: LogLevel;\n  /** Custom output function. Default: process.stdout.write. */\n  output?: (line: string) => void;\n  /**\n   * Replace circular references with `'[Circular]'` instead of throwing a TypeError.\n   * Useful in environments where log payloads may contain complex object graphs.\n   * Default: false.\n   */\n  safe?: boolean;\n};\n\n/** Handle returned by `batchTransport()`. Pass `handle.transport` to `createLogger({ transports })`. */\nexport type BatchHandle = {\n  /** Delegates to `dispose()`. Enables `using` declarations. */\n  [Symbol.dispose]: () => void;\n  /** Stop the interval timer and flush remaining entries. Call on shutdown. Idempotent. */\n  dispose: () => void;\n  /** `true` after `dispose()` has been called. */\n  readonly disposed: boolean;\n  /** Immediately flush buffered entries to the downstream handler without stopping the timer. */\n  flush: () => void;\n  /** The transport function to pass to `createLogger({ transports: [handle.transport] })`. */\n  transport: Transport;\n};\n\nexport type BatchTransportOptions = {\n  /** Flush interval in milliseconds. Default: 5000. */\n  interval?: number;\n  /** Minimum level to buffer. Default: 'debug'. */\n  level?: LogLevel;\n  /**\n   * Hard limit on the in-memory buffer size. When the buffer exceeds this value,\n   * the oldest entries are dropped to prevent unbounded memory growth.\n   * Unlike `maxSize`, this does NOT trigger a flush — it silently drops.\n   * Default: unbounded.\n   */\n  maxBuffer?: number;\n  /** Maximum buffer size before an early flush. Default: 50. */\n  maxSize?: number;\n  /**\n   * Callback to receive flushed batches. May return a Promise — async rejections\n   * are forwarded to `onFlushError` in addition to synchronous throws.\n   */\n  onFlush: (entries: LogEntry[]) => void | Promise<void>;\n  /**\n   * Called when onFlush throws synchronously or rejects asynchronously.\n   * Allows retry/dead-letter logic. Default: silent.\n   */\n  onFlushError?: (entries: LogEntry[], error: unknown) => void;\n};\n\nexport type PipeOptions = {\n  /**\n   * Called when one of the piped transports throws.\n   * Receives the thrown error and the log entry that triggered it.\n   * Default: silent (errors are swallowed to protect remaining transports).\n   */\n  onError?: (error: unknown, entry: LogEntry) => void;\n};\n\nexport type SampleTransportOptions = {\n  /** Minimum level to sample. Default: 'debug'. */\n  level?: LogLevel;\n  /** Fraction of entries to forward (0–1). */\n  rate: number;\n  /** Downstream transport to receive sampled entries. */\n  transport: Transport;\n};\n\nexport type RedactTransportOptions = {\n  /**\n   * Field names to replace at any depth in `data`.\n   * Matched by exact field name — dot-path notation (e.g. `'user.password'`) is NOT supported.\n   * A key like `'password'` will redact every field named `'password'` at any nesting level.\n   */\n  keys: string[];\n  /**\n   * Maximum object nesting depth to traverse during redaction.\n   * Objects deeper than this limit are returned as-is (not redacted).\n   * A dev-only warning is emitted when the cap is hit.\n   * Default: 20.\n   * @security In production builds, the depth warning is suppressed — deeply-nested sensitive\n   * fields beyond `maxDepth` will pass through unredacted without any indication. Ensure that\n   * sensitive payloads are not nested beyond this limit, or lower `maxDepth` as needed.\n   */\n  maxDepth?: number;\n  /** Replacement value for redacted fields. Default: '[REDACTED]'. */\n  replacement?: string;\n  /** Downstream transport to receive the redacted entry. */\n  transport: Transport;\n};\n\n/* ─── Logger options ─── */\n\nexport type RuneOptions = {\n  /** Initial pinned bindings for this logger instance. `Error` values are auto-serialized, same as per-call context. */\n  bindings?: Bindings;\n  /** Minimum log level for this logger instance. Default: 'debug'. */\n  logLevel?: LogLevel;\n  /** Middleware pipeline applied to every entry before dispatch to transports. */\n  middleware?: LogMiddleware[];\n  /**\n   * Namespace for this logger. When passed to `child()`, it is automatically\n   * dot-joined to the parent namespace (e.g. parent `'api'` + child `'auth'` → `'api.auth'`).\n   */\n  namespace?: string;\n  /**\n   * Transport pipeline. Each transport receives every entry that passes the level threshold.\n   * Default: [consoleTransport()].\n   */\n  transports?: Transport[];\n};\n\n/* ─── Log method ─── */\n\n/**\n * Signature shared by all five log-level methods.\n *\n * - `log.info('message')` — string-only, most common.\n * - `log.info({ ...fields }, 'message')` — structured context + optional message.\n *   `Error` values in `fields` are automatically serialized to `{ message, name, stack }`.\n *   Serialization is shallow only — an `Error` nested inside a nested object is left as-is.\n * - `log.error(err, { ...fields }, 'message')` — Error first, then optional context + message.\n *   Shorthand for the pattern where an Error is the primary subject of the log call.\n *   The context object may be omitted entirely: `log.error(err, 'message')`.\n *\n * @example\n * log.error({ err: new Error('timeout'), requestId }, 'request failed')\n * log.error(new Error('timeout'), { requestId }, 'request failed')\n */\nexport type LogMethod = {\n  (message: string): void;\n  (error: Error, message?: string): void;\n  (error: Error, context: Bindings, message?: string): void;\n  (context: Bindings, message?: string): void;\n};\n\n/* ─── Logger interface ─── */\n\nexport type Logger = {\n  /** Delegates to `dispose()`. Enables `using` declarations. */\n  [Symbol.dispose]: () => void;\n  /** Snapshot of currently pinned bindings. */\n  readonly bindings: Readonly<Bindings>;\n  /** Create a child logger with config overrides. Inherits all config and bindings by default. */\n  child: (overrides?: RuneOptions) => Logger;\n  debug: LogMethod;\n  /** `AbortSignal` aborted when `dispose()` is called. Use to tie external lifetimes to this logger. */\n  readonly disposalSignal: AbortSignal;\n  /**\n   * Marks the logger as disposed — all subsequent log calls become no-ops.\n   * Aborts `disposalSignal`. Does NOT auto-discover or dispose batch transports;\n   * hold a direct reference to `batchTransport` and call its `dispose()` on shutdown.\n   * Idempotent — safe to call multiple times.\n   */\n  dispose: () => void;\n  /** `true` after `dispose()` has been called. */\n  readonly disposed: boolean;\n  /** Returns true if entries at this level will pass the configured threshold. */\n  enabled: (type: LogLevel) => boolean;\n  error: LogMethod;\n  fatal: LogMethod;\n  /**\n   * Wrap a callback in a console group, closing it even on throw/reject.\n   * Pass a `level` to gate the group header on the configured log threshold\n   * (e.g. `level: 'debug'` suppresses the group when `logLevel` is above `'debug'`).\n   * Default: always renders (unless `logLevel` is `'off'`).\n   */\n  group: <T>(label: string, fn: () => T, level?: LogType) => T;\n  /**\n   * Same as `group`, using `console.groupCollapsed`.\n   * Pass a `level` to gate the group on the configured log threshold.\n   */\n  groupCollapsed: <T>(label: string, fn: () => T, level?: LogType) => T;\n  info: LogMethod;\n  /** Active log level for this logger instance. */\n  readonly logLevel: LogLevel;\n  /** Middleware pipeline applied before dispatch. */\n  readonly middleware: readonly LogMiddleware[];\n  /** Namespace string for this logger instance. */\n  readonly namespace: string;\n  /**\n   * Measure execution time of `fn` and emit a structured log entry.\n   * The entry message is `label`; `data` contains `{ duration_ms }` (rounded to 2 dp).\n   * When `fn` throws or rejects, `data` also includes `{ err }` with the serialized error.\n   * @param label - Human-readable description of the operation.\n   * @param fn - Synchronous or async function to time.\n   * @param level - Log level for the timing entry. Default: `'debug'`.\n   */\n  time: <T>(label: string, fn: () => T, level?: LogType) => T;\n  /** Transport pipeline for this logger instance. */\n  readonly transports: readonly Transport[];\n  /**\n   * Add a middleware function to the pipeline. Returns a **new** logger — the original is unchanged.\n   * Discarding the return value is a common mistake: always assign the result.\n   * @example\n   * const log = baseLog.use(tracingMiddleware); // ✓ keep the result\n   */\n  use: (middleware: LogMiddleware) => Logger;\n  warn: LogMethod;\n  /**\n   * Derive a child logger with additional pinned bindings.\n   * The returned logger is fully independent — disposing it does not affect the parent,\n   * and disposing the parent does not affect child loggers.\n   */\n  withBindings: (bindings: Bindings) => Logger;\n};\n"],"mappings":";AAMA,IAAa,IAAqC;CAChD,OAAO;CACP,OAAO;CACP,OAAO;CACP,MAAM;CACN,KAAK;CACL,MAAM;AACR;AAGA,SAAgB,EAAe,GAAqB,GAA0B;CAG5E,OAFI,MAAU,QAAc,KAErB,EAAS,MAAc,EAAS;AACzC"}
+{"version":3,"file":"types.js","names":[],"sources":["../src/types.ts"],"sourcesContent":["/* ─── Log levels ─── */\n\nexport type LogType = 'debug' | 'error' | 'fatal' | 'info' | 'warn';\nexport type LogLevel = LogType | 'off';\n\n/** Numeric priority for each level. Lower = more verbose. Exported for transport authors. */\nexport const PRIORITY: Record<LogLevel, number> = {\n  debug: 0,\n  error: 3,\n  fatal: 4,\n  info: 1,\n  off: 5,\n  warn: 2,\n};\n\n/** Returns true if `level` passes the `threshold`. Returns false when `level` is 'off'. Exported for transport/middleware authors. */\nexport function isLevelEnabled(threshold: LogLevel, level: LogLevel): boolean {\n  if (level === 'off') return false;\n\n  return PRIORITY[threshold] <= PRIORITY[level];\n}\n\n/* ─── Bindings ─── */\n\nexport type Bindings = Record<string, unknown>;\n\n/* ─── Log entry ─── */\n\n/**\n * The structured record produced by every log call and dispatched to all transports.\n * `data` is the merged result of pinned bindings and per-call context — transports\n * receive a single flat object and do not need to merge anything themselves.\n * Any `Error` instances — whether from a pinned binding (`bindings`/`withBindings()`) or\n * per-call context — are automatically serialized to `{ message, name, stack }`.\n * **Shallow only** — an `Error` nested inside a plain object (e.g. `{ meta: { err } }`) is left as-is;\n * only top-level fields of `data` are checked.\n */\nexport type LogEntry = {\n  /**\n   * Merged structured data: pinned bindings overlaid with per-call context.\n   * Already shallow-copied and immutable — do not mutate.\n   */\n  data: Readonly<Bindings>;\n  level: LogType;\n  message?: string;\n  namespace: string;\n  /** Exact moment of the log call — shared across all transports for the same entry. */\n  timestamp: Date;\n};\n\n/* ─── Transport ─── */\n\n/**\n * A transport receives a log entry and is responsible for its own delivery and formatting.\n * If a transport throws, the logger catches it, reports it via a dev-only warning, and continues\n * dispatching the entry to remaining transports — a single misbehaving transport can never crash\n * the caller of `log.info()`/etc. or block its siblings.\n */\nexport type Transport = (entry: LogEntry) => void;\n\n/**\n * Middleware function that transforms or filters log entries before dispatch. Return null to drop the entry.\n * If middleware throws, the logger catches it, reports it via a dev-only warning, and drops the entry\n * (no transports run for it) rather than crashing the caller.\n */\nexport type LogMiddleware = (entry: LogEntry) => LogEntry | null;\n\n/* ─── Transport option types ─── */\n\nexport type RemoteLogData = {\n  data?: Bindings;\n  env: 'development' | 'production';\n  level: LogType;\n  message?: string;\n  namespace?: string;\n  timestamp: string;\n};\n\nexport type RemoteTransportOptions = {\n  /** Override the detected runtime environment. Default: auto-detected. */\n  env?: 'development' | 'production';\n  /** Remote delivery handler — receives the log type and structured payload. */\n  handler: (type: LogType, data: RemoteLogData) => void;\n  /** Minimum level to forward. Default: 'debug'. */\n  level?: LogLevel;\n  /**\n   * Called when the handler throws or rejects.\n   * The async error path is separate from any synchronous errors in the emit call stack.\n   * Default: a dev-only `console.warn` (gated by `__RUNE_PROD__`). In production builds,\n   * unhandled remote transport errors are silently swallowed — pass an explicit `onError`\n   * if you need delivery-failure observability in production.\n   */\n  onError?: (error: unknown, data: RemoteLogData) => void;\n};\n\nexport type JsonTransportOptions = {\n  /**\n   * Custom output field names. Useful for adapting to aggregator conventions\n   * (Datadog, ELK, Loki, etc.).\n   *\n   * @example\n   * jsonTransport({ fields: { level: 'severity', time: '@timestamp', msg: 'message' } })\n   */\n  fields?: {\n    level?: string;\n    msg?: string;\n    ns?: string;\n    time?: string;\n  };\n  /** Minimum level to output. Default: 'debug'. */\n  level?: LogLevel;\n  /** Custom output function. Default: process.stdout.write. */\n  output?: (line: string) => void;\n  /**\n   * Replace circular references with `'[Circular]'` instead of throwing a TypeError.\n   * Useful in environments where log payloads may contain complex object graphs.\n   * Default: false.\n   */\n  safe?: boolean;\n};\n\n/** Handle returned by `batchTransport()`. Pass `handle.transport` to `createLogger({ transports })`. */\nexport type BatchHandle = {\n  /** Delegates to `dispose()`. Enables `await using` declarations. */\n  [Symbol.asyncDispose]: () => Promise<void>;\n  /** Stop the interval timer, flush remaining entries, and wait for all accepted batches. Idempotent. */\n  dispose: () => Promise<void>;\n  /** `true` after `dispose()` has been called. */\n  readonly disposed: boolean;\n  /** Immediately flush buffered entries and wait for their downstream delivery without stopping the timer. */\n  flush: () => Promise<void>;\n  /** The transport function to pass to `createLogger({ transports: [handle.transport] })`. */\n  transport: Transport;\n};\n\nexport type BatchTransportOptions = {\n  /** Flush interval in milliseconds. Must be finite and greater than zero. Default: 5000. */\n  interval?: number;\n  /** Minimum level to buffer. Default: 'debug'. */\n  level?: LogLevel;\n  /**\n   * Hard limit on the in-memory buffer size. Must be a finite non-negative integer.\n   * When the buffer exceeds this value, the oldest entries are dropped to prevent\n   * unbounded memory growth. Unlike `maxSize`, this does NOT trigger a flush.\n   * Default: unbounded.\n   */\n  maxBuffer?: number;\n  /** Maximum buffer size before an early flush. Must be a finite positive integer. Default: 50. */\n  maxSize?: number;\n  /** Callback to receive flushed batches. May return a Promise. */\n  onFlush: (entries: LogEntry[]) => void | Promise<void>;\n  /**\n   * Called when onFlush throws synchronously or rejects asynchronously. Observes the\n   * failure; the corresponding `flush()` or `dispose()` promise still rejects.\n   */\n  onFlushError?: (entries: LogEntry[], error: unknown) => void;\n};\n\nexport type PipeOptions = {\n  /**\n   * Called when one of the piped transports throws.\n   * Receives the thrown error and the log entry that triggered it.\n   * Default: silent (errors are swallowed to protect remaining transports).\n   */\n  onError?: (error: unknown, entry: LogEntry) => void;\n};\n\nexport type SampleTransportOptions = {\n  /** Minimum level to sample. Default: 'debug'. */\n  level?: LogLevel;\n  /** Finite fraction of entries to forward (0–1). */\n  rate: number;\n  /** Downstream transport to receive sampled entries. */\n  transport: Transport;\n};\n\nexport type RedactTransportOptions = {\n  /**\n   * Field names to replace at any depth in `data`.\n   * Matched by exact field name — dot-path notation (e.g. `'user.password'`) is NOT supported.\n   * A key like `'password'` will redact every field named `'password'` at any nesting level.\n   */\n  keys: string[];\n  /**\n   * Finite non-negative integer maximum object nesting depth to traverse during redaction.\n   * Objects deeper than this limit are returned as-is (not redacted).\n   * A dev-only warning is emitted when the cap is hit.\n   * Default: 20.\n   * @security In production builds, the depth warning is suppressed — deeply-nested sensitive\n   * fields beyond `maxDepth` will pass through unredacted without any indication. Ensure that\n   * sensitive payloads are not nested beyond this limit, or lower `maxDepth` as needed.\n   */\n  maxDepth?: number;\n  /** Replacement value for redacted fields. Default: '[REDACTED]'. */\n  replacement?: string;\n  /** Downstream transport to receive the redacted entry. */\n  transport: Transport;\n};\n\n/* ─── Logger options ─── */\n\nexport type RuneOptions = {\n  /** Initial pinned bindings for this logger instance. `Error` values are auto-serialized, same as per-call context. */\n  bindings?: Bindings;\n  /** Minimum log level for this logger instance. Default: 'debug'. */\n  logLevel?: LogLevel;\n  /** Middleware pipeline applied to every entry before dispatch to transports. */\n  middleware?: LogMiddleware[];\n  /**\n   * Namespace for this logger. When passed to `child()`, it is automatically\n   * dot-joined to the parent namespace (e.g. parent `'api'` + child `'auth'` → `'api.auth'`).\n   */\n  namespace?: string;\n  /**\n   * Transport pipeline. Each transport receives every entry that passes the level threshold.\n   * Default: [consoleTransport()].\n   */\n  transports?: Transport[];\n};\n\n/* ─── Log method ─── */\n\n/**\n * Signature shared by all five log-level methods.\n *\n * - `log.info('message')` — string-only, most common.\n * - `log.info({ ...fields }, 'message')` — structured context + optional message.\n *   `Error` values in `fields` are automatically serialized to `{ message, name, stack }`.\n *   Serialization is shallow only — an `Error` nested inside a nested object is left as-is.\n * - `log.error(err, { ...fields }, 'message')` — Error first, then optional context + message.\n *   Shorthand for the pattern where an Error is the primary subject of the log call.\n *   The context object may be omitted entirely: `log.error(err, 'message')`.\n *\n * @example\n * log.error({ err: new Error('timeout'), requestId }, 'request failed')\n * log.error(new Error('timeout'), { requestId }, 'request failed')\n */\nexport type LogMethod = {\n  (message: string): void;\n  (error: Error, message?: string): void;\n  (error: Error, context: Bindings, message?: string): void;\n  (context: Bindings, message?: string): void;\n};\n\n/* ─── Logger interface ─── */\n\nexport type Logger = {\n  /** Delegates to `dispose()`. Enables `using` declarations. */\n  [Symbol.dispose]: () => void;\n  /** Snapshot of currently pinned bindings. */\n  readonly bindings: Readonly<Bindings>;\n  /** Create a child logger with config overrides. Inherits all config and bindings by default. */\n  child: (overrides?: RuneOptions) => Logger;\n  debug: LogMethod;\n  /** `AbortSignal` aborted when `dispose()` is called. Use to tie external lifetimes to this logger. */\n  readonly disposalSignal: AbortSignal;\n  /**\n   * Marks the logger as disposed — all subsequent log calls become no-ops.\n   * Aborts `disposalSignal`. Does NOT auto-discover or dispose batch transports;\n   * hold a direct reference to `batchTransport` and call its `dispose()` on shutdown.\n   * Idempotent — safe to call multiple times.\n   */\n  dispose: () => void;\n  /** `true` after `dispose()` has been called. */\n  readonly disposed: boolean;\n  /** Returns true if entries at this level will pass the configured threshold. */\n  enabled: (type: LogLevel) => boolean;\n  error: LogMethod;\n  fatal: LogMethod;\n  /**\n   * Wrap a callback in a console group, closing it even on throw/reject.\n   * Pass a `level` to gate the group header on the configured log threshold\n   * (e.g. `level: 'debug'` suppresses the group when `logLevel` is above `'debug'`).\n   * Default: always renders (unless `logLevel` is `'off'`).\n   */\n  group: <T>(label: string, fn: () => T, level?: LogType) => T;\n  /**\n   * Same as `group`, using `console.groupCollapsed`.\n   * Pass a `level` to gate the group on the configured log threshold.\n   */\n  groupCollapsed: <T>(label: string, fn: () => T, level?: LogType) => T;\n  info: LogMethod;\n  /** Active log level for this logger instance. */\n  readonly logLevel: LogLevel;\n  /** Middleware pipeline applied before dispatch. */\n  readonly middleware: readonly LogMiddleware[];\n  /** Namespace string for this logger instance. */\n  readonly namespace: string;\n  /**\n   * Measure execution time of `fn` and emit a structured log entry.\n   * The entry message is `label`; `data` contains `{ duration_ms }` (rounded to 2 dp).\n   * When `fn` throws or rejects, `data` also includes `{ err }` with the serialized error.\n   * @param label - Human-readable description of the operation.\n   * @param fn - Synchronous or async function to time.\n   * @param level - Log level for the timing entry. Default: `'debug'`.\n   */\n  time: <T>(label: string, fn: () => T, level?: LogType) => T;\n  /** Transport pipeline for this logger instance. */\n  readonly transports: readonly Transport[];\n  /**\n   * Add a middleware function to the pipeline. Returns a **new** logger — the original is unchanged.\n   * Discarding the return value is a common mistake: always assign the result.\n   * @example\n   * const log = baseLog.use(tracingMiddleware); // ✓ keep the result\n   */\n  use: (middleware: LogMiddleware) => Logger;\n  warn: LogMethod;\n  /**\n   * Derive a child logger with additional pinned bindings.\n   * The returned logger is fully independent — disposing it does not affect the parent,\n   * and disposing the parent does not affect child loggers.\n   */\n  withBindings: (bindings: Bindings) => Logger;\n};\n"],"mappings":";AAMA,IAAa,IAAqC;CAChD,OAAO;CACP,OAAO;CACP,OAAO;CACP,MAAM;CACN,KAAK;CACL,MAAM;AACR;AAGA,SAAgB,EAAe,GAAqB,GAA0B;CAG5E,OAFI,MAAU,SAEP,EAAS,MAAc,EAAS;AACzC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vielzeug/rune",
-  "version": "1.1.2",
+  "version": "2.0.0",
   "description": "Structured logging — scoped loggers, pluggable transports, log levels, and remote log draining",
   "type": "module",
   "files": [
@@ -11,7 +11,6 @@
   "types": "dist/index.d.ts",
   "exports": {
     ".": {
-      "source": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
@@ -35,9 +34,9 @@
     "node": ">=22"
   },
   "devDependencies": {
-    "@types/node": "^26.1.0",
+    "@types/node": "^26.1.2",
     "typescript": "^6.0.3",
-    "vite": "^8.1.3",
+    "vite": "^8.2.0",
     "vitest": "^4.1.10"
   }
 }