react-native-buzzvil-ad 0.1.0

package/Buzzvil.podspec

@@ -0,0 +1,26 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "Buzzvil"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+
+  s.platforms    = { :ios => min_ios_version_supported }
+  s.source       = { :git => "https://github.com/AndrewDongminYoo/react-native-buzzvil.git", :tag => "#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,m,mm,swift,cpp}"
+  s.private_header_files = "ios/**/*.h"
+
+  s.dependency   "BuzzvilSDK", "~> 6.7.5"
+  # Buzzvil.mm imports <BuzzAdBenefitSDK/BuzzAdBenefitSDK-Swift.h> directly for
+  # BuzzBenefitHub, so declare it explicitly rather than relying on transitive
+  # header reachability.
+  s.dependency   "BuzzAdBenefitSDK", "~> 6.7.5"
+
+  install_modules_dependencies(s)
+end

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2026 Dongmin, Yu
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,58 @@
+# react-native-buzzvil-ad
+
+> [!IMPORTANT]
+> **This is an unofficial, community-maintained package — NOT an official Buzzvil product.**
+> It is not affiliated with, endorsed by, or supported by Buzzvil. "Buzzvil" and "BuzzBenefit"
+> are trademarks of their respective owners. Use at your own risk: neither the maintainer nor
+> Buzzvil is responsible for any issues arising from its use.
+
+An unofficial React Native wrapper for the Buzzvil **BuzzBenefit v6** SDK (Android & iOS).
+
+## Installation
+
+```sh
+npm install react-native-buzzvil-ad
+```
+
+## Usage
+
+```js
+import {
+  initialize,
+  login,
+  logout,
+  isLoggedIn,
+  showBenefitHub,
+} from 'react-native-buzzvil-ad';
+
+// Call once at app startup, before any other method:
+initialize('YOUR_BUZZVIL_APP_ID');
+
+// Log a user in (gender / birthYear are optional):
+await login({ userId: 'user-123', gender: 'MALE', birthYear: 1990 });
+
+// Present the BenefitHub (offerwall):
+showBenefitHub();
+
+// Session helpers:
+const loggedIn = await isLoggedIn();
+logout();
+```
+
+## Contributing
+
+- [Development workflow](CONTRIBUTING.md#development-workflow)
+- [Sending a pull request](CONTRIBUTING.md#sending-a-pull-request)
+- [Code of conduct](CODE_OF_CONDUCT.md)
+
+## Disclaimer
+
+This is an unofficial, community-maintained project and is **not** affiliated with, endorsed by, or sponsored by Buzzvil. All product names, logos, and brands — including "Buzzvil" and "BuzzBenefit" — are the property of their respective owners. This package is provided "as is", without warranty of any kind; the maintainer and Buzzvil accept no liability for any damages or issues arising from its use. For official SDKs and support, refer to [Buzzvil's official documentation](https://docs.buzzvil.com).
+
+## License
+
+MIT
+
+---
+
+Made with [create-react-native-library](https://github.com/callstack/react-native-builder-bob)

package/android/build.gradle

@@ -0,0 +1,76 @@
+buildscript {
+  ext.Buzzvil = [
+    kotlinVersion: "2.0.21",
+    minSdkVersion: 24,
+    compileSdkVersion: 36,
+    targetSdkVersion: 36
+  ]
+
+  ext.getExtOrDefault = { prop ->
+    if (rootProject.ext.has(prop)) {
+      return rootProject.ext.get(prop)
+    }
+
+    return Buzzvil[prop]
+  }
+
+  repositories {
+    google()
+    mavenCentral()
+    gradlePluginPortal()
+    maven { url "https://dl.buzzvil.com/public/maven" }
+  }
+
+  dependencies {
+    classpath "com.android.tools.build:gradle:8.7.2"
+    // noinspection DifferentKotlinGradleVersion
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:${getExtOrDefault('kotlinVersion')}"
+  }
+}
+
+
+apply plugin: "com.android.library"
+apply plugin: "kotlin-android"
+
+apply plugin: "com.facebook.react"
+
+android {
+  namespace "com.buzzvil"
+
+  compileSdkVersion getExtOrDefault("compileSdkVersion")
+
+  defaultConfig {
+    minSdkVersion getExtOrDefault("minSdkVersion")
+    targetSdkVersion getExtOrDefault("targetSdkVersion")
+  }
+
+  buildFeatures {
+    buildConfig true
+  }
+
+  buildTypes {
+    release {
+      minifyEnabled false
+    }
+  }
+
+  lint {
+    disable "GradleCompatible"
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_17
+    targetCompatibility JavaVersion.VERSION_17
+  }
+}
+
+dependencies {
+  implementation "com.facebook.react:react-android"
+
+  // Buzzvil BuzzBenefit v6 SDK. The buzzvil-bom pins versions for buzzvil-sdk
+  // and its sub-modules. The Maven repo (dl.buzzvil.com/public/maven) is
+  // declared in the consumer's settings.gradle, not here — RNGP runs in
+  // FAIL_ON_PROJECT_REPOS mode, which rejects module-level repositories {}.
+  api platform("com.buzzvil:buzzvil-bom:6.7.+")
+  implementation "com.buzzvil:buzzvil-sdk"
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,2 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+</manifest>

package/android/src/main/java/com/buzzvil/BuzzvilModule.kt

@@ -0,0 +1,90 @@
+package com.buzzvil
+
+import android.app.Application
+import com.facebook.react.bridge.Promise
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.UiThreadUtil
+
+// The Buzzvil class names and import paths below are verified against the
+// resolved `com.buzzvil:buzzvil-sdk` AAR (buzzvil-bom 6.7.x) — this module
+// compiles cleanly via `:dongminyu_react-native-buzzvil:compileDebugKotlin`.
+import com.buzzvil.buzzbenefit.BuzzBenefitConfig
+import com.buzzvil.buzzbenefit.benefithub.BuzzBenefitHub
+import com.buzzvil.buzzbenefit.benefithub.BuzzBenefitHubConfig
+import com.buzzvil.buzzbenefit.benefithub.BuzzBenefitHubPage
+import com.buzzvil.sdk.BuzzvilSdk
+import com.buzzvil.sdk.BuzzvilSdkLoginListener
+import com.buzzvil.sdk.BuzzvilSdkUser
+
+class BuzzvilModule(
+  reactContext: ReactApplicationContext,
+) : NativeBuzzvilSpec(reactContext) {
+  override fun initialize(appId: String) {
+    val application = reactApplicationContext.applicationContext as Application
+    val config = BuzzBenefitConfig.Builder(appId).build()
+    BuzzvilSdk.initialize(application, config)
+  }
+
+  override fun login(
+    userId: String,
+    gender: String,
+    birthYear: Double,
+    promise: Promise,
+  ) {
+    // Sentinel contract (see NativeBuzzvil.ts): "" gender / 0 birthYear → unset.
+    val user =
+      BuzzvilSdkUser(
+        userId = userId,
+        gender =
+          when (gender) {
+            "MALE" -> BuzzvilSdkUser.Gender.MALE
+            "FEMALE" -> BuzzvilSdkUser.Gender.FEMALE
+            else -> BuzzvilSdkUser.Gender.UNKNOWN // sentinel "" → unspecified
+          },
+        birthYear = if (birthYear > 0) birthYear.toInt() else null,
+      )
+    BuzzvilSdk.login(
+      user,
+      object : BuzzvilSdkLoginListener {
+        override fun onSuccess() {
+          promise.resolve(null)
+        }
+
+        override fun onFailure(errorType: BuzzvilSdkLoginListener.ErrorType) {
+          promise.reject("buzzvil_login_failed", "Buzzvil login failed: $errorType")
+        }
+      },
+    )
+  }
+
+  override fun logout() {
+    BuzzvilSdk.logout()
+  }
+
+  override fun isLoggedIn(promise: Promise) {
+    promise.resolve(BuzzvilSdk.isLoggedIn)
+  }
+
+  override fun showBenefitHub(
+    routePath: String,
+    showHistory: Boolean,
+  ) {
+    // BenefitHub launches an Activity — must run on the main thread (parity
+    // with the iOS dispatch_async(main) path).
+    UiThreadUtil.runOnUiThread {
+      val activity = currentActivity ?: return@runOnUiThread
+      val configBuilder = BuzzBenefitHubConfig.Builder()
+      if (routePath.isNotEmpty()) {
+        configBuilder.routePath(routePath)
+      }
+      if (showHistory) {
+        configBuilder.queryParams(BuzzBenefitHubPage.HISTORY.toRedirectQueryParams())
+      }
+      BuzzBenefitHub.show(activity, configBuilder.build())
+    }
+  }
+
+  companion object {
+    const val NAME = NativeBuzzvilSpec.NAME
+  }
+}

package/android/src/main/java/com/buzzvil/BuzzvilNativeAdView.kt

@@ -0,0 +1,250 @@
+package com.buzzvil
+
+import android.view.LayoutInflater
+import android.view.ViewGroup
+import android.widget.FrameLayout
+import android.widget.ImageView
+import android.widget.TextView
+import androidx.core.view.doOnLayout
+import com.facebook.react.bridge.Arguments
+import com.facebook.react.bridge.ReactContext
+import com.facebook.react.bridge.UiThreadUtil
+import com.facebook.react.bridge.WritableMap
+import com.facebook.react.uimanager.ThemedReactContext
+import com.facebook.react.uimanager.UIManagerHelper
+import com.facebook.react.uimanager.events.Event
+
+// Buzzvil native-ad API. Class names / signatures verified against the resolved
+// com.buzzvil:buzzad-benefit-base 6.7.7 AAR via `javap` (transitive through
+// buzzvil-sdk / buzzvil-bom). Notably: BuzzNativeViewBinder.bind() takes the
+// BuzzNative loader (NOT the loaded BuzzNativeAd), and the binder exposes
+// unbind()/dispose() for cleanup.
+import com.buzzvil.buzzbenefit.buzznative.BuzzMediaView
+import com.buzzvil.buzzbenefit.DefaultBuzzCtaView
+import com.buzzvil.buzzbenefit.buzznative.BuzzNative
+import com.buzzvil.buzzbenefit.buzznative.BuzzNativeAd
+import com.buzzvil.buzzbenefit.buzznative.BuzzNativeAdEventsListener
+import com.buzzvil.buzzbenefit.buzznative.BuzzNativeAdView as BuzzAdView
+import com.buzzvil.buzzbenefit.buzznative.BuzzNativeViewBinder
+import com.buzzvil.buzzbenefit.buzznative.BuzzRewardResult
+
+class BuzzvilNativeAdView(
+  context: ThemedReactContext,
+) : FrameLayout(context) {
+  // Plain private fields + explicit setters. Do NOT use `var x; private set` —
+  // its generated setX(String) would clash with the fun setX(String) below.
+  private var unitId: String? = null
+  private var layoutVariant: String = "300x250"
+
+  @Volatile private var disposed = false
+
+  private var buzzNative: BuzzNative? = null
+  private var binder: BuzzNativeViewBinder? = null
+
+  // The unit id of the in-flight / loaded ad. Doubles as the reload guard: an
+  // in-place `unitId` prop change must (re)load (mirrors iOS's `_loadedUnitId`
+  // comparison). Cleared in cleanup() so a recycled view can load again — never
+  // latched permanently.
+  private var loadedUnitId: String? = null
+
+  fun setUnitId(id: String) {
+    unitId = id.ifEmpty { null }
+    loadIfReady()
+  }
+
+  fun setLayoutVariant(v: String) {
+    layoutVariant = v
+  }
+
+  override fun onAttachedToWindow() {
+    super.onAttachedToWindow()
+    loadIfReady()
+  }
+
+  // Fabric sets props in any order, and the view may not be attached when the
+  // unitId arrives — both entry points call this. Guard on an id comparison
+  // (mirrors iOS): (re)load only when a non-null unitId actually changes, so an
+  // in-place `unitId` prop change on a mounted view reloads instead of being
+  // ignored.
+  private fun loadIfReady() {
+    val id = unitId
+    if (id == null || !isAttachedToWindow || id == loadedUnitId) return
+    loadedUnitId = id
+
+    // Tear down any previous ad before the new load (mirrors cleanup()'s
+    // teardown); a unitId change on a mounted view reuses this same object.
+    binder?.unbind()
+    binder?.dispose()
+    binder = null
+    buzzNative = null
+    removeAllViews()
+    // Re-arm the in-flight guard so the new load's callbacks (and the
+    // doOnLayout size emit) are not blocked by a previous cleanup()/load.
+    disposed = false
+
+    val buzz = BuzzNative(id)
+    buzzNative = buzz
+
+    buzz.setAdEventsListener(
+      object : BuzzNativeAdEventsListener {
+        override fun onImpressed(ad: BuzzNativeAd) {
+          emit("topImpressed", Arguments.createMap())
+        }
+
+        override fun onClicked(ad: BuzzNativeAd) {
+          emit("topAdClicked", Arguments.createMap())
+        }
+
+        override fun onRewardRequested(ad: BuzzNativeAd) {
+          // No matching JS event.
+        }
+
+        override fun onParticipated(ad: BuzzNativeAd) {
+          // No matching JS event.
+        }
+
+        override fun onRewarded(
+          ad: BuzzNativeAd,
+          result: BuzzRewardResult,
+        ) {
+          val payload = Arguments.createMap()
+          payload.putBoolean("success", result == BuzzRewardResult.SUCCESS)
+          emit("topRewarded", payload)
+        }
+      },
+    )
+
+    buzz.load(
+      { _ ->
+        // Inflate + bind must touch views on the UI thread. Re-check the reload
+        // guard on the UI thread (mirrors iOS): a late callback from a previous
+        // unitId must bail when `loadedUnitId` has since changed, otherwise it
+        // would bind a stale ad and double-emit.
+        UiThreadUtil.runOnUiThread {
+          if (disposed || id != loadedUnitId) return@runOnUiThread
+          bindLoadedAd(buzz)
+        }
+      },
+      { error ->
+        // Marshal to the UI thread for symmetry with the success path; the SDK
+        // gives no thread guarantee for these callbacks.
+        UiThreadUtil.runOnUiThread {
+          if (disposed || id != loadedUnitId) return@runOnUiThread
+          val payload = Arguments.createMap()
+          payload.putString("code", error.type.name)
+          payload.putString("message", error.message ?: error.type.name)
+          emit("topAdFailed", payload)
+        }
+      },
+    )
+  }
+
+  // Two layout families: compact horizontal banner (no media) for the small
+  // inventory sizes, the vertical media-on-top card for the large ones.
+  private fun layoutResFor(variant: String): Int =
+    when (variant) {
+      "320x50", "320x100", "320x130" -> R.layout.buzzvil_native_ad_banner
+      else -> R.layout.buzzvil_native_ad_card
+    }
+
+  // Fixed inventory-box height (dp) per exact size. Width comes from the JS
+  // `style`. NOTE: under Fabric the host frame is ultimately driven by the
+  // shadow node, so this height is a best-effort hint — see CLAUDE notes / PR.
+  private fun heightDpFor(variant: String): Int =
+    when (variant) {
+      "320x50" -> 50
+      "320x100" -> 100
+      "320x130" -> 130
+      "300x250" -> 250
+      "320x480" -> 480
+      else -> 250
+    }
+
+  private fun bindLoadedAd(buzz: BuzzNative) {
+    val adView =
+      LayoutInflater
+        .from(context)
+        .inflate(layoutResFor(layoutVariant), this, false) as BuzzAdView
+    removeAllViews()
+    addView(adView)
+
+    // Pin the host to the inventory-box height (px from dp); width stays from style.
+    val density = resources.displayMetrics.density
+    val heightPx = (heightDpFor(layoutVariant) * density).toInt()
+    layoutParams =
+      (
+        layoutParams ?: FrameLayout.LayoutParams(
+          ViewGroup.LayoutParams.MATCH_PARENT,
+          heightPx,
+        )
+      ).apply { height = heightPx }
+
+    val media = adView.findViewById<BuzzMediaView>(R.id.buzz_media)
+    val icon = adView.findViewById<ImageView>(R.id.buzz_icon)
+    val title = adView.findViewById<TextView>(R.id.buzz_title)
+    val desc = adView.findViewById<TextView>(R.id.buzz_desc)
+    val cta = adView.findViewById<DefaultBuzzCtaView>(R.id.buzz_cta)
+
+    binder =
+      BuzzNativeViewBinder
+        .Builder()
+        .buzzNativeAdView(adView)
+        .buzzMediaView(media)
+        .iconImageView(icon)
+        .titleTextView(title)
+        .descriptionTextView(desc)
+        .buzzCtaView(cta)
+        .build()
+    // bind() takes the BuzzNative loader, not the loaded BuzzNativeAd.
+    binder?.bind(buzz)
+
+    // Emit the REAL measured size, not the pre-layout {0,0}. doOnLayout fires
+    // once on the next layout pass (it self-removes), so this emits exactly once
+    // per load with non-zero dimensions.
+    doOnLayout {
+      if (disposed) return@doOnLayout
+      // getWidth()/getHeight() are physical pixels; RN's coordinate system is
+      // DP/points, so divide by display density to match iOS (which emits
+      // UIKit points). Same `displayMetrics.density` used for the fixed-height
+      // calc above.
+      val density = resources.displayMetrics.density
+      val payload = Arguments.createMap()
+      payload.putDouble("width", width / density.toDouble())
+      payload.putDouble("height", height / density.toDouble())
+      emit("topAdLoaded", payload)
+    }
+  }
+
+  private fun emit(
+    eventName: String,
+    payload: WritableMap,
+  ) {
+    val reactContext = context as ReactContext
+    val surfaceId = UIManagerHelper.getSurfaceId(reactContext)
+    val dispatcher = UIManagerHelper.getEventDispatcherForReactTag(reactContext, id) ?: return
+    dispatcher.dispatchEvent(BuzzvilAdEvent(surfaceId, id, eventName, payload))
+  }
+
+  fun cleanup() {
+    disposed = true
+    binder?.unbind()
+    binder?.dispose()
+    binder = null
+    buzzNative = null
+    // Clear the reload guard for recycle symmetry with iOS (prepareForRecycle):
+    // a reused view must be able to load again.
+    loadedUnitId = null
+    removeAllViews()
+  }
+
+  private class BuzzvilAdEvent(
+    surfaceId: Int,
+    viewTag: Int,
+    private val name: String,
+    private val payload: WritableMap,
+  ) : Event<BuzzvilAdEvent>(surfaceId, viewTag) {
+    override fun getEventName() = name
+
+    override fun getEventData() = payload
+  }
+}

package/android/src/main/java/com/buzzvil/BuzzvilNativeAdViewManager.kt

@@ -0,0 +1,62 @@
+package com.buzzvil
+
+import com.facebook.react.module.annotations.ReactModule
+import com.facebook.react.uimanager.SimpleViewManager
+import com.facebook.react.uimanager.ThemedReactContext
+import com.facebook.react.uimanager.ViewManagerDelegate
+import com.facebook.react.uimanager.annotations.ReactProp
+import com.facebook.react.viewmanagers.BuzzvilNativeAdViewManagerDelegate
+import com.facebook.react.viewmanagers.BuzzvilNativeAdViewManagerInterface
+
+@ReactModule(name = BuzzvilNativeAdViewManager.NAME)
+class BuzzvilNativeAdViewManager :
+  SimpleViewManager<BuzzvilNativeAdView>(),
+  BuzzvilNativeAdViewManagerInterface<BuzzvilNativeAdView> {
+  private val mDelegate: ViewManagerDelegate<BuzzvilNativeAdView>
+
+  init {
+    mDelegate = BuzzvilNativeAdViewManagerDelegate(this)
+  }
+
+  override fun getDelegate(): ViewManagerDelegate<BuzzvilNativeAdView>? = mDelegate
+
+  override fun getName(): String = NAME
+
+  public override fun createViewInstance(context: ThemedReactContext): BuzzvilNativeAdView = BuzzvilNativeAdView(context)
+
+  @ReactProp(name = "unitId")
+  override fun setUnitId(
+    view: BuzzvilNativeAdView,
+    value: String?,
+  ) {
+    view.setUnitId(value ?: "")
+  }
+
+  @ReactProp(name = "layout")
+  override fun setLayout(
+    view: BuzzvilNativeAdView,
+    value: String?,
+  ) {
+    view.setLayoutVariant(value ?: "300x250")
+  }
+
+  // Map the bubbling event names dispatched by the view to the JS prop handlers
+  // declared in BuzzvilNativeAdViewNativeComponent.ts.
+  override fun getExportedCustomDirectEventTypeConstants(): MutableMap<String, Any> =
+    mutableMapOf(
+      "topAdLoaded" to mapOf("registrationName" to "onAdLoaded"),
+      "topAdFailed" to mapOf("registrationName" to "onAdFailed"),
+      "topAdClicked" to mapOf("registrationName" to "onAdClicked"),
+      "topImpressed" to mapOf("registrationName" to "onImpressed"),
+      "topRewarded" to mapOf("registrationName" to "onRewarded"),
+    )
+
+  override fun onDropViewInstance(view: BuzzvilNativeAdView) {
+    view.cleanup()
+    super.onDropViewInstance(view)
+  }
+
+  companion object {
+    const val NAME = "BuzzvilNativeAdView"
+  }
+}

package/android/src/main/java/com/buzzvil/BuzzvilPackage.kt

@@ -0,0 +1,37 @@
+package com.buzzvil
+
+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
+
+class BuzzvilPackage : BaseReactPackage() {
+  override fun createViewManagers(reactContext: ReactApplicationContext): List<ViewManager<*, *>> = listOf(BuzzvilNativeAdViewManager())
+
+  override fun getModule(
+    name: String,
+    reactContext: ReactApplicationContext,
+  ): NativeModule? =
+    if (name == BuzzvilModule.NAME) {
+      BuzzvilModule(reactContext)
+    } else {
+      null
+    }
+
+  override fun getReactModuleInfoProvider() =
+    ReactModuleInfoProvider {
+      mapOf(
+        BuzzvilModule.NAME to
+          ReactModuleInfo(
+            name = BuzzvilModule.NAME,
+            className = BuzzvilModule.NAME,
+            canOverrideExistingModule = false,
+            needsEagerInit = false,
+            isCxxModule = false,
+            isTurboModule = true,
+          ),
+      )
+    }
+}