@capgo/capacitor-admob 8.1.21 → 8.2.1

package/dist/esm/definitions.d.ts

@@ -1,4 +1,5 @@
 import type { PluginListenerHandle } from '@capacitor/core';
+import type { AdMobPlusEventName, AdMobPlusEventPayloadMap } from './events';
 /**
  * Maximum ad content rating enum used to restrict ads based on content rating.
  *
@@ -44,6 +45,93 @@ export type RequestConfig = {
     /** Array of test device IDs */
     testDeviceIds?: string[];
 };
+/**
+ * Consent status from Google's User Messaging Platform (UMP).
+ *
+ * @see https://developers.google.com/admob/ump/android/reference/com/google/android/ump/ConsentInformation.ConsentStatus
+ * @since 8.2.0
+ */
+export declare enum AdmobConsentStatus {
+    /** User consent not required. */
+    NOT_REQUIRED = "NOT_REQUIRED",
+    /** User consent already obtained. */
+    OBTAINED = "OBTAINED",
+    /** User consent required but not yet obtained. */
+    REQUIRED = "REQUIRED",
+    /** Unknown consent status. Call requestConsentInfo() to update it. */
+    UNKNOWN = "UNKNOWN"
+}
+/**
+ * Privacy options requirement status from UMP.
+ *
+ * @see https://developers.google.com/admob/ump/android/reference/com/google/android/ump/ConsentInformation.PrivacyOptionsRequirementStatus
+ * @since 8.2.0
+ */
+export declare enum PrivacyOptionsRequirementStatus {
+    /** Privacy options entry point is not required. */
+    NOT_REQUIRED = "NOT_REQUIRED",
+    /** Privacy options entry point is required. */
+    REQUIRED = "REQUIRED",
+    /** Privacy options requirement status is unknown. */
+    UNKNOWN = "UNKNOWN"
+}
+/**
+ * Debug geography for testing UMP consent flows locally.
+ *
+ * @see https://developers.google.com/admob/ump/android/reference/com/google/android/ump/ConsentDebugSettings.DebugGeography
+ * @since 8.2.0
+ */
+export declare enum AdmobConsentDebugGeography {
+    /** Debug geography disabled. */
+    DISABLED = 0,
+    /** Geography appears as in EEA for debug devices. */
+    EEA = 1,
+    /**
+     * Geography appears as not in EEA for debug devices.
+     *
+     * @deprecated Use OTHER instead.
+     */
+    NOT_EEA = 2,
+    /** Geography appears as in a regulated US state for debug devices. */
+    US = 3,
+    /** Geography appears as OTHER for debug devices. */
+    OTHER = 4
+}
+/**
+ * Options for requesting UMP consent information.
+ *
+ * @since 8.2.0
+ */
+export type AdmobConsentRequestOptions = {
+    /** Sets the debug geography to test consent locally. */
+    debugGeography?: AdmobConsentDebugGeography;
+    /**
+     * Test device IDs to allow for consent debugging.
+     * On iOS, the ID may change if you uninstall and reinstall the app.
+     */
+    testDeviceIdentifiers?: string[];
+    /**
+     * When true, tags the user as under the age of consent for UMP requests.
+     *
+     * @default false
+     */
+    tagForUnderAgeOfConsent?: boolean;
+};
+/**
+ * Consent information returned by UMP.
+ *
+ * @since 8.2.0
+ */
+export type AdmobConsentInfo = {
+    /** The consent status of the user. */
+    status: AdmobConsentStatus;
+    /** If true, a consent form is available. */
+    isConsentFormAvailable?: boolean;
+    /** If true, an ad request can be made. */
+    canRequestAds: boolean;
+    /** Privacy options requirement status of the user. */
+    privacyOptionsRequirementStatus: PrivacyOptionsRequirementStatus;
+};
 /**
  * Tracking authorization status for iOS App Tracking Transparency.
  *
@@ -101,6 +189,89 @@ export type RewardedInterstitialAdOptions = MobileAdOptions & {
     /** Server-side verification options sent with rewarded callbacks. */
     serverSideVerification?: ServerSideVerificationOptions;
 };
+/**
+ * In-feed ad format. Both use a native overlay aligned to an HTML placeholder.
+ *
+ * @since 8.3.0
+ */
+export type FeedAdFormat = 'native' | 'banner';
+/**
+ * Optional colors for the built-in native ad template (hex strings, e.g. `#ffffff`).
+ *
+ * @since 8.3.0
+ */
+export type FeedNativeAdStyle = {
+    backgroundColor?: string;
+    headlineTextColor?: string;
+    bodyTextColor?: string;
+    ctaBackgroundColor?: string;
+    ctaTextColor?: string;
+};
+/**
+ * Options for creating an in-feed ad instance.
+ *
+ * Policy: AdMob counts native impressions and clicks only when assets render inside
+ * {@link https://developers.google.com/admob/android/native/advanced | NativeAdView} /
+ * GADNativeAdView with the AdChoices icon and an ad attribution badge. This plugin
+ * overlays a compliant native view on your placeholder. Optional {@link FeedNativeAdAssets}
+ * are returned on `feed.load` for layout sizing only, not for manual click forwarding.
+ *
+ * @since 8.3.0
+ */
+export type FeedAdCreateOptions = {
+    /** Native advanced or inline banner. */
+    format: FeedAdFormat;
+    /** AdMob ad unit ID. */
+    adUnitId: string;
+    /** Optional key echoed on feed events for your feed slot. */
+    positionKey?: string;
+    /**
+     * Auto-refresh interval in milliseconds. AdMob requires at least 30 seconds.
+     * Omit or pass `null` to disable auto-refresh.
+     */
+    autoRefreshMs?: number | null;
+    /** Template colors when `format` is `native`. */
+    nativeStyle?: FeedNativeAdStyle;
+};
+/**
+ * Normalized native ad assets for placeholder sizing. Clicks and impressions stay on the native view.
+ *
+ * @since 8.3.0
+ */
+export type FeedNativeAdAssets = {
+    headline?: string;
+    body?: string;
+    callToAction?: string;
+    advertiser?: string;
+    price?: string;
+    store?: string;
+    starRating?: number;
+    mediaAspectRatio?: number;
+};
+/**
+ * Banner size hints returned when a feed banner loads.
+ *
+ * @since 8.3.0
+ */
+export type FeedBannerAdAssets = {
+    width: number;
+    height: number;
+};
+/**
+ * Bounds of the HTML placeholder, in CSS pixels relative to the WebView viewport.
+ *
+ * @since 8.3.0
+ */
+export type FeedAdBounds = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    /** When false, the native overlay is hidden (e.g. off-screen while scrolling). */
+    visible: boolean;
+    /** `window.devicePixelRatio` from the WebView. Defaults to 1 on web. */
+    density?: number;
+};
 /**
  * AdMob Plus Plugin interface for displaying Google AdMob ads in Capacitor apps.
  *
@@ -152,6 +323,53 @@ export interface AdMobPlusPlugin {
      * ```
      */
     configRequest(requestConfig: RequestConfig): Promise<void>;
+    /**
+     * Request user consent information from Google's User Messaging Platform (UMP).
+     *
+     * Call this after `start()` and before loading ads for users in the EEA/UK.
+     *
+     * @param options - Optional consent request options for debugging and tagging
+     * @returns Promise that resolves with the current consent information
+     * @throws Error if the consent info request fails
+     * @since 8.2.0
+     * @example
+     * ```typescript
+     * const consentInfo = await AdMob.requestConsentInfo();
+     * if (consentInfo.isConsentFormAvailable && consentInfo.status === AdmobConsentStatus.REQUIRED) {
+     *   await AdMob.showConsentForm();
+     * }
+     * ```
+     */
+    requestConsentInfo(options?: AdmobConsentRequestOptions): Promise<AdmobConsentInfo>;
+    /**
+     * Shows the Google user consent form rendered from your GDPR message configuration.
+     *
+     * @returns Promise that resolves with updated consent information after the form is dismissed
+     * @throws Error if the consent form cannot be shown
+     * @since 8.2.0
+     * @example
+     * ```typescript
+     * const consentInfo = await AdMob.showConsentForm();
+     * if (!consentInfo.canRequestAds) {
+     *   return;
+     * }
+     * ```
+     */
+    showConsentForm(): Promise<AdmobConsentInfo>;
+    /**
+     * Shows the Google privacy options form rendered from your GDPR message configuration.
+     *
+     * Use this when your privacy message requires an in-app entry point for users to manage choices.
+     *
+     * @returns Promise that resolves when the form is dismissed
+     * @throws Error if the privacy options form cannot be shown
+     * @since 8.2.0
+     * @example
+     * ```typescript
+     * await AdMob.showPrivacyOptionsForm();
+     * ```
+     */
+    showPrivacyOptionsForm(): Promise<void>;
     /**
      * Create a new ad instance.
      *
@@ -230,6 +448,71 @@ export interface AdMobPlusPlugin {
     adHide(opts: {
         id: number;
     }): Promise<void>;
+    /**
+     * Create an in-feed ad slot (native overlay or inline banner overlay).
+     *
+     * @param opts - Feed ad configuration
+     * @returns Promise that resolves with the feed ad instance id
+     * @since 8.3.0
+     * @example
+     * ```typescript
+     * const { id } = await AdMob.feedAdCreate({
+     *   format: 'native',
+     *   adUnitId: 'ca-app-pub-3940256099942544/2247696110',
+     *   positionKey: 'feed-3',
+     *   autoRefreshMs: 60000,
+     * });
+     * ```
+     */
+    feedAdCreate(opts: FeedAdCreateOptions): Promise<{
+        id: number;
+    }>;
+    /**
+     * Destroy a feed ad instance and remove its native overlay.
+     *
+     * @param opts - Object containing the feed ad id
+     * @since 8.3.0
+     */
+    feedAdDestroy(opts: {
+        id: number;
+    }): Promise<void>;
+    /**
+     * Load or reload the feed ad. Listen for `feed.load` / `feed.loadfail` events.
+     *
+     * @param opts - Object containing the feed ad id
+     * @since 8.3.0
+     */
+    feedAdLoad(opts: {
+        id: number;
+    }): Promise<void>;
+    /**
+     * Whether the feed ad has finished loading.
+     *
+     * @param opts - Object containing the feed ad id
+     * @since 8.3.0
+     */
+    feedAdIsLoaded(opts: {
+        id: number;
+    }): Promise<boolean>;
+    /**
+     * Position the native overlay over an HTML placeholder. Call on scroll, resize, and orientation changes.
+     *
+     * @param opts - Feed ad id and bounds from `element.getBoundingClientRect()`
+     * @since 8.3.0
+     */
+    feedAdUpdateBounds(opts: FeedAdBounds & {
+        id: number;
+    }): Promise<void>;
+    /**
+     * Enable or disable auto-refresh (minimum 30 seconds).
+     *
+     * @param opts - Feed ad id and interval in ms, or `null` to disable
+     * @since 8.3.0
+     */
+    feedAdSetAutoRefresh(opts: {
+        id: number;
+        autoRefreshMs: number | null;
+    }): Promise<void>;
     /**
      * Get the current tracking authorization status (iOS only).
      *
@@ -279,7 +562,7 @@ export interface AdMobPlusPlugin {
      * await listener.remove();
      * ```
      */
-    addListener(eventName: string, listenerFunc: (event: any) => void): Promise<PluginListenerHandle> & PluginListenerHandle;
+    addListener<E extends AdMobPlusEventName>(eventName: E, listenerFunc: (event: AdMobPlusEventPayloadMap[E]) => void): Promise<PluginListenerHandle> & PluginListenerHandle;
     /**
      * Get the native Capacitor plugin version.
      *

package/dist/esm/definitions.js

@@ -16,6 +16,61 @@ export var MaxAdContentRating;
     /** Unspecified rating */
     MaxAdContentRating["UNSPECIFIED"] = "";
 })(MaxAdContentRating || (MaxAdContentRating = {}));
+/**
+ * Consent status from Google's User Messaging Platform (UMP).
+ *
+ * @see https://developers.google.com/admob/ump/android/reference/com/google/android/ump/ConsentInformation.ConsentStatus
+ * @since 8.2.0
+ */
+export var AdmobConsentStatus;
+(function (AdmobConsentStatus) {
+    /** User consent not required. */
+    AdmobConsentStatus["NOT_REQUIRED"] = "NOT_REQUIRED";
+    /** User consent already obtained. */
+    AdmobConsentStatus["OBTAINED"] = "OBTAINED";
+    /** User consent required but not yet obtained. */
+    AdmobConsentStatus["REQUIRED"] = "REQUIRED";
+    /** Unknown consent status. Call requestConsentInfo() to update it. */
+    AdmobConsentStatus["UNKNOWN"] = "UNKNOWN";
+})(AdmobConsentStatus || (AdmobConsentStatus = {}));
+/**
+ * Privacy options requirement status from UMP.
+ *
+ * @see https://developers.google.com/admob/ump/android/reference/com/google/android/ump/ConsentInformation.PrivacyOptionsRequirementStatus
+ * @since 8.2.0
+ */
+export var PrivacyOptionsRequirementStatus;
+(function (PrivacyOptionsRequirementStatus) {
+    /** Privacy options entry point is not required. */
+    PrivacyOptionsRequirementStatus["NOT_REQUIRED"] = "NOT_REQUIRED";
+    /** Privacy options entry point is required. */
+    PrivacyOptionsRequirementStatus["REQUIRED"] = "REQUIRED";
+    /** Privacy options requirement status is unknown. */
+    PrivacyOptionsRequirementStatus["UNKNOWN"] = "UNKNOWN";
+})(PrivacyOptionsRequirementStatus || (PrivacyOptionsRequirementStatus = {}));
+/**
+ * Debug geography for testing UMP consent flows locally.
+ *
+ * @see https://developers.google.com/admob/ump/android/reference/com/google/android/ump/ConsentDebugSettings.DebugGeography
+ * @since 8.2.0
+ */
+export var AdmobConsentDebugGeography;
+(function (AdmobConsentDebugGeography) {
+    /** Debug geography disabled. */
+    AdmobConsentDebugGeography[AdmobConsentDebugGeography["DISABLED"] = 0] = "DISABLED";
+    /** Geography appears as in EEA for debug devices. */
+    AdmobConsentDebugGeography[AdmobConsentDebugGeography["EEA"] = 1] = "EEA";
+    /**
+     * Geography appears as not in EEA for debug devices.
+     *
+     * @deprecated Use OTHER instead.
+     */
+    AdmobConsentDebugGeography[AdmobConsentDebugGeography["NOT_EEA"] = 2] = "NOT_EEA";
+    /** Geography appears as in a regulated US state for debug devices. */
+    AdmobConsentDebugGeography[AdmobConsentDebugGeography["US"] = 3] = "US";
+    /** Geography appears as OTHER for debug devices. */
+    AdmobConsentDebugGeography[AdmobConsentDebugGeography["OTHER"] = 4] = "OTHER";
+})(AdmobConsentDebugGeography || (AdmobConsentDebugGeography = {}));
 /**
  * Tracking authorization status for iOS App Tracking Transparency.
  *

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAN,IAAY,kBAWX;AAXD,WAAY,kBAAkB;IAC5B,wBAAwB;IACxB,6BAAO,CAAA;IACP,uBAAuB;IACvB,+BAAS,CAAA;IACT,wBAAwB;IACxB,+BAAS,CAAA;IACT,WAAW;IACX,6BAAO,CAAA;IACP,yBAAyB;IACzB,sCAAgB,CAAA;AAClB,CAAC,EAXW,kBAAkB,KAAlB,kBAAkB,QAW7B;AAgCD;;;;GAIG;AACH,MAAM,CAAN,IAAY,2BASX;AATD,WAAY,2BAA2B;IACrC,yDAAyD;IACzD,+FAAiB,CAAA;IACjB,iEAAiE;IACjE,yFAAc,CAAA;IACd,gCAAgC;IAChC,iFAAU,CAAA;IACV,6BAA6B;IAC7B,yFAAc,CAAA;AAChB,CAAC,EATW,2BAA2B,KAA3B,2BAA2B,QAStC"}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,MAAM,CAAN,IAAY,kBAWX;AAXD,WAAY,kBAAkB;IAC5B,wBAAwB;IACxB,6BAAO,CAAA;IACP,uBAAuB;IACvB,+BAAS,CAAA;IACT,wBAAwB;IACxB,+BAAS,CAAA;IACT,WAAW;IACX,6BAAO,CAAA;IACP,yBAAyB;IACzB,sCAAgB,CAAA;AAClB,CAAC,EAXW,kBAAkB,KAAlB,kBAAkB,QAW7B;AAgCD;;;;;GAKG;AACH,MAAM,CAAN,IAAY,kBASX;AATD,WAAY,kBAAkB;IAC5B,iCAAiC;IACjC,mDAA6B,CAAA;IAC7B,qCAAqC;IACrC,2CAAqB,CAAA;IACrB,kDAAkD;IAClD,2CAAqB,CAAA;IACrB,sEAAsE;IACtE,yCAAmB,CAAA;AACrB,CAAC,EATW,kBAAkB,KAAlB,kBAAkB,QAS7B;AAED;;;;;GAKG;AACH,MAAM,CAAN,IAAY,+BAOX;AAPD,WAAY,+BAA+B;IACzC,mDAAmD;IACnD,gEAA6B,CAAA;IAC7B,+CAA+C;IAC/C,wDAAqB,CAAA;IACrB,qDAAqD;IACrD,sDAAmB,CAAA;AACrB,CAAC,EAPW,+BAA+B,KAA/B,+BAA+B,QAO1C;AAED;;;;;GAKG;AACH,MAAM,CAAN,IAAY,0BAeX;AAfD,WAAY,0BAA0B;IACpC,gCAAgC;IAChC,mFAAY,CAAA;IACZ,qDAAqD;IACrD,yEAAO,CAAA;IACP;;;;OAIG;IACH,iFAAW,CAAA;IACX,sEAAsE;IACtE,uEAAM,CAAA;IACN,oDAAoD;IACpD,6EAAS,CAAA;AACX,CAAC,EAfW,0BAA0B,KAA1B,0BAA0B,QAerC;AAuCD;;;;GAIG;AACH,MAAM,CAAN,IAAY,2BASX;AATD,WAAY,2BAA2B;IACrC,yDAAyD;IACzD,+FAAiB,CAAA;IACjB,iEAAiE;IACjE,yFAAc,CAAA;IACd,gCAAgC;IAChC,iFAAU,CAAA;IACV,6BAA6B;IAC7B,yFAAc,CAAA;AAChB,CAAC,EATW,2BAA2B,KAA3B,2BAA2B,QAStC"}

package/dist/esm/events.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Typed event name constants for {@link AdMobPlusPlugin.addListener}.
+ *
+ * @since 8.2.0
+ */
+export declare const AdMobPlusEvents: {
+    readonly AdClick: "ad.click";
+    readonly AdDismiss: "ad.dismiss";
+    readonly AdImpression: "ad.impression";
+    readonly AdLoad: "ad.load";
+    readonly AdLoadFail: "ad.loadfail";
+    readonly AdReward: "ad.reward";
+    readonly AdShow: "ad.show";
+    readonly AdShowFail: "ad.showfail";
+    readonly BannerClick: "banner.click";
+    readonly BannerClose: "banner.close";
+    readonly BannerImpression: "banner.impression";
+    readonly BannerLoad: "banner.load";
+    readonly BannerLoadFail: "banner.loadfail";
+    readonly BannerOpen: "banner.open";
+    readonly BannerSizeChange: "banner.sizechange";
+    readonly InterstitialDismiss: "interstitial.dismiss";
+    readonly InterstitialImpression: "interstitial.impression";
+    readonly InterstitialLoad: "interstitial.load";
+    readonly InterstitialLoadFail: "interstitial.loadfail";
+    readonly InterstitialShow: "interstitial.show";
+    readonly InterstitialShowFail: "interstitial.showfail";
+    readonly RewardedDismiss: "rewarded.dismiss";
+    readonly RewardedImpression: "rewarded.impression";
+    readonly RewardedInterstitialDismiss: "rewardedi.dismiss";
+    readonly RewardedInterstitialImpression: "rewardedi.impression";
+    readonly RewardedInterstitialLoad: "rewardedi.load";
+    readonly RewardedInterstitialLoadFail: "rewardedi.loadfail";
+    readonly RewardedInterstitialReward: "rewardedi.reward";
+    readonly RewardedInterstitialShow: "rewardedi.show";
+    readonly RewardedInterstitialShowFail: "rewardedi.showfail";
+    readonly RewardedLoad: "rewarded.load";
+    readonly RewardedLoadFail: "rewarded.loadfail";
+    readonly RewardedReward: "rewarded.reward";
+    readonly RewardedShow: "rewarded.show";
+    readonly RewardedShowFail: "rewarded.showfail";
+    readonly FeedClick: "feed.click";
+    readonly FeedClose: "feed.close";
+    readonly FeedImpression: "feed.impression";
+    readonly FeedLoad: "feed.load";
+    readonly FeedLoadFail: "feed.loadfail";
+    readonly FeedOpen: "feed.open";
+    readonly FeedRefresh: "feed.refresh";
+};
+export type AdMobPlusEventName = (typeof AdMobPlusEvents)[keyof typeof AdMobPlusEvents];
+/** Event payload always includes the native ad instance id (`adId`). iOS also emits legacy `id`. */
+export type AdMobPlusAdIdPayload = {
+    adId: number;
+    id?: number;
+};
+/** In-feed ad events use `feedAdId` (same numeric id as `feedAdCreate`). */
+export type AdMobPlusFeedAdIdPayload = {
+    feedAdId: number;
+    positionKey?: string;
+    format?: 'native' | 'banner';
+};
+export type AdMobPlusFeedLoadPayload = AdMobPlusFeedAdIdPayload & {
+    assets?: Record<string, unknown>;
+};
+/** Load and fullscreen show failure payloads from native `LoadAdError` / `FullScreenContentError`. */
+export type AdMobPlusAdFailurePayload = AdMobPlusAdIdPayload & {
+    code: number;
+    message: string;
+    /** Legacy iOS failure field; same string as `message` when present. */
+    error?: string;
+};
+/** Reward callbacks include the earned reward plus `adId`. */
+export type AdMobPlusAdRewardPayload = AdMobPlusAdIdPayload & {
+    reward: {
+        amount: number;
+        type: string;
+    };
+};
+/**
+ * Maps each {@link AdMobPlusEventName} to the payload shape emitted from native code.
+ *
+ * @since 8.2.0
+ */
+export type AdMobPlusEventPayloadMap = {
+    [AdMobPlusEvents.AdClick]: AdMobPlusAdIdPayload;
+    [AdMobPlusEvents.AdDismiss]: AdMobPlusAdIdPayload;
+    [AdMobPlusEvents.AdImpression]: AdMobPlusAdIdPayload;
+    [AdMobPlusEvents.AdLoad]: AdMobPlusAdIdPayload;
+    [AdMobPlusEvents.AdLoadFail]: AdMobPlusAdFailurePayload;
+    [AdMobPlusEvents.AdReward]: AdMobPlusAdRewardPayload;
+    [AdMobPlusEvents.AdShow]: AdMobPlusAdIdPayload;
+    [AdMobPlusEvents.AdShowFail]: AdMobPlusAdFailurePayload;
+    [AdMobPlusEvents.BannerClick]: AdMobPlusAdIdPayload;
+    [AdMobPlusEvents.BannerClose]: AdMobPlusAdIdPayload;
+    [AdMobPlusEvents.BannerImpression]: AdMobPlusAdIdPayload;
+    [AdMobPlusEvents.BannerLoad]: AdMobPlusAdIdPayload;
+    [AdMobPlusEvents.BannerLoadFail]: AdMobPlusAdFailurePayload;
+    [AdMobPlusEvents.BannerOpen]: AdMobPlusAdIdPayload;
+    [AdMobPlusEvents.BannerSizeChange]: AdMobPlusAdIdPayload;
+    [AdMobPlusEvents.InterstitialDismiss]: AdMobPlusAdIdPayload;
+    [AdMobPlusEvents.InterstitialImpression]: AdMobPlusAdIdPayload;
+    [AdMobPlusEvents.InterstitialLoad]: AdMobPlusAdIdPayload;
+    [AdMobPlusEvents.InterstitialLoadFail]: AdMobPlusAdFailurePayload;
+    [AdMobPlusEvents.InterstitialShow]: AdMobPlusAdIdPayload;
+    [AdMobPlusEvents.InterstitialShowFail]: AdMobPlusAdFailurePayload;
+    [AdMobPlusEvents.RewardedDismiss]: AdMobPlusAdIdPayload;
+    [AdMobPlusEvents.RewardedImpression]: AdMobPlusAdIdPayload;
+    [AdMobPlusEvents.RewardedInterstitialDismiss]: AdMobPlusAdIdPayload;
+    [AdMobPlusEvents.RewardedInterstitialImpression]: AdMobPlusAdIdPayload;
+    [AdMobPlusEvents.RewardedInterstitialLoad]: AdMobPlusAdIdPayload;
+    [AdMobPlusEvents.RewardedInterstitialLoadFail]: AdMobPlusAdFailurePayload;
+    [AdMobPlusEvents.RewardedInterstitialReward]: AdMobPlusAdRewardPayload;
+    [AdMobPlusEvents.RewardedInterstitialShow]: AdMobPlusAdIdPayload;
+    [AdMobPlusEvents.RewardedInterstitialShowFail]: AdMobPlusAdFailurePayload;
+    [AdMobPlusEvents.RewardedLoad]: AdMobPlusAdIdPayload;
+    [AdMobPlusEvents.RewardedLoadFail]: AdMobPlusAdFailurePayload;
+    [AdMobPlusEvents.RewardedReward]: AdMobPlusAdRewardPayload;
+    [AdMobPlusEvents.RewardedShow]: AdMobPlusAdIdPayload;
+    [AdMobPlusEvents.RewardedShowFail]: AdMobPlusAdFailurePayload;
+    [AdMobPlusEvents.FeedClick]: AdMobPlusFeedAdIdPayload;
+    [AdMobPlusEvents.FeedClose]: AdMobPlusFeedAdIdPayload;
+    [AdMobPlusEvents.FeedImpression]: AdMobPlusFeedAdIdPayload;
+    [AdMobPlusEvents.FeedLoad]: AdMobPlusFeedLoadPayload;
+    [AdMobPlusEvents.FeedLoadFail]: AdMobPlusAdFailurePayload & AdMobPlusFeedAdIdPayload;
+    [AdMobPlusEvents.FeedOpen]: AdMobPlusFeedAdIdPayload;
+    [AdMobPlusEvents.FeedRefresh]: AdMobPlusFeedAdIdPayload;
+};

package/dist/esm/events.js

@@ -0,0 +1,50 @@
+/**
+ * Typed event name constants for {@link AdMobPlusPlugin.addListener}.
+ *
+ * @since 8.2.0
+ */
+export const AdMobPlusEvents = {
+    AdClick: 'ad.click',
+    AdDismiss: 'ad.dismiss',
+    AdImpression: 'ad.impression',
+    AdLoad: 'ad.load',
+    AdLoadFail: 'ad.loadfail',
+    AdReward: 'ad.reward',
+    AdShow: 'ad.show',
+    AdShowFail: 'ad.showfail',
+    BannerClick: 'banner.click',
+    BannerClose: 'banner.close',
+    BannerImpression: 'banner.impression',
+    BannerLoad: 'banner.load',
+    BannerLoadFail: 'banner.loadfail',
+    BannerOpen: 'banner.open',
+    BannerSizeChange: 'banner.sizechange',
+    InterstitialDismiss: 'interstitial.dismiss',
+    InterstitialImpression: 'interstitial.impression',
+    InterstitialLoad: 'interstitial.load',
+    InterstitialLoadFail: 'interstitial.loadfail',
+    InterstitialShow: 'interstitial.show',
+    InterstitialShowFail: 'interstitial.showfail',
+    RewardedDismiss: 'rewarded.dismiss',
+    RewardedImpression: 'rewarded.impression',
+    RewardedInterstitialDismiss: 'rewardedi.dismiss',
+    RewardedInterstitialImpression: 'rewardedi.impression',
+    RewardedInterstitialLoad: 'rewardedi.load',
+    RewardedInterstitialLoadFail: 'rewardedi.loadfail',
+    RewardedInterstitialReward: 'rewardedi.reward',
+    RewardedInterstitialShow: 'rewardedi.show',
+    RewardedInterstitialShowFail: 'rewardedi.showfail',
+    RewardedLoad: 'rewarded.load',
+    RewardedLoadFail: 'rewarded.loadfail',
+    RewardedReward: 'rewarded.reward',
+    RewardedShow: 'rewarded.show',
+    RewardedShowFail: 'rewarded.showfail',
+    FeedClick: 'feed.click',
+    FeedClose: 'feed.close',
+    FeedImpression: 'feed.impression',
+    FeedLoad: 'feed.load',
+    FeedLoadFail: 'feed.loadfail',
+    FeedOpen: 'feed.open',
+    FeedRefresh: 'feed.refresh',
+};
+//# sourceMappingURL=events.js.map

package/dist/esm/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/events.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,OAAO,EAAE,UAAU;IACnB,SAAS,EAAE,YAAY;IACvB,YAAY,EAAE,eAAe;IAC7B,MAAM,EAAE,SAAS;IACjB,UAAU,EAAE,aAAa;IACzB,QAAQ,EAAE,WAAW;IACrB,MAAM,EAAE,SAAS;IACjB,UAAU,EAAE,aAAa;IACzB,WAAW,EAAE,cAAc;IAC3B,WAAW,EAAE,cAAc;IAC3B,gBAAgB,EAAE,mBAAmB;IACrC,UAAU,EAAE,aAAa;IACzB,cAAc,EAAE,iBAAiB;IACjC,UAAU,EAAE,aAAa;IACzB,gBAAgB,EAAE,mBAAmB;IACrC,mBAAmB,EAAE,sBAAsB;IAC3C,sBAAsB,EAAE,yBAAyB;IACjD,gBAAgB,EAAE,mBAAmB;IACrC,oBAAoB,EAAE,uBAAuB;IAC7C,gBAAgB,EAAE,mBAAmB;IACrC,oBAAoB,EAAE,uBAAuB;IAC7C,eAAe,EAAE,kBAAkB;IACnC,kBAAkB,EAAE,qBAAqB;IACzC,2BAA2B,EAAE,mBAAmB;IAChD,8BAA8B,EAAE,sBAAsB;IACtD,wBAAwB,EAAE,gBAAgB;IAC1C,4BAA4B,EAAE,oBAAoB;IAClD,0BAA0B,EAAE,kBAAkB;IAC9C,wBAAwB,EAAE,gBAAgB;IAC1C,4BAA4B,EAAE,oBAAoB;IAClD,YAAY,EAAE,eAAe;IAC7B,gBAAgB,EAAE,mBAAmB;IACrC,cAAc,EAAE,iBAAiB;IACjC,YAAY,EAAE,eAAe;IAC7B,gBAAgB,EAAE,mBAAmB;IACrC,SAAS,EAAE,YAAY;IACvB,SAAS,EAAE,YAAY;IACvB,cAAc,EAAE,iBAAiB;IACjC,QAAQ,EAAE,WAAW;IACrB,YAAY,EAAE,eAAe;IAC7B,QAAQ,EAAE,WAAW;IACrB,WAAW,EAAE,cAAc;CACnB,CAAC"}

package/dist/esm/feed-ad.d.ts

@@ -0,0 +1,32 @@
+import type { FeedAdBounds, FeedAdCreateOptions } from './definitions';
+declare const MIN_AUTO_REFRESH_MS = 30000;
+/**
+ * High-level helper for in-feed native or banner ads.
+ *
+ * Policy: impressions and clicks are recorded only on the native overlay
+ * ({@link https://developers.google.com/admob/android/native/advanced | NativeAdView} /
+ * GADNativeAdView). Use a placeholder element in your HTML feed and call
+ * {@link FeedAd.attachTo} so the plugin keeps the overlay aligned on scroll and resize.
+ */
+export declare class FeedAd {
+    private id;
+    private createPromise;
+    private readonly opts;
+    private stopSync;
+    constructor(opts: FeedAdCreateOptions);
+    get feedAdId(): number | null;
+    create(): Promise<number>;
+    load(): Promise<void>;
+    isLoaded(): Promise<boolean>;
+    /**
+     * Load the ad (if needed) and keep a native ad view aligned with `element`.
+     */
+    attachTo(element: HTMLElement): Promise<void>;
+    updatePosition(bounds: FeedAdBounds): Promise<void>;
+    setAutoRefresh(autoRefreshMs: number | null): Promise<void>;
+    destroy(): Promise<void>;
+    private startBoundsSync;
+    private stopBoundsSync;
+    private pushBounds;
+}
+export { MIN_AUTO_REFRESH_MS as FEED_AD_MIN_AUTO_REFRESH_MS };