logixia 2.0.4 → 2.0.6

package/dist/testing.d.mts

@@ -1,4 +1,4 @@
-import { h as LogEntry, u as IBaseLogger } from "./index-xqaJtAZn.mjs";
+import { C as LogixiaLoggerInstance, g as LogEntry } from "./index-BSTtFcQ6.mjs";
 interface MockLogCall {
   level: string;
   message: string;
@@ -10,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[];
   /**
@@ -40,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.
@@ -49,15 +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()`
  */
 export declare function createMockLogger(options?: {
   silent?: boolean;
   context?: string;
+  healthy?: boolean;
 }): MockLoggerInstance;
 export type { LogMatcher, MockLogCall, MockLoggerInstance };
 //# sourceMappingURL=testing.d.mts.map

package/dist/testing.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"testing.d.mts","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;;;;;;;;;;;wBAoDc,iBACd;EAAW;EAAkB;IAC5B"}
+{"version":3,"file":"testing.d.mts","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.d.ts

@@ -1,4 +1,4 @@
-import { h as LogEntry, u as IBaseLogger } from "./index-DwozbmB4.js";
+import { C as LogixiaLoggerInstance, g as LogEntry } from "./index-CFDGkI8n.js";
 interface MockLogCall {
   level: string;
   message: string;
@@ -10,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[];
   /**
@@ -40,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.
@@ -49,15 +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()`
  */
 export declare function createMockLogger(options?: {
   silent?: boolean;
   context?: string;
+  healthy?: boolean;
 }): MockLoggerInstance;
 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"],"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;;;;;;;;;;;wBAoDc,iBACd;EAAW;EAAkB;IAC5B"}
+{"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

@@ -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,6 +189,12 @@ function createMockLogger(options = {}) {
 		reset() {
 			_calls.length = 0;
 		},
+		setHealth(healthy, details = {}) {
+			shared.health = {
+				healthy,
+				details
+			};
+		},
 		silent
 	};
 	return instance;

package/dist/testing.js.map

@@ -1 +1 @@
-{"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 { 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

@@ -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,6 +188,12 @@ function createMockLogger(options = {}) {
 		reset() {
 			_calls.length = 0;
 		},
+		setHealth(healthy, details = {}) {
+			shared.health = {
+				healthy,
+				details
+			};
+		},
 		silent
 	};
 	return instance;

package/dist/testing.mjs.map

@@ -1 +1 @@
-{"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 { 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":";AA0EA,SAAS,iBAAiB,MAAmB,KAAsB;;CACjE,IAAI,QAAQ,WAAW,OAAO,KAAK;CACnC,IAAI,QAAQ,SAAS,OAAO,KAAK;CACjC,SAAA,aAAO,KAAK,UAAA,QAAA,eAAA,KAAA,IAAA,KAAA,IAAA,WAAO,SAAS,KAAK,MAAkC;AACrE;AAEA,SAAS,yBAAyB,SAAyC;CACzE,IAAI,YAAY,KAAA,GAAW,OAAO;CAClC,IAAI,mBAAmB,QAAQ,OAAO,QAAQ,SAAS;CACvD,OAAO,KAAK,UAAU,OAAO;AAC/B;AAEA,SAAS,YAAY,MAAmB,SAA+B;CACrE,IAAI,YAAY,KAAA,GAAW,OAAO;CAClC,IAAI,OAAO,YAAY,UAAU,OAAO,KAAK,YAAY;CACzD,IAAI,mBAAmB,QAAQ,OAAO,QAAQ,KAAK,KAAK,OAAO;CAC/D,IAAI,OAAO,YAAY,YAAY,OAAO,QAAQ,IAAI;CAEtD,KAAK,MAAM,CAAC,KAAK,aAAa,OAAO,QAAQ,OAAO,GAAG;EACrD,MAAM,SAAS,iBAAiB,MAAM,GAAG;EACzC,IAAI,oBAAoB,QAClB;OAAA,CAAC,SAAS,KAAK,OAAO,UAAU,EAAE,CAAC,GAAG,OAAO;EAAA,OAEjD,IAAI,WAAW,UAAU,OAAO;CAEpC;CACA,OAAO;AACT;AAEA,SAAS,YAAY,OAA8B;CACjD,IAAI,MAAM,WAAW,GAAG,OAAO;CAC/B,OAAO,MACJ,KAAK,MAAM,MAAM,EAAE,MAAM,KAAK,EAAE,QAAQ,IAAI,EAAE,OAAO,KAAK,UAAU,EAAE,IAAI,IAAI,IAAI,CAAC,CACnF,KAAK,IAAI;AACd;;;;;;;;;;AAaA,SAAgB,iBACd,UAAkD,CAAC,GAC/B;CACpB,MAAM,EAAE,SAAS,MAAM,YAAY;CACnC,MAAM,SAAwB,CAAC;CAE/B,SAAS,OACP,OACA,gBACA,MACM;EACN,MAAM,UAAU,0BAA0B,QAAQ,eAAe,UAAU;EAC3E,MAAM,YACJ,0BAA0B,QACtB;GAAE,GAAG;GAAM,OAAO;IAAE,SAAS,eAAe;IAAS,OAAO,eAAe;GAAM;EAAE,IACnF;EAEN,OAAO,KAAK;GACV;GACA;GACA,GAAI,cAAc,KAAA,IAAY,EAAE,MAAM,UAAU,IAAI,CAAC;GACrD,OAAO;IACL;IACA;IACA,GAAI,YAAY,KAAA,IAAY,EAAE,QAAQ,IAAI,CAAC;IAC3C,GAAI,cAAc,KAAA,IAAY,EAAE,MAAM,UAAU,IAAI,CAAC;GACvD;EACF,CAAC;CACH;CAEA,MAAM,SAAsB;EAC1B,MAAM,MAAM,gBAAgB,MAAM;GAChC,OAAO,SAAS,gBAAkC,IAAI;EACxD;EACA,MAAM,KAAK,SAAS,MAAM;GACxB,OAAO,QAAQ,SAAS,IAAI;EAC9B;EACA,MAAM,KAAK,SAAS,MAAM;GACxB,OAAO,QAAQ,SAAS,IAAI;EAC9B;EACA,MAAM,MAAM,SAAS,MAAM;GACzB,OAAO,SAAS,SAAS,IAAI;EAC/B;EACA,MAAM,MAAM,SAAS,MAAM;GACzB,OAAO,SAAS,SAAS,IAAI;EAC/B;EACA,MAAM,QAAQ,SAAS,MAAM;GAC3B,OAAO,WAAW,SAAS,IAAI;EACjC;EACA,MAAM,SAAS,OAAO,SAAS,MAAM;GACnC,OAAO,OAAO,SAAS,IAAI;EAC7B;EAEA,KAAK,QAAQ,CAEb;EACA,MAAM,QAAQ,QAAQ;GACpB,OAAO;EACT;EACA,MAAM,UAAU,QAAQ,IAAI;GAC1B,OAAO,GAAG;EACZ;EAEA,SAAS,QAAQ,CAEjB;EACA,WAAW;GACT,OAAO;EACT;EACA,WAAW,MAAM,CAEjB;EACA,aAAa;GACX,OAAO;EACT;EAEA,YAAY,IAAI,CAEhB;EACA,aAAa,IAAI,CAEjB;EACA,eAAe,IAAI;GACjB,OAAO;EACT;EACA,gBAAgB;GACd,OAAO,CAAC;EACV;EACA,kBAAkB,CAElB;EAEA,gCAAgC,CAEhC;EACA,iCAAiC,CAEjC;EACA,mBAAmB,KAAK,SAAS,CAEjC;EACA,mBAAmB,KAA2B,CAE9C;EACA,iCAAiC,CAEjC;EACA,yBAAyB;GACvB,OAAO,CAAC;EACV;EAEA,MAAM,KAAK,OAAO;GAChB,OAAO,iBAAiB;IAAE;IAAQ,SAAS;GAAI,CAAC,CAAC,CAAC;EACpD;EACA,MAAM,QAAQ,CAEd;EAGA,IAAI,SAAS;GACX,OAAO;EACT;EACA,MAAM,aAAa;GACjB,OAAO;EACT;CACF;CAEA,MAAM,WAA+B;EACnC,IAAI,SAAS;GACX,OAAO;EACT;EACA,IAAI,QAAQ;GACV,OAAO;EACT;EAEA,SAAS,OAA+B;GACtC,IAAI,CAAC,OAAO,OAAO,CAAC,GAAG,MAAM;GAC7B,MAAM,IAAI,MAAM,YAAY;GAC5B,OAAO,OAAO,QAAQ,MAAM,EAAE,MAAM,YAAY,MAAM,CAAC;EACzD;EAEA,YAAY,OAAyC;GACnD,MAAM,WAAW,QACb,OAAO,QAAQ,MAAM,EAAE,MAAM,YAAY,MAAM,MAAM,YAAY,CAAC,IAClE;GACJ,OAAO,SAAS,SAAS,SAAS;EACpC;EAEA,UAAU,OAAe,SAA4B;GAGnD,IAAI,CAFe,SAAS,SAAS,KACZ,CAAC,CAAC,MAAM,MAAM,YAAY,GAAG,OAAO,CAClD,GAAG;IACZ,MAAM,cAAc,yBAAyB,OAAO;IACpD,MAAM,IAAI,MACR,0BAA0B,MAAM,iBAAiB,YAAY,sBACvC,YAAY,MAAM,GAC1C;GACF;EACF;EAEA,YAAY,OAAe,SAA4B;GAGrD,IAFmB,SAAS,SAAS,KACZ,CAAC,CAAC,MAAM,MAAM,YAAY,GAAG,OAAO,CACnD,GAAG;IACX,MAAM,cAAc,yBAAyB,OAAO;IACpD,MAAM,IAAI,MACR,gBAAgB,MAAM,iBAAiB,YAAY,yCAC7B,YAAY,MAAM,GAC1C;GACF;EACF;EAEA,QAAc;GACZ,OAAO,SAAS;EAClB;EAEA;CACF;CAEA,OAAO;AACT"}
+{"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-BJVL1QQl.d.ts → transport.types-CzJq4IrF.d.mts}

@@ -105,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;
@@ -127,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. */
@@ -186,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;
@@ -201,5 +212,5 @@ interface TransportMetrics {
   lastWrite: Date;
   averageWriteTime: number;
 }
-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-BJVL1QQl.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-BJVL1QQl.d.mts → transport.types-CzJq4IrF.d.ts}

@@ -105,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;
@@ -127,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. */
@@ -186,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;
@@ -201,5 +212,5 @@ interface TransportMetrics {
   lastWrite: Date;
   averageWriteTime: number;
 }
-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-BJVL1QQl.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"}

package/dist/transports.d.mts

@@ -1,10 +1,10 @@
-import { a as FileTransportConfig, c as IBatchTransport, d as SegmentTransportConfig, f as TransportConfig, i as DatabaseTransportConfig, l as ITransport, m as TransportMetrics, n as ConsoleTransportConfig, o as GoogleAnalyticsTransportConfig, p as TransportLogEntry, r as DataDogTransportConfig, s as IAsyncTransport, t as AnalyticsTransportConfig, u as MixpanelTransportConfig } from "./transport.types-BJVL1QQl.mjs";
-import { t as AzureMonitorTransport } from "./azure-monitor.transport-C7kYyZUW.mjs";
-import { t as CloudWatchTransport } from "./cloudwatch.transport-Rj4yTpRn.mjs";
-import { n as GCPTransport } from "./gcp.transport-C5D72b1g.mjs";
-import { h as LogEntry } from "./index-xqaJtAZn.mjs";
-import { a as DiscordTransport, c as OtlpLogTransportConfig, i as DiscordEmbed, l as toOtelSeverity, n as SlackTransport, o as DiscordTransportConfig, r as SlackTransportConfig, s as OtlpLogTransport, t as SlackMessage } from "./slack.transport-DxHOXlLu.mjs";
-import { t as WorkerTransport } from "./worker.transport-hJay1wxA.mjs";
+import { _ as TransportLogEntry, a as DatabaseTransportConfig, b as TransportType, c as GoogleAnalyticsTransportConfig, d as ITransport, f as MixpanelTransportConfig, g as TransportEvents, h as TransportConfig, i as DataDogTransportConfig, l as IAsyncTransport, m as SegmentTransportConfig, n as AnalyticsTransportConfig, o as FileStats, p as RotationConfig, r as ConsoleTransportConfig, s as FileTransportConfig, t as AnalyticsConfig, u as IBatchTransport, v as TransportMetrics, y as TransportRetryConfig } from "./transport.types-CzJq4IrF.mjs";
+import { n as AzureMonitorTransportConfig, t as AzureMonitorTransport } from "./azure-monitor.transport-CbSHOnNX.mjs";
+import { n as CloudWatchTransportConfig, t as CloudWatchTransport } from "./cloudwatch.transport-CjVrI6S4.mjs";
+import { n as GCPTransport, r as GCPTransportConfig } from "./gcp.transport-D9SdLPwP.mjs";
+import { g as LogEntry } from "./index-BSTtFcQ6.mjs";
+import { a as DiscordTransport, c as OtlpLogTransportConfig, i as DiscordEmbed, l as toOtelSeverity, n as SlackTransport, o as DiscordTransportConfig, r as SlackTransportConfig, s as OtlpLogTransport, t as SlackMessage } from "./slack.transport-BDyENuR0.mjs";
+import { n as WorkerTransportConfig, t as WorkerTransport } from "./worker.transport-Bl8lFRck.mjs";
 import { EventEmitter } from "node:events";
 export declare abstract class AnalyticsTransport implements ITransport, IBatchTransport {
   readonly name: string;
@@ -81,6 +81,7 @@ interface AnalyticsMetric {
 export declare class ConsoleTransport implements ITransport {
   private config;
   readonly name = "console";
+  readonly level?: string | undefined;
   readonly filter?: (entry: TransportLogEntry) => boolean;
   private static readonly COLORS;
   private static sanitize;
@@ -108,6 +109,7 @@ export declare class DatabaseTransport implements IAsyncTransport, IBatchTranspo
   readonly name = "database";
   readonly batchSize: number;
   readonly flushInterval: number;
+  readonly level?: string | undefined;
   readonly filter?: (entry: TransportLogEntry) => boolean;
   private batch;
   private flushTimer?;
@@ -179,8 +181,12 @@ export declare class DatabaseTransport implements IAsyncTransport, IBatchTranspo
  *
  * The API key is transmitted via the `DD-API-KEY` request header — never in the URL.
  *
+ * Metric names keep the legacy `logitron.logs.<level>` prefix (kept for
+ * dashboards and monitors that already query it; renaming would be a breaking
+ * change). Query `logitron.logs.error`, not `logixia.logs.error`.
+ *
  * @example
- * transports: { datadog: { apiKey: process.env.DD_API_KEY, service: 'api', env: 'production' } }
+ * analytics: { datadog: { apiKey: process.env.DD_API_KEY, service: 'api', env: 'production' } }
  */
 export declare class DataDogTransport extends AnalyticsTransport {
   private datadogConfig;
@@ -335,7 +341,7 @@ export declare class FileTransport implements ITransport, IBatchTransport {
  * Sends log entries as Google Analytics 4 Measurement Protocol events.
  *
  * @example
- * transports: {
+ * analytics: {
  *   googleAnalytics: { measurementId: 'G-XXXXXXX', apiSecret: process.env.GA_API_SECRET }
  * }
  */
@@ -369,7 +375,7 @@ export declare class GoogleAnalyticsTransport extends AnalyticsTransport {
  * Sends log entries as Mixpanel events via the Track and Engage HTTP APIs.
  *
  * @example
- * transports: { mixpanel: { token: process.env.MIXPANEL_TOKEN } }
+ * analytics: { mixpanel: { token: process.env.MIXPANEL_TOKEN } }
  */
 export declare class MixpanelTransport extends AnalyticsTransport {
   private mixpanelConfig;
@@ -394,7 +400,7 @@ export declare class MixpanelTransport extends AnalyticsTransport {
  * Sends log entries as Segment track/identify events via the HTTP Tracking API.
  *
  * @example
- * transports: { segment: { writeKey: process.env.SEGMENT_WRITE_KEY } }
+ * analytics: { segment: { writeKey: process.env.SEGMENT_WRITE_KEY } }
  */
 export declare class SegmentTransport extends AnalyticsTransport {
   private segmentConfig;
@@ -428,7 +434,13 @@ export declare class TransportManager extends EventEmitter {
   private isShuttingDown;
   private transportLevelPreferences;
   private warnedPromptDeprecated;
-  constructor(config?: TransportConfig);
+  private readonly levelValues;
+  /**
+   * @param config  Transport configuration.
+   * @param levels  The logger's `levelOptions.levels`; used with the built-in levels
+   *                to compare entries against each transport's `level`.
+   */
+  constructor(config?: TransportConfig, levels?: Record<string, number>);
   private setupTransports;
   addTransport(transport: ITransport, id?: string): void;
   removeTransport(id: string): boolean;
@@ -482,5 +494,5 @@ export declare class TransportManager extends EventEmitter {
   getTransportLevels(transportId: string): string[] | undefined;
   clearTransportLevelPreferences(): void;
 }
-export { AzureMonitorTransport, CloudWatchTransport, type DiscordEmbed, DiscordTransport, type DiscordTransportConfig, GCPTransport, OtlpLogTransport, type OtlpLogTransportConfig, type SlackMessage, SlackTransport, type SlackTransportConfig, WorkerTransport, toOtelSeverity };
+export { type AnalyticsConfig, type AnalyticsTransportConfig, AzureMonitorTransport, type AzureMonitorTransportConfig, CloudWatchTransport, type CloudWatchTransportConfig, type ConsoleTransportConfig, type DataDogTransportConfig, type DatabaseTransportConfig, type DiscordEmbed, DiscordTransport, type DiscordTransportConfig, type FileStats, type FileTransportConfig, GCPTransport, type GCPTransportConfig, type GoogleAnalyticsTransportConfig, type IAsyncTransport, type IBatchTransport, type ITransport, type MixpanelTransportConfig, OtlpLogTransport, type OtlpLogTransportConfig, type RotationConfig, type SegmentTransportConfig, type SlackMessage, SlackTransport, type SlackTransportConfig, type TransportConfig, type TransportEvents, type TransportLogEntry, type TransportMetrics, type TransportRetryConfig, type TransportType, WorkerTransport, type WorkerTransportConfig, toOtelSeverity };
 //# sourceMappingURL=transports.d.mts.map

package/dist/transports.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"transports.d.mts","names":[],"sources":["../src/transports/analytics.transport.ts","../src/transports/console.transport.ts","../src/transports/database.transport.ts","../src/transports/datadog.transport.ts","../src/transports/file.transport.ts","../src/transports/google-analytics.transport.ts","../src/transports/mixpanel.transport.ts","../src/transports/segment.transport.ts","../src/transports/transport.manager.ts"],"mappings":"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"}
+{"version":3,"file":"transports.d.mts","names":[],"sources":["../src/transports/analytics.transport.ts","../src/transports/console.transport.ts","../src/transports/database.transport.ts","../src/transports/datadog.transport.ts","../src/transports/file.transport.ts","../src/transports/google-analytics.transport.ts","../src/transports/mixpanel.transport.ts","../src/transports/segment.transport.ts","../src/transports/transport.manager.ts"],"mappings":"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"}