@callforge/tracking-client 0.9.2 → 0.10.0

package/README.md

@@ -19,18 +19,17 @@ 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.9+)
+## Realtime Data Layer Upgrade (v0.10+)
 
 This release adds explicit browser helpers for the new realtime layer:
-- `client.linkPhoneCall({ phoneNumber })` for strict web-click to phone-call linkage.
-- `client.setWebZip(zipCode, { source })` for immediate web ZIP availability to call processing.
+- `client.linkPhoneCall({ phoneNumber, realtime })` for strict web-click to phone-call linkage plus optional realtime fields.
 
 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).
-- Call `setWebZip` when the visitor selects or types a ZIP.
-- Keep `setParams` for broader attribution params; use `setWebZip` for fast ZIP propagation.
+- 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.
 
 ## Quick Start
 
@@ -97,32 +96,40 @@ Notes:
 - `callIntentToken` is short-lived and single-use.
 - Treat it as an opaque secret (do not log it).
 
-### 4. Realtime call-link + web ZIP helpers (recommended)
+### 4. Realtime call-link with bundled realtime fields (recommended)
 
-Use explicit helpers to write realtime data from the browser.
+Use `linkPhoneCall` to create the strict call-link and optionally attach realtime fields in the same request.
 
 ```typescript
 const client = CallForge.init({ categoryId: 'your-category-id' });
 
-async function dialTrackedNumber(phoneNumber: string) {
+async function dialTrackedNumber(phoneNumber: string, webZip?: string) {
   try {
     // Default TTL is 30s (clamped server-side to 5-120s).
-    await client.linkPhoneCall({ phoneNumber });
+    await client.linkPhoneCall({
+      phoneNumber,
+      realtime: webZip
+        ? {
+            webZip,
+            webZipSource: 'manual', // or 'suggested'
+            params: {
+              zipChoiceMethod: 'picker',
+            },
+          }
+        : undefined,
+    });
   } 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.
-- `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.
+- `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.
 
 ### 5. GA4 Integration
 
@@ -256,12 +263,19 @@ console.log(intent.callIntentToken);
 
 ### `client.linkPhoneCall(input)`
 
-Create a short-lived realtime call-link intent keyed by dialed number.
+Create a short-lived realtime call-link intent keyed by dialed number, with optional realtime payload fields persisted against the linked session.
 
 ```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'
@@ -269,25 +283,10 @@ 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 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.
+- 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.
 
 ### `client.onReady(callback)`
 
@@ -401,7 +400,8 @@ import type {
   LocationReadyCallback,
   CallIntentResponse,
   CallLinkIntentResponse,
-  RealtimeProfileResponse,
+  LinkPhoneCallInput,
+  RealtimeLinkPayload,
   RealtimeProfileSource,
 } from '@callforge/tracking-client';
 ```

package/dist/index.d.mts

@@ -92,18 +92,26 @@ interface CallLinkIntentResponse {
     expiresAt: string;
 }
 type RealtimeProfileSource = 'manual' | 'suggested';
-type RealtimeProfileResponse = {
-    status: 'ready';
-    profile: {
-        sessionId: string;
-        webZipCode: string;
-        webZipSource: RealtimeProfileSource;
-        webZipUpdatedAt: string;
-        expiresAt: string;
-    };
-} | {
-    status: 'unavailable';
-};
+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;
+}
 /**
  * Callback function for onReady subscription.
  */
@@ -160,17 +168,9 @@ 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: {
-        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>;
+    linkPhoneCall(input: LinkPhoneCallInput): Promise<CallLinkIntentResponse>;
+    private normalizeRealtimeLinkPayload;
+    private buildRealtimeFallbackParams;
     /**
      * 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 LocationReadyCallback, type ReadyCallback, type RealtimeProfileResponse, type RealtimeProfileSource, type TrackingLocation, type TrackingLocationSource, type TrackingParams, type TrackingSession, getPreloadSnippet };
+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 };

package/dist/index.d.ts

@@ -92,18 +92,26 @@ interface CallLinkIntentResponse {
     expiresAt: string;
 }
 type RealtimeProfileSource = 'manual' | 'suggested';
-type RealtimeProfileResponse = {
-    status: 'ready';
-    profile: {
-        sessionId: string;
-        webZipCode: string;
-        webZipSource: RealtimeProfileSource;
-        webZipUpdatedAt: string;
-        expiresAt: string;
-    };
-} | {
-    status: 'unavailable';
-};
+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;
+}
 /**
  * Callback function for onReady subscription.
  */
@@ -160,17 +168,9 @@ 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: {
-        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>;
+    linkPhoneCall(input: LinkPhoneCallInput): Promise<CallLinkIntentResponse>;
+    private normalizeRealtimeLinkPayload;
+    private buildRealtimeFallbackParams;
     /**
      * 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 LocationReadyCallback, type ReadyCallback, type RealtimeProfileResponse, type RealtimeProfileSource, type TrackingLocation, type TrackingLocationSource, type TrackingParams, type TrackingSession, getPreloadSnippet };
+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 };

package/dist/index.js

@@ -1,8 +1,6 @@
 "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;
@@ -19,7 +17,6 @@ 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 });
@@ -207,7 +204,6 @@ 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}$/;
@@ -301,6 +297,11 @@ 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 {
@@ -311,11 +312,11 @@ var CallForge = class _CallForge {
         },
         credentials: "omit",
         signal: controller.signal,
-        body: JSON.stringify({
+        body: JSON.stringify(__spreadValues({
           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}`);
@@ -325,52 +326,59 @@ var CallForge = class _CallForge {
       clearTimeout(timeoutId);
     }
   }
-  /**
-   * 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.");
+  normalizeRealtimeLinkPayload(realtime) {
+    if (!realtime) {
+      return void 0;
     }
-    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}`);
+    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.");
       }
-      const result = await response.json();
-      if (result.status === "ready") {
-        this.customParams = __spreadProps(__spreadValues({}, this.customParams), {
-          webZip: result.profile.webZipCode,
-          webZipSource: result.profile.webZipSource
-        });
+      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".');
       }
-      return result;
-    } finally {
-      clearTimeout(timeoutId);
+      normalized.webZipSource = realtime.webZipSource;
+    }
+    if (normalized.webZipSource && !normalized.webZip) {
+      throw new Error("realtime.webZipSource requires realtime.webZip.");
     }
+    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;
+      }
+      if (Object.keys(normalizedParams).length > 0) {
+        normalized.params = normalizedParams;
+      }
+    }
+    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.
@@ -553,11 +561,8 @@ var CallForge = class _CallForge {
   async fetchFromApi(locationId, sessionToken, params) {
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
-    let didForceRefreshBootstrap = false;
-    let usedBootstrapTokenInInitialRequest = false;
     try {
       let bootstrapToken = this.getCachedBootstrapToken();
-      usedBootstrapTokenInInitialRequest = !!bootstrapToken;
       let response = await fetch(
         this.buildUrl(locationId, sessionToken, params, bootstrapToken),
         {
@@ -567,7 +572,6 @@ var CallForge = class _CallForge {
       );
       if (response.status === 401) {
         bootstrapToken = await this.getBootstrapToken(true);
-        didForceRefreshBootstrap = true;
         if (bootstrapToken) {
           response = await fetch(
             this.buildUrl(locationId, sessionToken, params, bootstrapToken),
@@ -581,24 +585,7 @@ var CallForge = class _CallForge {
       if (!response.ok) {
         throw new Error(`API error: ${response.status} ${response.statusText}`);
       }
-      let data = await response.json();
-      if (data.leaseId === null && !usedBootstrapTokenInInitialRequest && !didForceRefreshBootstrap) {
-        const refreshedBootstrapToken = await this.getBootstrapToken(true);
-        didForceRefreshBootstrap = true;
-        if (refreshedBootstrapToken) {
-          const retryResponse = await fetch(
-            this.buildUrl(locationId, sessionToken, params, refreshedBootstrapToken),
-            {
-              credentials: "omit",
-              signal: controller.signal
-            }
-          );
-          if (retryResponse.ok) {
-            data = await retryResponse.json();
-          }
-        }
-      }
-      return data;
+      return await response.json();
     } finally {
       clearTimeout(timeoutId);
     }

package/dist/index.mjs

@@ -1,6 +1,4 @@
 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;
@@ -16,7 +14,6 @@ var __spreadValues = (a, b) => {
     }
   return a;
 };
-var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
 
 // src/cache.ts
 var EXPIRY_BUFFER_MS = 3e4;
@@ -183,7 +180,6 @@ 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}$/;
@@ -277,6 +273,11 @@ 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 {
@@ -287,11 +288,11 @@ var CallForge = class _CallForge {
         },
         credentials: "omit",
         signal: controller.signal,
-        body: JSON.stringify({
+        body: JSON.stringify(__spreadValues({
           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}`);
@@ -301,52 +302,59 @@ var CallForge = class _CallForge {
       clearTimeout(timeoutId);
     }
   }
-  /**
-   * 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.");
+  normalizeRealtimeLinkPayload(realtime) {
+    if (!realtime) {
+      return void 0;
     }
-    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}`);
+    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.");
       }
-      const result = await response.json();
-      if (result.status === "ready") {
-        this.customParams = __spreadProps(__spreadValues({}, this.customParams), {
-          webZip: result.profile.webZipCode,
-          webZipSource: result.profile.webZipSource
-        });
+      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".');
       }
-      return result;
-    } finally {
-      clearTimeout(timeoutId);
+      normalized.webZipSource = realtime.webZipSource;
+    }
+    if (normalized.webZipSource && !normalized.webZip) {
+      throw new Error("realtime.webZipSource requires realtime.webZip.");
     }
+    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;
+      }
+      if (Object.keys(normalizedParams).length > 0) {
+        normalized.params = normalizedParams;
+      }
+    }
+    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.
@@ -529,11 +537,8 @@ var CallForge = class _CallForge {
   async fetchFromApi(locationId, sessionToken, params) {
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
-    let didForceRefreshBootstrap = false;
-    let usedBootstrapTokenInInitialRequest = false;
     try {
       let bootstrapToken = this.getCachedBootstrapToken();
-      usedBootstrapTokenInInitialRequest = !!bootstrapToken;
       let response = await fetch(
         this.buildUrl(locationId, sessionToken, params, bootstrapToken),
         {
@@ -543,7 +548,6 @@ var CallForge = class _CallForge {
       );
       if (response.status === 401) {
         bootstrapToken = await this.getBootstrapToken(true);
-        didForceRefreshBootstrap = true;
         if (bootstrapToken) {
           response = await fetch(
             this.buildUrl(locationId, sessionToken, params, bootstrapToken),
@@ -557,24 +561,7 @@ var CallForge = class _CallForge {
       if (!response.ok) {
         throw new Error(`API error: ${response.status} ${response.statusText}`);
       }
-      let data = await response.json();
-      if (data.leaseId === null && !usedBootstrapTokenInInitialRequest && !didForceRefreshBootstrap) {
-        const refreshedBootstrapToken = await this.getBootstrapToken(true);
-        didForceRefreshBootstrap = true;
-        if (refreshedBootstrapToken) {
-          const retryResponse = await fetch(
-            this.buildUrl(locationId, sessionToken, params, refreshedBootstrapToken),
-            {
-              credentials: "omit",
-              signal: controller.signal
-            }
-          );
-          if (retryResponse.ok) {
-            data = await retryResponse.json();
-          }
-        }
-      }
-      return data;
+      return await response.json();
     } finally {
       clearTimeout(timeoutId);
     }

package/package.json

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