@tracelog/lib 0.2.2 → 0.3.0

package/README.md

@@ -107,6 +107,12 @@ await tracelog.init({
 
 ## Configuration
 
+**Disabling TraceLog:**
+```typescript
+// Set this flag before initialization to disable TraceLog completely
+window.__traceLogDisabled = true;
+```
+
 **Environment-based settings:**
 - Use `samplingRate: 0.1` to reduce data volume in high-traffic applications
 - Configure `sessionTimeout` to match your application's user session length

package/dist/browser/tracelog.js

@@ -2399,30 +2399,32 @@ let g = null, C = !1, q = !1;
 const sr = async (r) => {
   if (typeof window > "u" || typeof document > "u")
     throw new Error("This library can only be used in a browser environment");
-  if (g) {
-    a.debug("API", "Library already initialized, skipping duplicate initialization");
-    return;
-  }
-  if (C)
-    throw a.warn("API", "Initialization already in progress"), new Error("Initialization already in progress");
-  C = !0;
-  try {
-    a.info("API", "Initializing TraceLog", { projectId: r.id });
-    const e = Lt(r), t = new nr();
+  if (!window.__traceLogDisabled) {
+    if (g) {
+      a.debug("API", "Library already initialized, skipping duplicate initialization");
+      return;
+    }
+    if (C)
+      throw a.warn("API", "Initialization already in progress"), new Error("Initialization already in progress");
+    C = !0;
     try {
-      await t.init(e), g = t, a.info("API", "TraceLog initialized successfully", { projectId: e.id });
-    } catch (n) {
+      a.info("API", "Initializing TraceLog", { projectId: r.id });
+      const e = Lt(r), t = new nr();
       try {
-        await t.destroy(!0);
-      } catch (s) {
-        a.warn("API", "Failed to cleanup partially initialized app", { cleanupError: s });
+        await t.init(e), g = t, a.info("API", "TraceLog initialized successfully", { projectId: e.id });
+      } catch (n) {
+        try {
+          await t.destroy(!0);
+        } catch (s) {
+          a.warn("API", "Failed to cleanup partially initialized app", { cleanupError: s });
+        }
+        throw n;
       }
-      throw n;
+    } catch (e) {
+      throw g = null, a.error("API", "Initialization failed", { error: e }), e;
+    } finally {
+      C = !1;
     }
-  } catch (e) {
-    throw g = null, a.error("API", "Initialization failed", { error: e }), e;
-  } finally {
-    C = !1;
   }
 }, ir = (r, e) => {
   if (!g)

package/dist/cjs/api.js

@@ -21,6 +21,10 @@ const init = async (appConfig) => {
     if (typeof window === 'undefined' || typeof document === 'undefined') {
         throw new Error('This library can only be used in a browser environment');
     }
+    // Check if TraceLog is disabled
+    if (window.__traceLogDisabled) {
+        return;
+    }
     // Already initialized - safe to return
     if (app) {
         utils_1.debugLog.debug('API', 'Library already initialized, skipping duplicate initialization');

package/dist/cjs/types/window.types.d.ts

@@ -1,6 +1,11 @@
 import { TraceLogTestBridge } from './test-bridge.types';
 declare global {
     interface Window {
+        /**
+         * Flag to disable TraceLog initialization
+         * Set to true to prevent the library from running
+         */
+        __traceLogDisabled?: boolean;
         /**
          * Testing bridge for E2E tests
          * Only available when NODE_ENV=dev

package/dist/esm/api.js

@@ -18,6 +18,10 @@ export const init = async (appConfig) => {
     if (typeof window === 'undefined' || typeof document === 'undefined') {
         throw new Error('This library can only be used in a browser environment');
     }
+    // Check if TraceLog is disabled
+    if (window.__traceLogDisabled) {
+        return;
+    }
     // Already initialized - safe to return
     if (app) {
         debugLog.debug('API', 'Library already initialized, skipping duplicate initialization');

package/dist/esm/types/window.types.d.ts

@@ -1,6 +1,11 @@
 import { TraceLogTestBridge } from './test-bridge.types';
 declare global {
     interface Window {
+        /**
+         * Flag to disable TraceLog initialization
+         * Set to true to prevent the library from running
+         */
+        __traceLogDisabled?: boolean;
         /**
          * Testing bridge for E2E tests
          * Only available when NODE_ENV=dev

package/package.json

@@ -2,7 +2,7 @@
   "name": "@tracelog/lib",
   "description": "JavaScript library for web analytics and real-time event tracking",
   "license": "MIT",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "main": "./dist/cjs/public-api.js",
   "module": "./dist/esm/public-api.js",
   "types": "./dist/esm/public-api.d.ts",