@callforge/tracking-client 0.2.0 → 0.3.0

package/dist/index.d.mts

@@ -77,6 +77,10 @@ declare class CallForge {
     private readonly cache;
     private sessionPromise;
     private customParams;
+    private ga4PollInterval;
+    private ga4PollTimeout;
+    private sessionId;
+    private sessionCreated;
     private constructor();
     /**
      * Initialize the CallForge tracking client.
@@ -94,9 +98,22 @@ declare class CallForge {
     onReady(callback: ReadyCallback): void;
     /**
      * Set custom tracking parameters.
-     * Merges with existing params (new values override).
+     * If session already exists, sends PATCH to update.
+     * Otherwise queues params for next session request.
      */
-    setParams(params: Record<string, string>): void;
+    setParams(params: Record<string, string>): Promise<void>;
+    /**
+     * Get the currently queued custom params.
+     */
+    getQueuedParams(): TrackingParams;
+    private patchSession;
+    /**
+     * Start polling for the GA4 _ga cookie.
+     * If found immediately, calls setParams right away.
+     * Otherwise polls every 500ms for up to 10 seconds.
+     */
+    startGA4CookiePolling(): void;
+    private stopGA4CookiePolling;
     private fetchSession;
     private getLocationId;
     private getAutoParams;

package/dist/index.d.ts

@@ -77,6 +77,10 @@ declare class CallForge {
     private readonly cache;
     private sessionPromise;
     private customParams;
+    private ga4PollInterval;
+    private ga4PollTimeout;
+    private sessionId;
+    private sessionCreated;
     private constructor();
     /**
      * Initialize the CallForge tracking client.
@@ -94,9 +98,22 @@ declare class CallForge {
     onReady(callback: ReadyCallback): void;
     /**
      * Set custom tracking parameters.
-     * Merges with existing params (new values override).
+     * If session already exists, sends PATCH to update.
+     * Otherwise queues params for next session request.
      */
-    setParams(params: Record<string, string>): void;
+    setParams(params: Record<string, string>): Promise<void>;
+    /**
+     * Get the currently queued custom params.
+     */
+    getQueuedParams(): TrackingParams;
+    private patchSession;
+    /**
+     * Start polling for the GA4 _ga cookie.
+     * If found immediately, calls setParams right away.
+     * Otherwise polls every 500ms for up to 10 seconds.
+     */
+    startGA4CookiePolling(): void;
+    private stopGA4CookiePolling;
     private fetchSession;
     private getLocationId;
     private getAutoParams;

package/dist/index.js

@@ -129,17 +129,27 @@ var TrackingCache = class {
 
 // src/client.ts
 var DEFAULT_ENDPOINT = "https://tracking.callforge.io";
+function getGA4ClientId() {
+  if (typeof document === "undefined") return null;
+  const match = document.cookie.match(/_ga=GA\d+\.\d+\.(.+?)(?:;|$)/);
+  return match ? match[1] : null;
+}
 var FETCH_TIMEOUT_MS = 1e4;
 var AUTO_PARAMS = ["gclid", "gbraid", "wbraid", "msclkid", "fbclid"];
 var CallForge = class _CallForge {
   constructor(config) {
     this.sessionPromise = null;
     this.customParams = {};
+    this.ga4PollInterval = null;
+    this.ga4PollTimeout = null;
+    this.sessionId = null;
+    this.sessionCreated = false;
     this.config = {
       categoryId: config.categoryId,
       endpoint: config.endpoint || DEFAULT_ENDPOINT
     };
     this.cache = new TrackingCache(config.categoryId);
+    this.startGA4CookiePolling();
   }
   /**
    * Initialize the CallForge tracking client.
@@ -168,16 +178,80 @@ var CallForge = class _CallForge {
   }
   /**
    * Set custom tracking parameters.
-   * Merges with existing params (new values override).
+   * If session already exists, sends PATCH to update.
+   * Otherwise queues params for next session request.
    */
-  setParams(params) {
+  async setParams(params) {
     this.customParams = __spreadValues(__spreadValues({}, this.customParams), params);
+    if (this.sessionCreated && this.sessionId) {
+      await this.patchSession(params);
+    }
+  }
+  /**
+   * Get the currently queued custom params.
+   */
+  getQueuedParams() {
+    return __spreadValues({}, this.customParams);
+  }
+  async patchSession(params) {
+    try {
+      const response = await fetch(
+        `${this.config.endpoint}/v1/tracking/session/${this.sessionId}`,
+        {
+          method: "PATCH",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify(params)
+        }
+      );
+      if (!response.ok) {
+        console.warn("[CallForge] Failed to patch session:", response.status);
+      }
+    } catch (error) {
+      console.warn("[CallForge] Failed to patch session:", error);
+    }
+  }
+  /**
+   * Start polling for the GA4 _ga cookie.
+   * If found immediately, calls setParams right away.
+   * Otherwise polls every 500ms for up to 10 seconds.
+   */
+  startGA4CookiePolling() {
+    if (this.ga4PollInterval !== null || this.ga4PollTimeout !== null) {
+      return;
+    }
+    const clientId = getGA4ClientId();
+    if (clientId) {
+      this.setParams({ ga4ClientId: clientId });
+      return;
+    }
+    this.ga4PollInterval = setInterval(() => {
+      const clientId2 = getGA4ClientId();
+      if (clientId2) {
+        this.setParams({ ga4ClientId: clientId2 });
+        this.stopGA4CookiePolling();
+      }
+    }, 500);
+    this.ga4PollTimeout = setTimeout(() => {
+      this.stopGA4CookiePolling();
+    }, 1e4);
+  }
+  stopGA4CookiePolling() {
+    if (this.ga4PollInterval) {
+      clearInterval(this.ga4PollInterval);
+      this.ga4PollInterval = null;
+    }
+    if (this.ga4PollTimeout) {
+      clearTimeout(this.ga4PollTimeout);
+      this.ga4PollTimeout = null;
+    }
   }
   async fetchSession() {
     const locationId = this.getLocationId();
     if (locationId) {
       const cached = this.cache.get(locationId);
       if (cached) {
+        this.sessionId = cached.sessionId;
+        this.sessionCreated = true;
         return this.formatSession(cached);
       }
     }
@@ -188,15 +262,19 @@ var CallForge = class _CallForge {
       try {
         const data2 = await window.__cfTracking;
         this.saveToCache(locationId, data2, params);
+        this.sessionId = data2.sessionId;
+        this.sessionCreated = true;
         return this.formatApiResponse(data2);
       } catch (e) {
       }
     }
-    const sessionId = locationId ? this.cache.getSessionId(locationId) : null;
-    const data = await this.fetchFromApi(locationId, sessionId, params);
+    const cachedSessionId = locationId ? this.cache.getSessionId(locationId) : null;
+    const data = await this.fetchFromApi(locationId, cachedSessionId, params);
     if (locationId) {
       this.saveToCache(locationId, data, params);
     }
+    this.sessionId = data.sessionId;
+    this.sessionCreated = true;
     return this.formatApiResponse(data);
   }
   getLocationId() {

package/dist/index.mjs

@@ -105,17 +105,27 @@ var TrackingCache = class {
 
 // src/client.ts
 var DEFAULT_ENDPOINT = "https://tracking.callforge.io";
+function getGA4ClientId() {
+  if (typeof document === "undefined") return null;
+  const match = document.cookie.match(/_ga=GA\d+\.\d+\.(.+?)(?:;|$)/);
+  return match ? match[1] : null;
+}
 var FETCH_TIMEOUT_MS = 1e4;
 var AUTO_PARAMS = ["gclid", "gbraid", "wbraid", "msclkid", "fbclid"];
 var CallForge = class _CallForge {
   constructor(config) {
     this.sessionPromise = null;
     this.customParams = {};
+    this.ga4PollInterval = null;
+    this.ga4PollTimeout = null;
+    this.sessionId = null;
+    this.sessionCreated = false;
     this.config = {
       categoryId: config.categoryId,
       endpoint: config.endpoint || DEFAULT_ENDPOINT
     };
     this.cache = new TrackingCache(config.categoryId);
+    this.startGA4CookiePolling();
   }
   /**
    * Initialize the CallForge tracking client.
@@ -144,16 +154,80 @@ var CallForge = class _CallForge {
   }
   /**
    * Set custom tracking parameters.
-   * Merges with existing params (new values override).
+   * If session already exists, sends PATCH to update.
+   * Otherwise queues params for next session request.
    */
-  setParams(params) {
+  async setParams(params) {
     this.customParams = __spreadValues(__spreadValues({}, this.customParams), params);
+    if (this.sessionCreated && this.sessionId) {
+      await this.patchSession(params);
+    }
+  }
+  /**
+   * Get the currently queued custom params.
+   */
+  getQueuedParams() {
+    return __spreadValues({}, this.customParams);
+  }
+  async patchSession(params) {
+    try {
+      const response = await fetch(
+        `${this.config.endpoint}/v1/tracking/session/${this.sessionId}`,
+        {
+          method: "PATCH",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify(params)
+        }
+      );
+      if (!response.ok) {
+        console.warn("[CallForge] Failed to patch session:", response.status);
+      }
+    } catch (error) {
+      console.warn("[CallForge] Failed to patch session:", error);
+    }
+  }
+  /**
+   * Start polling for the GA4 _ga cookie.
+   * If found immediately, calls setParams right away.
+   * Otherwise polls every 500ms for up to 10 seconds.
+   */
+  startGA4CookiePolling() {
+    if (this.ga4PollInterval !== null || this.ga4PollTimeout !== null) {
+      return;
+    }
+    const clientId = getGA4ClientId();
+    if (clientId) {
+      this.setParams({ ga4ClientId: clientId });
+      return;
+    }
+    this.ga4PollInterval = setInterval(() => {
+      const clientId2 = getGA4ClientId();
+      if (clientId2) {
+        this.setParams({ ga4ClientId: clientId2 });
+        this.stopGA4CookiePolling();
+      }
+    }, 500);
+    this.ga4PollTimeout = setTimeout(() => {
+      this.stopGA4CookiePolling();
+    }, 1e4);
+  }
+  stopGA4CookiePolling() {
+    if (this.ga4PollInterval) {
+      clearInterval(this.ga4PollInterval);
+      this.ga4PollInterval = null;
+    }
+    if (this.ga4PollTimeout) {
+      clearTimeout(this.ga4PollTimeout);
+      this.ga4PollTimeout = null;
+    }
   }
   async fetchSession() {
     const locationId = this.getLocationId();
     if (locationId) {
       const cached = this.cache.get(locationId);
       if (cached) {
+        this.sessionId = cached.sessionId;
+        this.sessionCreated = true;
         return this.formatSession(cached);
       }
     }
@@ -164,15 +238,19 @@ var CallForge = class _CallForge {
       try {
         const data2 = await window.__cfTracking;
         this.saveToCache(locationId, data2, params);
+        this.sessionId = data2.sessionId;
+        this.sessionCreated = true;
         return this.formatApiResponse(data2);
       } catch (e) {
       }
     }
-    const sessionId = locationId ? this.cache.getSessionId(locationId) : null;
-    const data = await this.fetchFromApi(locationId, sessionId, params);
+    const cachedSessionId = locationId ? this.cache.getSessionId(locationId) : null;
+    const data = await this.fetchFromApi(locationId, cachedSessionId, params);
     if (locationId) {
       this.saveToCache(locationId, data, params);
     }
+    this.sessionId = data.sessionId;
+    this.sessionCreated = true;
     return this.formatApiResponse(data);
   }
   getLocationId() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@callforge/tracking-client",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "main": "dist/index.js",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -14,17 +14,17 @@
   "files": [
     "dist"
   ],
-  "devDependencies": {
-    "jsdom": "^27.4.0",
-    "tsup": "^8.0.0",
-    "typescript": "^5.3.0",
-    "vitest": "^1.6.0",
-    "@callforge/tsconfig": "0.0.0"
-  },
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts",
     "clean": "rm -rf dist",
     "test": "vitest run",
     "test:watch": "vitest"
+  },
+  "devDependencies": {
+    "@callforge/tsconfig": "workspace:*",
+    "jsdom": "^27.4.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.6.0"
   }
-}
+}