@moduna/otel 1.1.1 → 1.1.2

package/dist/interface/ModunaOTELConfig.d.ts

@@ -15,6 +15,10 @@ interface ModunaOTELBaseConfig {
      * Additional OTLP headers sent with telemetry exports.
      */
     headers?: Record<string, string>;
+    /**
+     * Automatically flushes and shuts down telemetry when the Node.js process exits.
+     */
+    autoShutdown?: boolean;
 }
 /**
  * Configuration options for a ModunaOTEL instance.

package/dist/services/ModunaOTEL.d.ts

@@ -43,6 +43,10 @@ export declare class ModunaOTEL {
      * Shuts down the singleton OpenTelemetry SDK.
      */
     shutdown(): Promise<void>;
+    /**
+     * Shuts down the singleton OpenTelemetry SDK and suppresses telemetry failures.
+     */
+    private shutdownSafely;
     /**
      * Creates telemetry settings for one Vercel AI SDK generateText or streamText call.
      *
@@ -82,6 +86,7 @@ export declare class ModunaOTEL {
      */
     instrument<T>(spanName: string, context: ModunaTraceContext, callback: TraceCallback<T>): Promise<T>;
     private normalizeConfig;
+    private registerLifecycleHooks;
     private createSDK;
     private startSafely;
     private createTraceMetadata;

package/dist/services/ModunaOTEL.js

@@ -51,6 +51,7 @@ class SilentOTLPTraceExporter extends OTLPTraceExporter {
  */
 export class ModunaOTEL {
     static shared = {
+        lifecycleHooksRegistered: false,
         started: false,
         warned: false,
     };
@@ -64,6 +65,7 @@ export class ModunaOTEL {
         const normalizedConfig = this.normalizeConfig(config);
         this.framework = normalizedConfig.framework;
         ModunaOTEL.shared.sdk ??= this.createSDK(normalizedConfig);
+        this.registerLifecycleHooks(normalizedConfig);
         void this.start();
     }
     /**
@@ -91,6 +93,15 @@ export class ModunaOTEL {
      * Shuts down the singleton OpenTelemetry SDK.
      */
     async shutdown() {
+        ModunaOTEL.shared.shutdownPromise ??= this.shutdownSafely().finally(() => {
+            ModunaOTEL.shared.shutdownPromise = undefined;
+        });
+        await ModunaOTEL.shared.shutdownPromise;
+    }
+    /**
+     * Shuts down the singleton OpenTelemetry SDK and suppresses telemetry failures.
+     */
+    async shutdownSafely() {
         const sdk = ModunaOTEL.shared.sdk;
         if (!ModunaOTEL.shared.started || !sdk) {
             return;
@@ -165,11 +176,32 @@ export class ModunaOTEL {
     normalizeConfig(config) {
         return {
             agentName: config.agentName,
+            autoShutdown: config.autoShutdown ?? true,
             apiKey: config.apiKey ?? process.env.MODUNA_API_KEY,
             framework: config.framework ?? config.sdkIntegration,
             headers: config.headers,
         };
     }
+    registerLifecycleHooks(config) {
+        if (!config.autoShutdown ||
+            ModunaOTEL.shared.lifecycleHooksRegistered) {
+            return;
+        }
+        process.once("beforeExit", () => {
+            void this.shutdown();
+        });
+        process.once("SIGINT", () => {
+            void this.shutdown().finally(() => {
+                process.exit(130);
+            });
+        });
+        process.once("SIGTERM", () => {
+            void this.shutdown().finally(() => {
+                process.exit(143);
+            });
+        });
+        ModunaOTEL.shared.lifecycleHooksRegistered = true;
+    }
     createSDK(config) {
         return new NodeSDK({
             resource: resourceFromAttributes({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moduna/otel",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "private": false,
   "description": "One-line OpenTelemetry setup for Moduna AI traces.",
   "license": "MIT",