vedatrace 0.1.8 → 0.2.0

package/dist/transports/index.d.cts

@@ -1,4 +1,4 @@
-import { c as VedaTraceLevel, b as VedaTraceTransport, I as InternalLogEntry } from '../types-CcdFb-vY.cjs';
+import { e as VedaTraceLevel, b as VedaTraceTransport, I as InternalLogEntry } from '../types-BU0UESs9.cjs';
 
 /**
  * Console transport for development/debugging
@@ -31,17 +31,20 @@ declare class VedaTraceConsoleTransport implements VedaTraceTransport {
 
 /**
  * HTTP transport for sending logs to VedaTrace ingestion endpoint
+ *
+ * Features:
+ * - Timeout support with AbortController
+ * - Retry on network failure
+ * - Keepalive support for browser final flush
  */
 
 interface HttpTransportConfig {
-    /** API key for authentication */
     apiKey: string;
-    /** Ingestion endpoint URL */
     endpoint?: string;
-    /** Request timeout in milliseconds */
     timeout?: number;
-    /** Additional headers */
     headers?: Record<string, string>;
+    /** Enable keepalive for browser final flush */
+    keepalive?: boolean;
 }
 declare class VedaTraceHttpTransport implements VedaTraceTransport {
     readonly name = "http";
@@ -49,10 +52,24 @@ declare class VedaTraceHttpTransport implements VedaTraceTransport {
     private apiKey;
     private timeout;
     private headers;
+    private keepalive;
     constructor(config: HttpTransportConfig);
     /** Send logs via HTTP POST */
     send(logs: InternalLogEntry[]): Promise<void>;
+    /** Flush pending logs - called on page unload */
+    flush(): Promise<void>;
+    /** Check if keepalive is enabled */
+    isKeepaliveEnabled(): boolean;
+    /** Enable/disable keepalive */
+    setKeepalive(enabled: boolean): void;
+}
+/**
+ * Browser-safe HTTP transport that uses keepalive for final flush
+ */
+declare class VedaTraceHttpTransportBrowser extends VedaTraceHttpTransport {
+    constructor(config: HttpTransportConfig);
+    flush(): Promise<void>;
 }
 
-export { VedaTraceConsoleTransport, VedaTraceHttpTransport };
+export { VedaTraceConsoleTransport, VedaTraceHttpTransport, VedaTraceHttpTransportBrowser };
 export type { ConsoleFormat, ConsoleTransportConfig, HttpTransportConfig };

package/dist/transports/index.d.mts

@@ -1,4 +1,4 @@
-import { c as VedaTraceLevel, b as VedaTraceTransport, I as InternalLogEntry } from '../types-CcdFb-vY.mjs';
+import { e as VedaTraceLevel, b as VedaTraceTransport, I as InternalLogEntry } from '../types-BU0UESs9.mjs';
 
 /**
  * Console transport for development/debugging
@@ -31,17 +31,20 @@ declare class VedaTraceConsoleTransport implements VedaTraceTransport {
 
 /**
  * HTTP transport for sending logs to VedaTrace ingestion endpoint
+ *
+ * Features:
+ * - Timeout support with AbortController
+ * - Retry on network failure
+ * - Keepalive support for browser final flush
  */
 
 interface HttpTransportConfig {
-    /** API key for authentication */
     apiKey: string;
-    /** Ingestion endpoint URL */
     endpoint?: string;
-    /** Request timeout in milliseconds */
     timeout?: number;
-    /** Additional headers */
     headers?: Record<string, string>;
+    /** Enable keepalive for browser final flush */
+    keepalive?: boolean;
 }
 declare class VedaTraceHttpTransport implements VedaTraceTransport {
     readonly name = "http";
@@ -49,10 +52,24 @@ declare class VedaTraceHttpTransport implements VedaTraceTransport {
     private apiKey;
     private timeout;
     private headers;
+    private keepalive;
     constructor(config: HttpTransportConfig);
     /** Send logs via HTTP POST */
     send(logs: InternalLogEntry[]): Promise<void>;
+    /** Flush pending logs - called on page unload */
+    flush(): Promise<void>;
+    /** Check if keepalive is enabled */
+    isKeepaliveEnabled(): boolean;
+    /** Enable/disable keepalive */
+    setKeepalive(enabled: boolean): void;
+}
+/**
+ * Browser-safe HTTP transport that uses keepalive for final flush
+ */
+declare class VedaTraceHttpTransportBrowser extends VedaTraceHttpTransport {
+    constructor(config: HttpTransportConfig);
+    flush(): Promise<void>;
 }
 
-export { VedaTraceConsoleTransport, VedaTraceHttpTransport };
+export { VedaTraceConsoleTransport, VedaTraceHttpTransport, VedaTraceHttpTransportBrowser };
 export type { ConsoleFormat, ConsoleTransportConfig, HttpTransportConfig };

package/dist/transports/index.mjs

@@ -80,11 +80,13 @@ class VedaTraceHttpTransport {
   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) {
@@ -106,7 +108,8 @@ class VedaTraceHttpTransport {
           ...this.headers
         },
         body: JSON.stringify(payload),
-        signal: controller.signal
+        signal: controller.signal,
+        keepalive: this.keepalive
       });
       clearTimeout(timeoutId);
       if (!response.ok) {
@@ -124,6 +127,27 @@ class VedaTraceHttpTransport {
       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 };
+export { VedaTraceConsoleTransport, VedaTraceHttpTransport, VedaTraceHttpTransportBrowser };

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

@@ -6,103 +6,79 @@
 type VedaTraceLevel = "debug" | "info" | "warn" | "error" | "fatal";
 /** Log entry structure matching ingestion API */
 interface VedaTraceLog {
-    /** Log severity level */
     level: VedaTraceLevel;
-    /** Log message */
     message: string;
-    /** Service name (optional, can override default) */
     service?: string;
-    /** Unix timestamp in milliseconds (optional, auto-generated if not provided) */
     timestamp?: number;
-    /** Arbitrary metadata object */
     metadata?: Record<string, unknown>;
 }
+/**
+ * Generic Edge Context interface for Cloudflare Workers / Pages / etc.
+ * This avoids importing heavy framework-specific types and works with any
+ * environment that provides a waitUntil() method.
+ */
+interface VedaTraceEdgeContext {
+    waitUntil(promise: Promise<unknown>): void;
+}
 /** Configuration options for VedaTrace SDK */
 interface VedaTraceConfig {
-    /** API key for authentication */
     apiKey?: string;
-    /** Default service name for all logs */
     service?: string;
-    /** Ingestion endpoint URL */
     endpoint?: string;
-    /** Environment identifier */
     environment?: "production" | "staging" | "development" | string;
-    /** Batch size before flushing (default: 100) */
     batchSize?: number;
-    /** Flush interval in milliseconds (default: 5000) */
     flushInterval?: number;
-    /** Maximum retry attempts for failed requests (default: 3) */
     maxRetries?: number;
-    /** Delay between retries in milliseconds (default: 1000) */
     retryDelay?: number;
-    /** Redaction configuration for PII */
     redaction?: RedactionConfig;
-    /** Custom transports (defaults to HTTP if apiKey provided) */
     transports?: VedaTraceTransport[];
-    /** Callback for transport errors */
     onError?: (error: Error) => void;
-    /** Callback for successful sends */
     onSuccess?: () => void;
-    /** Disable logging entirely */
     disabled?: boolean;
-    /** Enable debug mode (verbose console output) */
     debug?: boolean;
-    /** Flush immediately after each log (for console/dev mode) */
     immediateFlush?: boolean;
-    /** Unref the flush timer (Node.js only, default: false) */
     unrefTimer?: boolean;
+    autoStart?: boolean;
+    runtime?: RuntimeType;
+    /** Cloudflare Workers ExecutionContext - enables waitUntil support */
+    executionContext?: VedaTraceEdgeContext;
 }
-/** Redaction configuration */
 interface RedactionConfig {
-    /** Field paths to redact (e.g., ['password', 'user.token']) */
     paths?: string[];
-    /** Custom redaction mask (default: '[REDACTED]') */
     mask?: string;
-    /** Enable automatic PII detection */
     autoDetectPii?: boolean;
 }
-/** Transport interface for sending logs */
+type RuntimeType = "node" | "browser" | "cloudflare" | "deno" | "bun" | "edge";
 interface VedaTraceTransport {
-    /** Transport name */
     name: string;
-    /** Send logs to destination */
     send(logs: InternalLogEntry[]): Promise<void> | void;
-    /** Flush any pending logs */
     flush?(): Promise<void>;
 }
-/** Metadata that can be passed to log methods */
 interface LogMetadata {
-    /** Override default service name */
     service?: string;
-    /** Any other metadata fields */
     [key: string]: unknown;
 }
-/** Internal log entry with SDK metadata */
 interface InternalLogEntry extends VedaTraceLog {
-    /** SDK-generated fields */
     _sdk?: {
-        /** Source of the log (node, browser, edge) */
         source?: string;
-        /** SDK version */
         version?: string;
-        /** Error stack trace if log is an error */
         stackTrace?: string;
-        /** Browser info */
         browser?: {
             userAgent?: string;
             url?: string;
         };
     };
 }
-/** Batcher configuration */
 interface BatcherConfig {
     batchSize: number;
     flushInterval: number;
     maxRetries: number;
     retryDelay: number;
     unrefTimer?: boolean;
+    executionContext?: VedaTraceEdgeContext;
+    onError?: (error: Error) => void;
+    onSuccess?: () => void;
 }
-/** Logger interface */
 interface VedaTraceLoggerInterface {
     debug(message: string, metadata?: LogMetadata): void;
     info(message: string, metadata?: LogMetadata): void;
@@ -112,6 +88,14 @@ interface VedaTraceLoggerInterface {
     child(defaults: LogMetadata): VedaTraceLoggerInterface;
     flush(): Promise<void>;
     stop(): void;
+    start(): void;
+    runtime: RuntimeType;
+    /** Attach execution context for waitUntil support (Cloudflare Workers) */
+    withContext(ctx: VedaTraceEdgeContext): this;
+    /** Check if context is attached */
+    hasContext(): boolean;
+    /** Get current execution context */
+    getContext(): VedaTraceEdgeContext | undefined;
 }
 
-export type { BatcherConfig as B, InternalLogEntry as I, LogMetadata as L, RedactionConfig as R, VedaTraceLoggerInterface as V, VedaTraceConfig as a, VedaTraceTransport as b, VedaTraceLevel as c, VedaTraceLog as d };
+export type { BatcherConfig as B, InternalLogEntry as I, LogMetadata as L, RuntimeType as R, VedaTraceLoggerInterface as V, VedaTraceConfig as a, VedaTraceTransport as b, VedaTraceEdgeContext as c, RedactionConfig as d, VedaTraceLevel as e, VedaTraceLog as f };

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

@@ -6,103 +6,79 @@
 type VedaTraceLevel = "debug" | "info" | "warn" | "error" | "fatal";
 /** Log entry structure matching ingestion API */
 interface VedaTraceLog {
-    /** Log severity level */
     level: VedaTraceLevel;
-    /** Log message */
     message: string;
-    /** Service name (optional, can override default) */
     service?: string;
-    /** Unix timestamp in milliseconds (optional, auto-generated if not provided) */
     timestamp?: number;
-    /** Arbitrary metadata object */
     metadata?: Record<string, unknown>;
 }
+/**
+ * Generic Edge Context interface for Cloudflare Workers / Pages / etc.
+ * This avoids importing heavy framework-specific types and works with any
+ * environment that provides a waitUntil() method.
+ */
+interface VedaTraceEdgeContext {
+    waitUntil(promise: Promise<unknown>): void;
+}
 /** Configuration options for VedaTrace SDK */
 interface VedaTraceConfig {
-    /** API key for authentication */
     apiKey?: string;
-    /** Default service name for all logs */
     service?: string;
-    /** Ingestion endpoint URL */
     endpoint?: string;
-    /** Environment identifier */
     environment?: "production" | "staging" | "development" | string;
-    /** Batch size before flushing (default: 100) */
     batchSize?: number;
-    /** Flush interval in milliseconds (default: 5000) */
     flushInterval?: number;
-    /** Maximum retry attempts for failed requests (default: 3) */
     maxRetries?: number;
-    /** Delay between retries in milliseconds (default: 1000) */
     retryDelay?: number;
-    /** Redaction configuration for PII */
     redaction?: RedactionConfig;
-    /** Custom transports (defaults to HTTP if apiKey provided) */
     transports?: VedaTraceTransport[];
-    /** Callback for transport errors */
     onError?: (error: Error) => void;
-    /** Callback for successful sends */
     onSuccess?: () => void;
-    /** Disable logging entirely */
     disabled?: boolean;
-    /** Enable debug mode (verbose console output) */
     debug?: boolean;
-    /** Flush immediately after each log (for console/dev mode) */
     immediateFlush?: boolean;
-    /** Unref the flush timer (Node.js only, default: false) */
     unrefTimer?: boolean;
+    autoStart?: boolean;
+    runtime?: RuntimeType;
+    /** Cloudflare Workers ExecutionContext - enables waitUntil support */
+    executionContext?: VedaTraceEdgeContext;
 }
-/** Redaction configuration */
 interface RedactionConfig {
-    /** Field paths to redact (e.g., ['password', 'user.token']) */
     paths?: string[];
-    /** Custom redaction mask (default: '[REDACTED]') */
     mask?: string;
-    /** Enable automatic PII detection */
     autoDetectPii?: boolean;
 }
-/** Transport interface for sending logs */
+type RuntimeType = "node" | "browser" | "cloudflare" | "deno" | "bun" | "edge";
 interface VedaTraceTransport {
-    /** Transport name */
     name: string;
-    /** Send logs to destination */
     send(logs: InternalLogEntry[]): Promise<void> | void;
-    /** Flush any pending logs */
     flush?(): Promise<void>;
 }
-/** Metadata that can be passed to log methods */
 interface LogMetadata {
-    /** Override default service name */
     service?: string;
-    /** Any other metadata fields */
     [key: string]: unknown;
 }
-/** Internal log entry with SDK metadata */
 interface InternalLogEntry extends VedaTraceLog {
-    /** SDK-generated fields */
     _sdk?: {
-        /** Source of the log (node, browser, edge) */
         source?: string;
-        /** SDK version */
         version?: string;
-        /** Error stack trace if log is an error */
         stackTrace?: string;
-        /** Browser info */
         browser?: {
             userAgent?: string;
             url?: string;
         };
     };
 }
-/** Batcher configuration */
 interface BatcherConfig {
     batchSize: number;
     flushInterval: number;
     maxRetries: number;
     retryDelay: number;
     unrefTimer?: boolean;
+    executionContext?: VedaTraceEdgeContext;
+    onError?: (error: Error) => void;
+    onSuccess?: () => void;
 }
-/** Logger interface */
 interface VedaTraceLoggerInterface {
     debug(message: string, metadata?: LogMetadata): void;
     info(message: string, metadata?: LogMetadata): void;
@@ -112,6 +88,14 @@ interface VedaTraceLoggerInterface {
     child(defaults: LogMetadata): VedaTraceLoggerInterface;
     flush(): Promise<void>;
     stop(): void;
+    start(): void;
+    runtime: RuntimeType;
+    /** Attach execution context for waitUntil support (Cloudflare Workers) */
+    withContext(ctx: VedaTraceEdgeContext): this;
+    /** Check if context is attached */
+    hasContext(): boolean;
+    /** Get current execution context */
+    getContext(): VedaTraceEdgeContext | undefined;
 }
 
-export type { BatcherConfig as B, InternalLogEntry as I, LogMetadata as L, RedactionConfig as R, VedaTraceLoggerInterface as V, VedaTraceConfig as a, VedaTraceTransport as b, VedaTraceLevel as c, VedaTraceLog as d };
+export type { BatcherConfig as B, InternalLogEntry as I, LogMetadata as L, RuntimeType as R, VedaTraceLoggerInterface as V, VedaTraceConfig as a, VedaTraceTransport as b, VedaTraceEdgeContext as c, RedactionConfig as d, VedaTraceLevel as e, VedaTraceLog as f };

package/package.json

@@ -1,13 +1,13 @@
 {
 	"name": "vedatrace",
 	"description": "Universal JavaScript logging SDK for VedaTrace - type-safe, lightweight, and developer-friendly",
-	"version": "0.1.8",
+	"version": "0.2.0",
 	"scripts": {
 		"setup": "rm -rf node_modules && npm i && git init && husky",
 		"prepublishOnly": "npm run build",
 		"build": "pkgroll --clean-dist",
 		"test": "vitest --run",
-		"lint": "npx @biomejs/biome check --write",
+		"lint": "bunx @biomejs/biome check --write",
 		"changeset": "changeset",
 		"version": "changeset version",
 		"release": "bun run build && changeset publish",