cloudx-react-native 2.0.0-beta.1

package/src/InterstitialAd.ts

@@ -0,0 +1,103 @@
+import { addEventListener, removeEventListener } from './EventEmitter';
+import type { AdDisplayFailedInfo, AdInfo, AdLoadFailedInfo } from './types/AdInfo';
+import type { FullscreenAdType } from './types/FullscreenAd';
+import NativeCloudXModule from './specs/NativeCloudXModule';
+
+const {
+    ON_INTERSTITIAL_LOADED_EVENT,
+    ON_INTERSTITIAL_LOAD_FAILED_EVENT,
+    ON_INTERSTITIAL_CLICKED_EVENT,
+    ON_INTERSTITIAL_DISPLAYED_EVENT,
+    ON_INTERSTITIAL_DISPLAY_FAILED_EVENT,
+    ON_INTERSTITIAL_HIDDEN_EVENT,
+    ON_INTERSTITIAL_AD_REVENUE_PAID,
+} = NativeCloudXModule.getConstants();
+
+const isAdReady = (adUnitId: string): Promise<boolean> => {
+    return NativeCloudXModule.isInterstitialReady(adUnitId);
+};
+
+const loadAd = (adUnitId: string): void => {
+    NativeCloudXModule.loadInterstitial(adUnitId);
+};
+
+const showAd = (adUnitId: string, placement?: string | null, customData?: string | null): void => {
+    NativeCloudXModule.showInterstitial(adUnitId, placement ?? undefined, customData ?? undefined);
+};
+
+const destroyAd = (adUnitId: string): void => {
+    NativeCloudXModule.destroyInterstitial(adUnitId);
+};
+
+const addAdLoadedEventListener = (listener: (adInfo: AdInfo) => void): void => {
+    addEventListener(ON_INTERSTITIAL_LOADED_EVENT, listener);
+};
+const removeAdLoadedEventListener = (): void => {
+    removeEventListener(ON_INTERSTITIAL_LOADED_EVENT);
+};
+
+const addAdLoadFailedEventListener = (listener: (errorInfo: AdLoadFailedInfo) => void): void => {
+    addEventListener(ON_INTERSTITIAL_LOAD_FAILED_EVENT, listener);
+};
+const removeAdLoadFailedEventListener = (): void => {
+    removeEventListener(ON_INTERSTITIAL_LOAD_FAILED_EVENT);
+};
+
+const addAdClickedEventListener = (listener: (adInfo: AdInfo) => void): void => {
+    addEventListener(ON_INTERSTITIAL_CLICKED_EVENT, listener);
+};
+const removeAdClickedEventListener = (): void => {
+    removeEventListener(ON_INTERSTITIAL_CLICKED_EVENT);
+};
+
+const addAdDisplayedEventListener = (listener: (adInfo: AdInfo) => void): void => {
+    addEventListener(ON_INTERSTITIAL_DISPLAYED_EVENT, listener);
+};
+const removeAdDisplayedEventListener = (): void => {
+    removeEventListener(ON_INTERSTITIAL_DISPLAYED_EVENT);
+};
+
+const addAdFailedToDisplayEventListener = (listener: (errorInfo: AdDisplayFailedInfo) => void): void => {
+    addEventListener(ON_INTERSTITIAL_DISPLAY_FAILED_EVENT, listener);
+};
+const removeAdFailedToDisplayEventListener = (): void => {
+    removeEventListener(ON_INTERSTITIAL_DISPLAY_FAILED_EVENT);
+};
+
+const addAdHiddenEventListener = (listener: (adInfo: AdInfo) => void): void => {
+    addEventListener(ON_INTERSTITIAL_HIDDEN_EVENT, listener);
+};
+const removeAdHiddenEventListener = (): void => {
+    removeEventListener(ON_INTERSTITIAL_HIDDEN_EVENT);
+};
+
+const addAdRevenuePaidListener = (listener: (adInfo: AdInfo) => void): void => {
+    addEventListener(ON_INTERSTITIAL_AD_REVENUE_PAID, listener);
+};
+const removeAdRevenuePaidListener = (): void => {
+    removeEventListener(ON_INTERSTITIAL_AD_REVENUE_PAID);
+};
+
+export const InterstitialAd: FullscreenAdType = {
+    isAdReady,
+    loadAd,
+    showAd,
+    destroyAd,
+
+    addAdLoadedEventListener,
+    removeAdLoadedEventListener,
+    addAdLoadFailedEventListener,
+    removeAdLoadFailedEventListener,
+    addAdClickedEventListener,
+    removeAdClickedEventListener,
+    addAdDisplayedEventListener,
+    removeAdDisplayedEventListener,
+    addAdFailedToDisplayEventListener,
+    removeAdFailedToDisplayEventListener,
+    addAdHiddenEventListener,
+    removeAdHiddenEventListener,
+    addAdRevenuePaidListener,
+    removeAdRevenuePaidListener,
+};
+
+export default InterstitialAd;

package/src/MRecAd.ts

@@ -0,0 +1,133 @@
+import { addEventListener, removeEventListener } from './EventEmitter';
+import type { AdInfo, AdLoadFailedInfo } from './types/AdInfo';
+import type { MRecAdType, AdViewPositionType } from './types/BannerAd';
+import NativeCloudXModule from './specs/NativeCloudXModule';
+
+const {
+    ON_MREC_AD_LOADED_EVENT,
+    ON_MREC_AD_LOAD_FAILED_EVENT,
+    ON_MREC_AD_CLICKED_EVENT,
+    ON_MREC_AD_EXPANDED_EVENT,
+    ON_MREC_AD_COLLAPSED_EVENT,
+    ON_MREC_AD_REVENUE_PAID,
+} = NativeCloudXModule.getConstants();
+
+const createAd = (adUnitId: string, position: AdViewPositionType): void => {
+    NativeCloudXModule.createMRec(adUnitId, position);
+};
+
+const createAdWithOffsets = (adUnitId: string, position: AdViewPositionType, xOffset: number, yOffset: number): void => {
+    NativeCloudXModule.createMRecWithOffsets(adUnitId, position, xOffset, yOffset);
+};
+
+const destroyAd = (adUnitId: string): void => {
+    NativeCloudXModule.destroyMRec(adUnitId);
+};
+
+const showAd = (adUnitId: string): void => {
+    NativeCloudXModule.showMRec(adUnitId);
+};
+
+const hideAd = (adUnitId: string): void => {
+    NativeCloudXModule.hideMRec(adUnitId);
+};
+
+const setPlacement = (adUnitId: string, placement: string | null): void => {
+    NativeCloudXModule.setMRecPlacement(adUnitId, placement);
+};
+
+const setCustomData = (adUnitId: string, customData: string | null): void => {
+    NativeCloudXModule.setMRecCustomData(adUnitId, customData);
+};
+
+const startAutoRefresh = (adUnitId: string): void => {
+    NativeCloudXModule.startMRecAutoRefresh(adUnitId);
+};
+
+const stopAutoRefresh = (adUnitId: string): void => {
+    NativeCloudXModule.stopMRecAutoRefresh(adUnitId);
+};
+
+const updatePosition = (adUnitId: string, position: AdViewPositionType): void => {
+    NativeCloudXModule.updateMRecPosition(adUnitId, position);
+};
+
+const updateOffsets = (adUnitId: string, xOffset: number, yOffset: number): void => {
+    NativeCloudXModule.updateMRecOffsets(adUnitId, xOffset, yOffset);
+};
+
+const setBackgroundColor = (adUnitId: string, hexColorString: string): void => {
+    NativeCloudXModule.setMRecBackgroundColor(adUnitId, hexColorString);
+};
+
+const addAdLoadedEventListener = (listener: (adInfo: AdInfo) => void): void => {
+    addEventListener(ON_MREC_AD_LOADED_EVENT, listener);
+};
+const removeAdLoadedEventListener = (): void => {
+    removeEventListener(ON_MREC_AD_LOADED_EVENT);
+};
+
+const addAdLoadFailedEventListener = (listener: (errorInfo: AdLoadFailedInfo) => void): void => {
+    addEventListener(ON_MREC_AD_LOAD_FAILED_EVENT, listener);
+};
+const removeAdLoadFailedEventListener = (): void => {
+    removeEventListener(ON_MREC_AD_LOAD_FAILED_EVENT);
+};
+
+const addAdClickedEventListener = (listener: (adInfo: AdInfo) => void): void => {
+    addEventListener(ON_MREC_AD_CLICKED_EVENT, listener);
+};
+const removeAdClickedEventListener = (): void => {
+    removeEventListener(ON_MREC_AD_CLICKED_EVENT);
+};
+
+const addAdExpandedEventListener = (listener: (adInfo: AdInfo) => void): void => {
+    addEventListener(ON_MREC_AD_EXPANDED_EVENT, listener);
+};
+const removeAdExpandedEventListener = (): void => {
+    removeEventListener(ON_MREC_AD_EXPANDED_EVENT);
+};
+
+const addAdCollapsedEventListener = (listener: (adInfo: AdInfo) => void): void => {
+    addEventListener(ON_MREC_AD_COLLAPSED_EVENT, listener);
+};
+const removeAdCollapsedEventListener = (): void => {
+    removeEventListener(ON_MREC_AD_COLLAPSED_EVENT);
+};
+
+const addAdRevenuePaidListener = (listener: (adInfo: AdInfo) => void): void => {
+    addEventListener(ON_MREC_AD_REVENUE_PAID, listener);
+};
+const removeAdRevenuePaidListener = (): void => {
+    removeEventListener(ON_MREC_AD_REVENUE_PAID);
+};
+
+export const MRecAd: MRecAdType = {
+    createAd,
+    createAdWithOffsets,
+    destroyAd,
+    showAd,
+    hideAd,
+    updatePosition,
+    updateOffsets,
+    setBackgroundColor,
+    setPlacement,
+    setCustomData,
+    startAutoRefresh,
+    stopAutoRefresh,
+
+    addAdLoadedEventListener,
+    removeAdLoadedEventListener,
+    addAdLoadFailedEventListener,
+    removeAdLoadFailedEventListener,
+    addAdClickedEventListener,
+    removeAdClickedEventListener,
+    addAdExpandedEventListener,
+    removeAdExpandedEventListener,
+    addAdCollapsedEventListener,
+    removeAdCollapsedEventListener,
+    addAdRevenuePaidListener,
+    removeAdRevenuePaidListener,
+};
+
+export default MRecAd;

package/src/RewardedAd.ts

@@ -0,0 +1,113 @@
+import { addEventListener, removeEventListener } from './EventEmitter';
+import type { AdDisplayFailedInfo, AdInfo, AdLoadFailedInfo, AdRewardInfo } from './types/AdInfo';
+import type { RewardedAdType } from './types/RewardedAd';
+import NativeCloudXModule from './specs/NativeCloudXModule';
+
+const {
+    ON_REWARDED_AD_LOADED_EVENT,
+    ON_REWARDED_AD_LOAD_FAILED_EVENT,
+    ON_REWARDED_AD_CLICKED_EVENT,
+    ON_REWARDED_AD_DISPLAYED_EVENT,
+    ON_REWARDED_AD_DISPLAY_FAILED_EVENT,
+    ON_REWARDED_AD_HIDDEN_EVENT,
+    ON_REWARDED_AD_RECEIVED_REWARD_EVENT,
+    ON_REWARDED_AD_REVENUE_PAID,
+} = NativeCloudXModule.getConstants();
+
+const isAdReady = (adUnitId: string): Promise<boolean> => {
+    return NativeCloudXModule.isRewardedReady(adUnitId);
+};
+
+const loadAd = (adUnitId: string): void => {
+    NativeCloudXModule.loadRewarded(adUnitId);
+};
+
+const showAd = (adUnitId: string, placement?: string | null, customData?: string | null): void => {
+    NativeCloudXModule.showRewarded(adUnitId, placement ?? undefined, customData ?? undefined);
+};
+
+const destroyAd = (adUnitId: string): void => {
+    NativeCloudXModule.destroyRewarded(adUnitId);
+};
+
+const addAdLoadedEventListener = (listener: (adInfo: AdInfo) => void): void => {
+    addEventListener(ON_REWARDED_AD_LOADED_EVENT, listener);
+};
+const removeAdLoadedEventListener = (): void => {
+    removeEventListener(ON_REWARDED_AD_LOADED_EVENT);
+};
+
+const addAdLoadFailedEventListener = (listener: (errorInfo: AdLoadFailedInfo) => void): void => {
+    addEventListener(ON_REWARDED_AD_LOAD_FAILED_EVENT, listener);
+};
+const removeAdLoadFailedEventListener = (): void => {
+    removeEventListener(ON_REWARDED_AD_LOAD_FAILED_EVENT);
+};
+
+const addAdClickedEventListener = (listener: (adInfo: AdInfo) => void): void => {
+    addEventListener(ON_REWARDED_AD_CLICKED_EVENT, listener);
+};
+const removeAdClickedEventListener = (): void => {
+    removeEventListener(ON_REWARDED_AD_CLICKED_EVENT);
+};
+
+const addAdDisplayedEventListener = (listener: (adInfo: AdInfo) => void): void => {
+    addEventListener(ON_REWARDED_AD_DISPLAYED_EVENT, listener);
+};
+const removeAdDisplayedEventListener = (): void => {
+    removeEventListener(ON_REWARDED_AD_DISPLAYED_EVENT);
+};
+
+const addAdFailedToDisplayEventListener = (listener: (errorInfo: AdDisplayFailedInfo) => void): void => {
+    addEventListener(ON_REWARDED_AD_DISPLAY_FAILED_EVENT, listener);
+};
+const removeAdFailedToDisplayEventListener = (): void => {
+    removeEventListener(ON_REWARDED_AD_DISPLAY_FAILED_EVENT);
+};
+
+const addAdHiddenEventListener = (listener: (adInfo: AdInfo) => void): void => {
+    addEventListener(ON_REWARDED_AD_HIDDEN_EVENT, listener);
+};
+const removeAdHiddenEventListener = (): void => {
+    removeEventListener(ON_REWARDED_AD_HIDDEN_EVENT);
+};
+
+const addAdReceivedRewardEventListener = (listener: (rewardInfo: AdRewardInfo) => void): void => {
+    addEventListener(ON_REWARDED_AD_RECEIVED_REWARD_EVENT, listener);
+};
+const removeAdReceivedRewardEventListener = (): void => {
+    removeEventListener(ON_REWARDED_AD_RECEIVED_REWARD_EVENT);
+};
+
+const addAdRevenuePaidListener = (listener: (adInfo: AdInfo) => void): void => {
+    addEventListener(ON_REWARDED_AD_REVENUE_PAID, listener);
+};
+const removeAdRevenuePaidListener = (): void => {
+    removeEventListener(ON_REWARDED_AD_REVENUE_PAID);
+};
+
+export const RewardedAd: RewardedAdType = {
+    isAdReady,
+    loadAd,
+    showAd,
+    destroyAd,
+
+    addAdLoadedEventListener,
+    removeAdLoadedEventListener,
+    addAdLoadFailedEventListener,
+    removeAdLoadFailedEventListener,
+    addAdClickedEventListener,
+    removeAdClickedEventListener,
+    addAdDisplayedEventListener,
+    removeAdDisplayedEventListener,
+    addAdFailedToDisplayEventListener,
+    removeAdFailedToDisplayEventListener,
+    addAdHiddenEventListener,
+    removeAdHiddenEventListener,
+    addAdReceivedRewardEventListener,
+    removeAdReceivedRewardEventListener,
+    addAdRevenuePaidListener,
+    removeAdRevenuePaidListener,
+};
+
+export default RewardedAd;

package/src/hooks.ts

@@ -0,0 +1,292 @@
+/**
+ * React Hooks for CloudX SDK.
+ *
+ * Provides declarative hooks for managing fullscreen and banner ad lifecycles.
+ * These are a CloudX-specific convenience layer on top of the static module APIs.
+ */
+
+import { useEffect, useState, useCallback, useRef } from 'react';
+import { NativeEventEmitter } from 'react-native';
+import type { EventSubscription } from 'react-native';
+import NativeCloudXModule from './specs/NativeCloudXModule';
+
+const emitter = new NativeEventEmitter(NativeCloudXModule);
+
+const {
+    ON_INTERSTITIAL_LOADED_EVENT,
+    ON_INTERSTITIAL_LOAD_FAILED_EVENT,
+    ON_INTERSTITIAL_DISPLAY_FAILED_EVENT,
+    ON_INTERSTITIAL_HIDDEN_EVENT,
+    ON_REWARDED_AD_LOADED_EVENT,
+    ON_REWARDED_AD_LOAD_FAILED_EVENT,
+    ON_REWARDED_AD_DISPLAY_FAILED_EVENT,
+    ON_REWARDED_AD_HIDDEN_EVENT,
+    ON_REWARDED_AD_RECEIVED_REWARD_EVENT,
+    ON_BANNER_AD_LOADED_EVENT,
+    ON_BANNER_AD_LOAD_FAILED_EVENT,
+} = NativeCloudXModule.getConstants();
+
+// ---------------------------------------------------------------------------
+// useCloudXInterstitial
+// ---------------------------------------------------------------------------
+
+export type InterstitialHookResult = {
+    isLoaded: boolean;
+    isLoading: boolean;
+    error: string | null;
+    load: () => void;
+    show: (placement?: string | null, customData?: string | null) => void;
+    destroy: () => void;
+};
+
+/**
+ * Hook for managing an interstitial ad lifecycle.
+ *
+ * @param adUnitId - The ad unit identifier.
+ */
+export function useCloudXInterstitial(adUnitId: string): InterstitialHookResult {
+    const [isLoaded, setIsLoaded] = useState(false);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState<string | null>(null);
+    const mountedRef = useRef(true);
+
+    useEffect(() => {
+        mountedRef.current = true;
+        const subs: EventSubscription[] = [];
+
+        subs.push(
+            emitter.addListener(ON_INTERSTITIAL_LOADED_EVENT, (event: { adUnitId: string }) => {
+                if (event.adUnitId === adUnitId && mountedRef.current) {
+                    setIsLoaded(true);
+                    setIsLoading(false);
+                    setError(null);
+                }
+            }),
+        );
+
+        subs.push(
+            emitter.addListener(ON_INTERSTITIAL_LOAD_FAILED_EVENT, (event: { adUnitId: string; message?: string }) => {
+                if (event.adUnitId === adUnitId && mountedRef.current) {
+                    setIsLoaded(false);
+                    setIsLoading(false);
+                    setError(event.message ?? 'Failed to load');
+                }
+            }),
+        );
+
+        subs.push(
+            emitter.addListener(ON_INTERSTITIAL_DISPLAY_FAILED_EVENT, (event: { adUnitId: string; message?: string }) => {
+                if (event.adUnitId === adUnitId && mountedRef.current) {
+                    setIsLoaded(false);
+                    setError(event.message ?? 'Display failed');
+                }
+            }),
+        );
+
+        subs.push(
+            emitter.addListener(ON_INTERSTITIAL_HIDDEN_EVENT, (event: { adUnitId: string }) => {
+                if (event.adUnitId === adUnitId && mountedRef.current) {
+                    setIsLoaded(false);
+                }
+            }),
+        );
+
+        return () => {
+            mountedRef.current = false;
+            subs.forEach((s) => s.remove());
+            NativeCloudXModule.destroyInterstitial(adUnitId);
+        };
+    }, [adUnitId]);
+
+    const load = useCallback(() => {
+        setIsLoading(true);
+        setError(null);
+        NativeCloudXModule.loadInterstitial(adUnitId);
+    }, [adUnitId]);
+
+    const show = useCallback(
+        (placement?: string | null, customData?: string | null) => {
+            if (!isLoaded) {
+                setError('Ad not loaded');
+                return;
+            }
+            NativeCloudXModule.showInterstitial(adUnitId, placement ?? undefined, customData ?? undefined);
+        },
+        [adUnitId, isLoaded],
+    );
+
+    const destroy = useCallback(() => {
+        NativeCloudXModule.destroyInterstitial(adUnitId);
+        setIsLoaded(false);
+        setIsLoading(false);
+        setError(null);
+    }, [adUnitId]);
+
+    return { isLoaded, isLoading, error, load, show, destroy };
+}
+
+// ---------------------------------------------------------------------------
+// useCloudXRewarded
+// ---------------------------------------------------------------------------
+
+export type RewardedHookResult = {
+    isLoaded: boolean;
+    isLoading: boolean;
+    error: string | null;
+    rewardEarned: boolean;
+    load: () => void;
+    show: (placement?: string | null, customData?: string | null) => void;
+    destroy: () => void;
+};
+
+/**
+ * Hook for managing a rewarded ad lifecycle.
+ *
+ * @param adUnitId - The ad unit identifier.
+ */
+export function useCloudXRewarded(adUnitId: string): RewardedHookResult {
+    const [isLoaded, setIsLoaded] = useState(false);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState<string | null>(null);
+    const [rewardEarned, setRewardEarned] = useState(false);
+    const mountedRef = useRef(true);
+
+    useEffect(() => {
+        mountedRef.current = true;
+        const subs: EventSubscription[] = [];
+
+        subs.push(
+            emitter.addListener(ON_REWARDED_AD_LOADED_EVENT, (event: { adUnitId: string }) => {
+                if (event.adUnitId === adUnitId && mountedRef.current) {
+                    setIsLoaded(true);
+                    setIsLoading(false);
+                    setError(null);
+                }
+            }),
+        );
+
+        subs.push(
+            emitter.addListener(ON_REWARDED_AD_LOAD_FAILED_EVENT, (event: { adUnitId: string; message?: string }) => {
+                if (event.adUnitId === adUnitId && mountedRef.current) {
+                    setIsLoaded(false);
+                    setIsLoading(false);
+                    setError(event.message ?? 'Failed to load');
+                }
+            }),
+        );
+
+        subs.push(
+            emitter.addListener(ON_REWARDED_AD_DISPLAY_FAILED_EVENT, (event: { adUnitId: string; message?: string }) => {
+                if (event.adUnitId === adUnitId && mountedRef.current) {
+                    setIsLoaded(false);
+                    setError(event.message ?? 'Display failed');
+                }
+            }),
+        );
+
+        subs.push(
+            emitter.addListener(ON_REWARDED_AD_HIDDEN_EVENT, (event: { adUnitId: string }) => {
+                if (event.adUnitId === adUnitId && mountedRef.current) {
+                    setIsLoaded(false);
+                }
+            }),
+        );
+
+        subs.push(
+            emitter.addListener(ON_REWARDED_AD_RECEIVED_REWARD_EVENT, (event: { adUnitId: string }) => {
+                if (event.adUnitId === adUnitId && mountedRef.current) {
+                    setRewardEarned(true);
+                }
+            }),
+        );
+
+        return () => {
+            mountedRef.current = false;
+            subs.forEach((s) => s.remove());
+            NativeCloudXModule.destroyRewarded(adUnitId);
+        };
+    }, [adUnitId]);
+
+    const load = useCallback(() => {
+        setIsLoading(true);
+        setError(null);
+        setRewardEarned(false);
+        NativeCloudXModule.loadRewarded(adUnitId);
+    }, [adUnitId]);
+
+    const show = useCallback(
+        (placement?: string | null, customData?: string | null) => {
+            if (!isLoaded) {
+                setError('Ad not loaded');
+                return;
+            }
+            NativeCloudXModule.showRewarded(adUnitId, placement ?? undefined, customData ?? undefined);
+        },
+        [adUnitId, isLoaded],
+    );
+
+    const destroy = useCallback(() => {
+        NativeCloudXModule.destroyRewarded(adUnitId);
+        setIsLoaded(false);
+        setIsLoading(false);
+        setError(null);
+        setRewardEarned(false);
+    }, [adUnitId]);
+
+    return { isLoaded, isLoading, error, rewardEarned, load, show, destroy };
+}
+
+// ---------------------------------------------------------------------------
+// useCloudXBanner
+// ---------------------------------------------------------------------------
+
+export type BannerHookResult = {
+    isLoaded: boolean;
+    error: string | null;
+};
+
+/**
+ * Hook for listening to programmatic banner ad state.
+ *
+ * Subscribes to module-level banner events for a given adUnitId.
+ * Use with the programmatic BannerAd.createAd() API.
+ * For the <AdView> component, use its callback props (onAdLoaded, etc.) directly.
+ *
+ * @param adUnitId - The ad unit identifier.
+ */
+export function useCloudXBanner(adUnitId: string): BannerHookResult {
+    const [isLoaded, setIsLoaded] = useState(false);
+    const [error, setError] = useState<string | null>(null);
+    const mountedRef = useRef(true);
+
+    useEffect(() => {
+        mountedRef.current = true;
+        const subs: EventSubscription[] = [];
+
+        subs.push(
+            emitter.addListener(ON_BANNER_AD_LOADED_EVENT, (event: { adUnitId: string }) => {
+                if (event.adUnitId === adUnitId && mountedRef.current) {
+                    setIsLoaded(true);
+                    setError(null);
+                }
+            }),
+        );
+
+        subs.push(
+            emitter.addListener(ON_BANNER_AD_LOAD_FAILED_EVENT, (event: { adUnitId: string; message?: string }) => {
+                if (event.adUnitId === adUnitId && mountedRef.current) {
+                    setIsLoaded(false);
+                    setError(event.message ?? 'Failed to load');
+                }
+            }),
+        );
+
+        return () => {
+            mountedRef.current = false;
+            subs.forEach((s) => s.remove());
+            NativeCloudXModule.destroyBanner(adUnitId);
+        };
+    }, [adUnitId]);
+
+    return { isLoaded, error };
+}

package/src/index.ts

@@ -0,0 +1,50 @@
+// Core SDK
+export { default, CloudX } from './CloudX';
+export { default as NativeCloudXModule } from './specs/NativeCloudXModule';
+
+// Ad Modules
+export { InterstitialAd } from './InterstitialAd';
+export { RewardedAd } from './RewardedAd';
+export { BannerAd } from './BannerAd';
+export { MRecAd } from './MRecAd';
+
+// AdView Component
+export { AdView, AdFormat, AdViewPosition } from './AdView';
+export type { AdViewProps, AdViewHandler } from './AdView';
+
+// Error Codes
+export { ErrorCode } from './ErrorCode';
+
+// App Tracking Transparency (iOS)
+export { requestTrackingAuthorization, getTrackingAuthorizationStatus, ATTStatus } from './AppTrackingTransparency';
+
+// Hooks
+export { useCloudXInterstitial, useCloudXRewarded, useCloudXBanner } from './hooks';
+export type { InterstitialHookResult, RewardedHookResult, BannerHookResult } from './hooks';
+
+// Types
+export type {
+    AdInfo,
+    AdLoadFailedInfo,
+    AdDisplayFailedInfo,
+    AdRewardInfo,
+    Configuration,
+    CloudXType,
+    FullscreenAdType,
+    RewardedAdType,
+    BannerAdType,
+    MRecAdType,
+    AdViewPositionType,
+} from './types';
+
+// Log level constants
+export const LogLevel = {
+    VERBOSE: 'verbose',
+    DEBUG: 'debug',
+    INFO: 'info',
+    WARN: 'warn',
+    ERROR: 'error',
+    NONE: 'none',
+} as const;
+
+export type LogLevel = (typeof LogLevel)[keyof typeof LogLevel];