vedatrace 0.3.0 → 0.3.1

package/dist/index.mjs

@@ -1,4 +1,5 @@
-import { VedaTraceHttpTransportBrowser, VedaTraceHttpTransport, VedaTraceConsoleTransport } from './transports/index.mjs';
+import { i as isFatal, a as isRetryable, r as retryAfterMs, V as VedaTraceHttpTransportBrowser, b as VedaTraceHttpTransport, c as VedaTraceConsoleTransport } from './index-BcBZY8as.mjs';
+export { d as VedaTraceTransportError } from './index-BcBZY8as.mjs';
 
 class VedaTraceBatcher {
   constructor(transports, config, immediateFlush = false) {
@@ -15,6 +16,12 @@ class VedaTraceBatcher {
   pendingFlush = null;
   context;
   waitUntilFn;
+  /**
+   * Set when the ingestion endpoint rejects our credentials. Every subsequent
+   * batch would fail identically, so we stop rather than spend a request (and a
+   * retry storm) per flush for the life of the process. start() clears it.
+   */
+  halted = false;
   setContext(ctx) {
     this.context = ctx;
   }
@@ -22,6 +29,7 @@ class VedaTraceBatcher {
     return this.context;
   }
   add(log) {
+    if (this.halted) return;
     this.queue.push(log);
     if (this.context || this.waitUntilFn) {
       this.debouncedFlush();
@@ -43,23 +51,12 @@ class VedaTraceBatcher {
     this.flushQueued = true;
     queueMicrotask(() => {
       this.flushQueued = false;
-      this.flush().catch((error) => {
-        if (this.config.onError) {
-          this.config.onError(
-            error instanceof Error ? error : new Error(String(error))
-          );
-        } else {
-          console.error(
-            "[VedaTrace] Debounced flush error:",
-            error instanceof Error ? error.message : String(error)
-          );
-        }
-      });
+      this.flush().catch((error) => this.reportError(error));
     });
   }
   async flush() {
     if (this.isFlushing) {
-      return this.pendingFlush ?? await Promise.resolve();
+      return this.pendingFlush ?? Promise.resolve();
     }
     if (this.queue.length === 0) {
       return Promise.resolve();
@@ -70,6 +67,10 @@ class VedaTraceBatcher {
     const flushPromise = this.sendWithRetry(logsToSend).finally(() => {
       this.isFlushing = false;
       this.pendingFlush = null;
+    }).then(() => {
+      if (this.queue.length > 0 && !this.halted) {
+        return this.flush();
+      }
     });
     this.pendingFlush = flushPromise;
     if (this.context && typeof this.context.waitUntil === "function") {
@@ -85,26 +86,47 @@ class VedaTraceBatcher {
       try {
         await transport.send(logs);
       } catch (error) {
-        errors.push(error instanceof Error ? error : new Error(String(error)));
+        errors.push(error);
       }
     }
-    if (errors.length > 0 && errors.length === this.transports.length) {
-      if (attempt < this.config.maxRetries) {
-        await this.delay(this.config.retryDelay * (attempt + 1));
-        return this.sendWithRetry(logs, attempt + 1);
-      }
-      const combinedError = new Error(
-        `Failed to send logs after ${this.config.maxRetries} retries: ${errors.map((e) => e.message).join(", ")}`
-      );
-      if (this.config.onError) {
-        this.config.onError(combinedError);
-      } else {
-        console.error("[VedaTrace]", combinedError.message);
-      }
+    if (errors.length === 0 || errors.length < this.transports.length) {
+      this.config.onSuccess?.();
+      return;
+    }
+    const fatalError = errors.find(isFatal);
+    if (fatalError) {
+      this.halt(fatalError);
       return;
     }
-    if (this.config.onSuccess) {
-      this.config.onSuccess();
+    if (errors.some(isRetryable) && attempt < this.config.maxRetries) {
+      const backoff = this.config.retryDelay * (attempt + 1);
+      await this.delay(retryAfterMs(errors) ?? backoff);
+      return this.sendWithRetry(logs, attempt + 1);
+    }
+    const detail = errors.map(describeError).join(", ");
+    this.reportError(
+      new Error(
+        errors.some(isRetryable) ? `Failed to send ${logs.length} logs after ${this.config.maxRetries} retries: ${detail}` : `Failed to send ${logs.length} logs: ${detail}`
+      )
+    );
+  }
+  /** Stop accepting logs after an unrecoverable authentication failure. */
+  halt(error) {
+    this.halted = true;
+    this.queue = [];
+    this.stop();
+    this.reportError(
+      new Error(
+        `VedaTrace disabled: ${describeError(error)}. Check your API key and the key's allowed origins, then call logger.start() to resume.`
+      )
+    );
+  }
+  reportError(error) {
+    const normalized = error instanceof Error ? error : new Error(String(error));
+    if (this.config.onError) {
+      this.config.onError(normalized);
+    } else {
+      console.error("[VedaTrace]", normalized.message);
     }
   }
   startFlushTimer() {
@@ -113,22 +135,11 @@ class VedaTraceBatcher {
     }
     this.flushTimer = setInterval(() => {
       if (this.queue.length > 0) {
-        this.flush().catch((error) => {
-          if (this.config.onError) {
-            this.config.onError(
-              error instanceof Error ? error : new Error(String(error))
-            );
-          } else {
-            console.error(
-              "[VedaTrace] Flush error:",
-              error instanceof Error ? error.message : String(error)
-            );
-          }
-        });
+        this.flush().catch((error) => this.reportError(error));
       }
     }, this.config.flushInterval);
     if (this.config.unrefTimer === true) {
-      this.flushTimer.unref();
+      this.flushTimer.unref?.();
     }
   }
   stop() {
@@ -139,6 +150,7 @@ class VedaTraceBatcher {
     this.flushQueued = false;
   }
   start() {
+    this.halted = false;
     if (!this.flushTimer && !this.immediateFlush) {
       this.startFlushTimer();
     }
@@ -149,10 +161,17 @@ class VedaTraceBatcher {
   getQueueSize() {
     return this.queue.length;
   }
+  /** True once an auth failure has shut the batcher down. */
+  isHalted() {
+    return this.halted;
+  }
   setExecutionContext(ctx) {
     this.context = ctx;
   }
 }
+function describeError(error) {
+  return error instanceof Error ? error.message : String(error);
+}
 
 function detectRuntime() {
   if (typeof navigator !== "undefined" && navigator.userAgent === "Cloudflare-Workers") {
@@ -195,7 +214,8 @@ function isBrowser() {
   return detectRuntime() === "browser";
 }
 
-const SDK_VERSION = process.env.npm_package_version ?? "0.0.0";
+const SDK_VERSION = "0.3.1";
+
 class VedaTraceLogger {
   batcher = null;
   runtime;
@@ -348,24 +368,17 @@ class BrowserLifecycle {
     this.config = config;
     this.boundVisibilityHandler = this.handleVisibilityChange.bind(this);
     this.boundPageHideHandler = this.handlePageHide.bind(this);
-    this.boundBeforeUnloadHandler = this.handleBeforeUnload.bind(this);
-    this.boundUnloadHandler = this.handleUnload.bind(this);
   }
   boundVisibilityHandler;
   boundPageHideHandler;
-  boundBeforeUnloadHandler;
-  boundUnloadHandler;
   isAttached = false;
   pendingFlush = null;
   /** Start listening for browser lifecycle events */
   attach() {
     if (this.isAttached) return;
-    if (typeof document !== "undefined") {
-      document.addEventListener("visibilitychange", this.boundVisibilityHandler);
-      window.addEventListener("pagehide", this.boundPageHideHandler);
-      window.addEventListener("beforeunload", this.boundBeforeUnloadHandler);
-      window.addEventListener("unload", this.boundUnloadHandler);
-    }
+    if (typeof document === "undefined" || typeof window === "undefined") return;
+    document.addEventListener("visibilitychange", this.boundVisibilityHandler);
+    window.addEventListener("pagehide", this.boundPageHideHandler);
     this.isAttached = true;
     if (this.config.debug) {
       console.log("[VedaTrace] Browser lifecycle handlers attached");
@@ -374,21 +387,25 @@ class BrowserLifecycle {
   /** Stop listening for browser lifecycle events */
   detach() {
     if (!this.isAttached) return;
-    if (typeof document !== "undefined") {
+    if (typeof document !== "undefined" && typeof window !== "undefined") {
       document.removeEventListener(
         "visibilitychange",
         this.boundVisibilityHandler
       );
       window.removeEventListener("pagehide", this.boundPageHideHandler);
-      window.removeEventListener("beforeunload", this.boundBeforeUnloadHandler);
-      window.removeEventListener("unload", this.boundUnloadHandler);
     }
     this.isAttached = false;
     if (this.config.debug) {
       console.log("[VedaTrace] Browser lifecycle handlers detached");
     }
   }
-  /** Handle visibility change - flush when page becomes hidden */
+  /**
+   * Flush when the page becomes hidden.
+   *
+   * This is the one that actually matters: on mobile, a backgrounded tab is
+   * often discarded without ever firing pagehide, so "hidden" is the last
+   * reliable moment to ship what we have.
+   */
   handleVisibilityChange() {
     if (document.visibilityState === "hidden") {
       if (this.config.debug) {
@@ -397,7 +414,7 @@ class BrowserLifecycle {
       this.scheduleFlush();
     }
   }
-  /** Handle pagehide event - primary flush handler for Safari */
+  /** Final flush as the page is torn down or frozen into the bfcache. */
   handlePageHide(event) {
     if (this.config.debug) {
       console.log(
@@ -405,46 +422,16 @@ class BrowserLifecycle {
         event.persisted ? "(cached)" : "(navigation)"
       );
     }
-    if (event.persisted) {
-      this.scheduleFlush();
-    } else {
-      this.finalFlush();
-    }
-  }
-  /** Handle beforeunload - backup flush mechanism */
-  handleBeforeUnload(event) {
-    if (this.config.debug) {
-      console.log("[VedaTrace] Before unload event");
-    }
-    this.finalFlush();
-  }
-  /** Handle unload - fallback for older browsers */
-  handleUnload() {
-    if (this.config.debug) {
-      console.log("[VedaTrace] Unload event");
-    }
-    this.finalFlush();
+    this.scheduleFlush();
   }
-  /** Schedule a debounced flush (for visibility change) */
+  /** Flush at most once at a time; keepalive carries it past the document. */
   scheduleFlush() {
     if (this.pendingFlush) return;
-    this.pendingFlush = this.config.flush().finally(() => {
+    this.pendingFlush = this.config.flush().catch(() => {
+    }).finally(() => {
       this.pendingFlush = null;
     });
   }
-  /**
-   * Final flush using keepalive fetch
-   * For sending logs after the page context is destroyed
-   */
-  finalFlush() {
-    for (const transport of this.config.transports) {
-      if (transport.name === "http" && "flush" in transport) {
-        transport.flush?.();
-      }
-    }
-    this.config.flush().catch(() => {
-    });
-  }
   /** Check if handlers are attached */
   isActive() {
     return this.isAttached;
@@ -525,6 +512,16 @@ function redactPii(value, mask) {
   return result;
 }
 
+function resolveApiKey(config) {
+  if (config.apiKey) return config.apiKey;
+  try {
+    if (typeof process !== "undefined" && process.env) {
+      return process.env.VEDATRACE_API_KEY || void 0;
+    }
+  } catch {
+  }
+  return void 0;
+}
 const RUNTIME_FLUSH_INTERVALS = {
   node: 3e3,
   bun: 3e3,
@@ -535,14 +532,15 @@ const RUNTIME_FLUSH_INTERVALS = {
 };
 function vedatrace(config = {}) {
   const runtime = detectRuntime();
-  const logger = new VedaTraceLogger(config);
-  if (config.apiKey && (!config.transports || config.transports.length === 0)) {
+  const apiKey = resolveApiKey(config);
+  const logger = new VedaTraceLogger(apiKey ? { ...config, apiKey } : config);
+  if (apiKey && (!config.transports || config.transports.length === 0)) {
     const isBrowserEnv = isBrowser();
     const isServerlessEnv = isServerless();
     const isLongRunningEnv = isLongRunning();
     const HttpTransport = isBrowserEnv ? VedaTraceHttpTransportBrowser : VedaTraceHttpTransport;
     const httpConfig = {
-      apiKey: config.apiKey,
+      apiKey,
       keepalive: isBrowserEnv || isServerlessEnv
     };
     if (config.endpoint) httpConfig.endpoint = config.endpoint;
@@ -609,4 +607,4 @@ function devVedatrace(config = {}) {
   });
 }
 
-export { BrowserLifecycle, VedaTraceBatcher, VedaTraceConsoleTransport, VedaTraceHttpTransport, VedaTraceHttpTransportBrowser, VedaTraceLogger, vedatrace as default, detectRuntime, devVedatrace, isBrowser, isEdgeRuntime, isLongRunning, isServerless, redact, vedatrace };
+export { BrowserLifecycle, SDK_VERSION, VedaTraceBatcher, VedaTraceConsoleTransport, VedaTraceHttpTransport, VedaTraceHttpTransportBrowser, VedaTraceLogger, vedatrace as default, detectRuntime, devVedatrace, isBrowser, isEdgeRuntime, isLongRunning, isServerless, redact, vedatrace };

package/dist/integrations/express.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 var index = require('../index.cjs');
-require('../transports/index.cjs');
+require('../index-osD28Hs0.cjs');
 
 function vedaTraceMiddleware(config = {}) {
   const {
@@ -11,10 +11,11 @@ function vedaTraceMiddleware(config = {}) {
     logBody = false,
     ...vedaConfig
   } = config;
+  const baseLogger = index.default(vedaConfig);
   return (req, res, next) => {
     const requestId = generateRequestId(req);
     req.requestId = requestId;
-    const logger = index.default(vedaConfig).child({
+    const logger = baseLogger.child({
       requestId,
       ...requestMetadata(req)
     });
@@ -38,8 +39,6 @@ function vedaTraceMiddleware(config = {}) {
           statusCode: res.statusCode,
           durationMs: duration
         });
-        logger.flush().catch(() => {
-        });
       });
     }
     next();

package/dist/integrations/express.mjs

@@ -1,5 +1,5 @@
 import vedatrace from '../index.mjs';
-import '../transports/index.mjs';
+import '../index-BcBZY8as.mjs';
 
 function vedaTraceMiddleware(config = {}) {
   const {
@@ -9,10 +9,11 @@ function vedaTraceMiddleware(config = {}) {
     logBody = false,
     ...vedaConfig
   } = config;
+  const baseLogger = vedatrace(vedaConfig);
   return (req, res, next) => {
     const requestId = generateRequestId(req);
     req.requestId = requestId;
-    const logger = vedatrace(vedaConfig).child({
+    const logger = baseLogger.child({
       requestId,
       ...requestMetadata(req)
     });
@@ -36,8 +37,6 @@ function vedaTraceMiddleware(config = {}) {
           statusCode: res.statusCode,
           durationMs: duration
         });
-        logger.flush().catch(() => {
-        });
       });
     }
     next();

package/dist/integrations/nextjs.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 var index = require('../index.cjs');
-require('../transports/index.cjs');
+require('../index-osD28Hs0.cjs');
 
 function withVedaTrace(handler, config = {}) {
   const {
@@ -9,9 +9,10 @@ function withVedaTrace(handler, config = {}) {
     requestMetadata = () => ({}),
     ...vedaConfig
   } = config;
+  const baseLogger = index.default(vedaConfig);
   return async (req) => {
     const requestId = generateRequestId();
-    const logger = index.default(vedaConfig).child({
+    const logger = baseLogger.child({
       requestId,
       ...requestMetadata()
     });
@@ -42,10 +43,35 @@ function withVedaTrace(handler, config = {}) {
 function createVedaTraceLogger(config = {}) {
   return index.default(config);
 }
-const serverLogger = index.default({
-  service: "nextjs-server"
-});
+let serverLoggerInstance = null;
+function getServerLogger(config = {}) {
+  if (!serverLoggerInstance) {
+    serverLoggerInstance = index.default({ service: "nextjs-server", ...config });
+  }
+  return serverLoggerInstance;
+}
+const serverLogger = {
+  debug: (message, metadata) => getServerLogger().debug(message, metadata),
+  info: (message, metadata) => getServerLogger().info(message, metadata),
+  warn: (message, metadata) => getServerLogger().warn(message, metadata),
+  error: (message, metadata) => getServerLogger().error(message, metadata),
+  fatal: (message, metadata) => getServerLogger().fatal(message, metadata),
+  child: (defaults) => getServerLogger().child(defaults),
+  flush: () => getServerLogger().flush(),
+  stop: () => getServerLogger().stop(),
+  start: () => getServerLogger().start(),
+  withContext(ctx) {
+    getServerLogger().withContext(ctx);
+    return this;
+  },
+  hasContext: () => getServerLogger().hasContext(),
+  getContext: () => getServerLogger().getContext(),
+  get runtime() {
+    return getServerLogger().runtime;
+  }
+};
 
 exports.createVedaTraceLogger = createVedaTraceLogger;
+exports.getServerLogger = getServerLogger;
 exports.serverLogger = serverLogger;
 exports.withVedaTrace = withVedaTrace;

package/dist/integrations/nextjs.d.cts

@@ -47,22 +47,14 @@ declare function withVedaTrace<T extends (req: Request, ctx: NextJsContext) => P
  * ```
  */
 declare function createVedaTraceLogger(config?: VedaTraceConfig): VedaTraceLoggerInterface;
+/** Get (and lazily create) the shared Next.js server logger. */
+declare function getServerLogger(config?: VedaTraceConfig): VedaTraceLoggerInterface;
 /**
- * Server-side logger for Next.js
- * Use in Server Components or API routes
- *
- * @example
- * ```typescript
- * // app/page.tsx (Server Component)
- * import { serverLogger } from 'vedatrace/next'
- *
- * export default async function Page() {
- *   serverLogger.info('Rendering page')
- *   return <div>Hello</div>
- * }
- * ```
+ * Convenience wrapper around {@link getServerLogger} that keeps the original
+ * `serverLogger.info(...)` call shape while deferring construction to the first
+ * call.
  */
 declare const serverLogger: VedaTraceLoggerInterface;
 
-export { createVedaTraceLogger, serverLogger, withVedaTrace };
+export { createVedaTraceLogger, getServerLogger, serverLogger, withVedaTrace };
 export type { NextJsConfig, NextJsContext };

package/dist/integrations/nextjs.d.mts

@@ -47,22 +47,14 @@ declare function withVedaTrace<T extends (req: Request, ctx: NextJsContext) => P
  * ```
  */
 declare function createVedaTraceLogger(config?: VedaTraceConfig): VedaTraceLoggerInterface;
+/** Get (and lazily create) the shared Next.js server logger. */
+declare function getServerLogger(config?: VedaTraceConfig): VedaTraceLoggerInterface;
 /**
- * Server-side logger for Next.js
- * Use in Server Components or API routes
- *
- * @example
- * ```typescript
- * // app/page.tsx (Server Component)
- * import { serverLogger } from 'vedatrace/next'
- *
- * export default async function Page() {
- *   serverLogger.info('Rendering page')
- *   return <div>Hello</div>
- * }
- * ```
+ * Convenience wrapper around {@link getServerLogger} that keeps the original
+ * `serverLogger.info(...)` call shape while deferring construction to the first
+ * call.
  */
 declare const serverLogger: VedaTraceLoggerInterface;
 
-export { createVedaTraceLogger, serverLogger, withVedaTrace };
+export { createVedaTraceLogger, getServerLogger, serverLogger, withVedaTrace };
 export type { NextJsConfig, NextJsContext };

package/dist/integrations/nextjs.mjs

@@ -1,5 +1,5 @@
 import vedatrace from '../index.mjs';
-import '../transports/index.mjs';
+import '../index-BcBZY8as.mjs';
 
 function withVedaTrace(handler, config = {}) {
   const {
@@ -7,9 +7,10 @@ function withVedaTrace(handler, config = {}) {
     requestMetadata = () => ({}),
     ...vedaConfig
   } = config;
+  const baseLogger = vedatrace(vedaConfig);
   return async (req) => {
     const requestId = generateRequestId();
-    const logger = vedatrace(vedaConfig).child({
+    const logger = baseLogger.child({
       requestId,
       ...requestMetadata()
     });
@@ -40,8 +41,32 @@ function withVedaTrace(handler, config = {}) {
 function createVedaTraceLogger(config = {}) {
   return vedatrace(config);
 }
-const serverLogger = vedatrace({
-  service: "nextjs-server"
-});
+let serverLoggerInstance = null;
+function getServerLogger(config = {}) {
+  if (!serverLoggerInstance) {
+    serverLoggerInstance = vedatrace({ service: "nextjs-server", ...config });
+  }
+  return serverLoggerInstance;
+}
+const serverLogger = {
+  debug: (message, metadata) => getServerLogger().debug(message, metadata),
+  info: (message, metadata) => getServerLogger().info(message, metadata),
+  warn: (message, metadata) => getServerLogger().warn(message, metadata),
+  error: (message, metadata) => getServerLogger().error(message, metadata),
+  fatal: (message, metadata) => getServerLogger().fatal(message, metadata),
+  child: (defaults) => getServerLogger().child(defaults),
+  flush: () => getServerLogger().flush(),
+  stop: () => getServerLogger().stop(),
+  start: () => getServerLogger().start(),
+  withContext(ctx) {
+    getServerLogger().withContext(ctx);
+    return this;
+  },
+  hasContext: () => getServerLogger().hasContext(),
+  getContext: () => getServerLogger().getContext(),
+  get runtime() {
+    return getServerLogger().runtime;
+  }
+};
 
-export { createVedaTraceLogger, serverLogger, withVedaTrace };
+export { createVedaTraceLogger, getServerLogger, serverLogger, withVedaTrace };

package/dist/integrations/react.cjs

@@ -3,7 +3,7 @@
 var jsxRuntime = require('react/jsx-runtime');
 var react = require('react');
 var index = require('../index.cjs');
-require('../transports/index.cjs');
+require('../index-osD28Hs0.cjs');
 
 const VedaTraceContext = react.createContext(null);
 function VedaTraceProvider({

package/dist/integrations/react.mjs

@@ -1,7 +1,7 @@
 import { jsx } from 'react/jsx-runtime';
 import { createContext, useRef, useMemo, useEffect, useContext, useCallback } from 'react';
 import vedatrace from '../index.mjs';
-import '../transports/index.mjs';
+import '../index-BcBZY8as.mjs';
 
 const VedaTraceContext = createContext(null);
 function VedaTraceProvider({