@tracelog/lib 0.2.1 → 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

@@ -1,5 +1,5 @@
 var y = /* @__PURE__ */ ((r) => (r.Mobile = "mobile", r.Tablet = "tablet", r.Desktop = "desktop", r.Unknown = "unknown", r))(y || {});
-const ee = 15 * 60 * 1e3, Ze = 1e3, et = 1e4, xe = 250, tt = 24, Ee = 500, ve = 3, rt = 5e3, Ue = 1e4, nt = 10, ye = 5, Te = 500, Ie = 120, A = 1, st = 0, it = 1, z = 3e4, G = 864e5, _e = 120, we = 8 * 1024, Ae = 10, be = 10, Y = 255, T = 1e3, K = 100, Me = 3, _ = 2, at = 2e3, k = "data-tl", ot = [
+const ee = 15 * 60 * 1e3, Ze = 1e3, et = 1e4, Ue = 250, tt = 24, Ee = 500, ve = 3, rt = 5e3, xe = 1e4, nt = 10, ye = 5, Te = 500, Ie = 120, A = 1, st = 0, it = 1, z = 3e4, G = 864e5, _e = 120, we = 8 * 1024, Ae = 10, be = 10, Y = 255, T = 1e3, K = 100, Me = 3, _ = 2, at = 2e3, k = "data-tl", ot = [
   "button",
   "a",
   'input[type="button"]',
@@ -224,7 +224,7 @@ const St = () => {
   const e = Math.random() * 16 | 0;
   return (r === "x" ? e : e & 3 | 8).toString(16);
 });
-var w = /* @__PURE__ */ ((r) => (r.Skip = "skip", r.Localhost = "localhost:", r))(w || {}), re = /* @__PURE__ */ ((r) => (r.EVENT = "event", r.QUEUE = "queue", r))(re || {}), d = /* @__PURE__ */ ((r) => (r.PAGE_VIEW = "page_view", r.CLICK = "click", r.SCROLL = "scroll", r.SESSION_START = "session_start", r.SESSION_END = "session_end", r.CUSTOM = "custom", r.WEB_VITALS = "web_vitals", r.ERROR = "error", r))(d || {}), U = /* @__PURE__ */ ((r) => (r.UP = "up", r.DOWN = "down", r))(U || {}), N = /* @__PURE__ */ ((r) => (r.JS_ERROR = "js_error", r.PROMISE_REJECTION = "promise_rejection", r.NETWORK_ERROR = "network_error", r))(N || {}), H = /* @__PURE__ */ ((r) => (r.QA = "qa", r.DEBUG = "debug", r))(H || {}), yt = /* @__PURE__ */ ((r) => (r.AND = "AND", r.OR = "OR", r))(yt || {}), Tt = /* @__PURE__ */ ((r) => (r.URL_MATCHES = "url_matches", r.ELEMENT_MATCHES = "element_matches", r.DEVICE_TYPE = "device_type", r.ELEMENT_TEXT = "element_text", r.ELEMENT_ATTRIBUTE = "element_attribute", r.UTM_SOURCE = "utm_source", r.UTM_MEDIUM = "utm_medium", r.UTM_CAMPAIGN = "utm_campaign", r))(Tt || {}), It = /* @__PURE__ */ ((r) => (r.EQUALS = "equals", r.CONTAINS = "contains", r.STARTS_WITH = "starts_with", r.ENDS_WITH = "ends_with", r.REGEX = "regex", r.GREATER_THAN = "greater_than", r.LESS_THAN = "less_than", r.EXISTS = "exists", r.NOT_EXISTS = "not_exists", r))(It || {});
+var w = /* @__PURE__ */ ((r) => (r.Skip = "skip", r.Localhost = "localhost:", r))(w || {}), re = /* @__PURE__ */ ((r) => (r.EVENT = "event", r.QUEUE = "queue", r))(re || {}), d = /* @__PURE__ */ ((r) => (r.PAGE_VIEW = "page_view", r.CLICK = "click", r.SCROLL = "scroll", r.SESSION_START = "session_start", r.SESSION_END = "session_end", r.CUSTOM = "custom", r.WEB_VITALS = "web_vitals", r.ERROR = "error", r))(d || {}), x = /* @__PURE__ */ ((r) => (r.UP = "up", r.DOWN = "down", r))(x || {}), N = /* @__PURE__ */ ((r) => (r.JS_ERROR = "js_error", r.PROMISE_REJECTION = "promise_rejection", r.NETWORK_ERROR = "network_error", r))(N || {}), H = /* @__PURE__ */ ((r) => (r.QA = "qa", r.DEBUG = "debug", r))(H || {}), yt = /* @__PURE__ */ ((r) => (r.AND = "AND", r.OR = "OR", r))(yt || {}), Tt = /* @__PURE__ */ ((r) => (r.URL_MATCHES = "url_matches", r.ELEMENT_MATCHES = "element_matches", r.DEVICE_TYPE = "device_type", r.ELEMENT_TEXT = "element_text", r.ELEMENT_ATTRIBUTE = "element_attribute", r.UTM_SOURCE = "utm_source", r.UTM_MEDIUM = "utm_medium", r.UTM_CAMPAIGN = "utm_campaign", r))(Tt || {}), It = /* @__PURE__ */ ((r) => (r.EQUALS = "equals", r.CONTAINS = "contains", r.STARTS_WITH = "starts_with", r.ENDS_WITH = "ends_with", r.REGEX = "regex", r.GREATER_THAN = "greater_than", r.LESS_THAN = "less_than", r.EXISTS = "exists", r.NOT_EXISTS = "not_exists", r))(It || {});
 class O extends Error {
   constructor(e, t, n) {
     super(e), this.errorCode = t, this.layer = n, this.name = this.constructor.name, Error.captureStackTrace && Error.captureStackTrace(this, this.constructor);
@@ -522,7 +522,7 @@ const At = (r) => {
       error: e instanceof Error ? e.message : e
     }), new Error(`Metadata sanitization failed: ${e instanceof Error ? e.message : "Unknown error"}`);
   }
-}, xt = (r) => {
+}, Ut = (r) => {
   if (typeof r != "object" || r === null)
     return !1;
   for (const e of Object.values(r)) {
@@ -539,7 +539,7 @@ const At = (r) => {
     }
   }
   return !0;
-}, Ut = (r) => typeof r != "string" ? {
+}, xt = (r) => typeof r != "string" ? {
   valid: !1,
   error: "Event name must be a string"
 } : r.length === 0 ? {
@@ -556,7 +556,7 @@ const At = (r) => {
   error: "Event name cannot be a reserved word"
 } : { valid: !0 }, Ht = (r, e, t) => {
   const n = kt(e), s = `${t} "${r}" metadata error`;
-  if (!xt(n))
+  if (!Ut(n))
     return {
       valid: !1,
       error: `${s}: object has invalid types. Valid types are string, number, boolean or string arrays.`
@@ -605,7 +605,7 @@ const At = (r) => {
     sanitizedMetadata: n
   };
 }, Vt = (r, e) => {
-  const t = Ut(r);
+  const t = xt(r);
   if (!t.valid)
     return a.clientError("EventValidation", "Event name validation failed", { eventName: r, error: t.error }), t;
   if (!e)
@@ -762,7 +762,7 @@ class he {
       const n = this.buildConfigUrl(e, t), s = this.buildHeaders(t), i = await Gt(n, {
         method: "GET",
         headers: s,
-        timeout: Ue
+        timeout: xe
       });
       if (!i.ok)
         throw new Error(`HTTP ${i.status}: ${i.statusText}`);
@@ -927,7 +927,7 @@ class Qt extends f {
     }
   }
   async sendWithTimeout(e, t) {
-    const n = new AbortController(), s = setTimeout(() => n.abort(), Ue);
+    const n = new AbortController(), s = setTimeout(() => n.abort(), xe);
     try {
       const i = await fetch(e, {
         method: "POST",
@@ -1792,7 +1792,7 @@ class Jt extends f {
           this.processScrollEvent(s, i, o);
         }
         s.debounceTimer = null;
-      }, xe));
+      }, Ue));
     }, n = this.getScrollTop(e), s = {
       element: e,
       lastScrollPos: n,
@@ -1801,7 +1801,7 @@ class Jt extends f {
         this.getScrollHeight(e),
         this.getViewportHeight(e)
       ),
-      lastDirection: U.DOWN,
+      lastDirection: x.DOWN,
       lastEventTime: 0,
       debounceTimer: null,
       listener: t
@@ -1845,7 +1845,7 @@ class Jt extends f {
     e.debounceTimer !== null && (clearTimeout(e.debounceTimer), e.debounceTimer = null);
   }
   getScrollDirection(e, t) {
-    return e > t ? U.DOWN : U.UP;
+    return e > t ? x.DOWN : x.UP;
   }
   calculateScrollDepth(e, t, n) {
     if (t <= n)
@@ -2388,7 +2388,7 @@ class nr extends f {
     const e = () => {
       this.set("suppressNextScroll", !0), this.suppressNextScrollTimer && clearTimeout(this.suppressNextScrollTimer), this.suppressNextScrollTimer = window.setTimeout(() => {
         this.set("suppressNextScroll", !1);
-      }, xe * ct);
+      }, Ue * ct);
     };
     this.handlers.pageView = new Xt(this.managers.event, e), this.handlers.pageView.startTracking(), this.handlers.click = new qt(this.managers.event), this.handlers.click.startTracking(), this.handlers.scroll = new Jt(this.managers.event), this.handlers.scroll.startTracking(), this.handlers.performance = new tr(this.managers.event), this.handlers.performance.startTracking().catch(() => {
       a.warn("App", "Failed to start performance tracking");
@@ -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)
@@ -2528,6 +2530,9 @@ const sr = async (r) => {
   MIN_BASELINE_DAYS: 7,
   MIN_EVENTS_FOR_ANOMALY_DETECTION: 50
 }, Or = {
+  PAGE_URL_EXCLUDED: "excluded",
+  PAGE_URL_UNKNOWN: "unknown"
+}, Dr = {
   init: sr,
   event: ir,
   on: ar,
@@ -2633,9 +2638,9 @@ var ae, je = -1, L = function(r) {
       });
     }), setTimeout(t, 0));
   }));
-}, We = 0, J = 1 / 0, x = 0, hr = function(r) {
+}, We = 0, J = 1 / 0, U = 0, hr = function(r) {
   r.forEach(function(e) {
-    e.interactionId && (J = Math.min(J, e.interactionId), x = Math.max(x, e.interactionId), We = x ? (x - J) / 7 + 1 : 0);
+    e.interactionId && (J = Math.min(J, e.interactionId), U = Math.max(U, e.interactionId), We = U ? (U - J) / 7 + 1 : 0);
   });
 }, Be = function() {
   return ae ? We : performance.interactionCount || 0;
@@ -2749,10 +2754,11 @@ export {
   Ir as PERFORMANCE_CONFIG,
   Nr as SEGMENTATION_ANALYTICS,
   Ar as SESSION_ANALYTICS,
-  U as ScrollDirection,
+  Or as SPECIAL_PAGE_URLS,
+  x as ScrollDirection,
   Lr as TEMPORAL_ANALYSIS,
   It as TagConditionOperator,
   Tt as TagConditionType,
   yt as TagLogicalOperator,
-  Or as tracelog
+  Dr as tracelog
 };

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/app.constants.d.ts

@@ -72,3 +72,7 @@ export declare const ANOMALY_DETECTION: {
     readonly MIN_BASELINE_DAYS: 7;
     readonly MIN_EVENTS_FOR_ANOMALY_DETECTION: 50;
 };
+export declare const SPECIAL_PAGE_URLS: {
+    readonly PAGE_URL_EXCLUDED: "excluded";
+    readonly PAGE_URL_UNKNOWN: "unknown";
+};

package/dist/cjs/app.constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ANOMALY_DETECTION = exports.ANALYTICS_QUERY_LIMITS = exports.SEGMENTATION_ANALYTICS = exports.TEMPORAL_ANALYSIS = exports.INSIGHT_THRESHOLDS = exports.CONTENT_ANALYTICS = exports.DEVICE_ANALYTICS = exports.SESSION_ANALYTICS = exports.ENGAGEMENT_THRESHOLDS = exports.DATA_PROTECTION = exports.PERFORMANCE_CONFIG = void 0;
+exports.SPECIAL_PAGE_URLS = exports.ANOMALY_DETECTION = exports.ANALYTICS_QUERY_LIMITS = exports.SEGMENTATION_ANALYTICS = exports.TEMPORAL_ANALYSIS = exports.INSIGHT_THRESHOLDS = exports.CONTENT_ANALYTICS = exports.DEVICE_ANALYTICS = exports.SESSION_ANALYTICS = exports.ENGAGEMENT_THRESHOLDS = exports.DATA_PROTECTION = exports.PERFORMANCE_CONFIG = void 0;
 const performance_constants_1 = require("./constants/performance.constants");
 const error_constants_1 = require("./constants/error.constants");
 exports.PERFORMANCE_CONFIG = {
@@ -77,3 +77,7 @@ exports.ANOMALY_DETECTION = {
     MIN_BASELINE_DAYS: 7,
     MIN_EVENTS_FOR_ANOMALY_DETECTION: 50,
 };
+exports.SPECIAL_PAGE_URLS = {
+    PAGE_URL_EXCLUDED: 'excluded',
+    PAGE_URL_UNKNOWN: 'unknown',
+};

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/app.constants.d.ts

@@ -72,3 +72,7 @@ export declare const ANOMALY_DETECTION: {
     readonly MIN_BASELINE_DAYS: 7;
     readonly MIN_EVENTS_FOR_ANOMALY_DETECTION: 50;
 };
+export declare const SPECIAL_PAGE_URLS: {
+    readonly PAGE_URL_EXCLUDED: "excluded";
+    readonly PAGE_URL_UNKNOWN: "unknown";
+};

package/dist/esm/app.constants.js

@@ -74,3 +74,7 @@ export const ANOMALY_DETECTION = {
     MIN_BASELINE_DAYS: 7,
     MIN_EVENTS_FOR_ANOMALY_DETECTION: 50,
 };
+export const SPECIAL_PAGE_URLS = {
+    PAGE_URL_EXCLUDED: 'excluded',
+    PAGE_URL_UNKNOWN: 'unknown',
+};

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.1",
+  "version": "0.3.0",
   "main": "./dist/cjs/public-api.js",
   "module": "./dist/esm/public-api.js",
   "types": "./dist/esm/public-api.d.ts",