cloudx-react-native 3.10.0 → 3.10.1

package/src/useCloudXSdkInitialization.ts

@@ -0,0 +1,73 @@
+import { useEffect, useState } from 'react';
+import NativeCloudX from './specs/NativeCloudX';
+
+/*
+ * Once the SDK reports initialized it stays initialized for the JS VM's life,
+ * so cache it module-wide: only the first ad view mounted before init has to
+ * poll + show a placeholder; every later mount (banner, MREC, or native)
+ * renders its native view immediately.
+ */
+let cachedIsInitialized = false;
+
+/**
+ * Polls CloudX SDK initialization state and caches the result module-wide.
+ *
+ * Shared by `CloudXAdViewBase` (banner/MREC) and `CloudXNativeAdView` so
+ * every in-tree ad-view component gates native-view creation on SDK
+ * initialization identically: a view mounted before `CloudX.initialize()`
+ * completes would create its native ad against an uninitialized SDK, which
+ * on iOS returns nil and leaves the view permanently dead (no retry, no
+ * load-failed event). There is no init event to subscribe to, so poll
+ * `isInitialized()` until ready.
+ *
+ * @param componentName Used only in the console warnings, so callers can
+ * tell which component is waiting on initialization.
+ */
+export const useCloudXSdkInitializationGate = (componentName: string): boolean => {
+    const [isInitialized, setIsInitialized] = useState(cachedIsInitialized);
+
+    useEffect(() => {
+        if (cachedIsInitialized) {
+            return;
+        }
+        let cancelled = false;
+        let timer: ReturnType<typeof setTimeout> | undefined;
+        let warnedOnce = false;
+        const check = () => {
+            NativeCloudX.isInitialized()
+                .then((ready) => {
+                    if (cancelled) {
+                        return;
+                    }
+                    if (ready) {
+                        cachedIsInitialized = true;
+                        setIsInitialized(true);
+                        return;
+                    }
+                    if (!warnedOnce) {
+                        warnedOnce = true;
+                        console.warn(
+                            `${componentName} mounted before CloudX SDK initialization; will render once initialize() completes.`
+                        );
+                    }
+                    timer = setTimeout(check, 1000);
+                })
+                .catch((error) => {
+                    if (cancelled) {
+                        return;
+                    }
+                    console.warn(`${componentName} failed to read initialization state:`, error);
+                    timer = setTimeout(check, 1000);
+                });
+        };
+        check();
+        return () => {
+            cancelled = true;
+            if (timer) {
+                clearTimeout(timer);
+            }
+        };
+    }, [componentName]);
+
+    return isInitialized;
+};

package/src/version.ts

@@ -3,4 +3,4 @@
 // This value is reported to the native SDK in CloudX.initialize() and is used
 // for wrapper-version telemetry/attribution, so a stale value mis-attributes
 // installs to the wrong release.
-export const PLUGIN_VERSION = '3.10.0';
+export const PLUGIN_VERSION = '3.10.1';