cloudx-react-native 3.2.0 → 3.4.4

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

@@ -1,5 +1,6 @@
 import type { CloudXAdInfo, CloudXAdLoadFailedInfo } from './AdInfo';
 import type { CloudXAdEventListener } from './AdEvent';
+import type { CloudXExtraParameters } from './ExtraParameters';
 import type { CloudXAdPosition } from '../CloudXAdPosition';
 /**
  * Shared interface for view-based ads (Banners and MRECs).
@@ -10,6 +11,7 @@ export type CloudXViewAdType = {
     hideAd(adUnitId: string): void;
     setPlacement(adUnitId: string, placement: string | null): void;
     setCustomData(adUnitId: string, customData: string | null): void;
+    setExtraParameters(adUnitId: string, extraParameters: CloudXExtraParameters): void;
     updatePosition(adUnitId: string, bannerPosition: CloudXAdPosition): void;
     startAutoRefresh(adUnitId: string): void;
     stopAutoRefresh(adUnitId: string): void;

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

@@ -1 +1 @@
-{"version":3,"file":"ViewAd.d.ts","sourceRoot":"","sources":["../../../../src/types/ViewAd.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AACrE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC3B,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/B,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAC/D,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAEjE,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAEzE,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAExC,wBAAwB,CAAC,QAAQ,EAAE,qBAAqB,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;IAC9E,2BAA2B,IAAI,IAAI,CAAC;IAEpC,4BAA4B,CAAC,QAAQ,EAAE,qBAAqB,CAAC,sBAAsB,CAAC,GAAG,IAAI,CAAC;IAC5F,+BAA+B,IAAI,IAAI,CAAC;IAExC,yBAAyB,CAAC,QAAQ,EAAE,qBAAqB,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;IAC/E,4BAA4B,IAAI,IAAI,CAAC;IAErC,0BAA0B,CAAC,QAAQ,EAAE,qBAAqB,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;IAChF,6BAA6B,IAAI,IAAI,CAAC;IAEtC,2BAA2B,CAAC,QAAQ,EAAE,qBAAqB,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;IACjF,8BAA8B,IAAI,IAAI,CAAC;IAEvC,wBAAwB,CAAC,QAAQ,EAAE,qBAAqB,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;IAC9E,2BAA2B,IAAI,IAAI,CAAC;CACvC,CAAC"}
+{"version":3,"file":"ViewAd.d.ts","sourceRoot":"","sources":["../../../../src/types/ViewAd.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AACrE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC3B,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/B,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAC/D,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IACjE,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAEnF,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAEzE,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAExC,wBAAwB,CAAC,QAAQ,EAAE,qBAAqB,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;IAC9E,2BAA2B,IAAI,IAAI,CAAC;IAEpC,4BAA4B,CAAC,QAAQ,EAAE,qBAAqB,CAAC,sBAAsB,CAAC,GAAG,IAAI,CAAC;IAC5F,+BAA+B,IAAI,IAAI,CAAC;IAExC,yBAAyB,CAAC,QAAQ,EAAE,qBAAqB,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;IAC/E,4BAA4B,IAAI,IAAI,CAAC;IAErC,0BAA0B,CAAC,QAAQ,EAAE,qBAAqB,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;IAChF,6BAA6B,IAAI,IAAI,CAAC;IAEtC,2BAA2B,CAAC,QAAQ,EAAE,qBAAqB,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;IACjF,8BAA8B,IAAI,IAAI,CAAC;IAEvC,wBAAwB,CAAC,QAAQ,EAAE,qBAAqB,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;IAC9E,2BAA2B,IAAI,IAAI,CAAC;CACvC,CAAC"}

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

@@ -1,6 +1,7 @@
 export type { CloudXAdInfo, CloudXAdLoadFailedInfo, CloudXAdDisplayFailedInfo, CloudXAdRewardInfo } from './AdInfo';
 export type { CloudXInitializationResult, CloudXConfiguration } from './Configuration';
 export type { CloudXType, CloudXLogLevelValue } from './CloudX';
+export type { CloudXArbiterBid, CloudXArbiterConfiguration, CloudXArbiterPlatform, CloudXArbiterResult, CloudXSDKArbiterBid, CloudXLevelPlayArbiterBid, CloudXPubMaticArbiterBid, } from './Arbiter';
 export type { CloudXFullscreenAdType } from './FullscreenAd';
 export type { CloudXInterstitialAdType } from './InterstitialAd';
 export type { CloudXRewardedAdType } from './RewardedAd';
@@ -9,4 +10,5 @@ export type { CloudXBannerAdType } from './BannerAd';
 export type { CloudXMRECAdType } from './MRECAd';
 export type { CloudXAdProps } from './AdProps';
 export type { CloudXAdEventObject, CloudXAdEventListener } from './AdEvent';
+export type { CloudXExtraParameterValue, CloudXExtraParameters } from './ExtraParameters';
 //# sourceMappingURL=index.d.ts.map

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,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"}
+{"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"}

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cloudx-react-native",
-  "version": "3.2.0",
+  "version": "3.4.4",
   "description": "React Native wrapper for CloudX SDK (iOS & Android)",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",
@@ -45,6 +45,8 @@
   },
   "devDependencies": {
     "@types/react": "^18.0.0",
+    "react": "18.3.1",
+    "react-native": "0.76.2",
     "react-native-builder-bob": "^0.20.4",
     "typescript": "^5.2.2"
   },

package/src/CloudX.ts

@@ -1,5 +1,6 @@
 import type { CloudXType, CloudXLogLevelValue } from './types/CloudX';
 import type { CloudXInitializationResult } from './types/Configuration';
+import type { CloudXArbiterConfiguration, CloudXArbiterResult } from './types/Arbiter';
 import NativeCloudX from './specs/NativeCloudX';
 import { PLUGIN_VERSION } from './version';
 
@@ -51,6 +52,10 @@ const setDoNotSell = (isDoNotSell: boolean | null): void => {
     NativeCloudX.setDoNotSell(isDoNotSell);
 };
 
+const arbiter = (configuration: CloudXArbiterConfiguration): Promise<CloudXArbiterResult> => {
+    return NativeCloudX.arbiter(configuration) as Promise<CloudXArbiterResult>;
+};
+
 export const CloudX: CloudXType = {
     isInitialized,
     initialize,
@@ -64,6 +69,7 @@ export const CloudX: CloudXType = {
     setVisualDebuggingEnabled,
     setHasUserConsent,
     setDoNotSell,
+    arbiter,
 };
 
 export default CloudX;

package/src/CloudXBannerAd.ts

@@ -2,6 +2,7 @@ import { addEventListener, removeEventListener } from './EventEmitter';
 import type { CloudXAdPosition } from './CloudXAdPosition';
 import type { CloudXAdInfo, CloudXAdLoadFailedInfo } from './types/AdInfo';
 import type { CloudXBannerAdType } from './types/BannerAd';
+import type { CloudXExtraParameters } from './types/ExtraParameters';
 import NativeCloudX from './specs/NativeCloudX';
 
 const {
@@ -41,6 +42,10 @@ const setCustomData = (adUnitId: string, customData: string | null): void => {
     NativeCloudX.setBannerCustomData(adUnitId, customData);
 };
 
+const setExtraParameters = (adUnitId: string, extraParameters: CloudXExtraParameters): void => {
+    NativeCloudX.setBannerExtraParameters(adUnitId, extraParameters);
+};
+
 const updatePosition = (adUnitId: string, bannerPosition: CloudXAdPosition): void => {
     NativeCloudX.updateBannerPosition(adUnitId, bannerPosition);
 };
@@ -121,6 +126,7 @@ export const CloudXBannerAd: CloudXBannerAdType = {
 
     setPlacement,
     setCustomData,
+    setExtraParameters,
 
     updatePosition,
 

package/src/CloudXInterstitialAd.ts

@@ -1,5 +1,6 @@
 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';
 
@@ -21,6 +22,10 @@ const loadAd = (adUnitId: string): void => {
     NativeCloudX.loadInterstitial(adUnitId);
 };
 
+const setExtraParameters = (adUnitId: string, extraParameters: CloudXExtraParameters): void => {
+    NativeCloudX.setInterstitialExtraParameters(adUnitId, extraParameters);
+};
+
 const showAd = (adUnitId: string, placement?: string | null, customData?: string | null): void => {
     NativeCloudX.showInterstitial(adUnitId, placement ?? undefined, customData ?? undefined);
 };
@@ -81,6 +86,7 @@ const removeAdRevenuePaidListener = (): void => {
 export const CloudXInterstitialAd: CloudXFullscreenAdType = {
     isAdReady,
     loadAd,
+    setExtraParameters,
     showAd,
     destroyAd,
 

package/src/CloudXMRECAd.ts

@@ -2,6 +2,7 @@ import { addEventListener, removeEventListener } from './EventEmitter';
 import type { CloudXAdPosition } from './CloudXAdPosition';
 import type { CloudXAdInfo, CloudXAdLoadFailedInfo } from './types/AdInfo';
 import type { CloudXMRECAdType } from './types/MRECAd';
+import type { CloudXExtraParameters } from './types/ExtraParameters';
 import NativeCloudX from './specs/NativeCloudX';
 
 const {
@@ -41,6 +42,10 @@ const setCustomData = (adUnitId: string, customData: string | null): void => {
     NativeCloudX.setMRECCustomData(adUnitId, customData);
 };
 
+const setExtraParameters = (adUnitId: string, extraParameters: CloudXExtraParameters): void => {
+    NativeCloudX.setMRECExtraParameters(adUnitId, extraParameters);
+};
+
 const updatePosition = (adUnitId: string, bannerPosition: CloudXAdPosition): void => {
     NativeCloudX.updateMRECPosition(adUnitId, bannerPosition);
 };
@@ -121,6 +126,7 @@ export const CloudXMRECAd: CloudXMRECAdType = {
 
     setPlacement,
     setCustomData,
+    setExtraParameters,
 
     updatePosition,
 

package/src/CloudXRewardedAd.ts

@@ -1,5 +1,6 @@
 import { addEventListener, removeEventListener } from './EventEmitter';
 import type { CloudXAdDisplayFailedInfo, CloudXAdInfo, CloudXAdLoadFailedInfo, CloudXAdRewardInfo } from './types/AdInfo';
+import type { CloudXExtraParameters } from './types/ExtraParameters';
 import type { CloudXRewardedAdType } from './types/RewardedAd';
 import NativeCloudX from './specs/NativeCloudX';
 
@@ -22,6 +23,10 @@ const loadAd = (adUnitId: string): void => {
     NativeCloudX.loadRewarded(adUnitId);
 };
 
+const setExtraParameters = (adUnitId: string, extraParameters: CloudXExtraParameters): void => {
+    NativeCloudX.setRewardedExtraParameters(adUnitId, extraParameters);
+};
+
 const showAd = (adUnitId: string, placement?: string | null, customData?: string | null): void => {
     NativeCloudX.showRewarded(adUnitId, placement ?? undefined, customData ?? undefined);
 };
@@ -89,6 +94,7 @@ const removeAdRevenuePaidListener = (): void => {
 export const CloudXRewardedAd: CloudXRewardedAdType = {
     isAdReady,
     loadAd,
+    setExtraParameters,
     showAd,
     destroyAd,
 

package/src/index.ts

@@ -1,6 +1,7 @@
 // Core SDK
 export { default, CloudX } from './CloudX';
 export { default as NativeCloudX } from './specs/NativeCloudX';
+export { CloudXArbiterBid } from './types/Arbiter';
 
 // Ad Modules
 export { CloudXInterstitialAd } from './CloudXInterstitialAd';
@@ -29,6 +30,12 @@ export type {
     CloudXConfiguration,
     CloudXType,
     CloudXLogLevelValue,
+    CloudXArbiterConfiguration,
+    CloudXArbiterPlatform,
+    CloudXArbiterResult,
+    CloudXSDKArbiterBid,
+    CloudXLevelPlayArbiterBid,
+    CloudXPubMaticArbiterBid,
     CloudXFullscreenAdType,
     CloudXInterstitialAdType,
     CloudXRewardedAdType,
@@ -38,6 +45,8 @@ export type {
     CloudXAdProps,
     CloudXAdEventObject,
     CloudXAdEventListener,
+    CloudXExtraParameterValue,
+    CloudXExtraParameters,
 } from './types';
 
 // Log level constants

package/src/specs/NativeCloudX.ts

@@ -1,4 +1,5 @@
 import type { TurboModule } from 'react-native';
+import type { UnsafeObject } from 'react-native/Libraries/Types/CodegenTypes';
 import { TurboModuleRegistry } from 'react-native';
 import type { CloudXConfiguration } from '../types/Configuration';
 
@@ -9,7 +10,7 @@ import type { CloudXConfiguration } from '../types/Configuration';
  * Codegen uses this to produce type-safe native bindings.
  *
  * All methods correspond 1-to-1 with public APIs in the native iOS SDK
- * (CloudXCore 2.1.0-beta) and the native Android SDK.
+ * (CloudXCore) and the native Android SDK.
  */
 export interface Spec extends TurboModule {
     // =========================================================================
@@ -85,6 +86,12 @@ export interface Spec extends TurboModule {
     setHasUserConsent(hasUserConsent: boolean | null): void;
     setDoNotSell(isDoNotSell: boolean | null): void;
 
+    // =========================================================================
+    // Arbiter
+    // =========================================================================
+
+    arbiter(configuration: UnsafeObject): Promise<UnsafeObject>;
+
     // =========================================================================
     // Banner (Programmatic)
     // =========================================================================
@@ -94,6 +101,7 @@ export interface Spec extends TurboModule {
     setBannerBackgroundColor(adUnitId: string, hexColorString: string): void;
     setBannerPlacement(adUnitId: string, placement: string | null): void;
     setBannerCustomData(adUnitId: string, customData: string | null): void;
+    setBannerExtraParameters(adUnitId: string, extraParameters: UnsafeObject): void;
     updateBannerPosition(adUnitId: string, position: string): void;
     updateBannerOffsets(adUnitId: string, xOffset: number, yOffset: number): void;
     startBannerAutoRefresh(adUnitId: string): void;
@@ -110,6 +118,7 @@ export interface Spec extends TurboModule {
     createMRECWithOffsets(adUnitId: string, position: string, xOffset: number, yOffset: number): void;
     setMRECPlacement(adUnitId: string, placement: string | null): void;
     setMRECCustomData(adUnitId: string, customData: string | null): void;
+    setMRECExtraParameters(adUnitId: string, extraParameters: UnsafeObject): void;
     updateMRECPosition(adUnitId: string, position: string): void;
     updateMRECOffsets(adUnitId: string, xOffset: number, yOffset: number): void;
     startMRECAutoRefresh(adUnitId: string): void;
@@ -124,6 +133,7 @@ export interface Spec extends TurboModule {
     // =========================================================================
 
     loadInterstitial(adUnitId: string): void;
+    setInterstitialExtraParameters(adUnitId: string, extraParameters: UnsafeObject): void;
     isInterstitialReady(adUnitId: string): Promise<boolean>;
     showInterstitial(adUnitId: string, placement?: string | null, customData?: string | null): void;
     destroyInterstitial(adUnitId: string): void;
@@ -133,6 +143,7 @@ export interface Spec extends TurboModule {
     // =========================================================================
 
     loadRewarded(adUnitId: string): void;
+    setRewardedExtraParameters(adUnitId: string, extraParameters: UnsafeObject): void;
     isRewardedReady(adUnitId: string): Promise<boolean>;
     showRewarded(adUnitId: string, placement?: string | null, customData?: string | null): void;
     destroyRewarded(adUnitId: string): void;

package/src/types/AdInfo.ts

@@ -21,6 +21,9 @@ export type CloudXAdInfo = {
 
     /** The revenue generated from the ad impression, in USD. Defaults to 0. */
     revenue: number;
+
+    /** SDK-owned metadata values associated with this loaded ad. */
+    adValues: Record<string, string>;
 };
 
 /**

package/src/types/Arbiter.ts

@@ -0,0 +1,62 @@
+import type { CloudXAdInfo } from './AdInfo';
+
+export type CloudXArbiterPlatform = 'CLOUDX' | 'LEVELPLAY' | 'PUBMATIC' | 'NONE';
+
+export type CloudXSDKArbiterBid = {
+    platform: 'CLOUDX';
+    ad: CloudXAdInfo;
+};
+
+export type CloudXLevelPlayArbiterBid = {
+    platform: 'LEVELPLAY';
+    networkName: string;
+    revenue: number;
+    precision: string;
+    extras?: Record<string, string>;
+};
+
+export type CloudXPubMaticArbiterBid = {
+    platform: 'PUBMATIC';
+    price: number;
+    partnerName?: string | null;
+    extras?: Record<string, string>;
+};
+
+export type CloudXArbiterBid =
+    | CloudXSDKArbiterBid
+    | CloudXLevelPlayArbiterBid
+    | CloudXPubMaticArbiterBid;
+
+export const CloudXArbiterBid = {
+    cloudX(ad: CloudXAdInfo): CloudXSDKArbiterBid {
+        return {
+            platform: 'CLOUDX',
+            ad,
+        };
+    },
+
+    levelPlay(params: Omit<CloudXLevelPlayArbiterBid, 'platform'>): CloudXLevelPlayArbiterBid {
+        return {
+            platform: 'LEVELPLAY',
+            ...params,
+        };
+    },
+
+    pubMatic(params: Omit<CloudXPubMaticArbiterBid, 'platform'>): CloudXPubMaticArbiterBid {
+        return {
+            platform: 'PUBMATIC',
+            ...params,
+        };
+    },
+} as const;
+
+export type CloudXArbiterConfiguration = {
+    bids: CloudXArbiterBid[];
+};
+
+export type CloudXArbiterResult = {
+    id: string;
+    platform: CloudXArbiterPlatform;
+    bidId?: string | null;
+    extras: Record<string, string>;
+};

package/src/types/CloudX.ts

@@ -1,4 +1,5 @@
 import type { CloudXInitializationResult } from './Configuration';
+import type { CloudXArbiterConfiguration, CloudXArbiterResult } from './Arbiter';
 
 export type CloudXLogLevelValue = 'verbose' | 'debug' | 'info' | 'warn' | 'error' | 'none';
 
@@ -53,4 +54,7 @@ export type CloudXType = {
      * priority when present.
      */
     setDoNotSell(isDoNotSell: boolean | null): void;
+
+    /** Runs CloudX Arbiter using bid data passed through to the native SDK. */
+    arbiter(configuration: CloudXArbiterConfiguration): Promise<CloudXArbiterResult>;
 };

package/src/types/ExtraParameters.ts

@@ -0,0 +1,11 @@
+export type CloudXExtraParameterValue =
+    | string
+    | number
+    | boolean
+    | null
+    | CloudXExtraParameterValue[]
+    | { [key: string]: CloudXExtraParameterValue };
+
+export type CloudXExtraParameters = {
+    [key: string]: CloudXExtraParameterValue;
+};

package/src/types/FullscreenAd.ts

@@ -1,5 +1,6 @@
 import type { CloudXAdDisplayFailedInfo, CloudXAdInfo, CloudXAdLoadFailedInfo } from './AdInfo';
 import type { CloudXAdEventListener } from './AdEvent';
+import type { CloudXExtraParameters } from './ExtraParameters';
 
 /**
  * Shared interface for fullscreen ad types (Interstitial, Rewarded).
@@ -11,6 +12,9 @@ export type CloudXFullscreenAdType = {
     /** Loads an ad for the given ad unit. */
     loadAd(adUnitId: string): void;
 
+    /** Sets or clears extra parameters attached to the next bid request for this ad. */
+    setExtraParameters(adUnitId: string, extraParameters: CloudXExtraParameters): void;
+
     /** Shows a previously loaded ad. */
     showAd(adUnitId: string, placement?: string | null, customData?: string | null): void;
 

package/src/types/ViewAd.ts

@@ -1,5 +1,6 @@
 import type { CloudXAdInfo, CloudXAdLoadFailedInfo } from './AdInfo';
 import type { CloudXAdEventListener } from './AdEvent';
+import type { CloudXExtraParameters } from './ExtraParameters';
 import type { CloudXAdPosition } from '../CloudXAdPosition';
 
 /**
@@ -12,6 +13,7 @@ export type CloudXViewAdType = {
 
     setPlacement(adUnitId: string, placement: string | null): void;
     setCustomData(adUnitId: string, customData: string | null): void;
+    setExtraParameters(adUnitId: string, extraParameters: CloudXExtraParameters): void;
 
     updatePosition(adUnitId: string, bannerPosition: CloudXAdPosition): void;
 

package/src/types/index.ts

@@ -1,6 +1,15 @@
 export type { CloudXAdInfo, CloudXAdLoadFailedInfo, CloudXAdDisplayFailedInfo, CloudXAdRewardInfo } from './AdInfo';
 export type { CloudXInitializationResult, CloudXConfiguration } from './Configuration';
 export type { CloudXType, CloudXLogLevelValue } from './CloudX';
+export type {
+    CloudXArbiterBid,
+    CloudXArbiterConfiguration,
+    CloudXArbiterPlatform,
+    CloudXArbiterResult,
+    CloudXSDKArbiterBid,
+    CloudXLevelPlayArbiterBid,
+    CloudXPubMaticArbiterBid,
+} from './Arbiter';
 export type { CloudXFullscreenAdType } from './FullscreenAd';
 export type { CloudXInterstitialAdType } from './InterstitialAd';
 export type { CloudXRewardedAdType } from './RewardedAd';
@@ -9,3 +18,4 @@ export type { CloudXBannerAdType } from './BannerAd';
 export type { CloudXMRECAdType } from './MRECAd';
 export type { CloudXAdProps } from './AdProps';
 export type { CloudXAdEventObject, CloudXAdEventListener } from './AdEvent';
+export type { CloudXExtraParameterValue, CloudXExtraParameters } from './ExtraParameters';

package/src/version.ts

@@ -1,3 +1,3 @@
 // Keep PLUGIN_VERSION in sync with the `version` field in package.json.
 // Phase 1 of RELEASE.md bumps both together.
-export const PLUGIN_VERSION = '3.2.0';
+export const PLUGIN_VERSION = '3.4.4';