@pingops/sdk 0.1.2 → 0.2.0

package/dist/pingops-DJsItvUR.mjs

@@ -0,0 +1,302 @@
+import { context, trace } from "@opentelemetry/api";
+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 { PingopsSpanProcessor, getInstrumentations, getPingopsTracerProvider, setPingopsTracerProvider, shutdownTracerProvider } from "@pingops/otel";
+import { PINGOPS_CAPTURE_REQUEST_BODY, PINGOPS_CAPTURE_RESPONSE_BODY, PINGOPS_METADATA, PINGOPS_SESSION_ID, PINGOPS_TAGS, PINGOPS_TRACE_ID, PINGOPS_USER_ID, createLogger, createTraceId, uint8ArrayToHex } from "@pingops/core";
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { load } from "js-yaml";
+
+//#region src/config-loader.ts
+/**
+* Configuration loader for reading PingOps config from JSON/YAML files
+*/
+/**
+* Loads configuration from a JSON or YAML file
+*
+* @param filePath - Path to the config file (JSON or YAML)
+* @returns Parsed configuration object
+* @throws Error if file cannot be read or parsed
+*/
+function loadConfigFromFile(filePath) {
+	const resolvedPath = resolve(filePath);
+	const fileContent = readFileSync(resolvedPath, "utf-8");
+	const ext = resolvedPath.toLowerCase();
+	if (ext.endsWith(".yaml") || ext.endsWith(".yml")) return load(fileContent) || {};
+	else if (ext.endsWith(".json")) return JSON.parse(fileContent);
+	else try {
+		return JSON.parse(fileContent);
+	} catch {
+		return load(fileContent) || {};
+	}
+}
+/**
+* Merges configuration from file and environment variables.
+* Environment variables take precedence over file config.
+*
+* @param fileConfig - Configuration loaded from file
+* @returns Merged configuration with env vars taking precedence
+*/
+function mergeConfigWithEnv(fileConfig) {
+	const envConfig = {};
+	if (process.env.PINGOPS_API_KEY) envConfig.apiKey = process.env.PINGOPS_API_KEY;
+	if (process.env.PINGOPS_BASE_URL) envConfig.baseUrl = process.env.PINGOPS_BASE_URL;
+	if (process.env.PINGOPS_SERVICE_NAME) envConfig.serviceName = process.env.PINGOPS_SERVICE_NAME;
+	if (process.env.PINGOPS_DEBUG) envConfig.debug = process.env.PINGOPS_DEBUG === "true";
+	if (process.env.PINGOPS_BATCH_SIZE) envConfig.batchSize = parseInt(process.env.PINGOPS_BATCH_SIZE, 10);
+	if (process.env.PINGOPS_BATCH_TIMEOUT) envConfig.batchTimeout = parseInt(process.env.PINGOPS_BATCH_TIMEOUT, 10);
+	if (process.env.PINGOPS_EXPORT_MODE) envConfig.exportMode = process.env.PINGOPS_EXPORT_MODE;
+	return {
+		...fileConfig,
+		...envConfig
+	};
+}
+
+//#endregion
+//#region src/init-state.ts
+/**
+* Sets the SDK initialization flag.
+* Called by initializePingops when the SDK is initialized.
+*/
+function setSdkInitialized(initialized) {}
+
+//#endregion
+//#region src/pingops.ts
+/**
+* PingOps SDK singleton for manual instrumentation
+*
+* Provides initializePingops, shutdownPingops, startTrace, getActiveTraceId,
+* and getActiveSpanId. startTrace can auto-initialize from environment variables if needed.
+*/
+const TRACE_FLAG_SAMPLED = 1;
+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;
+function initializePingops(config, explicit = true) {
+	const resolvedConfig = typeof config === "string" ? resolveConfigFromFile(config) : "configFile" in config ? resolveConfigFromFile(config.configFile) : config;
+	if (isSdkInitializedFlag) {
+		if (resolvedConfig.debug) initLogger.warn("[PingOps] SDK already initialized, skipping");
+		return;
+	}
+	const resource = resourceFromAttributes({ [ATTR_SERVICE_NAME]: resolvedConfig.serviceName });
+	const processor = new PingopsSpanProcessor(resolvedConfig);
+	const instrumentations = getInstrumentations();
+	const nodeSdk = new NodeSDK({
+		resource,
+		spanProcessors: [processor],
+		instrumentations
+	});
+	nodeSdk.start();
+	sdkInstance = nodeSdk;
+	isSdkInitializedFlag = true;
+	/* @__PURE__ */ setSdkInitialized(true);
+	try {
+		const isolatedProvider = new NodeTracerProvider({
+			resource,
+			spanProcessors: [processor]
+		});
+		isolatedProvider.register();
+		setPingopsTracerProvider(isolatedProvider);
+	} catch (error) {
+		if (resolvedConfig.debug) initLogger.error("[PingOps] Failed to create isolated TracerProvider:", error instanceof Error ? error.message : String(error));
+	}
+	if (resolvedConfig.debug) initLogger.info("[PingOps] SDK initialized");
+}
+function resolveConfigFromFile(configFilePath) {
+	const mergedConfig = mergeConfigWithEnv(loadConfigFromFile(configFilePath));
+	if (!mergedConfig.baseUrl || !mergedConfig.serviceName) {
+		const missing = [!mergedConfig.baseUrl && "baseUrl (or PINGOPS_BASE_URL)", !mergedConfig.serviceName && "serviceName (or PINGOPS_SERVICE_NAME)"].filter(Boolean);
+		throw new Error(`initializePingops(configFile) requires ${missing.join(" and ")}. Provide them in the config file or via environment variables.`);
+	}
+	return mergedConfig;
+}
+/**
+* Shuts down the SDK and flushes remaining spans
+*/
+async function shutdownPingops() {
+	await shutdownTracerProvider();
+	if (!sdkInstance) return;
+	await sdkInstance.shutdown();
+	sdkInstance = null;
+	isSdkInitializedFlag = false;
+	/* @__PURE__ */ setSdkInitialized(false);
+}
+/**
+* Checks if the SDK is already initialized by checking if a NodeTracerProvider is available
+*/
+function isSdkInitialized() {
+	try {
+		const provider = getPingopsTracerProvider();
+		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() {
+	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 (initializationPromise) {
+		logger.debug("SDK initialization already in progress, waiting...");
+		return initializationPromise;
+	}
+	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
+		});
+		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;
+	}
+}
+/**
+* Returns the trace ID of the currently active span, if any.
+*/
+function getActiveTraceId() {
+	return trace.getActiveSpan()?.spanContext().traceId;
+}
+/**
+* Returns the span ID of the currently active span, if any.
+*/
+function getActiveSpanId() {
+	return trace.getActiveSpan()?.spanContext().spanId;
+}
+/**
+* Starts a new trace using the PingOps tracer provider and runs the callback within that trace.
+* Sets attributes (traceId, userId, sessionId, tags, metadata, etc.) in context so they are
+* propagated to spans created within the callback.
+*
+* @param options - Options including optional attributes and optional seed for deterministic traceId
+* @param fn - Function to execute within the trace and attribute context
+* @returns Promise resolving to the result of the function
+*
+* @example
+* ```typescript
+* import { startTrace, initializePingops } from '@pingops/sdk';
+*
+* initializePingops({ ... });
+*
+* const result = await startTrace({
+*   attributes: {
+*     userId: 'user-123',
+*     sessionId: 'session-456',
+*     tags: ['production', 'api'],
+*     metadata: { environment: 'prod', version: '1.0.0' }
+*   },
+*   seed: 'request-123' // optional: deterministic traceId from this seed
+* }, async () => {
+*   const response = await fetch('https://api.example.com/users/123');
+*   return response.json();
+* });
+* ```
+*/
+async function startTrace(options, fn) {
+	if (!isSdkInitialized()) await ensureInitialized();
+	const traceId = options.attributes?.traceId ?? await createTraceId(options?.seed);
+	const spanContext = {
+		traceId,
+		spanId: uint8ArrayToHex(crypto.getRandomValues(new Uint8Array(8))),
+		traceFlags: TRACE_FLAG_SAMPLED
+	};
+	const activeContext = context.active();
+	const contextWithSpanContext = trace.setSpanContext(activeContext, spanContext);
+	const tracer = getPingopsTracerProvider().getTracer("pingops-sdk", "1.0.0");
+	return new Promise((resolve$1, reject) => {
+		tracer.startActiveSpan("pingops-trace", {}, contextWithSpanContext, (span) => {
+			let contextWithAttributes = context.active();
+			const attrs = options.attributes;
+			if (attrs) contextWithAttributes = setAttributesInContext(contextWithAttributes, attrs);
+			contextWithAttributes = contextWithAttributes.setValue(PINGOPS_TRACE_ID, traceId);
+			const run = () => fn();
+			try {
+				const result = context.with(contextWithAttributes, run);
+				if (result instanceof Promise) result.then((v) => {
+					span.end();
+					resolve$1(v);
+				}).catch((err) => {
+					span.end();
+					reject(err);
+				});
+				else {
+					span.end();
+					resolve$1(result);
+				}
+			} catch (err) {
+				span.end();
+				reject(err);
+			}
+		});
+	});
+}
+function setAttributesInContext(ctx, attrs) {
+	if (attrs.userId !== void 0) ctx = ctx.setValue(PINGOPS_USER_ID, attrs.userId);
+	if (attrs.sessionId !== void 0) ctx = ctx.setValue(PINGOPS_SESSION_ID, attrs.sessionId);
+	if (attrs.tags !== void 0) ctx = ctx.setValue(PINGOPS_TAGS, attrs.tags);
+	if (attrs.metadata !== void 0) ctx = ctx.setValue(PINGOPS_METADATA, attrs.metadata);
+	if (attrs.captureRequestBody !== void 0) ctx = ctx.setValue(PINGOPS_CAPTURE_REQUEST_BODY, attrs.captureRequestBody);
+	if (attrs.captureResponseBody !== void 0) ctx = ctx.setValue(PINGOPS_CAPTURE_RESPONSE_BODY, attrs.captureResponseBody);
+	return ctx;
+}
+
+//#endregion
+export { startTrace as a, shutdownPingops as i, getActiveTraceId as n, loadConfigFromFile as o, initializePingops as r, mergeConfigWithEnv as s, getActiveSpanId as t };
+//# sourceMappingURL=pingops-DJsItvUR.mjs.map

package/dist/pingops-DJsItvUR.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pingops-DJsItvUR.mjs","names":["loadYaml"],"sources":["../src/config-loader.ts","../src/init-state.ts","../src/pingops.ts"],"sourcesContent":["/**\n * Configuration loader for reading PingOps config from JSON/YAML files\n */\n\nimport { readFileSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport { load as loadYaml } from \"js-yaml\";\nimport type { PingopsProcessorConfig } from \"@pingops/otel\";\n\n/**\n * Loads configuration from a JSON or YAML file\n *\n * @param filePath - Path to the config file (JSON or YAML)\n * @returns Parsed configuration object\n * @throws Error if file cannot be read or parsed\n */\nexport function loadConfigFromFile(\n  filePath: string\n): Partial<PingopsProcessorConfig> {\n  const resolvedPath = resolve(filePath);\n  const fileContent = readFileSync(resolvedPath, \"utf-8\");\n\n  const ext = resolvedPath.toLowerCase();\n  if (ext.endsWith(\".yaml\") || ext.endsWith(\".yml\")) {\n    return (loadYaml(fileContent) as Partial<PingopsProcessorConfig>) || {};\n  } else if (ext.endsWith(\".json\")) {\n    return JSON.parse(fileContent) as Partial<PingopsProcessorConfig>;\n  } else {\n    // Try to parse as JSON first, then YAML\n    try {\n      return JSON.parse(fileContent) as Partial<PingopsProcessorConfig>;\n    } catch {\n      return (loadYaml(fileContent) as Partial<PingopsProcessorConfig>) || {};\n    }\n  }\n}\n\n/**\n * Merges configuration from file and environment variables.\n * Environment variables take precedence over file config.\n *\n * @param fileConfig - Configuration loaded from file\n * @returns Merged configuration with env vars taking precedence\n */\nexport function mergeConfigWithEnv(\n  fileConfig: Partial<PingopsProcessorConfig>\n): Partial<PingopsProcessorConfig> {\n  const envConfig: Partial<PingopsProcessorConfig> = {};\n\n  // Read from environment variables\n  if (process.env.PINGOPS_API_KEY) {\n    envConfig.apiKey = process.env.PINGOPS_API_KEY;\n  }\n  if (process.env.PINGOPS_BASE_URL) {\n    envConfig.baseUrl = process.env.PINGOPS_BASE_URL;\n  }\n  if (process.env.PINGOPS_SERVICE_NAME) {\n    envConfig.serviceName = process.env.PINGOPS_SERVICE_NAME;\n  }\n  if (process.env.PINGOPS_DEBUG) {\n    envConfig.debug = process.env.PINGOPS_DEBUG === \"true\";\n  }\n  if (process.env.PINGOPS_BATCH_SIZE) {\n    envConfig.batchSize = parseInt(process.env.PINGOPS_BATCH_SIZE, 10);\n  }\n  if (process.env.PINGOPS_BATCH_TIMEOUT) {\n    envConfig.batchTimeout = parseInt(process.env.PINGOPS_BATCH_TIMEOUT, 10);\n  }\n  if (process.env.PINGOPS_EXPORT_MODE) {\n    envConfig.exportMode = process.env.PINGOPS_EXPORT_MODE as\n      | \"batched\"\n      | \"immediate\";\n  }\n\n  // Merge: env vars override file config\n  return {\n    ...fileConfig,\n    ...envConfig,\n  };\n}\n","/**\n * Shared state for tracking SDK initialization\n * This module exists to avoid circular dependencies between pingops.ts and instrumentation.ts\n */\n\nlet isSdkInitializedFlag = false;\n\n/**\n * Sets the SDK initialization flag.\n * Called by initializePingops when the SDK is initialized.\n */\nexport function setSdkInitialized(initialized: boolean): void {\n  isSdkInitializedFlag = initialized;\n}\n","/**\n * PingOps SDK singleton for manual instrumentation\n *\n * Provides initializePingops, shutdownPingops, startTrace, getActiveTraceId,\n * and getActiveSpanId. startTrace can auto-initialize from environment variables if needed.\n */\n\nimport { context, trace } from \"@opentelemetry/api\";\nimport { NodeSDK } from \"@opentelemetry/sdk-node\";\nimport { resourceFromAttributes } from \"@opentelemetry/resources\";\nimport { ATTR_SERVICE_NAME } from \"@opentelemetry/semantic-conventions\";\nimport { NodeTracerProvider } from \"@opentelemetry/sdk-trace-node\";\nimport type { PingopsProcessorConfig } from \"@pingops/otel\";\nimport {\n  setPingopsTracerProvider,\n  shutdownTracerProvider,\n  PingopsSpanProcessor,\n} from \"@pingops/otel\";\nimport {\n  createLogger,\n  createTraceId,\n  uint8ArrayToHex,\n  type PingopsTraceAttributes,\n} from \"@pingops/core\";\nimport {\n  PINGOPS_TRACE_ID,\n  PINGOPS_USER_ID,\n  PINGOPS_SESSION_ID,\n  PINGOPS_TAGS,\n  PINGOPS_METADATA,\n  PINGOPS_CAPTURE_REQUEST_BODY,\n  PINGOPS_CAPTURE_RESPONSE_BODY,\n} from \"@pingops/core\";\nimport { loadConfigFromFile, mergeConfigWithEnv } from \"./config-loader\";\nimport { setSdkInitialized } from \"./init-state\";\nimport { getPingopsTracerProvider } from \"@pingops/otel\";\nimport { getInstrumentations } from \"@pingops/otel\";\n\nconst TRACE_FLAG_SAMPLED = 1;\n\nconst initLogger = createLogger(\"[PingOps Initialize]\");\nconst logger = createLogger(\"[PingOps Pingops]\");\n\nlet sdkInstance: NodeSDK | null = null;\nlet isSdkInitializedFlag = false;\n\n/**\n * Global state to track initialization\n */\nlet isInitialized = false;\nlet initializationPromise: Promise<void> | null = null;\n\n/**\n * Initializes PingOps SDK\n *\n * This function:\n * 1. Creates an OpenTelemetry NodeSDK instance\n * 2. Configures Resource with service.name\n * 3. Registers PingopsSpanProcessor\n * 4. Enables HTTP/fetch/GenAI instrumentation\n * 5. Starts the SDK\n *\n * @param config - Configuration object, config file path, or config file wrapper\n * @param explicit - Whether this is an explicit call (default: true).\n *                   Set to false when called internally by startTrace auto-initialization.\n */\nexport function initializePingops(\n  config: PingopsProcessorConfig,\n  explicit?: boolean\n): void;\nexport function initializePingops(\n  configFilePath: string,\n  explicit?: boolean\n): void;\nexport function initializePingops(\n  config: { configFile: string },\n  explicit?: boolean\n): void;\nexport function initializePingops(\n  config:\n    | PingopsProcessorConfig\n    | string\n    | {\n        configFile: string;\n      },\n  explicit: boolean = true\n): void {\n  void explicit; // Ignored: SDK always uses global instrumentation\n  const resolvedConfig: PingopsProcessorConfig =\n    typeof config === \"string\"\n      ? resolveConfigFromFile(config)\n      : \"configFile\" in config\n        ? resolveConfigFromFile(config.configFile)\n        : config;\n\n  if (isSdkInitializedFlag) {\n    if (resolvedConfig.debug) {\n      initLogger.warn(\"[PingOps] SDK already initialized, skipping\");\n    }\n    return;\n  }\n\n  // Create resource with service name\n  const resource = resourceFromAttributes({\n    [ATTR_SERVICE_NAME]: resolvedConfig.serviceName,\n  });\n\n  const processor = new PingopsSpanProcessor(resolvedConfig);\n  const instrumentations = getInstrumentations();\n\n  // Node.js SDK\n  const nodeSdk = new NodeSDK({\n    resource,\n    spanProcessors: [processor],\n    instrumentations,\n  });\n\n  nodeSdk.start();\n  sdkInstance = nodeSdk;\n\n  // Mark SDK as initialized\n  isSdkInitializedFlag = true;\n\n  setSdkInitialized(true);\n\n  // Initialize isolated TracerProvider for manual spans AFTER NodeSDK starts\n  // This ensures manual spans created via startSpan are processed by the same processor\n  // We register it after NodeSDK so it takes precedence as the global provider\n  try {\n    // In version 2.2.0, span processors are passed in the constructor\n    const isolatedProvider = new NodeTracerProvider({\n      resource,\n      spanProcessors: [processor],\n    });\n\n    // Register the provider globally\n    isolatedProvider.register();\n\n    // Set it in global state\n    setPingopsTracerProvider(isolatedProvider);\n  } catch (error) {\n    if (resolvedConfig.debug) {\n      initLogger.error(\n        \"[PingOps] Failed to create isolated TracerProvider:\",\n        error instanceof Error ? error.message : String(error)\n      );\n    }\n    // Continue without isolated provider - manual spans will use global provider\n  }\n\n  if (resolvedConfig.debug) {\n    initLogger.info(\"[PingOps] SDK initialized\");\n  }\n}\n\nfunction resolveConfigFromFile(configFilePath: string): PingopsProcessorConfig {\n  const fileConfig = loadConfigFromFile(configFilePath);\n  const mergedConfig = mergeConfigWithEnv(fileConfig);\n\n  if (!mergedConfig.baseUrl || !mergedConfig.serviceName) {\n    const missing = [\n      !mergedConfig.baseUrl && \"baseUrl (or PINGOPS_BASE_URL)\",\n      !mergedConfig.serviceName && \"serviceName (or PINGOPS_SERVICE_NAME)\",\n    ].filter(Boolean);\n\n    throw new Error(\n      `initializePingops(configFile) requires ${missing.join(\" and \")}. ` +\n        `Provide them in the config file or via environment variables.`\n    );\n  }\n\n  return mergedConfig as PingopsProcessorConfig;\n}\n\n/**\n * Shuts down the SDK and flushes remaining spans\n */\nexport async function shutdownPingops(): Promise<void> {\n  // Shutdown isolated TracerProvider first\n  await shutdownTracerProvider();\n\n  if (!sdkInstance) {\n    return;\n  }\n\n  await sdkInstance.shutdown();\n  sdkInstance = null;\n  isSdkInitializedFlag = false;\n  setSdkInitialized(false);\n}\n\n/**\n * Checks if the SDK is already initialized by checking if a NodeTracerProvider is available\n */\nfunction isSdkInitialized(): boolean {\n  try {\n    const provider = getPingopsTracerProvider();\n    // If we have a NodeTracerProvider (not the default NoOpTracerProvider), SDK is initialized\n    const initialized = provider instanceof NodeTracerProvider;\n    logger.debug(\"Checked SDK initialization status\", {\n      initialized,\n      providerType: provider.constructor.name,\n    });\n    return initialized;\n  } catch (error) {\n    logger.debug(\"Error checking SDK initialization status\", {\n      error: error instanceof Error ? error.message : String(error),\n    });\n    return false;\n  }\n}\n\n/**\n * Auto-initializes the SDK from environment variables if not already initialized\n */\nasync function ensureInitialized(): Promise<void> {\n  // Check if SDK is already initialized (e.g., by calling initializePingops directly)\n  if (isSdkInitialized()) {\n    logger.debug(\"SDK already initialized, skipping auto-initialization\");\n    isInitialized = true;\n    return;\n  }\n\n  if (isInitialized) {\n    logger.debug(\"SDK initialization flag already set, skipping\");\n    return;\n  }\n\n  // If initialization is in progress, wait for it\n  if (initializationPromise) {\n    logger.debug(\"SDK initialization already in progress, waiting...\");\n    return initializationPromise;\n  }\n\n  // Start initialization\n  logger.info(\"Starting SDK auto-initialization from environment variables\");\n  initializationPromise = Promise.resolve().then(() => {\n    const apiKey = process.env.PINGOPS_API_KEY;\n    const baseUrl = process.env.PINGOPS_BASE_URL;\n    const serviceName = process.env.PINGOPS_SERVICE_NAME;\n    const debug = process.env.PINGOPS_DEBUG === \"true\";\n\n    logger.debug(\"Reading environment variables\", {\n      hasApiKey: !!apiKey,\n      hasBaseUrl: !!baseUrl,\n      hasServiceName: !!serviceName,\n      debug,\n    });\n\n    if (!apiKey || !baseUrl || !serviceName) {\n      const missing = [\n        !apiKey && \"PINGOPS_API_KEY\",\n        !baseUrl && \"PINGOPS_BASE_URL\",\n        !serviceName && \"PINGOPS_SERVICE_NAME\",\n      ].filter(Boolean);\n\n      logger.error(\n        \"Missing required environment variables for auto-initialization\",\n        {\n          missing,\n        }\n      );\n\n      throw new Error(\n        `PingOps SDK auto-initialization requires PINGOPS_API_KEY, PINGOPS_BASE_URL, and PINGOPS_SERVICE_NAME environment variables. Missing: ${missing.join(\", \")}`\n      );\n    }\n\n    const config: PingopsProcessorConfig = {\n      apiKey,\n      baseUrl,\n      serviceName,\n      debug,\n    };\n\n    logger.info(\"Initializing SDK with config\", {\n      baseUrl,\n      serviceName,\n      debug,\n    });\n\n    // Call initializePingops with explicit=false since this is auto-initialization\n    initializePingops(config, false);\n    isInitialized = true;\n\n    logger.info(\"SDK auto-initialization completed successfully\");\n  });\n\n  try {\n    await initializationPromise;\n  } catch (error) {\n    logger.error(\"SDK auto-initialization failed\", {\n      error: error instanceof Error ? error.message : String(error),\n    });\n    throw error;\n  } finally {\n    initializationPromise = null;\n  }\n}\n\n/**\n * Returns the trace ID of the currently active span, if any.\n */\nexport function getActiveTraceId(): string | undefined {\n  return trace.getActiveSpan()?.spanContext().traceId;\n}\n\n/**\n * Returns the span ID of the currently active span, if any.\n */\nexport function getActiveSpanId(): string | undefined {\n  return trace.getActiveSpan()?.spanContext().spanId;\n}\n\n/**\n * Starts a new trace using the PingOps tracer provider and runs the callback within that trace.\n * Sets attributes (traceId, userId, sessionId, tags, metadata, etc.) in context so they are\n * propagated to spans created within the callback.\n *\n * @param options - Options including optional attributes and optional seed for deterministic traceId\n * @param fn - Function to execute within the trace and attribute context\n * @returns Promise resolving to the result of the function\n *\n * @example\n * ```typescript\n * import { startTrace, initializePingops } from '@pingops/sdk';\n *\n * initializePingops({ ... });\n *\n * const result = await startTrace({\n *   attributes: {\n *     userId: 'user-123',\n *     sessionId: 'session-456',\n *     tags: ['production', 'api'],\n *     metadata: { environment: 'prod', version: '1.0.0' }\n *   },\n *   seed: 'request-123' // optional: deterministic traceId from this seed\n * }, async () => {\n *   const response = await fetch('https://api.example.com/users/123');\n *   return response.json();\n * });\n * ```\n */\nexport async function startTrace<T>(\n  options: { attributes?: PingopsTraceAttributes; seed?: string },\n  fn: () => T | Promise<T>\n): Promise<T> {\n  if (!isSdkInitialized()) {\n    await ensureInitialized();\n  }\n\n  const traceId =\n    options.attributes?.traceId ?? (await createTraceId(options?.seed));\n  const parentSpanId = uint8ArrayToHex(\n    crypto.getRandomValues(new Uint8Array(8))\n  );\n\n  const spanContext = {\n    traceId,\n    spanId: parentSpanId,\n    traceFlags: TRACE_FLAG_SAMPLED,\n  };\n\n  const activeContext = context.active();\n  const contextWithSpanContext = trace.setSpanContext(\n    activeContext,\n    spanContext\n  );\n\n  const tracer = getPingopsTracerProvider().getTracer(\"pingops-sdk\", \"1.0.0\");\n\n  return new Promise((resolve, reject) => {\n    tracer.startActiveSpan(\n      \"pingops-trace\",\n      {},\n      contextWithSpanContext,\n      (span) => {\n        let contextWithAttributes = context.active();\n        const attrs = options.attributes;\n        if (attrs) {\n          contextWithAttributes = setAttributesInContext(\n            contextWithAttributes,\n            attrs\n          );\n        }\n        contextWithAttributes = contextWithAttributes.setValue(\n          PINGOPS_TRACE_ID,\n          traceId\n        );\n\n        const run = () => fn();\n\n        try {\n          const result = context.with(contextWithAttributes, run);\n          if (result instanceof Promise) {\n            result\n              .then((v) => {\n                span.end();\n                resolve(v);\n              })\n              .catch((err) => {\n                span.end();\n                reject(err);\n              });\n          } else {\n            span.end();\n            resolve(result);\n          }\n        } catch (err) {\n          span.end();\n          reject(err);\n        }\n      }\n    );\n  });\n}\n\nfunction setAttributesInContext(\n  ctx: ReturnType<typeof context.active>,\n  attrs: PingopsTraceAttributes\n): ReturnType<typeof context.active> {\n  if (attrs.userId !== undefined) {\n    ctx = ctx.setValue(PINGOPS_USER_ID, attrs.userId);\n  }\n  if (attrs.sessionId !== undefined) {\n    ctx = ctx.setValue(PINGOPS_SESSION_ID, attrs.sessionId);\n  }\n  if (attrs.tags !== undefined) {\n    ctx = ctx.setValue(PINGOPS_TAGS, attrs.tags);\n  }\n  if (attrs.metadata !== undefined) {\n    ctx = ctx.setValue(PINGOPS_METADATA, attrs.metadata);\n  }\n  if (attrs.captureRequestBody !== undefined) {\n    ctx = ctx.setValue(PINGOPS_CAPTURE_REQUEST_BODY, attrs.captureRequestBody);\n  }\n  if (attrs.captureResponseBody !== undefined) {\n    ctx = ctx.setValue(\n      PINGOPS_CAPTURE_RESPONSE_BODY,\n      attrs.captureResponseBody\n    );\n  }\n  return ctx;\n}\n"],"mappings":"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"}

package/dist/register.cjs

@@ -0,0 +1,73 @@
+const require_pingops = require('./pingops-Bbm0Xd0z.cjs');
+
+//#region src/register.ts
+/**
+* @pingops/sdk/register - Auto-instrumentation setup
+*
+* This file automatically initializes PingOps SDK from environment variables or a config file when imported.
+*
+* RECOMMENDED: Import this file FIRST in your application (before any HTTP clients):
+*   import '@pingops/sdk/register';
+*   import axios from 'axios';
+*   // ... rest of your code
+*
+* ALTERNATIVE: Use Node.js --require flag (runs before any imports):
+*   node --require @pingops/sdk/register your-app.js
+*
+* Configuration can be provided via:
+* 1. Config file (JSON or YAML) - Set PINGOPS_CONFIG_FILE environment variable
+* 2. Environment variables (takes precedence over config file)
+*
+* Environment variables:
+*   - PINGOPS_CONFIG_FILE: Path to JSON or YAML config file (optional)
+*   - PINGOPS_API_KEY: Your API key
+*   - PINGOPS_BASE_URL: Base URL for PingOps API (required)
+*   - PINGOPS_SERVICE_NAME: Service name (required)
+*   - PINGOPS_DEBUG: Set to 'true' to enable debug logging
+*   - PINGOPS_BATCH_SIZE: Batch size for span export (optional)
+*   - PINGOPS_BATCH_TIMEOUT: Batch timeout in ms (optional)
+*   - PINGOPS_EXPORT_MODE: Export mode - 'batched' or 'immediate' (optional)
+*
+* Config file format (JSON example):
+*   {
+*     "apiKey": "your-api-key",
+*     "baseUrl": "https://api.pingops.com",
+*     "serviceName": "my-service",
+*     "debug": false,
+*     "batchSize": 50,
+*     "batchTimeout": 5000,
+*     "exportMode": "batched"
+*   }
+*
+* Config file format (YAML example):
+*   apiKey: your-api-key
+*   baseUrl: https://api.pingops.com
+*   serviceName: my-service
+*   debug: false
+*   batchSize: 50
+*   batchTimeout: 5000
+*   exportMode: batched
+*/
+let config = {};
+const configFilePath = process.env.PINGOPS_CONFIG_FILE;
+if (configFilePath) try {
+	config = require_pingops.mergeConfigWithEnv(require_pingops.loadConfigFromFile(configFilePath));
+} catch (error) {
+	console.error(`[PingOps] Failed to load config from file ${configFilePath}:`, error instanceof Error ? error.message : String(error));
+	config = require_pingops.mergeConfigWithEnv({});
+}
+else config = require_pingops.mergeConfigWithEnv({});
+const baseUrl = config.baseUrl;
+const serviceName = config.serviceName;
+if (baseUrl && serviceName) require_pingops.initializePingops({
+	apiKey: config.apiKey,
+	baseUrl,
+	serviceName,
+	debug: config.debug,
+	batchSize: config.batchSize,
+	batchTimeout: config.batchTimeout,
+	exportMode: config.exportMode
+});
+
+//#endregion
+//# sourceMappingURL=register.cjs.map

package/dist/register.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.cjs","names":["mergeConfigWithEnv","loadConfigFromFile"],"sources":["../src/register.ts"],"sourcesContent":["/**\n * @pingops/sdk/register - Auto-instrumentation setup\n *\n * This file automatically initializes PingOps SDK from environment variables or a config file when imported.\n *\n * RECOMMENDED: Import this file FIRST in your application (before any HTTP clients):\n *   import '@pingops/sdk/register';\n *   import axios from 'axios';\n *   // ... rest of your code\n *\n * ALTERNATIVE: Use Node.js --require flag (runs before any imports):\n *   node --require @pingops/sdk/register your-app.js\n *\n * Configuration can be provided via:\n * 1. Config file (JSON or YAML) - Set PINGOPS_CONFIG_FILE environment variable\n * 2. Environment variables (takes precedence over config file)\n *\n * Environment variables:\n *   - PINGOPS_CONFIG_FILE: Path to JSON or YAML config file (optional)\n *   - PINGOPS_API_KEY: Your API key\n *   - PINGOPS_BASE_URL: Base URL for PingOps API (required)\n *   - PINGOPS_SERVICE_NAME: Service name (required)\n *   - PINGOPS_DEBUG: Set to 'true' to enable debug logging\n *   - PINGOPS_BATCH_SIZE: Batch size for span export (optional)\n *   - PINGOPS_BATCH_TIMEOUT: Batch timeout in ms (optional)\n *   - PINGOPS_EXPORT_MODE: Export mode - 'batched' or 'immediate' (optional)\n *\n * Config file format (JSON example):\n *   {\n *     \"apiKey\": \"your-api-key\",\n *     \"baseUrl\": \"https://api.pingops.com\",\n *     \"serviceName\": \"my-service\",\n *     \"debug\": false,\n *     \"batchSize\": 50,\n *     \"batchTimeout\": 5000,\n *     \"exportMode\": \"batched\"\n *   }\n *\n * Config file format (YAML example):\n *   apiKey: your-api-key\n *   baseUrl: https://api.pingops.com\n *   serviceName: my-service\n *   debug: false\n *   batchSize: 50\n *   batchTimeout: 5000\n *   exportMode: batched\n */\n\nimport { initializePingops } from \"./pingops.js\";\nimport { loadConfigFromFile, mergeConfigWithEnv } from \"./config-loader.js\";\n\nlet config: {\n  apiKey?: string;\n  baseUrl?: string;\n  serviceName?: string;\n  debug?: boolean;\n  batchSize?: number;\n  batchTimeout?: number;\n  exportMode?: \"batched\" | \"immediate\";\n} = {};\n\n// Try to load config from file if PINGOPS_CONFIG_FILE is set\nconst configFilePath = process.env.PINGOPS_CONFIG_FILE;\nif (configFilePath) {\n  try {\n    const fileConfig = loadConfigFromFile(configFilePath);\n    config = mergeConfigWithEnv(fileConfig);\n  } catch (error) {\n    console.error(\n      `[PingOps] Failed to load config from file ${configFilePath}:`,\n      error instanceof Error ? error.message : String(error)\n    );\n    // Fall back to environment variables only\n    config = mergeConfigWithEnv({});\n  }\n} else {\n  // No config file, use environment variables only\n  config = mergeConfigWithEnv({});\n}\n\n// Only auto-initialize if required config values are present\nconst baseUrl = config.baseUrl;\nconst serviceName = config.serviceName;\n\nif (baseUrl && serviceName) {\n  initializePingops({\n    apiKey: config.apiKey,\n    baseUrl,\n    serviceName,\n    debug: config.debug,\n    batchSize: config.batchSize,\n    batchTimeout: config.batchTimeout,\n    exportMode: config.exportMode,\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmDA,IAAI,SAQA,EAAE;AAGN,MAAM,iBAAiB,QAAQ,IAAI;AACnC,IAAI,eACF,KAAI;AAEF,UAASA,mCADUC,mCAAmB,eAAe,CACd;SAChC,OAAO;AACd,SAAQ,MACN,6CAA6C,eAAe,IAC5D,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,CACvD;AAED,UAASD,mCAAmB,EAAE,CAAC;;IAIjC,UAASA,mCAAmB,EAAE,CAAC;AAIjC,MAAM,UAAU,OAAO;AACvB,MAAM,cAAc,OAAO;AAE3B,IAAI,WAAW,YACb,mCAAkB;CAChB,QAAQ,OAAO;CACf;CACA;CACA,OAAO,OAAO;CACd,WAAW,OAAO;CAClB,cAAc,OAAO;CACrB,YAAY,OAAO;CACpB,CAAC"}

package/dist/register.d.cts

@@ -0,0 +1 @@
+export { };

package/dist/register.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/register.mjs

@@ -0,0 +1,74 @@
+import { o as loadConfigFromFile, r as initializePingops, s as mergeConfigWithEnv } from "./pingops-DJsItvUR.mjs";
+
+//#region src/register.ts
+/**
+* @pingops/sdk/register - Auto-instrumentation setup
+*
+* This file automatically initializes PingOps SDK from environment variables or a config file when imported.
+*
+* RECOMMENDED: Import this file FIRST in your application (before any HTTP clients):
+*   import '@pingops/sdk/register';
+*   import axios from 'axios';
+*   // ... rest of your code
+*
+* ALTERNATIVE: Use Node.js --require flag (runs before any imports):
+*   node --require @pingops/sdk/register your-app.js
+*
+* Configuration can be provided via:
+* 1. Config file (JSON or YAML) - Set PINGOPS_CONFIG_FILE environment variable
+* 2. Environment variables (takes precedence over config file)
+*
+* Environment variables:
+*   - PINGOPS_CONFIG_FILE: Path to JSON or YAML config file (optional)
+*   - PINGOPS_API_KEY: Your API key
+*   - PINGOPS_BASE_URL: Base URL for PingOps API (required)
+*   - PINGOPS_SERVICE_NAME: Service name (required)
+*   - PINGOPS_DEBUG: Set to 'true' to enable debug logging
+*   - PINGOPS_BATCH_SIZE: Batch size for span export (optional)
+*   - PINGOPS_BATCH_TIMEOUT: Batch timeout in ms (optional)
+*   - PINGOPS_EXPORT_MODE: Export mode - 'batched' or 'immediate' (optional)
+*
+* Config file format (JSON example):
+*   {
+*     "apiKey": "your-api-key",
+*     "baseUrl": "https://api.pingops.com",
+*     "serviceName": "my-service",
+*     "debug": false,
+*     "batchSize": 50,
+*     "batchTimeout": 5000,
+*     "exportMode": "batched"
+*   }
+*
+* Config file format (YAML example):
+*   apiKey: your-api-key
+*   baseUrl: https://api.pingops.com
+*   serviceName: my-service
+*   debug: false
+*   batchSize: 50
+*   batchTimeout: 5000
+*   exportMode: batched
+*/
+let config = {};
+const configFilePath = process.env.PINGOPS_CONFIG_FILE;
+if (configFilePath) try {
+	config = mergeConfigWithEnv(loadConfigFromFile(configFilePath));
+} catch (error) {
+	console.error(`[PingOps] Failed to load config from file ${configFilePath}:`, error instanceof Error ? error.message : String(error));
+	config = mergeConfigWithEnv({});
+}
+else config = mergeConfigWithEnv({});
+const baseUrl = config.baseUrl;
+const serviceName = config.serviceName;
+if (baseUrl && serviceName) initializePingops({
+	apiKey: config.apiKey,
+	baseUrl,
+	serviceName,
+	debug: config.debug,
+	batchSize: config.batchSize,
+	batchTimeout: config.batchTimeout,
+	exportMode: config.exportMode
+});
+
+//#endregion
+export {  };
+//# sourceMappingURL=register.mjs.map

package/dist/register.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.mjs","names":[],"sources":["../src/register.ts"],"sourcesContent":["/**\n * @pingops/sdk/register - Auto-instrumentation setup\n *\n * This file automatically initializes PingOps SDK from environment variables or a config file when imported.\n *\n * RECOMMENDED: Import this file FIRST in your application (before any HTTP clients):\n *   import '@pingops/sdk/register';\n *   import axios from 'axios';\n *   // ... rest of your code\n *\n * ALTERNATIVE: Use Node.js --require flag (runs before any imports):\n *   node --require @pingops/sdk/register your-app.js\n *\n * Configuration can be provided via:\n * 1. Config file (JSON or YAML) - Set PINGOPS_CONFIG_FILE environment variable\n * 2. Environment variables (takes precedence over config file)\n *\n * Environment variables:\n *   - PINGOPS_CONFIG_FILE: Path to JSON or YAML config file (optional)\n *   - PINGOPS_API_KEY: Your API key\n *   - PINGOPS_BASE_URL: Base URL for PingOps API (required)\n *   - PINGOPS_SERVICE_NAME: Service name (required)\n *   - PINGOPS_DEBUG: Set to 'true' to enable debug logging\n *   - PINGOPS_BATCH_SIZE: Batch size for span export (optional)\n *   - PINGOPS_BATCH_TIMEOUT: Batch timeout in ms (optional)\n *   - PINGOPS_EXPORT_MODE: Export mode - 'batched' or 'immediate' (optional)\n *\n * Config file format (JSON example):\n *   {\n *     \"apiKey\": \"your-api-key\",\n *     \"baseUrl\": \"https://api.pingops.com\",\n *     \"serviceName\": \"my-service\",\n *     \"debug\": false,\n *     \"batchSize\": 50,\n *     \"batchTimeout\": 5000,\n *     \"exportMode\": \"batched\"\n *   }\n *\n * Config file format (YAML example):\n *   apiKey: your-api-key\n *   baseUrl: https://api.pingops.com\n *   serviceName: my-service\n *   debug: false\n *   batchSize: 50\n *   batchTimeout: 5000\n *   exportMode: batched\n */\n\nimport { initializePingops } from \"./pingops.js\";\nimport { loadConfigFromFile, mergeConfigWithEnv } from \"./config-loader.js\";\n\nlet config: {\n  apiKey?: string;\n  baseUrl?: string;\n  serviceName?: string;\n  debug?: boolean;\n  batchSize?: number;\n  batchTimeout?: number;\n  exportMode?: \"batched\" | \"immediate\";\n} = {};\n\n// Try to load config from file if PINGOPS_CONFIG_FILE is set\nconst configFilePath = process.env.PINGOPS_CONFIG_FILE;\nif (configFilePath) {\n  try {\n    const fileConfig = loadConfigFromFile(configFilePath);\n    config = mergeConfigWithEnv(fileConfig);\n  } catch (error) {\n    console.error(\n      `[PingOps] Failed to load config from file ${configFilePath}:`,\n      error instanceof Error ? error.message : String(error)\n    );\n    // Fall back to environment variables only\n    config = mergeConfigWithEnv({});\n  }\n} else {\n  // No config file, use environment variables only\n  config = mergeConfigWithEnv({});\n}\n\n// Only auto-initialize if required config values are present\nconst baseUrl = config.baseUrl;\nconst serviceName = config.serviceName;\n\nif (baseUrl && serviceName) {\n  initializePingops({\n    apiKey: config.apiKey,\n    baseUrl,\n    serviceName,\n    debug: config.debug,\n    batchSize: config.batchSize,\n    batchTimeout: config.batchTimeout,\n    exportMode: config.exportMode,\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmDA,IAAI,SAQA,EAAE;AAGN,MAAM,iBAAiB,QAAQ,IAAI;AACnC,IAAI,eACF,KAAI;AAEF,UAAS,mBADU,mBAAmB,eAAe,CACd;SAChC,OAAO;AACd,SAAQ,MACN,6CAA6C,eAAe,IAC5D,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,CACvD;AAED,UAAS,mBAAmB,EAAE,CAAC;;IAIjC,UAAS,mBAAmB,EAAE,CAAC;AAIjC,MAAM,UAAU,OAAO;AACvB,MAAM,cAAc,OAAO;AAE3B,IAAI,WAAW,YACb,mBAAkB;CAChB,QAAQ,OAAO;CACf;CACA;CACA,OAAO,OAAO;CACd,WAAW,OAAO;CAClB,cAAc,OAAO;CACrB,YAAY,OAAO;CACpB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pingops/sdk",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "type": "module",
   "engines": {
     "node": ">=20"
@@ -14,6 +14,11 @@
       "types": "./dist/index.d.mts",
       "import": "./dist/index.mjs",
       "require": "./dist/index.cjs"
+    },
+    "./register": {
+      "types": "./dist/register.d.mts",
+      "import": "./dist/register.mjs",
+      "require": "./dist/register.cjs"
     }
   },
   "files": [
@@ -38,11 +43,15 @@
     "@opentelemetry/sdk-node": "^0.208.0",
     "@opentelemetry/sdk-trace-node": "^2.2.0",
     "@opentelemetry/semantic-conventions": "^1.38.0",
-    "@pingops/otel": "^0.1.2",
-    "@pingops/core": "^0.1.2"
+    "js-yaml": "^4.1.0",
+    "@pingops/core": "^0.2.0",
+    "@pingops/otel": "^0.2.0"
   },
   "devDependencies": {
     "@types/node": "^20.11.0",
+    "@types/js-yaml": "^4.0.9",
+    "axios": "^1.6.2",
+    "tsx": "^4.7.0",
     "typescript": "^5.6.0"
   },
   "scripts": {

package/dist/index.cjs.map

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

package/dist/index.mjs.map

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