@launchdarkly/o11y 1.4.1 → 1.6.0

package/dist/record.d.ts

@@ -77,10 +77,26 @@ declare type attributeMutation = {
     };
 };
 
+/**
+ * Attributes is a map from string to attribute values.
+ *
+ * Note: only the own enumerable keys are counted as valid attribute keys.
+ */
+declare interface Attributes {
+    [attributeKey: string]: AttributeValue | undefined;
+}
+
 declare type attributes = cssTextKeyAttr & {
     [key: string]: string | number | true | null;
 };
 
+/**
+ * Attribute values may be any non-nullish primitive value except an object.
+ *
+ * null or undefined attribute values are invalid and will result in undefined behavior.
+ */
+declare type AttributeValue = string | number | boolean | Array<null | undefined | string> | Array<null | undefined | number> | Array<null | undefined | boolean>;
+
 declare type CanvasArg = SerializedCanvasArg | string | number | boolean | null | CanvasArg[];
 
 declare enum CanvasContext {
@@ -318,6 +334,34 @@ declare type Exact<T extends {
     [K in keyof T]: T[K];
 };
 
+/**
+ * Defines Exception.
+ *
+ * string or an object with one of (message or name or code) and optional stack
+ */
+declare type Exception = ExceptionWithCode | ExceptionWithMessage | ExceptionWithName | string;
+
+declare interface ExceptionWithCode {
+    code: string | number;
+    name?: string;
+    message?: string;
+    stack?: string;
+}
+
+declare interface ExceptionWithMessage {
+    code?: string | number;
+    message: string;
+    name?: string;
+    stack?: string;
+}
+
+declare interface ExceptionWithName {
+    code?: string | number;
+    message?: string;
+    name: string;
+    stack?: string;
+}
+
 declare type FeedbackMessage = {
     type: MessageType.Feedback;
     verbatim: string;
@@ -622,6 +666,33 @@ declare type Hook = Omit<Hook_2, 'afterEvaluation'> & {
     }): EvaluationSeriesData;
 };
 
+/**
+ * Defines High-Resolution Time.
+ *
+ * The first number, HrTime[0], is UNIX Epoch time in seconds since 00:00:00 UTC on 1 January 1970.
+ * The second number, HrTime[1], represents the partial second elapsed since Unix Epoch time represented by first number in nanoseconds.
+ * For example, 2021-01-01T12:30:10.150Z in UNIX Epoch time in milliseconds is represented as 1609504210150.
+ * The first number is calculated by converting and truncating the Epoch time in milliseconds to seconds:
+ * HrTime[0] = Math.trunc(1609504210150 / 1000) = 1609504210.
+ * The second number is calculated by converting the digits after the decimal point of the subtraction, (1609504210150 / 1000) - HrTime[0], to nanoseconds:
+ * HrTime[1] = Number((1609504210.150 - HrTime[0]).toFixed(9)) * 1e9 = 150000000.
+ * This is represented in HrTime format as [1609504210, 150000000].
+ */
+declare type HrTime = [number, number];
+
+/**
+ * Describes the request behind an auto-instrumented browser `fetch` or
+ * `XMLHttpRequest` span.
+ */
+declare type HttpSpanRequest = {
+    /** Which instrumentation created the span. */
+    type: 'fetch' | 'xhr';
+    /** Upper-cased HTTP method, e.g. `GET`. */
+    method: string;
+    /** The concrete request URL, e.g. `https://app.example.com/api/users/42`. */
+    url: string;
+};
+
 declare type IdentifyMessage = {
     type: MessageType.Identify;
     userIdentifier: string;
@@ -705,6 +776,30 @@ declare interface LDPlugin {
     getHooks?(metadata: LDPluginEnvironmentMetadata): Hook[];
 }
 
+/**
+ * A pointer from the current {@link Span} to another span in the same trace or
+ * in a different trace.
+ * Few examples of Link usage.
+ * 1. Batch Processing: A batch of elements may contain elements associated
+ *    with one or more traces/spans. Since there can only be one parent
+ *    SpanContext, Link is used to keep reference to SpanContext of all
+ *    elements in the batch.
+ * 2. Public Endpoint: A SpanContext in incoming client request on a public
+ *    endpoint is untrusted from service provider perspective. In such case it
+ *    is advisable to start a new trace with appropriate sampling decision.
+ *    However, it is desirable to associate incoming SpanContext to new trace
+ *    initiated on service provider side so two traces (from Client and from
+ *    Service Provider) can be correlated.
+ */
+declare interface Link {
+    /** The {@link SpanContext} of a linked span. */
+    context: SpanContext;
+    /** A set of {@link SpanAttributes} on the link. */
+    attributes?: SpanAttributes;
+    /** Count of attributes of the link that were dropped due to collection limits */
+    droppedAttributesCount?: number;
+}
+
 declare type listenerHandler = () => void;
 
 declare type loadedEvent = {
@@ -1094,6 +1189,55 @@ declare type ObserveOptions = CommonOptions & {
      * @default 2000
      */
     flagExposureDedupeMaxSize?: number;
+    /**
+     * Query parameters to read from the page URL and add as attributes to all
+     * telemetry, as if passed to `LDObserve.setAttributes`.
+     *
+     * When the SDK initializes, each listed parameter present in
+     * `location.search` becomes an attribute named after the parameter (e.g.
+     * `utm_campaign`) on every span (including document load, page view and
+     * fetch/XHR spans), log, error and metric for the rest of the page load,
+     * including after SPA navigation drops it from the URL.
+     *
+     * Last touch: when an SPA navigation lands on a URL with any listed
+     * parameter, the captured values are replaced by that URL's values, and
+     * previously captured keys missing from it are removed, so the set always
+     * reflects one landing. A navigation without listed parameters keeps the
+     * current values. Spans already started keep the values they had.
+     *
+     * Values are kept in memory only; nothing is written to storage or
+     * cookies, so a later full page load captures again from its own URL.
+     *
+     * Only the listed keys are captured, so other query parameters (which may
+     * hold personal data such as emails or tokens) are never recorded this
+     * way. The default list contains UTM parameters only. A name ending in `*`
+     * matches every parameter with that prefix (e.g. `'utm_*'`).
+     *
+     * Keys set with `setAttributes` win: capture never replaces or removes a
+     * key the app set itself. `removeAttributes` removes a captured value
+     * (a later landing with that parameter captures it again). Keys in the
+     * namespaces the SDK sets itself (`highlight.*`, `launchdarkly.*`,
+     * `session.*`, `context.contextKeys.*`) are ignored.
+     *
+     * A custom list replaces the default. Set to `false` or `[]` to turn
+     * capture off.
+     * @default ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content']
+     * @example captureQueryParams: ['utm_source', 'utm_campaign', 'gclid']
+     */
+    captureQueryParams?: string[] | false;
+    /**
+     * Specifies whether to record the page that linked to this one. When the
+     * SDK initializes and `document.referrer` is a different origin, it is
+     * added as the `landing.referrer` attribute to all telemetry for the rest
+     * of the page load, as if passed to `LDObserve.setAttributes`.
+     *
+     * Only the origin and path are kept: the query string, fragment and any
+     * credentials are stripped so tokens or personal data in the referrer URL
+     * are not recorded. An empty or same-origin referrer sets nothing, and
+     * the value is not updated on SPA navigation.
+     * @default true
+     */
+    captureReferrer?: boolean;
 };
 
 declare type OtelInstrumentatonOptions = {
@@ -1105,6 +1249,32 @@ declare type OtelInstrumentatonOptions = {
 
 declare type OtelOptions = {
     instrumentations?: OtelInstrumentatonOptions;
+    /**
+     * Called for each auto-instrumented `fetch` and `XMLHttpRequest` span just
+     * before it ends, so the response and error status are already on it.
+     * Use it to rename the span or add attributes, for example to give it a
+     * route template:
+     *
+     * ```ts
+     * onHttpRequestSpan: (span, { method, url }) => {
+     *   const route = matchRoute(url) // '/api/users/{userId}'
+     *   if (!route) return
+     *   span.updateName(`${method} ${route}`)
+     *   span.setAttributes({
+     *     'http.route': route,
+     *     'url.template': route,
+     *     'launchdarkly.operation.name': route,
+     *   })
+     * }
+     * ```
+     *
+     * The span's trace and span ids are fixed when the request starts, so
+     * renaming does not affect the `traceparent` sent to your backend.
+     * Errors thrown by the callback are swallowed. Requires
+     * `networkRecording` to be enabled, as the instrumentations are not
+     * installed otherwise.
+     */
+    onHttpRequestSpan?: (span: Span, request: HttpSpanRequest) => void;
 };
 
 declare class Plugin_2<T extends RecordOptions | ObserveOptions> {
@@ -1408,6 +1578,7 @@ declare class RecordSDK implements Record_3 {
     _isCrossOriginIframe: boolean;
     _eventBytesSinceSnapshot: number;
     _lastSnapshotTime: number;
+    _snapshotPayloadIds: Set<number>;
     _lastVisibilityChangeTime: number;
     pushPayloadTimerId: ReturnType<typeof setTimeout> | undefined;
     hasSessionUnloaded: boolean;
@@ -1682,6 +1853,208 @@ declare type SessionShortcutOptions = false | string;
 
 declare type Source = 'segment' | 'LaunchDarkly' | undefined;
 
+/**
+ * An interface that represents a span. A span represents a single operation
+ * within a trace. Examples of span might include remote procedure calls or a
+ * in-process function calls to sub-components. A Trace has a single, top-level
+ * "root" Span that in turn may have zero or more child Spans, which in turn
+ * may have children.
+ *
+ * Spans are created by the {@link Tracer.startSpan} method.
+ */
+declare interface Span {
+    /**
+     * Returns the {@link SpanContext} object associated with this Span.
+     *
+     * Get an immutable, serializable identifier for this span that can be used
+     * to create new child spans. Returned SpanContext is usable even after the
+     * span ends.
+     *
+     * @returns the SpanContext object associated with this Span.
+     */
+    spanContext(): SpanContext;
+    /**
+     * Sets an attribute to the span.
+     *
+     * Sets a single Attribute with the key and value passed as arguments.
+     *
+     * @param key the key for this attribute.
+     * @param value the value for this attribute. Setting a value null or
+     *              undefined is invalid and will result in undefined behavior.
+     */
+    setAttribute(key: string, value: SpanAttributeValue): this;
+    /**
+     * Sets attributes to the span.
+     *
+     * @param attributes the attributes that will be added.
+     *                   null or undefined attribute values
+     *                   are invalid and will result in undefined behavior.
+     */
+    setAttributes(attributes: SpanAttributes): this;
+    /**
+     * Adds an event to the Span.
+     *
+     * @param name the name of the event.
+     * @param [attributesOrStartTime] the attributes that will be added; these are
+     *     associated with this event. Can be also a start time
+     *     if type is {@type TimeInput} and 3rd param is undefined
+     * @param [startTime] start time of the event.
+     */
+    addEvent(name: string, attributesOrStartTime?: SpanAttributes | TimeInput, startTime?: TimeInput): this;
+    /**
+     * Adds a single link to the span.
+     *
+     * Links added after the creation will not affect the sampling decision.
+     * It is preferred span links be added at span creation.
+     *
+     * @param link the link to add.
+     */
+    addLink(link: Link): this;
+    /**
+     * Adds multiple links to the span.
+     *
+     * Links added after the creation will not affect the sampling decision.
+     * It is preferred span links be added at span creation.
+     *
+     * @param links the links to add.
+     */
+    addLinks(links: Link[]): this;
+    /**
+     * Sets a status to the span. If used, this will override the default Span
+     * status. Default is {@link SpanStatusCode.UNSET}. SetStatus overrides the value
+     * of previous calls to SetStatus on the Span.
+     *
+     * @param status the SpanStatus to set.
+     */
+    setStatus(status: SpanStatus): this;
+    /**
+     * Updates the Span name.
+     *
+     * This will override the name provided via {@link Tracer.startSpan}.
+     *
+     * Upon this update, any sampling behavior based on Span name will depend on
+     * the implementation.
+     *
+     * @param name the Span name.
+     */
+    updateName(name: string): this;
+    /**
+     * Marks the end of Span execution.
+     *
+     * Call to End of a Span MUST not have any effects on child spans. Those may
+     * still be running and can be ended later.
+     *
+     * Do not return `this`. The Span generally should not be used after it
+     * is ended so chaining is not desired in this context.
+     *
+     * @param [endTime] the time to set as Span's end time. If not provided,
+     *     use the current time as the span's end time.
+     */
+    end(endTime?: TimeInput): void;
+    /**
+     * Returns the flag whether this span will be recorded.
+     *
+     * @returns true if this Span is active and recording information like events
+     *     with the `AddEvent` operation and attributes using `setAttributes`.
+     */
+    isRecording(): boolean;
+    /**
+     * Sets exception as a span event
+     * @param exception the exception the only accepted values are string or Error
+     * @param [time] the time to set as Span's event time. If not provided,
+     *     use the current time.
+     */
+    recordException(exception: Exception, time?: TimeInput): void;
+}
+
+/**
+ * @deprecated please use {@link Attributes}
+ */
+declare type SpanAttributes = Attributes;
+
+/**
+ * @deprecated please use {@link AttributeValue}
+ */
+declare type SpanAttributeValue = AttributeValue;
+
+/**
+ * A SpanContext represents the portion of a {@link Span} which must be
+ * serialized and propagated along side of a {@link Baggage}.
+ */
+declare interface SpanContext {
+    /**
+     * The ID of the trace that this span belongs to. It is worldwide unique
+     * with practically sufficient probability by being made as 16 randomly
+     * generated bytes, encoded as a 32 lowercase hex characters corresponding to
+     * 128 bits.
+     */
+    traceId: string;
+    /**
+     * The ID of the Span. It is globally unique with practically sufficient
+     * probability by being made as 8 randomly generated bytes, encoded as a 16
+     * lowercase hex characters corresponding to 64 bits.
+     */
+    spanId: string;
+    /**
+     * Only true if the SpanContext was propagated from a remote parent.
+     */
+    isRemote?: boolean;
+    /**
+     * Trace flags to propagate.
+     *
+     * It is represented as 1 byte (bitmap). Bit to represent whether trace is
+     * sampled or not. When set, the least significant bit documents that the
+     * caller may have recorded trace data. A caller who does not record trace
+     * data out-of-band leaves this flag unset.
+     *
+     * see {@link TraceFlags} for valid flag values.
+     */
+    traceFlags: number;
+    /**
+     * Tracing-system-specific info to propagate.
+     *
+     * The tracestate field value is a `list` as defined below. The `list` is a
+     * series of `list-members` separated by commas `,`, and a list-member is a
+     * key/value pair separated by an equals sign `=`. Spaces and horizontal tabs
+     * surrounding `list-members` are ignored. There can be a maximum of 32
+     * `list-members` in a `list`.
+     * More Info: https://www.w3.org/TR/trace-context/#tracestate-field
+     *
+     * Examples:
+     *     Single tracing system (generic format):
+     *         tracestate: rojo=00f067aa0ba902b7
+     *     Multiple tracing systems (with different formatting):
+     *         tracestate: rojo=00f067aa0ba902b7,congo=t61rcWkgMzE
+     */
+    traceState?: TraceState;
+}
+
+declare interface SpanStatus {
+    /** The status code of this message. */
+    code: SpanStatusCode;
+    /** A developer-facing error message. */
+    message?: string;
+}
+
+/**
+ * An enumeration of status codes.
+ */
+declare enum SpanStatusCode {
+    /**
+     * The default status.
+     */
+    UNSET = 0,
+    /**
+     * The operation has been validated by an Application developer or
+     * Operator to have completed successfully.
+     */
+    OK = 1,
+    /**
+     * The operation contains an error.
+     */
+    ERROR = 2
+}
+
 declare interface StartOptions {
     /**
      * Specifies whether console warn messages should not be created.
@@ -1768,6 +2141,51 @@ declare type textNode = {
     isStyle?: true;
 };
 
+/**
+ * Defines TimeInput.
+ *
+ * hrtime, epoch milliseconds, performance.now() or Date
+ */
+declare type TimeInput = HrTime | number | Date;
+
+declare interface TraceState {
+    /**
+     * Create a new TraceState which inherits from this TraceState and has the
+     * given key set.
+     * The new entry will always be added in the front of the list of states.
+     *
+     * @param key key of the TraceState entry.
+     * @param value value of the TraceState entry.
+     */
+    set(key: string, value: string): TraceState;
+    /**
+     * Return a new TraceState which inherits from this TraceState but does not
+     * contain the given key.
+     *
+     * @param key the key for the TraceState entry to be removed.
+     */
+    unset(key: string): TraceState;
+    /**
+     * Returns the value to which the specified key is mapped, or `undefined` if
+     * this map contains no mapping for the key.
+     *
+     * @param key with which the specified value is to be associated.
+     * @returns the value to which the specified key is mapped, or `undefined` if
+     *     this map contains no mapping for the key.
+     */
+    get(key: string): string | undefined;
+    /**
+     * Serializes the TraceState to a `list` as defined below. The `list` is a
+     * series of `list-members` separated by commas `,`, and a list-member is a
+     * key/value pair separated by an equals sign `=`. Spaces and horizontal tabs
+     * surrounding `list-members` are ignored. There can be a maximum of 32
+     * `list-members` in a `list`.
+     *
+     * @returns the serialized string.
+     */
+    serialize(): string;
+}
+
 declare type viewportResizeData = {
     source: IncrementalSource.ViewportResize;
 } & viewportResizeDimension;

package/dist/record.js

@@ -1,5 +1,5 @@
-import "./common-D8kkCWo3.js";
-import { R as i } from "./record-DG2IcHxO.js";
+import "./common-C6gSg2Rq.js";
+import { R as i } from "./record-BpTfYU5r.js";
 import "./LDRecord.js";
 import "./buffer-CwCRPuMA.js";
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@launchdarkly/o11y",
-  "version": "1.4.1",
+  "version": "1.6.0",
   "description": "Shared browser foundation for @launchdarkly/observability and @launchdarkly/session-replay. Capture frontend metrics, errors, logs, traces, and session replays.",
   "keywords": [
     "launchdarkly",

package/dist/LDObserve-BQr7RYVC.js

@@ -1,130 +0,0 @@
-var i = (e, r, t) => new Promise((a, s) => {
-  var n = (o) => {
-    try {
-      l(t.next(o));
-    } catch (d) {
-      s(d);
-    }
-  }, b = (o) => {
-    try {
-      l(t.throw(o));
-    } catch (d) {
-      s(d);
-    }
-  }, l = (o) => o.done ? a(o.value) : Promise.resolve(o.value).then(n, b);
-  l((t = t.apply(e, r)).next());
-});
-import { B as _, d as h } from "./buffer-CwCRPuMA.js";
-const f = () => {
-  const e = {
-    end: () => {
-    },
-    spanContext: () => ({
-      traceId: "",
-      spanId: "",
-      traceFlags: 0
-    }),
-    setAttribute: (r, t) => e,
-    setAttributes: (r) => e,
-    addEvent: (r, t, a) => e,
-    addLinks: (r) => e,
-    setStatus: (r) => e,
-    recordException: () => {
-    },
-    addLink: () => e,
-    updateName: () => e,
-    isRecording: () => !1
-  };
-  return e;
-};
-function c(e, r, t) {
-  if (typeof t == "function")
-    return t;
-  if (typeof r == "function")
-    return r;
-  if (typeof e == "function")
-    return e;
-}
-class p extends _ {
-  _startSdk() {
-    return i(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 i(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 i(this, null, function* () {
-      yield this._stop(() => this._sdk.stop());
-    });
-  }
-  recordGauge(r) {
-    return this._bufferCall("recordGauge", [r]);
-  }
-  recordCount(r) {
-    return this._bufferCall("recordCount", [r]);
-  }
-  recordIncr(r) {
-    return this._bufferCall("recordIncr", [r]);
-  }
-  recordHistogram(r) {
-    return this._bufferCall("recordHistogram", [r]);
-  }
-  recordUpDownCounter(r) {
-    return this._bufferCall("recordUpDownCounter", [r]);
-  }
-  // 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(r, t, a, s) {
-    var n;
-    return this._isReady ? this._bufferCall("startSpan", [r, t, a, s]) : (this._logNoopSpanWarning(), (n = c(t, a, s)) == null ? void 0 : n(f()));
-  }
-  startManualSpan(r, t, a, s) {
-    var n;
-    return this._isReady ? this._bufferCall("startManualSpan", [r, t, a, s]) : (this._logNoopSpanWarning(), (n = c(t, a, s)) == null ? void 0 : n(f()));
-  }
-  _logNoopSpanWarning() {
-    h(
-      "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(r, t) {
-    return this._bufferCall("register", [r, t]);
-  }
-  recordLog(r, t, a) {
-    return this._bufferCall("recordLog", [r, t, a]);
-  }
-  recordError(r, t, a, s, n) {
-    return this._bufferCall("recordError", [
-      r,
-      t,
-      a,
-      s,
-      n
-    ]);
-  }
-  setLDContextKeyAttributes(r) {
-    return this._bufferCall("setLDContextKeyAttributes", [r]);
-  }
-  getLDContextKeyAttributes() {
-    return this._isLoaded ? this._callSdk("getLDContextKeyAttributes", []) : void 0;
-  }
-}
-let u;
-typeof globalThis != "undefined" ? globalThis.LDObserve ? u = globalThis.LDObserve : (u = new p(), globalThis.LDObserve = u) : u = new p();
-export {
-  u as L,
-  f as g
-};
-//# sourceMappingURL=LDObserve-BQr7RYVC.js.map

package/dist/LDObserve-BQr7RYVC.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"LDObserve-BQr7RYVC.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 { Attributes, Context, Span, SpanOptions } from '@opentelemetry/api'\nimport type { LDPluginEnvironmentMetadata } from '../plugins/plugin'\nimport { BufferedClass } 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\nclass _LDObserve extends BufferedClass<Observe> implements Observe {\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\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","_LDObserve","BufferedClass","__async","metric","name","_a","internalLogOnce","client","environmentMetadata","message","level","metadata","error","payload","source","type","contextKeys","LDObserve"],"mappings":"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"}