logixia 2.0.4 → 2.0.7

package/dist/{transport.manager-DkcEOlqV.js → otel-ChnVYRLA.js}

@@ -1,8 +1,8 @@
-const require_secret_config = require("./secret-config-CBZBs0p1.js");
-const require_internal_log = require("./internal-log-b0Vp4qrB.js");
+const require_secret_config = require("./secret-config-BvFl2dC8.js");
+const require_internal_log = require("./internal-log-DwqTjhpb.js");
 const require_coerce_utils = require("./coerce.utils-C1C5sIX0.js");
-const require_safe_stringify = require("./safe-stringify-DLz1Kz3o.js");
-const require_entry_fields = require("./entry-fields-RLd1jCoR.js");
+const require_safe_stringify = require("./safe-stringify-CN7icp8S.js");
+const require_entry_fields = require("./entry-fields-CVwoQplO.js");
 let node_events = require("node:events");
 let node_util = require("node:util");
 let node_zlib = require("node:zlib");
@@ -43,6 +43,7 @@ var ConsoleTransport = class ConsoleTransport {
 	constructor(config = {}) {
 		this.config = config;
 		this.name = "console";
+		this.level = config.level;
 		if (config.filter) this.filter = config.filter;
 	}
 	write(entry) {
@@ -280,6 +281,7 @@ var DatabaseTransport = class {
 		this.batchSize = config.batchSize || 100;
 		this.flushInterval = config.flushInterval || 5e3;
 		this.cap = new BufferCap("DatabaseTransport", config.maxBufferSize, this.batchSize);
+		this.level = config.level;
 		if (config.filter) this.filter = config.filter;
 		if (config.table) validateSqlIdentifier(config.table, "table");
 		this.setupFlushTimer();
@@ -986,8 +988,12 @@ function tag(key, value) {
 *
 * The API key is transmitted via the `DD-API-KEY` request header — never in the URL.
 *
+* Metric names keep the legacy `logitron.logs.<level>` prefix (kept for
+* dashboards and monitors that already query it; renaming would be a breaking
+* change). Query `logitron.logs.error`, not `logixia.logs.error`.
+*
 * @example
-* transports: { datadog: { apiKey: process.env.DD_API_KEY, service: 'api', env: 'production' } }
+* analytics: { datadog: { apiKey: process.env.DD_API_KEY, service: 'api', env: 'production' } }
 */
 var DataDogTransport = class extends AnalyticsTransport {
 	constructor(config) {
@@ -1676,7 +1682,7 @@ var FileTransport = class {
 * Sends log entries as Google Analytics 4 Measurement Protocol events.
 *
 * @example
-* transports: {
+* analytics: {
 *   googleAnalytics: { measurementId: 'G-XXXXXXX', apiSecret: process.env.GA_API_SECRET }
 * }
 */
@@ -1898,12 +1904,42 @@ var GoogleAnalyticsTransport = class extends AnalyticsTransport {
 		await this.sendEvent(event);
 	}
 };
+// src/transports/level-filter.ts
+/** Severity values of the built-in levels; lower is more severe (same scale as the logger). */
+const BUILTIN_LEVEL_VALUES = {
+	error: 0,
+	warn: 1,
+	info: 2,
+	debug: 3,
+	trace: 4,
+	verbose: 5
+};
+/** Built-in levels plus the logger's custom `levelOptions.levels`. */
+function buildLevelValues(custom) {
+	return new Map([...Object.entries(BUILTIN_LEVEL_VALUES), ...Object.entries(custom ?? {})]);
+}
+function lookup(values, level) {
+	return values.get(level) ?? values.get(level.toLowerCase());
+}
+/**
+* Whether an entry at `level` passes a transport's minimum `threshold`, using the
+* logger's scale (an entry passes when its value is <= the threshold's value).
+* The logger has already rejected unknown entry levels, so an unknown entry level
+* or threshold here does not filter.
+*/
+function meetsTransportLevel(threshold, level, values) {
+	if (!threshold) return true;
+	const min = lookup(values, threshold);
+	const actual = lookup(values, level);
+	if (min === void 0 || actual === void 0) return true;
+	return actual <= min;
+}
 // 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 } }
+* analytics: { mixpanel: { token: process.env.MIXPANEL_TOKEN } }
 */
 var MixpanelTransport = class extends AnalyticsTransport {
 	constructor(config) {
@@ -2050,7 +2086,7 @@ const LOGIXIA_VERSION = "1.12.0";
 * Sends log entries as Segment track/identify events via the HTTP Tracking API.
 *
 * @example
-* transports: { segment: { writeKey: process.env.SEGMENT_WRITE_KEY } }
+* analytics: { segment: { writeKey: process.env.SEGMENT_WRITE_KEY } }
 */
 var SegmentTransport = class extends AnalyticsTransport {
 	constructor(config) {
@@ -2317,13 +2353,19 @@ function _sleep(ms) {
 	return new Promise((resolve) => setTimeout(resolve, ms));
 }
 var TransportManager = class extends node_events.EventEmitter {
-	constructor(config = {}) {
+	/**
+	* @param config  Transport configuration.
+	* @param levels  The logger's `levelOptions.levels`; used with the built-in levels
+	*                to compare entries against each transport's `level`.
+	*/
+	constructor(config = {}, levels) {
 		super();
 		this.transports = /* @__PURE__ */ new Map();
 		this.metrics = /* @__PURE__ */ new Map();
 		this.isShuttingDown = false;
 		this.transportLevelPreferences = /* @__PURE__ */ new Map();
 		this.warnedPromptDeprecated = false;
+		this.levelValues = buildLevelValues(levels);
 		this.setupTransports(config);
 	}
 	setupTransports(config) {
@@ -2525,19 +2567,7 @@ var TransportManager = class extends node_events.EventEmitter {
 	}
 	shouldTransportHandle(transport, level, transportId) {
 		if (transportId && this.transportLevelPreferences.has(transportId)) return this.transportLevelPreferences.get(transportId).includes(level.toLowerCase());
-		if (!transport.level) return true;
-		const levels = [
-			"error",
-			"warn",
-			"info",
-			"debug",
-			"trace",
-			"verbose"
-		];
-		const transportLevelIndex = levels.indexOf(transport.level.toLowerCase());
-		const entryLevelIndex = levels.indexOf(level.toLowerCase());
-		if (transportLevelIndex === -1 || entryLevelIndex === -1) return true;
-		return entryLevelIndex <= transportLevelIndex;
+		return meetsTransportLevel(transport.level, level, this.levelValues);
 	}
 	getTransportType(transport) {
 		if (transport.name === "console") return "console";
@@ -2660,6 +2690,125 @@ var TransportManager = class extends node_events.EventEmitter {
 		require_internal_log.internalLog("Transport level preferences cleared");
 	}
 };
+// src/utils/otel.ts
+/** W3C trace-flags bit 0: the span is sampled (`TraceFlags.SAMPLED` in the OTel API). */
+const TRACE_FLAG_SAMPLED = 1;
+let _otelApi;
+function tryLoadOtelApi() {
+	if (_otelApi !== void 0) return _otelApi;
+	try {
+		_otelApi = require("@opentelemetry/api");
+		return _otelApi;
+	} catch {
+		_otelApi = null;
+		return null;
+	}
+}
+/**
+* Read the currently active OTel span context (if any) and return its fields
+* in a plain object suitable for spreading into a log entry.
+*
+* Returns `undefined` when:
+* - `@opentelemetry/api` is not installed
+* - No active span exists (root context)
+* - The span context is invalid (all-zeros)
+*/
+function getActiveOtelContext(opts = {}) {
+	const api = tryLoadOtelApi();
+	if (!api) return void 0;
+	try {
+		const ctx = api.context.active();
+		const sc = api.trace.getSpanContext(ctx);
+		if (!sc || !api.trace.isSpanContextValid(sc)) return void 0;
+		const isSampled = (sc.traceFlags & TRACE_FLAG_SAMPLED) === TRACE_FLAG_SAMPLED;
+		if (opts.sampledOnly && !isSampled) return void 0;
+		return {
+			traceId: sc.traceId,
+			spanId: sc.spanId,
+			traceFlags: sc.traceFlags,
+			isSampled
+		};
+	} catch {
+		return;
+	}
+}
+/**
+* Returns a metadata object with OTel context fields ready to merge into a log call,
+* using the configured field names.
+*
+* Returns `{}` when no active span exists (safe to spread unconditionally).
+*
+* @example
+* ```ts
+* await logger.info('Payment processed', {
+*   ...getOtelMetaFields(),
+*   orderId: 'ord_123',
+* });
+* ```
+*/
+function getOtelMetaFields(opts = {}) {
+	const { traceIdField = "traceId", spanIdField = "spanId", traceFlagsField = "traceFlags" } = opts;
+	const ctx = getActiveOtelContext(opts);
+	if (!ctx) return {};
+	return {
+		[traceIdField]: ctx.traceId,
+		[spanIdField]: ctx.spanId,
+		[traceFlagsField]: ctx.traceFlags
+	};
+}
+let _bridgeOptions = null;
+/**
+* Initialise the global OTel bridge.
+*
+* Once called, logixia's internal log pipeline checks for an active OTel span
+* on **every** log call and automatically merges the span context into the
+* entry's metadata — no per-call wiring needed.
+*
+* Call once at app startup, **after** the OTel SDK has been initialised:
+* ```ts
+* import { initOtelBridge } from 'logixia';
+* initOtelBridge();
+* ```
+*/
+function initOtelBridge(opts = {}) {
+	_bridgeOptions = opts;
+}
+/**
+* @internal
+* True when initOtelBridge() has been called. Lets the logger hot path skip the
+* `_getOtelPayloadIfEnabled()` call (and its `{}` allocation + Object.keys) on
+* every log when the bridge is off — the overwhelmingly common case.
+*/
+function _isOtelBridgeEnabled() {
+	return _bridgeOptions !== null;
+}
+/**
+* @internal
+* Used by the core logger to inject OTel context when the bridge is active.
+* Returns `{}` when the bridge is not initialised or no active span exists.
+*/
+function _getOtelPayloadIfEnabled() {
+	if (!_bridgeOptions) return {};
+	return getOtelMetaFields(_bridgeOptions);
+}
+/**
+* @internal
+* Payload field names the active bridge writes the trace and span ids to, or
+* `undefined` when the bridge is not initialised.
+*/
+function _getOtelBridgeFieldNames() {
+	if (!_bridgeOptions) return void 0;
+	return {
+		traceIdField: _bridgeOptions.traceIdField ?? "traceId",
+		spanIdField: _bridgeOptions.spanIdField ?? "spanId"
+	};
+}
+/**
+* Disable the OTel bridge (useful for tests).
+*/
+function disableOtelBridge() {
+	_bridgeOptions = null;
+}
 Object.defineProperty(exports, "AnalyticsTransport", {
 	enumerable: true,
 	get: function() {
@@ -2720,6 +2869,48 @@ Object.defineProperty(exports, "TransportManager", {
 		return TransportManager;
 	}
 });
+Object.defineProperty(exports, "_getOtelBridgeFieldNames", {
+	enumerable: true,
+	get: function() {
+		return _getOtelBridgeFieldNames;
+	}
+});
+Object.defineProperty(exports, "_getOtelPayloadIfEnabled", {
+	enumerable: true,
+	get: function() {
+		return _getOtelPayloadIfEnabled;
+	}
+});
+Object.defineProperty(exports, "_isOtelBridgeEnabled", {
+	enumerable: true,
+	get: function() {
+		return _isOtelBridgeEnabled;
+	}
+});
+Object.defineProperty(exports, "disableOtelBridge", {
+	enumerable: true,
+	get: function() {
+		return disableOtelBridge;
+	}
+});
+Object.defineProperty(exports, "getActiveOtelContext", {
+	enumerable: true,
+	get: function() {
+		return getActiveOtelContext;
+	}
+});
+Object.defineProperty(exports, "getOtelMetaFields", {
+	enumerable: true,
+	get: function() {
+		return getOtelMetaFields;
+	}
+});
+Object.defineProperty(exports, "initOtelBridge", {
+	enumerable: true,
+	get: function() {
+		return initOtelBridge;
+	}
+});
 Object.defineProperty(exports, "stripControlChars", {
 	enumerable: true,
 	get: function() {
@@ -2727,4 +2918,4 @@ Object.defineProperty(exports, "stripControlChars", {
 	}
 });
 
-//# sourceMappingURL=transport.manager-DkcEOlqV.js.map
+//# sourceMappingURL=otel-ChnVYRLA.js.map