logixia 2.0.0 → 2.0.6

package/dist/testing.d.ts

@@ -1,8 +1,4 @@
-import "./transport.types-CGoHpWQR.js";
-import { h as LogEntry, u as IBaseLogger } from "./index-DhIoploR.js";
-
-//#region src/testing/mock-logger.d.ts
-
+import { C as LogixiaLoggerInstance, g as LogEntry } from "./index-CFDGkI8n.js";
 interface MockLogCall {
   level: string;
   message: string;
@@ -14,8 +10,8 @@ interface MockLogCall {
 }
 type LogMatcher = string | RegExp | ((call: MockLogCall) => boolean) | Partial<Record<'message' | 'level' | string, unknown>>;
 interface MockLoggerInstance {
-  /** The logger itself — pass this where an IBaseLogger is expected. */
-  readonly logger: IBaseLogger;
+  /** The logger itself — pass this where an IBaseLogger or ILogger is expected. */
+  readonly logger: LogixiaLoggerInstance;
   /** Every call recorded across all levels, in insertion order. */
   readonly calls: MockLogCall[];
   /**
@@ -44,6 +40,11 @@ interface MockLoggerInstance {
   expectNoLog(level: string, matcher?: LogMatcher): void;
   /** Clear all recorded calls. Call between tests. */
   reset(): void;
+  /**
+   * Make `logger.healthCheck()` report healthy or unhealthy, to exercise code that
+   * reacts to a failing logger. Shared with child loggers.
+   */
+  setHealth(healthy: boolean, details?: Record<string, unknown>): void;
   /**
    * Silence — when true, the mock suppresses all console output from the
    * logger. Default: true.
@@ -53,16 +54,17 @@ interface MockLoggerInstance {
 /**
  * Create a mock logger for use in tests.
  *
- * The returned object implements `IBaseLogger` and additionally exposes `.calls`,
+ * The returned object implements `ILogger` and additionally exposes `.calls`,
  * `.getCalls()`, `.getLastCall()`, `.expectLog()`, `.expectNoLog()`, and `.reset()`.
  *
  * @param options.silent  Suppress console output (default: true)
  * @param options.context Optional context label written into every `entry.context`
+ * @param options.healthy Initial `healthCheck()` result (default: true); change later with `setHealth()`
  */
-declare function createMockLogger(options?: {
+export declare function createMockLogger(options?: {
   silent?: boolean;
   context?: string;
+  healthy?: boolean;
 }): MockLoggerInstance;
-//#endregion
-export { type LogMatcher, type MockLogCall, type MockLoggerInstance, createMockLogger };
+export type { LogMatcher, MockLogCall, MockLoggerInstance };
 //# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"testing.d.ts","names":[],"sources":["../src/testing/mock-logger.ts"],"sourcesContent":[],"mappings":";;;;;AAkCiB,UAdA,WAAA,CAckB;EAEhB,KAAA,EAAA,MAAA;EAED,OAAA,EAAA,MAAA;EAKU,IAAA,CAAA,EApBnB,MAoBmB,CAAA,MAAA,EAAA,OAAA,CAAA;EAEG;EAaM,KAAA,EAjC5B,IAiC4B,CAjCvB,QAiCuB,EAAA,OAAA,GAAA,SAAA,GAAA,SAAA,CAAA,GAAA;IAIE,IAAA,CAAA,EArC6B,MAqC7B,CAAA,MAAA,EAAA,OAAA,CAAA;EAAU,CAAA;AA2DjD;KA7FY,UAAA,YAER,iBACQ,2BACR,QAAQ;UAEK,kBAAA;;mBAEE;;kBAED;;;;;4BAKU;;+BAEG;;;;;;;;;;;;;qCAaM;;;;uCAIE;;;;;;;;;;;;;;;;;;iBA2DvB,gBAAA;;;IAEb"}
+{"version":3,"file":"testing.d.ts","names":[],"sources":["../src/testing/mock-logger.ts"],"mappings":";UAoBiB;EACf;EACA;EACA,OAAO;;EAEP,OAAO,KAAK;IAA+C,OAAO;;;KAGxD,sBAER,WACE,MAAM,2BACR,QAAQ;UAEK;;WAEN,QAAQ;;WAER,OAAO;;;;;EAKhB,SAAS,iBAAiB;;EAE1B,YAAY,iBAAiB;;;;;;;;;;;;;EAa7B,UAAU,eAAe,UAAU;;;;EAInC,YAAY,eAAe,UAAU;;EAErC;;;;;EAKA,UAAU,kBAAkB,UAAU;;;;;EAKtC;;;;;;;;;;;;wBAqDc,iBACd;EAAW;EAAkB;EAAkB;IAC9C"}

package/dist/testing.js

@@ -1,5 +1,5 @@
-
-//#region src/testing/mock-logger.ts
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+// src/testing/mock-logger.ts
 function resolveCallField(call, key) {
 	var _call$data;
 	if (key === "message") return call.message;
@@ -31,13 +31,23 @@ function formatCalls(calls) {
 /**
 * Create a mock logger for use in tests.
 *
-* The returned object implements `IBaseLogger` and additionally exposes `.calls`,
+* The returned object implements `ILogger` and additionally exposes `.calls`,
 * `.getCalls()`, `.getLastCall()`, `.expectLog()`, `.expectNoLog()`, and `.reset()`.
 *
 * @param options.silent  Suppress console output (default: true)
 * @param options.context Optional context label written into every `entry.context`
+* @param options.healthy Initial `healthCheck()` result (default: true); change later with `setHealth()`
 */
 function createMockLogger(options = {}) {
+	return buildMockLogger(options, {
+		namespaceLevels: {},
+		health: {
+			healthy: options.healthy ?? true,
+			details: {}
+		}
+	});
+}
+function buildMockLogger(options, shared) {
 	const { silent = true, context } = options;
 	const _calls = [];
 	function record(level, messageOrError, data) {
@@ -94,6 +104,18 @@ function createMockLogger(options = {}) {
 		getLevel() {
 			return "info";
 		},
+		setNamespaceLevels(levels) {
+			shared.namespaceLevels = { ...levels };
+		},
+		patchNamespaceLevels(levels) {
+			shared.namespaceLevels = {
+				...shared.namespaceLevels,
+				...levels
+			};
+		},
+		getNamespaceLevels() {
+			return { ...shared.namespaceLevels };
+		},
 		setContext(_ctx) {},
 		getContext() {
 			return context;
@@ -116,10 +138,17 @@ function createMockLogger(options = {}) {
 			return [];
 		},
 		child(ctx, _data) {
-			return createMockLogger({
+			return buildMockLogger({
 				silent,
 				context: ctx
-			}).logger;
+			}, shared).logger;
+		},
+		async flush() {},
+		async healthCheck() {
+			return {
+				healthy: shared.health.healthy,
+				details: { ...shared.health.details }
+			};
 		},
 		async close() {},
 		use(_plugin) {
@@ -160,11 +189,16 @@ function createMockLogger(options = {}) {
 		reset() {
 			_calls.length = 0;
 		},
+		setHealth(healthy, details = {}) {
+			shared.health = {
+				healthy,
+				details
+			};
+		},
 		silent
 	};
 	return instance;
 }
-
-//#endregion
 exports.createMockLogger = createMockLogger;
+
 //# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -1 +1 @@
-{"version":3,"file":"testing.js","names":["_calls: MockLogCall[]","logger: IBaseLogger","instance: MockLoggerInstance"],"sources":["../src/testing/mock-logger.ts"],"sourcesContent":["/**\n * logixia/testing — Zero-dependency mock logger for Vitest & Jest.\n *\n * @example\n * ```ts\n * import { createMockLogger } from 'logixia/testing';\n *\n * const mock = createMockLogger();\n * await myService.doSomething(mock.logger);\n *\n * mock.expectLog('info', { message: 'order created' });\n * mock.expectLog('error', { message: /failed/ });\n * mock.reset();\n * ```\n */\n\nimport type { IBaseLogger, LogEntry } from '../types';\n\n// ── Types ────────────────────────────────────────────────────────────────────\n\nexport interface MockLogCall {\n  level: string;\n  message: string;\n  data?: Record<string, unknown>;\n  /** Full LogEntry shape for assertions that inspect the complete record. */\n  entry: Pick<LogEntry, 'level' | 'message' | 'context'> & { data?: Record<string, unknown> };\n}\n\nexport type LogMatcher =\n  | string\n  | RegExp\n  | ((call: MockLogCall) => boolean)\n  | Partial<Record<'message' | 'level' | string, unknown>>;\n\nexport interface MockLoggerInstance {\n  /** The logger itself — pass this where an IBaseLogger is expected. */\n  readonly logger: IBaseLogger;\n  /** Every call recorded across all levels, in insertion order. */\n  readonly calls: MockLogCall[];\n  /**\n   * Get all calls for a specific level (case-insensitive). If `level` is\n   * omitted, returns all calls across every level.\n   */\n  getCalls(level?: string): MockLogCall[];\n  /** Return the most recent call, optionally filtered by level. */\n  getLastCall(level?: string): MockLogCall | undefined;\n  /**\n   * Assert that at least one recorded call matches `matcher`.\n   *\n   * - string → exact message match\n   * - RegExp → message test\n   * - function → receives the full MockLogCall\n   * - object → every key/value must match (supports RegExp values)\n   *\n   * Throws an Error with a descriptive message if the assertion fails (works\n   * with both Vitest `expect` and Jest matchers via `.toThrow()`, or you can\n   * let it propagate directly).\n   */\n  expectLog(level: string, matcher?: LogMatcher): void;\n  /**\n   * Assert that NO recorded call matches `matcher` at the given level.\n   */\n  expectNoLog(level: string, matcher?: LogMatcher): void;\n  /** Clear all recorded calls. Call between tests. */\n  reset(): void;\n  /**\n   * Silence — when true, the mock suppresses all console output from the\n   * logger. Default: true.\n   */\n  silent: boolean;\n}\n\n// ── Helpers ──────────────────────────────────────────────────────────────────\n\nfunction resolveCallField(call: MockLogCall, key: string): unknown {\n  if (key === 'message') return call.message;\n  if (key === 'level') return call.level;\n  return call.data?.[key] ?? (call.entry as Record<string, unknown>)[key];\n}\n\nfunction formatMatcherDescription(matcher: LogMatcher | undefined): string {\n  if (matcher === undefined) return '(any)';\n  if (matcher instanceof RegExp) return matcher.toString();\n  return JSON.stringify(matcher);\n}\n\nfunction matchesCall(call: MockLogCall, matcher?: LogMatcher): boolean {\n  if (matcher === undefined) return true;\n  if (typeof matcher === 'string') return call.message === matcher;\n  if (matcher instanceof RegExp) return matcher.test(call.message);\n  if (typeof matcher === 'function') return matcher(call);\n  // Object shape: every key/value must match\n  for (const [key, expected] of Object.entries(matcher)) {\n    const actual = resolveCallField(call, key);\n    if (expected instanceof RegExp) {\n      if (!expected.test(String(actual ?? ''))) return false;\n    } else {\n      if (actual !== expected) return false;\n    }\n  }\n  return true;\n}\n\nfunction formatCalls(calls: MockLogCall[]): string {\n  if (calls.length === 0) return '  (no calls recorded)';\n  return calls\n    .map((c) => `  [${c.level}] \"${c.message}\" ${c.data ? JSON.stringify(c.data) : ''}`)\n    .join('\\n');\n}\n\n// ── Implementation ────────────────────────────────────────────────────────────\n\n/**\n * Create a mock logger for use in tests.\n *\n * The returned object implements `IBaseLogger` and additionally exposes `.calls`,\n * `.getCalls()`, `.getLastCall()`, `.expectLog()`, `.expectNoLog()`, and `.reset()`.\n *\n * @param options.silent  Suppress console output (default: true)\n * @param options.context Optional context label written into every `entry.context`\n */\nexport function createMockLogger(\n  options: { silent?: boolean; context?: string } = {}\n): MockLoggerInstance {\n  const { silent = true, context } = options;\n  const _calls: MockLogCall[] = [];\n\n  function record(\n    level: string,\n    messageOrError: string | Error,\n    data?: Record<string, unknown>\n  ): void {\n    const message = messageOrError instanceof Error ? messageOrError.message : messageOrError;\n    const extraData =\n      messageOrError instanceof Error\n        ? { ...data, error: { message: messageOrError.message, stack: messageOrError.stack } }\n        : data;\n\n    _calls.push({\n      level,\n      message,\n      ...(extraData !== undefined ? { data: extraData } : {}),\n      entry: {\n        level,\n        message,\n        ...(context !== undefined ? { context } : {}),\n        ...(extraData !== undefined ? { data: extraData } : {}),\n      },\n    });\n  }\n\n  const logger: IBaseLogger = {\n    async error(messageOrError, data) {\n      record('error', messageOrError as string | Error, data);\n    },\n    async warn(message, data) {\n      record('warn', message, data);\n    },\n    async info(message, data) {\n      record('info', message, data);\n    },\n    async debug(message, data) {\n      record('debug', message, data);\n    },\n    async trace(message, data) {\n      record('trace', message, data);\n    },\n    async verbose(message, data) {\n      record('verbose', message, data);\n    },\n    async logLevel(level, message, data) {\n      record(level, message, data);\n    },\n\n    time(_label) {\n      /* no-op in tests */\n    },\n    async timeEnd(_label) {\n      return 0;\n    },\n    async timeAsync(_label, fn) {\n      return fn();\n    },\n\n    setLevel(_level) {\n      /* no-op */\n    },\n    getLevel() {\n      return 'info';\n    },\n    setContext(_ctx) {\n      /* no-op */\n    },\n    getContext() {\n      return context;\n    },\n\n    enableField(_f) {\n      /* no-op */\n    },\n    disableField(_f) {\n      /* no-op */\n    },\n    isFieldEnabled(_f) {\n      return true;\n    },\n    getFieldState() {\n      return {};\n    },\n    resetFieldState() {\n      /* no-op */\n    },\n\n    enableTransportLevelPrompting() {\n      /* no-op */\n    },\n    disableTransportLevelPrompting() {\n      /* no-op */\n    },\n    setTransportLevels(_id, _levels) {\n      /* no-op */\n    },\n    getTransportLevels(_id): string[] | undefined {\n      return undefined;\n    },\n    clearTransportLevelPreferences() {\n      /* no-op */\n    },\n    getAvailableTransports() {\n      return [];\n    },\n\n    child(ctx, _data) {\n      return createMockLogger({ silent, context: ctx }).logger;\n    },\n    async close() {\n      /* no-op */\n    },\n\n    // Plugin API stubs — mock logger does not run plugins\n    use(_plugin) {\n      return this;\n    },\n    unuse(_pluginName) {\n      return this;\n    },\n  };\n\n  const instance: MockLoggerInstance = {\n    get logger() {\n      return logger;\n    },\n    get calls() {\n      return _calls;\n    },\n\n    getCalls(level?: string): MockLogCall[] {\n      if (!level) return [..._calls];\n      const l = level.toLowerCase();\n      return _calls.filter((c) => c.level.toLowerCase() === l);\n    },\n\n    getLastCall(level?: string): MockLogCall | undefined {\n      const filtered = level\n        ? _calls.filter((c) => c.level.toLowerCase() === level.toLowerCase())\n        : _calls;\n      return filtered[filtered.length - 1];\n    },\n\n    expectLog(level: string, matcher?: LogMatcher): void {\n      const levelCalls = instance.getCalls(level);\n      const matched = levelCalls.some((c) => matchesCall(c, matcher));\n      if (!matched) {\n        const matcherDesc = formatMatcherDescription(matcher);\n        throw new Error(\n          `Expected at least one [${level}] log matching ${matcherDesc}.\\n` +\n            `Recorded calls:\\n${formatCalls(_calls)}`\n        );\n      }\n    },\n\n    expectNoLog(level: string, matcher?: LogMatcher): void {\n      const levelCalls = instance.getCalls(level);\n      const matched = levelCalls.some((c) => matchesCall(c, matcher));\n      if (matched) {\n        const matcherDesc = formatMatcherDescription(matcher);\n        throw new Error(\n          `Expected NO [${level}] log matching ${matcherDesc}, but one was found.\\n` +\n            `Recorded calls:\\n${formatCalls(_calls)}`\n        );\n      }\n    },\n\n    reset(): void {\n      _calls.length = 0;\n    },\n\n    silent,\n  };\n\n  return instance;\n}\n"],"mappings":"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"}
+{"version":3,"file":"testing.js","names":[],"sources":["../src/testing/mock-logger.ts"],"sourcesContent":["/**\n * logixia/testing — Zero-dependency mock logger for Vitest & Jest.\n *\n * @example\n * ```ts\n * import { createMockLogger } from 'logixia/testing';\n *\n * const mock = createMockLogger();\n * await myService.doSomething(mock.logger);\n *\n * mock.expectLog('info', { message: 'order created' });\n * mock.expectLog('error', { message: /failed/ });\n * mock.reset();\n * ```\n */\n\nimport type { LogEntry, LogixiaLoggerInstance, NamespaceLevels } from '../types';\n\n// ── Types ────────────────────────────────────────────────────────────────────\n\nexport interface MockLogCall {\n  level: string;\n  message: string;\n  data?: Record<string, unknown>;\n  /** Full LogEntry shape for assertions that inspect the complete record. */\n  entry: Pick<LogEntry, 'level' | 'message' | 'context'> & { data?: Record<string, unknown> };\n}\n\nexport type LogMatcher =\n  | string\n  | RegExp\n  | ((call: MockLogCall) => boolean)\n  | Partial<Record<'message' | 'level' | string, unknown>>;\n\nexport interface MockLoggerInstance {\n  /** The logger itself — pass this where an IBaseLogger or ILogger is expected. */\n  readonly logger: LogixiaLoggerInstance;\n  /** Every call recorded across all levels, in insertion order. */\n  readonly calls: MockLogCall[];\n  /**\n   * Get all calls for a specific level (case-insensitive). If `level` is\n   * omitted, returns all calls across every level.\n   */\n  getCalls(level?: string): MockLogCall[];\n  /** Return the most recent call, optionally filtered by level. */\n  getLastCall(level?: string): MockLogCall | undefined;\n  /**\n   * Assert that at least one recorded call matches `matcher`.\n   *\n   * - string → exact message match\n   * - RegExp → message test\n   * - function → receives the full MockLogCall\n   * - object → every key/value must match (supports RegExp values)\n   *\n   * Throws an Error with a descriptive message if the assertion fails (works\n   * with both Vitest `expect` and Jest matchers via `.toThrow()`, or you can\n   * let it propagate directly).\n   */\n  expectLog(level: string, matcher?: LogMatcher): void;\n  /**\n   * Assert that NO recorded call matches `matcher` at the given level.\n   */\n  expectNoLog(level: string, matcher?: LogMatcher): void;\n  /** Clear all recorded calls. Call between tests. */\n  reset(): void;\n  /**\n   * Make `logger.healthCheck()` report healthy or unhealthy, to exercise code that\n   * reacts to a failing logger. Shared with child loggers.\n   */\n  setHealth(healthy: boolean, details?: Record<string, unknown>): void;\n  /**\n   * Silence — when true, the mock suppresses all console output from the\n   * logger. Default: true.\n   */\n  silent: boolean;\n}\n\n// ── Helpers ──────────────────────────────────────────────────────────────────\n\nfunction resolveCallField(call: MockLogCall, key: string): unknown {\n  if (key === 'message') return call.message;\n  if (key === 'level') return call.level;\n  return call.data?.[key] ?? (call.entry as Record<string, unknown>)[key];\n}\n\nfunction formatMatcherDescription(matcher: LogMatcher | undefined): string {\n  if (matcher === undefined) return '(any)';\n  if (matcher instanceof RegExp) return matcher.toString();\n  return JSON.stringify(matcher);\n}\n\nfunction matchesCall(call: MockLogCall, matcher?: LogMatcher): boolean {\n  if (matcher === undefined) return true;\n  if (typeof matcher === 'string') return call.message === matcher;\n  if (matcher instanceof RegExp) return matcher.test(call.message);\n  if (typeof matcher === 'function') return matcher(call);\n  // Object shape: every key/value must match\n  for (const [key, expected] of Object.entries(matcher)) {\n    const actual = resolveCallField(call, key);\n    if (expected instanceof RegExp) {\n      if (!expected.test(String(actual ?? ''))) return false;\n    } else {\n      if (actual !== expected) return false;\n    }\n  }\n  return true;\n}\n\nfunction formatCalls(calls: MockLogCall[]): string {\n  if (calls.length === 0) return '  (no calls recorded)';\n  return calls\n    .map((c) => `  [${c.level}] \"${c.message}\" ${c.data ? JSON.stringify(c.data) : ''}`)\n    .join('\\n');\n}\n\n// ── Implementation ────────────────────────────────────────────────────────────\n\n/**\n * Create a mock logger for use in tests.\n *\n * The returned object implements `ILogger` and additionally exposes `.calls`,\n * `.getCalls()`, `.getLastCall()`, `.expectLog()`, `.expectNoLog()`, and `.reset()`.\n *\n * @param options.silent  Suppress console output (default: true)\n * @param options.context Optional context label written into every `entry.context`\n * @param options.healthy Initial `healthCheck()` result (default: true); change later with `setHealth()`\n */\nexport function createMockLogger(\n  options: { silent?: boolean; context?: string; healthy?: boolean } = {}\n): MockLoggerInstance {\n  return buildMockLogger(options, {\n    namespaceLevels: {},\n    health: { healthy: options.healthy ?? true, details: {} },\n  });\n}\n\n/** State a mock logger shares with its children, like the real logger. */\ninterface SharedMockState {\n  namespaceLevels: NamespaceLevels;\n  health: { healthy: boolean; details: Record<string, unknown> };\n}\n\nfunction buildMockLogger(\n  options: { silent?: boolean; context?: string },\n  shared: SharedMockState\n): MockLoggerInstance {\n  const { silent = true, context } = options;\n  const _calls: MockLogCall[] = [];\n\n  function record(\n    level: string,\n    messageOrError: string | Error,\n    data?: Record<string, unknown>\n  ): void {\n    const message = messageOrError instanceof Error ? messageOrError.message : messageOrError;\n    const extraData =\n      messageOrError instanceof Error\n        ? { ...data, error: { message: messageOrError.message, stack: messageOrError.stack } }\n        : data;\n\n    _calls.push({\n      level,\n      message,\n      ...(extraData !== undefined ? { data: extraData } : {}),\n      entry: {\n        level,\n        message,\n        ...(context !== undefined ? { context } : {}),\n        ...(extraData !== undefined ? { data: extraData } : {}),\n      },\n    });\n  }\n\n  const logger: LogixiaLoggerInstance = {\n    async error(messageOrError, data) {\n      record('error', messageOrError as string | Error, data);\n    },\n    async warn(message, data) {\n      record('warn', message, data);\n    },\n    async info(message, data) {\n      record('info', message, data);\n    },\n    async debug(message, data) {\n      record('debug', message, data);\n    },\n    async trace(message, data) {\n      record('trace', message, data);\n    },\n    async verbose(message, data) {\n      record('verbose', message, data);\n    },\n    async logLevel(level, message, data) {\n      record(level, message, data);\n    },\n\n    time(_label) {\n      /* no-op in tests */\n    },\n    async timeEnd(_label) {\n      return 0;\n    },\n    async timeAsync(_label, fn) {\n      return fn();\n    },\n\n    setLevel(_level) {\n      /* no-op */\n    },\n    getLevel() {\n      return 'info';\n    },\n    setNamespaceLevels(levels) {\n      shared.namespaceLevels = { ...levels };\n    },\n    patchNamespaceLevels(levels) {\n      shared.namespaceLevels = { ...shared.namespaceLevels, ...levels };\n    },\n    getNamespaceLevels() {\n      return { ...shared.namespaceLevels };\n    },\n    setContext(_ctx) {\n      /* no-op */\n    },\n    getContext() {\n      return context;\n    },\n\n    enableField(_f) {\n      /* no-op */\n    },\n    disableField(_f) {\n      /* no-op */\n    },\n    isFieldEnabled(_f) {\n      return true;\n    },\n    getFieldState() {\n      return {};\n    },\n    resetFieldState() {\n      /* no-op */\n    },\n\n    enableTransportLevelPrompting() {\n      /* no-op */\n    },\n    disableTransportLevelPrompting() {\n      /* no-op */\n    },\n    setTransportLevels(_id, _levels) {\n      /* no-op */\n    },\n    getTransportLevels(_id): string[] | undefined {\n      return undefined;\n    },\n    clearTransportLevelPreferences() {\n      /* no-op */\n    },\n    getAvailableTransports() {\n      return [];\n    },\n\n    child(ctx, _data) {\n      return buildMockLogger({ silent, context: ctx }, shared).logger;\n    },\n    async flush() {\n      /* no-op */\n    },\n    async healthCheck() {\n      return { healthy: shared.health.healthy, details: { ...shared.health.details } };\n    },\n    async close() {\n      /* no-op */\n    },\n\n    // Plugin API stubs — mock logger does not run plugins\n    use(_plugin) {\n      return this;\n    },\n    unuse(_pluginName) {\n      return this;\n    },\n  };\n\n  const instance: MockLoggerInstance = {\n    get logger() {\n      return logger;\n    },\n    get calls() {\n      return _calls;\n    },\n\n    getCalls(level?: string): MockLogCall[] {\n      if (!level) return [..._calls];\n      const l = level.toLowerCase();\n      return _calls.filter((c) => c.level.toLowerCase() === l);\n    },\n\n    getLastCall(level?: string): MockLogCall | undefined {\n      const filtered = level\n        ? _calls.filter((c) => c.level.toLowerCase() === level.toLowerCase())\n        : _calls;\n      return filtered[filtered.length - 1];\n    },\n\n    expectLog(level: string, matcher?: LogMatcher): void {\n      const levelCalls = instance.getCalls(level);\n      const matched = levelCalls.some((c) => matchesCall(c, matcher));\n      if (!matched) {\n        const matcherDesc = formatMatcherDescription(matcher);\n        throw new Error(\n          `Expected at least one [${level}] log matching ${matcherDesc}.\\n` +\n            `Recorded calls:\\n${formatCalls(_calls)}`\n        );\n      }\n    },\n\n    expectNoLog(level: string, matcher?: LogMatcher): void {\n      const levelCalls = instance.getCalls(level);\n      const matched = levelCalls.some((c) => matchesCall(c, matcher));\n      if (matched) {\n        const matcherDesc = formatMatcherDescription(matcher);\n        throw new Error(\n          `Expected NO [${level}] log matching ${matcherDesc}, but one was found.\\n` +\n            `Recorded calls:\\n${formatCalls(_calls)}`\n        );\n      }\n    },\n\n    reset(): void {\n      _calls.length = 0;\n    },\n\n    setHealth(healthy: boolean, details: Record<string, unknown> = {}): void {\n      shared.health = { healthy, details };\n    },\n\n    silent,\n  };\n\n  return instance;\n}\n"],"mappings":"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"}

package/dist/testing.mjs

@@ -1,4 +1,4 @@
-//#region src/testing/mock-logger.ts
+// src/testing/mock-logger.ts
 function resolveCallField(call, key) {
 	var _call$data;
 	if (key === "message") return call.message;
@@ -30,13 +30,23 @@ function formatCalls(calls) {
 /**
 * Create a mock logger for use in tests.
 *
-* The returned object implements `IBaseLogger` and additionally exposes `.calls`,
+* The returned object implements `ILogger` and additionally exposes `.calls`,
 * `.getCalls()`, `.getLastCall()`, `.expectLog()`, `.expectNoLog()`, and `.reset()`.
 *
 * @param options.silent  Suppress console output (default: true)
 * @param options.context Optional context label written into every `entry.context`
+* @param options.healthy Initial `healthCheck()` result (default: true); change later with `setHealth()`
 */
 function createMockLogger(options = {}) {
+	return buildMockLogger(options, {
+		namespaceLevels: {},
+		health: {
+			healthy: options.healthy ?? true,
+			details: {}
+		}
+	});
+}
+function buildMockLogger(options, shared) {
 	const { silent = true, context } = options;
 	const _calls = [];
 	function record(level, messageOrError, data) {
@@ -93,6 +103,18 @@ function createMockLogger(options = {}) {
 		getLevel() {
 			return "info";
 		},
+		setNamespaceLevels(levels) {
+			shared.namespaceLevels = { ...levels };
+		},
+		patchNamespaceLevels(levels) {
+			shared.namespaceLevels = {
+				...shared.namespaceLevels,
+				...levels
+			};
+		},
+		getNamespaceLevels() {
+			return { ...shared.namespaceLevels };
+		},
 		setContext(_ctx) {},
 		getContext() {
 			return context;
@@ -115,10 +137,17 @@ function createMockLogger(options = {}) {
 			return [];
 		},
 		child(ctx, _data) {
-			return createMockLogger({
+			return buildMockLogger({
 				silent,
 				context: ctx
-			}).logger;
+			}, shared).logger;
+		},
+		async flush() {},
+		async healthCheck() {
+			return {
+				healthy: shared.health.healthy,
+				details: { ...shared.health.details }
+			};
 		},
 		async close() {},
 		use(_plugin) {
@@ -159,11 +188,16 @@ function createMockLogger(options = {}) {
 		reset() {
 			_calls.length = 0;
 		},
+		setHealth(healthy, details = {}) {
+			shared.health = {
+				healthy,
+				details
+			};
+		},
 		silent
 	};
 	return instance;
 }
-
-//#endregion
 export { createMockLogger };
+
 //# sourceMappingURL=testing.mjs.map

package/dist/testing.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"testing.mjs","names":["_calls: MockLogCall[]","logger: IBaseLogger","instance: MockLoggerInstance"],"sources":["../src/testing/mock-logger.ts"],"sourcesContent":["/**\n * logixia/testing — Zero-dependency mock logger for Vitest & Jest.\n *\n * @example\n * ```ts\n * import { createMockLogger } from 'logixia/testing';\n *\n * const mock = createMockLogger();\n * await myService.doSomething(mock.logger);\n *\n * mock.expectLog('info', { message: 'order created' });\n * mock.expectLog('error', { message: /failed/ });\n * mock.reset();\n * ```\n */\n\nimport type { IBaseLogger, LogEntry } from '../types';\n\n// ── Types ────────────────────────────────────────────────────────────────────\n\nexport interface MockLogCall {\n  level: string;\n  message: string;\n  data?: Record<string, unknown>;\n  /** Full LogEntry shape for assertions that inspect the complete record. */\n  entry: Pick<LogEntry, 'level' | 'message' | 'context'> & { data?: Record<string, unknown> };\n}\n\nexport type LogMatcher =\n  | string\n  | RegExp\n  | ((call: MockLogCall) => boolean)\n  | Partial<Record<'message' | 'level' | string, unknown>>;\n\nexport interface MockLoggerInstance {\n  /** The logger itself — pass this where an IBaseLogger is expected. */\n  readonly logger: IBaseLogger;\n  /** Every call recorded across all levels, in insertion order. */\n  readonly calls: MockLogCall[];\n  /**\n   * Get all calls for a specific level (case-insensitive). If `level` is\n   * omitted, returns all calls across every level.\n   */\n  getCalls(level?: string): MockLogCall[];\n  /** Return the most recent call, optionally filtered by level. */\n  getLastCall(level?: string): MockLogCall | undefined;\n  /**\n   * Assert that at least one recorded call matches `matcher`.\n   *\n   * - string → exact message match\n   * - RegExp → message test\n   * - function → receives the full MockLogCall\n   * - object → every key/value must match (supports RegExp values)\n   *\n   * Throws an Error with a descriptive message if the assertion fails (works\n   * with both Vitest `expect` and Jest matchers via `.toThrow()`, or you can\n   * let it propagate directly).\n   */\n  expectLog(level: string, matcher?: LogMatcher): void;\n  /**\n   * Assert that NO recorded call matches `matcher` at the given level.\n   */\n  expectNoLog(level: string, matcher?: LogMatcher): void;\n  /** Clear all recorded calls. Call between tests. */\n  reset(): void;\n  /**\n   * Silence — when true, the mock suppresses all console output from the\n   * logger. Default: true.\n   */\n  silent: boolean;\n}\n\n// ── Helpers ──────────────────────────────────────────────────────────────────\n\nfunction resolveCallField(call: MockLogCall, key: string): unknown {\n  if (key === 'message') return call.message;\n  if (key === 'level') return call.level;\n  return call.data?.[key] ?? (call.entry as Record<string, unknown>)[key];\n}\n\nfunction formatMatcherDescription(matcher: LogMatcher | undefined): string {\n  if (matcher === undefined) return '(any)';\n  if (matcher instanceof RegExp) return matcher.toString();\n  return JSON.stringify(matcher);\n}\n\nfunction matchesCall(call: MockLogCall, matcher?: LogMatcher): boolean {\n  if (matcher === undefined) return true;\n  if (typeof matcher === 'string') return call.message === matcher;\n  if (matcher instanceof RegExp) return matcher.test(call.message);\n  if (typeof matcher === 'function') return matcher(call);\n  // Object shape: every key/value must match\n  for (const [key, expected] of Object.entries(matcher)) {\n    const actual = resolveCallField(call, key);\n    if (expected instanceof RegExp) {\n      if (!expected.test(String(actual ?? ''))) return false;\n    } else {\n      if (actual !== expected) return false;\n    }\n  }\n  return true;\n}\n\nfunction formatCalls(calls: MockLogCall[]): string {\n  if (calls.length === 0) return '  (no calls recorded)';\n  return calls\n    .map((c) => `  [${c.level}] \"${c.message}\" ${c.data ? JSON.stringify(c.data) : ''}`)\n    .join('\\n');\n}\n\n// ── Implementation ────────────────────────────────────────────────────────────\n\n/**\n * Create a mock logger for use in tests.\n *\n * The returned object implements `IBaseLogger` and additionally exposes `.calls`,\n * `.getCalls()`, `.getLastCall()`, `.expectLog()`, `.expectNoLog()`, and `.reset()`.\n *\n * @param options.silent  Suppress console output (default: true)\n * @param options.context Optional context label written into every `entry.context`\n */\nexport function createMockLogger(\n  options: { silent?: boolean; context?: string } = {}\n): MockLoggerInstance {\n  const { silent = true, context } = options;\n  const _calls: MockLogCall[] = [];\n\n  function record(\n    level: string,\n    messageOrError: string | Error,\n    data?: Record<string, unknown>\n  ): void {\n    const message = messageOrError instanceof Error ? messageOrError.message : messageOrError;\n    const extraData =\n      messageOrError instanceof Error\n        ? { ...data, error: { message: messageOrError.message, stack: messageOrError.stack } }\n        : data;\n\n    _calls.push({\n      level,\n      message,\n      ...(extraData !== undefined ? { data: extraData } : {}),\n      entry: {\n        level,\n        message,\n        ...(context !== undefined ? { context } : {}),\n        ...(extraData !== undefined ? { data: extraData } : {}),\n      },\n    });\n  }\n\n  const logger: IBaseLogger = {\n    async error(messageOrError, data) {\n      record('error', messageOrError as string | Error, data);\n    },\n    async warn(message, data) {\n      record('warn', message, data);\n    },\n    async info(message, data) {\n      record('info', message, data);\n    },\n    async debug(message, data) {\n      record('debug', message, data);\n    },\n    async trace(message, data) {\n      record('trace', message, data);\n    },\n    async verbose(message, data) {\n      record('verbose', message, data);\n    },\n    async logLevel(level, message, data) {\n      record(level, message, data);\n    },\n\n    time(_label) {\n      /* no-op in tests */\n    },\n    async timeEnd(_label) {\n      return 0;\n    },\n    async timeAsync(_label, fn) {\n      return fn();\n    },\n\n    setLevel(_level) {\n      /* no-op */\n    },\n    getLevel() {\n      return 'info';\n    },\n    setContext(_ctx) {\n      /* no-op */\n    },\n    getContext() {\n      return context;\n    },\n\n    enableField(_f) {\n      /* no-op */\n    },\n    disableField(_f) {\n      /* no-op */\n    },\n    isFieldEnabled(_f) {\n      return true;\n    },\n    getFieldState() {\n      return {};\n    },\n    resetFieldState() {\n      /* no-op */\n    },\n\n    enableTransportLevelPrompting() {\n      /* no-op */\n    },\n    disableTransportLevelPrompting() {\n      /* no-op */\n    },\n    setTransportLevels(_id, _levels) {\n      /* no-op */\n    },\n    getTransportLevels(_id): string[] | undefined {\n      return undefined;\n    },\n    clearTransportLevelPreferences() {\n      /* no-op */\n    },\n    getAvailableTransports() {\n      return [];\n    },\n\n    child(ctx, _data) {\n      return createMockLogger({ silent, context: ctx }).logger;\n    },\n    async close() {\n      /* no-op */\n    },\n\n    // Plugin API stubs — mock logger does not run plugins\n    use(_plugin) {\n      return this;\n    },\n    unuse(_pluginName) {\n      return this;\n    },\n  };\n\n  const instance: MockLoggerInstance = {\n    get logger() {\n      return logger;\n    },\n    get calls() {\n      return _calls;\n    },\n\n    getCalls(level?: string): MockLogCall[] {\n      if (!level) return [..._calls];\n      const l = level.toLowerCase();\n      return _calls.filter((c) => c.level.toLowerCase() === l);\n    },\n\n    getLastCall(level?: string): MockLogCall | undefined {\n      const filtered = level\n        ? _calls.filter((c) => c.level.toLowerCase() === level.toLowerCase())\n        : _calls;\n      return filtered[filtered.length - 1];\n    },\n\n    expectLog(level: string, matcher?: LogMatcher): void {\n      const levelCalls = instance.getCalls(level);\n      const matched = levelCalls.some((c) => matchesCall(c, matcher));\n      if (!matched) {\n        const matcherDesc = formatMatcherDescription(matcher);\n        throw new Error(\n          `Expected at least one [${level}] log matching ${matcherDesc}.\\n` +\n            `Recorded calls:\\n${formatCalls(_calls)}`\n        );\n      }\n    },\n\n    expectNoLog(level: string, matcher?: LogMatcher): void {\n      const levelCalls = instance.getCalls(level);\n      const matched = levelCalls.some((c) => matchesCall(c, matcher));\n      if (matched) {\n        const matcherDesc = formatMatcherDescription(matcher);\n        throw new Error(\n          `Expected NO [${level}] log matching ${matcherDesc}, but one was found.\\n` +\n            `Recorded calls:\\n${formatCalls(_calls)}`\n        );\n      }\n    },\n\n    reset(): void {\n      _calls.length = 0;\n    },\n\n    silent,\n  };\n\n  return instance;\n}\n"],"mappings":"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"}
+{"version":3,"file":"testing.mjs","names":[],"sources":["../src/testing/mock-logger.ts"],"sourcesContent":["/**\n * logixia/testing — Zero-dependency mock logger for Vitest & Jest.\n *\n * @example\n * ```ts\n * import { createMockLogger } from 'logixia/testing';\n *\n * const mock = createMockLogger();\n * await myService.doSomething(mock.logger);\n *\n * mock.expectLog('info', { message: 'order created' });\n * mock.expectLog('error', { message: /failed/ });\n * mock.reset();\n * ```\n */\n\nimport type { LogEntry, LogixiaLoggerInstance, NamespaceLevels } from '../types';\n\n// ── Types ────────────────────────────────────────────────────────────────────\n\nexport interface MockLogCall {\n  level: string;\n  message: string;\n  data?: Record<string, unknown>;\n  /** Full LogEntry shape for assertions that inspect the complete record. */\n  entry: Pick<LogEntry, 'level' | 'message' | 'context'> & { data?: Record<string, unknown> };\n}\n\nexport type LogMatcher =\n  | string\n  | RegExp\n  | ((call: MockLogCall) => boolean)\n  | Partial<Record<'message' | 'level' | string, unknown>>;\n\nexport interface MockLoggerInstance {\n  /** The logger itself — pass this where an IBaseLogger or ILogger is expected. */\n  readonly logger: LogixiaLoggerInstance;\n  /** Every call recorded across all levels, in insertion order. */\n  readonly calls: MockLogCall[];\n  /**\n   * Get all calls for a specific level (case-insensitive). If `level` is\n   * omitted, returns all calls across every level.\n   */\n  getCalls(level?: string): MockLogCall[];\n  /** Return the most recent call, optionally filtered by level. */\n  getLastCall(level?: string): MockLogCall | undefined;\n  /**\n   * Assert that at least one recorded call matches `matcher`.\n   *\n   * - string → exact message match\n   * - RegExp → message test\n   * - function → receives the full MockLogCall\n   * - object → every key/value must match (supports RegExp values)\n   *\n   * Throws an Error with a descriptive message if the assertion fails (works\n   * with both Vitest `expect` and Jest matchers via `.toThrow()`, or you can\n   * let it propagate directly).\n   */\n  expectLog(level: string, matcher?: LogMatcher): void;\n  /**\n   * Assert that NO recorded call matches `matcher` at the given level.\n   */\n  expectNoLog(level: string, matcher?: LogMatcher): void;\n  /** Clear all recorded calls. Call between tests. */\n  reset(): void;\n  /**\n   * Make `logger.healthCheck()` report healthy or unhealthy, to exercise code that\n   * reacts to a failing logger. Shared with child loggers.\n   */\n  setHealth(healthy: boolean, details?: Record<string, unknown>): void;\n  /**\n   * Silence — when true, the mock suppresses all console output from the\n   * logger. Default: true.\n   */\n  silent: boolean;\n}\n\n// ── Helpers ──────────────────────────────────────────────────────────────────\n\nfunction resolveCallField(call: MockLogCall, key: string): unknown {\n  if (key === 'message') return call.message;\n  if (key === 'level') return call.level;\n  return call.data?.[key] ?? (call.entry as Record<string, unknown>)[key];\n}\n\nfunction formatMatcherDescription(matcher: LogMatcher | undefined): string {\n  if (matcher === undefined) return '(any)';\n  if (matcher instanceof RegExp) return matcher.toString();\n  return JSON.stringify(matcher);\n}\n\nfunction matchesCall(call: MockLogCall, matcher?: LogMatcher): boolean {\n  if (matcher === undefined) return true;\n  if (typeof matcher === 'string') return call.message === matcher;\n  if (matcher instanceof RegExp) return matcher.test(call.message);\n  if (typeof matcher === 'function') return matcher(call);\n  // Object shape: every key/value must match\n  for (const [key, expected] of Object.entries(matcher)) {\n    const actual = resolveCallField(call, key);\n    if (expected instanceof RegExp) {\n      if (!expected.test(String(actual ?? ''))) return false;\n    } else {\n      if (actual !== expected) return false;\n    }\n  }\n  return true;\n}\n\nfunction formatCalls(calls: MockLogCall[]): string {\n  if (calls.length === 0) return '  (no calls recorded)';\n  return calls\n    .map((c) => `  [${c.level}] \"${c.message}\" ${c.data ? JSON.stringify(c.data) : ''}`)\n    .join('\\n');\n}\n\n// ── Implementation ────────────────────────────────────────────────────────────\n\n/**\n * Create a mock logger for use in tests.\n *\n * The returned object implements `ILogger` and additionally exposes `.calls`,\n * `.getCalls()`, `.getLastCall()`, `.expectLog()`, `.expectNoLog()`, and `.reset()`.\n *\n * @param options.silent  Suppress console output (default: true)\n * @param options.context Optional context label written into every `entry.context`\n * @param options.healthy Initial `healthCheck()` result (default: true); change later with `setHealth()`\n */\nexport function createMockLogger(\n  options: { silent?: boolean; context?: string; healthy?: boolean } = {}\n): MockLoggerInstance {\n  return buildMockLogger(options, {\n    namespaceLevels: {},\n    health: { healthy: options.healthy ?? true, details: {} },\n  });\n}\n\n/** State a mock logger shares with its children, like the real logger. */\ninterface SharedMockState {\n  namespaceLevels: NamespaceLevels;\n  health: { healthy: boolean; details: Record<string, unknown> };\n}\n\nfunction buildMockLogger(\n  options: { silent?: boolean; context?: string },\n  shared: SharedMockState\n): MockLoggerInstance {\n  const { silent = true, context } = options;\n  const _calls: MockLogCall[] = [];\n\n  function record(\n    level: string,\n    messageOrError: string | Error,\n    data?: Record<string, unknown>\n  ): void {\n    const message = messageOrError instanceof Error ? messageOrError.message : messageOrError;\n    const extraData =\n      messageOrError instanceof Error\n        ? { ...data, error: { message: messageOrError.message, stack: messageOrError.stack } }\n        : data;\n\n    _calls.push({\n      level,\n      message,\n      ...(extraData !== undefined ? { data: extraData } : {}),\n      entry: {\n        level,\n        message,\n        ...(context !== undefined ? { context } : {}),\n        ...(extraData !== undefined ? { data: extraData } : {}),\n      },\n    });\n  }\n\n  const logger: LogixiaLoggerInstance = {\n    async error(messageOrError, data) {\n      record('error', messageOrError as string | Error, data);\n    },\n    async warn(message, data) {\n      record('warn', message, data);\n    },\n    async info(message, data) {\n      record('info', message, data);\n    },\n    async debug(message, data) {\n      record('debug', message, data);\n    },\n    async trace(message, data) {\n      record('trace', message, data);\n    },\n    async verbose(message, data) {\n      record('verbose', message, data);\n    },\n    async logLevel(level, message, data) {\n      record(level, message, data);\n    },\n\n    time(_label) {\n      /* no-op in tests */\n    },\n    async timeEnd(_label) {\n      return 0;\n    },\n    async timeAsync(_label, fn) {\n      return fn();\n    },\n\n    setLevel(_level) {\n      /* no-op */\n    },\n    getLevel() {\n      return 'info';\n    },\n    setNamespaceLevels(levels) {\n      shared.namespaceLevels = { ...levels };\n    },\n    patchNamespaceLevels(levels) {\n      shared.namespaceLevels = { ...shared.namespaceLevels, ...levels };\n    },\n    getNamespaceLevels() {\n      return { ...shared.namespaceLevels };\n    },\n    setContext(_ctx) {\n      /* no-op */\n    },\n    getContext() {\n      return context;\n    },\n\n    enableField(_f) {\n      /* no-op */\n    },\n    disableField(_f) {\n      /* no-op */\n    },\n    isFieldEnabled(_f) {\n      return true;\n    },\n    getFieldState() {\n      return {};\n    },\n    resetFieldState() {\n      /* no-op */\n    },\n\n    enableTransportLevelPrompting() {\n      /* no-op */\n    },\n    disableTransportLevelPrompting() {\n      /* no-op */\n    },\n    setTransportLevels(_id, _levels) {\n      /* no-op */\n    },\n    getTransportLevels(_id): string[] | undefined {\n      return undefined;\n    },\n    clearTransportLevelPreferences() {\n      /* no-op */\n    },\n    getAvailableTransports() {\n      return [];\n    },\n\n    child(ctx, _data) {\n      return buildMockLogger({ silent, context: ctx }, shared).logger;\n    },\n    async flush() {\n      /* no-op */\n    },\n    async healthCheck() {\n      return { healthy: shared.health.healthy, details: { ...shared.health.details } };\n    },\n    async close() {\n      /* no-op */\n    },\n\n    // Plugin API stubs — mock logger does not run plugins\n    use(_plugin) {\n      return this;\n    },\n    unuse(_pluginName) {\n      return this;\n    },\n  };\n\n  const instance: MockLoggerInstance = {\n    get logger() {\n      return logger;\n    },\n    get calls() {\n      return _calls;\n    },\n\n    getCalls(level?: string): MockLogCall[] {\n      if (!level) return [..._calls];\n      const l = level.toLowerCase();\n      return _calls.filter((c) => c.level.toLowerCase() === l);\n    },\n\n    getLastCall(level?: string): MockLogCall | undefined {\n      const filtered = level\n        ? _calls.filter((c) => c.level.toLowerCase() === level.toLowerCase())\n        : _calls;\n      return filtered[filtered.length - 1];\n    },\n\n    expectLog(level: string, matcher?: LogMatcher): void {\n      const levelCalls = instance.getCalls(level);\n      const matched = levelCalls.some((c) => matchesCall(c, matcher));\n      if (!matched) {\n        const matcherDesc = formatMatcherDescription(matcher);\n        throw new Error(\n          `Expected at least one [${level}] log matching ${matcherDesc}.\\n` +\n            `Recorded calls:\\n${formatCalls(_calls)}`\n        );\n      }\n    },\n\n    expectNoLog(level: string, matcher?: LogMatcher): void {\n      const levelCalls = instance.getCalls(level);\n      const matched = levelCalls.some((c) => matchesCall(c, matcher));\n      if (matched) {\n        const matcherDesc = formatMatcherDescription(matcher);\n        throw new Error(\n          `Expected NO [${level}] log matching ${matcherDesc}, but one was found.\\n` +\n            `Recorded calls:\\n${formatCalls(_calls)}`\n        );\n      }\n    },\n\n    reset(): void {\n      _calls.length = 0;\n    },\n\n    setHealth(healthy: boolean, details: Record<string, unknown> = {}): void {\n      shared.health = { healthy, details };\n    },\n\n    silent,\n  };\n\n  return instance;\n}\n"],"mappings":"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"}

package/dist/{transport.types-CGoHpWQR.d.ts → transport.types-CzJq4IrF.d.mts}

@@ -1,4 +1,3 @@
-//#region src/types/transport.types.d.ts
 /**
  * Per-transport retry & failover configuration.
  */
@@ -106,7 +105,11 @@ interface ConsoleTransportConfig {
 }
 interface AnalyticsTransportConfig {
   level?: string;
-  apiKey: string;
+  /**
+   * @deprecated Not used by Mixpanel, Segment or Google Analytics (they use `token`,
+   * `writeKey` and `measurementId`/`apiSecret`). Only DataDog reads an API key.
+   */
+  apiKey?: string;
   projectId?: string;
   endpoint?: string;
   batchSize?: number;
@@ -128,6 +131,7 @@ interface MixpanelTransportConfig extends AnalyticsTransportConfig {
   superProperties?: Record<string, unknown>;
 }
 interface DataDogTransportConfig extends AnalyticsTransportConfig {
+  /** Datadog API key (sent as `DD-API-KEY`). Required. */
   apiKey: string;
   site?: 'datadoghq.com' | 'datadoghq.eu' | 'us3.datadoghq.com' | 'us5.datadoghq.com' | 'ap1.datadoghq.com' | 'ddog-gov.com';
   /** Gzip log request bodies (`Content-Encoding: gzip`). Default false. */
@@ -187,6 +191,12 @@ interface IAsyncTransport extends ITransport {
   flush(): Promise<void>;
   isReady?(): Promise<boolean>;
 }
+interface TransportEvents {
+  log: (entry: TransportLogEntry) => void;
+  error: (error: Error, transport: string) => void;
+  rotate: (oldFile: string, newFile: string) => void;
+  flush: (transport: string, count: number) => void;
+}
 interface IBatchTransport extends ITransport {
   readonly batchSize?: number;
   readonly flushInterval?: number;
@@ -202,6 +212,5 @@ interface TransportMetrics {
   lastWrite: Date;
   averageWriteTime: number;
 }
-//#endregion
-export { FileTransportConfig as a, IBatchTransport as c, SegmentTransportConfig as d, TransportConfig as f, DatabaseTransportConfig as i, ITransport as l, TransportMetrics as m, ConsoleTransportConfig as n, GoogleAnalyticsTransportConfig as o, TransportLogEntry as p, DataDogTransportConfig as r, IAsyncTransport as s, AnalyticsTransportConfig as t, MixpanelTransportConfig as u };
-//# sourceMappingURL=transport.types-CGoHpWQR.d.ts.map
+export { TransportLogEntry as _, DatabaseTransportConfig as a, TransportType as b, GoogleAnalyticsTransportConfig as c, ITransport as d, MixpanelTransportConfig as f, TransportEvents as g, TransportConfig as h, DataDogTransportConfig as i, IAsyncTransport as l, SegmentTransportConfig as m, AnalyticsTransportConfig as n, FileStats as o, RotationConfig as p, ConsoleTransportConfig as r, FileTransportConfig as s, AnalyticsConfig as t, IBatchTransport as u, TransportMetrics as v, TransportRetryConfig as y };
+//# sourceMappingURL=transport.types-CzJq4IrF.d.mts.map

package/dist/transport.types-CzJq4IrF.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.types-CzJq4IrF.d.mts","names":[],"sources":["../src/types/transport.types.ts"],"mappings":";;;UAKiB;EACf;EACA;EACA;EACA;EACA,WAAW;EACX,eAAe,OAAO,OAAO,OAAO;;UAGrB;EACf;EACA;;;;;EAKA,UAAU,OAAO;;;;;EAKjB,MAAM,OAAO,2BAA2B;EACxC,UAAU;EACV,QAAQ;;UAGO;EACf,WAAW;EACX;EACA;EACA,OAAO;EACP;EACA;EACA;EACA;;UAGe;EACf;EACA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;EACA;EACA;EACA;EACA;EACA,WAAW;;;;;;EAMX;;;;;;EAMA;EACA,UAAU,OAAO;;UAGF;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,UAAU,OAAO;;;;;EAKjB;;UAGe;EACf;EACA;EACA;EACA;;;;;;EAMA,cAAc;EACd,UAAU,OAAO;;UAGF;EACf;;;;;EAKA;EACA;EACA;EACA;EACA;EACA;EACA;;;;;EAKA;EACA,mBAAmB;EACnB,UAAU,OAAO;;UAGF,gCAAgC;EAC/C;EACA;EACA;EACA,kBAAkB;;UAGH,+BAA+B;;EAE9C;EACA;;EAQA;EACA;EACA;EACA;EACA;EACA;;EAEA;;UAGe,uCAAuC;EACtD;EACA;EACA;EACA;EACA;;UAGe,+BAA+B;EAC9C;EACA;;EAEA;EACA;EACA;EACA;EACA;;UAGe;EACf;EACA;EACA;EACA;;EAEA,gBAAgB,qBAAqB,OAAO;;UAG7B;EACf;EACA,SAAS;EACT,UAAU;;UAGK;EACf,UAAU;EACV,OAAO,sBAAsB;EAC7B,WAAW,0BAA0B;EACrC,YAAY;EACZ,SAAS;;UAGM;EACf,WAAW,0BAA0B;EACrC,UAAU,yBAAyB;EACnC,kBAAkB,iCAAiC;EACnD,UAAU,yBAAyB;;UAGpB,wBAAwB;EACvC,SAAS;EACT,YAAY;;UAGG;EACf,MAAM,OAAO;EACb,QAAQ,OAAO,OAAO;EACtB,SAAS,iBAAiB;EAC1B,QAAQ,mBAAmB;;UAGZ,wBAAwB;WAC9B;WACA;EACT,WAAW,OAAO;EAClB,SAAS;;KAGC;UAEK;EACf;EACA,MAAM;EACN;EACA;EACA,WAAW;EACX"}

package/dist/{transport.types-BMnurPcc.d.mts → transport.types-CzJq4IrF.d.ts}

@@ -1,4 +1,3 @@
-//#region src/types/transport.types.d.ts
 /**
  * Per-transport retry & failover configuration.
  */
@@ -106,7 +105,11 @@ interface ConsoleTransportConfig {
 }
 interface AnalyticsTransportConfig {
   level?: string;
-  apiKey: string;
+  /**
+   * @deprecated Not used by Mixpanel, Segment or Google Analytics (they use `token`,
+   * `writeKey` and `measurementId`/`apiSecret`). Only DataDog reads an API key.
+   */
+  apiKey?: string;
   projectId?: string;
   endpoint?: string;
   batchSize?: number;
@@ -128,6 +131,7 @@ interface MixpanelTransportConfig extends AnalyticsTransportConfig {
   superProperties?: Record<string, unknown>;
 }
 interface DataDogTransportConfig extends AnalyticsTransportConfig {
+  /** Datadog API key (sent as `DD-API-KEY`). Required. */
   apiKey: string;
   site?: 'datadoghq.com' | 'datadoghq.eu' | 'us3.datadoghq.com' | 'us5.datadoghq.com' | 'ap1.datadoghq.com' | 'ddog-gov.com';
   /** Gzip log request bodies (`Content-Encoding: gzip`). Default false. */
@@ -187,6 +191,12 @@ interface IAsyncTransport extends ITransport {
   flush(): Promise<void>;
   isReady?(): Promise<boolean>;
 }
+interface TransportEvents {
+  log: (entry: TransportLogEntry) => void;
+  error: (error: Error, transport: string) => void;
+  rotate: (oldFile: string, newFile: string) => void;
+  flush: (transport: string, count: number) => void;
+}
 interface IBatchTransport extends ITransport {
   readonly batchSize?: number;
   readonly flushInterval?: number;
@@ -202,6 +212,5 @@ interface TransportMetrics {
   lastWrite: Date;
   averageWriteTime: number;
 }
-//#endregion
-export { FileTransportConfig as a, IBatchTransport as c, SegmentTransportConfig as d, TransportConfig as f, DatabaseTransportConfig as i, ITransport as l, TransportMetrics as m, ConsoleTransportConfig as n, GoogleAnalyticsTransportConfig as o, TransportLogEntry as p, DataDogTransportConfig as r, IAsyncTransport as s, AnalyticsTransportConfig as t, MixpanelTransportConfig as u };
-//# sourceMappingURL=transport.types-BMnurPcc.d.mts.map
+export { TransportLogEntry as _, DatabaseTransportConfig as a, TransportType as b, GoogleAnalyticsTransportConfig as c, ITransport as d, MixpanelTransportConfig as f, TransportEvents as g, TransportConfig as h, DataDogTransportConfig as i, IAsyncTransport as l, SegmentTransportConfig as m, AnalyticsTransportConfig as n, FileStats as o, RotationConfig as p, ConsoleTransportConfig as r, FileTransportConfig as s, AnalyticsConfig as t, IBatchTransport as u, TransportMetrics as v, TransportRetryConfig as y };
+//# sourceMappingURL=transport.types-CzJq4IrF.d.ts.map

package/dist/transport.types-CzJq4IrF.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.types-CzJq4IrF.d.ts","names":[],"sources":["../src/types/transport.types.ts"],"mappings":";;;UAKiB;EACf;EACA;EACA;EACA;EACA,WAAW;EACX,eAAe,OAAO,OAAO,OAAO;;UAGrB;EACf;EACA;;;;;EAKA,UAAU,OAAO;;;;;EAKjB,MAAM,OAAO,2BAA2B;EACxC,UAAU;EACV,QAAQ;;UAGO;EACf,WAAW;EACX;EACA;EACA,OAAO;EACP;EACA;EACA;EACA;;UAGe;EACf;EACA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;EACA;EACA;EACA;EACA;EACA,WAAW;;;;;;EAMX;;;;;;EAMA;EACA,UAAU,OAAO;;UAGF;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,UAAU,OAAO;;;;;EAKjB;;UAGe;EACf;EACA;EACA;EACA;;;;;;EAMA,cAAc;EACd,UAAU,OAAO;;UAGF;EACf;;;;;EAKA;EACA;EACA;EACA;EACA;EACA;EACA;;;;;EAKA;EACA,mBAAmB;EACnB,UAAU,OAAO;;UAGF,gCAAgC;EAC/C;EACA;EACA;EACA,kBAAkB;;UAGH,+BAA+B;;EAE9C;EACA;;EAQA;EACA;EACA;EACA;EACA;EACA;;EAEA;;UAGe,uCAAuC;EACtD;EACA;EACA;EACA;EACA;;UAGe,+BAA+B;EAC9C;EACA;;EAEA;EACA;EACA;EACA;EACA;;UAGe;EACf;EACA;EACA;EACA;;EAEA,gBAAgB,qBAAqB,OAAO;;UAG7B;EACf;EACA,SAAS;EACT,UAAU;;UAGK;EACf,UAAU;EACV,OAAO,sBAAsB;EAC7B,WAAW,0BAA0B;EACrC,YAAY;EACZ,SAAS;;UAGM;EACf,WAAW,0BAA0B;EACrC,UAAU,yBAAyB;EACnC,kBAAkB,iCAAiC;EACnD,UAAU,yBAAyB;;UAGpB,wBAAwB;EACvC,SAAS;EACT,YAAY;;UAGG;EACf,MAAM,OAAO;EACb,QAAQ,OAAO,OAAO;EACtB,SAAS,iBAAiB;EAC1B,QAAQ,mBAAmB;;UAGZ,wBAAwB;WAC9B;WACA;EACT,WAAW,OAAO;EAClB,SAAS;;KAGC;UAEK;EACf;EACA,MAAM;EACN;EACA;EACA,WAAW;EACX"}