@grainql/analytics-web 3.2.1 → 3.2.2

package/dist/heatmap-tracking.js

@@ -179,6 +179,12 @@ class HeatmapTrackingManager {
     async captureSnapshot() {
         if (this.snapshotCaptured || !this.snapshotEnabled)
             return;
+        // Check daily snapshot limits before capturing
+        if (!this.canUploadSnapshot()) {
+            this.log('Snapshot upload limit reached or URL already captured today');
+            this.snapshotCaptured = true; // Prevent retry
+            return;
+        }
         try {
             this.log('Capturing DOM snapshot...');
             // Dynamically import rrweb-snapshot (only if enabled)
@@ -246,11 +252,97 @@ class HeatmapTrackingManager {
             }
             const result = await response.json();
             this.log('Snapshot uploaded successfully:', result);
+            // Record successful upload
+            this.recordSnapshotUpload(pageUrl);
         }
         catch (error) {
             this.log('Failed to upload snapshot:', error);
         }
     }
+    /**
+     * Check if snapshot can be uploaded based on daily limits
+     * - Max 5 snapshots per user per day
+     * - Same URL (without query params) can't be uploaded twice in same day
+     */
+    canUploadSnapshot() {
+        if (typeof window === 'undefined' || typeof localStorage === 'undefined') {
+            return true; // Allow in SSR/non-browser environments
+        }
+        try {
+            const pageUrl = this.normalizeUrl(window.location.href);
+            const urlWithoutQuery = this.stripQueryParams(pageUrl);
+            const today = new Date().toISOString().split('T')[0]; // YYYY-MM-DD
+            const storageKey = '_grain_snapshots';
+            // Get existing snapshot records
+            const stored = localStorage.getItem(storageKey);
+            let snapshots = stored ? JSON.parse(stored) : [];
+            // Clean up old entries (older than 2 days)
+            const twoDaysAgo = Date.now() - (2 * 24 * 60 * 60 * 1000);
+            snapshots = snapshots.filter(s => s.timestamp > twoDaysAgo);
+            // Get today's snapshots
+            const todaySnapshots = snapshots.filter(s => s.date === today);
+            // Check daily limit (5 per day)
+            if (todaySnapshots.length >= 5) {
+                this.log('Daily snapshot limit reached (5/5)');
+                return false;
+            }
+            // Check if this URL (without query params) was already uploaded today
+            const urlAlreadyUploaded = todaySnapshots.some(s => this.stripQueryParams(s.url) === urlWithoutQuery);
+            if (urlAlreadyUploaded) {
+                this.log(`Snapshot for ${urlWithoutQuery} already uploaded today`);
+                return false;
+            }
+            this.log(`Snapshot upload allowed (${todaySnapshots.length}/5 today)`);
+            return true;
+        }
+        catch (error) {
+            this.log('Error checking snapshot limits:', error);
+            return true; // Allow on error to not break functionality
+        }
+    }
+    /**
+     * Record a successful snapshot upload
+     */
+    recordSnapshotUpload(pageUrl) {
+        if (typeof window === 'undefined' || typeof localStorage === 'undefined') {
+            return;
+        }
+        try {
+            const today = new Date().toISOString().split('T')[0];
+            const storageKey = '_grain_snapshots';
+            // Get existing records
+            const stored = localStorage.getItem(storageKey);
+            let snapshots = stored ? JSON.parse(stored) : [];
+            // Add new record
+            snapshots.push({
+                url: pageUrl,
+                date: today,
+                timestamp: Date.now()
+            });
+            // Clean up old entries (older than 2 days)
+            const twoDaysAgo = Date.now() - (2 * 24 * 60 * 60 * 1000);
+            snapshots = snapshots.filter(s => s.timestamp > twoDaysAgo);
+            // Save back to localStorage
+            localStorage.setItem(storageKey, JSON.stringify(snapshots));
+            this.log(`Snapshot upload recorded: ${snapshots.filter(s => s.date === today).length}/5 today`);
+        }
+        catch (error) {
+            this.log('Error recording snapshot upload:', error);
+        }
+    }
+    /**
+     * Strip query parameters from URL for comparison
+     */
+    stripQueryParams(url) {
+        try {
+            const urlObj = new URL(url);
+            return `${urlObj.origin}${urlObj.pathname}`;
+        }
+        catch {
+            // If URL parsing fails, remove everything after ?
+            return url.split('?')[0];
+        }
+    }
     /**
      * Get API URL from tracker configuration
      */

package/dist/index.global.dev.js

@@ -1,4 +1,4 @@
-/* Grain Analytics Web SDK v3.2.1 | MIT License | Development Build */
+/* Grain Analytics Web SDK v3.2.2 | MIT License | Development Build */
 "use strict";
 var Grain = (() => {
   var __defProp = Object.defineProperty;
@@ -5955,6 +5955,11 @@ var Grain = (() => {
         async captureSnapshot() {
           if (this.snapshotCaptured || !this.snapshotEnabled)
             return;
+          if (!this.canUploadSnapshot()) {
+            this.log("Snapshot upload limit reached or URL already captured today");
+            this.snapshotCaptured = true;
+            return;
+          }
           try {
             this.log("Capturing DOM snapshot...");
             const rrwebSnapshot = await Promise.resolve().then(() => (init_rrweb_snapshot(), rrweb_snapshot_exports));
@@ -6014,10 +6019,84 @@ var Grain = (() => {
             }
             const result2 = await response.json();
             this.log("Snapshot uploaded successfully:", result2);
+            this.recordSnapshotUpload(pageUrl);
           } catch (error) {
             this.log("Failed to upload snapshot:", error);
           }
         }
+        /**
+         * Check if snapshot can be uploaded based on daily limits
+         * - Max 5 snapshots per user per day
+         * - Same URL (without query params) can't be uploaded twice in same day
+         */
+        canUploadSnapshot() {
+          if (typeof window === "undefined" || typeof localStorage === "undefined") {
+            return true;
+          }
+          try {
+            const pageUrl = this.normalizeUrl(window.location.href);
+            const urlWithoutQuery = this.stripQueryParams(pageUrl);
+            const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+            const storageKey = "_grain_snapshots";
+            const stored = localStorage.getItem(storageKey);
+            let snapshots = stored ? JSON.parse(stored) : [];
+            const twoDaysAgo = Date.now() - 2 * 24 * 60 * 60 * 1e3;
+            snapshots = snapshots.filter((s) => s.timestamp > twoDaysAgo);
+            const todaySnapshots = snapshots.filter((s) => s.date === today);
+            if (todaySnapshots.length >= 5) {
+              this.log("Daily snapshot limit reached (5/5)");
+              return false;
+            }
+            const urlAlreadyUploaded = todaySnapshots.some(
+              (s) => this.stripQueryParams(s.url) === urlWithoutQuery
+            );
+            if (urlAlreadyUploaded) {
+              this.log(`Snapshot for ${urlWithoutQuery} already uploaded today`);
+              return false;
+            }
+            this.log(`Snapshot upload allowed (${todaySnapshots.length}/5 today)`);
+            return true;
+          } catch (error) {
+            this.log("Error checking snapshot limits:", error);
+            return true;
+          }
+        }
+        /**
+         * Record a successful snapshot upload
+         */
+        recordSnapshotUpload(pageUrl) {
+          if (typeof window === "undefined" || typeof localStorage === "undefined") {
+            return;
+          }
+          try {
+            const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+            const storageKey = "_grain_snapshots";
+            const stored = localStorage.getItem(storageKey);
+            let snapshots = stored ? JSON.parse(stored) : [];
+            snapshots.push({
+              url: pageUrl,
+              date: today,
+              timestamp: Date.now()
+            });
+            const twoDaysAgo = Date.now() - 2 * 24 * 60 * 60 * 1e3;
+            snapshots = snapshots.filter((s) => s.timestamp > twoDaysAgo);
+            localStorage.setItem(storageKey, JSON.stringify(snapshots));
+            this.log(`Snapshot upload recorded: ${snapshots.filter((s) => s.date === today).length}/5 today`);
+          } catch (error) {
+            this.log("Error recording snapshot upload:", error);
+          }
+        }
+        /**
+         * Strip query parameters from URL for comparison
+         */
+        stripQueryParams(url) {
+          try {
+            const urlObj = new URL(url);
+            return `${urlObj.origin}${urlObj.pathname}`;
+          } catch {
+            return url.split("?")[0];
+          }
+        }
         /**
          * Get API URL from tracker configuration
          */