react-native-pangleads 0.1.0

package/nitrogen/generated/shared/c++/PangleAdEventType.hpp

@@ -0,0 +1,96 @@
+///
+/// PangleAdEventType.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/NitroHash.hpp>)
+#include <NitroModules/NitroHash.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/JSIConverter.hpp>)
+#include <NitroModules/JSIConverter.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/NitroDefines.hpp>)
+#include <NitroModules/NitroDefines.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+namespace margelo::nitro::pangleads {
+
+  /**
+   * An enum which can be represented as a JavaScript union (PangleAdEventType).
+   */
+  enum class PangleAdEventType {
+    LOADED      SWIFT_NAME(loaded) = 0,
+    ERROR      SWIFT_NAME(error) = 1,
+    OPENED      SWIFT_NAME(opened) = 2,
+    CLICKED      SWIFT_NAME(clicked) = 3,
+    CLOSED      SWIFT_NAME(closed) = 4,
+    REWARDED_LOADED      SWIFT_NAME(rewardedLoaded) = 5,
+    REWARDED_EARNED_REWARD      SWIFT_NAME(rewardedEarnedReward) = 6,
+  } CLOSED_ENUM;
+
+} // namespace margelo::nitro::pangleads
+
+namespace margelo::nitro {
+
+  // C++ PangleAdEventType <> JS PangleAdEventType (union)
+  template <>
+  struct JSIConverter<margelo::nitro::pangleads::PangleAdEventType> final {
+    static inline margelo::nitro::pangleads::PangleAdEventType fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      std::string unionValue = JSIConverter<std::string>::fromJSI(runtime, arg);
+      switch (hashString(unionValue.c_str(), unionValue.size())) {
+        case hashString("loaded"): return margelo::nitro::pangleads::PangleAdEventType::LOADED;
+        case hashString("error"): return margelo::nitro::pangleads::PangleAdEventType::ERROR;
+        case hashString("opened"): return margelo::nitro::pangleads::PangleAdEventType::OPENED;
+        case hashString("clicked"): return margelo::nitro::pangleads::PangleAdEventType::CLICKED;
+        case hashString("closed"): return margelo::nitro::pangleads::PangleAdEventType::CLOSED;
+        case hashString("rewarded_loaded"): return margelo::nitro::pangleads::PangleAdEventType::REWARDED_LOADED;
+        case hashString("rewarded_earned_reward"): return margelo::nitro::pangleads::PangleAdEventType::REWARDED_EARNED_REWARD;
+        default: [[unlikely]]
+          throw std::invalid_argument("Cannot convert \"" + unionValue + "\" to enum PangleAdEventType - invalid value!");
+      }
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, margelo::nitro::pangleads::PangleAdEventType arg) {
+      switch (arg) {
+        case margelo::nitro::pangleads::PangleAdEventType::LOADED: return JSIConverter<std::string>::toJSI(runtime, "loaded");
+        case margelo::nitro::pangleads::PangleAdEventType::ERROR: return JSIConverter<std::string>::toJSI(runtime, "error");
+        case margelo::nitro::pangleads::PangleAdEventType::OPENED: return JSIConverter<std::string>::toJSI(runtime, "opened");
+        case margelo::nitro::pangleads::PangleAdEventType::CLICKED: return JSIConverter<std::string>::toJSI(runtime, "clicked");
+        case margelo::nitro::pangleads::PangleAdEventType::CLOSED: return JSIConverter<std::string>::toJSI(runtime, "closed");
+        case margelo::nitro::pangleads::PangleAdEventType::REWARDED_LOADED: return JSIConverter<std::string>::toJSI(runtime, "rewarded_loaded");
+        case margelo::nitro::pangleads::PangleAdEventType::REWARDED_EARNED_REWARD: return JSIConverter<std::string>::toJSI(runtime, "rewarded_earned_reward");
+        default: [[unlikely]]
+          throw std::invalid_argument("Cannot convert PangleAdEventType to JS - invalid value: "
+                                    + std::to_string(static_cast<int>(arg)) + "!");
+      }
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isString()) {
+        return false;
+      }
+      std::string unionValue = JSIConverter<std::string>::fromJSI(runtime, value);
+      switch (hashString(unionValue.c_str(), unionValue.size())) {
+        case hashString("loaded"):
+        case hashString("error"):
+        case hashString("opened"):
+        case hashString("clicked"):
+        case hashString("closed"):
+        case hashString("rewarded_loaded"):
+        case hashString("rewarded_earned_reward"):
+          return true;
+        default:
+          return false;
+      }
+    }
+  };
+
+} // namespace margelo::nitro

package/nitrogen/generated/shared/c++/PangleAdVerificationOptions.hpp

@@ -0,0 +1,72 @@
+///
+/// PangleAdVerificationOptions.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/JSIConverter.hpp>)
+#include <NitroModules/JSIConverter.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/NitroDefines.hpp>)
+#include <NitroModules/NitroDefines.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+
+
+#include <string>
+#include <optional>
+
+namespace margelo::nitro::pangleads {
+
+  /**
+   * A struct which can be represented as a JavaScript object (PangleAdVerificationOptions).
+   */
+  struct PangleAdVerificationOptions {
+  public:
+    std::optional<std::string> userId     SWIFT_PRIVATE;
+    std::optional<std::string> customData     SWIFT_PRIVATE;
+
+  public:
+    PangleAdVerificationOptions() = default;
+    explicit PangleAdVerificationOptions(std::optional<std::string> userId, std::optional<std::string> customData): userId(userId), customData(customData) {}
+  };
+
+} // namespace margelo::nitro::pangleads
+
+namespace margelo::nitro {
+
+  // C++ PangleAdVerificationOptions <> JS PangleAdVerificationOptions (object)
+  template <>
+  struct JSIConverter<margelo::nitro::pangleads::PangleAdVerificationOptions> final {
+    static inline margelo::nitro::pangleads::PangleAdVerificationOptions fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::pangleads::PangleAdVerificationOptions(
+        JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, "userId")),
+        JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, "customData"))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::pangleads::PangleAdVerificationOptions& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, "userId", JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.userId));
+      obj.setProperty(runtime, "customData", JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.customData));
+      return obj;
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isObject()) {
+        return false;
+      }
+      jsi::Object obj = value.getObject(runtime);
+      if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, "userId"))) return false;
+      if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, "customData"))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

package/package.json

@@ -0,0 +1,177 @@
+{
+  "name": "react-native-pangleads",
+  "version": "0.1.0",
+  "description": "Nitro Modules bridge for the Pangle Ads SDK",
+  "main": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "exports": {
+    ".": {
+      "react-native-pangleads-source": "./src/index.ts",
+      "types": "./lib/typescript/src/index.d.ts",
+      "default": "./lib/module/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "cpp",
+    "nitrogen",
+    "nitro.json",
+    "*.podspec",
+    "react-native.config.js",
+    "!ios/build",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
+  ],
+  "scripts": {
+    "example": "yarn workspace react-native-pangleads-example",
+    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
+    "prepare": "bob build",
+    "nitrogen": "nitrogen",
+    "typecheck": "tsc",
+    "lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "test": "jest",
+    "release": "release-it --only-version"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/exzos28/react-native-pangleads.git"
+  },
+  "author": "exzos <oleksandr.kurinnyi.work@gmail.com> (https://github.com/exzos28)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/exzos28/react-native-pangleads/issues"
+  },
+  "homepage": "https://github.com/exzos28/react-native-pangleads#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@commitlint/config-conventional": "^21.0.2",
+    "@eslint/compat": "^2.1.0",
+    "@eslint/eslintrc": "^3.3.5",
+    "@eslint/js": "^10.0.1",
+    "@jest/globals": "^29.7.0",
+    "@react-native/babel-preset": "0.85.0",
+    "@react-native/eslint-config": "0.85.0",
+    "@react-native/jest-preset": "0.85.0",
+    "@release-it/conventional-changelog": "^11.0.1",
+    "@types/jest": "29.5.14",
+    "@types/react": "^19.2.0",
+    "commitlint": "^21.0.2",
+    "del-cli": "^7.0.0",
+    "eslint": "^9.39.4",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-ft-flow": "^3.0.11",
+    "eslint-plugin-prettier": "^5.5.6",
+    "expo": "*",
+    "jest": "^29.7.0",
+    "lefthook": "^2.1.9",
+    "nitrogen": "0.29.6",
+    "prettier": "^3.8.3",
+    "react": "19.2.3",
+    "react-native": "0.85.0",
+    "react-native-builder-bob": "^0.43.0",
+    "react-native-nitro-modules": "^0.29.6",
+    "release-it": "^20.2.0",
+    "turbo": "^2.9.16",
+    "typescript": "^6.0.3"
+  },
+  "peerDependencies": {
+    "expo": "*",
+    "react": "*",
+    "react-native": "*",
+    "react-native-nitro-modules": "^0.29.6"
+  },
+  "peerDependenciesMeta": {
+    "expo": {
+      "optional": true
+    }
+  },
+  "workspaces": [
+    "example"
+  ],
+  "packageManager": "yarn@4.11.0",
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "custom",
+        {
+          "script": "nitrogen",
+          "clean": "nitrogen/"
+        }
+      ],
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "commitlint": {
+    "extends": [
+      "@commitlint/config-conventional"
+    ]
+  },
+  "release-it": {
+    "git": {
+      "commitMessage": "chore: release ${version}",
+      "tagName": "v${version}"
+    },
+    "npm": {
+      "publish": true
+    },
+    "github": {
+      "release": true
+    },
+    "plugins": {
+      "@release-it/conventional-changelog": {
+        "preset": {
+          "name": "angular"
+        }
+      }
+    }
+  },
+  "create-react-native-library": {
+    "type": "nitro-module",
+    "languages": "kotlin-swift",
+    "tools": [
+      "eslint",
+      "jest",
+      "lefthook",
+      "release-it"
+    ],
+    "version": "0.63.0"
+  }
+}

package/react-native.config.js

@@ -0,0 +1,8 @@
+module.exports = {
+  dependency: {
+    platforms: {
+      ios: {},
+      android: {},
+    },
+  },
+};

package/src/index.test.ts

@@ -0,0 +1,255 @@
+import type {
+  PangleAdEventPayload,
+  PangleAdEventType,
+} from './specs/PangleAds.nitro';
+
+type Listener = (payload?: PangleAdEventPayload) => void;
+
+class MockNativeAd {
+  load = jest.fn();
+  show = jest.fn(async () => undefined);
+  removeAllListeners = jest.fn(() => {
+    this.listeners.clear();
+  });
+
+  private listeners = new Map<PangleAdEventType, Set<Listener>>();
+  private nextId = 1;
+  private idToEntry = new Map<
+    number,
+    { type: PangleAdEventType; listener: Listener }
+  >();
+
+  addAdEventListener = jest.fn(
+    (eventType: PangleAdEventType, listener: Listener) => {
+      const set = this.listeners.get(eventType) ?? new Set<Listener>();
+      set.add(listener);
+      this.listeners.set(eventType, set);
+      const id = this.nextId++;
+      this.idToEntry.set(id, { type: eventType, listener });
+      return id;
+    }
+  );
+
+  removeAdEventListener = jest.fn((subscriptionId: number) => {
+    const entry = this.idToEntry.get(subscriptionId);
+    if (!entry) {
+      return;
+    }
+    this.listeners.get(entry.type)?.delete(entry.listener);
+    this.idToEntry.delete(subscriptionId);
+  });
+
+  emit(eventType: PangleAdEventType, payload?: PangleAdEventPayload): void {
+    for (const listener of this.listeners.get(eventType) ?? []) {
+      listener(payload);
+    }
+  }
+}
+
+const mockCreatedInterstitials: MockNativeAd[] = [];
+const mockCreatedRewarded: MockNativeAd[] = [];
+
+jest.mock('react-native-nitro-modules', () => ({
+  NitroModules: {
+    createHybridObject: () => ({
+      initialize: jest.fn(async () => undefined),
+      setGDPRConsent: jest.fn(),
+      setCCPAConsent: jest.fn(),
+      setCOPPA: jest.fn(),
+      createInterstitialAd: jest.fn(() => {
+        const ad = new MockNativeAd();
+        mockCreatedInterstitials.push(ad);
+        return ad;
+      }),
+      createRewardedAd: jest.fn(() => {
+        const ad = new MockNativeAd();
+        mockCreatedRewarded.push(ad);
+        return ad;
+      }),
+    }),
+  },
+}));
+
+import {
+  AdEventType,
+  InterstitialAd,
+  MobileAds,
+  RewardedAd,
+  RewardedAdEventType,
+} from './index';
+
+beforeEach(() => {
+  mockCreatedInterstitials.length = 0;
+  mockCreatedRewarded.length = 0;
+});
+
+describe('InterstitialAd.createForAdRequest', () => {
+  it('throws for an empty ad unit id', () => {
+    expect(() => InterstitialAd.createForAdRequest('')).toThrow(
+      /expected a non-empty string value/
+    );
+  });
+
+  it('creates a native ad for a valid ad unit id', () => {
+    InterstitialAd.createForAdRequest('unit-1');
+    expect(mockCreatedInterstitials).toHaveLength(1);
+  });
+});
+
+describe('InterstitialAd load/show lifecycle', () => {
+  it('is not loaded until the native LOADED event fires', () => {
+    const ad = InterstitialAd.createForAdRequest('unit-1');
+    expect(ad.loaded).toBe(false);
+
+    ad.load();
+    expect(mockCreatedInterstitials[0]!.load).toHaveBeenCalledTimes(1);
+    expect(ad.loaded).toBe(false);
+
+    mockCreatedInterstitials[0]!.emit('loaded');
+    expect(ad.loaded).toBe(true);
+  });
+
+  it('does not call native load twice while a load is pending', () => {
+    const ad = InterstitialAd.createForAdRequest('unit-1');
+    ad.load();
+    ad.load();
+    expect(mockCreatedInterstitials[0]!.load).toHaveBeenCalledTimes(1);
+  });
+
+  it('throws synchronously when show() is called before the ad has loaded', () => {
+    const ad = InterstitialAd.createForAdRequest('unit-1');
+    expect(() => ad.show()).toThrow(/has not loaded and could not be shown/);
+  });
+
+  it('delegates to the native ad once loaded', async () => {
+    const ad = InterstitialAd.createForAdRequest('unit-1');
+    mockCreatedInterstitials[0]!.emit('loaded');
+
+    await ad.show();
+    expect(mockCreatedInterstitials[0]!.show).toHaveBeenCalledTimes(1);
+  });
+
+  it('resets loaded/load state on CLOSED so the ad can be reloaded', () => {
+    const ad = InterstitialAd.createForAdRequest('unit-1');
+    ad.load();
+    mockCreatedInterstitials[0]!.emit('loaded');
+    mockCreatedInterstitials[0]!.emit('closed');
+
+    expect(ad.loaded).toBe(false);
+    ad.load();
+    expect(mockCreatedInterstitials[0]!.load).toHaveBeenCalledTimes(2);
+  });
+
+  it('resets loaded/load state on ERROR so the ad can be retried', () => {
+    const ad = InterstitialAd.createForAdRequest('unit-1');
+    ad.load();
+    mockCreatedInterstitials[0]!.emit('error', { errorMessage: 'boom' });
+
+    expect(ad.loaded).toBe(false);
+    ad.load();
+    expect(mockCreatedInterstitials[0]!.load).toHaveBeenCalledTimes(2);
+  });
+});
+
+describe('InterstitialAd error payload', () => {
+  it('maps the native error payload to a JS Error', () => {
+    const ad = InterstitialAd.createForAdRequest('unit-1');
+    const handler = jest.fn();
+    ad.addAdEventListener(AdEventType.ERROR, handler);
+
+    mockCreatedInterstitials[0]!.emit('error', {
+      errorCode: 42,
+      errorMessage: 'no fill',
+    });
+
+    expect(handler).toHaveBeenCalledTimes(1);
+    const error = handler.mock.calls[0][0] as Error;
+    expect(error.message).toBe('no fill');
+    expect((error as Error & { code: string }).code).toBe('42');
+  });
+});
+
+describe('InterstitialAd listener subscriptions', () => {
+  it('stops notifying a listener after it unsubscribes', () => {
+    const ad = InterstitialAd.createForAdRequest('unit-1');
+    const handler = jest.fn();
+    const unsubscribe = ad.addAdEventListener(AdEventType.OPENED, handler);
+
+    mockCreatedInterstitials[0]!.emit('opened');
+    unsubscribe();
+    mockCreatedInterstitials[0]!.emit('opened');
+
+    expect(handler).toHaveBeenCalledTimes(1);
+  });
+
+  it('removeAllListeners clears listeners and forwards to the native ad', () => {
+    const ad = InterstitialAd.createForAdRequest('unit-1');
+    const handler = jest.fn();
+    ad.addAdEventListener(AdEventType.OPENED, handler);
+
+    ad.removeAllListeners();
+    expect(
+      mockCreatedInterstitials[0]!.removeAllListeners
+    ).toHaveBeenCalledTimes(1);
+
+    mockCreatedInterstitials[0]!.emit('opened');
+    expect(handler).not.toHaveBeenCalled();
+  });
+
+  it('addAdEventsListener receives every event type for the ad', () => {
+    const ad = InterstitialAd.createForAdRequest('unit-1');
+    const handler = jest.fn();
+    ad.addAdEventsListener(handler);
+
+    mockCreatedInterstitials[0]!.emit('opened');
+    mockCreatedInterstitials[0]!.emit('clicked');
+
+    expect(handler).toHaveBeenCalledWith({
+      type: 'opened',
+      payload: undefined,
+    });
+    expect(handler).toHaveBeenCalledWith({
+      type: 'clicked',
+      payload: undefined,
+    });
+  });
+});
+
+describe('RewardedAd', () => {
+  it('rejects AdEventType.LOADED in favor of RewardedAdEventType.LOADED', () => {
+    const ad = RewardedAd.createForAdRequest('unit-1');
+    expect(() =>
+      ad.addAdEventListener(AdEventType.LOADED as never, jest.fn())
+    ).toThrow(/use RewardedAdEventType.LOADED/);
+  });
+
+  it('does not fabricate reward data for LOADED or EARNED_REWARD events', () => {
+    const ad = RewardedAd.createForAdRequest('unit-1');
+    const onLoaded = jest.fn();
+    const onEarned = jest.fn();
+    ad.addAdEventListener(RewardedAdEventType.LOADED, onLoaded);
+    ad.addAdEventListener(RewardedAdEventType.EARNED_REWARD, onEarned);
+
+    mockCreatedRewarded[0]!.emit('rewarded_loaded');
+    mockCreatedRewarded[0]!.emit('rewarded_earned_reward');
+
+    expect(onLoaded).toHaveBeenCalledWith(undefined);
+    expect(onEarned).toHaveBeenCalledWith(undefined);
+  });
+
+  it('marks the ad as loaded on RewardedAdEventType.LOADED', () => {
+    const ad = RewardedAd.createForAdRequest('unit-1');
+    expect(ad.loaded).toBe(false);
+    mockCreatedRewarded[0]!.emit('rewarded_loaded');
+    expect(ad.loaded).toBe(true);
+  });
+});
+
+describe('MobileAds()', () => {
+  it('reports a ready adapter status after initialize resolves', async () => {
+    const statuses = await MobileAds().initialize('app-id');
+    expect(statuses).toEqual([
+      expect.objectContaining({ name: 'Pangle', state: 1 }),
+    ]);
+  });
+});