aurea-tracking-sdk 1.3.3 → 1.4.0

package/dist/index.d.mts

@@ -31,6 +31,11 @@ interface AureaConfig {
     };
     autoAdvanceStages?: boolean;
     customStages?: string[];
+    gdprConsent?: {
+        required: boolean;
+        onConsentRequired?: () => Promise<boolean>;
+        consentVersion?: string;
+    };
 }
 interface TrackingEvent {
     eventId: string;
@@ -132,15 +137,35 @@ declare class AureaSDK {
     private checkoutStartedAt?;
     private eventCategoryStats;
     private trackedOnceEvents;
+    private consentGiven;
+    private consentVersion;
     constructor(config: AureaConfig);
     /**
      * Initialize the SDK
      */
-    init(): void;
+    init(): Promise<void>;
     /**
      * Track a custom event
      */
     track(eventName: string, properties?: Record<string, any>): void;
+    /**
+     * Grant GDPR consent
+     * Call this when user accepts your privacy policy/cookie banner
+     */
+    grantConsent(version?: string): void;
+    /**
+     * Revoke GDPR consent
+     * Call this when user revokes consent (e.g., via cookie settings)
+     */
+    revokeConsent(): void;
+    /**
+     * Check if consent has been given
+     */
+    hasConsent(): boolean;
+    /**
+     * Request data deletion (Right to be Forgotten)
+     */
+    requestDataDeletion(): Promise<void>;
     /**
      * Identify a user (links anonymous user to known user)
      */
@@ -331,6 +356,10 @@ declare class AureaSDK {
      * Check if user has completed a purchase
      */
     private checkForPurchase;
+    /**
+     * Send Web Vital to dedicated endpoint
+     */
+    private sendWebVital;
     /**
      * Track Core Web Vitals
      */

package/dist/index.d.ts

@@ -31,6 +31,11 @@ interface AureaConfig {
     };
     autoAdvanceStages?: boolean;
     customStages?: string[];
+    gdprConsent?: {
+        required: boolean;
+        onConsentRequired?: () => Promise<boolean>;
+        consentVersion?: string;
+    };
 }
 interface TrackingEvent {
     eventId: string;
@@ -132,15 +137,35 @@ declare class AureaSDK {
     private checkoutStartedAt?;
     private eventCategoryStats;
     private trackedOnceEvents;
+    private consentGiven;
+    private consentVersion;
     constructor(config: AureaConfig);
     /**
      * Initialize the SDK
      */
-    init(): void;
+    init(): Promise<void>;
     /**
      * Track a custom event
      */
     track(eventName: string, properties?: Record<string, any>): void;
+    /**
+     * Grant GDPR consent
+     * Call this when user accepts your privacy policy/cookie banner
+     */
+    grantConsent(version?: string): void;
+    /**
+     * Revoke GDPR consent
+     * Call this when user revokes consent (e.g., via cookie settings)
+     */
+    revokeConsent(): void;
+    /**
+     * Check if consent has been given
+     */
+    hasConsent(): boolean;
+    /**
+     * Request data deletion (Right to be Forgotten)
+     */
+    requestDataDeletion(): Promise<void>;
     /**
      * Identify a user (links anonymous user to known user)
      */
@@ -331,6 +356,10 @@ declare class AureaSDK {
      * Check if user has completed a purchase
      */
     private checkForPurchase;
+    /**
+     * Send Web Vital to dedicated endpoint
+     */
+    private sendWebVital;
     /**
      * Track Core Web Vitals
      */

package/dist/index.js

@@ -55,6 +55,9 @@ var AureaSDK = class {
     this.eventCategoryStats = /* @__PURE__ */ new Map();
     // NEW: Track which events have been fired (for trackOnce behavior)
     this.trackedOnceEvents = /* @__PURE__ */ new Set();
+    // GDPR: Consent tracking
+    this.consentGiven = false;
+    this.consentVersion = "1.0";
     this.config = {
       apiUrl: "http://localhost:3000/api",
       debug: false,
@@ -77,12 +80,18 @@ var AureaSDK = class {
       if (savedUserId) {
         this.userId = savedUserId;
       }
+      const savedConsent = localStorage.getItem("aurea_consent");
+      const savedConsentVersion = localStorage.getItem("aurea_consent_version");
+      if (savedConsent === "granted" && savedConsentVersion) {
+        this.consentGiven = true;
+        this.consentVersion = savedConsentVersion;
+      }
     }
   }
   /**
    * Initialize the SDK
    */
-  init() {
+  async init() {
     if (this.initialized) {
       console.warn("[Aurea SDK] Already initialized");
       return;
@@ -93,6 +102,29 @@ var AureaSDK = class {
       }
       return;
     }
+    if (this.config.gdprConsent?.required) {
+      if (!this.consentGiven) {
+        if (this.config.debug) {
+          console.log("[Aurea SDK] GDPR consent required but not given");
+        }
+        if (this.config.gdprConsent.onConsentRequired) {
+          const consentGranted = await this.config.gdprConsent.onConsentRequired();
+          if (consentGranted) {
+            this.grantConsent(this.config.gdprConsent.consentVersion || "1.0");
+          } else {
+            if (this.config.debug) {
+              console.log("[Aurea SDK] Consent not granted, tracking disabled");
+            }
+            return;
+          }
+        } else {
+          if (this.config.debug) {
+            console.log("[Aurea SDK] Waiting for manual consent via grantConsent()");
+          }
+          return;
+        }
+      }
+    }
     this.initialized = true;
     if (this.config.autoTrack?.pageViews) {
       this.trackPageLoad();
@@ -134,6 +166,87 @@ var AureaSDK = class {
       console.log("[Aurea SDK] Event tracked:", eventName, properties);
     }
   }
+  /**
+   * Grant GDPR consent
+   * Call this when user accepts your privacy policy/cookie banner
+   */
+  grantConsent(version = "1.0") {
+    this.consentGiven = true;
+    this.consentVersion = version;
+    if (typeof window !== "undefined") {
+      localStorage.setItem("aurea_consent", "granted");
+      localStorage.setItem("aurea_consent_version", version);
+      localStorage.setItem("aurea_consent_timestamp", (/* @__PURE__ */ new Date()).toISOString());
+    }
+    this.track("consent_granted", {
+      consentVersion: version,
+      timestamp: Date.now()
+    });
+    if (!this.initialized) {
+      this.init();
+    }
+    if (this.config.debug) {
+      console.log("[Aurea SDK] Consent granted:", version);
+    }
+  }
+  /**
+   * Revoke GDPR consent
+   * Call this when user revokes consent (e.g., via cookie settings)
+   */
+  revokeConsent() {
+    this.consentGiven = false;
+    if (typeof window !== "undefined") {
+      localStorage.removeItem("aurea_consent");
+      localStorage.removeItem("aurea_consent_version");
+      localStorage.removeItem("aurea_consent_timestamp");
+    }
+    this.track("consent_revoked", {
+      timestamp: Date.now()
+    });
+    this.initialized = false;
+    if (this.config.debug) {
+      console.log("[Aurea SDK] Consent revoked, tracking stopped");
+    }
+  }
+  /**
+   * Check if consent has been given
+   */
+  hasConsent() {
+    return this.consentGiven;
+  }
+  /**
+   * Request data deletion (Right to be Forgotten)
+   */
+  async requestDataDeletion() {
+    try {
+      await fetch(`${this.config.apiUrl}/track/delete`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "X-Aurea-API-Key": this.config.apiKey,
+          "X-Aurea-Funnel-ID": this.config.funnelId
+        },
+        body: JSON.stringify({
+          anonymousId: this.anonymousId,
+          userId: this.userId
+        })
+      });
+      if (typeof window !== "undefined") {
+        localStorage.removeItem("aurea_anonymous_id");
+        localStorage.removeItem("aurea_user_id");
+        localStorage.removeItem("aurea_consent");
+        localStorage.removeItem("aurea_consent_version");
+        localStorage.removeItem("aurea_consent_timestamp");
+        sessionStorage.removeItem("aurea_session_id");
+      }
+      if (this.config.debug) {
+        console.log("[Aurea SDK] Data deletion requested");
+      }
+    } catch (error) {
+      console.error("[Aurea SDK] Failed to request data deletion:", error);
+      throw error;
+    }
+  }
   /**
    * Identify a user (links anonymous user to known user)
    */
@@ -648,9 +761,16 @@ var AureaSDK = class {
       }
     } else {
       const aspectRatio = screenWidth / screenHeight;
+      const userAgent = navigator.userAgent.toLowerCase();
+      const isMac = userAgent.includes("macintosh") || userAgent.includes("mac os x");
+      const isWindowsLaptop = userAgent.includes("windows") && userAgent.includes("touch");
+      const isChromebook = userAgent.includes("chromebook") || userAgent.includes("cros");
+      const hasLaptopKeyword = userAgent.includes("laptop");
       if (screenWidth >= 2560 || aspectRatio >= 2.2) {
         deviceType = "Ultrawide";
-      } else if (screenWidth < 1920) {
+      } else if (screenWidth <= 1920) {
+        deviceType = "Laptop";
+      } else if (screenWidth <= 2048 && (isWindowsLaptop || isChromebook || hasLaptopKeyword)) {
         deviceType = "Laptop";
       } else {
         deviceType = "Desktop";
@@ -695,6 +815,11 @@ var AureaSDK = class {
       session: {
         sessionId: this.sessionId
       },
+      gdpr: {
+        consentGiven: this.consentGiven,
+        consentVersion: this.consentVersion,
+        consentTimestamp: typeof window !== "undefined" ? localStorage.getItem("aurea_consent_timestamp") || void 0 : void 0
+      },
       device: typeof navigator !== "undefined" ? this.parseDeviceInfo() : void 0
     };
   }
@@ -879,6 +1004,49 @@ var AureaSDK = class {
       }
     }
   }
+  /**
+   * Send Web Vital to dedicated endpoint
+   */
+  async sendWebVital(metric, name, rating) {
+    try {
+      const deviceInfo = this.parseDeviceInfo();
+      await fetch(`${this.config.apiUrl}/track/web-vitals`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "X-Aurea-API-Key": this.config.apiKey,
+          "X-Aurea-Funnel-ID": this.config.funnelId
+        },
+        body: JSON.stringify({
+          funnelId: this.config.funnelId,
+          sessionId: this.sessionId,
+          anonymousId: this.anonymousId,
+          pageUrl: window.location.href,
+          pagePath: window.location.pathname,
+          pageTitle: document.title,
+          metric: name.toUpperCase(),
+          value: metric.value,
+          rating: rating.toUpperCase().replace("-", "_"),
+          delta: metric.delta,
+          id_metric: metric.id,
+          deviceType: deviceInfo?.deviceType,
+          browserName: deviceInfo?.browserName,
+          browserVersion: deviceInfo?.browserVersion,
+          osName: deviceInfo?.osName,
+          osVersion: deviceInfo?.osVersion,
+          screenWidth: deviceInfo?.screenWidth,
+          screenHeight: deviceInfo?.screenHeight,
+          timestamp: /* @__PURE__ */ new Date()
+        }),
+        keepalive: true
+      });
+      if (this.config.debug) {
+        console.log(`[Aurea SDK] Web Vital sent: ${name}`, metric.value, rating);
+      }
+    } catch (error) {
+      console.error(`[Aurea SDK] Failed to send ${name}:`, error);
+    }
+  }
   /**
    * Track Core Web Vitals
    */
@@ -900,61 +1068,36 @@ var AureaSDK = class {
     (0, import_web_vitals.onLCP)((metric) => {
       if (!this.webVitalsCollected.lcp) {
         this.webVitalsCollected.lcp = true;
-        this.track("web_vital", {
-          metric: "lcp",
-          value: metric.value,
-          rating: getVitalRating("LCP", metric.value),
-          delta: metric.delta,
-          id: metric.id
-        });
+        const rating = getVitalRating("LCP", metric.value);
+        this.sendWebVital(metric, "lcp", rating);
       }
     });
     (0, import_web_vitals.onINP)((metric) => {
       if (!this.webVitalsCollected.inp) {
         this.webVitalsCollected.inp = true;
-        this.track("web_vital", {
-          metric: "inp",
-          value: metric.value,
-          rating: getVitalRating("INP", metric.value),
-          delta: metric.delta,
-          id: metric.id
-        });
+        const rating = getVitalRating("INP", metric.value);
+        this.sendWebVital(metric, "inp", rating);
       }
     });
     (0, import_web_vitals.onCLS)((metric) => {
       if (!this.webVitalsCollected.cls) {
         this.webVitalsCollected.cls = true;
-        this.track("web_vital", {
-          metric: "cls",
-          value: metric.value,
-          rating: getVitalRating("CLS", metric.value),
-          delta: metric.delta,
-          id: metric.id
-        });
+        const rating = getVitalRating("CLS", metric.value);
+        this.sendWebVital(metric, "cls", rating);
       }
     });
     (0, import_web_vitals.onFCP)((metric) => {
       if (!this.webVitalsCollected.fcp) {
         this.webVitalsCollected.fcp = true;
-        this.track("web_vital", {
-          metric: "fcp",
-          value: metric.value,
-          rating: getVitalRating("FCP", metric.value),
-          delta: metric.delta,
-          id: metric.id
-        });
+        const rating = getVitalRating("FCP", metric.value);
+        this.sendWebVital(metric, "fcp", rating);
       }
     });
     (0, import_web_vitals.onTTFB)((metric) => {
       if (!this.webVitalsCollected.ttfb) {
         this.webVitalsCollected.ttfb = true;
-        this.track("web_vital", {
-          metric: "ttfb",
-          value: metric.value,
-          rating: getVitalRating("TTFB", metric.value),
-          delta: metric.delta,
-          id: metric.id
-        });
+        const rating = getVitalRating("TTFB", metric.value);
+        this.sendWebVital(metric, "ttfb", rating);
       }
     });
     if (this.config.debug) {

package/dist/index.mjs

@@ -26,6 +26,9 @@ var AureaSDK = class {
     this.eventCategoryStats = /* @__PURE__ */ new Map();
     // NEW: Track which events have been fired (for trackOnce behavior)
     this.trackedOnceEvents = /* @__PURE__ */ new Set();
+    // GDPR: Consent tracking
+    this.consentGiven = false;
+    this.consentVersion = "1.0";
     this.config = {
       apiUrl: "http://localhost:3000/api",
       debug: false,
@@ -48,12 +51,18 @@ var AureaSDK = class {
       if (savedUserId) {
         this.userId = savedUserId;
       }
+      const savedConsent = localStorage.getItem("aurea_consent");
+      const savedConsentVersion = localStorage.getItem("aurea_consent_version");
+      if (savedConsent === "granted" && savedConsentVersion) {
+        this.consentGiven = true;
+        this.consentVersion = savedConsentVersion;
+      }
     }
   }
   /**
    * Initialize the SDK
    */
-  init() {
+  async init() {
     if (this.initialized) {
       console.warn("[Aurea SDK] Already initialized");
       return;
@@ -64,6 +73,29 @@ var AureaSDK = class {
       }
       return;
     }
+    if (this.config.gdprConsent?.required) {
+      if (!this.consentGiven) {
+        if (this.config.debug) {
+          console.log("[Aurea SDK] GDPR consent required but not given");
+        }
+        if (this.config.gdprConsent.onConsentRequired) {
+          const consentGranted = await this.config.gdprConsent.onConsentRequired();
+          if (consentGranted) {
+            this.grantConsent(this.config.gdprConsent.consentVersion || "1.0");
+          } else {
+            if (this.config.debug) {
+              console.log("[Aurea SDK] Consent not granted, tracking disabled");
+            }
+            return;
+          }
+        } else {
+          if (this.config.debug) {
+            console.log("[Aurea SDK] Waiting for manual consent via grantConsent()");
+          }
+          return;
+        }
+      }
+    }
     this.initialized = true;
     if (this.config.autoTrack?.pageViews) {
       this.trackPageLoad();
@@ -105,6 +137,87 @@ var AureaSDK = class {
       console.log("[Aurea SDK] Event tracked:", eventName, properties);
     }
   }
+  /**
+   * Grant GDPR consent
+   * Call this when user accepts your privacy policy/cookie banner
+   */
+  grantConsent(version = "1.0") {
+    this.consentGiven = true;
+    this.consentVersion = version;
+    if (typeof window !== "undefined") {
+      localStorage.setItem("aurea_consent", "granted");
+      localStorage.setItem("aurea_consent_version", version);
+      localStorage.setItem("aurea_consent_timestamp", (/* @__PURE__ */ new Date()).toISOString());
+    }
+    this.track("consent_granted", {
+      consentVersion: version,
+      timestamp: Date.now()
+    });
+    if (!this.initialized) {
+      this.init();
+    }
+    if (this.config.debug) {
+      console.log("[Aurea SDK] Consent granted:", version);
+    }
+  }
+  /**
+   * Revoke GDPR consent
+   * Call this when user revokes consent (e.g., via cookie settings)
+   */
+  revokeConsent() {
+    this.consentGiven = false;
+    if (typeof window !== "undefined") {
+      localStorage.removeItem("aurea_consent");
+      localStorage.removeItem("aurea_consent_version");
+      localStorage.removeItem("aurea_consent_timestamp");
+    }
+    this.track("consent_revoked", {
+      timestamp: Date.now()
+    });
+    this.initialized = false;
+    if (this.config.debug) {
+      console.log("[Aurea SDK] Consent revoked, tracking stopped");
+    }
+  }
+  /**
+   * Check if consent has been given
+   */
+  hasConsent() {
+    return this.consentGiven;
+  }
+  /**
+   * Request data deletion (Right to be Forgotten)
+   */
+  async requestDataDeletion() {
+    try {
+      await fetch(`${this.config.apiUrl}/track/delete`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "X-Aurea-API-Key": this.config.apiKey,
+          "X-Aurea-Funnel-ID": this.config.funnelId
+        },
+        body: JSON.stringify({
+          anonymousId: this.anonymousId,
+          userId: this.userId
+        })
+      });
+      if (typeof window !== "undefined") {
+        localStorage.removeItem("aurea_anonymous_id");
+        localStorage.removeItem("aurea_user_id");
+        localStorage.removeItem("aurea_consent");
+        localStorage.removeItem("aurea_consent_version");
+        localStorage.removeItem("aurea_consent_timestamp");
+        sessionStorage.removeItem("aurea_session_id");
+      }
+      if (this.config.debug) {
+        console.log("[Aurea SDK] Data deletion requested");
+      }
+    } catch (error) {
+      console.error("[Aurea SDK] Failed to request data deletion:", error);
+      throw error;
+    }
+  }
   /**
    * Identify a user (links anonymous user to known user)
    */
@@ -619,9 +732,16 @@ var AureaSDK = class {
       }
     } else {
       const aspectRatio = screenWidth / screenHeight;
+      const userAgent = navigator.userAgent.toLowerCase();
+      const isMac = userAgent.includes("macintosh") || userAgent.includes("mac os x");
+      const isWindowsLaptop = userAgent.includes("windows") && userAgent.includes("touch");
+      const isChromebook = userAgent.includes("chromebook") || userAgent.includes("cros");
+      const hasLaptopKeyword = userAgent.includes("laptop");
       if (screenWidth >= 2560 || aspectRatio >= 2.2) {
         deviceType = "Ultrawide";
-      } else if (screenWidth < 1920) {
+      } else if (screenWidth <= 1920) {
+        deviceType = "Laptop";
+      } else if (screenWidth <= 2048 && (isWindowsLaptop || isChromebook || hasLaptopKeyword)) {
         deviceType = "Laptop";
       } else {
         deviceType = "Desktop";
@@ -666,6 +786,11 @@ var AureaSDK = class {
       session: {
         sessionId: this.sessionId
       },
+      gdpr: {
+        consentGiven: this.consentGiven,
+        consentVersion: this.consentVersion,
+        consentTimestamp: typeof window !== "undefined" ? localStorage.getItem("aurea_consent_timestamp") || void 0 : void 0
+      },
       device: typeof navigator !== "undefined" ? this.parseDeviceInfo() : void 0
     };
   }
@@ -850,6 +975,49 @@ var AureaSDK = class {
       }
     }
   }
+  /**
+   * Send Web Vital to dedicated endpoint
+   */
+  async sendWebVital(metric, name, rating) {
+    try {
+      const deviceInfo = this.parseDeviceInfo();
+      await fetch(`${this.config.apiUrl}/track/web-vitals`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "X-Aurea-API-Key": this.config.apiKey,
+          "X-Aurea-Funnel-ID": this.config.funnelId
+        },
+        body: JSON.stringify({
+          funnelId: this.config.funnelId,
+          sessionId: this.sessionId,
+          anonymousId: this.anonymousId,
+          pageUrl: window.location.href,
+          pagePath: window.location.pathname,
+          pageTitle: document.title,
+          metric: name.toUpperCase(),
+          value: metric.value,
+          rating: rating.toUpperCase().replace("-", "_"),
+          delta: metric.delta,
+          id_metric: metric.id,
+          deviceType: deviceInfo?.deviceType,
+          browserName: deviceInfo?.browserName,
+          browserVersion: deviceInfo?.browserVersion,
+          osName: deviceInfo?.osName,
+          osVersion: deviceInfo?.osVersion,
+          screenWidth: deviceInfo?.screenWidth,
+          screenHeight: deviceInfo?.screenHeight,
+          timestamp: /* @__PURE__ */ new Date()
+        }),
+        keepalive: true
+      });
+      if (this.config.debug) {
+        console.log(`[Aurea SDK] Web Vital sent: ${name}`, metric.value, rating);
+      }
+    } catch (error) {
+      console.error(`[Aurea SDK] Failed to send ${name}:`, error);
+    }
+  }
   /**
    * Track Core Web Vitals
    */
@@ -871,61 +1039,36 @@ var AureaSDK = class {
     onLCP((metric) => {
       if (!this.webVitalsCollected.lcp) {
         this.webVitalsCollected.lcp = true;
-        this.track("web_vital", {
-          metric: "lcp",
-          value: metric.value,
-          rating: getVitalRating("LCP", metric.value),
-          delta: metric.delta,
-          id: metric.id
-        });
+        const rating = getVitalRating("LCP", metric.value);
+        this.sendWebVital(metric, "lcp", rating);
       }
     });
     onINP((metric) => {
       if (!this.webVitalsCollected.inp) {
         this.webVitalsCollected.inp = true;
-        this.track("web_vital", {
-          metric: "inp",
-          value: metric.value,
-          rating: getVitalRating("INP", metric.value),
-          delta: metric.delta,
-          id: metric.id
-        });
+        const rating = getVitalRating("INP", metric.value);
+        this.sendWebVital(metric, "inp", rating);
       }
     });
     onCLS((metric) => {
       if (!this.webVitalsCollected.cls) {
         this.webVitalsCollected.cls = true;
-        this.track("web_vital", {
-          metric: "cls",
-          value: metric.value,
-          rating: getVitalRating("CLS", metric.value),
-          delta: metric.delta,
-          id: metric.id
-        });
+        const rating = getVitalRating("CLS", metric.value);
+        this.sendWebVital(metric, "cls", rating);
       }
     });
     onFCP((metric) => {
       if (!this.webVitalsCollected.fcp) {
         this.webVitalsCollected.fcp = true;
-        this.track("web_vital", {
-          metric: "fcp",
-          value: metric.value,
-          rating: getVitalRating("FCP", metric.value),
-          delta: metric.delta,
-          id: metric.id
-        });
+        const rating = getVitalRating("FCP", metric.value);
+        this.sendWebVital(metric, "fcp", rating);
       }
     });
     onTTFB((metric) => {
       if (!this.webVitalsCollected.ttfb) {
         this.webVitalsCollected.ttfb = true;
-        this.track("web_vital", {
-          metric: "ttfb",
-          value: metric.value,
-          rating: getVitalRating("TTFB", metric.value),
-          delta: metric.delta,
-          id: metric.id
-        });
+        const rating = getVitalRating("TTFB", metric.value);
+        this.sendWebVital(metric, "ttfb", rating);
       }
     });
     if (this.config.debug) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aurea-tracking-sdk",
-  "version": "1.3.3",
+  "version": "1.4.0",
   "description": "Standalone tracking SDK for Aurea CRM external funnels",
   "main": "dist/index.js",
   "module": "dist/index.mjs",