cloudx-react-native 3.10.0 → 3.11.0

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

@@ -0,0 +1,72 @@
+/**
+ * Context provider for the manual-render `<CloudXNativeAdView/>` flow.
+ *
+ * The pre-built asset components (title, advertiser, body, CTA, icon,
+ * options, media, star rating) read metadata and refs from this context.
+ * The host `<CloudXNativeAdView/>` owns the `setNativeAd` state setter and
+ * publishes the latest `CloudXNativeAdMetadata` when `onAdLoaded` fires so
+ * pre-built components re-render with the new content.
+ *
+ * Design notes:
+ * - A `starRatingRef` lets the star component participate in the binder
+ *   pipeline (even though the native side treats it as decorative).
+ * - Refs are typed explicitly rather than relying on `any`, so misuse
+ *   surfaces at compile time.
+ * - Adds `registerAssetRole`, called by every pre-built asset component on
+ *   mount. The host `<CloudXNativeAdView/>` passes `onAssetRoleRegistered`
+ *   to detect an asset component mounted while `renderMode` is `'template'`
+ *   — a likely publisher mistake — and warn once.
+ */
+import * as React from 'react';
+import type { ReactNode } from 'react';
+import type { Image, Text, View } from 'react-native';
+import type { CloudXNativeAdMetadata } from './types/NativeAd';
+type TextRef = React.ElementRef<typeof Text>;
+type ImageRef = React.ElementRef<typeof Image>;
+type ViewRef = React.ElementRef<typeof View>;
+/**
+ * Shape exposed to pre-built asset components. Consumers typically destructure
+ * a single ref + the `nativeAd` field; the setter is only used by the host.
+ */
+export type CloudXNativeAdViewContextValue = {
+    titleRef: React.RefObject<TextRef | null>;
+    advertiserRef: React.RefObject<TextRef | null>;
+    bodyRef: React.RefObject<TextRef | null>;
+    callToActionRef: React.RefObject<TextRef | null>;
+    iconRef: React.RefObject<ImageRef | null>;
+    optionsRef: React.RefObject<ViewRef | null>;
+    mediaRef: React.RefObject<ViewRef | null>;
+    starRatingRef: React.RefObject<ViewRef | null>;
+    nativeAd: CloudXNativeAdMetadata | null;
+    setNativeAd: React.Dispatch<React.SetStateAction<CloudXNativeAdMetadata | null>>;
+    /**
+     * Called by each pre-built asset component on mount, naming its asset
+     * role. Returns an unregister function, so an effect can simply
+     * `return registerAssetRole('CloudXTitleView')` and have the role drop
+     * out again when the component unmounts.
+     */
+    registerAssetRole: (role: string) => () => void;
+    /**
+     * Roles whose component is currently mounted. The host intersects this
+     * with the loaded ad's own asset set, so it only waits on a binding the
+     * publisher's layout can actually satisfy.
+     */
+    mountedAssetRoles: React.MutableRefObject<Set<string>>;
+};
+export declare const CloudXNativeAdViewContext: React.Context<CloudXNativeAdViewContextValue>;
+type ProviderProps = {
+    children: ReactNode;
+    /**
+     * Invoked when a descendant asset component registers its role. The host
+     * `<CloudXNativeAdView/>` uses this to warn when an asset component is
+     * mounted while `renderMode` is `'template'`.
+     */
+    onAssetRoleRegistered?: (role: string) => void;
+};
+/**
+ * Wrap this around the root of a `<CloudXNativeAdView/>` tree so descendant
+ * asset components share refs and ad state.
+ */
+export declare const CloudXNativeAdViewProvider: React.FC<ProviderProps>;
+export {};
+//# sourceMappingURL=CloudXNativeAdViewProvider.d.ts.map

package/lib/typescript/src/CloudXNativeAdViewProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CloudXNativeAdViewProvider.d.ts","sourceRoot":"","sources":["../../../src/CloudXNativeAdViewProvider.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE/D,KAAK,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;AAC7C,KAAK,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC;AAC/C,KAAK,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;AAE7C;;;GAGG;AACH,MAAM,MAAM,8BAA8B,GAAG;IACzC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAC1C,aAAa,EAAE,KAAK,CAAC,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAC/C,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACzC,eAAe,EAAE,KAAK,CAAC,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACjD,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAC1C,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAC5C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAC1C,aAAa,EAAE,KAAK,CAAC,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAC/C,QAAQ,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACxC,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAC,CAAC;IACjF;;;;;OAKG;IACH,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,IAAI,CAAC;IAChD;;;;OAIG;IACH,iBAAiB,EAAE,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;CAC1D,CAAC;AAUF,eAAO,MAAM,yBAAyB,+CAgBpC,CAAC;AAEH,KAAK,aAAa,GAAG;IACjB,QAAQ,EAAE,SAAS,CAAC;IACpB;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAClD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAE,KAAK,CAAC,EAAE,CAAC,aAAa,CAgD9D,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { NativeExtraParameterEntry } from './specs/CloudXAdViewNativeComponent';
+import type { CloudXAdProps } from './types/AdProps';
+export declare const toNativeExtraParameterEntries: (extraParameters?: CloudXAdProps["extraParameters"]) => ReadonlyArray<NativeExtraParameterEntry>;
+//# sourceMappingURL=extraParameters.d.ts.map

package/lib/typescript/src/extraParameters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extraParameters.d.ts","sourceRoot":"","sources":["../../../src/extraParameters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AACrF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AA4CrD,eAAO,MAAM,6BAA6B,GACtC,kBAAkB,aAAa,CAAC,iBAAiB,CAAC,KACnD,aAAa,CAAC,yBAAyB,CAiBzC,CAAC"}

package/lib/typescript/src/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/hooks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA6BH,MAAM,MAAM,4BAA4B,GAAG;IACvC,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,IAAI,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACtE,OAAO,EAAE,MAAM,IAAI,CAAC;CACvB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,4BAA4B,CA+EpF;AAMD,MAAM,MAAM,uBAAuB,GAAG;IAClC,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,IAAI,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACtE,OAAO,EAAE,MAAM,IAAI,CAAC;CACvB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,uBAAuB,CA+E1E;AAMD,MAAM,MAAM,wBAAwB,GAAG;IACnC,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;IACtB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,IAAI,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACtE,OAAO,EAAE,MAAM,IAAI,CAAC;CACvB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,wBAAwB,CA2F5E;AAMD,MAAM,MAAM,sBAAsB,GAAG;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,sBAAsB,CAmCxE"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/hooks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA6BH,MAAM,MAAM,4BAA4B,GAAG;IACvC,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,IAAI,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACtE,OAAO,EAAE,MAAM,IAAI,CAAC;CACvB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,4BAA4B,CAyFpF;AAMD,MAAM,MAAM,uBAAuB,GAAG;IAClC,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,IAAI,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACtE,OAAO,EAAE,MAAM,IAAI,CAAC;CACvB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,uBAAuB,CAyF1E;AAMD,MAAM,MAAM,wBAAwB,GAAG;IACnC,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;IACtB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,IAAI,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACtE,OAAO,EAAE,MAAM,IAAI,CAAC;CACvB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,wBAAwB,CAsG5E;AAMD,MAAM,MAAM,sBAAsB,GAAG;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,sBAAsB,CA0CxE"}

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

@@ -11,12 +11,15 @@ export { CloudXMRECAd } from './CloudXMRECAd';
 export { CloudXAdPosition } from './CloudXAdPosition';
 export { CloudXBannerView } from './CloudXBannerView';
 export { CloudXMRECView } from './CloudXMRECView';
+export { CloudXNativeAdView } from './CloudXNativeAdView';
+export { CloudXTitleView, CloudXAdvertiserView, CloudXBodyView, CloudXCallToActionView, CloudXIconView, CloudXOptionsView, CloudXMediaView, CloudXStarRatingView, } from './CloudXNativeAdViewComponents';
 export type { CloudXAdViewProps, CloudXAdViewFormat } from './CloudXAdViewBase';
 export { CloudXErrorCode } from './CloudXErrorCode';
 export { requestTrackingAuthorization, getTrackingAuthorizationStatus, CloudXATTStatus } from './AppTrackingTransparency';
 export { useCloudXInterstitial, useCloudXAppOpen, useCloudXRewarded, useCloudXBanner } from './hooks';
 export type { CloudXInterstitialHookResult, CloudXAppOpenHookResult, CloudXRewardedHookResult, CloudXBannerHookResult, } from './hooks';
-export type { CloudXAdInfo, CloudXAdLoadFailedInfo, CloudXAdDisplayFailedInfo, CloudXAdRewardInfo, CloudXInitializationResult, CloudXConfiguration, CloudXType, CloudXLogLevelValue, CloudXArbiterConfiguration, CloudXArbiterPlatform, CloudXArbiterResult, CloudXSDKArbiterBid, CloudXLevelPlayArbiterBid, CloudXPubMaticArbiterBid, CloudXCustomArbiterBid, CloudXAdMobArbiterBid, CloudXGamArbiterBid, CloudXRevenueData, CloudXRevenuePlatformValue, CloudXRevenuePrecisionValue, CloudXFullscreenAdType, CloudXInterstitialAdType, CloudXAppOpenAdType, CloudXRewardedAdType, CloudXViewAdType, CloudXBannerAdType, CloudXMRECAdType, CloudXAdProps, CloudXAdEventObject, CloudXAdEventListener, CloudXExtraParameterValue, CloudXExtraParameters, } from './types';
+export type { CloudXAdInfo, CloudXAdLoadFailedInfo, CloudXAdDisplayFailedInfo, CloudXAdRewardInfo, CloudXInitializationResult, CloudXConfiguration, CloudXType, CloudXLogLevelValue, CloudXArbiterConfiguration, CloudXArbiterPlatform, CloudXArbiterResult, CloudXSDKArbiterBid, CloudXLevelPlayArbiterBid, CloudXPubMaticArbiterBid, CloudXCustomArbiterBid, CloudXAdMobArbiterBid, CloudXGamArbiterBid, CloudXRevenueData, CloudXRevenuePlatformValue, CloudXRevenuePrecisionValue, CloudXFullscreenAdType, CloudXInterstitialAdType, CloudXAppOpenAdType, CloudXRewardedAdType, CloudXViewAdType, CloudXBannerAdType, CloudXMRECAdType, CloudXAdProps, CloudXAdEventObject, CloudXAdEventListener, CloudXExtraParameterValue, CloudXExtraParameters, CloudXNativeAdMetadata, CloudXNativeAdViewHandle, CloudXNativeAdViewProps, CloudXLocalExtraParameters, } from './types';
+export { CloudXNativeTemplate } from './types';
 export declare const CloudXLogLevel: {
     readonly VERBOSE: "verbose";
     readonly DEBUG: "debug";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAI/D,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAGpF,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGhF,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,EAAE,4BAA4B,EAAE,8BAA8B,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAG1H,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AACtG,YAAY,EACR,4BAA4B,EAC5B,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,GACzB,MAAM,SAAS,CAAC;AAGjB,YAAY,EACR,YAAY,EACZ,sBAAsB,EACtB,yBAAyB,EACzB,kBAAkB,EAClB,0BAA0B,EAC1B,mBAAmB,EACnB,UAAU,EACV,mBAAmB,EACnB,0BAA0B,EAC1B,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,EACjB,0BAA0B,EAC1B,2BAA2B,EAC3B,sBAAsB,EACtB,wBAAwB,EACxB,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,mBAAmB,EACnB,qBAAqB,EACrB,yBAAyB,EACzB,qBAAqB,GACxB,MAAM,SAAS,CAAC;AAGjB,eAAO,MAAM,cAAc;;;;;;;CAOjB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAI/D,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAGpF,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EACH,eAAe,EACf,oBAAoB,EACpB,cAAc,EACd,sBAAsB,EACtB,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,oBAAoB,GACvB,MAAM,gCAAgC,CAAC;AASxC,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGhF,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,EAAE,4BAA4B,EAAE,8BAA8B,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAG1H,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AACtG,YAAY,EACR,4BAA4B,EAC5B,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,GACzB,MAAM,SAAS,CAAC;AAGjB,YAAY,EACR,YAAY,EACZ,sBAAsB,EACtB,yBAAyB,EACzB,kBAAkB,EAClB,0BAA0B,EAC1B,mBAAmB,EACnB,UAAU,EACV,mBAAmB,EACnB,0BAA0B,EAC1B,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,EACjB,0BAA0B,EAC1B,2BAA2B,EAC3B,sBAAsB,EACtB,wBAAwB,EACxB,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,mBAAmB,EACnB,qBAAqB,EACrB,yBAAyB,EACzB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACvB,0BAA0B,GAC7B,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAG/C,eAAO,MAAM,cAAc;;;;;;;CAOjB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC"}

package/lib/typescript/src/specs/CloudXNativeAdViewNativeComponent.d.ts

@@ -0,0 +1,103 @@
+import type * as React from 'react';
+import type { HostComponent, ViewProps } from 'react-native';
+import type { Double, Int32, DirectEventHandler, UnsafeMixed } from 'react-native/Libraries/Types/CodegenTypes';
+/**
+ * Payload for native-ad lifecycle events (load, click, revenue).
+ *
+ * Codegen cannot express `Record<string, string>`, so the SDK-owned ad values
+ * are delivered as a JSON-encoded string in `adValuesJson` (mirroring
+ * CloudXAdViewNativeComponent) and re-parsed into a map by the JS wrapper.
+ * The loaded native ad's own metadata (title, media, icon, etc.) is likewise
+ * delivered as a JSON-encoded string in `nativeAdJson`, since codegen cannot
+ * express the native ad's heterogeneous field set as typed props.
+ */
+export type CloudXNativeAdInfoEvent = Readonly<{
+    adUnitId: string;
+    adFormat: string;
+    networkName: string;
+    networkPlacement?: string | null;
+    placement?: string | null;
+    creativeId?: string | null;
+    revenue: Double;
+    adValuesJson?: string | null;
+    nativeAdJson?: string | null;
+}>;
+/**
+ * Payload for native-ad load/display-failure events.
+ */
+export type CloudXNativeAdLoadFailedEvent = Readonly<{
+    adUnitId: string;
+    code: Double;
+    message?: string | null;
+}>;
+export type NativeExtraParameterEntry = Readonly<{
+    key: string;
+    value: UnsafeMixed;
+}>;
+/**
+ * Props for the native CloudXNativeAdView component.
+ *
+ * Mirrors the in-tree CloudXAdView (banner/MREC) component: the ad renders as
+ * an ordinary React Native view so publisher overlays layer above it via
+ * normal RN z-ordering.
+ */
+export interface NativeProps extends ViewProps {
+    /** Ad unit ID used to load the ad. */
+    adUnitId: string;
+    /**
+     * Publisher-selected template name (e.g. "small_template",
+     * "medium_template"). Named `templateName`, not `template` — codegen
+     * emits the prop as a literal `std::string template` struct member on
+     * the generated Props class, and `template` is a reserved word in C++,
+     * so that spelling fails to compile. The Old Architecture manager also
+     * accepts the legacy `template` prop name and aliases it internally for
+     * publisher compatibility.
+     */
+    templateName?: string | null;
+    /** Optional placement name for reporting. */
+    placement?: string | null;
+    /** Optional custom data string. */
+    customData?: string | null;
+    /** Extra parameters applied to the underlying native ad loader. */
+    extraParameters?: ReadonlyArray<NativeExtraParameterEntry>;
+    /** Local-only extra parameters applied to the underlying native ad loader. */
+    localExtraParameters?: ReadonlyArray<NativeExtraParameterEntry>;
+    /** Disables the video full-screen affordance when true. */
+    disableVideoFullScreen?: boolean;
+    /** Starts video creatives unmuted when true. */
+    startVideoUnmuted?: boolean;
+    /** Hides video media controls when true. */
+    hideVideoMediaControls?: boolean;
+    /**
+     * When true, the host skips template rendering and lets the JS layer
+     * drive layout through the `updateAssetView` + `renderNativeAd` commands.
+     */
+    manualRender?: boolean;
+    /** Called when an ad is successfully loaded. */
+    onAdLoadedEvent: DirectEventHandler<CloudXNativeAdInfoEvent>;
+    /** Called when the SDK fails to load an ad. */
+    onAdLoadFailedEvent: DirectEventHandler<CloudXNativeAdLoadFailedEvent>;
+    /** Called when the ad fails to render/display (e.g. manual render before load). */
+    onAdDisplayFailedEvent: DirectEventHandler<CloudXNativeAdLoadFailedEvent>;
+    /** Called when the ad is clicked. */
+    onAdClickedEvent: DirectEventHandler<CloudXNativeAdInfoEvent>;
+    /** Called when the loaded ad expires. */
+    onAdExpiredEvent: DirectEventHandler<CloudXNativeAdInfoEvent>;
+    /** Called when the ad is closed. */
+    onAdClosedEvent: DirectEventHandler<CloudXNativeAdInfoEvent>;
+    /** Called when ad revenue is paid. */
+    onAdRevenuePaidEvent: DirectEventHandler<CloudXNativeAdInfoEvent>;
+}
+export interface NativeCommands {
+    loadAd: (viewRef: React.ElementRef<HostComponent<NativeProps>>) => void;
+    destroyAd: (viewRef: React.ElementRef<HostComponent<NativeProps>>) => void;
+    updateAssetView: (viewRef: React.ElementRef<HostComponent<NativeProps>>, assetViewTag: Int32, assetName: string) => void;
+    renderNativeAd: (viewRef: React.ElementRef<HostComponent<NativeProps>>) => void;
+}
+export declare const Commands: NativeCommands;
+/**
+ * Native in-tree view component backing the publisher-facing native ad view.
+ */
+declare const _default: HostComponent<NativeProps>;
+export default _default;
+//# sourceMappingURL=CloudXNativeAdViewNativeComponent.d.ts.map

package/lib/typescript/src/specs/CloudXNativeAdViewNativeComponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CloudXNativeAdViewNativeComponent.d.ts","sourceRoot":"","sources":["../../../../src/specs/CloudXNativeAdViewNativeComponent.ts"],"names":[],"mappings":"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"}

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

@@ -1,11 +1,12 @@
 import type { CloudXErrorCode } from '../CloudXErrorCode';
+import type { CloudXNativeAdMetadata } from './NativeAd';
 /**
  * Represents a successfully loaded ad served by CloudX.
  */
 export type CloudXAdInfo = {
     /** The ad unit ID for this ad. */
     adUnitId: string;
-    /** The format of the ad (e.g., "BANNER", "MREC", "INTERSTITIAL", "REWARDED"). */
+    /** The format of the ad (e.g., "BANNER", "MREC", "INTERSTITIAL", "REWARDED", "NATIVE"). */
     adFormat: string;
     /** The name of the ad network that served the ad. */
     networkName: string;
@@ -19,6 +20,8 @@ export type CloudXAdInfo = {
     revenue: number;
     /** SDK-owned metadata values associated with this loaded ad. */
     adValues: Record<string, string>;
+    /** Structured native-ad metadata when the loaded creative is a native ad. */
+    nativeAd?: CloudXNativeAdMetadata | null;
 };
 /**
  * Represents a failure when attempting to load an ad.

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

@@ -1 +1 @@
-{"version":3,"file":"AdInfo.d.ts","sourceRoot":"","sources":["../../../../src/types/AdInfo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACvB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IAEjB,iFAAiF;IACjF,QAAQ,EAAE,MAAM,CAAC;IAEjB,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IAEpB,sEAAsE;IACtE,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjC,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B,2EAA2E;IAC3E,OAAO,EAAE,MAAM,CAAC;IAEhB,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACjC,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IAEjB,yBAAyB;IACzB,IAAI,EAAE,eAAe,CAAC;IAEtB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,YAAY,GAAG;IACnD,yBAAyB;IACzB,IAAI,EAAE,eAAe,CAAC;IAEtB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG;IAC5C,+BAA+B;IAC/B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B,yBAAyB;IACzB,YAAY,EAAE,MAAM,CAAC;CACxB,CAAC"}
+{"version":3,"file":"AdInfo.d.ts","sourceRoot":"","sources":["../../../../src/types/AdInfo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACvB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IAEjB,2FAA2F;IAC3F,QAAQ,EAAE,MAAM,CAAC;IAEjB,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IAEpB,sEAAsE;IACtE,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjC,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B,2EAA2E;IAC3E,OAAO,EAAE,MAAM,CAAC;IAEhB,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAC;CAC5C,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACjC,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IAEjB,yBAAyB;IACzB,IAAI,EAAE,eAAe,CAAC;IAEtB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,YAAY,GAAG;IACnD,yBAAyB;IACzB,IAAI,EAAE,eAAe,CAAC;IAEtB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG;IAC5C,+BAA+B;IAC/B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B,yBAAyB;IACzB,YAAY,EAAE,MAAM,CAAC;CACxB,CAAC"}

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

@@ -0,0 +1,114 @@
+import type { ViewProps } from 'react-native';
+import type { CloudXAdDisplayFailedInfo, CloudXAdInfo } from './AdInfo';
+import type { CloudXAdProps } from './AdProps';
+import type { CloudXExtraParameterValue } from './ExtraParameters';
+/**
+ * Built-in native ad template variants rendered by the SDK's view component.
+ *
+ * All four variants have a distinct bundled layout on both iOS and Android,
+ * and unknown values fall back to `MEDIUM` on both.
+ *
+ * On both platforms this prop selects the **local layout only**. Neither
+ * bid request carries the selection, so the server sizes the creative's
+ * assets for `medium` whatever is chosen here:
+ *
+ * - iOS: `CLXNativeAdLoader` builds its publisher with
+ *   `CLXNativeTemplateDefault`, which is `CLXNativeTemplateMedium`.
+ *   `CLXBidSignals` would thread a non-default template, but the loader
+ *   never supplies one.
+ * - Android: `BidSignalsProvider` writes `nativeRequirements.template`
+ *   as a fixed `"medium"`, pending a public template-selection API.
+ *
+ * A creative rendered in a non-`MEDIUM` layout therefore carries assets cut
+ * for `MEDIUM` — most visible with `VERTICAL_MEDIA`, the full-screen shape.
+ * Tracked as CXD-5385.
+ */
+export declare enum CloudXNativeTemplate {
+    /** 320x90 compact template: icon, title, advertiser, CTA. */
+    SMALL = "small_template",
+    /** 320x250 template. */
+    MEDIUM = "medium_template",
+    /** 320x300 media-forward template. */
+    MEDIA_BANNER = "media_banner_template",
+    /**
+     * Full-screen vertical template sized to the available bounds.
+     * Intended for feed-style vertical experiences. Bundled layout on both
+     * iOS and Android.
+     */
+    VERTICAL_MEDIA = "vertical_media_template"
+}
+/**
+ * Type-safe asset identifiers for custom native-ad binding.
+ */
+export declare enum CloudXNativeAssetType {
+    TITLE = "TitleView",
+    ADVERTISER = "AdvertiserView",
+    BODY = "BodyView",
+    CALL_TO_ACTION = "CallToActionView",
+    ICON = "IconView",
+    OPTIONS = "OptionsView",
+    MEDIA = "MediaView",
+    STAR_RATING = "StarRatingView"
+}
+/**
+ * Structured metadata for a single loaded native ad.
+ *
+ * Surfaced on the `onAdLoaded` callback as `CloudXAdInfo.nativeAd`.
+ */
+export type CloudXNativeAdMetadata = {
+    title?: string | null;
+    advertiser?: string | null;
+    body?: string | null;
+    callToAction?: string | null;
+    starRating?: number | null;
+    mediaContentAspectRatio?: number;
+    isIconImageAvailable: boolean;
+    isOptionsViewAvailable: boolean;
+    isMediaViewAvailable: boolean;
+    url?: string | null;
+    imageSource?: string | null;
+    isVideoContent: boolean;
+    videoDuration: number;
+    isExpired: boolean;
+};
+export type CloudXLocalExtraParameters = {
+    [key: string]: CloudXExtraParameterValue;
+};
+/**
+ * Props for the native-ad view component.
+ *
+ * Callbacks inherited from {@link CloudXAdProps} (`onAdLoaded`, `onAdLoadFailed`,
+ * `onAdClicked`, `onAdRevenuePaid`) receive unwrapped payloads, not synthetic events.
+ */
+export type CloudXNativeAdViewProps = CloudXAdProps & ViewProps & {
+    template?: CloudXNativeTemplate;
+    localExtraParameters?: CloudXLocalExtraParameters;
+    disableVideoFullScreen?: boolean;
+    startVideoUnmuted?: boolean;
+    hideVideoMediaControls?: boolean;
+    /** Selects between the SDK's bundled template layouts and manual asset binding. */
+    renderMode?: 'template' | 'manual';
+    /**
+     * Called when a loaded ad subsequently fails to display or track.
+     *
+     * Emitted on both platforms. Android fires it for post-load
+     * adapter/render errors and when click/impression registration fails in
+     * manual mode. iOS fires it on the three manual-mode failure paths:
+     * render requested before load, expired ad, and registration refused.
+     */
+    onAdDisplayFailed?: (errorInfo: CloudXAdDisplayFailedInfo) => void;
+    onAdExpired?: (adInfo: CloudXAdInfo) => void;
+    onAdClosed?: (adInfo: CloudXAdInfo) => void;
+};
+export type CloudXNativeAdViewHandle = {
+    /**
+     * Requests a load. This does NOT force a new auction: both native SDKs
+     * re-serve the ad they already hold while it is neither expired nor
+     * destroyed, including after its impression. Changed targeting is
+     * therefore not picked up. Call `destroyAd()` first for a fresh ad.
+     */
+    loadAd: () => void;
+    /** Releases the native ad and its resources. */
+    destroyAd: () => void;
+};
+//# sourceMappingURL=NativeAd.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NativeAd.d.ts","sourceRoot":"","sources":["../../../../src/types/NativeAd.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,yBAAyB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,oBAAY,oBAAoB;IAC5B,6DAA6D;IAC7D,KAAK,mBAAmB;IAExB,wBAAwB;IACxB,MAAM,oBAAoB;IAE1B,sCAAsC;IACtC,YAAY,0BAA0B;IAEtC;;;;OAIG;IACH,cAAc,4BAA4B;CAC7C;AAED;;GAEG;AACH,oBAAY,qBAAqB;IAC7B,KAAK,cAAc;IACnB,UAAU,mBAAmB;IAC7B,IAAI,aAAa;IACjB,cAAc,qBAAqB;IACnC,IAAI,aAAa;IACjB,OAAO,gBAAgB;IACvB,KAAK,cAAc;IACnB,WAAW,mBAAmB;CACjC;AAED;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACjC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,oBAAoB,EAAE,OAAO,CAAC;IAC9B,sBAAsB,EAAE,OAAO,CAAC;IAChC,oBAAoB,EAAE,OAAO,CAAC;IAC9B,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;CACtB,CAAC;AAIF,MAAM,MAAM,0BAA0B,GAAG;IACrC,CAAC,GAAG,EAAE,MAAM,GAAG,yBAAyB,CAAC;CAC5C,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAAG,aAAa,GAC/C,SAAS,GAAG;IACR,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,oBAAoB,CAAC,EAAE,0BAA0B,CAAC;IAClD,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,mFAAmF;IACnF,UAAU,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC;IACnC;;;;;;;OAOG;IACH,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,yBAAyB,KAAK,IAAI,CAAC;IACnE,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;IAC7C,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;CAC/C,CAAC;AAEN,MAAM,MAAM,wBAAwB,GAAG;IACnC;;;;;OAKG;IACH,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,gDAAgD;IAChD,SAAS,EAAE,MAAM,IAAI,CAAC;CACzB,CAAC"}

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

@@ -14,4 +14,6 @@ export type { CloudXMRECAdType } from './MRECAd';
 export type { CloudXAdProps } from './AdProps';
 export type { CloudXAdEventObject, CloudXAdEventListener } from './AdEvent';
 export type { CloudXExtraParameterValue, CloudXExtraParameters } from './ExtraParameters';
+export type { CloudXNativeAdMetadata, CloudXNativeAdViewHandle, CloudXNativeAdViewProps, CloudXLocalExtraParameters, } from './NativeAd';
+export { CloudXNativeTemplate, CloudXNativeAssetType } from './NativeAd';
 //# 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,EACR,gBAAgB,EAChB,0BAA0B,EAC1B,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,GACtB,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"}
+{"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,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,GACtB,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;AAC1F,YAAY,EACR,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACvB,0BAA0B,GAC7B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,16 @@
+/**
+ * Polls CloudX SDK initialization state and caches the result module-wide.
+ *
+ * Shared by `CloudXAdViewBase` (banner/MREC) and `CloudXNativeAdView` so
+ * every in-tree ad-view component gates native-view creation on SDK
+ * initialization identically: a view mounted before `CloudX.initialize()`
+ * completes would create its native ad against an uninitialized SDK, which
+ * on iOS returns nil and leaves the view permanently dead (no retry, no
+ * load-failed event). There is no init event to subscribe to, so poll
+ * `isInitialized()` until ready.
+ *
+ * @param componentName Used only in the console warnings, so callers can
+ * tell which component is waiting on initialization.
+ */
+export declare const useCloudXSdkInitializationGate: (componentName: string) => boolean;
+//# sourceMappingURL=useCloudXSdkInitialization.d.ts.map

package/lib/typescript/src/useCloudXSdkInitialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCloudXSdkInitialization.d.ts","sourceRoot":"","sources":["../../../src/useCloudXSdkInitialization.ts"],"names":[],"mappings":"AAWA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,8BAA8B,GAAI,eAAe,MAAM,KAAG,OA+CtE,CAAC"}

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cloudx-react-native",
-  "version": "3.10.0",
+  "version": "3.11.0",
   "description": "React Native wrapper for CloudX SDK (iOS & Android)",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",

package/src/CloudXAdViewBase.tsx

@@ -2,15 +2,13 @@ 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 type { CloudXAdInfoEvent, CloudXAdLoadFailedEvent } 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';
+import { toNativeExtraParameterEntries } from './extraParameters';
+import { useCloudXSdkInitializationGate } from './useCloudXSdkInitialization';
 
 /**
  * Ad format rendered by the in-tree view component.
@@ -40,14 +38,6 @@ const AD_SIZE = {
  */
 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 {};
@@ -77,69 +67,6 @@ const toLoadFailedInfo = (event: CloudXAdLoadFailedEvent): CloudXAdLoadFailedInf
     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
@@ -175,56 +102,12 @@ export const CloudXAdViewBase: React.FC<CloudXAdViewBaseProps> = ({
      * 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.
+     * permanently dead (no retry, no load-failed event). Shared with
+     * CloudXNativeAdView via useCloudXSdkInitializationGate: cached module-wide
+     * so only the first pre-init mount across any ad-view type 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);
-            }
-        };
-    }, []);
+    const isInitialized = useCloudXSdkInitializationGate('CloudXAdView');
 
     useEffect(() => {
         if (adFormat !== 'BANNER' || cachedIsTablet !== null) {