logixia 1.12.4 → 1.12.6

package/dist/index.mjs

@@ -1,6 +1,11 @@
-import { d as internalError, f as internalLog, p as internalWarn, u as safeToString } from "./transport.manager-DETpXuaY.mjs";
-import { A as redactObject, B as LogLevel, C as setTraceId, D as registerForShutdown, E as flushOnExit, F as isError, G as createExpressContextMiddleware, H as globalPluginRegistry, I as normalizeError, K as createFastifyContextHook, L as serializeError, M as getActiveOtelContext, N as getOtelMetaFields, O as resetShutdownHandlers, P as initOtelBridge, R as DEFAULT_LOG_COLORS, S as runWithTraceId, T as deregisterFromShutdown, U as usePlugin, V as PluginRegistry, W as LogixiaContext, _ as _setActiveContextKey, b as getCurrentTraceId, c as KafkaTraceInterceptor, d as __decorateMetadata, f as LogixiaLogger, g as TraceContext, h as TRACE_CONTEXT_KEY, i as WebSocketTraceInterceptor, j as disableOtelBridge, k as applyRedaction, l as LogixiaLoggerService, m as DEFAULT_TRACE_HEADERS, n as LOGIXIA_LOGGER_PREFIX, o as resolveResponseHeader, p as createLogger$1, r as LogixiaLoggerModule, s as __decorateParam, t as LOGIXIA_LOGGER_CONFIG, u as __decorate, v as createTraceMiddleware, w as traceStorage, x as getTraceContextKey, y as extractTraceId, z as DEFAULT_LOG_LEVELS } from "./logitron-logger.module-BIGTm2V6.mjs";
-import "./search-DOvSI-mb.mjs";
+import { n as internalLog, r as internalWarn, t as internalError } from "./internal-log-Cm8SOWSV.mjs";
+import { i as stringifyForLog, n as retrocycle, r as safeStringify, t as decycleValue } from "./safe-stringify-DJ66tW5I.mjs";
+import { i as HttpError, n as DEFAULT_MAX_BUFFER_SIZE, r as DEFAULT_REQUEST_TIMEOUT_MS, t as BatchBuffer } from "./batch-buffer-PGvSgbmd.mjs";
+import { n as createExpressContextMiddleware, r as createFastifyContextHook, t as LogixiaContext } from "./async-context-CwBNMm2E.mjs";
+import { A as resetShutdownHandlers, B as DEFAULT_LOG_COLORS, C as runWithTraceId, D as deregisterFromShutdown, E as _shutdownRegistrySize, F as getOtelMetaFields, G as usePlugin, H as LogLevel, I as initOtelBridge, L as isError, M as redactObject, N as disableOtelBridge, O as flushOnExit, P as getActiveOtelContext, R as normalizeError, S as getTraceContextKey, T as traceStorage, U as PluginRegistry, V as DEFAULT_LOG_LEVELS, W as globalPluginRegistry, _ as TraceContext, a as WebSocketTraceInterceptor, b as extractTraceId, c as __decorateParam, d as __decorate, f as __decorateMetadata, g as TRACE_CONTEXT_KEY, h as DEFAULT_TRACE_HEADERS, i as LogixiaLoggerModule, j as applyRedaction, k as registerForShutdown, l as KafkaTraceInterceptor, m as createLogger$1, n as LOGIXIA_LOGGER_PREFIX, p as LogixiaLogger, r as LOGIXIA_TRACE_CONFIG, s as resolveResponseHeader, t as LOGIXIA_LOGGER_CONFIG, u as LogixiaLoggerService, v as _setActiveContextKey, w as setTraceId, x as getCurrentTraceId, y as createTraceMiddleware, z as serializeError } from "./logitron-logger.module-Bs3XYZgF.mjs";
+import { t as safeToString } from "./coerce.utils-Dxv4_ikC.mjs";
+import "./transport.manager-D6KL3t9V.mjs";
+import { a as BasicSearchEngine, i as CorrelationEngine, n as PatternRecognitionEngine, o as BasicLogIndexer, r as NLPSearchEngine, t as SearchManager } from "./search-CFQRISUv.mjs";
 import { AsyncLocalStorage } from "node:async_hooks";
 import { Catch, Inject, Optional } from "@nestjs/common";
 
@@ -251,7 +256,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`);
+			internalError(`@LogMethod(${label}) ${phase} log failed: ${String(err)}`);
 		};
 		const emit$1 = (logger$1, phase, message, data) => {
 			const logFnRaw = logger$1[level];
@@ -270,7 +275,7 @@ function LogMethod(options = {}) {
 			const logger$1 = this.logger ?? 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.`);
+				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 };
@@ -329,7 +334,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`);
+				internalError(`ExceptionFilter failed to write log entry: ${String(err)}`);
 			};
 			let logPromise;
 			if (httpStatus >= 500) {
@@ -677,103 +682,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
 /**
@@ -939,6 +847,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,
@@ -989,7 +906,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: stringifyForLog(value) };
 	} catch {
 		return { stringValue: String(value) };
 	}
@@ -1004,13 +921,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 ?? DEFAULT_REQUEST_TIMEOUT_MS;
 		this.level = config.level;
+		this.buffer = new BatchBuffer({
+			name: "OtlpLogTransport",
+			batchSize: this.batchSize,
+			maxBufferSize: config.maxBufferSize ?? DEFAULT_MAX_BUFFER_SIZE,
+			send: (entries) => this.send(entries)
+		});
 		this.resourceAttrs = toAttributes({
 			"service.name": config.serviceName ?? "logixia",
 			...config.serviceVersion ? { "service.version": config.serviceVersion } : {},
@@ -1023,8 +946,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) {
@@ -1042,11 +965,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 stringifyForLog({ resourceLogs: [{
 			resource: { attributes: this.resourceAttrs },
 			scopeLogs: [{
 				scope: { name: "logixia" },
@@ -1054,40 +984,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) {
-				internalError("OtlpLogTransport flush error", err);
-				this.batch.unshift(...entries);
-				return;
-			}
-		}
+	flush() {
+		return this.buffer.flush();
 	}
 	async send(entries) {
 		if (typeof fetch !== "function") {
 			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 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) internalError(`OtlpLogTransport closing with ${this.batch.length} undelivered record(s)`);
+		await this.buffer.close();
 	}
 };
 
@@ -1417,5 +1347,5 @@ const logger = new LogixiaLogger(DEFAULT_CONFIG);
 */
 
 //#endregion
-export { DEFAULT_CONFIG, DEFAULT_LOG_COLORS, DEFAULT_LOG_LEVELS, DEFAULT_TRACE_HEADERS, ErrorResponseBuilder, InjectLogger, JsonFormatter, KafkaTraceInterceptor, LOGIXIA_LOGGER_CONFIG, LOGIXIA_LOGGER_PREFIX, LogLevel, LogMethod, LogixiaContext, LogixiaException, LogixiaExceptionFilter, LogixiaLogger, LogixiaLoggerModule, LogixiaLoggerService, MetricsPlugin, OtlpLogTransport, PluginRegistry, TRACE_CONTEXT_KEY, TextFormatter, TraceContext, WebSocketTraceInterceptor, _setActiveContextKey, addEventFields, applyRedaction, createExpressContextMiddleware, createFastifyContextHook, createLevelControlHandler, createLogger, createLoggerService, createMetricsPlugin, createTraceMiddleware, createTypedLogger, decycleValue, defineLogSchema, deregisterFromShutdown, disableOtelBridge, extractTraceId, flushOnExit, generateRequestId, generateTraceId, getActiveOtelContext, getCurrentTraceId, getEventFields, getOtelMetaFields, getTraceContextKey, globalPluginRegistry, initOtelBridge, isError, isLogixiaException, logger, normalizeError, redactObject, registerForShutdown, registerLevelSignal, resetShutdownHandlers, retrocycle, runWithTraceId, safeStringify, serializeError, setEventField, setTraceId, toOtelSeverity, traceStorage, usePlugin, wideEventMiddleware, withWideEvent };
+export { BasicLogIndexer, BasicSearchEngine, CorrelationEngine, DEFAULT_CONFIG, DEFAULT_LOG_COLORS, DEFAULT_LOG_LEVELS, DEFAULT_TRACE_HEADERS, ErrorResponseBuilder, InjectLogger, JsonFormatter, KafkaTraceInterceptor, LOGIXIA_LOGGER_CONFIG, LOGIXIA_LOGGER_PREFIX, LOGIXIA_TRACE_CONFIG, LogLevel, LogMethod, LogixiaContext, LogixiaException, LogixiaExceptionFilter, LogixiaLogger, LogixiaLoggerModule, LogixiaLoggerService, MetricsPlugin, NLPSearchEngine, OtlpLogTransport, PatternRecognitionEngine, PluginRegistry, SearchManager, TRACE_CONTEXT_KEY, TextFormatter, TraceContext, WebSocketTraceInterceptor, _setActiveContextKey, _shutdownRegistrySize, addEventFields, applyRedaction, createExpressContextMiddleware, createFastifyContextHook, createLevelControlHandler, createLogger, createLoggerService, createMetricsPlugin, createTraceMiddleware, createTypedLogger, decycleValue, defineLogSchema, deregisterFromShutdown, disableOtelBridge, extractTraceId, flushOnExit, generateRequestId, generateTraceId, getActiveOtelContext, getCurrentTraceId, getEventFields, getOtelMetaFields, getTraceContextKey, globalPluginRegistry, initOtelBridge, isError, isLogixiaException, logger, normalizeError, redactObject, registerForShutdown, registerLevelSignal, resetShutdownHandlers, retrocycle, runWithTraceId, safeStringify, serializeError, setEventField, setTraceId, stringifyForLog, toOtelSeverity, traceStorage, usePlugin, wideEventMiddleware, withWideEvent };
 //# sourceMappingURL=index.mjs.map