observability-toolkit 2.0.0 → 2.1.0

package/dist/lib/exports/otlp-proto-encode.js

@@ -0,0 +1,165 @@
+/**
+ * Thin encoding layer: OTLPTraceExport JSON → protobuf binary (Uint8Array)
+ *
+ * Converts the JSON OTLP trace payload produced by evaluationsToPhoenixTraces()
+ * into protobuf binary format using @bufbuild/protobuf generated types.
+ *
+ * Key conversion: hex trace/span IDs → base64 (proto `bytes` fields require
+ * base64 in JSON representation).
+ */
+import { fromJson, toBinary } from '@bufbuild/protobuf';
+import { ExportTraceServiceRequestSchema, } from '../../generated/opentelemetry/proto/collector/trace/v1/trace_service_pb.js';
+import { ExportLogsServiceRequestSchema, } from '../../generated/opentelemetry/proto/collector/logs/v1/logs_service_pb.js';
+import { ExportMetricsServiceRequestSchema, } from '../../generated/opentelemetry/proto/collector/metrics/v1/metrics_service_pb.js';
+import { MAX_HEX_BYTES, HEX_DIGITS_PER_BYTE } from '../core/constants.js';
+export { MAX_HEX_BYTES };
+/**
+ * Convert a hex string to a base64 string.
+ * Proto `bytes` fields (trace_id, span_id) are represented as base64 in JSON.
+ */
+export function hexToBase64(hex) {
+    if (hex.length % HEX_DIGITS_PER_BYTE !== 0) {
+        throw new Error(`hexToBase64: odd-length hex string (${hex.length} chars)`);
+    }
+    if (!/^[0-9a-fA-F]*$/.test(hex)) {
+        throw new Error('hexToBase64: non-hex characters in input');
+    }
+    const byteLength = hex.length / HEX_DIGITS_PER_BYTE;
+    if (byteLength > MAX_HEX_BYTES) {
+        throw new Error(`hexToBase64: input too large (${byteLength} bytes, max ${MAX_HEX_BYTES})`);
+    }
+    return Buffer.from(hex, 'hex').toString('base64');
+}
+/**
+ * Deep-convert hex trace/span IDs to base64 in an OTLPTraceExport structure.
+ * Returns a new object (does not mutate the input).
+ */
+export function convertHexIdsToBase64(traceExport) {
+    return {
+        resourceSpans: traceExport.resourceSpans.map(rs => ({
+            ...rs,
+            scopeSpans: rs.scopeSpans.map(ss => ({
+                ...ss,
+                spans: ss.spans.map(span => ({
+                    ...span,
+                    traceId: hexToBase64(span.traceId),
+                    spanId: hexToBase64(span.spanId),
+                    ...(span.parentSpanId && { parentSpanId: hexToBase64(span.parentSpanId) }),
+                })),
+            })),
+        })),
+    };
+}
+/**
+ * Encode an OTLPTraceExport JSON structure into protobuf binary.
+ *
+ * Flow: OTLPTraceExport → convertHexIdsToBase64 → fromJson() → toBinary() → Uint8Array
+ */
+export function encodeTracesProtobuf(traceExport) {
+    const withBase64Ids = convertHexIdsToBase64(traceExport);
+    const message = fromJson(ExportTraceServiceRequestSchema, withBase64Ids);
+    return toBinary(ExportTraceServiceRequestSchema, message);
+}
+/**
+ * Deep-convert hex trace/span IDs to base64 in an OTLPLogExport structure.
+ * Log records have optional traceId and spanId fields.
+ * Returns a new object (does not mutate the input).
+ */
+export function convertLogHexIdsToBase64(logExport) {
+    return {
+        resourceLogs: logExport.resourceLogs.map(rl => ({
+            ...rl,
+            scopeLogs: rl.scopeLogs.map(sl => ({
+                ...sl,
+                logRecords: sl.logRecords.map(lr => {
+                    const { traceId, spanId, ...rest } = lr;
+                    return {
+                        ...rest,
+                        ...(traceId && { traceId: hexToBase64(traceId) }),
+                        ...(spanId && { spanId: hexToBase64(spanId) }),
+                    };
+                }),
+            })),
+        })),
+    };
+}
+/**
+ * Encode an OTLPLogExport JSON structure into protobuf binary.
+ *
+ * Flow: OTLPLogExport → convertLogHexIdsToBase64 → fromJson() → toBinary() → Uint8Array
+ */
+export function encodeLogsProtobuf(logExport) {
+    const withBase64Ids = convertLogHexIdsToBase64(logExport);
+    // OTLPLogExport matches the OTLP JSON spec for ExportLogsServiceRequest.
+    // fromJson uses proto JSON mapping (uint64 fields accept string), so
+    // string-typed timeUnixNano/observedTimeUnixNano are safe.
+    const message = fromJson(ExportLogsServiceRequestSchema, withBase64Ids);
+    return toBinary(ExportLogsServiceRequestSchema, message);
+}
+/**
+ * Convert hex trace/span IDs to base64 in a single exemplar.
+ * Empty-string IDs are treated as absent (omitted) to match proto3 zero-value semantics.
+ */
+function convertExemplarHexIdsToBase64(exemplar) {
+    const { traceId, spanId, ...rest } = exemplar;
+    return {
+        ...rest,
+        ...(traceId && { traceId: hexToBase64(traceId) }),
+        ...(spanId && { spanId: hexToBase64(spanId) }),
+    };
+}
+/**
+ * Deep-convert hex trace/span IDs to base64 in exemplars within an OTLPMetricExport.
+ * Returns a new object (does not mutate the input).
+ */
+export function convertMetricHexIdsToBase64(metricExport) {
+    return {
+        resourceMetrics: metricExport.resourceMetrics.map(rm => ({
+            ...rm,
+            scopeMetrics: rm.scopeMetrics.map(sm => ({
+                ...sm,
+                metrics: sm.metrics.map(metric => ({
+                    ...metric,
+                    ...(metric.gauge && {
+                        gauge: {
+                            ...metric.gauge,
+                            dataPoints: metric.gauge.dataPoints.map(dp => ({
+                                ...dp,
+                                ...(dp.exemplars && { exemplars: dp.exemplars.map(convertExemplarHexIdsToBase64) }),
+                            })),
+                        },
+                    }),
+                    ...(metric.sum && {
+                        sum: {
+                            ...metric.sum,
+                            dataPoints: metric.sum.dataPoints.map(dp => ({
+                                ...dp,
+                                ...(dp.exemplars && { exemplars: dp.exemplars.map(convertExemplarHexIdsToBase64) }),
+                            })),
+                        },
+                    }),
+                    ...(metric.histogram && {
+                        histogram: {
+                            ...metric.histogram,
+                            dataPoints: metric.histogram.dataPoints.map(dp => ({
+                                ...dp,
+                                ...(dp.exemplars && { exemplars: dp.exemplars.map(convertExemplarHexIdsToBase64) }),
+                            })),
+                        },
+                    }),
+                })),
+            })),
+        })),
+    };
+}
+/**
+ * Encode an OTLPMetricExport JSON structure into protobuf binary.
+ *
+ * Flow: OTLPMetricExport → convertMetricHexIdsToBase64 → fromJson() → toBinary() → Uint8Array
+ */
+export function encodeMetricsProtobuf(metricExport) {
+    const withBase64Ids = convertMetricHexIdsToBase64(metricExport);
+    const message = fromJson(ExportMetricsServiceRequestSchema, withBase64Ids);
+    return toBinary(ExportMetricsServiceRequestSchema, message);
+}
+//# sourceMappingURL=otlp-proto-encode.js.map

package/dist/lib/exports/otlp-proto-encode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"otlp-proto-encode.js","sourceRoot":"","sources":["../../../src/lib/exports/otlp-proto-encode.ts"],"names":[],"mappings":"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"}

package/dist/lib/exports/otlp-proto-encode.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Tests for otlp-proto-encode.ts
+ *
+ * Covers hex-to-base64 conversion, ID remapping, and protobuf binary encoding.
+ */
+export {};
+//# sourceMappingURL=otlp-proto-encode.test.d.ts.map

package/dist/lib/exports/otlp-proto-encode.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otlp-proto-encode.test.d.ts","sourceRoot":"","sources":["../../../src/lib/exports/otlp-proto-encode.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}