react-native-applovin-max 8.2.0 → 9.1.0

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

@@ -3,59 +3,68 @@ import type { ViewProps } from 'react-native';
 import type { AdInfo, AdLoadFailedInfo } from './types/AdInfo';
 import type { AdViewHandler, NativeUIComponentAdViewOptions, AdViewId } from './types/AdViewProps';
 /**
- * Defines a format of an ad.
+ * Defines the format of an ad.
  */
 export declare enum AdFormat {
     /**
      * Banner ad.
      */
-    BANNER,
+    BANNER = "BANNER",
     /**
      * MREC ad.
      */
-    MREC
+    MREC = "MREC"
 }
 /**
- * Defines a position of a banner or MREC ad.
+ * Defines the position for rendering a banner or MREC ad within its container.
  */
 export declare enum AdViewPosition {
-    TOP_CENTER,
-    TOP_LEFT,
-    TOP_RIGHT,
-    CENTERED,
-    CENTER_LEFT,
-    CENTER_RIGHT,
-    BOTTOM_LEFT,
-    BOTTOM_CENTER,
-    BOTTOM_RIGHT
+    TOP_CENTER = "top_center",
+    TOP_LEFT = "top_left",
+    TOP_RIGHT = "top_right",
+    CENTERED = "centered",
+    CENTER_LEFT = "center_left",
+    CENTER_RIGHT = "center_right",
+    BOTTOM_LEFT = "bottom_left",
+    BOTTOM_CENTER = "bottom_center",
+    BOTTOM_RIGHT = "bottom_right"
 }
 /**
- * The {@link AdView} component renders banner or MREC ads with responsive sizing.
- * - **Banners**: 320x50 on phones, 728x90 on tablets.
- * - **MRECs**: 300x250 on all devices.
+ * Renders a banner or MREC ad using a native view, with adaptive or responsive sizing.
  *
- * Use {@link AppLovinMAX.isTablet()} to determine device type for layout adjustments.
- * For adaptive banners, use {@link BannerAd.getAdaptiveHeightForWidth()} for precise sizing.
+ * - **Banners**: 320×50 on phones, 728×90 on tablets.
+ * - **MRECs**: Fixed size of 300×250 on all devices.
+ *
+ * Internally uses {@link AppLovinMAX.isTablet()} to determine banner size on tablets.
+ * You can also use this method externally to assist with layout decisions.
+ *
+ * For adaptive banners, use {@link BannerAd.getAdaptiveHeightForWidth()} to determine the appropriate height.
  *
  * **Preloading**:
- * When preloading an {@link AdView} using {@link preloadNativeUIComponentAdView},
- * the returned {@link AdViewId} must be passed to identify the preloaded instance.
+ * If you preload an ad for AdView using {@link preloadNativeUIComponentAdView},
+ * pass the returned {@link AdViewId} to this component to display the preloaded instance.
+ *
+ * **Note:** The AppLovin SDK must be initialized before using this component.
  *
  * ### Example:
- * ```js
+ * ```tsx
  * <AdView
  *   adUnitId={adUnitId}
  *   adFormat={AdFormat.BANNER}
  *   placement="my_placement"
  *   customData="my_customData"
- *   extraParameters={{"key1":"value1", "key2":"value2"}}
- *   localExtraParameters={{"key1":123", "key2":object}}
+ *   extraParameters={{ key1: "value1", key2: "value2" }}
+ *   localExtraParameters={{ key1: "value1", key2: true }}
  *   adaptiveBannerEnabled={false}
  *   autoRefresh={false}
  *   style={styles.banner}
  *   onAdLoaded={(adInfo: AdInfo) => { ... }}
  * />
  * ```
+ *
+ * For complete implementation examples, see:
+ * - https://github.com/AppLovin/AppLovin-MAX-React-Native/blob/master/example/src/NativeBannerExample.tsx
+ * - https://github.com/AppLovin/AppLovin-MAX-React-Native/blob/master/example/src/NativeMRecExample.tsx
  */
 export declare const AdView: React.ForwardRefExoticComponent<import("./types/AdProps").AdProps & {
     adFormat: AdFormat;
@@ -73,10 +82,10 @@ export declare const AdView: React.ForwardRefExoticComponent<import("./types/AdP
  * - Unmounting {@link AdView} does not destroy the preloaded component—it will be reused on the next mount.
  * - You must manually destroy the preloaded component when it is no longer needed using {@link destroyNativeUIComponentAdView}.
  *
- * @param adUnitId - The Ad Unit ID for which the ads should be preloaded.
+ * @param adUnitId - The Ad Unit ID for which ads should be preloaded.
  * @param adFormat - The ad format to preload. Must be either {@link AdFormat.BANNER} or {@link AdFormat.MREC}.
  * @param options - Optional properties to configure the native UI component (e.g., placement, custom data).
- * @returns A promise resolving to an {@link AdViewId}, which uniquely identifies the preloaded component.
+ * @returns A promise that resolves to an {@link AdViewId}, uniquely identifying the preloaded component instance.
  * @throws An error if the preload request fails.
  */
 export declare const preloadNativeUIComponentAdView: (adUnitId: string, adFormat: AdFormat, options?: NativeUIComponentAdViewOptions) => Promise<AdViewId>;
@@ -91,26 +100,23 @@ export declare const preloadNativeUIComponentAdView: (adUnitId: string, adFormat
  */
 export declare const destroyNativeUIComponentAdView: (adViewId: AdViewId) => Promise<void>;
 /**
- * Adds the specified event listener to receive {@link AdInfo} when a native UI component loads a
- * new ad.
+ * Adds the specified event listener to receive {@link AdInfo} when a native UI component loads a new ad.
  *
  * @param listener Listener to be notified.
  */
 export declare const addNativeUIComponentAdViewAdLoadedEventListener: (listener: (adInfo: AdInfo) => void) => void;
 /**
- * Removes the event listener to receive {@link AdInfo} when a native UI component loads a new ad.
+ * Removes the event listener registered to receive {@link AdInfo} when a native UI component loads a new ad.
  */
 export declare const removeNativeUIComponentAdViewAdLoadedEventListener: () => void;
 /**
- * Adds the specified event listener to receive {@link AdLoadFailedInfo} when a native UI component
- * could not load a new ad.
+ * Adds the specified event listener to receive {@link AdLoadFailedInfo} when a native UI component could not load a new ad.
  *
  * @param listener Listener to be notified.
  */
 export declare const addNativeUIComponentAdViewAdLoadFailedEventListener: (listener: (errorInfo: AdLoadFailedInfo) => void) => void;
 /**
- * Removes the event listener to receive {@link AdLoadFailedInfo} when a native UI component could
- * not load a new ad.
+ * Removes the event listener registered to receive {@link AdLoadFailedInfo} when a native UI component could not load a new ad.
  */
 export declare const removeNativeUIComponentAdViewAdLoadFailedEventListener: () => void;
 //# sourceMappingURL=AdView.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"AdView.d.ts","sourceRoot":"","sources":["../../../src/AdView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,SAAS,EAAuD,MAAM,cAAc,CAAC;AACnG,OAAO,KAAK,EAAuB,MAAM,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEpF,OAAO,KAAK,EAAe,aAAa,EAAE,8BAA8B,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAuBhH;;GAEG;AACH,oBAAY,QAAQ;IAChB;;OAEG;IACH,MAA+B;IAE/B;;OAEG;IACH,IAA2B;CAC9B;AAED;;GAEG;AACH,oBAAY,cAAc;IACtB,UAAgC;IAChC,QAA4B;IAC5B,SAA8B;IAC9B,QAA4B;IAC5B,WAAkC;IAClC,YAAoC;IACpC,WAAkC;IAClC,aAAsC;IACtC,YAAoC;CACvC;AAqDD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,MAAM;;;;;;;;mDA2KjB,CAAC;AAEH;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,8BAA8B,aAAoB,MAAM,YAAY,QAAQ,YAAY,8BAA8B,KAAG,OAAO,CAAC,QAAQ,CAErJ,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,8BAA8B,aAAoB,QAAQ,KAAG,OAAO,CAAC,IAAI,CAErF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,+CAA+C,aAAc,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,KAAG,IAEpG,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kDAAkD,QAAO,IAErE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mDAAmD,aAAc,CAAC,SAAS,EAAE,gBAAgB,KAAK,IAAI,KAAG,IAErH,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sDAAsD,QAAO,IAEzE,CAAC"}
+{"version":3,"file":"AdView.d.ts","sourceRoot":"","sources":["../../../src/AdView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAwB,SAAS,EAAwC,MAAM,cAAc,CAAC;AAK1G,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,KAAK,EAAe,aAAa,EAAE,8BAA8B,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAKhH;;GAEG;AACH,oBAAY,QAAQ;IAChB;;OAEG;IACH,MAAM,WAAW;IAEjB;;OAEG;IACH,IAAI,SAAS;CAChB;AAED;;GAEG;AACH,oBAAY,cAAc;IACtB,UAAU,eAAe;IACzB,QAAQ,aAAa;IACrB,SAAS,cAAc;IACvB,QAAQ,aAAa;IACrB,WAAW,gBAAgB;IAC3B,YAAY,iBAAiB;IAC7B,WAAW,gBAAgB;IAC3B,aAAa,kBAAkB;IAC/B,YAAY,iBAAiB;CAChC;AAsBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,eAAO,MAAM,MAAM;;;;;;;;mDA4HjB,CAAC;AAEH;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,8BAA8B,GAAU,UAAU,MAAM,EAAE,UAAU,QAAQ,EAAE,UAAS,8BAAmC,KAAG,OAAO,CAAC,QAAQ,CAGzJ,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,8BAA8B,GAAU,UAAU,QAAQ,KAAG,OAAO,CAAC,IAAI,CAKrF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,+CAA+C,GAAI,UAAU,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,KAAG,IAEpG,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kDAAkD,QAAO,IAErE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mDAAmD,GAAI,UAAU,CAAC,SAAS,EAAE,gBAAgB,KAAK,IAAI,KAAG,IAErH,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sDAAsD,QAAO,IAEzE,CAAC"}

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

@@ -1,73 +1,74 @@
 import type { AppLovinMAXType } from './types/AppLovinMAX';
 /**
- * This enum represents the user's geography used to determine the type of consent flow shown to the
- * user.
+ * Represents the user's geography, used to determine which type of consent flow to display.
  */
 export declare enum ConsentFlowUserGeography {
     /**
-     * User's geography is unknown.
+     * The user's geography could not be determined.
      */
     UNKNOWN = "U",
     /**
-     * The user is in GDPR region.
+     * The user is located in a GDPR region.
      */
     GDPR = "G",
     /**
-     * The user is in a non-GDPR region.
+     * The user is not in a GDPR region.
      */
     OTHER = "O"
 }
 /**
- * AppLovin SDK-defined app tracking transparency status values (extended to include "unavailable"
- * state on iOS before iOS14).
+ * App tracking transparency status values as defined by the AppLovin SDK.
+ *
+ * These values are based on Apple's AppTrackingTransparency framework (iOS 14+).
  */
 export declare enum AppTrackingStatus {
     /**
-     * Device is on iOS before iOS14, AppTrackingTransparency.framework is not available.
+     * Device is running an iOS version prior to iOS 14.
+     * AppTrackingTransparency is not available.
      */
     UNAVAILABLE = "U",
     /**
-     * The user has not yet received an authorization request to authorize access to app-related
-     * data that can be used for tracking the user or the device.
+     * The user has not yet responded to the tracking authorization prompt.
      */
     NOT_DETERMINED = "N",
     /**
-     * Authorization to access app-related data that can be used for tracking the user or the device
-     * is restricted.
+     * Tracking is restricted (e.g. due to parental controls).
      */
     RESTRICTED = "R",
     /**
-     * The user denies authorization to access app-related data that can be used for tracking the
-     * user or the device.
+     * The user denied authorization for tracking.
      */
     DENIED = "D",
     /**
-     * The user authorizes access to app-related data that can be used for tracking the user or the
-     * device.
+     * The user authorized tracking access.
      */
     AUTHORIZED = "A"
 }
 /**
- * Represents errors for CMP flow.
+ * Error codes returned from the Consent Management Platform (CMP) flow.
  */
 export declare enum CMPErrorCode {
     /**
-     * Indicates that an unspecified error has occurred.
+     * An unspecified error occurred.
      */
     UNSPECIFIED = -1,
     /**
-     * Indicates that the CMP has not been integrated correctly.
+     * The CMP was not integrated correctly.
      */
     INTEGRATION_ERROR = 1,
     /**
-     * Indicates that the CMP form is unavailable.
+     * The CMP form is unavailable.
      */
     FORM_UNAVAILABLE = 2,
     /**
-     * Indicates that the CMP form is not required.
+     * The CMP form is not required for this user.
      */
     FORM_NOT_REQUIRED = 3
 }
+/**
+ * Main AppLovin MAX module interface exposed to JavaScript.
+ * Wraps the native module and overrides `initialize()` and `getSegments()` for custom handling.
+ */
 export declare const AppLovinMAX: AppLovinMAXType;
 export default AppLovinMAX;
 //# sourceMappingURL=AppLovinMAX.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"AppLovinMAX.d.ts","sourceRoot":"","sources":["../../../src/AppLovinMAX.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAO3D;;;GAGG;AACH,oBAAY,wBAAwB;IAChC;;OAEG;IACH,OAAO,MAAM;IAEb;;OAEG;IACH,IAAI,MAAM;IAEV;;OAEG;IACH,KAAK,MAAM;CACd;AAED;;;GAGG;AACH,oBAAY,iBAAiB;IACzB;;OAEG;IACH,WAAW,MAAM;IAEjB;;;OAGG;IACH,cAAc,MAAM;IAEpB;;;OAGG;IACH,UAAU,MAAM;IAEhB;;;OAGG;IACH,MAAM,MAAM;IAEZ;;;OAGG;IACH,UAAU,MAAM;CACnB;AAED;;GAEG;AACH,oBAAY,YAAY;IACpB;;OAEG;IACH,WAAW,KAAK;IAEhB;;OAEG;IACH,iBAAiB,IAAI;IAErB;;OAEG;IACH,gBAAgB,IAAI;IAEpB;;OAEG;IACH,iBAAiB,IAAI;CACxB;AA8BD,eAAO,MAAM,WAAW,EAAE,eASxB,CAAC;AAEH,eAAe,WAAW,CAAC"}
+{"version":3,"file":"AppLovinMAX.d.ts","sourceRoot":"","sources":["../../../src/AppLovinMAX.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAM3D;;GAEG;AACH,oBAAY,wBAAwB;IAChC;;OAEG;IACH,OAAO,MAAM;IAEb;;OAEG;IACH,IAAI,MAAM;IAEV;;OAEG;IACH,KAAK,MAAM;CACd;AAED;;;;GAIG;AACH,oBAAY,iBAAiB;IACzB;;;OAGG;IACH,WAAW,MAAM;IAEjB;;OAEG;IACH,cAAc,MAAM;IAEpB;;OAEG;IACH,UAAU,MAAM;IAEhB;;OAEG;IACH,MAAM,MAAM;IAEZ;;OAEG;IACH,UAAU,MAAM;CACnB;AAED;;GAEG;AACH,oBAAY,YAAY;IACpB;;OAEG;IACH,WAAW,KAAK;IAEhB;;OAEG;IACH,iBAAiB,IAAI;IAErB;;OAEG;IACH,gBAAgB,IAAI;IAEpB;;OAEG;IACH,iBAAiB,IAAI;CACxB;AAwCD;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,eASxB,CAAC;AAEH,eAAe,WAAW,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"AppOpenAd.d.ts","sourceRoot":"","sources":["../../../src/AppOpenAd.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AA0FvD,eAAO,MAAM,SAAS,EAAE,aA4BvB,CAAC;AAEF,eAAe,SAAS,CAAC"}
+{"version":3,"file":"AppOpenAd.d.ts","sourceRoot":"","sources":["../../../src/AppOpenAd.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAyFvD,eAAO,MAAM,SAAS,EAAE,aA4BvB,CAAC;AAEF,eAAe,SAAS,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"BannerAd.d.ts","sourceRoot":"","sources":["../../../src/BannerAd.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA6HrD,eAAO,MAAM,QAAQ,EAAE,YA6CtB,CAAC;AAEF,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"BannerAd.d.ts","sourceRoot":"","sources":["../../../src/BannerAd.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA4HrD,eAAO,MAAM,QAAQ,EAAE,YA6CtB,CAAC;AAEF,eAAe,QAAQ,CAAC"}

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

@@ -1,72 +1,65 @@
 /**
- * This enum contains various error codes that the SDK can return when a MAX ad fails to load or
- * display.
+ * Error codes returned by the AppLovin MAX SDK when an ad fails to load or display.
  */
 export declare enum ErrorCode {
     /**
-     * This error code represents an error that could not be categorized into one of the other defined
-     * errors. See the message field in the error object for more details.
+     * An unspecified error occurred.
+     * See the `message` field for more details.
      */
     UNSPECIFIED,
     /**
-     * This error code indicates that MAX returned no eligible ads from any mediated networks for this
-     * app/device.
+     * No eligible ads were returned from any mediated networks.
      */
     NO_FILL,
     /**
-     * This error code indicates that MAX returned eligible ads from mediated networks, but all ads
-     * failed to load. See the adLoadFailureInfo field in the error object for more details.
+     * Eligible ads were returned but all failed to load.
+     * See `adLoadFailureInfo` for more details.
      */
     AD_LOAD_FAILED,
     /**
-     * This error code represents an error that was encountered when showing an ad.
+     * An error occurred while attempting to display the ad.
      */
     AD_DISPLAY_FAILED,
     /**
-     * This error code indicates that the ad request failed due to a generic network error. See the
-     * message field in the error object for more details.
+     * The ad request failed due to a general network issue.
+     * See the `message` field for details.
      */
     NETWORK_ERROR,
     /**
-     * This error code indicates that the ad request timed out due to a slow internet connection.
+     * The ad request timed out, likely due to a slow internet connection.
      */
     NETWORK_TIMEOUT,
     /**
-     * This error code indicates that the ad request failed because the device is not connected to the
-     * internet.
+     * The ad request failed because the device was offline.
      */
     NO_NETWORK,
     /**
-     * This error code indicates that you attempted to show a fullscreen ad while another fullscreen ad
-     * is still showing.
+     * A fullscreen ad was requested while another one was already showing.
      */
     FULLSCREEN_AD_ALREADY_SHOWING,
     /**
-     * This error code indicates you are attempting to show a fullscreen ad before the one has been
-     * loaded.
+     * A fullscreen ad was requested before it had finished loading.
      */
     FULLSCREEN_AD_NOT_READY,
     /**
-     * This error code indicates you attempted to present a fullscreen ad from an invalid view
-     * controller.
-     * **iOS ONLY**.
+     * The ad was presented from an invalid view controller.
+     * **iOS only**.
      */
     FULLSCREEN_AD_INVALID_VIEW_CONTROLLER,
     /**
-     * This error code indicates that the SDK failed to display an ad because the user has the
-     * "Don't Keep Activities" developer setting enabled.
-     * **Android ONLY**.
+     * The SDK was unable to display the ad because the
+     * "Don't Keep Activities" developer setting is enabled.
+     * **Android only**.
      */
     DONT_KEEP_ACTIVITIES_ENABLED,
     /**
-     * This error code indicates that the SDK failed to load an ad because the publisher provided an
-     * invalid ad unit identifier.
+     * The ad failed to load due to an invalid ad unit identifier.
      *
-     * Possible reasons for an invalid ad unit identifier:
-     * 1. Ad unit identifier is malformed or does not exist.
-     * 2. Ad unit is disabled.
-     * 3. Ad unit is not associated with the current app's package name.
-     * 4. Ad unit was created within the last 30-60 minutes.
+     * Possible causes:
+     * 1. The ad unit ID is malformed or does not exist.
+     * 2. The ad unit is disabled.
+     * 3. The ad unit is not linked to the current app’s package name.
+     * 4. The ad unit was recently created (less than ~30–60 minutes ago).
      */
     INVALID_AD_UNIT_ID
 }

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

@@ -1 +1 @@
-{"version":3,"file":"ErrorCode.d.ts","sourceRoot":"","sources":["../../../src/ErrorCode.ts"],"names":[],"mappings":"AAmBA;;;GAGG;AACH,oBAAY,SAAS;IACjB;;;OAGG;IACH,WAAwC;IAExC;;;OAGG;IACH,OAAgC;IAEhC;;;OAGG;IACH,cAA8C;IAE9C;;OAEG;IACH,iBAAoD;IAEpD;;;OAGG;IACH,aAA4C;IAE5C;;OAEG;IACH,eAAgD;IAEhD;;;OAGG;IACH,UAAsC;IAEtC;;;OAGG;IACH,6BAA4E;IAE5E;;;OAGG;IACH,uBAAgE;IAEhE;;;;OAIG;IACH,qCAA4F;IAE5F;;;;OAIG;IACH,4BAA0E;IAE1E;;;;;;;;;OASG;IACH,kBAAsD;CACzD"}
+{"version":3,"file":"ErrorCode.d.ts","sourceRoot":"","sources":["../../../src/ErrorCode.ts"],"names":[],"mappings":"AAiBA;;GAEG;AACH,oBAAY,SAAS;IACjB;;;OAGG;IACH,WAAwC;IAExC;;OAEG;IACH,OAAgC;IAEhC;;;OAGG;IACH,cAA8C;IAE9C;;OAEG;IACH,iBAAoD;IAEpD;;;OAGG;IACH,aAA4C;IAE5C;;OAEG;IACH,eAAgD;IAEhD;;OAEG;IACH,UAAsC;IAEtC;;OAEG;IACH,6BAA4E;IAE5E;;OAEG;IACH,uBAAgE;IAEhE;;;OAGG;IACH,qCAA4F;IAE5F;;;;OAIG;IACH,4BAA0E;IAE1E;;;;;;;;OAQG;IACH,kBAAsD;CACzD"}

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

@@ -1,4 +1,20 @@
+/**
+ * Manages AppLovin MAX ad event listeners using a shared NativeEventEmitter.
+ * Ensures only one active subscription per event type at any given time.
+ */
 import type { AdEventObject, AdEventListener } from './types/AdEvent';
+/**
+ * Subscribes to a specific ad event.
+ * If a listener already exists for the event, it will be replaced.
+ *
+ * @param event - The event name to listen for.
+ * @param handler - The callback to handle the event.
+ */
 export declare const addEventListener: <T extends AdEventObject>(event: string, handler: AdEventListener<T>) => void;
+/**
+ * Unsubscribes from a specific ad event, if a listener exists.
+ *
+ * @param event - The event name to unsubscribe from.
+ */
 export declare const removeEventListener: (event: string) => void;
 //# sourceMappingURL=EventEmitter.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"EventEmitter.d.ts","sourceRoot":"","sources":["../../../src/EventEmitter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAStE,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,aAAa,SAAS,MAAM,WAAW,eAAe,CAAC,CAAC,CAAC,KAAG,IAOtG,CAAC;AAEF,eAAO,MAAM,mBAAmB,UAAW,MAAM,KAAG,IAMnD,CAAC"}
+{"version":3,"file":"EventEmitter.d.ts","sourceRoot":"","sources":["../../../src/EventEmitter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAStE;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,aAAa,EAAE,OAAO,MAAM,EAAE,SAAS,eAAe,CAAC,CAAC,CAAC,KAAG,IAOtG,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,OAAO,MAAM,KAAG,IAMnD,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"InterstitialAd.d.ts","sourceRoot":"","sources":["../../../src/InterstitialAd.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AA0FjE,eAAO,MAAM,cAAc,EAAE,kBA4B5B,CAAC;AAEF,eAAe,cAAc,CAAC"}
+{"version":3,"file":"InterstitialAd.d.ts","sourceRoot":"","sources":["../../../src/InterstitialAd.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAyFjE,eAAO,MAAM,cAAc,EAAE,kBA4B5B,CAAC;AAEF,eAAe,cAAc,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"MRecAd.d.ts","sourceRoot":"","sources":["../../../src/MRecAd.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAoGjD,eAAO,MAAM,MAAM,EAAE,UAmCpB,CAAC;AAEF,eAAe,MAAM,CAAC"}
+{"version":3,"file":"MRecAd.d.ts","sourceRoot":"","sources":["../../../src/MRecAd.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAmGjD,eAAO,MAAM,MAAM,EAAE,UAmCpB,CAAC;AAEF,eAAe,MAAM,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"Privacy.d.ts","sourceRoot":"","sources":["../../../src/Privacy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAInD,eAAO,MAAM,OAAO,EAAE,WAAyB,CAAC"}
+{"version":3,"file":"Privacy.d.ts","sourceRoot":"","sources":["../../../src/Privacy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGnD,eAAO,MAAM,OAAO,EAAE,WAAyB,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"RewardedAd.d.ts","sourceRoot":"","sources":["../../../src/RewardedAd.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAqGzD,eAAO,MAAM,UAAU,EAAE,cAiCxB,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"RewardedAd.d.ts","sourceRoot":"","sources":["../../../src/RewardedAd.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAoGzD,eAAO,MAAM,UAAU,EAAE,cAiCxB,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

@@ -0,0 +1,31 @@
+import type { LocalExtraParameterValue } from './types/AdProps';
+/**
+ * Converts a record of string-based extra parameters into an array of `{ key, value }` objects.
+ * Used for sending extra parameters to the native SDK.
+ *
+ * @param input - An optional map of key-value string pairs (or null values).
+ * @returns An array of `{ key, value }` objects. Returns an empty array if input is undefined.
+ */
+export declare const makeExtraParametersArray: (input?: Record<string, string | null>) => {
+    key: string;
+    value: string | null;
+}[];
+type LocalExtraParameterType = 'str' | 'bool';
+type LocalExtraParameterValueMap = {
+    str: string | null;
+    bool: boolean | null;
+};
+/**
+ * Converts a map of local extra parameters into a filtered array of `{ key, value }` pairs.
+ * Only values matching the specified type (`'str'` or `'bool'`) are included.
+ *
+ * @param input - A record of local extra parameters (string, boolean, or null).
+ * @param type - The expected type of each value: `'str'` for strings, `'bool'` for booleans.
+ * @returns A filtered array of `{ key, value }` objects, cast to the specified type.
+ */
+export declare const makeLocalExtraParametersArray: <T extends LocalExtraParameterType>(input: Record<string, LocalExtraParameterValue> | undefined, type: T) => {
+    key: string;
+    value: LocalExtraParameterValueMap[T];
+}[];
+export {};
+//# sourceMappingURL=Utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Utils.d.ts","sourceRoot":"","sources":["../../../src/Utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAEhE;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,GAAI,QAAQ,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,KAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAIrH,CAAC;AAEF,KAAK,uBAAuB,GAAG,KAAK,GAAG,MAAM,CAAC;AAE9C,KAAK,2BAA2B,GAAG;IAC/B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;CACxB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,6BAA6B,GAAI,CAAC,SAAS,uBAAuB,EAC3E,OAAO,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,GAAG,SAAS,EAC3D,MAAM,CAAC,KACR;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,2BAA2B,CAAC,CAAC,CAAC,CAAA;CAAE,EAWxD,CAAC"}

package/lib/typescript/src/nativeAd/NativeAdView.d.ts

@@ -1,9 +1,12 @@
+/**
+ * Provides the NativeAdView component, which manages loading and rendering of native ads using the
+ * AppLovin MAX SDK in React Native.
+ */
 import * as React from 'react';
 import type { ViewProps } from 'react-native';
 import type { NativeAdViewHandler } from '../types/NativeAdViewProps';
 /**
- * The {@link NativeAdView} component that you use building a native ad. This loads a native ad and
- * renders it with the asset views:
+ * The {@link NativeAdView} component renders a native ad and binds it to asset views:
  *
  * - {@link IconView}
  * - {@link TitleView}
@@ -13,19 +16,21 @@ import type { NativeAdViewHandler } from '../types/NativeAdViewProps';
  * - {@link MediaView}
  * - {@link CallToActionView}
  *
- * {@link NativeAdView} fills each asset view with the data of a native ad as soon as it loads the native
- * ad, but you need to provide the layout and style of the asset views.
- * {@link NativeAdView} can reload a new native ad by using the ref handler.
+ * Each asset view must be manually laid out and styled.
+ * The component automatically populates content once an ad is loaded.
+ * You can reload the ad using the component’s ref via `loadAd()`.
+ *
+ * **Note:** The AppLovin SDK must be initialized before using this component.
  *
  * ### Example:
- * ```js
+ * ```tsx
  * <NativeAdView
  *   ref={nativeAdViewHandler}
  *   adUnitId={adUnitId}
  *   style={styles.nativead}
  *   onAdLoaded={(adInfo: AdInfo) => { ... }}
  * >
- *   <View style={ ... }>
+ *   <View style={...}>
  *     <IconView style={styles.icon} />
  *     <TitleView style={styles.title} />
  *     <AdvertiserView style={styles.advertiser} />
@@ -37,6 +42,9 @@ import type { NativeAdViewHandler } from '../types/NativeAdViewProps';
  *   </View>
  * </NativeAdView>
  * ```
+ *
+ * For a complete implementation example, see:
+ * https://github.com/AppLovin/AppLovin-MAX-React-Native/blob/master/example/src/NativeAdViewExample.tsx
  */
 export declare const NativeAdView: React.ForwardRefExoticComponent<import("../types/AdProps").AdProps & ViewProps & React.RefAttributes<NativeAdViewHandler>>;
 //# sourceMappingURL=NativeAdView.d.ts.map

package/lib/typescript/src/nativeAd/NativeAdView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NativeAdView.d.ts","sourceRoot":"","sources":["../../../../src/nativeAd/NativeAdView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAK9C,OAAO,KAAK,EAAE,mBAAmB,EAAqB,MAAM,4BAA4B,CAAC;AAczF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,eAAO,MAAM,YAAY,4HAyBvB,CAAC"}
+{"version":3,"file":"NativeAdView.d.ts","sourceRoot":"","sources":["../../../../src/nativeAd/NativeAdView.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAwB,SAAS,EAAE,MAAM,cAAc,CAAC;AAMpE,OAAO,KAAK,EAAE,mBAAmB,EAAqB,MAAM,4BAA4B,CAAC;AAGzF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,eAAO,MAAM,YAAY,4HAuBvB,CAAC"}

package/lib/typescript/src/nativeAd/NativeAdViewComponents.d.ts

@@ -1,11 +1,75 @@
+/**
+ * Provides pre-styled React Native components for each native ad asset view:
+ *
+ * - TitleView
+ * - AdvertiserView
+ * - BodyView
+ * - CallToActionView
+ * - IconView
+ * - OptionsView
+ * - MediaView
+ * - StarRatingView
+ *
+ * Each component pulls ad content and view refs from NativeAdView context,
+ * and must be rendered inside a {@link NativeAdView}.
+ */
 import * as React from 'react';
 import type { ViewProps, ImageProps, TextProps } from 'react-native';
+/**
+ * Renders the native ad’s title.
+ */
 export declare const TitleView: (props: TextProps) => React.JSX.Element;
+/**
+ * Renders the advertiser name.
+ */
 export declare const AdvertiserView: (props: TextProps) => React.JSX.Element;
+/**
+ * Renders the ad’s body text (description).
+ */
 export declare const BodyView: (props: TextProps) => React.JSX.Element;
+/**
+ * Renders the call-to-action label.
+ * On iOS, wraps the text with a TouchableOpacity for better click behavior.
+ */
 export declare const CallToActionView: (props: TextProps) => React.JSX.Element;
+/**
+ * Renders the icon image for the native ad.
+ * Falls back to a blank placeholder if not available.
+ */
 export declare const IconView: (props: Omit<ImageProps, "source">) => React.JSX.Element;
+/**
+ * Renders the native ad’s options view.
+ */
 export declare const OptionsView: (props: ViewProps) => React.JSX.Element;
+/**
+ * Renders the native ad’s media content.
+ */
 export declare const MediaView: (props: ViewProps) => React.JSX.Element;
-export declare const StarRatingView: (props: ViewProps) => React.JSX.Element;
+/**
+ * Props for the {@link StarRatingView} component, which displays a star rating
+ * using Unicode stars (★ and ☆) styled with color, shadow, and size.
+ */
+type StarRatingViewProps = ViewProps & {
+    /**
+     * The color used for filled (active) stars.
+     * Defaults to gold (#ffe234).
+     */
+    color?: string;
+    /**
+     * The color used for empty (inactive) stars.
+     * Defaults to light gray (#dedede).
+     */
+    shadowColor?: string;
+    /**
+     * The size of each star, which also determines their visual size.
+     * Defaults to 10.
+     */
+    size?: number;
+};
+/**
+ * Renders the star rating of the ad, using Unicode stars (★ and ☆).
+ * Filled stars are rendered over hollow stars using a clipped view.
+ */
+export declare const StarRatingView: ({ color, shadowColor, size, style }: StarRatingViewProps) => React.JSX.Element;
+export {};
 //# sourceMappingURL=NativeAdViewComponents.d.ts.map

package/lib/typescript/src/nativeAd/NativeAdViewComponents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NativeAdViewComponents.d.ts","sourceRoot":"","sources":["../../../../src/nativeAd/NativeAdViewComponents.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAwB,SAAS,EAAE,MAAM,cAAc,CAAC;AAsB3F,eAAO,MAAM,SAAS,UAAW,SAAS,sBASzC,CAAC;AAEF,eAAO,MAAM,cAAc,UAAW,SAAS,sBAS9C,CAAC;AAEF,eAAO,MAAM,QAAQ,UAAW,SAAS,sBASxC,CAAC;AAEF,eAAO,MAAM,gBAAgB,UAAW,SAAS,sBAoBhD,CAAC;AAEF,eAAO,MAAM,QAAQ,UAAW,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,sBAWzD,CAAC;AAEF,eAAO,MAAM,WAAW,UAAW,SAAS,sBAK3C,CAAC;AAEF,eAAO,MAAM,SAAS,UAAW,SAAS,sBAKzC,CAAC;AAEF,eAAO,MAAM,cAAc,UAAW,SAAS,sBAwC9C,CAAC"}
+{"version":3,"file":"NativeAdViewComponents.d.ts","sourceRoot":"","sources":["../../../../src/nativeAd/NativeAdViewComponents.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGrE;;GAEG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,SAAS,sBAOzC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,SAAS,sBAO9C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,SAAS,sBAOxC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,SAAS,sBAkBhD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,sBAezD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,SAAS,sBAG3C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,SAAS,sBAGzC,CAAC;AAEF;;;GAGG;AACH,KAAK,mBAAmB,GAAG,SAAS,GAAG;IACnC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,qCAAkE,mBAAmB,sBA+BnH,CAAC"}