@virex-tech/paywallo-sdk 2.3.0 → 2.4.1

package/dist/index.mjs

@@ -412,11 +412,28 @@ function parseProperties(json) {
     return {};
   }
 }
-var DEVICE_ID_KEY, ANON_ID_KEY, USER_EMAIL_KEY, USER_PROPERTIES_KEY, USER_DISTINCT_ID_KEY, USER_NAME_KEY, USER_COUNTRY_KEY, USER_LOCALE_KEY, USER_PHONE_KEY, USER_FIRST_NAME_KEY, USER_LAST_NAME_KEY, USER_DOB_KEY, USER_GENDER_KEY, LEGACY_USER_PHONE_KEY, LEGACY_USER_FIRST_NAME_KEY, LEGACY_USER_LAST_NAME_KEY, LEGACY_USER_DOB_KEY, LEGACY_USER_GENDER_KEY, LEGACY_DEVICE_ID_KEY, LEGACY_ANON_ID_KEY, LEGACY_EMAIL_KEY, LEGACY_PROPERTIES_KEY, LEGACY_DISTINCT_ID_KEY, LEGACY_NAME_KEY, LEGACY_COUNTRY_KEY, LEGACY_LOCALE_KEY;
+async function persistAnonIdDurably(storage, anonId) {
+  let stored = await storage.set(ANON_ID_KEY, anonId);
+  for (let i = 0; i < ANON_ID_SET_RETRIES && !stored; i++) {
+    await new Promise((r) => setTimeout(r, ANON_ID_RETRY_DELAY_MS));
+    stored = await storage.set(ANON_ID_KEY, anonId);
+  }
+  if (!stored) {
+    await nativeStorage.set(ANON_ID_FALLBACK_KEY, anonId).catch(() => void 0);
+  }
+}
+async function readAnonIdDurably(storage) {
+  const secure = await readWithMigration(storage, ANON_ID_KEY, LEGACY_ANON_ID_KEY);
+  if (secure) return secure;
+  return nativeStorage.get(ANON_ID_FALLBACK_KEY);
+}
+var DEVICE_ID_KEY, ANON_ID_FALLBACK_KEY, ANON_ID_KEY, USER_EMAIL_KEY, USER_PROPERTIES_KEY, USER_DISTINCT_ID_KEY, USER_NAME_KEY, USER_COUNTRY_KEY, USER_LOCALE_KEY, USER_PHONE_KEY, USER_FIRST_NAME_KEY, USER_LAST_NAME_KEY, USER_DOB_KEY, USER_GENDER_KEY, LEGACY_USER_PHONE_KEY, LEGACY_USER_FIRST_NAME_KEY, LEGACY_USER_LAST_NAME_KEY, LEGACY_USER_DOB_KEY, LEGACY_USER_GENDER_KEY, LEGACY_DEVICE_ID_KEY, LEGACY_ANON_ID_KEY, LEGACY_EMAIL_KEY, LEGACY_PROPERTIES_KEY, LEGACY_DISTINCT_ID_KEY, LEGACY_NAME_KEY, LEGACY_COUNTRY_KEY, LEGACY_LOCALE_KEY, ANON_ID_SET_RETRIES, ANON_ID_RETRY_DELAY_MS;
 var init_IdentityStorage = __esm({
   "src/domains/identity/IdentityStorage.ts"() {
     "use strict";
+    init_NativeStorage();
     DEVICE_ID_KEY = "@paywallo:device_id";
+    ANON_ID_FALLBACK_KEY = "@paywallo:anon_id_fallback";
     ANON_ID_KEY = "@paywallo:anon_id";
     USER_EMAIL_KEY = "@paywallo:user_email";
     USER_PROPERTIES_KEY = "@paywallo:user_properties";
@@ -442,6 +459,8 @@ var init_IdentityStorage = __esm({
     LEGACY_NAME_KEY = "user_name";
     LEGACY_COUNTRY_KEY = "user_country";
     LEGACY_LOCALE_KEY = "user_locale";
+    ANON_ID_SET_RETRIES = 2;
+    ANON_ID_RETRY_DELAY_MS = 50;
   }
 });
 
@@ -521,8 +540,7 @@ var init_IdentityManager = __esm({
         }
         if (!this.anonId) {
           this.anonId = generateUUID();
-          await this.secureStorage.set(ANON_ID_KEY, this.anonId).catch(() => {
-          });
+          await persistAnonIdDurably(this.secureStorage, this.anonId);
         }
         this.initialized = true;
         return this.deviceId ?? "";
@@ -582,7 +600,8 @@ var init_IdentityManager = __esm({
               dateOfBirth: this.dateOfBirth ?? void 0,
               gender: this.gender ?? void 0
             });
-          } catch {
+          } catch (err) {
+            if (this.debug) console.log("[Paywallo] identify dispatch error", err);
           }
         }
       }
@@ -606,7 +625,8 @@ var init_IdentityManager = __esm({
         if (this.apiClient && this.anonId) {
           try {
             await this.apiClient.identify(this.anonId, this.properties, this.email ?? void 0, this.deviceId ?? void 0);
-          } catch {
+          } catch (err) {
+            if (this.debug) console.log("[Paywallo] identify dispatch error", err);
           }
         }
       }
@@ -649,18 +669,20 @@ var init_IdentityManager = __esm({
       }
       async loadPersistedState() {
         if (!this.secureStorage) return;
-        const state = await loadPersistedIdentity(this.secureStorage);
+        const [state, rawAnonId] = await Promise.all([
+          loadPersistedIdentity(this.secureStorage),
+          readAnonIdDurably(this.secureStorage)
+        ]);
         const deviceId = state.deviceId ?? await readDeviceIdWithFallback(this.secureStorage);
         if (deviceId) this.deviceId = deviceId;
-        if (state.anonId) {
+        if (rawAnonId) {
           const legacyPrefix = "$paywallo_anon:";
-          if (state.anonId.startsWith(legacyPrefix)) {
-            const stripped = state.anonId.slice(legacyPrefix.length);
+          if (rawAnonId.startsWith(legacyPrefix)) {
+            const stripped = rawAnonId.slice(legacyPrefix.length);
             this.anonId = stripped;
-            await this.secureStorage.set(ANON_ID_KEY, stripped).catch(() => {
-            });
+            await this.secureStorage.set(ANON_ID_KEY, stripped).catch(() => void 0);
           } else {
-            this.anonId = state.anonId;
+            this.anonId = rawAnonId;
           }
         }
         if (state.email) this.email = state.email;
@@ -885,21 +907,23 @@ var init_AdvertisingIdManager = __esm({
           if (Platform.OS === "ios") {
             if (!tracking.isAvailable()) {
               const idfv2 = await this.collectIdfv();
-              this.cached = { ...fallback, idfv: idfv2 };
-              return this.cached;
+              const result2 = { ...fallback, idfv: idfv2 };
+              if (idfv2 !== null) this.cached = result2;
+              return result2;
             }
             const current = await tracking.getTrackingPermissionsAsync();
             let status = current.status;
             let granted = current.granted;
             if (status === "undetermined" && requestATT) {
-              const result = await tracking.requestTrackingPermissionsAsync();
-              status = result.status;
-              granted = result.granted;
+              const result2 = await tracking.requestTrackingPermissionsAsync();
+              status = result2.status;
+              granted = result2.granted;
             }
             const idfv = await this.collectIdfv();
             const idfa = granted ? this.sanitizeId(tracking.getAdvertisingId()) : null;
-            this.cached = { idfv, idfa, gaid: null, attStatus: status };
-            return this.cached;
+            const result = { idfv, idfa, gaid: null, attStatus: status };
+            if (idfv !== null) this.cached = result;
+            return result;
           }
           if (Platform.OS === "android") {
             const rawGaid = tracking.getAdvertisingId();
@@ -915,12 +939,20 @@ var init_AdvertisingIdManager = __esm({
         }
       }
       async collectIdfv() {
-        try {
-          const info = await nativeDeviceInfo.getDeviceInfo();
-          return this.sanitizeId(info.idfv);
-        } catch {
-          return null;
+        const RETRY_DELAY_MS = 80;
+        const MAX_ATTEMPTS = 3;
+        for (let attempt = 0; attempt < MAX_ATTEMPTS; attempt++) {
+          try {
+            const info = await nativeDeviceInfo.getDeviceInfo();
+            const idfv = this.sanitizeId(info.idfv);
+            if (idfv !== null) return idfv;
+          } catch {
+          }
+          if (attempt < MAX_ATTEMPTS - 1) {
+            await new Promise((resolve) => setTimeout(resolve, RETRY_DELAY_MS));
+          }
         }
+        return null;
       }
       sanitizeId(id) {
         if (!id || id === ZERO_IDFA) return null;
@@ -1358,6 +1390,8 @@ var init_AttributionTracker = __esm({
 
 // src/domains/identity/InstallIdempotency.ts
 async function checkAndArmInstallGuard(storage) {
+  if (armedThisLaunch) return true;
+  armedThisLaunch = true;
   const alreadyTracked = await storage.get(INSTALL_KEYS.INSTALL_TRACKED);
   if (alreadyTracked) return true;
   let fallbackTracked = null;
@@ -1391,7 +1425,7 @@ async function getOrCreateInstallEventId() {
   });
   return id;
 }
-var INSTALL_KEYS;
+var INSTALL_KEYS, armedThisLaunch;
 var init_InstallIdempotency = __esm({
   "src/domains/identity/InstallIdempotency.ts"() {
     "use strict";
@@ -1416,6 +1450,7 @@ var init_InstallIdempotency = __esm({
       /** Legacy anon ID key written by SDK versions that used @panel: prefix. */
       LEGACY_ANON_ID: "@panel:anon_id"
     };
+    armedThisLaunch = false;
   }
 });
 
@@ -2370,8 +2405,8 @@ var init_NotificationHandlerSetup = __esm({
 // src/core/version.ts
 function resolveVersion() {
   try {
-    if ("2.3.0") {
-      return "2.3.0";
+    if ("2.4.1") {
+      return "2.4.1";
     }
   } catch {
   }
@@ -4244,10 +4279,10 @@ var init_OfflineQueueStorage = __esm({
     init_NativeStorage();
     init_QueueJournal();
     OfflineQueueStorage = class {
-      constructor(config, emit, log2) {
+      constructor(config, emit, log3) {
         this.config = config;
         this.emit = emit;
-        this.log = log2;
+        this.log = log3;
       }
       async loadFromStorage(queue) {
         const { merged, recovered, hadJournal } = await mergeJournalIntoMain(
@@ -4496,11 +4531,11 @@ var init_OfflineQueue = __esm({
           });
           return true;
         }
-        const delay = Math.min(
+        const delay2 = Math.min(
           this.config.baseRetryDelayMs * Math.pow(2, item.attempts - 1),
           this.config.maxRetryDelayMs
         );
-        item.nextRetryAt = Date.now() + delay;
+        item.nextRetryAt = Date.now() + delay2;
         await this.storage.saveToStorage(this.queue);
         return false;
       }
@@ -7778,8 +7813,8 @@ var init_HttpClient = __esm({
             if (this.shouldRetry(response.status, retryConfig)) {
               if (state.attempt < retryConfig.maxRetries) {
                 state.attempt++;
-                const delay = this.calculateDelayForResponse(state.attempt, response.headers, retryConfig);
-                await this.sleep(delay);
+                const delay2 = this.calculateDelayForResponse(state.attempt, response.headers, retryConfig);
+                await this.sleep(delay2);
                 continue;
               }
             }
@@ -7788,8 +7823,8 @@ var init_HttpClient = __esm({
             state.lastError = error instanceof Error ? error : new ClientError(CLIENT_ERROR_CODES.UNKNOWN, String(error));
             if (this.isNetworkError(state.lastError) && state.attempt < retryConfig.maxRetries) {
               state.attempt++;
-              const delay = this.calculateDelay(state.attempt, retryConfig);
-              await this.sleep(delay);
+              const delay2 = this.calculateDelay(state.attempt, retryConfig);
+              await this.sleep(delay2);
               continue;
             }
             throw state.lastError;
@@ -7938,7 +7973,36 @@ var init_http = __esm({
 
 // src/core/ApiClient.ts
 import { Platform as Platform15 } from "react-native";
-var ApiClient;
+function normalizeDateOfBirth(raw) {
+  if (!raw) return void 0;
+  if (DATE_OF_BIRTH_RE.test(raw)) return raw;
+  const d = new Date(raw);
+  if (isNaN(d.getTime())) return void 0;
+  const hasTimeComponent = raw.includes("T") || raw.includes("Z");
+  const yyyy = hasTimeComponent ? d.getUTCFullYear() : d.getFullYear();
+  const mm = String((hasTimeComponent ? d.getUTCMonth() : d.getMonth()) + 1).padStart(2, "0");
+  const dd = String(hasTimeComponent ? d.getUTCDate() : d.getDate()).padStart(2, "0");
+  return `${yyyy}-${mm}-${dd}`;
+}
+function buildPiiPayload(pii) {
+  const result = {};
+  if (pii.phone) result.phone = pii.phone;
+  if (pii.firstName) result.firstName = pii.firstName;
+  if (pii.lastName) result.lastName = pii.lastName;
+  const dob = normalizeDateOfBirth(pii.dateOfBirth);
+  if (dob) result.dateOfBirth = dob;
+  const g = normalizeGender(pii.gender);
+  if (g) result.gender = g;
+  return result;
+}
+function normalizeGender(raw) {
+  if (!raw) return void 0;
+  const lower = raw.toLowerCase();
+  if (lower === "m" || lower === "male") return "m";
+  if (lower === "f" || lower === "female") return "f";
+  return void 0;
+}
+var DATE_OF_BIRTH_RE, ApiClient;
 var init_ApiClient = __esm({
   "src/core/ApiClient.ts"() {
     "use strict";
@@ -7951,6 +8015,7 @@ var init_ApiClient = __esm({
     init_http();
     init_queue();
     init_version();
+    DATE_OF_BIRTH_RE = /^\d{4}-\d{2}-\d{2}$/;
     ApiClient = class {
       constructor(appKey, apiUrl, debug = false, environment = "Production", offlineQueueEnabled = true, timeout = 3e4) {
         this.cache = new ApiCache();
@@ -8125,11 +8190,7 @@ var init_ApiClient = __esm({
             traits,
             ...attribution && { attribution },
             ...deviceId && { deviceId },
-            ...pii?.phone && { phone: pii.phone },
-            ...pii?.firstName && { firstName: pii.firstName },
-            ...pii?.lastName && { lastName: pii.lastName },
-            ...pii?.dateOfBirth && { dateOfBirth: pii.dateOfBirth },
-            ...pii?.gender && { gender: pii.gender }
+            ...pii ? buildPiiPayload(pii) : {}
           },
           "identify"
         );
@@ -8415,8 +8476,8 @@ async function initWithRetry(state, config) {
     } catch (error) {
       state.initAttempts++;
       if (state.initAttempts > MAX_INIT_RETRIES) throw error;
-      const delay = RETRY_DELAYS[state.initAttempts - 1] ?? 1e4;
-      await new Promise((resolve) => setTimeout(resolve, delay));
+      const delay2 = RETRY_DELAYS[state.initAttempts - 1] ?? 1e4;
+      await new Promise((resolve) => setTimeout(resolve, delay2));
     }
   }
 }
@@ -9691,6 +9752,108 @@ init_paywall();
 init_paywall();
 init_paywall();
 
+// src/domains/paywall/SuperwallAttributeBridge.ts
+init_identity();
+var CONFIG_POLL_INTERVAL_MS = 250;
+var CONFIG_POLL_MAX_ATTEMPTS = 40;
+var lastSignature = null;
+function log(debug, msg, data) {
+  if (!debug) return;
+  if (data !== void 0) console.log(`[Paywallo:SuperwallAttr] ${msg}`, data);
+  else console.log(`[Paywallo:SuperwallAttr] ${msg}`);
+}
+function delay(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+var PAID_MEDIUM = /cpc|ppc|cpm|cpa|paid|display/i;
+function deriveIsPaid(a) {
+  if (a.fbclid || a.gclid || a.ttclid || a.tiktokCampaignId) return true;
+  return Boolean(a.utmMedium && PAID_MEDIUM.test(a.utmMedium));
+}
+function deriveAdNetwork(a) {
+  if (a.fbclid) return "meta";
+  if (a.ttclid || a.tiktokCampaignId) return "tiktok";
+  if (a.gclid) return "google";
+  return a.utmSource;
+}
+function buildSuperwallAttributes(a) {
+  const out = {};
+  if (!a) {
+    out.pw_is_paid = false;
+    return out;
+  }
+  const set2 = (key, value) => {
+    if (value) out[key] = value;
+  };
+  set2("pw_utm_source", a.utmSource);
+  set2("pw_utm_medium", a.utmMedium);
+  set2("pw_utm_campaign", a.utmCampaign);
+  set2("pw_utm_content", a.utmContent);
+  set2("pw_utm_term", a.utmTerm);
+  set2("pw_fbclid", a.fbclid);
+  set2("pw_gclid", a.gclid);
+  set2("pw_ttclid", a.ttclid);
+  set2("pw_tiktok_campaign_id", a.tiktokCampaignId);
+  set2("pw_tiktok_adgroup_id", a.tiktokAdgroupId);
+  set2("pw_tiktok_ad_id", a.tiktokAdId);
+  set2("pw_referrer", a.referrer);
+  set2("pw_install_referrer_source", a.installReferrerSource);
+  set2("pw_ad_network", deriveAdNetwork(a));
+  out.pw_is_paid = deriveIsPaid(a);
+  out.pw_attributed_at = a.capturedAt;
+  return out;
+}
+function pickNative(mod) {
+  const native = mod?.SuperwallExpoModule ?? mod?.default?.SuperwallExpoModule;
+  return native && typeof native.setUserAttributes === "function" && typeof native.getConfigurationStatus === "function" ? native : null;
+}
+async function resolveSuperwallNativeModule(debug) {
+  try {
+    const native = pickNative(await import("expo-superwall"));
+    if (native) return native;
+  } catch {
+  }
+  log(debug, "expo-superwall native module not available \u2014 attribute push skipped");
+  return null;
+}
+async function waitForConfigured(mod, debug) {
+  for (let attempt = 0; attempt < CONFIG_POLL_MAX_ATTEMPTS; attempt++) {
+    let status;
+    try {
+      status = String(await mod.getConfigurationStatus());
+    } catch (err) {
+      log(debug, "getConfigurationStatus error", { err: String(err) });
+      return false;
+    }
+    if (status === "CONFIGURED") return true;
+    if (status === "FAILED") {
+      log(debug, "Superwall configuration FAILED \u2014 skipping attribute push");
+      return false;
+    }
+    await delay(CONFIG_POLL_INTERVAL_MS);
+  }
+  log(debug, "Superwall not configured within timeout \u2014 skipping attribute push");
+  return false;
+}
+async function pushAttributionToSuperwall(debug = false) {
+  const attrs = buildSuperwallAttributes(attributionTracker.get());
+  const signature = JSON.stringify(attrs);
+  if (signature === lastSignature) {
+    log(debug, "attributes unchanged \u2014 skipping push");
+    return;
+  }
+  const native = await resolveSuperwallNativeModule(debug);
+  if (!native) return;
+  if (!await waitForConfigured(native, debug)) return;
+  try {
+    await native.setUserAttributes(attrs);
+    lastSignature = signature;
+    log(debug, "attributes pushed to Superwall", attrs);
+  } catch (err) {
+    log(debug, "setUserAttributes error", { err: String(err) });
+  }
+}
+
 // src/domains/paywall/SuperwallAutoBridge.ts
 init_PaywalloClient();
 
@@ -9724,7 +9887,7 @@ function buildDeterministicEventId(parts) {
 var bridgeStarted = false;
 var unsubscribe = null;
 var debugEnabled = false;
-function log(msg, data) {
+function log2(msg, data) {
   if (!debugEnabled) return;
   if (data !== void 0) {
     console.log(`[Paywallo:SuperwallBridge] ${msg}`, data);
@@ -9754,7 +9917,7 @@ async function trackPaywallEvent(type, identifier, ts, extra) {
       }
     });
   } catch (err) {
-    log("track error", { type, identifier, eventId: _eventId, err: String(err) });
+    log2("track error", { type, identifier, eventId: _eventId, err: String(err) });
   }
 }
 function mapDismissToCloseReason(resultType) {
@@ -9774,7 +9937,7 @@ function buildCallbacks() {
   return {
     onPaywallPresent: (info) => {
       const ts = Date.now();
-      log("onPaywallPresent", { identifier: info.identifier });
+      log2("onPaywallPresent", { identifier: info.identifier });
       void trackPaywallEvent("viewed", info.identifier, ts, {
         placement: info.presentedByEventWithName,
         variant_id: info.experiment?.variant?.id,
@@ -9783,7 +9946,7 @@ function buildCallbacks() {
     },
     onPaywallDismiss: (info, result) => {
       const ts = Date.now();
-      log("onPaywallDismiss", { identifier: info.identifier, result: result.type });
+      log2("onPaywallDismiss", { identifier: info.identifier, result: result.type });
       void trackPaywallEvent("closed", info.identifier, ts, {
         placement: info.presentedByEventWithName,
         variant_id: info.experiment?.variant?.id,
@@ -9797,7 +9960,7 @@ function buildCallbacks() {
       const safe = params !== null && typeof params === "object" ? params : {};
       const productId = "productId" in safe && typeof safe.productId === "string" ? safe.productId : "unknown";
       const identifier = "paywallIdentifier" in safe && typeof safe.paywallIdentifier === "string" ? safe.paywallIdentifier : productId;
-      log("onPurchase", { productId, identifier });
+      log2("onPurchase", { productId, identifier });
       void trackPaywallEvent("purchased", identifier, ts, { product_id: productId });
     },
     // Global Superwall event listener — used specifically for `transactionComplete`
@@ -9812,7 +9975,7 @@ function buildCallbacks() {
       const product = ev.product;
       const transaction = ev.transaction;
       if (!product) {
-        log("transactionComplete missing product \u2014 skipping transaction track");
+        log2("transactionComplete missing product \u2014 skipping transaction track");
         return;
       }
       const productId = product.productIdentifier ?? product.id ?? "unknown";
@@ -9821,7 +9984,7 @@ function buildCallbacks() {
       const transactionId = transaction?.storeTransactionId ?? transaction?.originalTransactionIdentifier ?? `${productId}_${String(ts)}`;
       const isTrial = product.hasFreeTrial === true || (product.trialPeriodPrice ?? 0) > 0;
       const paywallIdentifier = ev.paywallInfo?.identifier;
-      log("onSuperwallEvent: transactionComplete", { productId, currency, price, transactionId, isTrial });
+      log2("onSuperwallEvent: transactionComplete", { productId, currency, price, transactionId, isTrial });
       void (async () => {
         try {
           await PaywalloClient.track("transaction", {
@@ -9839,7 +10002,7 @@ function buildCallbacks() {
             }
           });
         } catch (err) {
-          log("transactionComplete track error", { err: String(err) });
+          log2("transactionComplete track error", { err: String(err) });
         }
       })();
     }
@@ -9848,7 +10011,7 @@ function buildCallbacks() {
 function startSuperwallAutoBridge(debug = false) {
   debugEnabled = debug;
   if (bridgeStarted) {
-    log("already started, skipping");
+    log2("already started, skipping");
     return;
   }
   void detectAndStart();
@@ -9860,7 +10023,7 @@ async function detectAndStart() {
     if (!mod || typeof mod.subscribeToSuperwallEvents !== "function") {
       const internal = await import("expo-superwall/build/src/internal/superwallEventBridge");
       if (typeof internal.subscribeToSuperwallEvents !== "function") {
-        log("expo-superwall subscribeToSuperwallEvents not found \u2014 bridge inactive");
+        log2("expo-superwall subscribeToSuperwallEvents not found \u2014 bridge inactive");
         return;
       }
       subscribeFn = internal.subscribeToSuperwallEvents;
@@ -9868,16 +10031,16 @@ async function detectAndStart() {
       subscribeFn = mod.subscribeToSuperwallEvents;
     }
   } catch {
-    log("expo-superwall not installed \u2014 bridge inactive");
+    log2("expo-superwall not installed \u2014 bridge inactive");
     return;
   }
   try {
     const callbacks = buildCallbacks();
     unsubscribe = subscribeFn(void 0, () => callbacks);
     bridgeStarted = true;
-    log("bridge started");
+    log2("bridge started");
   } catch (err) {
-    log("subscribe failed", { err: String(err) });
+    log2("subscribe failed", { err: String(err) });
   }
 }
 
@@ -10450,6 +10613,7 @@ function PaywalloProvider({ children, config }) {
       if (!mounted) return;
       setDistinctId(PaywalloClient.getDistinctId());
       startSuperwallAutoBridge(configRef.current.debug);
+      void pushAttributionToSuperwall(configRef.current.debug);
       setIsInitialized(true);
       if (!autoPreloadTriggeredRef.current) {
         autoPreloadTriggeredRef.current = true;