aurea-tracking-sdk 1.5.1 → 1.5.3

package/dist/index.d.mts

@@ -396,6 +396,23 @@ declare class AureaSDK {
      * Generate event ID
      */
     private generateEventId;
+    /**
+     * Get cookie value by name
+     */
+    private getCookie;
+    /**
+     * Store click IDs in localStorage with attribution windows
+     */
+    private storeClickIds;
+    /**
+     * Get stored click IDs from localStorage (within attribution window)
+     * Returns only the ID strings (not the full storage object)
+     */
+    private getStoredClickIds;
+    /**
+     * Get attribution window for a platform (in milliseconds)
+     */
+    private getAttributionWindow;
 }
 /**
  * Initialize Aurea SDK

package/dist/index.d.ts

@@ -396,6 +396,23 @@ declare class AureaSDK {
      * Generate event ID
      */
     private generateEventId;
+    /**
+     * Get cookie value by name
+     */
+    private getCookie;
+    /**
+     * Store click IDs in localStorage with attribution windows
+     */
+    private storeClickIds;
+    /**
+     * Get stored click IDs from localStorage (within attribution window)
+     * Returns only the ID strings (not the full storage object)
+     */
+    private getStoredClickIds;
+    /**
+     * Get attribution window for a platform (in milliseconds)
+     */
+    private getAttributionWindow;
 }
 /**
  * Initialize Aurea SDK

package/dist/index.js

@@ -819,13 +819,68 @@ var AureaSDK = class {
         title: document.title,
         referrer: document.referrer
       } : void 0,
-      utm: {
-        source: url.searchParams.get("utm_source") || void 0,
-        medium: url.searchParams.get("utm_medium") || void 0,
-        campaign: url.searchParams.get("utm_campaign") || void 0,
-        term: url.searchParams.get("utm_term") || void 0,
-        content: url.searchParams.get("utm_content") || void 0
-      },
+      utm: (() => {
+        const utm = {
+          source: url.searchParams.get("utm_source") || void 0,
+          medium: url.searchParams.get("utm_medium") || void 0,
+          campaign: url.searchParams.get("utm_campaign") || void 0,
+          term: url.searchParams.get("utm_term") || void 0,
+          content: url.searchParams.get("utm_content") || void 0
+        };
+        if (this.config.debug && (utm.source || utm.medium || utm.campaign)) {
+          console.log("[Aurea SDK] UTM params extracted from URL:", utm, "URL:", url.href);
+        }
+        return utm;
+      })(),
+      // Ad Platform Click IDs (for attribution)
+      clickIds: (() => {
+        const clickIds = {
+          // Meta/Facebook
+          fbclid: url.searchParams.get("fbclid") || void 0,
+          fbadid: url.searchParams.get("fbadid") || void 0,
+          // Google Ads
+          gclid: url.searchParams.get("gclid") || void 0,
+          gbraid: url.searchParams.get("gbraid") || void 0,
+          wbraid: url.searchParams.get("wbraid") || void 0,
+          dclid: url.searchParams.get("dclid") || void 0,
+          // TikTok
+          ttclid: url.searchParams.get("ttclid") || void 0,
+          tt_content: url.searchParams.get("tt_content") || void 0,
+          // Microsoft/Bing
+          msclkid: url.searchParams.get("msclkid") || void 0,
+          // Twitter/X
+          twclid: url.searchParams.get("twclid") || void 0,
+          // LinkedIn
+          li_fat_id: url.searchParams.get("li_fat_id") || void 0,
+          // Snapchat
+          ScCid: url.searchParams.get("ScCid") || void 0,
+          // Pinterest
+          epik: url.searchParams.get("epik") || void 0,
+          // Reddit
+          rdt_cid: url.searchParams.get("rdt_cid") || void 0
+        };
+        if (Object.values(clickIds).some((v) => v)) {
+          this.storeClickIds(clickIds);
+        }
+        const stored = this.getStoredClickIds();
+        const merged = { ...stored, ...clickIds };
+        if (this.config.debug && Object.values(merged).some((v) => v)) {
+          console.log("[Aurea SDK] Click IDs extracted:", merged);
+        }
+        return merged;
+      })(),
+      // First-party cookies (for Conversion APIs)
+      cookies: (() => {
+        const cookies = {
+          fbp: this.getCookie("_fbp"),
+          fbc: this.getCookie("_fbc"),
+          ttp: this.getCookie("_ttp")
+        };
+        if (this.config.debug && Object.values(cookies).some((v) => v)) {
+          console.log("[Aurea SDK] First-party cookies extracted:", cookies);
+        }
+        return cookies;
+      })(),
       user: {
         userId: this.userId,
         anonymousId: this.anonymousId
@@ -937,6 +992,18 @@ var AureaSDK = class {
    */
   async sendEvents(events) {
     if (events.length === 0) return;
+    if (this.config.debug) {
+      events.forEach((evt) => {
+        if (evt.eventName === "page_view") {
+          console.log("[Aurea SDK] Sending page_view with UTM:", {
+            source: evt.context.utm?.source,
+            medium: evt.context.utm?.medium,
+            campaign: evt.context.utm?.campaign,
+            url: evt.context.page?.url
+          });
+        }
+      });
+    }
     try {
       const response = await fetch(`${this.config.apiUrl}/track/events`, {
         method: "POST",
@@ -1266,6 +1333,90 @@ var AureaSDK = class {
   generateEventId() {
     return `evt_${this.generateId()}`;
   }
+  /**
+   * Get cookie value by name
+   */
+  getCookie(name) {
+    if (typeof document === "undefined") return void 0;
+    const value = `; ${document.cookie}`;
+    const parts = value.split(`; ${name}=`);
+    if (parts.length === 2) {
+      return parts.pop()?.split(";").shift();
+    }
+    return void 0;
+  }
+  /**
+   * Store click IDs in localStorage with attribution windows
+   */
+  storeClickIds(clickIds) {
+    if (typeof localStorage === "undefined") return;
+    const stored = localStorage.getItem("aurea_click_ids");
+    const storedData = stored ? JSON.parse(stored) : {};
+    const now = Date.now();
+    Object.entries(clickIds).forEach(([platform, id]) => {
+      if (id) {
+        storedData[platform] = {
+          id,
+          timestamp: now,
+          expiresAt: now + this.getAttributionWindow(platform)
+        };
+      }
+    });
+    localStorage.setItem("aurea_click_ids", JSON.stringify(storedData));
+  }
+  /**
+   * Get stored click IDs from localStorage (within attribution window)
+   * Returns only the ID strings (not the full storage object)
+   */
+  getStoredClickIds() {
+    if (typeof localStorage === "undefined") return {};
+    const stored = localStorage.getItem("aurea_click_ids");
+    if (!stored) return {};
+    try {
+      const clickIds = JSON.parse(stored);
+      const now = Date.now();
+      const active = {};
+      for (const [platform, data] of Object.entries(clickIds)) {
+        if (now < data.expiresAt) {
+          active[platform] = data.id;
+        }
+      }
+      return active;
+    } catch (error) {
+      console.error("[Aurea SDK] Failed to parse stored click IDs:", error);
+      return {};
+    }
+  }
+  /**
+   * Get attribution window for a platform (in milliseconds)
+   */
+  getAttributionWindow(platform) {
+    const windows = {
+      fbclid: 28 * 24 * 60 * 60 * 1e3,
+      // Facebook: 28 days
+      gclid: 90 * 24 * 60 * 60 * 1e3,
+      // Google: 90 days
+      gbraid: 90 * 24 * 60 * 60 * 1e3,
+      // Google iOS: 90 days
+      wbraid: 90 * 24 * 60 * 60 * 1e3,
+      // Google iOS: 90 days
+      ttclid: 28 * 24 * 60 * 60 * 1e3,
+      // TikTok: 28 days
+      msclkid: 90 * 24 * 60 * 60 * 1e3,
+      // Microsoft: 90 days
+      twclid: 30 * 24 * 60 * 60 * 1e3,
+      // Twitter: 30 days
+      li_fat_id: 90 * 24 * 60 * 60 * 1e3,
+      // LinkedIn: 90 days
+      ScCid: 28 * 24 * 60 * 60 * 1e3,
+      // Snapchat: 28 days
+      epik: 30 * 24 * 60 * 60 * 1e3,
+      // Pinterest: 30 days
+      rdt_cid: 28 * 24 * 60 * 60 * 1e3
+      // Reddit: 28 days
+    };
+    return windows[platform] || 30 * 24 * 60 * 60 * 1e3;
+  }
 };
 var sdkInstance = null;
 function initAurea(config) {

package/dist/index.mjs

@@ -790,13 +790,68 @@ var AureaSDK = class {
         title: document.title,
         referrer: document.referrer
       } : void 0,
-      utm: {
-        source: url.searchParams.get("utm_source") || void 0,
-        medium: url.searchParams.get("utm_medium") || void 0,
-        campaign: url.searchParams.get("utm_campaign") || void 0,
-        term: url.searchParams.get("utm_term") || void 0,
-        content: url.searchParams.get("utm_content") || void 0
-      },
+      utm: (() => {
+        const utm = {
+          source: url.searchParams.get("utm_source") || void 0,
+          medium: url.searchParams.get("utm_medium") || void 0,
+          campaign: url.searchParams.get("utm_campaign") || void 0,
+          term: url.searchParams.get("utm_term") || void 0,
+          content: url.searchParams.get("utm_content") || void 0
+        };
+        if (this.config.debug && (utm.source || utm.medium || utm.campaign)) {
+          console.log("[Aurea SDK] UTM params extracted from URL:", utm, "URL:", url.href);
+        }
+        return utm;
+      })(),
+      // Ad Platform Click IDs (for attribution)
+      clickIds: (() => {
+        const clickIds = {
+          // Meta/Facebook
+          fbclid: url.searchParams.get("fbclid") || void 0,
+          fbadid: url.searchParams.get("fbadid") || void 0,
+          // Google Ads
+          gclid: url.searchParams.get("gclid") || void 0,
+          gbraid: url.searchParams.get("gbraid") || void 0,
+          wbraid: url.searchParams.get("wbraid") || void 0,
+          dclid: url.searchParams.get("dclid") || void 0,
+          // TikTok
+          ttclid: url.searchParams.get("ttclid") || void 0,
+          tt_content: url.searchParams.get("tt_content") || void 0,
+          // Microsoft/Bing
+          msclkid: url.searchParams.get("msclkid") || void 0,
+          // Twitter/X
+          twclid: url.searchParams.get("twclid") || void 0,
+          // LinkedIn
+          li_fat_id: url.searchParams.get("li_fat_id") || void 0,
+          // Snapchat
+          ScCid: url.searchParams.get("ScCid") || void 0,
+          // Pinterest
+          epik: url.searchParams.get("epik") || void 0,
+          // Reddit
+          rdt_cid: url.searchParams.get("rdt_cid") || void 0
+        };
+        if (Object.values(clickIds).some((v) => v)) {
+          this.storeClickIds(clickIds);
+        }
+        const stored = this.getStoredClickIds();
+        const merged = { ...stored, ...clickIds };
+        if (this.config.debug && Object.values(merged).some((v) => v)) {
+          console.log("[Aurea SDK] Click IDs extracted:", merged);
+        }
+        return merged;
+      })(),
+      // First-party cookies (for Conversion APIs)
+      cookies: (() => {
+        const cookies = {
+          fbp: this.getCookie("_fbp"),
+          fbc: this.getCookie("_fbc"),
+          ttp: this.getCookie("_ttp")
+        };
+        if (this.config.debug && Object.values(cookies).some((v) => v)) {
+          console.log("[Aurea SDK] First-party cookies extracted:", cookies);
+        }
+        return cookies;
+      })(),
       user: {
         userId: this.userId,
         anonymousId: this.anonymousId
@@ -908,6 +963,18 @@ var AureaSDK = class {
    */
   async sendEvents(events) {
     if (events.length === 0) return;
+    if (this.config.debug) {
+      events.forEach((evt) => {
+        if (evt.eventName === "page_view") {
+          console.log("[Aurea SDK] Sending page_view with UTM:", {
+            source: evt.context.utm?.source,
+            medium: evt.context.utm?.medium,
+            campaign: evt.context.utm?.campaign,
+            url: evt.context.page?.url
+          });
+        }
+      });
+    }
     try {
       const response = await fetch(`${this.config.apiUrl}/track/events`, {
         method: "POST",
@@ -1237,6 +1304,90 @@ var AureaSDK = class {
   generateEventId() {
     return `evt_${this.generateId()}`;
   }
+  /**
+   * Get cookie value by name
+   */
+  getCookie(name) {
+    if (typeof document === "undefined") return void 0;
+    const value = `; ${document.cookie}`;
+    const parts = value.split(`; ${name}=`);
+    if (parts.length === 2) {
+      return parts.pop()?.split(";").shift();
+    }
+    return void 0;
+  }
+  /**
+   * Store click IDs in localStorage with attribution windows
+   */
+  storeClickIds(clickIds) {
+    if (typeof localStorage === "undefined") return;
+    const stored = localStorage.getItem("aurea_click_ids");
+    const storedData = stored ? JSON.parse(stored) : {};
+    const now = Date.now();
+    Object.entries(clickIds).forEach(([platform, id]) => {
+      if (id) {
+        storedData[platform] = {
+          id,
+          timestamp: now,
+          expiresAt: now + this.getAttributionWindow(platform)
+        };
+      }
+    });
+    localStorage.setItem("aurea_click_ids", JSON.stringify(storedData));
+  }
+  /**
+   * Get stored click IDs from localStorage (within attribution window)
+   * Returns only the ID strings (not the full storage object)
+   */
+  getStoredClickIds() {
+    if (typeof localStorage === "undefined") return {};
+    const stored = localStorage.getItem("aurea_click_ids");
+    if (!stored) return {};
+    try {
+      const clickIds = JSON.parse(stored);
+      const now = Date.now();
+      const active = {};
+      for (const [platform, data] of Object.entries(clickIds)) {
+        if (now < data.expiresAt) {
+          active[platform] = data.id;
+        }
+      }
+      return active;
+    } catch (error) {
+      console.error("[Aurea SDK] Failed to parse stored click IDs:", error);
+      return {};
+    }
+  }
+  /**
+   * Get attribution window for a platform (in milliseconds)
+   */
+  getAttributionWindow(platform) {
+    const windows = {
+      fbclid: 28 * 24 * 60 * 60 * 1e3,
+      // Facebook: 28 days
+      gclid: 90 * 24 * 60 * 60 * 1e3,
+      // Google: 90 days
+      gbraid: 90 * 24 * 60 * 60 * 1e3,
+      // Google iOS: 90 days
+      wbraid: 90 * 24 * 60 * 60 * 1e3,
+      // Google iOS: 90 days
+      ttclid: 28 * 24 * 60 * 60 * 1e3,
+      // TikTok: 28 days
+      msclkid: 90 * 24 * 60 * 60 * 1e3,
+      // Microsoft: 90 days
+      twclid: 30 * 24 * 60 * 60 * 1e3,
+      // Twitter: 30 days
+      li_fat_id: 90 * 24 * 60 * 60 * 1e3,
+      // LinkedIn: 90 days
+      ScCid: 28 * 24 * 60 * 60 * 1e3,
+      // Snapchat: 28 days
+      epik: 30 * 24 * 60 * 60 * 1e3,
+      // Pinterest: 30 days
+      rdt_cid: 28 * 24 * 60 * 60 * 1e3
+      // Reddit: 28 days
+    };
+    return windows[platform] || 30 * 24 * 60 * 60 * 1e3;
+  }
 };
 var sdkInstance = null;
 function initAurea(config) {

package/package.json

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