@pingops/sdk 0.1.1 → 0.1.3

package/dist/pingops.js

@@ -1,259 +0,0 @@
-/**
- * PingOps SDK singleton for manual instrumentation
- *
- * Provides initializePingops and shutdownPingops functions.
- * wrapHttp is available from @pingops/core and will auto-initialize
- * from environment variables if needed.
- */
-import { NodeSDK } from "@opentelemetry/sdk-node";
-import { resourceFromAttributes } from "@opentelemetry/resources";
-import { ATTR_SERVICE_NAME } from "@opentelemetry/semantic-conventions";
-import { NodeTracerProvider } from "@opentelemetry/sdk-trace-node";
-import { setPingopsTracerProvider, shutdownTracerProvider, PingopsSpanProcessor, } from "@pingops/otel";
-import { createLogger } from "@pingops/core";
-import { setSdkInitialized, isGlobalInstrumentationEnabled, } from "./init-state";
-import { wrapHttp as coreWrapHttp, } from "@pingops/core";
-import { getPingopsTracerProvider } from "@pingops/otel";
-import { getInstrumentations } from "@pingops/otel";
-const initLogger = createLogger("[PingOps Initialize]");
-const logger = createLogger("[PingOps Pingops]");
-let sdkInstance = null;
-let isSdkInitializedFlag = false;
-/**
- * Global state to track initialization
- */
-let isInitialized = false;
-let initializationPromise = null;
-/**
- * Initializes PingOps SDK
- *
- * This function:
- * 1. Creates an OpenTelemetry NodeSDK instance
- * 2. Configures Resource with service.name
- * 3. Registers PingopsSpanProcessor
- * 4. Enables HTTP/fetch/GenAI instrumentation
- * 5. Starts the SDK
- *
- * @param config - Configuration for the SDK
- * @param explicit - Whether this is an explicit call (default: true).
- *                   Set to false when called internally by wrapHttp auto-initialization.
- */
-export function initializePingops(config, explicit = true) {
-    if (isSdkInitializedFlag) {
-        if (config.debug) {
-            initLogger.warn("[PingOps] SDK already initialized, skipping");
-        }
-        return;
-    }
-    // Create resource with service name
-    const resource = resourceFromAttributes({
-        [ATTR_SERVICE_NAME]: config.serviceName,
-    });
-    const processor = new PingopsSpanProcessor(config);
-    const instrumentations = getInstrumentations(isGlobalInstrumentationEnabled);
-    // Node.js SDK
-    const nodeSdk = new NodeSDK({
-        resource,
-        spanProcessors: [processor],
-        instrumentations,
-    });
-    nodeSdk.start();
-    sdkInstance = nodeSdk;
-    // Mark SDK as initialized
-    isSdkInitializedFlag = true;
-    // Only enable global instrumentation if this was an explicit call
-    // If called via wrapHttp auto-initialization, global instrumentation stays disabled
-    setSdkInitialized(explicit);
-    // Initialize isolated TracerProvider for manual spans AFTER NodeSDK starts
-    // This ensures manual spans created via startSpan are processed by the same processor
-    // We register it after NodeSDK so it takes precedence as the global provider
-    try {
-        // In version 2.2.0, span processors are passed in the constructor
-        const isolatedProvider = new NodeTracerProvider({
-            resource,
-            spanProcessors: [processor],
-        });
-        // Register the provider globally
-        isolatedProvider.register();
-        // Set it in global state
-        setPingopsTracerProvider(isolatedProvider);
-    }
-    catch (error) {
-        if (config.debug) {
-            initLogger.error("[PingOps] Failed to create isolated TracerProvider:", error instanceof Error ? error.message : String(error));
-        }
-        // Continue without isolated provider - manual spans will use global provider
-    }
-    if (config.debug) {
-        initLogger.info("[PingOps] SDK initialized");
-    }
-}
-/**
- * Shuts down the SDK and flushes remaining spans
- */
-export async function shutdownPingops() {
-    // Shutdown isolated TracerProvider first
-    await shutdownTracerProvider();
-    if (!sdkInstance) {
-        return;
-    }
-    await sdkInstance.shutdown();
-    sdkInstance = null;
-    isSdkInitializedFlag = false;
-    setSdkInitialized(false);
-}
-/**
- * Checks if the SDK is already initialized by checking if a NodeTracerProvider is available
- */
-function isSdkInitialized() {
-    try {
-        const provider = getPingopsTracerProvider();
-        // If we have a NodeTracerProvider (not the default NoOpTracerProvider), SDK is initialized
-        const initialized = provider instanceof NodeTracerProvider;
-        logger.debug("Checked SDK initialization status", {
-            initialized,
-            providerType: provider.constructor.name,
-        });
-        return initialized;
-    }
-    catch (error) {
-        logger.debug("Error checking SDK initialization status", {
-            error: error instanceof Error ? error.message : String(error),
-        });
-        return false;
-    }
-}
-/**
- * Auto-initializes the SDK from environment variables if not already initialized
- */
-async function ensureInitialized() {
-    // Check if SDK is already initialized (e.g., by calling initializePingops directly)
-    if (isSdkInitialized()) {
-        logger.debug("SDK already initialized, skipping auto-initialization");
-        isInitialized = true;
-        return;
-    }
-    if (isInitialized) {
-        logger.debug("SDK initialization flag already set, skipping");
-        return;
-    }
-    // If initialization is in progress, wait for it
-    if (initializationPromise) {
-        logger.debug("SDK initialization already in progress, waiting...");
-        return initializationPromise;
-    }
-    // Start initialization
-    logger.info("Starting SDK auto-initialization from environment variables");
-    initializationPromise = Promise.resolve().then(() => {
-        const apiKey = process.env.PINGOPS_API_KEY;
-        const baseUrl = process.env.PINGOPS_BASE_URL;
-        const serviceName = process.env.PINGOPS_SERVICE_NAME;
-        const debug = process.env.PINGOPS_DEBUG === "true";
-        logger.debug("Reading environment variables", {
-            hasApiKey: !!apiKey,
-            hasBaseUrl: !!baseUrl,
-            hasServiceName: !!serviceName,
-            debug,
-        });
-        if (!apiKey || !baseUrl || !serviceName) {
-            const missing = [
-                !apiKey && "PINGOPS_API_KEY",
-                !baseUrl && "PINGOPS_BASE_URL",
-                !serviceName && "PINGOPS_SERVICE_NAME",
-            ].filter(Boolean);
-            logger.error("Missing required environment variables for auto-initialization", {
-                missing,
-            });
-            throw new Error(`PingOps SDK auto-initialization requires PINGOPS_API_KEY, PINGOPS_BASE_URL, and PINGOPS_SERVICE_NAME environment variables. Missing: ${missing.join(", ")}`);
-        }
-        const config = {
-            apiKey,
-            baseUrl,
-            serviceName,
-            debug,
-        };
-        logger.info("Initializing SDK with config", {
-            baseUrl,
-            serviceName,
-            debug,
-        });
-        // Call initializePingops with explicit=false since this is auto-initialization
-        initializePingops(config, false);
-        isInitialized = true;
-        logger.info("SDK auto-initialization completed successfully");
-    });
-    try {
-        await initializationPromise;
-    }
-    catch (error) {
-        logger.error("SDK auto-initialization failed", {
-            error: error instanceof Error ? error.message : String(error),
-        });
-        throw error;
-    }
-    finally {
-        initializationPromise = null;
-    }
-}
-/**
- * Wraps a function to set attributes on HTTP spans created within the wrapped block.
- *
- * This function sets attributes (userId, sessionId, tags, metadata) in the OpenTelemetry
- * context, which are automatically propagated to all spans created within the wrapped function.
- *
- * Instrumentation behavior:
- * - If `initializePingops` was called: All HTTP requests are instrumented by default.
- *   `wrapHttp` only adds attributes to spans created within the wrapped block.
- * - If `initializePingops` was NOT called: Only HTTP requests within `wrapHttp` blocks
- *   are instrumented. Requests outside `wrapHttp` are not instrumented.
- *
- * @param options - Options including attributes to propagate to spans
- * @param fn - Function to execute within the attribute context
- * @returns The result of the function
- *
- * @example
- * ```typescript
- * import { wrapHttp } from '@pingops/sdk';
- *
- * // Scenario 1: initializePingops was called
- * initializePingops({ ... });
- *
- * // All HTTP requests are instrumented, but this block adds attributes
- * const result = await wrapHttp({
- *   attributes: {
- *     userId: 'user-123',
- *     sessionId: 'session-456',
- *     tags: ['production', 'api'],
- *     metadata: { environment: 'prod', version: '1.0.0' }
- *   }
- * }, async () => {
- *   // This HTTP request will be instrumented AND have the attributes set above
- *   const response = await fetch('https://api.example.com/users/123');
- *   return response.json();
- * });
- *
- * // HTTP requests outside wrapHttp are still instrumented, just without the attributes
- * const otherResponse = await fetch('https://api.example.com/other');
- *
- * // Scenario 2: initializePingops was NOT called
- * // Only requests within wrapHttp are instrumented
- * await wrapHttp({
- *   attributes: { userId: 'user-123' }
- * }, async () => {
- *   // This request IS instrumented
- *   return fetch('https://api.example.com/data');
- * });
- *
- * // This request is NOT instrumented (outside wrapHttp)
- * await fetch('https://api.example.com/other');
- * ```
- */
-export function wrapHttp(options, fn) {
-    return coreWrapHttp({
-        ...options,
-        checkInitialized: isSdkInitialized,
-        isGlobalInstrumentationEnabled: isGlobalInstrumentationEnabled,
-        ensureInitialized: ensureInitialized,
-    }, fn);
-}
-//# sourceMappingURL=pingops.js.map

package/dist/pingops.js.map

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