cloudx-react-native 3.4.6 → 3.6.0

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.6";
+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.6",
+  "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

@@ -0,0 +1,294 @@
+import React, { useEffect, useMemo, useState } from 'react';
+import { View } from 'react-native';
+import type { NativeSyntheticEvent, StyleProp, ViewProps, ViewStyle } from 'react-native';
+import NativeCloudXAdView from './specs/CloudXAdViewNativeComponent';
+import type {
+    CloudXAdInfoEvent,
+    CloudXAdLoadFailedEvent,
+    NativeExtraParameterEntry,
+} from './specs/CloudXAdViewNativeComponent';
+import NativeCloudX from './specs/NativeCloudX';
+import type { CloudXAdInfo, CloudXAdLoadFailedInfo } from './types/AdInfo';
+import type { CloudXAdProps } from './types/AdProps';
+import type { CloudXErrorCode } from './CloudXErrorCode';
+
+/**
+ * Ad format rendered by the in-tree view component.
+ */
+export type CloudXAdViewFormat = 'BANNER' | 'MREC';
+
+/**
+ * Props shared by CloudXBannerView and CloudXMRECView.
+ */
+export type CloudXAdViewProps = CloudXAdProps & ViewProps;
+
+/** Internal props: the shared base additionally needs the concrete ad format. */
+type CloudXAdViewBaseProps = CloudXAdViewProps & {
+    adFormat: CloudXAdViewFormat;
+};
+
+const AD_SIZE = {
+    banner: { width: 320, height: 50 },
+    leader: { width: 728, height: 90 },
+    mrec: { width: 300, height: 250 },
+};
+
+/*
+ * Tablet status is a device constant, but NativeCloudX.isTablet() is async.
+ * Cache it at module level so only the first banner in a session can flash
+ * phone->leader; every later mount reads the resolved value synchronously.
+ */
+let cachedIsTablet: boolean | null = null;
+
+/*
+ * Once the SDK reports initialized it stays initialized for the JS VM's life,
+ * so cache it module-wide: only the first ad view mounted before init has to
+ * poll + show a placeholder; every later mount renders the native view
+ * immediately. Mirrors cachedIsTablet above.
+ */
+let cachedIsInitialized = false;
+
+const parseAdValues = (json?: string | null): Record<string, string> => {
+    if (!json) {
+        return {};
+    }
+    try {
+        const parsed = JSON.parse(json);
+        return parsed && typeof parsed === 'object' ? parsed : {};
+    } catch {
+        return {};
+    }
+};
+
+const toAdInfo = (event: CloudXAdInfoEvent): CloudXAdInfo => ({
+    adUnitId: event.adUnitId,
+    adFormat: event.adFormat,
+    networkName: event.networkName,
+    networkPlacement: event.networkPlacement || null,
+    placement: event.placement || null,
+    revenue: event.revenue ?? 0,
+    adValues: parseAdValues(event.adValuesJson),
+});
+
+const toLoadFailedInfo = (event: CloudXAdLoadFailedEvent): CloudXAdLoadFailedInfo => ({
+    adUnitId: event.adUnitId,
+    code: event.code as CloudXErrorCode,
+    message: event.message || null,
+});
+
+const warnIgnoredUndefinedExtraParameter = (keyPath: string): void => {
+    console.warn(
+        `CloudXAdView ignored extra parameter "${keyPath}" because ` +
+            'undefined values are not supported. Use null when a value is intentional.'
+    );
+};
+
+const normalizeExtraParameterValue = (
+    keyPath: string,
+    value: unknown
+): NativeExtraParameterEntry['value'] | undefined => {
+    if (value === undefined) {
+        warnIgnoredUndefinedExtraParameter(keyPath);
+        return undefined;
+    }
+
+    if (Array.isArray(value)) {
+        return value.reduce<unknown[]>((items, item, index) => {
+            const normalized = normalizeExtraParameterValue(`${keyPath}[${index}]`, item);
+            if (normalized !== undefined) {
+                items.push(normalized);
+            }
+            return items;
+        }, []);
+    }
+
+    if (value !== null && typeof value === 'object') {
+        return Object.entries(value as Record<string, unknown>).reduce<Record<string, unknown>>(
+            (object, [childKey, childValue]) => {
+                const normalized = normalizeExtraParameterValue(`${keyPath}.${childKey}`, childValue);
+                if (normalized !== undefined) {
+                    object[childKey] = normalized;
+                }
+                return object;
+            },
+            {}
+        );
+    }
+
+    return value;
+};
+
+const toNativeExtraParameterEntries = (
+    extraParameters?: CloudXAdProps['extraParameters']
+): ReadonlyArray<NativeExtraParameterEntry> => {
+    if (!extraParameters) {
+        return [];
+    }
+
+    return Object.entries(extraParameters as Record<string, unknown>).reduce<NativeExtraParameterEntry[]>(
+        (entries, [key, value]) => {
+            const normalizedValue = normalizeExtraParameterValue(key, value);
+            if (normalizedValue === undefined) {
+                return entries;
+            }
+
+            entries.push({ key, value: normalizedValue });
+            return entries;
+        },
+        []
+    );
+};
+
+/**
+ * Shared implementation for the in-tree banner/MREC view component. Resolves a
+ * default fixed size (overridable via `style`), wires the native per-view direct
+ * 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 from the host, so the served creative keeps its own standard
+ * dimensions inside the resized frame.
+ */
+export const CloudXAdViewBase: React.FC<CloudXAdViewBaseProps> = ({
+    adFormat,
+    adUnitId,
+    placement,
+    customData,
+    extraParameters,
+    onAdLoaded,
+    onAdLoadFailed,
+    onAdClicked,
+    onAdRevenuePaid,
+    style,
+    ...viewProps
+}) => {
+    const [isTablet, setIsTablet] = useState(cachedIsTablet ?? false);
+    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
+     * 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).
+     * Mirrors CloudXNativeAdView. Cached module-wide so only the first pre-init
+     * mount pays the placeholder + poll.
+     */
+    const [isInitialized, setIsInitialized] = useState(cachedIsInitialized);
+
+    useEffect(() => {
+        if (cachedIsInitialized) {
+            return;
+        }
+        let cancelled = false;
+        let timer: ReturnType<typeof setTimeout> | undefined;
+        let warnedOnce = false;
+        const check = () => {
+            NativeCloudX.isInitialized()
+                .then((ready) => {
+                    if (cancelled) {
+                        return;
+                    }
+                    if (ready) {
+                        cachedIsInitialized = true;
+                        setIsInitialized(true);
+                        return;
+                    }
+                    if (!warnedOnce) {
+                        warnedOnce = true;
+                        console.warn(
+                            'CloudXAdView mounted before CloudX SDK initialization; will render once initialize() completes.'
+                        );
+                    }
+                    timer = setTimeout(check, 1000);
+                })
+                .catch((error) => {
+                    if (cancelled) {
+                        return;
+                    }
+                    console.warn('CloudXAdView failed to read initialization state:', error);
+                    timer = setTimeout(check, 1000);
+                });
+        };
+        check();
+        return () => {
+            cancelled = true;
+            if (timer) {
+                clearTimeout(timer);
+            }
+        };
+    }, []);
+
+    useEffect(() => {
+        if (adFormat !== 'BANNER' || cachedIsTablet !== null) {
+            return;
+        }
+        let cancelled = false;
+        NativeCloudX.isTablet()
+            .then((tablet) => {
+                cachedIsTablet = tablet;
+                if (!cancelled) {
+                    setIsTablet(tablet);
+                }
+            })
+            .catch(() => {
+                /* keep phone default on failure */
+            });
+        return () => {
+            cancelled = true;
+        };
+    }, [adFormat]);
+
+    const defaultSize = useMemo<ViewStyle>(() => {
+        if (adFormat === 'MREC') {
+            return AD_SIZE.mrec;
+        }
+        return isTablet ? AD_SIZE.leader : AD_SIZE.banner;
+    }, [adFormat, isTablet]);
+
+    const resolvedStyle = useMemo<StyleProp<ViewStyle>>(
+        () => [defaultSize, style],
+        [defaultSize, style]
+    );
+    const nativeExtraParameters = useMemo(
+        () => toNativeExtraParameterEntries(extraParameters),
+        [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.
+    if (!isInitialized) {
+        return <View style={resolvedStyle} {...nativeViewProps} />;
+    }
+
+    return (
+        <NativeCloudXAdView
+            {...nativeViewProps}
+            style={resolvedStyle}
+            adUnitId={adUnitId}
+            adFormat={adFormat}
+            placement={placement ?? null}
+            customData={customData ?? null}
+            extraParameters={nativeExtraParameters}
+            onAdLoadedEvent={(e: NativeSyntheticEvent<CloudXAdInfoEvent>) =>
+                onAdLoaded?.(toAdInfo(e.nativeEvent))
+            }
+            onAdLoadFailedEvent={(e: NativeSyntheticEvent<CloudXAdLoadFailedEvent>) =>
+                onAdLoadFailed?.(toLoadFailedInfo(e.nativeEvent))
+            }
+            onAdClickedEvent={(e: NativeSyntheticEvent<CloudXAdInfoEvent>) =>
+                onAdClicked?.(toAdInfo(e.nativeEvent))
+            }
+            onAdRevenuePaidEvent={(e: NativeSyntheticEvent<CloudXAdInfoEvent>) =>
+                onAdRevenuePaid?.(toAdInfo(e.nativeEvent))
+            }
+        />
+    );
+};

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

@@ -0,0 +1,20 @@
+import React from 'react';
+import { CloudXAdViewBase } from './CloudXAdViewBase';
+import type { CloudXAdViewProps } from './CloudXAdViewBase';
+
+/**
+ * In-tree banner ad component.
+ *
+ * Unlike the imperative `CloudXBannerAd` API (a native overlay above the whole
+ * 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 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.
+ */
+export const CloudXBannerView: React.FC<CloudXAdViewProps> = (props) => (
+    <CloudXAdViewBase adFormat="BANNER" {...props} />
+);
+
+export default CloudXBannerView;

package/src/CloudXMRECView.tsx

@@ -0,0 +1,20 @@
+import React from 'react';
+import { CloudXAdViewBase } from './CloudXAdViewBase';
+import type { CloudXAdViewProps } from './CloudXAdViewBase';
+
+/**
+ * In-tree MREC ad component.
+ *
+ * Unlike the imperative `CloudXMRECAd` API (a native overlay above the whole RN
+ * 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 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.
+ */
+export const CloudXMRECView: React.FC<CloudXAdViewProps> = (props) => (
+    <CloudXAdViewBase adFormat="MREC" {...props} />
+);
+
+export default CloudXMRECView;