@javascriptcommon/react-native-google-mobile-ads 16.3.3

package/LICENSE

@@ -0,0 +1,32 @@
+Apache-2.0 License
+------------------
+
+Copyright (c) 2021-present Invertase Limited <oss@invertase.io>
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this library except in compliance with the License.
+
+You may obtain a copy of the Apache-2.0 License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+
+Creative Commons Attribution 3.0 License
+----------------------------------------
+
+Copyright (c) 2016-present Invertase Limited <oss@invertase.io>
+
+Documentation and other instructional materials provided for this project
+(including on a separate documentation repository or it's documentation website) are
+licensed under the Creative Commons Attribution 3.0 License. Code samples/blocks
+contained therein are licensed under the Apache License, Version 2.0 (the "License"), as above.
+
+You may obtain a copy of the Creative Commons Attribution 3.0 License at
+
+    https://creativecommons.org/licenses/by/3.0/

package/README.md

@@ -0,0 +1,181 @@
+<!--
+  @javascriptcommon/react-native-google-mobile-ads
+  ────────────────────────────────────────────────
+  Fork of invertase/react-native-google-mobile-ads. Differences:
+   • Android: migrated to the GMA Next-Gen SDK
+     (com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk), replacing the
+     legacy play-services-ads SDK. Supported on Android: banner, interstitial,
+     app-open, consent (UMP). NOT migrated on Android: native ads, rewarded,
+     rewarded-interstitial (their JS modules resolve to no-op stubs).
+   • iOS: unchanged — keeps the classic Google Mobile Ads SDK and full format support.
+  The JS API is identical to upstream. Licensed under Apache-2.0 (see LICENSE);
+  all original copyright is retained.
+-->
+<p align="center">
+  <a href="https://docs.page/invertase/react-native-google-mobile-ads">
+    <img width="160px" src="./docs/img/logo_admob_192px.svg"><br/>
+  </a>
+  <h2 align="center">React Native Google Mobile Ads (Next-Gen Android fork)</h2>
+</p>
+
+> **Fork notice** — `@javascriptcommon/react-native-google-mobile-ads` migrates the
+> **Android** native layer to the **GMA Next-Gen SDK** (`ads-mobile-sdk`). iOS is
+> unchanged (classic GMA SDK). On Android only banner / interstitial / app-open /
+> consent are implemented; native ads and rewarded are not. Same JS API as upstream.
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/react-native-google-mobile-ads"><img src="https://img.shields.io/npm/dm/react-native-google-mobile-ads.svg?style=flat-square" alt="NPM downloads"></a>
+  <a href="https://www.npmjs.com/package/react-native-google-mobile-ads"><img src="https://img.shields.io/npm/v/react-native-google-mobile-ads.svg?style=flat-square" alt="NPM version"></a>
+  <a href="/LICENSE"><img src="https://img.shields.io/npm/l/react-native-google-mobile-ads.svg?style=flat-square" alt="License"></a>
+</p>
+
+<p align="center">
+  <a href="https://invertase.link/discord"><img src="https://img.shields.io/discord/295953187817521152.svg?style=flat-square&colorA=7289da&label=Chat%20on%20Discord" alt="Chat on Discord"></a>
+  <a href="https://twitter.com/invertaseio"><img src="https://img.shields.io/twitter/follow/invertaseio.svg?style=flat-square&colorA=1da1f2&colorB=&label=Follow%20on%20Twitter" alt="Follow on Twitter"></a>
+  <a href="https://www.facebook.com/groups/invertase.io"><img src="https://img.shields.io/badge/Follow%20on%20Facebook-4172B8?logo=facebook&style=flat-square&logoColor=fff" alt="Follow on Facebook"></a>
+</p>
+
+---
+
+**React Native Google Mobile Ads** allows you to monetize your app with AdMob; a React Native wrapper around the native Google-Mobile-Ads SDKs for both iOS and Android.
+
+React Native Google Mobile Ads is built with three key principals in mind;
+
+- 🧪 **Well tested**
+  - the module is extensively tested to >95% coverage (getting there after moving from react-native-firebase!)
+- 👁 **Well typed**
+  - first class support for Typescript included
+- 📄 **Well documented**
+  - full reference & installation documentation alongside detailed guides and FAQs
+
+## Ad formats
+
+### App open
+
+App open ads are a special ad format intended for publishers wishing to monetize their app load screens.
+
+<img width="200" src="https://developers.google.com/static/admob/images/app-open-ad.png" alt="App open ad">
+
+[Learn More](https://docs.page/invertase/react-native-google-mobile-ads/displaying-ads#app-open-ads)
+
+### Banner
+
+Banner ad units display rectangular ads that occupy a portion of an app's layout.
+They stay on screen while users are interacting with the app, either anchored at the top or bottom of the screen or inline with content as the user scrolls.
+Banner ads can refresh automatically after a certain period of time.
+
+#### Anchored adaptive
+
+A dynamically sized banner that is full-width and auto-height. Anchored adaptive banners are expected to be always on-screen, locked to the screen’s top or bottom.
+
+<img width="200" src="https://developers.google.com/static/admob/images/Android_adaptive.png" alt="Anchored adaptive">
+
+[Learn More](https://docs.page/invertase/react-native-google-mobile-ads/displaying-ads#banner-ads-component)
+
+#### Inline adaptive
+
+Inline adaptive banners are larger, taller banners compared to anchored adaptive banners.
+They are of variable height, and can be as tall as the device screen.
+They are intended to be placed in scrolling content.
+
+<img width="600" src="https://developers.google.com/static/admob/images/inline-adaptive.png" alt="Inline adaptive">
+
+[Learn More](https://docs.page/invertase/react-native-google-mobile-ads/displaying-ads#banner-ads-component)
+
+#### Collapsible
+
+Collapsible banner ads are intended to improve performance of anchored ads that are otherwise a smaller size.
+
+<img width="400" src="https://developers.google.com/static/admob/images/collapsible-banner.png" alt="Collapsible banner">
+
+[Learn More](https://docs.page/invertase/react-native-google-mobile-ads/displaying-ads#collapsible-banner-ads)
+
+#### Fixed size (legacy)
+
+The Google Mobile Ads SDK supports fixed ad sizes for situations where adaptive banners ads don't meet your needs.
+Banner (320x50), Large banner (320x100), Medium rectangle (300x250), full banner (468x60) and leaderboard (728x90).
+
+[Learn More](https://docs.page/invertase/react-native-google-mobile-ads/displaying-ads#banner-ads-component)
+
+### Native
+
+Native ads allow you to customize the look and feel of the ads that appear in your app.
+You decide how and where they're placed, so the layout is more consistent your app's design.
+
+<img width="300" src="https://developers.google.com/static/admob/images/format-native.svg" alt="Native">
+
+[Learn More](https://docs.page/invertase/react-native-google-mobile-ads/native-ads)
+
+### Interstitial
+
+Interstitial ad units show full-page ads in your app. Place them at natural breaks & transitions in your app's interface, such as after level completion in a gaming app.
+
+<img width="300" src="https://developers.google.com/static/admob/images/format-interstitial.svg" alt="Interstitial">
+
+[Learn More](https://docs.page/invertase/react-native-google-mobile-ads/displaying-ads#interstitial-ads)
+
+### Rewarded
+
+AdMob rewarded ad units allow you to reward users with in-app items for interacting with video ads, playable ads, and surveys.
+
+<img width="300" src="https://developers.google.com/static/admob/images/format-rewarded.svg" alt="Rewarded">
+
+[Learn More](https://docs.page/invertase/react-native-google-mobile-ads/displaying-ads#rewarded-ads)
+
+### Rewarded Interstitial
+
+Rewarded interstitial is a type of incentivized ad format that allows you offer rewards for ads that appear automatically during natural app transitions.
+Unlike rewarded ads, users aren't required to opt-in to view a rewarded interstitial.
+
+<img width="300" src="https://developers.google.com/static/admob/images/format-rewarded-interstitial.svg" alt="Rewarded interstitial">
+
+[Learn More](https://docs.page/invertase/react-native-google-mobile-ads/displaying-ads#rewarded-interstitial-ads)
+
+## Migrating to the New Architecture Status (backwards compatible)
+
+This package can be used in both The Old and [The New Architecture](https://reactnative.dev/docs/the-new-architecture/landing-page).
+When using The New Architecture, some legacy code will still be used though. See status below:
+
+| Platform | Feature                                                                                                                                                        | Status      |
+| -------- |----------------------------------------------------------------------------------------------------------------------------------------------------------------| ----------- |
+| iOS      | Mobile Ads SDK Methods (Turbo Native Module)                                                                                                                   | ✅ Complete |
+| iOS      | Banners (Fabric Native Component)                                                                                                                              | ✅ Complete |
+| iOS      | Full Screen Ads (Turbo Native Module)                                                                                                                          | ✅ Complete |
+| iOS      | Native Ads (Turbo Native Module, Fabric Native Component)                                                                                                      | ✅ Complete |
+| iOS      | User Messaging Platform (Turbo Native Module)                                                                                                                  | ✅ Complete |
+| iOS      | [EventEmitter](https://github.com/reactwg/react-native-new-architecture/blob/main/docs/turbo-modules.md#add-event-emitting-capabilities) (Turbo Native Module) | ⏳ To-Do    |
+| iOS      | Revenue Precision Constants (Turbo Native Module)                                                                                                              | ✅ Complete |
+| Android  | Mobile Ads SDK Methods (Turbo Native Module)                                                                                                                   | ⏳ To-Do    |
+| Android  | Banners (Fabric Native Component)                                                                                                                              | ⏳ To-Do    |
+| Android  | Full Screen Ads (Turbo Native Module)                                                                                                                          | ⏳ To-Do    |
+| Android  | Native Ads (Turbo Native Module, Fabric Native Component)                                                                                                      | ✅ Complete |
+| Android  | User Messaging Platform (Turbo Native Module)                                                                                                                  | ⏳ To-Do    |
+| Android  | [EventEmitter](https://github.com/reactwg/react-native-new-architecture/blob/main/docs/turbo-modules.md#add-event-emitting-capabilities) (Turbo Native Module) | ⏳ To-Do    |
+| Android  | Revenue Precision Constants (Turbo Native Module)                                                                                                              | ⏳ To-Do    |
+
+## Documentation
+
+- [Installation](https://docs.page/invertase/react-native-google-mobile-ads)
+- [Displaying Ads](https://docs.page/invertase/react-native-google-mobile-ads/displaying-ads)
+
+## Contributing
+
+- [Issues](https://github.com/invertase/react-native-google-mobile-ads/issues)
+- [PRs](https://github.com/invertase/react-native-google-mobile-ads/pulls)
+- [Guidelines](https://github.com/invertase/react-native-google-mobile-ads/blob/main/CONTRIBUTING.md)
+- [Code of Conduct](https://github.com/invertase/meta/blob/main/CODE_OF_CONDUCT.md)
+
+## License
+
+- See [LICENSE](/LICENSE)
+
+---
+
+<p align="center">
+  <a href="https://invertase.io/?utm_source=readme&utm_medium=footer&utm_campaign=react-native-google-mobile-ads">
+    <img width="75px" src="https://static.invertase.io/assets/invertase/invertase-rounded-avatar.png">
+  </a>
+  <p align="center">
+    Built and maintained by <a href="https://invertase.io/?utm_source=readme&utm_medium=footer&utm_campaign=react-native-google-mobile-ads">Invertase</a>.
+  </p>
+</p>

package/RNGoogleMobileAds.podspec

@@ -0,0 +1,74 @@
+require 'json'
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+
+google_mobile_ads_sdk_version = package['sdkVersions']['ios']['googleMobileAds']
+google_ump_sdk_version = package['sdkVersions']['ios']['googleUmp']
+
+Pod::Spec.new do |s|
+  s.name                = "RNGoogleMobileAds"
+
+  s.version             = package["version"]
+  s.description         = package["description"]
+  s.summary             = <<-DESC
+                            #{package["description"]}
+                          DESC
+  s.homepage            = "http://invertase.io/oss/react-native-google-mobile-ads"
+  s.license             = package['license']
+  s.authors             = "Invertase Limited"
+  s.source              = { :git => "#{package["repository"]["url"]}.git", :tag => "v#{s.version}" }
+  s.social_media_url    = 'http://twitter.com/invertaseio'
+  s.ios.deployment_target = "12.0"
+  s.cocoapods_version   = '>= 1.12.0'
+  s.source_files        = "ios/**/*.{h,m,mm,swift}"
+  s.weak_frameworks     = "AppTrackingTransparency"
+
+  # Use install_modules_dependencies helper to install the dependencies if React Native version >=0.71.0.
+  # See https://github.com/facebook/react-native/blob/febf6b7f33fdb4904669f99d795eba4c0f95d7bf/scripts/cocoapods/new_architecture.rb#L79.
+  if respond_to?(:install_modules_dependencies, true)
+    install_modules_dependencies(s)
+  else
+    s.dependency "React-Core"
+
+    # Don't install the dependencies when we run `pod install` in the old architecture.
+    if ENV['RCT_NEW_ARCH_ENABLED'] == '1' then
+      s.compiler_flags = folly_compiler_flags + " -DRCT_NEW_ARCH_ENABLED=1"
+      s.pod_target_xcconfig    = {
+          "HEADER_SEARCH_PATHS" => "\"$(PODS_ROOT)/boost\"",
+          "OTHER_CPLUSPLUSFLAGS" => "-DFOLLY_NO_CONFIG -DFOLLY_MOBILE=1 -DFOLLY_USE_LIBCPP=1",
+          "CLANG_CXX_LANGUAGE_STANDARD" => "c++17"
+      }
+      s.dependency "React-Codegen"
+      s.dependency "RCT-Folly"
+      s.dependency "RCTRequired"
+      s.dependency "RCTTypeSafety"
+      s.dependency "ReactCommon/turbomodule/core"
+    end
+  end
+
+  # Other dependencies
+  if defined?($RNGoogleUmpSDKVersion)
+    Pod::UI.puts "#{s.name}: Using user specified Google UMP SDK version '#{$RNGoogleUmpSDKVersion}'"
+    google_ump_sdk_version = $RNGoogleUmpSDKVersion
+  end
+
+  if !ENV['MAC_CATALYST']
+  s.dependency          'GoogleUserMessagingPlatform', google_ump_sdk_version
+  end
+
+  if defined?($RNGoogleMobileAdsSDKVersion)
+    Pod::UI.puts "#{s.name}: Using user specified Google Mobile-Ads SDK version '#{$RNGoogleMobileAdsSDKVersion}'"
+    google_mobile_ads_sdk_version = $RNGoogleMobileAdsSDKVersion
+  end
+
+  # AdMob dependencies
+  if !ENV['MAC_CATALYST']
+  s.dependency          'Google-Mobile-Ads-SDK', google_mobile_ads_sdk_version
+  end
+
+  if defined?($RNGoogleMobileAdsAsStaticFramework)
+    Pod::UI.puts "#{s.name}: Using overridden static_framework value of '#{$RNGoogleMobileAdsAsStaticFramework}'"
+    s.static_framework = $RNGoogleMobileAdsAsStaticFramework
+  else
+    s.static_framework = false
+  end
+end

package/__tests__/banner.test.tsx

@@ -0,0 +1,53 @@
+import * as ReactNative from 'react-native';
+import React from 'react';
+import { render } from '@testing-library/react-native';
+import { BannerAd, BannerAdSize } from '../src';
+
+const MOCK_ID = 'MOCK_ID';
+
+jest.doMock('react-native', () => {
+  return Object.setPrototypeOf(
+    {
+      ...ReactNative,
+      Platform: {
+        OS: 'android',
+        select: () => {},
+      },
+    },
+    ReactNative,
+  );
+});
+
+describe('Google Mobile Ads Banner', function () {
+  it('throws if no unit ID was provided.', function () {
+    let errorMsg;
+    try {
+      render(<BannerAd unitId="" size={BannerAdSize.BANNER} />);
+    } catch (e) {
+      errorMsg = e.message;
+    }
+    expect(errorMsg).toEqual("BannerAd: 'unitId' expected a valid string unit ID.");
+  });
+
+  it('throws if size does not exist.', function () {
+    let errorMsg;
+    try {
+      render(<BannerAd unitId={MOCK_ID} size="NON_EXISTENT_SIZE" />);
+    } catch (e) {
+      errorMsg = e.message;
+    }
+    expect(errorMsg).toEqual(
+      "BannerAd: 'size(s)' expected a valid BannerAdSize or custom size string.",
+    );
+  });
+
+  it('throws if requestOptions is invalid.', function () {
+    let errorMsg;
+    try {
+      render(<BannerAd unitId={MOCK_ID} size={BannerAdSize.BANNER} requestOptions={'options'} />);
+    } catch (e) {
+      errorMsg = e.message;
+    }
+    expect(errorMsg).toEqual("BannerAd: 'options' expected an object value");
+  });
+});

package/__tests__/consent.test.ts

@@ -0,0 +1,33 @@
+import { AdsConsent } from '../src';
+
+describe('Google Mobile Ads AdsConsent', function () {
+  describe('requestInfoUpdate', function () {
+    it('throws if options are not an object', function () {
+      // @ts-ignore
+      expect(() => AdsConsent.requestInfoUpdate('123')).toThrow(
+        "AdsConsent.requestInfoUpdate(*) 'options' expected an object value.",
+      );
+    });
+
+    it('throws if options.debugGeography is not a valid value.', function () {
+      // @ts-ignore
+      expect(() => AdsConsent.requestInfoUpdate({ debugGeography: -1 })).toThrow(
+        "AdsConsent.requestInfoUpdate(*) 'options.debugGeography' expected one of AdsConsentDebugGeography.DISABLED, AdsConsentDebugGeography.EEA, AdsConsentDebugGeography.NOT_EEA, AdsConsentDebugGeography.REGULATED_US_STATE or AdsConsentDebugGeography.OTHER.",
+      );
+    });
+
+    it('throws if options.tagForUnderAgeOfConsent is not a boolean.', function () {
+      // @ts-ignore
+      expect(() => AdsConsent.requestInfoUpdate({ tagForUnderAgeOfConsent: '123' })).toThrow(
+        "AdsConsent.requestInfoUpdate(*) 'options.tagForUnderAgeOfConsent' expected a boolean value.",
+      );
+    });
+
+    it('throws if options.testDeviceIdentifiers is not an array', function () {
+      // @ts-ignore
+      expect(() => AdsConsent.requestInfoUpdate({ testDeviceIdentifiers: '123' })).toThrow(
+        "AdsConsent.requestInfoUpdate(*) 'options.testDeviceIdentifiers' expected an array of string values.",
+      );
+    });
+  });
+});

package/__tests__/googleMobileAds.test.ts

@@ -0,0 +1,108 @@
+import admob, { MaxAdContentRating } from '../src';
+import RNGoogleMobileAdsModule from '../src/specs/modules/NativeGoogleMobileAdsModule';
+
+describe('Admob', function () {
+  describe('setRequestConfiguration()', function () {
+    it('throws if config is not an object', function () {
+      // @ts-ignore
+      expect(() => admob().setRequestConfiguration('123')).toThrow(
+        "setRequestConfiguration(*) 'requestConfiguration' expected an object value",
+      );
+    });
+
+    describe('maxAdContentRating', function () {
+      it('throws if maxAdContentRating is invalid', function () {
+        expect(() =>
+          admob().setRequestConfiguration({
+            maxAdContentRating: 'Y' as MaxAdContentRating,
+          }),
+        ).toThrow(
+          "setRequestConfiguration(*) 'requestConfiguration.maxAdContentRating' expected one of G, PG, T, MA",
+        );
+      });
+    });
+
+    describe('tagForChildDirectedTreatment', function () {
+      it('throws if tagForChildDirectedTreatment not a boolean', function () {
+        expect(() =>
+          admob().setRequestConfiguration({
+            // @ts-ignore
+            tagForChildDirectedTreatment: 'true',
+          }),
+        ).toThrow(
+          "setRequestConfiguration(*) 'requestConfiguration.tagForChildDirectedTreatment' expected a boolean value",
+        );
+      });
+    });
+
+    describe('tagForUnderAgeOfConsent', function () {
+      it('throws if tagForUnderAgeOfConsent not a boolean', function () {
+        expect(() =>
+          admob().setRequestConfiguration({
+            // @ts-ignore
+            tagForUnderAgeOfConsent: 'false',
+          }),
+        ).toThrow(
+          "setRequestConfiguration(*) 'requestConfiguration.tagForUnderAgeOfConsent' expected a boolean value",
+        );
+      });
+    });
+
+    describe('testDeviceIdentifiers', function () {
+      it('throws if testDeviceIdentifiers not an array', function () {
+        expect(() =>
+          admob().setRequestConfiguration({
+            // @ts-ignore
+            testDeviceIdentifiers: 'EMULATOR',
+          }),
+        ).toThrow(
+          "setRequestConfiguration(*) 'requestConfiguration.testDeviceIdentifiers' expected an array value",
+        );
+      });
+    });
+
+    describe('testDebugMenu', function () {
+      it('does call native initialize method', () => {
+        admob().initialize();
+        expect(RNGoogleMobileAdsModule.initialize).toHaveBeenCalledTimes(1);
+      });
+
+      it('does call native setRequestConfiguration method', () => {
+        admob().setRequestConfiguration({ tagForChildDirectedTreatment: true });
+        expect(RNGoogleMobileAdsModule.setRequestConfiguration).toHaveBeenCalledTimes(1);
+      });
+
+      it('does call native openAdInspector method', () => {
+        admob().openAdInspector();
+        expect(RNGoogleMobileAdsModule.openAdInspector).toHaveBeenCalledTimes(1);
+      });
+
+      it('does call native openDebugMenu method', () => {
+        admob().openDebugMenu('12345');
+        expect(RNGoogleMobileAdsModule.openDebugMenu).toHaveBeenCalledTimes(1);
+      });
+
+      it('throws if adUnit is empty', function () {
+        expect(() => {
+          admob().openDebugMenu('');
+        }).toThrow('openDebugMenu expected a non-empty string value');
+      });
+
+      it('does call native setAppVolume method', () => {
+        admob().setAppVolume(0.5);
+        expect(RNGoogleMobileAdsModule.setAppVolume).toHaveBeenCalledTimes(1);
+      });
+
+      it('throws if setAppVolume is greater than 1', function () {
+        expect(() => {
+          admob().setAppVolume(2);
+        }).toThrow('The app volume must be a value between 0 and 1 inclusive.');
+      });
+
+      it('does call native setAppMuted method', () => {
+        admob().setAppMuted(true);
+        expect(RNGoogleMobileAdsModule.setAppMuted).toHaveBeenCalledTimes(1);
+      });
+    });
+  });
+});

package/__tests__/interstitial.test.ts

@@ -0,0 +1,140 @@
+import { AdEventType, InterstitialAd } from '../src';
+import NativeInterstitialModule from '../src/specs/modules/NativeInterstitialModule';
+
+describe('Google Mobile Ads Interstitial', function () {
+  describe('createForAdRequest', function () {
+    it('throws if adUnitId is invalid', function () {
+      // @ts-ignore
+      expect(() => InterstitialAd.createForAdRequest(123)).toThrow(
+        "'adUnitId' expected an string value",
+      );
+    });
+
+    it('throws if requestOptions are invalid', function () {
+      // @ts-ignore
+      expect(() => InterstitialAd.createForAdRequest('123', 123)).toThrow(
+        "InterstitialAd.createForAdRequest(_, *) 'options' expected an object value.",
+      );
+    });
+
+    // has own tests
+    it('returns a new instance', function () {
+      const i = InterstitialAd.createForAdRequest('abc');
+      expect(i.constructor.name).toEqual('InterstitialAd');
+      expect(i.adUnitId).toEqual('abc');
+      expect(i.loaded).toEqual(false);
+    });
+
+    describe('load()', () => {
+      afterEach(() => {
+        jest.clearAllMocks();
+      });
+
+      it('does call native load method', () => {
+        const ad = InterstitialAd.createForAdRequest('abc');
+
+        ad.load();
+        expect(NativeInterstitialModule.interstitialLoad).toHaveBeenCalledTimes(1);
+      });
+
+      it('does nothing if ad currently loading', () => {
+        const ad = InterstitialAd.createForAdRequest('abc');
+
+        ad.load();
+        expect(NativeInterstitialModule.interstitialLoad).toHaveBeenCalledTimes(1);
+
+        ad.load();
+        expect(NativeInterstitialModule.interstitialLoad).toHaveBeenCalledTimes(1);
+      });
+
+      it('does nothing if ad is already loaded', () => {
+        const ad = InterstitialAd.createForAdRequest('abc');
+
+        // @ts-ignore
+        ad._handleAdEvent({ body: { type: AdEventType.LOADED } });
+
+        ad.load();
+        expect(NativeInterstitialModule.interstitialLoad).not.toHaveBeenCalled();
+      });
+
+      it('can be called again after ad was closed', () => {
+        const ad = InterstitialAd.createForAdRequest('abc');
+
+        ad.load();
+        expect(NativeInterstitialModule.interstitialLoad).toHaveBeenCalledTimes(1);
+
+        // @ts-ignore
+        ad._handleAdEvent({ body: { type: AdEventType.CLOSED } });
+
+        ad.load();
+        expect(NativeInterstitialModule.interstitialLoad).toHaveBeenCalledTimes(2);
+      });
+
+      it('can be called again after ad failed to load', () => {
+        const ad = InterstitialAd.createForAdRequest('abc');
+
+        ad.load();
+        expect(NativeInterstitialModule.interstitialLoad).toHaveBeenCalledTimes(1);
+
+        // @ts-ignore
+        ad._handleAdEvent({ body: { type: AdEventType.ERROR } });
+
+        ad.load();
+        expect(NativeInterstitialModule.interstitialLoad).toHaveBeenCalledTimes(2);
+      });
+    });
+
+    describe('show', function () {
+      it('throws if showing before loaded', function () {
+        const i = InterstitialAd.createForAdRequest('abc');
+
+        expect(() => i.show()).toThrow(
+          'The requested InterstitialAd has not loaded and could not be shown',
+        );
+      });
+    });
+
+    describe('addAdEventsListener', function () {
+      it('throws if listener is not a function', function () {
+        const i = InterstitialAd.createForAdRequest('abc');
+
+        // @ts-ignore
+        expect(() => i.addAdEventsListener('foo')).toThrow("'listener' expected a function");
+      });
+
+      it('returns an unsubscriber function', function () {
+        const i = InterstitialAd.createForAdRequest('abc');
+        const unsub = i.addAdEventsListener(() => {});
+        expect(unsub).toBeDefined();
+        unsub();
+      });
+    });
+
+    describe('addAdEventListener', function () {
+      it('throws if type is not a AdEventType', function () {
+        const i = InterstitialAd.createForAdRequest('abc');
+
+        // @ts-ignore
+        expect(() => i.addAdEventListener('foo')).toThrow(
+          "'type' expected a valid event type value.",
+        );
+      });
+
+      it('throws if listener is not a function', function () {
+        const i = InterstitialAd.createForAdRequest('abc');
+
+        // @ts-ignore
+        expect(() => i.addAdEventListener(AdEventType.LOADED, 'foo')).toThrow(
+          "'listener' expected a function",
+        );
+      });
+
+      it('returns an unsubscriber function', function () {
+        const i = InterstitialAd.createForAdRequest('abc');
+        const unsub = i.addAdEventListener(AdEventType.LOADED, () => {});
+        expect(unsub).toBeDefined();
+        unsub();
+      });
+    });
+  });
+});