vestig 0.15.0 → 0.16.0

package/dist/otlp/processor.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Span Processor for vestig
+ *
+ * Provides a mechanism to process spans when they end, enabling
+ * export to external systems like OTLP-compatible backends.
+ */
+import type { Span } from '../tracing/types';
+/**
+ * Interface for processing spans
+ *
+ * SpanProcessors are notified when spans start and end,
+ * allowing them to batch and export span data.
+ */
+export interface SpanProcessor {
+    /**
+     * Called when a span starts
+     * @param span - The span that started
+     */
+    onStart?(span: Span): void;
+    /**
+     * Called when a span ends
+     * @param span - The span that ended
+     */
+    onEnd(span: Span): void;
+    /**
+     * Force flush any buffered spans
+     */
+    forceFlush?(): Promise<void>;
+    /**
+     * Shutdown the processor
+     */
+    shutdown?(): Promise<void>;
+}
+/**
+ * Global registry of span processors
+ */
+declare class SpanProcessorRegistry {
+    private processors;
+    /**
+     * Register a span processor
+     */
+    addProcessor(processor: SpanProcessor): void;
+    /**
+     * Remove a span processor
+     */
+    removeProcessor(processor: SpanProcessor): boolean;
+    /**
+     * Get all registered processors
+     */
+    getProcessors(): readonly SpanProcessor[];
+    /**
+     * Clear all processors
+     */
+    clearProcessors(): void;
+    /**
+     * Notify all processors that a span started
+     */
+    notifyStart(span: Span): void;
+    /**
+     * Notify all processors that a span ended
+     */
+    notifyEnd(span: Span): void;
+    /**
+     * Force flush all processors
+     */
+    forceFlush(): Promise<void>;
+    /**
+     * Shutdown all processors
+     */
+    shutdown(): Promise<void>;
+}
+/**
+ * Global span processor registry singleton
+ */
+export declare const spanProcessors: SpanProcessorRegistry;
+/**
+ * Register a span processor globally
+ *
+ * @example
+ * ```typescript
+ * import { registerSpanProcessor } from 'vestig'
+ * import { OTLPExporter } from 'vestig/otlp'
+ *
+ * const exporter = new OTLPExporter({
+ *   endpoint: 'https://otel.example.com/v1/traces',
+ *   serviceName: 'my-service',
+ * })
+ *
+ * registerSpanProcessor(exporter)
+ * ```
+ */
+export declare function registerSpanProcessor(processor: SpanProcessor): void;
+/**
+ * Unregister a span processor
+ */
+export declare function unregisterSpanProcessor(processor: SpanProcessor): boolean;
+/**
+ * Get all registered span processors
+ */
+export declare function getSpanProcessors(): readonly SpanProcessor[];
+/**
+ * Force flush all span processors
+ */
+export declare function flushSpanProcessors(): Promise<void>;
+/**
+ * Shutdown all span processors
+ */
+export declare function shutdownSpanProcessors(): Promise<void>;
+export {};
+//# sourceMappingURL=processor.d.ts.map

package/dist/otlp/processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processor.d.ts","sourceRoot":"","sources":["../../src/otlp/processor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAE5C;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC7B;;;OAGG;IACH,OAAO,CAAC,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAA;IAE1B;;;OAGG;IACH,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAA;IAEvB;;OAEG;IACH,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAE5B;;OAEG;IACH,QAAQ,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1B;AAED;;GAEG;AACH,cAAM,qBAAqB;IAC1B,OAAO,CAAC,UAAU,CAAsB;IAExC;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,aAAa,GAAG,IAAI;IAI5C;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO;IAOlD;;OAEG;IACH,aAAa,IAAI,SAAS,aAAa,EAAE;IAIzC;;OAEG;IACH,eAAe,IAAI,IAAI;IAIvB;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAU7B;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAU3B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAUjC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAU/B;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,uBAA8B,CAAA;AAEzD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,aAAa,GAAG,IAAI,CAEpE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO,CAEzE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,SAAS,aAAa,EAAE,CAE5D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAEnD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC,CAEtD"}

package/dist/otlp/processor.js

@@ -0,0 +1,131 @@
+/**
+ * Span Processor for vestig
+ *
+ * Provides a mechanism to process spans when they end, enabling
+ * export to external systems like OTLP-compatible backends.
+ */
+/**
+ * Global registry of span processors
+ */
+class SpanProcessorRegistry {
+    processors = [];
+    /**
+     * Register a span processor
+     */
+    addProcessor(processor) {
+        this.processors.push(processor);
+    }
+    /**
+     * Remove a span processor
+     */
+    removeProcessor(processor) {
+        const index = this.processors.indexOf(processor);
+        if (index === -1)
+            return false;
+        this.processors.splice(index, 1);
+        return true;
+    }
+    /**
+     * Get all registered processors
+     */
+    getProcessors() {
+        return this.processors;
+    }
+    /**
+     * Clear all processors
+     */
+    clearProcessors() {
+        this.processors = [];
+    }
+    /**
+     * Notify all processors that a span started
+     */
+    notifyStart(span) {
+        for (const processor of this.processors) {
+            try {
+                processor.onStart?.(span);
+            }
+            catch (err) {
+                console.error('[vestig] SpanProcessor.onStart error:', err);
+            }
+        }
+    }
+    /**
+     * Notify all processors that a span ended
+     */
+    notifyEnd(span) {
+        for (const processor of this.processors) {
+            try {
+                processor.onEnd(span);
+            }
+            catch (err) {
+                console.error('[vestig] SpanProcessor.onEnd error:', err);
+            }
+        }
+    }
+    /**
+     * Force flush all processors
+     */
+    async forceFlush() {
+        await Promise.all(this.processors.map((p) => p.forceFlush?.().catch((err) => {
+            console.error('[vestig] SpanProcessor.forceFlush error:', err);
+        })));
+    }
+    /**
+     * Shutdown all processors
+     */
+    async shutdown() {
+        await Promise.all(this.processors.map((p) => p.shutdown?.().catch((err) => {
+            console.error('[vestig] SpanProcessor.shutdown error:', err);
+        })));
+        this.processors = [];
+    }
+}
+/**
+ * Global span processor registry singleton
+ */
+export const spanProcessors = new SpanProcessorRegistry();
+/**
+ * Register a span processor globally
+ *
+ * @example
+ * ```typescript
+ * import { registerSpanProcessor } from 'vestig'
+ * import { OTLPExporter } from 'vestig/otlp'
+ *
+ * const exporter = new OTLPExporter({
+ *   endpoint: 'https://otel.example.com/v1/traces',
+ *   serviceName: 'my-service',
+ * })
+ *
+ * registerSpanProcessor(exporter)
+ * ```
+ */
+export function registerSpanProcessor(processor) {
+    spanProcessors.addProcessor(processor);
+}
+/**
+ * Unregister a span processor
+ */
+export function unregisterSpanProcessor(processor) {
+    return spanProcessors.removeProcessor(processor);
+}
+/**
+ * Get all registered span processors
+ */
+export function getSpanProcessors() {
+    return spanProcessors.getProcessors();
+}
+/**
+ * Force flush all span processors
+ */
+export function flushSpanProcessors() {
+    return spanProcessors.forceFlush();
+}
+/**
+ * Shutdown all span processors
+ */
+export function shutdownSpanProcessors() {
+    return spanProcessors.shutdown();
+}
+//# sourceMappingURL=processor.js.map

package/dist/otlp/processor.js.map

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

package/dist/otlp/types.d.ts

@@ -0,0 +1,237 @@
+/**
+ * OpenTelemetry Protocol (OTLP) types for vestig
+ *
+ * These types follow the OTLP/JSON specification for traces and logs.
+ * @see https://opentelemetry.io/docs/specs/otlp/
+ */
+import type { Span, SpanStatus } from '../tracing/types';
+/**
+ * OTLP attribute value types
+ */
+export type OTLPAttributeValue = {
+    stringValue: string;
+} | {
+    intValue: string;
+} | {
+    doubleValue: number;
+} | {
+    boolValue: boolean;
+} | {
+    arrayValue: {
+        values: OTLPAttributeValue[];
+    };
+} | {
+    kvlistValue: {
+        values: OTLPKeyValue[];
+    };
+};
+/**
+ * OTLP key-value pair for attributes
+ */
+export interface OTLPKeyValue {
+    key: string;
+    value: OTLPAttributeValue;
+}
+/**
+ * OTLP Resource represents the entity producing telemetry
+ */
+export interface OTLPResource {
+    attributes: OTLPKeyValue[];
+    droppedAttributesCount?: number;
+}
+/**
+ * OTLP InstrumentationScope identifies the instrumentation library
+ */
+export interface OTLPInstrumentationScope {
+    name: string;
+    version?: string;
+    attributes?: OTLPKeyValue[];
+}
+/**
+ * OTLP Span status codes
+ * @see https://opentelemetry.io/docs/specs/otel/trace/api/#set-status
+ */
+export declare enum OTLPStatusCode {
+    /** Default status */
+    UNSET = 0,
+    /** Operation completed successfully */
+    OK = 1,
+    /** Operation failed */
+    ERROR = 2
+}
+/**
+ * OTLP Span Kind
+ * @see https://opentelemetry.io/docs/specs/otel/trace/api/#spankind
+ */
+export declare enum OTLPSpanKind {
+    /** Default, internal operation */
+    INTERNAL = 1,
+    /** Server handling a request */
+    SERVER = 2,
+    /** Client making a request */
+    CLIENT = 3,
+    /** Producer sending a message */
+    PRODUCER = 4,
+    /** Consumer receiving a message */
+    CONSUMER = 5
+}
+/**
+ * OTLP Span status
+ */
+export interface OTLPSpanStatus {
+    code: OTLPStatusCode;
+    message?: string;
+}
+/**
+ * OTLP Span event
+ */
+export interface OTLPSpanEvent {
+    timeUnixNano: string;
+    name: string;
+    attributes?: OTLPKeyValue[];
+    droppedAttributesCount?: number;
+}
+/**
+ * OTLP Span link (for distributed traces)
+ */
+export interface OTLPSpanLink {
+    traceId: string;
+    spanId: string;
+    traceState?: string;
+    attributes?: OTLPKeyValue[];
+    droppedAttributesCount?: number;
+}
+/**
+ * OTLP Span representation
+ */
+export interface OTLPSpan {
+    traceId: string;
+    spanId: string;
+    traceState?: string;
+    parentSpanId?: string;
+    name: string;
+    kind: OTLPSpanKind;
+    startTimeUnixNano: string;
+    endTimeUnixNano: string;
+    attributes?: OTLPKeyValue[];
+    droppedAttributesCount?: number;
+    events?: OTLPSpanEvent[];
+    droppedEventsCount?: number;
+    links?: OTLPSpanLink[];
+    droppedLinksCount?: number;
+    status?: OTLPSpanStatus;
+}
+/**
+ * OTLP ScopeSpans groups spans by instrumentation scope
+ */
+export interface OTLPScopeSpans {
+    scope?: OTLPInstrumentationScope;
+    spans: OTLPSpan[];
+    schemaUrl?: string;
+}
+/**
+ * OTLP ResourceSpans groups spans by resource
+ */
+export interface OTLPResourceSpans {
+    resource?: OTLPResource;
+    scopeSpans: OTLPScopeSpans[];
+    schemaUrl?: string;
+}
+/**
+ * OTLP ExportTraceServiceRequest - the payload sent to /v1/traces
+ */
+export interface OTLPExportTraceServiceRequest {
+    resourceSpans: OTLPResourceSpans[];
+}
+/**
+ * OTLP Log Severity Number
+ * @see https://opentelemetry.io/docs/specs/otel/logs/data-model/#field-severitynumber
+ */
+export declare enum OTLPSeverityNumber {
+    TRACE = 1,
+    TRACE2 = 2,
+    TRACE3 = 3,
+    TRACE4 = 4,
+    DEBUG = 5,
+    DEBUG2 = 6,
+    DEBUG3 = 7,
+    DEBUG4 = 8,
+    INFO = 9,
+    INFO2 = 10,
+    INFO3 = 11,
+    INFO4 = 12,
+    WARN = 13,
+    WARN2 = 14,
+    WARN3 = 15,
+    WARN4 = 16,
+    ERROR = 17,
+    ERROR2 = 18,
+    ERROR3 = 19,
+    ERROR4 = 20,
+    FATAL = 21,
+    FATAL2 = 22,
+    FATAL3 = 23,
+    FATAL4 = 24
+}
+/**
+ * OTLP Log Record
+ */
+export interface OTLPLogRecord {
+    timeUnixNano: string;
+    observedTimeUnixNano?: string;
+    severityNumber?: OTLPSeverityNumber;
+    severityText?: string;
+    body?: OTLPAttributeValue;
+    attributes?: OTLPKeyValue[];
+    droppedAttributesCount?: number;
+    flags?: number;
+    traceId?: string;
+    spanId?: string;
+}
+/**
+ * OTLP ScopeLogs groups logs by instrumentation scope
+ */
+export interface OTLPScopeLogs {
+    scope?: OTLPInstrumentationScope;
+    logRecords: OTLPLogRecord[];
+    schemaUrl?: string;
+}
+/**
+ * OTLP ResourceLogs groups logs by resource
+ */
+export interface OTLPResourceLogs {
+    resource?: OTLPResource;
+    scopeLogs: OTLPScopeLogs[];
+    schemaUrl?: string;
+}
+/**
+ * OTLP ExportLogsServiceRequest - the payload sent to /v1/logs
+ */
+export interface OTLPExportLogsServiceRequest {
+    resourceLogs: OTLPResourceLogs[];
+}
+/**
+ * Convert vestig SpanStatus to OTLP StatusCode
+ */
+export declare function toOTLPStatusCode(status: SpanStatus): OTLPStatusCode;
+/**
+ * Convert a value to an OTLP attribute value
+ */
+export declare function toOTLPAttributeValue(value: unknown): OTLPAttributeValue;
+/**
+ * Convert a Record to OTLP key-value pairs
+ */
+export declare function toOTLPAttributes(attrs: Record<string, unknown>): OTLPKeyValue[];
+/**
+ * Convert milliseconds timestamp to nanoseconds string (OTLP format)
+ */
+export declare function msToNano(ms: number): string;
+/**
+ * Convert ISO date string to nanoseconds string
+ */
+export declare function isoToNano(isoString: string): string;
+/**
+ * Convert vestig Span to OTLP Span format
+ */
+export declare function toOTLPSpan(span: Span, epochStartMs: number): OTLPSpan;
+//# sourceMappingURL=types.d.ts.map

package/dist/otlp/types.d.ts.map

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

package/dist/otlp/types.js

@@ -0,0 +1,190 @@
+/**
+ * OpenTelemetry Protocol (OTLP) types for vestig
+ *
+ * These types follow the OTLP/JSON specification for traces and logs.
+ * @see https://opentelemetry.io/docs/specs/otlp/
+ */
+/**
+ * OTLP Span status codes
+ * @see https://opentelemetry.io/docs/specs/otel/trace/api/#set-status
+ */
+export var OTLPStatusCode;
+(function (OTLPStatusCode) {
+    /** Default status */
+    OTLPStatusCode[OTLPStatusCode["UNSET"] = 0] = "UNSET";
+    /** Operation completed successfully */
+    OTLPStatusCode[OTLPStatusCode["OK"] = 1] = "OK";
+    /** Operation failed */
+    OTLPStatusCode[OTLPStatusCode["ERROR"] = 2] = "ERROR";
+})(OTLPStatusCode || (OTLPStatusCode = {}));
+/**
+ * OTLP Span Kind
+ * @see https://opentelemetry.io/docs/specs/otel/trace/api/#spankind
+ */
+export var OTLPSpanKind;
+(function (OTLPSpanKind) {
+    /** Default, internal operation */
+    OTLPSpanKind[OTLPSpanKind["INTERNAL"] = 1] = "INTERNAL";
+    /** Server handling a request */
+    OTLPSpanKind[OTLPSpanKind["SERVER"] = 2] = "SERVER";
+    /** Client making a request */
+    OTLPSpanKind[OTLPSpanKind["CLIENT"] = 3] = "CLIENT";
+    /** Producer sending a message */
+    OTLPSpanKind[OTLPSpanKind["PRODUCER"] = 4] = "PRODUCER";
+    /** Consumer receiving a message */
+    OTLPSpanKind[OTLPSpanKind["CONSUMER"] = 5] = "CONSUMER";
+})(OTLPSpanKind || (OTLPSpanKind = {}));
+/**
+ * OTLP Log Severity Number
+ * @see https://opentelemetry.io/docs/specs/otel/logs/data-model/#field-severitynumber
+ */
+export var OTLPSeverityNumber;
+(function (OTLPSeverityNumber) {
+    OTLPSeverityNumber[OTLPSeverityNumber["TRACE"] = 1] = "TRACE";
+    OTLPSeverityNumber[OTLPSeverityNumber["TRACE2"] = 2] = "TRACE2";
+    OTLPSeverityNumber[OTLPSeverityNumber["TRACE3"] = 3] = "TRACE3";
+    OTLPSeverityNumber[OTLPSeverityNumber["TRACE4"] = 4] = "TRACE4";
+    OTLPSeverityNumber[OTLPSeverityNumber["DEBUG"] = 5] = "DEBUG";
+    OTLPSeverityNumber[OTLPSeverityNumber["DEBUG2"] = 6] = "DEBUG2";
+    OTLPSeverityNumber[OTLPSeverityNumber["DEBUG3"] = 7] = "DEBUG3";
+    OTLPSeverityNumber[OTLPSeverityNumber["DEBUG4"] = 8] = "DEBUG4";
+    OTLPSeverityNumber[OTLPSeverityNumber["INFO"] = 9] = "INFO";
+    OTLPSeverityNumber[OTLPSeverityNumber["INFO2"] = 10] = "INFO2";
+    OTLPSeverityNumber[OTLPSeverityNumber["INFO3"] = 11] = "INFO3";
+    OTLPSeverityNumber[OTLPSeverityNumber["INFO4"] = 12] = "INFO4";
+    OTLPSeverityNumber[OTLPSeverityNumber["WARN"] = 13] = "WARN";
+    OTLPSeverityNumber[OTLPSeverityNumber["WARN2"] = 14] = "WARN2";
+    OTLPSeverityNumber[OTLPSeverityNumber["WARN3"] = 15] = "WARN3";
+    OTLPSeverityNumber[OTLPSeverityNumber["WARN4"] = 16] = "WARN4";
+    OTLPSeverityNumber[OTLPSeverityNumber["ERROR"] = 17] = "ERROR";
+    OTLPSeverityNumber[OTLPSeverityNumber["ERROR2"] = 18] = "ERROR2";
+    OTLPSeverityNumber[OTLPSeverityNumber["ERROR3"] = 19] = "ERROR3";
+    OTLPSeverityNumber[OTLPSeverityNumber["ERROR4"] = 20] = "ERROR4";
+    OTLPSeverityNumber[OTLPSeverityNumber["FATAL"] = 21] = "FATAL";
+    OTLPSeverityNumber[OTLPSeverityNumber["FATAL2"] = 22] = "FATAL2";
+    OTLPSeverityNumber[OTLPSeverityNumber["FATAL3"] = 23] = "FATAL3";
+    OTLPSeverityNumber[OTLPSeverityNumber["FATAL4"] = 24] = "FATAL4";
+})(OTLPSeverityNumber || (OTLPSeverityNumber = {}));
+/**
+ * Convert vestig SpanStatus to OTLP StatusCode
+ */
+export function toOTLPStatusCode(status) {
+    switch (status) {
+        case 'ok':
+            return OTLPStatusCode.OK;
+        case 'error':
+            return OTLPStatusCode.ERROR;
+        case 'unset':
+        default:
+            return OTLPStatusCode.UNSET;
+    }
+}
+/**
+ * Convert a value to an OTLP attribute value
+ */
+export function toOTLPAttributeValue(value) {
+    if (value === null || value === undefined) {
+        return { stringValue: '' };
+    }
+    if (typeof value === 'string') {
+        return { stringValue: value };
+    }
+    if (typeof value === 'number') {
+        if (Number.isInteger(value)) {
+            return { intValue: String(value) };
+        }
+        return { doubleValue: value };
+    }
+    if (typeof value === 'boolean') {
+        return { boolValue: value };
+    }
+    if (Array.isArray(value)) {
+        return {
+            arrayValue: {
+                values: value.map(toOTLPAttributeValue),
+            },
+        };
+    }
+    if (typeof value === 'object') {
+        const kvList = [];
+        for (const [k, v] of Object.entries(value)) {
+            kvList.push({
+                key: k,
+                value: toOTLPAttributeValue(v),
+            });
+        }
+        return { kvlistValue: { values: kvList } };
+    }
+    // Fallback: stringify
+    return { stringValue: String(value) };
+}
+/**
+ * Convert a Record to OTLP key-value pairs
+ */
+export function toOTLPAttributes(attrs) {
+    const result = [];
+    for (const [key, value] of Object.entries(attrs)) {
+        if (value !== undefined) {
+            result.push({
+                key,
+                value: toOTLPAttributeValue(value),
+            });
+        }
+    }
+    return result;
+}
+/**
+ * Convert milliseconds timestamp to nanoseconds string (OTLP format)
+ */
+export function msToNano(ms) {
+    // Convert ms to nanoseconds (ms * 1_000_000)
+    // Use BigInt for precision with large numbers
+    return String(BigInt(Math.round(ms)) * BigInt(1_000_000));
+}
+/**
+ * Convert ISO date string to nanoseconds string
+ */
+export function isoToNano(isoString) {
+    const ms = new Date(isoString).getTime();
+    return msToNano(ms);
+}
+/**
+ * Convert vestig Span to OTLP Span format
+ */
+export function toOTLPSpan(span, epochStartMs) {
+    // Calculate absolute timestamps from performance.now() offsets
+    const startTimeMs = epochStartMs + span.startTime;
+    const endTimeMs = span.endTime !== undefined ? epochStartMs + span.endTime : Date.now();
+    const otlpSpan = {
+        traceId: span.traceId,
+        spanId: span.spanId,
+        name: span.name,
+        kind: OTLPSpanKind.INTERNAL,
+        startTimeUnixNano: msToNano(startTimeMs),
+        endTimeUnixNano: msToNano(endTimeMs),
+        status: {
+            code: toOTLPStatusCode(span.status),
+            message: span.statusMessage,
+        },
+    };
+    // Add parent span ID if present
+    if (span.parentSpanId) {
+        otlpSpan.parentSpanId = span.parentSpanId;
+    }
+    // Add attributes
+    const attrs = span.attributes;
+    if (Object.keys(attrs).length > 0) {
+        otlpSpan.attributes = toOTLPAttributes(attrs);
+    }
+    // Add events
+    const events = span.events;
+    if (events.length > 0) {
+        otlpSpan.events = events.map((e) => ({
+            timeUnixNano: isoToNano(e.timestamp),
+            name: e.name,
+            attributes: e.attributes ? toOTLPAttributes(e.attributes) : undefined,
+        }));
+    }
+    return otlpSpan;
+}
+//# sourceMappingURL=types.js.map

package/dist/otlp/types.js.map

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