react-native-daro 1.0.15 → 2.0.0-rc.1

package/android/src/oldarch/java/com/daro/reactnative/DaroRNModuleSpec.kt

@@ -0,0 +1,119 @@
+package com.daro.reactnative
+
+import com.facebook.react.bridge.Promise
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.ReactContextBaseJavaModule
+import com.facebook.react.bridge.ReactMethod
+import com.facebook.react.bridge.ReadableMap
+
+abstract class DaroRNModuleSpec(reactContext: ReactApplicationContext) :
+  ReactContextBaseJavaModule(reactContext) {
+
+  override fun getName(): String = DaroRNModule.NAME
+
+  protected abstract fun getTypedExportedConstants(): MutableMap<String, Any>
+
+  override fun getConstants(): MutableMap<String, Any> = getTypedExportedConstants()
+
+  @ReactMethod
+  abstract fun addListener(eventName: String)
+
+  @ReactMethod
+  abstract fun removeListeners(count: Double)
+
+  @ReactMethod
+  abstract fun isInitialized(promise: Promise)
+
+  @ReactMethod
+  abstract fun initializeSdk(promise: Promise)
+
+  @ReactMethod
+  abstract fun setUserId(userId: String, promise: Promise)
+
+  @ReactMethod
+  abstract fun setGdpr(status: String, consentString: String, promise: Promise)
+
+  @ReactMethod
+  abstract fun setCcpa(status: String, consentString: String, promise: Promise)
+
+  @ReactMethod
+  abstract fun setCoppa(status: String, promise: Promise)
+
+  @ReactMethod
+  abstract fun showMediationDebugger(promise: Promise)
+
+  // QA 표면 — newarch 는 NativeDaroModule.ts 에서 코드젠으로 생기지만 oldarch 는 이
+  // 손 스펙이 정본이다. 스펙에 메서드를 더할 때 여기도 같이 더하지 않으면 oldarch
+  // 소비자에서 "overrides nothing" 으로 컴파일이 깨진다 (example 은 newarch 라 안 보인다).
+  @ReactMethod
+  abstract fun showMediationDebuggerFor(mediation: String, promise: Promise)
+
+  @ReactMethod
+  abstract fun getSdkVersion(promise: Promise)
+
+  @ReactMethod
+  abstract fun getMediationStatuses(promise: Promise)
+
+  @ReactMethod
+  abstract fun getMediationWeights(promise: Promise)
+
+  @ReactMethod
+  abstract fun getAdapterInventory(promise: Promise)
+
+  @ReactMethod
+  abstract fun getIntegrationKeyInfo(promise: Promise)
+
+  @ReactMethod
+  abstract fun isInterstitialReady(requestId: Double, adUnitId: String, promise: Promise)
+
+  @ReactMethod
+  abstract fun loadInterstitial(requestId: Double, adUnitId: String, promise: Promise)
+
+  @ReactMethod
+  abstract fun showInterstitial(requestId: Double, adUnitId: String, promise: Promise)
+
+  @ReactMethod
+  abstract fun isRewardedAdReady(requestId: Double, adUnitId: String, promise: Promise)
+
+  @ReactMethod
+  abstract fun loadRewardedAd(requestId: Double, adUnitId: String, promise: Promise)
+
+  @ReactMethod
+  abstract fun showRewardedAd(
+    requestId: Double,
+    adUnitId: String,
+    customData: String?,
+    promise: Promise,
+  )
+
+  @ReactMethod
+  abstract fun isAppOpenAdReady(requestId: Double, adUnitId: String, promise: Promise)
+
+  @ReactMethod
+  abstract fun loadAppOpenAd(requestId: Double, adUnitId: String, promise: Promise)
+
+  @ReactMethod
+  abstract fun showAppOpenAd(
+    requestId: Double,
+    adUnitId: String,
+    customData: String?,
+    promise: Promise,
+  )
+
+  @ReactMethod
+  abstract fun isLightPopupReady(requestId: Double, adUnitId: String, promise: Promise)
+
+  @ReactMethod
+  abstract fun loadLightPopup(requestId: Double, adUnitId: String, promise: Promise)
+
+  @ReactMethod
+  abstract fun showLightPopup(requestId: Double, adUnitId: String, promise: Promise)
+
+  @ReactMethod
+  abstract fun setLightPopupAdConfiguration(
+    requestId: Double,
+    adUnitId: String,
+    configuration: ReadableMap,
+    promise: Promise,
+  )
+}

package/ios/{DaroMModule+AppOpen.swift → DaroRNModule+AppOpen.swift}

@@ -2,45 +2,47 @@ import React
 
 // MARK: - AppOpen Ad Methods
 
-extension DaroMModule {
+extension DaroRNModule {
 
-    @objc(isAppOpenAdReady::::)
+    @objc(isAppOpenAdReady:adUnitId:resolve:reject:)
     func isAppOpenAdReady(
-        _ requestId: NSNumber,
+        requestId: Double,
         adUnitId: String,
         resolve: RCTPromiseResolveBlock,
         reject: RCTPromiseRejectBlock
     ) {
+      let requestId = Int(requestId)
       if !Self.sdkInitialized {
-        DaroMModule.logger.debug("[DaroMMobileAds] !isInitialized")
+        DaroRNModule.logger.debug("[DaroRNMobileAds] !isInitialized")
         resolve(false)
         return
       }
-      resolve(appOpenAds[requestId.intValue]?.loadedAd != nil)
+      resolve(appOpenAds[requestId]?.loadedAd != nil)
     }
 
-    @objc(loadAppOpenAd::::)
+    @objc(loadAppOpenAd:adUnitId:resolve:reject:)
     func loadAppOpenAd(
-        _ requestId: NSNumber,
+        requestId: Double,
         adUnitId: String,
         resolve: RCTPromiseResolveBlock,
         reject: RCTPromiseRejectBlock
     ) {
-        let appOpenAdLoader = retrieveAppOpenLoader(requestId: requestId.intValue, adUnitId: adUnitId)
+      let requestId = Int(requestId)
+      let appOpenAdLoader = retrieveAppOpenLoader(requestId: requestId, adUnitId: adUnitId)
       appOpenAdLoader.loadAd()
-        resolve(Void())
+      resolve(Void())
     }
 
-    @objc(showAppOpenAd::::::)
+    @objc(showAppOpenAd:adUnitId:customData:resolve:reject:)
     func showAppOpenAd(
-        _ requestId: NSNumber,
+        requestId: Double,
         adUnitId: String,
-        placement: String?,
         customData: String?,
         resolve: @escaping RCTPromiseResolveBlock,
         reject: RCTPromiseRejectBlock
     ) {
-      guard let loadedAd = appOpenAds[requestId.intValue]?.loadedAd else {
+      let requestId = Int(requestId)
+      guard let loadedAd = appOpenAds[requestId]?.loadedAd else {
         reject("APPOPEN_NOT_LOADED", "AppOpen ad not loaded", nil)
         return
       }
@@ -56,25 +58,25 @@ extension DaroMModule {
     } else {
       let appOpenLoader = DaroAppOpenAdLoader(unit: DaroAdUnit(unitId: adUnitId))
       appOpenLoader.listener.onAdClicked = { [weak self] adInfo in
-        DaroMModule.logger.debug("[DARO] Sample AppOpen Ad clicked")
+        DaroRNModule.logger.debug("[DARO] Sample AppOpen Ad clicked")
         self?.sendEvent(with: .onAppOpenAdClickedEvent, body: adInfo?.toBody(requestId: requestId))
       }
 
       appOpenLoader.listener.onAdImpression = { [weak self] adInfo in
-        DaroMModule.logger.debug("[DARO] Sample AppOpen Ad impression")
+        DaroRNModule.logger.debug("[DARO] Sample AppOpen Ad impression")
         self?.appOpenAds[requestId]?.loadedAd = nil
         self?.sendEvent(with: .onAppOpenAdImpressionRecordedEvent, body: adInfo?.toBody(requestId: requestId))
       }
 
       appOpenLoader.listener.onAdLoadSuccess = { [weak self] ad, adInfo in
-        DaroMModule.logger.debug("[DARO] Sample AppOpen Ad loaded")
+        DaroRNModule.logger.debug("[DARO] Sample AppOpen Ad loaded")
         self?.appOpenAds[requestId]?.loadedAd = ad
         self?.sendEvent(with: .onAppOpenAdLoadedEvent, body: adInfo?.toBody(requestId: requestId))
         self?.setupAppOpenListener(for: ad, requestId: requestId)
       }
 
       appOpenLoader.listener.onAdLoadFail = { [weak self] error in
-        DaroMModule.logger.debug("[DARO] Sample AppOpen Ad failed: \(error)")
+        DaroRNModule.logger.debug("[DARO] Sample AppOpen Ad failed: \(error)")
         self?.sendEvent(with: .onAppOpenAdLoadFailedEvent, body: error.toBody(requestId: requestId))
       }
       self.appOpenAds[requestId] = AppOpenAd(loader: appOpenLoader)
@@ -84,17 +86,17 @@ extension DaroMModule {
 
   private func setupAppOpenListener(for ad: DaroAppOpenAd, requestId: Int) {
     ad.appOpenAdListener.onShown = { [weak self] adInfo in
-      DaroMModule.logger.debug("[DARO] Sample AppOpen Ad displayed")
+      DaroRNModule.logger.debug("[DARO] Sample AppOpen Ad displayed")
       self?.sendEvent(with: .onAppOpenAdDisplayedEvent, body: adInfo?.toBody(requestId: requestId))
     }
 
     ad.appOpenAdListener.onDismiss = { [weak self] adInfo in
-      DaroMModule.logger.debug("[DARO] Sample AppOpen Ad hidden")
+      DaroRNModule.logger.debug("[DARO] Sample AppOpen Ad hidden")
       self?.sendEvent(with: .onAppOpenAdHiddenEvent, body: adInfo?.toBody(requestId: requestId))
     }
 
     ad.appOpenAdListener.onFailedToShow = { [weak self] adInfo, error in
-      DaroMModule.logger.debug("[DARO] Sample AppOpen Ad failed to display")
+      DaroRNModule.logger.debug("[DARO] Sample AppOpen Ad failed to display")
       self?.sendEvent(with: .onAppOpenAdFailedToDisplayEvent, body: adInfo?.toBody(requestId: requestId))
     }
   }

package/ios/DaroRNModule+Consent.swift

@@ -0,0 +1,88 @@
+import Daro
+import Dispatch
+import React
+
+/// 동의 표면(GDPR·CCPA·COPPA) — JS 의 플랫폼 중립 문자열을 iOS 표현으로 옮긴다.
+///
+/// **JS 가 raw Int 를 넘기지 않는다.** `DaroGdprStatus` 는 `@objc enum … : Int` 라
+/// 브리지로 정수를 흘리는 게 제일 짧지만, 그러면 iOS 의 case 순서가 JS 계약이 되어
+/// Android(enum 이름 기반)가 그 정수를 되옮겨야 한다. 되옮김이 빠지거나 낡으면 **에러
+/// 없이 틀린 동의 상태**가 전달된다 — Flutter 가 그 반대 방향(Android enum 이름을 그대로
+/// iOS 로)으로 겪은 사고가 DARO-1471 이다. 그래서 오가는 것은 어느 플랫폼 것도 아닌
+/// 문자열이고, 옮기는 표가 여기 한 장 있다.
+extension DaroRNModule {
+
+  private static let gdprStatuses: [String: DaroGdprStatus] = [
+    "optIn": .optIn,
+    "optOut": .optOut,
+    "notApplicable": .notApplicable,
+    "unknown": .unknown,
+  ]
+
+  private static let ccpaStatuses: [String: DaroCcpaStatus] = [
+    "optIn": .optIn,
+    "optOut": .optOut,
+    "notApplicable": .notApplicable,
+  ]
+
+  private static let coppaStatuses: [String: DaroCoppaStatus] = [
+    "child": .child,
+    "notChild": .notChild,
+  ]
+
+  // 모르는 상태는 **기본값으로 떨어뜨리지 않고 reject 한다.** 동의는 조용히 틀리면 안 되는
+  // 값이다 — 오타가 "일단 옵트인"으로 흡수되면 호출자는 성공 응답을 받고 규제 대상
+  // 트래픽에 개인화 광고를 계속 태운다. 실패가 화면에 남는 쪽이 싸다.
+  @objc(setGdpr:consentString:resolve:reject:)
+  func setGdpr(
+    status: String,
+    consentString: String,
+    resolve: @escaping RCTPromiseResolveBlock,
+    reject: @escaping RCTPromiseRejectBlock
+  ) {
+    guard let parsed = Self.gdprStatuses[status] else {
+      reject("INVALID_CONSENT_STATUS", "Unknown GdprStatus: \(status)", nil)
+      return
+    }
+    // `DaroAds.setGdpr` 는 메인 스레드 호출을 요구한다(SDK 주석). 이 모듈의 메서드는
+    // RN 이 모듈 전용 큐에서 부르므로 여기서 옮겨야 한다 — 안 옮기면 백그라운드에서
+    // 네트워크 SDK 의 프라이버시 설정을 만지게 된다.
+    DispatchQueue.main.async {
+      DaroAds.shared.setGdpr(parsed, consentString: consentString)
+      resolve(nil)
+    }
+  }
+
+  @objc(setCcpa:consentString:resolve:reject:)
+  func setCcpa(
+    status: String,
+    consentString: String,
+    resolve: @escaping RCTPromiseResolveBlock,
+    reject: @escaping RCTPromiseRejectBlock
+  ) {
+    guard let parsed = Self.ccpaStatuses[status] else {
+      reject("INVALID_CONSENT_STATUS", "Unknown CcpaStatus: \(status)", nil)
+      return
+    }
+    DispatchQueue.main.async {
+      DaroAds.shared.setCcpa(parsed, consentString: consentString)
+      resolve(nil)
+    }
+  }
+
+  @objc(setCoppa:resolve:reject:)
+  func setCoppa(
+    status: String,
+    resolve: @escaping RCTPromiseResolveBlock,
+    reject: @escaping RCTPromiseRejectBlock
+  ) {
+    guard let parsed = Self.coppaStatuses[status] else {
+      reject("INVALID_CONSENT_STATUS", "Unknown CoppaStatus: \(status)", nil)
+      return
+    }
+    DispatchQueue.main.async {
+      DaroAds.shared.setCoppa(parsed)
+      resolve(nil)
+    }
+  }
+}

package/ios/{DaroMModule+Interstitial.swift → DaroRNModule+Interstitial.swift}

@@ -2,43 +2,46 @@ import React
 
 // MARK: - Interstitial Ad Methods
 
-extension DaroMModule {
+extension DaroRNModule {
 
-  @objc(isInterstitialReady::::)
+  @objc(isInterstitialReady:adUnitId:resolve:reject:)
     func isInterstitialReady(
-      _ requestId: NSNumber,
+      requestId: Double,
       adUnitId: String,
       resolve: RCTPromiseResolveBlock,
       reject: RCTPromiseRejectBlock
     ) {
+      let requestId = Int(requestId)
       if !Self.sdkInitialized {
-        DaroMModule.logger.debug("[DaroMMobileAds] !isInitialized")
+        DaroRNModule.logger.debug("[DaroRNMobileAds] !isInitialized")
         resolve(false)
         return
       }
-      resolve(interstitials[requestId.intValue]?.loadedAd != nil)
+      resolve(interstitials[requestId]?.loadedAd != nil)
     }
 
-    @objc(loadInterstitial::::)
+    @objc(loadInterstitial:adUnitId:resolve:reject:)
     func loadInterstitial(
-      _ requestId: NSNumber,
+      requestId: Double,
       adUnitId: String,
       resolve: RCTPromiseResolveBlock,
       reject: RCTPromiseRejectBlock
     ) {
-      let interstitialLoader = retrieveInterstitialLoader(requestId: requestId.intValue, adUnitId: adUnitId)
+      let requestId = Int(requestId)
+      let interstitialLoader = retrieveInterstitialLoader(requestId: requestId, adUnitId: adUnitId)
       interstitialLoader.loadAd()
       resolve(Void())
     }
 
-    @objc(showInterstitial::::)
+    @objc(showInterstitial:adUnitId:resolve:reject:)
     func showInterstitial(
-      _ requestId: NSNumber,
+      requestId: Double,
       adUnitId: String,
       resolve: @escaping RCTPromiseResolveBlock,
       reject: @escaping RCTPromiseRejectBlock
     ) {
-      guard let loadedAd = interstitials[requestId.intValue]?.loadedAd else {
+      let requestId = Int(requestId)
+      guard let loadedAd = interstitials[requestId]?.loadedAd else {
         reject("INTERSTITIAL_NOT_LOADED", "Interstitial ad not loaded", nil)
         return
       }
@@ -58,25 +61,25 @@ extension DaroMModule {
       } else {
         let interstitialLoader = DaroInterstitialAdLoader(unit: DaroAdUnit(unitId: adUnitId))
         interstitialLoader.listener.onAdClicked = { [weak self] adInfo in
-          DaroMModule.logger.debug("[DARO] Sample Interstitial Ad clicked")
+          DaroRNModule.logger.debug("[DARO] Sample Interstitial Ad clicked")
           self?.sendEvent(with: .onInterstitialClickedEvent, body: adInfo?.toBody(requestId: requestId))
         }
 
         interstitialLoader.listener.onAdImpression = { [weak self] adInfo in
-          DaroMModule.logger.debug("[DARO] Sample Interstitial Ad impression")
+          DaroRNModule.logger.debug("[DARO] Sample Interstitial Ad impression")
           self?.interstitials[requestId]?.loadedAd = nil
           self?.sendEvent(with: .onInterstitialAdImpressionRecordedEvent, body: adInfo?.toBody(requestId: requestId))
         }
 
         interstitialLoader.listener.onAdLoadSuccess = { [weak self] ad, adInfo in
-          DaroMModule.logger.debug("[DARO] Sample Interstitial Ad loaded")
+          DaroRNModule.logger.debug("[DARO] Sample Interstitial Ad loaded")
           self?.interstitials[requestId]?.loadedAd = ad
           self?.sendEvent(with: .onInterstitialLoadedEvent, body: adInfo?.toBody(requestId: requestId))
           self?.setupInterstitialListener(for: ad, requestId: requestId)
         }
 
         interstitialLoader.listener.onAdLoadFail = { [weak self] error in
-          DaroMModule.logger.debug("[DARO] Sample Interstitial Ad failed: \(error)")
+          DaroRNModule.logger.debug("[DARO] Sample Interstitial Ad failed: \(error)")
           self?.sendEvent(with: .onInterstitialLoadFailedEvent, body: error.toBody(requestId: requestId))
         }
         self.interstitials[requestId] = InterstitialAd(loader: interstitialLoader)
@@ -86,17 +89,17 @@ extension DaroMModule {
 
     private func setupInterstitialListener(for ad: DaroInterstitialAd, requestId: Int) {
       ad.interstitialListener.onShown = { [weak self] adInfo in
-        DaroMModule.logger.debug("[DARO] Sample Interstitial Ad displayed")
+        DaroRNModule.logger.debug("[DARO] Sample Interstitial Ad displayed")
         self?.sendEvent(with: .onInterstitialDisplayedEvent, body: adInfo?.toBody(requestId: requestId))
       }
 
       ad.interstitialListener.onDismiss = { [weak self] adInfo in
-        DaroMModule.logger.debug("[DARO] Sample Interstitial Ad hidden")
+        DaroRNModule.logger.debug("[DARO] Sample Interstitial Ad hidden")
         self?.sendEvent(with: .onInterstitialHiddenEvent, body: adInfo?.toBody(requestId: requestId))
       }
 
       ad.interstitialListener.onFailedToShow = { [weak self] adInfo, error in
-        DaroMModule.logger.debug("[DARO] Sample Interstitial Ad failed to display")
+        DaroRNModule.logger.debug("[DARO] Sample Interstitial Ad failed to display")
         self?.sendEvent(with: .onInterstitialAdFailedToDisplayEvent, body: adInfo?.toBody(requestId: requestId))
       }
     }

package/ios/{DaroMModule+LightPopup.swift → DaroRNModule+LightPopup.swift}

@@ -1,47 +1,50 @@
 import React
 import UIKit
 // MARK: - LightPopup Ad
-extension DaroMModule {
+extension DaroRNModule {
 
-  @objc(isLightPopupReady::::)
+  @objc(isLightPopupReady:adUnitId:resolve:reject:)
   func isLightPopupReady(
-    _ requestId: NSNumber,
+    requestId: Double,
     adUnitId: String,
     resolve: RCTPromiseResolveBlock,
     reject: RCTPromiseRejectBlock
   ) {
+    let requestId = Int(requestId)
     if !Self.sdkInitialized {
-      DaroMModule.logger.debug("[DaroMMobileAds] !isInitialized")
+      DaroRNModule.logger.debug("[DaroRNMobileAds] !isInitialized")
       resolve(false)
       return
     }
-    resolve(lightPopups[requestId.intValue]?.loadedAd != nil)
+    resolve(lightPopups[requestId]?.loadedAd != nil)
   }
 
-  @objc(loadLightPopup::::)
+  @objc(loadLightPopup:adUnitId:resolve:reject:)
   func loadLightPopup(
-    _ requestId: NSNumber,
+    requestId: Double,
     adUnitId: String,
     resolve: RCTPromiseResolveBlock,
     reject: RCTPromiseRejectBlock
   ) {
-    let lightPopupLoader = retrieveLightPopupLoader(requestId: requestId.intValue, adUnitId: adUnitId)
+    let requestId = Int(requestId)
+    let lightPopupLoader = retrieveLightPopupLoader(requestId: requestId, adUnitId: adUnitId)
     lightPopupLoader.loadAd()
     resolve(Void())
   }
 
-  @objc(showLightPopup::::)
+  @objc(showLightPopup:adUnitId:resolve:reject:)
   func showLightPopup(
-    _ requestId: NSNumber,
+    requestId: Double,
     adUnitId: String,
     resolve: @escaping RCTPromiseResolveBlock,
     reject: @escaping RCTPromiseRejectBlock
   ) {
-    guard let loadedAd = lightPopups[requestId.intValue]?.loadedAd else {
+    let requestId = Int(requestId)
+    guard let loadedAd = lightPopups[requestId]?.loadedAd else {
       reject("LIGHTPOPUP_NOT_LOADED", "LightPopup ad not loaded", nil)
       return
     }
-    let reqIdInt = requestId.intValue
+    let reqIdInt = requestId
     executeOnMainThread { [weak self] in
       guard let viewController = UIApplication.shared.windows.first?.rootViewController else {
         reject("VIEW_CONTROLLER_NOT_FOUND", "Root view controller not found", nil)
@@ -53,15 +56,15 @@ extension DaroMModule {
     }
   }
 
-  @objc(setLightPopupAdConfiguration:::::)
+  @objc(setLightPopupAdConfiguration:adUnitId:configuration:resolve:reject:)
     func setLightPopupAdConfiguration(
-      _ requestId: NSNumber,
+      requestId: Double,
       adUnitId: String,
       configuration: [String: Any],
       resolve: RCTPromiseResolveBlock,
       reject: RCTPromiseRejectBlock
     ) {
-      let reqIdInt = requestId.intValue
+      let reqIdInt = Int(requestId)
       guard let loadedAd = lightPopups[reqIdInt]?.loadedAd else {
         lightPopupConfigurations[reqIdInt] = configuration
         resolve(Void())

package/ios/DaroRNModule+Qa.swift

@@ -0,0 +1,158 @@
+import AppLovinSDK
+import Daro
+import Dispatch
+import GoogleMobileAds
+import React
+
+/// Ad Inspector 제시 판정 상태 — **메인 큐에서만 만진다.**
+///
+/// 값 타입 로컬을 escaping 클로저가 캡처하면 콜백 큐에 따라 읽기·쓰기가 겹칠 수 있어
+/// promise 가 두 번 settle 될 위험이 있다. 참조 타입으로 두고 접근을 메인 큐로 모은다.
+private final class DebuggerPresentation {
+  var settled = false
+}
+
+// QA 표면 — 통합 SDK 의 공개 API(mediationStatuses·mediationWeights)는 그대로 브리지하고,
+// SDK 가 갖지 않는 것(서브네트워크 인벤토리·벤더 디버거)은 네이티브 QA 앱들과 같은 축으로
+// 벤더에 직접 묻는다 (DARO-1424).
+extension DaroRNModule {
+
+  @objc(getSdkVersion:reject:)
+  func getSdkVersion(resolve: RCTPromiseResolveBlock, reject: RCTPromiseRejectBlock) {
+    // 핀(2.0.0-beta01, 8/19 빌드)에는 @_spi sdkVersion(DARO-1409, 8/21)이 없다.
+    // SPI 실린 베타로 핀이 오르면 실제 값으로 교체한다.
+    resolve(NSNull())
+  }
+
+  @objc(getMediationStatuses:reject:)
+  func getMediationStatuses(resolve: RCTPromiseResolveBlock, reject: RCTPromiseRejectBlock) {
+    resolve(
+      DaroAds.shared.mediationStatuses.map {
+        [
+          "mediationPlatform": $0.mediationPlatform,
+          "isReady": $0.isReady,
+          "hasFailed": $0.hasFailed,
+        ]
+      }
+    )
+  }
+
+  @objc(getMediationWeights:reject:)
+  func getMediationWeights(resolve: RCTPromiseResolveBlock, reject: RCTPromiseRejectBlock) {
+    if let weights = DaroAds.shared.mediationWeights {
+      // 키가 공개 어휘를 따른다 (DARO-1594). SDK 프로퍼티 이름과 같으므로 여기서
+      // 매핑하지 않는다 — 매핑을 두면 어휘가 또 바뀔 때 한쪽만 낡는다.
+      resolve(["daroa": weights.daroa, "darom": weights.darom])
+    } else {
+      resolve(NSNull())
+    }
+  }
+
+  @objc(showMediationDebuggerFor:resolve:reject:)
+  func showMediationDebuggerFor(
+    mediation: String,
+    resolve: @escaping RCTPromiseResolveBlock,
+    reject: @escaping RCTPromiseRejectBlock
+  ) {
+    DispatchQueue.main.async {
+      if mediation == "applovin" {
+        // ALSdk 초기화 뒤에 불러야 한다 — 전이면 빈 화면이 뜬다 (QA 앱 DebuggerHelper 실측).
+        ALSdk.shared().showMediationDebugger()
+        resolve(nil)
+      } else {
+        // **에러를 삼키지 않는다.** 초기화 전이거나 테스트 기기가 아니면 GMA 가 여기로
+        // 사유를 준다 — 버리면 화면에는 성공 로그만 남고 검사기는 안 뜬다.
+        //
+        // 이 콜백 하나가 두 사건을 겸한다: **실패(제시 못 함)** 와 **닫힘(정상 종료)**.
+        // 그래서 어느 쪽도 그냥 믿을 수 없다 — 콜백을 기다려 성공을 판정하면 "열렸다"가
+        // 검사기를 닫을 때까지(또는 앱을 그대로 죽이면 영영) 안 뜨고, 기다리지 않고 바로
+        // 성공 처리하면 **비동기로 오는 실패**(GMA 는 설정을 받아본 뒤에야 거절 사유를
+        // 안다)를 놓쳐 성공 로그만 남는다.
+        //
+        // 그래서 짧은 유예를 둔다. 그 안에 온 콜백은 제시 실패로 보고 reject 하고,
+        // 조용하면 떠 있는 것으로 보고 resolve 한다 — 그 뒤에 오는 콜백은 닫힘이다.
+        // **모든 판정을 메인 큐에서 한다** — 벤더가 어느 큐로 콜백하든 이중 settle 이
+        // 나지 않게(RN 은 두 번 settle 하면 예외를 던진다).
+        let state = DebuggerPresentation()
+        MobileAds.shared.presentAdInspector(from: nil) { error in
+          DispatchQueue.main.async {
+            if state.settled {
+              if let error {
+                Self.logger.error("Ad Inspector 종료 시 에러: \(error.localizedDescription)")
+              }
+              return
+            }
+            state.settled = true
+            if let error {
+              reject("AD_INSPECTOR_FAILED", error.localizedDescription, error)
+            } else {
+              // 유예 안에 에러 없이 닫혔다 — 열렸다가 곧장 닫힌 경우다.
+              resolve(nil)
+            }
+          }
+        }
+        DispatchQueue.main.asyncAfter(deadline: .now() + 1.5) {
+          guard !state.settled else { return }
+          state.settled = true
+          resolve(nil)
+        }
+      }
+    }
+  }
+
+  // 주입 결과 판독 — pod install 훅이 Info.plist 에 심은 봉투·파생값 4종을 그대로 돌려준다.
+  @objc(getIntegrationKeyInfo:reject:)
+  func getIntegrationKeyInfo(resolve: RCTPromiseResolveBlock, reject: RCTPromiseRejectBlock) {
+    let keys = [
+      "DaroIntegrationKey",
+      "DaroAppKey",
+      "GADApplicationIdentifier",
+      "DaroAppLovinSdkKey",
+      "DaroAppLovinAdReviewKey",
+    ]
+    var info: [String: Any] = [:]
+    for key in keys {
+      info[key] = Bundle.main.object(forInfoDictionaryKey: key) as? String ?? NSNull()
+    }
+    resolve(info)
+  }
+
+  @objc(getAdapterInventory:reject:)
+  func getAdapterInventory(
+    resolve: @escaping RCTPromiseResolveBlock,
+    reject: @escaping RCTPromiseRejectBlock
+  ) {
+    // **여기서 GMA 를 깨우지 않는다.** 한때 `MobileAds.start` 로 스냅샷을 받았는데, 그러면
+    // 초기화 전에 부른 호출이 GMA 를 먼저 띄워 SDK 의 초기화 순서 검증을 망가뜨린다 —
+    // 그 가드를 화면 콜백 하나에만 두면 다른 호출자(진단 스크립트·소비자)가 그냥 밟는다.
+    // `initializationStatus` 는 읽기 전용이라 부작용이 없다.
+    //
+    // **iOS 는 손 목록을 두지 않는다.** Android 는 `adapterStatusMap` 이 초기화된 것만
+    // 담아 미탑재와 구분이 안 되므로 클래스명을 나열하지만, iOS 의
+    // `adapterStatusesByClassName` 은 **링크된 어댑터를 전부** 담는다 — 손 목록은
+    // 반드시 낡는다(iOS QA 앱 `SDKInitializer.adapterInventory` 의 실측 결정과 같다).
+    // 초기화 전에는 비어 있을 수 있는데, 그건 화면이 펼 때마다 다시 읽어 메운다.
+    DispatchQueue.main.async {
+      let status = MobileAds.shared.initializationStatus
+      let admob = status.adapterStatusesByClassName
+        .sorted { $0.key < $1.key }
+        .map { key, value in
+          [
+            "name": key.replacingOccurrences(of: "GADMediationAdapter", with: ""),
+            "detail": value.state == .ready ? "READY" : value.description,
+            "isReady": value.state == .ready,
+          ]
+        }
+      let applovin = ALSdk.shared().availableMediatedNetworks
+        .sorted { $0.name < $1.name }
+        .map {
+          [
+            "name": $0.name,
+            "detail": $0.adapterVersion.isEmpty ? "미탑재" : $0.adapterVersion,
+            "isReady": !$0.adapterVersion.isEmpty,
+          ]
+        }
+      resolve(["admob": admob, "applovin": applovin])
+    }
+  }
+}