observability-toolkit 1.8.5 → 2.1.0

package/dist/lib/exports/otlp-format-converter.js

@@ -0,0 +1,401 @@
+/**
+ * OTLP format converter — flat JSONL → OTLP envelope
+ *
+ * Converts legacy flat telemetry records to OTLP-compliant JSON format.
+ * Each output is a single-record OTLP envelope (one span/log/metric).
+ *
+ * @see docs/roadmap/impl-l5-batch-jsonl-otlp-migration.md
+ */
+import { createReadStream, createWriteStream, copyFileSync, renameSync, readdirSync, existsSync, unlinkSync } from 'fs';
+import { createInterface } from 'readline';
+import { join } from 'path';
+import { toOTLPAttributes, } from './otlp-export.js';
+import { AGGREGATION_TEMPORALITY } from '../../backends/index.js';
+import { NANOSECONDS_PER_SECOND_BIGINT, NANOSECONDS_PER_MILLISECOND_BIGINT, } from '../core/units.js';
+// --- Constants ---
+const TRACE_ID_RE = /^[0-9a-f]{32}$/;
+const SPAN_ID_RE = /^[0-9a-f]{16}$/;
+export const SIGNAL_FILE_PATTERNS = {
+    traces: /^traces-.*\.jsonl$/,
+    logs: /^logs-.*\.jsonl$/,
+    metrics: /^metrics-.*\.jsonl$/,
+};
+const TIMESTAMP_TUPLE_LENGTH = 2;
+// --- Timestamp helpers ---
+/**
+ * Convert [seconds, nanoseconds] tuple to nanosecond string.
+ * Uses BigInt to avoid floating-point precision loss.
+ */
+export function timestampToNanoString(ts) {
+    const nanos = BigInt(ts[0]) * NANOSECONDS_PER_SECOND_BIGINT + BigInt(ts[1]);
+    return nanos.toString();
+}
+/**
+ * Convert ISO-8601 string to nanosecond string.
+ * Millisecond precision (Date.getTime() → *1_000_000).
+ */
+export function isoToNanoString(iso) {
+    const ms = new Date(iso).getTime();
+    const nanos = BigInt(ms) * NANOSECONDS_PER_MILLISECOND_BIGINT;
+    return nanos.toString();
+}
+/**
+ * Convert flexible timestamp (ISO string or [s, ns] tuple) to nanosecond string.
+ */
+export function flexTimestampToNanoString(ts) {
+    if (Array.isArray(ts))
+        return timestampToNanoString(ts);
+    return isoToNanoString(ts);
+}
+// --- Format detection ---
+/**
+ * Detect whether a parsed JSON line is already in OTLP format.
+ * OTLP envelopes have top-level array keys: resourceSpans, resourceLogs, or resourceMetrics.
+ */
+export function isOTLPFormat(record) {
+    return (Array.isArray(record['resourceSpans']) ||
+        Array.isArray(record['resourceLogs']) ||
+        Array.isArray(record['resourceMetrics']));
+}
+// --- ID validation ---
+function warnInvalidId(field, value, expected, verbose) {
+    if (verbose && !expected.test(value)) {
+        console.warn(`  warn: ${field} "${value}" does not match ${expected}`);
+    }
+}
+// --- Resource helpers ---
+function buildResourceAttributes(resource) {
+    const attrs = [];
+    if (resource?.serviceName) {
+        attrs.push({ key: 'service.name', value: { stringValue: resource.serviceName } });
+    }
+    if (resource?.serviceVersion) {
+        attrs.push({ key: 'service.version', value: { stringValue: resource.serviceVersion } });
+    }
+    return attrs;
+}
+// --- Per-record converters ---
+/**
+ * Convert flat span record → single-span OTLP trace envelope.
+ */
+export function convertFlatSpan(record, verbose = false) {
+    const traceId = record['traceId'];
+    const spanId = record['spanId'];
+    if (typeof traceId !== 'string' || typeof spanId !== 'string') {
+        throw new TypeError(`Missing required fields: traceId (${typeof traceId}), spanId (${typeof spanId})`);
+    }
+    warnInvalidId('traceId', traceId, TRACE_ID_RE, verbose);
+    warnInvalidId('spanId', spanId, SPAN_ID_RE, verbose);
+    const startTime = record['startTime'];
+    if (!startTime || !Array.isArray(startTime) || startTime.length !== TIMESTAMP_TUPLE_LENGTH) {
+        throw new TypeError(`Missing or invalid startTime: expected [seconds, nanoseconds] tuple`);
+    }
+    const endTime = record['endTime'];
+    const resource = record['resource'];
+    const attrs = record['attributes'];
+    const events = record['events'];
+    const links = record['links'];
+    const status = record['status'];
+    const scope = record['instrumentationScope'];
+    const otlpSpan = {
+        traceId,
+        spanId,
+        name: record['name'],
+        kind: record['kind'] ?? 0,
+        startTimeUnixNano: timestampToNanoString(startTime),
+    };
+    if (record['parentSpanId']) {
+        otlpSpan['parentSpanId'] = record['parentSpanId'];
+    }
+    if (endTime) {
+        otlpSpan['endTimeUnixNano'] = timestampToNanoString(endTime);
+    }
+    if (status) {
+        otlpSpan['status'] = status;
+    }
+    if (attrs && Object.keys(attrs).length > 0) {
+        otlpSpan['attributes'] = toOTLPAttributes(attrs);
+    }
+    if (events && events.length > 0) {
+        otlpSpan['events'] = events.map((e) => ({
+            name: e.name,
+            timeUnixNano: e.timestamp != null
+                ? (BigInt(Math.round(e.timestamp)) * NANOSECONDS_PER_MILLISECOND_BIGINT).toString()
+                : '0',
+            attributes: e.attributes ? toOTLPAttributes(e.attributes) : undefined,
+        }));
+    }
+    // Flat format uses nested context: { traceId, spanId }
+    if (links && links.length > 0) {
+        otlpSpan['links'] = links.map((link) => ({
+            traceId: link.context.traceId,
+            spanId: link.context.spanId,
+            attributes: link.attributes ? toOTLPAttributes(link.attributes) : undefined,
+        }));
+    }
+    return {
+        resourceSpans: [{
+                resource: { attributes: buildResourceAttributes(resource) },
+                scopeSpans: [{
+                        scope: scope ? { name: scope.name, version: scope.version } : undefined,
+                        spans: [otlpSpan],
+                    }],
+            }],
+    };
+}
+/**
+ * Convert flat log record → single-record OTLP log envelope.
+ */
+export function convertFlatLog(record) {
+    const timestamp = record['timestamp'];
+    if (timestamp == null || (typeof timestamp !== 'string' && !Array.isArray(timestamp))) {
+        throw new TypeError(`Missing or invalid timestamp: expected ISO string or [seconds, nanoseconds] tuple`);
+    }
+    const observedTimestamp = record['observedTimestamp'];
+    const resource = record['resource'];
+    const attrs = record['attributes'];
+    const scope = record['instrumentationScope'];
+    const timeUnixNano = flexTimestampToNanoString(timestamp);
+    const observedTimeUnixNano = observedTimestamp
+        ? flexTimestampToNanoString(observedTimestamp)
+        : timeUnixNano;
+    const otlpLog = { timeUnixNano, observedTimeUnixNano };
+    if (record['severityNumber'] != null) {
+        otlpLog['severityNumber'] = record['severityNumber'];
+    }
+    if (record['severityText'] || record['severity']) {
+        otlpLog['severityText'] = record['severityText'] ?? record['severity'];
+    }
+    if (record['body'] != null) {
+        otlpLog['body'] = { stringValue: String(record['body']) };
+    }
+    if (record['traceId']) {
+        otlpLog['traceId'] = record['traceId'];
+    }
+    if (record['spanId']) {
+        otlpLog['spanId'] = record['spanId'];
+    }
+    if (attrs && Object.keys(attrs).length > 0) {
+        otlpLog['attributes'] = toOTLPAttributes(attrs);
+    }
+    return {
+        resourceLogs: [{
+                resource: { attributes: buildResourceAttributes(resource) },
+                scopeLogs: [{
+                        scope: scope ? { name: scope.name, version: scope.version } : undefined,
+                        logRecords: [otlpLog],
+                    }],
+            }],
+    };
+}
+/**
+ * Convert flat metric record → single-metric OTLP metric envelope.
+ */
+export function convertFlatMetric(record) {
+    const timestamp = record['timestamp'];
+    if (timestamp == null || (typeof timestamp !== 'string' && !Array.isArray(timestamp))) {
+        throw new TypeError(`Missing or invalid timestamp: expected ISO string or [seconds, nanoseconds] tuple`);
+    }
+    const name = record['name'];
+    const value = record['value'];
+    const type = record['type'];
+    const unit = record['unit'];
+    const attrs = record['attributes'];
+    const resource = record['resource'];
+    const histogram = record['histogram'];
+    const exemplars = record['exemplars'];
+    const aggregationTemporality = normalizeAggregationTemporality(record['aggregationTemporality']);
+    const timeUnixNano = flexTimestampToNanoString(timestamp);
+    const otlpAttrs = attrs && Object.keys(attrs).length > 0 ? toOTLPAttributes(attrs) : undefined;
+    const startTimestamp = record['startTimestamp'] ?? record['startTime'];
+    const startTimeUnixNano = startTimestamp != null
+        ? flexTimestampToNanoString(startTimestamp)
+        : undefined;
+    const convertExemplars = (ex) => {
+        if (!ex || ex.length === 0)
+            return undefined;
+        return ex.map(e => ({
+            timeUnixNano: e.timestamp ? flexTimestampToNanoString(e.timestamp) : timeUnixNano,
+            asDouble: e.value,
+            traceId: e.traceId,
+            spanId: e.spanId,
+            filteredAttributes: e.attributes ? toOTLPAttributes(e.attributes) : undefined,
+        }));
+    };
+    const metric = { name };
+    if (unit)
+        metric['unit'] = unit;
+    if (type === 'histogram' && histogram) {
+        const explicitBounds = histogram.buckets.filter(b => isFinite(b.le)).map(b => b.le);
+        const bucketCounts = histogram.buckets.map(b => String(b.count));
+        const dp = {
+            timeUnixNano,
+            startTimeUnixNano,
+            count: String(histogram.count),
+            sum: histogram.sum,
+            bucketCounts,
+            explicitBounds,
+            attributes: otlpAttrs,
+            exemplars: convertExemplars(exemplars),
+        };
+        metric['histogram'] = {
+            dataPoints: [dp],
+            aggregationTemporality: aggregationTemporality || AGGREGATION_TEMPORALITY.CUMULATIVE,
+        };
+    }
+    else if (type === 'counter') {
+        const dp = {
+            timeUnixNano,
+            startTimeUnixNano,
+            attributes: otlpAttrs,
+            exemplars: convertExemplars(exemplars),
+        };
+        if (Number.isInteger(value)) {
+            dp.asInt = String(value);
+        }
+        else {
+            dp.asDouble = value;
+        }
+        metric['sum'] = {
+            dataPoints: [dp],
+            aggregationTemporality: aggregationTemporality || AGGREGATION_TEMPORALITY.DELTA,
+            isMonotonic: true,
+        };
+    }
+    else {
+        const dp = {
+            timeUnixNano,
+            attributes: otlpAttrs,
+            exemplars: convertExemplars(exemplars),
+        };
+        if (Number.isInteger(value)) {
+            dp.asInt = String(value);
+        }
+        else {
+            dp.asDouble = value;
+        }
+        metric['gauge'] = { dataPoints: [dp] };
+    }
+    return {
+        resourceMetrics: [{
+                resource: { attributes: buildResourceAttributes(resource) },
+                scopeMetrics: [{
+                        scope: undefined,
+                        metrics: [metric],
+                    }],
+            }],
+    };
+}
+function normalizeAggregationTemporality(value) {
+    if (typeof value === 'number')
+        return value;
+    if (typeof value === 'string') {
+        return AGGREGATION_TEMPORALITY[value] ?? AGGREGATION_TEMPORALITY.UNSPECIFIED;
+    }
+    return AGGREGATION_TEMPORALITY.UNSPECIFIED;
+}
+/**
+ * Convert a single flat record to its OTLP envelope based on signal type.
+ */
+export function convertRecord(record, signal, verbose = false) {
+    switch (signal) {
+        case 'traces': return convertFlatSpan(record, verbose);
+        case 'logs': return convertFlatLog(record);
+        case 'metrics': return convertFlatMetric(record);
+    }
+}
+// --- File discovery ---
+/**
+ * Discover JSONL files matching the signal type pattern in a directory.
+ */
+export function discoverFiles(dir, signal) {
+    if (!existsSync(dir))
+        return [];
+    const entries = readdirSync(dir);
+    const results = [];
+    const signals = signal === 'all'
+        ? ['traces', 'logs', 'metrics']
+        : [signal];
+    for (const s of signals) {
+        const pattern = SIGNAL_FILE_PATTERNS[s];
+        for (const entry of entries) {
+            if (pattern.test(entry)) {
+                results.push({ path: join(dir, entry), signal: s });
+            }
+        }
+    }
+    return results.sort((a, b) => a.path.localeCompare(b.path));
+}
+// --- Streaming migration ---
+/**
+ * Migrate a single JSONL file from flat format to OTLP format.
+ * Uses streaming with backpressure to handle large files.
+ */
+export async function migrateFile(inputPath, signal, options) {
+    const tmpPath = inputPath + '.tmp';
+    const bakPath = inputPath + '.bak';
+    let converted = 0;
+    let skipped = 0;
+    let errors = 0;
+    const rl = createInterface({
+        input: createReadStream(inputPath, { encoding: 'utf-8' }),
+        crlfDelay: Infinity,
+    });
+    const ws = options.dryRun ? null : createWriteStream(tmpPath, { encoding: 'utf-8' });
+    try {
+        for await (const line of rl) {
+            if (!line.trim())
+                continue;
+            try {
+                const record = JSON.parse(line);
+                if (isOTLPFormat(record)) {
+                    if (ws) {
+                        const ok = ws.write(line + '\n');
+                        if (!ok)
+                            await new Promise(resolve => ws.once('drain', resolve));
+                    }
+                    skipped++;
+                    continue;
+                }
+                const otlpRecord = convertRecord(record, signal, options.verbose);
+                if (ws) {
+                    const ok = ws.write(JSON.stringify(otlpRecord) + '\n');
+                    if (!ok)
+                        await new Promise(resolve => ws.once('drain', resolve));
+                }
+                converted++;
+            }
+            catch {
+                errors++;
+                if (ws) {
+                    const ok = ws.write(line + '\n');
+                    if (!ok)
+                        await new Promise(resolve => ws.once('drain', resolve));
+                }
+            }
+        }
+        if (ws) {
+            ws.end();
+            await new Promise((resolve, reject) => {
+                ws.once('finish', resolve);
+                ws.once('error', reject);
+            });
+        }
+    }
+    catch (err) {
+        ws?.destroy();
+        rl.close();
+        if (!options.dryRun && existsSync(tmpPath)) {
+            unlinkSync(tmpPath);
+        }
+        throw err;
+    }
+    if (!options.dryRun && ws) {
+        if (!options.noBackup) {
+            copyFileSync(inputPath, bakPath);
+        }
+        renameSync(tmpPath, inputPath);
+    }
+    return { converted, skipped, errors, path: inputPath };
+}
+//# sourceMappingURL=otlp-format-converter.js.map

package/dist/lib/exports/otlp-format-converter.js.map

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

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

@@ -0,0 +1,53 @@
+/**
+ * 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 type { OTLPTraceExport } from './phoenix-export.js';
+import type { OTLPLogExport, OTLPMetricExport } from './otlp-export.js';
+import { MAX_HEX_BYTES } 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 declare function hexToBase64(hex: string): string;
+/**
+ * Deep-convert hex trace/span IDs to base64 in an OTLPTraceExport structure.
+ * Returns a new object (does not mutate the input).
+ */
+export declare function convertHexIdsToBase64(traceExport: OTLPTraceExport): OTLPTraceExport;
+/**
+ * Encode an OTLPTraceExport JSON structure into protobuf binary.
+ *
+ * Flow: OTLPTraceExport → convertHexIdsToBase64 → fromJson() → toBinary() → Uint8Array
+ */
+export declare function encodeTracesProtobuf(traceExport: OTLPTraceExport): Uint8Array;
+/**
+ * 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 declare function convertLogHexIdsToBase64(logExport: OTLPLogExport): OTLPLogExport;
+/**
+ * Encode an OTLPLogExport JSON structure into protobuf binary.
+ *
+ * Flow: OTLPLogExport → convertLogHexIdsToBase64 → fromJson() → toBinary() → Uint8Array
+ */
+export declare function encodeLogsProtobuf(logExport: OTLPLogExport): Uint8Array;
+/**
+ * Deep-convert hex trace/span IDs to base64 in exemplars within an OTLPMetricExport.
+ * Returns a new object (does not mutate the input).
+ */
+export declare function convertMetricHexIdsToBase64(metricExport: OTLPMetricExport): OTLPMetricExport;
+/**
+ * Encode an OTLPMetricExport JSON structure into protobuf binary.
+ *
+ * Flow: OTLPMetricExport → convertMetricHexIdsToBase64 → fromJson() → toBinary() → Uint8Array
+ */
+export declare function encodeMetricsProtobuf(metricExport: OTLPMetricExport): Uint8Array;
+//# sourceMappingURL=otlp-proto-encode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"otlp-proto-encode.d.ts","sourceRoot":"","sources":["../../../src/lib/exports/otlp-proto-encode.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAYH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAgB,MAAM,kBAAkB,CAAC;AACtF,OAAO,EAAE,aAAa,EAAuB,MAAM,sBAAsB,CAAC;AAE1E,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB;;;GAGG;AAEH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAY/C;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,eAAe,GAAG,eAAe,CAenF;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,eAAe,GAAG,UAAU,CAI7E;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,aAAa,GAAG,aAAa,CAiBhF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,aAAa,GAAG,UAAU,CAOvE;AAeD;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,YAAY,EAAE,gBAAgB,GAAG,gBAAgB,CAuC5F;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,gBAAgB,GAAG,UAAU,CAIhF"}

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"}