@dexto/core 1.8.3 → 1.8.5

package/dist/telemetry/browser.js

@@ -0,0 +1,115 @@
+import "../chunk-C6A6W6XS.js";
+import { context as otlpContext, propagation, trace } from "@opentelemetry/api";
+function isGlobalTelemetryLike(value) {
+  if (typeof value !== "object" || value === null) {
+    return false;
+  }
+  return typeof Reflect.get(value, "forceFlush") === "function" && typeof Reflect.get(value, "isInitialized") === "function" && typeof Reflect.get(value, "name") === "string" && typeof Reflect.get(value, "shutdown") === "function" && Reflect.get(value, "tracer") !== void 0;
+}
+class Telemetry {
+  tracer;
+  name;
+  _isInitialized;
+  _shutdownHandler;
+  static _initPromise;
+  constructor(config, options) {
+    const serviceName = config.serviceName ?? "dexto-service";
+    const tracerName = config.tracerName ?? serviceName;
+    this.name = serviceName;
+    this.tracer = trace.getTracer(tracerName);
+    this._shutdownHandler = options.shutdown;
+    this._isInitialized = options.initialized;
+  }
+  static async registerGlobal(options = {}) {
+    const existing = Telemetry.getGlobalInstance();
+    if (existing !== void 0) {
+      return existing;
+    }
+    if (Telemetry._initPromise !== void 0) {
+      return Telemetry._initPromise;
+    }
+    Telemetry._initPromise = Promise.resolve().then(() => {
+      const current = Telemetry.getGlobalInstance();
+      if (current !== void 0) {
+        return current;
+      }
+      const telemetry = new Telemetry(options.config ?? {}, {
+        initialized: options.initialized ?? true,
+        ...options.shutdown !== void 0 && { shutdown: options.shutdown }
+      });
+      Telemetry.setGlobalInstance(telemetry);
+      return telemetry;
+    });
+    return Telemetry._initPromise;
+  }
+  static getActiveSpan() {
+    return trace.getActiveSpan();
+  }
+  static get() {
+    const telemetry = Telemetry.getGlobalInstance();
+    if (telemetry === void 0) {
+      throw new Error("Telemetry not initialized. Call Telemetry.registerGlobal() first.");
+    }
+    return telemetry;
+  }
+  static hasGlobalInstance() {
+    return Telemetry.getGlobalInstance() !== void 0;
+  }
+  static async shutdownGlobal() {
+    const telemetry = Telemetry.getGlobalInstance();
+    if (telemetry !== void 0) {
+      await telemetry.shutdown();
+    }
+    Telemetry.setGlobalInstance(void 0);
+    Telemetry._initPromise = void 0;
+  }
+  static setBaggage(baggage, ctx = otlpContext.active()) {
+    const currentBaggage = Object.fromEntries(
+      propagation.getBaggage(ctx)?.getAllEntries() ?? []
+    );
+    return propagation.setBaggage(
+      ctx,
+      propagation.createBaggage({
+        ...currentBaggage,
+        ...baggage
+      })
+    );
+  }
+  static withContext(ctx, fn) {
+    return otlpContext.with(ctx, fn);
+  }
+  isInitialized() {
+    return this._isInitialized;
+  }
+  async forceFlush() {
+    const provider = trace.getTracerProvider();
+    const forceFlush = Reflect.get(provider, "forceFlush");
+    if (typeof forceFlush === "function") {
+      await Reflect.apply(forceFlush, provider, []);
+    }
+  }
+  async shutdown() {
+    try {
+      await this._shutdownHandler?.();
+    } finally {
+      this._isInitialized = false;
+      this._shutdownHandler = void 0;
+      Telemetry.setGlobalInstance(void 0);
+      Telemetry._initPromise = void 0;
+    }
+  }
+  static getGlobalInstance() {
+    const telemetry = Reflect.get(globalThis, "__TELEMETRY__");
+    return isGlobalTelemetryLike(telemetry) ? telemetry : void 0;
+  }
+  static setGlobalInstance(telemetry) {
+    if (telemetry === void 0) {
+      Reflect.deleteProperty(globalThis, "__TELEMETRY__");
+      return;
+    }
+    Reflect.set(globalThis, "__TELEMETRY__", telemetry);
+  }
+}
+export {
+  Telemetry
+};

package/dist/telemetry/decorators.cjs

@@ -49,11 +49,7 @@ function withSpan(options) {
       if (spanKind !== void 0) {
         spanOptions.kind = spanKind;
       }
-      const span = tracer.startSpan(spanName, spanOptions);
-      let ctx = import_api.trace.setSpan(import_api.context.active(), span);
-      args.forEach((arg, index) => {
-        span.setAttribute(`${spanName}.argument.${index}`, (0, import_safe_stringify.safeStringify)(arg, 8192));
-      });
+      let ctx = import_api.context.active();
       const {
         requestId,
         componentName,
@@ -63,47 +59,52 @@ function withSpan(options) {
         sessionId,
         hostRuntime
       } = (0, import_utils.getBaggageValues)(ctx);
-      if (sessionId) {
-        span.setAttribute("sessionId", sessionId);
-        span.setAttribute("baggage.sessionId", sessionId);
-      }
-      if (requestId) {
-        span.setAttribute("http.request_id", requestId);
-        span.setAttribute("baggage.http.request_id", requestId);
-      }
-      if (threadId) {
-        span.setAttribute("threadId", threadId);
-        span.setAttribute("baggage.threadId", threadId);
-      }
-      if (resourceId) {
-        span.setAttribute("resourceId", resourceId);
-        span.setAttribute("baggage.resourceId", resourceId);
-      }
-      if (runId !== void 0) {
-        span.setAttribute("runId", String(runId));
-        span.setAttribute("baggage.runId", String(runId));
-      }
-      for (const [key, value] of Object.entries((0, import_runtime.getHostRuntimeAttributes)(hostRuntime))) {
-        span.setAttribute(key, value);
-      }
       const inferredComponentName = options?.componentName;
       const effectiveHostRuntime = hostRuntime;
       const effectiveRunId = effectiveHostRuntime?.ids?.runId ?? runId;
-      if (componentName) {
-        span.setAttribute("componentName", componentName);
-        span.setAttribute("baggage.componentName", componentName);
-      } else if (inferredComponentName) {
-        span.setAttribute("componentName", inferredComponentName);
-      }
-      if (effectiveRunId !== void 0) {
-        span.setAttribute("runId", String(effectiveRunId));
-        span.setAttribute("baggage.runId", String(effectiveRunId));
-      }
-      for (const [key, value] of Object.entries(
-        (0, import_runtime.getHostRuntimeAttributes)(effectiveHostRuntime)
-      )) {
-        span.setAttribute(key, value);
-      }
+      const applySpanAttributes = (span) => {
+        args.forEach((arg, index) => {
+          span.setAttribute(`${spanName}.argument.${index}`, (0, import_safe_stringify.safeStringify)(arg, 8192));
+        });
+        if (sessionId) {
+          span.setAttribute("sessionId", sessionId);
+          span.setAttribute("baggage.sessionId", sessionId);
+        }
+        if (requestId) {
+          span.setAttribute("http.request_id", requestId);
+          span.setAttribute("baggage.http.request_id", requestId);
+        }
+        if (threadId) {
+          span.setAttribute("threadId", threadId);
+          span.setAttribute("baggage.threadId", threadId);
+        }
+        if (resourceId) {
+          span.setAttribute("resourceId", resourceId);
+          span.setAttribute("baggage.resourceId", resourceId);
+        }
+        if (runId !== void 0) {
+          span.setAttribute("runId", String(runId));
+          span.setAttribute("baggage.runId", String(runId));
+        }
+        for (const [key, value] of Object.entries((0, import_runtime.getHostRuntimeAttributes)(hostRuntime))) {
+          span.setAttribute(key, value);
+        }
+        if (componentName) {
+          span.setAttribute("componentName", componentName);
+          span.setAttribute("baggage.componentName", componentName);
+        } else if (inferredComponentName) {
+          span.setAttribute("componentName", inferredComponentName);
+        }
+        if (effectiveRunId !== void 0) {
+          span.setAttribute("runId", String(effectiveRunId));
+          span.setAttribute("baggage.runId", String(effectiveRunId));
+        }
+        for (const [key, value] of Object.entries(
+          (0, import_runtime.getHostRuntimeAttributes)(effectiveHostRuntime)
+        )) {
+          span.setAttribute(key, value);
+        }
+      };
       const existingBaggage = import_api.propagation.getBaggage(ctx);
       const baggageEntries = {};
       if (existingBaggage) {
@@ -151,48 +152,51 @@ function withSpan(options) {
       if (Object.keys(baggageEntries).length > 0) {
         ctx = import_api.propagation.setBaggage(ctx, import_api.propagation.createBaggage(baggageEntries));
       }
-      let result;
-      try {
-        result = import_api.context.with(ctx, () => originalMethod.apply(this, args));
-        if (result instanceof Promise) {
-          return result.then((resolvedValue) => {
-            span.setAttribute(
-              `${spanName}.result`,
-              (0, import_safe_stringify.safeStringify)(resolvedValue, 8192)
-            );
-            return resolvedValue;
-          }).catch((error) => {
-            span.recordException(error);
-            span.setStatus({
-              code: import_api.SpanStatusCode.ERROR,
-              message: error?.toString()
+      return tracer.startActiveSpan(spanName, spanOptions, ctx, (span) => {
+        applySpanAttributes(span);
+        let result;
+        try {
+          result = originalMethod.apply(this, args);
+          if (result instanceof Promise) {
+            return result.then((resolvedValue) => {
+              span.setAttribute(
+                `${spanName}.result`,
+                (0, import_safe_stringify.safeStringify)(resolvedValue, 8192)
+              );
+              return resolvedValue;
+            }).catch((error) => {
+              span.recordException(error);
+              span.setStatus({
+                code: import_api.SpanStatusCode.ERROR,
+                message: error?.toString()
+              });
+              throw error;
+            }).finally(() => {
+              span.end();
             });
-            throw error;
-          }).finally(() => {
-            span.end();
+          }
+          span.setAttribute(`${spanName}.result`, (0, import_safe_stringify.safeStringify)(result, 8192));
+          return result;
+        } catch (error) {
+          const logger2 = this?.logger;
+          logger2?.error(
+            `withSpan: Error in method '${methodName}': ${error instanceof Error ? error.message : String(error)}`,
+            { error }
+          );
+          span.setStatus({
+            code: import_api.SpanStatusCode.ERROR,
+            message: error instanceof Error ? error.message : "Unknown error"
           });
+          if (error instanceof Error) {
+            span.recordException(error);
+          }
+          throw error;
+        } finally {
+          if (!(result instanceof Promise)) {
+            span.end();
+          }
         }
-        span.setAttribute(`${spanName}.result`, (0, import_safe_stringify.safeStringify)(result, 8192));
-        return result;
-      } catch (error) {
-        const logger2 = this?.logger;
-        logger2?.error(
-          `withSpan: Error in method '${methodName}': ${error instanceof Error ? error.message : String(error)}`,
-          { error }
-        );
-        span.setStatus({
-          code: import_api.SpanStatusCode.ERROR,
-          message: error instanceof Error ? error.message : "Unknown error"
-        });
-        if (error instanceof Error) {
-          span.recordException(error);
-        }
-        throw error;
-      } finally {
-        if (!(result instanceof Promise)) {
-          span.end();
-        }
-      }
+      });
     };
     return descriptor;
   };

package/dist/telemetry/decorators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/telemetry/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,EAIH,QAAQ,EAIX,MAAM,oBAAoB,CAAC;AAO5B,wBAAgB,QAAQ,CAAC,OAAO,EAAE;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,GAAG,CAgON;AAGD,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB,IACoB,CAAC,SAAS;IAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAA;CAAE,EAAE,QAAQ,CAAC,OA6BrE"}
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/telemetry/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,EAIH,QAAQ,EAKX,MAAM,oBAAoB,CAAC;AAO5B,wBAAgB,QAAQ,CAAC,OAAO,EAAE;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,GAAG,CAmON;AAGD,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB,IACoB,CAAC,SAAS;IAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAA;CAAE,EAAE,QAAQ,CAAC,OA6BrE"}

package/dist/telemetry/decorators.js

@@ -32,11 +32,7 @@ function withSpan(options) {
       if (spanKind !== void 0) {
         spanOptions.kind = spanKind;
       }
-      const span = tracer.startSpan(spanName, spanOptions);
-      let ctx = trace.setSpan(context.active(), span);
-      args.forEach((arg, index) => {
-        span.setAttribute(`${spanName}.argument.${index}`, safeStringify(arg, 8192));
-      });
+      let ctx = context.active();
       const {
         requestId,
         componentName,
@@ -46,47 +42,52 @@ function withSpan(options) {
         sessionId,
         hostRuntime
       } = getBaggageValues(ctx);
-      if (sessionId) {
-        span.setAttribute("sessionId", sessionId);
-        span.setAttribute("baggage.sessionId", sessionId);
-      }
-      if (requestId) {
-        span.setAttribute("http.request_id", requestId);
-        span.setAttribute("baggage.http.request_id", requestId);
-      }
-      if (threadId) {
-        span.setAttribute("threadId", threadId);
-        span.setAttribute("baggage.threadId", threadId);
-      }
-      if (resourceId) {
-        span.setAttribute("resourceId", resourceId);
-        span.setAttribute("baggage.resourceId", resourceId);
-      }
-      if (runId !== void 0) {
-        span.setAttribute("runId", String(runId));
-        span.setAttribute("baggage.runId", String(runId));
-      }
-      for (const [key, value] of Object.entries(getHostRuntimeAttributes(hostRuntime))) {
-        span.setAttribute(key, value);
-      }
       const inferredComponentName = options?.componentName;
       const effectiveHostRuntime = hostRuntime;
       const effectiveRunId = effectiveHostRuntime?.ids?.runId ?? runId;
-      if (componentName) {
-        span.setAttribute("componentName", componentName);
-        span.setAttribute("baggage.componentName", componentName);
-      } else if (inferredComponentName) {
-        span.setAttribute("componentName", inferredComponentName);
-      }
-      if (effectiveRunId !== void 0) {
-        span.setAttribute("runId", String(effectiveRunId));
-        span.setAttribute("baggage.runId", String(effectiveRunId));
-      }
-      for (const [key, value] of Object.entries(
-        getHostRuntimeAttributes(effectiveHostRuntime)
-      )) {
-        span.setAttribute(key, value);
-      }
+      const applySpanAttributes = (span) => {
+        args.forEach((arg, index) => {
+          span.setAttribute(`${spanName}.argument.${index}`, safeStringify(arg, 8192));
+        });
+        if (sessionId) {
+          span.setAttribute("sessionId", sessionId);
+          span.setAttribute("baggage.sessionId", sessionId);
+        }
+        if (requestId) {
+          span.setAttribute("http.request_id", requestId);
+          span.setAttribute("baggage.http.request_id", requestId);
+        }
+        if (threadId) {
+          span.setAttribute("threadId", threadId);
+          span.setAttribute("baggage.threadId", threadId);
+        }
+        if (resourceId) {
+          span.setAttribute("resourceId", resourceId);
+          span.setAttribute("baggage.resourceId", resourceId);
+        }
+        if (runId !== void 0) {
+          span.setAttribute("runId", String(runId));
+          span.setAttribute("baggage.runId", String(runId));
+        }
+        for (const [key, value] of Object.entries(getHostRuntimeAttributes(hostRuntime))) {
+          span.setAttribute(key, value);
+        }
+        if (componentName) {
+          span.setAttribute("componentName", componentName);
+          span.setAttribute("baggage.componentName", componentName);
+        } else if (inferredComponentName) {
+          span.setAttribute("componentName", inferredComponentName);
+        }
+        if (effectiveRunId !== void 0) {
+          span.setAttribute("runId", String(effectiveRunId));
+          span.setAttribute("baggage.runId", String(effectiveRunId));
+        }
+        for (const [key, value] of Object.entries(
+          getHostRuntimeAttributes(effectiveHostRuntime)
+        )) {
+          span.setAttribute(key, value);
+        }
+      };
       const existingBaggage = propagation.getBaggage(ctx);
       const baggageEntries = {};
       if (existingBaggage) {
@@ -134,48 +135,51 @@ function withSpan(options) {
       if (Object.keys(baggageEntries).length > 0) {
         ctx = propagation.setBaggage(ctx, propagation.createBaggage(baggageEntries));
       }
-      let result;
-      try {
-        result = context.with(ctx, () => originalMethod.apply(this, args));
-        if (result instanceof Promise) {
-          return result.then((resolvedValue) => {
-            span.setAttribute(
-              `${spanName}.result`,
-              safeStringify(resolvedValue, 8192)
-            );
-            return resolvedValue;
-          }).catch((error) => {
-            span.recordException(error);
-            span.setStatus({
-              code: SpanStatusCode.ERROR,
-              message: error?.toString()
+      return tracer.startActiveSpan(spanName, spanOptions, ctx, (span) => {
+        applySpanAttributes(span);
+        let result;
+        try {
+          result = originalMethod.apply(this, args);
+          if (result instanceof Promise) {
+            return result.then((resolvedValue) => {
+              span.setAttribute(
+                `${spanName}.result`,
+                safeStringify(resolvedValue, 8192)
+              );
+              return resolvedValue;
+            }).catch((error) => {
+              span.recordException(error);
+              span.setStatus({
+                code: SpanStatusCode.ERROR,
+                message: error?.toString()
+              });
+              throw error;
+            }).finally(() => {
+              span.end();
             });
-            throw error;
-          }).finally(() => {
-            span.end();
+          }
+          span.setAttribute(`${spanName}.result`, safeStringify(result, 8192));
+          return result;
+        } catch (error) {
+          const logger2 = this?.logger;
+          logger2?.error(
+            `withSpan: Error in method '${methodName}': ${error instanceof Error ? error.message : String(error)}`,
+            { error }
+          );
+          span.setStatus({
+            code: SpanStatusCode.ERROR,
+            message: error instanceof Error ? error.message : "Unknown error"
           });
+          if (error instanceof Error) {
+            span.recordException(error);
+          }
+          throw error;
+        } finally {
+          if (!(result instanceof Promise)) {
+            span.end();
+          }
         }
-        span.setAttribute(`${spanName}.result`, safeStringify(result, 8192));
-        return result;
-      } catch (error) {
-        const logger2 = this?.logger;
-        logger2?.error(
-          `withSpan: Error in method '${methodName}': ${error instanceof Error ? error.message : String(error)}`,
-          { error }
-        );
-        span.setStatus({
-          code: SpanStatusCode.ERROR,
-          message: error instanceof Error ? error.message : "Unknown error"
-        });
-        if (error instanceof Error) {
-          span.recordException(error);
-        }
-        throw error;
-      } finally {
-        if (!(result instanceof Promise)) {
-          span.end();
-        }
-      }
+      });
     };
     return descriptor;
   };

package/dist/telemetry/index.cjs

@@ -19,13 +19,16 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var telemetry_exports = {};
 __export(telemetry_exports, {
   OtelConfigurationSchema: () => import_schemas.OtelConfigurationSchema,
-  Telemetry: () => import_telemetry.Telemetry
+  Telemetry: () => import_telemetry.Telemetry,
+  recordOperationSpan: () => import_operation_span.recordOperationSpan
 });
 module.exports = __toCommonJS(telemetry_exports);
 var import_telemetry = require("./telemetry.js");
 var import_schemas = require("./schemas.js");
+var import_operation_span = require("./operation-span.js");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   OtelConfigurationSchema,
-  Telemetry
+  Telemetry,
+  recordOperationSpan
 });

package/dist/telemetry/index.d.ts

@@ -1,4 +1,5 @@
 export { Telemetry, type TelemetryRegistrationOptions, type TelemetryShutdownHandler, } from './telemetry.js';
 export { OtelConfigurationSchema } from './schemas.js';
 export type { OtelConfiguration } from './schemas.js';
+export { recordOperationSpan, type OperationSpanOptions } from './operation-span.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/telemetry/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,SAAS,EACT,KAAK,4BAA4B,EACjC,KAAK,wBAAwB,GAChC,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,SAAS,EACT,KAAK,4BAA4B,EACjC,KAAK,wBAAwB,GAChC,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/telemetry/index.js

@@ -3,7 +3,9 @@ import {
   Telemetry
 } from "./telemetry.js";
 import { OtelConfigurationSchema } from "./schemas.js";
+import { recordOperationSpan } from "./operation-span.js";
 export {
   OtelConfigurationSchema,
-  Telemetry
+  Telemetry,
+  recordOperationSpan
 };

package/dist/telemetry/operation-span.cjs

@@ -0,0 +1,74 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var operation_span_exports = {};
+__export(operation_span_exports, {
+  recordOperationSpan: () => recordOperationSpan
+});
+module.exports = __toCommonJS(operation_span_exports);
+var import_api = require("@opentelemetry/api");
+var import_utils = require("./utils.js");
+async function recordOperationSpan(options, operation, logger) {
+  const skipIfNoTelemetry = options.skipIfNoTelemetry ?? true;
+  if (skipIfNoTelemetry && !(0, import_utils.hasActiveTelemetry)(logger)) {
+    return operation();
+  }
+  return import_api.trace.getTracer(options.tracerName ?? "dexto").startActiveSpan(options.name, { kind: import_api.SpanKind.INTERNAL }, async (span) => {
+    const spanContext = import_api.trace.setSpan(import_api.context.active(), span);
+    (0, import_utils.addBaggageAttributesToSpan)(span, spanContext, logger);
+    if (options.componentName !== void 0) {
+      span.setAttribute("componentName", options.componentName);
+    }
+    setOperationSpanAttributes(span, options.attributes);
+    try {
+      const result = await operation();
+      try {
+        setOperationSpanAttributes(span, options.resultAttributes?.(result));
+      } catch (error) {
+        logger?.debug("Failed to set OpenTelemetry result attributes", {
+          error: error instanceof Error ? error.message : String(error),
+          span: options.name
+        });
+      }
+      span.setStatus({ code: import_api.SpanStatusCode.OK });
+      return result;
+    } catch (error) {
+      if (error instanceof Error) {
+        span.recordException(error);
+        span.setStatus({ code: import_api.SpanStatusCode.ERROR, message: error.message });
+      } else {
+        span.setStatus({ code: import_api.SpanStatusCode.ERROR, message: String(error) });
+      }
+      throw error;
+    } finally {
+      span.end();
+    }
+  });
+}
+function setOperationSpanAttributes(span, attributes) {
+  if (span === void 0 || attributes === void 0) {
+    return;
+  }
+  for (const [key, value] of Object.entries(attributes)) {
+    span.setAttribute(key, value);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  recordOperationSpan
+});

package/dist/telemetry/operation-span.d.ts

@@ -0,0 +1,13 @@
+import type { Logger } from '../logger/v2/types.js';
+type OperationSpanAttributes = Record<string, string | number | boolean>;
+export type OperationSpanOptions<T> = {
+    attributes?: OperationSpanAttributes;
+    componentName?: string;
+    name: string;
+    resultAttributes?: (result: T) => OperationSpanAttributes | undefined;
+    skipIfNoTelemetry?: boolean;
+    tracerName?: string;
+};
+export declare function recordOperationSpan<T>(options: OperationSpanOptions<T>, operation: () => T | Promise<T>, logger?: Logger): Promise<T>;
+export {};
+//# sourceMappingURL=operation-span.d.ts.map

package/dist/telemetry/operation-span.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-span.d.ts","sourceRoot":"","sources":["../../src/telemetry/operation-span.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAGpD,KAAK,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;AAEzE,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI;IAClC,UAAU,CAAC,EAAE,uBAAuB,CAAC;IACrC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,uBAAuB,GAAG,SAAS,CAAC;IACtE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,wBAAsB,mBAAmB,CAAC,CAAC,EACvC,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC,EAChC,SAAS,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAC/B,MAAM,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,CAAC,CAAC,CA0CZ"}