vedatrace 0.1.8 → 0.1.9

package/dist/index.cjs

@@ -5,13 +5,15 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var transports_index = require('./transports/index.cjs');
 
 class VedaTraceBatcher {
-  constructor(transports, config, onError, onSuccess, immediateFlush = false) {
+  constructor(transports, config, onError, onSuccess, immediateFlush = false, autoStart = false) {
     this.transports = transports;
     this.config = config;
     this.onError = onError;
     this.onSuccess = onSuccess;
     this.immediateFlush = immediateFlush;
-    this.startFlushTimer();
+    if (autoStart && !immediateFlush) {
+      this.startFlushTimer();
+    }
   }
   queue = [];
   flushTimer = null;
@@ -100,6 +102,12 @@ class VedaTraceBatcher {
       this.flushTimer = null;
     }
   }
+  /** Start the flush timer (for manual control in edge runtimes) */
+  start() {
+    if (!this.flushTimer && !this.immediateFlush) {
+      this.startFlushTimer();
+    }
+  }
   /** Delay helper */
   delay(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
@@ -110,12 +118,39 @@ class VedaTraceBatcher {
   }
 }
 
+function detectRuntime() {
+  if (typeof process !== "undefined" && process.versions?.node) {
+    return "node";
+  }
+  if (typeof globalThis !== "undefined" && "navigator" in globalThis && typeof self === "undefined") {
+    return "browser";
+  }
+  if (typeof caches !== "undefined") {
+    return "cloudflare";
+  }
+  const maybeDeno = globalThis;
+  if (maybeDeno?.version) {
+    return "deno";
+  }
+  const maybeBun = globalThis;
+  if (maybeBun?.Bun) {
+    return "bun";
+  }
+  return "edge";
+}
+function isEdgeRuntime() {
+  const runtime = detectRuntime();
+  return runtime === "cloudflare" || runtime === "deno" || runtime === "bun" || runtime === "edge";
+}
+
 const SDK_VERSION = "1.0.0";
 class VedaTraceLogger {
   batcher = null;
+  runtime;
   config;
   childDefaults;
   constructor(config = {}, childDefaults = {}) {
+    this.runtime = config.runtime ?? detectRuntime();
     this.childDefaults = childDefaults;
     this.config = {
       service: config.service,
@@ -238,7 +273,13 @@ class VedaTraceLogger {
       this.batcher.stop();
     }
   }
-  /** Detect runtime environment */
+  /** Start the flush timer (for manual control in edge runtimes) */
+  start() {
+    if (this.batcher) {
+      this.batcher.start();
+    }
+  }
+  /** Detect runtime environment (legacy, kept for compatibility) */
   detectEnvironment() {
     if (typeof globalThis !== "undefined" && "navigator" in globalThis) {
       return "browser";
@@ -326,6 +367,9 @@ function redactPii(value, mask) {
 
 function vedatrace(config = {}) {
   const logger = new VedaTraceLogger(config);
+  const isEdge = isEdgeRuntime();
+  const shouldImmediateFlush = config.immediateFlush ?? isEdge;
+  const shouldAutoStart = config.autoStart ?? !isEdge;
   if (config.apiKey && (!config.transports || config.transports.length === 0)) {
     const httpConfig = { apiKey: config.apiKey };
     if (config.endpoint) httpConfig.endpoint = config.endpoint;
@@ -334,13 +378,15 @@ function vedatrace(config = {}) {
       [httpTransport],
       {
         batchSize: config.batchSize ?? 100,
-        flushInterval: config.flushInterval ?? 1e3,
+        flushInterval: config.flushInterval ?? (isEdge ? 1e3 : 5e3),
         maxRetries: config.maxRetries ?? 3,
         retryDelay: config.retryDelay ?? 1e3,
         unrefTimer: config.unrefTimer
       },
       config.onError,
-      config.onSuccess
+      config.onSuccess,
+      shouldImmediateFlush,
+      shouldAutoStart
     );
     logger.setBatcher(batcher);
     if (typeof process !== "undefined") {
@@ -372,6 +418,8 @@ exports.VedaTraceHttpTransport = transports_index.VedaTraceHttpTransport;
 exports.VedaTraceBatcher = VedaTraceBatcher;
 exports.VedaTraceLogger = VedaTraceLogger;
 exports.default = vedatrace;
+exports.detectRuntime = detectRuntime;
 exports.devVedatrace = devVedatrace;
+exports.isEdgeRuntime = isEdgeRuntime;
 exports.redact = redact;
 exports.vedatrace = vedatrace;

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { b as VedaTraceTransport, B as BatcherConfig, I as InternalLogEntry, V as VedaTraceLoggerInterface, a as VedaTraceConfig, L as LogMetadata, R as RedactionConfig } from './types-CcdFb-vY.cjs';
-export { c as VedaTraceLevel, d as VedaTraceLog } from './types-CcdFb-vY.cjs';
+import { b as VedaTraceTransport, B as BatcherConfig, I as InternalLogEntry, V as VedaTraceLoggerInterface, R as RuntimeType$1, a as VedaTraceConfig, L as LogMetadata, c as RedactionConfig } from './types-DUNRMOTv.cjs';
+export { d as VedaTraceLevel, e as VedaTraceLog } from './types-DUNRMOTv.cjs';
 export { ConsoleFormat, ConsoleTransportConfig, HttpTransportConfig, VedaTraceConsoleTransport, VedaTraceHttpTransport } from './transports/index.cjs';
 
 /**
@@ -17,7 +17,7 @@ declare class VedaTraceBatcher {
     private flushTimer;
     private isFlushing;
     private pendingFlush;
-    constructor(transports: VedaTraceTransport[], config: BatcherConfig, onError?: ((error: Error) => void) | undefined, onSuccess?: (() => void) | undefined, immediateFlush?: boolean);
+    constructor(transports: VedaTraceTransport[], config: BatcherConfig, onError?: ((error: Error) => void) | undefined, onSuccess?: (() => void) | undefined, immediateFlush?: boolean, autoStart?: boolean);
     /** Add log to queue */
     add(log: InternalLogEntry): void;
     /** Flush logs to all transports */
@@ -28,6 +28,8 @@ declare class VedaTraceBatcher {
     private startFlushTimer;
     /** Stop the flush timer */
     stop(): void;
+    /** Start the flush timer (for manual control in edge runtimes) */
+    start(): void;
     /** Delay helper */
     private delay;
     /** Get current queue size */
@@ -40,6 +42,7 @@ declare class VedaTraceBatcher {
 
 declare class VedaTraceLogger implements VedaTraceLoggerInterface {
     private batcher;
+    runtime: RuntimeType$1;
     private config;
     private childDefaults;
     constructor(config?: VedaTraceConfig, childDefaults?: LogMetadata);
@@ -65,7 +68,9 @@ declare class VedaTraceLogger implements VedaTraceLoggerInterface {
     flush(): Promise<void>;
     /** Stop the batcher and flush timer */
     stop(): void;
-    /** Detect runtime environment */
+    /** Start the flush timer (for manual control in edge runtimes) */
+    start(): void;
+    /** Detect runtime environment (legacy, kept for compatibility) */
     private detectEnvironment;
 }
 
@@ -78,6 +83,14 @@ declare class VedaTraceLogger implements VedaTraceLoggerInterface {
  */
 declare function redact(obj: unknown, config?: RedactionConfig): unknown;
 
+/**
+ * Runtime environment detection utility
+ * Detects Node.js, Browser, Cloudflare Workers, Deno, Bun
+ */
+type RuntimeType = "node" | "browser" | "cloudflare" | "deno" | "bun" | "edge";
+declare function detectRuntime(): RuntimeType;
+declare function isEdgeRuntime(): boolean;
+
 /**
  * VedaTrace SDK - Universal JavaScript logging
  *
@@ -112,4 +125,4 @@ declare function vedatrace(config?: VedaTraceConfig): VedaTraceLoggerInterface;
  */
 declare function devVedatrace(config?: Omit<VedaTraceConfig, "apiKey" | "transports">): VedaTraceLoggerInterface;
 
-export { BatcherConfig, InternalLogEntry, LogMetadata, RedactionConfig, VedaTraceBatcher, VedaTraceConfig, VedaTraceLogger, VedaTraceLoggerInterface, VedaTraceTransport, vedatrace as default, devVedatrace, redact, vedatrace };
+export { BatcherConfig, InternalLogEntry, LogMetadata, RedactionConfig, RuntimeType$1 as RuntimeType, VedaTraceBatcher, VedaTraceConfig, VedaTraceLogger, VedaTraceLoggerInterface, VedaTraceTransport, vedatrace as default, detectRuntime, devVedatrace, isEdgeRuntime, redact, vedatrace };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { b as VedaTraceTransport, B as BatcherConfig, I as InternalLogEntry, V as VedaTraceLoggerInterface, a as VedaTraceConfig, L as LogMetadata, R as RedactionConfig } from './types-CcdFb-vY.mjs';
-export { c as VedaTraceLevel, d as VedaTraceLog } from './types-CcdFb-vY.mjs';
+import { b as VedaTraceTransport, B as BatcherConfig, I as InternalLogEntry, V as VedaTraceLoggerInterface, R as RuntimeType$1, a as VedaTraceConfig, L as LogMetadata, c as RedactionConfig } from './types-DUNRMOTv.mjs';
+export { d as VedaTraceLevel, e as VedaTraceLog } from './types-DUNRMOTv.mjs';
 export { ConsoleFormat, ConsoleTransportConfig, HttpTransportConfig, VedaTraceConsoleTransport, VedaTraceHttpTransport } from './transports/index.mjs';
 
 /**
@@ -17,7 +17,7 @@ declare class VedaTraceBatcher {
     private flushTimer;
     private isFlushing;
     private pendingFlush;
-    constructor(transports: VedaTraceTransport[], config: BatcherConfig, onError?: ((error: Error) => void) | undefined, onSuccess?: (() => void) | undefined, immediateFlush?: boolean);
+    constructor(transports: VedaTraceTransport[], config: BatcherConfig, onError?: ((error: Error) => void) | undefined, onSuccess?: (() => void) | undefined, immediateFlush?: boolean, autoStart?: boolean);
     /** Add log to queue */
     add(log: InternalLogEntry): void;
     /** Flush logs to all transports */
@@ -28,6 +28,8 @@ declare class VedaTraceBatcher {
     private startFlushTimer;
     /** Stop the flush timer */
     stop(): void;
+    /** Start the flush timer (for manual control in edge runtimes) */
+    start(): void;
     /** Delay helper */
     private delay;
     /** Get current queue size */
@@ -40,6 +42,7 @@ declare class VedaTraceBatcher {
 
 declare class VedaTraceLogger implements VedaTraceLoggerInterface {
     private batcher;
+    runtime: RuntimeType$1;
     private config;
     private childDefaults;
     constructor(config?: VedaTraceConfig, childDefaults?: LogMetadata);
@@ -65,7 +68,9 @@ declare class VedaTraceLogger implements VedaTraceLoggerInterface {
     flush(): Promise<void>;
     /** Stop the batcher and flush timer */
     stop(): void;
-    /** Detect runtime environment */
+    /** Start the flush timer (for manual control in edge runtimes) */
+    start(): void;
+    /** Detect runtime environment (legacy, kept for compatibility) */
     private detectEnvironment;
 }
 
@@ -78,6 +83,14 @@ declare class VedaTraceLogger implements VedaTraceLoggerInterface {
  */
 declare function redact(obj: unknown, config?: RedactionConfig): unknown;
 
+/**
+ * Runtime environment detection utility
+ * Detects Node.js, Browser, Cloudflare Workers, Deno, Bun
+ */
+type RuntimeType = "node" | "browser" | "cloudflare" | "deno" | "bun" | "edge";
+declare function detectRuntime(): RuntimeType;
+declare function isEdgeRuntime(): boolean;
+
 /**
  * VedaTrace SDK - Universal JavaScript logging
  *
@@ -112,4 +125,4 @@ declare function vedatrace(config?: VedaTraceConfig): VedaTraceLoggerInterface;
  */
 declare function devVedatrace(config?: Omit<VedaTraceConfig, "apiKey" | "transports">): VedaTraceLoggerInterface;
 
-export { BatcherConfig, InternalLogEntry, LogMetadata, RedactionConfig, VedaTraceBatcher, VedaTraceConfig, VedaTraceLogger, VedaTraceLoggerInterface, VedaTraceTransport, vedatrace as default, devVedatrace, redact, vedatrace };
+export { BatcherConfig, InternalLogEntry, LogMetadata, RedactionConfig, RuntimeType$1 as RuntimeType, VedaTraceBatcher, VedaTraceConfig, VedaTraceLogger, VedaTraceLoggerInterface, VedaTraceTransport, vedatrace as default, detectRuntime, devVedatrace, isEdgeRuntime, redact, vedatrace };

package/dist/index.mjs

@@ -1,13 +1,15 @@
 import { VedaTraceHttpTransport, VedaTraceConsoleTransport } from './transports/index.mjs';
 
 class VedaTraceBatcher {
-  constructor(transports, config, onError, onSuccess, immediateFlush = false) {
+  constructor(transports, config, onError, onSuccess, immediateFlush = false, autoStart = false) {
     this.transports = transports;
     this.config = config;
     this.onError = onError;
     this.onSuccess = onSuccess;
     this.immediateFlush = immediateFlush;
-    this.startFlushTimer();
+    if (autoStart && !immediateFlush) {
+      this.startFlushTimer();
+    }
   }
   queue = [];
   flushTimer = null;
@@ -96,6 +98,12 @@ class VedaTraceBatcher {
       this.flushTimer = null;
     }
   }
+  /** Start the flush timer (for manual control in edge runtimes) */
+  start() {
+    if (!this.flushTimer && !this.immediateFlush) {
+      this.startFlushTimer();
+    }
+  }
   /** Delay helper */
   delay(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
@@ -106,12 +114,39 @@ class VedaTraceBatcher {
   }
 }
 
+function detectRuntime() {
+  if (typeof process !== "undefined" && process.versions?.node) {
+    return "node";
+  }
+  if (typeof globalThis !== "undefined" && "navigator" in globalThis && typeof self === "undefined") {
+    return "browser";
+  }
+  if (typeof caches !== "undefined") {
+    return "cloudflare";
+  }
+  const maybeDeno = globalThis;
+  if (maybeDeno?.version) {
+    return "deno";
+  }
+  const maybeBun = globalThis;
+  if (maybeBun?.Bun) {
+    return "bun";
+  }
+  return "edge";
+}
+function isEdgeRuntime() {
+  const runtime = detectRuntime();
+  return runtime === "cloudflare" || runtime === "deno" || runtime === "bun" || runtime === "edge";
+}
+
 const SDK_VERSION = "1.0.0";
 class VedaTraceLogger {
   batcher = null;
+  runtime;
   config;
   childDefaults;
   constructor(config = {}, childDefaults = {}) {
+    this.runtime = config.runtime ?? detectRuntime();
     this.childDefaults = childDefaults;
     this.config = {
       service: config.service,
@@ -234,7 +269,13 @@ class VedaTraceLogger {
       this.batcher.stop();
     }
   }
-  /** Detect runtime environment */
+  /** Start the flush timer (for manual control in edge runtimes) */
+  start() {
+    if (this.batcher) {
+      this.batcher.start();
+    }
+  }
+  /** Detect runtime environment (legacy, kept for compatibility) */
   detectEnvironment() {
     if (typeof globalThis !== "undefined" && "navigator" in globalThis) {
       return "browser";
@@ -322,6 +363,9 @@ function redactPii(value, mask) {
 
 function vedatrace(config = {}) {
   const logger = new VedaTraceLogger(config);
+  const isEdge = isEdgeRuntime();
+  const shouldImmediateFlush = config.immediateFlush ?? isEdge;
+  const shouldAutoStart = config.autoStart ?? !isEdge;
   if (config.apiKey && (!config.transports || config.transports.length === 0)) {
     const httpConfig = { apiKey: config.apiKey };
     if (config.endpoint) httpConfig.endpoint = config.endpoint;
@@ -330,13 +374,15 @@ function vedatrace(config = {}) {
       [httpTransport],
       {
         batchSize: config.batchSize ?? 100,
-        flushInterval: config.flushInterval ?? 1e3,
+        flushInterval: config.flushInterval ?? (isEdge ? 1e3 : 5e3),
         maxRetries: config.maxRetries ?? 3,
         retryDelay: config.retryDelay ?? 1e3,
         unrefTimer: config.unrefTimer
       },
       config.onError,
-      config.onSuccess
+      config.onSuccess,
+      shouldImmediateFlush,
+      shouldAutoStart
     );
     logger.setBatcher(batcher);
     if (typeof process !== "undefined") {
@@ -363,4 +409,4 @@ function devVedatrace(config = {}) {
   });
 }
 
-export { VedaTraceBatcher, VedaTraceConsoleTransport, VedaTraceHttpTransport, VedaTraceLogger, vedatrace as default, devVedatrace, redact, vedatrace };
+export { VedaTraceBatcher, VedaTraceConsoleTransport, VedaTraceHttpTransport, VedaTraceLogger, vedatrace as default, detectRuntime, devVedatrace, isEdgeRuntime, redact, vedatrace };

package/dist/integrations/express.d.cts

@@ -1,5 +1,5 @@
 import { Request, Response, NextFunction } from 'express';
-import { V as VedaTraceLoggerInterface, a as VedaTraceConfig, L as LogMetadata } from '../types-CcdFb-vY.cjs';
+import { V as VedaTraceLoggerInterface, a as VedaTraceConfig, L as LogMetadata } from '../types-DUNRMOTv.cjs';
 
 /**
  * Express.js middleware integration for VedaTrace

package/dist/integrations/express.d.mts

@@ -1,5 +1,5 @@
 import { Request, Response, NextFunction } from 'express';
-import { V as VedaTraceLoggerInterface, a as VedaTraceConfig, L as LogMetadata } from '../types-CcdFb-vY.mjs';
+import { V as VedaTraceLoggerInterface, a as VedaTraceConfig, L as LogMetadata } from '../types-DUNRMOTv.mjs';
 
 /**
  * Express.js middleware integration for VedaTrace

package/dist/integrations/nextjs.d.cts

@@ -1,4 +1,4 @@
-import { a as VedaTraceConfig, L as LogMetadata, V as VedaTraceLoggerInterface } from '../types-CcdFb-vY.cjs';
+import { a as VedaTraceConfig, L as LogMetadata, V as VedaTraceLoggerInterface } from '../types-DUNRMOTv.cjs';
 
 /**
  * Next.js integration for VedaTrace

package/dist/integrations/nextjs.d.mts

@@ -1,4 +1,4 @@
-import { a as VedaTraceConfig, L as LogMetadata, V as VedaTraceLoggerInterface } from '../types-CcdFb-vY.mjs';
+import { a as VedaTraceConfig, L as LogMetadata, V as VedaTraceLoggerInterface } from '../types-DUNRMOTv.mjs';
 
 /**
  * Next.js integration for VedaTrace

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-CcdFb-vY.cjs';
+import { a as VedaTraceConfig, V as VedaTraceLoggerInterface, L as LogMetadata } from '../types-DUNRMOTv.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-CcdFb-vY.mjs';
+import { a as VedaTraceConfig, V as VedaTraceLoggerInterface, L as LogMetadata } from '../types-DUNRMOTv.mjs';
 
 /**
  * React integration for VedaTrace

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 { d as VedaTraceLevel, b as VedaTraceTransport, I as InternalLogEntry } from '../types-DUNRMOTv.cjs';
 
 /**
  * Console transport for development/debugging

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 { d as VedaTraceLevel, b as VedaTraceTransport, I as InternalLogEntry } from '../types-DUNRMOTv.mjs';
 
 /**
  * Console transport for development/debugging

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

@@ -51,6 +51,10 @@ interface VedaTraceConfig {
     immediateFlush?: boolean;
     /** Unref the flush timer (Node.js only, default: false) */
     unrefTimer?: boolean;
+    /** Auto-start the flush timer (default: true, auto-disabled for edge runtimes) */
+    autoStart?: boolean;
+    /** Force a specific runtime (auto-detected by default) */
+    runtime?: RuntimeType;
 }
 /** Redaction configuration */
 interface RedactionConfig {
@@ -61,6 +65,8 @@ interface RedactionConfig {
     /** Enable automatic PII detection */
     autoDetectPii?: boolean;
 }
+/** Runtime environment type */
+type RuntimeType = "node" | "browser" | "cloudflare" | "deno" | "bun" | "edge";
 /** Transport interface for sending logs */
 interface VedaTraceTransport {
     /** Transport name */
@@ -112,6 +118,8 @@ interface VedaTraceLoggerInterface {
     child(defaults: LogMetadata): VedaTraceLoggerInterface;
     flush(): Promise<void>;
     stop(): void;
+    start(): void;
+    runtime: RuntimeType;
 }
 
-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, RedactionConfig as c, VedaTraceLevel as d, VedaTraceLog as e };

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

@@ -51,6 +51,10 @@ interface VedaTraceConfig {
     immediateFlush?: boolean;
     /** Unref the flush timer (Node.js only, default: false) */
     unrefTimer?: boolean;
+    /** Auto-start the flush timer (default: true, auto-disabled for edge runtimes) */
+    autoStart?: boolean;
+    /** Force a specific runtime (auto-detected by default) */
+    runtime?: RuntimeType;
 }
 /** Redaction configuration */
 interface RedactionConfig {
@@ -61,6 +65,8 @@ interface RedactionConfig {
     /** Enable automatic PII detection */
     autoDetectPii?: boolean;
 }
+/** Runtime environment type */
+type RuntimeType = "node" | "browser" | "cloudflare" | "deno" | "bun" | "edge";
 /** Transport interface for sending logs */
 interface VedaTraceTransport {
     /** Transport name */
@@ -112,6 +118,8 @@ interface VedaTraceLoggerInterface {
     child(defaults: LogMetadata): VedaTraceLoggerInterface;
     flush(): Promise<void>;
     stop(): void;
+    start(): void;
+    runtime: RuntimeType;
 }
 
-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, RedactionConfig as c, VedaTraceLevel as d, VedaTraceLog as e };

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "vedatrace",
 	"description": "Universal JavaScript logging SDK for VedaTrace - type-safe, lightweight, and developer-friendly",
-	"version": "0.1.8",
+	"version": "0.1.9",
 	"scripts": {
 		"setup": "rm -rf node_modules && npm i && git init && husky",
 		"prepublishOnly": "npm run build",