cloudx-react-native 2.0.0-beta.1 → 2.2.3

package/android/src/main/java/com/cloudxreactnative/CloudXModuleImpl.kt

@@ -0,0 +1,694 @@
+package com.cloudxreactnative
+
+import android.app.Activity
+import android.graphics.Color
+import android.util.Log
+import android.view.Gravity
+import android.view.OrientationEventListener
+import android.view.View
+import android.view.ViewGroup
+import android.widget.LinearLayout
+import android.widget.RelativeLayout
+import com.facebook.react.bridge.Arguments
+import com.facebook.react.bridge.LifecycleEventListener
+import com.facebook.react.bridge.Promise
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.WritableMap
+import com.facebook.react.modules.core.DeviceEventManagerModule
+import io.cloudx.sdk.CloudX
+import io.cloudx.sdk.CloudXAd
+import io.cloudx.sdk.CloudXAdFormat
+import io.cloudx.sdk.CloudXAdRevenueListener
+import io.cloudx.sdk.CloudXAdView as SdkAdView
+import io.cloudx.sdk.CloudXAdViewListener
+import io.cloudx.sdk.CloudXError
+import io.cloudx.sdk.CloudXInitializationConfiguration
+import io.cloudx.sdk.CloudXInitializationListener
+import io.cloudx.sdk.CloudXInterstitialAd
+import io.cloudx.sdk.CloudXInterstitialListener
+import io.cloudx.sdk.CloudXLogLevel
+import io.cloudx.sdk.CloudXReward
+import io.cloudx.sdk.CloudXRewardedAd
+import io.cloudx.sdk.CloudXRewardedListener
+import io.cloudx.sdk.CloudXSdkConfiguration
+import java.util.concurrent.ConcurrentHashMap
+
+class CloudXModuleImpl(private val reactApplicationContext: ReactApplicationContext) : LifecycleEventListener {
+
+    init {
+        reactApplicationContext.addLifecycleEventListener(this)
+    }
+
+    private val interstitials = ConcurrentHashMap<String, CloudXInterstitialAd>()
+    private val rewardedAds = ConcurrentHashMap<String, CloudXRewardedAd>()
+    private val adViews = ConcurrentHashMap<String, SdkAdView>()
+    private val adViewAdFormats = ConcurrentHashMap<String, CloudXAdFormat>()
+    private val adViewPositions = ConcurrentHashMap<String, String>()
+    private val adViewOffsetsDp = ConcurrentHashMap<String, Pair<Float, Float>>()
+    private val adUnitIdsToShowAfterCreate = ConcurrentHashMap.newKeySet<String>()
+    // Workaround for React Native bug where getCurrentActivity() returns null:
+    // https://github.com/facebook/react-native/issues/18345
+    private var currentActivity: Activity? = null
+    private var windowManager: android.view.WindowManager? = null
+    private var lastRotation: Int = -1
+
+    private val DEFAULT_AD_VIEW_OFFSET_DP = Pair(0f, 0f)
+
+    companion object {
+        private const val TAG = "CloudX"
+        const val MODULE_NAME = "CloudX"
+    }
+
+    // =========================================================================
+    // Activity Helper
+    // =========================================================================
+
+    private fun maybeGetCurrentActivity(): Activity? {
+        if (reactApplicationContext.hasCurrentActivity()) {
+            currentActivity = reactApplicationContext.currentActivity
+        }
+        return currentActivity
+    }
+
+    // =========================================================================
+    // Initialization
+    // =========================================================================
+
+    fun isInitialized(promise: Promise) {
+        promise.resolve(CloudX.isInitialized())
+    }
+
+    fun initialize(pluginVersion: String, appKey: String, promise: Promise) {
+        val config = CloudXInitializationConfiguration.builder(appKey)
+            .setPluginVersion(pluginVersion)
+            .build()
+
+        CloudX.initialize(config, object : CloudXInitializationListener {
+            override fun onInitialized(configuration: CloudXSdkConfiguration) {
+                setupOrientationListener()
+                val result = Arguments.createMap()
+                result.putBoolean("success", true)
+                result.putString("message", "SDK initialized successfully")
+                promise.resolve(result)
+            }
+
+            override fun onInitializationFailed(cloudXError: CloudXError) {
+                Log.e(TAG, "CloudX SDK initialization failed: ${cloudXError.message}")
+                promise.reject(cloudXError.code.name, cloudXError.message, null)
+            }
+        })
+    }
+
+    fun isTablet(promise: Promise) {
+        val isTablet = reactApplicationContext.resources.configuration.smallestScreenWidthDp >= 600
+        promise.resolve(isTablet)
+    }
+
+    fun getVersion(promise: Promise) {
+        promise.resolve(CloudX.getVersion())
+    }
+
+    // =========================================================================
+    // Configuration
+    // =========================================================================
+
+    fun setMinLogLevel(level: String) {
+        val logLevel = when (level.lowercase()) {
+            "verbose" -> CloudXLogLevel.VERBOSE
+            "debug" -> CloudXLogLevel.DEBUG
+            "info" -> CloudXLogLevel.INFO
+            "warn" -> CloudXLogLevel.WARN
+            "error" -> CloudXLogLevel.ERROR
+            "none" -> CloudXLogLevel.NONE
+            else -> CloudXLogLevel.INFO
+        }
+        CloudX.setMinLogLevel(logLevel)
+    }
+
+    fun setVisualDebuggingEnabled(enabled: Boolean) {
+        // Visual debugging is iOS-only; no-op on Android
+    }
+
+    // =========================================================================
+    // User Targeting
+    // =========================================================================
+
+    fun setHashedUserID(hashedUserID: String) {
+        CloudX.setHashedUserId(hashedUserID)
+    }
+
+    fun setUserKeyValue(key: String, value: String) {
+        CloudX.setUserKeyValue(key, value)
+    }
+
+    fun setAppKeyValue(key: String, value: String) {
+        CloudX.setAppKeyValue(key, value)
+    }
+
+    fun clearAllKeyValues() {
+        CloudX.clearAllKeyValues()
+    }
+
+    // =========================================================================
+    // Banner (Programmatic)
+    // =========================================================================
+
+    fun createBanner(adUnitId: String, position: String) = createAdView(adUnitId, CloudXAdFormat.BANNER, position, 0.0, 0.0)
+    fun createBannerWithOffsets(adUnitId: String, position: String, xOffset: Double, yOffset: Double) = createAdView(adUnitId, CloudXAdFormat.BANNER, position, xOffset, yOffset)
+    fun setBannerBackgroundColor(adUnitId: String, hexColorString: String) = setAdViewBackgroundColor(adUnitId, CloudXAdFormat.BANNER, hexColorString)
+    fun setBannerPlacement(adUnitId: String, placement: String?) = setAdViewPlacement(adUnitId, CloudXAdFormat.BANNER, placement)
+    fun setBannerCustomData(adUnitId: String, customData: String?) = setAdViewCustomData(adUnitId, CloudXAdFormat.BANNER, customData)
+    fun updateBannerPosition(adUnitId: String, position: String) = updateAdViewPosition(adUnitId, CloudXAdFormat.BANNER, position, adViewOffsetsDp[adUnitId] ?: DEFAULT_AD_VIEW_OFFSET_DP)
+    fun updateBannerOffsets(adUnitId: String, xOffset: Double, yOffset: Double) = updateAdViewPosition(adUnitId, CloudXAdFormat.BANNER, adViewPositions[adUnitId], Pair(xOffset.toFloat(), yOffset.toFloat()))
+    fun startBannerAutoRefresh(adUnitId: String) = startAdViewAutoRefresh(adUnitId, CloudXAdFormat.BANNER)
+    fun stopBannerAutoRefresh(adUnitId: String) = stopAdViewAutoRefresh(adUnitId, CloudXAdFormat.BANNER)
+    fun showBanner(adUnitId: String) = showAdView(adUnitId, CloudXAdFormat.BANNER)
+    fun hideBanner(adUnitId: String) = hideAdView(adUnitId, CloudXAdFormat.BANNER)
+    fun destroyBanner(adUnitId: String) = destroyAdView(adUnitId, CloudXAdFormat.BANNER)
+
+    // =========================================================================
+    // MREC (Programmatic)
+    // =========================================================================
+
+    fun createMREC(adUnitId: String, position: String) = createAdView(adUnitId, CloudXAdFormat.MREC, position, 0.0, 0.0)
+    fun createMRECWithOffsets(adUnitId: String, position: String, xOffset: Double, yOffset: Double) = createAdView(adUnitId, CloudXAdFormat.MREC, position, xOffset, yOffset)
+    fun setMRECBackgroundColor(adUnitId: String, hexColorString: String) = setAdViewBackgroundColor(adUnitId, CloudXAdFormat.MREC, hexColorString)
+    fun setMRECPlacement(adUnitId: String, placement: String?) = setAdViewPlacement(adUnitId, CloudXAdFormat.MREC, placement)
+    fun setMRECCustomData(adUnitId: String, customData: String?) = setAdViewCustomData(adUnitId, CloudXAdFormat.MREC, customData)
+    fun updateMRECPosition(adUnitId: String, position: String) = updateAdViewPosition(adUnitId, CloudXAdFormat.MREC, position, adViewOffsetsDp[adUnitId] ?: DEFAULT_AD_VIEW_OFFSET_DP)
+    fun updateMRECOffsets(adUnitId: String, xOffset: Double, yOffset: Double) = updateAdViewPosition(adUnitId, CloudXAdFormat.MREC, adViewPositions[adUnitId], Pair(xOffset.toFloat(), yOffset.toFloat()))
+    fun startMRECAutoRefresh(adUnitId: String) = startAdViewAutoRefresh(adUnitId, CloudXAdFormat.MREC)
+    fun stopMRECAutoRefresh(adUnitId: String) = stopAdViewAutoRefresh(adUnitId, CloudXAdFormat.MREC)
+    fun showMREC(adUnitId: String) = showAdView(adUnitId, CloudXAdFormat.MREC)
+    fun hideMREC(adUnitId: String) = hideAdView(adUnitId, CloudXAdFormat.MREC)
+    fun destroyMREC(adUnitId: String) = destroyAdView(adUnitId, CloudXAdFormat.MREC)
+
+    // =========================================================================
+    // Interstitial
+    // =========================================================================
+
+    fun loadInterstitial(adUnitId: String) {
+        retrieveInterstitial(adUnitId).load()
+    }
+
+    fun isInterstitialReady(adUnitId: String, promise: Promise) {
+        promise.resolve(retrieveInterstitial(adUnitId).isAdReady)
+    }
+
+    fun showInterstitial(adUnitId: String, placement: String?, customData: String?) {
+        val interstitial = retrieveInterstitial(adUnitId)
+        val activity = maybeGetCurrentActivity()
+        if (activity == null) {
+            Log.e(TAG, "showInterstitial: no activity available")
+            return
+        }
+        interstitial.show(activity, placement, customData)
+    }
+
+    fun destroyInterstitial(adUnitId: String) {
+        interstitials.remove(adUnitId)?.let {
+            it.listener = null
+            it.revenueListener = null
+            it.destroy()
+        }
+    }
+
+    // =========================================================================
+    // Rewarded
+    // =========================================================================
+
+    fun loadRewarded(adUnitId: String) {
+        retrieveRewarded(adUnitId).load()
+    }
+
+    fun isRewardedReady(adUnitId: String, promise: Promise) {
+        promise.resolve(retrieveRewarded(adUnitId).isAdReady)
+    }
+
+    fun showRewarded(adUnitId: String, placement: String?, customData: String?) {
+        val rewarded = retrieveRewarded(adUnitId)
+        val activity = maybeGetCurrentActivity()
+        if (activity == null) {
+            Log.e(TAG, "showRewarded: no activity available")
+            return
+        }
+        rewarded.show(activity, placement, customData)
+    }
+
+    fun destroyRewarded(adUnitId: String) {
+        rewardedAds.remove(adUnitId)?.let {
+            it.listener = null
+            it.revenueListener = null
+            it.destroy()
+        }
+    }
+
+    // =========================================================================
+    // Listener Factories
+    // =========================================================================
+
+    private fun createAdViewListener(adUnitId: String, adFormat: CloudXAdFormat): CloudXAdViewListener {
+        val isMrec = adFormat == CloudXAdFormat.MREC
+        val loadedEvent = if (isMrec) CloudXAdEvents.ON_MREC_AD_LOADED_EVENT else CloudXAdEvents.ON_BANNER_AD_LOADED_EVENT
+        val loadFailedEvent = if (isMrec) CloudXAdEvents.ON_MREC_AD_LOAD_FAILED_EVENT else CloudXAdEvents.ON_BANNER_AD_LOAD_FAILED_EVENT
+        val clickedEvent = if (isMrec) CloudXAdEvents.ON_MREC_AD_CLICKED_EVENT else CloudXAdEvents.ON_BANNER_AD_CLICKED_EVENT
+        val expandedEvent = if (isMrec) CloudXAdEvents.ON_MREC_AD_EXPANDED_EVENT else CloudXAdEvents.ON_BANNER_AD_EXPANDED_EVENT
+        val collapsedEvent = if (isMrec) CloudXAdEvents.ON_MREC_AD_COLLAPSED_EVENT else CloudXAdEvents.ON_BANNER_AD_COLLAPSED_EVENT
+
+        return object : CloudXAdViewListener {
+            override fun onAdLoaded(cloudXAd: CloudXAd) {
+                positionAdView(adUnitId, adFormat)
+
+                val adView = retrieveAdView(adUnitId, adFormat)
+                if (adView != null && adView.visibility != View.VISIBLE) {
+                    adView.stopAutoRefresh()
+                }
+
+                sendReactNativeEvent(loadedEvent, getAdInfo(cloudXAd))
+            }
+            override fun onAdLoadFailed(failedAdUnitId: String, cloudXError: CloudXError) {
+                sendReactNativeEvent(loadFailedEvent, getAdLoadFailedInfo(failedAdUnitId, cloudXError))
+            }
+            override fun onAdClicked(cloudXAd: CloudXAd) {
+                sendReactNativeEvent(clickedEvent, getAdInfo(cloudXAd))
+            }
+            override fun onAdExpanded(cloudXAd: CloudXAd) {
+                sendReactNativeEvent(expandedEvent, getAdInfo(cloudXAd))
+            }
+            override fun onAdCollapsed(cloudXAd: CloudXAd) {
+                sendReactNativeEvent(collapsedEvent, getAdInfo(cloudXAd))
+            }
+        }
+    }
+
+    private fun createAdViewRevenueListener(adUnitId: String, adFormat: CloudXAdFormat): CloudXAdRevenueListener {
+        val revenueEvent = if (adFormat == CloudXAdFormat.MREC) CloudXAdEvents.ON_MREC_AD_REVENUE_PAID else CloudXAdEvents.ON_BANNER_AD_REVENUE_PAID
+        return object : CloudXAdRevenueListener {
+            override fun onAdRevenuePaid(cloudXAd: CloudXAd) {
+                sendReactNativeEvent(revenueEvent, getAdInfo(cloudXAd))
+            }
+        }
+    }
+
+    private fun createInterstitialListener(adUnitId: String): CloudXInterstitialListener {
+        return object : CloudXInterstitialListener {
+            override fun onAdLoaded(cloudXAd: CloudXAd) {
+                sendReactNativeEvent(CloudXAdEvents.ON_INTERSTITIAL_LOADED_EVENT, getAdInfo(cloudXAd))
+            }
+            override fun onAdLoadFailed(failedAdUnitId: String, cloudXError: CloudXError) {
+                sendReactNativeEvent(CloudXAdEvents.ON_INTERSTITIAL_LOAD_FAILED_EVENT, getAdLoadFailedInfo(failedAdUnitId, cloudXError))
+            }
+            override fun onAdClicked(cloudXAd: CloudXAd) {
+                sendReactNativeEvent(CloudXAdEvents.ON_INTERSTITIAL_CLICKED_EVENT, getAdInfo(cloudXAd))
+            }
+            override fun onAdDisplayed(cloudXAd: CloudXAd) {
+                sendReactNativeEvent(CloudXAdEvents.ON_INTERSTITIAL_DISPLAYED_EVENT, getAdInfo(cloudXAd))
+            }
+            override fun onAdDisplayFailed(cloudXAd: CloudXAd, cloudXError: CloudXError) {
+                sendReactNativeEvent(CloudXAdEvents.ON_INTERSTITIAL_DISPLAY_FAILED_EVENT, getAdDisplayFailedInfo(cloudXAd, cloudXError))
+            }
+            override fun onAdHidden(cloudXAd: CloudXAd) {
+                sendReactNativeEvent(CloudXAdEvents.ON_INTERSTITIAL_HIDDEN_EVENT, getAdInfo(cloudXAd))
+            }
+        }
+    }
+
+    private fun createRewardedListener(adUnitId: String): CloudXRewardedListener {
+        return object : CloudXRewardedListener {
+            override fun onAdLoaded(cloudXAd: CloudXAd) {
+                sendReactNativeEvent(CloudXAdEvents.ON_REWARDED_AD_LOADED_EVENT, getAdInfo(cloudXAd))
+            }
+            override fun onAdLoadFailed(failedAdUnitId: String, cloudXError: CloudXError) {
+                sendReactNativeEvent(CloudXAdEvents.ON_REWARDED_AD_LOAD_FAILED_EVENT, getAdLoadFailedInfo(failedAdUnitId, cloudXError))
+            }
+            override fun onAdClicked(cloudXAd: CloudXAd) {
+                sendReactNativeEvent(CloudXAdEvents.ON_REWARDED_AD_CLICKED_EVENT, getAdInfo(cloudXAd))
+            }
+            override fun onAdDisplayed(cloudXAd: CloudXAd) {
+                sendReactNativeEvent(CloudXAdEvents.ON_REWARDED_AD_DISPLAYED_EVENT, getAdInfo(cloudXAd))
+            }
+            override fun onAdDisplayFailed(cloudXAd: CloudXAd, cloudXError: CloudXError) {
+                sendReactNativeEvent(CloudXAdEvents.ON_REWARDED_AD_DISPLAY_FAILED_EVENT, getAdDisplayFailedInfo(cloudXAd, cloudXError))
+            }
+            override fun onAdHidden(cloudXAd: CloudXAd) {
+                sendReactNativeEvent(CloudXAdEvents.ON_REWARDED_AD_HIDDEN_EVENT, getAdInfo(cloudXAd))
+            }
+            override fun onUserRewarded(cloudXAd: CloudXAd, reward: CloudXReward) {
+                val data = getAdInfo(cloudXAd)
+                data.putString("rewardLabel", reward.label)
+                data.putInt("rewardAmount", reward.amount)
+                sendReactNativeEvent(CloudXAdEvents.ON_REWARDED_AD_RECEIVED_REWARD_EVENT, data)
+            }
+        }
+    }
+
+    private fun createFullscreenRevenueListener(adUnitId: String, eventName: String): CloudXAdRevenueListener {
+        return object : CloudXAdRevenueListener {
+            override fun onAdRevenuePaid(cloudXAd: CloudXAd) {
+                sendReactNativeEvent(eventName, getAdInfo(cloudXAd))
+            }
+        }
+    }
+
+    // =========================================================================
+    // Ad View Helpers (shared by Banner and MREC)
+    // =========================================================================
+
+    private fun createAdView(adUnitId: String, adFormat: CloudXAdFormat, position: String, xOffset: Double, yOffset: Double) {
+        // Run on main thread to ensure there are no concurrency issues with other ad view methods
+        reactApplicationContext.runOnUiQueueThread {
+            val adView = retrieveAdView(adUnitId, adFormat, position, Pair(xOffset.toFloat(), yOffset.toFloat()))
+                ?: return@runOnUiQueueThread
+
+            adView.visibility = View.GONE
+
+            if (adView.parent == null) {
+                maybeAttachToCurrentActivity(adView)
+                adViewAdFormats[adUnitId] = adFormat
+                positionAdView(adUnitId, adFormat)
+            }
+
+            adView.load()
+
+            // The publisher may have requested to show the ad view before it was created.
+            if (adUnitIdsToShowAfterCreate.contains(adUnitId)) {
+                showAdView(adUnitId, adFormat)
+                adUnitIdsToShowAfterCreate.remove(adUnitId)
+            }
+        }
+    }
+
+    private fun setAdViewPlacement(adUnitId: String, adFormat: CloudXAdFormat, placement: String?) {
+        reactApplicationContext.runOnUiQueueThread {
+            val adView = retrieveAdView(adUnitId, adFormat, "", DEFAULT_AD_VIEW_OFFSET_DP) ?: return@runOnUiQueueThread
+            adView.setPlacement(placement)
+        }
+    }
+
+    private fun setAdViewCustomData(adUnitId: String, adFormat: CloudXAdFormat, customData: String?) {
+        reactApplicationContext.runOnUiQueueThread {
+            val adView = retrieveAdView(adUnitId, adFormat, "", DEFAULT_AD_VIEW_OFFSET_DP) ?: return@runOnUiQueueThread
+            adView.setCustomData(customData)
+        }
+    }
+
+    private fun updateAdViewPosition(adUnitId: String, adFormat: CloudXAdFormat, position: String?, offsetsDp: Pair<Float, Float>) {
+        reactApplicationContext.runOnUiQueueThread {
+            val adView = retrieveAdView(adUnitId, adFormat) ?: return@runOnUiQueueThread
+            adViewPositions[adUnitId] = position ?: return@runOnUiQueueThread
+            adViewOffsetsDp[adUnitId] = offsetsDp
+            positionAdView(adUnitId, adFormat)
+        }
+    }
+
+    private fun showAdView(adUnitId: String, adFormat: CloudXAdFormat) {
+        reactApplicationContext.runOnUiQueueThread {
+            val adView = retrieveAdView(adUnitId, adFormat)
+            if (adView == null) {
+                adUnitIdsToShowAfterCreate.add(adUnitId)
+                return@runOnUiQueueThread
+            }
+
+            maybeAttachToCurrentActivity(adView)
+            adView.visibility = View.VISIBLE
+            adView.startAutoRefresh()
+        }
+    }
+
+    private fun hideAdView(adUnitId: String, adFormat: CloudXAdFormat) {
+        reactApplicationContext.runOnUiQueueThread {
+            adUnitIdsToShowAfterCreate.remove(adUnitId)
+            val adView = retrieveAdView(adUnitId, adFormat) ?: return@runOnUiQueueThread
+            adView.visibility = View.GONE
+            adView.stopAutoRefresh()
+        }
+    }
+
+    private fun destroyAdView(adUnitId: String, adFormat: CloudXAdFormat) {
+        reactApplicationContext.runOnUiQueueThread {
+            val adView = retrieveAdView(adUnitId, adFormat)
+            if (adView == null) return@runOnUiQueueThread
+
+            val parent = adView.parent
+            if (parent is ViewGroup) {
+                parent.removeView(adView)
+            }
+
+            adView.listener = null
+            adView.revenueListener = null
+            adView.destroy()
+
+            adViews.remove(adUnitId)
+            adViewAdFormats.remove(adUnitId)
+            adViewPositions.remove(adUnitId)
+            adViewOffsetsDp.remove(adUnitId)
+            adUnitIdsToShowAfterCreate.remove(adUnitId)
+        }
+    }
+
+    private fun setAdViewBackgroundColor(adUnitId: String, adFormat: CloudXAdFormat, hexColorString: String) {
+        reactApplicationContext.runOnUiQueueThread {
+            val adView = retrieveAdView(adUnitId, adFormat) ?: return@runOnUiQueueThread
+            try {
+                adView.setBackgroundColor(Color.parseColor(hexColorString))
+            } catch (e: IllegalArgumentException) {
+                Log.e(TAG, "setAdViewBackgroundColor: invalid color string \"$hexColorString\"", e)
+            }
+        }
+    }
+
+    private fun startAdViewAutoRefresh(adUnitId: String, adFormat: CloudXAdFormat) {
+        reactApplicationContext.runOnUiQueueThread { retrieveAdView(adUnitId, adFormat)?.startAutoRefresh() }
+    }
+
+    private fun stopAdViewAutoRefresh(adUnitId: String, adFormat: CloudXAdFormat) {
+        reactApplicationContext.runOnUiQueueThread { retrieveAdView(adUnitId, adFormat)?.stopAutoRefresh() }
+    }
+
+    // =========================================================================
+    // Ad View Positioning
+    // =========================================================================
+
+    private fun maybeAttachToCurrentActivity(adView: SdkAdView) {
+        if (adView.parent != null) return
+
+        val activity = maybeGetCurrentActivity()
+        if (activity == null) {
+            Log.e(TAG, "maybeAttachToCurrentActivity: no activity available")
+            return
+        }
+
+        val relativeLayout = RelativeLayout(reactApplicationContext)
+        relativeLayout.addView(adView)
+
+        activity.addContentView(
+            relativeLayout,
+            LinearLayout.LayoutParams(
+                LinearLayout.LayoutParams.MATCH_PARENT,
+                LinearLayout.LayoutParams.MATCH_PARENT
+            )
+        )
+    }
+
+    private fun retrieveInterstitial(adUnitId: String): CloudXInterstitialAd {
+        var interstitial = interstitials[adUnitId]
+        if (interstitial == null) {
+            interstitial = CloudX.createInterstitial(adUnitId)
+            interstitial.listener = createInterstitialListener(adUnitId)
+            interstitial.revenueListener = createFullscreenRevenueListener(adUnitId, CloudXAdEvents.ON_INTERSTITIAL_AD_REVENUE_PAID)
+            interstitials[adUnitId] = interstitial
+        }
+        return interstitial
+    }
+
+    private fun retrieveRewarded(adUnitId: String): CloudXRewardedAd {
+        var rewarded = rewardedAds[adUnitId]
+        if (rewarded == null) {
+            rewarded = CloudX.createRewarded(adUnitId)
+            rewarded.listener = createRewardedListener(adUnitId)
+            rewarded.revenueListener = createFullscreenRevenueListener(adUnitId, CloudXAdEvents.ON_REWARDED_AD_REVENUE_PAID)
+            rewardedAds[adUnitId] = rewarded
+        }
+        return rewarded
+    }
+
+    private fun retrieveAdView(adUnitId: String, adFormat: CloudXAdFormat): SdkAdView? {
+        return retrieveAdView(adUnitId, adFormat, null, DEFAULT_AD_VIEW_OFFSET_DP)
+    }
+
+    private fun retrieveAdView(adUnitId: String, adFormat: CloudXAdFormat, position: String?, offsetsDp: Pair<Float, Float>): SdkAdView? {
+        var adView = adViews[adUnitId]
+        if (adView == null && position != null) {
+            adView = if (adFormat == CloudXAdFormat.MREC) CloudX.createMREC(adUnitId) else CloudX.createBanner(adUnitId)
+            adView.listener = createAdViewListener(adUnitId, adFormat)
+            adView.revenueListener = createAdViewRevenueListener(adUnitId, adFormat)
+            adViews[adUnitId] = adView
+            adViewPositions[adUnitId] = position
+            adViewOffsetsDp[adUnitId] = offsetsDp
+        }
+        return adView
+    }
+
+    private fun positionAdView(adUnitId: String, adFormat: CloudXAdFormat) {
+        val adView = retrieveAdView(adUnitId, adFormat) ?: return
+        val relativeLayout = adView.parent as? RelativeLayout
+        if (relativeLayout == null) {
+            Log.e(TAG, "positionAdView: ad view has no parent layout")
+            return
+        }
+
+        val density = reactApplicationContext.resources.displayMetrics.density
+        val params = adView.layoutParams as RelativeLayout.LayoutParams
+
+        // Reset stale state before repositioning
+        adView.rotation = 0f
+        adView.translationX = 0f
+        adView.translationY = 0f
+        params.setMargins(0, 0, 0, 0)
+
+        val isMREC = adFormat == CloudXAdFormat.MREC
+        val isTablet = reactApplicationContext.resources.configuration.smallestScreenWidthDp >= 600
+        params.width = ((if (isMREC) 300 else if (isTablet) 728 else 320) * density).toInt()
+        params.height = ((if (isMREC) 250 else if (isTablet) 90 else 50) * density).toInt()
+        adView.layoutParams = params
+
+        val position = (adViewPositions[adUnitId] ?: "BOTTOM_CENTER").uppercase()
+        val offsetsDp = adViewOffsetsDp[adUnitId] ?: Pair(0f, 0f)
+        val offsetXPx = (offsetsDp.first * density).toInt()
+        val offsetYPx = (offsetsDp.second * density).toInt()
+
+        val gravity = when (position) {
+            "TOP_LEFT" -> Gravity.TOP or Gravity.START
+            "TOP_CENTER" -> Gravity.TOP or Gravity.CENTER_HORIZONTAL
+            "TOP_RIGHT" -> Gravity.TOP or Gravity.END
+            "CENTER_LEFT" -> Gravity.CENTER_VERTICAL or Gravity.START
+            "CENTERED" -> Gravity.CENTER
+            "CENTER_RIGHT" -> Gravity.CENTER_VERTICAL or Gravity.END
+            "BOTTOM_LEFT" -> Gravity.BOTTOM or Gravity.START
+            "BOTTOM_CENTER" -> Gravity.BOTTOM or Gravity.CENTER_HORIZONTAL
+            "BOTTOM_RIGHT" -> Gravity.BOTTOM or Gravity.END
+            else -> Gravity.BOTTOM or Gravity.CENTER_HORIZONTAL
+        }
+
+        relativeLayout.gravity = gravity
+        relativeLayout.setPadding(0, 0, 0, 0)
+
+        // Apply offsets directionally based on which edges are active for the position.
+        // For edge-anchored axes, use margins (which push the view inward from the edge).
+        // For center-anchored axes, margins don't shift centered children, so use translation.
+        val isLeft             = position.endsWith("LEFT")
+        val isRight            = position.endsWith("RIGHT")
+        val isTop              = position.startsWith("TOP")
+        val isBottom           = position.startsWith("BOTTOM")
+        val isCenterHorizontal = !isLeft && !isRight   // TOP_CENTER, BOTTOM_CENTER, CENTERED
+        val isCenterVertical   = !isTop && !isBottom   // CENTER_LEFT, CENTER_RIGHT, CENTERED
+
+        params.marginStart  = if (isLeft)   offsetXPx else 0
+        params.marginEnd    = if (isRight)  offsetXPx else 0
+        params.topMargin    = if (isTop)    offsetYPx else 0
+        params.bottomMargin = if (isBottom) offsetYPx else 0
+        adView.layoutParams = params
+
+        adView.translationX = if (isCenterHorizontal) offsetXPx.toFloat() else 0f
+        adView.translationY = if (isCenterVertical)   offsetYPx.toFloat() else 0f
+    }
+
+    // =========================================================================
+    // Orientation Change Handler
+    // =========================================================================
+
+    private fun setupOrientationListener() {
+        if (windowManager != null) return
+
+        windowManager = reactApplicationContext.getSystemService(android.content.Context.WINDOW_SERVICE) as android.view.WindowManager
+
+        @Suppress("DEPRECATION")
+        lastRotation = windowManager!!.defaultDisplay.rotation
+
+        object : OrientationEventListener(reactApplicationContext) {
+            override fun onOrientationChanged(orientation: Int) {
+                @Suppress("DEPRECATION")
+                val newRotation = windowManager?.defaultDisplay?.rotation ?: return
+                if (newRotation != lastRotation) {
+                    lastRotation = newRotation
+                    for ((adUnitId, adFormat) in adViewAdFormats) {
+                        positionAdView(adUnitId, adFormat)
+                    }
+                }
+            }
+        }.enable()
+    }
+
+    // =========================================================================
+    // Ad Info
+    // =========================================================================
+
+    // =========================================================================
+    // Lifecycle
+    // =========================================================================
+
+    override fun onHostResume() {}
+    override fun onHostPause() {}
+
+    override fun onHostDestroy() {
+        // Make copy because destroyAdView() removes from adViews
+        val adViewsCopy = HashMap(adViewAdFormats)
+        for ((adUnitId, adFormat) in adViewsCopy) {
+            destroyAdView(adUnitId, adFormat)
+        }
+
+        for (interstitial in interstitials.values) {
+            interstitial.destroy()
+        }
+        interstitials.clear()
+
+        for (rewarded in rewardedAds.values) {
+            rewarded.destroy()
+        }
+        rewardedAds.clear()
+    }
+
+    // =========================================================================
+    // React Native Bridge
+    // =========================================================================
+
+    private fun sendReactNativeEvent(name: String, params: WritableMap) {
+        reactApplicationContext
+            .getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter::class.java)
+            .emit(name, params)
+    }
+
+    // =========================================================================
+    // Constants
+    // =========================================================================
+
+    fun getConstants(): MutableMap<String, Any> = mutableMapOf(
+        "ON_BANNER_AD_LOADED_EVENT" to CloudXAdEvents.ON_BANNER_AD_LOADED_EVENT,
+        "ON_BANNER_AD_LOAD_FAILED_EVENT" to CloudXAdEvents.ON_BANNER_AD_LOAD_FAILED_EVENT,
+        "ON_BANNER_AD_CLICKED_EVENT" to CloudXAdEvents.ON_BANNER_AD_CLICKED_EVENT,
+        "ON_BANNER_AD_EXPANDED_EVENT" to CloudXAdEvents.ON_BANNER_AD_EXPANDED_EVENT,
+        "ON_BANNER_AD_COLLAPSED_EVENT" to CloudXAdEvents.ON_BANNER_AD_COLLAPSED_EVENT,
+        "ON_BANNER_AD_REVENUE_PAID" to CloudXAdEvents.ON_BANNER_AD_REVENUE_PAID,
+        "ON_MREC_AD_LOADED_EVENT" to CloudXAdEvents.ON_MREC_AD_LOADED_EVENT,
+        "ON_MREC_AD_LOAD_FAILED_EVENT" to CloudXAdEvents.ON_MREC_AD_LOAD_FAILED_EVENT,
+        "ON_MREC_AD_CLICKED_EVENT" to CloudXAdEvents.ON_MREC_AD_CLICKED_EVENT,
+        "ON_MREC_AD_EXPANDED_EVENT" to CloudXAdEvents.ON_MREC_AD_EXPANDED_EVENT,
+        "ON_MREC_AD_COLLAPSED_EVENT" to CloudXAdEvents.ON_MREC_AD_COLLAPSED_EVENT,
+        "ON_MREC_AD_REVENUE_PAID" to CloudXAdEvents.ON_MREC_AD_REVENUE_PAID,
+        "ON_INTERSTITIAL_LOADED_EVENT" to CloudXAdEvents.ON_INTERSTITIAL_LOADED_EVENT,
+        "ON_INTERSTITIAL_LOAD_FAILED_EVENT" to CloudXAdEvents.ON_INTERSTITIAL_LOAD_FAILED_EVENT,
+        "ON_INTERSTITIAL_CLICKED_EVENT" to CloudXAdEvents.ON_INTERSTITIAL_CLICKED_EVENT,
+        "ON_INTERSTITIAL_DISPLAYED_EVENT" to CloudXAdEvents.ON_INTERSTITIAL_DISPLAYED_EVENT,
+        "ON_INTERSTITIAL_DISPLAY_FAILED_EVENT" to CloudXAdEvents.ON_INTERSTITIAL_DISPLAY_FAILED_EVENT,
+        "ON_INTERSTITIAL_HIDDEN_EVENT" to CloudXAdEvents.ON_INTERSTITIAL_HIDDEN_EVENT,
+        "ON_INTERSTITIAL_AD_REVENUE_PAID" to CloudXAdEvents.ON_INTERSTITIAL_AD_REVENUE_PAID,
+        "ON_REWARDED_AD_LOADED_EVENT" to CloudXAdEvents.ON_REWARDED_AD_LOADED_EVENT,
+        "ON_REWARDED_AD_LOAD_FAILED_EVENT" to CloudXAdEvents.ON_REWARDED_AD_LOAD_FAILED_EVENT,
+        "ON_REWARDED_AD_CLICKED_EVENT" to CloudXAdEvents.ON_REWARDED_AD_CLICKED_EVENT,
+        "ON_REWARDED_AD_DISPLAYED_EVENT" to CloudXAdEvents.ON_REWARDED_AD_DISPLAYED_EVENT,
+        "ON_REWARDED_AD_DISPLAY_FAILED_EVENT" to CloudXAdEvents.ON_REWARDED_AD_DISPLAY_FAILED_EVENT,
+        "ON_REWARDED_AD_HIDDEN_EVENT" to CloudXAdEvents.ON_REWARDED_AD_HIDDEN_EVENT,
+        "ON_REWARDED_AD_RECEIVED_REWARD_EVENT" to CloudXAdEvents.ON_REWARDED_AD_RECEIVED_REWARD_EVENT,
+        "ON_REWARDED_AD_REVENUE_PAID" to CloudXAdEvents.ON_REWARDED_AD_REVENUE_PAID,
+    )
+}