@eventuras/logger 0.8.0 → 0.9.0

package/README.md

@@ -234,16 +234,15 @@ Redacts `authorization`, `cookie`, `set-cookie`, `x-api-key`, `x-auth-token`, an
 
 ## OpenTelemetry Integration
 
-Send logs to any OTel-compatible backend (Sentry, Grafana, Jaeger, etc.) without vendor lock-in.
+Send logs to any OTel-compatible backend (Sentry, Grafana, the Aspire dashboard, etc.) without vendor lock-in. Every line the Pino transport writes — after redaction, from every logger, including ones created before setup — is also emitted as an OpenTelemetry log record.
 
 ### Install OTel Packages
 
 ```bash
-pnpm add @opentelemetry/api @opentelemetry/api-logs @opentelemetry/sdk-logs \
-  @opentelemetry/instrumentation-pino @opentelemetry/exporter-logs-otlp-http
+pnpm add @opentelemetry/sdk-logs @opentelemetry/exporter-logs-otlp-http
 ```
 
-These are optional peer dependencies — the library works fine without them.
+`@opentelemetry/sdk-logs` is an optional peer dependency — the logger uses your app's copy, the same one your processor comes from. Nothing else is needed.
 
 ### Setup
 
@@ -252,16 +251,18 @@ import { setupOpenTelemetryLogger } from "@eventuras/logger/opentelemetry";
 import { OTLPLogExporter } from "@opentelemetry/exporter-logs-otlp-http";
 import { BatchLogRecordProcessor } from "@opentelemetry/sdk-logs";
 
-setupOpenTelemetryLogger({
+await setupOpenTelemetryLogger({
   serviceName: "my-app",
-  logRecordProcessor: new BatchLogRecordProcessor(
-    new OTLPLogExporter({
-      url: process.env.OTEL_EXPORTER_OTLP_LOGS_ENDPOINT,
-    }),
-  ),
+  logRecordProcessor: new BatchLogRecordProcessor({
+    exporter: new OTLPLogExporter(), // reads the OTEL_EXPORTER_OTLP_* variables
+  }),
 });
 ```
 
+Already running the OpenTelemetry Node SDK? Call `setupOpenTelemetryLogger()` without options to emit to the globally registered LoggerProvider, or pass one as `loggerProvider`.
+
+Setup never throws or rejects: if it can't start, it logs an error and logging to stdout carries on.
+
 ### Shutdown
 
 ```typescript

package/dist/Logger-B22dX10w.js

@@ -0,0 +1,338 @@
+import pino from "pino";
+//#region src/sink.ts
+var SINK_KEY = Symbol.for("@eventuras/logger:line-sink");
+function setLogLineSink(sink) {
+	globalThis[SINK_KEY] = sink;
+}
+/** Forward a line to the sink, if any. Never throws — telemetry must not break logging. */
+function forwardLogLine(line) {
+	const sink = globalThis[SINK_KEY];
+	if (!sink) return;
+	try {
+		sink(line);
+	} catch {}
+}
+//#endregion
+//#region src/transports/pino.ts
+/**
+* Pino-based transport — the default production backend.
+*
+* Wraps a Pino logger instance to satisfy the `LogTransport` interface,
+* keeping Pino as an implementation detail that consumers never interact with directly.
+*
+* For pretty-printed dev output, see `configureNodeLogger` in
+* `@eventuras/logger/node` — this module intentionally stays free of
+* `node:stream` imports so the main entry stays browser/edge-safe.
+*/
+var PinoTransport = class {
+	/** The underlying Pino instance. Exposed for advanced integrations only. */
+	pino;
+	constructor(options = {}) {
+		const pinoOpts = {
+			level: options.level ?? "info",
+			timestamp: pino.stdTimeFunctions.isoTime,
+			formatters: { level: (label) => ({ level: label }) },
+			...options.redact && { redact: {
+				paths: options.redact,
+				censor: "[REDACTED]"
+			} },
+			...options.pinoOptions
+		};
+		const userStreamWrite = options.pinoOptions?.hooks?.streamWrite;
+		pinoOpts.hooks = {
+			...options.pinoOptions?.hooks,
+			streamWrite: (line) => {
+				const out = userStreamWrite ? userStreamWrite(line) : line;
+				forwardLogLine(out);
+				return out;
+			}
+		};
+		if (options.destinationStream) this.pino = pino(pinoOpts, options.destinationStream);
+		else if (options.destination) this.pino = pino(pinoOpts, pino.destination(options.destination));
+		else this.pino = pino(pinoOpts);
+	}
+	log(level, data, msg) {
+		if (msg) this.pino[level](data, msg);
+		else this.pino[level](data);
+	}
+	child(bindings) {
+		return new PinoChildTransport(this.pino.child(bindings));
+	}
+	async flush() {
+		this.pino.flush();
+	}
+};
+/**
+* Lightweight wrapper for a Pino child logger.
+* Created by `PinoTransport.child()` — not intended for direct use.
+*/
+var PinoChildTransport = class PinoChildTransport {
+	pinoChild;
+	constructor(pinoChild) {
+		this.pinoChild = pinoChild;
+	}
+	log(level, data, msg) {
+		if (msg) this.pinoChild[level](data, msg);
+		else this.pinoChild[level](data);
+	}
+	child(bindings) {
+		return new PinoChildTransport(this.pinoChild.child(bindings));
+	}
+	async flush() {
+		this.pinoChild.flush();
+	}
+};
+//#endregion
+//#region src/transports/console.ts
+var LEVEL_TO_CONSOLE = {
+	trace: "debug",
+	debug: "debug",
+	info: "log",
+	warn: "warn",
+	error: "error",
+	fatal: "error"
+};
+var ConsoleTransport = class ConsoleTransport {
+	bindings;
+	/** Create a ConsoleTransport with optional pre-bound context fields. */
+	constructor(bindings) {
+		this.bindings = bindings ?? {};
+	}
+	/** Write a log entry to the appropriate `console` method. */
+	log(level, data, msg) {
+		const method = LEVEL_TO_CONSOLE[level];
+		const merged = {
+			...this.bindings,
+			...data
+		};
+		const hasData = Object.keys(merged).length > 0;
+		if (msg && hasData) console[method](`[${level}]`, msg, merged);
+		else if (msg) console[method](`[${level}]`, msg);
+		else if (hasData) console[method](`[${level}]`, merged);
+	}
+	/** Return a new ConsoleTransport with the given bindings merged in. */
+	child(bindings) {
+		return new ConsoleTransport({
+			...this.bindings,
+			...bindings
+		});
+	}
+};
+//#endregion
+//#region src/Logger.ts
+var DEFAULT_REDACT = [
+	"password",
+	"token",
+	"apiKey",
+	"authorization",
+	"secret"
+];
+function getEnv(key) {
+	if (typeof globalThis !== "undefined" && typeof globalThis.process === "object") return globalThis.process.env[key];
+}
+/** Detect Node.js runtime (vs browser / edge). */
+function isNodeRuntime() {
+	try {
+		return typeof process !== "undefined" && typeof process.versions?.node === "string";
+	} catch {
+		return false;
+	}
+}
+function createDefaultTransport(config) {
+	if (!isNodeRuntime()) return new ConsoleTransport();
+	return new PinoTransport({
+		level: config.level ?? getEnv("LOG_LEVEL") ?? "info",
+		redact: config.redact ?? DEFAULT_REDACT,
+		destination: config.destination
+	});
+}
+var Logger = class Logger {
+	static transport;
+	static config = {};
+	options;
+	childTransport;
+	static {
+		Logger.transport = createDefaultTransport(Logger.config);
+	}
+	constructor(options = {}) {
+		this.options = options;
+		if (options.context || options.correlationId || options.namespace) {
+			const bindings = {
+				...options.namespace && { namespace: options.namespace },
+				...options.correlationId && { correlationId: options.correlationId },
+				...options.context
+			};
+			this.childTransport = Logger.transport.child(bindings);
+		}
+	}
+	/**
+	* Configure global logger settings. Call once at application startup.
+	*
+	* Supply a custom `transport` to replace the default Pino backend,
+	* or omit it to keep PinoTransport with the provided options.
+	*
+	* @example
+	* Logger.configure({ level: 'debug', redact: ['password', 'apiKey'] });
+	*
+	* @example
+	* import { ConsoleTransport } from '@eventuras/logger';
+	* Logger.configure({ transport: new ConsoleTransport() });
+	*/
+	static configure(config) {
+		Logger.config = {
+			...Logger.config,
+			...config
+		};
+		Logger.transport = Logger.config.transport ?? createDefaultTransport(Logger.config);
+	}
+	/**
+	* Get the active transport for advanced integrations.
+	*
+	* If you need access to the underlying Pino instance (e.g. for OTel
+	* instrumentation), check `transport instanceof PinoTransport` and
+	* access `.pino` on it.
+	*/
+	static getTransport() {
+		return Logger.transport;
+	}
+	/**
+	* @deprecated Since 0.7 — will be removed in 1.0. Use `Logger.getTransport()`
+	* instead. If you need the raw Pino instance, cast the transport:
+	* `(Logger.getTransport() as PinoTransport).pino`.
+	*/
+	static getPinoInstance() {
+		if (Logger.transport instanceof PinoTransport) return Logger.transport.pino;
+		throw new Error("getPinoInstance() requires PinoTransport. Use Logger.getTransport() for the active transport.");
+	}
+	/**
+	* Normalize arguments for static log methods.
+	* Supports both `Logger.info('msg')` and `Logger.info({ namespace: 'x' }, 'msg')`.
+	*/
+	static normalizeArgs(optionsOrMsg, rest) {
+		if (typeof optionsOrMsg === "string") return [{}, [optionsOrMsg, ...rest]];
+		return [optionsOrMsg, rest];
+	}
+	static isDevelopment() {
+		return getEnv("NODE_ENV") === "development";
+	}
+	static formatError(error) {
+		if (error instanceof Error) return `${error.name}: ${error.message}\nStack: ${error.stack}`;
+		return String(error);
+	}
+	static buildLogData(options) {
+		return {
+			...options.namespace && { namespace: options.namespace },
+			...options.correlationId && { correlationId: options.correlationId },
+			...options.context
+		};
+	}
+	static staticLog(level, options, ...msg) {
+		if (options.developerOnly && !Logger.isDevelopment()) return;
+		const data = Logger.buildLogData(options);
+		Logger.transport.log(level, {
+			...data,
+			msg
+		});
+	}
+	static staticErrorLog(level, options, ...msg) {
+		if (options.developerOnly && !Logger.isDevelopment()) return;
+		const errorInfo = options.error ? { error: Logger.formatError(options.error) } : {};
+		const data = {
+			...Logger.buildLogData(options),
+			...errorInfo
+		};
+		Logger.transport.log(level, {
+			...data,
+			msg
+		});
+	}
+	static info(optionsOrMsg, ...msg) {
+		const [options, messages] = Logger.normalizeArgs(optionsOrMsg, msg);
+		Logger.staticLog("info", options, ...messages);
+	}
+	static debug(optionsOrMsg, ...msg) {
+		const [options, messages] = Logger.normalizeArgs(optionsOrMsg, msg);
+		Logger.staticLog("debug", options, ...messages);
+	}
+	static trace(optionsOrMsg, ...msg) {
+		const [options, messages] = Logger.normalizeArgs(optionsOrMsg, msg);
+		Logger.staticLog("trace", options, ...messages);
+	}
+	static warn(optionsOrMsg, ...msg) {
+		const [options, messages] = Logger.normalizeArgs(optionsOrMsg, msg);
+		Logger.staticLog("warn", options, ...messages);
+	}
+	static error(optionsOrMsg, ...msg) {
+		const [options, messages] = Logger.normalizeArgs(optionsOrMsg, msg);
+		Logger.staticErrorLog("error", options, ...messages);
+	}
+	static fatal(optionsOrMsg, ...msg) {
+		const [options, messages] = Logger.normalizeArgs(optionsOrMsg, msg);
+		Logger.staticErrorLog("fatal", options, ...messages);
+	}
+	/**
+	* Create a scoped logger instance with predefined options.
+	*
+	* @example
+	* const logger = Logger.create({ namespace: 'CollectionEditor' });
+	* logger.info('Something happened');
+	*
+	* @example
+	* const logger = Logger.create({
+	*   namespace: 'API',
+	*   context: { userId: 123 },
+	*   correlationId: req.headers['x-correlation-id'],
+	* });
+	* logger.info({ eventId: 789 }, 'Event added');
+	*/
+	static create(options = {}) {
+		return new Logger(options);
+	}
+	logInstance(level, data, msg) {
+		const transport = this.childTransport ?? Logger.transport;
+		if (typeof data === "string") transport.log(level, {}, data);
+		else if (msg) transport.log(level, data ?? {}, msg);
+		else transport.log(level, data ?? {});
+	}
+	/** Log at `trace` level. Pass a string or `{ data }` with an optional message. */
+	trace(data, msg) {
+		this.logInstance("trace", data, msg);
+	}
+	/** Log at `debug` level. */
+	debug(data, msg) {
+		this.logInstance("debug", data, msg);
+	}
+	/** Log at `info` level. */
+	info(data, msg) {
+		this.logInstance("info", data, msg);
+	}
+	/** Log at `warn` level. */
+	warn(data, msg) {
+		this.logInstance("warn", data, msg);
+	}
+	/**
+	* Log at `error` level. Accepts an `Error` instance, a data object, or a plain string.
+	* Error instances are serialized automatically.
+	*/
+	error(errorOrData, msg) {
+		const transport = this.childTransport ?? Logger.transport;
+		if (typeof errorOrData === "string") transport.log("error", {}, errorOrData);
+		else if (errorOrData instanceof Error) transport.log("error", { error: errorOrData }, msg);
+		else if (msg) transport.log("error", errorOrData ?? {}, msg);
+		else transport.log("error", errorOrData ?? {});
+	}
+	/**
+	* Log at `fatal` level. Same signature as `error()` but signals a critical/shutdown failure.
+	*/
+	fatal(errorOrData, msg) {
+		const transport = this.childTransport ?? Logger.transport;
+		if (typeof errorOrData === "string") transport.log("fatal", {}, errorOrData);
+		else if (errorOrData instanceof Error) transport.log("fatal", { error: errorOrData }, msg);
+		else if (msg) transport.log("fatal", errorOrData ?? {}, msg);
+		else transport.log("fatal", errorOrData ?? {});
+	}
+};
+//#endregion
+export { setLogLineSink as i, ConsoleTransport as n, PinoTransport as r, Logger as t };
+
+//# sourceMappingURL=Logger-B22dX10w.js.map

package/dist/Logger-B22dX10w.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger-B22dX10w.js","names":[],"sources":["../src/sink.ts","../src/transports/pino.ts","../src/transports/console.ts","../src/Logger.ts"],"sourcesContent":["/**\n * Process-wide hook for the serialized log lines Pino writes.\n *\n * `PinoTransport` hands every line (after redaction) to the sink, and\n * `@eventuras/logger/opentelemetry` sets the sink to forward lines as\n * OpenTelemetry log records.\n *\n * The sink lives on `globalThis` rather than in module state because a\n * bundler can load this package more than once in one process — Next.js\n * compiles `instrumentation.ts` into its own layer — and the copy that sets\n * the sink up is not necessarily the one whose loggers write the lines.\n */\n\nexport type LogLineSink = (line: string) => void;\n\nconst SINK_KEY = Symbol.for('@eventuras/logger:line-sink');\n\ntype SinkHolder = { [SINK_KEY]?: LogLineSink };\n\nexport function setLogLineSink(sink: LogLineSink | undefined): void {\n  (globalThis as SinkHolder)[SINK_KEY] = sink;\n}\n\n/** Forward a line to the sink, if any. Never throws — telemetry must not break logging. */\nexport function forwardLogLine(line: string): void {\n  const sink = (globalThis as SinkHolder)[SINK_KEY];\n  if (!sink) return;\n  try {\n    sink(line);\n  } catch {\n    // Dropped: a failing exporter or an unparseable line must not stop the\n    // line from reaching the primary destination.\n  }\n}\n","/**\n * Pino-based transport — the default production backend.\n *\n * Wraps a Pino logger instance to satisfy the `LogTransport` interface,\n * keeping Pino as an implementation detail that consumers never interact with directly.\n *\n * For pretty-printed dev output, see `configureNodeLogger` in\n * `@eventuras/logger/node` — this module intentionally stays free of\n * `node:stream` imports so the main entry stays browser/edge-safe.\n */\nimport pino, { type Logger as PinoLogger, type LoggerOptions as PinoLoggerOptions } from 'pino';\nimport { forwardLogLine } from '../sink';\nimport type { LogLevel, LogTransport } from '../types';\n\n/**\n * Minimal structural type for a Pino destination stream — accepts anything\n * with a `write` method. Defined locally so this file (re-exported from the\n * universal `@eventuras/logger` entry) doesn't pull `NodeJS.*` types into\n * browser/edge consumers that don't ship `@types/node`.\n */\nexport interface PinoDestinationStream {\n  write(chunk: string | Uint8Array): unknown;\n}\n\n/** Options for creating a PinoTransport. */\nexport type PinoTransportOptions = {\n  /** Minimum log level. Defaults to `'info'`. */\n  level?: LogLevel;\n  /** Field paths to redact from output. */\n  redact?: string[];\n  /** File path destination (omit for stdout). */\n  destination?: string;\n  /**\n   * Writable stream destination (e.g. a pretty-print stream from\n   * `@eventuras/logger/node`). Takes precedence over `destination`.\n   */\n  destinationStream?: PinoDestinationStream;\n  /** Raw Pino options for advanced tuning (merged after built-in defaults). */\n  pinoOptions?: PinoLoggerOptions;\n};\n\nexport class PinoTransport implements LogTransport {\n  /** The underlying Pino instance. Exposed for advanced integrations only. */\n  readonly pino: PinoLogger;\n\n  constructor(options: PinoTransportOptions = {}) {\n    const pinoOpts: PinoLoggerOptions = {\n      level: options.level ?? 'info',\n      // ISO timestamps for Loki/Grafana compatibility\n      timestamp: pino.stdTimeFunctions.isoTime,\n      // Output level as string label — avoids numeric mapping in log pipelines\n      formatters: {\n        level: (label) => ({ level: label }),\n      },\n      ...(options.redact && {\n        redact: { paths: options.redact, censor: '[REDACTED]' },\n      }),\n      ...options.pinoOptions,\n    };\n\n    // Hand every serialized line — after redaction, and from child loggers\n    // too, since they inherit hooks — to the OpenTelemetry bridge when one is\n    // set up. A caller-supplied streamWrite hook still runs first.\n    const userStreamWrite = options.pinoOptions?.hooks?.streamWrite;\n    pinoOpts.hooks = {\n      ...options.pinoOptions?.hooks,\n      streamWrite: (line) => {\n        const out = userStreamWrite ? userStreamWrite(line) : line;\n        forwardLogLine(out);\n        return out;\n      },\n    };\n\n    if (options.destinationStream) {\n      // Pino's overload expects a NodeJS.WritableStream; the structural\n      // PinoDestinationStream is a strict subset (only `.write` is read at\n      // runtime), so the cast is safe.\n      this.pino = pino(pinoOpts, options.destinationStream as Parameters<typeof pino>[1]);\n    } else if (options.destination) {\n      this.pino = pino(pinoOpts, pino.destination(options.destination));\n    } else {\n      this.pino = pino(pinoOpts);\n    }\n  }\n\n  log(level: LogLevel, data: Record<string, unknown>, msg?: string): void {\n    if (msg) {\n      this.pino[level](data, msg);\n    } else {\n      this.pino[level](data);\n    }\n  }\n\n  child(bindings: Record<string, unknown>): LogTransport {\n    const childPino = this.pino.child(bindings);\n    return new PinoChildTransport(childPino);\n  }\n\n  async flush(): Promise<void> {\n    this.pino.flush();\n  }\n}\n\n/**\n * Lightweight wrapper for a Pino child logger.\n * Created by `PinoTransport.child()` — not intended for direct use.\n */\nclass PinoChildTransport implements LogTransport {\n  constructor(private readonly pinoChild: PinoLogger) { }\n\n  log(level: LogLevel, data: Record<string, unknown>, msg?: string): void {\n    if (msg) {\n      this.pinoChild[level](data, msg);\n    } else {\n      this.pinoChild[level](data);\n    }\n  }\n\n  child(bindings: Record<string, unknown>): LogTransport {\n    return new PinoChildTransport(this.pinoChild.child(bindings));\n  }\n\n  async flush(): Promise<void> {\n    this.pinoChild.flush();\n  }\n}\n","/**\n * Console-based transport for browser environments and testing.\n *\n * Uses `console.log/warn/error` — no dependencies, works everywhere.\n * Useful as a lightweight fallback when Pino is not available or desired.\n */\nimport type { LogLevel, LogTransport } from '../types';\n\nconst LEVEL_TO_CONSOLE: Record<LogLevel, 'log' | 'warn' | 'error' | 'debug'> = {\n  trace: 'debug',\n  debug: 'debug',\n  info: 'log',\n  warn: 'warn',\n  error: 'error',\n  fatal: 'error',\n};\n\nexport class ConsoleTransport implements LogTransport {\n  private readonly bindings: Record<string, unknown>;\n\n  /** Create a ConsoleTransport with optional pre-bound context fields. */\n  constructor(bindings?: Record<string, unknown>) {\n    this.bindings = bindings ?? {};\n  }\n\n  /** Write a log entry to the appropriate `console` method. */\n  log(level: LogLevel, data: Record<string, unknown>, msg?: string): void {\n    const method = LEVEL_TO_CONSOLE[level];\n    const merged = { ...this.bindings, ...data };\n    const hasData = Object.keys(merged).length > 0;\n\n    if (msg && hasData) {\n      console[method](`[${level}]`, msg, merged);\n    } else if (msg) {\n      console[method](`[${level}]`, msg);\n    } else if (hasData) {\n      console[method](`[${level}]`, merged);\n    }\n  }\n\n  /** Return a new ConsoleTransport with the given bindings merged in. */\n  child(bindings: Record<string, unknown>): LogTransport {\n    return new ConsoleTransport({ ...this.bindings, ...bindings });\n  }\n}\n","/**\n * Structured logger with pluggable transports.\n *\n * Uses a `LogTransport` abstraction so the logging backend can be swapped\n * without changing application code. Ships with PinoTransport (default,\n * production-grade) and ConsoleTransport (browser/testing).\n *\n * Standard log levels:\n * fatal: 60 | error: 50 | warn: 40 | info: 30 | debug: 20 | trace: 10\n *\n * @example\n * // Scoped logger (recommended pattern)\n * const logger = Logger.create({\n *   namespace: 'CollectionEditor',\n *   context: { collectionId: 123 },\n * });\n * logger.info('Event added', { eventId: 456 });\n *\n * @example\n * // Static one-off logs\n * Logger.info('Simple message');\n * Logger.error({ error: err }, 'Something failed');\n *\n * @example\n * // Custom transport\n * import { ConsoleTransport } from '@eventuras/logger';\n * Logger.configure({ transport: new ConsoleTransport() });\n */\nimport type {\n  ErrorLoggerOptions,\n  LoggerConfig,\n  LoggerOptions,\n  LogLevel,\n  LogTransport,\n} from './types';\nimport { PinoTransport } from './transports/pino';\nimport { ConsoleTransport } from './transports/console';\n\nconst DEFAULT_REDACT = ['password', 'token', 'apiKey', 'authorization', 'secret'];\n\nfunction getEnv(key: string): string | undefined {\n  if (typeof globalThis !== 'undefined' && typeof (globalThis as Record<string, unknown>).process === 'object') {\n    return (globalThis as unknown as { process: { env: Record<string, string | undefined>; }; }).process.env[key];\n  }\n  return undefined;\n}\n\n/** Detect Node.js runtime (vs browser / edge). */\nfunction isNodeRuntime(): boolean {\n  try {\n    return typeof process !== 'undefined' && typeof process.versions?.node === 'string';\n  } catch {\n    return false;\n  }\n}\n\nfunction createDefaultTransport(config: LoggerConfig): LogTransport {\n  // In non-Node environments (browser, edge), fall back to ConsoleTransport\n  if (!isNodeRuntime()) {\n    return new ConsoleTransport();\n  }\n\n  return new PinoTransport({\n    level: config.level ?? (getEnv('LOG_LEVEL') as LogLevel | undefined) ?? 'info',\n    redact: config.redact ?? DEFAULT_REDACT,\n    destination: config.destination,\n  });\n}\n\nexport class Logger {\n  private static transport: LogTransport;\n  private static config: LoggerConfig = {};\n\n  // Instance properties for scoped logger\n  private readonly options: LoggerOptions;\n  private readonly childTransport?: LogTransport;\n\n  static {\n    Logger.transport = createDefaultTransport(Logger.config);\n  }\n\n  private constructor(options: LoggerOptions = {}) {\n    this.options = options;\n\n    if (options.context || options.correlationId || options.namespace) {\n      const bindings: Record<string, unknown> = {\n        ...(options.namespace && { namespace: options.namespace }),\n        ...(options.correlationId && { correlationId: options.correlationId }),\n        ...options.context,\n      };\n      this.childTransport = Logger.transport.child(bindings);\n    }\n  }\n\n  /**\n   * Configure global logger settings. Call once at application startup.\n   *\n   * Supply a custom `transport` to replace the default Pino backend,\n   * or omit it to keep PinoTransport with the provided options.\n   *\n   * @example\n   * Logger.configure({ level: 'debug', redact: ['password', 'apiKey'] });\n   *\n   * @example\n   * import { ConsoleTransport } from '@eventuras/logger';\n   * Logger.configure({ transport: new ConsoleTransport() });\n   */\n  static configure(config: Partial<LoggerConfig>): void {\n    Logger.config = { ...Logger.config, ...config };\n    Logger.transport = Logger.config.transport ?? createDefaultTransport(Logger.config);\n  }\n\n  /**\n   * Get the active transport for advanced integrations.\n   *\n   * If you need access to the underlying Pino instance (e.g. for OTel\n   * instrumentation), check `transport instanceof PinoTransport` and\n   * access `.pino` on it.\n   */\n  static getTransport(): LogTransport {\n    return Logger.transport;\n  }\n\n  /**\n   * @deprecated Since 0.7 — will be removed in 1.0. Use `Logger.getTransport()`\n   * instead. If you need the raw Pino instance, cast the transport:\n   * `(Logger.getTransport() as PinoTransport).pino`.\n   */\n  static getPinoInstance(): import('pino').Logger {\n    if (Logger.transport instanceof PinoTransport) {\n      return Logger.transport.pino;\n    }\n    throw new Error(\n      'getPinoInstance() requires PinoTransport. Use Logger.getTransport() for the active transport.',\n    );\n  }\n\n  // --- Static convenience methods ---\n\n  /**\n   * Normalize arguments for static log methods.\n   * Supports both `Logger.info('msg')` and `Logger.info({ namespace: 'x' }, 'msg')`.\n   */\n  private static normalizeArgs(\n    optionsOrMsg: LoggerOptions | string,\n    rest: unknown[],\n  ): [LoggerOptions, unknown[]] {\n    if (typeof optionsOrMsg === 'string') {\n      return [{}, [optionsOrMsg, ...rest]];\n    }\n    return [optionsOrMsg, rest];\n  }\n\n  private static isDevelopment(): boolean {\n    return getEnv('NODE_ENV') === 'development';\n  }\n\n  private static formatError(error: unknown): string {\n    if (error instanceof Error) {\n      return `${error.name}: ${error.message}\\nStack: ${error.stack}`;\n    }\n    return String(error);\n  }\n\n  private static buildLogData(options: LoggerOptions): Record<string, unknown> {\n    return {\n      ...(options.namespace && { namespace: options.namespace }),\n      ...(options.correlationId && { correlationId: options.correlationId }),\n      ...options.context,\n    };\n  }\n\n  private static staticLog(\n    level: LogLevel,\n    options: LoggerOptions,\n    ...msg: unknown[]\n  ): void {\n    if (options.developerOnly && !Logger.isDevelopment()) return;\n    const data = Logger.buildLogData(options);\n    Logger.transport.log(level, { ...data, msg });\n  }\n\n  private static staticErrorLog(\n    level: LogLevel,\n    options: ErrorLoggerOptions,\n    ...msg: unknown[]\n  ): void {\n    if (options.developerOnly && !Logger.isDevelopment()) return;\n    const errorInfo = options.error ? { error: Logger.formatError(options.error) } : {};\n    const data = { ...Logger.buildLogData(options), ...errorInfo };\n    Logger.transport.log(level, { ...data, msg });\n  }\n\n  /** Log at info level with options and message(s). */\n  static info(options: LoggerOptions, ...msg: unknown[]): void;\n  /** Log at info level with just a message string. */\n  static info(msg: string, ...args: unknown[]): void;\n  static info(optionsOrMsg: LoggerOptions | string, ...msg: unknown[]): void {\n    const [options, messages] = Logger.normalizeArgs(optionsOrMsg, msg);\n    Logger.staticLog('info', options, ...messages);\n  }\n\n  /** Log at debug level with options and message(s). */\n  static debug(options: LoggerOptions, ...msg: unknown[]): void;\n  /** Log at debug level with just a message string. */\n  static debug(msg: string, ...args: unknown[]): void;\n  static debug(optionsOrMsg: LoggerOptions | string, ...msg: unknown[]): void {\n    const [options, messages] = Logger.normalizeArgs(optionsOrMsg, msg);\n    Logger.staticLog('debug', options, ...messages);\n  }\n\n  /** Log at trace level with options and message(s). */\n  static trace(options: LoggerOptions, ...msg: unknown[]): void;\n  /** Log at trace level with just a message string. */\n  static trace(msg: string, ...args: unknown[]): void;\n  static trace(optionsOrMsg: LoggerOptions | string, ...msg: unknown[]): void {\n    const [options, messages] = Logger.normalizeArgs(optionsOrMsg, msg);\n    Logger.staticLog('trace', options, ...messages);\n  }\n\n  /** Log at warn level with options and message(s). */\n  static warn(options: LoggerOptions, ...msg: unknown[]): void;\n  /** Log at warn level with just a message string. */\n  static warn(msg: string, ...args: unknown[]): void;\n  static warn(optionsOrMsg: LoggerOptions | string, ...msg: unknown[]): void {\n    const [options, messages] = Logger.normalizeArgs(optionsOrMsg, msg);\n    Logger.staticLog('warn', options, ...messages);\n  }\n\n  /** Log at error level with options and message(s). */\n  static error(options: ErrorLoggerOptions, ...msg: unknown[]): void;\n  /** Log at error level with just a message string. */\n  static error(msg: string, ...args: unknown[]): void;\n  static error(optionsOrMsg: ErrorLoggerOptions | string, ...msg: unknown[]): void {\n    const [options, messages] = Logger.normalizeArgs(optionsOrMsg, msg);\n    Logger.staticErrorLog('error', options, ...messages);\n  }\n\n  /** Log at fatal level with options and message(s). */\n  static fatal(options: ErrorLoggerOptions, ...msg: unknown[]): void;\n  /** Log at fatal level with just a message string. */\n  static fatal(msg: string, ...args: unknown[]): void;\n  static fatal(optionsOrMsg: ErrorLoggerOptions | string, ...msg: unknown[]): void {\n    const [options, messages] = Logger.normalizeArgs(optionsOrMsg, msg);\n    Logger.staticErrorLog('fatal', options, ...messages);\n  }\n\n  /**\n   * Create a scoped logger instance with predefined options.\n   *\n   * @example\n   * const logger = Logger.create({ namespace: 'CollectionEditor' });\n   * logger.info('Something happened');\n   *\n   * @example\n   * const logger = Logger.create({\n   *   namespace: 'API',\n   *   context: { userId: 123 },\n   *   correlationId: req.headers['x-correlation-id'],\n   * });\n   * logger.info({ eventId: 789 }, 'Event added');\n   */\n  static create(options: LoggerOptions = {}): Logger {\n    return new Logger(options);\n  }\n\n  // --- Instance methods ---\n\n  private logInstance(level: LogLevel, data?: Record<string, unknown> | string, msg?: string): void {\n    const transport = this.childTransport ?? Logger.transport;\n    if (typeof data === 'string') {\n      transport.log(level, {}, data);\n    } else if (msg) {\n      transport.log(level, data ?? {}, msg);\n    } else {\n      transport.log(level, data ?? {});\n    }\n  }\n\n  /** Log at `trace` level. Pass a string or `{ data }` with an optional message. */\n  trace(data?: Record<string, unknown> | string, msg?: string): void {\n    this.logInstance('trace', data, msg);\n  }\n\n  /** Log at `debug` level. */\n  debug(data?: Record<string, unknown> | string, msg?: string): void {\n    this.logInstance('debug', data, msg);\n  }\n\n  /** Log at `info` level. */\n  info(data?: Record<string, unknown> | string, msg?: string): void {\n    this.logInstance('info', data, msg);\n  }\n\n  /** Log at `warn` level. */\n  warn(data?: Record<string, unknown> | string, msg?: string): void {\n    this.logInstance('warn', data, msg);\n  }\n\n  /**\n   * Log at `error` level. Accepts an `Error` instance, a data object, or a plain string.\n   * Error instances are serialized automatically.\n   */\n  error(errorOrData?: unknown, msg?: string): void {\n    const transport = this.childTransport ?? Logger.transport;\n    if (typeof errorOrData === 'string') {\n      transport.log('error', {}, errorOrData);\n    } else if (errorOrData instanceof Error) {\n      transport.log('error', { error: errorOrData }, msg);\n    } else if (msg) {\n      transport.log('error', (errorOrData as Record<string, unknown>) ?? {}, msg);\n    } else {\n      transport.log('error', (errorOrData as Record<string, unknown>) ?? {});\n    }\n  }\n\n  /**\n   * Log at `fatal` level. Same signature as `error()` but signals a critical/shutdown failure.\n   */\n  fatal(errorOrData?: unknown, msg?: string): void {\n    const transport = this.childTransport ?? Logger.transport;\n    if (typeof errorOrData === 'string') {\n      transport.log('fatal', {}, errorOrData);\n    } else if (errorOrData instanceof Error) {\n      transport.log('fatal', { error: errorOrData }, msg);\n    } else if (msg) {\n      transport.log('fatal', (errorOrData as Record<string, unknown>) ?? {}, msg);\n    } else {\n      transport.log('fatal', (errorOrData as Record<string, unknown>) ?? {});\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/index.js

@@ -1,6 +1,10 @@
-import { n as e, r as t, t as n } from "./Logger-CcNEmm6u.js";
+import { n as ConsoleTransport, r as PinoTransport, t as Logger } from "./Logger-B22dX10w.js";
 //#region src/httpLogger.ts
-var r = [
+/**
+* HTTP logging utilities for API clients.
+* Provides header redaction for structured logging.
+*/
+var SENSITIVE_HEADERS = [
 	"authorization",
 	"cookie",
 	"set-cookie",
@@ -8,15 +12,32 @@ var r = [
 	"x-auth-token",
 	"proxy-authorization"
 ];
-function i(e) {
-	let t = {};
-	return e instanceof Headers ? e.forEach((e, n) => {
-		t[n] = r.includes(n.toLowerCase()) ? "[REDACTED]" : e;
-	}) : Array.isArray(e) ? e.forEach(([e, n]) => {
-		t[e] = r.includes(e.toLowerCase()) ? "[REDACTED]" : String(n);
-	}) : Object.entries(e).forEach(([e, n]) => {
-		t[e] = r.includes(e.toLowerCase()) ? "[REDACTED]" : String(n);
-	}), t;
+/**
+* Redact sensitive headers for logging.
+* Use with logger.debug/info/error to safely log HTTP headers.
+*
+* @example
+* logger.debug({
+*   request: {
+*     url: '/api/users',
+*     headers: redactHeaders(headers)
+*   }
+* }, 'HTTP request');
+*/
+function redactHeaders(headers) {
+	const result = {};
+	if (headers instanceof Headers) headers.forEach((value, key) => {
+		result[key] = SENSITIVE_HEADERS.includes(key.toLowerCase()) ? "[REDACTED]" : value;
+	});
+	else if (Array.isArray(headers)) headers.forEach(([key, value]) => {
+		result[key] = SENSITIVE_HEADERS.includes(key.toLowerCase()) ? "[REDACTED]" : String(value);
+	});
+	else Object.entries(headers).forEach(([key, value]) => {
+		result[key] = SENSITIVE_HEADERS.includes(key.toLowerCase()) ? "[REDACTED]" : String(value);
+	});
+	return result;
 }
 //#endregion
-export { e as ConsoleTransport, n as Logger, t as PinoTransport, i as redactHeaders };
+export { ConsoleTransport, Logger, PinoTransport, redactHeaders };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/httpLogger.ts"],"sourcesContent":["/**\n * HTTP logging utilities for API clients.\n * Provides header redaction for structured logging.\n */\n\nconst SENSITIVE_HEADERS = [\n  'authorization',\n  'cookie',\n  'set-cookie',\n  'x-api-key',\n  'x-auth-token',\n  'proxy-authorization',\n];\n\n/**\n * Redact sensitive headers for logging.\n * Use with logger.debug/info/error to safely log HTTP headers.\n *\n * @example\n * logger.debug({\n *   request: {\n *     url: '/api/users',\n *     headers: redactHeaders(headers)\n *   }\n * }, 'HTTP request');\n */\nexport function redactHeaders(\n  headers: Headers | Record<string, unknown> | [string, string][],\n): Record<string, string> {\n  const result: Record<string, string> = {};\n\n  if (headers instanceof Headers) {\n    headers.forEach((value: string, key: string) => {\n      result[key] = SENSITIVE_HEADERS.includes(key.toLowerCase()) ? '[REDACTED]' : value;\n    });\n  } else if (Array.isArray(headers)) {\n    headers.forEach(([key, value]) => {\n      result[key] = SENSITIVE_HEADERS.includes(key.toLowerCase()) ? '[REDACTED]' : String(value);\n    });\n  } else {\n    Object.entries(headers).forEach(([key, value]) => {\n      result[key] = SENSITIVE_HEADERS.includes(key.toLowerCase()) ? '[REDACTED]' : String(value);\n    });\n  }\n\n  return result;\n}\n"],"mappings":";;;;;;AAKA,IAAM,oBAAoB;CACxB;CACA;CACA;CACA;CACA;CACA;AACF;;;;;;;;;;;;;AAcA,SAAgB,cACd,SACwB;CACxB,MAAM,SAAiC,CAAC;CAExC,IAAI,mBAAmB,SACrB,QAAQ,SAAS,OAAe,QAAgB;EAC9C,OAAO,OAAO,kBAAkB,SAAS,IAAI,YAAY,CAAC,IAAI,eAAe;CAC/E,CAAC;MACI,IAAI,MAAM,QAAQ,OAAO,GAC9B,QAAQ,SAAS,CAAC,KAAK,WAAW;EAChC,OAAO,OAAO,kBAAkB,SAAS,IAAI,YAAY,CAAC,IAAI,eAAe,OAAO,KAAK;CAC3F,CAAC;MAED,OAAO,QAAQ,OAAO,CAAC,CAAC,SAAS,CAAC,KAAK,WAAW;EAChD,OAAO,OAAO,kBAAkB,SAAS,IAAI,YAAY,CAAC,IAAI,eAAe,OAAO,KAAK;CAC3F,CAAC;CAGH,OAAO;AACT"}