@pingops/otel 0.1.1 → 0.1.2

package/dist/instrumentations/undici/types.d.ts

@@ -1,106 +0,0 @@
-import type { InstrumentationConfig } from "@opentelemetry/instrumentation";
-import type { Attributes, Span } from "@opentelemetry/api";
-export interface UndiciRequest {
-    origin: string;
-    method: string;
-    path: string;
-    /**
-     * Serialized string of headers in the form `name: value\r\n` for v5
-     * Array of strings `[key1, value1, key2, value2]`, where values are
-     * `string | string[]` for v6
-     */
-    headers: string | (string | string[])[];
-    /**
-     * Helper method to add headers (from v6)
-     */
-    addHeader: (name: string, value: string) => void;
-    throwOnError: boolean;
-    completed: boolean;
-    aborted: boolean;
-    idempotent: boolean;
-    contentLength: number | null;
-    contentType: string | null;
-    body: any;
-}
-export interface UndiciResponse {
-    headers: Buffer[];
-    statusCode: number;
-    statusText: string;
-}
-export interface IgnoreRequestFunction<T = UndiciRequest> {
-    (request: T): boolean;
-}
-export interface RequestHookFunction<T = UndiciRequest> {
-    (span: Span, request: T): void;
-}
-export interface ResponseHookFunction<RequestType = UndiciRequest, ResponseType = UndiciResponse> {
-    (span: Span, info: {
-        request: RequestType;
-        response: ResponseType;
-    }): void;
-}
-export interface StartSpanHookFunction<T = UndiciRequest> {
-    (request: T): Attributes;
-}
-export interface UndiciInstrumentationConfig<RequestType = UndiciRequest, ResponseType = UndiciResponse> extends InstrumentationConfig {
-    /** Not trace all outgoing requests that matched with custom function */
-    ignoreRequestHook?: IgnoreRequestFunction<RequestType>;
-    /** Function for adding custom attributes before request is handled */
-    requestHook?: RequestHookFunction<RequestType>;
-    /** Function called once response headers have been received */
-    responseHook?: ResponseHookFunction<RequestType, ResponseType>;
-    /** Function for adding custom attributes before a span is started */
-    startSpanHook?: StartSpanHookFunction<RequestType>;
-    /** Require parent to create span for outgoing requests */
-    requireParentforSpans?: boolean;
-    /** Map the following HTTP headers to span attributes. */
-    headersToSpanAttributes?: {
-        requestHeaders?: string[];
-        responseHeaders?: string[];
-    };
-    /**
-     * Maximum size of request body to capture in bytes
-     * @defaultValue 4096 (4 KB)
-     */
-    maxRequestBodySize?: number;
-    /**
-     * Maximum size of response body to capture in bytes
-     * @defaultValue 4096 (4 KB)
-     */
-    maxResponseBodySize?: number;
-}
-export interface ListenerRecord {
-    name: string;
-    unsubscribe: () => void;
-}
-export interface RequestMessage {
-    request: UndiciRequest;
-}
-export interface RequestHeadersMessage {
-    request: UndiciRequest;
-    socket: any;
-}
-export interface ResponseHeadersMessage {
-    request: UndiciRequest;
-    response: UndiciResponse;
-}
-export interface RequestTrailersMessage {
-    request: UndiciRequest;
-    response: UndiciResponse;
-}
-export interface RequestErrorMessage {
-    request: UndiciRequest;
-    error: Error;
-}
-export interface RequestBodyChunkSentMessage {
-    request: UndiciRequest;
-    chunk: Buffer;
-}
-export interface RequestBodySentMessage {
-    request: UndiciRequest;
-}
-export interface RequestBodyChunkReceivedMessage {
-    request: UndiciRequest;
-    chunk: Buffer;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/instrumentations/undici/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/instrumentations/undici/types.ts"],"names":[],"mappings":"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"}

package/dist/instrumentations/undici/types.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=types.js.map

package/dist/instrumentations/undici/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/instrumentations/undici/types.ts"],"names":[],"mappings":""}

package/dist/instrumentations/undici/undici.d.ts

@@ -1,12 +0,0 @@
-/**
- * Undici instrumentation for OpenTelemetry
- */
-import { UndiciInstrumentation } from "./pingops-undici";
-/**
- * Creates an Undici instrumentation instance
- *
- * @param isGlobalInstrumentationEnabled - Function that checks if global instrumentation is enabled
- * @returns UndiciInstrumentation instance
- */
-export declare function createUndiciInstrumentation(isGlobalInstrumentationEnabled: () => boolean): UndiciInstrumentation;
-//# sourceMappingURL=undici.d.ts.map

package/dist/instrumentations/undici/undici.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"undici.d.ts","sourceRoot":"","sources":["../../../src/instrumentations/undici/undici.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAIzD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,8BAA8B,EAAE,MAAM,OAAO,GAC5C,qBAAqB,CAYvB"}

package/dist/instrumentations/undici/undici.js

@@ -1,26 +0,0 @@
-/**
- * Undici instrumentation for OpenTelemetry
- */
-import { UndiciInstrumentation } from "./pingops-undici";
-import { context } from "@opentelemetry/api";
-import { PINGOPS_HTTP_ENABLED } from "@pingops/core";
-/**
- * Creates an Undici instrumentation instance
- *
- * @param isGlobalInstrumentationEnabled - Function that checks if global instrumentation is enabled
- * @returns UndiciInstrumentation instance
- */
-export function createUndiciInstrumentation(isGlobalInstrumentationEnabled) {
-    return new UndiciInstrumentation({
-        enabled: true,
-        ignoreRequestHook: () => {
-            // If global instrumentation is enabled, instrument all requests
-            if (isGlobalInstrumentationEnabled()) {
-                return false;
-            }
-            // If global instrumentation is NOT enabled, only instrument when PINGOPS_HTTP_ENABLED is true
-            return context.active().getValue(PINGOPS_HTTP_ENABLED) !== true;
-        },
-    });
-}
-//# sourceMappingURL=undici.js.map

package/dist/instrumentations/undici/undici.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"undici.js","sourceRoot":"","sources":["../../../src/instrumentations/undici/undici.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAErD;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CACzC,8BAA6C;IAE7C,OAAO,IAAI,qBAAqB,CAAC;QAC/B,OAAO,EAAE,IAAI;QACb,iBAAiB,EAAE,GAAG,EAAE;YACtB,gEAAgE;YAChE,IAAI,8BAA8B,EAAE,EAAE,CAAC;gBACrC,OAAO,KAAK,CAAC;YACf,CAAC;YACD,8FAA8F;YAC9F,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC,KAAK,IAAI,CAAC;QAClE,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/span-processor.d.ts

@@ -1,78 +0,0 @@
-/**
- * PingopsSpanProcessor - OpenTelemetry SpanProcessor implementation
- * Observes finished spans and sends eligible ones to PingOps backend
- *
- * This processor provides:
- * - Automatic filtering of spans (CLIENT spans with HTTP/GenAI attributes only)
- * - Domain and header filtering based on configuration
- * - Batched or immediate export modes using OTLP exporters
- * - Fire-and-forget transport (never blocks application)
- *
- * @example
- * ```typescript
- * import { NodeSDK } from '@opentelemetry/sdk-node';
- * import { PingopsSpanProcessor } from '@pingops/otel';
- *
- * const sdk = new NodeSDK({
- *   spanProcessors: [
- *     new PingopsSpanProcessor({
- *       apiKey: 'your-api-key',
- *       baseUrl: 'https://api.pingops.com',
- *       serviceName: 'my-service',
- *       exportMode: 'batched', // or 'immediate'
- *       domainAllowList: [
- *         { domain: 'api.example.com' }
- *       ]
- *     })
- *   ]
- * });
- *
- * sdk.start();
- * ```
- */
-import type { SpanProcessor, ReadableSpan, Span } from "@opentelemetry/sdk-trace-base";
-import type { Context } from "@opentelemetry/api";
-import type { PingopsProcessorConfig } from "./config";
-/**
- * OpenTelemetry span processor for sending spans to PingOps backend.
- *
- * This processor wraps OpenTelemetry's built-in processors (BatchSpanProcessor or SimpleSpanProcessor)
- * and applies filtering before passing spans to the OTLP exporter.
- */
-export declare class PingopsSpanProcessor implements SpanProcessor {
-    private processor;
-    private config;
-    /**
-     * Creates a new PingopsSpanProcessor instance.
-     *
-     * @param config - Configuration parameters for the processor
-     */
-    constructor(config: PingopsProcessorConfig);
-    /**
-     * Called when a span starts - extracts parent attributes from context and adds them to the span
-     */
-    onStart(span: Span, parentContext: Context): void;
-    /**
-     * Called when a span ends. Filters the span and passes it to the underlying processor if eligible.
-     *
-     * This method:
-     * 1. Checks if the span is eligible (CLIENT + HTTP/GenAI attributes)
-     * 2. Applies domain filtering (determines if span should be exported)
-     * 3. Applies header filtering via FilteredSpan wrapper (domain-specific and global rules)
-     * 4. If eligible, passes filtered span to underlying OTLP processor for export
-     */
-    onEnd(span: ReadableSpan): void;
-    /**
-     * Forces an immediate flush of all pending spans.
-     *
-     * @returns Promise that resolves when all pending operations are complete
-     */
-    forceFlush(): Promise<void>;
-    /**
-     * Gracefully shuts down the processor, ensuring all pending operations are completed.
-     *
-     * @returns Promise that resolves when shutdown is complete
-     */
-    shutdown(): Promise<void>;
-}
-//# sourceMappingURL=span-processor.d.ts.map

package/dist/span-processor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"span-processor.d.ts","sourceRoot":"","sources":["../src/span-processor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,IAAI,EACL,MAAM,+BAA+B,CAAC;AAMvC,OAAO,KAAK,EAAE,OAAO,EAAc,MAAM,oBAAoB,CAAC;AAS9D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AA8DvD;;;;;GAKG;AACH,qBAAa,oBAAqB,YAAW,aAAa;IACxD,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,MAAM,CAQZ;IAEF;;;;OAIG;gBACS,MAAM,EAAE,sBAAsB;IA2D1C;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,GAAG,IAAI;IA0BjD;;;;;;;;OAQG;IACH,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IA2F/B;;;;OAIG;IACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAaxC;;;;OAIG;IACU,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAYvC"}

package/dist/span-processor.js

@@ -1,282 +0,0 @@
-/**
- * PingopsSpanProcessor - OpenTelemetry SpanProcessor implementation
- * Observes finished spans and sends eligible ones to PingOps backend
- *
- * This processor provides:
- * - Automatic filtering of spans (CLIENT spans with HTTP/GenAI attributes only)
- * - Domain and header filtering based on configuration
- * - Batched or immediate export modes using OTLP exporters
- * - Fire-and-forget transport (never blocks application)
- *
- * @example
- * ```typescript
- * import { NodeSDK } from '@opentelemetry/sdk-node';
- * import { PingopsSpanProcessor } from '@pingops/otel';
- *
- * const sdk = new NodeSDK({
- *   spanProcessors: [
- *     new PingopsSpanProcessor({
- *       apiKey: 'your-api-key',
- *       baseUrl: 'https://api.pingops.com',
- *       serviceName: 'my-service',
- *       exportMode: 'batched', // or 'immediate'
- *       domainAllowList: [
- *         { domain: 'api.example.com' }
- *       ]
- *     })
- *   ]
- * });
- *
- * sdk.start();
- * ```
- */
-import { BatchSpanProcessor, SimpleSpanProcessor, } from "@opentelemetry/sdk-trace-base";
-import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http";
-import { isSpanEligible, shouldCaptureSpan, createLogger, getPropagatedAttributesFromContext, extractSpanPayload, } from "@pingops/core";
-import { setGlobalConfig } from "./config-store";
-const logger = createLogger("[PingOps Processor]");
-/**
- * Creates a filtered span wrapper that applies header filtering to attributes
- *
- * This wrapper applies both domain-specific and global header filtering:
- * - Uses domain allow list to determine domain-specific header rules
- * - Applies global header allow/deny lists
- * - Filters headers from http.request.header and http.response.header attributes
- *
- * Uses a Proxy to automatically forward all properties and methods to the original span,
- * except for 'attributes' which returns the filtered version. This approach is future-proof
- * and will work with any new methods or properties added to ReadableSpan.
- *
- * This allows us to filter headers before the span is serialized by OTLP exporter
- */
-function createFilteredSpan(span, domainAllowList, globalHeadersAllowList, globalHeadersDenyList, globalCaptureRequestBody, globalCaptureResponseBody) {
-    // Use extractSpanPayload to get filtered attributes
-    // This handles both domain-specific header rules and global header filtering
-    // as well as body capture filtering
-    const payload = extractSpanPayload(span, domainAllowList, globalHeadersAllowList, globalHeadersDenyList, globalCaptureRequestBody, globalCaptureResponseBody);
-    const filteredAttributes = (payload?.attributes ??
-        span.attributes);
-    logger.debug("Payload", { payload });
-    // Create a Proxy that intercepts 'attributes' access and forwards everything else
-    return new Proxy(span, {
-        get(target, prop) {
-            // Intercept 'attributes' to return filtered version
-            if (prop === "attributes") {
-                return filteredAttributes;
-            }
-            // Forward all other property/method access to the original span
-            const value = target[prop];
-            // If it's a function, bind it to the original target to preserve 'this' context
-            if (typeof value === "function") {
-                return value.bind(target);
-            }
-            return value;
-        },
-    });
-}
-/**
- * OpenTelemetry span processor for sending spans to PingOps backend.
- *
- * This processor wraps OpenTelemetry's built-in processors (BatchSpanProcessor or SimpleSpanProcessor)
- * and applies filtering before passing spans to the OTLP exporter.
- */
-export class PingopsSpanProcessor {
-    processor;
-    config;
-    /**
-     * Creates a new PingopsSpanProcessor instance.
-     *
-     * @param config - Configuration parameters for the processor
-     */
-    constructor(config) {
-        const exportMode = config.exportMode ?? "batched";
-        // Get API key from config or environment
-        const apiKey = config.apiKey || process.env.PINGOPS_API_KEY || "";
-        // Create OTLP exporter pointing to PingOps backend
-        const exporter = new OTLPTraceExporter({
-            url: `${config.baseUrl}/v1/traces`,
-            headers: {
-                Authorization: apiKey ? `Bearer ${apiKey}` : "",
-                "Content-Type": "application/json",
-            },
-            timeoutMillis: 5000,
-        });
-        // Create underlying processor based on export mode
-        if (exportMode === "immediate") {
-            this.processor = new SimpleSpanProcessor(exporter);
-        }
-        else {
-            this.processor = new BatchSpanProcessor(exporter, {
-                maxExportBatchSize: config.batchSize ?? 50,
-                scheduledDelayMillis: config.batchTimeout ?? 5000,
-            });
-        }
-        this.config = {
-            debug: config.debug ?? false,
-            headersAllowList: config.headersAllowList,
-            headersDenyList: config.headersDenyList,
-            domainAllowList: config.domainAllowList,
-            domainDenyList: config.domainDenyList,
-            captureRequestBody: config.captureRequestBody,
-            captureResponseBody: config.captureResponseBody,
-        };
-        // Register global config for instrumentations to access
-        setGlobalConfig({
-            captureRequestBody: config.captureRequestBody,
-            captureResponseBody: config.captureResponseBody,
-            domainAllowList: config.domainAllowList,
-        });
-        logger.info("Initialized PingopsSpanProcessor", {
-            baseUrl: config.baseUrl,
-            exportMode,
-            batchSize: config.batchSize,
-            batchTimeout: config.batchTimeout,
-            hasDomainAllowList: !!config.domainAllowList && config.domainAllowList.length > 0,
-            hasDomainDenyList: !!config.domainDenyList && config.domainDenyList.length > 0,
-            hasHeadersAllowList: !!config.headersAllowList && config.headersAllowList.length > 0,
-            hasHeadersDenyList: !!config.headersDenyList && config.headersDenyList.length > 0,
-        });
-    }
-    /**
-     * Called when a span starts - extracts parent attributes from context and adds them to the span
-     */
-    onStart(span, parentContext) {
-        const spanContext = span.spanContext();
-        logger.debug("Span started", {
-            spanName: span.name,
-            spanId: spanContext.spanId,
-            traceId: spanContext.traceId,
-        });
-        // Extract propagated attributes from context and set them on the span
-        const propagatedAttributes = getPropagatedAttributesFromContext(parentContext);
-        if (Object.keys(propagatedAttributes).length > 0) {
-            for (const [key, value] of Object.entries(propagatedAttributes)) {
-                // Type guard: value must be string or string[] for OpenTelemetry attributes
-                if (typeof value === "string" || Array.isArray(value)) {
-                    span.setAttribute(key, value);
-                }
-            }
-            logger.debug("Set propagated attributes on span", {
-                spanName: span.name,
-                attributeKeys: Object.keys(propagatedAttributes),
-            });
-        }
-        this.processor.onStart(span, parentContext);
-    }
-    /**
-     * Called when a span ends. Filters the span and passes it to the underlying processor if eligible.
-     *
-     * This method:
-     * 1. Checks if the span is eligible (CLIENT + HTTP/GenAI attributes)
-     * 2. Applies domain filtering (determines if span should be exported)
-     * 3. Applies header filtering via FilteredSpan wrapper (domain-specific and global rules)
-     * 4. If eligible, passes filtered span to underlying OTLP processor for export
-     */
-    onEnd(span) {
-        const spanContext = span.spanContext();
-        logger.debug("Span ended, processing", {
-            spanName: span.name,
-            spanId: spanContext.spanId,
-            traceId: spanContext.traceId,
-            spanKind: span.kind,
-        });
-        try {
-            // Step 1: Check if span is eligible (CLIENT + HTTP/GenAI attributes)
-            if (!isSpanEligible(span)) {
-                logger.debug("Span not eligible, skipping", {
-                    spanName: span.name,
-                    spanId: spanContext.spanId,
-                    reason: "not CLIENT or missing HTTP/GenAI attributes",
-                });
-                return;
-            }
-            // Step 2: Extract URL for domain filtering
-            const attributes = span.attributes;
-            const url = attributes["http.url"] ||
-                attributes["url.full"] ||
-                (attributes["server.address"]
-                    ? `https://${String(attributes["server.address"])}`
-                    : "");
-            logger.debug("Extracted URL for domain filtering", {
-                spanName: span.name,
-                url,
-                hasHttpUrl: !!attributes["http.url"],
-                hasUrlFull: !!attributes["url.full"],
-                hasServerAddress: !!attributes["server.address"],
-            });
-            // Step 3: Apply domain filtering
-            if (url) {
-                const shouldCapture = shouldCaptureSpan(url, this.config.domainAllowList, this.config.domainDenyList);
-                if (!shouldCapture) {
-                    logger.info("Span filtered out by domain rules", {
-                        spanName: span.name,
-                        spanId: spanContext.spanId,
-                        url,
-                    });
-                    return;
-                }
-            }
-            else {
-                logger.debug("No URL found for domain filtering, proceeding", {
-                    spanName: span.name,
-                });
-            }
-            // Step 4: Apply filtering (header filtering with domain-specific rules) by wrapping the span
-            const filteredSpan = createFilteredSpan(span, this.config.domainAllowList, this.config.headersAllowList, this.config.headersDenyList, this.config.captureRequestBody, this.config.captureResponseBody);
-            // Step 5: Span passed all filters, pass filtered span to underlying processor for export
-            this.processor.onEnd(filteredSpan);
-            logger.info("Span passed all filters and queued for export", {
-                spanName: span.name,
-                spanId: spanContext.spanId,
-                traceId: spanContext.traceId,
-                url,
-                hasHeaderFiltering: !!(this.config.headersAllowList || this.config.headersDenyList),
-            });
-        }
-        catch (error) {
-            // Defensive error handling - never crash the app
-            logger.error("Error processing span", {
-                spanName: span.name,
-                spanId: spanContext.spanId,
-                error: error instanceof Error ? error.message : String(error),
-            });
-        }
-    }
-    /**
-     * Forces an immediate flush of all pending spans.
-     *
-     * @returns Promise that resolves when all pending operations are complete
-     */
-    async forceFlush() {
-        logger.info("Force flushing spans");
-        try {
-            await this.processor.forceFlush();
-            logger.info("Force flush complete");
-        }
-        catch (error) {
-            logger.error("Error during force flush", {
-                error: error instanceof Error ? error.message : String(error),
-            });
-            throw error;
-        }
-    }
-    /**
-     * Gracefully shuts down the processor, ensuring all pending operations are completed.
-     *
-     * @returns Promise that resolves when shutdown is complete
-     */
-    async shutdown() {
-        logger.info("Shutting down processor");
-        try {
-            await this.processor.shutdown();
-            logger.info("Processor shutdown complete");
-        }
-        catch (error) {
-            logger.error("Error during processor shutdown", {
-                error: error instanceof Error ? error.message : String(error),
-            });
-            throw error;
-        }
-    }
-}
-//# sourceMappingURL=span-processor.js.map

package/dist/span-processor.js.map

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

package/dist/tracer-provider.d.ts

@@ -1,57 +0,0 @@
-/**
- * Tracer Provider with global state and isolated TracerProvider architecture
- *
- * This module provides an isolated TracerProvider that shares the same
- * span processors (like PingopsSpanProcessor) with the main OpenTelemetry SDK.
- * This ensures manual spans created via startSpan are properly processed.
- *
- * Architecture follows Langfuse's pattern with global state management.
- */
-import type { TracerProvider } from "@opentelemetry/api";
-import { NodeTracerProvider } from "@opentelemetry/sdk-trace-node";
-import type { SpanProcessor } from "@opentelemetry/sdk-trace-base";
-/**
- * Sets an isolated TracerProvider for PingOps tracing operations.
- *
- * This allows PingOps to use its own TracerProvider instance, separate from
- * the global OpenTelemetry TracerProvider. This is useful for avoiding conflicts
- * with other OpenTelemetry instrumentation in the application.
- *
- * @param provider - The TracerProvider instance to use, or null to clear the isolated provider
- * @public
- */
-export declare function setPingopsTracerProvider(provider: TracerProvider | null): void;
-/**
- * Gets the TracerProvider for PingOps tracing operations.
- *
- * Returns the isolated TracerProvider if one has been set via setPingopsTracerProvider(),
- * otherwise falls back to the global OpenTelemetry TracerProvider.
- *
- * @returns The TracerProvider instance to use for PingOps tracing
- * @public
- */
-export declare function getPingopsTracerProvider(): TracerProvider;
-/**
- * Initializes the isolated TracerProvider with the given span processors
- *
- * This creates a separate TracerProvider that shares the same span processors
- * (like PingopsSpanProcessor) with the main SDK. This ensures manual spans
- * are processed correctly.
- *
- * @param spanProcessors - Array of span processors to use (e.g., PingopsSpanProcessor)
- * @param serviceName - Service name for resource attributes
- * @deprecated Use setPingopsTracerProvider instead
- */
-export declare function initializeTracerProvider(spanProcessors: SpanProcessor[], serviceName: string): void;
-/**
- * Gets the isolated TracerProvider instance
- *
- * @returns The TracerProvider instance, or null if not initialized
- * @deprecated Use getPingopsTracerProvider instead
- */
-export declare function getTracerProvider(): NodeTracerProvider | null;
-/**
- * Shuts down the TracerProvider and flushes remaining spans
- */
-export declare function shutdownTracerProvider(): Promise<void>;
-//# sourceMappingURL=tracer-provider.d.ts.map

package/dist/tracer-provider.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tracer-provider.d.ts","sourceRoot":"","sources":["../src/tracer-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AA4EnE;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,cAAc,GAAG,IAAI,GAC9B,IAAI,CAgBN;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,IAAI,cAAc,CAezD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACtC,cAAc,EAAE,aAAa,EAAE,EAC/B,WAAW,EAAE,MAAM,GAClB,IAAI,CA4BN;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,kBAAkB,GAAG,IAAI,CAG7D;AAED;;GAEG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC,CA6B5D"}