loggily 0.7.0 → 0.10.0

package/dist/{index-Co4jC3mx.d.mts → file-writer-BhJzFNKE.d.mts}

@@ -1,49 +1,5 @@
-import { c as SpanData } from "./core-DAFH-huv.mjs";
+import { l as SpanData } from "./core-DHB4KaG1.mjs";
 
-//#region src/file-writer.d.ts
-/**
- * File writer for loggily — Node.js/Bun only.
- *
- * Separated from core logger to allow tree-shaking in browser bundles.
- * Uses dynamic import("node:fs") to avoid static dependency on Node APIs.
- */
-/** Options for creating an async buffered file writer */
-interface FileWriterOptions {
-  /** Buffer size threshold in bytes before flushing (default: 4096) */
-  bufferSize?: number;
-  /** Flush interval in milliseconds (default: 100) */
-  flushInterval?: number;
-}
-/** An async buffered file writer with automatic flushing */
-interface FileWriter {
-  /** Write a line to the buffer (appends newline) */
-  write(line: string): void;
-  /** Flush the buffer immediately */
-  flush(): void;
-  /** Close the writer and flush remaining buffer */
-  close(): void;
-}
-/**
- * Create an async buffered file writer for log output.
- * Buffers writes and flushes on size threshold or interval.
- * Registers a process.on('exit') handler to flush remaining buffer.
- *
- * **Node.js/Bun only** — not available in browser environments.
- *
- * @param filePath - Path to the log file (opened in append mode)
- * @param options - Buffer size and flush interval configuration
- * @returns FileWriter with write, flush, and close methods
- *
- * @example
- * const writer = createFileWriter('/tmp/app.log')
- * const unsubscribe = addWriter((formatted) => writer.write(formatted))
- *
- * // On shutdown:
- * unsubscribe()
- * writer.close()
- */
-declare function createFileWriter(filePath: string, options?: FileWriterOptions): FileWriter;
-//#endregion
 //#region src/tracing.d.ts
 /** Supported ID formats */
 type IdFormat = "simple" | "w3c";
@@ -51,9 +7,15 @@ type IdFormat = "simple" | "w3c";
  * Set the ID format for new spans and traces.
  * - "simple": sp_1, sp_2, tr_1, tr_2 (default, lightweight)
  * - "w3c": 32-char hex trace ID, 16-char hex span ID (W3C Trace Context compatible)
+ *
+ * @deprecated Use the `TRACE_ID_FORMAT` env var or `{ idFormat: "w3c" }` in the config array instead.
  */
 declare function setIdFormat(format: IdFormat): void;
-/** Get the current ID format */
+/**
+ * Get the current ID format.
+ *
+ * @deprecated Use the `TRACE_ID_FORMAT` env var or `{ idFormat: "w3c" }` in the config array instead.
+ */
 declare function getIdFormat(): IdFormat;
 /** Options for traceparent header formatting */
 interface TraceparentOptions {
@@ -77,7 +39,8 @@ interface TraceparentOptions {
  *
  * @example
  * ```typescript
- * const span = log.span("http-request")
+ * const span = log.span?.("http-request")
+ * if (!span) return
  * const header = traceparent(span.spanData)
  * // → "00-a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6-1a2b3c4d5e6f7a8b-01"
  * fetch(url, { headers: { traceparent: header } })
@@ -88,11 +51,66 @@ declare function traceparent(spanData: SpanData, options?: TraceparentOptions):
  * Set the head-based sampling rate for new traces.
  * Applied at trace creation — all spans within a sampled trace are kept.
  *
+ * @deprecated Use the `TRACE_SAMPLE_RATE` env var or `{ sampleRate: 0.1 }` in the config array instead.
  * @param rate - Sampling rate from 0.0 (sample nothing) to 1.0 (sample everything, default)
  */
 declare function setSampleRate(rate: number): void;
-/** Get the current sampling rate */
+/**
+ * Get the current sampling rate.
+ *
+ * @deprecated Use the `TRACE_SAMPLE_RATE` env var or `{ sampleRate: 0.1 }` in the config array instead.
+ */
 declare function getSampleRate(): number;
 //#endregion
-export { setIdFormat as a, FileWriter as c, getSampleRate as i, FileWriterOptions as l, TraceparentOptions as n, setSampleRate as o, getIdFormat as r, traceparent as s, IdFormat as t, createFileWriter as u };
-//# sourceMappingURL=index-Co4jC3mx.d.mts.map
+//#region src/file-writer.d.ts
+/**
+ * File writer for loggily — Node.js/Bun only.
+ *
+ * Separated from core logger to allow tree-shaking in browser bundles.
+ * Uses dynamic import("node:fs") to avoid static dependency on Node APIs.
+ */
+/** Options for creating an async buffered file writer */
+interface FileWriterOptions {
+  /** Buffer size threshold in bytes before flushing (default: 4096) */
+  bufferSize?: number;
+  /** Flush interval in milliseconds (default: 100) */
+  flushInterval?: number;
+  /** Test-only filesystem injection. Production callers should omit this. */
+  __fs?: {
+    openSync(path: string, flags: string): number;
+    writeSync(fd: number, data: string): unknown;
+    closeSync(fd: number): void;
+  };
+}
+/** An async buffered file writer with automatic flushing */
+interface FileWriter {
+  /** Write a line to the buffer (appends newline) */
+  write(line: string): void;
+  /** Flush the buffer immediately */
+  flush(): void;
+  /** Close the writer and flush remaining buffer */
+  close(): void;
+}
+/**
+ * Create an async buffered file writer for log output.
+ * Buffers writes and flushes on size threshold or interval.
+ * Registers a process.on('exit') handler to flush remaining buffer.
+ *
+ * **Node.js/Bun only** — not available in browser environments.
+ *
+ * @param filePath - Path to the log file (opened in append mode)
+ * @param options - Buffer size and flush interval configuration
+ * @returns FileWriter with write, flush, and close methods
+ *
+ * @example
+ * const writer = createFileWriter('/tmp/app.log')
+ * const unsubscribe = addWriter((formatted) => writer.write(formatted))
+ *
+ * // On shutdown:
+ * unsubscribe()
+ * writer.close()
+ */
+declare function createFileWriter(filePath: string, options?: FileWriterOptions): FileWriter;
+//#endregion
+export { TraceparentOptions as a, setIdFormat as c, IdFormat as i, setSampleRate as l, FileWriterOptions as n, getIdFormat as o, createFileWriter as r, getSampleRate as s, FileWriter as t, traceparent as u };
+//# sourceMappingURL=file-writer-BhJzFNKE.d.mts.map

package/dist/file-writer-BhJzFNKE.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-writer-BhJzFNKE.d.mts","names":[],"sources":["../src/tracing.ts","../src/file-writer.ts"],"mappings":";;;;KAYY,QAAA;;;;;AAoBZ;;;iBATgB,WAAA,CAAY,MAAA,EAAQ,QAAA;;AAkDpC;;;;iBAzCgB,WAAA,CAAA,GAAe,QAAA;;UAyCd,kBAAA;EA+Ba;EA7B5B,OAAA;AAAA;;;;;AA6EF;;;;;;;;AC9IA;;;;;;;;;;;;iBD4FgB,WAAA,CACd,QAAA,EAAU,QAAA,EACV,OAAA,GAAU,kBAAA;;;;;AChFZ;;;iBDoHgB,aAAA,CAAc,IAAA;;;;;;iBAYd,aAAA,CAAA;;;;;;AA5IhB;;;;UCFiB,iBAAA;EDaD;ECXd,UAAA;;EAEA,aAAA;EDS0C;ECP1C,IAAA;IACE,QAAA,CAAS,IAAA,UAAc,KAAA;IACvB,SAAA,CAAU,EAAA,UAAY,IAAA;IACtB,SAAA,CAAU,EAAA;EAAA;AAAA;;UAKG,UAAA;EDmDf;ECjDA,KAAA,CAAM,IAAA;ED4EQ;EC1Ed,KAAA;;EAEA,KAAA;AAAA;;;;;;AD8GF;;;;;AAYA;;;;;;;;AC9IA;iBA0CgB,gBAAA,CACd,QAAA,UACA,OAAA,GAAS,iBAAA,GACR,UAAA"}

package/dist/index.browser.d.mts

@@ -0,0 +1,10 @@
+import { A as getTraceFilter, B as startCollecting, C as disableSpans, D as getLogFormat, E as getDebugFilter, F as setLogLevel, G as writeSpan, H as withConfigMetrics, I as setOutputMode, L as setSuppressConsole, M as resetIds, N as setDebugFilter, O as getLogLevel, P as setLogFormat, R as setTraceFilter, S as createTestLogger, T as getCollectedSpans, U as withEnvDefaults, V as stopCollecting, W as withSpans, _ as addWriter, a as LoggerFactory, b as createLogger, c as PluginCtx, d as SpanRecord, f as SpanRecorder, i as Logger, j as pipe, k as getOutputMode, l as SpanData, m as WriterFn, n as LazyMessage, o as LoggerPlugin, r as LazyProps, s as OutputMode, t as ConditionalLogger, u as SpanLogger, v as baseCreateLogger, w as enableSpans, y as clearCollectedSpans, z as spansAreEnabled } from "./core-DHB4KaG1.mjs";
+import { a as LOG_LEVEL_PRIORITY, c as LogLevel, d as SpanEvent, f as Stage, h as safeStringify, i as FileDescriptor, l as OutputLogLevel, m as buildPipeline, n as ConfigObject, o as LogEvent, p as Writable, r as Event, s as LogFormat, t as ConfigElement, u as Pipeline } from "./pipeline-D0omS7eF.mjs";
+import { a as TraceparentOptions, c as setIdFormat, i as IdFormat, l as setSampleRate, n as FileWriterOptions, o as getIdFormat, s as getSampleRate, t as FileWriter, u as traceparent } from "./file-writer-BhJzFNKE.mjs";
+
+//#region src/index.browser.d.ts
+/** @throws Always — createFileWriter is not available in browser environments */
+declare function createFileWriter(): never;
+//#endregion
+export { type ConditionalLogger, type ConfigElement, type ConfigObject, type Event, type FileDescriptor, type FileWriter, type FileWriterOptions, type IdFormat, LOG_LEVEL_PRIORITY, type LazyMessage, type LazyProps, type LogEvent, type LogFormat, type LogLevel, type Logger, type LoggerFactory, type LoggerPlugin, type OutputLogLevel, type OutputMode, type Pipeline, type PluginCtx, type SpanData, type SpanEvent, type SpanLogger, type SpanRecord, type SpanRecorder, type Stage, type TraceparentOptions, type Writable, type WriterFn, addWriter, baseCreateLogger, buildPipeline, clearCollectedSpans, createFileWriter, createLogger, createTestLogger, disableSpans, enableSpans, getCollectedSpans, getDebugFilter, getIdFormat, getLogFormat, getLogLevel, getOutputMode, getSampleRate, getTraceFilter, pipe, resetIds, safeStringify, setDebugFilter, setIdFormat, setLogFormat, setLogLevel, setOutputMode, setSampleRate, setSuppressConsole, setTraceFilter, spansAreEnabled, startCollecting, stopCollecting, traceparent, withConfigMetrics, withEnvDefaults, withSpans, writeSpan };
+//# sourceMappingURL=index.browser.d.mts.map

package/dist/index.browser.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.browser.d.mts","names":[],"sources":["../src/index.browser.ts"],"mappings":";;;;;;iBAmGgB,gBAAA,CAAA"}

package/dist/index.browser.mjs

@@ -0,0 +1,10 @@
+import { A as withEnvDefaults, B as setSampleRate, C as setOutputMode, D as startCollecting, E as spansAreEnabled, F as safeStringify, L as getIdFormat, M as writeSpan, N as LOG_LEVEL_PRIORITY, O as stopCollecting, P as buildPipeline, R as getSampleRate, S as setLogLevel, T as setTraceFilter, V as traceparent, _ as getTraceFilter, a as baseCreateLogger, b as setDebugFilter, d as enableSpans, f as getCollectedSpans, g as getOutputMode, h as getLogLevel, i as addWriter, j as withSpans, k as withConfigMetrics, l as createTestLogger, m as getLogFormat, o as clearCollectedSpans, p as getDebugFilter, s as createLogger, u as disableSpans, v as pipe, w as setSuppressConsole, x as setLogFormat, y as resetIds, z as setIdFormat } from "./core-Byd3DY71.mjs";
+//#region src/index.browser.ts
+/** @throws Always — createFileWriter is not available in browser environments */
+function createFileWriter() {
+	throw new Error("createFileWriter is not available in browser environments. Use a writable sink in the config array instead.");
+}
+//#endregion
+export { LOG_LEVEL_PRIORITY, addWriter, baseCreateLogger, buildPipeline, clearCollectedSpans, createFileWriter, createLogger, createTestLogger, disableSpans, enableSpans, getCollectedSpans, getDebugFilter, getIdFormat, getLogFormat, getLogLevel, getOutputMode, getSampleRate, getTraceFilter, pipe, resetIds, safeStringify, setDebugFilter, setIdFormat, setLogFormat, setLogLevel, setOutputMode, setSampleRate, setSuppressConsole, setTraceFilter, spansAreEnabled, startCollecting, stopCollecting, traceparent, withConfigMetrics, withEnvDefaults, withSpans, writeSpan };
+
+//# sourceMappingURL=index.browser.mjs.map

package/dist/index.browser.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.browser.mjs","names":[],"sources":["../src/index.browser.ts"],"sourcesContent":["/**\n * loggily v2 browser entry point.\n *\n * Re-exports the full logger API except createFileWriter (which requires node:fs).\n * Bundlers resolve this via the \"browser\" condition in package.json exports.\n */\n\nexport {\n  // Core API\n  createLogger,\n  baseCreateLogger,\n  createTestLogger,\n  pipe,\n  withSpans,\n  withEnvDefaults,\n  withConfigMetrics,\n  type LoggerFactory,\n  type LoggerPlugin,\n  type PluginCtx,\n\n  // Types\n  type ConditionalLogger,\n  type Logger,\n  type SpanLogger,\n  type SpanData,\n  type LazyMessage,\n  type LazyProps,\n  type Event,\n  type LogEvent,\n  type SpanEvent,\n  type Stage,\n  type LogLevel,\n  type OutputLogLevel,\n  type LogFormat,\n  type OutputMode,\n\n  // Constants\n  LOG_LEVEL_PRIORITY,\n\n  // Utilities\n  safeStringify,\n  resetIds,\n\n  // Span collection\n  startCollecting,\n  stopCollecting,\n  getCollectedSpans,\n  clearCollectedSpans,\n\n  // Span metrics\n  type SpanRecord,\n  type SpanRecorder,\n\n  // Deprecated v1 API (throws with migration instructions)\n  setLogLevel,\n  getLogLevel,\n  enableSpans,\n  disableSpans,\n  spansAreEnabled,\n  setTraceFilter,\n  getTraceFilter,\n  setDebugFilter,\n  getDebugFilter,\n  setLogFormat,\n  getLogFormat,\n  setSuppressConsole,\n  setOutputMode,\n  getOutputMode,\n  addWriter,\n  type WriterFn,\n  writeSpan,\n} from \"./core.js\"\n\n// Tracing utilities (runtime-agnostic, work in browser)\nexport {\n  setIdFormat,\n  getIdFormat,\n  type IdFormat,\n  traceparent,\n  type TraceparentOptions,\n  setSampleRate,\n  getSampleRate,\n} from \"./tracing.js\"\n\n// Pipeline builder for power users\nexport { buildPipeline, type Pipeline } from \"./pipeline.js\"\n\n// Re-export config types for typed pipeline construction\nexport type {\n  ConfigElement,\n  ConfigObject,\n  FileDescriptor,\n  Writable,\n} from \"./pipeline.js\"\n\n// File writer types (exported for type compatibility, but the function throws)\nexport type { FileWriterOptions, FileWriter } from \"./file-writer.js\"\n\n/** @throws Always — createFileWriter is not available in browser environments */\nexport function createFileWriter(): never {\n  throw new Error(\n    \"createFileWriter is not available in browser environments. Use a writable sink in the config array instead.\",\n  )\n}\n"],"mappings":";;;AAmGA,SAAgB,mBAA0B;AACxC,OAAM,IAAI,MACR,8GACD"}

package/dist/index.d.mts

@@ -1,3 +1,4 @@
-import { A as setDebugFilter, B as Event, C as getCollectedSpans, D as getOutputMode, E as getLogLevel, F as setTraceFilter, G as OutputLogLevel, H as LogEvent, I as spansAreEnabled, J as Stage, K as Pipeline, L as startCollecting, M as setLogLevel, N as setOutputMode, O as getTraceFilter, P as setSuppressConsole, R as stopCollecting, S as enableSpans, T as getLogFormat, U as LogFormat, V as LOG_LEVEL_PRIORITY, W as LogLevel, X as defaultPipeline, Y as buildPipeline, Z as safeStringify, _ as clearCollectedSpans, a as LoggerFactory, b as createSpanDataProxy, c as SpanData, d as SpanRecorder, f as _ambientRecorder, g as addWriter, h as _setContextHooks, i as Logger, j as setLogFormat, k as resetIds, l as SpanLogger, m as _setAmbientRecorder, n as LazyMessage, o as LoggerPlugin, p as _clearContextHooks, q as SpanEvent, r as LazyProps, s as OutputMode, t as ConditionalLogger, u as SpanRecord, v as compose, w as getDebugFilter, x as disableSpans, y as createLogger, z as writeSpan } from "./core-DAFH-huv.mjs";
-import { a as setIdFormat, c as FileWriter, i as getSampleRate, l as FileWriterOptions, n as TraceparentOptions, o as setSampleRate, r as getIdFormat, s as traceparent, t as IdFormat, u as createFileWriter } from "./index-Co4jC3mx.mjs";
-export { ConditionalLogger, Event, FileWriter, FileWriterOptions, IdFormat, LOG_LEVEL_PRIORITY, LazyMessage, LazyProps, LogEvent, LogFormat, LogLevel, Logger, LoggerFactory, LoggerPlugin, OutputLogLevel, OutputMode, Pipeline, SpanData, SpanEvent, SpanLogger, SpanRecord, SpanRecorder, Stage, TraceparentOptions, _ambientRecorder, _clearContextHooks, _setAmbientRecorder, _setContextHooks, addWriter, buildPipeline, clearCollectedSpans, compose, createFileWriter, createLogger, createSpanDataProxy, defaultPipeline, disableSpans, enableSpans, getCollectedSpans, getDebugFilter, getIdFormat, getLogFormat, getLogLevel, getOutputMode, getSampleRate, getTraceFilter, resetIds, safeStringify, setDebugFilter, setIdFormat, setLogFormat, setLogLevel, setOutputMode, setSampleRate, setSuppressConsole, setTraceFilter, spansAreEnabled, startCollecting, stopCollecting, traceparent, writeSpan };
+import { A as getTraceFilter, B as startCollecting, C as disableSpans, D as getLogFormat, E as getDebugFilter, F as setLogLevel, G as writeSpan, H as withConfigMetrics, I as setOutputMode, L as setSuppressConsole, M as resetIds, N as setDebugFilter, O as getLogLevel, P as setLogFormat, R as setTraceFilter, S as createTestLogger, T as getCollectedSpans, U as withEnvDefaults, V as stopCollecting, W as withSpans, _ as addWriter, a as LoggerFactory, b as createLogger, c as PluginCtx, d as SpanRecord, f as SpanRecorder, g as _setContextHooks, h as _clearContextHooks, i as Logger, j as pipe, k as getOutputMode, l as SpanData, m as WriterFn, n as LazyMessage, o as LoggerPlugin, p as SpannedLogger, r as LazyProps, s as OutputMode, t as ConditionalLogger, u as SpanLogger, v as baseCreateLogger, w as enableSpans, x as createSpanDataProxy, y as clearCollectedSpans, z as spansAreEnabled } from "./core-DHB4KaG1.mjs";
+import { a as LOG_LEVEL_PRIORITY, c as LogLevel, d as SpanEvent, f as Stage, g as serializeCause, h as safeStringify, i as FileDescriptor, l as OutputLogLevel, m as buildPipeline, n as ConfigObject, o as LogEvent, p as Writable, r as Event, s as LogFormat, t as ConfigElement, u as Pipeline } from "./pipeline-D0omS7eF.mjs";
+import { a as TraceparentOptions, c as setIdFormat, i as IdFormat, l as setSampleRate, n as FileWriterOptions, o as getIdFormat, r as createFileWriter, s as getSampleRate, t as FileWriter, u as traceparent } from "./file-writer-BhJzFNKE.mjs";
+export { type ConditionalLogger, type ConfigElement, type ConfigObject, type Event, type FileDescriptor, type FileWriter, type FileWriterOptions, type IdFormat, LOG_LEVEL_PRIORITY, type LazyMessage, type LazyProps, type LogEvent, type LogFormat, type LogLevel, type Logger, type LoggerFactory, type LoggerPlugin, type OutputLogLevel, type OutputMode, type Pipeline, type PluginCtx, type SpanData, type SpanEvent, type SpanLogger, type SpanRecord, type SpanRecorder, type SpannedLogger, type Stage, type TraceparentOptions, type Writable, type WriterFn, _clearContextHooks, _setContextHooks, addWriter, baseCreateLogger, buildPipeline, clearCollectedSpans, createFileWriter, createLogger, createSpanDataProxy, createTestLogger, disableSpans, enableSpans, getCollectedSpans, getDebugFilter, getIdFormat, getLogFormat, getLogLevel, getOutputMode, getSampleRate, getTraceFilter, pipe, resetIds, safeStringify, serializeCause, setDebugFilter, setIdFormat, setLogFormat, setLogLevel, setOutputMode, setSampleRate, setSuppressConsole, setTraceFilter, spansAreEnabled, startCollecting, stopCollecting, traceparent, withConfigMetrics, withEnvDefaults, withSpans, writeSpan };

package/dist/index.mjs

@@ -1,2 +1,7 @@
-import { A as getSampleRate, C as setSuppressConsole, D as stopCollecting, E as startCollecting, F as buildPipeline, I as defaultPipeline, L as safeStringify, M as setSampleRate, N as traceparent, O as writeSpan, P as LOG_LEVEL_PRIORITY, R as createFileWriter, S as setOutputMode, T as spansAreEnabled, _ as getTraceFilter, a as addWriter, b as setLogFormat, c as createLogger, d as enableSpans, f as getCollectedSpans, g as getOutputMode, h as getLogLevel, i as _setContextHooks, j as setIdFormat, k as getIdFormat, l as createSpanDataProxy, m as getLogFormat, n as _clearContextHooks, o as clearCollectedSpans, p as getDebugFilter, r as _setAmbientRecorder, s as compose, t as _ambientRecorder, u as disableSpans, v as resetIds, w as setTraceFilter, x as setLogLevel, y as setDebugFilter } from "./core-Du3sIje6.mjs";
-export { LOG_LEVEL_PRIORITY, _ambientRecorder, _clearContextHooks, _setAmbientRecorder, _setContextHooks, addWriter, buildPipeline, clearCollectedSpans, compose, createFileWriter, createLogger, createSpanDataProxy, defaultPipeline, disableSpans, enableSpans, getCollectedSpans, getDebugFilter, getIdFormat, getLogFormat, getLogLevel, getOutputMode, getSampleRate, getTraceFilter, resetIds, safeStringify, setDebugFilter, setIdFormat, setLogFormat, setLogLevel, setOutputMode, setSampleRate, setSuppressConsole, setTraceFilter, spansAreEnabled, startCollecting, stopCollecting, traceparent, writeSpan };
+import { A as withEnvDefaults, B as setSampleRate, C as setOutputMode, D as startCollecting, E as spansAreEnabled, F as safeStringify, H as createFileWriter, I as serializeCause, L as getIdFormat, M as writeSpan, N as LOG_LEVEL_PRIORITY, O as stopCollecting, P as buildPipeline, R as getSampleRate, S as setLogLevel, T as setTraceFilter, V as traceparent, _ as getTraceFilter, a as baseCreateLogger, b as setDebugFilter, c as createSpanDataProxy, d as enableSpans, f as getCollectedSpans, g as getOutputMode, h as getLogLevel, i as addWriter, j as withSpans, k as withConfigMetrics, l as createTestLogger, m as getLogFormat, n as _setContextHooks, o as clearCollectedSpans, p as getDebugFilter, r as _setLogFileWriterFactory, s as createLogger, t as _clearContextHooks, u as disableSpans, v as pipe, w as setSuppressConsole, x as setLogFormat, y as resetIds, z as setIdFormat } from "./core-Byd3DY71.mjs";
+//#region src/index.ts
+_setLogFileWriterFactory(createFileWriter);
+//#endregion
+export { LOG_LEVEL_PRIORITY, _clearContextHooks, _setContextHooks, addWriter, baseCreateLogger, buildPipeline, clearCollectedSpans, createFileWriter, createLogger, createSpanDataProxy, createTestLogger, disableSpans, enableSpans, getCollectedSpans, getDebugFilter, getIdFormat, getLogFormat, getLogLevel, getOutputMode, getSampleRate, getTraceFilter, pipe, resetIds, safeStringify, serializeCause, setDebugFilter, setIdFormat, setLogFormat, setLogLevel, setOutputMode, setSampleRate, setSuppressConsole, setTraceFilter, spansAreEnabled, startCollecting, stopCollecting, traceparent, withConfigMetrics, withEnvDefaults, withSpans, writeSpan };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["_cfw"],"sources":["../src/index.ts"],"sourcesContent":["/**\n * loggily v2 — Structured logging with spans\n *\n * One import. Objects configure. Arrays branch. Values write.\n */\n\nexport {\n  // Core API\n  createLogger,\n  baseCreateLogger,\n  createTestLogger,\n  pipe,\n  type LoggerFactory,\n  type LoggerPlugin,\n  type PluginCtx,\n  // Plugins\n  withSpans,\n  withEnvDefaults,\n  withConfigMetrics,\n  // Types\n  type ConditionalLogger,\n  type Logger,\n  type SpanLogger,\n  type SpannedLogger,\n  type SpanData,\n  type LazyMessage,\n  type LazyProps,\n  type Event,\n  type LogEvent,\n  type SpanEvent,\n  type Stage,\n  type LogLevel,\n  type OutputLogLevel,\n  type LogFormat,\n  type OutputMode,\n  // Constants\n  LOG_LEVEL_PRIORITY,\n  // Utilities\n  safeStringify,\n  resetIds,\n  // Span collection\n  startCollecting,\n  stopCollecting,\n  getCollectedSpans,\n  clearCollectedSpans,\n  // Span metrics\n  type SpanRecord,\n  type SpanRecorder,\n  // Internal (used by context.ts)\n  _setContextHooks,\n  _clearContextHooks,\n  createSpanDataProxy,\n  // Deprecated v1 API (maps to env vars for backwards compat)\n  setLogLevel,\n  getLogLevel,\n  enableSpans,\n  disableSpans,\n  spansAreEnabled,\n  setTraceFilter,\n  getTraceFilter,\n  setDebugFilter,\n  getDebugFilter,\n  setLogFormat,\n  getLogFormat,\n  setSuppressConsole,\n  setOutputMode,\n  getOutputMode,\n  addWriter,\n  type WriterFn,\n  writeSpan,\n} from \"./core.js\"\n\nexport {\n  createFileWriter,\n  type FileWriter,\n  type FileWriterOptions,\n} from \"./file-writer.js\"\n\n// Wire file writer into core for LOG_FILE env var support\nimport { createFileWriter as _cfw } from \"./file-writer.js\"\nimport { _setLogFileWriterFactory } from \"./core.js\"\n_setLogFileWriterFactory(_cfw)\n\nexport {\n  setIdFormat,\n  getIdFormat,\n  type IdFormat,\n  traceparent,\n  type TraceparentOptions,\n  setSampleRate,\n  getSampleRate,\n} from \"./tracing.js\"\n\n// Re-export pipeline builder and utilities for power users\nexport { buildPipeline, type Pipeline, serializeCause } from \"./pipeline.js\"\n\n// Re-export config types for typed pipeline construction\nexport type {\n  ConfigElement,\n  ConfigObject,\n  FileDescriptor,\n  Writable,\n} from \"./pipeline.js\"\n"],"mappings":";;AAiFA,yBAAyBA,iBAAK"}

package/dist/metrics.d.mts

@@ -1,48 +1,2 @@
-import { d as SpanRecorder, t as ConditionalLogger, u as SpanRecord } from "./core-DAFH-huv.mjs";
-
-//#region src/metrics.d.ts
-interface SpanStats {
-  count: number;
-  min: number;
-  max: number;
-  mean: number;
-  p50: number;
-  p95: number;
-  p99: number;
-  total: number;
-}
-interface MetricsCollector extends SpanRecorder {
-  /** Get stats for a specific span namespace */
-  stats(name: string): SpanStats | undefined;
-  /** Get stats for all recorded namespaces */
-  all(): Map<string, SpanStats>;
-  /** Format a human-readable summary */
-  summary(): string;
-  /** Reset all collected data */
-  reset(): void;
-}
-declare function createMetricsCollector(maxEntries?: number): MetricsCollector;
-/** Get aggregated span stats (from ambient collector). */
-declare function spanStats(): Map<string, SpanStats>;
-/** Get the ambient collector's formatted summary. */
-declare function spanSummary(): string;
-/** Reset the ambient collector. */
-declare function resetSpanStats(): void;
-/**
- * Compose a logger with a metrics collector.
- * Returns a curried wrapper: `withMetrics(collector?)(logger)`
- *
- * - No arg: uses the built-in ambient collector
- * - Custom collector: records to your collector
- * - Stackable: `withMetrics(a)(withMetrics(b)(logger))` fans out to both
- *
- * @example
- * ```typescript
- * const log = withMetrics()(createLogger("myapp"))
- * const log = withMetrics(myCollector)(createLogger("myapp"))
- * ```
- */
-declare function withMetrics(collector?: SpanRecorder): (logger: ConditionalLogger) => ConditionalLogger;
-//#endregion
-export { MetricsCollector, type SpanRecord, type SpanRecorder, SpanStats, createMetricsCollector, resetSpanStats, spanStats, spanSummary, withMetrics };
-//# sourceMappingURL=metrics.d.mts.map
+import { J as createMetricsCollector, K as MetricsCollector, Y as withMetrics, d as SpanRecord, f as SpanRecorder, q as SpanStats } from "./core-DHB4KaG1.mjs";
+export { MetricsCollector, SpanRecord, SpanRecorder, SpanStats, createMetricsCollector, withMetrics };

package/dist/metrics.mjs

@@ -1,23 +1,4 @@
-import { r as _setAmbientRecorder } from "./core-Du3sIje6.mjs";
 //#region src/metrics.ts
-/**
-* Metrics collection for loggily spans.
-*
-* Two modes:
-* - **Ambient**: import this module → spans auto-record when TRACE is active
-* - **Explicit**: `withMetrics(collector?)(logger)` for custom collection
-*
-* @example
-* ```typescript
-* import { spanStats } from "loggily/metrics"
-* // TRACE=myapp bun run app
-* // → on exit: spanStats() returns aggregated p50/p95/p99
-*
-* // Custom collector:
-* import { withMetrics, createMetricsCollector } from "loggily/metrics"
-* const log = withMetrics()(createLogger("myapp"))
-* ```
-*/
 function percentile(sorted, p) {
 	if (sorted.length === 0) return 0;
 	return sorted[Math.min(Math.floor(sorted.length * p), sorted.length - 1)];
@@ -68,38 +49,23 @@ function createMetricsCollector(maxEntries = 1e3) {
 		}
 	};
 }
-const _ambient = createMetricsCollector();
-_setAmbientRecorder(_ambient);
-/** Get aggregated span stats (from ambient collector). */
-function spanStats() {
-	return _ambient.all();
-}
-/** Get the ambient collector's formatted summary. */
-function spanSummary() {
-	return _ambient.summary();
-}
-/** Reset the ambient collector. */
-function resetSpanStats() {
-	_ambient.reset();
-}
 /**
 * Compose a logger with a metrics collector.
-* Returns a curried wrapper: `withMetrics(collector?)(logger)`
+* Returns a curried wrapper: `withMetrics(collector)(logger)`
 *
-* - No arg: uses the built-in ambient collector
-* - Custom collector: records to your collector
-* - Stackable: `withMetrics(a)(withMetrics(b)(logger))` fans out to both
+* Records span duration to the provided collector on span disposal.
+* Stackable: `withMetrics(a)(withMetrics(b)(logger))` fans out to both.
 *
 * @example
 * ```typescript
-* const log = withMetrics()(createLogger("myapp"))
-* const log = withMetrics(myCollector)(createLogger("myapp"))
+* const collector = createMetricsCollector()
+* const log = withMetrics(collector)(createLogger("myapp"))
 * ```
 */
 function withMetrics(collector) {
-	const recorder = collector ?? _ambient;
 	return (logger) => {
 		return new Proxy(logger, { get(target, prop) {
+			if (prop === "metrics") return collector;
 			if (prop === "span") {
 				const originalSpan = target.span;
 				if (!originalSpan) return void 0;
@@ -108,7 +74,7 @@ function withMetrics(collector) {
 					const originalDispose = span[Symbol.dispose];
 					span[Symbol.dispose] = () => {
 						originalDispose.call(span);
-						if (span.spanData?.duration != null) recorder.recordSpan({
+						if (span.spanData?.duration != null) collector.recordSpan({
 							name: span.name,
 							durationMs: span.spanData.duration
 						});
@@ -116,15 +82,19 @@ function withMetrics(collector) {
 					return span;
 				};
 			}
+			if (prop === "child") return (namespaceOrContext, childProps) => {
+				const child = target.child(namespaceOrContext, childProps);
+				return withMetrics(collector)(child);
+			};
 			if (prop === "logger") return (namespace, childProps) => {
 				const child = target.logger(namespace, childProps);
-				return withMetrics(recorder)(child);
+				return withMetrics(collector)(child);
 			};
 			return target[prop];
 		} });
 	};
 }
 //#endregion
-export { createMetricsCollector, resetSpanStats, spanStats, spanSummary, withMetrics };
+export { createMetricsCollector, withMetrics };
 
 //# sourceMappingURL=metrics.mjs.map

package/dist/metrics.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"metrics.mjs","names":[],"sources":["../src/metrics.ts"],"sourcesContent":["/**\n * Metrics collection for loggily spans.\n *\n * Two modes:\n * - **Ambient**: import this module → spans auto-record when TRACE is active\n * - **Explicit**: `withMetrics(collector?)(logger)` for custom collection\n *\n * @example\n * ```typescript\n * import { spanStats } from \"loggily/metrics\"\n * // TRACE=myapp bun run app\n * // → on exit: spanStats() returns aggregated p50/p95/p99\n *\n * // Custom collector:\n * import { withMetrics, createMetricsCollector } from \"loggily/metrics\"\n * const log = withMetrics()(createLogger(\"myapp\"))\n * ```\n */\n\nimport {\n  type SpanRecorder,\n  type SpanRecord,\n  type ConditionalLogger,\n  type Logger,\n  type LazyProps,\n  type SpanLogger,\n  _setAmbientRecorder,\n  spansAreEnabled,\n} from \"./core.js\"\n\nexport type { SpanRecorder, SpanRecord }\n\n// ============ Stats ============\n\nexport interface SpanStats {\n  count: number\n  min: number\n  max: number\n  mean: number\n  p50: number\n  p95: number\n  p99: number\n  total: number\n}\n\nfunction percentile(sorted: number[], p: number): number {\n  if (sorted.length === 0) return 0\n  const idx = Math.min(Math.floor(sorted.length * p), sorted.length - 1)\n  return sorted[idx]!\n}\n\nfunction computeStats(durations: number[]): SpanStats {\n  const sorted = [...durations].sort((a, b) => a - b)\n  const total = sorted.reduce((sum, d) => sum + d, 0)\n  return {\n    count: sorted.length,\n    min: sorted[0] ?? 0,\n    max: sorted[sorted.length - 1] ?? 0,\n    mean: sorted.length > 0 ? total / sorted.length : 0,\n    p50: percentile(sorted, 0.5),\n    p95: percentile(sorted, 0.95),\n    p99: percentile(sorted, 0.99),\n    total,\n  }\n}\n\n// ============ Collector ============\n\nexport interface MetricsCollector extends SpanRecorder {\n  /** Get stats for a specific span namespace */\n  stats(name: string): SpanStats | undefined\n  /** Get stats for all recorded namespaces */\n  all(): Map<string, SpanStats>\n  /** Format a human-readable summary */\n  summary(): string\n  /** Reset all collected data */\n  reset(): void\n}\n\nexport function createMetricsCollector(maxEntries = 1000): MetricsCollector {\n  const store = new Map<string, number[]>()\n\n  return {\n    recordSpan(data: SpanRecord): void {\n      let arr = store.get(data.name)\n      if (!arr) {\n        arr = []\n        store.set(data.name, arr)\n      }\n      arr.push(data.durationMs)\n      // Bound memory: keep last N entries per namespace\n      if (arr.length > maxEntries) arr.shift()\n    },\n\n    stats(name: string): SpanStats | undefined {\n      const arr = store.get(name)\n      if (!arr || arr.length === 0) return undefined\n      return computeStats(arr)\n    },\n\n    all(): Map<string, SpanStats> {\n      const result = new Map<string, SpanStats>()\n      for (const [name, durations] of store) {\n        if (durations.length > 0) result.set(name, computeStats(durations))\n      }\n      return result\n    },\n\n    summary(): string {\n      const entries = [...this.all().entries()]\n      if (entries.length === 0) return \"(no span data)\"\n      const lines = entries.map(\n        ([name, s]) =>\n          `${name}: ${s.count} spans, mean=${s.mean.toFixed(1)}ms, p50=${s.p50.toFixed(1)}ms, p95=${s.p95.toFixed(1)}ms, p99=${s.p99.toFixed(1)}ms`,\n      )\n      return lines.join(\"\\n\")\n    },\n\n    reset(): void {\n      store.clear()\n    },\n  }\n}\n\n// ============ Ambient Collector ============\n\nconst _ambient = createMetricsCollector()\n\n// Auto-activate ambient recording.\n// Always set — the cost is one ?.recordSpan() call per span (negligible).\n// The TRACE gate already controls whether spans are *created* at all.\n_setAmbientRecorder(_ambient)\n\n/** Get aggregated span stats (from ambient collector). */\nexport function spanStats(): Map<string, SpanStats> {\n  return _ambient.all()\n}\n\n/** Get the ambient collector's formatted summary. */\nexport function spanSummary(): string {\n  return _ambient.summary()\n}\n\n/** Reset the ambient collector. */\nexport function resetSpanStats(): void {\n  _ambient.reset()\n}\n\n// ============ withMetrics ============\n\n/**\n * Compose a logger with a metrics collector.\n * Returns a curried wrapper: `withMetrics(collector?)(logger)`\n *\n * - No arg: uses the built-in ambient collector\n * - Custom collector: records to your collector\n * - Stackable: `withMetrics(a)(withMetrics(b)(logger))` fans out to both\n *\n * @example\n * ```typescript\n * const log = withMetrics()(createLogger(\"myapp\"))\n * const log = withMetrics(myCollector)(createLogger(\"myapp\"))\n * ```\n */\nexport function withMetrics(collector?: SpanRecorder): (logger: ConditionalLogger) => ConditionalLogger {\n  const recorder = collector ?? _ambient\n\n  return (logger: ConditionalLogger): ConditionalLogger => {\n    // Wrap the logger's span method to intercept disposal\n    return new Proxy(logger, {\n      get(target, prop: string | symbol) {\n        if (prop === \"span\") {\n          const originalSpan = target.span\n          if (!originalSpan) return undefined // TRACE off — preserve ?.  behavior\n          return (namespace?: string, props?: LazyProps): SpanLogger => {\n            const span = originalSpan.call(target, namespace, props)\n            // Wrap disposal to record to our collector\n            const originalDispose = (span as unknown as { [Symbol.dispose]: () => void })[Symbol.dispose]\n            ;(span as unknown as { [Symbol.dispose]: () => void })[Symbol.dispose] = () => {\n              originalDispose.call(span)\n              // After original disposal computed duration, record it\n              if (span.spanData?.duration != null) {\n                recorder.recordSpan({ name: span.name, durationMs: span.spanData.duration })\n              }\n            }\n            return span\n          }\n        }\n        if (prop === \"logger\") {\n          // Child loggers inherit the metrics wrapper\n          return (namespace?: string, childProps?: Record<string, unknown>): Logger => {\n            const child = target.logger(namespace, childProps)\n            // Re-wrap the child — withMetrics(recorder) applied recursively\n            return withMetrics(recorder)(child as unknown as ConditionalLogger) as unknown as Logger\n          }\n        }\n        return (target as unknown as Record<string | symbol, unknown>)[prop]\n      },\n    })\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AA6CA,SAAS,WAAW,QAAkB,GAAmB;AACvD,KAAI,OAAO,WAAW,EAAG,QAAO;AAEhC,QAAO,OADK,KAAK,IAAI,KAAK,MAAM,OAAO,SAAS,EAAE,EAAE,OAAO,SAAS,EAAE;;AAIxE,SAAS,aAAa,WAAgC;CACpD,MAAM,SAAS,CAAC,GAAG,UAAU,CAAC,MAAM,GAAG,MAAM,IAAI,EAAE;CACnD,MAAM,QAAQ,OAAO,QAAQ,KAAK,MAAM,MAAM,GAAG,EAAE;AACnD,QAAO;EACL,OAAO,OAAO;EACd,KAAK,OAAO,MAAM;EAClB,KAAK,OAAO,OAAO,SAAS,MAAM;EAClC,MAAM,OAAO,SAAS,IAAI,QAAQ,OAAO,SAAS;EAClD,KAAK,WAAW,QAAQ,GAAI;EAC5B,KAAK,WAAW,QAAQ,IAAK;EAC7B,KAAK,WAAW,QAAQ,IAAK;EAC7B;EACD;;AAgBH,SAAgB,uBAAuB,aAAa,KAAwB;CAC1E,MAAM,wBAAQ,IAAI,KAAuB;AAEzC,QAAO;EACL,WAAW,MAAwB;GACjC,IAAI,MAAM,MAAM,IAAI,KAAK,KAAK;AAC9B,OAAI,CAAC,KAAK;AACR,UAAM,EAAE;AACR,UAAM,IAAI,KAAK,MAAM,IAAI;;AAE3B,OAAI,KAAK,KAAK,WAAW;AAEzB,OAAI,IAAI,SAAS,WAAY,KAAI,OAAO;;EAG1C,MAAM,MAAqC;GACzC,MAAM,MAAM,MAAM,IAAI,KAAK;AAC3B,OAAI,CAAC,OAAO,IAAI,WAAW,EAAG,QAAO,KAAA;AACrC,UAAO,aAAa,IAAI;;EAG1B,MAA8B;GAC5B,MAAM,yBAAS,IAAI,KAAwB;AAC3C,QAAK,MAAM,CAAC,MAAM,cAAc,MAC9B,KAAI,UAAU,SAAS,EAAG,QAAO,IAAI,MAAM,aAAa,UAAU,CAAC;AAErE,UAAO;;EAGT,UAAkB;GAChB,MAAM,UAAU,CAAC,GAAG,KAAK,KAAK,CAAC,SAAS,CAAC;AACzC,OAAI,QAAQ,WAAW,EAAG,QAAO;AAKjC,UAJc,QAAQ,KACnB,CAAC,MAAM,OACN,GAAG,KAAK,IAAI,EAAE,MAAM,eAAe,EAAE,KAAK,QAAQ,EAAE,CAAC,UAAU,EAAE,IAAI,QAAQ,EAAE,CAAC,UAAU,EAAE,IAAI,QAAQ,EAAE,CAAC,UAAU,EAAE,IAAI,QAAQ,EAAE,CAAC,IACzI,CACY,KAAK,KAAK;;EAGzB,QAAc;AACZ,SAAM,OAAO;;EAEhB;;AAKH,MAAM,WAAW,wBAAwB;AAKzC,oBAAoB,SAAS;;AAG7B,SAAgB,YAAoC;AAClD,QAAO,SAAS,KAAK;;;AAIvB,SAAgB,cAAsB;AACpC,QAAO,SAAS,SAAS;;;AAI3B,SAAgB,iBAAuB;AACrC,UAAS,OAAO;;;;;;;;;;;;;;;;AAmBlB,SAAgB,YAAY,WAA4E;CACtG,MAAM,WAAW,aAAa;AAE9B,SAAQ,WAAiD;AAEvD,SAAO,IAAI,MAAM,QAAQ,EACvB,IAAI,QAAQ,MAAuB;AACjC,OAAI,SAAS,QAAQ;IACnB,MAAM,eAAe,OAAO;AAC5B,QAAI,CAAC,aAAc,QAAO,KAAA;AAC1B,YAAQ,WAAoB,UAAkC;KAC5D,MAAM,OAAO,aAAa,KAAK,QAAQ,WAAW,MAAM;KAExD,MAAM,kBAAmB,KAAqD,OAAO;AACnF,UAAqD,OAAO,iBAAiB;AAC7E,sBAAgB,KAAK,KAAK;AAE1B,UAAI,KAAK,UAAU,YAAY,KAC7B,UAAS,WAAW;OAAE,MAAM,KAAK;OAAM,YAAY,KAAK,SAAS;OAAU,CAAC;;AAGhF,YAAO;;;AAGX,OAAI,SAAS,SAEX,SAAQ,WAAoB,eAAiD;IAC3E,MAAM,QAAQ,OAAO,OAAO,WAAW,WAAW;AAElD,WAAO,YAAY,SAAS,CAAC,MAAsC;;AAGvE,UAAQ,OAAuD;KAElE,CAAC"}
+{"version":3,"file":"metrics.mjs","names":[],"sources":["../src/metrics.ts"],"sourcesContent":["/**\n * Metrics collection for loggily spans.\n *\n * Explicit only: `withMetrics(collector)(logger)` for custom collection.\n *\n * @example\n * ```typescript\n * import { withMetrics, createMetricsCollector } from \"loggily/metrics\"\n * const collector = createMetricsCollector()\n * const log = withMetrics(collector)(createLogger(\"myapp\"))\n * ```\n */\n\nimport {\n  type SpanRecorder,\n  type SpanRecord,\n  type ConditionalLogger,\n  type Logger,\n  type LazyProps,\n  type SpanLogger,\n} from \"./core.js\"\n\nexport type { SpanRecorder, SpanRecord }\n\n// ============ Stats ============\n\nexport interface SpanStats {\n  count: number\n  min: number\n  max: number\n  mean: number\n  p50: number\n  p95: number\n  p99: number\n  total: number\n}\n\nfunction percentile(sorted: number[], p: number): number {\n  if (sorted.length === 0) return 0\n  const idx = Math.min(Math.floor(sorted.length * p), sorted.length - 1)\n  return sorted[idx]!\n}\n\nfunction computeStats(durations: number[]): SpanStats {\n  const sorted = [...durations].sort((a, b) => a - b)\n  const total = sorted.reduce((sum, d) => sum + d, 0)\n  return {\n    count: sorted.length,\n    min: sorted[0] ?? 0,\n    max: sorted[sorted.length - 1] ?? 0,\n    mean: sorted.length > 0 ? total / sorted.length : 0,\n    p50: percentile(sorted, 0.5),\n    p95: percentile(sorted, 0.95),\n    p99: percentile(sorted, 0.99),\n    total,\n  }\n}\n\n// ============ Collector ============\n\nexport interface MetricsCollector extends SpanRecorder {\n  /** Get stats for a specific span namespace */\n  stats(name: string): SpanStats | undefined\n  /** Get stats for all recorded namespaces */\n  all(): Map<string, SpanStats>\n  /** Format a human-readable summary */\n  summary(): string\n  /** Reset all collected data */\n  reset(): void\n}\n\nexport function createMetricsCollector(maxEntries = 1000): MetricsCollector {\n  const store = new Map<string, number[]>()\n\n  return {\n    recordSpan(data: SpanRecord): void {\n      let arr = store.get(data.name)\n      if (!arr) {\n        arr = []\n        store.set(data.name, arr)\n      }\n      arr.push(data.durationMs)\n      // Bound memory: keep last N entries per namespace\n      if (arr.length > maxEntries) arr.shift()\n    },\n\n    stats(name: string): SpanStats | undefined {\n      const arr = store.get(name)\n      if (!arr || arr.length === 0) return undefined\n      return computeStats(arr)\n    },\n\n    all(): Map<string, SpanStats> {\n      const result = new Map<string, SpanStats>()\n      for (const [name, durations] of store) {\n        if (durations.length > 0) result.set(name, computeStats(durations))\n      }\n      return result\n    },\n\n    summary(): string {\n      const entries = [...this.all().entries()]\n      if (entries.length === 0) return \"(no span data)\"\n      const lines = entries.map(\n        ([name, s]) =>\n          `${name}: ${s.count} spans, mean=${s.mean.toFixed(1)}ms, p50=${s.p50.toFixed(1)}ms, p95=${s.p95.toFixed(1)}ms, p99=${s.p99.toFixed(1)}ms`,\n      )\n      return lines.join(\"\\n\")\n    },\n\n    reset(): void {\n      store.clear()\n    },\n  }\n}\n\n// ============ withMetrics ============\n\n/**\n * Compose a logger with a metrics collector.\n * Returns a curried wrapper: `withMetrics(collector)(logger)`\n *\n * Records span duration to the provided collector on span disposal.\n * Stackable: `withMetrics(a)(withMetrics(b)(logger))` fans out to both.\n *\n * @example\n * ```typescript\n * const collector = createMetricsCollector()\n * const log = withMetrics(collector)(createLogger(\"myapp\"))\n * ```\n */\nexport function withMetrics(\n  collector: SpanRecorder,\n): (logger: ConditionalLogger) => ConditionalLogger {\n  return (logger: ConditionalLogger): ConditionalLogger => {\n    // Wrap the logger's span method to intercept disposal\n    return new Proxy(logger, {\n      get(target, prop: string | symbol) {\n        if (prop === \"metrics\") {\n          return collector\n        }\n        if (prop === \"span\") {\n          const originalSpan = target.span\n          if (!originalSpan) return undefined // TRACE off — preserve ?.  behavior\n          return (namespace?: string, props?: LazyProps): SpanLogger => {\n            const span = originalSpan.call(target, namespace, props)\n            // Wrap disposal to record to our collector\n            const originalDispose = (\n              span as unknown as { [Symbol.dispose]: () => void }\n            )[Symbol.dispose]\n            ;(span as unknown as { [Symbol.dispose]: () => void })[\n              Symbol.dispose\n            ] = () => {\n              originalDispose.call(span)\n              // After original disposal computed duration, record it\n              if (span.spanData?.duration != null) {\n                collector.recordSpan({\n                  name: span.name,\n                  durationMs: span.spanData.duration,\n                })\n              }\n            }\n            return span\n          }\n        }\n        if (prop === \"child\") {\n          return (\n            namespaceOrContext?: string | Record<string, unknown>,\n            childProps?: Record<string, unknown>,\n          ): ConditionalLogger => {\n            const child = target.child(namespaceOrContext as string, childProps)\n            return withMetrics(collector)(child)\n          }\n        }\n        if (prop === \"logger\") {\n          // Child loggers inherit the metrics wrapper\n          return (\n            namespace?: string,\n            childProps?: Record<string, unknown>,\n          ): Logger => {\n            const child = target.logger(namespace, childProps)\n            // Re-wrap the child — withMetrics(collector) applied recursively\n            return withMetrics(collector)(\n              child as unknown as ConditionalLogger,\n            ) as unknown as Logger\n          }\n        }\n        return (target as unknown as Record<string | symbol, unknown>)[prop]\n      },\n    })\n  }\n}\n"],"mappings":";AAqCA,SAAS,WAAW,QAAkB,GAAmB;AACvD,KAAI,OAAO,WAAW,EAAG,QAAO;AAEhC,QAAO,OADK,KAAK,IAAI,KAAK,MAAM,OAAO,SAAS,EAAE,EAAE,OAAO,SAAS,EAAE;;AAIxE,SAAS,aAAa,WAAgC;CACpD,MAAM,SAAS,CAAC,GAAG,UAAU,CAAC,MAAM,GAAG,MAAM,IAAI,EAAE;CACnD,MAAM,QAAQ,OAAO,QAAQ,KAAK,MAAM,MAAM,GAAG,EAAE;AACnD,QAAO;EACL,OAAO,OAAO;EACd,KAAK,OAAO,MAAM;EAClB,KAAK,OAAO,OAAO,SAAS,MAAM;EAClC,MAAM,OAAO,SAAS,IAAI,QAAQ,OAAO,SAAS;EAClD,KAAK,WAAW,QAAQ,GAAI;EAC5B,KAAK,WAAW,QAAQ,IAAK;EAC7B,KAAK,WAAW,QAAQ,IAAK;EAC7B;EACD;;AAgBH,SAAgB,uBAAuB,aAAa,KAAwB;CAC1E,MAAM,wBAAQ,IAAI,KAAuB;AAEzC,QAAO;EACL,WAAW,MAAwB;GACjC,IAAI,MAAM,MAAM,IAAI,KAAK,KAAK;AAC9B,OAAI,CAAC,KAAK;AACR,UAAM,EAAE;AACR,UAAM,IAAI,KAAK,MAAM,IAAI;;AAE3B,OAAI,KAAK,KAAK,WAAW;AAEzB,OAAI,IAAI,SAAS,WAAY,KAAI,OAAO;;EAG1C,MAAM,MAAqC;GACzC,MAAM,MAAM,MAAM,IAAI,KAAK;AAC3B,OAAI,CAAC,OAAO,IAAI,WAAW,EAAG,QAAO,KAAA;AACrC,UAAO,aAAa,IAAI;;EAG1B,MAA8B;GAC5B,MAAM,yBAAS,IAAI,KAAwB;AAC3C,QAAK,MAAM,CAAC,MAAM,cAAc,MAC9B,KAAI,UAAU,SAAS,EAAG,QAAO,IAAI,MAAM,aAAa,UAAU,CAAC;AAErE,UAAO;;EAGT,UAAkB;GAChB,MAAM,UAAU,CAAC,GAAG,KAAK,KAAK,CAAC,SAAS,CAAC;AACzC,OAAI,QAAQ,WAAW,EAAG,QAAO;AAKjC,UAJc,QAAQ,KACnB,CAAC,MAAM,OACN,GAAG,KAAK,IAAI,EAAE,MAAM,eAAe,EAAE,KAAK,QAAQ,EAAE,CAAC,UAAU,EAAE,IAAI,QAAQ,EAAE,CAAC,UAAU,EAAE,IAAI,QAAQ,EAAE,CAAC,UAAU,EAAE,IAAI,QAAQ,EAAE,CAAC,IACzI,CACY,KAAK,KAAK;;EAGzB,QAAc;AACZ,SAAM,OAAO;;EAEhB;;;;;;;;;;;;;;;AAkBH,SAAgB,YACd,WACkD;AAClD,SAAQ,WAAiD;AAEvD,SAAO,IAAI,MAAM,QAAQ,EACvB,IAAI,QAAQ,MAAuB;AACjC,OAAI,SAAS,UACX,QAAO;AAET,OAAI,SAAS,QAAQ;IACnB,MAAM,eAAe,OAAO;AAC5B,QAAI,CAAC,aAAc,QAAO,KAAA;AAC1B,YAAQ,WAAoB,UAAkC;KAC5D,MAAM,OAAO,aAAa,KAAK,QAAQ,WAAW,MAAM;KAExD,MAAM,kBACJ,KACA,OAAO;AACP,UACA,OAAO,iBACC;AACR,sBAAgB,KAAK,KAAK;AAE1B,UAAI,KAAK,UAAU,YAAY,KAC7B,WAAU,WAAW;OACnB,MAAM,KAAK;OACX,YAAY,KAAK,SAAS;OAC3B,CAAC;;AAGN,YAAO;;;AAGX,OAAI,SAAS,QACX,SACE,oBACA,eACsB;IACtB,MAAM,QAAQ,OAAO,MAAM,oBAA8B,WAAW;AACpE,WAAO,YAAY,UAAU,CAAC,MAAM;;AAGxC,OAAI,SAAS,SAEX,SACE,WACA,eACW;IACX,MAAM,QAAQ,OAAO,OAAO,WAAW,WAAW;AAElD,WAAO,YAAY,UAAU,CAC3B,MACD;;AAGL,UAAQ,OAAuD;KAElE,CAAC"}

package/dist/otel.d.mts

@@ -0,0 +1,63 @@
+import { f as Stage } from "./pipeline-D0omS7eF.mjs";
+
+//#region src/otel.d.ts
+interface OtelApi {
+  logs?: {
+    getLoggerProvider(): {
+      getLogger(name: string): {
+        emit(record: {
+          severityNumber: number;
+          severityText: string;
+          body: string;
+          attributes: Record<string, unknown>;
+          timestamp: number[];
+        }): void;
+      };
+    };
+  };
+  trace?: {
+    getTracerProvider(): {
+      getTracer(name: string): {
+        startSpan(name: string, options?: {
+          startTime: number[];
+          attributes: Record<string, unknown>;
+        }): {
+          end(endTime?: number[]): void;
+          setAttribute(key: string, value: unknown): void;
+          setStatus(status: {
+            code: number;
+            message?: string;
+          }): void;
+        };
+      };
+    };
+  };
+}
+interface OtelBridgeOptions {
+  /** The @opentelemetry/api module. Pass the import to avoid require() in ESM. */
+  api?: OtelApi;
+  /** Logger name for OTLP LogRecords (default: "loggily") */
+  loggerName?: string;
+  /** Tracer name for OTLP Spans (default: "loggily") */
+  tracerName?: string;
+  /** Whether to forward log events (default: true) */
+  logs?: boolean;
+  /** Whether to forward span events (default: true) */
+  spans?: boolean;
+}
+/**
+ * Create a Stage that forwards loggily events to OpenTelemetry.
+ *
+ * Pass the @opentelemetry/api module via options.api:
+ *
+ * ```ts
+ * import * as otelApi from "@opentelemetry/api"
+ * const log = createLogger("myapp", [toOtel({ api: otelApi }), console])
+ * ```
+ *
+ * Events pass through unchanged (the stage is transparent).
+ */
+declare function toOtel(options?: OtelBridgeOptions): Stage;
+//#endregion
+export { OtelBridgeOptions, toOtel };
+//# sourceMappingURL=otel.d.mts.map

package/dist/otel.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel.d.mts","names":[],"sources":["../src/otel.ts"],"mappings":";;;UAeU,OAAA;EACR,IAAA;IACE,iBAAA;MACE,SAAA,CAAU,IAAA;QACR,IAAA,CAAK,MAAA;UACH,cAAA;UACA,YAAA;UACA,IAAA;UACA,UAAA,EAAY,MAAA;UACZ,SAAA;QAAA;MAAA;IAAA;EAAA;EAKR,KAAA;IACE,iBAAA;MACE,SAAA,CAAU,IAAA;QACR,SAAA,CACE,IAAA,UACA,OAAA;UACE,SAAA;UACA,UAAA,EAAY,MAAA;QAAA;UAGd,GAAA,CAAI,OAAA;UACJ,YAAA,CAAa,GAAA,UAAa,KAAA;UAC1B,SAAA,CAAU,MAAA;YAAU,IAAA;YAAc,OAAA;UAAA;QAAA;MAAA;IAAA;EAAA;AAAA;AAAA,UAqB3B,iBAAA;EAET;EAAN,GAAA,GAAM,OAAA;EAIN;EAFA,UAAA;EAMA;EAJA,UAAA;EAIK;EAFL,IAAA;EAiBoB;EAfpB,KAAA;AAAA;;;;;;;;;;;;;iBAec,MAAA,CAAO,OAAA,GAAS,iBAAA,GAAyB,KAAA"}

package/dist/otel.mjs

@@ -0,0 +1,82 @@
+//#region src/otel.ts
+const SEVERITY_MAP = {
+	trace: {
+		number: 1,
+		text: "TRACE"
+	},
+	debug: {
+		number: 5,
+		text: "DEBUG"
+	},
+	info: {
+		number: 9,
+		text: "INFO"
+	},
+	warn: {
+		number: 13,
+		text: "WARN"
+	},
+	error: {
+		number: 17,
+		text: "ERROR"
+	}
+};
+function msToHrTime(ms) {
+	return [Math.floor(ms / 1e3), ms % 1e3 * 1e6];
+}
+/**
+* Create a Stage that forwards loggily events to OpenTelemetry.
+*
+* Pass the @opentelemetry/api module via options.api:
+*
+* ```ts
+* import * as otelApi from "@opentelemetry/api"
+* const log = createLogger("myapp", [toOtel({ api: otelApi }), console])
+* ```
+*
+* Events pass through unchanged (the stage is transparent).
+*/
+function toOtel(options = {}) {
+	const { api: otelApi = null, loggerName = "loggily", tracerName = "loggily", logs: forwardLogs = true, spans: forwardSpans = true } = options;
+	function forwardLog(event) {
+		const logsApi = otelApi?.logs;
+		if (!logsApi) return;
+		const severity = SEVERITY_MAP[event.level] ?? SEVERITY_MAP.info;
+		logsApi.getLoggerProvider().getLogger(loggerName).emit({
+			severityNumber: severity.number,
+			severityText: severity.text,
+			body: event.message,
+			attributes: {
+				"loggily.namespace": event.namespace,
+				...event.props
+			},
+			timestamp: msToHrTime(event.time)
+		});
+	}
+	function forwardSpan(event) {
+		const traceApi = otelApi?.trace;
+		if (!traceApi) return;
+		const tracer = traceApi.getTracerProvider().getTracer(tracerName);
+		const startTime = msToHrTime(event.time - event.duration);
+		const span = tracer.startSpan(event.name, {
+			startTime,
+			attributes: {
+				"loggily.namespace": event.namespace,
+				"loggily.span_id": event.spanId,
+				"loggily.trace_id": event.traceId,
+				...event.props
+			}
+		});
+		if (event.parentId) span.setAttribute("loggily.parent_id", event.parentId);
+		span.end(msToHrTime(event.time));
+	}
+	return (event) => {
+		if (forwardLogs && event.kind === "log") forwardLog(event);
+		if (forwardSpans && event.kind === "span") forwardSpan(event);
+		return event;
+	};
+}
+//#endregion
+export { toOtel };
+
+//# sourceMappingURL=otel.mjs.map

package/dist/otel.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel.mjs","names":[],"sources":["../src/otel.ts"],"sourcesContent":["/**\n * loggily/otel — OpenTelemetry bridge\n *\n * Maps loggily LogEvent/SpanEvent to OpenTelemetry SDK calls.\n * Requires @opentelemetry/api as a peer dependency.\n *\n * Usage:\n *   import * as otelApi from \"@opentelemetry/api\"\n *   import { toOtel } from \"loggily/otel\"\n *   const log = createLogger(\"myapp\", [toOtel({ api: otelApi }), console])\n */\n\nimport type { Event, LogEvent, SpanEvent, Stage } from \"./pipeline.js\"\n\n// OpenTelemetry API types (peer dep — imported at runtime)\ninterface OtelApi {\n  logs?: {\n    getLoggerProvider(): {\n      getLogger(name: string): {\n        emit(record: {\n          severityNumber: number\n          severityText: string\n          body: string\n          attributes: Record<string, unknown>\n          timestamp: number[]\n        }): void\n      }\n    }\n  }\n  trace?: {\n    getTracerProvider(): {\n      getTracer(name: string): {\n        startSpan(\n          name: string,\n          options?: {\n            startTime: number[]\n            attributes: Record<string, unknown>\n          },\n        ): {\n          end(endTime?: number[]): void\n          setAttribute(key: string, value: unknown): void\n          setStatus(status: { code: number; message?: string }): void\n        }\n      }\n    }\n  }\n}\n\nconst SEVERITY_MAP: Record<string, { number: number; text: string }> = {\n  trace: { number: 1, text: \"TRACE\" },\n  debug: { number: 5, text: \"DEBUG\" },\n  info: { number: 9, text: \"INFO\" },\n  warn: { number: 13, text: \"WARN\" },\n  error: { number: 17, text: \"ERROR\" },\n}\n\nfunction msToHrTime(ms: number): [number, number] {\n  const seconds = Math.floor(ms / 1000)\n  const nanos = (ms % 1000) * 1_000_000\n  return [seconds, nanos]\n}\n\nexport interface OtelBridgeOptions {\n  /** The @opentelemetry/api module. Pass the import to avoid require() in ESM. */\n  api?: OtelApi\n  /** Logger name for OTLP LogRecords (default: \"loggily\") */\n  loggerName?: string\n  /** Tracer name for OTLP Spans (default: \"loggily\") */\n  tracerName?: string\n  /** Whether to forward log events (default: true) */\n  logs?: boolean\n  /** Whether to forward span events (default: true) */\n  spans?: boolean\n}\n\n/**\n * Create a Stage that forwards loggily events to OpenTelemetry.\n *\n * Pass the @opentelemetry/api module via options.api:\n *\n * ```ts\n * import * as otelApi from \"@opentelemetry/api\"\n * const log = createLogger(\"myapp\", [toOtel({ api: otelApi }), console])\n * ```\n *\n * Events pass through unchanged (the stage is transparent).\n */\nexport function toOtel(options: OtelBridgeOptions = {}): Stage {\n  const {\n    api: otelApi = null,\n    loggerName = \"loggily\",\n    tracerName = \"loggily\",\n    logs: forwardLogs = true,\n    spans: forwardSpans = true,\n  } = options\n\n  function forwardLog(event: LogEvent): void {\n    const logsApi = otelApi?.logs\n    if (!logsApi) return\n\n    const severity = SEVERITY_MAP[event.level] ?? SEVERITY_MAP.info!\n    const logger = logsApi.getLoggerProvider().getLogger(loggerName)\n    logger.emit({\n      severityNumber: severity.number,\n      severityText: severity.text,\n      body: event.message,\n      attributes: {\n        \"loggily.namespace\": event.namespace,\n        ...event.props,\n      },\n      timestamp: msToHrTime(event.time),\n    })\n  }\n\n  function forwardSpan(event: SpanEvent): void {\n    const traceApi = otelApi?.trace\n    if (!traceApi) return\n\n    const tracer = traceApi.getTracerProvider().getTracer(tracerName)\n    const startTime = msToHrTime(event.time - event.duration)\n    const span = tracer.startSpan(event.name, {\n      startTime,\n      attributes: {\n        \"loggily.namespace\": event.namespace,\n        \"loggily.span_id\": event.spanId,\n        \"loggily.trace_id\": event.traceId,\n        ...event.props,\n      },\n    })\n    if (event.parentId) {\n      span.setAttribute(\"loggily.parent_id\", event.parentId)\n    }\n    span.end(msToHrTime(event.time))\n  }\n\n  return (event: Event): Event => {\n    if (forwardLogs && event.kind === \"log\") forwardLog(event)\n    if (forwardSpans && event.kind === \"span\") forwardSpan(event)\n    return event // transparent — pass through\n  }\n}\n"],"mappings":";AAgDA,MAAM,eAAiE;CACrE,OAAO;EAAE,QAAQ;EAAG,MAAM;EAAS;CACnC,OAAO;EAAE,QAAQ;EAAG,MAAM;EAAS;CACnC,MAAM;EAAE,QAAQ;EAAG,MAAM;EAAQ;CACjC,MAAM;EAAE,QAAQ;EAAI,MAAM;EAAQ;CAClC,OAAO;EAAE,QAAQ;EAAI,MAAM;EAAS;CACrC;AAED,SAAS,WAAW,IAA8B;AAGhD,QAAO,CAFS,KAAK,MAAM,KAAK,IAAK,EACtB,KAAK,MAAQ,IACL;;;;;;;;;;;;;;AA4BzB,SAAgB,OAAO,UAA6B,EAAE,EAAS;CAC7D,MAAM,EACJ,KAAK,UAAU,MACf,aAAa,WACb,aAAa,WACb,MAAM,cAAc,MACpB,OAAO,eAAe,SACpB;CAEJ,SAAS,WAAW,OAAuB;EACzC,MAAM,UAAU,SAAS;AACzB,MAAI,CAAC,QAAS;EAEd,MAAM,WAAW,aAAa,MAAM,UAAU,aAAa;AAC5C,UAAQ,mBAAmB,CAAC,UAAU,WAAW,CACzD,KAAK;GACV,gBAAgB,SAAS;GACzB,cAAc,SAAS;GACvB,MAAM,MAAM;GACZ,YAAY;IACV,qBAAqB,MAAM;IAC3B,GAAG,MAAM;IACV;GACD,WAAW,WAAW,MAAM,KAAK;GAClC,CAAC;;CAGJ,SAAS,YAAY,OAAwB;EAC3C,MAAM,WAAW,SAAS;AAC1B,MAAI,CAAC,SAAU;EAEf,MAAM,SAAS,SAAS,mBAAmB,CAAC,UAAU,WAAW;EACjE,MAAM,YAAY,WAAW,MAAM,OAAO,MAAM,SAAS;EACzD,MAAM,OAAO,OAAO,UAAU,MAAM,MAAM;GACxC;GACA,YAAY;IACV,qBAAqB,MAAM;IAC3B,mBAAmB,MAAM;IACzB,oBAAoB,MAAM;IAC1B,GAAG,MAAM;IACV;GACF,CAAC;AACF,MAAI,MAAM,SACR,MAAK,aAAa,qBAAqB,MAAM,SAAS;AAExD,OAAK,IAAI,WAAW,MAAM,KAAK,CAAC;;AAGlC,SAAQ,UAAwB;AAC9B,MAAI,eAAe,MAAM,SAAS,MAAO,YAAW,MAAM;AAC1D,MAAI,gBAAgB,MAAM,SAAS,OAAQ,aAAY,MAAM;AAC7D,SAAO"}