@sebspark/otel 0.4.2 → 0.5.0

package/dist/index.d.mts

@@ -1,8 +1,9 @@
+import { LoggerProvider } from '@opentelemetry/api-logs';
 import * as _opentelemetry_api from '@opentelemetry/api';
 import { trace, SpanOptions } from '@opentelemetry/api';
 
 type Attrs = Record<string, any>;
-declare function getLogger(serviceOverride?: string, extraAttrs?: Attrs): {
+declare function getLogger(serviceOverride?: string, extraAttrs?: Attrs, testProvider?: LoggerProvider): {
     debug: (msg: string, attrs?: Attrs) => void;
     info: (msg: string, attrs?: Attrs) => void;
     notice: (msg: string, attrs?: Attrs) => void;
@@ -15,6 +16,8 @@ declare function getLogger(serviceOverride?: string, extraAttrs?: Attrs): {
 
 declare function getMeter(componentNameOverride?: string): Promise<_opentelemetry_api.Meter>;
 
+declare function initialize(): Promise<void>;
+
 type OtelTracer = ReturnType<typeof trace.getTracer>;
 type Span = ReturnType<OtelTracer['startSpan']>;
 type Func<T> = (span: Span) => Promise<T> | T;
@@ -47,4 +50,4 @@ interface Tracer extends OtelTracer {
  */
 declare function getTracer(componentNameOverride?: string): Promise<Tracer>;
 
-export { getLogger, getMeter, getTracer };
+export { getLogger, getMeter, getTracer, initialize };

package/dist/index.d.ts

@@ -1,8 +1,9 @@
+import { LoggerProvider } from '@opentelemetry/api-logs';
 import * as _opentelemetry_api from '@opentelemetry/api';
 import { trace, SpanOptions } from '@opentelemetry/api';
 
 type Attrs = Record<string, any>;
-declare function getLogger(serviceOverride?: string, extraAttrs?: Attrs): {
+declare function getLogger(serviceOverride?: string, extraAttrs?: Attrs, testProvider?: LoggerProvider): {
     debug: (msg: string, attrs?: Attrs) => void;
     info: (msg: string, attrs?: Attrs) => void;
     notice: (msg: string, attrs?: Attrs) => void;
@@ -15,6 +16,8 @@ declare function getLogger(serviceOverride?: string, extraAttrs?: Attrs): {
 
 declare function getMeter(componentNameOverride?: string): Promise<_opentelemetry_api.Meter>;
 
+declare function initialize(): Promise<void>;
+
 type OtelTracer = ReturnType<typeof trace.getTracer>;
 type Span = ReturnType<OtelTracer['startSpan']>;
 type Func<T> = (span: Span) => Promise<T> | T;
@@ -47,4 +50,4 @@ interface Tracer extends OtelTracer {
  */
 declare function getTracer(componentNameOverride?: string): Promise<Tracer>;
 
-export { getLogger, getMeter, getTracer };
+export { getLogger, getMeter, getTracer, initialize };

package/dist/index.js

@@ -32,10 +32,30 @@ var index_exports = {};
 __export(index_exports, {
   getLogger: () => getLogger,
   getMeter: () => getMeter,
-  getTracer: () => getTracer
+  getTracer: () => getTracer,
+  initialize: () => initialize
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/logger.ts
+var import_api4 = require("@opentelemetry/api");
+var import_api_logs2 = require("@opentelemetry/api-logs");
+
+// src/consts.ts
+var LOG_SEVERITY_MAP = {
+  TRACE: 1,
+  DEBUG: 5,
+  INFO: 9,
+  NOTICE: 10,
+  WARNING: 13,
+  WARN: 13,
+  ERROR: 17,
+  FATAL: 21,
+  CRITICAL: 21,
+  ALERT: 22,
+  EMERGENCY: 23
+};
+
 // src/otel.ts
 var import_api3 = require("@opentelemetry/api");
 var import_api_logs = require("@opentelemetry/api-logs");
@@ -53,21 +73,6 @@ var import_sdk_trace_node = require("@opentelemetry/sdk-trace-node");
 // src/loggers/console-log-pretty-exporter.ts
 var import_core = require("@opentelemetry/core");
 
-// src/consts.ts
-var LOG_SEVERITY_MAP = {
-  TRACE: 1,
-  DEBUG: 5,
-  INFO: 9,
-  NOTICE: 10,
-  WARNING: 13,
-  WARN: 13,
-  ERROR: 17,
-  FATAL: 21,
-  CRITICAL: 21,
-  ALERT: 22,
-  EMERGENCY: 23
-};
-
 // src/loggers/formatters/shared.ts
 var import_semantic_conventions = require("@opentelemetry/semantic-conventions");
 var import_fast_safe_stringify = __toESM(require("fast-safe-stringify"));
@@ -637,21 +642,29 @@ var getResource = async () => {
 };
 
 // src/otel.ts
-import_api3.diag.setLogger(new import_api3.DiagConsoleLogger(), import_api3.DiagLogLevel.ERROR);
 var initialization;
 async function initialize() {
   if (!initialization) {
-    initialization = _initialize();
+    import_api3.diag.setLogger(new import_api3.DiagConsoleLogger(), import_api3.DiagLogLevel.ERROR);
+    initialization = initializeOtel();
   }
   return initialization;
 }
-async function _initialize() {
+function isInitialized() {
+  return initialization !== void 0;
+}
+async function initializeOtel() {
   try {
     const serviceName = process.env.OTEL_SERVICE_NAME ?? "unknown-service";
     const otlpEndpoint = process.env.OTEL_EXPORTER_OTLP_ENDPOINT;
+    const isTestMode = process.env.NODE_ENV === "test" || process.env.VITEST === "true";
     const resource = await getResource();
-    const logProvider = getLogProvider(resource, otlpEndpoint);
-    import_api_logs.logs.setGlobalLoggerProvider(logProvider);
+    let logProvider;
+    const shouldSetupLogProvider = !isTestMode || !!process.env.LOG_LEVEL;
+    if (shouldSetupLogProvider) {
+      logProvider = getLogProvider(resource, otlpEndpoint);
+      import_api_logs.logs.setGlobalLoggerProvider(logProvider);
+    }
     const spanProcessor = getSpanProcessor(otlpEndpoint);
     const metricReader = getMetricReader(otlpEndpoint);
     const sdk = new import_sdk_node.NodeSDK({
@@ -664,34 +677,37 @@ async function _initialize() {
     console.log(`[otel] Telemetry initialized for "${serviceName}"`);
     process.on("SIGTERM", async () => {
       console.log("[otel] Shutting down...");
-      await Promise.all([sdk.shutdown(), logProvider.shutdown()]);
+      const shutdownPromises = [sdk.shutdown()];
+      if (logProvider) {
+        shutdownPromises.push(logProvider.shutdown());
+      }
+      await Promise.all(shutdownPromises);
       console.log("[otel] Shutdown complete.");
       process.exit(0);
     });
   } catch (err) {
-    console.error("[otel] Startup error:", err);
+    if (err instanceof Error && err.message.includes("duplicate registration")) {
+      console.warn("[otel] Warning - API already registered, continuing...");
+    } else {
+      console.error("[otel] Startup error:", err);
+    }
   }
 }
 
 // src/logger.ts
-var import_api4 = require("@opentelemetry/api");
-var import_api_logs2 = require("@opentelemetry/api-logs");
-function getLogger(serviceOverride, extraAttrs = {}) {
+function getLogger(serviceOverride, extraAttrs = {}, testProvider) {
+  if (!isInitialized()) {
+    throw new Error(
+      "OpenTelemetry is not initialized. Please call initialize() before getting a logger."
+    );
+  }
   const { systemName, systemVersion, resourceAttributes } = detectTelemetryContext(serviceOverride);
   const defaultAttrs = {
     ...resourceAttributes,
     ...extraAttrs
   };
-  let isInitialized = false;
   function emit(severityText, body, attrs = {}) {
-    if (!isInitialized) {
-      initialize().then(() => {
-        isInitialized = true;
-        emit(severityText, body, attrs);
-      });
-      return;
-    }
-    const logger = import_api_logs2.logs.getLogger(systemName, systemVersion);
+    const logger = testProvider ? testProvider.getLogger(systemName, systemVersion) : import_api_logs2.logs.getLogger(systemName, systemVersion);
     const span = import_api4.trace.getSpan(import_api4.context.active());
     const spanContext = span?.spanContext();
     logger.emit({
@@ -826,12 +842,10 @@ function extractArgs(spanOptionsSpanOrFunc, spanOrFunc, func) {
 var isFunction = (value) => typeof value === "function";
 var isSpan = (value) => value !== null && value !== void 0 && isFunction(value.spanContext) && isFunction(value.end);
 var isSpanOptions = (value) => value !== null && value !== void 0 && (!!value.startTime || !!value.attributes || !!value.kind) && !isSpan(value);
-
-// src/index.ts
-initialize();
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   getLogger,
   getMeter,
-  getTracer
+  getTracer,
+  initialize
 });

package/dist/index.mjs

@@ -1,3 +1,22 @@
+// src/logger.ts
+import { context, trace } from "@opentelemetry/api";
+import { logs as logs2 } from "@opentelemetry/api-logs";
+
+// src/consts.ts
+var LOG_SEVERITY_MAP = {
+  TRACE: 1,
+  DEBUG: 5,
+  INFO: 9,
+  NOTICE: 10,
+  WARNING: 13,
+  WARN: 13,
+  ERROR: 17,
+  FATAL: 21,
+  CRITICAL: 21,
+  ALERT: 22,
+  EMERGENCY: 23
+};
+
 // src/otel.ts
 import { DiagConsoleLogger, DiagLogLevel, diag } from "@opentelemetry/api";
 import { logs } from "@opentelemetry/api-logs";
@@ -21,21 +40,6 @@ import {
 // src/loggers/console-log-pretty-exporter.ts
 import { ExportResultCode } from "@opentelemetry/core";
 
-// src/consts.ts
-var LOG_SEVERITY_MAP = {
-  TRACE: 1,
-  DEBUG: 5,
-  INFO: 9,
-  NOTICE: 10,
-  WARNING: 13,
-  WARN: 13,
-  ERROR: 17,
-  FATAL: 21,
-  CRITICAL: 21,
-  ALERT: 22,
-  EMERGENCY: 23
-};
-
 // src/loggers/formatters/shared.ts
 import {
   ATTR_SERVICE_NAME,
@@ -614,21 +618,29 @@ var getResource = async () => {
 };
 
 // src/otel.ts
-diag.setLogger(new DiagConsoleLogger(), DiagLogLevel.ERROR);
 var initialization;
 async function initialize() {
   if (!initialization) {
-    initialization = _initialize();
+    diag.setLogger(new DiagConsoleLogger(), DiagLogLevel.ERROR);
+    initialization = initializeOtel();
   }
   return initialization;
 }
-async function _initialize() {
+function isInitialized() {
+  return initialization !== void 0;
+}
+async function initializeOtel() {
   try {
     const serviceName = process.env.OTEL_SERVICE_NAME ?? "unknown-service";
     const otlpEndpoint = process.env.OTEL_EXPORTER_OTLP_ENDPOINT;
+    const isTestMode = process.env.NODE_ENV === "test" || process.env.VITEST === "true";
     const resource = await getResource();
-    const logProvider = getLogProvider(resource, otlpEndpoint);
-    logs.setGlobalLoggerProvider(logProvider);
+    let logProvider;
+    const shouldSetupLogProvider = !isTestMode || !!process.env.LOG_LEVEL;
+    if (shouldSetupLogProvider) {
+      logProvider = getLogProvider(resource, otlpEndpoint);
+      logs.setGlobalLoggerProvider(logProvider);
+    }
     const spanProcessor = getSpanProcessor(otlpEndpoint);
     const metricReader = getMetricReader(otlpEndpoint);
     const sdk = new NodeSDK({
@@ -641,34 +653,37 @@ async function _initialize() {
     console.log(`[otel] Telemetry initialized for "${serviceName}"`);
     process.on("SIGTERM", async () => {
       console.log("[otel] Shutting down...");
-      await Promise.all([sdk.shutdown(), logProvider.shutdown()]);
+      const shutdownPromises = [sdk.shutdown()];
+      if (logProvider) {
+        shutdownPromises.push(logProvider.shutdown());
+      }
+      await Promise.all(shutdownPromises);
       console.log("[otel] Shutdown complete.");
       process.exit(0);
     });
   } catch (err) {
-    console.error("[otel] Startup error:", err);
+    if (err instanceof Error && err.message.includes("duplicate registration")) {
+      console.warn("[otel] Warning - API already registered, continuing...");
+    } else {
+      console.error("[otel] Startup error:", err);
+    }
   }
 }
 
 // src/logger.ts
-import { context, trace } from "@opentelemetry/api";
-import { logs as logs2 } from "@opentelemetry/api-logs";
-function getLogger(serviceOverride, extraAttrs = {}) {
+function getLogger(serviceOverride, extraAttrs = {}, testProvider) {
+  if (!isInitialized()) {
+    throw new Error(
+      "OpenTelemetry is not initialized. Please call initialize() before getting a logger."
+    );
+  }
   const { systemName, systemVersion, resourceAttributes } = detectTelemetryContext(serviceOverride);
   const defaultAttrs = {
     ...resourceAttributes,
     ...extraAttrs
   };
-  let isInitialized = false;
   function emit(severityText, body, attrs = {}) {
-    if (!isInitialized) {
-      initialize().then(() => {
-        isInitialized = true;
-        emit(severityText, body, attrs);
-      });
-      return;
-    }
-    const logger = logs2.getLogger(systemName, systemVersion);
+    const logger = testProvider ? testProvider.getLogger(systemName, systemVersion) : logs2.getLogger(systemName, systemVersion);
     const span = trace.getSpan(context.active());
     const spanContext = span?.spanContext();
     logger.emit({
@@ -807,11 +822,9 @@ function extractArgs(spanOptionsSpanOrFunc, spanOrFunc, func) {
 var isFunction = (value) => typeof value === "function";
 var isSpan = (value) => value !== null && value !== void 0 && isFunction(value.spanContext) && isFunction(value.end);
 var isSpanOptions = (value) => value !== null && value !== void 0 && (!!value.startTime || !!value.attributes || !!value.kind) && !isSpan(value);
-
-// src/index.ts
-initialize();
 export {
   getLogger,
   getMeter,
-  getTracer
+  getTracer,
+  initialize
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sebspark/otel",
-  "version": "0.4.2",
+  "version": "0.5.0",
   "license": "Apache-2.0",
   "main": "dist/index.js",
   "module": "dist/index.mjs",