react-native-otel 0.1.0 → 0.1.4

package/lib/module/context/span-context.js

@@ -1,14 +1,65 @@
 "use strict";
 
-// Module-level singleton. Tracks only the current active screen span.
-// Network spans do NOT touch this context (handled via activeNetworkSpans map).
+// Public interface — what external consumers see when they import spanContext.
+// Hides push/pop to prevent misuse; use tracer.startActiveSpan() or
+// tracer.withSpan() for safe nested context management.
+
+// Each manual push is tracked by a unique token so that pop() can find the
+// exact entry to remove regardless of concurrent async interleaving.
+
 class SpanContextManager {
+  // Screen-level span set by navigation instrumentation.
+
+  // Manual spans pushed by startActiveSpan / withSpan.
+  // Separate from screenSpan_ because they have different lifecycles.
+  manualStack_ = [];
+
+  // ─── Public API (backward-compatible) ──────────────────────────────────────
+
+  // Set the screen-level span. Called by navigation on route change.
+  // Clears the manual stack so stale sub-operation context from the previous
+  // screen does not leak into the new one.
   setCurrent(span) {
-    this.current_ = span;
+    this.screenSpan_ = span;
+    this.manualStack_ = [];
   }
+
+  // Return the most specific active span. Manual stack takes precedence.
   current() {
-    return this.current_;
+    const top = this.manualStack_[this.manualStack_.length - 1];
+    return top?.span ?? this.screenSpan_;
+  }
+
+  // ─── Internal API (used by Tracer only, not re-exported from index.ts) ─────
+
+  // Push span as the active context. Returns a token required by pop().
+  /** @internal */
+  push(span) {
+    const token = Symbol();
+    this.manualStack_.push({
+      span,
+      token
+    });
+    return token;
+  }
+
+  // Remove the entry matching token, regardless of position in the stack.
+  // Identity-based (not positional) so concurrent async operations cannot
+  // accidentally pop each other's entries.
+  /** @internal */
+  pop(token) {
+    const idx = this.manualStack_.findIndex(e => e.token === token);
+    if (idx !== -1) {
+      this.manualStack_.splice(idx, 1);
+    }
   }
 }
-export const spanContext = new SpanContextManager();
+const manager = new SpanContextManager();
+
+// External consumers get the narrowed type — push/pop are hidden.
+export const spanContext = manager;
+
+// Internal alias with the concrete type so tracer.ts can call push/pop.
+// Not re-exported from index.ts.
+export const spanContextInternal = manager;
 //# sourceMappingURL=span-context.js.map

package/lib/module/context/span-context.js.map

@@ -1 +1 @@
-{"version":3,"names":["SpanContextManager","setCurrent","span","current_","current","spanContext"],"sourceRoot":"../../../src","sources":["context/span-context.ts"],"mappings":";;AAEA;AACA;AACA,MAAMA,kBAAkB,CAAC;EAGvBC,UAAUA,CAACC,IAAiC,EAAQ;IAClD,IAAI,CAACC,QAAQ,GAAGD,IAAI;EACtB;EAEAE,OAAOA,CAAA,EAAgC;IACrC,OAAO,IAAI,CAACD,QAAQ;EACtB;AACF;AAEA,OAAO,MAAME,WAAW,GAAG,IAAIL,kBAAkB,CAAC,CAAC","ignoreList":[]}
+{"version":3,"names":["SpanContextManager","manualStack_","setCurrent","span","screenSpan_","current","top","length","push","token","Symbol","pop","idx","findIndex","e","splice","manager","spanContext","spanContextInternal"],"sourceRoot":"../../../src","sources":["context/span-context.ts"],"mappings":";;AAEA;AACA;AACA;;AAMA;AACA;;AAMA,MAAMA,kBAAkB,CAAqC;EAC3D;;EAEA;EACA;EACQC,YAAY,GAAiB,EAAE;;EAEvC;;EAEA;EACA;EACA;EACAC,UAAUA,CAACC,IAAiC,EAAQ;IAClD,IAAI,CAACC,WAAW,GAAGD,IAAI;IACvB,IAAI,CAACF,YAAY,GAAG,EAAE;EACxB;;EAEA;EACAI,OAAOA,CAAA,EAAgC;IACrC,MAAMC,GAAG,GAAG,IAAI,CAACL,YAAY,CAAC,IAAI,CAACA,YAAY,CAACM,MAAM,GAAG,CAAC,CAAC;IAC3D,OAAOD,GAAG,EAAEH,IAAI,IAAI,IAAI,CAACC,WAAW;EACtC;;EAEA;;EAEA;EACA;EACAI,IAAIA,CAACL,IAAqB,EAAU;IAClC,MAAMM,KAAK,GAAGC,MAAM,CAAC,CAAC;IACtB,IAAI,CAACT,YAAY,CAACO,IAAI,CAAC;MAAEL,IAAI;MAAEM;IAAM,CAAC,CAAC;IACvC,OAAOA,KAAK;EACd;;EAEA;EACA;EACA;EACA;EACAE,GAAGA,CAACF,KAAa,EAAQ;IACvB,MAAMG,GAAG,GAAG,IAAI,CAACX,YAAY,CAACY,SAAS,CAAEC,CAAC,IAAKA,CAAC,CAACL,KAAK,KAAKA,KAAK,CAAC;IACjE,IAAIG,GAAG,KAAK,CAAC,CAAC,EAAE;MACd,IAAI,CAACX,YAAY,CAACc,MAAM,CAACH,GAAG,EAAE,CAAC,CAAC;IAClC;EACF;AACF;AAEA,MAAMI,OAAO,GAAG,IAAIhB,kBAAkB,CAAC,CAAC;;AAExC;AACA,OAAO,MAAMiB,WAAqC,GAAGD,OAAO;;AAE5D;AACA;AACA,OAAO,MAAME,mBAAuC,GAAGF,OAAO","ignoreList":[]}

package/lib/module/core/ids.js

@@ -1,16 +1,30 @@
 "use strict";
 
-function randomHex(length) {
-  let result = '';
-  for (let i = 0; i < length; i++) {
-    result += Math.floor(Math.random() * 16).toString(16);
+function randomBytesHex(byteCount) {
+  try {
+    const bytes = new Uint8Array(byteCount);
+    crypto.getRandomValues(bytes);
+    return Array.from(bytes, b => b.toString(16).padStart(2, '0')).join('');
+  } catch {
+    // Fallback if crypto.getRandomValues is unavailable
+    if (__DEV__) {
+      console.warn('[react-native-otel] crypto.getRandomValues unavailable; falling back to Math.random for ID generation. IDs may collide at scale.');
+    }
+    let result = '';
+    for (let i = 0; i < byteCount * 2; i++) {
+      result += Math.floor(Math.random() * 16).toString(16);
+    }
+    return result;
   }
-  return result;
 }
+
+// 128-bit trace ID per OTel spec (32 hex chars)
 export function generateTraceId() {
-  return randomHex(32);
+  return randomBytesHex(16);
 }
+
+// 64-bit span ID per OTel spec (16 hex chars)
 export function generateSpanId() {
-  return randomHex(16);
+  return randomBytesHex(8);
 }
 //# sourceMappingURL=ids.js.map

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

@@ -1 +1 @@
-{"version":3,"names":["randomHex","length","result","i","Math","floor","random","toString","generateTraceId","generateSpanId"],"sourceRoot":"../../../src","sources":["core/ids.ts"],"mappings":";;AAAA,SAASA,SAASA,CAACC,MAAc,EAAU;EACzC,IAAIC,MAAM,GAAG,EAAE;EACf,KAAK,IAAIC,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGF,MAAM,EAAEE,CAAC,EAAE,EAAE;IAC/BD,MAAM,IAAIE,IAAI,CAACC,KAAK,CAACD,IAAI,CAACE,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,CAACC,QAAQ,CAAC,EAAE,CAAC;EACvD;EACA,OAAOL,MAAM;AACf;AAEA,OAAO,SAASM,eAAeA,CAAA,EAAW;EACxC,OAAOR,SAAS,CAAC,EAAE,CAAC;AACtB;AAEA,OAAO,SAASS,cAAcA,CAAA,EAAW;EACvC,OAAOT,SAAS,CAAC,EAAE,CAAC;AACtB","ignoreList":[]}
+{"version":3,"names":["randomBytesHex","byteCount","bytes","Uint8Array","crypto","getRandomValues","Array","from","b","toString","padStart","join","__DEV__","console","warn","result","i","Math","floor","random","generateTraceId","generateSpanId"],"sourceRoot":"../../../src","sources":["core/ids.ts"],"mappings":";;AAAA,SAASA,cAAcA,CAACC,SAAiB,EAAU;EACjD,IAAI;IACF,MAAMC,KAAK,GAAG,IAAIC,UAAU,CAACF,SAAS,CAAC;IACvCG,MAAM,CAACC,eAAe,CAACH,KAAK,CAAC;IAC7B,OAAOI,KAAK,CAACC,IAAI,CAACL,KAAK,EAAGM,CAAC,IAAKA,CAAC,CAACC,QAAQ,CAAC,EAAE,CAAC,CAACC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAACC,IAAI,CAAC,EAAE,CAAC;EAC3E,CAAC,CAAC,MAAM;IACN;IACA,IAAIC,OAAO,EAAE;MACXC,OAAO,CAACC,IAAI,CACV,kIACF,CAAC;IACH;IACA,IAAIC,MAAM,GAAG,EAAE;IACf,KAAK,IAAIC,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGf,SAAS,GAAG,CAAC,EAAEe,CAAC,EAAE,EAAE;MACtCD,MAAM,IAAIE,IAAI,CAACC,KAAK,CAACD,IAAI,CAACE,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,CAACV,QAAQ,CAAC,EAAE,CAAC;IACvD;IACA,OAAOM,MAAM;EACf;AACF;;AAEA;AACA,OAAO,SAASK,eAAeA,CAAA,EAAW;EACxC,OAAOpB,cAAc,CAAC,EAAE,CAAC;AAC3B;;AAEA;AACA,OAAO,SAASqB,cAAcA,CAAA,EAAW;EACvC,OAAOrB,cAAc,CAAC,CAAC,CAAC;AAC1B","ignoreList":[]}

package/lib/module/core/meter.js

@@ -2,6 +2,9 @@
 
 import { sanitizeAttributes } from "./attributes.js";
 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];
 export class Counter {
   constructor(name, pushToBuffer) {
     this.name = name;
@@ -18,18 +21,69 @@ export class Counter {
   }
 }
 export class Histogram {
-  constructor(name, pushToBuffer) {
+  // Keyed by serialized attributes so concurrent recordings with different
+  // attribute sets are tracked independently.
+  buckets = new Map();
+  constructor(name, pushToBuffer, options) {
     this.name = name;
     this.pushToBuffer = pushToBuffer;
+    this.boundaries = options?.boundaries ?? DEFAULT_HISTOGRAM_BOUNDARIES;
   }
   record(value, attrs) {
-    this.pushToBuffer({
-      type: 'histogram',
-      name: this.name,
-      value,
-      timestampMs: now(),
-      attributes: attrs ? sanitizeAttributes(attrs) : {}
-    });
+    const sanitized = attrs ? sanitizeAttributes(attrs) : {};
+    const key = JSON.stringify(sanitized);
+    let bucket = this.buckets.get(key);
+    if (!bucket) {
+      bucket = {
+        count: 0,
+        sum: 0,
+        bucketCounts: new Array(this.boundaries.length + 1).fill(0),
+        startTimeMs: now(),
+        lastTimeMs: now(),
+        attributes: sanitized
+      };
+      this.buckets.set(key, bucket);
+    }
+    bucket.count += 1;
+    bucket.sum += value;
+    bucket.lastTimeMs = now();
+
+    // Place value into its bucket (first boundary that the value is <= to).
+    let placed = false;
+    for (let i = 0; i < this.boundaries.length; i++) {
+      if (value <= this.boundaries[i]) {
+        bucket.bucketCounts[i] += 1;
+        placed = true;
+        break;
+      }
+    }
+    // +Inf bucket
+    if (!placed) {
+      bucket.bucketCounts[this.boundaries.length] += 1;
+    }
+  }
+
+  // Called by Meter.flush() — drains accumulated buckets into the export buffer.
+  flush() {
+    for (const bucket of this.buckets.values()) {
+      const record = {
+        type: 'histogram',
+        name: this.name,
+        count: bucket.count,
+        sum: bucket.sum,
+        bucketBoundaries: this.boundaries,
+        bucketCounts: bucket.bucketCounts,
+        timestampMs: bucket.lastTimeMs,
+        attributes: bucket.attributes
+      };
+      this.pushToBuffer(record);
+    }
+    this.buckets.clear();
+  }
+
+  // Returns whether there is any accumulated data.
+  hasData() {
+    return this.buckets.size > 0;
   }
 }
 export class Gauge {
@@ -49,19 +103,28 @@ export class Gauge {
 }
 export class Meter {
   buffer = [];
+  histograms = [];
   constructor(exporter) {
     this.exporter = exporter;
   }
   createCounter(name) {
     return new Counter(name, r => this.buffer.push(r));
   }
-  createHistogram(name) {
-    return new Histogram(name, r => this.buffer.push(r));
+  createHistogram(name, options) {
+    const histogram = new Histogram(name, r => this.buffer.push(r), options);
+    this.histograms.push(histogram);
+    return histogram;
   }
   createGauge(name) {
     return new Gauge(name, r => this.buffer.push(r));
   }
   flush() {
+    // Drain all histogram buckets into the buffer first.
+    for (const histogram of this.histograms) {
+      if (histogram.hasData()) {
+        histogram.flush();
+      }
+    }
     if (this.buffer.length === 0) return;
     const toExport = this.buffer.splice(0, this.buffer.length);
     this.exporter?.export(toExport);

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

@@ -1 +1 @@
-{"version":3,"names":["sanitizeAttributes","now","Counter","constructor","name","pushToBuffer","add","value","attrs","type","timestampMs","attributes","Histogram","record","Gauge","set","Meter","buffer","exporter","createCounter","r","push","createHistogram","createGauge","flush","length","toExport","splice","export"],"sourceRoot":"../../../src","sources":["core/meter.ts"],"mappings":";;AAEA,SAASA,kBAAkB,QAAQ,iBAAc;AACjD,SAASC,GAAG,QAAQ,YAAS;AAE7B,OAAO,MAAMC,OAAO,CAAC;EACnBC,WAAWA,CACDC,IAAY,EACZC,YAA4C,EACpD;IAAA,KAFQD,IAAY,GAAZA,IAAY;IAAA,KACZC,YAA4C,GAA5CA,YAA4C;EACnD;EAEHC,GAAGA,CAACC,KAAa,EAAEC,KAAkB,EAAQ;IAC3C,IAAI,CAACH,YAAY,CAAC;MAChBI,IAAI,EAAE,SAAS;MACfL,IAAI,EAAE,IAAI,CAACA,IAAI;MACfG,KAAK;MACLG,WAAW,EAAET,GAAG,CAAC,CAAC;MAClBU,UAAU,EAAEH,KAAK,GAAGR,kBAAkB,CAACQ,KAAK,CAAC,GAAG,CAAC;IACnD,CAAC,CAAC;EACJ;AACF;AAEA,OAAO,MAAMI,SAAS,CAAC;EACrBT,WAAWA,CACDC,IAAY,EACZC,YAA4C,EACpD;IAAA,KAFQD,IAAY,GAAZA,IAAY;IAAA,KACZC,YAA4C,GAA5CA,YAA4C;EACnD;EAEHQ,MAAMA,CAACN,KAAa,EAAEC,KAAkB,EAAQ;IAC9C,IAAI,CAACH,YAAY,CAAC;MAChBI,IAAI,EAAE,WAAW;MACjBL,IAAI,EAAE,IAAI,CAACA,IAAI;MACfG,KAAK;MACLG,WAAW,EAAET,GAAG,CAAC,CAAC;MAClBU,UAAU,EAAEH,KAAK,GAAGR,kBAAkB,CAACQ,KAAK,CAAC,GAAG,CAAC;IACnD,CAAC,CAAC;EACJ;AACF;AAEA,OAAO,MAAMM,KAAK,CAAC;EACjBX,WAAWA,CACDC,IAAY,EACZC,YAA4C,EACpD;IAAA,KAFQD,IAAY,GAAZA,IAAY;IAAA,KACZC,YAA4C,GAA5CA,YAA4C;EACnD;EAEHU,GAAGA,CAACR,KAAa,EAAEC,KAAkB,EAAQ;IAC3C,IAAI,CAACH,YAAY,CAAC;MAChBI,IAAI,EAAE,OAAO;MACbL,IAAI,EAAE,IAAI,CAACA,IAAI;MACfG,KAAK;MACLG,WAAW,EAAET,GAAG,CAAC,CAAC;MAClBU,UAAU,EAAEH,KAAK,GAAGR,kBAAkB,CAACQ,KAAK,CAAC,GAAG,CAAC;IACnD,CAAC,CAAC;EACJ;AACF;AAEA,OAAO,MAAMQ,KAAK,CAAC;EACTC,MAAM,GAAmB,EAAE;EAGnCd,WAAWA,CAACe,QAAyB,EAAE;IACrC,IAAI,CAACA,QAAQ,GAAGA,QAAQ;EAC1B;EAEAC,aAAaA,CAACf,IAAY,EAAW;IACnC,OAAO,IAAIF,OAAO,CAACE,IAAI,EAAGgB,CAAC,IAAK,IAAI,CAACH,MAAM,CAACI,IAAI,CAACD,CAAC,CAAC,CAAC;EACtD;EAEAE,eAAeA,CAAClB,IAAY,EAAa;IACvC,OAAO,IAAIQ,SAAS,CAACR,IAAI,EAAGgB,CAAC,IAAK,IAAI,CAACH,MAAM,CAACI,IAAI,CAACD,CAAC,CAAC,CAAC;EACxD;EAEAG,WAAWA,CAACnB,IAAY,EAAS;IAC/B,OAAO,IAAIU,KAAK,CAACV,IAAI,EAAGgB,CAAC,IAAK,IAAI,CAACH,MAAM,CAACI,IAAI,CAACD,CAAC,CAAC,CAAC;EACpD;EAEAI,KAAKA,CAAA,EAAS;IACZ,IAAI,IAAI,CAACP,MAAM,CAACQ,MAAM,KAAK,CAAC,EAAE;IAC9B,MAAMC,QAAQ,GAAG,IAAI,CAACT,MAAM,CAACU,MAAM,CAAC,CAAC,EAAE,IAAI,CAACV,MAAM,CAACQ,MAAM,CAAC;IAC1D,IAAI,CAACP,QAAQ,EAAEU,MAAM,CAACF,QAAQ,CAAC;EACjC;AACF","ignoreList":[]}
+{"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":[]}

package/lib/module/core/tracer.js

@@ -2,19 +2,22 @@
 
 import { ATTR_EXCEPTION_MESSAGE, ATTR_EXCEPTION_STACKTRACE, ATTR_EXCEPTION_TYPE } from '@opentelemetry/semantic-conventions';
 import { Span, NoopSpan } from "./span.js";
-import { spanContext } from "../context/span-context.js";
+import { spanContext, spanContextInternal } from "../context/span-context.js";
 export class Tracer {
   constructor(params) {
     this.exporter = params.exporter;
     this.sampleRate = params.sampleRate ?? 1.0;
     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) {
       return new NoopSpan();
     }
 
-    // Resolve parent: explicit > current screen span > none (new trace)
+    // Resolve parent: explicit > current active span > none (new root trace)
     const parent = options?.parent !== undefined ? options.parent ?? undefined : spanContext.current() ?? undefined;
     const userAttrs = this.getUserAttributes();
     return new Span({
@@ -28,6 +31,72 @@ export class Tracer {
       exporter: this.exporter
     });
   }
+
+  // Create a span, make it the active context for the duration of fn, then
+  // automatically end it. Sub-operations started inside fn via startSpan() will
+  // automatically parent to this span.
+  //
+  // For concurrent async work (multiple in-flight awaits), pass parent
+  // explicitly to startSpan() instead — the shared context stack is not safe
+  // for interleaved async operations.
+
+  startActiveSpan(name, optionsOrFn, fn) {
+    const options = typeof optionsOrFn === 'function' ? undefined : optionsOrFn;
+    const callback = typeof optionsOrFn === 'function' ? optionsOrFn : fn;
+    const span = this.startSpan(name, options);
+    const token = spanContextInternal.push(span);
+    const cleanup = (isError, err) => {
+      if (isError && err instanceof Error) {
+        span.setStatus('ERROR', err.message);
+      }
+      span.end();
+      spanContextInternal.pop(token);
+    };
+    try {
+      const result = callback(span);
+      if (result instanceof Promise) {
+        // Token-based pop fires after the promise settles, preserving identity
+        // even if other startActiveSpan calls interleave on the event loop.
+        return result.then(v => {
+          cleanup(false);
+          return v;
+        }, e => {
+          cleanup(true, e);
+          throw e;
+        });
+      }
+      cleanup(false);
+      return result;
+    } catch (e) {
+      cleanup(true, e);
+      throw e;
+    }
+  }
+
+  // Make an existing span the active context for the duration of fn.
+  // Does NOT end the span — the caller owns its lifetime.
+  // Safe for synchronous work. For concurrent async work, see startActiveSpan.
+  withSpan(span, fn) {
+    const token = spanContextInternal.push(span);
+    const cleanup = () => spanContextInternal.pop(token);
+    try {
+      const result = fn(span);
+      if (result instanceof Promise) {
+        return result.then(v => {
+          cleanup();
+          return v;
+        }, e => {
+          cleanup();
+          throw e;
+        });
+      }
+      cleanup();
+      return result;
+    } catch (e) {
+      cleanup();
+      throw e;
+    }
+  }
   recordEvent(name, attributes) {
     spanContext.current()?.addEvent(name, attributes);
   }

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

@@ -1 +1 @@
-{"version":3,"names":["ATTR_EXCEPTION_MESSAGE","ATTR_EXCEPTION_STACKTRACE","ATTR_EXCEPTION_TYPE","Span","NoopSpan","spanContext","Tracer","constructor","params","exporter","sampleRate","getUserAttributes","startSpan","name","options","Math","random","parent","undefined","current","userAttrs","kind","attributes","recordEvent","addEvent","recordException","error","span","message","stack","setStatus","end"],"sourceRoot":"../../../src","sources":["core/tracer.ts"],"mappings":";;AAAA,SACEA,sBAAsB,EACtBC,yBAAyB,EACzBC,mBAAmB,QACd,qCAAqC;AAI5C,SAASC,IAAI,EAAEC,QAAQ,QAAQ,WAAQ;AACvC,SAASC,WAAW,QAAQ,4BAAyB;AAErD,OAAO,MAAMC,MAAM,CAAC;EAKlBC,WAAWA,CAACC,MAIX,EAAE;IACD,IAAI,CAACC,QAAQ,GAAGD,MAAM,CAACC,QAAQ;IAC/B,IAAI,CAACC,UAAU,GAAGF,MAAM,CAACE,UAAU,IAAI,GAAG;IAC1C,IAAI,CAACC,iBAAiB,GAAGH,MAAM,CAACG,iBAAiB;EACnD;EAEAC,SAASA,CACPC,IAAY,EACZC,OAOC,EACgB;IACjB,IAAI,IAAI,CAACJ,UAAU,GAAG,GAAG,IAAIK,IAAI,CAACC,MAAM,CAAC,CAAC,GAAG,IAAI,CAACN,UAAU,EAAE;MAC5D,OAAO,IAAIN,QAAQ,CAAC,CAAC;IACvB;;IAEA;IACA,MAAMa,MAA+B,GACnCH,OAAO,EAAEG,MAAM,KAAKC,SAAS,GACzBJ,OAAO,CAACG,MAAM,IAAIC,SAAS,GAC3Bb,WAAW,CAACc,OAAO,CAAC,CAAC,IAAID,SAAS;IAExC,MAAME,SAAS,GAAG,IAAI,CAACT,iBAAiB,CAAC,CAAC;IAC1C,OAAO,IAAIR,IAAI,CAAC;MACdU,IAAI;MACJQ,IAAI,EAAEP,OAAO,EAAEO,IAAI;MACnBC,UAAU,EAAE;QAAE,GAAGF,SAAS;QAAE,GAAGN,OAAO,EAAEQ;MAAW,CAAC;MACpDL,MAAM;MACNR,QAAQ,EAAE,IAAI,CAACA;IACjB,CAAC,CAAC;EACJ;EAEAc,WAAWA,CAACV,IAAY,EAAES,UAAuB,EAAQ;IACvDjB,WAAW,CAACc,OAAO,CAAC,CAAC,EAAEK,QAAQ,CAACX,IAAI,EAAES,UAAU,CAAC;EACnD;EAEAG,eAAeA,CAACC,KAAY,EAAEJ,UAAuB,EAAQ;IAC3D,MAAMK,IAAI,GAAG,IAAI,CAACf,SAAS,CAAC,aAAac,KAAK,CAACb,IAAI,EAAE,EAAE;MACrDQ,IAAI,EAAE,UAAU;MAChBC,UAAU,EAAE;QACV,CAACpB,mBAAmB,GAAGwB,KAAK,CAACb,IAAI;QACjC,CAACb,sBAAsB,GAAG0B,KAAK,CAACE,OAAO;QACvC,CAAC3B,yBAAyB,GAAGyB,KAAK,CAACG,KAAK,IAAI,EAAE;QAC9C,GAAGP;MACL;IACF,CAAC,CAAC;IACFK,IAAI,CAACG,SAAS,CAAC,OAAO,EAAEJ,KAAK,CAACE,OAAO,CAAC;IACtCD,IAAI,CAACI,GAAG,CAAC,CAAC;EACZ;AACF","ignoreList":[]}
+{"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":";;AAAA,SACEA,sBAAsB,EACtBC,yBAAyB,EACzBC,mBAAmB,QACd,qCAAqC;AAI5C,SAASC,IAAI,EAAEC,QAAQ,QAAQ,WAAQ;AACvC,SAASC,WAAW,EAAEC,mBAAmB,QAAQ,4BAAyB;AAU1E,OAAO,MAAMC,MAAM,CAAC;EAKlBC,WAAWA,CAACC,MAIX,EAAE;IACD,IAAI,CAACC,QAAQ,GAAGD,MAAM,CAACC,QAAQ;IAC/B,IAAI,CAACC,UAAU,GAAGF,MAAM,CAACE,UAAU,IAAI,GAAG;IAC1C,IAAI,CAACC,iBAAiB,GAAGH,MAAM,CAACG,iBAAiB;EACnD;;EAEA;EACA;EACAC,SAASA,CAACC,IAAY,EAAEC,OAAqB,EAAmB;IAC9D,IAAI,IAAI,CAACJ,UAAU,GAAG,GAAG,IAAIK,IAAI,CAACC,MAAM,CAAC,CAAC,GAAG,IAAI,CAACN,UAAU,EAAE;MAC5D,OAAO,IAAIP,QAAQ,CAAC,CAAC;IACvB;;IAEA;IACA,MAAMc,MAA+B,GACnCH,OAAO,EAAEG,MAAM,KAAKC,SAAS,GACzBJ,OAAO,CAACG,MAAM,IAAIC,SAAS,GAC3Bd,WAAW,CAACe,OAAO,CAAC,CAAC,IAAID,SAAS;IAExC,MAAME,SAAS,GAAG,IAAI,CAACT,iBAAiB,CAAC,CAAC;IAC1C,OAAO,IAAIT,IAAI,CAAC;MACdW,IAAI;MACJQ,IAAI,EAAEP,OAAO,EAAEO,IAAI;MACnBC,UAAU,EAAE;QAAE,GAAGF,SAAS;QAAE,GAAGN,OAAO,EAAEQ;MAAW,CAAC;MACpDL,MAAM;MACNR,QAAQ,EAAE,IAAI,CAACA;IACjB,CAAC,CAAC;EACJ;;EAEA;EACA;EACA;EACA;EACA;EACA;EACA;;EAOAc,eAAeA,CACbV,IAAY,EACZW,WAAyD,EACzDC,EAAiC,EAC9B;IACH,MAAMX,OAAO,GAAG,OAAOU,WAAW,KAAK,UAAU,GAAGN,SAAS,GAAGM,WAAW;IAC3E,MAAME,QAAQ,GAAG,OAAOF,WAAW,KAAK,UAAU,GAAGA,WAAW,GAAGC,EAAG;IAEtE,MAAME,IAAI,GAAG,IAAI,CAACf,SAAS,CAACC,IAAI,EAAEC,OAAO,CAAC;IAC1C,MAAMc,KAAK,GAAGvB,mBAAmB,CAACwB,IAAI,CAACF,IAAI,CAAC;IAE5C,MAAMG,OAAO,GAAGA,CAACC,OAAgB,EAAEC,GAAa,KAAK;MACnD,IAAID,OAAO,IAAIC,GAAG,YAAYC,KAAK,EAAE;QACnCN,IAAI,CAACO,SAAS,CAAC,OAAO,EAAEF,GAAG,CAACG,OAAO,CAAC;MACtC;MACAR,IAAI,CAACS,GAAG,CAAC,CAAC;MACV/B,mBAAmB,CAACgC,GAAG,CAACT,KAAK,CAAC;IAChC,CAAC;IAED,IAAI;MACF,MAAMU,MAAM,GAAGZ,QAAQ,CAACC,IAAI,CAAC;MAC7B,IAAIW,MAAM,YAAYC,OAAO,EAAE;QAC7B;QACA;QACA,OAAOD,MAAM,CAACE,IAAI,CACfC,CAAC,IAAK;UACLX,OAAO,CAAC,KAAK,CAAC;UACd,OAAOW,CAAC;QACV,CAAC,EACAC,CAAU,IAAK;UACdZ,OAAO,CAAC,IAAI,EAAEY,CAAC,CAAC;UAChB,MAAMA,CAAC;QACT,CACF,CAAC;MACH;MACAZ,OAAO,CAAC,KAAK,CAAC;MACd,OAAOQ,MAAM;IACf,CAAC,CAAC,OAAOI,CAAC,EAAE;MACVZ,OAAO,CAAC,IAAI,EAAEY,CAAC,CAAC;MAChB,MAAMA,CAAC;IACT;EACF;;EAEA;EACA;EACA;EACAC,QAAQA,CAAIhB,IAAqB,EAAEF,EAAgC,EAAK;IACtE,MAAMG,KAAK,GAAGvB,mBAAmB,CAACwB,IAAI,CAACF,IAAI,CAAC;IAE5C,MAAMG,OAAO,GAAGA,CAAA,KAAMzB,mBAAmB,CAACgC,GAAG,CAACT,KAAK,CAAC;IAEpD,IAAI;MACF,MAAMU,MAAM,GAAGb,EAAE,CAACE,IAAI,CAAC;MACvB,IAAIW,MAAM,YAAYC,OAAO,EAAE;QAC7B,OAAOD,MAAM,CAACE,IAAI,CACfC,CAAC,IAAK;UACLX,OAAO,CAAC,CAAC;UACT,OAAOW,CAAC;QACV,CAAC,EACAC,CAAU,IAAK;UACdZ,OAAO,CAAC,CAAC;UACT,MAAMY,CAAC;QACT,CACF,CAAC;MACH;MACAZ,OAAO,CAAC,CAAC;MACT,OAAOQ,MAAM;IACf,CAAC,CAAC,OAAOI,CAAC,EAAE;MACVZ,OAAO,CAAC,CAAC;MACT,MAAMY,CAAC;IACT;EACF;EAEAE,WAAWA,CAAC/B,IAAY,EAAES,UAAuB,EAAQ;IACvDlB,WAAW,CAACe,OAAO,CAAC,CAAC,EAAE0B,QAAQ,CAAChC,IAAI,EAAES,UAAU,CAAC;EACnD;EAEAwB,eAAeA,CAACC,KAAY,EAAEzB,UAAuB,EAAQ;IAC3D,MAAMK,IAAI,GAAG,IAAI,CAACf,SAAS,CAAC,aAAamC,KAAK,CAAClC,IAAI,EAAE,EAAE;MACrDQ,IAAI,EAAE,UAAU;MAChBC,UAAU,EAAE;QACV,CAACrB,mBAAmB,GAAG8C,KAAK,CAAClC,IAAI;QACjC,CAACd,sBAAsB,GAAGgD,KAAK,CAACZ,OAAO;QACvC,CAACnC,yBAAyB,GAAG+C,KAAK,CAACC,KAAK,IAAI,EAAE;QAC9C,GAAG1B;MACL;IACF,CAAC,CAAC;IACFK,IAAI,CAACO,SAAS,CAAC,OAAO,EAAEa,KAAK,CAACZ,OAAO,CAAC;IACtCR,IAAI,CAACS,GAAG,CAAC,CAAC;EACZ;AACF","ignoreList":[]}

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

@@ -34,7 +34,14 @@ export class ConsoleMetricExporter {
   export(metrics) {
     if (!shouldLog(this.debug)) return;
     for (const metric of metrics) {
-      console.log(`[OTEL METRIC] ${metric.name} ${metric.type} value=${metric.value}`, Object.keys(metric.attributes).length > 0 ? metric.attributes : '');
+      if (metric.type === 'histogram') {
+        const h = metric;
+        const avg = h.count > 0 ? (h.sum / h.count).toFixed(2) : '0';
+        const bucketStr = h.bucketBoundaries.map((b, i) => `≤${b}:${h.bucketCounts[i]}`).concat([`+Inf:${h.bucketCounts[h.bucketBoundaries.length]}`]).join(' ');
+        console.log(`[OTEL METRIC] ${h.name} histogram count=${h.count} sum=${h.sum} avg=${avg} [${bucketStr}]`, Object.keys(h.attributes).length > 0 ? h.attributes : '');
+      } else {
+        console.log(`[OTEL METRIC] ${metric.name} ${metric.type} value=${metric.value}`, Object.keys(metric.attributes).length > 0 ? metric.attributes : '');
+      }
     }
   }
 }

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

@@ -1 +1 @@
-{"version":3,"names":["shouldLog","debug","process","env","NODE_ENV","ConsoleSpanExporter","constructor","export","spans","span","duration","endTimeMs","undefined","startTimeMs","lines","name","traceId","spanId","parentSpanId","status","statusMessage","JSON","stringify","attributes","events","length","push","event","offset","timestampMs","attrsStr","Object","keys","droppedEventsCount","console","log","join","ConsoleMetricExporter","metrics","metric","type","value","ConsoleLogExporter","logs","traceInfo","severity","padEnd","body"],"sourceRoot":"../../../src","sources":["exporters/console-exporter.ts"],"mappings":";;AASA,SAASA,SAASA,CAACC,KAAc,EAAW;EAC1C,OAAOA,KAAK,IAAIC,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,aAAa;AACxD;AAEA,OAAO,MAAMC,mBAAmB,CAAyB;EACvDC,WAAWA,CAASL,KAAK,GAAG,KAAK,EAAE;IAAA,KAAfA,KAAK,GAALA,KAAK;EAAW;EAEpCM,MAAMA,CAACC,KAAqB,EAAQ;IAClC,IAAI,CAACR,SAAS,CAAC,IAAI,CAACC,KAAK,CAAC,EAAE;IAE5B,KAAK,MAAMQ,IAAI,IAAID,KAAK,EAAE;MACxB,MAAME,QAAQ,GACZD,IAAI,CAACE,SAAS,KAAKC,SAAS,GACxB,GAAGH,IAAI,CAACE,SAAS,GAAGF,IAAI,CAACI,WAAW,IAAI,GACxC,SAAS;MACf,MAAMC,KAAe,GAAG,CACtB,eAAeL,IAAI,CAACM,IAAI,aAAaN,IAAI,CAACO,OAAO,WAC/CP,IAAI,CAACQ,MAAM,IACTR,IAAI,CAACS,YAAY,GAAG,iBAAiBT,IAAI,CAACS,YAAY,EAAE,GAAG,EAAE,EAAE,EACnE,eAAeR,QAAQ,aAAaD,IAAI,CAACU,MAAM,GAC7CV,IAAI,CAACW,aAAa,GAAG,KAAKX,IAAI,CAACW,aAAa,GAAG,GAAG,EAAE,EACpD,EACF,iBAAiBC,IAAI,CAACC,SAAS,CAACb,IAAI,CAACc,UAAU,CAAC,EAAE,CACnD;MAED,IAAId,IAAI,CAACe,MAAM,CAACC,MAAM,GAAG,CAAC,EAAE;QAC1BX,KAAK,CAACY,IAAI,CAAC,WAAW,CAAC;QACvB,KAAK,MAAMC,KAAK,IAAIlB,IAAI,CAACe,MAAM,EAAE;UAC/B,MAAMI,MAAM,GAAGD,KAAK,CAACE,WAAW,GAAGpB,IAAI,CAACI,WAAW;UACnD,MAAMiB,QAAQ,GACZC,MAAM,CAACC,IAAI,CAACL,KAAK,CAACJ,UAAU,CAAC,CAACE,MAAM,GAAG,CAAC,GACpC,KAAKJ,IAAI,CAACC,SAAS,CAACK,KAAK,CAACJ,UAAU,CAAC,EAAE,GACvC,IAAI;UACVT,KAAK,CAACY,IAAI,CAAC,SAASE,MAAM,QAAQD,KAAK,CAACZ,IAAI,KAAKe,QAAQ,EAAE,CAAC;QAC9D;MACF;MAEA,IAAIrB,IAAI,CAACwB,kBAAkB,GAAG,CAAC,EAAE;QAC/BnB,KAAK,CAACY,IAAI,CAAC,qBAAqBjB,IAAI,CAACwB,kBAAkB,EAAE,CAAC;MAC5D;MAEAC,OAAO,CAACC,GAAG,CAACrB,KAAK,CAACsB,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/B;EACF;AACF;AAEA,OAAO,MAAMC,qBAAqB,CAA2B;EAC3D/B,WAAWA,CAASL,KAAK,GAAG,KAAK,EAAE;IAAA,KAAfA,KAAK,GAALA,KAAK;EAAW;EAEpCM,MAAMA,CAAC+B,OAAuB,EAAQ;IACpC,IAAI,CAACtC,SAAS,CAAC,IAAI,CAACC,KAAK,CAAC,EAAE;IAE5B,KAAK,MAAMsC,MAAM,IAAID,OAAO,EAAE;MAC5BJ,OAAO,CAACC,GAAG,CACT,iBAAiBI,MAAM,CAACxB,IAAI,IAAIwB,MAAM,CAACC,IAAI,UAAUD,MAAM,CAACE,KAAK,EAAE,EACnEV,MAAM,CAACC,IAAI,CAACO,MAAM,CAAChB,UAAU,CAAC,CAACE,MAAM,GAAG,CAAC,GAAGc,MAAM,CAAChB,UAAU,GAAG,EAClE,CAAC;IACH;EACF;AACF;AAEA,OAAO,MAAMmB,kBAAkB,CAAwB;EACrDpC,WAAWA,CAASL,KAAK,GAAG,KAAK,EAAE;IAAA,KAAfA,KAAK,GAALA,KAAK;EAAW;EAEpCM,MAAMA,CAACoC,IAAiB,EAAQ;IAC9B,IAAI,CAAC3C,SAAS,CAAC,IAAI,CAACC,KAAK,CAAC,EAAE;IAE5B,KAAK,MAAMkC,GAAG,IAAIQ,IAAI,EAAE;MACtB,MAAMC,SAAS,GAAGT,GAAG,CAACnB,OAAO,GACzB,YAAYmB,GAAG,CAACnB,OAAO,WAAWmB,GAAG,CAAClB,MAAM,IAAI,GAChD,EAAE;MAENiB,OAAO,CAACC,GAAG,CACT,cAAcA,GAAG,CAACU,QAAQ,CAACC,MAAM,CAAC,CAAC,CAAC,KAAKX,GAAG,CAACY,IAAI,EAAE,EACnDH,SAAS,EACTb,MAAM,CAACC,IAAI,CAACG,GAAG,CAACZ,UAAU,CAAC,CAACE,MAAM,GAAG,CAAC,GAAGU,GAAG,CAACZ,UAAU,GAAG,EAC5D,CAAC;IACH;EACF;AACF","ignoreList":[]}
+{"version":3,"names":["shouldLog","debug","process","env","NODE_ENV","ConsoleSpanExporter","constructor","export","spans","span","duration","endTimeMs","undefined","startTimeMs","lines","name","traceId","spanId","parentSpanId","status","statusMessage","JSON","stringify","attributes","events","length","push","event","offset","timestampMs","attrsStr","Object","keys","droppedEventsCount","console","log","join","ConsoleMetricExporter","metrics","metric","type","h","avg","count","sum","toFixed","bucketStr","bucketBoundaries","map","b","i","bucketCounts","concat","value","ConsoleLogExporter","logs","traceInfo","severity","padEnd","body"],"sourceRoot":"../../../src","sources":["exporters/console-exporter.ts"],"mappings":";;AAUA,SAASA,SAASA,CAACC,KAAc,EAAW;EAC1C,OAAOA,KAAK,IAAIC,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,aAAa;AACxD;AAEA,OAAO,MAAMC,mBAAmB,CAAyB;EACvDC,WAAWA,CAASL,KAAK,GAAG,KAAK,EAAE;IAAA,KAAfA,KAAK,GAALA,KAAK;EAAW;EAEpCM,MAAMA,CAACC,KAAqB,EAAQ;IAClC,IAAI,CAACR,SAAS,CAAC,IAAI,CAACC,KAAK,CAAC,EAAE;IAE5B,KAAK,MAAMQ,IAAI,IAAID,KAAK,EAAE;MACxB,MAAME,QAAQ,GACZD,IAAI,CAACE,SAAS,KAAKC,SAAS,GACxB,GAAGH,IAAI,CAACE,SAAS,GAAGF,IAAI,CAACI,WAAW,IAAI,GACxC,SAAS;MACf,MAAMC,KAAe,GAAG,CACtB,eAAeL,IAAI,CAACM,IAAI,aAAaN,IAAI,CAACO,OAAO,WAC/CP,IAAI,CAACQ,MAAM,IACTR,IAAI,CAACS,YAAY,GAAG,iBAAiBT,IAAI,CAACS,YAAY,EAAE,GAAG,EAAE,EAAE,EACnE,eAAeR,QAAQ,aAAaD,IAAI,CAACU,MAAM,GAC7CV,IAAI,CAACW,aAAa,GAAG,KAAKX,IAAI,CAACW,aAAa,GAAG,GAAG,EAAE,EACpD,EACF,iBAAiBC,IAAI,CAACC,SAAS,CAACb,IAAI,CAACc,UAAU,CAAC,EAAE,CACnD;MAED,IAAId,IAAI,CAACe,MAAM,CAACC,MAAM,GAAG,CAAC,EAAE;QAC1BX,KAAK,CAACY,IAAI,CAAC,WAAW,CAAC;QACvB,KAAK,MAAMC,KAAK,IAAIlB,IAAI,CAACe,MAAM,EAAE;UAC/B,MAAMI,MAAM,GAAGD,KAAK,CAACE,WAAW,GAAGpB,IAAI,CAACI,WAAW;UACnD,MAAMiB,QAAQ,GACZC,MAAM,CAACC,IAAI,CAACL,KAAK,CAACJ,UAAU,CAAC,CAACE,MAAM,GAAG,CAAC,GACpC,KAAKJ,IAAI,CAACC,SAAS,CAACK,KAAK,CAACJ,UAAU,CAAC,EAAE,GACvC,IAAI;UACVT,KAAK,CAACY,IAAI,CAAC,SAASE,MAAM,QAAQD,KAAK,CAACZ,IAAI,KAAKe,QAAQ,EAAE,CAAC;QAC9D;MACF;MAEA,IAAIrB,IAAI,CAACwB,kBAAkB,GAAG,CAAC,EAAE;QAC/BnB,KAAK,CAACY,IAAI,CAAC,qBAAqBjB,IAAI,CAACwB,kBAAkB,EAAE,CAAC;MAC5D;MAEAC,OAAO,CAACC,GAAG,CAACrB,KAAK,CAACsB,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/B;EACF;AACF;AAEA,OAAO,MAAMC,qBAAqB,CAA2B;EAC3D/B,WAAWA,CAASL,KAAK,GAAG,KAAK,EAAE;IAAA,KAAfA,KAAK,GAALA,KAAK;EAAW;EAEpCM,MAAMA,CAAC+B,OAAuB,EAAQ;IACpC,IAAI,CAACtC,SAAS,CAAC,IAAI,CAACC,KAAK,CAAC,EAAE;IAE5B,KAAK,MAAMsC,MAAM,IAAID,OAAO,EAAE;MAC5B,IAAIC,MAAM,CAACC,IAAI,KAAK,WAAW,EAAE;QAC/B,MAAMC,CAAC,GAAGF,MAAyB;QACnC,MAAMG,GAAG,GAAGD,CAAC,CAACE,KAAK,GAAG,CAAC,GAAG,CAACF,CAAC,CAACG,GAAG,GAAGH,CAAC,CAACE,KAAK,EAAEE,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG;QAC5D,MAAMC,SAAS,GAAGL,CAAC,CAACM,gBAAgB,CACjCC,GAAG,CAAC,CAACC,CAAC,EAAEC,CAAC,KAAK,IAAID,CAAC,IAAIR,CAAC,CAACU,YAAY,CAACD,CAAC,CAAC,EAAE,CAAC,CAC3CE,MAAM,CAAC,CAAC,QAAQX,CAAC,CAACU,YAAY,CAACV,CAAC,CAACM,gBAAgB,CAACtB,MAAM,CAAC,EAAE,CAAC,CAAC,CAC7DW,IAAI,CAAC,GAAG,CAAC;QACZF,OAAO,CAACC,GAAG,CACT,iBAAiBM,CAAC,CAAC1B,IAAI,oBAAoB0B,CAAC,CAACE,KAAK,QAAQF,CAAC,CAACG,GAAG,QAAQF,GAAG,KAAKI,SAAS,GAAG,EAC3Ff,MAAM,CAACC,IAAI,CAACS,CAAC,CAAClB,UAAU,CAAC,CAACE,MAAM,GAAG,CAAC,GAAGgB,CAAC,CAAClB,UAAU,GAAG,EACxD,CAAC;MACH,CAAC,MAAM;QACLW,OAAO,CAACC,GAAG,CACT,iBAAiBI,MAAM,CAACxB,IAAI,IAAIwB,MAAM,CAACC,IAAI,UAAUD,MAAM,CAACc,KAAK,EAAE,EACnEtB,MAAM,CAACC,IAAI,CAACO,MAAM,CAAChB,UAAU,CAAC,CAACE,MAAM,GAAG,CAAC,GAAGc,MAAM,CAAChB,UAAU,GAAG,EAClE,CAAC;MACH;IACF;EACF;AACF;AAEA,OAAO,MAAM+B,kBAAkB,CAAwB;EACrDhD,WAAWA,CAASL,KAAK,GAAG,KAAK,EAAE;IAAA,KAAfA,KAAK,GAALA,KAAK;EAAW;EAEpCM,MAAMA,CAACgD,IAAiB,EAAQ;IAC9B,IAAI,CAACvD,SAAS,CAAC,IAAI,CAACC,KAAK,CAAC,EAAE;IAE5B,KAAK,MAAMkC,GAAG,IAAIoB,IAAI,EAAE;MACtB,MAAMC,SAAS,GAAGrB,GAAG,CAACnB,OAAO,GACzB,YAAYmB,GAAG,CAACnB,OAAO,WAAWmB,GAAG,CAAClB,MAAM,IAAI,GAChD,EAAE;MAENiB,OAAO,CAACC,GAAG,CACT,cAAcA,GAAG,CAACsB,QAAQ,CAACC,MAAM,CAAC,CAAC,CAAC,KAAKvB,GAAG,CAACwB,IAAI,EAAE,EACnDH,SAAS,EACTzB,MAAM,CAACC,IAAI,CAACG,GAAG,CAACZ,UAAU,CAAC,CAACE,MAAM,GAAG,CAAC,GAAGU,GAAG,CAACZ,UAAU,GAAG,EAC5D,CAAC;IACH;EACF;AACF","ignoreList":[]}

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

@@ -1,5 +1,7 @@
 "use strict";
 
+import { Wal, fetchWithRetry } from "./wal.js";
+
 // ─── OTLP attribute value serialization ──────────────────────────────────────
 
 function toOtlpValue(value) {
@@ -75,6 +77,19 @@ export class OtlpHttpExporter {
   setResource(resource) {
     this.resource_ = resource;
   }
+
+  // Called by OtelSDK.init() when a StorageAdapter is configured.
+  // Initialises the WAL and replays any undelivered batches from the previous session.
+  setStorage(storage) {
+    this.wal_ = new Wal(storage, '@react-native-otel/wal/spans');
+    this.replayWal();
+  }
+  replayWal() {
+    if (!this.wal_) return;
+    for (const batch of this.wal_.readAll()) {
+      this.deliverBatch(batch.data, batch.id);
+    }
+  }
   export(spans) {
     this.buffer.push(...spans);
     if (this.buffer.length >= this.batchSize) {
@@ -84,7 +99,12 @@ export class OtlpHttpExporter {
   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);
+    }
   }
 
   // Clear the flush timer and send any remaining buffered spans.
@@ -95,9 +115,23 @@ export class OtlpHttpExporter {
     }
     this.flush();
   }
-  send(spans) {
+  deliverBatch(spans, walId) {
+    const body = this.buildBody(spans);
+    fetchWithRetry(this.tracesEndpoint, {
+      method: 'POST',
+      headers: this.headers,
+      body
+    }).then(success => {
+      if (success && walId !== undefined) {
+        this.wal_?.delete(walId);
+      }
+    }).catch(() => {
+      // Leave in WAL for next session
+    });
+  }
+  buildBody(spans) {
     const resourceAttrs = this.resource_ ? toOtlpAttributes(this.resource_) : [];
-    const body = JSON.stringify({
+    return JSON.stringify({
       resourceSpans: [{
         resource: {
           attributes: resourceAttrs
@@ -111,11 +145,6 @@ export class OtlpHttpExporter {
         }]
       }]
     });
-    fetch(this.tracesEndpoint, {
-      method: 'POST',
-      headers: this.headers,
-      body
-    }).catch(() => {});
   }
   toOtlpSpan(span) {
     return {
@@ -149,7 +178,8 @@ export class OtlpHttpExporter {
 
 // ─── Metric exporter ──────────────────────────────────────────────────────────
 
-// OTLP aggregation temporality: 2 = CUMULATIVE
+// OTLP aggregation temporality constants
+const AGGREGATION_TEMPORALITY_DELTA = 1;
 const AGGREGATION_TEMPORALITY_CUMULATIVE = 2;
 export class OtlpHttpMetricExporter {
   constructor(options) {
@@ -162,11 +192,40 @@ export class OtlpHttpMetricExporter {
   setResource(resource) {
     this.resource_ = resource;
   }
+  setStorage(storage) {
+    this.wal_ = new Wal(storage, '@react-native-otel/wal/metrics');
+    this.replayWal();
+  }
+  replayWal() {
+    if (!this.wal_) return;
+    for (const batch of this.wal_.readAll()) {
+      this.deliverBatch(batch.data, batch.id);
+    }
+  }
   export(metrics) {
     if (metrics.length === 0) return;
-    this.send(metrics);
+    if (this.wal_) {
+      const id = this.wal_.write(metrics);
+      this.deliverBatch(metrics, id);
+    } else {
+      this.deliverBatch(metrics, undefined);
+    }
   }
-  send(metrics) {
+  deliverBatch(metrics, walId) {
+    const body = this.buildBody(metrics);
+    fetchWithRetry(this.metricsEndpoint, {
+      method: 'POST',
+      headers: this.headers,
+      body
+    }).then(success => {
+      if (success && walId !== undefined) {
+        this.wal_?.delete(walId);
+      }
+    }).catch(() => {
+      // Leave in WAL for next session
+    });
+  }
+  buildBody(metrics) {
     const resourceAttrs = this.resource_ ? toOtlpAttributes(this.resource_) : [];
 
     // Group records by name so each unique metric name becomes one OTLP metric.
@@ -181,8 +240,6 @@ export class OtlpHttpMetricExporter {
     }
     const otlpMetrics = Array.from(byName.entries()).map(([name, records]) => {
       const type = records[0]?.type;
-
-      // Counters → sum; histograms + gauges → gauge (no bucket data available).
       if (type === 'counter') {
         return {
           name,
@@ -198,6 +255,28 @@ export class OtlpHttpMetricExporter {
           }
         };
       }
+      if (type === 'histogram') {
+        return {
+          name,
+          histogram: {
+            dataPoints: records.map(r => ({
+              count: String(r.count),
+              sum: r.sum,
+              // bucketCounts in OTLP are string-encoded uint64
+              bucketCounts: r.bucketCounts.map(String),
+              // explicitBounds does not include the implicit +Inf upper bound
+              explicitBounds: r.bucketBoundaries,
+              startTimeUnixNano: msToNano(r.timestampMs),
+              timeUnixNano: msToNano(r.timestampMs),
+              attributes: toOtlpAttributes(r.attributes)
+            })),
+            // Each flush window is independent — use DELTA semantics.
+            aggregationTemporality: AGGREGATION_TEMPORALITY_DELTA
+          }
+        };
+      }
+
+      // gauge
       return {
         name,
         gauge: {
@@ -209,7 +288,7 @@ export class OtlpHttpMetricExporter {
         }
       };
     });
-    const body = JSON.stringify({
+    return JSON.stringify({
       resourceMetrics: [{
         resource: {
           attributes: resourceAttrs
@@ -223,11 +302,6 @@ export class OtlpHttpMetricExporter {
         }]
       }]
     });
-    fetch(this.metricsEndpoint, {
-      method: 'POST',
-      headers: this.headers,
-      body
-    }).catch(() => {});
   }
 }
 
@@ -307,7 +381,7 @@ export class OtlpHttpLogExporter {
         }]
       }]
     });
-    fetch(this.logsEndpoint, {
+    fetchWithRetry(this.logsEndpoint, {
       method: 'POST',
       headers: this.headers,
       body