@adapty/capacitor 3.17.0 → 4.0.0-beta.1

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 { AdaptyError } from '@adapty/core';\n\nimport type { Adapty } from '../adapty';\nimport { coderFactory } from '../coders/factory';\nimport { LogContext, Log } from '../logger';\nimport { WebPresentation } from '../types';\nimport type { AdaptyOnboarding } from '../types';\nimport type { components } from '../types/api';\nimport { mapValues, withErrorContext } from '../utils';\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 = coderFactory.createOnboardingCoder();\n    const paramsWithDefaults = { ...DEFAULT_ONBOARDING_PARAMS, ...params };\n    const encodedParams = coderFactory.createUiCreateOnboardingViewParamsCoder().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"]}
+{"version":3,"file":"onboarding-view-controller.js","sourceRoot":"","sources":["../../../src/ui-builder/onboarding-view-controller.ts"],"names":[],"mappings":"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","sourcesContent":["import { AdaptyError } from '@adapty/core';\n\nimport type { Adapty } from '../adapty';\nimport { coderFactory } from '../coders/factory';\nimport { LogContext, Log } from '../logger';\nimport { WebPresentation } from '../types';\nimport type { AdaptyOnboarding } from '../types';\nimport type { components } from '../types/api';\nimport { mapValues, withErrorContext } from '../utils';\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 * @deprecated Since 4.0.0. Migrate onboardings to the Flow Builder API.\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 = coderFactory.createOnboardingCoder();\n    const paramsWithDefaults = { ...DEFAULT_ONBOARDING_PARAMS, ...params };\n    const encodedParams = coderFactory.createUiCreateOnboardingViewParamsCoder().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   *   onCustom: (actionId, meta) => {\n   *     console.log('Custom action:', actionId, meta);\n   *   },\n   *   onStateUpdated: (action, meta) => {\n   *     console.log('State updated:', action, meta);\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/types.d.ts

@@ -1,363 +1,16 @@
-import type { AdaptyError } from '@adapty/core';
-import type { AdaptyPaywallProduct, AdaptyProductIdentifier, AdaptyProfile, AdaptyPurchaseResult, WebPresentation } from '../types';
-import type { FileLocation, MakePurchaseParamsInput } from '../types/inputs';
-/**
- * @internal
- */
-export type ArgType<T> = T extends () => any ? void : T extends (arg: infer U) => any ? U : void;
-/**
- * EventHandler callback should not return a promise,
- * because using `await` may postpone closing a paywall view.
- *
- * We don't want to block the UI thread.
- */
-export type EventHandlerResult = boolean | void;
-/**
- * Purchase parameters keyed by AdaptyProductIdentifier objects
- */
-export type ProductPurchaseParams = {
-    productId: AdaptyProductIdentifier;
-    params: MakePurchaseParamsInput;
-}[];
-export type AdaptyCustomAsset = AdaptyCustomImageAsset | AdaptyCustomVideoAsset | AdaptyCustomColorAsset | AdaptyCustomGradientAsset;
-export type AdaptyCustomImageAsset = {
-    type: 'image';
-    base64: string;
-} | {
-    type: 'image';
-    relativeAssetPath: string;
-} | {
-    type: 'image';
-    fileLocation: FileLocation;
-};
-export type AdaptyCustomVideoAsset = {
-    type: 'video';
-    relativeAssetPath: string;
-} | {
-    type: 'video';
-    fileLocation: FileLocation;
-};
-export type AdaptyCustomColorAsset = {
-    type: 'color';
-    argb: number;
-} | {
-    type: 'color';
-    rgb: number;
-} | {
-    type: 'color';
-    rgba: number;
-};
-export type AdaptyCustomGradientAsset = {
-    type: 'linear-gradient';
-    values: ({
-        p: number;
-        argb: number;
-    } | {
-        p: number;
-        rgb: number;
-    } | {
-        p: number;
-        rgba: number;
-    })[];
-    points?: {
-        x0?: number;
-        y0?: number;
-        x1?: number;
-        y1?: number;
-    };
-};
-export type AdaptyUiOnboardingMeta = {
-    onboardingId: string;
-    screenClientId: string;
-    screenIndex: number;
-    totalScreens: number;
-};
-export type AdaptyUiOnboardingStateParams = {
-    id: string;
-    value: string;
-    label: string;
-};
-/**
- * Paywall event handlers configuration
+import type { FlowEventHandlers, OnboardingEventHandlers } from '@adapty/core';
+export type { EventHandlerResult, ProductPurchaseParams, FlowEventHandlers, OnboardingEventHandlers, OnboardingAnalyticsEventName, AdaptyUiOnboardingMeta, AdaptyUiOnboardingStateParams, OnboardingStateUpdatedAction, FlowPermissionResponse, FlowPermissionStatus, AdaptyPermission, CreateFlowViewParamsInput, CreateOnboardingViewParamsInput, AdaptyUiView, AdaptyUiMediaCache, AdaptyUiDialogConfig, AdaptyCustomAsset, AdaptyCustomImageAsset, AdaptyCustomVideoAsset, AdaptyCustomColorAsset, AdaptyCustomGradientAsset, AdaptyIOSPresentationStyle, } from '@adapty/core';
+export { AdaptyUiDialogActionType } from '@adapty/core';
+/**
+ * Default flow-view event handlers. Mirrors react-native-adapty v4 defaults:
+ * most handlers keep the view open (return false); onCloseButtonPress and
+ * onError close it (return true). onUrlPress / onRequestAppReview delegate to
+ * the native handler methods.
  *
- * @see {@link https://adapty.io/docs/capacitor-handling-events | [DOC] Handling View Events}
- */
-export interface EventHandlers {
-    /**
-     * Called when a user taps the close button on the paywall view
-     *
-     * If you return `true`, the paywall view will be closed.
-     * We strongly recommend to return `true` in this case.
-     * @default true
-     */
-    onCloseButtonPress: () => EventHandlerResult;
-    /**
-     * Called when a user navigates back on Android
-     *
-     * If you return `true`, the paywall view will be closed.
-     * We strongly recommend to return `true` in this case.
-     * @default true
-     */
-    onAndroidSystemBack: () => EventHandlerResult;
-    /**
-     * Called when a user taps an URL in the paywall view.
-     *
-     * If you return `true`, the paywall view will be closed.
-     * @default false
-     *
-     * The default onUrlPress handler does not support `browser_in_app`.
-     * To support it, install an in-app browser plugin (e.g. `@capacitor/inappbrowser`)
-     * and handle the `openIn` argument in your own custom onUrlPress handler.
-     *
-     * @param url - URL to open
-     * @param openIn - How the URL was configured to open in the dashboard:
-     *                 `'browser_in_app'` — in-app browser
-     *                 `'browser_out_app'` — external/system browser
-     */
-    onUrlPress: (url: string, openIn: WebPresentation) => EventHandlerResult;
-    /**
-     * Called when a user performs a custom action in the paywall view
-     *
-     * If you return `true`, the paywall view will be closed.
-     * @default false
-     */
-    onCustomAction: (actionId: string) => EventHandlerResult;
-    /**
-     * Called when a user selects a product in the paywall view
-     *
-     * If you return `true` from this callback, the paywall view will be closed.
-     * @default false
-     */
-    onProductSelected: (productId: string) => EventHandlerResult;
-    /**
-     * Called when a purchase process starts
-     *
-     * If you return `true` from this callback, the paywall view will be closed.
-     * @default false
-     */
-    onPurchaseStarted: (product: AdaptyPaywallProduct) => EventHandlerResult;
-    /**
-     * Called when the purchase succeeds, the user cancels their purchase, or the purchase appears to be pending
-     *
-     * If you return `true` from this callback, the paywall view will be closed.
-     * We strongly recommend returning `purchaseResult.type !== 'user_cancelled'` in this case.
-     * @default `purchaseResult.type !== 'user_cancelled'`
-     *
-     * @param purchaseResult - object, which provides details about the purchase.
-     * If the result is `'success'`, it also includes the updated user's profile.
-     */
-    onPurchaseCompleted: (purchaseResult: AdaptyPurchaseResult, product: AdaptyPaywallProduct) => EventHandlerResult;
-    /**
-     * Called if a purchase fails after a user taps the purchase button
-     *
-     * If you return `true` from this callback, the paywall view will be closed.
-     * @default false
-     *
-     * @param error - AdaptyError object with error code and message
-     */
-    onPurchaseFailed: (error: AdaptyError, product: AdaptyPaywallProduct) => EventHandlerResult;
-    /**
-     * Called when a user taps the restore button in the paywall view
-     *
-     * If you return `true` from this callback, the paywall view will be closed.
-     * @default false
-     */
-    onRestoreStarted: () => EventHandlerResult;
-    /**
-     * Called when a purchase is completed
-     *
-     * If you return `true` from this callback, the paywall view will be closed.
-     * We strongly recommend to return `true` in this case.
-     * @default true
-     *
-     * @param profile - updated user profile
-     */
-    onRestoreCompleted: (profile: AdaptyProfile) => EventHandlerResult;
-    /**
-     * Called if a restore fails after a user taps the restore button
-     *
-     * If you return `true` from this callback, the paywall view will be closed.
-     * @default false
-     *
-     * @param error - AdaptyError object with error code and message
-     */
-    onRestoreFailed: (error: AdaptyError) => EventHandlerResult;
-    /**
-     * Called when the paywall view appears
-     *
-     * If you return `true`, the paywall view will be closed.
-     * @default false
-     */
-    onAppeared: () => EventHandlerResult;
-    /**
-     * Called when the paywall view disappears
-     *
-     * If you return `true`, the paywall view will be closed.
-     * @default false
-     */
-    onDisappeared: () => EventHandlerResult;
-    /**
-     * Called if a paywall view fails to render.
-     * This should not ever happen, but if it does, feel free to report it to us.
-     *
-     * If you return `true` from this callback, the paywall view will be closed.
-     * @default true
-     *
-     * @param error - AdaptyError object with error code and message
-     */
-    onRenderingFailed: (error: AdaptyError) => EventHandlerResult;
-    /**
-     * Called if a product list fails to load on a presented view,
-     * for example, if there is no internet connection
-     *
-     * If you return `true` from this callback, the paywall view will be closed.
-     * @default false
-     *
-     * @param error - AdaptyError object with error code and message
-     */
-    onLoadingProductsFailed: (error: AdaptyError) => EventHandlerResult;
-    /**
-     * Called when web payment navigation finishes
-     *
-     * If you return `true`, the paywall view will be closed.
-     * @default false
-     */
-    onWebPaymentNavigationFinished: (product?: AdaptyPaywallProduct, error?: AdaptyError) => EventHandlerResult;
-}
-/**
- * Default event handlers that provide standard closing behavior
- */
-export declare const DEFAULT_EVENT_HANDLERS: EventHandlers;
-export type OnboardingStateUpdatedAction = {
-    elementId: string;
-    elementType: 'select';
-    value: AdaptyUiOnboardingStateParams;
-} | {
-    elementId: string;
-    elementType: 'multi_select';
-    value: AdaptyUiOnboardingStateParams[];
-} | {
-    elementId: string;
-    elementType: 'input';
-    value: {
-        type: 'text' | 'email';
-        value: string;
-    } | {
-        type: 'number';
-        value: number;
-    };
-} | {
-    elementId: string;
-    elementType: 'date_picker';
-    value: {
-        day?: number;
-        month?: number;
-        year?: number;
-    };
-};
-export interface AdaptyUiView {
-    id: string;
-}
-export interface AdaptyUiMediaCache {
-    memoryStorageTotalCostLimit?: number;
-    memoryStorageCountLimit?: number;
-    diskStorageSizeLimit?: number;
-}
-export interface AdaptyUiDialogConfig {
-    /**
-     * The action title to display as part of the dialog. If you provide two actions,
-     * be sure `primaryAction` cancels the operation and leaves things unchanged.
-     */
-    primaryActionTitle: string;
-    /**
-     * The secondary action title to display as part of the dialog.
-     */
-    secondaryActionTitle?: string;
-    /**
-     * The title of the dialog.
-     */
-    title?: string;
-    /**
-     * Descriptive text that provides additional details about the reason for the dialog.
-     */
-    content?: string;
-}
-export declare const AdaptyUiDialogActionType: Readonly<{
-    primary: "primary";
-    secondary: "secondary";
-}>;
-export type AdaptyUiDialogActionType = (typeof AdaptyUiDialogActionType)[keyof typeof AdaptyUiDialogActionType];
-/**
- * Additional options for creating a paywall view
- *
- * @see {@link https://adapty.io/docs/capacitor-present-paywalls | [DOC] Creating Paywall View}
+ * @internal
  */
-export interface CreatePaywallViewParamsInput {
-    /**
-     * `true` if you want to prefetch products before presenting a paywall view.
-     */
-    prefetchProducts?: boolean;
-    /**
-     * This value limits the timeout (in milliseconds) for this method.
-     */
-    loadTimeoutMs?: number;
-    /**
-     * If you are going to use custom tags functionality, pass an object with tags and corresponding replacement values
-     *
-     * ```
-     * {
-     *   'USERNAME': 'Bruce',
-     *   'CITY': 'Philadelphia'
-     * }
-     * ```
-     */
-    customTags?: Record<string, string>;
-    /**
-     * If you are going to use custom timer functionality, pass an object with timer ids and corresponding dates the timers should end at
-     */
-    customTimers?: Record<string, Date>;
-    /**
-     * Use this when you need to override paywall assets with your own
-     */
-    customAssets?: Record<string, AdaptyCustomAsset>;
-    /**
-     * Provide per-product purchase parameters keyed by Adapty product identifier
-     */
-    productPurchaseParams?: ProductPurchaseParams;
-}
+export declare const DEFAULT_FLOW_EVENT_HANDLERS: FlowEventHandlers;
 /**
- * Additional options for creating an onboarding view
- *
- * @see {@link https://adapty.io/docs/capacitor-get-onboardings | [DOC] Creating Onboarding View}
+ * @internal
  */
-export interface CreateOnboardingViewParamsInput {
-    /**
-     * If you want to change the presentation behavior of external URLs, pass a preferred value.
-     *
-     * @default {@link WebPresentation.BrowserInApp}
-     */
-    externalUrlsPresentation?: WebPresentation;
-}
-export interface OnboardingEventHandlers {
-    onClose: (actionId: string, meta: AdaptyUiOnboardingMeta) => EventHandlerResult;
-    onCustom: (actionId: string, meta: AdaptyUiOnboardingMeta) => EventHandlerResult;
-    onPaywall: (actionId: string, meta: AdaptyUiOnboardingMeta) => EventHandlerResult;
-    onStateUpdated: (action: OnboardingStateUpdatedAction, meta: AdaptyUiOnboardingMeta) => EventHandlerResult;
-    onFinishedLoading: (meta: AdaptyUiOnboardingMeta) => EventHandlerResult;
-    onAnalytics: (event: {
-        name: string;
-        /**
-         * @deprecated Use `elementId` instead
-         */
-        element_id?: string;
-        elementId?: string;
-        reply?: string;
-    }, meta: AdaptyUiOnboardingMeta) => EventHandlerResult;
-    onError: (error: AdaptyError) => EventHandlerResult;
-}
 export declare const DEFAULT_ONBOARDING_EVENT_HANDLERS: Partial<OnboardingEventHandlers>;
-/**
- * iOS presentation style for paywall and onboarding views
- * @platform ios
- */
-export type AdaptyIOSPresentationStyle = 'full_screen' | 'page_sheet';

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

@@ -1,42 +1,72 @@
+import { adapty } from '../adapty-instance';
 import { Log } from '../logger';
+export { AdaptyUiDialogActionType } from '@adapty/core';
 /**
- * Default event handlers that provide standard closing behavior
+ * Default flow-view event handlers. Mirrors react-native-adapty v4 defaults:
+ * most handlers keep the view open (return false); onCloseButtonPress and
+ * onError close it (return true). onUrlPress / onRequestAppReview delegate to
+ * the native handler methods.
+ *
+ * @internal
  */
-export const DEFAULT_EVENT_HANDLERS = {
+export const DEFAULT_FLOW_EVENT_HANDLERS = {
     onCloseButtonPress: () => true,
-    onAndroidSystemBack: () => true,
+    onAndroidSystemBack: () => false,
+    // Delegate to the handler method, which opens the URL natively honoring
+    // `open_in` (`browser_out_app` → external browser, `browser_in_app` → in-app
+    // browser). Override this handler to open URLs yourself instead.
     onUrlPress: (url, openIn) => {
-        if (openIn === 'browser_in_app') {
-            Log.warn('onUrlPress', () => 'open_in=browser_in_app is not supported by the default onUrlPress handler. Override onUrlPress to support an in-app browser.');
-        }
-        if (typeof window !== 'undefined') {
-            try {
-                window.open(new URL(url), '_blank');
-            }
-            catch (_a) {
-                Log.warn('onUrlPress', () => `Invalid URL: ${url}`);
-            }
-        }
-        return false;
+        adapty
+            .openWebUrl({ url, openIn })
+            .catch((error) => Log.warn('onUrlPress', () => `Failed to open url via native: ${error}`));
+        return false; // Keep flow view open
     },
     onCustomAction: () => false,
     onProductSelected: () => false,
     onPurchaseStarted: () => false,
-    onPurchaseCompleted: (purchaseResult) => (purchaseResult === null || purchaseResult === void 0 ? void 0 : purchaseResult.type) !== 'user_cancelled',
+    onPurchaseCompleted: () => false,
     onPurchaseFailed: () => false,
     onRestoreStarted: () => false,
-    onRestoreCompleted: () => true,
+    onRestoreCompleted: () => false,
     onRestoreFailed: () => false,
     onAppeared: () => false,
     onDisappeared: () => false,
-    onRenderingFailed: () => true,
+    onError: () => true,
     onLoadingProductsFailed: () => false,
     onWebPaymentNavigationFinished: () => false,
+    // Delegate to the handler method, which shows the platform app-review prompt
+    // natively (`SKStoreReviewController` on iOS, In-App Review on Android).
+    // Override this handler to control the prompt yourself instead.
+    onRequestAppReview: () => {
+        void adapty
+            .requestAppReview()
+            .catch((error) => Log.warn('onRequestAppReview', () => `Failed to request app review via native: ${error}`));
+        return false; // Keep flow view open
+    },
+    onAnalytics: () => false,
+    // There is no real default here: permissions must be declared in the app
+    // bundle by the developer, so we cannot grant them on the user's behalf. Warn
+    // and reply `denied` so native always gets a correlated answer.
+    onRequestPermission: async () => {
+        Log.warn('onRequestPermission', () => 'No onRequestPermission handler provided; replying `denied`. Declare the required ' +
+            'permissions in your app and provide an onRequestPermission handler to respond.');
+        return { status: 'denied' };
+    },
+    // Observer mode: no real default. If you enable observer mode and present a
+    // flow view, you must drive the purchase/restore yourself, so warn when no
+    // handler is provided.
+    onObserverPurchaseInitiated: () => {
+        Log.warn('onObserverPurchaseInitiated', () => 'No onObserverPurchaseInitiated handler provided. In observer mode you must drive the purchase yourself; provide this handler to do so.');
+        return false;
+    },
+    onObserverRestoreInitiated: () => {
+        Log.warn('onObserverRestoreInitiated', () => 'No onObserverRestoreInitiated handler provided. In observer mode you must drive the restore yourself; provide this handler to do so.');
+        return false;
+    },
 };
-export const AdaptyUiDialogActionType = Object.freeze({
-    primary: 'primary',
-    secondary: 'secondary',
-});
+/**
+ * @internal
+ */
 export const DEFAULT_ONBOARDING_EVENT_HANDLERS = {
     onClose: () => true,
 };

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

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/ui-builder/types.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AA0NhC;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAkB;IACnD,kBAAkB,EAAE,GAAG,EAAE,CAAC,IAAI;IAC9B,mBAAmB,EAAE,GAAG,EAAE,CAAC,IAAI;IAC/B,UAAU,EAAE,CAAC,GAAW,EAAE,MAAuB,EAAE,EAAE;QACnD,IAAI,MAAM,KAAK,gBAAgB,EAAE,CAAC;YAChC,GAAG,CAAC,IAAI,CACN,YAAY,EACZ,GAAG,EAAE,CACH,8HAA8H,CACjI,CAAC;QACJ,CAAC;QACD,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;YAClC,IAAI,CAAC;gBACH,MAAM,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;YACtC,CAAC;YAAC,WAAM,CAAC;gBACP,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,gBAAgB,GAAG,EAAE,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,cAAc,EAAE,GAAG,EAAE,CAAC,KAAK;IAC3B,iBAAiB,EAAE,GAAG,EAAE,CAAC,KAAK;IAC9B,iBAAiB,EAAE,GAAG,EAAE,CAAC,KAAK;IAC9B,mBAAmB,EAAE,CAAC,cAAoC,EAAE,EAAE,CAAC,CAAA,cAAc,aAAd,cAAc,uBAAd,cAAc,CAAE,IAAI,MAAK,gBAAgB;IACxG,gBAAgB,EAAE,GAAG,EAAE,CAAC,KAAK;IAC7B,gBAAgB,EAAE,GAAG,EAAE,CAAC,KAAK;IAC7B,kBAAkB,EAAE,GAAG,EAAE,CAAC,IAAI;IAC9B,eAAe,EAAE,GAAG,EAAE,CAAC,KAAK;IAC5B,UAAU,EAAE,GAAG,EAAE,CAAC,KAAK;IACvB,aAAa,EAAE,GAAG,EAAE,CAAC,KAAK;IAC1B,iBAAiB,EAAE,GAAG,EAAE,CAAC,IAAI;IAC7B,uBAAuB,EAAE,GAAG,EAAE,CAAC,KAAK;IACpC,8BAA8B,EAAE,GAAG,EAAE,CAAC,KAAK;CAC5C,CAAC;AA0DF,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC,MAAM,CAAC;IACpD,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;CACvB,CAAC,CAAC;AA8EH,MAAM,CAAC,MAAM,iCAAiC,GAAqC;IACjF,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI;CACpB,CAAC","sourcesContent":["import type { AdaptyError } from '@adapty/core';\n\nimport { Log } from '../logger';\nimport type {\n  AdaptyPaywallProduct,\n  AdaptyProductIdentifier,\n  AdaptyProfile,\n  AdaptyPurchaseResult,\n  WebPresentation,\n} from '../types';\nimport type { FileLocation, MakePurchaseParamsInput } from '../types/inputs';\n\n/**\n * @internal\n */\nexport type ArgType<T> = T extends () => any ? void : T extends (arg: infer U) => any ? U : void;\n\n/**\n * EventHandler callback should not return a promise,\n * because using `await` may postpone closing a paywall view.\n *\n * We don't want to block the UI thread.\n */\nexport type EventHandlerResult = boolean | void;\n\n/**\n * Purchase parameters keyed by AdaptyProductIdentifier objects\n */\nexport type ProductPurchaseParams = {\n  productId: AdaptyProductIdentifier;\n  params: MakePurchaseParamsInput;\n}[];\n\nexport type AdaptyCustomAsset =\n  | AdaptyCustomImageAsset\n  | AdaptyCustomVideoAsset\n  | AdaptyCustomColorAsset\n  | AdaptyCustomGradientAsset;\n\nexport type AdaptyCustomImageAsset =\n  | { type: 'image'; base64: string }\n  | { type: 'image'; relativeAssetPath: string } // shorthand: uses same path for both iOS fileName and Android relativeAssetPath\n  | { type: 'image'; fileLocation: FileLocation }; // full control for platform-specific paths\n\nexport type AdaptyCustomVideoAsset =\n  | { type: 'video'; relativeAssetPath: string } // shorthand: uses same path for both iOS fileName and Android relativeAssetPath\n  | { type: 'video'; fileLocation: FileLocation }; // full control for platform-specific paths\n\nexport type AdaptyCustomColorAsset =\n  | { type: 'color'; argb: number /* e.g. 0xFFFF0000 (opaque red) */ }\n  | { type: 'color'; rgb: number /* e.g. 0xFF0000 (red) */ }\n  | { type: 'color'; rgba: number /* e.g. 0xFF0000FF (opaque red) */ };\n\nexport type AdaptyCustomGradientAsset = {\n  type: 'linear-gradient';\n  values: ({ p: number; argb: number } | { p: number; rgb: number } | { p: number; rgba: number })[];\n  points?: { x0?: number; y0?: number; x1?: number; y1?: number };\n};\n\nexport type AdaptyUiOnboardingMeta = {\n  onboardingId: string;\n  screenClientId: string;\n  screenIndex: number;\n  totalScreens: number;\n};\n\nexport type AdaptyUiOnboardingStateParams = {\n  id: string;\n  value: string;\n  label: string;\n};\n\n/**\n * Paywall event handlers configuration\n *\n * @see {@link https://adapty.io/docs/capacitor-handling-events | [DOC] Handling View Events}\n */\nexport interface EventHandlers {\n  /**\n   * Called when a user taps the close button on the paywall view\n   *\n   * If you return `true`, the paywall view will be closed.\n   * We strongly recommend to return `true` in this case.\n   * @default true\n   */\n  onCloseButtonPress: () => EventHandlerResult;\n  /**\n   * Called when a user navigates back on Android\n   *\n   * If you return `true`, the paywall view will be closed.\n   * We strongly recommend to return `true` in this case.\n   * @default true\n   */\n  onAndroidSystemBack: () => EventHandlerResult;\n  /**\n   * Called when a user taps an URL in the paywall view.\n   *\n   * If you return `true`, the paywall view will be closed.\n   * @default false\n   *\n   * The default onUrlPress handler does not support `browser_in_app`.\n   * To support it, install an in-app browser plugin (e.g. `@capacitor/inappbrowser`)\n   * and handle the `openIn` argument in your own custom onUrlPress handler.\n   *\n   * @param url - URL to open\n   * @param openIn - How the URL was configured to open in the dashboard:\n   *                 `'browser_in_app'` — in-app browser\n   *                 `'browser_out_app'` — external/system browser\n   */\n  onUrlPress: (url: string, openIn: WebPresentation) => EventHandlerResult;\n  /**\n   * Called when a user performs a custom action in the paywall view\n   *\n   * If you return `true`, the paywall view will be closed.\n   * @default false\n   */\n  onCustomAction: (actionId: string) => EventHandlerResult;\n  /**\n   * Called when a user selects a product in the paywall view\n   *\n   * If you return `true` from this callback, the paywall view will be closed.\n   * @default false\n   */\n  onProductSelected: (productId: string) => EventHandlerResult;\n  /**\n   * Called when a purchase process starts\n   *\n   * If you return `true` from this callback, the paywall view will be closed.\n   * @default false\n   */\n  onPurchaseStarted: (product: AdaptyPaywallProduct) => EventHandlerResult;\n  /**\n   * Called when the purchase succeeds, the user cancels their purchase, or the purchase appears to be pending\n   *\n   * If you return `true` from this callback, the paywall view will be closed.\n   * We strongly recommend returning `purchaseResult.type !== 'user_cancelled'` in this case.\n   * @default `purchaseResult.type !== 'user_cancelled'`\n   *\n   * @param purchaseResult - object, which provides details about the purchase.\n   * If the result is `'success'`, it also includes the updated user's profile.\n   */\n  onPurchaseCompleted: (purchaseResult: AdaptyPurchaseResult, product: AdaptyPaywallProduct) => EventHandlerResult;\n  /**\n   * Called if a purchase fails after a user taps the purchase button\n   *\n   * If you return `true` from this callback, the paywall view will be closed.\n   * @default false\n   *\n   * @param error - AdaptyError object with error code and message\n   */\n  onPurchaseFailed: (error: AdaptyError, product: AdaptyPaywallProduct) => EventHandlerResult;\n  /**\n   * Called when a user taps the restore button in the paywall view\n   *\n   * If you return `true` from this callback, the paywall view will be closed.\n   * @default false\n   */\n  onRestoreStarted: () => EventHandlerResult;\n  /**\n   * Called when a purchase is completed\n   *\n   * If you return `true` from this callback, the paywall view will be closed.\n   * We strongly recommend to return `true` in this case.\n   * @default true\n   *\n   * @param profile - updated user profile\n   */\n  onRestoreCompleted: (profile: AdaptyProfile) => EventHandlerResult;\n  /**\n   * Called if a restore fails after a user taps the restore button\n   *\n   * If you return `true` from this callback, the paywall view will be closed.\n   * @default false\n   *\n   * @param error - AdaptyError object with error code and message\n   */\n  onRestoreFailed: (error: AdaptyError) => EventHandlerResult;\n  /**\n   * Called when the paywall view appears\n   *\n   * If you return `true`, the paywall view will be closed.\n   * @default false\n   */\n  onAppeared: () => EventHandlerResult;\n  /**\n   * Called when the paywall view disappears\n   *\n   * If you return `true`, the paywall view will be closed.\n   * @default false\n   */\n  onDisappeared: () => EventHandlerResult;\n  /**\n   * Called if a paywall view fails to render.\n   * This should not ever happen, but if it does, feel free to report it to us.\n   *\n   * If you return `true` from this callback, the paywall view will be closed.\n   * @default true\n   *\n   * @param error - AdaptyError object with error code and message\n   */\n  onRenderingFailed: (error: AdaptyError) => EventHandlerResult;\n  /**\n   * Called if a product list fails to load on a presented view,\n   * for example, if there is no internet connection\n   *\n   * If you return `true` from this callback, the paywall view will be closed.\n   * @default false\n   *\n   * @param error - AdaptyError object with error code and message\n   */\n  onLoadingProductsFailed: (error: AdaptyError) => EventHandlerResult;\n  /**\n   * Called when web payment navigation finishes\n   *\n   * If you return `true`, the paywall view will be closed.\n   * @default false\n   */\n  onWebPaymentNavigationFinished: (product?: AdaptyPaywallProduct, error?: AdaptyError) => EventHandlerResult;\n}\n\n/**\n * Default event handlers that provide standard closing behavior\n */\nexport const DEFAULT_EVENT_HANDLERS: EventHandlers = {\n  onCloseButtonPress: () => true,\n  onAndroidSystemBack: () => true,\n  onUrlPress: (url: string, openIn: WebPresentation) => {\n    if (openIn === 'browser_in_app') {\n      Log.warn(\n        'onUrlPress',\n        () =>\n          'open_in=browser_in_app is not supported by the default onUrlPress handler. Override onUrlPress to support an in-app browser.',\n      );\n    }\n    if (typeof window !== 'undefined') {\n      try {\n        window.open(new URL(url), '_blank');\n      } catch {\n        Log.warn('onUrlPress', () => `Invalid URL: ${url}`);\n      }\n    }\n    return false;\n  },\n  onCustomAction: () => false,\n  onProductSelected: () => false,\n  onPurchaseStarted: () => false,\n  onPurchaseCompleted: (purchaseResult: AdaptyPurchaseResult) => purchaseResult?.type !== 'user_cancelled',\n  onPurchaseFailed: () => false,\n  onRestoreStarted: () => false,\n  onRestoreCompleted: () => true,\n  onRestoreFailed: () => false,\n  onAppeared: () => false,\n  onDisappeared: () => false,\n  onRenderingFailed: () => true,\n  onLoadingProductsFailed: () => false,\n  onWebPaymentNavigationFinished: () => false,\n};\n\nexport type OnboardingStateUpdatedAction =\n  | {\n      elementId: string;\n      elementType: 'select';\n      value: AdaptyUiOnboardingStateParams;\n    }\n  | {\n      elementId: string;\n      elementType: 'multi_select';\n      value: AdaptyUiOnboardingStateParams[];\n    }\n  | {\n      elementId: string;\n      elementType: 'input';\n      value: { type: 'text' | 'email'; value: string } | { type: 'number'; value: number };\n    }\n  | {\n      elementId: string;\n      elementType: 'date_picker';\n      value: {\n        day?: number;\n        month?: number;\n        year?: number;\n      };\n    };\n\nexport interface AdaptyUiView {\n  id: string;\n}\n\nexport interface AdaptyUiMediaCache {\n  memoryStorageTotalCostLimit?: number;\n  memoryStorageCountLimit?: number;\n  diskStorageSizeLimit?: number;\n}\n\nexport interface AdaptyUiDialogConfig {\n  /**\n   * The action title to display as part of the dialog. If you provide two actions,\n   * be sure `primaryAction` cancels the operation and leaves things unchanged.\n   */\n  primaryActionTitle: string;\n  /**\n   * The secondary action title to display as part of the dialog.\n   */\n  secondaryActionTitle?: string;\n  /**\n   * The title of the dialog.\n   */\n  title?: string;\n  /**\n   * Descriptive text that provides additional details about the reason for the dialog.\n   */\n  content?: string;\n}\n\nexport const AdaptyUiDialogActionType = Object.freeze({\n  primary: 'primary',\n  secondary: 'secondary',\n});\n\nexport type AdaptyUiDialogActionType = (typeof AdaptyUiDialogActionType)[keyof typeof AdaptyUiDialogActionType];\n\n/**\n * Additional options for creating a paywall view\n *\n * @see {@link https://adapty.io/docs/capacitor-present-paywalls | [DOC] Creating Paywall View}\n */\nexport interface CreatePaywallViewParamsInput {\n  /**\n   * `true` if you want to prefetch products before presenting a paywall view.\n   */\n  prefetchProducts?: boolean;\n  /**\n   * This value limits the timeout (in milliseconds) for this method.\n   */\n  loadTimeoutMs?: number;\n  /**\n   * If you are going to use custom tags functionality, pass an object with tags and corresponding replacement values\n   *\n   * ```\n   * {\n   *   'USERNAME': 'Bruce',\n   *   'CITY': 'Philadelphia'\n   * }\n   * ```\n   */\n  customTags?: Record<string, string>;\n  /**\n   * If you are going to use custom timer functionality, pass an object with timer ids and corresponding dates the timers should end at\n   */\n  customTimers?: Record<string, Date>;\n  /**\n   * Use this when you need to override paywall assets with your own\n   */\n  customAssets?: Record<string, AdaptyCustomAsset>;\n  /**\n   * Provide per-product purchase parameters keyed by Adapty product identifier\n   */\n  productPurchaseParams?: ProductPurchaseParams;\n}\n\n/**\n * Additional options for creating an onboarding view\n *\n * @see {@link https://adapty.io/docs/capacitor-get-onboardings | [DOC] Creating Onboarding View}\n */\nexport interface CreateOnboardingViewParamsInput {\n  /**\n   * If you want to change the presentation behavior of external URLs, pass a preferred value.\n   *\n   * @default {@link WebPresentation.BrowserInApp}\n   */\n  externalUrlsPresentation?: WebPresentation;\n}\n\nexport interface OnboardingEventHandlers {\n  onClose: (actionId: string, meta: AdaptyUiOnboardingMeta) => EventHandlerResult;\n  onCustom: (actionId: string, meta: AdaptyUiOnboardingMeta) => EventHandlerResult;\n  onPaywall: (actionId: string, meta: AdaptyUiOnboardingMeta) => EventHandlerResult;\n  onStateUpdated: (action: OnboardingStateUpdatedAction, meta: AdaptyUiOnboardingMeta) => EventHandlerResult;\n  onFinishedLoading: (meta: AdaptyUiOnboardingMeta) => EventHandlerResult;\n  onAnalytics: (\n    event: {\n      name: string;\n      /**\n       * @deprecated Use `elementId` instead\n       */\n      element_id?: string;\n      elementId?: string;\n      reply?: string;\n    },\n    meta: AdaptyUiOnboardingMeta,\n  ) => EventHandlerResult;\n  onError: (error: AdaptyError) => EventHandlerResult;\n}\n\nexport const DEFAULT_ONBOARDING_EVENT_HANDLERS: Partial<OnboardingEventHandlers> = {\n  onClose: () => true,\n};\n\n/**\n * iOS presentation style for paywall and onboarding views\n * @platform ios\n */\nexport type AdaptyIOSPresentationStyle = 'full_screen' | 'page_sheet';\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/ui-builder/types.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AA4BhC,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAExD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAsB;IAC5D,kBAAkB,EAAE,GAAG,EAAE,CAAC,IAAI;IAC9B,mBAAmB,EAAE,GAAG,EAAE,CAAC,KAAK;IAChC,wEAAwE;IACxE,6EAA6E;IAC7E,iEAAiE;IACjE,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;QAC1B,MAAM;aACH,UAAU,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;aAC3B,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,kCAAkC,KAAK,EAAE,CAAC,CAAC,CAAC;QAE7F,OAAO,KAAK,CAAC,CAAC,sBAAsB;IACtC,CAAC;IACD,cAAc,EAAE,GAAG,EAAE,CAAC,KAAK;IAC3B,iBAAiB,EAAE,GAAG,EAAE,CAAC,KAAK;IAC9B,iBAAiB,EAAE,GAAG,EAAE,CAAC,KAAK;IAC9B,mBAAmB,EAAE,GAAG,EAAE,CAAC,KAAK;IAChC,gBAAgB,EAAE,GAAG,EAAE,CAAC,KAAK;IAC7B,gBAAgB,EAAE,GAAG,EAAE,CAAC,KAAK;IAC7B,kBAAkB,EAAE,GAAG,EAAE,CAAC,KAAK;IAC/B,eAAe,EAAE,GAAG,EAAE,CAAC,KAAK;IAC5B,UAAU,EAAE,GAAG,EAAE,CAAC,KAAK;IACvB,aAAa,EAAE,GAAG,EAAE,CAAC,KAAK;IAC1B,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI;IACnB,uBAAuB,EAAE,GAAG,EAAE,CAAC,KAAK;IACpC,8BAA8B,EAAE,GAAG,EAAE,CAAC,KAAK;IAC3C,6EAA6E;IAC7E,yEAAyE;IACzE,gEAAgE;IAChE,kBAAkB,EAAE,GAAG,EAAE;QACvB,KAAK,MAAM;aACR,gBAAgB,EAAE;aAClB,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,oBAAoB,EAAE,GAAG,EAAE,CAAC,4CAA4C,KAAK,EAAE,CAAC,CAAC,CAAC;QAE/G,OAAO,KAAK,CAAC,CAAC,sBAAsB;IACtC,CAAC;IACD,WAAW,EAAE,GAAG,EAAE,CAAC,KAAK;IACxB,yEAAyE;IACzE,8EAA8E;IAC9E,gEAAgE;IAChE,mBAAmB,EAAE,KAAK,IAAI,EAAE;QAC9B,GAAG,CAAC,IAAI,CACN,qBAAqB,EACrB,GAAG,EAAE,CACH,mFAAmF;YACnF,gFAAgF,CACnF,CAAC;QAEF,OAAO,EAAE,MAAM,EAAE,QAAiB,EAAE,CAAC;IACvC,CAAC;IACD,4EAA4E;IAC5E,2EAA2E;IAC3E,uBAAuB;IACvB,2BAA2B,EAAE,GAAG,EAAE;QAChC,GAAG,CAAC,IAAI,CACN,6BAA6B,EAC7B,GAAG,EAAE,CACH,wIAAwI,CAC3I,CAAC;QAEF,OAAO,KAAK,CAAC;IACf,CAAC;IACD,0BAA0B,EAAE,GAAG,EAAE;QAC/B,GAAG,CAAC,IAAI,CACN,4BAA4B,EAC5B,GAAG,EAAE,CACH,sIAAsI,CACzI,CAAC;QAEF,OAAO,KAAK,CAAC;IACf,CAAC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAqC;IACjF,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI;CACpB,CAAC","sourcesContent":["import type { FlowEventHandlers, OnboardingEventHandlers } from '@adapty/core';\n\nimport { adapty } from '../adapty-instance';\nimport { Log } from '../logger';\n\n// Re-export all shared UI types from @adapty/core\nexport type {\n  EventHandlerResult,\n  ProductPurchaseParams,\n  FlowEventHandlers,\n  OnboardingEventHandlers,\n  OnboardingAnalyticsEventName,\n  AdaptyUiOnboardingMeta,\n  AdaptyUiOnboardingStateParams,\n  OnboardingStateUpdatedAction,\n  FlowPermissionResponse,\n  FlowPermissionStatus,\n  AdaptyPermission,\n  CreateFlowViewParamsInput,\n  CreateOnboardingViewParamsInput,\n  AdaptyUiView,\n  AdaptyUiMediaCache,\n  AdaptyUiDialogConfig,\n  AdaptyCustomAsset,\n  AdaptyCustomImageAsset,\n  AdaptyCustomVideoAsset,\n  AdaptyCustomColorAsset,\n  AdaptyCustomGradientAsset,\n  AdaptyIOSPresentationStyle,\n} from '@adapty/core';\n\nexport { AdaptyUiDialogActionType } from '@adapty/core';\n\n/**\n * Default flow-view event handlers. Mirrors react-native-adapty v4 defaults:\n * most handlers keep the view open (return false); onCloseButtonPress and\n * onError close it (return true). onUrlPress / onRequestAppReview delegate to\n * the native handler methods.\n *\n * @internal\n */\nexport const DEFAULT_FLOW_EVENT_HANDLERS: FlowEventHandlers = {\n  onCloseButtonPress: () => true,\n  onAndroidSystemBack: () => false,\n  // Delegate to the handler method, which opens the URL natively honoring\n  // `open_in` (`browser_out_app` → external browser, `browser_in_app` → in-app\n  // browser). Override this handler to open URLs yourself instead.\n  onUrlPress: (url, openIn) => {\n    adapty\n      .openWebUrl({ url, openIn })\n      .catch((error) => Log.warn('onUrlPress', () => `Failed to open url via native: ${error}`));\n\n    return false; // Keep flow view open\n  },\n  onCustomAction: () => false,\n  onProductSelected: () => false,\n  onPurchaseStarted: () => false,\n  onPurchaseCompleted: () => false,\n  onPurchaseFailed: () => false,\n  onRestoreStarted: () => false,\n  onRestoreCompleted: () => false,\n  onRestoreFailed: () => false,\n  onAppeared: () => false,\n  onDisappeared: () => false,\n  onError: () => true,\n  onLoadingProductsFailed: () => false,\n  onWebPaymentNavigationFinished: () => false,\n  // Delegate to the handler method, which shows the platform app-review prompt\n  // natively (`SKStoreReviewController` on iOS, In-App Review on Android).\n  // Override this handler to control the prompt yourself instead.\n  onRequestAppReview: () => {\n    void adapty\n      .requestAppReview()\n      .catch((error) => Log.warn('onRequestAppReview', () => `Failed to request app review via native: ${error}`));\n\n    return false; // Keep flow view open\n  },\n  onAnalytics: () => false,\n  // There is no real default here: permissions must be declared in the app\n  // bundle by the developer, so we cannot grant them on the user's behalf. Warn\n  // and reply `denied` so native always gets a correlated answer.\n  onRequestPermission: async () => {\n    Log.warn(\n      'onRequestPermission',\n      () =>\n        'No onRequestPermission handler provided; replying `denied`. Declare the required ' +\n        'permissions in your app and provide an onRequestPermission handler to respond.',\n    );\n\n    return { status: 'denied' as const };\n  },\n  // Observer mode: no real default. If you enable observer mode and present a\n  // flow view, you must drive the purchase/restore yourself, so warn when no\n  // handler is provided.\n  onObserverPurchaseInitiated: () => {\n    Log.warn(\n      'onObserverPurchaseInitiated',\n      () =>\n        'No onObserverPurchaseInitiated handler provided. In observer mode you must drive the purchase yourself; provide this handler to do so.',\n    );\n\n    return false;\n  },\n  onObserverRestoreInitiated: () => {\n    Log.warn(\n      'onObserverRestoreInitiated',\n      () =>\n        'No onObserverRestoreInitiated handler provided. In observer mode you must drive the restore yourself; provide this handler to do so.',\n    );\n\n    return false;\n  },\n};\n\n/**\n * @internal\n */\nexport const DEFAULT_ONBOARDING_EVENT_HANDLERS: Partial<OnboardingEventHandlers> = {\n  onClose: () => true,\n};\n"]}

package/dist/esm/version.d.ts

@@ -1,2 +1,2 @@
-declare const _default: "3.17.0";
+declare const _default: "4.0.0-beta.1";
 export default _default;

package/dist/esm/version.js

@@ -1,2 +1,2 @@
-export default '3.17.0';
+export default '4.0.0-beta.1';
 //# sourceMappingURL=version.js.map

package/dist/esm/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,eAAe,QAAQ,CAAC","sourcesContent":["export default '3.17.0';\n"]}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,eAAe,cAAc,CAAC","sourcesContent":["export default '4.0.0-beta.1';\n"]}