@adapty/capacitor 3.17.1 → 4.0.0-beta.1

package/dist/esm/types/configs.d.ts

@@ -1,21 +1,19 @@
 import type { AdaptyPaywallProduct } from './index';
 import type { GetPlacementParamsInput, GetPlacementForDefaultAudienceParamsInput, MakePurchaseParamsInput } from './inputs';
 /**
- * Describes the options for the `getPaywall` method.
+ * Describes the options for the `getFlow` method.
  * @public
  */
-export interface GetPaywallOptions {
+export interface GetFlowOptions {
     placementId: string;
-    locale?: string;
     params?: GetPlacementParamsInput;
 }
 /**
- * Describes the options for the `getPaywallForDefaultAudience` method.
+ * Describes the options for the `getFlowForDefaultAudience` method.
  * @public
  */
-export interface GetPaywallForDefaultAudienceOptions {
+export interface GetFlowForDefaultAudienceOptions {
     placementId: string;
-    locale?: string;
     params?: GetPlacementForDefaultAudienceParamsInput;
 }
 /**
@@ -50,15 +48,15 @@ export interface MakePurchaseOptions {
  */
 export interface AdaptyDefaultOptions {
     /**
-     * Default options for the `getPaywall` method.
+     * Default options for the `getFlow` method.
      */
-    get_paywall: {
+    get_flow: {
         params: Required<GetPlacementParamsInput>;
     };
     /**
-     * Default options for the `getPaywallForDefaultAudience` method.
+     * Default options for the `getFlowForDefaultAudience` method.
      */
-    get_paywall_for_default_audience: {
+    get_flow_for_default_audience: {
         params: GetPlacementForDefaultAudienceParamsInput;
     };
     /**
@@ -76,15 +74,15 @@ export interface AdaptyDefaultOptions {
     };
 }
 /**
- * Merged type that combines GetPaywallOptions with required params from AdaptyDefaultOptions
+ * Merged type that combines GetFlowOptions with required params from AdaptyDefaultOptions
  * @public
  */
-export type GetPaywallOptionsWithDefaults = AdaptyDefaultOptions['get_paywall'] & GetPaywallOptions;
+export type GetFlowOptionsWithDefaults = AdaptyDefaultOptions['get_flow'] & GetFlowOptions;
 /**
- * Merged type that combines GetPaywallForDefaultAudienceOptions with required params from AdaptyDefaultOptions
+ * Merged type that combines GetFlowForDefaultAudienceOptions with required params from AdaptyDefaultOptions
  * @public
  */
-export type GetPaywallForDefaultAudienceOptionsWithDefaults = AdaptyDefaultOptions['get_paywall_for_default_audience'] & GetPaywallForDefaultAudienceOptions;
+export type GetFlowForDefaultAudienceOptionsWithDefaults = AdaptyDefaultOptions['get_flow_for_default_audience'] & GetFlowForDefaultAudienceOptions;
 /**
  * Merged type for `getOnboarding` with defaults
  * @public

package/dist/esm/types/configs.js.map

@@ -1 +1 @@
-{"version":3,"file":"configs.js","sourceRoot":"","sources":["../../../src/types/configs.ts"],"names":[],"mappings":"","sourcesContent":["import type { AdaptyPaywallProduct } from './index';\nimport type {\n  GetPlacementParamsInput,\n  GetPlacementForDefaultAudienceParamsInput,\n  MakePurchaseParamsInput,\n} from './inputs';\n\n/**\n * Describes the options for the `getPaywall` method.\n * @public\n */\nexport interface GetPaywallOptions {\n  placementId: string;\n  locale?: string;\n  params?: GetPlacementParamsInput;\n}\n\n/**\n * Describes the options for the `getPaywallForDefaultAudience` method.\n * @public\n */\nexport interface GetPaywallForDefaultAudienceOptions {\n  placementId: string;\n  locale?: string;\n  params?: GetPlacementForDefaultAudienceParamsInput;\n}\n\n/**\n * Describes the options for the `getOnboarding` method.\n * @public\n */\nexport interface GetOnboardingOptions {\n  placementId: string;\n  locale?: string;\n  params?: GetPlacementParamsInput;\n}\n\n/**\n * Describes the options for the `getOnboardingForDefaultAudience` method.\n * @public\n */\nexport interface GetOnboardingForDefaultAudienceOptions {\n  placementId: string;\n  locale?: string;\n  // Keep same input shape as RN: allow loadTimeoutMs even though it is not used by schema\n  params?: GetPlacementParamsInput;\n}\n\n/**\n * Describes the options for the `makePurchase` method.\n * @public\n */\nexport interface MakePurchaseOptions {\n  product: AdaptyPaywallProduct;\n  params?: MakePurchaseParamsInput;\n}\n\n/**\n * Describes the options for the Adapty constructor.\n * @public\n */\nexport interface AdaptyDefaultOptions {\n  /**\n   * Default options for the `getPaywall` method.\n   */\n  get_paywall: {\n    params: Required<GetPlacementParamsInput>;\n  };\n  /**\n   * Default options for the `getPaywallForDefaultAudience` method.\n   */\n  get_paywall_for_default_audience: {\n    params: GetPlacementForDefaultAudienceParamsInput;\n  };\n  /**\n   * Default options for the `getOnboarding` method.\n   */\n  get_onboarding: {\n    params: Required<GetPlacementParamsInput>;\n  };\n  /**\n   * Default options for the `getOnboardingForDefaultAudience` method.\n   * Keep parity with RN by using `GetPlacementParamsInput`.\n   */\n  get_onboarding_for_default_audience: {\n    params: GetPlacementParamsInput;\n  };\n}\n\n/**\n * Merged type that combines GetPaywallOptions with required params from AdaptyDefaultOptions\n * @public\n */\nexport type GetPaywallOptionsWithDefaults = AdaptyDefaultOptions['get_paywall'] & GetPaywallOptions;\n\n/**\n * Merged type that combines GetPaywallForDefaultAudienceOptions with required params from AdaptyDefaultOptions\n * @public\n */\nexport type GetPaywallForDefaultAudienceOptionsWithDefaults = AdaptyDefaultOptions['get_paywall_for_default_audience'] &\n  GetPaywallForDefaultAudienceOptions;\n\n/**\n * Merged type for `getOnboarding` with defaults\n * @public\n */\nexport type GetOnboardingOptionsWithDefaults = AdaptyDefaultOptions['get_onboarding'] & GetOnboardingOptions;\n\n/**\n * Merged type for `getOnboardingForDefaultAudience` with defaults\n * @public\n */\nexport type GetOnboardingForDefaultAudienceOptionsWithDefaults =\n  AdaptyDefaultOptions['get_onboarding_for_default_audience'] & GetOnboardingForDefaultAudienceOptions;\n"]}
+{"version":3,"file":"configs.js","sourceRoot":"","sources":["../../../src/types/configs.ts"],"names":[],"mappings":"","sourcesContent":["import type { AdaptyPaywallProduct } from './index';\nimport type {\n  GetPlacementParamsInput,\n  GetPlacementForDefaultAudienceParamsInput,\n  MakePurchaseParamsInput,\n} from './inputs';\n\n/**\n * Describes the options for the `getFlow` method.\n * @public\n */\nexport interface GetFlowOptions {\n  placementId: string;\n  params?: GetPlacementParamsInput;\n}\n\n/**\n * Describes the options for the `getFlowForDefaultAudience` method.\n * @public\n */\nexport interface GetFlowForDefaultAudienceOptions {\n  placementId: string;\n  params?: GetPlacementForDefaultAudienceParamsInput;\n}\n\n/**\n * Describes the options for the `getOnboarding` method.\n * @public\n */\nexport interface GetOnboardingOptions {\n  placementId: string;\n  locale?: string;\n  params?: GetPlacementParamsInput;\n}\n\n/**\n * Describes the options for the `getOnboardingForDefaultAudience` method.\n * @public\n */\nexport interface GetOnboardingForDefaultAudienceOptions {\n  placementId: string;\n  locale?: string;\n  // Keep same input shape as RN: allow loadTimeoutMs even though it is not used by schema\n  params?: GetPlacementParamsInput;\n}\n\n/**\n * Describes the options for the `makePurchase` method.\n * @public\n */\nexport interface MakePurchaseOptions {\n  product: AdaptyPaywallProduct;\n  params?: MakePurchaseParamsInput;\n}\n\n/**\n * Describes the options for the Adapty constructor.\n * @public\n */\nexport interface AdaptyDefaultOptions {\n  /**\n   * Default options for the `getFlow` method.\n   */\n  get_flow: {\n    params: Required<GetPlacementParamsInput>;\n  };\n  /**\n   * Default options for the `getFlowForDefaultAudience` method.\n   */\n  get_flow_for_default_audience: {\n    params: GetPlacementForDefaultAudienceParamsInput;\n  };\n  /**\n   * Default options for the `getOnboarding` method.\n   */\n  get_onboarding: {\n    params: Required<GetPlacementParamsInput>;\n  };\n  /**\n   * Default options for the `getOnboardingForDefaultAudience` method.\n   * Keep parity with RN by using `GetPlacementParamsInput`.\n   */\n  get_onboarding_for_default_audience: {\n    params: GetPlacementParamsInput;\n  };\n}\n\n/**\n * Merged type that combines GetFlowOptions with required params from AdaptyDefaultOptions\n * @public\n */\nexport type GetFlowOptionsWithDefaults = AdaptyDefaultOptions['get_flow'] & GetFlowOptions;\n\n/**\n * Merged type that combines GetFlowForDefaultAudienceOptions with required params from AdaptyDefaultOptions\n * @public\n */\nexport type GetFlowForDefaultAudienceOptionsWithDefaults = AdaptyDefaultOptions['get_flow_for_default_audience'] &\n  GetFlowForDefaultAudienceOptions;\n\n/**\n * Merged type for `getOnboarding` with defaults\n * @public\n */\nexport type GetOnboardingOptionsWithDefaults = AdaptyDefaultOptions['get_onboarding'] & GetOnboardingOptions;\n\n/**\n * Merged type for `getOnboardingForDefaultAudience` with defaults\n * @public\n */\nexport type GetOnboardingForDefaultAudienceOptionsWithDefaults =\n  AdaptyDefaultOptions['get_onboarding_for_default_audience'] & GetOnboardingForDefaultAudienceOptions;\n"]}

package/dist/esm/types/flow-events.d.ts

@@ -0,0 +1 @@
+export { FlowEventId, type FlowEventIdType, type FlowEventView, type ParsedFlowEvent, type AdaptyPermission, type FlowUserAction, type FlowDidAppearEvent, type FlowDidDisappearEvent, type FlowDidPerformActionEvent, type FlowDidSelectProductEvent, type FlowDidStartPurchaseEvent, type FlowDidFinishPurchaseEvent, type FlowDidFailPurchaseEvent, type FlowDidStartRestoreEvent, type FlowDidFinishRestoreEvent, type FlowDidFailRestoreEvent, type FlowDidReceiveErrorEvent, type FlowDidFailLoadingProductsEvent, type FlowDidFinishWebPaymentNavigationEvent, type FlowDidRequestAppReviewEvent, type FlowDidReceiveAnalyticEvent, type FlowDidAskPermissionEvent, type FlowObserverDidInitiatePurchaseEvent, type FlowObserverDidInitiateRestoreEvent, } from '@adapty/core';

package/dist/esm/types/flow-events.js

@@ -0,0 +1,2 @@
+export { FlowEventId, } from '@adapty/core';
+//# sourceMappingURL=flow-events.js.map

package/dist/esm/types/flow-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-events.js","sourceRoot":"","sources":["../../../src/types/flow-events.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,GAwBZ,MAAM,cAAc,CAAC","sourcesContent":["export {\n  FlowEventId,\n  type FlowEventIdType,\n  type FlowEventView,\n  type ParsedFlowEvent,\n  type AdaptyPermission,\n  type FlowUserAction,\n  type FlowDidAppearEvent,\n  type FlowDidDisappearEvent,\n  type FlowDidPerformActionEvent,\n  type FlowDidSelectProductEvent,\n  type FlowDidStartPurchaseEvent,\n  type FlowDidFinishPurchaseEvent,\n  type FlowDidFailPurchaseEvent,\n  type FlowDidStartRestoreEvent,\n  type FlowDidFinishRestoreEvent,\n  type FlowDidFailRestoreEvent,\n  type FlowDidReceiveErrorEvent,\n  type FlowDidFailLoadingProductsEvent,\n  type FlowDidFinishWebPaymentNavigationEvent,\n  type FlowDidRequestAppReviewEvent,\n  type FlowDidReceiveAnalyticEvent,\n  type FlowDidAskPermissionEvent,\n  type FlowObserverDidInitiatePurchaseEvent,\n  type FlowObserverDidInitiateRestoreEvent,\n} from '@adapty/core';\n"]}

package/dist/esm/types/index.d.ts

@@ -1,5 +1,5 @@
-export type { AdaptyPrice, AdaptyPaywall, AdaptyOnboarding, AdaptyPlacement, AdaptyRemoteConfig, AdaptyPaywallBuilder, AdaptyOnboardingBuilder, AdaptyPurchaseResult, AdaptyProfile, AttributionSource, AdaptyAccessLevel, AdaptyNonSubscription, AdaptySubscription, AdaptyPaywallProduct, AdaptySubscriptionDetails, AdaptySubscriptionOffer, AdaptySubscriptionOfferId, AdaptyDiscountPhase, AdaptySubscriptionPeriod, AdaptyProfileParameters, ProductReference, AdaptyProductIdentifier, AdaptyInstallationStatus, AdaptyInstallationDetails, } from '@adapty/core';
+export type { AdaptyPrice, AdaptyFlow, AdaptyFlowPaywall, AdaptyOnboarding, AdaptyPlacement, AdaptyRemoteConfig, AdaptyOnboardingBuilder, AdaptyPurchaseResult, AdaptyProfile, AttributionSource, AdaptyAccessLevel, AdaptyNonSubscription, AdaptySubscription, AdaptyPaywallProduct, AdaptySubscriptionDetails, AdaptySubscriptionOffer, AdaptySubscriptionOfferId, AdaptyDiscountPhase, AdaptySubscriptionPeriod, AdaptyProfileParameters, AdaptyProductIdentifier, AdaptyInstallationStatus, AdaptyInstallationDetails, } from '@adapty/core';
 export { WebPresentation, RefundPreference, VendorStore, OfferType, CancellationReason, Gender, AppTrackingTransparencyStatus, ProductPeriod, ErrorCode, ErrorCodeName, getErrorCode, getErrorPrompt, } from '@adapty/core';
 export * from './inputs';
-export * from './paywall-events';
+export * from './flow-events';
 export * from './onboarding-events';

package/dist/esm/types/index.js

@@ -1,6 +1,6 @@
 export { WebPresentation, RefundPreference, VendorStore, OfferType, CancellationReason, Gender, AppTrackingTransparencyStatus, ProductPeriod, ErrorCode, ErrorCodeName, getErrorCode, getErrorPrompt, } from '@adapty/core';
 // Re-export local modules that are NOT in core
 export * from './inputs';
-export * from './paywall-events';
+export * from './flow-events';
 export * from './onboarding-events';
 //# sourceMappingURL=index.js.map

package/dist/esm/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AA4BA,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,SAAS,EACT,kBAAkB,EAClB,MAAM,EACN,6BAA6B,EAC7B,aAAa,EACb,SAAS,EACT,aAAa,EACb,YAAY,EACZ,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB,+CAA+C;AAC/C,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC","sourcesContent":["// Re-export all model types from @adapty/core\nexport type {\n  AdaptyPrice,\n  AdaptyPaywall,\n  AdaptyOnboarding,\n  AdaptyPlacement,\n  AdaptyRemoteConfig,\n  AdaptyPaywallBuilder,\n  AdaptyOnboardingBuilder,\n  AdaptyPurchaseResult,\n  AdaptyProfile,\n  AttributionSource,\n  AdaptyAccessLevel,\n  AdaptyNonSubscription,\n  AdaptySubscription,\n  AdaptyPaywallProduct,\n  AdaptySubscriptionDetails,\n  AdaptySubscriptionOffer,\n  AdaptySubscriptionOfferId,\n  AdaptyDiscountPhase,\n  AdaptySubscriptionPeriod,\n  AdaptyProfileParameters,\n  ProductReference,\n  AdaptyProductIdentifier,\n  AdaptyInstallationStatus,\n  AdaptyInstallationDetails,\n} from '@adapty/core';\n\nexport {\n  WebPresentation,\n  RefundPreference,\n  VendorStore,\n  OfferType,\n  CancellationReason,\n  Gender,\n  AppTrackingTransparencyStatus,\n  ProductPeriod,\n  ErrorCode,\n  ErrorCodeName,\n  getErrorCode,\n  getErrorPrompt,\n} from '@adapty/core';\n\n// Re-export local modules that are NOT in core\nexport * from './inputs';\nexport * from './paywall-events';\nexport * from './onboarding-events';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AA2BA,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,SAAS,EACT,kBAAkB,EAClB,MAAM,EACN,6BAA6B,EAC7B,aAAa,EACb,SAAS,EACT,aAAa,EACb,YAAY,EACZ,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB,+CAA+C;AAC/C,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC","sourcesContent":["// Re-export all model types from @adapty/core\nexport type {\n  AdaptyPrice,\n  AdaptyFlow,\n  AdaptyFlowPaywall,\n  AdaptyOnboarding,\n  AdaptyPlacement,\n  AdaptyRemoteConfig,\n  AdaptyOnboardingBuilder,\n  AdaptyPurchaseResult,\n  AdaptyProfile,\n  AttributionSource,\n  AdaptyAccessLevel,\n  AdaptyNonSubscription,\n  AdaptySubscription,\n  AdaptyPaywallProduct,\n  AdaptySubscriptionDetails,\n  AdaptySubscriptionOffer,\n  AdaptySubscriptionOfferId,\n  AdaptyDiscountPhase,\n  AdaptySubscriptionPeriod,\n  AdaptyProfileParameters,\n  AdaptyProductIdentifier,\n  AdaptyInstallationStatus,\n  AdaptyInstallationDetails,\n} from '@adapty/core';\n\nexport {\n  WebPresentation,\n  RefundPreference,\n  VendorStore,\n  OfferType,\n  CancellationReason,\n  Gender,\n  AppTrackingTransparencyStatus,\n  ProductPeriod,\n  ErrorCode,\n  ErrorCodeName,\n  getErrorCode,\n  getErrorPrompt,\n} from '@adapty/core';\n\n// Re-export local modules that are NOT in core\nexport * from './inputs';\nexport * from './flow-events';\nexport * from './onboarding-events';\n"]}

package/dist/esm/types/inputs.d.ts

@@ -1 +1 @@
-export { LogLevel, FetchPolicy, AdaptyAndroidSubscriptionUpdateReplacementMode, type ActivateParamsInput, type IdentifyParamsInput, type MakePurchaseParamsInput, type AdaptyAndroidSubscriptionUpdateParameters, type AdaptyAndroidPurchaseParams, type GetPlacementParamsInput, type GetPlacementForDefaultAudienceParamsInput, type GetPaywallProductsParamsInput, type FileLocation, } from '@adapty/core';
+export { LogLevel, FetchPolicy, AdaptyAndroidSubscriptionUpdateReplacementMode, type ActivateParamsInput, type IdentifyParamsInput, type MakePurchaseParamsInput, type AdaptyAndroidPurchaseParams, type GetPlacementParamsInput, type GetPlacementForDefaultAudienceParamsInput, type GetPaywallProductsParamsInput, type FileLocation, } from '@adapty/core';

package/dist/esm/types/inputs.js.map

@@ -1 +1 @@
-{"version":3,"file":"inputs.js","sourceRoot":"","sources":["../../../src/types/inputs.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,WAAW,EACX,8CAA8C,GAU/C,MAAM,cAAc,CAAC","sourcesContent":["export {\n  LogLevel,\n  FetchPolicy,\n  AdaptyAndroidSubscriptionUpdateReplacementMode,\n  type ActivateParamsInput,\n  type IdentifyParamsInput,\n  type MakePurchaseParamsInput,\n  type AdaptyAndroidSubscriptionUpdateParameters,\n  type AdaptyAndroidPurchaseParams,\n  type GetPlacementParamsInput,\n  type GetPlacementForDefaultAudienceParamsInput,\n  type GetPaywallProductsParamsInput,\n  type FileLocation,\n} from '@adapty/core';\n"]}
+{"version":3,"file":"inputs.js","sourceRoot":"","sources":["../../../src/types/inputs.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,WAAW,EACX,8CAA8C,GAS/C,MAAM,cAAc,CAAC","sourcesContent":["export {\n  LogLevel,\n  FetchPolicy,\n  AdaptyAndroidSubscriptionUpdateReplacementMode,\n  type ActivateParamsInput,\n  type IdentifyParamsInput,\n  type MakePurchaseParamsInput,\n  type AdaptyAndroidPurchaseParams,\n  type GetPlacementParamsInput,\n  type GetPlacementForDefaultAudienceParamsInput,\n  type GetPaywallProductsParamsInput,\n  type FileLocation,\n} from '@adapty/core';\n"]}

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

@@ -43,6 +43,12 @@ export declare abstract class BaseViewEmitter<TEventHandlers extends Record<stri
      * Abstract method to get emitter name for error messages
      */
     protected abstract getEmitterName(): string;
+    /**
+     * Hook for subclasses to fully handle an event themselves (e.g. async
+     * request/response round-trips). Return true to skip the standard
+     * "call handler → maybe close view" dispatch for this event.
+     */
+    protected handleSpecialEvent(_handlerName: keyof TEventHandlers, _eventData: TEventData): boolean;
     addListener(event: keyof TEventHandlers, callback: TEventHandlers[keyof TEventHandlers], onRequestClose: () => Promise<void>): Promise<PluginListenerHandle>;
     addInternalListener(event: keyof TEventHandlers, callback: (event: TEventData) => void): Promise<PluginListenerHandle>;
     removeAllListeners(): void;

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

@@ -11,6 +11,14 @@ export class BaseViewEmitter {
         this.internalHandlers = new Map();
         this.viewId = viewId;
     }
+    /**
+     * Hook for subclasses to fully handle an event themselves (e.g. async
+     * request/response round-trips). Return true to skip the standard
+     * "call handler → maybe close view" dispatch for this event.
+     */
+    handleSpecialEvent(_handlerName, _eventData) {
+        return false;
+    }
     async addListener(event, callback, onRequestClose) {
         const nativeEvent = this.getNativeEventForHandler(event);
         if (!nativeEvent) {
@@ -79,6 +87,10 @@ export class BaseViewEmitter {
             if (!handlerName) {
                 return;
             }
+            if (this.handleSpecialEvent(handlerName, eventData)) {
+                log.success(() => ({ message: 'Special event handled', handlerName }));
+                return;
+            }
             // 1. Client handler (single)
             const handlerData = this.handlers.get(handlerName);
             if (handlerData) {

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

@@ -1 +1 @@
-{"version":3,"file":"base-view-emitter.js","sourceRoot":"","sources":["../../../src/ui-builder/base-view-emitter.ts"],"names":[],"mappings":"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","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\n\nimport { AdaptyCapacitorPlugin } from '../bridge/plugin';\nimport { LogContext } from '../logger';\n\nexport interface CapacitorEventArg {\n  data: string; // JSON string from native\n}\n\nexport interface HandlerData<THandler> {\n  handler: THandler;\n  onRequestClose: () => Promise<void>;\n}\n\n/**\n * Base class for view event emitters that manages common event handling logic.\n * Each event type can have only one handler - new handlers replace existing ones.\n */\nexport abstract class BaseViewEmitter<\n  TEventHandlers extends Record<string, any>,\n  TEventData,\n  TNativeEvent extends string = string,\n> {\n  protected viewId: string;\n  protected eventListeners: Map<TNativeEvent, PluginListenerHandle> = new Map();\n  protected handlers: Map<keyof TEventHandlers, HandlerData<TEventHandlers[keyof TEventHandlers]>> = new Map();\n  protected internalHandlers: Map<keyof TEventHandlers, { handler: (event: TEventData) => void }> = new Map();\n\n  constructor(viewId: string) {\n    this.viewId = viewId;\n  }\n\n  /**\n   * Abstract method to parse event data from JSON string\n   */\n  protected abstract parseEventData(rawEventData: string, ctx: LogContext): TEventData;\n\n  /**\n   * Abstract method to get native event name for handler\n   */\n  protected abstract getNativeEventForHandler(event: keyof TEventHandlers): TNativeEvent | null;\n\n  /**\n   * Resolves handler name for incoming native event based on parsed data\n   */\n  protected abstract getHandlerForNativeEvent(\n    nativeEvent: TNativeEvent,\n    eventData: TEventData,\n  ): keyof TEventHandlers | null;\n\n  /**\n   * Abstract method to extract callback arguments for a specific handler\n   */\n  protected abstract extractCallbackArgs(handlerName: keyof TEventHandlers, eventData: TEventData): unknown[];\n\n  /**\n   * Abstract method to get view ID from parsed event data\n   */\n  protected abstract getEventViewId(eventData: TEventData): string | null;\n\n  /**\n   * Abstract method to get emitter name for error messages\n   */\n  protected abstract getEmitterName(): string;\n\n  public async addListener(\n    event: keyof TEventHandlers,\n    callback: TEventHandlers[keyof TEventHandlers],\n    onRequestClose: () => Promise<void>,\n  ): Promise<PluginListenerHandle> {\n    const nativeEvent = this.getNativeEventForHandler(event);\n    if (!nativeEvent) {\n      throw new Error(`No native event mapping found for handler: ${String(event)}`);\n    }\n\n    // Replace existing handler for this event type\n    this.handlers.set(event, {\n      handler: callback,\n      onRequestClose,\n    });\n\n    return await this.getOrCreateNativeListener(nativeEvent);\n  }\n\n  public async addInternalListener(\n    event: keyof TEventHandlers,\n    callback: (event: TEventData) => void,\n  ): Promise<PluginListenerHandle> {\n    const nativeEvent = this.getNativeEventForHandler(event);\n    if (!nativeEvent) {\n      throw new Error(`No native event mapping found for handler: ${String(event)}`);\n    }\n\n    this.internalHandlers.set(event, { handler: callback });\n\n    return await this.getOrCreateNativeListener(nativeEvent);\n  }\n\n  public removeAllListeners(): void {\n    this.eventListeners.forEach((subscription) => {\n      subscription.remove().catch(() => {\n        // intentionally ignore errors during cleanup\n      });\n    });\n    this.eventListeners.clear();\n    this.handlers.clear();\n    this.internalHandlers.clear();\n  }\n\n  private async createNativeListener(nativeEvent: TNativeEvent): Promise<PluginListenerHandle> {\n    const emitterName = this.getEmitterName();\n    const viewId = this.viewId;\n\n    const subscription = await AdaptyCapacitorPlugin.addListener(nativeEvent, (arg: CapacitorEventArg) => {\n      const ctx = new LogContext();\n      const log = ctx.event({ methodName: nativeEvent });\n      log.start(() => ({ raw: arg }));\n\n      // Strict validation: events must come in {data: \"json_string\"} format\n      if (!arg || typeof arg !== 'object' || !arg.data) {\n        const error = new Error(\n          `[${emitterName}] Invalid event format received. Expected {data: \"json_string\"}, got: ${JSON.stringify(arg)}`,\n        );\n        log.failed(() => ({ error }));\n        throw error;\n      }\n\n      const rawEventData: string = arg.data;\n\n      // Parse JSON string using specific parser with decode logging\n      let eventData: TEventData;\n      if (typeof rawEventData === 'string') {\n        try {\n          eventData = this.parseEventData(rawEventData, ctx);\n        } catch (error) {\n          log.failed(() => ({ error }));\n          throw error;\n        }\n      } else {\n        const err = new Error(\n          `[${emitterName}] Expected event data to be JSON string, got ${typeof rawEventData}: ${rawEventData}`,\n        );\n        log.failed(() => ({ error: err }));\n        throw err;\n      }\n\n      const eventViewId = this.getEventViewId(eventData);\n      if (viewId !== eventViewId) {\n        return;\n      }\n\n      const handlerName = this.getHandlerForNativeEvent(nativeEvent, eventData);\n      if (!handlerName) {\n        return;\n      }\n\n      // 1. Client handler (single)\n      const handlerData = this.handlers.get(handlerName);\n      if (handlerData) {\n        const { handler, onRequestClose } = handlerData;\n        const callbackArgs = this.extractCallbackArgs(handlerName, eventData);\n\n        const cb = handler as (...args: typeof callbackArgs) => boolean;\n        try {\n          const shouldClose = cb(...callbackArgs);\n          if (shouldClose) {\n            onRequestClose().catch((error) => {\n              log.failed(() => ({ error, handlerName }));\n            });\n          }\n          log.success(() => ({ message: 'Event handled successfully', handlerName }));\n        } catch (error) {\n          log.failed(() => ({ error, handlerName }));\n        }\n      }\n\n      // 2. Internal handler\n      const internalHandlerData = this.internalHandlers.get(handlerName);\n      if (internalHandlerData) {\n        try {\n          internalHandlerData.handler(eventData);\n        } catch (error: unknown) {\n          log.failed(() => ({ error, handlerName: `internal:${String(handlerName)}` }));\n        }\n      }\n    });\n\n    this.eventListeners.set(nativeEvent, subscription);\n    return subscription;\n  }\n\n  private async getOrCreateNativeListener(nativeEvent: TNativeEvent): Promise<PluginListenerHandle> {\n    const existing = this.eventListeners.get(nativeEvent);\n    if (existing) {\n      return existing;\n    }\n\n    const created = await this.createNativeListener(nativeEvent);\n    if (!created) {\n      throw new Error(`Failed to register listener for ${nativeEvent}`);\n    }\n    return created;\n  }\n}\n"]}
+{"version":3,"file":"base-view-emitter.js","sourceRoot":"","sources":["../../../src/ui-builder/base-view-emitter.ts"],"names":[],"mappings":"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","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\n\nimport { AdaptyCapacitorPlugin } from '../bridge/plugin';\nimport { LogContext } from '../logger';\n\nexport interface CapacitorEventArg {\n  data: string; // JSON string from native\n}\n\nexport interface HandlerData<THandler> {\n  handler: THandler;\n  onRequestClose: () => Promise<void>;\n}\n\n/**\n * Base class for view event emitters that manages common event handling logic.\n * Each event type can have only one handler - new handlers replace existing ones.\n */\nexport abstract class BaseViewEmitter<\n  TEventHandlers extends Record<string, any>,\n  TEventData,\n  TNativeEvent extends string = string,\n> {\n  protected viewId: string;\n  protected eventListeners: Map<TNativeEvent, PluginListenerHandle> = new Map();\n  protected handlers: Map<keyof TEventHandlers, HandlerData<TEventHandlers[keyof TEventHandlers]>> = new Map();\n  protected internalHandlers: Map<keyof TEventHandlers, { handler: (event: TEventData) => void }> = new Map();\n\n  constructor(viewId: string) {\n    this.viewId = viewId;\n  }\n\n  /**\n   * Abstract method to parse event data from JSON string\n   */\n  protected abstract parseEventData(rawEventData: string, ctx: LogContext): TEventData;\n\n  /**\n   * Abstract method to get native event name for handler\n   */\n  protected abstract getNativeEventForHandler(event: keyof TEventHandlers): TNativeEvent | null;\n\n  /**\n   * Resolves handler name for incoming native event based on parsed data\n   */\n  protected abstract getHandlerForNativeEvent(\n    nativeEvent: TNativeEvent,\n    eventData: TEventData,\n  ): keyof TEventHandlers | null;\n\n  /**\n   * Abstract method to extract callback arguments for a specific handler\n   */\n  protected abstract extractCallbackArgs(handlerName: keyof TEventHandlers, eventData: TEventData): unknown[];\n\n  /**\n   * Abstract method to get view ID from parsed event data\n   */\n  protected abstract getEventViewId(eventData: TEventData): string | null;\n\n  /**\n   * Abstract method to get emitter name for error messages\n   */\n  protected abstract getEmitterName(): string;\n\n  /**\n   * Hook for subclasses to fully handle an event themselves (e.g. async\n   * request/response round-trips). Return true to skip the standard\n   * \"call handler → maybe close view\" dispatch for this event.\n   */\n  protected handleSpecialEvent(_handlerName: keyof TEventHandlers, _eventData: TEventData): boolean {\n    return false;\n  }\n\n  public async addListener(\n    event: keyof TEventHandlers,\n    callback: TEventHandlers[keyof TEventHandlers],\n    onRequestClose: () => Promise<void>,\n  ): Promise<PluginListenerHandle> {\n    const nativeEvent = this.getNativeEventForHandler(event);\n    if (!nativeEvent) {\n      throw new Error(`No native event mapping found for handler: ${String(event)}`);\n    }\n\n    // Replace existing handler for this event type\n    this.handlers.set(event, {\n      handler: callback,\n      onRequestClose,\n    });\n\n    return await this.getOrCreateNativeListener(nativeEvent);\n  }\n\n  public async addInternalListener(\n    event: keyof TEventHandlers,\n    callback: (event: TEventData) => void,\n  ): Promise<PluginListenerHandle> {\n    const nativeEvent = this.getNativeEventForHandler(event);\n    if (!nativeEvent) {\n      throw new Error(`No native event mapping found for handler: ${String(event)}`);\n    }\n\n    this.internalHandlers.set(event, { handler: callback });\n\n    return await this.getOrCreateNativeListener(nativeEvent);\n  }\n\n  public removeAllListeners(): void {\n    this.eventListeners.forEach((subscription) => {\n      subscription.remove().catch(() => {\n        // intentionally ignore errors during cleanup\n      });\n    });\n    this.eventListeners.clear();\n    this.handlers.clear();\n    this.internalHandlers.clear();\n  }\n\n  private async createNativeListener(nativeEvent: TNativeEvent): Promise<PluginListenerHandle> {\n    const emitterName = this.getEmitterName();\n    const viewId = this.viewId;\n\n    const subscription = await AdaptyCapacitorPlugin.addListener(nativeEvent, (arg: CapacitorEventArg) => {\n      const ctx = new LogContext();\n      const log = ctx.event({ methodName: nativeEvent });\n      log.start(() => ({ raw: arg }));\n\n      // Strict validation: events must come in {data: \"json_string\"} format\n      if (!arg || typeof arg !== 'object' || !arg.data) {\n        const error = new Error(\n          `[${emitterName}] Invalid event format received. Expected {data: \"json_string\"}, got: ${JSON.stringify(arg)}`,\n        );\n        log.failed(() => ({ error }));\n        throw error;\n      }\n\n      const rawEventData: string = arg.data;\n\n      // Parse JSON string using specific parser with decode logging\n      let eventData: TEventData;\n      if (typeof rawEventData === 'string') {\n        try {\n          eventData = this.parseEventData(rawEventData, ctx);\n        } catch (error) {\n          log.failed(() => ({ error }));\n          throw error;\n        }\n      } else {\n        const err = new Error(\n          `[${emitterName}] Expected event data to be JSON string, got ${typeof rawEventData}: ${rawEventData}`,\n        );\n        log.failed(() => ({ error: err }));\n        throw err;\n      }\n\n      const eventViewId = this.getEventViewId(eventData);\n      if (viewId !== eventViewId) {\n        return;\n      }\n\n      const handlerName = this.getHandlerForNativeEvent(nativeEvent, eventData);\n      if (!handlerName) {\n        return;\n      }\n\n      if (this.handleSpecialEvent(handlerName, eventData)) {\n        log.success(() => ({ message: 'Special event handled', handlerName }));\n        return;\n      }\n\n      // 1. Client handler (single)\n      const handlerData = this.handlers.get(handlerName);\n      if (handlerData) {\n        const { handler, onRequestClose } = handlerData;\n        const callbackArgs = this.extractCallbackArgs(handlerName, eventData);\n\n        const cb = handler as (...args: typeof callbackArgs) => boolean;\n        try {\n          const shouldClose = cb(...callbackArgs);\n          if (shouldClose) {\n            onRequestClose().catch((error) => {\n              log.failed(() => ({ error, handlerName }));\n            });\n          }\n          log.success(() => ({ message: 'Event handled successfully', handlerName }));\n        } catch (error) {\n          log.failed(() => ({ error, handlerName }));\n        }\n      }\n\n      // 2. Internal handler\n      const internalHandlerData = this.internalHandlers.get(handlerName);\n      if (internalHandlerData) {\n        try {\n          internalHandlerData.handler(eventData);\n        } catch (error: unknown) {\n          log.failed(() => ({ error, handlerName: `internal:${String(handlerName)}` }));\n        }\n      }\n    });\n\n    this.eventListeners.set(nativeEvent, subscription);\n    return subscription;\n  }\n\n  private async getOrCreateNativeListener(nativeEvent: TNativeEvent): Promise<PluginListenerHandle> {\n    const existing = this.eventListeners.get(nativeEvent);\n    if (existing) {\n      return existing;\n    }\n\n    const created = await this.createNativeListener(nativeEvent);\n    if (!created) {\n      throw new Error(`Failed to register listener for ${nativeEvent}`);\n    }\n    return created;\n  }\n}\n"]}

package/dist/esm/ui-builder/create-flow-view.d.ts

@@ -0,0 +1,14 @@
+import type { AdaptyFlow } from '../types';
+import { FlowViewController } from './flow-view-controller';
+import type { CreateFlowViewParamsInput } from './types';
+/**
+ * Creates a flow view controller. Use it to further configure a view or present it.
+ *
+ * @see {@link https://adapty.io/docs/capacitor-present-paywalls | [DOC] Creating a flow view}
+ *
+ * @param {AdaptyFlow} flow - flow to present (from `adapty.getFlow(...)`).
+ * @param {CreateFlowViewParamsInput} [params] - additional params.
+ * @returns {Promise<FlowViewController>}
+ * @throws {AdaptyError} if the flow has no view configured or view creation fails.
+ */
+export declare function createFlowView(flow: AdaptyFlow, params?: CreateFlowViewParamsInput): Promise<FlowViewController>;

package/dist/esm/ui-builder/create-flow-view.js

@@ -0,0 +1,16 @@
+import { adapty } from '../adapty-instance';
+import { FlowViewController } from './flow-view-controller';
+/**
+ * Creates a flow view controller. Use it to further configure a view or present it.
+ *
+ * @see {@link https://adapty.io/docs/capacitor-present-paywalls | [DOC] Creating a flow view}
+ *
+ * @param {AdaptyFlow} flow - flow to present (from `adapty.getFlow(...)`).
+ * @param {CreateFlowViewParamsInput} [params] - additional params.
+ * @returns {Promise<FlowViewController>}
+ * @throws {AdaptyError} if the flow has no view configured or view creation fails.
+ */
+export async function createFlowView(flow, params = {}) {
+    return FlowViewController.create(flow, params, adapty);
+}
+//# sourceMappingURL=create-flow-view.js.map

package/dist/esm/ui-builder/create-flow-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-flow-view.js","sourceRoot":"","sources":["../../../src/ui-builder/create-flow-view.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAG5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAG5D;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAgB,EAChB,SAAoC,EAAE;IAEtC,OAAO,kBAAkB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AACzD,CAAC","sourcesContent":["import { adapty } from '../adapty-instance';\nimport type { AdaptyFlow } from '../types';\n\nimport { FlowViewController } from './flow-view-controller';\nimport type { CreateFlowViewParamsInput } from './types';\n\n/**\n * Creates a flow view controller. Use it to further configure a view or present it.\n *\n * @see {@link https://adapty.io/docs/capacitor-present-paywalls | [DOC] Creating a flow view}\n *\n * @param {AdaptyFlow} flow - flow to present (from `adapty.getFlow(...)`).\n * @param {CreateFlowViewParamsInput} [params] - additional params.\n * @returns {Promise<FlowViewController>}\n * @throws {AdaptyError} if the flow has no view configured or view creation fails.\n */\nexport async function createFlowView(\n  flow: AdaptyFlow,\n  params: CreateFlowViewParamsInput = {},\n): Promise<FlowViewController> {\n  return FlowViewController.create(flow, params, adapty);\n}\n"]}

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

@@ -5,6 +5,8 @@ import type { CreateOnboardingViewParamsInput } from './types';
  * Creates an onboarding view controller.
  * You can use it to further configure a view or present it.
  *
+ * @deprecated Since 4.0.0. Migrate onboardings to the Flow Builder API.
+ *
  * @see {@link https://adapty.io/docs/capacitor-get-onboardings | [DOC] Creating an onboarding view}
  *
  * @param {AdaptyOnboarding} onboarding - onboarding that you want to present.

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

@@ -5,6 +5,8 @@ const adaptyPlugin = new Adapty();
  * Creates an onboarding view controller.
  * You can use it to further configure a view or present it.
  *
+ * @deprecated Since 4.0.0. Migrate onboardings to the Flow Builder API.
+ *
  * @see {@link https://adapty.io/docs/capacitor-get-onboardings | [DOC] Creating an onboarding view}
  *
  * @param {AdaptyOnboarding} onboarding - onboarding that you want to present.

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

@@ -1 +1 @@
-{"version":3,"file":"create-onboarding-view.js","sourceRoot":"","sources":["../../../src/ui-builder/create-onboarding-view.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAGxE,MAAM,YAAY,GAAG,IAAI,MAAM,EAAE,CAAC;AAElC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,UAA4B,EAC5B,SAA0C,EAAE;IAE5C,MAAM,UAAU,GAAG,MAAM,wBAAwB,CAAC,MAAM,CAAC,UAAU,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;IAC3F,OAAO,UAAU,CAAC;AACpB,CAAC","sourcesContent":["import { Adapty } from '../adapty';\nimport type { AdaptyOnboarding } from '../types';\n\nimport { OnboardingViewController } from './onboarding-view-controller';\nimport type { CreateOnboardingViewParamsInput } from './types';\n\nconst adaptyPlugin = new Adapty();\n\n/**\n * Creates an onboarding view controller.\n * You can use it to further configure a view or present it.\n *\n * @see {@link https://adapty.io/docs/capacitor-get-onboardings | [DOC] Creating an onboarding view}\n *\n * @param {AdaptyOnboarding} onboarding - onboarding that you want to present.\n * @param {CreateOnboardingViewParamsInput | undefined} [params] - additional params.\n * @returns {Promise<OnboardingViewController>} ViewController — A promise that resolves to a ViewController instance.\n *\n * @example\n * ```ts\n * const onboarding = await adapty.getOnboarding({ placementId: 'MY_PLACEMENT' });\n * const view = await createOnboardingView(onboarding);\n * view.present();\n * ```\n *\n * @example\n * ```ts\n * const view = await createOnboardingView(onboarding, {\n *   externalUrlsPresentation: WebPresentation.BrowserOutApp\n * });\n * ```\n *\n * @throws {AdaptyError} — If onboarding 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 createOnboardingView(\n  onboarding: AdaptyOnboarding,\n  params: CreateOnboardingViewParamsInput = {},\n): Promise<OnboardingViewController> {\n  const controller = await OnboardingViewController.create(onboarding, adaptyPlugin, params);\n  return controller;\n}\n"]}
+{"version":3,"file":"create-onboarding-view.js","sourceRoot":"","sources":["../../../src/ui-builder/create-onboarding-view.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAGxE,MAAM,YAAY,GAAG,IAAI,MAAM,EAAE,CAAC;AAElC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,UAA4B,EAC5B,SAA0C,EAAE;IAE5C,MAAM,UAAU,GAAG,MAAM,wBAAwB,CAAC,MAAM,CAAC,UAAU,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;IAC3F,OAAO,UAAU,CAAC;AACpB,CAAC","sourcesContent":["import { Adapty } from '../adapty';\nimport type { AdaptyOnboarding } from '../types';\n\nimport { OnboardingViewController } from './onboarding-view-controller';\nimport type { CreateOnboardingViewParamsInput } from './types';\n\nconst adaptyPlugin = new Adapty();\n\n/**\n * Creates an onboarding view controller.\n * You can use it to further configure a view or present it.\n *\n * @deprecated Since 4.0.0. Migrate onboardings to the Flow Builder API.\n *\n * @see {@link https://adapty.io/docs/capacitor-get-onboardings | [DOC] Creating an onboarding view}\n *\n * @param {AdaptyOnboarding} onboarding - onboarding that you want to present.\n * @param {CreateOnboardingViewParamsInput | undefined} [params] - additional params.\n * @returns {Promise<OnboardingViewController>} ViewController — A promise that resolves to a ViewController instance.\n *\n * @example\n * ```ts\n * const onboarding = await adapty.getOnboarding({ placementId: 'MY_PLACEMENT' });\n * const view = await createOnboardingView(onboarding);\n * view.present();\n * ```\n *\n * @example\n * ```ts\n * const view = await createOnboardingView(onboarding, {\n *   externalUrlsPresentation: WebPresentation.BrowserOutApp\n * });\n * ```\n *\n * @throws {AdaptyError} — If onboarding 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 createOnboardingView(\n  onboarding: AdaptyOnboarding,\n  params: CreateOnboardingViewParamsInput = {},\n): Promise<OnboardingViewController> {\n  const controller = await OnboardingViewController.create(onboarding, adaptyPlugin, params);\n  return controller;\n}\n"]}

package/dist/esm/ui-builder/{paywall-view-controller.d.ts → flow-view-controller.d.ts}

@@ -1,17 +1,17 @@
 import type { Adapty } from '../adapty';
-import type { AdaptyPaywall } from '../types';
-import type { CreatePaywallViewParamsInput, AdaptyUiDialogConfig, AdaptyUiDialogActionType, EventHandlers, AdaptyIOSPresentationStyle } from './types';
+import type { AdaptyFlow } from '../types';
+import type { CreateFlowViewParamsInput, AdaptyUiDialogConfig, AdaptyUiDialogActionType, FlowEventHandlers, AdaptyIOSPresentationStyle } from './types';
 /**
- * Controller for managing paywall views.
+ * Controller for managing flow views.
  *
  * @remarks
- * This class provides methods to present, dismiss, and handle events for paywall views
- * created with the Paywall Builder. Create instances using the {@link createPaywallView} function
+ * This class provides methods to present, dismiss, and handle events for flow views
+ * created with the Flow Builder. Create instances using the {@link createFlowView} function
  * rather than directly constructing this class.
  *
  * @public
  */
-export declare class PaywallViewController {
+export declare class FlowViewController {
     private id;
     private adaptyPlugin;
     private viewEmitter;
@@ -21,35 +21,35 @@ export declare class PaywallViewController {
      * and creates reference between native controller and JS instance
      * @internal
      */
-    static create(paywall: AdaptyPaywall, params: CreatePaywallViewParamsInput, adaptyPlugin: Adapty): Promise<PaywallViewController>;
+    static create(flow: AdaptyFlow, params: CreateFlowViewParamsInput, adaptyPlugin: Adapty): Promise<FlowViewController>;
     /**
      * Since constructors in JS cannot be async, it is not
      * preferred to create ViewControllers in direct way.
-     * Consider using @link{ViewController.create} instead
+     * Consider using {@link FlowViewController.create} instead
      *
      * @internal
      */
     private constructor();
     /**
-     * Presents the paywall view as a modal screen.
+     * Presents the flow view as a modal screen.
      *
      * @remarks
-     * Calling `present` on an already visible paywall view will result in an error.
-     * The paywall will be displayed with the configured presentation style on iOS.
-     * On Android, the paywall is always presented as a full-screen activity.
+     * Calling `present` on an already visible flow view will result in an error.
+     * The flow will be displayed with the configured presentation style on iOS.
+     * On Android, the flow 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 paywall is presented.
+     * @returns A promise that resolves when the flow is presented.
      * @throws {@link AdaptyError} if the view reference is invalid or the view is already presented.
      *
      * @example
      * Present with default full-screen style
      * ```typescript
-     * import { adapty, createPaywallView } from '@adapty/capacitor';
+     * import { adapty, createFlowView } from '@adapty/capacitor';
      *
-     * const paywall = await adapty.getPaywall({ placementId: 'YOUR_PLACEMENT_ID' });
-     * const view = await createPaywallView(paywall);
+     * const flow = await adapty.getFlow({ placementId: 'YOUR_PLACEMENT_ID' });
+     * const view = await createFlowView(flow);
      * await view.present();
      * ```
      *
@@ -63,20 +63,20 @@ export declare class PaywallViewController {
         iosPresentationStyle?: AdaptyIOSPresentationStyle;
     }): Promise<void>;
     /**
-     * Dismisses the paywall view.
+     * Dismisses the flow view.
      *
      * @remarks
-     * This method closes the paywall and cleans up associated resources.
+     * This method closes the flow and cleans up associated resources.
      * After dismissing, the view controller instance cannot be reused.
      *
-     * @returns A promise that resolves when the paywall is dismissed.
+     * @returns A promise that resolves when the flow is dismissed.
      * @throws {@link AdaptyError} if the view reference is invalid.
      *
      * @example
      * ```typescript
-     * import { createPaywallView } from '@adapty/capacitor';
+     * import { createFlowView } from '@adapty/capacitor';
      *
-     * const view = await createPaywallView(paywall);
+     * const view = await createFlowView(flow);
      * await view.present();
      * // ... later
      * await view.dismiss();
@@ -87,7 +87,7 @@ export declare class PaywallViewController {
      * Displays a dialog to the user.
      *
      * @remarks
-     * Use this method to show custom dialogs within the paywall flow.
+     * Use this method to show custom dialogs within the flow.
      * If you provide two actions in the config, the primary action should cancel the operation
      * and leave things unchanged, while the secondary action should confirm the operation.
      *
@@ -117,20 +117,20 @@ export declare class PaywallViewController {
     showDialog(config: AdaptyUiDialogConfig): Promise<AdaptyUiDialogActionType>;
     private onRequestClose;
     /**
-     * Registers event handlers for paywall UI events.
+     * Registers event handlers for flow UI events.
      *
      * @remarks
      * Each event type can have only one handler — new handlers replace existing ones.
-     * Default handlers are registered automatically in {@link createPaywallView} and provide standard closing behavior:
-     * - `onCloseButtonPress` - closes the paywall
-     * - `onAndroidSystemBack` - closes the paywall (Android only)
-     * - `onRestoreCompleted` - closes the paywall after successful restore
-     * - `onRenderingFailed` - closes the paywall when rendering fails
-     * - `onPurchaseCompleted` - closes the paywall after successful purchase
+     * Default handlers are registered automatically in {@link createFlowView} (see `DEFAULT_FLOW_EVENT_HANDLERS`).
+     * Only two defaults close the view; all others keep it open:
+     * - `onCloseButtonPress` - closes the view (returns `true`)
+     * - `onError` - closes the view (returns `true`)
+     * - all other handlers keep the view open by default (return `false`),
+     *   including `onAndroidSystemBack`, `onRestoreCompleted`, and `onPurchaseCompleted`
      *
-     * If you want to override these listeners, we strongly recommend returning `true`
-     * (or `purchaseResult.type !== 'user_cancelled'` in case of `onPurchaseCompleted`)
-     * from your custom listener to retain default closing behavior.
+     * Returning `true` from a handler closes the view; returning `false` keeps it open.
+     * To retain default behavior in a custom listener, return the same value as the default
+     * implementation (only `onCloseButtonPress` and `onError` close the view by default).
      *
      * Calling this method multiple times will replace previously registered handlers for provided events.
      *
@@ -142,9 +142,9 @@ export declare class PaywallViewController {
      * @example
      * Register custom event handlers
      * ```typescript
-     * import { createPaywallView } from '@adapty/capacitor';
+     * import { createFlowView } from '@adapty/capacitor';
      *
-     * const view = await createPaywallView(paywall);
+     * const view = await createFlowView(flow);
      *
      * const unsubscribe = await view.setEventHandlers({
      *   onPurchaseStarted: (product) => {
@@ -152,7 +152,7 @@ export declare class PaywallViewController {
      *   },
      *   onPurchaseCompleted: (result) => {
      *     console.log('Purchase completed:', result.type);
-     *     // Return true to keep default closing behavior
+     *     // Return true to close the view after purchase (default keeps it open)
      *     return result.type !== 'user_cancelled';
      *   },
      *   onPurchaseFailed: (error) => {
@@ -166,7 +166,7 @@ export declare class PaywallViewController {
      * unsubscribe();
      * ```
      */
-    setEventHandlers(eventHandlers?: Partial<EventHandlers>): Promise<() => void>;
+    setEventHandlers(eventHandlers?: Partial<FlowEventHandlers>): Promise<() => void>;
     /**
      * Clears all registered event handlers.
      *
@@ -179,7 +179,7 @@ export declare class PaywallViewController {
      *
      * @example
      * ```typescript
-     * const view = await createPaywallView(paywall);
+     * const view = await createFlowView(flow);
      * await view.setEventHandlers({ onPurchaseCompleted: handlePurchase });
      *
      * // Later, clear all handlers