logixia 1.3.0 → 1.4.0

package/dist/testing.d.mts

@@ -1,4 +1,4 @@
-import { l as IBaseLogger, m as LogEntry } from "./index-iDTW2-eY.mjs";
+import { l as IBaseLogger, m as LogEntry } from "./index-Ium497V3.mjs";
 
 //#region src/testing/mock-logger.d.ts
 

package/dist/testing.d.ts

@@ -1,4 +1,4 @@
-import { l as IBaseLogger, m as LogEntry } from "./index-CHIsdA9n.js";
+import { l as IBaseLogger, m as LogEntry } from "./index-t-ActikQ.js";
 
 //#region src/testing/mock-logger.d.ts
 

package/dist/testing.js

@@ -121,7 +121,13 @@ function createMockLogger(options = {}) {
 				context: ctx
 			}).logger;
 		},
-		async close() {}
+		async close() {},
+		use(_plugin) {
+			return this;
+		},
+		unuse(_pluginName) {
+			return this;
+		}
 	};
 	const instance = {
 		get logger() {

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\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":["_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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"}

package/dist/testing.mjs

@@ -120,7 +120,13 @@ function createMockLogger(options = {}) {
 				context: ctx
 			}).logger;
 		},
-		async close() {}
+		async close() {},
+		use(_plugin) {
+			return this;
+		},
+		unuse(_pluginName) {
+			return this;
+		}
 	};
 	const instance = {
 		get logger() {

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\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":["_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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"}

package/dist/{transport.manager-5VVdqS3o.mjs → transport.manager-DR7TLXQT.mjs}

@@ -48,6 +48,14 @@ function internalError(message, error) {
 
 //#endregion
 //#region src/transports/console.transport.ts
+/**
+* Writes log entries to stdout (info/debug/verbose) and stderr (error/warn).
+*
+* Supports pretty-printed colorized output and compact JSON mode.
+*
+* @example
+* transports: { console: { format: 'json' } }
+*/
 var ConsoleTransport = class ConsoleTransport {
 	static #_ = this.COLORS = new Map([
 		["red", "\x1B[31m"],
@@ -126,14 +134,35 @@ var ConsoleTransport = class ConsoleTransport {
 
 //#endregion
 //#region src/transports/database.transport.ts
+/**
+* Validates that a SQL identifier (table/index name) contains only safe characters.
+* Prevents SQL injection via user-supplied table names.
+*/
+function validateSqlIdentifier(name, label = "table") {
+	if (!/^[a-zA-Z_]\w*$/.test(name)) throw new Error(`Invalid ${label} name "${name}". Only letters, digits, and underscores are allowed, and the name must start with a letter or underscore.`);
+}
+/**
+* Persists log entries to a database in batches.
+*
+* Supports MongoDB, PostgreSQL, MySQL, and SQLite. Entries are buffered and
+* flushed on a configurable interval or batch size threshold to minimize
+* round-trips.
+*
+* @example
+* transports: {
+*   database: { type: 'postgresql', host: 'localhost', database: 'appdb', table: 'logs' }
+* }
+*/
 var DatabaseTransport = class {
 	constructor(config) {
 		this.config = config;
 		this.name = "database";
 		this.batch = [];
+		this.isFlushing = false;
 		this.isConnected = false;
 		this.batchSize = config.batchSize || 100;
 		this.flushInterval = config.flushInterval || 5e3;
+		if (config.table) validateSqlIdentifier(config.table, "table");
 		this.setupFlushTimer();
 	}
 	async write(entry) {
@@ -146,6 +175,8 @@ var DatabaseTransport = class {
 	}
 	async flush() {
 		if (this.batch.length === 0) return;
+		if (this.isFlushing) return;
+		this.isFlushing = true;
 		const entriesToFlush = [...this.batch];
 		this.batch = [];
 		try {
@@ -168,6 +199,8 @@ var DatabaseTransport = class {
 			internalError("Database flush error", error);
 			this.batch.unshift(...entriesToFlush);
 			throw error;
+		} finally {
+			this.isFlushing = false;
 		}
 	}
 	async isReady() {
@@ -240,7 +273,7 @@ var DatabaseTransport = class {
 	}
 	async connectMySQL() {
 		try {
-			const mysql = await import("./promise-C4pQPcK4.mjs").then(__toDynamicImportESM()).catch(() => {
+			const mysql = await import("./promise-BrZcjavs.mjs").then(__toDynamicImportESM()).catch(() => {
 				throw new Error("MySQL driver not installed. Run: npm install mysql2");
 			});
 			const config = {
@@ -534,6 +567,14 @@ var AnalyticsTransport = class {
 
 //#endregion
 //#region src/transports/datadog.transport.ts
+/**
+* Sends log entries and metrics to Datadog via the Logs and Metrics HTTP APIs.
+*
+* The API key is transmitted via the `DD-API-KEY` request header — never in the URL.
+*
+* @example
+* transports: { datadog: { apiKey: process.env.DD_API_KEY, service: 'api', env: 'production' } }
+*/
 var DataDogTransport = class extends AnalyticsTransport {
 	constructor(config) {
 		super("datadog", config);
@@ -576,7 +617,7 @@ var DataDogTransport = class extends AnalyticsTransport {
 	}
 	async sendLogBatch(entries) {
 		const payload = { logs: entries.map((entry) => this.transformToDataDogLog(entry)) };
-		await this.makeLogsRequest("/v1/input/" + this.datadogConfig.apiKey, payload);
+		await this.makeLogsRequest("/v1/input", payload);
 	}
 	async sendMetric(entry) {
 		await this.sendMetricBatch([entry]);
@@ -759,11 +800,21 @@ const mkdir = promisify(fs.mkdir);
 const unlink = promisify(fs.unlink);
 const readdir = promisify(fs.readdir);
 const stat = promisify(fs.stat);
+/**
+* Appends log entries to a local file with automatic rotation.
+*
+* Supports batched writes, size-based and date-based rotation, and optional
+* gzip compression of rotated files.
+*
+* @example
+* transports: { file: { filename: 'app.log', dirname: './logs', maxSize: '50MB' } }
+*/
 var FileTransport = class {
 	constructor(config) {
 		this.name = "file";
 		this.batch = [];
 		this.lastRotation = /* @__PURE__ */ new Date();
+		this.isRotating = false;
 		this.config = {
 			format: "json",
 			batchSize: 100,
@@ -778,7 +829,14 @@ var FileTransport = class {
 	}
 	async write(entry) {
 		try {
-			if (this.shouldRotateNow()) await this.rotate();
+			if (this.shouldRotateNow() && !this.isRotating) {
+				this.isRotating = true;
+				try {
+					await this.rotate();
+				} finally {
+					this.isRotating = false;
+				}
+			}
 			if (this.config.batchSize && this.config.batchSize > 1) this.addToBatch(entry);
 			else await this.writeBatch([entry]);
 		} catch (error) {
@@ -910,6 +968,14 @@ var FileTransport = class {
 
 //#endregion
 //#region src/transports/google-analytics.transport.ts
+/**
+* Sends log entries as Google Analytics 4 Measurement Protocol events.
+*
+* @example
+* transports: {
+*   googleAnalytics: { measurementId: 'G-XXXXXXX', apiSecret: process.env.GA_API_SECRET }
+* }
+*/
 var GoogleAnalyticsTransport = class extends AnalyticsTransport {
 	constructor(config) {
 		super("google-analytics", config);
@@ -1133,6 +1199,12 @@ var GoogleAnalyticsTransport = class extends AnalyticsTransport {
 
 //#endregion
 //#region src/transports/mixpanel.transport.ts
+/**
+* Sends log entries as Mixpanel events via the Track and Engage HTTP APIs.
+*
+* @example
+* transports: { mixpanel: { token: process.env.MIXPANEL_TOKEN } }
+*/
 var MixpanelTransport = class extends AnalyticsTransport {
 	constructor(config) {
 		super("mixpanel", config);
@@ -1270,6 +1342,12 @@ var MixpanelTransport = class extends AnalyticsTransport {
 
 //#endregion
 //#region src/transports/segment.transport.ts
+/**
+* Sends log entries as Segment track/identify events via the HTTP Tracking API.
+*
+* @example
+* transports: { segment: { writeKey: process.env.SEGMENT_WRITE_KEY } }
+*/
 var SegmentTransport = class extends AnalyticsTransport {
 	constructor(config) {
 		super("segment", config);
@@ -1895,4 +1973,4 @@ var TransportManager = class extends EventEmitter {
 
 //#endregion
 export { FileTransport as a, DatabaseTransport as c, internalLog as d, internalWarn as f, GoogleAnalyticsTransport as i, ConsoleTransport as l, SegmentTransport as n, DataDogTransport as o, MixpanelTransport as r, AnalyticsTransport as s, TransportManager as t, internalError as u };
-//# sourceMappingURL=transport.manager-5VVdqS3o.mjs.map
+//# sourceMappingURL=transport.manager-DR7TLXQT.mjs.map