@ezoic/react-native-sdk 1.1.0 → 1.2.0

package/EzoicReactNativeSdk.podspec

@@ -20,6 +20,6 @@ Pod::Spec.new do |s|
 
   # Native Ezoic Ads SDK (vends the `EzoicAdsSDKBinary` module). Brings in
   # PrebidMobile + Google-Mobile-Ads-SDK transitively.
-  s.dependency "EzoicAdsSDK", "~> 1.1"
+  s.dependency "EzoicAdsSDK", "~> 1.2"
   s.swift_version = "5.9"
 end

package/android/build.gradle

@@ -68,5 +68,5 @@ dependencies {
   // Native Ezoic Ads SDK (resolved from Maven Central). Brings in Google Mobile
   // Ads + Prebid transitively. Requires mavenCentral() + google() in the
   // consuming app's repositories (the RN template provides both).
-  implementation "com.ezoic.sdk:ezoic-ads-sdk:1.1.0"
+  implementation "com.ezoic.sdk:ezoic-ads-sdk:1.2.0"
 }

package/android/src/main/java/com/ezoic/reactnative/EzoicAdsModule.kt

@@ -7,6 +7,9 @@ import com.facebook.react.bridge.ReactApplicationContext
 import com.facebook.react.bridge.ReadableMap
 import com.facebook.react.bridge.WritableMap
 import com.facebook.react.modules.core.DeviceEventManagerModule
+import com.ezoic.ads.sdk.adunits.EzoicInterstitialAd
+import com.ezoic.ads.sdk.adunits.EzoicInterstitialAdListener
+import com.ezoic.ads.sdk.adunits.EzoicInterstitialAdListenerAdapter
 import com.ezoic.ads.sdk.adunits.EzoicReward
 import com.ezoic.ads.sdk.adunits.EzoicRewardedAd
 import com.ezoic.ads.sdk.adunits.EzoicRewardedAdListener
@@ -32,6 +35,22 @@ class EzoicAdsModule(reactContext: ReactApplicationContext) :
     @Volatile var reward: EzoicReward? = null
   }
 
+  /** Loaded interstitial ads awaiting `show`, keyed by ad unit id. */
+  private val interstitialAds = ConcurrentHashMap<Int, EzoicInterstitialAd>()
+
+  /** In-flight interstitial `show` calls, keyed by ad unit id. */
+  private val pendingInterstitialShows = ConcurrentHashMap<Int, InterstitialShow>()
+
+  private class InterstitialShow(val promise: Promise) {
+    @Volatile var settled = false
+  }
+
+  /** Ad unit ids with an in-flight rewarded `load`. */
+  private val loadingRewarded = ConcurrentHashMap.newKeySet<Int>()
+
+  /** Ad unit ids with an in-flight interstitial `load`. */
+  private val loadingInterstitial = ConcurrentHashMap.newKeySet<Int>()
+
   override fun initialize(config: ReadableMap, promise: Promise) {
     val domain = if (config.hasKey("domain")) config.getString("domain") else null
     if (domain.isNullOrEmpty()) {
@@ -79,7 +98,12 @@ class EzoicAdsModule(reactContext: ReactApplicationContext) :
       promise.reject("EzoicAds", "Invalid adUnitIdentifier: $adUnitIdentifier")
       return
     }
+    if (rewardedAds.containsKey(id) || !loadingRewarded.add(id)) {
+      promise.reject("EzoicAds", "An ad is already loaded/loading for ad unit $adUnitIdentifier")
+      return
+    }
     EzoicRewardedAd.load(reactApplicationContext, id) { result ->
+      loadingRewarded.remove(id)
       result.onSuccess { ad ->
         ad.listener = makeListener(adUnitIdentifier)
         rewardedAds[id] = ad
@@ -97,6 +121,10 @@ class EzoicAdsModule(reactContext: ReactApplicationContext) :
       promise.reject("EzoicAds", "Rewarded ad not loaded for $adUnitIdentifier")
       return
     }
+    if (pendingShows.containsKey(id)) {
+      promise.reject("EzoicAds", "A show is already in progress for ad unit $adUnitIdentifier")
+      return
+    }
     val activity = currentActivity
     if (activity == null) {
       promise.reject("EzoicAds", "No current Activity to present the rewarded ad")
@@ -138,6 +166,75 @@ class EzoicAdsModule(reactContext: ReactApplicationContext) :
     }
   }
 
+  override fun loadInterstitialAd(adUnitIdentifier: String, promise: Promise) {
+    val id = adUnitIdentifier.toIntOrNull()
+    if (id == null) {
+      promise.reject("EzoicAds", "Invalid adUnitIdentifier: $adUnitIdentifier")
+      return
+    }
+    if (interstitialAds.containsKey(id) || !loadingInterstitial.add(id)) {
+      promise.reject("EzoicAds", "An ad is already loaded/loading for ad unit $adUnitIdentifier")
+      return
+    }
+    EzoicInterstitialAd.load(reactApplicationContext, id) { result ->
+      loadingInterstitial.remove(id)
+      result.onSuccess { ad ->
+        ad.listener = makeInterstitialListener(adUnitIdentifier)
+        interstitialAds[id] = ad
+        promise.resolve(null)
+      }.onFailure { e ->
+        promise.reject("EzoicAds", e.message ?: "Interstitial ad failed to load", e)
+      }
+    }
+  }
+
+  override fun showInterstitialAd(adUnitIdentifier: String, promise: Promise) {
+    val id = adUnitIdentifier.toIntOrNull()
+    val ad = if (id != null) interstitialAds[id] else null
+    if (id == null || ad == null) {
+      promise.reject("EzoicAds", "Interstitial ad not loaded for $adUnitIdentifier")
+      return
+    }
+    if (pendingInterstitialShows.containsKey(id)) {
+      promise.reject("EzoicAds", "A show is already in progress for ad unit $adUnitIdentifier")
+      return
+    }
+    val activity = currentActivity
+    if (activity == null) {
+      promise.reject("EzoicAds", "No current Activity to present the interstitial ad")
+      return
+    }
+
+    pendingInterstitialShows[id] = InterstitialShow(promise)
+
+    // Native show(activity) has no completion lambda, so replace the load-time
+    // listener with one that settles the promise on terminal events
+    // (dismiss = resolve, failed-to-show = reject).
+    ad.listener = makeInterstitialListener(
+      adUnitIdentifier,
+      onDismiss = {
+        interstitialAds.remove(id)
+        val pending = pendingInterstitialShows.remove(id)
+        if (pending != null && !pending.settled) {
+          pending.settled = true
+          pending.promise.resolve(null)
+        }
+      },
+      onFailedToShow = { message ->
+        interstitialAds.remove(id)
+        val pending = pendingInterstitialShows.remove(id)
+        if (pending != null && !pending.settled) {
+          pending.settled = true
+          pending.promise.reject("EzoicAds", message)
+        }
+      }
+    )
+
+    activity.runOnUiThread {
+      ad.show(activity)
+    }
+  }
+
   override fun addListener(eventName: String) {
     // No-op: required by the React Native NativeEventEmitter contract.
   }
@@ -158,6 +255,7 @@ class EzoicAdsModule(reactContext: ReactApplicationContext) :
     override fun onRewardedAdFailedToShow(rewardedAd: EzoicRewardedAd, error: EzoicError) {
       emitRewardedEvent(adUnitIdentifier, "failedToShow") {
         putString("message", error.message)
+        putInt("code", error.code)
       }
       onFailedToShow?.invoke(error.message)
     }
@@ -197,11 +295,57 @@ class EzoicAdsModule(reactContext: ReactApplicationContext) :
       .emit(REWARDED_EVENT, map)
   }
 
+  private fun makeInterstitialListener(
+    adUnitIdentifier: String,
+    onDismiss: (() -> Unit)? = null,
+    onFailedToShow: ((String) -> Unit)? = null
+  ): EzoicInterstitialAdListener = object : EzoicInterstitialAdListenerAdapter() {
+    override fun onInterstitialAdShown(interstitialAd: EzoicInterstitialAd) {
+      emitInterstitialEvent(adUnitIdentifier, "shown")
+    }
+
+    override fun onInterstitialAdFailedToShow(interstitialAd: EzoicInterstitialAd, error: EzoicError) {
+      emitInterstitialEvent(adUnitIdentifier, "failedToShow") {
+        putString("message", error.message)
+        putInt("code", error.code)
+      }
+      onFailedToShow?.invoke(error.message)
+    }
+
+    override fun onInterstitialAdImpression(interstitialAd: EzoicInterstitialAd) {
+      emitInterstitialEvent(adUnitIdentifier, "impression")
+    }
+
+    override fun onInterstitialAdClicked(interstitialAd: EzoicInterstitialAd) {
+      emitInterstitialEvent(adUnitIdentifier, "clicked")
+    }
+
+    override fun onInterstitialAdDismissed(interstitialAd: EzoicInterstitialAd) {
+      emitInterstitialEvent(adUnitIdentifier, "dismissed")
+      onDismiss?.invoke()
+    }
+  }
+
+  private fun emitInterstitialEvent(
+    adUnitIdentifier: String,
+    type: String,
+    extra: (WritableMap.() -> Unit)? = null
+  ) {
+    val map = Arguments.createMap()
+    map.putString("adUnitIdentifier", adUnitIdentifier)
+    map.putString("type", type)
+    extra?.invoke(map)
+    reactApplicationContext
+      .getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter::class.java)
+      .emit(INTERSTITIAL_EVENT, map)
+  }
+
   private fun ReadableMap.optBool(key: String, default: Boolean): Boolean =
     if (hasKey(key) && !isNull(key)) getBoolean(key) else default
 
   companion object {
     const val NAME = NativeEzoicAdsSpec.NAME
     private const val REWARDED_EVENT = "EzoicRewardedAdEvent"
+    private const val INTERSTITIAL_EVENT = "EzoicInterstitialAdEvent"
   }
 }

package/ios/EzoicAdsImpl.swift

@@ -22,65 +22,118 @@ import EzoicAdsSDKBinary
     }
   }
 
+  /// Loaded interstitial ads awaiting `show`, keyed by ad unit id.
+  private var interstitialAds: [Int: EzoicInterstitialAd] = [:]
+
+  /// In-flight interstitial `show` calls, keyed by ad unit id.
+  private var pendingInterstitialShows: [Int: PendingInterstitialShow] = [:]
+
+  private final class PendingInterstitialShow {
+    let resolve: (Any?) -> Void
+    let reject: (String, String, NSError?) -> Void
+    init(resolve: @escaping (Any?) -> Void, reject: @escaping (String, String, NSError?) -> Void) {
+      self.resolve = resolve
+      self.reject = reject
+    }
+  }
+
+  /// Ad unit ids with an in-flight rewarded `load`.
+  private var loadingRewarded: Set<Int> = []
+
+  /// Ad unit ids with an in-flight interstitial `load`.
+  private var loadingInterstitial: Set<Int> = []
+
+  /// Runs `work` on the main thread. The ad/pending/loading dictionaries and
+  /// every native load/show call touch UIKit and this shared state, so they must
+  /// only run on main. Delegate callbacks already arrive on main.
+  private func onMain(_ work: @escaping () -> Void) {
+    if Thread.isMainThread {
+      work()
+    } else {
+      DispatchQueue.main.async(execute: work)
+    }
+  }
+
   @objc public func initialize(_ config: NSDictionary,
                                resolve: @escaping (Any?) -> Void,
                                reject: @escaping (String, String, NSError?) -> Void) {
-    guard let domain = config["domain"] as? String, !domain.isEmpty else {
-      reject("EzoicAds", "initialize requires a non-empty `domain`.", nil)
-      return
-    }
-    let configuration = EzoicConfiguration(
-      domain: domain,
-      autoReadConsent: (config["autoReadConsent"] as? Bool) ?? true,
-      subjectToCOPPA: (config["subjectToCOPPA"] as? Bool) ?? false,
-      requestATTBeforeAds: (config["requestATTBeforeAds"] as? Bool) ?? true,
-      debugEnabled: (config["debugEnabled"] as? Bool) ?? false,
-      testMode: (config["testMode"] as? Bool) ?? false
-    )
-    EzoicAds.shared.initialize(with: configuration) { result in
-      switch result {
-      case .success:
-        resolve(nil)
-      case .failure(let error):
-        reject("EzoicAds", error.localizedDescription, error as NSError)
+    onMain {
+      guard let domain = config["domain"] as? String, !domain.isEmpty else {
+        reject("EzoicAds", "initialize requires a non-empty `domain`.", nil)
+        return
+      }
+      let configuration = EzoicConfiguration(
+        domain: domain,
+        autoReadConsent: (config["autoReadConsent"] as? Bool) ?? true,
+        subjectToCOPPA: (config["subjectToCOPPA"] as? Bool) ?? false,
+        requestATTBeforeAds: (config["requestATTBeforeAds"] as? Bool) ?? true,
+        debugEnabled: (config["debugEnabled"] as? Bool) ?? false,
+        testMode: (config["testMode"] as? Bool) ?? false
+      )
+      EzoicAds.shared.initialize(with: configuration) { result in
+        switch result {
+        case .success:
+          resolve(nil)
+        case .failure(let error):
+          reject("EzoicAds", error.localizedDescription, error as NSError)
+        }
       }
     }
   }
 
   @objc public func setGDPRConsent(_ applies: Bool, consentString: String?) {
-    EzoicAds.shared.setGDPRConsent(applies: applies, consentString: consentString)
+    onMain {
+      EzoicAds.shared.setGDPRConsent(applies: applies, consentString: consentString)
+    }
   }
 
   @objc public func setGPPConsent(_ gppString: String?, sectionIds: String?) {
-    EzoicAds.shared.setGPPConsent(gppString: gppString, sectionIds: sectionIds)
+    onMain {
+      EzoicAds.shared.setGPPConsent(gppString: gppString, sectionIds: sectionIds)
+    }
   }
 
   @objc public func setSubjectToCOPPA(_ value: Bool) {
-    EzoicAds.shared.setSubjectToCOPPA(value)
+    onMain {
+      EzoicAds.shared.setSubjectToCOPPA(value)
+    }
   }
 
   @objc public func trackPageview(_ resolve: @escaping (Any?) -> Void) {
-    EzoicAds.shared.trackPageview { success in
-      resolve(NSNumber(value: success))
+    onMain {
+      EzoicAds.shared.trackPageview { success in
+        resolve(NSNumber(value: success))
+      }
     }
   }
 
   @objc public func loadRewardedAd(_ adUnitIdentifier: String,
                                    resolve: @escaping (Any?) -> Void,
                                    reject: @escaping (String, String, NSError?) -> Void) {
-    guard let id = Int(adUnitIdentifier) else {
-      reject("EzoicAds", "Invalid adUnitIdentifier: \(adUnitIdentifier)", nil)
-      return
-    }
-    EzoicRewardedAd.load(adUnitIdentifier: id) { [weak self] result in
+    onMain { [weak self] in
       guard let self = self else { return }
-      switch result {
-      case .success(let ad):
-        ad.delegate = self
-        self.rewardedAds[id] = ad
-        resolve(nil)
-      case .failure(let error):
-        reject("EzoicAds", error.localizedDescription, error as NSError)
+      guard let id = Int(adUnitIdentifier) else {
+        reject("EzoicAds", "Invalid adUnitIdentifier: \(adUnitIdentifier)", nil)
+        return
+      }
+      if self.rewardedAds[id] != nil || self.loadingRewarded.contains(id) {
+        reject("EzoicAds", "An ad is already loaded/loading for ad unit \(adUnitIdentifier)", nil)
+        return
+      }
+      self.loadingRewarded.insert(id)
+      EzoicRewardedAd.load(adUnitIdentifier: id) { [weak self] result in
+        guard let self = self else { return }
+        self.onMain {
+          self.loadingRewarded.remove(id)
+          switch result {
+          case .success(let ad):
+            ad.delegate = self
+            self.rewardedAds[id] = ad
+            resolve(nil)
+          case .failure(let error):
+            reject("EzoicAds", error.localizedDescription, error as NSError)
+          }
+        }
       }
     }
   }
@@ -88,14 +141,21 @@ import EzoicAdsSDKBinary
   @objc public func showRewardedAd(_ adUnitIdentifier: String,
                                    resolve: @escaping (Any?) -> Void,
                                    reject: @escaping (String, String, NSError?) -> Void) {
-    guard let id = Int(adUnitIdentifier), let ad = rewardedAds[id] else {
-      reject("EzoicAds", "Rewarded ad not loaded for \(adUnitIdentifier)", nil)
-      return
-    }
-    pendingShows[id] = PendingRewardShow(resolve: resolve, reject: reject)
-    // Presenting from nil lets GMA use the application's top view controller.
-    ad.show(from: nil) { [weak self] reward in
-      self?.pendingShows[id]?.reward = reward
+    onMain { [weak self] in
+      guard let self = self else { return }
+      guard let id = Int(adUnitIdentifier), let ad = self.rewardedAds[id] else {
+        reject("EzoicAds", "Rewarded ad not loaded for \(adUnitIdentifier)", nil)
+        return
+      }
+      if self.pendingShows[id] != nil {
+        reject("EzoicAds", "A show is already in progress for ad unit \(adUnitIdentifier)", nil)
+        return
+      }
+      self.pendingShows[id] = PendingRewardShow(resolve: resolve, reject: reject)
+      // Presenting from nil lets GMA use the application's top view controller.
+      ad.show(from: nil) { [weak self] reward in
+        self?.onMain { self?.pendingShows[id]?.reward = reward }
+      }
     }
   }
 
@@ -107,6 +167,67 @@ import EzoicAdsSDKBinary
     for (key, value) in extra { body[key] = value }
     eventEmitter?("EzoicRewardedAdEvent", body)
   }
+
+  @objc public func loadInterstitialAd(_ adUnitIdentifier: String,
+                                       resolve: @escaping (Any?) -> Void,
+                                       reject: @escaping (String, String, NSError?) -> Void) {
+    onMain { [weak self] in
+      guard let self = self else { return }
+      guard let id = Int(adUnitIdentifier) else {
+        reject("EzoicAds", "Invalid adUnitIdentifier: \(adUnitIdentifier)", nil)
+        return
+      }
+      if self.interstitialAds[id] != nil || self.loadingInterstitial.contains(id) {
+        reject("EzoicAds", "An ad is already loaded/loading for ad unit \(adUnitIdentifier)", nil)
+        return
+      }
+      self.loadingInterstitial.insert(id)
+      EzoicInterstitialAd.load(adUnitIdentifier: id) { [weak self] result in
+        guard let self = self else { return }
+        self.onMain {
+          self.loadingInterstitial.remove(id)
+          switch result {
+          case .success(let ad):
+            ad.delegate = self
+            self.interstitialAds[id] = ad
+            resolve(nil)
+          case .failure(let error):
+            reject("EzoicAds", error.localizedDescription, error as NSError)
+          }
+        }
+      }
+    }
+  }
+
+  @objc public func showInterstitialAd(_ adUnitIdentifier: String,
+                                       resolve: @escaping (Any?) -> Void,
+                                       reject: @escaping (String, String, NSError?) -> Void) {
+    onMain { [weak self] in
+      guard let self = self else { return }
+      guard let id = Int(adUnitIdentifier), let ad = self.interstitialAds[id] else {
+        reject("EzoicAds", "Interstitial ad not loaded for \(adUnitIdentifier)", nil)
+        return
+      }
+      if self.pendingInterstitialShows[id] != nil {
+        reject("EzoicAds", "A show is already in progress for ad unit \(adUnitIdentifier)", nil)
+        return
+      }
+      self.pendingInterstitialShows[id] = PendingInterstitialShow(resolve: resolve, reject: reject)
+      // Native show(from:) has no completion handler, so the show promise is
+      // settled from the delegate (dismiss = resolve, failed-to-present = reject).
+      // Presenting from nil lets GMA use the application's top view controller.
+      ad.show(from: nil)
+    }
+  }
+
+  private func emitInterstitial(_ ad: EzoicInterstitialAd, _ type: String, _ extra: [String: Any] = [:]) {
+    var body: [String: Any] = [
+      "adUnitIdentifier": String(ad.adUnitIdentifier),
+      "type": type
+    ]
+    for (key, value) in extra { body[key] = value }
+    eventEmitter?("EzoicInterstitialAdEvent", body)
+  }
 }
 
 // MARK: - EzoicRewardedAdDelegate
@@ -118,7 +239,7 @@ extension EzoicAdsImpl: EzoicRewardedAdDelegate {
   }
 
   public func rewardedAd(_ rewardedAd: EzoicRewardedAd, didFailToPresentWithError error: EzoicError) {
-    emit(rewardedAd, "failedToShow", ["message": error.localizedDescription])
+    emit(rewardedAd, "failedToShow", ["message": error.localizedDescription, "code": error.code])
     let id = rewardedAd.adUnitIdentifier
     rewardedAds.removeValue(forKey: id)
     if let pending = pendingShows.removeValue(forKey: id) {
@@ -154,3 +275,38 @@ extension EzoicAdsImpl: EzoicRewardedAdDelegate {
     }
   }
 }
+
+// MARK: - EzoicInterstitialAdDelegate
+
+extension EzoicAdsImpl: EzoicInterstitialAdDelegate {
+
+  public func interstitialAdDidPresent(_ interstitialAd: EzoicInterstitialAd) {
+    emitInterstitial(interstitialAd, "shown")
+  }
+
+  public func interstitialAd(_ interstitialAd: EzoicInterstitialAd, didFailToPresentWithError error: EzoicError) {
+    emitInterstitial(interstitialAd, "failedToShow", ["message": error.localizedDescription, "code": error.code])
+    let id = interstitialAd.adUnitIdentifier
+    interstitialAds.removeValue(forKey: id)
+    if let pending = pendingInterstitialShows.removeValue(forKey: id) {
+      pending.reject("EzoicAds", error.localizedDescription, error as NSError)
+    }
+  }
+
+  public func interstitialAdDidRecordImpression(_ interstitialAd: EzoicInterstitialAd) {
+    emitInterstitial(interstitialAd, "impression")
+  }
+
+  public func interstitialAdDidRecordClick(_ interstitialAd: EzoicInterstitialAd) {
+    emitInterstitial(interstitialAd, "clicked")
+  }
+
+  public func interstitialAdDidDismiss(_ interstitialAd: EzoicInterstitialAd) {
+    emitInterstitial(interstitialAd, "dismissed")
+    let id = interstitialAd.adUnitIdentifier
+    interstitialAds.removeValue(forKey: id)
+    if let pending = pendingInterstitialShows.removeValue(forKey: id) {
+      pending.resolve(nil)
+    }
+  }
+}

package/ios/EzoicReactNativeSdk.mm

@@ -2,6 +2,7 @@
 #import <EzoicReactNativeSdk/EzoicReactNativeSdk-Swift.h>
 
 static NSString *const kEzoicRewardedEvent = @"EzoicRewardedAdEvent";
+static NSString *const kEzoicInterstitialEvent = @"EzoicInterstitialAdEvent";
 
 @implementation EzoicReactNativeSdk {
   EzoicAdsImpl *_impl;
@@ -30,7 +31,7 @@ static NSString *const kEzoicRewardedEvent = @"EzoicRewardedAdEvent";
 }
 
 - (NSArray<NSString *> *)supportedEvents {
-  return @[ kEzoicRewardedEvent ];
+  return @[ kEzoicRewardedEvent, kEzoicInterstitialEvent ];
 }
 
 - (void)startObserving {
@@ -88,6 +89,22 @@ static NSString *const kEzoicRewardedEvent = @"EzoicRewardedAdEvent";
                  reject:^(NSString *code, NSString *msg, NSError *_Nullable e) { reject(code, msg, e); }];
 }
 
+- (void)loadInterstitialAd:(NSString *)adUnitIdentifier
+                   resolve:(RCTPromiseResolveBlock)resolve
+                    reject:(RCTPromiseRejectBlock)reject {
+  [_impl loadInterstitialAd:adUnitIdentifier
+                    resolve:^(id _Nullable v) { resolve(v); }
+                     reject:^(NSString *code, NSString *msg, NSError *_Nullable e) { reject(code, msg, e); }];
+}
+
+- (void)showInterstitialAd:(NSString *)adUnitIdentifier
+                   resolve:(RCTPromiseResolveBlock)resolve
+                    reject:(RCTPromiseRejectBlock)reject {
+  [_impl showInterstitialAd:adUnitIdentifier
+                    resolve:^(id _Nullable v) { resolve(v); }
+                     reject:^(NSString *code, NSString *msg, NSError *_Nullable e) { reject(code, msg, e); }];
+}
+
 - (std::shared_ptr<facebook::react::TurboModule>)getTurboModule:
     (const facebook::react::ObjCTurboModule::InitParams &)params {
   return std::make_shared<facebook::react::NativeEzoicAdsSpecJSI>(params);

package/lib/module/EzoicInterstitialAd.js

@@ -0,0 +1,108 @@
+"use strict";
+
+import { NativeEventEmitter } from 'react-native';
+import NativeEzoicAds from "./NativeEzoicAds.js";
+import { coerceAdUnitId } from "./helpers.js";
+
+/** Lifecycle callbacks for an interstitial ad. All are optional. */
+
+/** The single native event name carrying every interstitial lifecycle signal. */
+const INTERSTITIAL_EVENT = 'EzoicInterstitialAdEvent';
+// A single shared emitter is sufficient — events are routed to the right
+// instance by adUnitIdentifier below.
+const emitter = new NativeEventEmitter(NativeEzoicAds);
+
+/**
+ * An interstitial ad. Use the static `load` to fetch an ad ahead of time, then
+ * call `show()` to present it full-screen at a natural transition point.
+ * Interstitials carry no reward.
+ *
+ * ```ts
+ * const ad = await EzoicInterstitialAd.load('12345');
+ * ad.setListeners({ onDismissed: () => console.log('closed') });
+ * await ad.show();
+ * ```
+ *
+ * Mirrors the native `EzoicInterstitialAd` load/show lifecycle on both
+ * platforms. Interstitial ads are single-use — load a new one for the next
+ * opportunity.
+ */
+export class EzoicInterstitialAd {
+  /** The Ezoic ad unit identifier this ad was loaded for. */
+
+  listeners = {};
+  subscription = null;
+  constructor(adUnitIdentifier) {
+    this.adUnitIdentifier = adUnitIdentifier;
+    this.subscription = emitter.addListener(INTERSTITIAL_EVENT, raw => {
+      const event = raw;
+      if (event.adUnitIdentifier !== this.adUnitIdentifier) return;
+      this.handleEvent(event);
+    });
+  }
+
+  /**
+   * Loads an interstitial ad for the given Ezoic ad unit identifier. Resolves
+   * with a ready-to-show `EzoicInterstitialAd`, or rejects if no ad could be
+   * loaded.
+   */
+  static async load(adUnitIdentifier) {
+    const id = coerceAdUnitId(adUnitIdentifier);
+    const ad = new EzoicInterstitialAd(id);
+    try {
+      await NativeEzoicAds.loadInterstitialAd(id);
+      return ad;
+    } catch (error) {
+      ad.destroy();
+      throw error;
+    }
+  }
+
+  /** Registers lifecycle callbacks. Replaces any previously set listeners. */
+  setListeners(listeners) {
+    this.listeners = listeners;
+  }
+
+  /**
+   * Presents the interstitial ad full-screen. Resolves when the ad is
+   * dismissed. Rejects if the ad was not ready (load first) or failed to
+   * present.
+   */
+  async show() {
+    await NativeEzoicAds.showInterstitialAd(this.adUnitIdentifier);
+  }
+
+  /** Releases the event subscription. Safe to call multiple times. */
+  destroy() {
+    this.subscription?.remove();
+    this.subscription = null;
+    this.listeners = {};
+  }
+  handleEvent(event) {
+    switch (event.type) {
+      case 'shown':
+        this.listeners.onShown?.();
+        break;
+      case 'failedToShow':
+        this.listeners.onFailedToShow?.({
+          message: event.message ?? '',
+          code: event.code
+        });
+        // Failure to show is terminal — the native ad is single-use.
+        this.destroy();
+        break;
+      case 'impression':
+        this.listeners.onImpression?.();
+        break;
+      case 'clicked':
+        this.listeners.onClicked?.();
+        break;
+      case 'dismissed':
+        this.listeners.onDismissed?.();
+        // Dismissal is terminal — the native ad is single-use.
+        this.destroy();
+        break;
+    }
+  }
+}
+//# sourceMappingURL=EzoicInterstitialAd.js.map

package/lib/module/EzoicInterstitialAd.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["NativeEventEmitter","NativeEzoicAds","coerceAdUnitId","INTERSTITIAL_EVENT","emitter","EzoicInterstitialAd","listeners","subscription","constructor","adUnitIdentifier","addListener","raw","event","handleEvent","load","id","ad","loadInterstitialAd","error","destroy","setListeners","show","showInterstitialAd","remove","type","onShown","onFailedToShow","message","code","onImpression","onClicked","onDismissed"],"sourceRoot":"../../src","sources":["EzoicInterstitialAd.ts"],"mappings":";;AAAA,SAASA,kBAAkB,QAAkC,cAAc;AAC3E,OAAOC,cAAc,MAAM,qBAAkB;AAC7C,SAASC,cAAc,QAAQ,cAAW;;AAE1C;;AASA;AACA,MAAMC,kBAAkB,GAAG,0BAA0B;AASrD;AACA;AACA,MAAMC,OAAO,GAAG,IAAIJ,kBAAkB,CAACC,cAAuB,CAAC;;AAE/D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMI,mBAAmB,CAAC;EAC/B;;EAGQC,SAAS,GAAiC,CAAC,CAAC;EAC5CC,YAAY,GAA+B,IAAI;EAE/CC,WAAWA,CAACC,gBAAwB,EAAE;IAC5C,IAAI,CAACA,gBAAgB,GAAGA,gBAAgB;IACxC,IAAI,CAACF,YAAY,GAAGH,OAAO,CAACM,WAAW,CACrCP,kBAAkB,EACjBQ,GAAY,IAAK;MAChB,MAAMC,KAAK,GAAGD,GAA8B;MAC5C,IAAIC,KAAK,CAACH,gBAAgB,KAAK,IAAI,CAACA,gBAAgB,EAAE;MACtD,IAAI,CAACI,WAAW,CAACD,KAAK,CAAC;IACzB,CACF,CAAC;EACH;;EAEA;AACF;AACA;AACA;AACA;EACE,aAAaE,IAAIA,CAACL,gBAAwB,EAAgC;IACxE,MAAMM,EAAE,GAAGb,cAAc,CAACO,gBAAgB,CAAC;IAC3C,MAAMO,EAAE,GAAG,IAAIX,mBAAmB,CAACU,EAAE,CAAC;IACtC,IAAI;MACF,MAAMd,cAAc,CAACgB,kBAAkB,CAACF,EAAE,CAAC;MAC3C,OAAOC,EAAE;IACX,CAAC,CAAC,OAAOE,KAAK,EAAE;MACdF,EAAE,CAACG,OAAO,CAAC,CAAC;MACZ,MAAMD,KAAK;IACb;EACF;;EAEA;EACAE,YAAYA,CAACd,SAAuC,EAAQ;IAC1D,IAAI,CAACA,SAAS,GAAGA,SAAS;EAC5B;;EAEA;AACF;AACA;AACA;AACA;EACE,MAAMe,IAAIA,CAAA,EAAkB;IAC1B,MAAMpB,cAAc,CAACqB,kBAAkB,CAAC,IAAI,CAACb,gBAAgB,CAAC;EAChE;;EAEA;EACAU,OAAOA,CAAA,EAAS;IACd,IAAI,CAACZ,YAAY,EAAEgB,MAAM,CAAC,CAAC;IAC3B,IAAI,CAAChB,YAAY,GAAG,IAAI;IACxB,IAAI,CAACD,SAAS,GAAG,CAAC,CAAC;EACrB;EAEQO,WAAWA,CAACD,KAA8B,EAAQ;IACxD,QAAQA,KAAK,CAACY,IAAI;MAChB,KAAK,OAAO;QACV,IAAI,CAAClB,SAAS,CAACmB,OAAO,GAAG,CAAC;QAC1B;MACF,KAAK,cAAc;QACjB,IAAI,CAACnB,SAAS,CAACoB,cAAc,GAAG;UAC9BC,OAAO,EAAEf,KAAK,CAACe,OAAO,IAAI,EAAE;UAC5BC,IAAI,EAAEhB,KAAK,CAACgB;QACd,CAAC,CAAC;QACF;QACA,IAAI,CAACT,OAAO,CAAC,CAAC;QACd;MACF,KAAK,YAAY;QACf,IAAI,CAACb,SAAS,CAACuB,YAAY,GAAG,CAAC;QAC/B;MACF,KAAK,SAAS;QACZ,IAAI,CAACvB,SAAS,CAACwB,SAAS,GAAG,CAAC;QAC5B;MACF,KAAK,WAAW;QACd,IAAI,CAACxB,SAAS,CAACyB,WAAW,GAAG,CAAC;QAC9B;QACA,IAAI,CAACZ,OAAO,CAAC,CAAC;QACd;IACJ;EACF;AACF","ignoreList":[]}

package/lib/module/EzoicRewardedAd.js

@@ -86,8 +86,11 @@ export class EzoicRewardedAd {
         break;
       case 'failedToShow':
         this.listeners.onFailedToShow?.({
-          message: event.message ?? ''
+          message: event.message ?? '',
+          code: event.code
         });
+        // Failure to show is terminal — the native ad is single-use.
+        this.destroy();
         break;
       case 'impression':
         this.listeners.onImpression?.();

package/lib/module/EzoicRewardedAd.js.map

@@ -1 +1 @@
-{"version":3,"names":["NativeEventEmitter","NativeEzoicAds","coerceAdUnitId","mapRewardResult","REWARDED_EVENT","emitter","EzoicRewardedAd","listeners","subscription","constructor","adUnitIdentifier","addListener","raw","event","handleEvent","load","id","ad","loadRewardedAd","error","destroy","setListeners","show","result","showRewardedAd","remove","type","onShown","onFailedToShow","message","onImpression","onClicked","onUserEarnedReward","rewardType","amount","rewardAmount","onDismissed"],"sourceRoot":"../../src","sources":["EzoicRewardedAd.ts"],"mappings":";;AAAA,SAASA,kBAAkB,QAAkC,cAAc;AAC3E,OAAOC,cAAc,MAAM,qBAAkB;AAC7C,SAASC,cAAc,EAAEC,eAAe,QAAQ,cAAW;;AAE3D;;AAMA;;AAUA;AACA,MAAMC,cAAc,GAAG,sBAAsB;AAgB7C;AACA;AACA,MAAMC,OAAO,GAAG,IAAIL,kBAAkB,CAACC,cAAuB,CAAC;;AAE/D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMK,eAAe,CAAC;EAC3B;;EAGQC,SAAS,GAA6B,CAAC,CAAC;EACxCC,YAAY,GAA+B,IAAI;EAE/CC,WAAWA,CAACC,gBAAwB,EAAE;IAC5C,IAAI,CAACA,gBAAgB,GAAGA,gBAAgB;IACxC,IAAI,CAACF,YAAY,GAAGH,OAAO,CAACM,WAAW,CAACP,cAAc,EAAGQ,GAAY,IAAK;MACxE,MAAMC,KAAK,GAAGD,GAA0B;MACxC,IAAIC,KAAK,CAACH,gBAAgB,KAAK,IAAI,CAACA,gBAAgB,EAAE;MACtD,IAAI,CAACI,WAAW,CAACD,KAAK,CAAC;IACzB,CAAC,CAAC;EACJ;;EAEA;AACF;AACA;AACA;EACE,aAAaE,IAAIA,CAACL,gBAAwB,EAA4B;IACpE,MAAMM,EAAE,GAAGd,cAAc,CAACQ,gBAAgB,CAAC;IAC3C,MAAMO,EAAE,GAAG,IAAIX,eAAe,CAACU,EAAE,CAAC;IAClC,IAAI;MACF,MAAMf,cAAc,CAACiB,cAAc,CAACF,EAAE,CAAC;MACvC,OAAOC,EAAE;IACX,CAAC,CAAC,OAAOE,KAAK,EAAE;MACdF,EAAE,CAACG,OAAO,CAAC,CAAC;MACZ,MAAMD,KAAK;IACb;EACF;;EAEA;EACAE,YAAYA,CAACd,SAAmC,EAAQ;IACtD,IAAI,CAACA,SAAS,GAAGA,SAAS;EAC5B;;EAEA;AACF;AACA;AACA;AACA;EACE,MAAMe,IAAIA,CAAA,EAAgC;IACxC,MAAMC,MAAM,GAAG,MAAMtB,cAAc,CAACuB,cAAc,CAAC,IAAI,CAACd,gBAAgB,CAAC;IACzE,OAAOP,eAAe,CAACoB,MAAM,CAAC;EAChC;;EAEA;EACAH,OAAOA,CAAA,EAAS;IACd,IAAI,CAACZ,YAAY,EAAEiB,MAAM,CAAC,CAAC;IAC3B,IAAI,CAACjB,YAAY,GAAG,IAAI;IACxB,IAAI,CAACD,SAAS,GAAG,CAAC,CAAC;EACrB;EAEQO,WAAWA,CAACD,KAA0B,EAAQ;IACpD,QAAQA,KAAK,CAACa,IAAI;MAChB,KAAK,OAAO;QACV,IAAI,CAACnB,SAAS,CAACoB,OAAO,GAAG,CAAC;QAC1B;MACF,KAAK,cAAc;QACjB,IAAI,CAACpB,SAAS,CAACqB,cAAc,GAAG;UAAEC,OAAO,EAAEhB,KAAK,CAACgB,OAAO,IAAI;QAAG,CAAC,CAAC;QACjE;MACF,KAAK,YAAY;QACf,IAAI,CAACtB,SAAS,CAACuB,YAAY,GAAG,CAAC;QAC/B;MACF,KAAK,SAAS;QACZ,IAAI,CAACvB,SAAS,CAACwB,SAAS,GAAG,CAAC;QAC5B;MACF,KAAK,QAAQ;QACX,IAAI,CAACxB,SAAS,CAACyB,kBAAkB,GAAG;UAClCN,IAAI,EAAEb,KAAK,CAACoB,UAAU,IAAI,EAAE;UAC5BC,MAAM,EAAErB,KAAK,CAACsB,YAAY,IAAI;QAChC,CAAC,CAAC;QACF;MACF,KAAK,WAAW;QACd,IAAI,CAAC5B,SAAS,CAAC6B,WAAW,GAAG,CAAC;QAC9B;QACA,IAAI,CAAChB,OAAO,CAAC,CAAC;QACd;IACJ;EACF;AACF","ignoreList":[]}
+{"version":3,"names":["NativeEventEmitter","NativeEzoicAds","coerceAdUnitId","mapRewardResult","REWARDED_EVENT","emitter","EzoicRewardedAd","listeners","subscription","constructor","adUnitIdentifier","addListener","raw","event","handleEvent","load","id","ad","loadRewardedAd","error","destroy","setListeners","show","result","showRewardedAd","remove","type","onShown","onFailedToShow","message","code","onImpression","onClicked","onUserEarnedReward","rewardType","amount","rewardAmount","onDismissed"],"sourceRoot":"../../src","sources":["EzoicRewardedAd.ts"],"mappings":";;AAAA,SAASA,kBAAkB,QAAkC,cAAc;AAC3E,OAAOC,cAAc,MAAM,qBAAkB;AAC7C,SAASC,cAAc,EAAEC,eAAe,QAAQ,cAAW;;AAE3D;;AAMA;;AAUA;AACA,MAAMC,cAAc,GAAG,sBAAsB;AAiB7C;AACA;AACA,MAAMC,OAAO,GAAG,IAAIL,kBAAkB,CAACC,cAAuB,CAAC;;AAE/D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMK,eAAe,CAAC;EAC3B;;EAGQC,SAAS,GAA6B,CAAC,CAAC;EACxCC,YAAY,GAA+B,IAAI;EAE/CC,WAAWA,CAACC,gBAAwB,EAAE;IAC5C,IAAI,CAACA,gBAAgB,GAAGA,gBAAgB;IACxC,IAAI,CAACF,YAAY,GAAGH,OAAO,CAACM,WAAW,CAACP,cAAc,EAAGQ,GAAY,IAAK;MACxE,MAAMC,KAAK,GAAGD,GAA0B;MACxC,IAAIC,KAAK,CAACH,gBAAgB,KAAK,IAAI,CAACA,gBAAgB,EAAE;MACtD,IAAI,CAACI,WAAW,CAACD,KAAK,CAAC;IACzB,CAAC,CAAC;EACJ;;EAEA;AACF;AACA;AACA;EACE,aAAaE,IAAIA,CAACL,gBAAwB,EAA4B;IACpE,MAAMM,EAAE,GAAGd,cAAc,CAACQ,gBAAgB,CAAC;IAC3C,MAAMO,EAAE,GAAG,IAAIX,eAAe,CAACU,EAAE,CAAC;IAClC,IAAI;MACF,MAAMf,cAAc,CAACiB,cAAc,CAACF,EAAE,CAAC;MACvC,OAAOC,EAAE;IACX,CAAC,CAAC,OAAOE,KAAK,EAAE;MACdF,EAAE,CAACG,OAAO,CAAC,CAAC;MACZ,MAAMD,KAAK;IACb;EACF;;EAEA;EACAE,YAAYA,CAACd,SAAmC,EAAQ;IACtD,IAAI,CAACA,SAAS,GAAGA,SAAS;EAC5B;;EAEA;AACF;AACA;AACA;AACA;EACE,MAAMe,IAAIA,CAAA,EAAgC;IACxC,MAAMC,MAAM,GAAG,MAAMtB,cAAc,CAACuB,cAAc,CAAC,IAAI,CAACd,gBAAgB,CAAC;IACzE,OAAOP,eAAe,CAACoB,MAAM,CAAC;EAChC;;EAEA;EACAH,OAAOA,CAAA,EAAS;IACd,IAAI,CAACZ,YAAY,EAAEiB,MAAM,CAAC,CAAC;IAC3B,IAAI,CAACjB,YAAY,GAAG,IAAI;IACxB,IAAI,CAACD,SAAS,GAAG,CAAC,CAAC;EACrB;EAEQO,WAAWA,CAACD,KAA0B,EAAQ;IACpD,QAAQA,KAAK,CAACa,IAAI;MAChB,KAAK,OAAO;QACV,IAAI,CAACnB,SAAS,CAACoB,OAAO,GAAG,CAAC;QAC1B;MACF,KAAK,cAAc;QACjB,IAAI,CAACpB,SAAS,CAACqB,cAAc,GAAG;UAC9BC,OAAO,EAAEhB,KAAK,CAACgB,OAAO,IAAI,EAAE;UAC5BC,IAAI,EAAEjB,KAAK,CAACiB;QACd,CAAC,CAAC;QACF;QACA,IAAI,CAACV,OAAO,CAAC,CAAC;QACd;MACF,KAAK,YAAY;QACf,IAAI,CAACb,SAAS,CAACwB,YAAY,GAAG,CAAC;QAC/B;MACF,KAAK,SAAS;QACZ,IAAI,CAACxB,SAAS,CAACyB,SAAS,GAAG,CAAC;QAC5B;MACF,KAAK,QAAQ;QACX,IAAI,CAACzB,SAAS,CAAC0B,kBAAkB,GAAG;UAClCP,IAAI,EAAEb,KAAK,CAACqB,UAAU,IAAI,EAAE;UAC5BC,MAAM,EAAEtB,KAAK,CAACuB,YAAY,IAAI;QAChC,CAAC,CAAC;QACF;MACF,KAAK,WAAW;QACd,IAAI,CAAC7B,SAAS,CAAC8B,WAAW,GAAG,CAAC;QAC9B;QACA,IAAI,CAACjB,OAAO,CAAC,CAAC;QACd;IACJ;EACF;AACF","ignoreList":[]}

package/lib/module/NativeEzoicAds.js.map

@@ -1 +1 @@
-{"version":3,"names":["TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativeEzoicAds.ts"],"mappings":";;AACA,SAASA,mBAAmB,QAAQ,cAAc;;AAWlD;AACA;AACA;AACA;AACA;AACA;;AAoBA,eAAeA,mBAAmB,CAACC,YAAY,CAAO,qBAAqB,CAAC","ignoreList":[]}
+{"version":3,"names":["TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativeEzoicAds.ts"],"mappings":";;AACA,SAASA,mBAAmB,QAAQ,cAAc;;AAWlD;AACA;AACA;AACA;AACA;AACA;;AAsBA,eAAeA,mBAAmB,CAACC,YAAY,CAAO,qBAAqB,CAAC","ignoreList":[]}

package/lib/module/index.js

@@ -5,6 +5,7 @@ import EzoicBannerNative from './EzoicBannerViewNativeComponent';
 import { coerceAdUnitId, normalizeConfig, normalizeSize } from "./helpers.js";
 import { jsx as _jsx } from "react/jsx-runtime";
 export { EzoicRewardedAd } from "./EzoicRewardedAd.js";
+export { EzoicInterstitialAd } from "./EzoicInterstitialAd.js";
 export const EzoicAds = {
   initialize(config) {
     return NativeEzoicAds.initialize(normalizeConfig(config));

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["NativeEzoicAds","EzoicBannerNative","coerceAdUnitId","normalizeConfig","normalizeSize","jsx","_jsx","EzoicRewardedAd","EzoicAds","initialize","config","setGDPRConsent","applies","consentString","setGPPConsent","gppString","sectionIds","setSubjectToCOPPA","value","trackPageview","EzoicBannerView","props","adUnitIdentifier","size","onLoad","onError","onImpression","onClick","onOpen","onClose","rest","undefined","e","nativeEvent","onAdClick"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AACA,OAAOA,cAAc,MAA4B,qBAAkB;AACnE,OAAOC,iBAAiB,MAAM,kCAAkC;AAChE,SAASC,cAAc,EAAEC,eAAe,EAAEC,aAAa,QAAQ,cAAW;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAG3E,SACEC,eAAe,QAGV,sBAAmB;AAE1B,OAAO,MAAMC,QAAQ,GAAG;EACtBC,UAAUA,CAACC,MAAmB,EAAiB;IAC7C,OAAOV,cAAc,CAACS,UAAU,CAACN,eAAe,CAACO,MAAM,CAAC,CAAC;EAC3D,CAAC;EACDC,cAAcA,CAACC,OAAgB,EAAEC,aAAsB,EAAQ;IAC7Db,cAAc,CAACW,cAAc,CAACC,OAAO,EAAEC,aAAa,CAAC;EACvD,CAAC;EACDC,aAAaA,CAACC,SAAkB,EAAEC,UAAmB,EAAQ;IAC3DhB,cAAc,CAACc,aAAa,CAACC,SAAS,EAAEC,UAAU,CAAC;EACrD,CAAC;EACDC,iBAAiBA,CAACC,KAAc,EAAQ;IACtClB,cAAc,CAACiB,iBAAiB,CAACC,KAAK,CAAC;EACzC,CAAC;EACDC,aAAaA,CAAA,EAAqB;IAChC,OAAOnB,cAAc,CAACmB,aAAa,CAAC,CAAC;EACvC;AACF,CAAC;AAmBD,OAAO,SAASC,eAAeA,CAACC,KAA2B,EAAE;EAC3D,MAAM;IACJC,gBAAgB;IAChBC,IAAI;IACJC,MAAM;IACNC,OAAO;IACPC,YAAY;IACZC,OAAO;IACPC,MAAM;IACNC,OAAO;IACP,GAAGC;EACL,CAAC,GAAGT,KAAK;EACT,oBACEf,IAAA,CAACL,iBAAiB;IAAA,GACZ6B,IAAI;IACRR,gBAAgB,EAAEpB,cAAc,CAACoB,gBAAgB,CAAE;IACnDC,IAAI,EAAEnB,aAAa,CAACmB,IAAI,CAAE;IAC1BC,MAAM,EAAEA,MAAM,GAAG,MAAMA,MAAM,CAAC,CAAC,GAAGO,SAAU;IAC5CN,OAAO,EAAEA,OAAO,GAAIO,CAAC,IAAKP,OAAO,CAACO,CAAC,CAACC,WAAW,CAAC,GAAGF,SAAU;IAC7DL,YAAY,EAAEA,YAAY,GAAG,MAAMA,YAAY,CAAC,CAAC,GAAGK,SAAU;IAC9DG,SAAS,EAAEP,OAAO,GAAG,MAAMA,OAAO,CAAC,CAAC,GAAGI,SAAU;IACjDH,MAAM,EAAEA,MAAM,GAAG,MAAMA,MAAM,CAAC,CAAC,GAAGG,SAAU;IAC5CF,OAAO,EAAEA,OAAO,GAAG,MAAMA,OAAO,CAAC,CAAC,GAAGE;EAAU,CAChD,CAAC;AAEN","ignoreList":[]}
+{"version":3,"names":["NativeEzoicAds","EzoicBannerNative","coerceAdUnitId","normalizeConfig","normalizeSize","jsx","_jsx","EzoicRewardedAd","EzoicInterstitialAd","EzoicAds","initialize","config","setGDPRConsent","applies","consentString","setGPPConsent","gppString","sectionIds","setSubjectToCOPPA","value","trackPageview","EzoicBannerView","props","adUnitIdentifier","size","onLoad","onError","onImpression","onClick","onOpen","onClose","rest","undefined","e","nativeEvent","onAdClick"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AACA,OAAOA,cAAc,MAA4B,qBAAkB;AACnE,OAAOC,iBAAiB,MAAM,kCAAkC;AAChE,SAASC,cAAc,EAAEC,eAAe,EAAEC,aAAa,QAAQ,cAAW;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAG3E,SACEC,eAAe,QAGV,sBAAmB;AAC1B,SACEC,mBAAmB,QAEd,0BAAuB;AAE9B,OAAO,MAAMC,QAAQ,GAAG;EACtBC,UAAUA,CAACC,MAAmB,EAAiB;IAC7C,OAAOX,cAAc,CAACU,UAAU,CAACP,eAAe,CAACQ,MAAM,CAAC,CAAC;EAC3D,CAAC;EACDC,cAAcA,CAACC,OAAgB,EAAEC,aAAsB,EAAQ;IAC7Dd,cAAc,CAACY,cAAc,CAACC,OAAO,EAAEC,aAAa,CAAC;EACvD,CAAC;EACDC,aAAaA,CAACC,SAAkB,EAAEC,UAAmB,EAAQ;IAC3DjB,cAAc,CAACe,aAAa,CAACC,SAAS,EAAEC,UAAU,CAAC;EACrD,CAAC;EACDC,iBAAiBA,CAACC,KAAc,EAAQ;IACtCnB,cAAc,CAACkB,iBAAiB,CAACC,KAAK,CAAC;EACzC,CAAC;EACDC,aAAaA,CAAA,EAAqB;IAChC,OAAOpB,cAAc,CAACoB,aAAa,CAAC,CAAC;EACvC;AACF,CAAC;AAmBD,OAAO,SAASC,eAAeA,CAACC,KAA2B,EAAE;EAC3D,MAAM;IACJC,gBAAgB;IAChBC,IAAI;IACJC,MAAM;IACNC,OAAO;IACPC,YAAY;IACZC,OAAO;IACPC,MAAM;IACNC,OAAO;IACP,GAAGC;EACL,CAAC,GAAGT,KAAK;EACT,oBACEhB,IAAA,CAACL,iBAAiB;IAAA,GACZ8B,IAAI;IACRR,gBAAgB,EAAErB,cAAc,CAACqB,gBAAgB,CAAE;IACnDC,IAAI,EAAEpB,aAAa,CAACoB,IAAI,CAAE;IAC1BC,MAAM,EAAEA,MAAM,GAAG,MAAMA,MAAM,CAAC,CAAC,GAAGO,SAAU;IAC5CN,OAAO,EAAEA,OAAO,GAAIO,CAAC,IAAKP,OAAO,CAACO,CAAC,CAACC,WAAW,CAAC,GAAGF,SAAU;IAC7DL,YAAY,EAAEA,YAAY,GAAG,MAAMA,YAAY,CAAC,CAAC,GAAGK,SAAU;IAC9DG,SAAS,EAAEP,OAAO,GAAG,MAAMA,OAAO,CAAC,CAAC,GAAGI,SAAU;IACjDH,MAAM,EAAEA,MAAM,GAAG,MAAMA,MAAM,CAAC,CAAC,GAAGG,SAAU;IAC5CF,OAAO,EAAEA,OAAO,GAAG,MAAMA,OAAO,CAAC,CAAC,GAAGE;EAAU,CAChD,CAAC;AAEN","ignoreList":[]}

package/lib/typescript/src/EzoicInterstitialAd.d.ts

@@ -0,0 +1,51 @@
+/** Lifecycle callbacks for an interstitial ad. All are optional. */
+export interface EzoicInterstitialAdListeners {
+    onShown?: () => void;
+    onFailedToShow?: (error: {
+        message: string;
+        code?: number;
+    }) => void;
+    onImpression?: () => void;
+    onClicked?: () => void;
+    onDismissed?: () => void;
+}
+/**
+ * An interstitial ad. Use the static `load` to fetch an ad ahead of time, then
+ * call `show()` to present it full-screen at a natural transition point.
+ * Interstitials carry no reward.
+ *
+ * ```ts
+ * const ad = await EzoicInterstitialAd.load('12345');
+ * ad.setListeners({ onDismissed: () => console.log('closed') });
+ * await ad.show();
+ * ```
+ *
+ * Mirrors the native `EzoicInterstitialAd` load/show lifecycle on both
+ * platforms. Interstitial ads are single-use — load a new one for the next
+ * opportunity.
+ */
+export declare class EzoicInterstitialAd {
+    /** The Ezoic ad unit identifier this ad was loaded for. */
+    readonly adUnitIdentifier: string;
+    private listeners;
+    private subscription;
+    private constructor();
+    /**
+     * Loads an interstitial ad for the given Ezoic ad unit identifier. Resolves
+     * with a ready-to-show `EzoicInterstitialAd`, or rejects if no ad could be
+     * loaded.
+     */
+    static load(adUnitIdentifier: string): Promise<EzoicInterstitialAd>;
+    /** Registers lifecycle callbacks. Replaces any previously set listeners. */
+    setListeners(listeners: EzoicInterstitialAdListeners): void;
+    /**
+     * Presents the interstitial ad full-screen. Resolves when the ad is
+     * dismissed. Rejects if the ad was not ready (load first) or failed to
+     * present.
+     */
+    show(): Promise<void>;
+    /** Releases the event subscription. Safe to call multiple times. */
+    destroy(): void;
+    private handleEvent;
+}
+//# sourceMappingURL=EzoicInterstitialAd.d.ts.map

package/lib/typescript/src/EzoicInterstitialAd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EzoicInterstitialAd.d.ts","sourceRoot":"","sources":["../../../src/EzoicInterstitialAd.ts"],"names":[],"mappings":"AAIA,oEAAoE;AACpE,MAAM,WAAW,4BAA4B;IAC3C,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACrE,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;CAC1B;AAgBD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,mBAAmB;IAC9B,2DAA2D;IAC3D,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAElC,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,YAAY,CAAoC;IAExD,OAAO;IAYP;;;;OAIG;WACU,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAYzE,4EAA4E;IAC5E,YAAY,CAAC,SAAS,EAAE,4BAA4B,GAAG,IAAI;IAI3D;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,oEAAoE;IACpE,OAAO,IAAI,IAAI;IAMf,OAAO,CAAC,WAAW;CA0BpB"}

package/lib/typescript/src/EzoicRewardedAd.d.ts

@@ -8,6 +8,7 @@ export interface EzoicRewardedAdListeners {
     onShown?: () => void;
     onFailedToShow?: (error: {
         message: string;
+        code?: number;
     }) => void;
     onImpression?: () => void;
     onClicked?: () => void;

package/lib/typescript/src/EzoicRewardedAd.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EzoicRewardedAd.d.ts","sourceRoot":"","sources":["../../../src/EzoicRewardedAd.ts"],"names":[],"mappings":"AAIA,gEAAgE;AAChE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,+DAA+D;AAC/D,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACtD,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;CACpD;AAuBD;;;;;;;;;;;;;GAaG;AACH,qBAAa,eAAe;IAC1B,2DAA2D;IAC3D,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAElC,OAAO,CAAC,SAAS,CAAgC;IACjD,OAAO,CAAC,YAAY,CAAoC;IAExD,OAAO;IASP;;;OAGG;WACU,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAYrE,4EAA4E;IAC5E,YAAY,CAAC,SAAS,EAAE,wBAAwB,GAAG,IAAI;IAIvD;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAKzC,oEAAoE;IACpE,OAAO,IAAI,IAAI;IAMf,OAAO,CAAC,WAAW;CA2BpB"}
+{"version":3,"file":"EzoicRewardedAd.d.ts","sourceRoot":"","sources":["../../../src/EzoicRewardedAd.ts"],"names":[],"mappings":"AAIA,gEAAgE;AAChE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,+DAA+D;AAC/D,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACrE,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;CACpD;AAwBD;;;;;;;;;;;;;GAaG;AACH,qBAAa,eAAe;IAC1B,2DAA2D;IAC3D,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAElC,OAAO,CAAC,SAAS,CAAgC;IACjD,OAAO,CAAC,YAAY,CAAoC;IAExD,OAAO;IASP;;;OAGG;WACU,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAYrE,4EAA4E;IAC5E,YAAY,CAAC,SAAS,EAAE,wBAAwB,GAAG,IAAI;IAIvD;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAKzC,oEAAoE;IACpE,OAAO,IAAI,IAAI;IAMf,OAAO,CAAC,WAAW;CAgCpB"}

package/lib/typescript/src/NativeEzoicAds.d.ts

@@ -26,6 +26,8 @@ export interface Spec extends TurboModule {
     trackPageview(): Promise<boolean>;
     loadRewardedAd(adUnitIdentifier: string): Promise<void>;
     showRewardedAd(adUnitIdentifier: string): Promise<EzoicRewardResult>;
+    loadInterstitialAd(adUnitIdentifier: string): Promise<void>;
+    showInterstitialAd(adUnitIdentifier: string): Promise<void>;
     addListener(eventName: string): void;
     removeListeners(count: number): void;
 }

package/lib/typescript/src/NativeEzoicAds.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NativeEzoicAds.d.ts","sourceRoot":"","sources":["../../../src/NativeEzoicAds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/D,aAAa,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7D,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACxC,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAClC,cAAc,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,cAAc,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAErE,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;;AAED,wBAA6E"}
+{"version":3,"file":"NativeEzoicAds.d.ts","sourceRoot":"","sources":["../../../src/NativeEzoicAds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/D,aAAa,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7D,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACxC,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAClC,cAAc,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,cAAc,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACrE,kBAAkB,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,kBAAkB,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5D,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;;AAED,wBAA6E"}

package/lib/typescript/src/index.d.ts

@@ -2,6 +2,7 @@ import type { StyleProp, ViewStyle } from 'react-native';
 import { type EzoicConfig } from './NativeEzoicAds.js';
 export type { EzoicConfig };
 export { EzoicRewardedAd, type EzoicReward, type EzoicRewardedAdListeners, } from './EzoicRewardedAd.js';
+export { EzoicInterstitialAd, type EzoicInterstitialAdListeners, } from './EzoicInterstitialAd.js';
 export declare const EzoicAds: {
     initialize(config: EzoicConfig): Promise<void>;
     setGDPRConsent(applies: boolean, consentString?: string): void;

package/lib/typescript/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzD,OAAuB,EAAE,KAAK,WAAW,EAAE,MAAM,qBAAkB,CAAC;AAIpE,YAAY,EAAE,WAAW,EAAE,CAAC;AAC5B,OAAO,EACL,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,wBAAwB,GAC9B,MAAM,sBAAmB,CAAC;AAE3B,eAAO,MAAM,QAAQ;uBACA,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;4BAGtB,OAAO,kBAAkB,MAAM,GAAG,IAAI;8BAGpC,MAAM,eAAe,MAAM,GAAG,IAAI;6BAGnC,OAAO,GAAG,IAAI;qBAGtB,OAAO,CAAC,OAAO,CAAC;CAGlC,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC5C,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,+BAyB1D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzD,OAAuB,EAAE,KAAK,WAAW,EAAE,MAAM,qBAAkB,CAAC;AAIpE,YAAY,EAAE,WAAW,EAAE,CAAC;AAC5B,OAAO,EACL,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,wBAAwB,GAC9B,MAAM,sBAAmB,CAAC;AAC3B,OAAO,EACL,mBAAmB,EACnB,KAAK,4BAA4B,GAClC,MAAM,0BAAuB,CAAC;AAE/B,eAAO,MAAM,QAAQ;uBACA,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;4BAGtB,OAAO,kBAAkB,MAAM,GAAG,IAAI;8BAGpC,MAAM,eAAe,MAAM,GAAG,IAAI;6BAGnC,OAAO,GAAG,IAAI;qBAGtB,OAAO,CAAC,OAAO,CAAC;CAGlC,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC5C,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,+BAyB1D"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ezoic/react-native-sdk",
-  "version": "1.1.0",
-  "description": "Ezoic Ads SDK for React Native (Prebid + Google Ad Manager banner and rewarded ads).",
+  "version": "1.2.0",
+  "description": "Ezoic Ads SDK for React Native (Prebid + Google Ad Manager banner, interstitial and rewarded ads).",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
   "exports": {

package/src/EzoicInterstitialAd.ts

@@ -0,0 +1,126 @@
+import { NativeEventEmitter, type EmitterSubscription } from 'react-native';
+import NativeEzoicAds from './NativeEzoicAds';
+import { coerceAdUnitId } from './helpers';
+
+/** Lifecycle callbacks for an interstitial ad. All are optional. */
+export interface EzoicInterstitialAdListeners {
+  onShown?: () => void;
+  onFailedToShow?: (error: { message: string; code?: number }) => void;
+  onImpression?: () => void;
+  onClicked?: () => void;
+  onDismissed?: () => void;
+}
+
+/** The single native event name carrying every interstitial lifecycle signal. */
+const INTERSTITIAL_EVENT = 'EzoicInterstitialAdEvent';
+
+interface InterstitialNativeEvent {
+  adUnitIdentifier: string;
+  type: 'shown' | 'failedToShow' | 'impression' | 'clicked' | 'dismissed';
+  message?: string;
+  code?: number;
+}
+
+// A single shared emitter is sufficient — events are routed to the right
+// instance by adUnitIdentifier below.
+const emitter = new NativeEventEmitter(NativeEzoicAds as never);
+
+/**
+ * An interstitial ad. Use the static `load` to fetch an ad ahead of time, then
+ * call `show()` to present it full-screen at a natural transition point.
+ * Interstitials carry no reward.
+ *
+ * ```ts
+ * const ad = await EzoicInterstitialAd.load('12345');
+ * ad.setListeners({ onDismissed: () => console.log('closed') });
+ * await ad.show();
+ * ```
+ *
+ * Mirrors the native `EzoicInterstitialAd` load/show lifecycle on both
+ * platforms. Interstitial ads are single-use — load a new one for the next
+ * opportunity.
+ */
+export class EzoicInterstitialAd {
+  /** The Ezoic ad unit identifier this ad was loaded for. */
+  readonly adUnitIdentifier: string;
+
+  private listeners: EzoicInterstitialAdListeners = {};
+  private subscription: EmitterSubscription | null = null;
+
+  private constructor(adUnitIdentifier: string) {
+    this.adUnitIdentifier = adUnitIdentifier;
+    this.subscription = emitter.addListener(
+      INTERSTITIAL_EVENT,
+      (raw: unknown) => {
+        const event = raw as InterstitialNativeEvent;
+        if (event.adUnitIdentifier !== this.adUnitIdentifier) return;
+        this.handleEvent(event);
+      }
+    );
+  }
+
+  /**
+   * Loads an interstitial ad for the given Ezoic ad unit identifier. Resolves
+   * with a ready-to-show `EzoicInterstitialAd`, or rejects if no ad could be
+   * loaded.
+   */
+  static async load(adUnitIdentifier: string): Promise<EzoicInterstitialAd> {
+    const id = coerceAdUnitId(adUnitIdentifier);
+    const ad = new EzoicInterstitialAd(id);
+    try {
+      await NativeEzoicAds.loadInterstitialAd(id);
+      return ad;
+    } catch (error) {
+      ad.destroy();
+      throw error;
+    }
+  }
+
+  /** Registers lifecycle callbacks. Replaces any previously set listeners. */
+  setListeners(listeners: EzoicInterstitialAdListeners): void {
+    this.listeners = listeners;
+  }
+
+  /**
+   * Presents the interstitial ad full-screen. Resolves when the ad is
+   * dismissed. Rejects if the ad was not ready (load first) or failed to
+   * present.
+   */
+  async show(): Promise<void> {
+    await NativeEzoicAds.showInterstitialAd(this.adUnitIdentifier);
+  }
+
+  /** Releases the event subscription. Safe to call multiple times. */
+  destroy(): void {
+    this.subscription?.remove();
+    this.subscription = null;
+    this.listeners = {};
+  }
+
+  private handleEvent(event: InterstitialNativeEvent): void {
+    switch (event.type) {
+      case 'shown':
+        this.listeners.onShown?.();
+        break;
+      case 'failedToShow':
+        this.listeners.onFailedToShow?.({
+          message: event.message ?? '',
+          code: event.code,
+        });
+        // Failure to show is terminal — the native ad is single-use.
+        this.destroy();
+        break;
+      case 'impression':
+        this.listeners.onImpression?.();
+        break;
+      case 'clicked':
+        this.listeners.onClicked?.();
+        break;
+      case 'dismissed':
+        this.listeners.onDismissed?.();
+        // Dismissal is terminal — the native ad is single-use.
+        this.destroy();
+        break;
+    }
+  }
+}

package/src/EzoicRewardedAd.ts

@@ -11,7 +11,7 @@ export interface EzoicReward {
 /** Lifecycle callbacks for a rewarded ad. All are optional. */
 export interface EzoicRewardedAdListeners {
   onShown?: () => void;
-  onFailedToShow?: (error: { message: string }) => void;
+  onFailedToShow?: (error: { message: string; code?: number }) => void;
   onImpression?: () => void;
   onClicked?: () => void;
   onDismissed?: () => void;
@@ -31,6 +31,7 @@ interface RewardedNativeEvent {
     | 'dismissed'
     | 'reward';
   message?: string;
+  code?: number;
   rewardType?: string;
   rewardAmount?: number;
 }
@@ -113,7 +114,12 @@ export class EzoicRewardedAd {
         this.listeners.onShown?.();
         break;
       case 'failedToShow':
-        this.listeners.onFailedToShow?.({ message: event.message ?? '' });
+        this.listeners.onFailedToShow?.({
+          message: event.message ?? '',
+          code: event.code,
+        });
+        // Failure to show is terminal — the native ad is single-use.
+        this.destroy();
         break;
       case 'impression':
         this.listeners.onImpression?.();

package/src/NativeEzoicAds.ts

@@ -30,7 +30,9 @@ export interface Spec extends TurboModule {
   trackPageview(): Promise<boolean>;
   loadRewardedAd(adUnitIdentifier: string): Promise<void>;
   showRewardedAd(adUnitIdentifier: string): Promise<EzoicRewardResult>;
-  // Required by NativeEventEmitter for the rewarded ad lifecycle events.
+  loadInterstitialAd(adUnitIdentifier: string): Promise<void>;
+  showInterstitialAd(adUnitIdentifier: string): Promise<void>;
+  // Required by NativeEventEmitter for the ad lifecycle events.
   addListener(eventName: string): void;
   removeListeners(count: number): void;
 }

package/src/index.tsx

@@ -9,6 +9,10 @@ export {
   type EzoicReward,
   type EzoicRewardedAdListeners,
 } from './EzoicRewardedAd';
+export {
+  EzoicInterstitialAd,
+  type EzoicInterstitialAdListeners,
+} from './EzoicInterstitialAd';
 
 export const EzoicAds = {
   initialize(config: EzoicConfig): Promise<void> {