logixia 1.2.1 → 1.3.0

package/dist/nest.mjs

@@ -1,5 +1,5 @@
-import "./transport.manager-Vi__pagn.mjs";
-import { a as TraceMiddleware, g as setTraceId, i as WebSocketTraceInterceptor, m as getCurrentTraceId, n as LOGIXIA_LOGGER_PREFIX, o as KafkaTraceInterceptor, p as generateTraceId, r as LogixiaLoggerModule, s as LogixiaLoggerService, t as LOGIXIA_LOGGER_CONFIG } from "./logitron-logger.module-iO8DPE7_.mjs";
+import { a as TraceMiddleware, g as setTraceId, i as WebSocketTraceInterceptor, m as getCurrentTraceId, n as LOGIXIA_LOGGER_PREFIX, o as KafkaTraceInterceptor, p as generateTraceId, r as LogixiaLoggerModule, s as LogixiaLoggerService, t as LOGIXIA_LOGGER_CONFIG } from "./logitron-logger.module-2AzkadqZ.mjs";
+import "./transport.manager-5VVdqS3o.mjs";
 
 //#region src/core/request-context.ts
 var RequestContextManager = class {

package/dist/testing.d.mts

@@ -0,0 +1,67 @@
+import { l as IBaseLogger, m as LogEntry } from "./index-iDTW2-eY.mjs";
+
+//#region src/testing/mock-logger.d.ts
+
+interface MockLogCall {
+  level: string;
+  message: string;
+  data?: Record<string, unknown>;
+  /** Full LogEntry shape for assertions that inspect the complete record. */
+  entry: Pick<LogEntry, 'level' | 'message' | 'context'> & {
+    data?: Record<string, unknown>;
+  };
+}
+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;
+  /** Every call recorded across all levels, in insertion order. */
+  readonly calls: MockLogCall[];
+  /**
+   * Get all calls for a specific level (case-insensitive). If `level` is
+   * omitted, returns all calls across every level.
+   */
+  getCalls(level?: string): MockLogCall[];
+  /** Return the most recent call, optionally filtered by level. */
+  getLastCall(level?: string): MockLogCall | undefined;
+  /**
+   * Assert that at least one recorded call matches `matcher`.
+   *
+   * - string → exact message match
+   * - RegExp → message test
+   * - function → receives the full MockLogCall
+   * - object → every key/value must match (supports RegExp values)
+   *
+   * Throws an Error with a descriptive message if the assertion fails (works
+   * with both Vitest `expect` and Jest matchers via `.toThrow()`, or you can
+   * let it propagate directly).
+   */
+  expectLog(level: string, matcher?: LogMatcher): void;
+  /**
+   * Assert that NO recorded call matches `matcher` at the given level.
+   */
+  expectNoLog(level: string, matcher?: LogMatcher): void;
+  /** Clear all recorded calls. Call between tests. */
+  reset(): void;
+  /**
+   * Silence — when true, the mock suppresses all console output from the
+   * logger. Default: true.
+   */
+  silent: boolean;
+}
+/**
+ * Create a mock logger for use in tests.
+ *
+ * The returned object implements `IBaseLogger` 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`
+ */
+declare function createMockLogger(options?: {
+  silent?: boolean;
+  context?: string;
+}): MockLoggerInstance;
+//#endregion
+export { type LogMatcher, type MockLogCall, type MockLoggerInstance, createMockLogger };
+//# sourceMappingURL=testing.d.mts.map

package/dist/testing.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.mts","names":[],"sources":["../src/testing/mock-logger.ts"],"sourcesContent":[],"mappings":";;;;AAoCmB,UAhBF,WAAA,CAgBE;EAED,KAAA,EAAA,MAAA;EAKU,OAAA,EAAA,MAAA;EAEG,IAAA,CAAA,EAtBtB,MAsBsB,CAAA,MAAA,EAAA,OAAA,CAAA;EAaM;EAIE,KAAA,EArC9B,IAqC8B,CArCzB,QAqCyB,EAAA,OAAA,GAAA,SAAA,GAAA,SAAA,CAAA,GAAA;IAAU,IAAA,CAAA,EArCmB,MAqCnB,CAAA,MAAA,EAAA,OAAA,CAAA;EA2DjC,CAAA;;KA7FJ,UAAA,YAER,iBACQ,2BACR,QAAQ;UAEK,kBAAA;;mBAEE;;kBAED;;;;;4BAKU;;+BAEG;;;;;;;;;;;;;qCAaM;;;;uCAIE;;;;;;;;;;;;;;;;;;iBA2DvB,gBAAA;;;IAEb"}

package/dist/testing.d.ts

@@ -0,0 +1,67 @@
+import { l as IBaseLogger, m as LogEntry } from "./index-CHIsdA9n.js";
+
+//#region src/testing/mock-logger.d.ts
+
+interface MockLogCall {
+  level: string;
+  message: string;
+  data?: Record<string, unknown>;
+  /** Full LogEntry shape for assertions that inspect the complete record. */
+  entry: Pick<LogEntry, 'level' | 'message' | 'context'> & {
+    data?: Record<string, unknown>;
+  };
+}
+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;
+  /** Every call recorded across all levels, in insertion order. */
+  readonly calls: MockLogCall[];
+  /**
+   * Get all calls for a specific level (case-insensitive). If `level` is
+   * omitted, returns all calls across every level.
+   */
+  getCalls(level?: string): MockLogCall[];
+  /** Return the most recent call, optionally filtered by level. */
+  getLastCall(level?: string): MockLogCall | undefined;
+  /**
+   * Assert that at least one recorded call matches `matcher`.
+   *
+   * - string → exact message match
+   * - RegExp → message test
+   * - function → receives the full MockLogCall
+   * - object → every key/value must match (supports RegExp values)
+   *
+   * Throws an Error with a descriptive message if the assertion fails (works
+   * with both Vitest `expect` and Jest matchers via `.toThrow()`, or you can
+   * let it propagate directly).
+   */
+  expectLog(level: string, matcher?: LogMatcher): void;
+  /**
+   * Assert that NO recorded call matches `matcher` at the given level.
+   */
+  expectNoLog(level: string, matcher?: LogMatcher): void;
+  /** Clear all recorded calls. Call between tests. */
+  reset(): void;
+  /**
+   * Silence — when true, the mock suppresses all console output from the
+   * logger. Default: true.
+   */
+  silent: boolean;
+}
+/**
+ * Create a mock logger for use in tests.
+ *
+ * The returned object implements `IBaseLogger` 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`
+ */
+declare function createMockLogger(options?: {
+  silent?: boolean;
+  context?: string;
+}): MockLoggerInstance;
+//#endregion
+export { type LogMatcher, type MockLogCall, type MockLoggerInstance, createMockLogger };
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","names":[],"sources":["../src/testing/mock-logger.ts"],"sourcesContent":[],"mappings":";;;;AAoCmB,UAhBF,WAAA,CAgBE;EAED,KAAA,EAAA,MAAA;EAKU,OAAA,EAAA,MAAA;EAEG,IAAA,CAAA,EAtBtB,MAsBsB,CAAA,MAAA,EAAA,OAAA,CAAA;EAaM;EAIE,KAAA,EArC9B,IAqC8B,CArCzB,QAqCyB,EAAA,OAAA,GAAA,SAAA,GAAA,SAAA,CAAA,GAAA;IAAU,IAAA,CAAA,EArCmB,MAqCnB,CAAA,MAAA,EAAA,OAAA,CAAA;EA2DjC,CAAA;;KA7FJ,UAAA,YAER,iBACQ,2BACR,QAAQ;UAEK,kBAAA;;mBAEE;;kBAED;;;;;4BAKU;;+BAEG;;;;;;;;;;;;;qCAaM;;;;uCAIE;;;;;;;;;;;;;;;;;;iBA2DvB,gBAAA;;;IAEb"}

package/dist/testing.js

@@ -0,0 +1,164 @@
+
+//#region src/testing/mock-logger.ts
+function resolveCallField(call, key) {
+	var _call$data;
+	if (key === "message") return call.message;
+	if (key === "level") return call.level;
+	return ((_call$data = call.data) === null || _call$data === void 0 ? void 0 : _call$data[key]) ?? call.entry[key];
+}
+function formatMatcherDescription(matcher) {
+	if (matcher === void 0) return "(any)";
+	if (matcher instanceof RegExp) return matcher.toString();
+	return JSON.stringify(matcher);
+}
+function matchesCall(call, matcher) {
+	if (matcher === void 0) return true;
+	if (typeof matcher === "string") return call.message === matcher;
+	if (matcher instanceof RegExp) return matcher.test(call.message);
+	if (typeof matcher === "function") return matcher(call);
+	for (const [key, expected] of Object.entries(matcher)) {
+		const actual = resolveCallField(call, key);
+		if (expected instanceof RegExp) {
+			if (!expected.test(String(actual ?? ""))) return false;
+		} else if (actual !== expected) return false;
+	}
+	return true;
+}
+function formatCalls(calls) {
+	if (calls.length === 0) return "  (no calls recorded)";
+	return calls.map((c) => `  [${c.level}] "${c.message}" ${c.data ? JSON.stringify(c.data) : ""}`).join("\n");
+}
+/**
+* Create a mock logger for use in tests.
+*
+* The returned object implements `IBaseLogger` 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`
+*/
+function createMockLogger(options = {}) {
+	const { silent = true, context } = options;
+	const _calls = [];
+	function record(level, messageOrError, data) {
+		const message = messageOrError instanceof Error ? messageOrError.message : messageOrError;
+		const extraData = messageOrError instanceof Error ? {
+			...data,
+			error: {
+				message: messageOrError.message,
+				stack: messageOrError.stack
+			}
+		} : data;
+		_calls.push({
+			level,
+			message,
+			...extraData !== void 0 ? { data: extraData } : {},
+			entry: {
+				level,
+				message,
+				...context !== void 0 ? { context } : {},
+				...extraData !== void 0 ? { data: extraData } : {}
+			}
+		});
+	}
+	const logger = {
+		async error(messageOrError, data) {
+			record("error", messageOrError, data);
+		},
+		async warn(message, data) {
+			record("warn", message, data);
+		},
+		async info(message, data) {
+			record("info", message, data);
+		},
+		async debug(message, data) {
+			record("debug", message, data);
+		},
+		async trace(message, data) {
+			record("trace", message, data);
+		},
+		async verbose(message, data) {
+			record("verbose", message, data);
+		},
+		async logLevel(level, message, data) {
+			record(level, message, data);
+		},
+		time(_label) {},
+		async timeEnd(_label) {
+			return 0;
+		},
+		async timeAsync(_label, fn) {
+			return fn();
+		},
+		setLevel(_level) {},
+		getLevel() {
+			return "info";
+		},
+		setContext(_ctx) {},
+		getContext() {
+			return context;
+		},
+		enableField(_f) {},
+		disableField(_f) {},
+		isFieldEnabled(_f) {
+			return true;
+		},
+		getFieldState() {
+			return {};
+		},
+		resetFieldState() {},
+		enableTransportLevelPrompting() {},
+		disableTransportLevelPrompting() {},
+		setTransportLevels(_id, _levels) {},
+		getTransportLevels(_id) {},
+		clearTransportLevelPreferences() {},
+		getAvailableTransports() {
+			return [];
+		},
+		child(ctx, _data) {
+			return createMockLogger({
+				silent,
+				context: ctx
+			}).logger;
+		},
+		async close() {}
+	};
+	const instance = {
+		get logger() {
+			return logger;
+		},
+		get calls() {
+			return _calls;
+		},
+		getCalls(level) {
+			if (!level) return [..._calls];
+			const l = level.toLowerCase();
+			return _calls.filter((c) => c.level.toLowerCase() === l);
+		},
+		getLastCall(level) {
+			const filtered = level ? _calls.filter((c) => c.level.toLowerCase() === level.toLowerCase()) : _calls;
+			return filtered[filtered.length - 1];
+		},
+		expectLog(level, matcher) {
+			if (!instance.getCalls(level).some((c) => matchesCall(c, matcher))) {
+				const matcherDesc = formatMatcherDescription(matcher);
+				throw new Error(`Expected at least one [${level}] log matching ${matcherDesc}.\nRecorded calls:\n${formatCalls(_calls)}`);
+			}
+		},
+		expectNoLog(level, matcher) {
+			if (instance.getCalls(level).some((c) => matchesCall(c, matcher))) {
+				const matcherDesc = formatMatcherDescription(matcher);
+				throw new Error(`Expected NO [${level}] log matching ${matcherDesc}, but one was found.\nRecorded calls:\n${formatCalls(_calls)}`);
+			}
+		},
+		reset() {
+			_calls.length = 0;
+		},
+		silent
+	};
+	return instance;
+}
+
+//#endregion
+exports.createMockLogger = createMockLogger;
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +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":";;AA0EA,SAAS,iBAAiB,MAAmB,KAAsB;;AACjE,KAAI,QAAQ,UAAW,QAAO,KAAK;AACnC,KAAI,QAAQ,QAAS,QAAO,KAAK;AACjC,uBAAO,KAAK,8DAAO,SAAS,KAAK,MAAkC;;AAGrE,SAAS,yBAAyB,SAAyC;AACzE,KAAI,YAAY,OAAW,QAAO;AAClC,KAAI,mBAAmB,OAAQ,QAAO,QAAQ,UAAU;AACxD,QAAO,KAAK,UAAU,QAAQ;;AAGhC,SAAS,YAAY,MAAmB,SAA+B;AACrE,KAAI,YAAY,OAAW,QAAO;AAClC,KAAI,OAAO,YAAY,SAAU,QAAO,KAAK,YAAY;AACzD,KAAI,mBAAmB,OAAQ,QAAO,QAAQ,KAAK,KAAK,QAAQ;AAChE,KAAI,OAAO,YAAY,WAAY,QAAO,QAAQ,KAAK;AAEvD,MAAK,MAAM,CAAC,KAAK,aAAa,OAAO,QAAQ,QAAQ,EAAE;EACrD,MAAM,SAAS,iBAAiB,MAAM,IAAI;AAC1C,MAAI,oBAAoB,QACtB;OAAI,CAAC,SAAS,KAAK,OAAO,UAAU,GAAG,CAAC,CAAE,QAAO;aAE7C,WAAW,SAAU,QAAO;;AAGpC,QAAO;;AAGT,SAAS,YAAY,OAA8B;AACjD,KAAI,MAAM,WAAW,EAAG,QAAO;AAC/B,QAAO,MACJ,KAAK,MAAM,MAAM,EAAE,MAAM,KAAK,EAAE,QAAQ,IAAI,EAAE,OAAO,KAAK,UAAU,EAAE,KAAK,GAAG,KAAK,CACnF,KAAK,KAAK;;;;;;;;;;;AAcf,SAAgB,iBACd,UAAkD,EAAE,EAChC;CACpB,MAAM,EAAE,SAAS,MAAM,YAAY;CACnC,MAAMA,SAAwB,EAAE;CAEhC,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;IAAO;GAAE,GACpF;AAEN,SAAO,KAAK;GACV;GACA;GACA,GAAI,cAAc,SAAY,EAAE,MAAM,WAAW,GAAG,EAAE;GACtD,OAAO;IACL;IACA;IACA,GAAI,YAAY,SAAY,EAAE,SAAS,GAAG,EAAE;IAC5C,GAAI,cAAc,SAAY,EAAE,MAAM,WAAW,GAAG,EAAE;IACvD;GACF,CAAC;;CAGJ,MAAMC,SAAsB;EAC1B,MAAM,MAAM,gBAAgB,MAAM;AAChC,UAAO,SAAS,gBAAkC,KAAK;;EAEzD,MAAM,KAAK,SAAS,MAAM;AACxB,UAAO,QAAQ,SAAS,KAAK;;EAE/B,MAAM,KAAK,SAAS,MAAM;AACxB,UAAO,QAAQ,SAAS,KAAK;;EAE/B,MAAM,MAAM,SAAS,MAAM;AACzB,UAAO,SAAS,SAAS,KAAK;;EAEhC,MAAM,MAAM,SAAS,MAAM;AACzB,UAAO,SAAS,SAAS,KAAK;;EAEhC,MAAM,QAAQ,SAAS,MAAM;AAC3B,UAAO,WAAW,SAAS,KAAK;;EAElC,MAAM,SAAS,OAAO,SAAS,MAAM;AACnC,UAAO,OAAO,SAAS,KAAK;;EAG9B,KAAK,QAAQ;EAGb,MAAM,QAAQ,QAAQ;AACpB,UAAO;;EAET,MAAM,UAAU,QAAQ,IAAI;AAC1B,UAAO,IAAI;;EAGb,SAAS,QAAQ;EAGjB,WAAW;AACT,UAAO;;EAET,WAAW,MAAM;EAGjB,aAAa;AACX,UAAO;;EAGT,YAAY,IAAI;EAGhB,aAAa,IAAI;EAGjB,eAAe,IAAI;AACjB,UAAO;;EAET,gBAAgB;AACd,UAAO,EAAE;;EAEX,kBAAkB;EAIlB,gCAAgC;EAGhC,iCAAiC;EAGjC,mBAAmB,KAAK,SAAS;EAGjC,mBAAmB,KAA2B;EAG9C,iCAAiC;EAGjC,yBAAyB;AACvB,UAAO,EAAE;;EAGX,MAAM,KAAK,OAAO;AAChB,UAAO,iBAAiB;IAAE;IAAQ,SAAS;IAAK,CAAC,CAAC;;EAEpD,MAAM,QAAQ;EAGf;CAED,MAAMC,WAA+B;EACnC,IAAI,SAAS;AACX,UAAO;;EAET,IAAI,QAAQ;AACV,UAAO;;EAGT,SAAS,OAA+B;AACtC,OAAI,CAAC,MAAO,QAAO,CAAC,GAAG,OAAO;GAC9B,MAAM,IAAI,MAAM,aAAa;AAC7B,UAAO,OAAO,QAAQ,MAAM,EAAE,MAAM,aAAa,KAAK,EAAE;;EAG1D,YAAY,OAAyC;GACnD,MAAM,WAAW,QACb,OAAO,QAAQ,MAAM,EAAE,MAAM,aAAa,KAAK,MAAM,aAAa,CAAC,GACnE;AACJ,UAAO,SAAS,SAAS,SAAS;;EAGpC,UAAU,OAAe,SAA4B;AAGnD,OAAI,CAFe,SAAS,SAAS,MAAM,CAChB,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,EACjD;IACZ,MAAM,cAAc,yBAAyB,QAAQ;AACrD,UAAM,IAAI,MACR,0BAA0B,MAAM,iBAAiB,YAAY,sBACvC,YAAY,OAAO,GAC1C;;;EAIL,YAAY,OAAe,SAA4B;AAGrD,OAFmB,SAAS,SAAS,MAAM,CAChB,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,EAClD;IACX,MAAM,cAAc,yBAAyB,QAAQ;AACrD,UAAM,IAAI,MACR,gBAAgB,MAAM,iBAAiB,YAAY,yCAC7B,YAAY,OAAO,GAC1C;;;EAIL,QAAc;AACZ,UAAO,SAAS;;EAGlB;EACD;AAED,QAAO"}

package/dist/testing.mjs

@@ -0,0 +1,163 @@
+//#region src/testing/mock-logger.ts
+function resolveCallField(call, key) {
+	var _call$data;
+	if (key === "message") return call.message;
+	if (key === "level") return call.level;
+	return ((_call$data = call.data) === null || _call$data === void 0 ? void 0 : _call$data[key]) ?? call.entry[key];
+}
+function formatMatcherDescription(matcher) {
+	if (matcher === void 0) return "(any)";
+	if (matcher instanceof RegExp) return matcher.toString();
+	return JSON.stringify(matcher);
+}
+function matchesCall(call, matcher) {
+	if (matcher === void 0) return true;
+	if (typeof matcher === "string") return call.message === matcher;
+	if (matcher instanceof RegExp) return matcher.test(call.message);
+	if (typeof matcher === "function") return matcher(call);
+	for (const [key, expected] of Object.entries(matcher)) {
+		const actual = resolveCallField(call, key);
+		if (expected instanceof RegExp) {
+			if (!expected.test(String(actual ?? ""))) return false;
+		} else if (actual !== expected) return false;
+	}
+	return true;
+}
+function formatCalls(calls) {
+	if (calls.length === 0) return "  (no calls recorded)";
+	return calls.map((c) => `  [${c.level}] "${c.message}" ${c.data ? JSON.stringify(c.data) : ""}`).join("\n");
+}
+/**
+* Create a mock logger for use in tests.
+*
+* The returned object implements `IBaseLogger` 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`
+*/
+function createMockLogger(options = {}) {
+	const { silent = true, context } = options;
+	const _calls = [];
+	function record(level, messageOrError, data) {
+		const message = messageOrError instanceof Error ? messageOrError.message : messageOrError;
+		const extraData = messageOrError instanceof Error ? {
+			...data,
+			error: {
+				message: messageOrError.message,
+				stack: messageOrError.stack
+			}
+		} : data;
+		_calls.push({
+			level,
+			message,
+			...extraData !== void 0 ? { data: extraData } : {},
+			entry: {
+				level,
+				message,
+				...context !== void 0 ? { context } : {},
+				...extraData !== void 0 ? { data: extraData } : {}
+			}
+		});
+	}
+	const logger = {
+		async error(messageOrError, data) {
+			record("error", messageOrError, data);
+		},
+		async warn(message, data) {
+			record("warn", message, data);
+		},
+		async info(message, data) {
+			record("info", message, data);
+		},
+		async debug(message, data) {
+			record("debug", message, data);
+		},
+		async trace(message, data) {
+			record("trace", message, data);
+		},
+		async verbose(message, data) {
+			record("verbose", message, data);
+		},
+		async logLevel(level, message, data) {
+			record(level, message, data);
+		},
+		time(_label) {},
+		async timeEnd(_label) {
+			return 0;
+		},
+		async timeAsync(_label, fn) {
+			return fn();
+		},
+		setLevel(_level) {},
+		getLevel() {
+			return "info";
+		},
+		setContext(_ctx) {},
+		getContext() {
+			return context;
+		},
+		enableField(_f) {},
+		disableField(_f) {},
+		isFieldEnabled(_f) {
+			return true;
+		},
+		getFieldState() {
+			return {};
+		},
+		resetFieldState() {},
+		enableTransportLevelPrompting() {},
+		disableTransportLevelPrompting() {},
+		setTransportLevels(_id, _levels) {},
+		getTransportLevels(_id) {},
+		clearTransportLevelPreferences() {},
+		getAvailableTransports() {
+			return [];
+		},
+		child(ctx, _data) {
+			return createMockLogger({
+				silent,
+				context: ctx
+			}).logger;
+		},
+		async close() {}
+	};
+	const instance = {
+		get logger() {
+			return logger;
+		},
+		get calls() {
+			return _calls;
+		},
+		getCalls(level) {
+			if (!level) return [..._calls];
+			const l = level.toLowerCase();
+			return _calls.filter((c) => c.level.toLowerCase() === l);
+		},
+		getLastCall(level) {
+			const filtered = level ? _calls.filter((c) => c.level.toLowerCase() === level.toLowerCase()) : _calls;
+			return filtered[filtered.length - 1];
+		},
+		expectLog(level, matcher) {
+			if (!instance.getCalls(level).some((c) => matchesCall(c, matcher))) {
+				const matcherDesc = formatMatcherDescription(matcher);
+				throw new Error(`Expected at least one [${level}] log matching ${matcherDesc}.\nRecorded calls:\n${formatCalls(_calls)}`);
+			}
+		},
+		expectNoLog(level, matcher) {
+			if (instance.getCalls(level).some((c) => matchesCall(c, matcher))) {
+				const matcherDesc = formatMatcherDescription(matcher);
+				throw new Error(`Expected NO [${level}] log matching ${matcherDesc}, but one was found.\nRecorded calls:\n${formatCalls(_calls)}`);
+			}
+		},
+		reset() {
+			_calls.length = 0;
+		},
+		silent
+	};
+	return instance;
+}
+
+//#endregion
+export { createMockLogger };
+//# sourceMappingURL=testing.mjs.map

package/dist/testing.mjs.map

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

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

@@ -1546,6 +1546,9 @@ var SegmentTransport = class extends AnalyticsTransport {
 
 //#endregion
 //#region src/transports/transport.manager.ts
+function _sleep(ms) {
+	return new Promise((resolve) => setTimeout(resolve, ms));
+}
 var TransportManager = class extends EventEmitter {
 	constructor(config = {}) {
 		super();
@@ -1660,7 +1663,7 @@ var TransportManager = class extends EventEmitter {
 		const startTime = Date.now();
 		const metrics = this.metrics.get(id);
 		try {
-			await transport.write(entry);
+			await this._writeWithRetry(transport, entry);
 			const writeTime = Date.now() - startTime;
 			metrics.logsWritten++;
 			metrics.lastWrite = new Date(startTime);
@@ -1672,6 +1675,52 @@ var TransportManager = class extends EventEmitter {
 			throw error;
 		}
 	}
+	/**
+	* Feature 9: Multi-transport retry + failover.
+	*
+	* Attempts `transport.write()` up to `retry.maxRetries + 1` times with the
+	* configured backoff strategy. If all attempts fail and a fallback transport
+	* is configured, routes the entry there instead.
+	*/
+	async _writeWithRetry(transport, entry) {
+		const retryCfg = transport.retry;
+		if (!retryCfg || !retryCfg.maxRetries) {
+			await transport.write(entry);
+			return;
+		}
+		const { maxRetries, backoff = "exponential", delay: baseDelay = 500, maxDelay = 3e4, fallback, onExhausted } = retryCfg;
+		let lastError = /* @__PURE__ */ new Error("Unknown transport error");
+		for (let attempt = 0; attempt <= maxRetries; attempt++) try {
+			await transport.write(entry);
+			return;
+		} catch (err) {
+			lastError = err instanceof Error ? err : new Error(String(err));
+			if (attempt < maxRetries) {
+				let wait;
+				switch (backoff) {
+					case "fixed":
+						wait = baseDelay;
+						break;
+					case "linear":
+						wait = baseDelay * (attempt + 1);
+						break;
+					case "exponential":
+					default: wait = Math.min(baseDelay * Math.pow(2, attempt), maxDelay);
+				}
+				this.emit("transport:retry", transport.name, attempt + 1, maxRetries, wait);
+				await _sleep(wait);
+			}
+		}
+		if (fallback) {
+			this.emit("transport:fallback", transport.name, fallback.name);
+			try {
+				await fallback.write(entry);
+				return;
+			} catch {}
+		}
+		onExhausted === null || onExhausted === void 0 || onExhausted(lastError, entry);
+		throw lastError;
+	}
 	shouldTransportHandle(transport, level, transportId) {
 		if (transportId && this.transportLevelPreferences.has(transportId)) return this.transportLevelPreferences.get(transportId).includes(level.toLowerCase());
 		if (!transport.level) return true;
@@ -1846,4 +1895,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-Vi__pagn.mjs.map
+//# sourceMappingURL=transport.manager-5VVdqS3o.mjs.map