react-native-levelplayads 0.1.0

package/package.json

@@ -0,0 +1,170 @@
+{
+  "name": "react-native-levelplayads",
+  "version": "0.1.0",
+  "description": "Nitro Modules bridge for the LevelPlay (ironSource) mediation SDK",
+  "main": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "exports": {
+    ".": {
+      "react-native-levelplayads-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-levelplayads-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-levelplayads.git"
+  },
+  "author": "exzos <oleksandr.kurinnyi.work@gmail.com> (https://github.com/exzos28)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/exzos28/react-native-levelplayads/issues"
+  },
+  "homepage": "https://github.com/exzos28/react-native-levelplayads#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",
+    "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": {
+    "react": "*",
+    "react-native": "*",
+    "react-native-nitro-modules": "^0.29.6"
+  },
+  "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,119 @@
+// NitroModules.createHybridObject() is called twice: once by index.ts eagerly
+// at import time, once again below to obtain a reference for assertions. Both
+// calls must return the same object, hence the memoized instance.
+jest.mock('react-native-nitro-modules', () => {
+  let instance:
+    | {
+        initialize: jest.Mock;
+        load: jest.Mock;
+        show: jest.Mock;
+        setGDPRConsent: jest.Mock;
+        setCCPAConsent: jest.Mock;
+        setCOPPA: jest.Mock;
+      }
+    | undefined;
+
+  return {
+    NitroModules: {
+      createHybridObject: () => {
+        instance ??= {
+          initialize: jest.fn(async () => undefined),
+          load: jest.fn(async () => undefined),
+          show: jest.fn(async () => ({ state: 'completed' })),
+          setGDPRConsent: jest.fn(),
+          setCCPAConsent: jest.fn(),
+          setCOPPA: jest.fn(),
+        };
+        return instance;
+      },
+    },
+  };
+});
+
+import { NitroModules } from 'react-native-nitro-modules';
+
+import { LevelPlayAds } from './index';
+
+const mockNativeLevelPlayAds = NitroModules.createHybridObject(
+  'LevelPlayAds'
+) as unknown as {
+  initialize: jest.Mock;
+  load: jest.Mock;
+  show: jest.Mock;
+  setGDPRConsent: jest.Mock;
+  setCCPAConsent: jest.Mock;
+  setCOPPA: jest.Mock;
+};
+
+beforeEach(() => {
+  jest.clearAllMocks();
+});
+
+describe('LevelPlayAds().initialize', () => {
+  it('throws for an empty app key', () => {
+    expect(() => LevelPlayAds().initialize('')).toThrow(
+      /expected a non-empty string value/
+    );
+  });
+
+  it('defaults testMode to false', () => {
+    LevelPlayAds().initialize('app-key-1');
+    expect(mockNativeLevelPlayAds.initialize).toHaveBeenCalledWith(
+      'app-key-1',
+      false
+    );
+  });
+
+  it('forwards testMode when provided', () => {
+    LevelPlayAds().initialize('app-key-1', { testMode: true });
+    expect(mockNativeLevelPlayAds.initialize).toHaveBeenCalledWith(
+      'app-key-1',
+      true
+    );
+  });
+});
+
+describe('LevelPlayAds().load', () => {
+  it('throws for an empty ad unit id', () => {
+    expect(() => LevelPlayAds().load('interstitial', '')).toThrow(
+      /expected a non-empty string value/
+    );
+  });
+
+  it('delegates to the native module', async () => {
+    await LevelPlayAds().load('interstitial', 'ad-unit-1');
+    expect(mockNativeLevelPlayAds.load).toHaveBeenCalledWith(
+      'interstitial',
+      'ad-unit-1'
+    );
+  });
+});
+
+describe('LevelPlayAds().show', () => {
+  it('throws for an empty ad unit id', () => {
+    expect(() => LevelPlayAds().show('rewarded', '')).toThrow(
+      /expected a non-empty string value/
+    );
+  });
+
+  it('resolves with the native show result', async () => {
+    const result = await LevelPlayAds().show('rewarded', 'ad-unit-1');
+    expect(mockNativeLevelPlayAds.show).toHaveBeenCalledWith(
+      'rewarded',
+      'ad-unit-1'
+    );
+    expect(result).toEqual({ state: 'completed' });
+  });
+});
+
+describe('LevelPlayAds() consent setters', () => {
+  it('forwards GDPR/CCPA/COPPA flags to the native module', () => {
+    LevelPlayAds().setGDPRConsent(true);
+    LevelPlayAds().setCCPAConsent(false);
+    LevelPlayAds().setCOPPA(true);
+
+    expect(mockNativeLevelPlayAds.setGDPRConsent).toHaveBeenCalledWith(true);
+    expect(mockNativeLevelPlayAds.setCCPAConsent).toHaveBeenCalledWith(false);
+    expect(mockNativeLevelPlayAds.setCOPPA).toHaveBeenCalledWith(true);
+  });
+});

package/src/index.ts

@@ -0,0 +1,71 @@
+import { NitroModules } from 'react-native-nitro-modules';
+
+import type {
+  LevelPlayAdShowResult,
+  LevelPlayAdType,
+  LevelPlayAds as NativeLevelPlayAds,
+} from './specs/LevelPlayAds.nitro';
+
+export interface LevelPlayAdsInitializeOptions {
+  testMode?: boolean;
+}
+
+export interface LevelPlayAdsModuleInterface {
+  initialize(
+    appKey: string,
+    options?: LevelPlayAdsInitializeOptions
+  ): Promise<void>;
+  load(adType: LevelPlayAdType, adUnitId: string): Promise<void>;
+  show(
+    adType: LevelPlayAdType,
+    adUnitId: string
+  ): Promise<LevelPlayAdShowResult>;
+  setGDPRConsent(optIn: boolean): void;
+  setCCPAConsent(optIn: boolean): void;
+  setCOPPA(isCoppa: boolean): void;
+}
+
+const nativeLevelPlayAds =
+  NitroModules.createHybridObject<NativeLevelPlayAds>('LevelPlayAds');
+
+function requireAdUnitId(methodName: string, adUnitId: string): void {
+  if (typeof adUnitId !== 'string' || adUnitId.length === 0) {
+    throw new Error(
+      `LevelPlayAds.${methodName}(*) 'adUnitId' expected a non-empty string value.`
+    );
+  }
+}
+
+const levelPlayAdsInstance: LevelPlayAdsModuleInterface = {
+  initialize(appKey, options) {
+    if (typeof appKey !== 'string' || appKey.length === 0) {
+      throw new Error(
+        "LevelPlayAds.initialize(*) 'appKey' expected a non-empty string value."
+      );
+    }
+    return nativeLevelPlayAds.initialize(appKey, options?.testMode ?? false);
+  },
+  load(adType, adUnitId) {
+    requireAdUnitId('load', adUnitId);
+    return nativeLevelPlayAds.load(adType, adUnitId);
+  },
+  show(adType, adUnitId) {
+    requireAdUnitId('show', adUnitId);
+    return nativeLevelPlayAds.show(adType, adUnitId);
+  },
+  setGDPRConsent: (optIn) => nativeLevelPlayAds.setGDPRConsent(optIn),
+  setCCPAConsent: (optIn) => nativeLevelPlayAds.setCCPAConsent(optIn),
+  setCOPPA: (isCoppa) => nativeLevelPlayAds.setCOPPA(isCoppa),
+};
+
+export const LevelPlayAds = (): LevelPlayAdsModuleInterface =>
+  levelPlayAdsInstance;
+
+export default LevelPlayAds;
+
+export type {
+  LevelPlayAdShowResult,
+  LevelPlayAdShowState,
+  LevelPlayAdType,
+  LevelPlayAds as LevelPlayAdsSpec,
+} from './specs/LevelPlayAds.nitro';

package/src/specs/LevelPlayAds.nitro.ts

@@ -0,0 +1,26 @@
+import type { HybridObject } from 'react-native-nitro-modules';
+
+export type LevelPlayAdShowState = 'completed' | 'skipped';
+
+export interface LevelPlayAdShowResult {
+  state: LevelPlayAdShowState;
+}
+
+export type LevelPlayAdType = 'interstitial' | 'rewarded';
+
+export interface LevelPlayAds extends HybridObject<{
+  ios: 'swift';
+  android: 'kotlin';
+}> {
+  initialize(appKey: string, testMode: boolean): Promise<void>;
+
+  load(adType: LevelPlayAdType, adUnitId: string): Promise<void>;
+  show(
+    adType: LevelPlayAdType,
+    adUnitId: string
+  ): Promise<LevelPlayAdShowResult>;
+
+  setGDPRConsent(optIn: boolean): void;
+  setCCPAConsent(optIn: boolean): void;
+  setCOPPA(isCoppa: boolean): void;
+}