@callforge/tracking-client 0.10.0 → 0.10.1

package/README.md

@@ -19,17 +19,18 @@ Client integration requirements:
 - Keep handling `phoneNumber` and `leaseId` separately. A request can return a phone number with `leaseId: null` when lease assignment is intentionally suppressed.
 - For attribution/scale metrics, treat `leaseId` as the source of truth for lease-backed traffic.
 
-## Realtime Data Layer Upgrade (v0.10+)
+## Realtime Data Layer Upgrade (v0.9+)
 
 This release adds explicit browser helpers for the new realtime layer:
-- `client.linkPhoneCall({ phoneNumber, realtime })` for strict web-click to phone-call linkage plus optional realtime fields.
+- `client.linkPhoneCall({ phoneNumber })` for strict web-click to phone-call linkage.
+- `client.setWebZip(zipCode, { source })` for immediate web ZIP availability to call processing.
 
 Integration checklist:
 - Call `linkPhoneCall` immediately before opening a `tel:` link.
 - Pass the exact dialed number string (`+1...`) used by the link.
 - Continue dialing even if `linkPhoneCall` fails (best-effort attribution assist, not UX-blocking).
-- When ZIP is known, include it in `linkPhoneCall(...realtime)` as `webZip` and `webZipSource`.
-- Use `realtime.params` for additional key/value fields you want persisted with the linked session.
+- Call `setWebZip` when the visitor selects or types a ZIP.
+- Keep `setParams` for broader attribution params; use `setWebZip` for fast ZIP propagation.
 
 ## Quick Start
 
@@ -96,40 +97,32 @@ Notes:
 - `callIntentToken` is short-lived and single-use.
 - Treat it as an opaque secret (do not log it).
 
-### 4. Realtime call-link with bundled realtime fields (recommended)
+### 4. Realtime call-link + web ZIP helpers (recommended)
 
-Use `linkPhoneCall` to create the strict call-link and optionally attach realtime fields in the same request.
+Use explicit helpers to write realtime data from the browser.
 
 ```typescript
 const client = CallForge.init({ categoryId: 'your-category-id' });
 
-async function dialTrackedNumber(phoneNumber: string, webZip?: string) {
+async function dialTrackedNumber(phoneNumber: string) {
   try {
     // Default TTL is 30s (clamped server-side to 5-120s).
-    await client.linkPhoneCall({
-      phoneNumber,
-      realtime: webZip
-        ? {
-            webZip,
-            webZipSource: 'manual', // or 'suggested'
-            params: {
-              zipChoiceMethod: 'picker',
-            },
-          }
-        : undefined,
-    });
+    await client.linkPhoneCall({ phoneNumber });
   } finally {
     // Do not block dialing on telemetry failure.
     window.location.href = `tel:${phoneNumber}`;
   }
 }
+
+// Example ZIP picker handler
+await client.setWebZip('30309', { source: 'manual' });
 ```
 
 Notes:
 - `linkPhoneCall` is optimized for mobile tap-to-call timing.
-- `realtime.webZip` accepts `manual` (typed) and `suggested` (picked from options) via `webZipSource`.
-- `realtime.webZip` is validated client-side (`12345` format).
-- `realtime.params` allows additional key/value payloads for future realtime enrichment without API changes.
+- `setWebZip` accepts `manual` (typed) and `suggested` (picked from options).
+- `setWebZip` validates ZIP format (`12345`) client-side before sending.
+- `setWebZip` also sends `webZip` as a custom session param in a best-effort sync backup path.
 
 ### 5. GA4 Integration
 
@@ -263,19 +256,12 @@ console.log(intent.callIntentToken);
 
 ### `client.linkPhoneCall(input)`
 
-Create a short-lived realtime call-link intent keyed by dialed number, with optional realtime payload fields persisted against the linked session.
+Create a short-lived realtime call-link intent keyed by dialed number.
 
 ```typescript
 const result = await client.linkPhoneCall({
   phoneNumber: '+13105551234',
   ttlSeconds: 30, // Optional, default 30s
-  realtime: {
-    webZip: '30309',          // Optional
-    webZipSource: 'manual',   // Optional, defaults to 'manual' when webZip is provided
-    params: {                 // Optional
-      zipChoiceMethod: 'picker',
-    },
-  },
 });
 
 console.log(result.status); // 'ready'
@@ -283,10 +269,25 @@ console.log(result.status); // 'ready'
 
 Use this right before `tel:` navigation so inbound call handling can perform strict 1:1 consume.
 
+### `client.setWebZip(zipCode, options?)`
+
+Store visitor-selected ZIP in the realtime profile layer for immediate call-side enrichment.
+
+```typescript
+const result = await client.setWebZip('30309', {
+  source: 'manual', // or 'suggested'
+  ttlSeconds: 3600, // Optional
+});
+
+if (result.status === 'ready') {
+  console.log(result.profile.webZipCode);
+}
+```
+
 Behavior:
-- Rejects invalid `realtime.webZip` values unless they are 5 digits.
-- Persists bundled realtime values (`webZip` + `params`) during call-link intent creation.
-- Mirrors bundled realtime values into custom params and performs a best-effort session sync backup.
+- Rejects invalid ZIP values unless they are 5 digits.
+- Writes profile data keyed by `sessionId`.
+- Also mirrors `webZip` and `webZipSource` into custom params and triggers a best-effort session sync backup.
 
 ### `client.onReady(callback)`
 
@@ -400,8 +401,7 @@ import type {
   LocationReadyCallback,
   CallIntentResponse,
   CallLinkIntentResponse,
-  LinkPhoneCallInput,
-  RealtimeLinkPayload,
+  RealtimeProfileResponse,
   RealtimeProfileSource,
 } from '@callforge/tracking-client';
 ```

package/dist/index.d.mts

@@ -92,26 +92,18 @@ interface CallLinkIntentResponse {
     expiresAt: string;
 }
 type RealtimeProfileSource = 'manual' | 'suggested';
-interface RealtimeLinkPayload {
-    /**
-     * Optional web ZIP to persist alongside call-link intent.
-     * Must be 5 digits.
-     */
-    webZip?: string;
-    /**
-     * Source for webZip. Defaults to 'manual' when webZip is provided.
-     */
-    webZipSource?: RealtimeProfileSource;
-    /**
-     * Additional realtime params to persist with the linked session.
-     */
-    params?: Record<string, string>;
-}
-interface LinkPhoneCallInput {
-    phoneNumber: string;
-    ttlSeconds?: number;
-    realtime?: RealtimeLinkPayload;
-}
+type RealtimeProfileResponse = {
+    status: 'ready';
+    profile: {
+        sessionId: string;
+        webZipCode: string;
+        webZipSource: RealtimeProfileSource;
+        webZipUpdatedAt: string;
+        expiresAt: string;
+    };
+} | {
+    status: 'unavailable';
+};
 /**
  * Callback function for onReady subscription.
  */
@@ -168,9 +160,17 @@ declare class CallForge {
      * Create a short-lived realtime call-link intent for a specific dialed number.
      * Use this immediately before opening a `tel:` link.
      */
-    linkPhoneCall(input: LinkPhoneCallInput): Promise<CallLinkIntentResponse>;
-    private normalizeRealtimeLinkPayload;
-    private buildRealtimeFallbackParams;
+    linkPhoneCall(input: {
+        phoneNumber: string;
+        ttlSeconds?: number;
+    }): Promise<CallLinkIntentResponse>;
+    /**
+     * Write visitor-selected web ZIP to the realtime data layer.
+     */
+    setWebZip(zipCode: string, options?: {
+        source?: RealtimeProfileSource;
+        ttlSeconds?: number;
+    }): Promise<RealtimeProfileResponse>;
     /**
      * Subscribe to session ready event.
      * Callback is called once session data is available.
@@ -234,4 +234,4 @@ declare class CallForge {
  */
 declare function getPreloadSnippet(config: CallForgeConfig): string;
 
-export { CallForge, type CallForgeConfig, type CallIntentResponse, type CallLinkIntentResponse, type LinkPhoneCallInput, type LocationReadyCallback, type ReadyCallback, type RealtimeLinkPayload, type RealtimeProfileSource, type TrackingLocation, type TrackingLocationSource, type TrackingParams, type TrackingSession, getPreloadSnippet };
+export { CallForge, type CallForgeConfig, type CallIntentResponse, type CallLinkIntentResponse, type LocationReadyCallback, type ReadyCallback, type RealtimeProfileResponse, type RealtimeProfileSource, type TrackingLocation, type TrackingLocationSource, type TrackingParams, type TrackingSession, getPreloadSnippet };

package/dist/index.d.ts

@@ -92,26 +92,18 @@ interface CallLinkIntentResponse {
     expiresAt: string;
 }
 type RealtimeProfileSource = 'manual' | 'suggested';
-interface RealtimeLinkPayload {
-    /**
-     * Optional web ZIP to persist alongside call-link intent.
-     * Must be 5 digits.
-     */
-    webZip?: string;
-    /**
-     * Source for webZip. Defaults to 'manual' when webZip is provided.
-     */
-    webZipSource?: RealtimeProfileSource;
-    /**
-     * Additional realtime params to persist with the linked session.
-     */
-    params?: Record<string, string>;
-}
-interface LinkPhoneCallInput {
-    phoneNumber: string;
-    ttlSeconds?: number;
-    realtime?: RealtimeLinkPayload;
-}
+type RealtimeProfileResponse = {
+    status: 'ready';
+    profile: {
+        sessionId: string;
+        webZipCode: string;
+        webZipSource: RealtimeProfileSource;
+        webZipUpdatedAt: string;
+        expiresAt: string;
+    };
+} | {
+    status: 'unavailable';
+};
 /**
  * Callback function for onReady subscription.
  */
@@ -168,9 +160,17 @@ declare class CallForge {
      * Create a short-lived realtime call-link intent for a specific dialed number.
      * Use this immediately before opening a `tel:` link.
      */
-    linkPhoneCall(input: LinkPhoneCallInput): Promise<CallLinkIntentResponse>;
-    private normalizeRealtimeLinkPayload;
-    private buildRealtimeFallbackParams;
+    linkPhoneCall(input: {
+        phoneNumber: string;
+        ttlSeconds?: number;
+    }): Promise<CallLinkIntentResponse>;
+    /**
+     * Write visitor-selected web ZIP to the realtime data layer.
+     */
+    setWebZip(zipCode: string, options?: {
+        source?: RealtimeProfileSource;
+        ttlSeconds?: number;
+    }): Promise<RealtimeProfileResponse>;
     /**
      * Subscribe to session ready event.
      * Callback is called once session data is available.
@@ -234,4 +234,4 @@ declare class CallForge {
  */
 declare function getPreloadSnippet(config: CallForgeConfig): string;
 
-export { CallForge, type CallForgeConfig, type CallIntentResponse, type CallLinkIntentResponse, type LinkPhoneCallInput, type LocationReadyCallback, type ReadyCallback, type RealtimeLinkPayload, type RealtimeProfileSource, type TrackingLocation, type TrackingLocationSource, type TrackingParams, type TrackingSession, getPreloadSnippet };
+export { CallForge, type CallForgeConfig, type CallIntentResponse, type CallLinkIntentResponse, type LocationReadyCallback, type ReadyCallback, type RealtimeProfileResponse, type RealtimeProfileSource, type TrackingLocation, type TrackingLocationSource, type TrackingParams, type TrackingSession, getPreloadSnippet };

package/dist/index.js

@@ -1,6 +1,8 @@
 "use strict";
 var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getOwnPropSymbols = Object.getOwnPropertySymbols;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
@@ -17,6 +19,7 @@ var __spreadValues = (a, b) => {
     }
   return a;
 };
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -204,6 +207,7 @@ var DEFAULT_ENDPOINT = "https://tracking.callforge.io";
 var FETCH_TIMEOUT_MS = 1e4;
 var CALL_INTENT_TIMEOUT_MS = 8e3;
 var REALTIME_CALL_LINK_TIMEOUT_MS = 5e3;
+var REALTIME_PROFILE_TIMEOUT_MS = 5e3;
 var BOOTSTRAP_TOKEN_EXPIRY_BUFFER_MS = 1e4;
 var AUTO_PARAMS = ["gclid", "gbraid", "wbraid", "msclkid", "fbclid", "gad_campaignid", "gad_source"];
 var ZIP_CODE_PATTERN = /^\d{5}$/;
@@ -297,11 +301,6 @@ var CallForge = class _CallForge {
    */
   async linkPhoneCall(input) {
     const session = await this.getSession();
-    const realtime = this.normalizeRealtimeLinkPayload(input.realtime);
-    const fallbackParams = this.buildRealtimeFallbackParams(realtime);
-    if (Object.keys(fallbackParams).length > 0) {
-      void this.setParams(fallbackParams);
-    }
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), REALTIME_CALL_LINK_TIMEOUT_MS);
     try {
@@ -312,11 +311,11 @@ var CallForge = class _CallForge {
         },
         credentials: "omit",
         signal: controller.signal,
-        body: JSON.stringify(__spreadValues({
+        body: JSON.stringify({
           sessionToken: session.sessionToken,
           phoneNumber: input.phoneNumber,
           ttlSeconds: input.ttlSeconds
-        }, realtime ? { realtime } : {}))
+        })
       });
       if (!response.ok) {
         throw new Error(`Realtime call-link API error: ${response.status} ${response.statusText}`);
@@ -326,59 +325,52 @@ var CallForge = class _CallForge {
       clearTimeout(timeoutId);
     }
   }
-  normalizeRealtimeLinkPayload(realtime) {
-    if (!realtime) {
-      return void 0;
-    }
-    const normalized = {};
-    if (typeof realtime.webZip !== "undefined") {
-      const normalizedZip = realtime.webZip.trim();
-      if (!ZIP_CODE_PATTERN.test(normalizedZip)) {
-        throw new Error("Invalid realtime.webZip. Expected a 5-digit ZIP.");
-      }
-      normalized.webZip = normalizedZip;
-    }
-    if (typeof realtime.webZipSource !== "undefined") {
-      if (realtime.webZipSource !== "manual" && realtime.webZipSource !== "suggested") {
-        throw new Error('Invalid realtime.webZipSource. Expected "manual" or "suggested".');
-      }
-      normalized.webZipSource = realtime.webZipSource;
-    }
-    if (normalized.webZipSource && !normalized.webZip) {
-      throw new Error("realtime.webZipSource requires realtime.webZip.");
+  /**
+   * Write visitor-selected web ZIP to the realtime data layer.
+   */
+  async setWebZip(zipCode, options) {
+    var _a;
+    const normalizedZip = zipCode.trim();
+    if (!ZIP_CODE_PATTERN.test(normalizedZip)) {
+      throw new Error("Invalid ZIP code. Expected a 5-digit ZIP.");
     }
-    if (realtime.params) {
-      const normalizedParams = {};
-      for (const [key, value] of Object.entries(realtime.params)) {
-        if (key.trim() === "") {
-          throw new Error("Invalid realtime.params key. Keys must be non-empty strings.");
-        }
-        if (typeof value !== "string") {
-          throw new Error(`Invalid realtime.params value for key "${key}". Expected string.`);
-        }
-        normalizedParams[key] = value;
+    const session = await this.getSession();
+    const fallbackSource = (_a = options == null ? void 0 : options.source) != null ? _a : "manual";
+    void this.setParams({
+      webZip: normalizedZip,
+      webZipSource: fallbackSource
+    });
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), REALTIME_PROFILE_TIMEOUT_MS);
+    try {
+      const response = await fetch(`${this.config.endpoint}/v1/tracking/realtime-profile`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json"
+        },
+        credentials: "omit",
+        signal: controller.signal,
+        body: JSON.stringify({
+          sessionToken: session.sessionToken,
+          webZip: normalizedZip,
+          source: options == null ? void 0 : options.source,
+          ttlSeconds: options == null ? void 0 : options.ttlSeconds
+        })
+      });
+      if (!response.ok) {
+        throw new Error(`Realtime profile API error: ${response.status} ${response.statusText}`);
       }
-      if (Object.keys(normalizedParams).length > 0) {
-        normalized.params = normalizedParams;
+      const result = await response.json();
+      if (result.status === "ready") {
+        this.customParams = __spreadProps(__spreadValues({}, this.customParams), {
+          webZip: result.profile.webZipCode,
+          webZipSource: result.profile.webZipSource
+        });
       }
+      return result;
+    } finally {
+      clearTimeout(timeoutId);
     }
-    if (normalized.webZip && !normalized.webZipSource) {
-      normalized.webZipSource = "manual";
-    }
-    if (typeof normalized.webZip === "undefined" && typeof normalized.webZipSource === "undefined" && typeof normalized.params === "undefined") {
-      return void 0;
-    }
-    return normalized;
-  }
-  buildRealtimeFallbackParams(realtime) {
-    var _a, _b;
-    if (!realtime) {
-      return {};
-    }
-    return __spreadValues(__spreadValues({}, (_a = realtime.params) != null ? _a : {}), realtime.webZip ? {
-      webZip: realtime.webZip,
-      webZipSource: (_b = realtime.webZipSource) != null ? _b : "manual"
-    } : {});
   }
   /**
    * Subscribe to session ready event.
@@ -519,14 +511,15 @@ var CallForge = class _CallForge {
     return this.formatApiResponse(data);
   }
   async fetchLocation() {
-    var _a, _b;
+    var _a, _b, _c, _d;
     const locationId = this.getLocationId();
     if (typeof window !== "undefined" && window.__cfTrackingLocation) {
       try {
         const data2 = await window.__cfTrackingLocation;
         const dataWithExtras = data2;
         const effectiveLocId = (_a = dataWithExtras.locId) != null ? _a : locationId;
-        const location2 = this.toTrackingLocation(data2.location, dataWithExtras.zipOptions);
+        const zipOptions = (_c = dataWithExtras.zipOptions) != null ? _c : (_b = data2.location) == null ? void 0 : _b.zipOptions;
+        const location2 = this.toTrackingLocation(data2.location, zipOptions);
         this.saveLocationToCache(effectiveLocId, location2, data2.expiresAt);
         return location2;
       } catch (e) {
@@ -534,7 +527,7 @@ var CallForge = class _CallForge {
     }
     const cached = this.locationCache.get(locationId);
     if (cached) {
-      return this.toTrackingLocation(cached.location, (_b = cached.location) == null ? void 0 : _b.zipOptions);
+      return this.toTrackingLocation(cached.location, (_d = cached.location) == null ? void 0 : _d.zipOptions);
     }
     const data = await this.fetchLocationFromApi(locationId);
     const location = this.toTrackingLocation(data.location, data.zipOptions);

package/dist/index.mjs

@@ -1,4 +1,6 @@
 var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
 var __getOwnPropSymbols = Object.getOwnPropertySymbols;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __propIsEnum = Object.prototype.propertyIsEnumerable;
@@ -14,6 +16,7 @@ var __spreadValues = (a, b) => {
     }
   return a;
 };
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
 
 // src/cache.ts
 var EXPIRY_BUFFER_MS = 3e4;
@@ -180,6 +183,7 @@ var DEFAULT_ENDPOINT = "https://tracking.callforge.io";
 var FETCH_TIMEOUT_MS = 1e4;
 var CALL_INTENT_TIMEOUT_MS = 8e3;
 var REALTIME_CALL_LINK_TIMEOUT_MS = 5e3;
+var REALTIME_PROFILE_TIMEOUT_MS = 5e3;
 var BOOTSTRAP_TOKEN_EXPIRY_BUFFER_MS = 1e4;
 var AUTO_PARAMS = ["gclid", "gbraid", "wbraid", "msclkid", "fbclid", "gad_campaignid", "gad_source"];
 var ZIP_CODE_PATTERN = /^\d{5}$/;
@@ -273,11 +277,6 @@ var CallForge = class _CallForge {
    */
   async linkPhoneCall(input) {
     const session = await this.getSession();
-    const realtime = this.normalizeRealtimeLinkPayload(input.realtime);
-    const fallbackParams = this.buildRealtimeFallbackParams(realtime);
-    if (Object.keys(fallbackParams).length > 0) {
-      void this.setParams(fallbackParams);
-    }
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), REALTIME_CALL_LINK_TIMEOUT_MS);
     try {
@@ -288,11 +287,11 @@ var CallForge = class _CallForge {
         },
         credentials: "omit",
         signal: controller.signal,
-        body: JSON.stringify(__spreadValues({
+        body: JSON.stringify({
           sessionToken: session.sessionToken,
           phoneNumber: input.phoneNumber,
           ttlSeconds: input.ttlSeconds
-        }, realtime ? { realtime } : {}))
+        })
       });
       if (!response.ok) {
         throw new Error(`Realtime call-link API error: ${response.status} ${response.statusText}`);
@@ -302,59 +301,52 @@ var CallForge = class _CallForge {
       clearTimeout(timeoutId);
     }
   }
-  normalizeRealtimeLinkPayload(realtime) {
-    if (!realtime) {
-      return void 0;
-    }
-    const normalized = {};
-    if (typeof realtime.webZip !== "undefined") {
-      const normalizedZip = realtime.webZip.trim();
-      if (!ZIP_CODE_PATTERN.test(normalizedZip)) {
-        throw new Error("Invalid realtime.webZip. Expected a 5-digit ZIP.");
-      }
-      normalized.webZip = normalizedZip;
-    }
-    if (typeof realtime.webZipSource !== "undefined") {
-      if (realtime.webZipSource !== "manual" && realtime.webZipSource !== "suggested") {
-        throw new Error('Invalid realtime.webZipSource. Expected "manual" or "suggested".');
-      }
-      normalized.webZipSource = realtime.webZipSource;
-    }
-    if (normalized.webZipSource && !normalized.webZip) {
-      throw new Error("realtime.webZipSource requires realtime.webZip.");
+  /**
+   * Write visitor-selected web ZIP to the realtime data layer.
+   */
+  async setWebZip(zipCode, options) {
+    var _a;
+    const normalizedZip = zipCode.trim();
+    if (!ZIP_CODE_PATTERN.test(normalizedZip)) {
+      throw new Error("Invalid ZIP code. Expected a 5-digit ZIP.");
     }
-    if (realtime.params) {
-      const normalizedParams = {};
-      for (const [key, value] of Object.entries(realtime.params)) {
-        if (key.trim() === "") {
-          throw new Error("Invalid realtime.params key. Keys must be non-empty strings.");
-        }
-        if (typeof value !== "string") {
-          throw new Error(`Invalid realtime.params value for key "${key}". Expected string.`);
-        }
-        normalizedParams[key] = value;
+    const session = await this.getSession();
+    const fallbackSource = (_a = options == null ? void 0 : options.source) != null ? _a : "manual";
+    void this.setParams({
+      webZip: normalizedZip,
+      webZipSource: fallbackSource
+    });
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), REALTIME_PROFILE_TIMEOUT_MS);
+    try {
+      const response = await fetch(`${this.config.endpoint}/v1/tracking/realtime-profile`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json"
+        },
+        credentials: "omit",
+        signal: controller.signal,
+        body: JSON.stringify({
+          sessionToken: session.sessionToken,
+          webZip: normalizedZip,
+          source: options == null ? void 0 : options.source,
+          ttlSeconds: options == null ? void 0 : options.ttlSeconds
+        })
+      });
+      if (!response.ok) {
+        throw new Error(`Realtime profile API error: ${response.status} ${response.statusText}`);
       }
-      if (Object.keys(normalizedParams).length > 0) {
-        normalized.params = normalizedParams;
+      const result = await response.json();
+      if (result.status === "ready") {
+        this.customParams = __spreadProps(__spreadValues({}, this.customParams), {
+          webZip: result.profile.webZipCode,
+          webZipSource: result.profile.webZipSource
+        });
       }
+      return result;
+    } finally {
+      clearTimeout(timeoutId);
     }
-    if (normalized.webZip && !normalized.webZipSource) {
-      normalized.webZipSource = "manual";
-    }
-    if (typeof normalized.webZip === "undefined" && typeof normalized.webZipSource === "undefined" && typeof normalized.params === "undefined") {
-      return void 0;
-    }
-    return normalized;
-  }
-  buildRealtimeFallbackParams(realtime) {
-    var _a, _b;
-    if (!realtime) {
-      return {};
-    }
-    return __spreadValues(__spreadValues({}, (_a = realtime.params) != null ? _a : {}), realtime.webZip ? {
-      webZip: realtime.webZip,
-      webZipSource: (_b = realtime.webZipSource) != null ? _b : "manual"
-    } : {});
   }
   /**
    * Subscribe to session ready event.
@@ -495,14 +487,15 @@ var CallForge = class _CallForge {
     return this.formatApiResponse(data);
   }
   async fetchLocation() {
-    var _a, _b;
+    var _a, _b, _c, _d;
     const locationId = this.getLocationId();
     if (typeof window !== "undefined" && window.__cfTrackingLocation) {
       try {
         const data2 = await window.__cfTrackingLocation;
         const dataWithExtras = data2;
         const effectiveLocId = (_a = dataWithExtras.locId) != null ? _a : locationId;
-        const location2 = this.toTrackingLocation(data2.location, dataWithExtras.zipOptions);
+        const zipOptions = (_c = dataWithExtras.zipOptions) != null ? _c : (_b = data2.location) == null ? void 0 : _b.zipOptions;
+        const location2 = this.toTrackingLocation(data2.location, zipOptions);
         this.saveLocationToCache(effectiveLocId, location2, data2.expiresAt);
         return location2;
       } catch (e) {
@@ -510,7 +503,7 @@ var CallForge = class _CallForge {
     }
     const cached = this.locationCache.get(locationId);
     if (cached) {
-      return this.toTrackingLocation(cached.location, (_b = cached.location) == null ? void 0 : _b.zipOptions);
+      return this.toTrackingLocation(cached.location, (_d = cached.location) == null ? void 0 : _d.zipOptions);
     }
     const data = await this.fetchLocationFromApi(locationId);
     const location = this.toTrackingLocation(data.location, data.zipOptions);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@callforge/tracking-client",
-  "version": "0.10.0",
+  "version": "0.10.1",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",