@launchdarkly/o11y 1.4.1 → 1.5.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [1.5.0](https://github.com/launchdarkly/observability-sdk/compare/o11y-1.4.1...o11y-1.5.0) (2026-11-03)
+
+
+### Features
+
+* **o11y:** add otel.onHttpRequestSpan hook for auto fetch/XHR spans ([#872](https://github.com/launchdarkly/observability-sdk/issues/872)) ([4387ead](https://github.com/launchdarkly/observability-sdk/commit/4387eadbeddfbdd6f2449d81c906b63f42c1736d))
+* **o11y:** add setAttributes/removeAttributes and stamp context keys on every span ([#855](https://github.com/launchdarkly/observability-sdk/issues/855)) ([c086c84](https://github.com/launchdarkly/observability-sdk/commit/c086c846eb1ea0832f4337885c0064004a2c2de4))
+* **o11y:** link a new browser session to the one it replaces ([#857](https://github.com/launchdarkly/observability-sdk/issues/857)) ([cf5ccbe](https://github.com/launchdarkly/observability-sdk/commit/cf5ccbe5374983262a9b42783bef791cec9b1497))
+
+
+### Bug Fixes
+
+* **o11y:** don't count a full snapshot's bytes toward the next snapshot ([#874](https://github.com/launchdarkly/observability-sdk/issues/874)) ([0ca2e72](https://github.com/launchdarkly/observability-sdk/commit/0ca2e72da05567fa1b53205a5406b9a6dc4de733))
+
 ## [1.4.1](https://github.com/launchdarkly/observability-sdk/compare/o11y-1.4.0...o11y-1.4.1) (2026-10-29)
 
 

package/dist/LDObserve-o8Ro1UV8.js

@@ -0,0 +1,160 @@
+var o = (s, t, r) => new Promise((e, a) => {
+  var n = (i) => {
+    try {
+      l(r.next(i));
+    } catch (f) {
+      a(f);
+    }
+  }, h = (i) => {
+    try {
+      l(r.throw(i));
+    } catch (f) {
+      a(f);
+    }
+  }, l = (i) => i.done ? e(i.value) : Promise.resolve(i.value).then(n, h);
+  l((r = r.apply(s, t)).next());
+});
+import { B as p, d as g } from "./buffer-CwCRPuMA.js";
+const d = () => {
+  const s = {
+    end: () => {
+    },
+    spanContext: () => ({
+      traceId: "",
+      spanId: "",
+      traceFlags: 0
+    }),
+    setAttribute: (t, r) => s,
+    setAttributes: (t) => s,
+    addEvent: (t, r, e) => s,
+    addLinks: (t) => s,
+    setStatus: (t) => s,
+    recordException: () => {
+    },
+    addLink: () => s,
+    updateName: () => s,
+    isRecording: () => !1
+  };
+  return s;
+};
+function b(s, t, r) {
+  if (typeof r == "function")
+    return r;
+  if (typeof t == "function")
+    return t;
+  if (typeof s == "function")
+    return s;
+}
+const c = /* @__PURE__ */ new Set(["setAttributes", "removeAttributes"]);
+class _ extends p {
+  /**
+   * Applies buffered `setAttributes`/`removeAttributes` calls to `sdk`
+   * without attaching it. Call it before `sdk.start()` so attributes set
+   * before init reach spans recorded synchronously during start (e.g. the
+   * document load span). `load` also does this, so calling it is optional.
+   */
+  applyBufferedAttributes(t) {
+    const r = this._callBuffer.filter(
+      ({ method: e }) => c.has(e)
+    );
+    if (r.length) {
+      this._callBuffer = this._callBuffer.filter(
+        ({ method: e }) => !c.has(e)
+      ), this._sdk = t;
+      for (const { method: e, args: a } of r)
+        this._callSdk(e, a);
+    }
+  }
+  load(t, r) {
+    this.applyBufferedAttributes(t), super.load(t, r);
+  }
+  _startSdk() {
+    return o(this, null, function* () {
+      yield this._sdk.start();
+    });
+  }
+  // Never buffered: with `manualStart`, `start()` may run before the plugin
+  // has attached an SDK. It then stays pending and resolves once `load`
+  // attaches and starts the SDK.
+  start() {
+    return o(this, null, function* () {
+      return this._start();
+    });
+  }
+  // Never buffered, and never throws: before an SDK is attached it just
+  // cancels a start that has not run yet.
+  stop() {
+    return o(this, null, function* () {
+      yield this._stop(() => this._sdk.stop());
+    });
+  }
+  recordGauge(t) {
+    return this._bufferCall("recordGauge", [t]);
+  }
+  recordCount(t) {
+    return this._bufferCall("recordCount", [t]);
+  }
+  recordIncr(t) {
+    return this._bufferCall("recordIncr", [t]);
+  }
+  recordHistogram(t) {
+    return this._bufferCall("recordHistogram", [t]);
+  }
+  recordUpDownCounter(t) {
+    return this._bufferCall("recordUpDownCounter", [t]);
+  }
+  // The callback holds the caller's own work, so it must never be buffered:
+  // deferring it would replay that work at an arbitrary later time, or drop it.
+  startSpan(t, r, e, a) {
+    var n;
+    return this._isReady ? this._bufferCall("startSpan", [t, r, e, a]) : (this._logNoopSpanWarning(), (n = b(r, e, a)) == null ? void 0 : n(d()));
+  }
+  startManualSpan(t, r, e, a) {
+    var n;
+    return this._isReady ? this._bufferCall("startManualSpan", [t, r, e, a]) : (this._logNoopSpanWarning(), (n = b(r, e, a)) == null ? void 0 : n(d()));
+  }
+  _logNoopSpanWarning() {
+    g(
+      "startSpan/startManualSpan called before start()",
+      "span-before-start",
+      "warn",
+      "The span callback runs on a no-op span and the span is not recorded."
+    );
+  }
+  register(t, r) {
+    return this._bufferCall("register", [t, r]);
+  }
+  recordLog(t, r, e) {
+    return this._bufferCall("recordLog", [t, r, e]);
+  }
+  recordError(t, r, e, a, n) {
+    return this._bufferCall("recordError", [
+      t,
+      r,
+      e,
+      a,
+      n
+    ]);
+  }
+  setLDContextKeyAttributes(t) {
+    return this._bufferCall("setLDContextKeyAttributes", [t]);
+  }
+  // Applied directly once an SDK is attached, even before it starts (see
+  // ATTRIBUTE_METHODS).
+  setAttributes(t) {
+    return this._isLoaded ? this._callSdk("setAttributes", [t]) : this._bufferCall("setAttributes", [t]);
+  }
+  removeAttributes(t) {
+    return this._isLoaded ? this._callSdk("removeAttributes", [t]) : this._bufferCall("removeAttributes", [t]);
+  }
+  getLDContextKeyAttributes() {
+    return this._isLoaded ? this._callSdk("getLDContextKeyAttributes", []) : void 0;
+  }
+}
+let u;
+typeof globalThis != "undefined" ? globalThis.LDObserve ? u = globalThis.LDObserve : (u = new _(), globalThis.LDObserve = u) : u = new _();
+export {
+  u as L,
+  d as g
+};
+//# sourceMappingURL=LDObserve-o8Ro1UV8.js.map

package/dist/LDObserve-o8Ro1UV8.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LDObserve-o8Ro1UV8.js","sources":["../src/client/otel/utils.ts","../src/sdk/LDObserve.ts"],"sourcesContent":["import {\n\tAttributes,\n\tAttributeValue,\n\tLink,\n\tSpan,\n\tSpanStatus,\n\tTimeInput,\n} from '@opentelemetry/api'\n\nexport const getNoopSpan = () => {\n\tconst noopSpan: Span = {\n\t\tend: () => {},\n\t\tspanContext: () => ({\n\t\t\ttraceId: '',\n\t\t\tspanId: '',\n\t\t\ttraceFlags: 0,\n\t\t}),\n\t\tsetAttribute: (_key: string, _value: AttributeValue) => noopSpan,\n\t\tsetAttributes: (_attributes: Attributes) => noopSpan,\n\t\taddEvent: (\n\t\t\t_name: string,\n\t\t\t_attributesOrStartTime?: Attributes | TimeInput,\n\t\t\t_startTime?: TimeInput,\n\t\t) => noopSpan,\n\t\taddLinks: (_links: Link[]) => noopSpan,\n\t\tsetStatus: (_status: SpanStatus) => noopSpan,\n\t\trecordException: () => {},\n\t\taddLink: () => noopSpan,\n\t\tupdateName: () => noopSpan,\n\t\tisRecording: () => false,\n\t}\n\n\treturn noopSpan\n}\n","import type { Observe } from '../api/observe'\nimport type { LDClient } from '../integrations/launchdarkly'\nimport type { ErrorMessageType } from '../client/types/shared-types'\nimport type { OTelMetric as Metric } from '../client/types/types'\nimport type {\n\tAttributes,\n\tAttributeValue,\n\tContext,\n\tSpan,\n\tSpanOptions,\n} from '@opentelemetry/api'\nimport type { LDPluginEnvironmentMetadata } from '../plugins/plugin'\nimport { BufferedClass, type BufferedLoadOptions } from './buffer'\nimport { getNoopSpan } from '../client/otel/utils'\nimport { ConsoleMethods } from '../client/types/client'\nimport { internalLogOnce } from './util'\n\n/**\n * Resolves the span callback from whichever argument position it was passed in,\n * matching the overloads `startSpan` and `startManualSpan` accept.\n */\nfunction resolveSpanCallback(\n\toptions: unknown,\n\tcontext: unknown,\n\tfn: unknown,\n): ((span: Span) => any) | undefined {\n\tif (typeof fn === 'function') {\n\t\treturn fn as (span: Span) => any\n\t}\n\tif (typeof context === 'function') {\n\t\treturn context as (span: Span) => any\n\t}\n\tif (typeof options === 'function') {\n\t\treturn options as (span: Span) => any\n\t}\n\treturn undefined\n}\n\n// Calls that only update SDK state used to tag telemetry. Buffered ones are\n// applied as soon as an SDK is attached, before it starts, so they reach\n// telemetry recorded during start-up (e.g. the document load span).\nconst ATTRIBUTE_METHODS = new Set(['setAttributes', 'removeAttributes'])\n\nclass _LDObserve extends BufferedClass<Observe> implements Observe {\n\t/**\n\t * Applies buffered `setAttributes`/`removeAttributes` calls to `sdk`\n\t * without attaching it. Call it before `sdk.start()` so attributes set\n\t * before init reach spans recorded synchronously during start (e.g. the\n\t * document load span). `load` also does this, so calling it is optional.\n\t */\n\tapplyBufferedAttributes(sdk: Observe) {\n\t\tconst attributeCalls = this._callBuffer.filter(({ method }) =>\n\t\t\tATTRIBUTE_METHODS.has(method),\n\t\t)\n\t\tif (!attributeCalls.length) {\n\t\t\treturn\n\t\t}\n\t\tthis._callBuffer = this._callBuffer.filter(\n\t\t\t({ method }) => !ATTRIBUTE_METHODS.has(method),\n\t\t)\n\t\tthis._sdk = sdk\n\t\tfor (const { method, args } of attributeCalls) {\n\t\t\tthis._callSdk(method, args)\n\t\t}\n\t}\n\n\tload(sdk: Observe, options?: BufferedLoadOptions) {\n\t\tthis.applyBufferedAttributes(sdk)\n\t\tsuper.load(sdk, options)\n\t}\n\n\tprotected async _startSdk() {\n\t\tawait this._sdk.start()\n\t}\n\n\t// Never buffered: with `manualStart`, `start()` may run before the plugin\n\t// has attached an SDK. It then stays pending and resolves once `load`\n\t// attaches and starts the SDK.\n\tasync start() {\n\t\treturn this._start()\n\t}\n\n\t// Never buffered, and never throws: before an SDK is attached it just\n\t// cancels a start that has not run yet.\n\tasync stop() {\n\t\tawait this._stop(() => this._sdk.stop())\n\t}\n\n\trecordGauge(metric: Metric) {\n\t\treturn this._bufferCall('recordGauge', [metric])\n\t}\n\n\trecordCount(metric: Metric) {\n\t\treturn this._bufferCall('recordCount', [metric])\n\t}\n\n\trecordIncr(metric: Omit<Metric, 'value'>) {\n\t\treturn this._bufferCall('recordIncr', [metric])\n\t}\n\n\trecordHistogram(metric: Metric) {\n\t\treturn this._bufferCall('recordHistogram', [metric])\n\t}\n\n\trecordUpDownCounter(metric: Metric) {\n\t\treturn this._bufferCall('recordUpDownCounter', [metric])\n\t}\n\n\t// The callback holds the caller's own work, so it must never be buffered:\n\t// deferring it would replay that work at an arbitrary later time, or drop it.\n\tstartSpan(\n\t\tname: string,\n\t\toptions: SpanOptions | ((span?: Span) => any),\n\t\tcontext?: Context | ((span?: Span) => any),\n\t\tfn?: (span?: Span) => any,\n\t) {\n\t\tif (!this._isReady) {\n\t\t\tthis._logNoopSpanWarning()\n\t\t\treturn resolveSpanCallback(options, context, fn)?.(getNoopSpan())\n\t\t}\n\t\treturn this._bufferCall('startSpan', [name, options, context, fn])\n\t}\n\n\tstartManualSpan(\n\t\tname: string,\n\t\toptions: SpanOptions | ((span: Span) => any),\n\t\tcontext?: Context | ((span: Span) => any),\n\t\tfn?: (span: Span) => any,\n\t) {\n\t\tif (!this._isReady) {\n\t\t\tthis._logNoopSpanWarning()\n\t\t\treturn resolveSpanCallback(options, context, fn)?.(getNoopSpan())\n\t\t}\n\t\treturn this._bufferCall('startManualSpan', [name, options, context, fn])\n\t}\n\n\tprivate _logNoopSpanWarning() {\n\t\tinternalLogOnce(\n\t\t\t'startSpan/startManualSpan called before start()',\n\t\t\t'span-before-start',\n\t\t\t'warn',\n\t\t\t'The span callback runs on a no-op span and the span is not recorded.',\n\t\t)\n\t}\n\n\tregister(\n\t\tclient: LDClient,\n\t\tenvironmentMetadata: LDPluginEnvironmentMetadata,\n\t) {\n\t\treturn this._bufferCall('register', [client, environmentMetadata])\n\t}\n\n\trecordLog(message: any, level: ConsoleMethods, metadata?: Attributes) {\n\t\treturn this._bufferCall('recordLog', [message, level, metadata])\n\t}\n\n\trecordError(\n\t\terror: Error,\n\t\tmessage?: string,\n\t\tpayload?: { [key: string]: string },\n\t\tsource?: string,\n\t\ttype?: ErrorMessageType,\n\t) {\n\t\treturn this._bufferCall('recordError', [\n\t\t\terror,\n\t\t\tmessage,\n\t\t\tpayload,\n\t\t\tsource,\n\t\t\ttype,\n\t\t])\n\t}\n\n\tsetLDContextKeyAttributes(contextKeys: Attributes) {\n\t\treturn this._bufferCall('setLDContextKeyAttributes', [contextKeys])\n\t}\n\n\t// Applied directly once an SDK is attached, even before it starts (see\n\t// ATTRIBUTE_METHODS).\n\tsetAttributes(\n\t\tattributes: Record<string, AttributeValue | null | undefined>,\n\t) {\n\t\tif (this._isLoaded) {\n\t\t\treturn this._callSdk('setAttributes', [attributes])\n\t\t}\n\t\treturn this._bufferCall('setAttributes', [attributes])\n\t}\n\n\tremoveAttributes(keys: string[]) {\n\t\tif (this._isLoaded) {\n\t\t\treturn this._callSdk('removeAttributes', [keys])\n\t\t}\n\t\treturn this._bufferCall('removeAttributes', [keys])\n\t}\n\n\tgetLDContextKeyAttributes(): Attributes | undefined {\n\t\t// A getter: read directly once attached rather than buffering.\n\t\treturn this._isLoaded\n\t\t\t? this._callSdk('getLDContextKeyAttributes', [])\n\t\t\t: undefined\n\t}\n}\n\ninterface GlobalThis {\n\tLDObserve?: _LDObserve\n}\ndeclare var globalThis: GlobalThis\n\nexport let LDObserve!: _LDObserve\nif (typeof globalThis !== 'undefined') {\n\tif (globalThis.LDObserve) {\n\t\tLDObserve = globalThis.LDObserve\n\t} else {\n\t\tLDObserve = new _LDObserve()\n\t\tglobalThis.LDObserve = LDObserve\n\t}\n} else {\n\tLDObserve = new _LDObserve()\n}\n"],"names":["getNoopSpan","noopSpan","_key","_value","_attributes","_name","_attributesOrStartTime","_startTime","_links","_status","resolveSpanCallback","options","context","fn","ATTRIBUTE_METHODS","_LDObserve","BufferedClass","sdk","attributeCalls","method","args","__async","metric","name","_a","internalLogOnce","client","environmentMetadata","message","level","metadata","error","payload","source","type","contextKeys","attributes","keys","LDObserve"],"mappings":"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"}

package/dist/LDObserve.d.ts

@@ -226,6 +226,14 @@ declare interface LDClientMin {
 export declare let LDObserve: _LDObserve;
 
 declare class _LDObserve extends BufferedClass<Observe> implements Observe {
+    /**
+     * Applies buffered `setAttributes`/`removeAttributes` calls to `sdk`
+     * without attaching it. Call it before `sdk.start()` so attributes set
+     * before init reach spans recorded synchronously during start (e.g. the
+     * document load span). `load` also does this, so calling it is optional.
+     */
+    applyBufferedAttributes(sdk: Observe): void;
+    load(sdk: Observe, options?: BufferedLoadOptions): void;
     protected _startSdk(): Promise<void>;
     start(): Promise<void>;
     stop(): Promise<void>;
@@ -243,6 +251,8 @@ declare class _LDObserve extends BufferedClass<Observe> implements Observe {
         [key: string]: string;
     }, source?: string, type?: ErrorMessageType): any;
     setLDContextKeyAttributes(contextKeys: Attributes): any;
+    setAttributes(attributes: Record<string, AttributeValue | null | undefined>): any;
+    removeAttributes(keys: string[]): any;
     getLDContextKeyAttributes(): Attributes | undefined;
 }
 
@@ -412,6 +422,40 @@ declare interface Observe {
      * Useful when you don't want to emit a console log to the browser dev tools but still want to report a custom log.
      */
     recordLog: (message: any, level: ConsoleMethods, metadata?: Attributes) => void;
+    /**
+     * Adds attributes to all telemetry recorded from now on: every span
+     * (including automatically instrumented ones such as document load,
+     * fetch/XHR, clicks and page views), log, error and metric.
+     *
+     * Calling it again merges with the attributes already set; a `null` or
+     * `undefined` value removes that key. Attributes passed to an individual
+     * call (for example `recordLog` metadata or metric attributes) take
+     * precedence over these. Keys in namespaces the SDK sets itself
+     * (`highlight.*`, `launchdarkly.*`, `session.*`, `context.contextKeys.*`)
+     * are ignored.
+     *
+     * Attributes are held in memory for the current page load only: they are
+     * never persisted, and a full page load starts without them.
+     *
+     * Each attribute is also added to every metric, so a value with many
+     * distinct values (such as a user ID) creates as many metric series.
+     *
+     * @example
+     * ```typescript
+     * LDObserve.setAttributes({ utm_campaign: 'spring_promo', utm_source: 'email' })
+     * ```
+     */
+    setAttributes(attributes: Record<string, AttributeValue | null | undefined>): void;
+    /**
+     * Removes attributes previously added with `setAttributes`. Telemetry
+     * recorded afterwards no longer carries them.
+     *
+     * @example
+     * ```typescript
+     * LDObserve.removeAttributes(['utm_campaign'])
+     * ```
+     */
+    removeAttributes(keys: string[]): void;
     register(client: LDClientMin, environmentMetadata: LDPluginEnvironmentMetadata): void;
     getHooks?(metadata: LDPluginEnvironmentMetadata): Hook[];
     setLDContextKeyAttributes(contextKeys: Attributes): void;

package/dist/LDObserve.js

@@ -1,5 +1,5 @@
 import "./buffer-CwCRPuMA.js";
-import { L as m } from "./LDObserve-BQr7RYVC.js";
+import { L as m } from "./LDObserve-o8Ro1UV8.js";
 export {
   m as LDObserve
 };