loggily 0.6.0 → 0.6.2

package/dist/file-writer-BuQGFGRs.d.mts

@@ -1,46 +0,0 @@
-//#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
-export { FileWriterOptions as n, createFileWriter as r, FileWriter as t };
-//# sourceMappingURL=file-writer-BuQGFGRs.d.mts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"file-writer-BuQGFGRs.d.mts","names":[],"sources":["../src/file-writer.ts"],"mappings":";;AAUA;;;;;AAQA;AAAA,UARiB,iBAAA;;EAEf,UAAA;EAQA;EANA,aAAA;AAAA;;UAIe,UAAA;EAMV;EAJL,KAAA,CAAM,IAAA;EA0BwB;EAxB9B,KAAA;EAwB6F;EAtB7F,KAAA;AAAA;;;;;;;;;;;;;;;;;;;;iBAsBc,gBAAA,CAAiB,QAAA,UAAkB,OAAA,GAAS,iBAAA,GAAyB,UAAA"}

package/dist/file-writer.d.mts

@@ -1,2 +0,0 @@
-import { n as FileWriterOptions, r as createFileWriter, t as FileWriter } from "./file-writer-BuQGFGRs.mjs";
-export { FileWriter, FileWriterOptions, createFileWriter };

package/dist/file-writer.mjs

@@ -1,75 +0,0 @@
-import { closeSync, openSync, writeSync } from "node:fs";
-//#region src/file-writer.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.
-*/
-/**
-* 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()
-*/
-function createFileWriter(filePath, options = {}) {
-	const bufferSize = options.bufferSize ?? 4096;
-	const flushInterval = options.flushInterval ?? 100;
-	let buffer = "";
-	let fd = null;
-	let timer = null;
-	let closed = false;
-	fd = openSync(filePath, "a");
-	/** Flush buffer contents to disk synchronously */
-	function flush() {
-		if (buffer.length === 0 || fd === null) return;
-		writeSync(fd, buffer);
-		buffer = "";
-	}
-	timer = setInterval(flush, flushInterval);
-	if (timer && typeof timer === "object" && "unref" in timer) timer.unref();
-	const exitHandler = () => flush();
-	process.on("exit", exitHandler);
-	return {
-		write(line) {
-			if (closed) return;
-			buffer += line + "\n";
-			if (buffer.length >= bufferSize) flush();
-		},
-		flush,
-		close() {
-			if (closed) return;
-			closed = true;
-			if (timer !== null) {
-				clearInterval(timer);
-				timer = null;
-			}
-			try {
-				flush();
-			} catch {} finally {
-				if (fd !== null) {
-					closeSync(fd);
-					fd = null;
-				}
-				process.removeListener("exit", exitHandler);
-			}
-		}
-	};
-}
-//#endregion
-export { createFileWriter };
-
-//# sourceMappingURL=file-writer.mjs.map

package/dist/file-writer.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"file-writer.mjs","names":[],"sources":["../src/file-writer.ts"],"sourcesContent":["/**\n * File writer for loggily — Node.js/Bun only.\n *\n * Separated from core logger to allow tree-shaking in browser bundles.\n * Uses dynamic import(\"node:fs\") to avoid static dependency on Node APIs.\n */\n\nimport { openSync, writeSync, closeSync } from \"node:fs\"\n\n/** Options for creating an async buffered file writer */\nexport interface FileWriterOptions {\n  /** Buffer size threshold in bytes before flushing (default: 4096) */\n  bufferSize?: number\n  /** Flush interval in milliseconds (default: 100) */\n  flushInterval?: number\n}\n\n/** An async buffered file writer with automatic flushing */\nexport interface FileWriter {\n  /** Write a line to the buffer (appends newline) */\n  write(line: string): void\n  /** Flush the buffer immediately */\n  flush(): void\n  /** Close the writer and flush remaining buffer */\n  close(): void\n}\n\n/**\n * Create an async buffered file writer for log output.\n * Buffers writes and flushes on size threshold or interval.\n * Registers a process.on('exit') handler to flush remaining buffer.\n *\n * **Node.js/Bun only** — not available in browser environments.\n *\n * @param filePath - Path to the log file (opened in append mode)\n * @param options - Buffer size and flush interval configuration\n * @returns FileWriter with write, flush, and close methods\n *\n * @example\n * const writer = createFileWriter('/tmp/app.log')\n * const unsubscribe = addWriter((formatted) => writer.write(formatted))\n *\n * // On shutdown:\n * unsubscribe()\n * writer.close()\n */\nexport function createFileWriter(filePath: string, options: FileWriterOptions = {}): FileWriter {\n  const bufferSize = options.bufferSize ?? 4096\n  const flushInterval = options.flushInterval ?? 100\n\n  let buffer = \"\"\n  let fd: number | null = null\n  let timer: ReturnType<typeof setInterval> | null = null\n  let closed = false\n\n  // Open file in append mode\n  fd = openSync(filePath, \"a\")\n\n  /** Flush buffer contents to disk synchronously */\n  function flush(): void {\n    if (buffer.length === 0 || fd === null) return\n    const data = buffer\n    writeSync(fd, data)\n    buffer = \"\"\n  }\n\n  // Set up periodic flush\n  timer = setInterval(flush, flushInterval)\n  // Don't let the timer keep the process alive\n  if (timer && typeof timer === \"object\" && \"unref\" in timer) {\n    ;(timer as { unref(): void }).unref()\n  }\n\n  // Flush on process exit to avoid data loss\n  const exitHandler = (): void => flush()\n  process.on(\"exit\", exitHandler)\n\n  return {\n    write(line: string): void {\n      if (closed) return\n      buffer += line + \"\\n\"\n      if (buffer.length >= bufferSize) {\n        flush()\n      }\n    },\n\n    flush,\n\n    close(): void {\n      if (closed) return\n      closed = true\n      if (timer !== null) {\n        clearInterval(timer)\n        timer = null\n      }\n      try {\n        flush()\n      } catch {\n        // Swallow flush errors during close — data loss is unavoidable\n        // at this point, but we must still release the fd and exit handler.\n      } finally {\n        if (fd !== null) {\n          closeSync(fd)\n          fd = null\n        }\n        process.removeListener(\"exit\", exitHandler)\n      }\n    },\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AA8CA,SAAgB,iBAAiB,UAAkB,UAA6B,EAAE,EAAc;CAC9F,MAAM,aAAa,QAAQ,cAAc;CACzC,MAAM,gBAAgB,QAAQ,iBAAiB;CAE/C,IAAI,SAAS;CACb,IAAI,KAAoB;CACxB,IAAI,QAA+C;CACnD,IAAI,SAAS;AAGb,MAAK,SAAS,UAAU,IAAI;;CAG5B,SAAS,QAAc;AACrB,MAAI,OAAO,WAAW,KAAK,OAAO,KAAM;AAExC,YAAU,IADG,OACM;AACnB,WAAS;;AAIX,SAAQ,YAAY,OAAO,cAAc;AAEzC,KAAI,SAAS,OAAO,UAAU,YAAY,WAAW,MACjD,OAA4B,OAAO;CAIvC,MAAM,oBAA0B,OAAO;AACvC,SAAQ,GAAG,QAAQ,YAAY;AAE/B,QAAO;EACL,MAAM,MAAoB;AACxB,OAAI,OAAQ;AACZ,aAAU,OAAO;AACjB,OAAI,OAAO,UAAU,WACnB,QAAO;;EAIX;EAEA,QAAc;AACZ,OAAI,OAAQ;AACZ,YAAS;AACT,OAAI,UAAU,MAAM;AAClB,kBAAc,MAAM;AACpB,YAAQ;;AAEV,OAAI;AACF,WAAO;WACD,WAGE;AACR,QAAI,OAAO,MAAM;AACf,eAAU,GAAG;AACb,UAAK;;AAEP,YAAQ,eAAe,QAAQ,YAAY;;;EAGhD"}

package/dist/metrics.d.mts

@@ -1,48 +0,0 @@
-import { d as SpanRecord, f as SpanRecorder, t as ConditionalLogger } from "./core-7D7sstHl.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

package/dist/metrics.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"metrics.d.mts","names":[],"sources":["../src/metrics.ts"],"mappings":";;;UAkCiB,SAAA;EACf,KAAA;EACA,GAAA;EACA,GAAA;EACA,IAAA;EACA,GAAA;EACA,GAAA;EACA,GAAA;EACA,KAAA;AAAA;AAAA,UA0Be,gBAAA,SAAyB,YAAA;EAIjC;EAFP,KAAA,CAAM,IAAA,WAAe,SAAA;EAIrB;EAFA,GAAA,IAAO,GAAA,SAAY,SAAA;EAId;EAFL,OAAA;EAKc;EAHd,KAAA;AAAA;AAAA,iBAGc,sBAAA,CAAuB,UAAA,YAAoB,gBAAA;;iBAuD3C,SAAA,CAAA,GAAa,GAAA,SAAY,SAAA;;iBAKzB,WAAA,CAAA;;iBAKA,cAAA,CAAA;AALhB;;;;;AAKA;;;;;AAoBA;;;;AAzBA,iBAyBgB,WAAA,CAAY,SAAA,GAAY,YAAA,IAAgB,MAAA,EAAQ,iBAAA,KAAsB,iBAAA"}

package/dist/metrics.mjs

@@ -1,130 +0,0 @@
-import { r as _setAmbientRecorder } from "./core-BDFU50FQ.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)];
-}
-function computeStats(durations) {
-	const sorted = [...durations].sort((a, b) => a - b);
-	const total = sorted.reduce((sum, d) => sum + d, 0);
-	return {
-		count: sorted.length,
-		min: sorted[0] ?? 0,
-		max: sorted[sorted.length - 1] ?? 0,
-		mean: sorted.length > 0 ? total / sorted.length : 0,
-		p50: percentile(sorted, .5),
-		p95: percentile(sorted, .95),
-		p99: percentile(sorted, .99),
-		total
-	};
-}
-function createMetricsCollector(maxEntries = 1e3) {
-	const store = /* @__PURE__ */ new Map();
-	return {
-		recordSpan(data) {
-			let arr = store.get(data.name);
-			if (!arr) {
-				arr = [];
-				store.set(data.name, arr);
-			}
-			arr.push(data.durationMs);
-			if (arr.length > maxEntries) arr.shift();
-		},
-		stats(name) {
-			const arr = store.get(name);
-			if (!arr || arr.length === 0) return void 0;
-			return computeStats(arr);
-		},
-		all() {
-			const result = /* @__PURE__ */ new Map();
-			for (const [name, durations] of store) if (durations.length > 0) result.set(name, computeStats(durations));
-			return result;
-		},
-		summary() {
-			const entries = [...this.all().entries()];
-			if (entries.length === 0) return "(no span data)";
-			return entries.map(([name, s]) => `${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`).join("\n");
-		},
-		reset() {
-			store.clear();
-		}
-	};
-}
-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)`
-*
-* - 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"))
-* ```
-*/
-function withMetrics(collector) {
-	const recorder = collector ?? _ambient;
-	return (logger) => {
-		return new Proxy(logger, { get(target, prop) {
-			if (prop === "span") {
-				const originalSpan = target.span;
-				if (!originalSpan) return void 0;
-				return (namespace, props) => {
-					const span = originalSpan.call(target, namespace, props);
-					const originalDispose = span[Symbol.dispose];
-					span[Symbol.dispose] = () => {
-						originalDispose.call(span);
-						if (span.spanData?.duration != null) recorder.recordSpan({
-							name: span.name,
-							durationMs: span.spanData.duration
-						});
-					};
-					return span;
-				};
-			}
-			if (prop === "logger") return (namespace, childProps) => {
-				const child = target.logger(namespace, childProps);
-				return withMetrics(recorder)(child);
-			};
-			return target[prop];
-		} });
-	};
-}
-//#endregion
-export { createMetricsCollector, resetSpanStats, spanStats, spanSummary, withMetrics };
-
-//# sourceMappingURL=metrics.mjs.map

package/dist/metrics.mjs.map

@@ -1 +0,0 @@
-{"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":"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"}

package/dist/tracing-2kv3HZ07.d.mts

@@ -1,65 +0,0 @@
-import { l as SpanData } from "./core-7D7sstHl.mjs";
-
-//#region src/tracing.d.ts
-/** Supported ID formats */
-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)
- */
-declare function setIdFormat(format: IdFormat): void;
-/** Get the current ID format */
-declare function getIdFormat(): IdFormat;
-/** Generate a span ID according to the current format */
-declare function generateSpanId(): string;
-/** Generate a trace ID according to the current format */
-declare function generateTraceId(): string;
-/** Reset ID counters (for testing) */
-declare function resetIdCounters(): void;
-/** Options for traceparent header formatting */
-interface TraceparentOptions {
-  /** Whether this span is sampled. Defaults to true for backwards compatibility. */
-  sampled?: boolean;
-}
-/**
- * Format a W3C traceparent header from span data.
- *
- * Format: `{version}-{trace-id}-{span-id}-{trace-flags}`
- * - version: "00" (current W3C spec version)
- * - trace-id: 32 hex chars (128 bits)
- * - span-id: 16 hex chars (64 bits)
- * - trace-flags: "01" (sampled) or "00" (not sampled)
- *
- * Works with both simple and W3C ID formats. Simple IDs are zero-padded to spec length.
- *
- * @param spanData - Span data with id and traceId
- * @param options - Optional settings (sampled flag). Defaults to sampled=true.
- * @returns W3C traceparent header string
- *
- * @example
- * ```typescript
- * const span = log.span("http-request")
- * const header = traceparent(span.spanData)
- * // → "00-a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6-1a2b3c4d5e6f7a8b-01"
- * fetch(url, { headers: { traceparent: header } })
- * ```
- */
-declare function traceparent(spanData: SpanData, options?: TraceparentOptions): string;
-/**
- * Set the head-based sampling rate for new traces.
- * Applied at trace creation — all spans within a sampled trace are kept.
- *
- * @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 */
-declare function getSampleRate(): number;
-/**
- * Determine whether a new trace should be sampled.
- * Called at trace creation time (head-based sampling).
- */
-declare function shouldSample(): boolean;
-//#endregion
-export { getIdFormat as a, setIdFormat as c, traceparent as d, generateTraceId as i, setSampleRate as l, TraceparentOptions as n, getSampleRate as o, generateSpanId as r, resetIdCounters as s, IdFormat as t, shouldSample as u };
-//# sourceMappingURL=tracing-2kv3HZ07.d.mts.map

package/dist/tracing-2kv3HZ07.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tracing-2kv3HZ07.d.mts","names":[],"sources":["../src/tracing.ts"],"mappings":";;;;KAYY,QAAA;;;;;AAcZ;iBALgB,WAAA,CAAY,MAAA,EAAQ,QAAA;;iBAKpB,WAAA,CAAA,GAAe,QAAA;;iBAiBf,cAAA,CAAA;;iBAQA,eAAA,CAAA;;iBAQA,eAAA,CAAA;AARhB;AAAA,UAgBiB,kBAAA;;EAEf,OAAA;AAAA;AAVF;;;;;AAQA;;;;;AA4BA;;;;;;;;;;AAkCA;;;AAtEA,iBAoCgB,WAAA,CAAY,QAAA,EAAU,QAAA,EAAU,OAAA,GAAU,kBAAA;;AA0C1D;;;;;iBARgB,aAAA,CAAc,IAAA;;iBAQd,aAAA,CAAA;;;;;iBAQA,YAAA,CAAA"}

package/dist/tracing.d.mts

@@ -1,2 +0,0 @@
-import { a as getIdFormat, c as setIdFormat, d as traceparent, i as generateTraceId, l as setSampleRate, n as TraceparentOptions, o as getSampleRate, r as generateSpanId, s as resetIdCounters, t as IdFormat, u as shouldSample } from "./tracing-2kv3HZ07.mjs";
-export { IdFormat, TraceparentOptions, generateSpanId, generateTraceId, getIdFormat, getSampleRate, resetIdCounters, setIdFormat, setSampleRate, shouldSample, traceparent };

package/dist/tracing.mjs

@@ -1,96 +0,0 @@
-//#region src/tracing.ts
-let currentIdFormat = "simple";
-/**
-* 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)
-*/
-function setIdFormat(format) {
-	currentIdFormat = format;
-}
-/** Get the current ID format */
-function getIdFormat() {
-	return currentIdFormat;
-}
-let simpleSpanCounter = 0;
-let simpleTraceCounter = 0;
-/** Generate a hex string of the given byte length using crypto.randomUUID */
-function randomHex(bytes) {
-	return crypto.randomUUID().replace(/-/g, "").slice(0, bytes * 2);
-}
-/** Generate a span ID according to the current format */
-function generateSpanId() {
-	if (currentIdFormat === "w3c") return randomHex(8);
-	return `sp_${(++simpleSpanCounter).toString(36)}`;
-}
-/** Generate a trace ID according to the current format */
-function generateTraceId() {
-	if (currentIdFormat === "w3c") return randomHex(16);
-	return `tr_${(++simpleTraceCounter).toString(36)}`;
-}
-/** Reset ID counters (for testing) */
-function resetIdCounters() {
-	simpleSpanCounter = 0;
-	simpleTraceCounter = 0;
-}
-/**
-* Format a W3C traceparent header from span data.
-*
-* Format: `{version}-{trace-id}-{span-id}-{trace-flags}`
-* - version: "00" (current W3C spec version)
-* - trace-id: 32 hex chars (128 bits)
-* - span-id: 16 hex chars (64 bits)
-* - trace-flags: "01" (sampled) or "00" (not sampled)
-*
-* Works with both simple and W3C ID formats. Simple IDs are zero-padded to spec length.
-*
-* @param spanData - Span data with id and traceId
-* @param options - Optional settings (sampled flag). Defaults to sampled=true.
-* @returns W3C traceparent header string
-*
-* @example
-* ```typescript
-* const span = log.span("http-request")
-* const header = traceparent(span.spanData)
-* // → "00-a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6-1a2b3c4d5e6f7a8b-01"
-* fetch(url, { headers: { traceparent: header } })
-* ```
-*/
-function traceparent(spanData, options) {
-	return `00-${padHex(spanData.traceId, 32)}-${padHex(spanData.id, 16)}-${options?.sampled ?? true ? "01" : "00"}`;
-}
-/** Pad or hash an ID to the specified hex length */
-function padHex(id, length) {
-	if (id.length === length && /^[0-9a-f]+$/.test(id)) return id;
-	let hex = "";
-	for (let i = 0; i < id.length; i++) hex += id.charCodeAt(i).toString(16).padStart(2, "0");
-	return hex.padStart(length, "0").slice(-length);
-}
-let sampleRate = 1;
-/**
-* Set the head-based sampling rate for new traces.
-* Applied at trace creation — all spans within a sampled trace are kept.
-*
-* @param rate - Sampling rate from 0.0 (sample nothing) to 1.0 (sample everything, default)
-*/
-function setSampleRate(rate) {
-	if (rate < 0 || rate > 1) throw new Error(`Sample rate must be between 0.0 and 1.0, got ${rate}`);
-	sampleRate = rate;
-}
-/** Get the current sampling rate */
-function getSampleRate() {
-	return sampleRate;
-}
-/**
-* Determine whether a new trace should be sampled.
-* Called at trace creation time (head-based sampling).
-*/
-function shouldSample() {
-	if (sampleRate >= 1) return true;
-	if (sampleRate <= 0) return false;
-	return Math.random() < sampleRate;
-}
-//#endregion
-export { generateSpanId, generateTraceId, getIdFormat, getSampleRate, resetIdCounters, setIdFormat, setSampleRate, shouldSample, traceparent };
-
-//# sourceMappingURL=tracing.mjs.map

package/dist/tracing.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"tracing.mjs","names":[],"sources":["../src/tracing.ts"],"sourcesContent":["/**\n * Distributed tracing utilities for loggily.\n *\n * Provides W3C-compatible trace/span ID generation, traceparent header formatting,\n * and head-based sampling. All features are opt-in and don't break the existing API.\n */\n\nimport type { SpanData } from \"./core.js\"\n\n// ============ ID Format ============\n\n/** Supported ID formats */\nexport type IdFormat = \"simple\" | \"w3c\"\n\nlet currentIdFormat: IdFormat = \"simple\"\n\n/**\n * Set the ID format for new spans and traces.\n * - \"simple\": sp_1, sp_2, tr_1, tr_2 (default, lightweight)\n * - \"w3c\": 32-char hex trace ID, 16-char hex span ID (W3C Trace Context compatible)\n */\nexport function setIdFormat(format: IdFormat): void {\n  currentIdFormat = format\n}\n\n/** Get the current ID format */\nexport function getIdFormat(): IdFormat {\n  return currentIdFormat\n}\n\n// Simple format counters (used by core.ts via the generator functions)\nlet simpleSpanCounter = 0\nlet simpleTraceCounter = 0\n\n/** Generate a hex string of the given byte length using crypto.randomUUID */\nfunction randomHex(bytes: number): string {\n  // crypto.randomUUID() gives us 32 hex chars (128 bits) after removing dashes\n  // For 16 bytes (32 hex chars) we use one UUID, for 8 bytes (16 hex chars) we take a slice\n  const uuid = crypto.randomUUID().replace(/-/g, \"\")\n  return uuid.slice(0, bytes * 2)\n}\n\n/** Generate a span ID according to the current format */\nexport function generateSpanId(): string {\n  if (currentIdFormat === \"w3c\") {\n    return randomHex(8) // 16-char hex\n  }\n  return `sp_${(++simpleSpanCounter).toString(36)}`\n}\n\n/** Generate a trace ID according to the current format */\nexport function generateTraceId(): string {\n  if (currentIdFormat === \"w3c\") {\n    return randomHex(16) // 32-char hex\n  }\n  return `tr_${(++simpleTraceCounter).toString(36)}`\n}\n\n/** Reset ID counters (for testing) */\nexport function resetIdCounters(): void {\n  simpleSpanCounter = 0\n  simpleTraceCounter = 0\n}\n\n// ============ W3C Traceparent ============\n\n/** Options for traceparent header formatting */\nexport interface TraceparentOptions {\n  /** Whether this span is sampled. Defaults to true for backwards compatibility. */\n  sampled?: boolean\n}\n\n/**\n * Format a W3C traceparent header from span data.\n *\n * Format: `{version}-{trace-id}-{span-id}-{trace-flags}`\n * - version: \"00\" (current W3C spec version)\n * - trace-id: 32 hex chars (128 bits)\n * - span-id: 16 hex chars (64 bits)\n * - trace-flags: \"01\" (sampled) or \"00\" (not sampled)\n *\n * Works with both simple and W3C ID formats. Simple IDs are zero-padded to spec length.\n *\n * @param spanData - Span data with id and traceId\n * @param options - Optional settings (sampled flag). Defaults to sampled=true.\n * @returns W3C traceparent header string\n *\n * @example\n * ```typescript\n * const span = log.span(\"http-request\")\n * const header = traceparent(span.spanData)\n * // → \"00-a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6-1a2b3c4d5e6f7a8b-01\"\n * fetch(url, { headers: { traceparent: header } })\n * ```\n */\nexport function traceparent(spanData: SpanData, options?: TraceparentOptions): string {\n  const traceId = padHex(spanData.traceId, 32)\n  const spanId = padHex(spanData.id, 16)\n  const flags = (options?.sampled ?? true) ? \"01\" : \"00\"\n  return `00-${traceId}-${spanId}-${flags}`\n}\n\n/** Pad or hash an ID to the specified hex length */\nfunction padHex(id: string, length: number): string {\n  // If it's already the right length and looks like hex, use as-is\n  if (id.length === length && /^[0-9a-f]+$/.test(id)) {\n    return id\n  }\n\n  // For simple IDs (sp_1, tr_1), create a deterministic hex representation\n  // by encoding the string as hex bytes, zero-padded to the target length\n  let hex = \"\"\n  for (let i = 0; i < id.length; i++) {\n    hex += id.charCodeAt(i).toString(16).padStart(2, \"0\")\n  }\n  // Pad or truncate to target length\n  return hex.padStart(length, \"0\").slice(-length)\n}\n\n// ============ Sampling ============\n\nlet sampleRate = 1.0\n\n/**\n * Set the head-based sampling rate for new traces.\n * Applied at trace creation — all spans within a sampled trace are kept.\n *\n * @param rate - Sampling rate from 0.0 (sample nothing) to 1.0 (sample everything, default)\n */\nexport function setSampleRate(rate: number): void {\n  if (rate < 0 || rate > 1) {\n    throw new Error(`Sample rate must be between 0.0 and 1.0, got ${rate}`)\n  }\n  sampleRate = rate\n}\n\n/** Get the current sampling rate */\nexport function getSampleRate(): number {\n  return sampleRate\n}\n\n/**\n * Determine whether a new trace should be sampled.\n * Called at trace creation time (head-based sampling).\n */\nexport function shouldSample(): boolean {\n  if (sampleRate >= 1.0) return true\n  if (sampleRate <= 0.0) return false\n  return Math.random() < sampleRate\n}\n"],"mappings":";AAcA,IAAI,kBAA4B;;;;;;AAOhC,SAAgB,YAAY,QAAwB;AAClD,mBAAkB;;;AAIpB,SAAgB,cAAwB;AACtC,QAAO;;AAIT,IAAI,oBAAoB;AACxB,IAAI,qBAAqB;;AAGzB,SAAS,UAAU,OAAuB;AAIxC,QADa,OAAO,YAAY,CAAC,QAAQ,MAAM,GAAG,CACtC,MAAM,GAAG,QAAQ,EAAE;;;AAIjC,SAAgB,iBAAyB;AACvC,KAAI,oBAAoB,MACtB,QAAO,UAAU,EAAE;AAErB,QAAO,OAAO,EAAE,mBAAmB,SAAS,GAAG;;;AAIjD,SAAgB,kBAA0B;AACxC,KAAI,oBAAoB,MACtB,QAAO,UAAU,GAAG;AAEtB,QAAO,OAAO,EAAE,oBAAoB,SAAS,GAAG;;;AAIlD,SAAgB,kBAAwB;AACtC,qBAAoB;AACpB,sBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;AAkCvB,SAAgB,YAAY,UAAoB,SAAsC;AAIpF,QAAO,MAHS,OAAO,SAAS,SAAS,GAAG,CAGvB,GAFN,OAAO,SAAS,IAAI,GAAG,CAEP,GADhB,SAAS,WAAW,OAAQ,OAAO;;;AAKpD,SAAS,OAAO,IAAY,QAAwB;AAElD,KAAI,GAAG,WAAW,UAAU,cAAc,KAAK,GAAG,CAChD,QAAO;CAKT,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,GAAG,QAAQ,IAC7B,QAAO,GAAG,WAAW,EAAE,CAAC,SAAS,GAAG,CAAC,SAAS,GAAG,IAAI;AAGvD,QAAO,IAAI,SAAS,QAAQ,IAAI,CAAC,MAAM,CAAC,OAAO;;AAKjD,IAAI,aAAa;;;;;;;AAQjB,SAAgB,cAAc,MAAoB;AAChD,KAAI,OAAO,KAAK,OAAO,EACrB,OAAM,IAAI,MAAM,gDAAgD,OAAO;AAEzE,cAAa;;;AAIf,SAAgB,gBAAwB;AACtC,QAAO;;;;;;AAOT,SAAgB,eAAwB;AACtC,KAAI,cAAc,EAAK,QAAO;AAC9B,KAAI,cAAc,EAAK,QAAO;AAC9B,QAAO,KAAK,QAAQ,GAAG"}