logixia 1.12.4 → 1.12.6

package/dist/index.js

@@ -1,10 +1,16 @@
-const require_transport_manager = require('./transport.manager-ciG4r5uz.js');
-const require_logitron_logger_module = require('./logitron-logger.module-BTxDpK6u.js');
-require('./search-DoZF3RZj.js');
+const require_chunk = require('./chunk-nOFOJqeH.js');
+const require_internal_log = require('./internal-log-BUJYMZbE.js');
+const require_safe_stringify = require('./safe-stringify-DWo3aZp_.js');
+const require_batch_buffer = require('./batch-buffer-BY-mRWIK.js');
+const require_async_context = require('./async-context-CSHWoHMB.js');
+const require_logitron_logger_module = require('./logitron-logger.module-BsDZR5BH.js');
+const require_coerce_utils = require('./coerce.utils-BN980Y9V.js');
+require('./transport.manager-BivyUTtU.js');
+const require_search = require('./search-njTI2hdo.js');
 let node_async_hooks = require("node:async_hooks");
-node_async_hooks = require_transport_manager.__toESM(node_async_hooks);
+node_async_hooks = require_chunk.__toESM(node_async_hooks);
 let __nestjs_common = require("@nestjs/common");
-__nestjs_common = require_transport_manager.__toESM(__nestjs_common);
+__nestjs_common = require_chunk.__toESM(__nestjs_common);
 
 //#region src/exceptions/exception.ts
 var LogixiaException = class extends Error {
@@ -253,7 +259,7 @@ function LogMethod(options = {}) {
 		const label = options.label ?? `${className}.${methodName}`;
 		let _warnedNoLogger = false;
 		const reportLogFailure = (phase, err) => {
-			process.stderr.write(`[logixia] @LogMethod(${label}) ${phase} log failed: ${String(err)}\n`);
+			require_internal_log.internalError(`@LogMethod(${label}) ${phase} log failed: ${String(err)}`);
 		};
 		const emit$1 = (logger$1, phase, message, data) => {
 			const logFnRaw = logger$1[level];
@@ -272,7 +278,7 @@ function LogMethod(options = {}) {
 			const logger$1 = this.logger ?? require_logitron_logger_module.LogixiaLoggerModule._globalLogger ?? void 0;
 			if (!logger$1 && !_warnedNoLogger) {
 				_warnedNoLogger = true;
-				console.warn(`[logixia] @LogMethod on ${label}: no logger available. Either inject LogixiaLoggerService as this.logger or ensure LogixiaLoggerModule is initialised.`);
+				require_internal_log.internalWarn(`@LogMethod on ${label}: no logger available. Either inject LogixiaLoggerService as this.logger or ensure LogixiaLoggerModule is initialised.`);
 			}
 			const start = Date.now();
 			const entry = { method: label };
@@ -331,7 +337,7 @@ let LogixiaExceptionFilter = class LogixiaExceptionFilter$1 {
 				...errorResponse.meta.trace_id !== void 0 ? { trace_id: errorResponse.meta.trace_id } : {}
 			};
 			const onLogFailure = (err) => {
-				process.stderr.write(`[logixia] ExceptionFilter failed to write log entry: ${String(err)}\n`);
+				require_internal_log.internalError(`ExceptionFilter failed to write log entry: ${String(err)}`);
 			};
 			let logPromise;
 			if (httpStatus >= 500) {
@@ -428,7 +434,7 @@ var JsonFormatter = class {
 //#endregion
 //#region src/formatters/text.formatter.ts
 const CONTROL_CHARS_RE = /[\x00-\x08\x0B-\x1F\x7F-\x9F]/g;
-const stripControls = (value) => require_transport_manager.safeToString(value).replace(CONTROL_CHARS_RE, "");
+const stripControls = (value) => require_coerce_utils.safeToString(value).replace(CONTROL_CHARS_RE, "");
 var TextFormatter = class TextFormatter {
 	constructor(options = {}) {
 		this.colorize = options.colorize ?? true;
@@ -507,11 +513,11 @@ var TextFormatter = class TextFormatter {
 				if (typeof value === "string") return `${key}="${value}"`;
 				if (typeof value === "number" || typeof value === "boolean") return `${key}=${value}`;
 				if (value instanceof Date) return `${key}=${value.toISOString()}`;
-				if (typeof value === "object") return `${key}=${stripControls(require_transport_manager.safeToString(value))}`;
+				if (typeof value === "object") return `${key}=${stripControls(require_coerce_utils.safeToString(value))}`;
 				return `${key}=${String(value)}`;
 			}).join(" ");
 		} catch {
-			return stripControls(require_transport_manager.safeToString(payload));
+			return stripControls(require_coerce_utils.safeToString(payload));
 		}
 	}
 	/**
@@ -573,7 +579,7 @@ function registerLevelSignal(logger$1, options = {}) {
 		const current = logger$1.getLevel();
 		const next = cycle[(cycle.indexOf(current) + 1) % cycle.length];
 		logger$1.setLevel(next);
-		require_transport_manager.internalLog(`runtime level changed via ${signal}: ${current} → ${next}`);
+		require_internal_log.internalLog(`runtime level changed via ${signal}: ${current} → ${next}`);
 	};
 	process.on(signal, handler);
 	return () => {
@@ -648,7 +654,7 @@ function createLevelControlHandler(logger$1, options = {}) {
 				const coerced = {};
 				for (const [pat, lvl] of Object.entries(nl)) coerced[pat] = String(lvl).toLowerCase();
 				logger$1.setNamespaceLevels(coerced);
-			} else require_transport_manager.internalWarn("level control: logger does not support setNamespaceLevels — ignored");
+			} else require_internal_log.internalWarn("level control: logger does not support setNamespaceLevels — ignored");
 		}
 		send(res, 200, snapshot());
 	};
@@ -679,103 +685,6 @@ function createLevelControlHandler(logger$1, options = {}) {
 	};
 }
 
-//#endregion
-//#region src/utils/safe-stringify.ts
-/** Build a JSONPath like `$["a"][0]["b"]` for a decycle pointer. */
-function jsonPath(parts) {
-	let path = "$";
-	for (const p of parts) path += typeof p === "number" ? `[${p}]` : `[${JSON.stringify(p)}]`;
-	return path;
-}
-/**
-* Serialize any value to JSON without throwing on circular references or BigInt.
-* Circular refs become `"[Circular]"` (or `{ $ref }` pointers when `decycle`).
-*/
-function safeStringify(value, options = {}) {
-	const { indent, deterministic = false, decycle = false, bigint = "string" } = options;
-	if (decycle) return JSON.stringify(decycleValue(value, bigint), void 0, indent);
-	const seen = /* @__PURE__ */ new WeakSet();
-	const transform = (val) => {
-		if (typeof val === "bigint") return bigint === "number" ? Number(val) : val.toString();
-		if (typeof val === "function") return `[Function: ${val.name || "anonymous"}]`;
-		if (typeof val === "symbol") return val.toString();
-		if (val === null || typeof val !== "object") return val;
-		if (seen.has(val)) return "[Circular]";
-		seen.add(val);
-		let out;
-		if (Array.isArray(val)) out = val.map((item) => transform(item));
-		else if (val instanceof Date) out = val.toISOString();
-		else {
-			const rec = val;
-			const keys = deterministic ? Object.keys(rec).sort() : Object.keys(rec);
-			const obj = {};
-			for (const k of keys) {
-				if (k === "__proto__" || k === "constructor" || k === "prototype") continue;
-				obj[k] = transform(rec[k]);
-			}
-			out = obj;
-		}
-		seen.delete(val);
-		return out;
-	};
-	return JSON.stringify(transform(value), void 0, indent);
-}
-/**
-* Replace repeated object references with round-trippable `{ "$ref": "$..." }`
-* JSONPath pointers (the classic Crockford decycle). Pair with {@link retrocycle}
-* to reconstruct the original shared/circular graph.
-*/
-function decycleValue(value, bigint = "string") {
-	const paths = /* @__PURE__ */ new WeakMap();
-	const walk = (val, path) => {
-		if (typeof val === "bigint") return bigint === "number" ? Number(val) : val.toString();
-		if (val === null || typeof val !== "object") return val;
-		if (val instanceof Date) return val.toISOString();
-		const existing = paths.get(val);
-		if (existing !== void 0) return { $ref: existing };
-		paths.set(val, jsonPath(path));
-		if (Array.isArray(val)) return val.map((item, i) => walk(item, [...path, i]));
-		const rec = val;
-		const obj = {};
-		for (const k of Object.keys(rec)) {
-			if (k === "__proto__" || k === "constructor" || k === "prototype") continue;
-			obj[k] = walk(rec[k], [...path, k]);
-		}
-		return obj;
-	};
-	return walk(value, []);
-}
-/**
-* Inverse of {@link decycleValue}: resolve `{ "$ref": "$..." }` pointers back
-* into the live object graph (mutates and returns the parsed input).
-*/
-function retrocycle(root) {
-	const refRe = /^\$(?:\[(?:\d+|"(?:[^"\\]|\\.)*")\])*$/;
-	const resolve = (path) => {
-		const segs = [];
-		const partRe = /\[(\d+|"(?:[^"\\]|\\.)*")\]/g;
-		let m;
-		while ((m = partRe.exec(path)) !== null) {
-			const raw = m[1];
-			segs.push(raw.startsWith("\"") ? JSON.parse(raw) : Number(raw));
-		}
-		let node = root;
-		for (const s of segs) node = node[s];
-		return node;
-	};
-	const walk = (val) => {
-		if (val === null || typeof val !== "object") return;
-		const rec = val;
-		for (const k of Object.keys(rec)) {
-			const child = rec[k];
-			if (child !== null && typeof child === "object" && typeof child.$ref === "string" && refRe.test(child.$ref)) rec[k] = resolve(child.$ref);
-			else walk(child);
-		}
-	};
-	walk(root);
-	return root;
-}
-
 //#endregion
 //#region src/utils/typed-logger.ts
 /**
@@ -819,7 +728,7 @@ function createTypedLogger(logger$1, schema) {
 	function withValidation(level, fn, message, data) {
 		if (schema && data) {
 			const warnings = schema.validate(data);
-			for (const w of warnings) require_transport_manager.internalWarn(`[logixia/schema] ${w} — level=${level} message="${message}"`);
+			for (const w of warnings) require_internal_log.internalWarn(`[logixia/schema] ${w} — level=${level} message="${message}"`);
 		}
 		return fn(message, data);
 	}
@@ -829,7 +738,7 @@ function createTypedLogger(logger$1, schema) {
 			if (schema && data) {
 				const warnings = schema.validate(data);
 				const display = messageOrError instanceof Error ? messageOrError.message : messageOrError;
-				for (const w of warnings) require_transport_manager.internalWarn(`[logixia/schema] ${w} — level=error message="${display}"`);
+				for (const w of warnings) require_internal_log.internalWarn(`[logixia/schema] ${w} — level=error message="${display}"`);
 			}
 			return logger$1.error(messageOrError, data);
 		},
@@ -941,6 +850,15 @@ function wideEventMiddleware(logger$1, options = {}) {
 
 //#endregion
 //#region src/transports/otlp.transport.ts
+const HEX_32 = /^[0-9a-f]{32}$/;
+/**
+* OTLP JSON wants a 32-char lowercase hex trace id. Dashed UUIDs are
+* normalised; anything else (or all zeros) returns undefined.
+*/
+function toOtlpTraceId(id) {
+	const hex = id.replace(/-/g, "").toLowerCase();
+	return HEX_32.test(hex) && hex !== "0".repeat(32) ? hex : void 0;
+}
 /**
 * Map a logixia level name to an OTel SeverityNumber (1–24) and text.
 * Per the OTel logs SDK spec: TRACE=1, DEBUG=5, INFO=9, WARN=13, ERROR=17,
@@ -991,7 +909,7 @@ function toAnyValue(value) {
 	if (typeof value === "bigint") return { stringValue: value.toString() };
 	if (value === null || value === void 0) return { stringValue: "" };
 	try {
-		return { stringValue: JSON.stringify(value) };
+		return { stringValue: require_safe_stringify.stringifyForLog(value) };
 	} catch {
 		return { stringValue: String(value) };
 	}
@@ -1006,13 +924,19 @@ function toAttributes(rec) {
 var OtlpLogTransport = class {
 	constructor(config) {
 		this.name = "otlp";
-		this.batch = [];
 		this.flushTimer = null;
 		this.url = config.url;
 		this.headers = config.headers ?? {};
 		this.batchSize = config.batchSize ?? 100;
 		this.flushIntervalMs = config.flushIntervalMs ?? 5e3;
+		this.requestTimeoutMs = config.requestTimeoutMs ?? require_batch_buffer.DEFAULT_REQUEST_TIMEOUT_MS;
 		this.level = config.level;
+		this.buffer = new require_batch_buffer.BatchBuffer({
+			name: "OtlpLogTransport",
+			batchSize: this.batchSize,
+			maxBufferSize: config.maxBufferSize ?? require_batch_buffer.DEFAULT_MAX_BUFFER_SIZE,
+			send: (entries) => this.send(entries)
+		});
 		this.resourceAttrs = toAttributes({
 			"service.name": config.serviceName ?? "logixia",
 			...config.serviceVersion ? { "service.version": config.serviceVersion } : {},
@@ -1025,8 +949,8 @@ var OtlpLogTransport = class {
 		if (this.flushTimer.unref) this.flushTimer.unref();
 	}
 	write(entry) {
-		this.batch.push(entry);
-		if (this.batch.length >= this.batchSize) this.flush().catch(() => {});
+		this.buffer.push(entry);
+		this.buffer.flushIfFull();
 	}
 	/** Convert one entry into an OTLP LogRecord. */
 	toLogRecord(entry) {
@@ -1044,11 +968,18 @@ var OtlpLogTransport = class {
 			body: { stringValue: entry.message },
 			attributes: toAttributes(attrs)
 		};
-		if (entry.traceId) record["traceId"] = entry.traceId;
+		if (entry.traceId) {
+			const traceId = toOtlpTraceId(entry.traceId);
+			if (traceId) record["traceId"] = traceId;
+			else record["attributes"].push({
+				key: "trace_id",
+				value: { stringValue: entry.traceId }
+			});
+		}
 		return record;
 	}
 	buildPayload(entries) {
-		return JSON.stringify({ resourceLogs: [{
+		return require_safe_stringify.stringifyForLog({ resourceLogs: [{
 			resource: { attributes: this.resourceAttrs },
 			scopeLogs: [{
 				scope: { name: "logixia" },
@@ -1056,40 +987,40 @@ var OtlpLogTransport = class {
 			}]
 		}] });
 	}
-	async flush() {
-		while (this.batch.length > 0) {
-			const entries = this.batch.splice(0, this.batchSize);
-			try {
-				await this.send(entries);
-			} catch (err) {
-				require_transport_manager.internalError("OtlpLogTransport flush error", err);
-				this.batch.unshift(...entries);
-				return;
-			}
-		}
+	flush() {
+		return this.buffer.flush();
 	}
 	async send(entries) {
 		if (typeof fetch !== "function") {
-			require_transport_manager.internalWarn("OtlpLogTransport: global fetch unavailable — cannot export logs");
+			require_internal_log.internalWarn("OtlpLogTransport: global fetch unavailable — cannot export logs");
 			return;
 		}
-		const res = await fetch(this.url, {
-			method: "POST",
-			headers: {
-				"Content-Type": "application/json",
-				...this.headers
-			},
-			body: this.buildPayload(entries)
-		});
-		if (!res.ok) throw new Error(`OTLP export failed: HTTP ${res.status}`);
+		const controller = new AbortController();
+		const timer = setTimeout(() => controller.abort(), this.requestTimeoutMs);
+		try {
+			const res = await fetch(this.url, {
+				method: "POST",
+				headers: {
+					"Content-Type": "application/json",
+					...this.headers
+				},
+				body: this.buildPayload(entries),
+				signal: controller.signal
+			});
+			if (!res.ok) throw new require_batch_buffer.HttpError(res.status, "", "OTLP export");
+		} catch (err) {
+			if (controller.signal.aborted) throw new Error(`OTLP export timed out after ${this.requestTimeoutMs}ms`, { cause: err });
+			throw err;
+		} finally {
+			clearTimeout(timer);
+		}
 	}
 	async close() {
 		if (this.flushTimer) {
 			clearInterval(this.flushTimer);
 			this.flushTimer = null;
 		}
-		for (let attempt = 0; attempt < 3 && this.batch.length > 0; attempt += 1) await this.flush();
-		if (this.batch.length > 0) require_transport_manager.internalError(`OtlpLogTransport closing with ${this.batch.length} undelivered record(s)`);
+		await this.buffer.close();
 	}
 };
 
@@ -1419,6 +1350,9 @@ const logger = new require_logitron_logger_module.LogixiaLogger(DEFAULT_CONFIG);
 */
 
 //#endregion
+exports.BasicLogIndexer = require_search.BasicLogIndexer;
+exports.BasicSearchEngine = require_search.BasicSearchEngine;
+exports.CorrelationEngine = require_search.CorrelationEngine;
 exports.DEFAULT_CONFIG = DEFAULT_CONFIG;
 exports.DEFAULT_LOG_COLORS = require_logitron_logger_module.DEFAULT_LOG_COLORS;
 exports.DEFAULT_LOG_LEVELS = require_logitron_logger_module.DEFAULT_LOG_LEVELS;
@@ -1434,9 +1368,10 @@ Object.defineProperty(exports, 'KafkaTraceInterceptor', {
 });
 exports.LOGIXIA_LOGGER_CONFIG = require_logitron_logger_module.LOGIXIA_LOGGER_CONFIG;
 exports.LOGIXIA_LOGGER_PREFIX = require_logitron_logger_module.LOGIXIA_LOGGER_PREFIX;
+exports.LOGIXIA_TRACE_CONFIG = require_logitron_logger_module.LOGIXIA_TRACE_CONFIG;
 exports.LogLevel = require_logitron_logger_module.LogLevel;
 exports.LogMethod = LogMethod;
-exports.LogixiaContext = require_logitron_logger_module.LogixiaContext;
+exports.LogixiaContext = require_async_context.LogixiaContext;
 exports.LogixiaException = LogixiaException;
 Object.defineProperty(exports, 'LogixiaExceptionFilter', {
   enumerable: true,
@@ -1458,8 +1393,11 @@ Object.defineProperty(exports, 'LogixiaLoggerService', {
   }
 });
 exports.MetricsPlugin = MetricsPlugin;
+exports.NLPSearchEngine = require_search.NLPSearchEngine;
 exports.OtlpLogTransport = OtlpLogTransport;
+exports.PatternRecognitionEngine = require_search.PatternRecognitionEngine;
 exports.PluginRegistry = require_logitron_logger_module.PluginRegistry;
+exports.SearchManager = require_search.SearchManager;
 exports.TRACE_CONTEXT_KEY = require_logitron_logger_module.TRACE_CONTEXT_KEY;
 exports.TextFormatter = TextFormatter;
 exports.TraceContext = require_logitron_logger_module.TraceContext;
@@ -1470,17 +1408,18 @@ Object.defineProperty(exports, 'WebSocketTraceInterceptor', {
   }
 });
 exports._setActiveContextKey = require_logitron_logger_module._setActiveContextKey;
+exports._shutdownRegistrySize = require_logitron_logger_module._shutdownRegistrySize;
 exports.addEventFields = addEventFields;
 exports.applyRedaction = require_logitron_logger_module.applyRedaction;
-exports.createExpressContextMiddleware = require_logitron_logger_module.createExpressContextMiddleware;
-exports.createFastifyContextHook = require_logitron_logger_module.createFastifyContextHook;
+exports.createExpressContextMiddleware = require_async_context.createExpressContextMiddleware;
+exports.createFastifyContextHook = require_async_context.createFastifyContextHook;
 exports.createLevelControlHandler = createLevelControlHandler;
 exports.createLogger = createLogger;
 exports.createLoggerService = createLoggerService;
 exports.createMetricsPlugin = createMetricsPlugin;
 exports.createTraceMiddleware = require_logitron_logger_module.createTraceMiddleware;
 exports.createTypedLogger = createTypedLogger;
-exports.decycleValue = decycleValue;
+exports.decycleValue = require_safe_stringify.decycleValue;
 exports.defineLogSchema = defineLogSchema;
 exports.deregisterFromShutdown = require_logitron_logger_module.deregisterFromShutdown;
 exports.disableOtelBridge = require_logitron_logger_module.disableOtelBridge;
@@ -1503,12 +1442,13 @@ exports.redactObject = require_logitron_logger_module.redactObject;
 exports.registerForShutdown = require_logitron_logger_module.registerForShutdown;
 exports.registerLevelSignal = registerLevelSignal;
 exports.resetShutdownHandlers = require_logitron_logger_module.resetShutdownHandlers;
-exports.retrocycle = retrocycle;
+exports.retrocycle = require_safe_stringify.retrocycle;
 exports.runWithTraceId = require_logitron_logger_module.runWithTraceId;
-exports.safeStringify = safeStringify;
+exports.safeStringify = require_safe_stringify.safeStringify;
 exports.serializeError = require_logitron_logger_module.serializeError;
 exports.setEventField = setEventField;
 exports.setTraceId = require_logitron_logger_module.setTraceId;
+exports.stringifyForLog = require_safe_stringify.stringifyForLog;
 exports.toOtelSeverity = toOtelSeverity;
 exports.traceStorage = require_logitron_logger_module.traceStorage;
 exports.usePlugin = require_logitron_logger_module.usePlugin;