@iii-dev/helpers 0.19.4-alpha.2 → 0.19.4-alpha.4

package/dist/observability/index.cjs

@@ -0,0 +1,490 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_telemetry_system = require('../telemetry-system-CY8_emop.cjs');
+let _opentelemetry_api_logs = require("@opentelemetry/api-logs");
+let _opentelemetry_api = require("@opentelemetry/api");
+let node_perf_hooks = require("node:perf_hooks");
+
+//#region src/observability/logger.ts
+/**
+* Structured logger that emits logs as OpenTelemetry LogRecords.
+*
+* Every log call automatically captures the active trace and span context,
+* correlating your logs with distributed traces without any manual wiring.
+* When OTel is not initialized, Logger gracefully falls back to `console.*`.
+*
+* Pass structured data as the second argument to any log method. Using an
+* object of key-value pairs (instead of string interpolation) lets you
+* filter, aggregate, and build dashboards in your observability backend.
+*
+* @example
+* ```typescript
+* import { Logger } from 'iii-sdk'
+*
+* const logger = new Logger()
+*
+* // Basic logging — trace context is injected automatically
+* logger.info('Worker connected')
+*
+* // Structured context for dashboards and alerting
+* logger.info('Order processed', { orderId: 'ord_123', amount: 49.99, currency: 'USD' })
+* logger.warn('Retry attempt', { attempt: 3, maxRetries: 5, endpoint: '/api/charge' })
+* logger.error('Payment failed', { orderId: 'ord_123', gateway: 'stripe', errorCode: 'card_declined' })
+* ```
+*/
+var Logger = class {
+	_otelLogger = null;
+	get otelLogger() {
+		if (!this._otelLogger) this._otelLogger = require_telemetry_system.getLogger();
+		return this._otelLogger;
+	}
+	constructor(traceId, serviceName, spanId) {
+		this.traceId = traceId;
+		this.serviceName = serviceName;
+		this.spanId = spanId;
+	}
+	emit(message, severity, data) {
+		const attributes = {};
+		const traceId = this.traceId ?? require_telemetry_system.currentTraceId();
+		const spanId = this.spanId ?? require_telemetry_system.currentSpanId();
+		if (traceId) attributes.trace_id = traceId;
+		if (spanId) attributes.span_id = spanId;
+		if (this.serviceName) attributes["service.name"] = this.serviceName;
+		if (data !== void 0) attributes["log.data"] = data;
+		if (this.otelLogger) this.otelLogger.emit({
+			severityNumber: severity,
+			body: message,
+			attributes: Object.keys(attributes).length > 0 ? attributes : void 0
+		});
+		else switch (severity) {
+			case _opentelemetry_api_logs.SeverityNumber.DEBUG:
+				console.debug(message, data);
+				break;
+			case _opentelemetry_api_logs.SeverityNumber.INFO:
+				console.info(message, data);
+				break;
+			case _opentelemetry_api_logs.SeverityNumber.WARN:
+				console.warn(message, data);
+				break;
+			case _opentelemetry_api_logs.SeverityNumber.ERROR:
+				console.error(message, data);
+				break;
+			default: console.log(message, data);
+		}
+	}
+	/**
+	* Log an info-level message.
+	*
+	* @param message - Human-readable log message.
+	* @param data - Structured context attached as OTel log attributes.
+	*   Use key-value objects to enable filtering and aggregation in your
+	*   observability backend (e.g. Grafana, Datadog, New Relic).
+	*
+	* @example
+	* ```typescript
+	* logger.info('Order processed', { orderId: 'ord_123', status: 'completed' })
+	* ```
+	*/
+	info(message, data) {
+		this.emit(message, _opentelemetry_api_logs.SeverityNumber.INFO, data);
+	}
+	/**
+	* Log a warning-level message.
+	*
+	* @param message - Human-readable log message.
+	* @param data - Structured context attached as OTel log attributes.
+	*   Use key-value objects to enable filtering and aggregation in your
+	*   observability backend (e.g. Grafana, Datadog, New Relic).
+	*
+	* @example
+	* ```typescript
+	* logger.warn('Retry attempt', { attempt: 3, maxRetries: 5, endpoint: '/api/charge' })
+	* ```
+	*/
+	warn(message, data) {
+		this.emit(message, _opentelemetry_api_logs.SeverityNumber.WARN, data);
+	}
+	/**
+	* Log an error-level message.
+	*
+	* @param message - Human-readable log message.
+	* @param data - Structured context attached as OTel log attributes.
+	*   Use key-value objects to enable filtering and aggregation in your
+	*   observability backend (e.g. Grafana, Datadog, New Relic).
+	*
+	* @example
+	* ```typescript
+	* logger.error('Payment failed', { orderId: 'ord_123', gateway: 'stripe', errorCode: 'card_declined' })
+	* ```
+	*/
+	error(message, data) {
+		this.emit(message, _opentelemetry_api_logs.SeverityNumber.ERROR, data);
+	}
+	/**
+	* Log a debug-level message.
+	*
+	* @param message - Human-readable log message.
+	* @param data - Structured context attached as OTel log attributes.
+	*   Use key-value objects to enable filtering and aggregation in your
+	*   observability backend (e.g. Grafana, Datadog, New Relic).
+	*
+	* @example
+	* ```typescript
+	* logger.debug('Cache lookup', { key: 'user:42', hit: false })
+	* ```
+	*/
+	debug(message, data) {
+		this.emit(message, _opentelemetry_api_logs.SeverityNumber.DEBUG, data);
+	}
+};
+
+//#endregion
+//#region src/observability/http-instrumentation.ts
+const SAFE_REQUEST_HEADERS = ["content-type", "accept"];
+const SAFE_RESPONSE_HEADERS = ["content-type"];
+/**
+* Execute a fetch request inside an OTel CLIENT span.
+*
+* Mirrors the Rust execute_traced_request shape: injects W3C traceparent into
+* outgoing headers, records HTTP semantic-convention attributes, and sets
+* ERROR span status for HTTP responses with status >= 400 or network errors.
+*/
+async function executeTracedRequest(input, init) {
+	const tracer = init?.tracer ?? _opentelemetry_api.trace.getTracer("iii-node-sdk");
+	const rawUrl = typeof input === "string" ? input : input instanceof URL ? input.toString() : input.url;
+	let url;
+	try {
+		url = new URL(rawUrl);
+	} catch {
+		url = null;
+	}
+	const method = (init?.method ?? (typeof input === "object" && "method" in input ? input.method : "GET") ?? "GET").toUpperCase();
+	const name = url?.pathname ? `${method} ${url.pathname}` : method;
+	return tracer.startActiveSpan(name, {
+		kind: _opentelemetry_api.SpanKind.CLIENT,
+		attributes: {
+			"http.request.method": method,
+			"url.full": url?.toString() ?? rawUrl,
+			"network.protocol.name": "http",
+			...url ? {
+				"server.address": url.hostname,
+				"url.scheme": url.protocol.replace(":", ""),
+				"url.path": url.pathname
+			} : {},
+			...url?.port ? { "server.port": Number(url.port) } : {},
+			...url?.search ? { "url.query": url.search.slice(1) } : {}
+		}
+	}, async (span) => {
+		try {
+			const baseHeaders = typeof input === "object" && "headers" in input ? input.headers : void 0;
+			const headers = new Headers(baseHeaders);
+			if (init?.headers) for (const [k, v] of new Headers(init.headers).entries()) headers.set(k, v);
+			const carrier = {};
+			_opentelemetry_api.propagation.inject(_opentelemetry_api.context.active(), carrier);
+			for (const [k, v] of Object.entries(carrier)) headers.set(k, v);
+			for (const h of SAFE_REQUEST_HEADERS) {
+				const v = headers.get(h);
+				if (v) span.setAttribute(`http.request.header.${h}`, v);
+			}
+			const response = await fetch(input, {
+				...init,
+				headers
+			});
+			span.setAttribute("http.response.status_code", response.status);
+			const cl = response.headers.get("content-length");
+			if (cl) span.setAttribute("http.response.body.size", Number(cl));
+			for (const h of SAFE_RESPONSE_HEADERS) {
+				const v = response.headers.get(h);
+				if (v) span.setAttribute(`http.response.header.${h}`, v);
+			}
+			if (response.status >= 400) {
+				span.setStatus({
+					code: _opentelemetry_api.SpanStatusCode.ERROR,
+					message: String(response.status)
+				});
+				span.setAttribute("error.type", String(response.status));
+			} else span.setStatus({ code: _opentelemetry_api.SpanStatusCode.OK });
+			return response;
+		} catch (err) {
+			const error = err;
+			span.recordException(error);
+			span.setStatus({
+				code: _opentelemetry_api.SpanStatusCode.ERROR,
+				message: error.message
+			});
+			span.setAttribute("error.type", error.name);
+			throw err;
+		} finally {
+			span.end();
+		}
+	});
+}
+
+//#endregion
+//#region src/observability/worker-metrics.ts
+/**
+* Worker metrics collection for the III Node SDK.
+*
+* Collects CPU, memory, and event loop metrics for worker health monitoring.
+* Uses the Node.js built-in `monitorEventLoopDelay` API for accurate
+* event loop lag measurements.
+*/
+/**
+* Collects worker resource metrics including CPU, memory, and event loop lag.
+*
+* Uses the Node.js `monitorEventLoopDelay` API for high-precision event loop
+* delay measurements instead of manual `setImmediate` timing.
+*
+* @example
+* ```typescript
+* const collector = new WorkerMetricsCollector()
+*
+* // Collect metrics periodically
+* setInterval(() => {
+*   const metrics = collector.collect()
+*   console.log('CPU:', metrics.cpu_percent, '%')
+*   console.log('Event Loop Lag:', metrics.event_loop_lag_ms, 'ms')
+* }, 5000)
+*
+* // Clean up when done
+* collector.stopMonitoring()
+* ```
+*/
+var WorkerMetricsCollector = class {
+	startTime;
+	lastCpuUsage;
+	lastCpuTime;
+	eventLoopHistogram = null;
+	/**
+	* Creates a new WorkerMetricsCollector instance.
+	*
+	* @param options - Configuration options
+	*/
+	constructor(options = {}) {
+		this.startTime = Date.now();
+		this.lastCpuUsage = process.cpuUsage();
+		this.lastCpuTime = node_perf_hooks.performance.now();
+		this.startEventLoopMonitoring(options.eventLoopResolutionMs ?? 20);
+	}
+	/**
+	* Starts the event loop delay histogram monitoring.
+	*
+	* @param resolutionMs - Histogram resolution in milliseconds
+	*/
+	startEventLoopMonitoring(resolutionMs) {
+		this.eventLoopHistogram = (0, node_perf_hooks.monitorEventLoopDelay)({ resolution: Number.isFinite(resolutionMs) && resolutionMs > 0 ? Math.max(1, Math.floor(resolutionMs)) : 20 });
+		this.eventLoopHistogram.enable();
+	}
+	/**
+	* Stops the event loop monitoring and releases resources.
+	* Should be called when the collector is no longer needed.
+	*/
+	stopMonitoring() {
+		if (this.eventLoopHistogram) {
+			this.eventLoopHistogram.disable();
+			this.eventLoopHistogram = null;
+		}
+	}
+	/**
+	* Collects current worker metrics.
+	*
+	* This method calculates CPU usage since the last collection,
+	* reads memory usage, and gets event loop delay statistics.
+	* The event loop histogram is reset after each collection for
+	* accurate per-interval measurements.
+	*
+	* @returns Current worker metrics snapshot
+	*/
+	collect() {
+		const memoryUsage = process.memoryUsage();
+		const cpuUsage = process.cpuUsage();
+		const now = node_perf_hooks.performance.now();
+		const cpuDelta = {
+			user: cpuUsage.user - this.lastCpuUsage.user,
+			system: cpuUsage.system - this.lastCpuUsage.system
+		};
+		const timeDelta = (now - this.lastCpuTime) * 1e3;
+		const cpuPercent = timeDelta > 0 ? (cpuDelta.user + cpuDelta.system) / timeDelta * 100 : 0;
+		this.lastCpuUsage = cpuUsage;
+		this.lastCpuTime = now;
+		let eventLoopLagMs = 0;
+		if (this.eventLoopHistogram) {
+			eventLoopLagMs = this.eventLoopHistogram.mean / 1e6;
+			this.eventLoopHistogram.reset();
+		}
+		return {
+			memory_heap_used: memoryUsage.heapUsed,
+			memory_heap_total: memoryUsage.heapTotal,
+			memory_rss: memoryUsage.rss,
+			memory_external: memoryUsage.external,
+			cpu_user_micros: cpuUsage.user,
+			cpu_system_micros: cpuUsage.system,
+			cpu_percent: Math.min(cpuPercent, 100),
+			event_loop_lag_ms: eventLoopLagMs,
+			uptime_seconds: Math.floor((Date.now() - this.startTime) / 1e3),
+			timestamp_ms: Date.now(),
+			runtime: "node"
+		};
+	}
+};
+
+//#endregion
+//#region src/observability/otel-worker-gauges.ts
+let registeredGauges = false;
+let metricsCollector = null;
+let registeredMeter = null;
+let registeredBatchCallback = null;
+let registeredObservables = [];
+function registerWorkerGauges(meter, options) {
+	if (registeredGauges) return;
+	const { workerId, workerName } = options;
+	const baseAttributes = {
+		"worker.id": workerId,
+		...workerName && { "worker.name": workerName }
+	};
+	metricsCollector = new WorkerMetricsCollector();
+	const memoryHeapUsed = meter.createObservableGauge("iii.worker.memory.heap_used", {
+		description: "Worker heap memory used in bytes",
+		unit: "bytes"
+	});
+	const memoryHeapTotal = meter.createObservableGauge("iii.worker.memory.heap_total", {
+		description: "Worker total heap memory in bytes",
+		unit: "bytes"
+	});
+	const memoryRss = meter.createObservableGauge("iii.worker.memory.rss", {
+		description: "Worker resident set size in bytes",
+		unit: "bytes"
+	});
+	const memoryExternal = meter.createObservableGauge("iii.worker.memory.external", {
+		description: "Worker external memory in bytes",
+		unit: "bytes"
+	});
+	const cpuPercent = meter.createObservableGauge("iii.worker.cpu.percent", {
+		description: "Worker CPU usage percentage",
+		unit: "%"
+	});
+	const cpuUserMicros = meter.createObservableGauge("iii.worker.cpu.user_micros", {
+		description: "Worker CPU user time in microseconds",
+		unit: "us"
+	});
+	const cpuSystemMicros = meter.createObservableGauge("iii.worker.cpu.system_micros", {
+		description: "Worker CPU system time in microseconds",
+		unit: "us"
+	});
+	const eventLoopLag = meter.createObservableGauge("iii.worker.event_loop.lag_ms", {
+		description: "Worker event loop lag in milliseconds",
+		unit: "ms"
+	});
+	const uptimeSeconds = meter.createObservableGauge("iii.worker.uptime_seconds", {
+		description: "Worker uptime in seconds",
+		unit: "s"
+	});
+	const batchCallback = (observableResult) => {
+		if (!metricsCollector) return;
+		const metrics = metricsCollector.collect();
+		if (metrics.memory_heap_used !== void 0) observableResult.observe(memoryHeapUsed, metrics.memory_heap_used, baseAttributes);
+		if (metrics.memory_heap_total !== void 0) observableResult.observe(memoryHeapTotal, metrics.memory_heap_total, baseAttributes);
+		if (metrics.memory_rss !== void 0) observableResult.observe(memoryRss, metrics.memory_rss, baseAttributes);
+		if (metrics.memory_external !== void 0) observableResult.observe(memoryExternal, metrics.memory_external, baseAttributes);
+		if (metrics.cpu_percent !== void 0) observableResult.observe(cpuPercent, metrics.cpu_percent, baseAttributes);
+		if (metrics.cpu_user_micros !== void 0) observableResult.observe(cpuUserMicros, metrics.cpu_user_micros, baseAttributes);
+		if (metrics.cpu_system_micros !== void 0) observableResult.observe(cpuSystemMicros, metrics.cpu_system_micros, baseAttributes);
+		if (metrics.event_loop_lag_ms !== void 0) observableResult.observe(eventLoopLag, metrics.event_loop_lag_ms, baseAttributes);
+		if (metrics.uptime_seconds !== void 0) observableResult.observe(uptimeSeconds, metrics.uptime_seconds, baseAttributes);
+	};
+	meter.addBatchObservableCallback(batchCallback, [
+		memoryHeapUsed,
+		memoryHeapTotal,
+		memoryRss,
+		memoryExternal,
+		cpuPercent,
+		cpuUserMicros,
+		cpuSystemMicros,
+		eventLoopLag,
+		uptimeSeconds
+	]);
+	registeredMeter = meter;
+	registeredBatchCallback = batchCallback;
+	registeredObservables = [
+		memoryHeapUsed,
+		memoryHeapTotal,
+		memoryRss,
+		memoryExternal,
+		cpuPercent,
+		cpuUserMicros,
+		cpuSystemMicros,
+		eventLoopLag,
+		uptimeSeconds
+	];
+	registeredGauges = true;
+}
+function stopWorkerGauges() {
+	if (registeredMeter && registeredBatchCallback) registeredMeter.removeBatchObservableCallback(registeredBatchCallback, registeredObservables);
+	if (metricsCollector) {
+		metricsCollector.stopMonitoring();
+		metricsCollector = null;
+	}
+	registeredMeter = null;
+	registeredBatchCallback = null;
+	registeredObservables = [];
+	registeredGauges = false;
+}
+
+//#endregion
+//#region src/observability/utils.ts
+/**
+* Safely stringify a value, handling circular references, BigInt, and other edge cases.
+* Returns "[unserializable]" if serialization fails for any reason.
+*/
+function safeStringify(value) {
+	const seen = /* @__PURE__ */ new WeakSet();
+	try {
+		return JSON.stringify(value, (_key, val) => {
+			if (typeof val === "bigint") return val.toString();
+			if (val !== null && typeof val === "object") {
+				if (seen.has(val)) return "[Circular]";
+				seen.add(val);
+			}
+			return val;
+		}) ?? "[unserializable]";
+	} catch {
+		return "[unserializable]";
+	}
+}
+
+//#endregion
+exports.BaggageSpanProcessor = require_telemetry_system.BaggageSpanProcessor;
+exports.DEFAULT_ALLOWLIST = require_telemetry_system.DEFAULT_ALLOWLIST;
+exports.Logger = Logger;
+exports.REDACTED_PLACEHOLDER = require_telemetry_system.REDACTED_PLACEHOLDER;
+exports.SeverityNumber = _opentelemetry_api_logs.SeverityNumber;
+exports.WorkerMetricsCollector = WorkerMetricsCollector;
+exports.currentSpanId = require_telemetry_system.currentSpanId;
+exports.currentSpanIsRecording = require_telemetry_system.currentSpanIsRecording;
+exports.currentTraceId = require_telemetry_system.currentTraceId;
+exports.executeTracedRequest = executeTracedRequest;
+exports.extractBaggage = require_telemetry_system.extractBaggage;
+exports.extractContext = require_telemetry_system.extractContext;
+exports.extractTraceparent = require_telemetry_system.extractTraceparent;
+exports.flushOtel = require_telemetry_system.flushOtel;
+exports.getAllBaggage = require_telemetry_system.getAllBaggage;
+exports.getBaggageEntry = require_telemetry_system.getBaggageEntry;
+exports.getLogger = require_telemetry_system.getLogger;
+exports.initOtel = require_telemetry_system.initOtel;
+exports.injectBaggage = require_telemetry_system.injectBaggage;
+exports.injectTraceparent = require_telemetry_system.injectTraceparent;
+exports.patchGlobalFetch = require_telemetry_system.patchGlobalFetch;
+exports.recordSpanEvent = require_telemetry_system.recordSpanEvent;
+exports.redact = require_telemetry_system.redact;
+exports.redactAndTruncate = require_telemetry_system.redactAndTruncate;
+exports.registerWorkerGauges = registerWorkerGauges;
+exports.removeBaggageEntry = require_telemetry_system.removeBaggageEntry;
+exports.resolveMaxBytesFromEnv = require_telemetry_system.resolveMaxBytesFromEnv;
+exports.safeStringify = safeStringify;
+exports.setBaggageEntry = require_telemetry_system.setBaggageEntry;
+exports.setCurrentSpanAttribute = require_telemetry_system.setCurrentSpanAttribute;
+exports.setCurrentSpanError = require_telemetry_system.setCurrentSpanError;
+exports.shutdownOtel = require_telemetry_system.shutdownOtel;
+exports.stopWorkerGauges = stopWorkerGauges;
+exports.unpatchGlobalFetch = require_telemetry_system.unpatchGlobalFetch;
+exports.withSpan = require_telemetry_system.withSpan;
+//# sourceMappingURL=index.cjs.map

package/dist/observability/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["getOtelLogger","currentTraceId","currentSpanId","SeverityNumber","trace","SpanKind","otelContext","SpanStatusCode","performance"],"sources":["../../src/observability/logger.ts","../../src/observability/http-instrumentation.ts","../../src/observability/worker-metrics.ts","../../src/observability/otel-worker-gauges.ts","../../src/observability/utils.ts"],"sourcesContent":["import { AnyValue, AnyValueMap, SeverityNumber } from '@opentelemetry/api-logs'\nimport {\n  currentSpanId,\n  currentTraceId,\n  getLogger as getOtelLogger,\n} from './telemetry-system'\n\n/** @internal */\nexport type LoggerParams = {\n  message: string\n  trace_id?: string\n  span_id?: string\n  service_name?: string\n  data?: unknown\n  /** @deprecated Use service_name instead */\n  function_name?: string\n}\n\n/**\n * Structured logger that emits logs as OpenTelemetry LogRecords.\n *\n * Every log call automatically captures the active trace and span context,\n * correlating your logs with distributed traces without any manual wiring.\n * When OTel is not initialized, Logger gracefully falls back to `console.*`.\n *\n * Pass structured data as the second argument to any log method. Using an\n * object of key-value pairs (instead of string interpolation) lets you\n * filter, aggregate, and build dashboards in your observability backend.\n *\n * @example\n * ```typescript\n * import { Logger } from 'iii-sdk'\n *\n * const logger = new Logger()\n *\n * // Basic logging — trace context is injected automatically\n * logger.info('Worker connected')\n *\n * // Structured context for dashboards and alerting\n * logger.info('Order processed', { orderId: 'ord_123', amount: 49.99, currency: 'USD' })\n * logger.warn('Retry attempt', { attempt: 3, maxRetries: 5, endpoint: '/api/charge' })\n * logger.error('Payment failed', { orderId: 'ord_123', gateway: 'stripe', errorCode: 'card_declined' })\n * ```\n */\nexport class Logger {\n  private _otelLogger: ReturnType<typeof getOtelLogger> | null = null\n\n  private get otelLogger() {\n    // Lazy initialization: re-fetch logger if not yet available\n    if (!this._otelLogger) {\n      this._otelLogger = getOtelLogger()\n    }\n    return this._otelLogger\n  }\n\n  constructor(\n    private readonly traceId?: string,\n    private readonly serviceName?: string,\n    private readonly spanId?: string,\n  ) {}\n\n  private emit(message: string, severity: SeverityNumber, data?: unknown): void {\n    const attributes: AnyValueMap = {}\n    const traceId = this.traceId ?? currentTraceId()\n    const spanId = this.spanId ?? currentSpanId()\n\n    if (traceId) {\n      attributes.trace_id = traceId\n    }\n    if (spanId) {\n      attributes.span_id = spanId\n    }\n    if (this.serviceName) {\n      attributes['service.name'] = this.serviceName\n    }\n    if (data !== undefined) {\n      attributes['log.data'] = data as AnyValue\n    }\n\n    if (this.otelLogger) {\n      this.otelLogger.emit({\n        severityNumber: severity,\n        body: message,\n        attributes: Object.keys(attributes).length > 0 ? attributes : undefined,\n      })\n    } else {\n      // Fallback to console when OTEL is not available\n      switch (severity) {\n        case SeverityNumber.DEBUG:\n          console.debug(message, data)\n          break\n        case SeverityNumber.INFO:\n          console.info(message, data)\n          break\n        case SeverityNumber.WARN:\n          console.warn(message, data)\n          break\n        case SeverityNumber.ERROR:\n          console.error(message, data)\n          break\n        default:\n          console.log(message, data)\n      }\n    }\n  }\n\n  /**\n   * Log an info-level message.\n   *\n   * @param message - Human-readable log message.\n   * @param data - Structured context attached as OTel log attributes.\n   *   Use key-value objects to enable filtering and aggregation in your\n   *   observability backend (e.g. Grafana, Datadog, New Relic).\n   *\n   * @example\n   * ```typescript\n   * logger.info('Order processed', { orderId: 'ord_123', status: 'completed' })\n   * ```\n   */\n  info(message: string, data?: unknown): void {\n    this.emit(message, SeverityNumber.INFO, data)\n  }\n\n  /**\n   * Log a warning-level message.\n   *\n   * @param message - Human-readable log message.\n   * @param data - Structured context attached as OTel log attributes.\n   *   Use key-value objects to enable filtering and aggregation in your\n   *   observability backend (e.g. Grafana, Datadog, New Relic).\n   *\n   * @example\n   * ```typescript\n   * logger.warn('Retry attempt', { attempt: 3, maxRetries: 5, endpoint: '/api/charge' })\n   * ```\n   */\n  warn(message: string, data?: unknown): void {\n    this.emit(message, SeverityNumber.WARN, data)\n  }\n\n  /**\n   * Log an error-level message.\n   *\n   * @param message - Human-readable log message.\n   * @param data - Structured context attached as OTel log attributes.\n   *   Use key-value objects to enable filtering and aggregation in your\n   *   observability backend (e.g. Grafana, Datadog, New Relic).\n   *\n   * @example\n   * ```typescript\n   * logger.error('Payment failed', { orderId: 'ord_123', gateway: 'stripe', errorCode: 'card_declined' })\n   * ```\n   */\n  error(message: string, data?: unknown): void {\n    this.emit(message, SeverityNumber.ERROR, data)\n  }\n\n  /**\n   * Log a debug-level message.\n   *\n   * @param message - Human-readable log message.\n   * @param data - Structured context attached as OTel log attributes.\n   *   Use key-value objects to enable filtering and aggregation in your\n   *   observability backend (e.g. Grafana, Datadog, New Relic).\n   *\n   * @example\n   * ```typescript\n   * logger.debug('Cache lookup', { key: 'user:42', hit: false })\n   * ```\n   */\n  debug(message: string, data?: unknown): void {\n    this.emit(message, SeverityNumber.DEBUG, data)\n  }\n}\n","import { context as otelContext, propagation, SpanKind, SpanStatusCode, trace, type Tracer } from '@opentelemetry/api'\n\nconst SAFE_REQUEST_HEADERS = ['content-type', 'accept'] as const\nconst SAFE_RESPONSE_HEADERS = ['content-type'] as const\n\nexport interface TracedFetchInit extends RequestInit {\n  tracer?: Tracer\n}\n\n/**\n * Execute a fetch request inside an OTel CLIENT span.\n *\n * Mirrors the Rust execute_traced_request shape: injects W3C traceparent into\n * outgoing headers, records HTTP semantic-convention attributes, and sets\n * ERROR span status for HTTP responses with status >= 400 or network errors.\n */\nexport async function executeTracedRequest(\n  input: RequestInfo | URL,\n  init?: TracedFetchInit,\n): Promise<Response> {\n  const tracer = init?.tracer ?? trace.getTracer('iii-node-sdk')\n  const rawUrl = typeof input === 'string' ? input : input instanceof URL ? input.toString() : input.url\n  let url: URL | null\n  try {\n    url = new URL(rawUrl)\n  } catch {\n    url = null\n  }\n  const method = (init?.method ?? (typeof input === 'object' && 'method' in input ? input.method : 'GET') ?? 'GET').toUpperCase()\n  const name = url?.pathname ? `${method} ${url.pathname}` : method\n\n  return tracer.startActiveSpan(\n    name,\n    {\n      kind: SpanKind.CLIENT,\n      attributes: {\n        'http.request.method': method,\n        'url.full': url?.toString() ?? rawUrl,\n        'network.protocol.name': 'http',\n        ...(url\n          ? {\n              'server.address': url.hostname,\n              'url.scheme': url.protocol.replace(':', ''),\n              'url.path': url.pathname,\n            }\n          : {}),\n        ...(url?.port ? { 'server.port': Number(url.port) } : {}),\n        ...(url?.search ? { 'url.query': url.search.slice(1) } : {}),\n      },\n    },\n    async (span) => {\n      try {\n        // Seed with the Request's own headers so they survive when caller\n        // passes a Request object; init.headers (if any) then overrides.\n        const baseHeaders =\n          typeof input === 'object' && 'headers' in input ? input.headers : undefined\n        const headers = new Headers(baseHeaders)\n        if (init?.headers) {\n          for (const [k, v] of new Headers(init.headers).entries()) headers.set(k, v)\n        }\n        const carrier: Record<string, string> = {}\n        propagation.inject(otelContext.active(), carrier)\n        for (const [k, v] of Object.entries(carrier)) headers.set(k, v)\n\n        for (const h of SAFE_REQUEST_HEADERS) {\n          const v = headers.get(h)\n          if (v) span.setAttribute(`http.request.header.${h}`, v)\n        }\n\n        const response = await fetch(input, { ...init, headers })\n        span.setAttribute('http.response.status_code', response.status)\n        const cl = response.headers.get('content-length')\n        if (cl) span.setAttribute('http.response.body.size', Number(cl))\n        for (const h of SAFE_RESPONSE_HEADERS) {\n          const v = response.headers.get(h)\n          if (v) span.setAttribute(`http.response.header.${h}`, v)\n        }\n\n        if (response.status >= 400) {\n          span.setStatus({ code: SpanStatusCode.ERROR, message: String(response.status) })\n          span.setAttribute('error.type', String(response.status))\n        } else {\n          span.setStatus({ code: SpanStatusCode.OK })\n        }\n        return response\n      } catch (err) {\n        const error = err as Error\n        span.recordException(error)\n        span.setStatus({ code: SpanStatusCode.ERROR, message: error.message })\n        span.setAttribute('error.type', error.name)\n        throw err\n      } finally {\n        span.end()\n      }\n    },\n  )\n}\n","/**\n * Worker metrics collection for the III Node SDK.\n *\n * Collects CPU, memory, and event loop metrics for worker health monitoring.\n * Uses the Node.js built-in `monitorEventLoopDelay` API for accurate\n * event loop lag measurements.\n */\n\nimport { type IntervalHistogram, monitorEventLoopDelay, performance } from 'node:perf_hooks'\n\n/**\n * Worker metrics data structure used internally for OTEL metric collection.\n */\nexport type WorkerMetrics = {\n  memory_heap_used?: number\n  memory_heap_total?: number\n  memory_rss?: number\n  memory_external?: number\n  cpu_user_micros?: number\n  cpu_system_micros?: number\n  cpu_percent?: number\n  event_loop_lag_ms?: number\n  uptime_seconds?: number\n  timestamp_ms: number\n  runtime: string\n}\n\n/**\n * Configuration options for the WorkerMetricsCollector.\n */\nexport interface WorkerMetricsCollectorOptions {\n  /**\n   * Event loop delay histogram resolution in milliseconds.\n   * Lower values provide more accurate measurements but use more resources.\n   * @default 20\n   */\n  eventLoopResolutionMs?: number\n}\n\n/**\n * Collects worker resource metrics including CPU, memory, and event loop lag.\n *\n * Uses the Node.js `monitorEventLoopDelay` API for high-precision event loop\n * delay measurements instead of manual `setImmediate` timing.\n *\n * @example\n * ```typescript\n * const collector = new WorkerMetricsCollector()\n *\n * // Collect metrics periodically\n * setInterval(() => {\n *   const metrics = collector.collect()\n *   console.log('CPU:', metrics.cpu_percent, '%')\n *   console.log('Event Loop Lag:', metrics.event_loop_lag_ms, 'ms')\n * }, 5000)\n *\n * // Clean up when done\n * collector.stopMonitoring()\n * ```\n */\nexport class WorkerMetricsCollector {\n  private readonly startTime: number\n  private lastCpuUsage: NodeJS.CpuUsage\n  private lastCpuTime: number\n  private eventLoopHistogram: IntervalHistogram | null = null\n\n  /**\n   * Creates a new WorkerMetricsCollector instance.\n   *\n   * @param options - Configuration options\n   */\n  constructor(options: WorkerMetricsCollectorOptions = {}) {\n    this.startTime = Date.now()\n    this.lastCpuUsage = process.cpuUsage()\n    this.lastCpuTime = performance.now()\n    this.startEventLoopMonitoring(options.eventLoopResolutionMs ?? 20)\n  }\n\n  /**\n   * Starts the event loop delay histogram monitoring.\n   *\n   * @param resolutionMs - Histogram resolution in milliseconds\n   */\n  private startEventLoopMonitoring(resolutionMs: number): void {\n    // Sanitize resolution: must be a positive finite number, minimum 1ms\n    const safeResolutionMs =\n      Number.isFinite(resolutionMs) && resolutionMs > 0 ? Math.max(1, Math.floor(resolutionMs)) : 20 // Default fallback\n\n    this.eventLoopHistogram = monitorEventLoopDelay({ resolution: safeResolutionMs })\n    this.eventLoopHistogram.enable()\n  }\n\n  /**\n   * Stops the event loop monitoring and releases resources.\n   * Should be called when the collector is no longer needed.\n   */\n  public stopMonitoring(): void {\n    if (this.eventLoopHistogram) {\n      this.eventLoopHistogram.disable()\n      this.eventLoopHistogram = null\n    }\n  }\n\n  /**\n   * Collects current worker metrics.\n   *\n   * This method calculates CPU usage since the last collection,\n   * reads memory usage, and gets event loop delay statistics.\n   * The event loop histogram is reset after each collection for\n   * accurate per-interval measurements.\n   *\n   * @returns Current worker metrics snapshot\n   */\n  collect(): WorkerMetrics {\n    const memoryUsage = process.memoryUsage()\n    const cpuUsage = process.cpuUsage()\n    const now = performance.now()\n\n    // Calculate CPU percentage since last collection\n    const cpuDelta = {\n      user: cpuUsage.user - this.lastCpuUsage.user,\n      system: cpuUsage.system - this.lastCpuUsage.system,\n    }\n    const timeDelta = (now - this.lastCpuTime) * 1000 // Convert ms to microseconds\n    const cpuPercent = timeDelta > 0 ? ((cpuDelta.user + cpuDelta.system) / timeDelta) * 100 : 0\n\n    // Update state for next collection\n    this.lastCpuUsage = cpuUsage\n    this.lastCpuTime = now\n\n    // Get event loop lag from histogram (in nanoseconds, convert to ms)\n    let eventLoopLagMs = 0\n    if (this.eventLoopHistogram) {\n      // Mean is in nanoseconds, convert to milliseconds\n      eventLoopLagMs = this.eventLoopHistogram.mean / 1_000_000\n      // Reset histogram for next collection interval\n      this.eventLoopHistogram.reset()\n    }\n\n    return {\n      memory_heap_used: memoryUsage.heapUsed,\n      memory_heap_total: memoryUsage.heapTotal,\n      memory_rss: memoryUsage.rss,\n      memory_external: memoryUsage.external,\n      cpu_user_micros: cpuUsage.user,\n      cpu_system_micros: cpuUsage.system,\n      cpu_percent: Math.min(cpuPercent, 100), // Cap at 100%\n      event_loop_lag_ms: eventLoopLagMs,\n      uptime_seconds: Math.floor((Date.now() - this.startTime) / 1000),\n      timestamp_ms: Date.now(),\n      runtime: 'node',\n    }\n  }\n}\n","import type { Meter, BatchObservableResult, Observable } from '@opentelemetry/api'\nimport { WorkerMetricsCollector } from './worker-metrics'\n\nexport interface WorkerGaugesOptions {\n  workerId: string\n  workerName?: string\n}\n\nlet registeredGauges = false\nlet metricsCollector: WorkerMetricsCollector | null = null\nlet registeredMeter: Meter | null = null\nlet registeredBatchCallback: ((observableResult: BatchObservableResult) => void) | null = null\nlet registeredObservables: Observable[] = []\n\nexport function registerWorkerGauges(meter: Meter, options: WorkerGaugesOptions): void {\n  if (registeredGauges) {\n    return\n  }\n\n  const { workerId, workerName } = options\n  const baseAttributes = {\n    'worker.id': workerId,\n    ...(workerName && { 'worker.name': workerName }),\n  }\n\n  metricsCollector = new WorkerMetricsCollector()\n\n  const memoryHeapUsed = meter.createObservableGauge('iii.worker.memory.heap_used', {\n    description: 'Worker heap memory used in bytes',\n    unit: 'bytes',\n  })\n\n  const memoryHeapTotal = meter.createObservableGauge('iii.worker.memory.heap_total', {\n    description: 'Worker total heap memory in bytes',\n    unit: 'bytes',\n  })\n\n  const memoryRss = meter.createObservableGauge('iii.worker.memory.rss', {\n    description: 'Worker resident set size in bytes',\n    unit: 'bytes',\n  })\n\n  const memoryExternal = meter.createObservableGauge('iii.worker.memory.external', {\n    description: 'Worker external memory in bytes',\n    unit: 'bytes',\n  })\n\n  const cpuPercent = meter.createObservableGauge('iii.worker.cpu.percent', {\n    description: 'Worker CPU usage percentage',\n    unit: '%',\n  })\n\n  const cpuUserMicros = meter.createObservableGauge('iii.worker.cpu.user_micros', {\n    description: 'Worker CPU user time in microseconds',\n    unit: 'us',\n  })\n\n  const cpuSystemMicros = meter.createObservableGauge('iii.worker.cpu.system_micros', {\n    description: 'Worker CPU system time in microseconds',\n    unit: 'us',\n  })\n\n  const eventLoopLag = meter.createObservableGauge('iii.worker.event_loop.lag_ms', {\n    description: 'Worker event loop lag in milliseconds',\n    unit: 'ms',\n  })\n\n  const uptimeSeconds = meter.createObservableGauge('iii.worker.uptime_seconds', {\n    description: 'Worker uptime in seconds',\n    unit: 's',\n  })\n\n  const batchCallback = (observableResult: BatchObservableResult) => {\n    if (!metricsCollector) return\n\n    const metrics = metricsCollector.collect()\n\n    if (metrics.memory_heap_used !== undefined) {\n      observableResult.observe(memoryHeapUsed, metrics.memory_heap_used, baseAttributes)\n    }\n    if (metrics.memory_heap_total !== undefined) {\n      observableResult.observe(memoryHeapTotal, metrics.memory_heap_total, baseAttributes)\n    }\n    if (metrics.memory_rss !== undefined) {\n      observableResult.observe(memoryRss, metrics.memory_rss, baseAttributes)\n    }\n    if (metrics.memory_external !== undefined) {\n      observableResult.observe(memoryExternal, metrics.memory_external, baseAttributes)\n    }\n    if (metrics.cpu_percent !== undefined) {\n      observableResult.observe(cpuPercent, metrics.cpu_percent, baseAttributes)\n    }\n    if (metrics.cpu_user_micros !== undefined) {\n      observableResult.observe(cpuUserMicros, metrics.cpu_user_micros, baseAttributes)\n    }\n    if (metrics.cpu_system_micros !== undefined) {\n      observableResult.observe(cpuSystemMicros, metrics.cpu_system_micros, baseAttributes)\n    }\n    if (metrics.event_loop_lag_ms !== undefined) {\n      observableResult.observe(eventLoopLag, metrics.event_loop_lag_ms, baseAttributes)\n    }\n    if (metrics.uptime_seconds !== undefined) {\n      observableResult.observe(uptimeSeconds, metrics.uptime_seconds, baseAttributes)\n    }\n  }\n\n  meter.addBatchObservableCallback(batchCallback, [\n    memoryHeapUsed,\n    memoryHeapTotal,\n    memoryRss,\n    memoryExternal,\n    cpuPercent,\n    cpuUserMicros,\n    cpuSystemMicros,\n    eventLoopLag,\n    uptimeSeconds,\n  ])\n\n  registeredMeter = meter\n  registeredBatchCallback = batchCallback\n  registeredObservables = [\n    memoryHeapUsed,\n    memoryHeapTotal,\n    memoryRss,\n    memoryExternal,\n    cpuPercent,\n    cpuUserMicros,\n    cpuSystemMicros,\n    eventLoopLag,\n    uptimeSeconds,\n  ]\n\n  registeredGauges = true\n}\n\nexport function stopWorkerGauges(): void {\n  // Remove the batch observable callback before stopping\n  if (registeredMeter && registeredBatchCallback) {\n    registeredMeter.removeBatchObservableCallback(registeredBatchCallback, registeredObservables)\n  }\n\n  if (metricsCollector) {\n    metricsCollector.stopMonitoring()\n    metricsCollector = null\n  }\n\n  registeredMeter = null\n  registeredBatchCallback = null\n  registeredObservables = []\n  registeredGauges = false\n}\n","/**\n * Safely stringify a value, handling circular references, BigInt, and other edge cases.\n * Returns \"[unserializable]\" if serialization fails for any reason.\n */\nexport function safeStringify(value: unknown): string {\n  const seen = new WeakSet<object>()\n\n  try {\n    const result = JSON.stringify(value, (_key, val) => {\n      // Handle BigInt\n      if (typeof val === 'bigint') {\n        return val.toString()\n      }\n\n      // Handle circular references\n      if (val !== null && typeof val === 'object') {\n        if (seen.has(val)) {\n          return '[Circular]'\n        }\n        seen.add(val)\n      }\n\n      return val\n    })\n    return result ?? '[unserializable]'\n  } catch {\n    return '[unserializable]'\n  }\n}\n"],"mappings":"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"}