vedatrace 0.2.1 → 0.3.1

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

@@ -1,4 +1,4 @@
-import { a as VedaTraceConfig, L as LogMetadata, V as VedaTraceLoggerInterface } from '../types-BU0UESs9.cjs';
+import { a as VedaTraceConfig, L as LogMetadata, V as VedaTraceLoggerInterface } from '../types-CSBzeGyK.cjs';
 
 /**
  * Next.js integration for VedaTrace
@@ -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

@@ -1,4 +1,4 @@
-import { a as VedaTraceConfig, L as LogMetadata, V as VedaTraceLoggerInterface } from '../types-BU0UESs9.mjs';
+import { a as VedaTraceConfig, L as LogMetadata, V as VedaTraceLoggerInterface } from '../types-CSBzeGyK.mjs';
 
 /**
  * Next.js integration for VedaTrace
@@ -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.d.cts

@@ -1,5 +1,5 @@
 import { ReactNode, ReactElement } from 'react';
-import { a as VedaTraceConfig, V as VedaTraceLoggerInterface, L as LogMetadata } from '../types-BU0UESs9.cjs';
+import { a as VedaTraceConfig, V as VedaTraceLoggerInterface, L as LogMetadata } from '../types-CSBzeGyK.cjs';
 
 /**
  * React integration for VedaTrace

package/dist/integrations/react.d.mts

@@ -1,5 +1,5 @@
 import { ReactNode, ReactElement } from 'react';
-import { a as VedaTraceConfig, V as VedaTraceLoggerInterface, L as LogMetadata } from '../types-BU0UESs9.mjs';
+import { a as VedaTraceConfig, V as VedaTraceLoggerInterface, L as LogMetadata } from '../types-CSBzeGyK.mjs';
 
 /**
  * React integration for VedaTrace

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({

package/dist/transports/index.cjs

@@ -1,157 +1,9 @@
 'use strict';
 
-const LEVEL_COLORS = {
-  debug: "\x1B[36m",
-  // cyan
-  info: "\x1B[32m",
-  // green
-  warn: "\x1B[33m",
-  // yellow
-  error: "\x1B[31m",
-  // red
-  fatal: "\x1B[35m"
-  // magenta
-};
-const RESET_COLOR = "\x1B[0m";
-const LEVEL_PRIORITY = {
-  debug: 0,
-  info: 1,
-  warn: 2,
-  error: 3,
-  fatal: 4
-};
-class VedaTraceConsoleTransport {
-  name = "console";
-  format;
-  colors;
-  minLevel;
-  constructor(config = {}) {
-    this.format = config.format ?? "pretty";
-    this.colors = config.colors ?? true;
-    this.minLevel = config.minLevel ?? "debug";
-  }
-  /** Send logs to console */
-  send(logs) {
-    for (const log of logs) {
-      if (LEVEL_PRIORITY[log.level] < LEVEL_PRIORITY[this.minLevel]) {
-        continue;
-      }
-      switch (this.format) {
-        case "json":
-          this.logJson(log);
-          break;
-        case "simple":
-          this.logSimple(log);
-          break;
-        default:
-          this.logPretty(log);
-          break;
-      }
-    }
-  }
-  /** Format as JSON */
-  logJson(log) {
-    console.log(JSON.stringify(log));
-  }
-  /** Format as simple text */
-  logSimple(log) {
-    const timestamp = new Date(log.timestamp ?? Date.now()).toISOString();
-    const service = log.service ? `[${log.service}] ` : "";
-    console.log(
-      `${timestamp} ${log.level.toUpperCase()} ${service}${log.message}`
-    );
-  }
-  /** Format as pretty colored output */
-  logPretty(log) {
-    const timestamp = new Date(log.timestamp ?? Date.now()).toISOString();
-    const color = this.colors ? LEVEL_COLORS[log.level] : "";
-    const reset = this.colors ? RESET_COLOR : "";
-    const service = log.service ? ` ${color}[${log.service}]${reset}` : "";
-    let output = `${timestamp} ${color}${log.level.toUpperCase()}${reset}${service} ${log.message}`;
-    if (log.metadata && Object.keys(log.metadata).length > 0) {
-      output += `
-  ${color}metadata:${reset} ${JSON.stringify(log.metadata, null, 2).replace(/\n/g, "\n  ")}`;
-    }
-    console.log(output);
-  }
-}
+var transports_index = require('../index-osD28Hs0.cjs');
 
-class VedaTraceHttpTransport {
-  name = "http";
-  endpoint;
-  apiKey;
-  timeout;
-  headers;
-  keepalive;
-  constructor(config) {
-    this.apiKey = config.apiKey;
-    this.endpoint = config.endpoint ?? "https://ingest.vedatrace.dev/v1/logs";
-    this.timeout = config.timeout ?? 3e4;
-    this.headers = config.headers ?? {};
-    this.keepalive = config.keepalive ?? false;
-  }
-  /** Send logs via HTTP POST */
-  async send(logs) {
-    const controller = new AbortController();
-    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
-    const payload = logs.map((log) => ({
-      level: log.level,
-      message: log.message,
-      service: log.service,
-      timestamp: log.timestamp ? new Date(log.timestamp).toISOString() : void 0,
-      metadata: log.metadata
-    }));
-    try {
-      const response = await fetch(this.endpoint, {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json",
-          "X-API-Key": this.apiKey,
-          ...this.headers
-        },
-        body: JSON.stringify(payload),
-        signal: controller.signal,
-        keepalive: this.keepalive
-      });
-      clearTimeout(timeoutId);
-      if (!response.ok) {
-        const text = await response.text();
-        throw new Error(`HTTP ${response.status}: ${text}`);
-      }
-    } catch (error) {
-      clearTimeout(timeoutId);
-      if (error instanceof Error) {
-        if (error.name === "AbortError") {
-          throw new Error(`Request timeout after ${this.timeout}ms`);
-        }
-        throw error;
-      }
-      throw new Error(String(error));
-    }
-  }
-  /** Flush pending logs - called on page unload */
-  async flush() {
-    return Promise.resolve();
-  }
-  /** Check if keepalive is enabled */
-  isKeepaliveEnabled() {
-    return this.keepalive;
-  }
-  /** Enable/disable keepalive */
-  setKeepalive(enabled) {
-    this.keepalive = enabled;
-  }
-}
-class VedaTraceHttpTransportBrowser extends VedaTraceHttpTransport {
-  constructor(config) {
-    super({ ...config, keepalive: true });
-  }
-  async flush() {
-    this.setKeepalive(true);
-    return super.flush();
-  }
-}
 
-exports.VedaTraceConsoleTransport = VedaTraceConsoleTransport;
-exports.VedaTraceHttpTransport = VedaTraceHttpTransport;
-exports.VedaTraceHttpTransportBrowser = VedaTraceHttpTransportBrowser;
+
+exports.VedaTraceConsoleTransport = transports_index.VedaTraceConsoleTransport;
+exports.VedaTraceHttpTransport = transports_index.VedaTraceHttpTransport;
+exports.VedaTraceHttpTransportBrowser = transports_index.VedaTraceHttpTransportBrowser;

package/dist/transports/index.d.cts

@@ -1,4 +1,4 @@
-import { e as VedaTraceLevel, b as VedaTraceTransport, I as InternalLogEntry } from '../types-BU0UESs9.cjs';
+import { e as VedaTraceLevel, b as VedaTraceTransport, I as InternalLogEntry } from '../types-CSBzeGyK.cjs';
 
 /**
  * Console transport for development/debugging
@@ -34,8 +34,9 @@ declare class VedaTraceConsoleTransport implements VedaTraceTransport {
  *
  * Features:
  * - Timeout support with AbortController
- * - Retry on network failure
- * - Keepalive support for browser final flush
+ * - Status-aware errors so the batcher can tell retryable from permanent
+ * - Keepalive for the browser's final flush, with automatic splitting to stay
+ *   under the 64 KiB body limit the fetch spec puts on keepalive requests
  */
 
 interface HttpTransportConfig {
@@ -56,7 +57,11 @@ declare class VedaTraceHttpTransport implements VedaTraceTransport {
     constructor(config: HttpTransportConfig);
     /** Send logs via HTTP POST */
     send(logs: InternalLogEntry[]): Promise<void>;
-    /** Flush pending logs - called on page unload */
+    private post;
+    /**
+     * No-op: this transport holds no buffer of its own. The batcher owns the
+     * queue and calls send() directly, including on the browser's final flush.
+     */
     flush(): Promise<void>;
     /** Check if keepalive is enabled */
     isKeepaliveEnabled(): boolean;
@@ -64,11 +69,16 @@ declare class VedaTraceHttpTransport implements VedaTraceTransport {
     setKeepalive(enabled: boolean): void;
 }
 /**
- * Browser-safe HTTP transport that uses keepalive for final flush
+ * Browser HTTP transport: keepalive is always on so the final flush survives
+ * the page going away.
+ *
+ * Note on `navigator.sendBeacon`: it cannot set request headers, and the
+ * ingestion endpoint authenticates with `X-API-Key`, so a beacon would arrive
+ * unauthenticated. Keepalive fetch is the only mechanism that carries both the
+ * credentials and the payload past unload.
  */
 declare class VedaTraceHttpTransportBrowser extends VedaTraceHttpTransport {
     constructor(config: HttpTransportConfig);
-    flush(): Promise<void>;
 }
 
 export { VedaTraceConsoleTransport, VedaTraceHttpTransport, VedaTraceHttpTransportBrowser };

package/dist/transports/index.d.mts

@@ -1,4 +1,4 @@
-import { e as VedaTraceLevel, b as VedaTraceTransport, I as InternalLogEntry } from '../types-BU0UESs9.mjs';
+import { e as VedaTraceLevel, b as VedaTraceTransport, I as InternalLogEntry } from '../types-CSBzeGyK.mjs';
 
 /**
  * Console transport for development/debugging
@@ -34,8 +34,9 @@ declare class VedaTraceConsoleTransport implements VedaTraceTransport {
  *
  * Features:
  * - Timeout support with AbortController
- * - Retry on network failure
- * - Keepalive support for browser final flush
+ * - Status-aware errors so the batcher can tell retryable from permanent
+ * - Keepalive for the browser's final flush, with automatic splitting to stay
+ *   under the 64 KiB body limit the fetch spec puts on keepalive requests
  */
 
 interface HttpTransportConfig {
@@ -56,7 +57,11 @@ declare class VedaTraceHttpTransport implements VedaTraceTransport {
     constructor(config: HttpTransportConfig);
     /** Send logs via HTTP POST */
     send(logs: InternalLogEntry[]): Promise<void>;
-    /** Flush pending logs - called on page unload */
+    private post;
+    /**
+     * No-op: this transport holds no buffer of its own. The batcher owns the
+     * queue and calls send() directly, including on the browser's final flush.
+     */
     flush(): Promise<void>;
     /** Check if keepalive is enabled */
     isKeepaliveEnabled(): boolean;
@@ -64,11 +69,16 @@ declare class VedaTraceHttpTransport implements VedaTraceTransport {
     setKeepalive(enabled: boolean): void;
 }
 /**
- * Browser-safe HTTP transport that uses keepalive for final flush
+ * Browser HTTP transport: keepalive is always on so the final flush survives
+ * the page going away.
+ *
+ * Note on `navigator.sendBeacon`: it cannot set request headers, and the
+ * ingestion endpoint authenticates with `X-API-Key`, so a beacon would arrive
+ * unauthenticated. Keepalive fetch is the only mechanism that carries both the
+ * credentials and the payload past unload.
  */
 declare class VedaTraceHttpTransportBrowser extends VedaTraceHttpTransport {
     constructor(config: HttpTransportConfig);
-    flush(): Promise<void>;
 }
 
 export { VedaTraceConsoleTransport, VedaTraceHttpTransport, VedaTraceHttpTransportBrowser };

package/dist/transports/index.mjs

@@ -1,153 +1 @@
-const LEVEL_COLORS = {
-  debug: "\x1B[36m",
-  // cyan
-  info: "\x1B[32m",
-  // green
-  warn: "\x1B[33m",
-  // yellow
-  error: "\x1B[31m",
-  // red
-  fatal: "\x1B[35m"
-  // magenta
-};
-const RESET_COLOR = "\x1B[0m";
-const LEVEL_PRIORITY = {
-  debug: 0,
-  info: 1,
-  warn: 2,
-  error: 3,
-  fatal: 4
-};
-class VedaTraceConsoleTransport {
-  name = "console";
-  format;
-  colors;
-  minLevel;
-  constructor(config = {}) {
-    this.format = config.format ?? "pretty";
-    this.colors = config.colors ?? true;
-    this.minLevel = config.minLevel ?? "debug";
-  }
-  /** Send logs to console */
-  send(logs) {
-    for (const log of logs) {
-      if (LEVEL_PRIORITY[log.level] < LEVEL_PRIORITY[this.minLevel]) {
-        continue;
-      }
-      switch (this.format) {
-        case "json":
-          this.logJson(log);
-          break;
-        case "simple":
-          this.logSimple(log);
-          break;
-        default:
-          this.logPretty(log);
-          break;
-      }
-    }
-  }
-  /** Format as JSON */
-  logJson(log) {
-    console.log(JSON.stringify(log));
-  }
-  /** Format as simple text */
-  logSimple(log) {
-    const timestamp = new Date(log.timestamp ?? Date.now()).toISOString();
-    const service = log.service ? `[${log.service}] ` : "";
-    console.log(
-      `${timestamp} ${log.level.toUpperCase()} ${service}${log.message}`
-    );
-  }
-  /** Format as pretty colored output */
-  logPretty(log) {
-    const timestamp = new Date(log.timestamp ?? Date.now()).toISOString();
-    const color = this.colors ? LEVEL_COLORS[log.level] : "";
-    const reset = this.colors ? RESET_COLOR : "";
-    const service = log.service ? ` ${color}[${log.service}]${reset}` : "";
-    let output = `${timestamp} ${color}${log.level.toUpperCase()}${reset}${service} ${log.message}`;
-    if (log.metadata && Object.keys(log.metadata).length > 0) {
-      output += `
-  ${color}metadata:${reset} ${JSON.stringify(log.metadata, null, 2).replace(/\n/g, "\n  ")}`;
-    }
-    console.log(output);
-  }
-}
-
-class VedaTraceHttpTransport {
-  name = "http";
-  endpoint;
-  apiKey;
-  timeout;
-  headers;
-  keepalive;
-  constructor(config) {
-    this.apiKey = config.apiKey;
-    this.endpoint = config.endpoint ?? "https://ingest.vedatrace.dev/v1/logs";
-    this.timeout = config.timeout ?? 3e4;
-    this.headers = config.headers ?? {};
-    this.keepalive = config.keepalive ?? false;
-  }
-  /** Send logs via HTTP POST */
-  async send(logs) {
-    const controller = new AbortController();
-    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
-    const payload = logs.map((log) => ({
-      level: log.level,
-      message: log.message,
-      service: log.service,
-      timestamp: log.timestamp ? new Date(log.timestamp).toISOString() : void 0,
-      metadata: log.metadata
-    }));
-    try {
-      const response = await fetch(this.endpoint, {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json",
-          "X-API-Key": this.apiKey,
-          ...this.headers
-        },
-        body: JSON.stringify(payload),
-        signal: controller.signal,
-        keepalive: this.keepalive
-      });
-      clearTimeout(timeoutId);
-      if (!response.ok) {
-        const text = await response.text();
-        throw new Error(`HTTP ${response.status}: ${text}`);
-      }
-    } catch (error) {
-      clearTimeout(timeoutId);
-      if (error instanceof Error) {
-        if (error.name === "AbortError") {
-          throw new Error(`Request timeout after ${this.timeout}ms`);
-        }
-        throw error;
-      }
-      throw new Error(String(error));
-    }
-  }
-  /** Flush pending logs - called on page unload */
-  async flush() {
-    return Promise.resolve();
-  }
-  /** Check if keepalive is enabled */
-  isKeepaliveEnabled() {
-    return this.keepalive;
-  }
-  /** Enable/disable keepalive */
-  setKeepalive(enabled) {
-    this.keepalive = enabled;
-  }
-}
-class VedaTraceHttpTransportBrowser extends VedaTraceHttpTransport {
-  constructor(config) {
-    super({ ...config, keepalive: true });
-  }
-  async flush() {
-    this.setKeepalive(true);
-    return super.flush();
-  }
-}
-
-export { VedaTraceConsoleTransport, VedaTraceHttpTransport, VedaTraceHttpTransportBrowser };
+export { c as VedaTraceConsoleTransport, b as VedaTraceHttpTransport, V as VedaTraceHttpTransportBrowser } from '../index-BcBZY8as.mjs';

package/dist/{types-BU0UESs9.d.cts → types-CSBzeGyK.d.cts}

@@ -42,6 +42,12 @@ interface VedaTraceConfig {
     runtime?: RuntimeType;
     /** Cloudflare Workers ExecutionContext - enables waitUntil support */
     executionContext?: VedaTraceEdgeContext;
+    /**
+     * Global waitUntil function (e.g. from "cloudflare:workers").
+     * When provided, the SDK uses the reliable debounced-flush+waitUntil path
+     * instead of fire-and-forget, ensuring logs complete before worker termination.
+     */
+    waitUntil?: (promise: Promise<unknown>) => void;
 }
 interface RedactionConfig {
     paths?: string[];
@@ -78,6 +84,8 @@ interface BatcherConfig {
     executionContext?: VedaTraceEdgeContext;
     onError?: (error: Error) => void;
     onSuccess?: () => void;
+    debug?: boolean;
+    waitUntil?: (promise: Promise<unknown>) => void;
 }
 interface VedaTraceLoggerInterface {
     debug(message: string, metadata?: LogMetadata): void;

package/dist/{types-BU0UESs9.d.mts → types-CSBzeGyK.d.mts}

@@ -42,6 +42,12 @@ interface VedaTraceConfig {
     runtime?: RuntimeType;
     /** Cloudflare Workers ExecutionContext - enables waitUntil support */
     executionContext?: VedaTraceEdgeContext;
+    /**
+     * Global waitUntil function (e.g. from "cloudflare:workers").
+     * When provided, the SDK uses the reliable debounced-flush+waitUntil path
+     * instead of fire-and-forget, ensuring logs complete before worker termination.
+     */
+    waitUntil?: (promise: Promise<unknown>) => void;
 }
 interface RedactionConfig {
     paths?: string[];
@@ -78,6 +84,8 @@ interface BatcherConfig {
     executionContext?: VedaTraceEdgeContext;
     onError?: (error: Error) => void;
     onSuccess?: () => void;
+    debug?: boolean;
+    waitUntil?: (promise: Promise<unknown>) => void;
 }
 interface VedaTraceLoggerInterface {
     debug(message: string, metadata?: LogMetadata): void;