@adapty/capacitor 3.11.1-beta.0 → 3.15.0

package/dist/esm/ui-builder/onboarding-view-emitter.js

@@ -1,18 +1,24 @@
-import { parseOnboardingEvent } from '../shared/coders/parse';
+import { parseOnboardingEvent } from '../shared/coders/parse-onboarding';
+import { OnboardingEventId } from '../shared/types/onboarding-events';
 import { BaseViewEmitter } from './base-view-emitter';
 /**
  * OnboardingViewEmitter manages event handlers for onboarding view events.
  * Each event type can have only one handler - new handlers replace existing ones.
  */
 export class OnboardingViewEmitter extends BaseViewEmitter {
-    getEventConfig(event) {
-        return HANDLER_TO_EVENT_CONFIG[event];
-    }
     parseEventData(rawEventData, ctx) {
-        return parseOnboardingEvent(rawEventData, ctx);
+        const result = parseOnboardingEvent(rawEventData, ctx);
+        if (!result) {
+            throw new Error('Failed to parse onboarding event');
+        }
+        return result;
+    }
+    getNativeEventForHandler(event) {
+        return HANDLER_TO_NATIVE_EVENT[event];
     }
-    getPossibleHandlers(nativeEvent) {
-        return NATIVE_EVENT_TO_HANDLERS[nativeEvent] || [];
+    getHandlerForNativeEvent(nativeEvent) {
+        var _a;
+        return (_a = NATIVE_EVENT_RESOLVER[nativeEvent]) !== null && _a !== void 0 ? _a : null;
     }
     extractCallbackArgs(handlerName, eventData) {
         return extractCallbackArgs(handlerName, eventData);
@@ -21,60 +27,47 @@ export class OnboardingViewEmitter extends BaseViewEmitter {
         var _a, _b;
         return (_b = (_a = eventData === null || eventData === void 0 ? void 0 : eventData.view) === null || _a === void 0 ? void 0 : _a.id) !== null && _b !== void 0 ? _b : null;
     }
-    shouldCallHandler() {
-        // Onboarding events don't use propertyMap filtering
-        return true;
-    }
     getEmitterName() {
         return 'OnboardingViewEmitter';
     }
 }
-const ONBOARDING_EVENT_MAPPINGS = {
-    onboarding_did_fail_with_error: [{ handlerName: 'onError' }],
-    onboarding_on_analytics_action: [{ handlerName: 'onAnalytics' }],
-    onboarding_did_finish_loading: [{ handlerName: 'onFinishedLoading' }],
-    onboarding_on_close_action: [{ handlerName: 'onClose' }],
-    onboarding_on_custom_action: [{ handlerName: 'onCustom' }],
-    onboarding_on_paywall_action: [{ handlerName: 'onPaywall' }],
-    onboarding_on_state_updated_action: [{ handlerName: 'onStateUpdated' }],
+const HANDLER_TO_NATIVE_EVENT = {
+    onError: 'onboarding_did_fail_with_error',
+    onAnalytics: 'onboarding_on_analytics_action',
+    onFinishedLoading: 'onboarding_did_finish_loading',
+    onClose: 'onboarding_on_close_action',
+    onCustom: 'onboarding_on_custom_action',
+    onPaywall: 'onboarding_on_paywall_action',
+    onStateUpdated: 'onboarding_on_state_updated_action',
 };
-const HANDLER_TO_EVENT_CONFIG = Object.entries(ONBOARDING_EVENT_MAPPINGS).reduce((acc, [nativeEvent, mappings]) => {
-    mappings.forEach(({ handlerName }) => {
-        acc[handlerName] = {
-            nativeEvent,
-            handlerName,
-        };
-    });
-    return acc;
-}, {});
-// Reverse mapping: nativeEvent -> EventName[]
-const NATIVE_EVENT_TO_HANDLERS = Object.entries(HANDLER_TO_EVENT_CONFIG).reduce((acc, [handlerName, config]) => {
-    if (!acc[config.nativeEvent]) {
-        acc[config.nativeEvent] = [];
-    }
-    acc[config.nativeEvent].push(handlerName);
-    return acc;
-}, {});
-function extractCallbackArgs(handlerName, eventArg) {
-    const actionId = eventArg.id || '';
-    const meta = eventArg.meta;
-    const event = eventArg.event;
-    const action = eventArg.action;
-    switch (handlerName) {
-        case 'onClose':
-        case 'onCustom':
-        case 'onPaywall':
-            return [actionId, meta];
-        case 'onStateUpdated':
-            return [action, meta];
-        case 'onFinishedLoading':
-            return [meta];
-        case 'onAnalytics':
-            return [event, meta];
-        case 'onError':
-            return [eventArg.error];
-        default:
-            return [];
+const NATIVE_EVENT_RESOLVER = {
+    onboarding_did_fail_with_error: 'onError',
+    onboarding_on_analytics_action: 'onAnalytics',
+    onboarding_did_finish_loading: 'onFinishedLoading',
+    onboarding_on_close_action: 'onClose',
+    onboarding_on_custom_action: 'onCustom',
+    onboarding_on_paywall_action: 'onPaywall',
+    onboarding_on_state_updated_action: 'onStateUpdated',
+};
+function extractCallbackArgs(_handlerName, event) {
+    switch (event.id) {
+        case OnboardingEventId.Close:
+        case OnboardingEventId.Custom:
+        case OnboardingEventId.Paywall:
+            return [event.actionId, event.meta];
+        case OnboardingEventId.StateUpdated:
+            return [event.action, event.meta];
+        case OnboardingEventId.FinishedLoading:
+            return [event.meta];
+        case OnboardingEventId.Analytics:
+            return [
+                Object.assign(Object.assign({}, event.event), { 
+                    // Add backward compatibility: populate element_id from elementId
+                    element_id: event.event.elementId }),
+                event.meta,
+            ];
+        case OnboardingEventId.Error:
+            return [event.error];
     }
 }
 //# sourceMappingURL=onboarding-view-emitter.js.map

package/dist/esm/ui-builder/onboarding-view-emitter.js.map

@@ -1 +1 @@
-{"version":3,"file":"onboarding-view-emitter.js","sourceRoot":"","sources":["../../../src/ui-builder/onboarding-view-emitter.ts"],"names":[],"mappings":"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","sourcesContent":["import { parseOnboardingEvent } from '../shared/coders/parse';\nimport type { LogContext } from '../shared/logger';\nimport type { AdaptyError } from '../shared/types/method-types';\n\nimport { BaseViewEmitter, type BaseEventConfig } from './base-view-emitter';\nimport type { AdaptyUiOnboardingMeta, OnboardingEventHandlers, OnboardingStateUpdatedAction } from './types';\n\ntype EventName = keyof OnboardingEventHandlers;\n\ninterface OnboardingEventData {\n  id?: string;\n  meta?: AdaptyUiOnboardingMeta;\n  event?: {\n    name: string;\n    element_id?: string;\n    reply?: string;\n  };\n  action?: OnboardingStateUpdatedAction;\n  error?: AdaptyError;\n  view?: {\n    id: string;\n  };\n}\n\n/**\n * OnboardingViewEmitter manages event handlers for onboarding view events.\n * Each event type can have only one handler - new handlers replace existing ones.\n */\nexport class OnboardingViewEmitter extends BaseViewEmitter<OnboardingEventHandlers, OnboardingEventData> {\n  protected getEventConfig(event: keyof OnboardingEventHandlers): BaseEventConfig | undefined {\n    return HANDLER_TO_EVENT_CONFIG[event as EventName];\n  }\n\n  protected parseEventData(rawEventData: string, ctx: LogContext): OnboardingEventData {\n    return parseOnboardingEvent(rawEventData, ctx) as OnboardingEventData;\n  }\n\n  protected getPossibleHandlers(nativeEvent: string): (keyof OnboardingEventHandlers)[] {\n    return NATIVE_EVENT_TO_HANDLERS[nativeEvent] || [];\n  }\n\n  protected extractCallbackArgs(handlerName: keyof OnboardingEventHandlers, eventData: OnboardingEventData): unknown[] {\n    return extractCallbackArgs(handlerName as EventName, eventData);\n  }\n\n  protected getEventViewId(eventData: OnboardingEventData): string | null {\n    return eventData?.view?.id ?? null;\n  }\n\n  protected shouldCallHandler(): boolean {\n    // Onboarding events don't use propertyMap filtering\n    return true;\n  }\n\n  protected getEmitterName(): string {\n    return 'OnboardingViewEmitter';\n  }\n}\n\ntype UiEventMapping = {\n  [nativeEventId: string]: {\n    handlerName: keyof OnboardingEventHandlers;\n  }[];\n};\n\nconst ONBOARDING_EVENT_MAPPINGS: UiEventMapping = {\n  onboarding_did_fail_with_error: [{ handlerName: 'onError' }],\n  onboarding_on_analytics_action: [{ handlerName: 'onAnalytics' }],\n  onboarding_did_finish_loading: [{ handlerName: 'onFinishedLoading' }],\n  onboarding_on_close_action: [{ handlerName: 'onClose' }],\n  onboarding_on_custom_action: [{ handlerName: 'onCustom' }],\n  onboarding_on_paywall_action: [{ handlerName: 'onPaywall' }],\n  onboarding_on_state_updated_action: [{ handlerName: 'onStateUpdated' }],\n};\n\nconst HANDLER_TO_EVENT_CONFIG: Record<\n  keyof OnboardingEventHandlers,\n  {\n    nativeEvent: string;\n    handlerName: keyof OnboardingEventHandlers;\n  }\n> = Object.entries(ONBOARDING_EVENT_MAPPINGS).reduce(\n  (acc, [nativeEvent, mappings]) => {\n    mappings.forEach(({ handlerName }) => {\n      acc[handlerName] = {\n        nativeEvent,\n        handlerName,\n      };\n    });\n    return acc;\n  },\n  {} as Record<\n    keyof OnboardingEventHandlers,\n    {\n      nativeEvent: string;\n      handlerName: keyof OnboardingEventHandlers;\n    }\n  >,\n);\n\n// Reverse mapping: nativeEvent -> EventName[]\nconst NATIVE_EVENT_TO_HANDLERS: Record<string, EventName[]> = Object.entries(HANDLER_TO_EVENT_CONFIG).reduce(\n  (acc, [handlerName, config]) => {\n    if (!acc[config.nativeEvent]) {\n      acc[config.nativeEvent] = [];\n    }\n    acc[config.nativeEvent].push(handlerName as EventName);\n    return acc;\n  },\n  {} as Record<string, EventName[]>,\n);\n\nfunction extractCallbackArgs(handlerName: keyof OnboardingEventHandlers, eventArg: OnboardingEventData): unknown[] {\n  const actionId = eventArg.id || '';\n  const meta = eventArg.meta;\n  const event = eventArg.event;\n  const action = eventArg.action;\n\n  switch (handlerName) {\n    case 'onClose':\n    case 'onCustom':\n    case 'onPaywall':\n      return [actionId, meta];\n    case 'onStateUpdated':\n      return [action, meta];\n    case 'onFinishedLoading':\n      return [meta];\n    case 'onAnalytics':\n      return [event, meta];\n    case 'onError':\n      return [eventArg.error];\n    default:\n      return [];\n  }\n}\n"]}
+{"version":3,"file":"onboarding-view-emitter.js","sourceRoot":"","sources":["../../../src/ui-builder/onboarding-view-emitter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAEzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAGtE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAMtD;;;GAGG;AACH,MAAM,OAAO,qBAAsB,SAAQ,eAI1C;IACW,cAAc,CAAC,YAAoB,EAAE,GAAe;QAC5D,MAAM,MAAM,GAAG,oBAAoB,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;QACvD,IAAI,CAAC,MAAM,EAAE;YACX,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;SACrD;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAES,wBAAwB,CAAC,KAAoC;QACrE,OAAO,uBAAuB,CAAC,KAAkB,CAAC,CAAC;IACrD,CAAC;IAES,wBAAwB,CAAC,WAAkC;;QACnE,OAAO,MAAA,qBAAqB,CAAC,WAAW,CAAC,mCAAI,IAAI,CAAC;IACpD,CAAC;IAES,mBAAmB,CAC3B,WAA0C,EAC1C,SAAgC;QAEhC,OAAO,mBAAmB,CAAC,WAAwB,EAAE,SAAS,CAAC,CAAC;IAClE,CAAC;IAES,cAAc,CAAC,SAAgC;;QACvD,OAAO,MAAA,MAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,IAAI,0CAAE,EAAE,mCAAI,IAAI,CAAC;IACrC,CAAC;IAES,cAAc;QACtB,OAAO,uBAAuB,CAAC;IACjC,CAAC;CACF;AAED,MAAM,uBAAuB,GAA6C;IACxE,OAAO,EAAE,gCAAgC;IACzC,WAAW,EAAE,gCAAgC;IAC7C,iBAAiB,EAAE,+BAA+B;IAClD,OAAO,EAAE,4BAA4B;IACrC,QAAQ,EAAE,6BAA6B;IACvC,SAAS,EAAE,8BAA8B;IACzC,cAAc,EAAE,oCAAoC;CACrD,CAAC;AAEF,MAAM,qBAAqB,GAA6C;IACtE,8BAA8B,EAAE,SAAS;IACzC,8BAA8B,EAAE,aAAa;IAC7C,6BAA6B,EAAE,mBAAmB;IAClD,0BAA0B,EAAE,SAAS;IACrC,2BAA2B,EAAE,UAAU;IACvC,4BAA4B,EAAE,WAAW;IACzC,kCAAkC,EAAE,gBAAgB;CACrD,CAAC;AAIF,SAAS,mBAAmB,CAC1B,YAAe,EACf,KAA4B;IAE5B,QAAQ,KAAK,CAAC,EAAE,EAAE;QAChB,KAAK,iBAAiB,CAAC,KAAK,CAAC;QAC7B,KAAK,iBAAiB,CAAC,MAAM,CAAC;QAC9B,KAAK,iBAAiB,CAAC,OAAO;YAC5B,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAqB,CAAC;QAE1D,KAAK,iBAAiB,CAAC,YAAY;YACjC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAqB,CAAC;QAExD,KAAK,iBAAiB,CAAC,eAAe;YACpC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAqB,CAAC;QAE1C,KAAK,iBAAiB,CAAC,SAAS;YAC9B,OAAO;gDAEA,KAAK,CAAC,KAAK;oBACd,iEAAiE;oBACjE,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,SAAS;gBAEnC,KAAK,CAAC,IAAI;aACS,CAAC;QAExB,KAAK,iBAAiB,CAAC,KAAK;YAC1B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAqB,CAAC;KAC5C;AACH,CAAC","sourcesContent":["import { parseOnboardingEvent } from '../shared/coders/parse-onboarding';\nimport type { LogContext } from '../shared/logger';\nimport { OnboardingEventId } from '../shared/types/onboarding-events';\nimport type { OnboardingEventIdType, ParsedOnboardingEvent } from '../shared/types/onboarding-events';\n\nimport { BaseViewEmitter } from './base-view-emitter';\nimport type { OnboardingEventHandlers } from './types';\n\ntype EventName = keyof OnboardingEventHandlers;\ntype OnboardingNativeEvent = OnboardingEventIdType;\n\n/**\n * OnboardingViewEmitter manages event handlers for onboarding view events.\n * Each event type can have only one handler - new handlers replace existing ones.\n */\nexport class OnboardingViewEmitter extends BaseViewEmitter<\n  OnboardingEventHandlers,\n  ParsedOnboardingEvent,\n  OnboardingNativeEvent\n> {\n  protected parseEventData(rawEventData: string, ctx: LogContext): ParsedOnboardingEvent {\n    const result = parseOnboardingEvent(rawEventData, ctx);\n    if (!result) {\n      throw new Error('Failed to parse onboarding event');\n    }\n    return result;\n  }\n\n  protected getNativeEventForHandler(event: keyof OnboardingEventHandlers): OnboardingNativeEvent | null {\n    return HANDLER_TO_NATIVE_EVENT[event as EventName];\n  }\n\n  protected getHandlerForNativeEvent(nativeEvent: OnboardingNativeEvent): keyof OnboardingEventHandlers | null {\n    return NATIVE_EVENT_RESOLVER[nativeEvent] ?? null;\n  }\n\n  protected extractCallbackArgs(\n    handlerName: keyof OnboardingEventHandlers,\n    eventData: ParsedOnboardingEvent,\n  ): unknown[] {\n    return extractCallbackArgs(handlerName as EventName, eventData);\n  }\n\n  protected getEventViewId(eventData: ParsedOnboardingEvent): string | null {\n    return eventData?.view?.id ?? null;\n  }\n\n  protected getEmitterName(): string {\n    return 'OnboardingViewEmitter';\n  }\n}\n\nconst HANDLER_TO_NATIVE_EVENT: Record<EventName, OnboardingNativeEvent> = {\n  onError: 'onboarding_did_fail_with_error',\n  onAnalytics: 'onboarding_on_analytics_action',\n  onFinishedLoading: 'onboarding_did_finish_loading',\n  onClose: 'onboarding_on_close_action',\n  onCustom: 'onboarding_on_custom_action',\n  onPaywall: 'onboarding_on_paywall_action',\n  onStateUpdated: 'onboarding_on_state_updated_action',\n};\n\nconst NATIVE_EVENT_RESOLVER: Record<OnboardingNativeEvent, EventName> = {\n  onboarding_did_fail_with_error: 'onError',\n  onboarding_on_analytics_action: 'onAnalytics',\n  onboarding_did_finish_loading: 'onFinishedLoading',\n  onboarding_on_close_action: 'onClose',\n  onboarding_on_custom_action: 'onCustom',\n  onboarding_on_paywall_action: 'onPaywall',\n  onboarding_on_state_updated_action: 'onStateUpdated',\n};\n\ntype ExtractedArgs<T extends keyof OnboardingEventHandlers> = Parameters<OnboardingEventHandlers[T]>;\n\nfunction extractCallbackArgs<T extends keyof OnboardingEventHandlers>(\n  _handlerName: T,\n  event: ParsedOnboardingEvent,\n): ExtractedArgs<T> {\n  switch (event.id) {\n    case OnboardingEventId.Close:\n    case OnboardingEventId.Custom:\n    case OnboardingEventId.Paywall:\n      return [event.actionId, event.meta] as ExtractedArgs<T>;\n\n    case OnboardingEventId.StateUpdated:\n      return [event.action, event.meta] as ExtractedArgs<T>;\n\n    case OnboardingEventId.FinishedLoading:\n      return [event.meta] as ExtractedArgs<T>;\n\n    case OnboardingEventId.Analytics:\n      return [\n        {\n          ...event.event,\n          // Add backward compatibility: populate element_id from elementId\n          element_id: event.event.elementId,\n        },\n        event.meta,\n      ] as ExtractedArgs<T>;\n\n    case OnboardingEventId.Error:\n      return [event.error] as ExtractedArgs<T>;\n  }\n}\n"]}

package/dist/esm/ui-builder/paywall-view-controller.d.ts

@@ -1,8 +1,14 @@
 import type { Adapty } from '../adapty';
 import type { AdaptyPaywall } from '../shared/types';
-import type { CreatePaywallViewParamsInput, AdaptyUiDialogConfig, AdaptyUiDialogActionType, EventHandlers } from './types';
+import type { CreatePaywallViewParamsInput, AdaptyUiDialogConfig, AdaptyUiDialogActionType, EventHandlers, AdaptyIOSPresentationStyle } from './types';
 /**
- * Provides methods to control created paywall view
+ * Controller for managing paywall views.
+ *
+ * @remarks
+ * This class provides methods to present, dismiss, and handle events for paywall views
+ * created with the Paywall Builder. Create instances using the {@link createPaywallView} function
+ * rather than directly constructing this class.
+ *
  * @public
  */
 export declare class PaywallViewController {
@@ -25,66 +31,160 @@ export declare class PaywallViewController {
      */
     private constructor();
     /**
-     * Presents a paywall view as a full-screen modal
+     * Presents the paywall view as a modal screen.
      *
      * @remarks
-     * Calling `present` upon already visible paywall view
-     * would result in an error
+     * Calling `present` on an already visible paywall view will result in an error.
+     * The paywall will be displayed with the configured presentation style on iOS.
+     * On Android, the paywall is always presented as a full-screen activity.
      *
-     * @throws {AdaptyError}
+     * @param options - Optional presentation options
+     * @param options.iosPresentationStyle - iOS presentation style. Available options: `'full_screen'` (default) or `'page_sheet'`. Only affects iOS platform.
+     * @returns A promise that resolves when the paywall is presented.
+     * @throws {@link AdaptyError} if the view reference is invalid or the view is already presented.
+     *
+     * @example
+     * Present with default full-screen style
+     * ```typescript
+     * import { adapty, createPaywallView } from '@adapty/capacitor';
+     *
+     * const paywall = await adapty.getPaywall({ placementId: 'YOUR_PLACEMENT_ID' });
+     * const view = await createPaywallView(paywall);
+     * await view.present();
+     * ```
+     *
+     * @example
+     * Present with page sheet style on iOS
+     * ```typescript
+     * await view.present({ iosPresentationStyle: 'page_sheet' });
+     * ```
      */
-    present(): Promise<void>;
+    present(options?: {
+        iosPresentationStyle?: AdaptyIOSPresentationStyle;
+    }): Promise<void>;
     /**
-     * Dismisses a paywall view
+     * Dismisses the paywall view.
+     *
+     * @remarks
+     * This method closes the paywall and cleans up associated resources.
+     * After dismissing, the view controller instance cannot be reused.
      *
-     * @throws {AdaptyError}
+     * @returns A promise that resolves when the paywall is dismissed.
+     * @throws {@link AdaptyError} if the view reference is invalid.
+     *
+     * @example
+     * ```typescript
+     * import { createPaywallView } from '@adapty/capacitor';
+     *
+     * const view = await createPaywallView(paywall);
+     * await view.present();
+     * // ... later
+     * await view.dismiss();
+     * ```
      */
     dismiss(): Promise<void>;
     /**
-     * Presents the dialog
-     *
-     * @param {AdaptyUiDialogConfig} config - A config for showing the dialog.
+     * Displays a dialog to the user.
      *
      * @remarks
-     * If you provide two actions in the config, be sure `primaryAction` cancels the operation
-     * and leaves things unchanged.
+     * Use this method to show custom dialogs within the paywall flow.
+     * If you provide two actions in the config, the primary action should cancel the operation
+     * and leave things unchanged, while the secondary action should confirm the operation.
      *
-     * @returns {Promise<AdaptyUiDialogActionType>} A Promise that resolves to the {@link AdaptyUiDialogActionType} object
+     * @param config - Configuration for the dialog.
+     * @param config.title - The dialog title.
+     * @param config.content - The dialog message content.
+     * @param config.primaryActionTitle - The title for the primary (default) action button.
+     * @param config.secondaryActionTitle - Optional. The title for the secondary action button.
+     * @returns A promise that resolves to the action type that the user selected: `'primary'` or `'secondary'`.
+     * @throws {@link AdaptyError} if the view reference is invalid.
      *
-     * @throws {AdaptyError}
+     * @example
+     * Show confirmation dialog
+     * ```typescript
+     * const action = await view.showDialog({
+     *   title: 'Confirm Purchase',
+     *   content: 'Are you sure you want to proceed with this purchase?',
+     *   primaryActionTitle: 'Cancel',
+     *   secondaryActionTitle: 'Continue'
+     * });
+     *
+     * if (action === 'secondary') {
+     *   console.log('User confirmed');
+     * }
+     * ```
      */
     showDialog(config: AdaptyUiDialogConfig): Promise<AdaptyUiDialogActionType>;
     private onRequestClose;
     /**
-     * Register event handlers for UI events
-     *
-     * @see {@link https://adapty.io/docs/capacitor-handling-events | [DOC] Handling View Events}
+     * Registers event handlers for paywall UI events.
      *
      * @remarks
      * Each event type can have only one handler — new handlers replace existing ones.
-     * Default handlers are registered in {@link PaywallViewController.create} and provide standard closing behavior:
-     * - `onCloseButtonPress`
-     * - `onAndroidSystemBack`
-     * - `onRestoreCompleted`
-     * - `onPurchaseCompleted`
+     * Default handlers are registered automatically in {@link createPaywallView} and provide standard closing behavior:
+     * - `onCloseButtonPress` - closes the paywall
+     * - `onAndroidSystemBack` - closes the paywall (Android only)
+     * - `onRestoreCompleted` - closes the paywall after successful restore
+     * - `onRenderingFailed` - closes the paywall when rendering fails
+     * - `onPurchaseCompleted` - closes the paywall after successful purchase
      *
-     *
-     * If you want to override these listeners, we strongly recommend to return `true` (or `purchaseResult.type !== 'user_cancelled'` in case of `onPurchaseCompleted`)
+     * If you want to override these listeners, we strongly recommend returning `true`
+     * (or `purchaseResult.type !== 'user_cancelled'` in case of `onPurchaseCompleted`)
      * from your custom listener to retain default closing behavior.
      *
      * Calling this method multiple times will replace previously registered handlers for provided events.
      *
-     * @param {Partial<EventHandlers>} eventHandlers - set of event handling callbacks
-     * @returns {() => void} unsubscribe - function to unsubscribe all listeners
+     * @see {@link https://adapty.io/docs/capacitor-handling-events | Handling View Events}
+     *
+     * @param eventHandlers - Set of event handling callbacks. Only provided handlers will be registered or updated.
+     * @returns A promise that resolves to an unsubscribe function that removes all registered listeners.
+     *
+     * @example
+     * Register custom event handlers
+     * ```typescript
+     * import { createPaywallView } from '@adapty/capacitor';
+     *
+     * const view = await createPaywallView(paywall);
+     *
+     * const unsubscribe = await view.setEventHandlers({
+     *   onPurchaseStarted: (product) => {
+     *     console.log('Purchase started:', product.vendorProductId);
+     *   },
+     *   onPurchaseCompleted: (result) => {
+     *     console.log('Purchase completed:', result.type);
+     *     // Return true to keep default closing behavior
+     *     return result.type !== 'user_cancelled';
+     *   },
+     *   onPurchaseFailed: (error) => {
+     *     console.error('Purchase failed:', error);
+     *   }
+     * });
+     *
+     * await view.present();
+     *
+     * // Later, unsubscribe all handlers
+     * unsubscribe();
+     * ```
      */
     setEventHandlers(eventHandlers?: Partial<EventHandlers>): Promise<() => void>;
     /**
-     * Clears all registered event handlers
+     * Clears all registered event handlers.
      *
      * @remarks
      * This method removes all previously registered event handlers.
      * After calling this method, no event handlers will be active
-     * until you call `setEventHandlers` again.
+     * until you call {@link setEventHandlers} again.
+     *
+     * Use this after dismiss to remove all event handlers
+     *
+     * @example
+     * ```typescript
+     * const view = await createPaywallView(paywall);
+     * await view.setEventHandlers({ onPurchaseCompleted: handlePurchase });
+     *
+     * // Later, clear all handlers
+     * view.clearEventHandlers();
+     * ```
      */
     clearEventHandlers(): void;
 }