cloudx-react-native 3.4.7 → 3.6.0

package/lib/typescript/src/types/AppOpenAd.d.ts

@@ -0,0 +1,8 @@
+import type { CloudXFullscreenAdType } from './FullscreenAd';
+/**
+ * App Open ad type — identical to the fullscreen ad interface.
+ * Provides a named type for consumers and a place to add app-open-specific
+ * methods in the future without refactoring.
+ */
+export type CloudXAppOpenAdType = CloudXFullscreenAdType;
+//# sourceMappingURL=AppOpenAd.d.ts.map

package/lib/typescript/src/types/AppOpenAd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppOpenAd.d.ts","sourceRoot":"","sources":["../../../../src/types/AppOpenAd.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAE7D;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,sBAAsB,CAAC"}

package/lib/typescript/src/types/CloudX.d.ts

@@ -1,5 +1,6 @@
 import type { CloudXInitializationResult } from './Configuration';
 import type { CloudXArbiterConfiguration, CloudXArbiterResult } from './Arbiter';
+import type { CloudXRevenueData } from './RevenueData';
 export type CloudXLogLevelValue = 'verbose' | 'debug' | 'info' | 'warn' | 'error' | 'none';
 /**
  * Main CloudX SDK module interface.
@@ -43,5 +44,10 @@ export type CloudXType = {
     setDoNotSell(isDoNotSell: boolean | null): void;
     /** Runs CloudX Arbiter using bid data passed through to the native SDK. */
     arbiter(configuration: CloudXArbiterConfiguration): Promise<CloudXArbiterResult>;
+    /**
+     * Reports publisher-observed revenue data.
+     * Resolves false when unsupported, invalid, or rejected.
+     */
+    reportRevenueData(data: CloudXRevenueData): Promise<boolean>;
 };
 //# sourceMappingURL=CloudX.d.ts.map

package/lib/typescript/src/types/CloudX.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CloudX.d.ts","sourceRoot":"","sources":["../../../../src/types/CloudX.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,KAAK,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEjF,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAE3F;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACrB,oDAAoD;IACpD,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAElC,yDAAyD;IACzD,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAEhE,qDAAqD;IACrD,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAE7B,6CAA6C;IAC7C,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAE9B,yDAAyD;IACzD,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAEjD,2CAA2C;IAC3C,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5C,sDAAsD;IACtD,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAElD,sDAAsD;IACtD,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjD,uCAAuC;IACvC,iBAAiB,IAAI,IAAI,CAAC;IAE1B,iFAAiF;IACjF,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAElD;;;;;;OAMG;IACH,iBAAiB,CAAC,cAAc,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC;IAExD;;;;;;OAMG;IACH,YAAY,CAAC,WAAW,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC;IAEhD,2EAA2E;IAC3E,OAAO,CAAC,aAAa,EAAE,0BAA0B,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACpF,CAAC"}
+{"version":3,"file":"CloudX.d.ts","sourceRoot":"","sources":["../../../../src/types/CloudX.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,KAAK,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACjF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAE3F;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACrB,oDAAoD;IACpD,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAElC,yDAAyD;IACzD,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAEhE,qDAAqD;IACrD,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAE7B,6CAA6C;IAC7C,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAE9B,yDAAyD;IACzD,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAEjD,2CAA2C;IAC3C,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5C,sDAAsD;IACtD,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAElD,sDAAsD;IACtD,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjD,uCAAuC;IACvC,iBAAiB,IAAI,IAAI,CAAC;IAE1B,iFAAiF;IACjF,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAElD;;;;;;OAMG;IACH,iBAAiB,CAAC,cAAc,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC;IAExD;;;;;;OAMG;IACH,YAAY,CAAC,WAAW,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC;IAEhD,2EAA2E;IAC3E,OAAO,CAAC,aAAa,EAAE,0BAA0B,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEjF;;;OAGG;IACH,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAChE,CAAC"}

package/lib/typescript/src/types/RevenueData.d.ts

@@ -0,0 +1,32 @@
+export type CloudXRevenuePlatformValue = string;
+export declare const CloudXRevenuePlatform: {
+    readonly ADMOB: "AdMob";
+    readonly custom: (name: string) => CloudXRevenuePlatformValue;
+};
+export declare const CloudXRevenuePrecision: {
+    readonly EXACT: "exact";
+    readonly ESTIMATED: "estimated";
+    readonly PUBLISHER_DEFINED: "publisher_defined";
+    readonly UNDEFINED: "undefined";
+};
+export type CloudXRevenuePrecisionValue = (typeof CloudXRevenuePrecision)[keyof typeof CloudXRevenuePrecision];
+export type CloudXRevenueData = {
+    platform: CloudXRevenuePlatformValue;
+    /**
+     * Revenue for this impression in `currencyCode` units, not micros.
+     *
+     * Example: pass `1.234` for USD 1.234, not `1234000`.
+     */
+    revenue: number;
+    adFormat: string;
+    currencyCode?: string | null;
+    precision?: CloudXRevenuePrecisionValue | null;
+    networkName?: string | null;
+    adUnitId?: string | null;
+    thirdPartyAdPlacementId?: string | null;
+    creativeId?: string | null;
+    networkPlacement?: string | null;
+    countryCode?: string | null;
+    userSegment?: string | null;
+};
+//# sourceMappingURL=RevenueData.d.ts.map

package/lib/typescript/src/types/RevenueData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RevenueData.d.ts","sourceRoot":"","sources":["../../../../src/types/RevenueData.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,0BAA0B,GAAG,MAAM,CAAC;AAEhD,eAAO,MAAM,qBAAqB;;4BAMf,MAAM,KAAG,0BAA0B;CAC5C,CAAC;AAEX,eAAO,MAAM,sBAAsB;;;;;CAKzB,CAAC;AAEX,MAAM,MAAM,2BAA2B,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,OAAO,sBAAsB,CAAC,CAAC;AAE/G,MAAM,MAAM,iBAAiB,GAAG;IAC5B,QAAQ,EAAE,0BAA0B,CAAC;IACrC;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,CAAC,EAAE,2BAA2B,GAAG,IAAI,CAAC;IAC/C,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,uBAAuB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,CAAC"}

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

@@ -2,8 +2,11 @@ export type { CloudXAdInfo, CloudXAdLoadFailedInfo, CloudXAdDisplayFailedInfo, C
 export type { CloudXInitializationResult, CloudXConfiguration } from './Configuration';
 export type { CloudXType, CloudXLogLevelValue } from './CloudX';
 export type { CloudXArbiterBid, CloudXArbiterConfiguration, CloudXArbiterPlatform, CloudXArbiterResult, CloudXSDKArbiterBid, CloudXLevelPlayArbiterBid, CloudXPubMaticArbiterBid, } from './Arbiter';
+export { CloudXRevenuePlatform, CloudXRevenuePrecision } from './RevenueData';
+export type { CloudXRevenueData, CloudXRevenuePlatformValue, CloudXRevenuePrecisionValue } from './RevenueData';
 export type { CloudXFullscreenAdType } from './FullscreenAd';
 export type { CloudXInterstitialAdType } from './InterstitialAd';
+export type { CloudXAppOpenAdType } from './AppOpenAd';
 export type { CloudXRewardedAdType } from './RewardedAd';
 export type { CloudXViewAdType } from './ViewAd';
 export type { CloudXBannerAdType } from './BannerAd';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACpH,YAAY,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACvF,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAChE,YAAY,EACR,gBAAgB,EAChB,0BAA0B,EAC1B,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,GAC3B,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC7D,YAAY,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AACjE,YAAY,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACzD,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,YAAY,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAC5E,YAAY,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACpH,YAAY,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACvF,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAChE,YAAY,EACR,gBAAgB,EAChB,0BAA0B,EAC1B,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,GAC3B,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC9E,YAAY,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAChH,YAAY,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC7D,YAAY,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AACjE,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,YAAY,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACzD,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,YAAY,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAC5E,YAAY,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC"}

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

@@ -1,2 +1,2 @@
-export declare const PLUGIN_VERSION = "3.4.7";
+export declare const PLUGIN_VERSION = "3.6.0";
 //# sourceMappingURL=version.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cloudx-react-native",
-  "version": "3.4.7",
+  "version": "3.6.0",
   "description": "React Native wrapper for CloudX SDK (iOS & Android)",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",
@@ -24,8 +24,9 @@
   ],
   "scripts": {
     "prepare": "bob build",
-    "typescript": "tsc --noEmit",
+    "typescript": "tsc --noEmit -p tsconfig.build.json",
     "lint": "eslint \"src/**/*.{ts,tsx}\"",
+    "release:check": "node scripts/check-release-metadata.mjs && npm run typescript && npm run lint && npm pack --dry-run",
     "clean": "rm -rf lib"
   },
   "keywords": [
@@ -44,7 +45,10 @@
     "react-native": "*"
   },
   "devDependencies": {
+    "@react-native-community/eslint-config": "^3.2.0",
     "@types/react": "^18.0.0",
+    "eslint": "^8.57.0",
+    "prettier": "2.8.8",
     "react": "18.3.1",
     "react-native": "0.76.2",
     "react-native-builder-bob": "^0.20.4",

package/src/CloudX.ts

@@ -1,6 +1,7 @@
 import type { CloudXType, CloudXLogLevelValue } from './types/CloudX';
 import type { CloudXInitializationResult } from './types/Configuration';
 import type { CloudXArbiterConfiguration, CloudXArbiterResult } from './types/Arbiter';
+import type { CloudXRevenueData } from './types/RevenueData';
 import NativeCloudX from './specs/NativeCloudX';
 import { PLUGIN_VERSION } from './version';
 
@@ -56,6 +57,10 @@ const arbiter = (configuration: CloudXArbiterConfiguration): Promise<CloudXArbit
     return NativeCloudX.arbiter(configuration) as Promise<CloudXArbiterResult>;
 };
 
+const reportRevenueData = (data: CloudXRevenueData): Promise<boolean> => {
+    return NativeCloudX.reportRevenueData(data);
+};
+
 export const CloudX: CloudXType = {
     isInitialized,
     initialize,
@@ -70,6 +75,7 @@ export const CloudX: CloudXType = {
     setHasUserConsent,
     setDoNotSell,
     arbiter,
+    reportRevenueData,
 };
 
 export default CloudX;

package/src/CloudXAdViewBase.tsx

@@ -54,9 +54,7 @@ const parseAdValues = (json?: string | null): Record<string, string> => {
     }
     try {
         const parsed = JSON.parse(json);
-        return parsed && typeof parsed === 'object' && !Array.isArray(parsed)
-            ? parsed
-            : {};
+        return parsed && typeof parsed === 'object' ? parsed : {};
     } catch {
         return {};
     }
@@ -147,7 +145,7 @@ const toNativeExtraParameterEntries = (
  * events to the public CloudXAdProps callbacks, and hosts the native ad view.
  *
  * Note: overriding `style` with a non-IAB size resizes the host frame, not the
- * creative - iOS pins the ad view to the host bounds and Android measures the
+ * creative — iOS pins the ad view to the host bounds and Android measures the
  * creative from the host, so the served creative keeps its own standard
  * dimensions inside the resized frame.
  */
@@ -165,12 +163,17 @@ export const CloudXAdViewBase: React.FC<CloudXAdViewBaseProps> = ({
     ...viewProps
 }) => {
     const [isTablet, setIsTablet] = useState(cachedIsTablet ?? false);
-    const nativeViewProps = viewProps;
+    const nativeViewProps = { ...viewProps } as ViewProps & {
+        onAdExpanded?: unknown;
+        onAdCollapsed?: unknown;
+    };
+    delete nativeViewProps.onAdExpanded;
+    delete nativeViewProps.onAdCollapsed;
 
     /*
      * Gate native ad-view creation on SDK initialization. A view mounted before
      * CloudX.initialize() completes would create the ad against an uninitialized
-     * SDK - on iOS createBannerWithAdUnitId: returns nil and the view is
+     * SDK — on iOS createBannerWithAdUnitId: returns nil and the view is
      * permanently dead (no retry, no load-failed event). There is no init event
      * to subscribe to, so poll isInitialized() until ready, then mount the
      * native view (which is what delivers adUnitId/adFormat and triggers create).
@@ -258,11 +261,9 @@ export const CloudXAdViewBase: React.FC<CloudXAdViewBaseProps> = ({
         [extraParameters]
     );
 
-    /*
-     * Until the SDK is initialized, render a sized placeholder that reserves
-     * the ad slot's layout but does NOT mount the native view (so no pre-init
-     * create). Swaps to the real ad view once isInitialized flips true.
-     */
+    // Until the SDK is initialized, render a sized placeholder that reserves the
+    // ad slot's layout but does NOT mount the native view (so no pre-init
+    // create). Swaps to the real ad view once isInitialized flips true.
     if (!isInitialized) {
         return <View style={resolvedStyle} {...nativeViewProps} />;
     }

package/src/CloudXAppOpenAd.ts

@@ -0,0 +1,109 @@
+import { addEventListener, removeEventListener } from './EventEmitter';
+import type { CloudXAdDisplayFailedInfo, CloudXAdInfo, CloudXAdLoadFailedInfo } from './types/AdInfo';
+import type { CloudXExtraParameters } from './types/ExtraParameters';
+import type { CloudXFullscreenAdType } from './types/FullscreenAd';
+import NativeCloudX from './specs/NativeCloudX';
+
+const {
+    ON_APPOPEN_LOADED_EVENT,
+    ON_APPOPEN_LOAD_FAILED_EVENT,
+    ON_APPOPEN_CLICKED_EVENT,
+    ON_APPOPEN_DISPLAYED_EVENT,
+    ON_APPOPEN_DISPLAY_FAILED_EVENT,
+    ON_APPOPEN_HIDDEN_EVENT,
+    ON_APPOPEN_AD_REVENUE_PAID,
+} = NativeCloudX.getConstants();
+
+const isAdReady = (adUnitId: string): Promise<boolean> => {
+    return NativeCloudX.isAppOpenReady(adUnitId);
+};
+
+const loadAd = (adUnitId: string): void => {
+    NativeCloudX.loadAppOpen(adUnitId);
+};
+
+const setExtraParameters = (adUnitId: string, extraParameters: CloudXExtraParameters): void => {
+    NativeCloudX.setAppOpenExtraParameters(adUnitId, extraParameters);
+};
+
+const showAd = (adUnitId: string, placement?: string | null, customData?: string | null): void => {
+    NativeCloudX.showAppOpen(adUnitId, placement ?? undefined, customData ?? undefined);
+};
+
+const destroyAd = (adUnitId: string): void => {
+    NativeCloudX.destroyAppOpen(adUnitId);
+};
+
+const addAdLoadedEventListener = (listener: (adInfo: CloudXAdInfo) => void): void => {
+    addEventListener(ON_APPOPEN_LOADED_EVENT, listener);
+};
+const removeAdLoadedEventListener = (): void => {
+    removeEventListener(ON_APPOPEN_LOADED_EVENT);
+};
+
+const addAdLoadFailedEventListener = (listener: (errorInfo: CloudXAdLoadFailedInfo) => void): void => {
+    addEventListener(ON_APPOPEN_LOAD_FAILED_EVENT, listener);
+};
+const removeAdLoadFailedEventListener = (): void => {
+    removeEventListener(ON_APPOPEN_LOAD_FAILED_EVENT);
+};
+
+const addAdClickedEventListener = (listener: (adInfo: CloudXAdInfo) => void): void => {
+    addEventListener(ON_APPOPEN_CLICKED_EVENT, listener);
+};
+const removeAdClickedEventListener = (): void => {
+    removeEventListener(ON_APPOPEN_CLICKED_EVENT);
+};
+
+const addAdDisplayedEventListener = (listener: (adInfo: CloudXAdInfo) => void): void => {
+    addEventListener(ON_APPOPEN_DISPLAYED_EVENT, listener);
+};
+const removeAdDisplayedEventListener = (): void => {
+    removeEventListener(ON_APPOPEN_DISPLAYED_EVENT);
+};
+
+const addAdFailedToDisplayEventListener = (listener: (errorInfo: CloudXAdDisplayFailedInfo) => void): void => {
+    addEventListener(ON_APPOPEN_DISPLAY_FAILED_EVENT, listener);
+};
+const removeAdFailedToDisplayEventListener = (): void => {
+    removeEventListener(ON_APPOPEN_DISPLAY_FAILED_EVENT);
+};
+
+const addAdHiddenEventListener = (listener: (adInfo: CloudXAdInfo) => void): void => {
+    addEventListener(ON_APPOPEN_HIDDEN_EVENT, listener);
+};
+const removeAdHiddenEventListener = (): void => {
+    removeEventListener(ON_APPOPEN_HIDDEN_EVENT);
+};
+
+const addAdRevenuePaidListener = (listener: (adInfo: CloudXAdInfo) => void): void => {
+    addEventListener(ON_APPOPEN_AD_REVENUE_PAID, listener);
+};
+const removeAdRevenuePaidListener = (): void => {
+    removeEventListener(ON_APPOPEN_AD_REVENUE_PAID);
+};
+
+export const CloudXAppOpenAd: CloudXFullscreenAdType = {
+    isAdReady,
+    loadAd,
+    setExtraParameters,
+    showAd,
+    destroyAd,
+
+    addAdLoadedEventListener,
+    removeAdLoadedEventListener,
+    addAdLoadFailedEventListener,
+    removeAdLoadFailedEventListener,
+    addAdClickedEventListener,
+    removeAdClickedEventListener,
+    addAdDisplayedEventListener,
+    removeAdDisplayedEventListener,
+    addAdFailedToDisplayEventListener,
+    removeAdFailedToDisplayEventListener,
+    addAdHiddenEventListener,
+    removeAdHiddenEventListener,
+    addAdRevenuePaidListener,
+    removeAdRevenuePaidListener,
+};
+
+export default CloudXAppOpenAd;

package/src/CloudXBannerView.tsx

@@ -9,9 +9,9 @@ import type { CloudXAdViewProps } from './CloudXAdViewBase';
  * RN view tree), this renders the banner as an ordinary React Native view, so
  * app overlays such as toasts layer above it via normal RN z-ordering.
  *
- * Defaults to 320x50 on phones and 728x90 on tablets; override via `style`.
+ * Defaults to 320×50 on phones and 728×90 on tablets; override via `style`.
  * Overriding `style` to a non-standard size resizes the host frame, not the
- * creative - the served banner keeps its own IAB dimensions inside that frame.
+ * creative — the served banner keeps its own IAB dimensions inside that frame.
  */
 export const CloudXBannerView: React.FC<CloudXAdViewProps> = (props) => (
     <CloudXAdViewBase adFormat="BANNER" {...props} />

package/src/CloudXMRECView.tsx

@@ -9,9 +9,9 @@ import type { CloudXAdViewProps } from './CloudXAdViewBase';
  * view tree), this renders the MREC as an ordinary React Native view, so app
  * overlays such as toasts layer above it via normal RN z-ordering.
  *
- * Fixed size of 300x250; override via `style`.
+ * Fixed size of 300×250; override via `style`.
  * Overriding `style` to a non-standard size resizes the host frame, not the
- * creative - the served MREC keeps its own dimensions inside that frame.
+ * creative — the served MREC keeps its own dimensions inside that frame.
  */
 export const CloudXMRECView: React.FC<CloudXAdViewProps> = (props) => (
     <CloudXAdViewBase adFormat="MREC" {...props} />

package/src/hooks.ts

@@ -15,6 +15,10 @@ const {
     ON_INTERSTITIAL_LOAD_FAILED_EVENT,
     ON_INTERSTITIAL_DISPLAY_FAILED_EVENT,
     ON_INTERSTITIAL_HIDDEN_EVENT,
+    ON_APPOPEN_LOADED_EVENT,
+    ON_APPOPEN_LOAD_FAILED_EVENT,
+    ON_APPOPEN_DISPLAY_FAILED_EVENT,
+    ON_APPOPEN_HIDDEN_EVENT,
     ON_REWARDED_AD_LOADED_EVENT,
     ON_REWARDED_AD_LOAD_FAILED_EVENT,
     ON_REWARDED_AD_DISPLAY_FAILED_EVENT,
@@ -123,6 +127,105 @@ export function useCloudXInterstitial(adUnitId: string): CloudXInterstitialHookR
     return { isLoaded, isLoading, error, load, show, destroy };
 }
 
+// ---------------------------------------------------------------------------
+// useCloudXAppOpen
+// ---------------------------------------------------------------------------
+
+export type CloudXAppOpenHookResult = {
+    isLoaded: boolean;
+    isLoading: boolean;
+    error: string | null;
+    load: () => void;
+    show: (placement?: string | null, customData?: string | null) => void;
+    destroy: () => void;
+};
+
+/**
+ * Hook for managing an app open ad lifecycle.
+ *
+ * @param adUnitId - The ad unit identifier.
+ */
+export function useCloudXAppOpen(adUnitId: string): CloudXAppOpenHookResult {
+    const [isLoaded, setIsLoaded] = useState(false);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState<string | null>(null);
+    const mountedRef = useRef(true);
+
+    useEffect(() => {
+        mountedRef.current = true;
+        const subs: EventSubscription[] = [];
+
+        subs.push(
+            emitter.addListener(ON_APPOPEN_LOADED_EVENT, (event: { adUnitId: string }) => {
+                if (event.adUnitId === adUnitId && mountedRef.current) {
+                    setIsLoaded(true);
+                    setIsLoading(false);
+                    setError(null);
+                }
+            }),
+        );
+
+        subs.push(
+            emitter.addListener(ON_APPOPEN_LOAD_FAILED_EVENT, (event: { adUnitId: string; message?: string }) => {
+                if (event.adUnitId === adUnitId && mountedRef.current) {
+                    setIsLoaded(false);
+                    setIsLoading(false);
+                    setError(event.message ?? 'Failed to load');
+                }
+            }),
+        );
+
+        subs.push(
+            emitter.addListener(ON_APPOPEN_DISPLAY_FAILED_EVENT, (event: { adUnitId: string; message?: string }) => {
+                if (event.adUnitId === adUnitId && mountedRef.current) {
+                    setIsLoaded(false);
+                    setError(event.message ?? 'Display failed');
+                }
+            }),
+        );
+
+        subs.push(
+            emitter.addListener(ON_APPOPEN_HIDDEN_EVENT, (event: { adUnitId: string }) => {
+                if (event.adUnitId === adUnitId && mountedRef.current) {
+                    setIsLoaded(false);
+                }
+            }),
+        );
+
+        return () => {
+            mountedRef.current = false;
+            subs.forEach((s) => s.remove());
+            NativeCloudX.destroyAppOpen(adUnitId);
+        };
+    }, [adUnitId]);
+
+    const load = useCallback(() => {
+        setIsLoading(true);
+        setError(null);
+        NativeCloudX.loadAppOpen(adUnitId);
+    }, [adUnitId]);
+
+    const show = useCallback(
+        (placement?: string | null, customData?: string | null) => {
+            if (!isLoaded) {
+                setError('Ad not loaded');
+                return;
+            }
+            NativeCloudX.showAppOpen(adUnitId, placement ?? undefined, customData ?? undefined);
+        },
+        [adUnitId, isLoaded],
+    );
+
+    const destroy = useCallback(() => {
+        NativeCloudX.destroyAppOpen(adUnitId);
+        setIsLoaded(false);
+        setIsLoading(false);
+        setError(null);
+    }, [adUnitId]);
+
+    return { isLoaded, isLoading, error, load, show, destroy };
+}
+
 // ---------------------------------------------------------------------------
 // useCloudXRewarded
 // ---------------------------------------------------------------------------

package/src/index.ts

@@ -1,10 +1,16 @@
 // Core SDK
 export { default, CloudX } from './CloudX';
 export { default as NativeCloudX } from './specs/NativeCloudX';
+// The shared NativeEventEmitter every hook subscribes through. Consumers
+// that need raw event access (e.g. logging) should use this instance rather
+// than constructing their own NativeEventEmitter(NativeCloudX).
+export { emitter as cloudXEventEmitter } from './EventEmitter';
 export { CloudXArbiterBid } from './types/Arbiter';
+export { CloudXRevenuePlatform, CloudXRevenuePrecision } from './types/RevenueData';
 
 // Ad Modules
 export { CloudXInterstitialAd } from './CloudXInterstitialAd';
+export { CloudXAppOpenAd } from './CloudXAppOpenAd';
 export { CloudXRewardedAd } from './CloudXRewardedAd';
 export { CloudXBannerAd } from './CloudXBannerAd';
 export { CloudXMRECAd } from './CloudXMRECAd';
@@ -22,8 +28,13 @@ export { CloudXErrorCode } from './CloudXErrorCode';
 export { requestTrackingAuthorization, getTrackingAuthorizationStatus, CloudXATTStatus } from './AppTrackingTransparency';
 
 // Hooks
-export { useCloudXInterstitial, useCloudXRewarded, useCloudXBanner } from './hooks';
-export type { CloudXInterstitialHookResult, CloudXRewardedHookResult, CloudXBannerHookResult } from './hooks';
+export { useCloudXInterstitial, useCloudXAppOpen, useCloudXRewarded, useCloudXBanner } from './hooks';
+export type {
+    CloudXInterstitialHookResult,
+    CloudXAppOpenHookResult,
+    CloudXRewardedHookResult,
+    CloudXBannerHookResult,
+} from './hooks';
 
 // Types
 export type {
@@ -41,8 +52,12 @@ export type {
     CloudXSDKArbiterBid,
     CloudXLevelPlayArbiterBid,
     CloudXPubMaticArbiterBid,
+    CloudXRevenueData,
+    CloudXRevenuePlatformValue,
+    CloudXRevenuePrecisionValue,
     CloudXFullscreenAdType,
     CloudXInterstitialAdType,
+    CloudXAppOpenAdType,
     CloudXRewardedAdType,
     CloudXViewAdType,
     CloudXBannerAdType,

package/src/specs/CloudXAdViewNativeComponent.ts

@@ -42,7 +42,7 @@ export type NativeExtraParameterEntry = Readonly<{
  *
  * This is the in-tree view component: the ad renders as an ordinary React
  * Native view, so publisher overlays (toasts, modals) layer above it via
- * normal RN z-ordering - unlike the imperative overlay banner API.
+ * normal RN z-ordering — unlike the imperative overlay banner API.
  */
 export interface NativeProps extends ViewProps {
     /** Ad unit ID used to load the ad. */

package/src/specs/NativeCloudX.ts

@@ -52,6 +52,15 @@ export interface Spec extends TurboModule {
         ON_REWARDED_AD_HIDDEN_EVENT: string;
         ON_REWARDED_AD_RECEIVED_REWARD_EVENT: string;
         ON_REWARDED_AD_REVENUE_PAID: string;
+
+        // App Open events
+        ON_APPOPEN_LOADED_EVENT: string;
+        ON_APPOPEN_LOAD_FAILED_EVENT: string;
+        ON_APPOPEN_CLICKED_EVENT: string;
+        ON_APPOPEN_DISPLAYED_EVENT: string;
+        ON_APPOPEN_DISPLAY_FAILED_EVENT: string;
+        ON_APPOPEN_HIDDEN_EVENT: string;
+        ON_APPOPEN_AD_REVENUE_PAID: string;
     };
 
     // =========================================================================
@@ -92,6 +101,9 @@ export interface Spec extends TurboModule {
 
     arbiter(configuration: UnsafeObject): Promise<UnsafeObject>;
 
+    // Revenue Data
+    reportRevenueData(data: UnsafeObject): Promise<boolean>;
+
     // =========================================================================
     // Banner (Programmatic)
     // =========================================================================
@@ -148,6 +160,16 @@ export interface Spec extends TurboModule {
     showRewarded(adUnitId: string, placement?: string | null, customData?: string | null): void;
     destroyRewarded(adUnitId: string): void;
 
+    // =========================================================================
+    // App Open
+    // =========================================================================
+
+    loadAppOpen(adUnitId: string): void;
+    setAppOpenExtraParameters(adUnitId: string, extraParameters: UnsafeObject): void;
+    isAppOpenReady(adUnitId: string): Promise<boolean>;
+    showAppOpen(adUnitId: string, placement?: string | null, customData?: string | null): void;
+    destroyAppOpen(adUnitId: string): void;
+
     // =========================================================================
     // Event Emitter (required by NativeEventEmitter)
     // =========================================================================

package/src/types/AppOpenAd.ts

@@ -0,0 +1,8 @@
+import type { CloudXFullscreenAdType } from './FullscreenAd';
+
+/**
+ * App Open ad type — identical to the fullscreen ad interface.
+ * Provides a named type for consumers and a place to add app-open-specific
+ * methods in the future without refactoring.
+ */
+export type CloudXAppOpenAdType = CloudXFullscreenAdType;

package/src/types/CloudX.ts

@@ -1,5 +1,6 @@
 import type { CloudXInitializationResult } from './Configuration';
 import type { CloudXArbiterConfiguration, CloudXArbiterResult } from './Arbiter';
+import type { CloudXRevenueData } from './RevenueData';
 
 export type CloudXLogLevelValue = 'verbose' | 'debug' | 'info' | 'warn' | 'error' | 'none';
 
@@ -57,4 +58,10 @@ export type CloudXType = {
 
     /** Runs CloudX Arbiter using bid data passed through to the native SDK. */
     arbiter(configuration: CloudXArbiterConfiguration): Promise<CloudXArbiterResult>;
+
+    /**
+     * Reports publisher-observed revenue data.
+     * Resolves false when unsupported, invalid, or rejected.
+     */
+    reportRevenueData(data: CloudXRevenueData): Promise<boolean>;
 };

package/src/types/RevenueData.ts

@@ -0,0 +1,39 @@
+export type CloudXRevenuePlatformValue = string;
+
+export const CloudXRevenuePlatform = {
+    ADMOB: 'AdMob',
+    /*
+     * InMobi does not provide a React Native SDK.
+     * INMOBI: 'InMobi',
+     */
+    custom: (name: string): CloudXRevenuePlatformValue => name.trim(),
+} as const;
+
+export const CloudXRevenuePrecision = {
+    EXACT: 'exact',
+    ESTIMATED: 'estimated',
+    PUBLISHER_DEFINED: 'publisher_defined',
+    UNDEFINED: 'undefined',
+} as const;
+
+export type CloudXRevenuePrecisionValue = (typeof CloudXRevenuePrecision)[keyof typeof CloudXRevenuePrecision];
+
+export type CloudXRevenueData = {
+    platform: CloudXRevenuePlatformValue;
+    /**
+     * Revenue for this impression in `currencyCode` units, not micros.
+     *
+     * Example: pass `1.234` for USD 1.234, not `1234000`.
+     */
+    revenue: number;
+    adFormat: string;
+    currencyCode?: string | null;
+    precision?: CloudXRevenuePrecisionValue | null;
+    networkName?: string | null;
+    adUnitId?: string | null;
+    thirdPartyAdPlacementId?: string | null;
+    creativeId?: string | null;
+    networkPlacement?: string | null;
+    countryCode?: string | null;
+    userSegment?: string | null;
+};

package/src/types/index.ts

@@ -10,8 +10,11 @@ export type {
     CloudXLevelPlayArbiterBid,
     CloudXPubMaticArbiterBid,
 } from './Arbiter';
+export { CloudXRevenuePlatform, CloudXRevenuePrecision } from './RevenueData';
+export type { CloudXRevenueData, CloudXRevenuePlatformValue, CloudXRevenuePrecisionValue } from './RevenueData';
 export type { CloudXFullscreenAdType } from './FullscreenAd';
 export type { CloudXInterstitialAdType } from './InterstitialAd';
+export type { CloudXAppOpenAdType } from './AppOpenAd';
 export type { CloudXRewardedAdType } from './RewardedAd';
 export type { CloudXViewAdType } from './ViewAd';
 export type { CloudXBannerAdType } from './BannerAd';

package/src/version.ts

@@ -3,4 +3,4 @@
 // This value is reported to the native SDK in CloudX.initialize() and is used
 // for wrapper-version telemetry/attribution, so a stale value mis-attributes
 // installs to the wrong release.
-export const PLUGIN_VERSION = '3.4.7';
+export const PLUGIN_VERSION = '3.6.0';