react-native-otel 0.1.0 → 0.1.5

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,7 +2,35 @@
 
 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];
+
+// 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;
@@ -13,26 +41,78 @@ export class Counter {
       name: this.name,
       value,
       timestampMs: now(),
-      attributes: attrs ? sanitizeAttributes(attrs) : {}
+      attributes: cachedSanitize(this.attrCache, attrs)
     });
   }
 }
 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 {
+  attrCache = new Map();
   constructor(name, pushToBuffer) {
     this.name = name;
     this.pushToBuffer = pushToBuffer;
@@ -43,25 +123,34 @@ export class Gauge {
       name: this.name,
       value,
       timestampMs: now(),
-      attributes: attrs ? sanitizeAttributes(attrs) : {}
+      attributes: cachedSanitize(this.attrCache, attrs)
     });
   }
 }
 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","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

@@ -2,20 +2,41 @@
 
 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.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 screen span > none (new 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,
@@ -24,10 +45,78 @@ export class Tracer {
         ...userAttrs,
         ...options?.attributes
       },
+      links: options?.links,
       parent,
-      exporter: this.exporter
+      exporter: processor ? undefined : this.exporter,
+      processor
     });
   }
+
+  // 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","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":[]}