@adapty/capacitor 3.11.1-beta.0 → 3.15.0

package/dist/esm/ui-builder/index.d.ts

@@ -1,38 +1,7 @@
-import type { AdaptyOnboarding, AdaptyPaywall } from '../shared/types';
-import { OnboardingViewController } from './onboarding-view-controller';
-import { PaywallViewController } from './paywall-view-controller';
-import type { CreatePaywallViewParamsInput } from './types';
-export { PaywallViewController, OnboardingViewController };
-export type { CreatePaywallViewParamsInput };
-export type { AdaptyUiView, AdaptyUiDialogConfig, AdaptyUiDialogActionType, EventHandlers } from './types';
+export { PaywallViewController } from './paywall-view-controller';
+export { OnboardingViewController } from './onboarding-view-controller';
+export type { CreatePaywallViewParamsInput, CreateOnboardingViewParamsInput } from './types';
+export type { AdaptyCustomAsset, AdaptyUiView, AdaptyUiDialogConfig, AdaptyUiDialogActionType, AdaptyIOSPresentationStyle, EventHandlers, } from './types';
 export type { OnboardingEventHandlers } from './types';
-/**
- * Creates a paywall view controller.
- * You can use it to further configure a view or present it.
- *
- * @see {@link https://adapty.io/docs/capacitor-present-paywalls | [DOC] Creating a paywall view}
- *
- * @param {AdaptyPaywall} paywall - paywall that you want to present.
- * @param {CreatePaywallViewParamsInput | undefined} [params] - additional params.
- * @returns {Promise<PaywallViewController>} ViewController — A promise that resolves to a ViewController instance.
- *
- * @example
- * ```ts
- * const paywall = await adapty.getPaywall("MY_PAYWALL");
- * const view = await createPaywallView(paywall);
- * view.present();
- * ```
- *
- * @throws {AdaptyError} — If paywall is not found,
- * does not have a no-code view configured
- * or if there is an error while creating a view.
- */
-export declare function createPaywallView(paywall: AdaptyPaywall, params?: CreatePaywallViewParamsInput): Promise<PaywallViewController>;
-/**
- * Creates an onboarding view controller.
- * You can use it to further configure a view or present it.
- *
- * @param {AdaptyOnboarding} onboarding - onboarding that you want to present.
- * @returns {Promise<OnboardingViewController>} ViewController — A promise that resolves to a ViewController instance.
- */
-export declare function createOnboardingView(onboarding: AdaptyOnboarding): Promise<OnboardingViewController>;
+export { createPaywallView } from './create-paywall-view';
+export { createOnboardingView } from './create-onboarding-view';

package/dist/esm/ui-builder/index.js

@@ -1,43 +1,6 @@
-import { Adapty } from '../adapty';
-import { OnboardingViewController } from './onboarding-view-controller';
-import { PaywallViewController } from './paywall-view-controller';
-const adaptyPlugin = new Adapty();
 // Export UI types and classes for convenience
-export { PaywallViewController, OnboardingViewController };
-/**
- * Creates a paywall view controller.
- * You can use it to further configure a view or present it.
- *
- * @see {@link https://adapty.io/docs/capacitor-present-paywalls | [DOC] Creating a paywall view}
- *
- * @param {AdaptyPaywall} paywall - paywall that you want to present.
- * @param {CreatePaywallViewParamsInput | undefined} [params] - additional params.
- * @returns {Promise<PaywallViewController>} ViewController — A promise that resolves to a ViewController instance.
- *
- * @example
- * ```ts
- * const paywall = await adapty.getPaywall("MY_PAYWALL");
- * const view = await createPaywallView(paywall);
- * view.present();
- * ```
- *
- * @throws {AdaptyError} — If paywall is not found,
- * does not have a no-code view configured
- * or if there is an error while creating a view.
- */
-export async function createPaywallView(paywall, params = {}) {
-    const controller = await PaywallViewController.create(paywall, params, adaptyPlugin);
-    return controller;
-}
-/**
- * Creates an onboarding view controller.
- * You can use it to further configure a view or present it.
- *
- * @param {AdaptyOnboarding} onboarding - onboarding that you want to present.
- * @returns {Promise<OnboardingViewController>} ViewController — A promise that resolves to a ViewController instance.
- */
-export async function createOnboardingView(onboarding) {
-    const controller = await OnboardingViewController.create(onboarding, adaptyPlugin);
-    return controller;
-}
+export { PaywallViewController } from './paywall-view-controller';
+export { OnboardingViewController } from './onboarding-view-controller';
+export { createPaywallView } from './create-paywall-view';
+export { createOnboardingView } from './create-onboarding-view';
 //# sourceMappingURL=index.js.map

package/dist/esm/ui-builder/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ui-builder/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAGlE,MAAM,YAAY,GAAG,IAAI,MAAM,EAAE,CAAC;AAElC,8CAA8C;AAC9C,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,CAAC;AAK3D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAsB,EACtB,SAAuC,EAAE;IAEzC,MAAM,UAAU,GAAG,MAAM,qBAAqB,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;IAErF,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,UAA4B;IACrE,MAAM,UAAU,GAAG,MAAM,wBAAwB,CAAC,MAAM,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IACnF,OAAO,UAAU,CAAC;AACpB,CAAC","sourcesContent":["import { Adapty } from '../adapty';\nimport type { AdaptyOnboarding, AdaptyPaywall } from '../shared/types';\n\nimport { OnboardingViewController } from './onboarding-view-controller';\nimport { PaywallViewController } from './paywall-view-controller';\nimport type { CreatePaywallViewParamsInput } from './types';\n\nconst adaptyPlugin = new Adapty();\n\n// Export UI types and classes for convenience\nexport { PaywallViewController, OnboardingViewController };\nexport type { CreatePaywallViewParamsInput };\nexport type { AdaptyUiView, AdaptyUiDialogConfig, AdaptyUiDialogActionType, EventHandlers } from './types';\nexport type { OnboardingEventHandlers } from './types';\n\n/**\n * Creates a paywall view controller.\n * You can use it to further configure a view or present it.\n *\n * @see {@link https://adapty.io/docs/capacitor-present-paywalls | [DOC] Creating a paywall view}\n *\n * @param {AdaptyPaywall} paywall - paywall that you want to present.\n * @param {CreatePaywallViewParamsInput | undefined} [params] - additional params.\n * @returns {Promise<PaywallViewController>} ViewController — A promise that resolves to a ViewController instance.\n *\n * @example\n * ```ts\n * const paywall = await adapty.getPaywall(\"MY_PAYWALL\");\n * const view = await createPaywallView(paywall);\n * view.present();\n * ```\n *\n * @throws {AdaptyError} — If paywall is not found,\n * does not have a no-code view configured\n * or if there is an error while creating a view.\n */\nexport async function createPaywallView(\n  paywall: AdaptyPaywall,\n  params: CreatePaywallViewParamsInput = {},\n): Promise<PaywallViewController> {\n  const controller = await PaywallViewController.create(paywall, params, adaptyPlugin);\n\n  return controller;\n}\n\n/**\n * Creates an onboarding view controller.\n * You can use it to further configure a view or present it.\n *\n * @param {AdaptyOnboarding} onboarding - onboarding that you want to present.\n * @returns {Promise<OnboardingViewController>} ViewController — A promise that resolves to a ViewController instance.\n */\nexport async function createOnboardingView(onboarding: AdaptyOnboarding): Promise<OnboardingViewController> {\n  const controller = await OnboardingViewController.create(onboarding, adaptyPlugin);\n  return controller;\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ui-builder/index.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAYxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC","sourcesContent":["// Export UI types and classes for convenience\nexport { PaywallViewController } from './paywall-view-controller';\nexport { OnboardingViewController } from './onboarding-view-controller';\nexport type { CreatePaywallViewParamsInput, CreateOnboardingViewParamsInput } from './types';\nexport type {\n  AdaptyCustomAsset,\n  AdaptyUiView,\n  AdaptyUiDialogConfig,\n  AdaptyUiDialogActionType,\n  AdaptyIOSPresentationStyle,\n  EventHandlers,\n} from './types';\nexport type { OnboardingEventHandlers } from './types';\n\nexport { createPaywallView } from './create-paywall-view';\nexport { createOnboardingView } from './create-onboarding-view';\n"]}

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

@@ -1,8 +1,15 @@
 import type { Adapty } from '../adapty';
 import type { AdaptyOnboarding } from '../shared/types';
-import type { OnboardingEventHandlers } from './types';
+import type { OnboardingEventHandlers, AdaptyIOSPresentationStyle, CreateOnboardingViewParamsInput } from './types';
+export declare const DEFAULT_ONBOARDING_PARAMS: CreateOnboardingViewParamsInput;
 /**
- * Provides methods to control created onboarding view
+ * Controller for managing onboarding views.
+ *
+ * @remarks
+ * This class provides methods to present, dismiss, and handle events for onboarding views
+ * created with the Onboarding Builder. Create instances using the {@link createOnboardingView} function
+ * rather than directly constructing this class.
+ *
  * @public
  */
 export declare class OnboardingViewController {
@@ -15,7 +22,7 @@ export declare class OnboardingViewController {
      * and creates reference between native controller and JS instance
      * @internal
      */
-    static create(onboarding: AdaptyOnboarding, adaptyPlugin: Adapty): Promise<OnboardingViewController>;
+    static create(onboarding: AdaptyOnboarding, adaptyPlugin: Adapty, params?: CreateOnboardingViewParamsInput): Promise<OnboardingViewController>;
     /**
      * Since constructors in JS cannot be async, it is not
      * preferred to create ViewControllers in direct way.
@@ -25,44 +32,123 @@ export declare class OnboardingViewController {
      */
     private constructor();
     /**
-     * Presents an onboarding view as a full-screen modal
+     * Presents the onboarding view as a modal screen.
      *
      * @remarks
-     * Calling `present` upon already visible onboarding view
-     * would result in an error
+     * Calling `present` on an already visible onboarding view will result in an error.
+     * The onboarding will be displayed with the configured presentation style on iOS.
+     * On Android, the onboarding 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 onboarding 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, createOnboardingView } from '@adapty/capacitor';
+     *
+     * const onboarding = await adapty.getOnboarding({ placementId: 'YOUR_PLACEMENT_ID' });
+     * const view = await createOnboardingView(onboarding);
+     * 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 an onboarding view
+     * Dismisses the onboarding view.
+     *
+     * @remarks
+     * This method closes the onboarding and cleans up associated resources.
+     * After dismissing, the view controller instance cannot be reused.
+     *
+     * @returns A promise that resolves when the onboarding is dismissed.
+     * @throws {@link AdaptyError} if the view reference is invalid.
      *
-     * @throws {AdaptyError}
+     * @example
+     * ```typescript
+     * import { createOnboardingView } from '@adapty/capacitor';
+     *
+     * const view = await createOnboardingView(onboarding);
+     * await view.present();
+     * // ... later
+     * await view.dismiss();
+     * ```
      */
     dismiss(): Promise<void>;
     private onRequestClose;
     /**
-     * Register event handlers for UI events
+     * Registers event handlers for onboarding UI events.
      *
      * @remarks
      * Each event type can have only one handler — new handlers replace existing ones.
-     * Default handlers are registered in {@link OnboardingViewController.create} and provide standard closing behavior:
-     * - `onClose`
+     * Default handlers are registered automatically in {@link createOnboardingView} and provide standard closing behavior:
+     * - `onClose` - closes the onboarding when the close button is pressed or system back is used
      *
+     * If you want to override the `onClose` listener, we strongly recommend returning `true`
+     * from your custom listener to retain default closing behavior.
      *
      * Calling this method multiple times will replace previously registered handlers for provided events.
      *
-     * @param {Partial<OnboardingEventHandlers>} eventHandlers - set of event handling callbacks
-     * @returns {() => void} unsubscribe - function to unsubscribe all listeners
+     * @see {@link https://adapty.io/docs/capacitor-handling-onboarding-events | Handling Onboarding 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 { createOnboardingView } from '@adapty/capacitor';
+     *
+     * const view = await createOnboardingView(onboarding);
+     *
+     * const unsubscribe = await view.setEventHandlers({
+     *   onClose: () => {
+     *     console.log('Onboarding closed');
+     *     // Return true to keep default closing behavior
+     *     return true;
+     *   },
+     *   onActionPerformed: (action) => {
+     *     console.log('Action performed:', action.name);
+     *   },
+     *   onProductSelected: (product) => {
+     *     console.log('Product selected:', product.vendorProductId);
+     *   }
+     * });
+     *
+     * await view.present();
+     *
+     * // Later, unsubscribe all handlers
+     * unsubscribe();
+     * ```
      */
     setEventHandlers(eventHandlers?: Partial<OnboardingEventHandlers>): 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 createOnboardingView(onboarding);
+     * await view.setEventHandlers({ onClose: handleClose });
+     *
+     * // Later, clear all handlers
+     * view.clearEventHandlers();
+     * ```
      */
     clearEventHandlers(): void;
 }

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

@@ -1,12 +1,23 @@
 import { AdaptyError } from '../shared/adapty-error';
 import { AdaptyOnboardingCoder } from '../shared/coders/adapty-onboarding';
+import { AdaptyUICreateOnboardingViewParamsCoder } from '../shared/coders/adapty-ui-create-onboarding-view-params';
 import { LogContext, Log } from '../shared/logger';
+import { WebPresentation } from '../shared/types';
 import { mapValues } from '../shared/utils/map-values';
 import { withErrorContext } from '../shared/utils/with-error-context';
 import { OnboardingViewEmitter } from './onboarding-view-emitter';
 import { DEFAULT_ONBOARDING_EVENT_HANDLERS } from './types';
+export const DEFAULT_ONBOARDING_PARAMS = {
+    externalUrlsPresentation: WebPresentation.BrowserInApp,
+};
 /**
- * Provides methods to control created onboarding view
+ * Controller for managing onboarding views.
+ *
+ * @remarks
+ * This class provides methods to present, dismiss, and handle events for onboarding views
+ * created with the Onboarding Builder. Create instances using the {@link createOnboardingView} function
+ * rather than directly constructing this class.
+ *
  * @public
  */
 export class OnboardingViewController {
@@ -16,17 +27,16 @@ export class OnboardingViewController {
      * and creates reference between native controller and JS instance
      * @internal
      */
-    static async create(onboarding, adaptyPlugin) {
+    static async create(onboarding, adaptyPlugin, params = {}) {
         const controller = new OnboardingViewController(adaptyPlugin);
         const ctx = new LogContext();
         const methodKey = 'adapty_ui_create_onboarding_view';
         const log = ctx.call({ methodName: methodKey });
-        log.start(() => ({ onboarding }));
+        log.start(() => ({ onboarding, params }));
         const coder = new AdaptyOnboardingCoder();
-        const data = {
-            method: methodKey,
-            onboarding: coder.encode(onboarding),
-        };
+        const paramsWithDefaults = Object.assign(Object.assign({}, DEFAULT_ONBOARDING_PARAMS), params);
+        const encodedParams = new AdaptyUICreateOnboardingViewParamsCoder().encode(paramsWithDefaults);
+        const data = Object.assign({ method: methodKey, onboarding: coder.encode(onboarding) }, encodedParams);
         const result = (await controller.adaptyPlugin.handleMethodCall(methodKey, JSON.stringify(data), ctx, log));
         controller.id = result.id;
         await controller.setEventHandlers(DEFAULT_ONBOARDING_EVENT_HANDLERS);
@@ -53,32 +63,69 @@ export class OnboardingViewController {
         this.adaptyPlugin = adaptyPlugin;
     }
     /**
-     * Presents an onboarding view as a full-screen modal
+     * Presents the onboarding view as a modal screen.
      *
      * @remarks
-     * Calling `present` upon already visible onboarding view
-     * would result in an error
+     * Calling `present` on an already visible onboarding view will result in an error.
+     * The onboarding will be displayed with the configured presentation style on iOS.
+     * On Android, the onboarding is always presented as a full-screen activity.
+     *
+     * @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 onboarding 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, createOnboardingView } from '@adapty/capacitor';
+     *
+     * const onboarding = await adapty.getOnboarding({ placementId: 'YOUR_PLACEMENT_ID' });
+     * const view = await createOnboardingView(onboarding);
+     * await view.present();
+     * ```
      *
-     * @throws {AdaptyError}
+     * @example
+     * Present with page sheet style on iOS
+     * ```typescript
+     * await view.present({ iosPresentationStyle: 'page_sheet' });
+     * ```
      */
-    async present() {
+    async present(options = {}) {
+        var _a;
         const ctx = new LogContext();
         const methodKey = 'adapty_ui_present_onboarding_view';
         const log = ctx.call({ methodName: methodKey });
-        log.start(() => ({ _id: this.id }));
+        log.start(() => ({ _id: this.id, iosPresentationStyle: options.iosPresentationStyle }));
         if (this.id === null) {
             throw new AdaptyError({ adaptyCode: 2002, message: 'No view reference' });
         }
         const data = {
             method: methodKey,
             id: this.id,
+            ios_presentation_style: (_a = options.iosPresentationStyle) !== null && _a !== void 0 ? _a : 'full_screen',
         };
         await this.adaptyPlugin.handleMethodCall(methodKey, JSON.stringify(data), ctx, log);
     }
     /**
-     * Dismisses an onboarding view
+     * Dismisses the onboarding view.
+     *
+     * @remarks
+     * This method closes the onboarding and cleans up associated resources.
+     * After dismissing, the view controller instance cannot be reused.
+     *
+     * @returns A promise that resolves when the onboarding is dismissed.
+     * @throws {@link AdaptyError} if the view reference is invalid.
      *
-     * @throws {AdaptyError}
+     * @example
+     * ```typescript
+     * import { createOnboardingView } from '@adapty/capacitor';
+     *
+     * const view = await createOnboardingView(onboarding);
+     * await view.present();
+     * // ... later
+     * await view.dismiss();
+     * ```
      */
     async dismiss() {
         const ctx = new LogContext();
@@ -94,20 +141,52 @@ export class OnboardingViewController {
             destroy: true,
         };
         await this.adaptyPlugin.handleMethodCall(methodKey, JSON.stringify(data), ctx, log);
+        this.clearEventHandlers();
     }
     /**
-     * Register event handlers for UI events
+     * Registers event handlers for onboarding UI events.
      *
      * @remarks
      * Each event type can have only one handler — new handlers replace existing ones.
-     * Default handlers are registered in {@link OnboardingViewController.create} and provide standard closing behavior:
-     * - `onClose`
+     * Default handlers are registered automatically in {@link createOnboardingView} and provide standard closing behavior:
+     * - `onClose` - closes the onboarding when the close button is pressed or system back is used
      *
+     * If you want to override the `onClose` listener, we strongly recommend returning `true`
+     * from your custom listener to retain default closing behavior.
      *
      * Calling this method multiple times will replace previously registered handlers for provided events.
      *
-     * @param {Partial<OnboardingEventHandlers>} eventHandlers - set of event handling callbacks
-     * @returns {() => void} unsubscribe - function to unsubscribe all listeners
+     * @see {@link https://adapty.io/docs/capacitor-handling-onboarding-events | Handling Onboarding 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 { createOnboardingView } from '@adapty/capacitor';
+     *
+     * const view = await createOnboardingView(onboarding);
+     *
+     * const unsubscribe = await view.setEventHandlers({
+     *   onClose: () => {
+     *     console.log('Onboarding closed');
+     *     // Return true to keep default closing behavior
+     *     return true;
+     *   },
+     *   onActionPerformed: (action) => {
+     *     console.log('Action performed:', action.name);
+     *   },
+     *   onProductSelected: (product) => {
+     *     console.log('Product selected:', product.vendorProductId);
+     *   }
+     * });
+     *
+     * await view.present();
+     *
+     * // Later, unsubscribe all handlers
+     * unsubscribe();
+     * ```
      */
     async setEventHandlers(eventHandlers = {}) {
         var _a;
@@ -146,12 +225,23 @@ export class OnboardingViewController {
         return unsubscribe;
     }
     /**
-     * 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 createOnboardingView(onboarding);
+     * await view.setEventHandlers({ onClose: handleClose });
+     *
+     * // Later, clear all handlers
+     * view.clearEventHandlers();
+     * ```
      */
     clearEventHandlers() {
         Log.info('clearEventHandlers', () => 'Clearing all onboarding event handlers for view', () => ({ id: this.id }));

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

@@ -1 +1 @@
-{"version":3,"file":"onboarding-view-controller.js","sourceRoot":"","sources":["../../../src/ui-builder/onboarding-view-controller.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Adapty } from '../adapty';\nimport { AdaptyError } from '../shared/adapty-error';\nimport { AdaptyOnboardingCoder } from '../shared/coders/adapty-onboarding';\nimport { LogContext, Log } from '../shared/logger';\nimport type { AdaptyOnboarding } from '../shared/types';\nimport type { components } from '../shared/types/api';\nimport { mapValues } from '../shared/utils/map-values';\nimport { withErrorContext } from '../shared/utils/with-error-context';\n\nimport { OnboardingViewEmitter } from './onboarding-view-emitter';\nimport { DEFAULT_ONBOARDING_EVENT_HANDLERS } from './types';\nimport type { AdaptyUiView, OnboardingEventHandlers } from './types';\n\ntype Req = components['requests'];\n\n/**\n * Provides methods to control created onboarding view\n * @public\n */\nexport class OnboardingViewController {\n  private id: string | null = null;\n  private adaptyPlugin: Adapty;\n  private viewEmitter: OnboardingViewEmitter | null = null;\n\n  /**\n   * Intended way to create a OnboardingViewController instance.\n   * It prepares a native controller to be presented\n   * and creates reference between native controller and JS instance\n   * @internal\n   */\n  static async create(onboarding: AdaptyOnboarding, adaptyPlugin: Adapty): Promise<OnboardingViewController> {\n    const controller = new OnboardingViewController(adaptyPlugin);\n\n    const ctx = new LogContext();\n    const methodKey = 'adapty_ui_create_onboarding_view';\n    const log = ctx.call({ methodName: methodKey });\n    log.start(() => ({ onboarding }));\n\n    const coder = new AdaptyOnboardingCoder();\n    const data: Req['AdaptyUICreateOnboardingView.Request'] = {\n      method: methodKey,\n      onboarding: coder.encode(onboarding),\n    };\n\n    const result = (await controller.adaptyPlugin.handleMethodCall(\n      methodKey,\n      JSON.stringify(data),\n      ctx,\n      log,\n    )) as AdaptyUiView;\n    controller.id = result.id;\n\n    await controller.setEventHandlers(DEFAULT_ONBOARDING_EVENT_HANDLERS);\n\n    return controller;\n  }\n\n  /**\n   * Since constructors in JS cannot be async, it is not\n   * preferred to create ViewControllers in direct way.\n   * Consider using @link{OnboardingViewController.create} instead\n   *\n   * @internal\n   */\n  private constructor(adaptyPlugin: Adapty) {\n    this.adaptyPlugin = adaptyPlugin;\n  }\n\n  /**\n   * Presents an onboarding view as a full-screen modal\n   *\n   * @remarks\n   * Calling `present` upon already visible onboarding view\n   * would result in an error\n   *\n   * @throws {AdaptyError}\n   */\n  public async present(): Promise<void> {\n    const ctx = new LogContext();\n    const methodKey = 'adapty_ui_present_onboarding_view';\n    const log = ctx.call({ methodName: methodKey });\n    log.start(() => ({ _id: this.id }));\n\n    if (this.id === null) {\n      throw new AdaptyError({ adaptyCode: 2002, message: 'No view reference' });\n    }\n\n    const data: Req['AdaptyUIPresentOnboardingView.Request'] = {\n      method: methodKey,\n      id: this.id,\n    };\n\n    await this.adaptyPlugin.handleMethodCall(methodKey, JSON.stringify(data), ctx, log);\n  }\n\n  /**\n   * Dismisses an onboarding view\n   *\n   * @throws {AdaptyError}\n   */\n  public async dismiss(): Promise<void> {\n    const ctx = new LogContext();\n    const methodKey = 'adapty_ui_dismiss_onboarding_view';\n    const log = ctx.call({ methodName: methodKey });\n    log.start(() => ({ _id: this.id }));\n\n    if (this.id === null) {\n      throw new AdaptyError({ adaptyCode: 2002, message: 'No view reference' });\n    }\n\n    const data: Req['AdaptyUIDismissOnboardingView.Request'] = {\n      method: methodKey,\n      id: this.id,\n      destroy: true,\n    };\n\n    await this.adaptyPlugin.handleMethodCall(methodKey, JSON.stringify(data), ctx, log);\n  }\n\n  private onRequestClose = async () => {\n    try {\n      await this.dismiss();\n    } catch (error) {\n      Log.warn(\n        'setEventHandlers',\n        () => 'Failed to dismiss onboarding',\n        () => ({ error }),\n      );\n    }\n  };\n\n  /**\n   * Register event handlers for UI events\n   *\n   * @remarks\n   * Each event type can have only one handler — new handlers replace existing ones.\n   * Default handlers are registered in {@link OnboardingViewController.create} and provide standard closing behavior:\n   * - `onClose`\n   *\n   *\n   * Calling this method multiple times will replace previously registered handlers for provided events.\n   *\n   * @param {Partial<OnboardingEventHandlers>} eventHandlers - set of event handling callbacks\n   * @returns {() => void} unsubscribe - function to unsubscribe all listeners\n   */\n  public async setEventHandlers(eventHandlers: Partial<OnboardingEventHandlers> = {}): Promise<() => void> {\n    const ctx = new LogContext();\n    const log = ctx.call({ methodName: 'setEventHandlers' });\n    log.start(() => ({ _id: this.id }));\n\n    if (this.id === null) {\n      throw new AdaptyError({ adaptyCode: 2002, message: 'No view reference' });\n    }\n\n    Log.verbose(\n      'setEventHandlers',\n      () => 'Registering onboarding event handlers for view',\n      () => ({ id: this.id }),\n    );\n\n    const viewEmitter = this.viewEmitter ?? new OnboardingViewEmitter(this.id);\n    this.viewEmitter = viewEmitter;\n\n    const wrappedErrorLogEventHandlers = mapValues(eventHandlers, (handler, eventName) =>\n      handler && typeof handler === 'function'\n        ? withErrorContext(handler, eventName as string, 'OnboardingViewController')\n        : undefined,\n    );\n\n    // Merge with defaults to ensure default behavior is preserved after unsubscribe/resubscribe cycles\n    const finalEventHandlers: Partial<OnboardingEventHandlers> = {\n      ...DEFAULT_ONBOARDING_EVENT_HANDLERS,\n      ...wrappedErrorLogEventHandlers,\n    };\n\n    for (const [eventName, handler] of Object.entries(finalEventHandlers)) {\n      if (handler && typeof handler === 'function') {\n        try {\n          await viewEmitter.addListener(eventName as keyof OnboardingEventHandlers, handler, this.onRequestClose);\n          Log.verbose(\n            'setEventHandlers',\n            () => 'Registered onboarding handler',\n            () => ({ eventName }),\n          );\n        } catch (error) {\n          Log.error(\n            'setEventHandlers',\n            () => `Failed to register onboarding handler for ${eventName}`,\n            () => ({ error }),\n          );\n        }\n      }\n    }\n\n    const unsubscribe = () => {\n      Log.info(\n        'setEventHandlers',\n        () => 'Unsubscribing onboarding event handlers for view',\n        () => ({ id: this.id }),\n      );\n      if (this.viewEmitter) {\n        this.viewEmitter.removeAllListeners();\n        this.viewEmitter = null;\n      }\n    };\n\n    return unsubscribe;\n  }\n\n  /**\n   * Clears all registered event handlers\n   *\n   * @remarks\n   * This method removes all previously registered event handlers.\n   * After calling this method, no event handlers will be active\n   * until you call `setEventHandlers` again.\n   */\n  public clearEventHandlers(): void {\n    Log.info(\n      'clearEventHandlers',\n      () => 'Clearing all onboarding event handlers for view',\n      () => ({ id: this.id }),\n    );\n\n    if (this.viewEmitter) {\n      this.viewEmitter.removeAllListeners();\n      this.viewEmitter = null;\n    }\n  }\n}\n"]}
+{"version":3,"file":"onboarding-view-controller.js","sourceRoot":"","sources":["../../../src/ui-builder/onboarding-view-controller.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Adapty } from '../adapty';\nimport { AdaptyError } from '../shared/adapty-error';\nimport { AdaptyOnboardingCoder } from '../shared/coders/adapty-onboarding';\nimport { AdaptyUICreateOnboardingViewParamsCoder } from '../shared/coders/adapty-ui-create-onboarding-view-params';\nimport { LogContext, Log } from '../shared/logger';\nimport { WebPresentation } from '../shared/types';\nimport type { AdaptyOnboarding } from '../shared/types';\nimport type { components } from '../shared/types/api';\nimport { mapValues } from '../shared/utils/map-values';\nimport { withErrorContext } from '../shared/utils/with-error-context';\n\nimport { OnboardingViewEmitter } from './onboarding-view-emitter';\nimport { DEFAULT_ONBOARDING_EVENT_HANDLERS } from './types';\nimport type {\n  AdaptyUiView,\n  OnboardingEventHandlers,\n  AdaptyIOSPresentationStyle,\n  CreateOnboardingViewParamsInput,\n} from './types';\n\ntype Req = components['requests'];\n\nexport const DEFAULT_ONBOARDING_PARAMS: CreateOnboardingViewParamsInput = {\n  externalUrlsPresentation: WebPresentation.BrowserInApp,\n};\n\n/**\n * Controller for managing onboarding views.\n *\n * @remarks\n * This class provides methods to present, dismiss, and handle events for onboarding views\n * created with the Onboarding Builder. Create instances using the {@link createOnboardingView} function\n * rather than directly constructing this class.\n *\n * @public\n */\nexport class OnboardingViewController {\n  private id: string | null = null;\n  private adaptyPlugin: Adapty;\n  private viewEmitter: OnboardingViewEmitter | null = null;\n\n  /**\n   * Intended way to create a OnboardingViewController instance.\n   * It prepares a native controller to be presented\n   * and creates reference between native controller and JS instance\n   * @internal\n   */\n  static async create(\n    onboarding: AdaptyOnboarding,\n    adaptyPlugin: Adapty,\n    params: CreateOnboardingViewParamsInput = {},\n  ): Promise<OnboardingViewController> {\n    const controller = new OnboardingViewController(adaptyPlugin);\n\n    const ctx = new LogContext();\n    const methodKey = 'adapty_ui_create_onboarding_view';\n    const log = ctx.call({ methodName: methodKey });\n    log.start(() => ({ onboarding, params }));\n\n    const coder = new AdaptyOnboardingCoder();\n    const paramsWithDefaults = { ...DEFAULT_ONBOARDING_PARAMS, ...params };\n    const encodedParams = new AdaptyUICreateOnboardingViewParamsCoder().encode(paramsWithDefaults);\n\n    const data: Req['AdaptyUICreateOnboardingView.Request'] = {\n      method: methodKey,\n      onboarding: coder.encode(onboarding),\n      ...encodedParams,\n    };\n\n    const result = (await controller.adaptyPlugin.handleMethodCall(\n      methodKey,\n      JSON.stringify(data),\n      ctx,\n      log,\n    )) as AdaptyUiView;\n    controller.id = result.id;\n\n    await controller.setEventHandlers(DEFAULT_ONBOARDING_EVENT_HANDLERS);\n\n    return controller;\n  }\n\n  /**\n   * Since constructors in JS cannot be async, it is not\n   * preferred to create ViewControllers in direct way.\n   * Consider using @link{OnboardingViewController.create} instead\n   *\n   * @internal\n   */\n  private constructor(adaptyPlugin: Adapty) {\n    this.adaptyPlugin = adaptyPlugin;\n  }\n\n  /**\n   * Presents the onboarding view as a modal screen.\n   *\n   * @remarks\n   * Calling `present` on an already visible onboarding view will result in an error.\n   * The onboarding will be displayed with the configured presentation style on iOS.\n   * On Android, the onboarding is always presented as a full-screen activity.\n   *\n   * @param options - Optional presentation options\n   * @param options.iosPresentationStyle - iOS presentation style. Available options: `'full_screen'` (default) or `'page_sheet'`. Only affects iOS platform.\n   * @returns A promise that resolves when the onboarding is presented.\n   * @throws {@link AdaptyError} if the view reference is invalid or the view is already presented.\n   *\n   * @example\n   * Present with default full-screen style\n   * ```typescript\n   * import { adapty, createOnboardingView } from '@adapty/capacitor';\n   *\n   * const onboarding = await adapty.getOnboarding({ placementId: 'YOUR_PLACEMENT_ID' });\n   * const view = await createOnboardingView(onboarding);\n   * await view.present();\n   * ```\n   *\n   * @example\n   * Present with page sheet style on iOS\n   * ```typescript\n   * await view.present({ iosPresentationStyle: 'page_sheet' });\n   * ```\n   */\n  public async present(options: { iosPresentationStyle?: AdaptyIOSPresentationStyle } = {}): Promise<void> {\n    const ctx = new LogContext();\n    const methodKey = 'adapty_ui_present_onboarding_view';\n    const log = ctx.call({ methodName: methodKey });\n    log.start(() => ({ _id: this.id, iosPresentationStyle: options.iosPresentationStyle }));\n\n    if (this.id === null) {\n      throw new AdaptyError({ adaptyCode: 2002, message: 'No view reference' });\n    }\n\n    const data: any = {\n      method: methodKey,\n      id: this.id,\n      ios_presentation_style: options.iosPresentationStyle ?? 'full_screen',\n    };\n\n    await this.adaptyPlugin.handleMethodCall(methodKey, JSON.stringify(data), ctx, log);\n  }\n\n  /**\n   * Dismisses the onboarding view.\n   *\n   * @remarks\n   * This method closes the onboarding and cleans up associated resources.\n   * After dismissing, the view controller instance cannot be reused.\n   *\n   * @returns A promise that resolves when the onboarding is dismissed.\n   * @throws {@link AdaptyError} if the view reference is invalid.\n   *\n   * @example\n   * ```typescript\n   * import { createOnboardingView } from '@adapty/capacitor';\n   *\n   * const view = await createOnboardingView(onboarding);\n   * await view.present();\n   * // ... later\n   * await view.dismiss();\n   * ```\n   */\n  public async dismiss(): Promise<void> {\n    const ctx = new LogContext();\n    const methodKey = 'adapty_ui_dismiss_onboarding_view';\n    const log = ctx.call({ methodName: methodKey });\n    log.start(() => ({ _id: this.id }));\n\n    if (this.id === null) {\n      throw new AdaptyError({ adaptyCode: 2002, message: 'No view reference' });\n    }\n\n    const data: Req['AdaptyUIDismissOnboardingView.Request'] = {\n      method: methodKey,\n      id: this.id,\n      destroy: true,\n    };\n\n    await this.adaptyPlugin.handleMethodCall(methodKey, JSON.stringify(data), ctx, log);\n    this.clearEventHandlers();\n  }\n\n  private onRequestClose = async () => {\n    try {\n      await this.dismiss();\n    } catch (error) {\n      Log.warn(\n        'setEventHandlers',\n        () => 'Failed to dismiss onboarding',\n        () => ({ error }),\n      );\n    }\n  };\n\n  /**\n   * Registers event handlers for onboarding UI events.\n   *\n   * @remarks\n   * Each event type can have only one handler — new handlers replace existing ones.\n   * Default handlers are registered automatically in {@link createOnboardingView} and provide standard closing behavior:\n   * - `onClose` - closes the onboarding when the close button is pressed or system back is used\n   *\n   * If you want to override the `onClose` listener, we strongly recommend returning `true`\n   * from your custom listener to retain default closing behavior.\n   *\n   * Calling this method multiple times will replace previously registered handlers for provided events.\n   *\n   * @see {@link https://adapty.io/docs/capacitor-handling-onboarding-events | Handling Onboarding Events}\n   *\n   * @param eventHandlers - Set of event handling callbacks. Only provided handlers will be registered or updated.\n   * @returns A promise that resolves to an unsubscribe function that removes all registered listeners.\n   *\n   * @example\n   * Register custom event handlers\n   * ```typescript\n   * import { createOnboardingView } from '@adapty/capacitor';\n   *\n   * const view = await createOnboardingView(onboarding);\n   *\n   * const unsubscribe = await view.setEventHandlers({\n   *   onClose: () => {\n   *     console.log('Onboarding closed');\n   *     // Return true to keep default closing behavior\n   *     return true;\n   *   },\n   *   onActionPerformed: (action) => {\n   *     console.log('Action performed:', action.name);\n   *   },\n   *   onProductSelected: (product) => {\n   *     console.log('Product selected:', product.vendorProductId);\n   *   }\n   * });\n   *\n   * await view.present();\n   *\n   * // Later, unsubscribe all handlers\n   * unsubscribe();\n   * ```\n   */\n  public async setEventHandlers(eventHandlers: Partial<OnboardingEventHandlers> = {}): Promise<() => void> {\n    const ctx = new LogContext();\n    const log = ctx.call({ methodName: 'setEventHandlers' });\n    log.start(() => ({ _id: this.id }));\n\n    if (this.id === null) {\n      throw new AdaptyError({ adaptyCode: 2002, message: 'No view reference' });\n    }\n\n    Log.verbose(\n      'setEventHandlers',\n      () => 'Registering onboarding event handlers for view',\n      () => ({ id: this.id }),\n    );\n\n    const viewEmitter = this.viewEmitter ?? new OnboardingViewEmitter(this.id);\n    this.viewEmitter = viewEmitter;\n\n    const wrappedErrorLogEventHandlers = mapValues(eventHandlers, (handler, eventName) =>\n      handler && typeof handler === 'function'\n        ? withErrorContext(handler, eventName as string, 'OnboardingViewController')\n        : undefined,\n    );\n\n    // Merge with defaults to ensure default behavior is preserved after unsubscribe/resubscribe cycles\n    const finalEventHandlers: Partial<OnboardingEventHandlers> = {\n      ...DEFAULT_ONBOARDING_EVENT_HANDLERS,\n      ...wrappedErrorLogEventHandlers,\n    };\n\n    for (const [eventName, handler] of Object.entries(finalEventHandlers)) {\n      if (handler && typeof handler === 'function') {\n        try {\n          await viewEmitter.addListener(eventName as keyof OnboardingEventHandlers, handler, this.onRequestClose);\n          Log.verbose(\n            'setEventHandlers',\n            () => 'Registered onboarding handler',\n            () => ({ eventName }),\n          );\n        } catch (error) {\n          Log.error(\n            'setEventHandlers',\n            () => `Failed to register onboarding handler for ${eventName}`,\n            () => ({ error }),\n          );\n        }\n      }\n    }\n\n    const unsubscribe = () => {\n      Log.info(\n        'setEventHandlers',\n        () => 'Unsubscribing onboarding event handlers for view',\n        () => ({ id: this.id }),\n      );\n      if (this.viewEmitter) {\n        this.viewEmitter.removeAllListeners();\n        this.viewEmitter = null;\n      }\n    };\n\n    return unsubscribe;\n  }\n\n  /**\n   * Clears all registered event handlers.\n   *\n   * @remarks\n   * This method removes all previously registered event handlers.\n   * After calling this method, no event handlers will be active\n   * until you call {@link setEventHandlers} again.\n   *\n   * Use this after dismiss to remove all event handlers.\n   *\n   * @example\n   * ```typescript\n   * const view = await createOnboardingView(onboarding);\n   * await view.setEventHandlers({ onClose: handleClose });\n   *\n   * // Later, clear all handlers\n   * view.clearEventHandlers();\n   * ```\n   */\n  public clearEventHandlers(): void {\n    Log.info(\n      'clearEventHandlers',\n      () => 'Clearing all onboarding event handlers for view',\n      () => ({ id: this.id }),\n    );\n\n    if (this.viewEmitter) {\n      this.viewEmitter.removeAllListeners();\n      this.viewEmitter = null;\n    }\n  }\n}\n"]}

package/dist/esm/ui-builder/onboarding-view-emitter.d.ts

@@ -1,32 +1,18 @@
 import type { LogContext } from '../shared/logger';
-import type { AdaptyError } from '../shared/types/method-types';
-import { BaseViewEmitter, type BaseEventConfig } from './base-view-emitter';
-import type { AdaptyUiOnboardingMeta, OnboardingEventHandlers, OnboardingStateUpdatedAction } from './types';
-interface OnboardingEventData {
-    id?: string;
-    meta?: AdaptyUiOnboardingMeta;
-    event?: {
-        name: string;
-        element_id?: string;
-        reply?: string;
-    };
-    action?: OnboardingStateUpdatedAction;
-    error?: AdaptyError;
-    view?: {
-        id: string;
-    };
-}
+import type { OnboardingEventIdType, ParsedOnboardingEvent } from '../shared/types/onboarding-events';
+import { BaseViewEmitter } from './base-view-emitter';
+import type { OnboardingEventHandlers } from './types';
+type OnboardingNativeEvent = OnboardingEventIdType;
 /**
  * OnboardingViewEmitter manages event handlers for onboarding view events.
  * Each event type can have only one handler - new handlers replace existing ones.
  */
-export declare class OnboardingViewEmitter extends BaseViewEmitter<OnboardingEventHandlers, OnboardingEventData> {
-    protected getEventConfig(event: keyof OnboardingEventHandlers): BaseEventConfig | undefined;
-    protected parseEventData(rawEventData: string, ctx: LogContext): OnboardingEventData;
-    protected getPossibleHandlers(nativeEvent: string): (keyof OnboardingEventHandlers)[];
-    protected extractCallbackArgs(handlerName: keyof OnboardingEventHandlers, eventData: OnboardingEventData): unknown[];
-    protected getEventViewId(eventData: OnboardingEventData): string | null;
-    protected shouldCallHandler(): boolean;
+export declare class OnboardingViewEmitter extends BaseViewEmitter<OnboardingEventHandlers, ParsedOnboardingEvent, OnboardingNativeEvent> {
+    protected parseEventData(rawEventData: string, ctx: LogContext): ParsedOnboardingEvent;
+    protected getNativeEventForHandler(event: keyof OnboardingEventHandlers): OnboardingNativeEvent | null;
+    protected getHandlerForNativeEvent(nativeEvent: OnboardingNativeEvent): keyof OnboardingEventHandlers | null;
+    protected extractCallbackArgs(handlerName: keyof OnboardingEventHandlers, eventData: ParsedOnboardingEvent): unknown[];
+    protected getEventViewId(eventData: ParsedOnboardingEvent): string | null;
     protected getEmitterName(): string;
 }
 export {};