cloudx-react-native 3.4.7 → 3.6.1

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/Arbiter.ts

@@ -1,6 +1,6 @@
 import type { CloudXAdInfo } from './AdInfo';
 
-export type CloudXArbiterPlatform = 'CLOUDX' | 'LEVELPLAY' | 'PUBMATIC' | 'NONE';
+export type CloudXArbiterPlatform = 'CLOUDX' | 'LEVELPLAY' | 'PUBMATIC' | 'CUSTOM' | 'NONE';
 
 export type CloudXSDKArbiterBid = {
     platform: 'CLOUDX';
@@ -22,10 +22,20 @@ export type CloudXPubMaticArbiterBid = {
     extras?: Record<string, string>;
 };
 
+export type CloudXCustomArbiterBid = {
+    platform: 'CUSTOM';
+    platformName: string;
+    networkName: string;
+    revenuePerImpressionUSD: number;
+    precision: string;
+    extras?: Record<string, string>;
+};
+
 export type CloudXArbiterBid =
     | CloudXSDKArbiterBid
     | CloudXLevelPlayArbiterBid
-    | CloudXPubMaticArbiterBid;
+    | CloudXPubMaticArbiterBid
+    | CloudXCustomArbiterBid;
 
 export const CloudXArbiterBid = {
     cloudX(ad: CloudXAdInfo): CloudXSDKArbiterBid {
@@ -48,6 +58,13 @@ export const CloudXArbiterBid = {
             ...params,
         };
     },
+
+    custom(params: Omit<CloudXCustomArbiterBid, 'platform'>): CloudXCustomArbiterBid {
+        return {
+            platform: 'CUSTOM',
+            ...params,
+        };
+    },
 } as const;
 
 export type CloudXArbiterConfiguration = {
@@ -57,6 +74,7 @@ export type CloudXArbiterConfiguration = {
 export type CloudXArbiterResult = {
     id: string;
     platform: CloudXArbiterPlatform;
+    platformName: string;
     bidId?: string | null;
     extras: Record<string, string>;
 };

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

@@ -9,9 +9,13 @@ export type {
     CloudXSDKArbiterBid,
     CloudXLevelPlayArbiterBid,
     CloudXPubMaticArbiterBid,
+    CloudXCustomArbiterBid,
 } 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.1';