@observantic/sdk 1.0.0

package/dist/index.d.cts

@@ -0,0 +1,159 @@
+import { NodeSDK } from '@opentelemetry/sdk-node';
+import { Tracer, Meter } from '@opentelemetry/api';
+export { SpanKind, SpanStatusCode, context, metrics, trace } from '@opentelemetry/api';
+import { Logger } from '@opentelemetry/api-logs';
+export { logs } from '@opentelemetry/api-logs';
+
+interface ObservanticOptions {
+    /**
+     * Ingestion API key for your Observantic workspace.
+     * Defaults to process.env.OBSERVANTIC_API_KEY.
+     */
+    apiKey?: string;
+    /**
+     * Observantic ingestion base endpoint URL.
+     * Defaults to process.env.OBSERVANTIC_ENDPOINT or "https://api.observantic.com".
+     */
+    endpoint?: string;
+    /**
+     * Name of your application service.
+     * Defaults to process.env.OBSERVANTIC_SERVICE_NAME, process.env.OTEL_SERVICE_NAME,
+     * process.env.npm_package_name, or "node-service".
+     */
+    serviceName?: string;
+    /**
+     * Deployment environment (e.g., "production", "staging", "development").
+     * Defaults to process.env.OBSERVANTIC_ENVIRONMENT, process.env.NODE_ENV, or "development".
+     */
+    environment?: string;
+    /**
+     * Version of your application.
+     * Defaults to process.env.OBSERVANTIC_SERVICE_VERSION, process.env.npm_package_version, or "1.0.0".
+     */
+    serviceVersion?: string;
+    /**
+     * Custom resource attributes to attach to all telemetry (traces, metrics, logs).
+     */
+    resourceAttributes?: Record<string, string | number | boolean>;
+    /**
+     * Additional HTTP headers to attach to OTLP export requests.
+     */
+    headers?: Record<string, string>;
+    /**
+     * Disable telemetry collection entirely (useful in test or CI environments).
+     * Defaults to process.env.OBSERVANTIC_DISABLED === "true".
+     */
+    disabled?: boolean;
+    /**
+     * Enable verbose OpenTelemetry internal diagnostic logging.
+     * Defaults to process.env.OBSERVANTIC_DEBUG === "true".
+     */
+    debug?: boolean;
+    /**
+     * Automatically install graceful shutdown hooks for SIGINT and SIGTERM.
+     * Defaults to true.
+     */
+    autoShutdown?: boolean;
+    /**
+     * Sampling ratio for traces from 0.0 (0%) to 1.0 (100%).
+     * Defaults to 1.0.
+     */
+    traceSampleRate?: number;
+    /**
+     * Batch span export timeout in milliseconds.
+     * Defaults to 5000ms.
+     */
+    batchTimeoutMillis?: number;
+    /**
+     * Maximum queue size for spans and logs waiting to be exported.
+     * Defaults to 2048.
+     */
+    maxQueueSize?: number;
+    /**
+     * Maximum batch size per export request.
+     * Defaults to 512.
+     */
+    maxExportBatchSize?: number;
+    /**
+     * Metrics periodic export interval in milliseconds.
+     * Defaults to 60000ms (60s).
+     */
+    metricExportIntervalMillis?: number;
+    /**
+     * Enable or disable individual telemetry signals.
+     */
+    signals?: {
+        traces?: boolean;
+        metrics?: boolean;
+        logs?: boolean;
+    };
+}
+interface ResolvedObservanticConfig {
+    apiKey: string;
+    endpoint: string;
+    tracesEndpoint: string;
+    metricsEndpoint: string;
+    logsEndpoint: string;
+    serviceName: string;
+    environment: string;
+    serviceVersion: string;
+    resourceAttributes: Record<string, string | number | boolean>;
+    headers: Record<string, string>;
+    disabled: boolean;
+    debug: boolean;
+    autoShutdown: boolean;
+    traceSampleRate: number;
+    batchTimeoutMillis: number;
+    maxQueueSize: number;
+    maxExportBatchSize: number;
+    metricExportIntervalMillis: number;
+    signals: {
+        traces: boolean;
+        metrics: boolean;
+        logs: boolean;
+    };
+}
+/**
+ * Normalizes an endpoint URL and constructs signal-specific paths.
+ */
+declare function normalizeEndpoints(baseEndpoint: string): {
+    endpoint: string;
+    tracesEndpoint: string;
+    metricsEndpoint: string;
+    logsEndpoint: string;
+};
+/**
+ * Resolves user options with environment variables and sensible defaults.
+ */
+declare function resolveConfig(options?: ObservanticOptions): ResolvedObservanticConfig;
+
+/**
+ * Gracefully shuts down the Observantic OpenTelemetry SDK and flushes pending telemetry.
+ */
+declare function shutdownObservantic(): Promise<void>;
+
+interface ObservanticClient {
+    sdk: NodeSDK | null;
+    config: ResolvedObservanticConfig;
+    shutdown: () => Promise<void>;
+    getTracer: (name?: string, version?: string) => Tracer;
+    getMeter: (name?: string, version?: string) => Meter;
+    getLogger: (name?: string, version?: string) => Logger;
+}
+/**
+ * Initializes Observantic OpenTelemetry instrumentation for Node.js and Express.
+ *
+ * @example
+ * ```ts
+ * import { initObservantic } from "@observantic/node";
+ *
+ * initObservantic({
+ *   apiKey: "cw_live_sec_xxxxx",
+ *   endpoint: "https://api.observantic.com",
+ *   serviceName: "my-express-app"
+ * });
+ * ```
+ */
+declare function initObservantic(options?: ObservanticOptions): ObservanticClient;
+
+export { type ObservanticClient, type ObservanticOptions, type ResolvedObservanticConfig, initObservantic, normalizeEndpoints, resolveConfig, shutdownObservantic };

package/dist/index.d.ts

@@ -0,0 +1,159 @@
+import { NodeSDK } from '@opentelemetry/sdk-node';
+import { Tracer, Meter } from '@opentelemetry/api';
+export { SpanKind, SpanStatusCode, context, metrics, trace } from '@opentelemetry/api';
+import { Logger } from '@opentelemetry/api-logs';
+export { logs } from '@opentelemetry/api-logs';
+
+interface ObservanticOptions {
+    /**
+     * Ingestion API key for your Observantic workspace.
+     * Defaults to process.env.OBSERVANTIC_API_KEY.
+     */
+    apiKey?: string;
+    /**
+     * Observantic ingestion base endpoint URL.
+     * Defaults to process.env.OBSERVANTIC_ENDPOINT or "https://api.observantic.com".
+     */
+    endpoint?: string;
+    /**
+     * Name of your application service.
+     * Defaults to process.env.OBSERVANTIC_SERVICE_NAME, process.env.OTEL_SERVICE_NAME,
+     * process.env.npm_package_name, or "node-service".
+     */
+    serviceName?: string;
+    /**
+     * Deployment environment (e.g., "production", "staging", "development").
+     * Defaults to process.env.OBSERVANTIC_ENVIRONMENT, process.env.NODE_ENV, or "development".
+     */
+    environment?: string;
+    /**
+     * Version of your application.
+     * Defaults to process.env.OBSERVANTIC_SERVICE_VERSION, process.env.npm_package_version, or "1.0.0".
+     */
+    serviceVersion?: string;
+    /**
+     * Custom resource attributes to attach to all telemetry (traces, metrics, logs).
+     */
+    resourceAttributes?: Record<string, string | number | boolean>;
+    /**
+     * Additional HTTP headers to attach to OTLP export requests.
+     */
+    headers?: Record<string, string>;
+    /**
+     * Disable telemetry collection entirely (useful in test or CI environments).
+     * Defaults to process.env.OBSERVANTIC_DISABLED === "true".
+     */
+    disabled?: boolean;
+    /**
+     * Enable verbose OpenTelemetry internal diagnostic logging.
+     * Defaults to process.env.OBSERVANTIC_DEBUG === "true".
+     */
+    debug?: boolean;
+    /**
+     * Automatically install graceful shutdown hooks for SIGINT and SIGTERM.
+     * Defaults to true.
+     */
+    autoShutdown?: boolean;
+    /**
+     * Sampling ratio for traces from 0.0 (0%) to 1.0 (100%).
+     * Defaults to 1.0.
+     */
+    traceSampleRate?: number;
+    /**
+     * Batch span export timeout in milliseconds.
+     * Defaults to 5000ms.
+     */
+    batchTimeoutMillis?: number;
+    /**
+     * Maximum queue size for spans and logs waiting to be exported.
+     * Defaults to 2048.
+     */
+    maxQueueSize?: number;
+    /**
+     * Maximum batch size per export request.
+     * Defaults to 512.
+     */
+    maxExportBatchSize?: number;
+    /**
+     * Metrics periodic export interval in milliseconds.
+     * Defaults to 60000ms (60s).
+     */
+    metricExportIntervalMillis?: number;
+    /**
+     * Enable or disable individual telemetry signals.
+     */
+    signals?: {
+        traces?: boolean;
+        metrics?: boolean;
+        logs?: boolean;
+    };
+}
+interface ResolvedObservanticConfig {
+    apiKey: string;
+    endpoint: string;
+    tracesEndpoint: string;
+    metricsEndpoint: string;
+    logsEndpoint: string;
+    serviceName: string;
+    environment: string;
+    serviceVersion: string;
+    resourceAttributes: Record<string, string | number | boolean>;
+    headers: Record<string, string>;
+    disabled: boolean;
+    debug: boolean;
+    autoShutdown: boolean;
+    traceSampleRate: number;
+    batchTimeoutMillis: number;
+    maxQueueSize: number;
+    maxExportBatchSize: number;
+    metricExportIntervalMillis: number;
+    signals: {
+        traces: boolean;
+        metrics: boolean;
+        logs: boolean;
+    };
+}
+/**
+ * Normalizes an endpoint URL and constructs signal-specific paths.
+ */
+declare function normalizeEndpoints(baseEndpoint: string): {
+    endpoint: string;
+    tracesEndpoint: string;
+    metricsEndpoint: string;
+    logsEndpoint: string;
+};
+/**
+ * Resolves user options with environment variables and sensible defaults.
+ */
+declare function resolveConfig(options?: ObservanticOptions): ResolvedObservanticConfig;
+
+/**
+ * Gracefully shuts down the Observantic OpenTelemetry SDK and flushes pending telemetry.
+ */
+declare function shutdownObservantic(): Promise<void>;
+
+interface ObservanticClient {
+    sdk: NodeSDK | null;
+    config: ResolvedObservanticConfig;
+    shutdown: () => Promise<void>;
+    getTracer: (name?: string, version?: string) => Tracer;
+    getMeter: (name?: string, version?: string) => Meter;
+    getLogger: (name?: string, version?: string) => Logger;
+}
+/**
+ * Initializes Observantic OpenTelemetry instrumentation for Node.js and Express.
+ *
+ * @example
+ * ```ts
+ * import { initObservantic } from "@observantic/node";
+ *
+ * initObservantic({
+ *   apiKey: "cw_live_sec_xxxxx",
+ *   endpoint: "https://api.observantic.com",
+ *   serviceName: "my-express-app"
+ * });
+ * ```
+ */
+declare function initObservantic(options?: ObservanticOptions): ObservanticClient;
+
+export { type ObservanticClient, type ObservanticOptions, type ResolvedObservanticConfig, initObservantic, normalizeEndpoints, resolveConfig, shutdownObservantic };

package/dist/index.js

@@ -0,0 +1,369 @@
+// src/index.ts
+import { NodeSDK } from "@opentelemetry/sdk-node";
+import {
+  diag as diag2,
+  DiagConsoleLogger,
+  DiagLogLevel,
+  trace,
+  context,
+  metrics,
+  SpanStatusCode,
+  SpanKind
+} from "@opentelemetry/api";
+import { logs } from "@opentelemetry/api-logs";
+
+// src/config.ts
+function normalizeEndpoints(baseEndpoint) {
+  let cleaned = (baseEndpoint || "https://api.observantic.com").trim();
+  cleaned = cleaned.replace(/\/+$/, "");
+  if (cleaned.endsWith("/v1/traces")) {
+    const root = cleaned.slice(0, -"/v1/traces".length);
+    return {
+      endpoint: root,
+      tracesEndpoint: cleaned,
+      metricsEndpoint: `${root}/v1/metrics`,
+      logsEndpoint: `${root}/v1/logs`
+    };
+  }
+  if (cleaned.endsWith("/v1")) {
+    return {
+      endpoint: cleaned,
+      tracesEndpoint: `${cleaned}/traces`,
+      metricsEndpoint: `${cleaned}/metrics`,
+      logsEndpoint: `${cleaned}/logs`
+    };
+  }
+  return {
+    endpoint: cleaned,
+    tracesEndpoint: `${cleaned}/v1/traces`,
+    metricsEndpoint: `${cleaned}/v1/metrics`,
+    logsEndpoint: `${cleaned}/v1/logs`
+  };
+}
+function parseOtelHeaders(headerStr) {
+  if (!headerStr) return {};
+  const headers = {};
+  const pairs = headerStr.split(",");
+  for (const pair of pairs) {
+    const idx = pair.indexOf("=");
+    if (idx > 0) {
+      const key = pair.substring(0, idx).trim();
+      const val = pair.substring(idx + 1).trim();
+      if (key) headers[key] = val;
+    }
+  }
+  return headers;
+}
+function resolveConfig(options = {}) {
+  const env = process.env;
+  const apiKey = options.apiKey || env.OBSERVANTIC_API_KEY || "";
+  const rawEndpoint = options.endpoint || env.OBSERVANTIC_ENDPOINT || env.OTEL_EXPORTER_OTLP_ENDPOINT || "https://api.observantic.com";
+  const { endpoint, tracesEndpoint, metricsEndpoint, logsEndpoint } = normalizeEndpoints(rawEndpoint);
+  const serviceName = options.serviceName || env.OBSERVANTIC_SERVICE_NAME || env.OTEL_SERVICE_NAME || env.npm_package_name || process.title || "node-service";
+  const environment = options.environment || env.OBSERVANTIC_ENVIRONMENT || env.NODE_ENV || "development";
+  const serviceVersion = options.serviceVersion || env.OBSERVANTIC_SERVICE_VERSION || env.npm_package_version || "1.0.0";
+  const disabled = options.disabled !== void 0 ? options.disabled : env.OBSERVANTIC_DISABLED === "true" || env.OTEL_SDK_DISABLED === "true";
+  const debug = options.debug !== void 0 ? options.debug : env.OBSERVANTIC_DEBUG === "true" || env.OTEL_LOG_LEVEL === "debug";
+  const autoShutdown = options.autoShutdown !== void 0 ? options.autoShutdown : true;
+  const traceSampleRate = options.traceSampleRate !== void 0 ? Math.max(0, Math.min(1, options.traceSampleRate)) : env.OBSERVANTIC_TRACE_SAMPLE_RATE ? parseFloat(env.OBSERVANTIC_TRACE_SAMPLE_RATE) : 1;
+  const envHeaders = parseOtelHeaders(env.OTEL_EXPORTER_OTLP_HEADERS);
+  const headers = {
+    ...envHeaders,
+    ...options.headers || {}
+  };
+  if (apiKey) {
+    headers["Authorization"] = `Bearer ${apiKey}`;
+    headers["x-cw-token"] = apiKey;
+  }
+  return {
+    apiKey,
+    endpoint,
+    tracesEndpoint,
+    metricsEndpoint,
+    logsEndpoint,
+    serviceName,
+    environment,
+    serviceVersion,
+    resourceAttributes: options.resourceAttributes || {},
+    headers,
+    disabled,
+    debug,
+    autoShutdown,
+    traceSampleRate,
+    batchTimeoutMillis: options.batchTimeoutMillis || 5e3,
+    maxQueueSize: options.maxQueueSize || 2048,
+    maxExportBatchSize: options.maxExportBatchSize || 512,
+    metricExportIntervalMillis: options.metricExportIntervalMillis || 6e4,
+    signals: {
+      traces: options.signals?.traces !== false,
+      metrics: options.signals?.metrics !== false,
+      logs: options.signals?.logs !== false
+    }
+  };
+}
+
+// src/resource.ts
+import { Resource } from "@opentelemetry/resources";
+import {
+  SEMRESATTRS_SERVICE_NAME,
+  SEMRESATTRS_SERVICE_VERSION,
+  SEMRESATTRS_DEPLOYMENT_ENVIRONMENT,
+  SEMRESATTRS_TELEMETRY_SDK_NAME,
+  SEMRESATTRS_TELEMETRY_SDK_LANGUAGE,
+  SEMRESATTRS_TELEMETRY_SDK_VERSION,
+  SEMRESATTRS_PROCESS_PID,
+  SEMRESATTRS_PROCESS_RUNTIME_NAME,
+  SEMRESATTRS_PROCESS_RUNTIME_VERSION
+} from "@opentelemetry/semantic-conventions";
+function createResource(config) {
+  const customAttributes = {
+    [SEMRESATTRS_SERVICE_NAME]: config.serviceName,
+    [SEMRESATTRS_SERVICE_VERSION]: config.serviceVersion,
+    [SEMRESATTRS_DEPLOYMENT_ENVIRONMENT]: config.environment,
+    [SEMRESATTRS_TELEMETRY_SDK_NAME]: "@observantic/sdk",
+    [SEMRESATTRS_TELEMETRY_SDK_LANGUAGE]: "nodejs",
+    [SEMRESATTRS_TELEMETRY_SDK_VERSION]: "1.0.0",
+    [SEMRESATTRS_PROCESS_PID]: process.pid,
+    [SEMRESATTRS_PROCESS_RUNTIME_NAME]: "nodejs",
+    [SEMRESATTRS_PROCESS_RUNTIME_VERSION]: process.version,
+    ...config.resourceAttributes
+  };
+  return new Resource(customAttributes);
+}
+
+// src/tracing.ts
+import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http";
+import {
+  BatchSpanProcessor,
+  ParentBasedSampler,
+  TraceIdRatioBasedSampler,
+  AlwaysOnSampler,
+  AlwaysOffSampler
+} from "@opentelemetry/sdk-trace-base";
+function createTraceExporter(config) {
+  return new OTLPTraceExporter({
+    url: config.tracesEndpoint,
+    headers: config.headers,
+    timeoutMillis: 1e4
+  });
+}
+function createSampler(sampleRate) {
+  if (sampleRate >= 1) {
+    return new ParentBasedSampler({ root: new AlwaysOnSampler() });
+  }
+  if (sampleRate <= 0) {
+    return new ParentBasedSampler({ root: new AlwaysOffSampler() });
+  }
+  return new ParentBasedSampler({
+    root: new TraceIdRatioBasedSampler(sampleRate)
+  });
+}
+function createSpanProcessor(exporter, config) {
+  return new BatchSpanProcessor(exporter, {
+    maxQueueSize: config.maxQueueSize,
+    maxExportBatchSize: config.maxExportBatchSize,
+    scheduledDelayMillis: config.batchTimeoutMillis,
+    exportTimeoutMillis: 1e4
+  });
+}
+
+// src/metrics.ts
+import { OTLPMetricExporter } from "@opentelemetry/exporter-metrics-otlp-http";
+import {
+  PeriodicExportingMetricReader,
+  AggregationTemporality
+} from "@opentelemetry/sdk-metrics";
+function createMetricExporter(config) {
+  return new OTLPMetricExporter({
+    url: config.metricsEndpoint,
+    headers: config.headers,
+    timeoutMillis: 1e4,
+    temporalityPreference: AggregationTemporality.DELTA
+  });
+}
+function createMetricReader(exporter, config) {
+  return new PeriodicExportingMetricReader({
+    exporter,
+    exportIntervalMillis: config.metricExportIntervalMillis,
+    exportTimeoutMillis: 1e4
+  });
+}
+
+// src/logging.ts
+import { OTLPLogExporter } from "@opentelemetry/exporter-logs-otlp-http";
+import { BatchLogRecordProcessor } from "@opentelemetry/sdk-logs";
+function createLogExporter(config) {
+  return new OTLPLogExporter({
+    url: config.logsEndpoint,
+    headers: config.headers,
+    timeoutMillis: 1e4
+  });
+}
+function createLogRecordProcessor(exporter, config) {
+  return new BatchLogRecordProcessor(exporter, {
+    maxQueueSize: config.maxQueueSize,
+    maxExportBatchSize: config.maxExportBatchSize,
+    scheduledDelayMillis: config.batchTimeoutMillis,
+    exportTimeoutMillis: 1e4
+  });
+}
+
+// src/instrumentation.ts
+import { getNodeAutoInstrumentations } from "@opentelemetry/auto-instrumentations-node";
+function createInstrumentations(_config) {
+  return [
+    getNodeAutoInstrumentations({
+      "@opentelemetry/instrumentation-fs": {
+        // Disable noisy fs hooks by default to prevent span flooding
+        enabled: false
+      },
+      "@opentelemetry/instrumentation-http": {
+        enabled: true
+      },
+      "@opentelemetry/instrumentation-express": {
+        enabled: true
+      }
+    })
+  ];
+}
+
+// src/shutdown.ts
+import { diag } from "@opentelemetry/api";
+var activeSdk = null;
+var isShuttingDown = false;
+var isSignalHandlerRegistered = false;
+function registerSdk(sdk) {
+  activeSdk = sdk;
+}
+async function shutdownObservantic() {
+  if (!activeSdk) {
+    return;
+  }
+  if (isShuttingDown) {
+    return;
+  }
+  isShuttingDown = true;
+  diag.info("Shutting down Observantic OpenTelemetry SDK...");
+  try {
+    await activeSdk.shutdown();
+    diag.info("Observantic OpenTelemetry SDK terminated successfully.");
+  } catch (err) {
+    diag.error("Error shutting down Observantic OpenTelemetry SDK", err);
+    throw err;
+  } finally {
+    activeSdk = null;
+    isShuttingDown = false;
+  }
+}
+function installShutdownHooks(sdk) {
+  registerSdk(sdk);
+  if (isSignalHandlerRegistered) {
+    return;
+  }
+  const handleSignal = async (signal) => {
+    diag.info(`Received ${signal}, gracefully shutting down Observantic telemetry...`);
+    try {
+      await shutdownObservantic();
+    } catch (err) {
+      diag.error(`Failed to flush telemetry on ${signal}:`, err);
+    }
+  };
+  process.once("SIGTERM", () => void handleSignal("SIGTERM"));
+  process.once("SIGINT", () => void handleSignal("SIGINT"));
+  isSignalHandlerRegistered = true;
+}
+
+// src/index.ts
+import { logs as logs2 } from "@opentelemetry/api-logs";
+var isInitialized = false;
+function initObservantic(options = {}) {
+  const config = resolveConfig(options);
+  if (config.debug) {
+    diag2.setLogger(new DiagConsoleLogger(), DiagLogLevel.DEBUG);
+  }
+  if (config.disabled) {
+    diag2.info("[@observantic/node] Telemetry is disabled via configuration.");
+    return {
+      sdk: null,
+      config,
+      shutdown: async () => {
+      },
+      getTracer: (name = "observantic", version = "1.0.0") => trace.getTracer(name, version),
+      getMeter: (name = "observantic", version = "1.0.0") => metrics.getMeter(name, version),
+      getLogger: (name = "observantic", version = "1.0.0") => logs.getLogger(name, version)
+    };
+  }
+  if (!config.apiKey) {
+    console.warn(
+      "[@observantic/node] Warning: No apiKey provided. Please provide an apiKey in initObservantic({ apiKey }) or set the OBSERVANTIC_API_KEY environment variable."
+    );
+  }
+  if (isInitialized) {
+    diag2.warn("[@observantic/node] initObservantic was called multiple times. Returning existing client.");
+    return {
+      sdk: null,
+      config,
+      shutdown: shutdownObservantic,
+      getTracer: (name = "observantic", version = "1.0.0") => trace.getTracer(name, version),
+      getMeter: (name = "observantic", version = "1.0.0") => metrics.getMeter(name, version),
+      getLogger: (name = "observantic", version = "1.0.0") => logs.getLogger(name, version)
+    };
+  }
+  const resource = createResource(config);
+  const sdkConfig = {
+    resource,
+    instrumentations: createInstrumentations(config)
+  };
+  if (config.signals.traces) {
+    const traceExporter = createTraceExporter(config);
+    const spanProcessor = createSpanProcessor(traceExporter, config);
+    const sampler = createSampler(config.traceSampleRate);
+    sdkConfig.spanProcessor = spanProcessor;
+    sdkConfig.sampler = sampler;
+  }
+  if (config.signals.metrics) {
+    const metricExporter = createMetricExporter(config);
+    const metricReader = createMetricReader(metricExporter, config);
+    sdkConfig.metricReader = metricReader;
+  }
+  if (config.signals.logs) {
+    const logExporter = createLogExporter(config);
+    const logRecordProcessor = createLogRecordProcessor(logExporter, config);
+    sdkConfig.logRecordProcessor = logRecordProcessor;
+  }
+  const sdk = new NodeSDK(sdkConfig);
+  try {
+    sdk.start();
+    isInitialized = true;
+    diag2.info(`[@observantic/node] Initialized successfully for service: "${config.serviceName}" [${config.environment}]`);
+    if (config.autoShutdown) {
+      installShutdownHooks(sdk);
+    } else {
+      registerSdk(sdk);
+    }
+  } catch (err) {
+    diag2.error("[@observantic/node] Failed to start OpenTelemetry NodeSDK:", err);
+    throw err;
+  }
+  return {
+    sdk,
+    config,
+    shutdown: shutdownObservantic,
+    getTracer: (name = config.serviceName, version = config.serviceVersion) => trace.getTracer(name, version),
+    getMeter: (name = config.serviceName, version = config.serviceVersion) => metrics.getMeter(name, version),
+    getLogger: (name = config.serviceName, version = config.serviceVersion) => logs.getLogger(name, version)
+  };
+}
+export {
+  SpanKind,
+  SpanStatusCode,
+  context,
+  initObservantic,
+  logs2 as logs,
+  metrics,
+  normalizeEndpoints,
+  resolveConfig,
+  shutdownObservantic,
+  trace
+};
+//# sourceMappingURL=index.js.map