@statly/observe 1.0.0 → 1.2.0

package/dist/chunk-J5AHUFP2.mjs

@@ -0,0 +1,135 @@
+// src/span.ts
+var Span = class {
+  constructor(name, context, tags) {
+    this._status = "ok" /* OK */;
+    this._tags = {};
+    this._metadata = {};
+    this._finished = false;
+    this.name = name;
+    this.context = context;
+    this.startTime = Date.now();
+    if (tags) this._tags = { ...tags };
+  }
+  /**
+   * Finish the span and calculate duration
+   */
+  finish(endTime) {
+    if (this._finished) return;
+    this._endTime = endTime || Date.now();
+    this._durationMs = this._endTime - this.startTime;
+    this._finished = true;
+  }
+  setTag(key, value) {
+    this._tags[key] = value;
+    return this;
+  }
+  setMetadata(key, value) {
+    this._metadata[key] = value;
+    return this;
+  }
+  setStatus(status) {
+    this._status = status;
+    return this;
+  }
+  get status() {
+    return this._status;
+  }
+  get tags() {
+    return { ...this._tags };
+  }
+  get durationMs() {
+    return this._durationMs;
+  }
+  toDict() {
+    return {
+      name: this.name,
+      traceId: this.context.traceId,
+      spanId: this.context.spanId,
+      parentId: this.context.parentId,
+      startTime: this.startTime,
+      endTime: this._endTime,
+      durationMs: this._durationMs,
+      status: this._status,
+      tags: this._tags,
+      metadata: this._metadata
+    };
+  }
+};
+var TraceContext = class {
+  static getActiveSpan() {
+    return this.currentSpan;
+  }
+  static setActiveSpan(span) {
+    this.currentSpan = span;
+  }
+};
+TraceContext.currentSpan = null;
+
+// src/telemetry.ts
+var TelemetryProvider = class _TelemetryProvider {
+  constructor() {
+    this.client = null;
+  }
+  static getInstance() {
+    if (!_TelemetryProvider.instance) {
+      _TelemetryProvider.instance = new _TelemetryProvider();
+    }
+    return _TelemetryProvider.instance;
+  }
+  setClient(client) {
+    this.client = client;
+  }
+  /**
+   * Start a new span
+   */
+  startSpan(name, tags) {
+    const parent = TraceContext.getActiveSpan();
+    const traceId = parent ? parent.context.traceId : this.generateId();
+    const parentId = parent ? parent.context.spanId : null;
+    const span = new Span(name, {
+      traceId,
+      spanId: this.generateId(),
+      parentId
+    }, tags);
+    TraceContext.setActiveSpan(span);
+    return span;
+  }
+  /**
+   * Finish and report a span
+   */
+  finishSpan(span) {
+    span.finish();
+    if (TraceContext.getActiveSpan() === span) {
+      TraceContext.setActiveSpan(null);
+    }
+    if (this.client) {
+      this.client.captureSpan(span);
+    }
+  }
+  generateId() {
+    return Math.random().toString(16).substring(2, 18);
+  }
+};
+async function trace(name, operation, tags) {
+  const provider = TelemetryProvider.getInstance();
+  const span = provider.startSpan(name, tags);
+  try {
+    const result = await operation(span);
+    return result;
+  } catch (error) {
+    span.setStatus("error" /* ERROR */);
+    span.setTag("error", "true");
+    if (error instanceof Error) {
+      span.setTag("exception.type", error.name);
+      span.setTag("exception.message", error.message);
+    }
+    throw error;
+  } finally {
+    provider.finishSpan(span);
+  }
+}
+
+export {
+  TelemetryProvider,
+  trace
+};

package/dist/{chunk-UNDSALI5.mjs → chunk-SJ7C46AP.mjs}

@@ -1,3 +1,7 @@
+import {
+  TelemetryProvider
+} from "./chunk-J5AHUFP2.mjs";
+
 // src/transport.ts
 var Transport = class {
   constructor(options) {
@@ -58,10 +62,10 @@ var Transport = class {
     this.queue = [];
     try {
       await this.sendBatch(events);
-    } catch (error) {
+    } catch (error2) {
       this.queue = [...events, ...this.queue].slice(0, this.maxQueueSize);
       if (this.debug) {
-        console.error("[Statly] Failed to send events:", error);
+        console.error("[Statly] Failed to send events:", error2);
       }
     } finally {
       this.isSending = false;
@@ -101,13 +105,13 @@ var Transport = class {
         console.log(`[Statly] Sent ${events.length} event(s)`);
       }
       return { success: true, status: response.status };
-    } catch (error) {
+    } catch (error2) {
       if (this.debug) {
-        console.error("[Statly] Network error:", error);
+        console.error("[Statly] Network error:", error2);
       }
       return {
         success: false,
-        error: error instanceof Error ? error.message : "Network error"
+        error: error2 instanceof Error ? error2.message : "Network error"
       };
     }
   }
@@ -174,16 +178,16 @@ var GlobalHandlers = class {
       if (!this.errorCallback) {
         return;
       }
-      let error;
+      let error2;
       if (event.reason instanceof Error) {
-        error = event.reason;
+        error2 = event.reason;
       } else if (typeof event.reason === "string") {
-        error = new Error(event.reason);
+        error2 = new Error(event.reason);
       } else {
-        error = new Error("Unhandled Promise Rejection");
-        error.reason = event.reason;
+        error2 = new Error("Unhandled Promise Rejection");
+        error2.reason = event.reason;
       }
-      this.errorCallback(error, {
+      this.errorCallback(error2, {
         mechanism: { type: "onunhandledrejection", handled: false }
       });
     };
@@ -226,13 +230,13 @@ var GlobalHandlers = class {
   }
   installOnError() {
     this.originalOnError = window.onerror;
-    window.onerror = (message, source, lineno, colno, error) => {
+    window.onerror = (message, source, lineno, colno, error2) => {
       if (this.originalOnError) {
-        this.originalOnError.call(window, message, source, lineno, colno, error);
+        this.originalOnError.call(window, message, source, lineno, colno, error2);
       }
       if (this.errorCallback) {
-        const errorObj = error || new Error(String(message));
-        if (!error && source) {
+        const errorObj = error2 || new Error(String(message));
+        if (!error2 && source) {
           errorObj.filename = source;
           errorObj.lineno = lineno;
           errorObj.colno = colno;
@@ -356,6 +360,7 @@ var StatlyClient = class {
     this.breadcrumbs = new BreadcrumbManager(this.options.maxBreadcrumbs);
     this.globalHandlers = new GlobalHandlers();
     this.consoleIntegration = new ConsoleIntegration();
+    TelemetryProvider.getInstance().setClient(this);
   }
   mergeOptions(options) {
     return {
@@ -395,8 +400,8 @@ var StatlyClient = class {
     }
     this.initialized = true;
     if (this.options.autoCapture) {
-      this.globalHandlers.install((error, context) => {
-        this.captureError(error, context);
+      this.globalHandlers.install((error2, context) => {
+        this.captureError(error2, context);
       });
     }
     if (this.options.captureConsole) {
@@ -419,15 +424,15 @@ var StatlyClient = class {
   /**
    * Capture an exception/error
    */
-  captureException(error, context) {
+  captureException(error2, context) {
     let errorObj;
-    if (error instanceof Error) {
-      errorObj = error;
-    } else if (typeof error === "string") {
-      errorObj = new Error(error);
+    if (error2 instanceof Error) {
+      errorObj = error2;
+    } else if (typeof error2 === "string") {
+      errorObj = new Error(error2);
     } else {
       errorObj = new Error("Unknown error");
-      errorObj.originalError = error;
+      errorObj.originalError = error2;
     }
     return this.captureError(errorObj, context);
   }
@@ -441,21 +446,45 @@ var StatlyClient = class {
     });
     return this.sendEvent(event);
   }
+  /**
+   * Capture a completed span
+   */
+  captureSpan(span) {
+    const event = this.buildEvent({
+      message: `Span: ${span.name}`,
+      level: "span",
+      span: span.toDict()
+    });
+    return this.sendEvent(event);
+  }
+  /**
+   * Start a new tracing span
+   */
+  startSpan(name, tags) {
+    return TelemetryProvider.getInstance().startSpan(name, tags);
+  }
+  /**
+   * Execute a function within a trace span
+   */
+  async trace(name, operation, tags) {
+    const { trace: traceFn } = await import("./telemetry-CXHOTW3Y.mjs");
+    return traceFn(name, operation, tags);
+  }
   /**
    * Internal method to capture an error
    */
-  captureError(error, context) {
+  captureError(error2, context) {
     if (Math.random() > this.options.sampleRate) {
       return "";
     }
     const event = this.buildEvent({
-      message: error.message,
+      message: error2.message,
       level: "error",
-      stack: error.stack,
+      stack: error2.stack,
       exception: {
-        type: error.name,
-        value: error.message,
-        stacktrace: this.parseStackTrace(error.stack)
+        type: error2.name,
+        value: error2.message,
+        stacktrace: this.parseStackTrace(error2.stack)
       },
       extra: context
     });
@@ -652,73 +681,88 @@ var StatlyClient = class {
 // src/integrations/nextjs.ts
 function withStatlyPagesApi(handler) {
   return async (req, res) => {
-    Statly.addBreadcrumb({
-      category: "http",
-      message: `${req.method} ${req.url}`,
-      level: "info",
-      data: {
-        method: req.method,
-        url: req.url
-      }
-    });
-    try {
-      return await handler(req, res);
-    } catch (error) {
-      const context = {
-        request: {
+    return Statly.trace(`${req.method} ${req.url}`, async (span) => {
+      span.setTag("component", "nextjs-pages-api");
+      span.setTag("http.method", req.method || "GET");
+      span.setTag("http.url", req.url || "unknown");
+      Statly.addBreadcrumb({
+        category: "http",
+        message: `${req.method} ${req.url}`,
+        level: "info",
+        data: {
           method: req.method,
-          url: req.url,
-          headers: sanitizeHeaders(req.headers),
-          query: req.query
+          url: req.url
         }
-      };
-      Statly.captureException(error, context);
-      throw error;
-    }
+      });
+      try {
+        const result = await handler(req, res);
+        return result;
+      } catch (error2) {
+        const context = {
+          request: {
+            method: req.method,
+            url: req.url,
+            headers: sanitizeHeaders(req.headers),
+            query: req.query
+          }
+        };
+        Statly.captureException(error2, context);
+        throw error2;
+      }
+    });
   };
 }
 function withStatly(handler) {
   const wrappedHandler = async (request, context) => {
-    Statly.addBreadcrumb({
-      category: "http",
-      message: `${request.method} ${request.nextUrl?.pathname || request.url}`,
-      level: "info",
-      data: {
-        method: request.method,
-        url: request.nextUrl?.pathname || request.url
-      }
-    });
-    try {
-      return await handler(request, context);
-    } catch (error) {
-      const headers = {};
-      request.headers.forEach((value, key) => {
-        headers[key] = value;
-      });
-      const errorContext = {
-        request: {
+    return Statly.trace(`${request.method} ${request.nextUrl?.pathname || request.url}`, async (span) => {
+      span.setTag("component", "nextjs-app-router");
+      span.setTag("http.method", request.method);
+      span.setTag("http.url", request.nextUrl?.pathname || request.url);
+      Statly.addBreadcrumb({
+        category: "http",
+        message: `${request.method} ${request.nextUrl?.pathname || request.url}`,
+        level: "info",
+        data: {
           method: request.method,
-          url: request.nextUrl?.pathname || request.url,
-          headers: sanitizeHeaders(headers),
-          searchParams: request.nextUrl?.searchParams?.toString()
+          url: request.nextUrl?.pathname || request.url
         }
-      };
-      if (context?.params) {
-        try {
-          errorContext.params = await context.params;
-        } catch {
+      });
+      try {
+        const result = await handler(request, context);
+        if (result instanceof Response) {
+          span.setTag("http.status_code", result.status.toString());
+        }
+        return result;
+      } catch (error2) {
+        const headers = {};
+        request.headers.forEach((value, key) => {
+          headers[key] = value;
+        });
+        const errorContext = {
+          request: {
+            method: request.method,
+            url: request.nextUrl?.pathname || request.url,
+            headers: sanitizeHeaders(headers),
+            searchParams: request.nextUrl?.searchParams?.toString()
+          }
+        };
+        if (context?.params) {
+          try {
+            errorContext.params = await context.params;
+          } catch {
+          }
         }
+        Statly.captureException(error2, errorContext);
+        throw error2;
       }
-      Statly.captureException(error, errorContext);
-      throw error;
-    }
+    });
   };
   return wrappedHandler;
 }
-function captureNextJsError(error, context) {
-  return Statly.captureException(error, {
+function captureNextJsError(error2, context) {
+  return Statly.captureException(error2, {
     ...context,
-    digest: error.digest,
+    digest: error2.digest,
     source: "nextjs-error-boundary"
   });
 }
@@ -726,12 +770,12 @@ function withStatlyGetServerSideProps(handler) {
   return async (context) => {
     try {
       return await handler(context);
-    } catch (error) {
-      Statly.captureException(error, {
+    } catch (error2) {
+      Statly.captureException(error2, {
         source: "getServerSideProps",
         url: context.req?.url || context.resolvedUrl
       });
-      throw error;
+      throw error2;
     }
   };
 }
@@ -739,31 +783,35 @@ function withStatlyGetStaticProps(handler) {
   return async (context) => {
     try {
       return await handler(context);
-    } catch (error) {
-      Statly.captureException(error, {
+    } catch (error2) {
+      Statly.captureException(error2, {
         source: "getStaticProps",
         params: context.params
       });
-      throw error;
+      throw error2;
     }
   };
 }
 function withStatlyServerAction(action, actionName) {
   return async (...args) => {
-    Statly.addBreadcrumb({
-      category: "action",
-      message: `Server action: ${actionName || "unknown"}`,
-      level: "info"
-    });
-    try {
-      return await action(...args);
-    } catch (error) {
-      Statly.captureException(error, {
-        source: "server-action",
-        actionName
+    return Statly.trace(`Action: ${actionName || "unknown"}`, async (span) => {
+      span.setTag("component", "nextjs-server-action");
+      span.setTag("action.name", actionName || "unknown");
+      Statly.addBreadcrumb({
+        category: "action",
+        message: `Server action: ${actionName || "unknown"}`,
+        level: "info"
       });
-      throw error;
-    }
+      try {
+        return await action(...args);
+      } catch (error2) {
+        Statly.captureException(error2, {
+          source: "server-action",
+          actionName
+        });
+        throw error2;
+      }
+    });
   };
 }
 function sanitizeHeaders(headers) {
@@ -816,16 +864,16 @@ function statlyFastifyPlugin(fastify, options, done) {
     });
     hookDone();
   });
-  fastify.setErrorHandler((error, request, reply) => {
-    const statusCode = error.statusCode || 500;
+  fastify.setErrorHandler((error2, request, reply) => {
+    const statusCode = error2.statusCode || 500;
     if (skipStatusCodes.includes(statusCode)) {
-      throw error;
+      throw error2;
     }
-    if (!captureValidationErrors && error.validation) {
-      throw error;
+    if (!captureValidationErrors && error2.validation) {
+      throw error2;
     }
-    if (shouldCapture && !shouldCapture(error)) {
-      throw error;
+    if (shouldCapture && !shouldCapture(error2)) {
+      throw error2;
     }
     const context = {
       request: {
@@ -838,27 +886,27 @@ function statlyFastifyPlugin(fastify, options, done) {
         params: request.params
       },
       error: {
-        statusCode: error.statusCode,
-        code: error.code
+        statusCode: error2.statusCode,
+        code: error2.code
       }
     };
     if (request.ip) {
       context.ip = request.ip;
     }
-    if (error.validation) {
-      context.validation = error.validation;
+    if (error2.validation) {
+      context.validation = error2.validation;
     }
     Statly.setTag("http.method", request.method);
     Statly.setTag("http.url", request.routerPath || request.url);
     Statly.setTag("http.status_code", String(statusCode));
-    Statly.captureException(error, context);
-    throw error;
+    Statly.captureException(error2, context);
+    throw error2;
   });
   done();
 }
 var statlyPlugin = statlyFastifyPlugin;
 function createRequestCapture(request) {
-  return (error, additionalContext) => {
+  return (error2, additionalContext) => {
     const context = {
       request: {
         id: request.id,
@@ -868,7 +916,7 @@ function createRequestCapture(request) {
       },
       ...additionalContext
     };
-    return Statly.captureException(error, context);
+    return Statly.captureException(error2, context);
   };
 }
 function sanitizeHeaders2(headers) {
@@ -918,12 +966,12 @@ function init(options) {
   client = new StatlyClient(finalOptions);
   client.init();
 }
-function captureException(error, context) {
+function captureException(error2, context) {
   if (!client) {
     console.warn("[Statly] SDK not initialized. Call Statly.init() first.");
     return "";
   }
-  return client.captureException(error, context);
+  return client.captureException(error2, context);
 }
 function captureMessage(message, level = "info") {
   if (!client) {
@@ -976,6 +1024,20 @@ async function close() {
 function getClient() {
   return client;
 }
+async function trace2(name, operation, tags) {
+  if (!client) {
+    return operation(null);
+  }
+  return client.trace(name, operation, tags);
+}
+function startSpan(name, tags) {
+  if (!client) return null;
+  return client.startSpan(name, tags);
+}
+function captureSpan(span) {
+  if (!client) return "";
+  return client.captureSpan(span);
+}
 var Statly = {
   init,
   captureException,
@@ -986,7 +1048,10 @@ var Statly = {
   addBreadcrumb,
   flush,
   close,
-  getClient
+  getClient,
+  trace: trace2,
+  startSpan,
+  captureSpan
 };
 
 // src/integrations/express.ts
@@ -1028,8 +1093,8 @@ function requestHandler() {
 }
 function expressErrorHandler(options = {}) {
   return (err, req, res, next) => {
-    const error = err instanceof Error ? err : new Error(String(err));
-    if (options.shouldHandleError && !options.shouldHandleError(error)) {
+    const error2 = err instanceof Error ? err : new Error(String(err));
+    if (options.shouldHandleError && !options.shouldHandleError(error2)) {
       return next(err);
     }
     const context = {
@@ -1053,7 +1118,7 @@ function expressErrorHandler(options = {}) {
     if (req.statlyContext?.transactionName) {
       Statly.setTag("transaction", req.statlyContext.transactionName);
     }
-    Statly.captureException(error, context);
+    Statly.captureException(error2, context);
     next(err);
   };
 }
@@ -1110,5 +1175,8 @@ export {
   flush,
   close,
   getClient,
+  trace2 as trace,
+  startSpan,
+  captureSpan,
   Statly
 };