@brainfish-ai/web-tracker 0.0.23 → 0.0.25

package/dist/tracker.d.ts

@@ -2,7 +2,7 @@ declare global {
     interface Window {
         BrainfishAnalytics: {
             q?: [string, ...any[]];
-            (method: string, ...args: any[]): void;
+            (method: string, ...args: any[]): any;
         };
     }
 }

package/dist/tracker.es.js

@@ -3456,6 +3456,28 @@ class TTLSet {
     return Array.from(this.items.keys());
   }
 }
+let latestIdentifyPayload = null;
+if (typeof window !== "undefined") {
+  window.addEventListener("message", (event) => {
+    const trustedOrigin = "https://agent.brainfi.sh";
+    if (event.origin !== trustedOrigin) {
+      return;
+    }
+    if (event.data?.type === "REQUEST_USER_IDENTITY") {
+      if (latestIdentifyPayload && event.source) {
+        const iframe = document.querySelector("#bf-iframe-container .trigger-iframe");
+        if (!iframe || event.source !== iframe.contentWindow) {
+          console.warn("BrainfishWidgetWarn: Rejected REQUEST_USER_IDENTITY from untrusted iframe source:", event.origin);
+          return;
+        }
+        event.source.postMessage({
+          type: "USER_IDENTIFY",
+          payload: latestIdentifyPayload
+        }, event.origin);
+      }
+    }
+  });
+}
 var NudgeCTABlockActionType;
 (function(NudgeCTABlockActionType2) {
   NudgeCTABlockActionType2["OpenUrl"] = "openUrl";
@@ -3468,7 +3490,7 @@ var NudgeCTABlockType;
   NudgeCTABlockType2["Button"] = "button";
   NudgeCTABlockType2["Link"] = "link";
 })(NudgeCTABlockType || (NudgeCTABlockType = {}));
-class TrackerSdk {
+const _TrackerSdk = class _TrackerSdk {
   constructor(options) {
     __publicField(this, "options");
     __publicField(this, "client");
@@ -3480,6 +3502,7 @@ class TrackerSdk {
     __publicField(this, "eventListeners", {});
     // this set is used to prevent showing the same nudge multiple times in a short period
     __publicField(this, "recentNudgeIds", new TTLSet(1e3));
+    __publicField(this, "trackingDisabled", false);
     this.options = options;
     const query = {
       sdk_name: options.sdk || "node",
@@ -3500,6 +3523,9 @@ class TrackerSdk {
         version: options.sdkVersion || ""
       }
     });
+    if (typeof window !== "undefined" && typeof localStorage !== "undefined") {
+      this.trackingDisabled = localStorage.getItem(_TrackerSdk.TRACKING_DISABLED_KEY) === "true";
+    }
     this.setupIncomingPayloadHandler();
   }
   // placeholder for future use
@@ -3552,6 +3578,9 @@ class TrackerSdk {
     if (this.options.disabled) {
       return Promise.resolve();
     }
+    if (this.trackingDisabled) {
+      return Promise.resolve();
+    }
     if (this.options.filter && !this.options.filter(payload)) {
       return Promise.resolve();
     }
@@ -3605,6 +3634,7 @@ class TrackerSdk {
     if (payload.phone && !/^\+[1-9]\d{1,14}$/.test(payload.phone)) {
       console.warn("BrainfishWidgetWarn: phone should be in E.164 format (e.g., +14155552671). Providing the correct format ensures accurate user identification.");
     }
+    latestIdentifyPayload = payload;
     const iframe = document.querySelector("#bf-iframe-container .trigger-iframe");
     if (iframe) {
       const sendMessage = () => {
@@ -3637,6 +3667,9 @@ class TrackerSdk {
     if (this.options.disabled) {
       return Promise.resolve(null);
     }
+    if (this.trackingDisabled) {
+      return Promise.resolve(null);
+    }
     const payload = {
       type: "event.record",
       payload: {
@@ -3686,7 +3719,37 @@ class TrackerSdk {
     });
     this.queue = [];
   }
-}
+  /**
+   * Disables privacy-sensitive tracking features (recording, screenshots).
+   * This setting persists across page reloads via localStorage.
+   */
+  disableTracking() {
+    this.trackingDisabled = true;
+    if (typeof window !== "undefined" && typeof localStorage !== "undefined") {
+      localStorage.setItem(_TrackerSdk.TRACKING_DISABLED_KEY, "true");
+    }
+  }
+  /**
+   * Re-enables privacy-sensitive tracking features (recording, screenshots).
+   * Note: Full effect requires a page reload to restart recording.
+   */
+  enableTracking() {
+    this.trackingDisabled = false;
+    if (typeof window !== "undefined" && typeof localStorage !== "undefined") {
+      localStorage.removeItem(_TrackerSdk.TRACKING_DISABLED_KEY);
+    }
+    console.log("Brainfish tracking re-enabled. Refresh page for full effect.");
+  }
+  /**
+   * Returns whether privacy-sensitive tracking is currently disabled.
+   * @returns true if tracking is disabled, false otherwise
+   */
+  isTrackingDisabled() {
+    return this.trackingDisabled;
+  }
+};
+__publicField(_TrackerSdk, "TRACKING_DISABLED_KEY", "bf_tracking_disabled");
+let TrackerSdk = _TrackerSdk;
 var cache = {
   image: /* @__PURE__ */ new Map(),
   background: /* @__PURE__ */ new Map(),
@@ -38440,9 +38503,8 @@ function toCamelCase(str) {
     ($1) => $1.toUpperCase().replace("-", "").replace("_", "")
   );
 }
-const VERSION = "0.0.23";
+const VERSION = "0.0.25";
 class Tracker extends TrackerSdk {
-  // 750KB
   constructor(options) {
     super({
       sdk: "web",
@@ -38455,6 +38517,8 @@ class Tracker extends TrackerSdk {
     __publicField(this, "sessionManager", SessionManager.getInstance());
     __publicField(this, "recordingBlocklist", []);
     __publicField(this, "MAX_SCREENSHOT_SIZE", 750 * 1024);
+    // 750KB
+    __publicField(this, "isRecordingActive", false);
     this.options = options;
     this.agent = new Agent();
     this.recordingBlocklist = options.recordingBlocklist || [];
@@ -38462,17 +38526,19 @@ class Tracker extends TrackerSdk {
       this.setGlobalProperties({
         __referrer: document.referrer
       });
-      if (this.options.trackOutgoingLinks) {
+      const trackingDisabled = this.isTrackingDisabled();
+      if (this.options.trackOutgoingLinks && !trackingDisabled) {
         this.trackOutgoingLinks();
       }
       if (this.options.trackScreenViews) {
         this.trackScreenViews();
       }
-      if (this.options.trackAttributes) {
+      if (this.options.trackAttributes && !trackingDisabled) {
         this.trackAttributes();
       }
-      if (this.options.enableRecording && this.options._allowScreenRecording) {
+      if (this.options.enableRecording && this.options._allowScreenRecording && !trackingDisabled) {
         this.startRecording();
+        this.isRecordingActive = true;
         console.log("Brainfish has started ambient learning");
       }
     }
@@ -38587,7 +38653,7 @@ class Tracker extends TrackerSdk {
       __path: path,
       __title: document.title
     };
-    if (this.options.enableRecording && canDiscover(
+    if (this.options.enableRecording && !this.isTrackingDisabled() && canDiscover(
       this.recordingBlocklist,
       this.options._allowLocalhostRecording
     )) {
@@ -38625,6 +38691,26 @@ class Tracker extends TrackerSdk {
     super.track("screen_view", props);
     this.sessionManager.updateLastScreenViewEventTime();
   }
+  /**
+   * Disables privacy-sensitive tracking features and stops active recording.
+   */
+  disableTracking() {
+    super.disableTracking();
+    if (this.isRecordingActive) {
+      if (this.agent.recordingManager.recorder.stop) {
+        this.agent.recordingManager.recorder.stop();
+      }
+      this.isRecordingActive = false;
+      console.log("Brainfish has stopped ambient learning");
+    }
+  }
+  /**
+   * Re-enables privacy-sensitive tracking features.
+   * Note: Full effect requires a page reload to restart recording and event listeners.
+   */
+  enableTracking() {
+    super.enableTracking();
+  }
 }
 ((window2) => {
   if (window2.BrainfishAnalytics && "q" in window2.BrainfishAnalytics) {
@@ -38644,7 +38730,7 @@ class Tracker extends TrackerSdk {
     window2.BrainfishAnalytics = (t, ...args) => {
       const fn = tracker[t] ? tracker[t].bind(tracker) : void 0;
       if (typeof fn === "function") {
-        fn(...args);
+        return fn(...args);
       } else {
         console.warn(`Method ${t} does not exist on BrainfishAnalytics`);
       }