logixia 2.0.4 → 2.0.6

package/dist/{transport.manager-eZ_EeC00.mjs → otel-Dt5riXuE.mjs}

@@ -1,9 +1,9 @@
 import { t as __require } from "./rolldown-runtime-D3PmRqjj.mjs";
-import { n as internalLog, r as internalWarn, t as internalError } from "./internal-log-uCSd1PMc.mjs";
-import { n as protectSecrets, o as urlSecrets, r as scrubError, t as collectSecrets } from "./secret-config-BegMLkYl.mjs";
+import { n as internalLog, r as internalWarn, t as internalError } from "./internal-log-Bg4V1cPg.mjs";
+import { n as protectSecrets, o as urlSecrets, r as scrubError, t as collectSecrets } from "./secret-config-Dhb6pqTU.mjs";
 import { t as safeToString } from "./coerce.utils-B_rEudCn.mjs";
-import { i as stringifyForLog } from "./safe-stringify-BMRl3EX3.mjs";
-import { t as mergeCoreFields } from "./entry-fields-CGuvT2R0.mjs";
+import { i as stringifyForLog } from "./safe-stringify-B5p5ktFe.mjs";
+import { t as mergeCoreFields } from "./entry-fields-J1OBi24o.mjs";
 import { EventEmitter } from "node:events";
 import { promisify } from "node:util";
 import { createGzip, gzip } from "node:zlib";
@@ -42,6 +42,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) {
@@ -279,6 +280,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();
@@ -985,8 +987,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) {
@@ -1675,7 +1681,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 }
 * }
 */
@@ -1897,12 +1903,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) {
@@ -2049,7 +2085,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) {
@@ -2316,13 +2352,19 @@ function _sleep(ms) {
 	return new Promise((resolve) => setTimeout(resolve, ms));
 }
 var TransportManager = class extends 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) {
@@ -2524,19 +2566,7 @@ var TransportManager = class extends 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";
@@ -2659,6 +2689,125 @@ var TransportManager = class extends EventEmitter {
 		internalLog("Transport level preferences cleared");
 	}
 };
-export { FileTransport as a, DatabaseTransport as c, stripControlChars as d, GoogleAnalyticsTransport as i, BufferCap as l, SegmentTransport as n, DataDogTransport as o, MixpanelTransport as r, AnalyticsTransport as s, TransportManager as t, ConsoleTransport as u };
+// 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;
+}
+export { ConsoleTransport as _, getActiveOtelContext as a, TransportManager as c, GoogleAnalyticsTransport as d, FileTransport as f, BufferCap as g, DatabaseTransport as h, disableOtelBridge as i, SegmentTransport as l, AnalyticsTransport as m, _getOtelPayloadIfEnabled as n, getOtelMetaFields as o, DataDogTransport as p, _isOtelBridgeEnabled as r, initOtelBridge as s, _getOtelBridgeFieldNames as t, MixpanelTransport as u, stripControlChars as v };
 
-//# sourceMappingURL=transport.manager-eZ_EeC00.mjs.map
+//# sourceMappingURL=otel-Dt5riXuE.mjs.map