@callforge/tracking-client 0.6.2 → 0.6.3

package/README.md

@@ -83,6 +83,7 @@ Requirements:
 
 How it works:
 - Extracts the GA4 `client_id` from the `_ga` cookie and sends it to CallForge as `ga4ClientId`.
+- Polls briefly after init to capture the cookie if Google Analytics sets it slightly later.
 - If `ga4MeasurementId` is configured and `gtag` is available, also uses `gtag('get', measurementId, 'client_id', ...)` (with a short retry window).
 - If `ga4ClientId` becomes available after a session is created, the client will refresh once to sync it to CallForge.
 
@@ -187,6 +188,7 @@ client.setParams({
 
 Behavior:
 - Merges with existing params (later calls override earlier values).
+- If a session already exists (cached `sessionToken`), the client will refresh once to sync updated params server-side (best-effort).
 - Parameters are sent with every `getSession()` API request.
 - Persisted in localStorage alongside session data.
 

package/dist/index.d.mts

@@ -113,7 +113,10 @@ declare class CallForge {
      */
     onReady(callback: ReadyCallback): void;
     /**
-     * Set custom tracking parameters for the next session fetch.
+     * Set custom tracking parameters for attribution.
+     *
+     * When possible, the client will also refresh the session once to sync
+     * the updated params to CallForge (so server-side events can use them).
      */
     setParams(params: Record<string, string>): Promise<void>;
     /**
@@ -142,7 +145,7 @@ declare class CallForge {
     private saveToCache;
     private formatSession;
     private formatApiResponse;
-    private syncGA4ClientIdIfNeeded;
+    private syncParamsToCallForgeIfPossible;
     private buildUrl;
 }
 

package/dist/index.d.ts

@@ -113,7 +113,10 @@ declare class CallForge {
      */
     onReady(callback: ReadyCallback): void;
     /**
-     * Set custom tracking parameters for the next session fetch.
+     * Set custom tracking parameters for attribution.
+     *
+     * When possible, the client will also refresh the session once to sync
+     * the updated params to CallForge (so server-side events can use them).
      */
     setParams(params: Record<string, string>): Promise<void>;
     /**
@@ -142,7 +145,7 @@ declare class CallForge {
     private saveToCache;
     private formatSession;
     private formatApiResponse;
-    private syncGA4ClientIdIfNeeded;
+    private syncParamsToCallForgeIfPossible;
     private buildUrl;
 }
 

package/dist/index.js

@@ -210,23 +210,27 @@ var CallForge = class _CallForge {
     });
   }
   /**
-   * Set custom tracking parameters for the next session fetch.
+   * Set custom tracking parameters for attribution.
+   *
+   * When possible, the client will also refresh the session once to sync
+   * the updated params to CallForge (so server-side events can use them).
    */
   async setParams(params) {
     this.customParams = __spreadValues(__spreadValues({}, this.customParams), params);
-    if (params.ga4ClientId) {
-      const sync = async () => {
-        try {
-          await this.syncGA4ClientIdIfNeeded();
-        } catch (e) {
-        }
-      };
-      if (this.sessionPromise) {
-        void this.sessionPromise.then(sync).catch(() => {
-        });
-      } else {
-        void sync();
+    const sync = async () => {
+      try {
+        await this.syncParamsToCallForgeIfPossible();
+      } catch (e) {
+      }
+    };
+    if (this.sessionPromise) {
+      try {
+        await this.sessionPromise;
+      } catch (e) {
       }
+      await sync();
+    } else {
+      await sync();
     }
   }
   /**
@@ -259,7 +263,6 @@ var CallForge = class _CallForge {
     });
   }
   startGA4ClientIdPolling() {
-    if (!this.config.ga4MeasurementId) return;
     if (typeof window === "undefined") return;
     if (this.customParams.ga4ClientId) return;
     const MAX_ATTEMPTS = 20;
@@ -391,18 +394,13 @@ var CallForge = class _CallForge {
       location: data.location
     };
   }
-  async syncGA4ClientIdIfNeeded() {
-    const ga4ClientId = this.customParams.ga4ClientId;
-    if (!ga4ClientId) return;
+  async syncParamsToCallForgeIfPossible() {
     const locationId = this.getLocationId();
     const sessionToken = this.cache.getSessionToken(locationId);
     if (!sessionToken) return;
     const autoParams = this.getAutoParams();
     const cachedParams = this.cache.getParams();
     const params = __spreadValues(__spreadValues(__spreadValues({}, autoParams), cachedParams), this.customParams);
-    if (cachedParams.ga4ClientId === params.ga4ClientId) {
-      return;
-    }
     const data = await this.fetchFromApi(locationId, sessionToken, params);
     this.saveToCache(locationId, data, params);
   }

package/dist/index.mjs

@@ -186,23 +186,27 @@ var CallForge = class _CallForge {
     });
   }
   /**
-   * Set custom tracking parameters for the next session fetch.
+   * Set custom tracking parameters for attribution.
+   *
+   * When possible, the client will also refresh the session once to sync
+   * the updated params to CallForge (so server-side events can use them).
    */
   async setParams(params) {
     this.customParams = __spreadValues(__spreadValues({}, this.customParams), params);
-    if (params.ga4ClientId) {
-      const sync = async () => {
-        try {
-          await this.syncGA4ClientIdIfNeeded();
-        } catch (e) {
-        }
-      };
-      if (this.sessionPromise) {
-        void this.sessionPromise.then(sync).catch(() => {
-        });
-      } else {
-        void sync();
+    const sync = async () => {
+      try {
+        await this.syncParamsToCallForgeIfPossible();
+      } catch (e) {
+      }
+    };
+    if (this.sessionPromise) {
+      try {
+        await this.sessionPromise;
+      } catch (e) {
       }
+      await sync();
+    } else {
+      await sync();
     }
   }
   /**
@@ -235,7 +239,6 @@ var CallForge = class _CallForge {
     });
   }
   startGA4ClientIdPolling() {
-    if (!this.config.ga4MeasurementId) return;
     if (typeof window === "undefined") return;
     if (this.customParams.ga4ClientId) return;
     const MAX_ATTEMPTS = 20;
@@ -367,18 +370,13 @@ var CallForge = class _CallForge {
       location: data.location
     };
   }
-  async syncGA4ClientIdIfNeeded() {
-    const ga4ClientId = this.customParams.ga4ClientId;
-    if (!ga4ClientId) return;
+  async syncParamsToCallForgeIfPossible() {
     const locationId = this.getLocationId();
     const sessionToken = this.cache.getSessionToken(locationId);
     if (!sessionToken) return;
     const autoParams = this.getAutoParams();
     const cachedParams = this.cache.getParams();
     const params = __spreadValues(__spreadValues(__spreadValues({}, autoParams), cachedParams), this.customParams);
-    if (cachedParams.ga4ClientId === params.ga4ClientId) {
-      return;
-    }
     const data = await this.fetchFromApi(locationId, sessionToken, params);
     this.saveToCache(locationId, data, params);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@callforge/tracking-client",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
@@ -17,17 +17,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"
   }
-}
+}