react-native-otel 0.1.4 → 0.1.6

package/lib/module/core/meter.js

@@ -5,7 +5,32 @@ import { now } from "./clock.js";
 
 // Default bucket boundaries in milliseconds — covers typical mobile latencies.
 const DEFAULT_HISTOGRAM_BOUNDARIES = [0, 5, 10, 25, 50, 75, 100, 250, 500, 1000];
+
+// Cap for the sanitized-attributes memoization cache to prevent memory leaks
+// when attributes have high cardinality.
+const ATTR_CACHE_MAX = 100;
+
+/**
+ * Memoized attribute sanitization: avoids calling sanitizeAttributes() on
+ * every Counter.add() / Gauge.set() call for the same attribute set.
+ */
+function cachedSanitize(cache, attrs) {
+  if (!attrs) return {};
+  const key = JSON.stringify(attrs);
+  let sanitized = cache.get(key);
+  if (sanitized === undefined) {
+    sanitized = sanitizeAttributes(attrs);
+    if (cache.size >= ATTR_CACHE_MAX) {
+      // Evict the oldest entry to cap memory usage.
+      const firstKey = cache.keys().next().value;
+      if (firstKey !== undefined) cache.delete(firstKey);
+    }
+    cache.set(key, sanitized);
+  }
+  return sanitized;
+}
 export class Counter {
+  attrCache = new Map();
   constructor(name, pushToBuffer) {
     this.name = name;
     this.pushToBuffer = pushToBuffer;
@@ -16,7 +41,7 @@ export class Counter {
       name: this.name,
       value,
       timestampMs: now(),
-      attributes: attrs ? sanitizeAttributes(attrs) : {}
+      attributes: cachedSanitize(this.attrCache, attrs)
     });
   }
 }
@@ -87,6 +112,7 @@ export class Histogram {
   }
 }
 export class Gauge {
+  attrCache = new Map();
   constructor(name, pushToBuffer) {
     this.name = name;
     this.pushToBuffer = pushToBuffer;
@@ -97,7 +123,7 @@ export class Gauge {
       name: this.name,
       value,
       timestampMs: now(),
-      attributes: attrs ? sanitizeAttributes(attrs) : {}
+      attributes: cachedSanitize(this.attrCache, attrs)
     });
   }
 }

package/lib/module/core/meter.js.map

@@ -1 +1 @@
-{"version":3,"names":["sanitizeAttributes","now","DEFAULT_HISTOGRAM_BOUNDARIES","Counter","constructor","name","pushToBuffer","add","value","attrs","type","timestampMs","attributes","Histogram","buckets","Map","options","boundaries","record","sanitized","key","JSON","stringify","bucket","get","count","sum","bucketCounts","Array","length","fill","startTimeMs","lastTimeMs","set","placed","i","flush","values","bucketBoundaries","clear","hasData","size","Gauge","Meter","buffer","histograms","exporter","createCounter","r","push","createHistogram","histogram","createGauge","toExport","splice","export"],"sourceRoot":"../../../src","sources":["core/meter.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["sanitizeAttributes","now","DEFAULT_HISTOGRAM_BOUNDARIES","ATTR_CACHE_MAX","cachedSanitize","cache","attrs","key","JSON","stringify","sanitized","get","undefined","size","firstKey","keys","next","value","delete","set","Counter","attrCache","Map","constructor","name","pushToBuffer","add","type","timestampMs","attributes","Histogram","buckets","options","boundaries","record","bucket","count","sum","bucketCounts","Array","length","fill","startTimeMs","lastTimeMs","placed","i","flush","values","bucketBoundaries","clear","hasData","Gauge","Meter","buffer","histograms","exporter","createCounter","r","push","createHistogram","histogram","createGauge","toExport","splice","export"],"sourceRoot":"../../../src","sources":["core/meter.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/core/processor.js

@@ -0,0 +1,28 @@
+"use strict";
+
+/**
+ * A SpanProcessor intercepts span lifecycle events.
+ * Implement this interface to add custom logic (e.g. enrichment, filtering)
+ * before spans are exported.
+ */
+
+/**
+ * Wraps a SpanExporter: calls exporter.export() immediately when a span ends.
+ * This is the default processor used inside Tracer when no custom processor
+ * is provided.
+ */
+export class SimpleSpanProcessor {
+  constructor(exporter) {
+    this.exporter = exporter;
+  }
+  onEnd(span) {
+    this.exporter.export([span]);
+  }
+}
+
+/** No-op processor — useful as a placeholder or in tests. */
+export class NoopSpanProcessor {
+  onStart(_span) {}
+  onEnd(_span) {}
+}
+//# sourceMappingURL=processor.js.map

package/lib/module/core/processor.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["SimpleSpanProcessor","constructor","exporter","onEnd","span","export","NoopSpanProcessor","onStart","_span"],"sourceRoot":"../../../src","sources":["core/processor.ts"],"mappings":";;AAGA;AACA;AACA;AACA;AACA;;AAQA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMA,mBAAmB,CAA0B;EACxDC,WAAWA,CAAkBC,QAAsB,EAAE;IAAA,KAAxBA,QAAsB,GAAtBA,QAAsB;EAAG;EAEtDC,KAAKA,CAACC,IAAkB,EAAQ;IAC9B,IAAI,CAACF,QAAQ,CAACG,MAAM,CAAC,CAACD,IAAI,CAAC,CAAC;EAC9B;AACF;;AAEA;AACA,OAAO,MAAME,iBAAiB,CAA0B;EACtDC,OAAOA,CAACC,KAAW,EAAQ,CAAC;EAC5BL,KAAKA,CAACK,KAAmB,EAAQ,CAAC;AACpC","ignoreList":[]}

package/lib/module/core/resource.js

@@ -6,6 +6,7 @@ import { ATTR_APP_BUILD_ID, ATTR_DEPLOYMENT_ENVIRONMENT_NAME, ATTR_DEVICE_MANUFA
 // Immutable after creation — user identity is NOT stored here.
 export function buildResource(params) {
   return Object.freeze({
+    ...params.extra,
     [ATTR_SERVICE_NAME]: params.serviceName,
     [ATTR_SERVICE_VERSION]: params.serviceVersion,
     [ATTR_OS_NAME]: params.osName,

package/lib/module/core/resource.js.map

@@ -1 +1 @@
-{"version":3,"names":["ATTR_SERVICE_NAME","ATTR_SERVICE_VERSION","ATTR_APP_BUILD_ID","ATTR_DEPLOYMENT_ENVIRONMENT_NAME","ATTR_DEVICE_MANUFACTURER","ATTR_DEVICE_MODEL_NAME","ATTR_OS_NAME","ATTR_OS_VERSION","buildResource","params","Object","freeze","serviceName","serviceVersion","osName","osVersion","deviceBrand","deviceModel","deviceType","appBuild","environment"],"sourceRoot":"../../../src","sources":["core/resource.ts"],"mappings":";;AAAA,SACEA,iBAAiB,EACjBC,oBAAoB,QACf,qCAAqC;AAC5C,SACEC,iBAAiB,EACjBC,gCAAgC,EAChCC,wBAAwB,EACxBC,sBAAsB,EACtBC,YAAY,EACZC,eAAe,QACV,gDAAgD;AAcvD;AACA;AACA,OAAO,SAASC,aAAaA,CAACC,MAU7B,EAAsB;EACrB,OAAOC,MAAM,CAACC,MAAM,CAAC;IACnB,CAACX,iBAAiB,GAAGS,MAAM,CAACG,WAAW;IACvC,CAACX,oBAAoB,GAAGQ,MAAM,CAACI,cAAc;IAC7C,CAACP,YAAY,GAAGG,MAAM,CAACK,MAAM;IAC7B,CAACP,eAAe,GAAGE,MAAM,CAACM,SAAS;IACnC,CAACX,wBAAwB,GAAGK,MAAM,CAACO,WAAW;IAC9C,CAACX,sBAAsB,GAAGI,MAAM,CAACQ,WAAW;IAC5C,aAAa,EAAER,MAAM,CAACS,UAAU;IAChC,CAAChB,iBAAiB,GAAGO,MAAM,CAACU,QAAQ;IACpC,CAAChB,gCAAgC,GAAGM,MAAM,CAACW;EAC7C,CAAC,CAAC;AACJ","ignoreList":[]}
+{"version":3,"names":["ATTR_SERVICE_NAME","ATTR_SERVICE_VERSION","ATTR_APP_BUILD_ID","ATTR_DEPLOYMENT_ENVIRONMENT_NAME","ATTR_DEVICE_MANUFACTURER","ATTR_DEVICE_MODEL_NAME","ATTR_OS_NAME","ATTR_OS_VERSION","buildResource","params","Object","freeze","extra","serviceName","serviceVersion","osName","osVersion","deviceBrand","deviceModel","deviceType","appBuild","environment"],"sourceRoot":"../../../src","sources":["core/resource.ts"],"mappings":";;AAAA,SACEA,iBAAiB,EACjBC,oBAAoB,QACf,qCAAqC;AAC5C,SACEC,iBAAiB,EACjBC,gCAAgC,EAChCC,wBAAwB,EACxBC,sBAAsB,EACtBC,YAAY,EACZC,eAAe,QACV,gDAAgD;AAiBvD;AACA;AACA,OAAO,SAASC,aAAaA,CAACC,MAY7B,EAAsB;EACrB,OAAOC,MAAM,CAACC,MAAM,CAAC;IACnB,GAAGF,MAAM,CAACG,KAAK;IACf,CAACZ,iBAAiB,GAAGS,MAAM,CAACI,WAAW;IACvC,CAACZ,oBAAoB,GAAGQ,MAAM,CAACK,cAAc;IAC7C,CAACR,YAAY,GAAGG,MAAM,CAACM,MAAM;IAC7B,CAACR,eAAe,GAAGE,MAAM,CAACO,SAAS;IACnC,CAACZ,wBAAwB,GAAGK,MAAM,CAACQ,WAAW;IAC9C,CAACZ,sBAAsB,GAAGI,MAAM,CAACS,WAAW;IAC5C,aAAa,EAAET,MAAM,CAACU,UAAU;IAChC,CAACjB,iBAAiB,GAAGO,MAAM,CAACW,QAAQ;IACpC,CAACjB,gCAAgC,GAAGM,MAAM,CAACY;EAC7C,CAAC,CAAC;AACJ","ignoreList":[]}

package/lib/module/core/sampler.js

@@ -0,0 +1,55 @@
+"use strict";
+
+/**
+ * A Sampler decides whether a span should be recorded or dropped.
+ * Return `true` to record the span, `false` to drop it (NoopSpan is used).
+ */
+
+/** Records every span (default). */
+export class AlwaysOnSampler {
+  shouldSample() {
+    return true;
+  }
+}
+
+/** Drops every span. */
+export class AlwaysOffSampler {
+  shouldSample() {
+    return false;
+  }
+}
+
+/**
+ * Samples a deterministic fraction of traces based on the trace ID.
+ * Uses the first 8 bytes of the traceId to produce a 0–1 value and
+ * compares it against the configured ratio, matching the W3C spec intent.
+ *
+ * When there is no parent (new root trace), a random value is used instead
+ * so that the ratio still holds for root spans.
+ */
+export class TraceIdRatioSampler {
+  constructor(ratio) {
+    this.ratio = ratio;
+    if (ratio < 0 || ratio > 1) {
+      throw new RangeError(`TraceIdRatioSampler: ratio must be in [0, 1], got ${ratio}`);
+    }
+  }
+  shouldSample(_name, parent) {
+    if (this.ratio <= 0) return false;
+    if (this.ratio >= 1) return true;
+    const traceId = parent?.traceId;
+    if (traceId && traceId.length >= 16) {
+      // Parse the lower 32 bits of the first 8 bytes (hex chars 8–15) as an
+      // unsigned integer in [0, 2^32) and normalize to [0, 1).
+      // parseInt with radix 16 always returns a non-negative number for 8 hex
+      // digits, so no bitwise operation is needed.
+      const lo = parseInt(traceId.slice(8, 16), 16); // [0, 0xFFFFFFFF]
+      const normalized = lo / 0x100000000; // [0, 1)
+      return normalized < this.ratio;
+    }
+
+    // No parent trace ID — fall back to random.
+    return Math.random() < this.ratio;
+  }
+}
+//# sourceMappingURL=sampler.js.map

package/lib/module/core/sampler.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["AlwaysOnSampler","shouldSample","AlwaysOffSampler","TraceIdRatioSampler","constructor","ratio","RangeError","_name","parent","traceId","length","lo","parseInt","slice","normalized","Math","random"],"sourceRoot":"../../../src","sources":["core/sampler.ts"],"mappings":";;AAGA;AACA;AACA;AACA;;AASA;AACA,OAAO,MAAMA,eAAe,CAAoB;EAC9CC,YAAYA,CAAA,EAAY;IACtB,OAAO,IAAI;EACb;AACF;;AAEA;AACA,OAAO,MAAMC,gBAAgB,CAAoB;EAC/CD,YAAYA,CAAA,EAAY;IACtB,OAAO,KAAK;EACd;AACF;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAME,mBAAmB,CAAoB;EAClDC,WAAWA,CAAkBC,KAAa,EAAE;IAAA,KAAfA,KAAa,GAAbA,KAAa;IACxC,IAAIA,KAAK,GAAG,CAAC,IAAIA,KAAK,GAAG,CAAC,EAAE;MAC1B,MAAM,IAAIC,UAAU,CAClB,qDAAqDD,KAAK,EAC5D,CAAC;IACH;EACF;EAEAJ,YAAYA,CAACM,KAAa,EAAEC,MAAoB,EAAW;IACzD,IAAI,IAAI,CAACH,KAAK,IAAI,CAAC,EAAE,OAAO,KAAK;IACjC,IAAI,IAAI,CAACA,KAAK,IAAI,CAAC,EAAE,OAAO,IAAI;IAEhC,MAAMI,OAAO,GAAGD,MAAM,EAAEC,OAAO;IAC/B,IAAIA,OAAO,IAAIA,OAAO,CAACC,MAAM,IAAI,EAAE,EAAE;MACnC;MACA;MACA;MACA;MACA,MAAMC,EAAE,GAAGC,QAAQ,CAACH,OAAO,CAACI,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;MAC/C,MAAMC,UAAU,GAAGH,EAAE,GAAG,WAAW,CAAC,CAAC;MACrC,OAAOG,UAAU,GAAG,IAAI,CAACT,KAAK;IAChC;;IAEA;IACA,OAAOU,IAAI,CAACC,MAAM,CAAC,CAAC,GAAG,IAAI,CAACX,KAAK;EACnC;AACF","ignoreList":[]}

package/lib/module/core/span.js

@@ -7,6 +7,10 @@ import { generateSpanId, generateTraceId } from "./ids.js";
 
 // Defined here to avoid circular dep with exporters/types.ts
 
+// Forward-declared to avoid circular dep with core/processor.ts
+
+/** A causal link to a span in a different (or the same) trace. */
+
 // Carries both IDs needed to link a child span into an existing trace.
 
 export class Span {
@@ -15,6 +19,7 @@ export class Span {
   // Mutable plain object — setAttribute writes directly, no full clone.
 
   events = [];
+  links = [];
   droppedEventsCount = 0;
   status = 'UNSET';
   statusMessage = undefined;
@@ -26,7 +31,10 @@ export class Span {
     this.kind = params.kind ?? 'INTERNAL';
     this.startTimeMs = now();
     this.attributes = params.attributes ? sanitizeAttributes(params.attributes) : {};
+    this.links = params.links ?? [];
     this.exporter = params.exporter;
+    this.processor = params.processor;
+    this.processor?.onStart?.(this);
   }
   setAttribute(key, value) {
     if (this.endTimeMs !== undefined) return;
@@ -68,7 +76,12 @@ export class Span {
     if (this.status === 'UNSET') {
       this.status = 'OK';
     }
-    this.exporter?.export([this]);
+    // Processor takes precedence over direct exporter (processor wraps the exporter).
+    if (this.processor) {
+      this.processor.onEnd(this);
+    } else {
+      this.exporter?.export([this]);
+    }
   }
 }
 
@@ -84,6 +97,7 @@ export class NoopSpan {
   endTimeMs = undefined;
   attributes = {};
   events = [];
+  links = [];
   droppedEventsCount = 0;
   status = 'UNSET';
   statusMessage = undefined;

package/lib/module/core/span.js.map

@@ -1 +1 @@
-{"version":3,"names":["ATTR_EXCEPTION_MESSAGE","ATTR_EXCEPTION_STACKTRACE","ATTR_EXCEPTION_TYPE","sanitizeAttributes","sanitizeValue","now","generateSpanId","generateTraceId","Span","MAX_EVENTS","endTimeMs","undefined","events","droppedEventsCount","status","statusMessage","constructor","params","traceId","parent","spanId","parentSpanId","name","kind","startTimeMs","attributes","exporter","setAttribute","key","value","sanitized","addEvent","attrs","length","push","timestampMs","setStatus","message","recordException","error","stack","end","export","NoopSpan","_key","_value","_name","_attrs","_status","_message","_error"],"sourceRoot":"../../../src","sources":["core/span.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["ATTR_EXCEPTION_MESSAGE","ATTR_EXCEPTION_STACKTRACE","ATTR_EXCEPTION_TYPE","sanitizeAttributes","sanitizeValue","now","generateSpanId","generateTraceId","Span","MAX_EVENTS","endTimeMs","undefined","events","links","droppedEventsCount","status","statusMessage","constructor","params","traceId","parent","spanId","parentSpanId","name","kind","startTimeMs","attributes","exporter","processor","onStart","setAttribute","key","value","sanitized","addEvent","attrs","length","push","timestampMs","setStatus","message","recordException","error","stack","end","onEnd","export","NoopSpan","_key","_value","_name","_attrs","_status","_message","_error"],"sourceRoot":"../../../src","sources":["core/span.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/core/tracer.js

@@ -7,18 +7,36 @@ export class Tracer {
   constructor(params) {
     this.exporter = params.exporter;
     this.sampleRate = params.sampleRate ?? 1.0;
+    this.sampler = params.sampler;
+    this.processors = params.processors ?? [];
     this.getUserAttributes = params.getUserAttributes;
   }
 
   // Create a span without making it the active context.
   // Use startActiveSpan() when you want sub-operations to auto-parent.
   startSpan(name, options) {
-    if (this.sampleRate < 1.0 && Math.random() > this.sampleRate) {
+    // Resolve parent: explicit > current active span > none (new root trace)
+    const parent = options?.parent !== undefined ? options.parent ?? undefined : spanContext.current() ?? undefined;
+
+    // Sampler takes precedence over legacy sampleRate when provided.
+    if (this.sampler) {
+      if (!this.sampler.shouldSample(name, parent, options?.attributes)) {
+        return new NoopSpan();
+      }
+    } else if (this.sampleRate < 1.0 && Math.random() > this.sampleRate) {
       return new NoopSpan();
     }
 
-    // Resolve parent: explicit > current active span > none (new root trace)
-    const parent = options?.parent !== undefined ? options.parent ?? undefined : spanContext.current() ?? undefined;
+    // Build a composite processor if multiple processors are registered,
+    // otherwise use a single processor or fall back to direct exporter.
+    const processor = this.processors.length > 1 ? {
+      onStart: s => {
+        for (const p of this.processors) p.onStart?.(s);
+      },
+      onEnd: s => {
+        for (const p of this.processors) p.onEnd(s);
+      }
+    } : this.processors[0];
     const userAttrs = this.getUserAttributes();
     return new Span({
       name,
@@ -27,8 +45,10 @@ export class Tracer {
         ...userAttrs,
         ...options?.attributes
       },
+      links: options?.links,
       parent,
-      exporter: this.exporter
+      exporter: processor ? undefined : this.exporter,
+      processor
     });
   }
 

package/lib/module/core/tracer.js.map

@@ -1 +1 @@
-{"version":3,"names":["ATTR_EXCEPTION_MESSAGE","ATTR_EXCEPTION_STACKTRACE","ATTR_EXCEPTION_TYPE","Span","NoopSpan","spanContext","spanContextInternal","Tracer","constructor","params","exporter","sampleRate","getUserAttributes","startSpan","name","options","Math","random","parent","undefined","current","userAttrs","kind","attributes","startActiveSpan","optionsOrFn","fn","callback","span","token","push","cleanup","isError","err","Error","setStatus","message","end","pop","result","Promise","then","v","e","withSpan","recordEvent","addEvent","recordException","error","stack"],"sourceRoot":"../../../src","sources":["core/tracer.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["ATTR_EXCEPTION_MESSAGE","ATTR_EXCEPTION_STACKTRACE","ATTR_EXCEPTION_TYPE","Span","NoopSpan","spanContext","spanContextInternal","Tracer","constructor","params","exporter","sampleRate","sampler","processors","getUserAttributes","startSpan","name","options","parent","undefined","current","shouldSample","attributes","Math","random","processor","length","onStart","s","p","onEnd","userAttrs","kind","links","startActiveSpan","optionsOrFn","fn","callback","span","token","push","cleanup","isError","err","Error","setStatus","message","end","pop","result","Promise","then","v","e","withSpan","recordEvent","addEvent","recordException","error","stack"],"sourceRoot":"../../../src","sources":["core/tracer.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/exporters/multi-exporter.js

@@ -0,0 +1,57 @@
+"use strict";
+
+/**
+ * Fans out span export calls to multiple exporters.
+ * All exporters receive the same batch; errors in one do not affect others.
+ */
+export class MultiSpanExporter {
+  constructor(exporters) {
+    this.exporters = exporters;
+  }
+  export(spans) {
+    for (const exp of this.exporters) {
+      try {
+        exp.export(spans);
+      } catch {
+        // Isolate failures — one bad exporter must not drop data from others.
+      }
+    }
+  }
+}
+
+/**
+ * Fans out metric export calls to multiple exporters.
+ */
+export class MultiMetricExporter {
+  constructor(exporters) {
+    this.exporters = exporters;
+  }
+  export(metrics) {
+    for (const exp of this.exporters) {
+      try {
+        exp.export(metrics);
+      } catch {
+        // Isolate failures.
+      }
+    }
+  }
+}
+
+/**
+ * Fans out log export calls to multiple exporters.
+ */
+export class MultiLogExporter {
+  constructor(exporters) {
+    this.exporters = exporters;
+  }
+  export(logs) {
+    for (const exp of this.exporters) {
+      try {
+        exp.export(logs);
+      } catch {
+        // Isolate failures.
+      }
+    }
+  }
+}
+//# sourceMappingURL=multi-exporter.js.map

package/lib/module/exporters/multi-exporter.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["MultiSpanExporter","constructor","exporters","export","spans","exp","MultiMetricExporter","metrics","MultiLogExporter","logs"],"sourceRoot":"../../../src","sources":["exporters/multi-exporter.ts"],"mappings":";;AAQA;AACA;AACA;AACA;AACA,OAAO,MAAMA,iBAAiB,CAAyB;EACrDC,WAAWA,CAAkBC,SAAyB,EAAE;IAAA,KAA3BA,SAAyB,GAAzBA,SAAyB;EAAG;EAEzDC,MAAMA,CAACC,KAAqB,EAAQ;IAClC,KAAK,MAAMC,GAAG,IAAI,IAAI,CAACH,SAAS,EAAE;MAChC,IAAI;QACFG,GAAG,CAACF,MAAM,CAACC,KAAK,CAAC;MACnB,CAAC,CAAC,MAAM;QACN;MAAA;IAEJ;EACF;AACF;;AAEA;AACA;AACA;AACA,OAAO,MAAME,mBAAmB,CAA2B;EACzDL,WAAWA,CAAkBC,SAA2B,EAAE;IAAA,KAA7BA,SAA2B,GAA3BA,SAA2B;EAAG;EAE3DC,MAAMA,CAACI,OAAuB,EAAQ;IACpC,KAAK,MAAMF,GAAG,IAAI,IAAI,CAACH,SAAS,EAAE;MAChC,IAAI;QACFG,GAAG,CAACF,MAAM,CAACI,OAAO,CAAC;MACrB,CAAC,CAAC,MAAM;QACN;MAAA;IAEJ;EACF;AACF;;AAEA;AACA;AACA;AACA,OAAO,MAAMC,gBAAgB,CAAwB;EACnDP,WAAWA,CAAkBC,SAAwB,EAAE;IAAA,KAA1BA,SAAwB,GAAxBA,SAAwB;EAAG;EAExDC,MAAMA,CAACM,IAAiB,EAAQ;IAC9B,KAAK,MAAMJ,GAAG,IAAI,IAAI,CAACH,SAAS,EAAE;MAChC,IAAI;QACFG,GAAG,CAACF,MAAM,CAACM,IAAI,CAAC;MAClB,CAAC,CAAC,MAAM;QACN;MAAA;IAEJ;EACF;AACF","ignoreList":[]}

package/lib/module/exporters/otlp-http-exporter.js

@@ -1,6 +1,7 @@
 "use strict";
 
 import { Wal, fetchWithRetry } from "./wal.js";
+import { SDK_VERSION } from "../version.js";
 
 // ─── OTLP attribute value serialization ──────────────────────────────────────
 
@@ -71,6 +72,8 @@ export class OtlpHttpExporter {
     this.timer_ = setInterval(() => {
       this.flush();
     }, interval);
+    // Allow Node.js to exit cleanly in test environments without calling destroy().
+    if (typeof this.timer_.unref === 'function') this.timer_.unref();
   }
 
   // Called by OtelSDK.init() after buildResource() — not part of SpanExporter.
@@ -139,7 +142,7 @@ export class OtlpHttpExporter {
         scopeSpans: [{
           scope: {
             name: 'react-native-otel',
-            version: '0.1.0'
+            version: SDK_VERSION
           },
           spans: spans.map(s => this.toOtlpSpan(s))
         }]
@@ -164,6 +167,11 @@ export class OtlpHttpExporter {
         timeUnixNano: msToNano(event.timestampMs),
         attributes: toOtlpAttributes(event.attributes)
       })),
+      links: span.links.map(link => ({
+        traceId: link.traceId,
+        spanId: link.spanId,
+        attributes: link.attributes ? toOtlpAttributes(link.attributes) : []
+      })),
       droppedEventsCount: span.droppedEventsCount,
       status: {
         code: SPAN_STATUS_CODE[span.status] ?? 0,
@@ -182,12 +190,19 @@ export class OtlpHttpExporter {
 const AGGREGATION_TEMPORALITY_DELTA = 1;
 const AGGREGATION_TEMPORALITY_CUMULATIVE = 2;
 export class OtlpHttpMetricExporter {
+  buffer_ = [];
   constructor(options) {
     this.metricsEndpoint = options.endpoint.replace(/\/$/, '') + '/v1/metrics';
     this.headers = {
       'Content-Type': 'application/json',
       ...options.headers
     };
+    const interval = options.flushIntervalMs ?? 30_000;
+    this.timer_ = setInterval(() => {
+      this.flush();
+    }, interval);
+    // Allow Node.js to exit cleanly in test environments without calling destroy().
+    if (typeof this.timer_.unref === 'function') this.timer_.unref();
   }
   setResource(resource) {
     this.resource_ = resource;
@@ -204,13 +219,30 @@ export class OtlpHttpMetricExporter {
   }
   export(metrics) {
     if (metrics.length === 0) return;
+    this.buffer_.push(...metrics);
+  }
+
+  // Drain buffered metrics and deliver them immediately.
+  // Called by the internal timer and also useful for testing / explicit flush.
+  flush() {
+    if (this.buffer_.length === 0) return;
+    const batch = this.buffer_.splice(0);
     if (this.wal_) {
-      const id = this.wal_.write(metrics);
-      this.deliverBatch(metrics, id);
+      const id = this.wal_.write(batch);
+      this.deliverBatch(batch, id);
     } else {
-      this.deliverBatch(metrics, undefined);
+      this.deliverBatch(batch, undefined);
     }
   }
+
+  // Clear the flush timer and send any remaining buffered metrics.
+  destroy() {
+    if (this.timer_ !== undefined) {
+      clearInterval(this.timer_);
+      this.timer_ = undefined;
+    }
+    this.flush();
+  }
   deliverBatch(metrics, walId) {
     const body = this.buildBody(metrics);
     fetchWithRetry(this.metricsEndpoint, {
@@ -296,7 +328,7 @@ export class OtlpHttpMetricExporter {
         scopeMetrics: [{
           scope: {
             name: 'react-native-otel',
-            version: '0.1.0'
+            version: SDK_VERSION
           },
           metrics: otlpMetrics
         }]
@@ -329,10 +361,24 @@ export class OtlpHttpLogExporter {
     this.timer_ = setInterval(() => {
       this.flush();
     }, interval);
+    // Allow Node.js to exit cleanly in test environments without calling destroy().
+    if (typeof this.timer_.unref === 'function') this.timer_.unref();
   }
   setResource(resource) {
     this.resource_ = resource;
   }
+
+  // Called by OtelSDK.init() when a StorageAdapter is configured.
+  setStorage(storage) {
+    this.wal_ = new Wal(storage, '@react-native-otel/wal/logs');
+    this.replayWal();
+  }
+  replayWal() {
+    if (!this.wal_) return;
+    for (const batch of this.wal_.readAll()) {
+      this.deliverBatch(batch.data, batch.id);
+    }
+  }
   export(logs) {
     this.buffer.push(...logs);
     if (this.buffer.length >= this.batchSize) {
@@ -342,7 +388,12 @@ export class OtlpHttpLogExporter {
   flush() {
     if (this.buffer.length === 0) return;
     const batch = this.buffer.splice(0);
-    this.send(batch);
+    if (this.wal_) {
+      const id = this.wal_.write(batch);
+      this.deliverBatch(batch, id);
+    } else {
+      this.deliverBatch(batch, undefined);
+    }
   }
   destroy() {
     if (this.timer_ !== undefined) {
@@ -351,6 +402,15 @@ export class OtlpHttpLogExporter {
     }
     this.flush();
   }
+  deliverBatch(logs, walId) {
+    this.send(logs).then(success => {
+      if (success && walId !== undefined) {
+        this.wal_?.delete(walId);
+      }
+    }).catch(() => {
+      // Leave in WAL for next session
+    });
+  }
   send(logs) {
     const resourceAttrs = this.resource_ ? toOtlpAttributes(this.resource_) : [];
     const body = JSON.stringify({
@@ -361,7 +421,7 @@ export class OtlpHttpLogExporter {
         scopeLogs: [{
           scope: {
             name: 'react-native-otel',
-            version: '0.1.0'
+            version: SDK_VERSION
           },
           logRecords: logs.map(log => ({
             timeUnixNano: msToNano(log.timestampMs),
@@ -381,11 +441,11 @@ export class OtlpHttpLogExporter {
         }]
       }]
     });
-    fetchWithRetry(this.logsEndpoint, {
+    return fetchWithRetry(this.logsEndpoint, {
       method: 'POST',
       headers: this.headers,
       body
-    }).catch(() => {});
+    });
   }
 }
 //# sourceMappingURL=otlp-http-exporter.js.map