@interopio/otel 0.0.13 → 0.0.16

package/dist/traces/nullTracingState.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NullTracingState = void 0;
+const api_1 = require("@opentelemetry/api");
+class NullTracingState {
+    constructor(source, propagationInfo) {
+        this.source = source;
+        this.propagationInfo = propagationInfo;
+        this.level = "OFF";
+    }
+    endSpan() {
+        return Promise.resolve();
+    }
+    get enabled() {
+        return false;
+    }
+    get id() {
+        return undefined;
+    }
+    get traceId() {
+        return undefined;
+    }
+    setStatus(status) {
+        return this;
+    }
+    addEvent(name, attributesOrStartTime, startTime) {
+        return this;
+    }
+    recordException(exception, time) { }
+    isRecording() {
+        return false;
+    }
+    updateName(name) {
+        return this;
+    }
+    spanContext() {
+        return undefined;
+    }
+    addData(level, data) {
+        return Promise.resolve();
+    }
+    getPropagationInfo() {
+        if (this.propagationInfo) {
+            return this.propagationInfo;
+        }
+        const propagationInfo = {};
+        api_1.propagation.inject(api_1.context.active(), propagationInfo);
+        return propagationInfo;
+    }
+    injectPropagationInfo(carrier) {
+        if (this.propagationInfo) {
+            carrier.__interopIOTracePropagationInfo = this.propagationInfo;
+        }
+    }
+}
+exports.NullTracingState = NullTracingState;
+//# sourceMappingURL=nullTracingState.js.map

package/dist/traces/nullTracingState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nullTracingState.js","sourceRoot":"","sources":["../../src/traces/nullTracingState.ts"],"names":[],"mappings":";;;AASA,4CAO4B;AAE5B,MAAa,gBAAgB;IAC3B,YAAmB,MAAc,EAAU,eAAuC;QAA/D,WAAM,GAAN,MAAM,CAAQ;QAAU,oBAAe,GAAf,eAAe,CAAwB;QAElF,UAAK,GAAG,KAAc,CAAC;IAF8D,CAAC;IAI/E,OAAO;QACZ,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED,IAAW,OAAO;QAChB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAW,EAAE;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAW,OAAO;QAChB,OAAO,SAAS,CAAC;IACnB,CAAC;IACM,SAAS,CAAC,MAAkB;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IACM,QAAQ,CACb,IAAY,EACZ,qBAA8C,EAC9C,SAAqB;QAErB,OAAO,IAAI,CAAC;IACd,CAAC;IACM,eAAe,CAAC,SAAoB,EAAE,IAAgB,IAAG,CAAC;IAC1D,WAAW;QAChB,OAAO,KAAK,CAAC;IACf,CAAC;IACM,UAAU,CAAC,IAAY;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IACM,WAAW;QAChB,OAAO,SAAS,CAAC;IACnB,CAAC;IAEM,OAAO,CAAC,KAAyC,EAAE,IAAmB;QAC3E,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAEM,kBAAkB;QACvB,IAAI,IAAI,CAAC,eAAe,EAAE;YACxB,OAAO,IAAI,CAAC,eAAe,CAAC;SAC7B;QACD,MAAM,eAAe,GAAG,EAAG,CAAC;QAC5B,iBAAW,CAAC,MAAM,CAAC,aAAO,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC;QACtD,OAAO,eAAe,CAAC;IACzB,CAAC;IAEM,qBAAqB,CAAC,OAA+B;QAC1D,IAAI,IAAI,CAAC,eAAe,EAAE;YACxB,OAAO,CAAC,+BAA+B,GAAG,IAAI,CAAC,eAAe,CAAC;SAChE;IACH,CAAC;CACF;AA1DD,4CA0DC"}

package/dist/traces/traces.d.ts

@@ -0,0 +1,21 @@
+import { PropagationInfo, PropagationInfoCarrier, TracesManager, TracingContext, TracingState, WithSpanCallback } from "./types";
+/**
+ * Null-safe singleton class that can be invoked even if you haven't initialized
+ * the library (yet?), or if you don't have access to the current manager instance.
+ */
+export default class Traces {
+    private static _instance;
+    static get instance(): TracesManager;
+    static set instance(value: TracesManager);
+    private static _currentTracingState;
+    static get currentTracingState(): TracingState;
+    static set currentTracingState(value: TracingState | null);
+    static extractTracingPropagationInfo(propagationInfoCarrier: PropagationInfo | PropagationInfoCarrier, deleteProperty?: boolean | undefined): PropagationInfo | null;
+    static withSpan(root: string, argMapping?: {
+        argMapping: Record<string, string>;
+    }): any;
+    static withSpan<T>(source: string, callback: WithSpanCallback<T>): Promise<T>;
+    static withSpan<T>(source: string, tracingContext: TracingContext | any, callback: WithSpanCallback<T>): Promise<T>;
+    static withSpan<T>(source: string, tracingContextOrCallback: TracingContext | WithSpanCallback<T> | any, propagationInfoOrCallback?: PropagationInfo | PropagationInfoCarrier | WithSpanCallback<T>, callback?: WithSpanCallback<T>): Promise<T>;
+}
+export declare const withSpan: typeof Traces.withSpan;

package/dist/traces/traces.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withSpan = void 0;
+/* eslint-disable @typescript-eslint/no-explicit-any */
+// TODO: fix types
+const nullTracesManager_1 = require("./nullTracesManager");
+const nullTracingState_1 = require("./nullTracingState");
+const utils_1 = require("./utils");
+/**
+ * Null-safe singleton class that can be invoked even if you haven't initialized
+ * the library (yet?), or if you don't have access to the current manager instance.
+ */
+class Traces {
+    static get instance() {
+        return Traces._instance;
+    }
+    static set instance(value) {
+        Traces._instance = value;
+    }
+    static get currentTracingState() {
+        return Traces._currentTracingState || new nullTracingState_1.NullTracingState("unknown", null);
+    }
+    static set currentTracingState(value) {
+        Traces._currentTracingState = value;
+    }
+    static extractTracingPropagationInfo(propagationInfoCarrier, deleteProperty) {
+        if (propagationInfoCarrier.traceparent) {
+            return propagationInfoCarrier;
+        }
+        const nestedPropagationInfo = propagationInfoCarrier
+            .__interopIOTracePropagationInfo;
+        if (nestedPropagationInfo) {
+            if (deleteProperty === true) {
+                delete propagationInfoCarrier.__interopIOTracePropagationInfo;
+            }
+            return nestedPropagationInfo;
+        }
+        else {
+            return null;
+        }
+    }
+    static withSpan(source, tracingContextOrCallback, propagationInfoOrCallback, callback) {
+        // decorator
+        if ((!tracingContextOrCallback || tracingContextOrCallback["argMapping"]) &&
+            !propagationInfoOrCallback &&
+            !callback) {
+            return function (target, propertyKey, descriptor) {
+                const originalFn = descriptor.value;
+                descriptor.value = function (...args) {
+                    return Traces.withSpan(source + "." + propertyKey, tracingContextOrCallback
+                        ? Object.assign({}, (0, utils_1.extractTracingContextFromArgs)(tracingContextOrCallback, args)) : {
+                        args,
+                    }, () => {
+                        return originalFn.apply(this, args);
+                    });
+                };
+            };
+        }
+        return Traces.instance.withSpan(source, tracingContextOrCallback, propagationInfoOrCallback, callback);
+    }
+}
+exports.default = Traces;
+Traces._instance = new nullTracesManager_1.NullTracesManager();
+exports.withSpan = Traces.withSpan;
+//# sourceMappingURL=traces.js.map

package/dist/traces/traces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traces.js","sourceRoot":"","sources":["../../src/traces/traces.ts"],"names":[],"mappings":";;;AAAA,uDAAuD;AACvD,kBAAkB;AAClB,2DAAwD;AACxD,yDAAsD;AAStD,mCAAwD;AAExD;;;GAGG;AACH,MAAqB,MAAM;IAGlB,MAAM,KAAK,QAAQ;QACxB,OAAO,MAAM,CAAC,SAAS,CAAC;IAC1B,CAAC;IACM,MAAM,KAAK,QAAQ,CAAC,KAAoB;QAC7C,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC;IAC3B,CAAC;IAGM,MAAM,KAAK,mBAAmB;QACnC,OAAO,MAAM,CAAC,oBAAoB,IAAI,IAAI,mCAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC9E,CAAC;IACM,MAAM,KAAK,mBAAmB,CAAC,KAA0B;QAC9D,MAAM,CAAC,oBAAoB,GAAG,KAAK,CAAC;IACtC,CAAC;IAED,MAAM,CAAC,6BAA6B,CAClC,sBAAgE,EAChE,cAAoC;QAEpC,IAAK,sBAA0C,CAAC,WAAW,EAAE;YAC3D,OAAO,sBAAyC,CAAC;SAClD;QACD,MAAM,qBAAqB,GAAI,sBAAiD;aAC7E,+BAA+B,CAAC;QACnC,IAAI,qBAAqB,EAAE;YACzB,IAAI,cAAc,KAAK,IAAI,EAAE;gBAC3B,OAAQ,sBAAiD,CAAC,+BAA+B,CAAC;aAC3F;YACD,OAAO,qBAAqB,CAAC;SAC9B;aAAM;YACL,OAAO,IAAI,CAAC;SACb;IACH,CAAC;IAiBD,MAAM,CAAC,QAAQ,CACb,MAAc,EACd,wBAAgF,EAChF,yBAA0F,EAC1F,QAA8B;QAE9B,YAAY;QACZ,IACE,CAAC,CAAC,wBAAwB,IAAI,wBAAwB,CAAC,YAAY,CAAC,CAAC;YACrE,CAAC,yBAAyB;YAC1B,CAAC,QAAQ,EACT;YACA,OAAO,UAAU,MAAW,EAAE,WAAmB,EAAE,UAA8B;gBAC/E,MAAM,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC;gBACpC,UAAU,CAAC,KAAK,GAAG,UAAU,GAAG,IAAW;oBACzC,OAAO,MAAM,CAAC,QAAQ,CACpB,MAAM,GAAG,GAAG,GAAG,WAAW,EAC1B,wBAAwB;wBACtB,CAAC,mBAAM,IAAA,qCAA6B,EAAC,wBAAwB,EAAE,IAAI,CAAC,EACpE,CAAC,CAAC;wBACE,IAAI;qBACL,EACL,GAAG,EAAE;wBACH,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;oBACtC,CAAC,CACF,CAAC;gBACJ,CAAC,CAAC;YACJ,CAAC,CAAC;SACH;QAED,OAAO,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAC7B,MAAM,EACN,wBAA+B,EAC/B,yBAAgC,EAChC,QAAe,CAChB,CAAC;IACJ,CAAC;;AAxFH,yBAyFC;AAvFgB,gBAAS,GAAkB,IAAI,qCAAiB,EAAE,CAAC;AAyFvD,QAAA,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC"}

package/dist/traces/tracingState.d.ts

@@ -1,26 +1,26 @@
-/// <reference types="node" />
 import { Logger } from "../logger/types";
 import { AttributeData, PropagationInfo, PropagationInfoCarrier, TracingState as ITracingState, Verbosity } from "./types";
-import { Span, SpanContext, Exception, TimeInput, Attributes, SpanStatus } from "@opentelemetry/api";
+import { Span, SpanContext, Exception, TimeInput, Attributes, SpanStatus, SpanStatusCode } from "@opentelemetry/api";
 export declare class TracingState implements ITracingState {
     source: string;
     level: keyof typeof Verbosity;
     span: Span;
     private logger;
     private version;
-    constructor(source: string, level: keyof typeof Verbosity, span: Span, logger: Logger, version: string, spanTimeoutMs: number | undefined);
+    SpanStatusCode: typeof SpanStatusCode;
+    currentSpanStatus: SpanStatus;
+    constructor(source: string, level: keyof typeof Verbosity, span: Span, logger: Logger, version: string);
     endSpan(timedOut?: boolean): Promise<void>;
     get enabled(): boolean;
     private hasEnded;
-    private _timeoutId;
-    get timeoutId(): NodeJS.Timeout | undefined;
     private spanContextField;
     get id(): string;
-    setStatus(status: SpanStatus): Span;
-    addEvent(name: string, attributesOrStartTime?: Attributes | TimeInput, startTime?: TimeInput): Span;
+    get traceId(): string;
+    setStatus(status: SpanStatus): this;
+    addEvent(name: string, attributesOrStartTime?: Attributes | TimeInput, startTime?: TimeInput): this;
     recordException(exception: Exception, time?: TimeInput): void;
     isRecording(): boolean;
-    updateName(name: string): Span;
+    updateName(name: string): this;
     spanContext(): SpanContext;
     addData(level: Verbosity | keyof typeof Verbosity, data: AttributeData): Promise<void>;
     getPropagationInfo(): PropagationInfo;

package/dist/traces/tracingState.js

@@ -5,59 +5,45 @@ const types_1 = require("./types");
 const api_1 = require("@opentelemetry/api");
 const utils_1 = require("./utils");
 class TracingState {
-    constructor(source, level, span, logger, version, spanTimeoutMs) {
+    constructor(source, level, span, logger, version) {
         this.source = source;
         this.level = level;
         this.span = span;
         this.logger = logger;
         this.version = version;
+        this.SpanStatusCode = api_1.SpanStatusCode;
+        this.currentSpanStatus = { code: api_1.SpanStatusCode.UNSET };
         this.hasEnded = false;
         this.spanContextField = span.spanContext();
-        if (spanTimeoutMs && spanTimeoutMs >= 0) {
-            this._timeoutId = setTimeout(() => {
-                this.endSpan(true);
-            }, spanTimeoutMs);
-        }
     }
     endSpan(timedOut) {
-        var _a, _b;
+        var _a;
         if (this.hasEnded) {
             (_a = this.logger) === null || _a === void 0 ? void 0 : _a.debug(`Span ended more than once: ${this.source}`);
         }
         else {
-            try {
-                this.hasEnded = true;
-                if (timedOut) {
-                    (_b = this.logger) === null || _b === void 0 ? void 0 : _b.debug(`Span timed out and was automatically ended: ${this.source}`);
-                    this.span.setStatus({
-                        code: api_1.SpanStatusCode.ERROR,
-                        message: "Span timed out",
-                    });
-                }
-                else {
-                    clearTimeout(this.timeoutId);
-                }
-            }
-            finally {
-                this.span.end();
-            }
+            this.hasEnded = true;
+            this.span.end();
         }
         return Promise.resolve();
     }
     get enabled() {
         return true;
     }
-    get timeoutId() {
-        return this._timeoutId;
-    }
     get id() {
         return this.spanContextField.spanId;
     }
+    get traceId() {
+        return this.spanContextField.traceId;
+    }
     setStatus(status) {
-        return this.span.setStatus.call(this.span, status);
+        this.currentSpanStatus = Object.assign({}, status);
+        this.span.setStatus.call(this.span, status);
+        return this;
     }
     addEvent(name, attributesOrStartTime, startTime) {
-        return this.span.addEvent.call(this.span, name, attributesOrStartTime, startTime);
+        this.span.addEvent.call(this.span, name, attributesOrStartTime, startTime);
+        return this;
     }
     recordException(exception, time) {
         this.span.recordException.call(this.span, exception, time);
@@ -66,7 +52,8 @@ class TracingState {
         return this.span.isRecording.call(this.span);
     }
     updateName(name) {
-        return this.span.updateName.call(this.span, name);
+        this.span.updateName.call(this.span, name);
+        return this;
     }
     spanContext() {
         return this.span.spanContext.call(this.span);
@@ -91,8 +78,8 @@ class TracingState {
             // TODO vnikolov: check if this needs to be populated
             tracestate: this.spanContextField.traceState && String(this.spanContextField.traceState),
         };
-        // this is a NOOP because we're using base SDK
-        api_1.propagation.inject(api_1.context.active(), propagationInfo);
+        // // this is a NOOP because we're using base SDK
+        // propagation.inject(context.active(), propagationInfo);
         return propagationInfo;
     }
     injectPropagationInfo(carrier) {

package/dist/traces/tracingState.js.map

@@ -1 +1 @@
-{"version":3,"file":"tracingState.js","sourceRoot":"","sources":["../../src/traces/tracingState.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tracingState.js","sourceRoot":"","sources":["../../src/traces/tracingState.ts"],"names":[],"mappings":"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"}

package/dist/traces/types.d.ts

@@ -1,14 +1,14 @@
-/// <reference types="node" />
-import { Span, TracerProvider } from "@opentelemetry/api";
+import { Attributes, Span, SpanStatus, SpanStatusCode, TimeInput, TracerProvider } from "@opentelemetry/api";
 import { Logger } from "../logger/types";
 import { Manager } from "../types";
+import { OTLPExporterNodeConfigBase } from "@opentelemetry/otlp-exporter-base";
+import { Sampler, SpanExporter, SpanProcessor } from "@opentelemetry/sdk-trace-base";
 export interface TracesManager extends Manager<TracesSettings> {
-    extractTracingPropagationInfo(propagationInfoCarrier: PropagationInfo | PropagationInfoCarrier): PropagationInfo | undefined;
-    withSpan(source: string, callback: WithSpanCallback): Promise<ReturnType<WithSpanCallback>>;
-    withSpan(source: string, tracingContext: TracingContext, callback: WithSpanCallback): Promise<ReturnType<WithSpanCallback>>;
-    withSpan(source: string, tracingContext: TracingContext, propagationInfo: PropagationInfo | PropagationInfoCarrier, callback: WithSpanCallback): Promise<ReturnType<WithSpanCallback>>;
+    withSpan<T>(source: string, callback: WithSpanCallback<T>): Promise<T>;
+    withSpan<T>(source: string, tracingContext: TracingContext, callback: WithSpanCallback<T>): Promise<T>;
+    withSpan<T>(source: string, tracingContext: TracingContext, propagationInfo: PropagationInfo | PropagationInfoCarrier, callback: WithSpanCallback<T>): Promise<T>;
 }
-export type WithSpanCallback = (tracingState: TracingState) => any | Promise<any>;
+export type WithSpanCallback<T> = (tracingState: TracingState) => T | Promise<T>;
 export interface PropagationInfo {
     traceparent?: string;
     tracestate?: string;
@@ -18,21 +18,22 @@ export interface PropagationInfoCarrier {
 }
 export interface TracingState {
     enabled: boolean;
+    SpanStatusCode?: typeof SpanStatusCode;
     level: keyof typeof Verbosity;
     addData(level: Verbosity | keyof typeof Verbosity, data: AttributeData): Promise<void>;
     source: string;
     id?: string;
-    timeoutId?: NodeJS.Timeout;
+    traceId?: string;
     endSpan(): Promise<void>;
-    span: Span | null;
+    span?: Span;
     getPropagationInfo: () => PropagationInfo | null;
     injectPropagationInfo: (carrier: PropagationInfoCarrier & object) => void;
-    setStatus?: Span["setStatus"];
-    addEvent?: Span["addEvent"];
+    setStatus?: (status: SpanStatus) => this;
+    addEvent?: (name: string, attributesOrStartTime?: Attributes | TimeInput, startTime?: TimeInput) => this;
     recordException?: Span["recordException"];
     isRecording?: Span["isRecording"];
-    updateName?: Span["updateName"];
-    spanContext?: Span["spanContext"];
+    updateName?: (name: string) => this;
+    spanContext?: Span["spanContext"] | (() => undefined);
 }
 export type AttributeArray = Array<null | undefined | string> | Array<null | undefined | number> | Array<null | undefined | boolean>;
 export interface AttributeData {
@@ -42,7 +43,11 @@ export interface TracingContext {
     app?: string;
     user?: string;
     serviceName?: string;
-    [key: string]: string | number | undefined;
+    serviceId?: string;
+    platformVersion?: string;
+    serviceVersion?: string;
+    userId?: string;
+    [key: string]: string | number | boolean | undefined;
 }
 export declare enum Verbosity {
     OFF = 0,
@@ -54,37 +59,244 @@ export declare enum Verbosity {
     HIGHEST = 6
 }
 export interface Filter {
-    source: string;
-    level: keyof typeof Verbosity;
-    enable?: boolean;
-    context: {
+    /**
+     * Specifies the source string used for matching spans.
+     * Spans match only if their source equals this value, or
+     * if their source starts with '<source>.' (e.g. my.api.foo
+     * starts with my.api).
+     *
+     * Start string with "#" for case-insensitive regex match.
+     */
+    source?: string;
+    /**
+     * Specifies the context values used for matching spans.
+     * Spans match only if all the values in this object match
+     * the context values returned by the context getter callback
+     * and the filteringContext config property.
+     *
+     * Start strings with "#" for case-insensitive regex match.
+     */
+    context?: {
         [key: string]: string | number | boolean;
     };
+    /**
+     * Whether the matched span will be created or will be a no-op.
+     *
+     * If not specified, see 'TracesDefaultsSettings'.
+     */
+    enabled?: boolean;
+    /**
+     * If filter is disabled, setting this to "true" will stop the propagation
+     * of tracing contexts.
+     */
+    stopPropagation?: boolean;
+    /**
+     * The attribute verbosity level of matched spans.
+     *
+     * If not specified, see 'TracesDefaultsSettings'.
+     */
+    level?: keyof typeof Verbosity;
+    /**
+     * Whether the filtering context will be added as span attributes
+     * to the matched span.
+     *
+     * If not specified, see 'TracesDefaultsSettings'.
+     */
+    addContextToTrace?: boolean;
+    /**
+     * Whether the span's status will be set to OK on completion, if
+     * it's still UNSET.
+     *
+     * If not specified, see 'TracesDefaultsSettings'.
+     */
+    autoSetSuccessStatus?: boolean;
 }
+/**
+ * Used for spans that didn't match a Filter or SamplingSettings entry,
+ * or if particular property isn't provided in matched entry.
+ */
 export interface TracesDefaultsSettings {
+    /**
+     * Whether the span will be created or will be a no-op. See 'Filter'.
+     *
+     * Defaults to 'true'.
+     */
     enabled?: boolean;
+    /**
+     * If filter is disabled, setting this to "true" will stop the propagation
+     * of tracing contexts.
+     */
+    stopPropagation?: boolean;
+    /**
+     * Default span attribute verbosity level. See 'Filter'.
+     *
+     * Defaults to 'INFO'.
+     */
     level?: keyof typeof Verbosity;
+    /**
+     * Whether the filtering context will be added as span attributes
+     * to the span. See 'Filter'.
+     *
+     * Defaults to 'true'.
+     */
+    addContextToTrace?: boolean;
+    /**
+     * Whether the span's status will be set to OK on completion, if
+     * it's still UNSET. See 'Filter'.
+     *
+     * Defaults to 'false'.
+     */
+    autoSetSuccessStatus?: boolean;
+    /**
+     * Default sampling setting/probability. See 'SamplingSettings'.
+     *
+     * Defaults to 'true'.
+     */
     sample?: number | boolean;
 }
 export interface TracesSettings {
+    /**
+     * Whether tracing functionality is enabled.
+     * If disabled, API is still usable, but methods are no-ops.
+     * Defaults to 'false'.
+     */
     enabled: boolean;
-    url?: string;
-    console?: boolean;
+    /**
+     * If provided, this value will be added to the span attributes
+     * and to the span filtering context (see 'filters').
+     */
+    platformVersion?: string;
+    /**
+     * If provided, these values will be added to the span attributes
+     * and to the span filtering context (see 'filters').
+     */
+    filteringContext?: {
+        [key: string]: string;
+    };
+    /**
+     * Array of filter entries used to determine whether
+     * a particular operation will create a tracing span, and
+     * what verbosity level will apply to attributes added
+     * to that span.
+     *
+     * If no matching filter entry is found,
+     * the settings from 'default' are used.
+     */
     filters?: Filter[];
-    sampling?: SamplingSettings;
+    /**
+     * If true, use a predefined list of filters for well-known
+     * platform traces.
+     *
+     * Defaults to true.
+     */
+    useDefaultFilters?: boolean;
+    /**
+     * Array of sampling setting entries used to determine
+     * whether a span will be sampled.
+     *
+     * If no matching sampling setting entry is found,
+     * the settings from 'default' are used.
+     */
+    sampling?: SamplingSettings[];
+    /**
+     * Default settings if appropriate entries aren't found
+     * in 'filters' and 'sampling' collections.
+     */
     default?: TracesDefaultsSettings;
-    spanTimeoutMs?: number;
+    /**
+     * If an OTEL TraceProvider isn't provided to the library,
+     * it will initialize its own.
+     *
+     * If 'url' is specified, TracerProvider will
+     * have an OTLPTraceExporter using this destination URL.
+     */
+    url?: string;
+    /**
+     * If an OTEL TraceProvider isn't provided to the library,
+     * it will initialize its own.
+     *
+     * If 'url' is specified, TracerProvider will
+     * have an OTLPTraceExporter with 'url' as detination URL and
+     * 'otlpExporterConfig' as additional * config.
+     */
+    otlpExporterConfig?: OTLPExporterNodeConfigBase;
+    /**
+     * If an OTEL TraceProvider isn't provided to the library,
+     * it will initialize its own.
+     *
+     * If 'console' is 'true', TracerProvider will
+     * have a ConsoleTraceExporter.
+     */
+    console?: boolean;
+    /**
+     * If an OTEL TraceProvider isn't provided to the library,
+     * it will initialize its own, with this provided service.name
+     * attribute.
+     */
     serviceName?: string;
-    user?: string;
-    addContextToTrace?: boolean;
+    /**
+     * If an OTEL TraceProvider isn't provided to the library,
+     * it will initialize its own, with this provided service.instance.id
+     * attribute.
+     */
+    serviceId?: string;
+    /**
+     * If an OTEL TraceProvider isn't provided to the library,
+     * it will initialize its own, with this provided service.version
+     * attribute.
+     */
+    serviceVersion?: string;
+    /**
+     * If an OTEL TraceProvider isn't provided to the library,
+     * it will initialize its own, with this provided user.id
+     * attribute.
+     */
+    userId?: string;
+    /**
+     * Builder overrides
+     */
+    tracingContextGetter?: (() => TracingContext) | undefined;
+    tracerProvider?: TracerProvider;
+    samplerGetter?: (defaultSampler: Sampler) => Sampler;
+    spanProcessors?: SpanProcessor[];
+    spanExporters?: SpanExporter[];
+    providerRegistrationSettings?: any;
 }
 export interface SamplingSettings {
+    /**
+     * Span name to determine if span will match this sampling setting entry.
+     * Start string with "#" for case-insensitive regex match
+     */
+    name?: string;
+    /**
+     * Span attributes that determine if span will match this sampling setting entry.
+     * Useful e.g. for checking otel.library.name/otel.scope.name attribute to filter
+     * auto-instrumentated spans.
+     * Start strings with "#" for case-insensitive regex match.
+     */
     attributes?: {
-        [key: string]: string | number;
+        [key: string]: string | number | boolean;
     };
+    /**
+     * Context values that determine if span will match this sampling setting entry.
+     * 'Context' here refers to the object returned from the 'contextGetter' callback at the
+     * time of sampling, not the OTEL context concept.
+     * This is useful for sampling based on the current client environment - current user, application,
+     * server node, time of day, etc.
+     * Start strings with "#" for case-insensitive regex match.
+     */
     context?: {
-        [key: string]: string | number;
+        [key: string]: string | number | boolean;
     };
+    /**
+     * Probability that span will be sampled, based on its traceId
+     * Spans from the same trace will always either all be sampled, or none will,
+     * provided they all have the same sampling probability.
+     * If true: will be sampled
+     * If false: will not be sampled
+     * If number between 0 and 1: has this probability of being sampled.
+     * Precision: 3 decimal digits
+     */
     sample: number | boolean;
 }
 export interface TracesManagerBuilder {

package/dist/traces/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/traces/types.ts"],"names":[],"mappings":";;;AAoEA,IAAY,SAQX;AARD,WAAY,SAAS;IACnB,uCAAG,CAAA;IACH,6CAAM,CAAA;IACN,qDAAU,CAAA;IACV,2CAAK,CAAA;IACL,yCAAI,CAAA;IACJ,yCAAI,CAAA;IACJ,+CAAO,CAAA;AACT,CAAC,EARW,SAAS,GAAT,iBAAS,KAAT,iBAAS,QAQpB"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/traces/types.ts"],"names":[],"mappings":";;;AAmFA,IAAY,SAQX;AARD,WAAY,SAAS;IACnB,uCAAG,CAAA;IACH,6CAAM,CAAA;IACN,qDAAU,CAAA;IACV,2CAAK,CAAA;IACL,yCAAI,CAAA;IACJ,yCAAI,CAAA;IACJ,+CAAO,CAAA;AACT,CAAC,EARW,SAAS,GAAT,iBAAS,KAAT,iBAAS,QAQpB"}

package/dist/traces/utils/index.d.ts

@@ -1,13 +1,21 @@
-import { TracerProvider } from "@opentelemetry/api";
-import { AttributeData, Filter, TracingContext } from "../types";
+import { Sampler, SpanExporter, SpanProcessor } from "@opentelemetry/sdk-trace-base";
+import { ContextManager, TracerProvider } from "@opentelemetry/api";
+import { AttributeData, Filter, TracesDefaultsSettings, TracesSettings, TracingContext } from "../types";
 import { Span } from "@opentelemetry/api";
-export declare const isSpanEnabled: (match: any, defaultMatch: any) => any;
+import { Logger } from "../../logger/types";
+export declare const isSpanEnabled: (match: Filter | undefined, defaultMatch: TracesDefaultsSettings | undefined) => boolean | undefined;
 export declare const isFilterMatch: (filter: Filter, context: TracingContext, source: string) => boolean;
-export declare const setTracerProvider: (provider?: TracerProvider, settings?: {
-    serviceName: string;
-    url: string;
-    console?: boolean;
-}) => void;
+export declare const setTracerProvider: (tracerProvider?: TracerProvider, sampler?: ((defaultSampler: Sampler) => Sampler) | undefined, spanProcessors?: SpanProcessor[], spanExporters?: SpanExporter[], providerRegistrationSettings?: {
+    contextManager?: ContextManager;
+}, contextGetter?: () => TracingContext, logger?: Logger, settings?: TracesSettings) => void;
 export declare const saveDataInAttribute: (data: AttributeData, otelSpan: Span) => void;
 export declare const replacePlaceHolders: (settings: any, context: any) => any;
 export declare const isFunctionType: (variable: unknown) => boolean;
+export declare const deep_value: (obj: {
+    [x: string]: any;
+}, path: any) => any;
+export declare const extractTracingContextFromArgs: (template: {
+    argMapping: {
+        [x: string]: string;
+    };
+}, args: any[]) => any;