novvy-ads-react-native 1.0.0-beta.1

package/android/src/main/java/ai/novvy/reactnative/NovvyAdsModule.kt

@@ -0,0 +1,390 @@
+package ai.novvy.reactnative
+
+import android.app.Activity
+import android.view.ViewGroup
+import ai.novvy.android.sdk.*
+import com.facebook.react.bridge.Arguments
+import com.facebook.react.bridge.Promise
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.ReadableArray
+import com.facebook.react.bridge.ReadableMap
+import com.facebook.react.bridge.UiThreadUtil
+import com.facebook.react.bridge.WritableMap
+import java.util.concurrent.ConcurrentHashMap
+
+/**
+ * TurboModule bridging the Novvy Android ad SDK to React Native.
+ *
+ * Mirrors the Flutter plugin's `NovvyAdsApiImpl.kt` one-to-one:
+ * - SDK init + user/content context
+ * - Interstitial / Rewarded / Mid / End full-screen ads (load → show)
+ * - Scroll (inline feed) ads (load → attach → setPlaying → detach)
+ * - Pause (realtime pause card) ads (attach → detach, no load)
+ *
+ * A single `onAdEvent` emitter multiplexes every ad's lifecycle events to JS;
+ * each JS ad object filters by its own `adObjectId`.
+ */
+class NovvyAdsModule(reactContext: ReactApplicationContext) :
+  NativeNovvyAdsSpec(reactContext) {
+
+  private val appContext = reactContext.applicationContext
+  // Accessed from both the native-modules thread (load*) and the main thread
+  // (attach/show/dispose, marshaled via runOnMain) — must be concurrency-safe.
+  private val adMap = ConcurrentHashMap<String, Any>()
+  private val scrollContainerMap = ConcurrentHashMap<String, ViewGroup>()
+  private val pauseContainerMap = ConcurrentHashMap<String, ViewGroup>()
+  private val pauseAdapterMap = ConcurrentHashMap<String, RnPlayerAdapter>()
+
+  init {
+    instance = this
+  }
+
+  override fun invalidate() {
+    super.invalidate()
+    if (instance === this) {
+      instance = null
+    }
+  }
+
+  // ── Event emission ──────────────────────────────────────────────────────
+
+  private fun runOnMain(block: () -> Unit) {
+    if (UiThreadUtil.isOnUiThread()) block() else UiThreadUtil.runOnUiThread(block)
+  }
+
+  private fun emit(
+    adObjectId: String,
+    adUnitId: String,
+    event: String,
+    error: String? = null,
+    remainingSeconds: Int? = null,
+  ) {
+    val map: WritableMap = Arguments.createMap().apply {
+      putString("adObjectId", adObjectId)
+      putString("adUnitId", adUnitId)
+      putString("event", event)
+      if (error != null) putString("error", error)
+      if (remainingSeconds != null) putInt("remainingSeconds", remainingSeconds)
+    }
+    runOnMain { emitOnAdEvent(map) }
+  }
+
+  private fun errorText(error: NovvyError): String = when (error) {
+    is NovvyError.InternalError -> "InternalError: ${error.details}"
+    else -> error.message ?: error::class.simpleName ?: "UnknownError"
+  }
+
+  // ── Initialization & context ──────────────────────────────────────────────
+
+  override fun initialize(
+    appId: String,
+    endpoint: String,
+    apiKey: String,
+    userContext: ReadableMap?,
+    promise: Promise,
+  ) {
+    NovvySDK.initialize(
+      context = appContext,
+      appId = appId,
+      endpoint = endpoint,
+      apiKey = apiKey,
+      userContext = userContext?.toSdkUserContext(),
+      onComplete = { success -> runOnMain { promise.resolve(success) } },
+    )
+  }
+
+  override fun setUserContext(context: ReadableMap) {
+    NovvySDK.setUserContext(context.toSdkUserContext())
+  }
+
+  override fun updateUserContext(partial: ReadableMap) {
+    NovvySDK.updateUserContext(
+      userId = partial.optString("userId"),
+      hashedEmail = partial.optString("hashedEmail"),
+      isPaidUser = partial.optBoolean("isPaidUser"),
+      age = partial.optInt("age"),
+      gender = partial.optString("gender"),
+      dramaWatchHistory = partial.optArray("dramaWatchHistory")?.toSdkRecords(),
+      maximumAdsInOneDrama = partial.optInt("maximumAdsInOneDrama"),
+    )
+  }
+
+  override fun setContentContext(context: ReadableMap) {
+    NovvySDK.setContentContext(
+      NovvyContentContext(
+        seriesName = context.optString("seriesName"),
+        episodeNumber = context.optInt("episodeNumber"),
+        url = context.optString("url"),
+      )
+    )
+  }
+
+  override fun updateContentContext(partial: ReadableMap) {
+    NovvySDK.updateContentContext(
+      seriesName = partial.optString("seriesName"),
+      episodeNumber = partial.optInt("episodeNumber"),
+      url = partial.optString("url"),
+    )
+  }
+
+  private fun ReadableMap.toSdkUserContext(): NovvyUserContext = NovvyUserContext(
+    userId = optString("userId"),
+    hashedEmail = optString("hashedEmail"),
+    isPaidUser = optBoolean("isPaidUser"),
+    age = optInt("age"),
+    gender = optString("gender"),
+    dramaWatchHistory = optArray("dramaWatchHistory")?.toSdkRecords(),
+    maximumAdsInOneDrama = optInt("maximumAdsInOneDrama"),
+  )
+
+  private fun ReadableArray.toSdkRecords(): List<NovvyDramaRecord> {
+    val out = mutableListOf<NovvyDramaRecord>()
+    for (i in 0 until size()) {
+      val record = getMap(i) ?: continue
+      out.add(
+        NovvyDramaRecord(
+          seriesId = record.optString("seriesId") ?: "",
+          lastWatchedEpisode = record.optInt("lastWatchedEpisode") ?: 0,
+          unlockedEpisode = record.optInt("unlockedEpisode") ?: 0,
+          dramaTitle = record.optString("dramaTitle"),
+        )
+      )
+    }
+    return out
+  }
+
+  // ── Interstitial ───────────────────────────────────────────────────────────
+
+  override fun loadInterstitialAd(adUnitId: String, adObjectId: String) {
+    val ad = NovvyInterstitialAd(adUnitId)
+    adMap[adObjectId] = ad
+    ad.load(object : NovvyInterstitialAdListener {
+      override fun onAdLoaded(ad: NovvyInterstitialAd) = emit(adObjectId, adUnitId, EV_LOADED)
+      override fun onAdFailedToLoad(ad: NovvyInterstitialAd, error: NovvyError) =
+        emit(adObjectId, adUnitId, EV_FAILED, errorText(error))
+      override fun onAdShown(ad: NovvyInterstitialAd) = emit(adObjectId, adUnitId, EV_SHOWED)
+      override fun onAdClosed(ad: NovvyInterstitialAd) = emit(adObjectId, adUnitId, EV_DISMISSED)
+    })
+  }
+
+  override fun showInterstitialAd(adObjectId: String) = runOnMain {
+    val ad = adMap[adObjectId] as? NovvyInterstitialAd ?: return@runOnMain
+    val activity = requireActivity(adObjectId) ?: return@runOnMain
+    ad.show(activity)
+  }
+
+  // ── Rewarded ─────────────────────────────────────────────────────────────
+
+  override fun loadRewardedAd(adUnitId: String, adObjectId: String) {
+    val ad = NovvyRewardedAd(adUnitId)
+    adMap[adObjectId] = ad
+    ad.load(object : NovvyRewardedAdListener {
+      override fun onAdLoaded(ad: NovvyRewardedAd) = emit(adObjectId, adUnitId, EV_LOADED)
+      override fun onAdFailedToLoad(ad: NovvyRewardedAd, error: NovvyError) =
+        emit(adObjectId, adUnitId, EV_FAILED, errorText(error))
+      override fun onAdShown(ad: NovvyRewardedAd) = emit(adObjectId, adUnitId, EV_SHOWED)
+      override fun onUserEarnedReward(ad: NovvyRewardedAd) =
+        emit(adObjectId, adUnitId, EV_EARNED_REWARD)
+      override fun onAdClosed(ad: NovvyRewardedAd) = emit(adObjectId, adUnitId, EV_DISMISSED)
+    })
+  }
+
+  override fun showRewardedAd(adObjectId: String) = runOnMain {
+    val ad = adMap[adObjectId] as? NovvyRewardedAd ?: return@runOnMain
+    val activity = requireActivity(adObjectId) ?: return@runOnMain
+    ad.show(activity)
+  }
+
+  // ── Mid-roll ───────────────────────────────────────────────────────────────
+
+  override fun loadMidAd(adUnitId: String, adObjectId: String) {
+    val ad = NovvyMidAd(adUnitId)
+    adMap[adObjectId] = ad
+    ad.load(object : NovvyMidAdListener {
+      override fun onAdLoaded(ad: NovvyMidAd) = emit(adObjectId, adUnitId, EV_LOADED)
+      override fun onAdFailedToLoad(ad: NovvyMidAd, error: NovvyError) =
+        emit(adObjectId, adUnitId, EV_FAILED, errorText(error))
+      override fun onAdShown(ad: NovvyMidAd) = emit(adObjectId, adUnitId, EV_SHOWED)
+      override fun onAdClosed(ad: NovvyMidAd) = emit(adObjectId, adUnitId, EV_DISMISSED)
+    })
+  }
+
+  override fun showMidAd(adObjectId: String) = runOnMain {
+    val ad = adMap[adObjectId] as? NovvyMidAd ?: return@runOnMain
+    val activity = requireActivity(adObjectId) ?: return@runOnMain
+    ad.show(activity)
+  }
+
+  // ── End-roll ─────────────────────────────────────────────────────────────
+
+  override fun loadEndAd(adUnitId: String, adObjectId: String) {
+    val ad = NovvyEndAd(adUnitId)
+    adMap[adObjectId] = ad
+    ad.load(object : NovvyEndAdListener {
+      override fun onAdLoaded(ad: NovvyEndAd) = emit(adObjectId, adUnitId, EV_LOADED)
+      override fun onAdFailedToLoad(ad: NovvyEndAd, error: NovvyError) =
+        emit(adObjectId, adUnitId, EV_FAILED, errorText(error))
+      override fun onAdShown(ad: NovvyEndAd) = emit(adObjectId, adUnitId, EV_SHOWED)
+      override fun onAdClosed(ad: NovvyEndAd) = emit(adObjectId, adUnitId, EV_DISMISSED)
+    })
+  }
+
+  override fun showEndAd(adObjectId: String) = runOnMain {
+    val ad = adMap[adObjectId] as? NovvyEndAd ?: return@runOnMain
+    val activity = requireActivity(adObjectId) ?: return@runOnMain
+    ad.show(activity)
+  }
+
+  // ── Scroll (inline feed) ─────────────────────────────────────────────────
+
+  override fun loadScrollAd(adUnitId: String, adObjectId: String, episodeNumber: Double?) {
+    val ad = NovvyScrollAd(adUnitId = adUnitId, episode = episodeNumber?.toInt())
+    adMap[adObjectId] = ad
+    ad.load(object : NovvyScrollAdListener {
+      override fun onAdLoaded(ad: NovvyScrollAd) = emit(adObjectId, adUnitId, EV_LOADED)
+      override fun onAdFailedToLoad(ad: NovvyScrollAd, error: NovvyError) =
+        emit(adObjectId, adUnitId, EV_FAILED, errorText(error))
+      override fun onAdShown(ad: NovvyScrollAd) = emit(adObjectId, adUnitId, EV_SHOWED)
+      override fun onAdHidden(ad: NovvyScrollAd) = emit(adObjectId, adUnitId, EV_HIDDEN)
+    })
+  }
+
+  override fun attachScrollAd(
+    adObjectId: String,
+    durationSeconds: Double?,
+    useDefaultSwipeOverlay: Boolean,
+  ) = runOnMain {
+    val ad = adMap[adObjectId] as? NovvyScrollAd ?: return@runOnMain
+    val container = scrollContainerMap[adObjectId] ?: return@runOnMain
+    ad.attach(
+      container = container,
+      durationSeconds = durationSeconds?.toInt(),
+      useDefaultSwipeOverlay = useDefaultSwipeOverlay,
+      onAdPlaybackTick = { remaining -> emit(adObjectId, "", EV_PLAYBACK_TICK, remainingSeconds = remaining) },
+    )
+  }
+
+  override fun setScrollAdPlaying(adObjectId: String, playing: Boolean) = runOnMain {
+    (adMap[adObjectId] as? NovvyScrollAd)?.setPlaying(playing)
+  }
+
+  override fun detachScrollAd(adObjectId: String) = runOnMain {
+    (adMap[adObjectId] as? NovvyScrollAd)?.detach()
+    scrollContainerMap.remove(adObjectId)
+  }
+
+  // ── Pause (realtime pause card) ─────────────────────────────────────────
+
+  override fun attachPauseAd(
+    adUnitId: String,
+    adObjectId: String,
+    positionMs: Double,
+    isPlaying: Boolean,
+  ) = runOnMain {
+    val container = pauseContainerMap[adObjectId] ?: return@runOnMain
+    val adapter = RnPlayerAdapter().apply {
+      currentPositionMs = positionMs.toLong()
+      this.isPlaying = isPlaying
+    }
+    pauseAdapterMap[adObjectId] = adapter
+    val ad = NovvyPauseAd(adUnitId)
+    adMap[adObjectId] = ad
+    ad.attach(container, adapter, object : NovvyPauseAdListener {
+      override fun onAdFailedToLoad(ad: NovvyPauseAd, error: NovvyError) =
+        emit(adObjectId, adUnitId, EV_FAILED, errorText(error))
+      override fun onAdShown(ad: NovvyPauseAd) = emit(adObjectId, adUnitId, EV_SHOWED)
+      override fun onAdHidden(ad: NovvyPauseAd) = emit(adObjectId, adUnitId, EV_HIDDEN)
+    })
+  }
+
+  override fun updatePauseAdPlayerState(
+    adObjectId: String,
+    positionMs: Double,
+    isPlaying: Boolean,
+  ) {
+    val adapter = pauseAdapterMap[adObjectId] ?: return
+    adapter.currentPositionMs = positionMs.toLong()
+    adapter.isPlaying = isPlaying
+  }
+
+  override fun detachPauseAd(adObjectId: String) = runOnMain {
+    (adMap[adObjectId] as? NovvyPauseAd)?.detach()
+    pauseContainerMap.remove(adObjectId)
+    pauseAdapterMap.remove(adObjectId)
+  }
+
+  // ── Common ────────────────────────────────────────────────────────────────
+
+  override fun disposeAd(adObjectId: String) = runOnMain {
+    when (val ad = adMap[adObjectId]) {
+      is NovvyPauseAd -> {
+        ad.detach(); ad.destroy()
+        pauseContainerMap.remove(adObjectId)
+        pauseAdapterMap.remove(adObjectId)
+      }
+      is NovvyScrollAd -> {
+        ad.detach(); ad.destroy()
+        scrollContainerMap.remove(adObjectId)
+      }
+      is NovvyRewardedAd -> ad.destroy()
+      is NovvyInterstitialAd -> ad.destroy()
+      is NovvyMidAd -> ad.destroy()
+      is NovvyEndAd -> ad.destroy()
+    }
+    adMap.remove(adObjectId)
+  }
+
+  // ── Platform view helpers (called by view managers) ───────────────────────
+
+  fun registerScrollContainer(adObjectId: String, container: ViewGroup) {
+    scrollContainerMap[adObjectId] = container
+  }
+
+  fun registerPauseContainer(adObjectId: String, container: ViewGroup) {
+    pauseContainerMap[adObjectId] = container
+  }
+
+  fun onScrollViewDisposed(adObjectId: String) = detachScrollAd(adObjectId)
+  fun onPauseViewDisposed(adObjectId: String) = detachPauseAd(adObjectId)
+
+  private fun requireActivity(adObjectId: String): Activity? {
+    val activity = currentActivity
+    if (activity == null) {
+      emit(adObjectId, "", EV_FAILED, "No active Activity available")
+    }
+    return activity
+  }
+
+  companion object {
+    const val NAME = NativeNovvyAdsSpec.NAME
+
+    /** The live module instance, used by the view managers to register containers. */
+    @Volatile
+    @JvmStatic
+    var instance: NovvyAdsModule? = null
+      private set
+
+    // Event names — must match the NovvyAdEvent string union in the TS layer.
+    private const val EV_LOADED = "loaded"
+    private const val EV_FAILED = "failedToLoad"
+    private const val EV_SHOWED = "showed"
+    private const val EV_DISMISSED = "dismissed"
+    private const val EV_HIDDEN = "hidden"
+    private const val EV_EARNED_REWARD = "earnedReward"
+    private const val EV_PLAYBACK_TICK = "playbackTick"
+  }
+}
+
+// ── ReadableMap helpers ───────────────────────────────────────────────────────
+
+private fun ReadableMap.optString(key: String): String? =
+  if (hasKey(key) && !isNull(key)) getString(key) else null
+
+private fun ReadableMap.optBoolean(key: String): Boolean? =
+  if (hasKey(key) && !isNull(key)) getBoolean(key) else null
+
+private fun ReadableMap.optInt(key: String): Int? =
+  if (hasKey(key) && !isNull(key)) getDouble(key).toInt() else null
+
+private fun ReadableMap.optArray(key: String): ReadableArray? =
+  if (hasKey(key) && !isNull(key)) getArray(key) else null

package/android/src/main/java/ai/novvy/reactnative/NovvyAdsPackage.kt

@@ -0,0 +1,46 @@
+package ai.novvy.reactnative
+
+import com.facebook.react.BaseReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.module.model.ReactModuleInfo
+import com.facebook.react.module.model.ReactModuleInfoProvider
+import com.facebook.react.uimanager.ViewManager
+
+/**
+ * React Native package exposing the Novvy Ads TurboModule and the two inline
+ * ad view managers (scroll + pause). Mirrors the Flutter plugin's
+ * `NovvyAdsPlugin` registration.
+ */
+class NovvyAdsPackage : BaseReactPackage() {
+
+  override fun getModule(
+    name: String,
+    reactContext: ReactApplicationContext,
+  ): NativeModule? = if (name == NovvyAdsModule.NAME) {
+    NovvyAdsModule(reactContext)
+  } else {
+    null
+  }
+
+  override fun getReactModuleInfoProvider(): ReactModuleInfoProvider =
+    ReactModuleInfoProvider {
+      mapOf(
+        NovvyAdsModule.NAME to ReactModuleInfo(
+          NovvyAdsModule.NAME,
+          NovvyAdsModule.NAME,
+          false, // canOverrideExistingModule
+          false, // needsEagerInit
+          false, // isCxxModule
+          true, // isTurboModule
+        ),
+      )
+    }
+
+  override fun createViewManagers(
+    reactContext: ReactApplicationContext,
+  ): List<ViewManager<*, *>> = listOf(
+    NovvyScrollAdViewManager(),
+    NovvyPauseAdViewManager(),
+  )
+}

package/android/src/main/java/ai/novvy/reactnative/NovvyPauseAdViewManager.kt

@@ -0,0 +1,68 @@
+package ai.novvy.reactnative
+
+import android.view.ViewGroup
+import android.widget.FrameLayout
+import com.facebook.react.module.annotations.ReactModule
+import com.facebook.react.uimanager.SimpleViewManager
+import com.facebook.react.uimanager.ThemedReactContext
+import com.facebook.react.uimanager.UIManagerHelper
+import com.facebook.react.uimanager.ViewManagerDelegate
+import com.facebook.react.viewmanagers.NovvyPauseAdViewManagerDelegate
+import com.facebook.react.viewmanagers.NovvyPauseAdViewManagerInterface
+
+/**
+ * Fabric ViewManager for the inline realtime pause-card ad container.
+ *
+ * Registers a transparent [FrameLayout] with [NovvyAdsModule] keyed by
+ * `adObjectId`, then fires `onViewReady` so JS issues `attachPauseAd` (there is
+ * no load step for pause ads). Mirrors the Flutter plugin's `NovvyPauseViewFactory`.
+ */
+@ReactModule(name = NovvyPauseAdViewManager.NAME)
+class NovvyPauseAdViewManager :
+  SimpleViewManager<FrameLayout>(),
+  NovvyPauseAdViewManagerInterface<FrameLayout> {
+
+  private val delegate = NovvyPauseAdViewManagerDelegate(this)
+  private val adObjectIds = HashMap<FrameLayout, String>()
+
+  override fun getName(): String = NAME
+
+  override fun getDelegate(): ViewManagerDelegate<FrameLayout> = delegate
+
+  override fun createViewInstance(context: ThemedReactContext): FrameLayout =
+    NovvyAdContainerView(context).apply {
+      layoutParams = ViewGroup.LayoutParams(
+        ViewGroup.LayoutParams.MATCH_PARENT,
+        ViewGroup.LayoutParams.MATCH_PARENT,
+      )
+    }
+
+  override fun setAdObjectId(view: FrameLayout, value: String?) {
+    if (value.isNullOrEmpty()) return
+    adObjectIds[view] = value
+    NovvyAdsModule.instance?.registerPauseContainer(value, view)
+    dispatchViewReady(view, value)
+  }
+
+  private fun dispatchViewReady(view: FrameLayout, adObjectId: String) {
+    val context = (view as? NovvyAdContainerView)?.reactContext ?: return
+    val dispatcher =
+      UIManagerHelper.getEventDispatcherForReactTag(context, view.id) ?: return
+    val surfaceId = UIManagerHelper.getSurfaceId(view)
+    dispatcher.dispatchEvent(ViewReadyEvent(surfaceId, view.id, adObjectId))
+  }
+
+  override fun onDropViewInstance(view: FrameLayout) {
+    super.onDropViewInstance(view)
+    adObjectIds.remove(view)?.let { NovvyAdsModule.instance?.onPauseViewDisposed(it) }
+  }
+
+  override fun getExportedCustomDirectEventTypeConstants(): MutableMap<String, Any> =
+    mutableMapOf(
+      ViewReadyEvent.EVENT_NAME to mapOf("registrationName" to "onViewReady"),
+    )
+
+  companion object {
+    const val NAME = "NovvyPauseAdView"
+  }
+}

package/android/src/main/java/ai/novvy/reactnative/NovvyScrollAdViewManager.kt

@@ -0,0 +1,72 @@
+package ai.novvy.reactnative
+
+import android.graphics.Color
+import android.view.ViewGroup
+import android.widget.FrameLayout
+import com.facebook.react.module.annotations.ReactModule
+import com.facebook.react.uimanager.SimpleViewManager
+import com.facebook.react.uimanager.ThemedReactContext
+import com.facebook.react.uimanager.UIManagerHelper
+import com.facebook.react.uimanager.ViewManagerDelegate
+import com.facebook.react.viewmanagers.NovvyScrollAdViewManagerDelegate
+import com.facebook.react.viewmanagers.NovvyScrollAdViewManagerInterface
+
+/**
+ * Fabric ViewManager for the inline scroll (feed) ad container.
+ *
+ * Creates a black-backed [FrameLayout], registers it with [NovvyAdsModule]
+ * keyed by `adObjectId`, then fires `onViewReady` so JS issues `attachScrollAd`.
+ * Mirrors the Flutter plugin's `NovvyScrollViewFactory` / `NovvyScrollPlatformView`.
+ */
+@ReactModule(name = NovvyScrollAdViewManager.NAME)
+class NovvyScrollAdViewManager :
+  SimpleViewManager<FrameLayout>(),
+  NovvyScrollAdViewManagerInterface<FrameLayout> {
+
+  private val delegate = NovvyScrollAdViewManagerDelegate(this)
+  private val adObjectIds = HashMap<FrameLayout, String>()
+
+  override fun getName(): String = NAME
+
+  override fun getDelegate(): ViewManagerDelegate<FrameLayout> = delegate
+
+  override fun createViewInstance(context: ThemedReactContext): FrameLayout =
+    NovvyAdContainerView(context).apply {
+      layoutParams = ViewGroup.LayoutParams(
+        ViewGroup.LayoutParams.MATCH_PARENT,
+        ViewGroup.LayoutParams.MATCH_PARENT,
+      )
+      // Opaque black backdrop: the ad view is transparent until the video
+      // decodes its first frame; black reads as a clean loading state.
+      setBackgroundColor(Color.BLACK)
+    }
+
+  override fun setAdObjectId(view: FrameLayout, value: String?) {
+    if (value.isNullOrEmpty()) return
+    adObjectIds[view] = value
+    NovvyAdsModule.instance?.registerScrollContainer(value, view)
+    dispatchViewReady(view, value)
+  }
+
+  private fun dispatchViewReady(view: FrameLayout, adObjectId: String) {
+    val context = (view as? NovvyAdContainerView)?.reactContext ?: return
+    val dispatcher =
+      UIManagerHelper.getEventDispatcherForReactTag(context, view.id) ?: return
+    val surfaceId = UIManagerHelper.getSurfaceId(view)
+    dispatcher.dispatchEvent(ViewReadyEvent(surfaceId, view.id, adObjectId))
+  }
+
+  override fun onDropViewInstance(view: FrameLayout) {
+    super.onDropViewInstance(view)
+    adObjectIds.remove(view)?.let { NovvyAdsModule.instance?.onScrollViewDisposed(it) }
+  }
+
+  override fun getExportedCustomDirectEventTypeConstants(): MutableMap<String, Any> =
+    mutableMapOf(
+      ViewReadyEvent.EVENT_NAME to mapOf("registrationName" to "onViewReady"),
+    )
+
+  companion object {
+    const val NAME = "NovvyScrollAdView"
+  }
+}

package/android/src/main/java/ai/novvy/reactnative/RnPlayerAdapter.kt

@@ -0,0 +1,18 @@
+package ai.novvy.reactnative
+
+import ai.novvy.android.sdk.NovvyPlayerAdapter
+
+/**
+ * A [NovvyPlayerAdapter] whose state is pushed from JS via TurboModule calls.
+ *
+ * The SDK's PlaybackMonitor polls this adapter; JS pushes updated values at
+ * ~500ms cadence via `updatePauseAdPlayerState`. Mirrors the Flutter plugin's
+ * `FlutterPlayerAdapter`.
+ */
+internal class RnPlayerAdapter : NovvyPlayerAdapter {
+  @Volatile
+  override var currentPositionMs: Long = 0L
+
+  @Volatile
+  override var isPlaying: Boolean = false
+}

package/android/src/main/java/ai/novvy/reactnative/ViewReadyEvent.kt

@@ -0,0 +1,26 @@
+package ai.novvy.reactnative
+
+import com.facebook.react.bridge.Arguments
+import com.facebook.react.bridge.WritableMap
+import com.facebook.react.uimanager.events.Event
+
+/**
+ * Direct event fired once the native ad container is registered with
+ * [NovvyAdsModule], signalling JS to issue attach (mirrors the Flutter
+ * plugin's `onPlatformViewCreated`).
+ */
+internal class ViewReadyEvent(
+  surfaceId: Int,
+  viewTag: Int,
+  private val adObjectId: String,
+) : Event<ViewReadyEvent>(surfaceId, viewTag) {
+
+  override fun getEventName(): String = EVENT_NAME
+
+  override fun getEventData(): WritableMap =
+    Arguments.createMap().apply { putString("adObjectId", adObjectId) }
+
+  companion object {
+    const val EVENT_NAME = "topViewReady"
+  }
+}

package/app.plugin.js

@@ -0,0 +1,4 @@
+// Entry point Expo looks for when the plugin is referenced as
+// "novvy-ads-react-native" in an app's `plugins` array. Points at the compiled
+// config plugin (build-time only, no runtime dependency).
+module.exports = require('./plugin/build');