@adapty/capacitor 3.17.1 → 4.0.0-beta.1

package/dist/plugin.cjs.js

@@ -813,6 +813,283 @@ var AdaptyDiscountPhaseCoder = class extends SimpleCoder {
 	}
 };
 
+//#endregion
+//#region src/coders/product-reference.ts
+var ProductReferenceCoder = class extends SimpleCoder {
+	constructor(..._args) {
+		super(..._args);
+		this.properties = {
+			flowProductId: {
+				key: "flow_product_id",
+				required: false,
+				type: "string"
+			},
+			vendorId: {
+				key: "vendor_product_id",
+				required: true,
+				type: "string"
+			},
+			adaptyId: {
+				key: "adapty_product_id",
+				required: true,
+				type: "string"
+			},
+			accessLevelId: {
+				key: "access_level_id",
+				required: true,
+				type: "string"
+			},
+			productType: {
+				key: "product_type",
+				required: true,
+				type: "string"
+			},
+			ios: {
+				promotionalOfferId: {
+					key: "promotional_offer_id",
+					required: false,
+					type: "string"
+				},
+				winBackOfferId: {
+					key: "win_back_offer_id",
+					required: false,
+					type: "string"
+				}
+			},
+			android: {
+				basePlanId: {
+					key: "base_plan_id",
+					required: false,
+					type: "string"
+				},
+				offerId: {
+					key: "offer_id",
+					required: false,
+					type: "string"
+				}
+			}
+		};
+	}
+};
+
+//#endregion
+//#region src/coders/array.ts
+var ArrayCoder = class {
+	constructor(coderFactory) {
+		this.coderFactory = coderFactory;
+	}
+	decode(input) {
+		const coder = this.coderFactory();
+		return input.map((item) => coder.decode(item));
+	}
+	encode(value) {
+		const coder = this.coderFactory();
+		return value.map((item) => coder.encode(item));
+	}
+};
+
+//#endregion
+//#region src/coders/adapty-placement.ts
+var AdaptyPlacementCoder = class extends SimpleCoder {
+	constructor(..._args) {
+		super(..._args);
+		this.properties = {
+			abTestName: {
+				key: "ab_test_name",
+				required: true,
+				type: "string"
+			},
+			audienceName: {
+				key: "audience_name",
+				required: true,
+				type: "string"
+			},
+			id: {
+				key: "developer_id",
+				required: true,
+				type: "string"
+			},
+			revision: {
+				key: "revision",
+				required: true,
+				type: "number"
+			},
+			audienceVersionId: {
+				key: "placement_audience_version_id",
+				required: true,
+				type: "string"
+			},
+			isTrackingPurchases: {
+				key: "is_tracking_purchases",
+				required: false,
+				type: "boolean"
+			}
+		};
+	}
+};
+
+//#endregion
+//#region src/coders/adapty-flow-paywall.ts
+const PROPERTIES = {
+	placement: {
+		key: "placement",
+		required: true,
+		type: "object",
+		converter: new AdaptyPlacementCoder()
+	},
+	id: {
+		key: "paywall_id",
+		required: true,
+		type: "string"
+	},
+	name: {
+		key: "paywall_name",
+		required: true,
+		type: "string"
+	},
+	products: {
+		key: "products",
+		required: true,
+		type: "array",
+		converter: new ArrayCoder(() => new ProductReferenceCoder())
+	},
+	variationId: {
+		key: "variation_id",
+		required: true,
+		type: "string"
+	},
+	webPurchaseUrl: {
+		key: "web_purchase_url",
+		required: false,
+		type: "string"
+	}
+};
+var AdaptyFlowPaywallCoder = class extends Coder {
+	constructor(..._args) {
+		super(..._args);
+		this.properties = PROPERTIES;
+	}
+	decode(data) {
+		const codablePart = super.decode(data);
+		return {
+			...codablePart,
+			productIdentifiers: codablePart.products.map((product) => ({
+				vendorProductId: product.vendorId,
+				adaptyProductId: product.adaptyId,
+				basePlanId: product.android?.basePlanId
+			}))
+		};
+	}
+	encode(data) {
+		const { productIdentifiers,...codablePart } = data;
+		return super.encode(codablePart);
+	}
+};
+
+//#endregion
+//#region src/coders/json.ts
+var JSONCoder = class {
+	decode(input) {
+		if (!input) return {};
+		return JSON.parse(input);
+	}
+	encode(value) {
+		if (Object.keys(value).length === 0) return "";
+		return JSON.stringify(value);
+	}
+};
+
+//#endregion
+//#region src/coders/adapty-remote-config.ts
+var AdaptyRemoteConfigCoder = class extends Coder {
+	constructor(..._args) {
+		super(..._args);
+		this.properties = {
+			data: {
+				key: "data",
+				required: true,
+				type: "string",
+				converter: new JSONCoder()
+			},
+			lang: {
+				key: "lang",
+				required: true,
+				type: "string"
+			}
+		};
+	}
+	decode(data) {
+		const codablePart = super.decode(data);
+		const dataString = JSON.stringify(codablePart.data);
+		return {
+			...codablePart,
+			dataString: dataString.length < 4 ? "" : dataString
+		};
+	}
+	encode(data) {
+		const { dataString,...codablePart } = data;
+		return super.encode(codablePart);
+	}
+};
+
+//#endregion
+//#region src/coders/adapty-flow.ts
+var AdaptyFlowCoder = class extends SimpleCoder {
+	constructor(..._args) {
+		super(..._args);
+		this.properties = {
+			placement: {
+				key: "placement",
+				required: true,
+				type: "object",
+				converter: new AdaptyPlacementCoder()
+			},
+			id: {
+				key: "flow_id",
+				required: true,
+				type: "string"
+			},
+			name: {
+				key: "flow_name",
+				required: true,
+				type: "string"
+			},
+			variationId: {
+				key: "variation_id",
+				required: true,
+				type: "string"
+			},
+			remoteConfigs: {
+				key: "remote_configs",
+				required: false,
+				type: "array",
+				converter: new ArrayCoder(() => new AdaptyRemoteConfigCoder())
+			},
+			flowVersionId: {
+				key: "flow_version_id",
+				required: false,
+				type: "string"
+			},
+			paywalls: {
+				key: "variations",
+				required: true,
+				type: "array",
+				converter: new ArrayCoder(() => new AdaptyFlowPaywallCoder())
+			},
+			responseCreatedAt: {
+				key: "response_created_at",
+				required: true,
+				type: "number"
+			},
+			payloadData: {
+				key: "payload_data",
+				required: false,
+				type: "string"
+			}
+		};
+	}
+};
+
 //#endregion
 //#region src/coders/adapty-identify-params.ts
 var AdaptyIdentifyParamsCoder = class {
@@ -982,92 +1259,6 @@ var AdaptyOnboardingBuilderCoder = class extends SimpleCoder {
 	}
 };
 
-//#endregion
-//#region src/coders/json.ts
-var JSONCoder = class {
-	decode(input) {
-		if (!input) return {};
-		return JSON.parse(input);
-	}
-	encode(value) {
-		if (Object.keys(value).length === 0) return "";
-		return JSON.stringify(value);
-	}
-};
-
-//#endregion
-//#region src/coders/adapty-remote-config.ts
-var AdaptyRemoteConfigCoder = class extends Coder {
-	constructor(..._args) {
-		super(..._args);
-		this.properties = {
-			data: {
-				key: "data",
-				required: true,
-				type: "string",
-				converter: new JSONCoder()
-			},
-			lang: {
-				key: "lang",
-				required: true,
-				type: "string"
-			}
-		};
-	}
-	decode(data) {
-		const codablePart = super.decode(data);
-		const dataString = JSON.stringify(codablePart.data);
-		return {
-			...codablePart,
-			dataString: dataString.length < 4 ? "" : dataString
-		};
-	}
-	encode(data) {
-		const { dataString,...codablePart } = data;
-		return super.encode(codablePart);
-	}
-};
-
-//#endregion
-//#region src/coders/adapty-placement.ts
-var AdaptyPlacementCoder = class extends SimpleCoder {
-	constructor(..._args) {
-		super(..._args);
-		this.properties = {
-			abTestName: {
-				key: "ab_test_name",
-				required: true,
-				type: "string"
-			},
-			audienceName: {
-				key: "audience_name",
-				required: true,
-				type: "string"
-			},
-			id: {
-				key: "developer_id",
-				required: true,
-				type: "string"
-			},
-			revision: {
-				key: "revision",
-				required: true,
-				type: "number"
-			},
-			audienceVersionId: {
-				key: "placement_audience_version_id",
-				required: true,
-				type: "string"
-			},
-			isTrackingPurchases: {
-				key: "is_tracking_purchases",
-				required: false,
-				type: "boolean"
-			}
-		};
-	}
-};
-
 //#endregion
 //#region src/coders/adapty-onboarding.ts
 var AdaptyOnboardingCoder = class extends Coder {
@@ -1137,26 +1328,6 @@ var AdaptyOnboardingCoder = class extends Coder {
 	}
 };
 
-//#endregion
-//#region src/coders/adapty-paywall-builder.ts
-var AdaptyPaywallBuilderCoder = class extends SimpleCoder {
-	constructor(..._args) {
-		super(..._args);
-		this.properties = {
-			id: {
-				key: "paywall_builder_id",
-				required: true,
-				type: "string"
-			},
-			lang: {
-				key: "lang",
-				required: true,
-				type: "string"
-			}
-		};
-	}
-};
-
 //#endregion
 //#region src/coders/adapty-subscription-offer-identifier.ts
 var AdaptySubscriptionOfferIdCoder = class extends SimpleCoder {
@@ -1177,22 +1348,6 @@ var AdaptySubscriptionOfferIdCoder = class extends SimpleCoder {
 	}
 };
 
-//#endregion
-//#region src/coders/array.ts
-var ArrayCoder = class {
-	constructor(coderFactory) {
-		this.coderFactory = coderFactory;
-	}
-	decode(input) {
-		const coder = this.coderFactory();
-		return input.map((item) => coder.decode(item));
-	}
-	encode(value) {
-		const coder = this.coderFactory();
-		return value.map((item) => coder.encode(item));
-	}
-};
-
 //#endregion
 //#region src/coders/adapty-subscription-offer.ts
 var AdaptySubscriptionOfferCoder = class extends SimpleCoder {
@@ -1286,207 +1441,64 @@ var AdaptyPaywallProductCoder = class extends SimpleCoder {
 		this.properties = {
 			vendorProductId: {
 				key: "vendor_product_id",
-				required: true,
-				type: "string"
-			},
-			adaptyId: {
-				key: "adapty_product_id",
-				required: true,
-				type: "string"
-			},
-			paywallProductIndex: {
-				key: "paywall_product_index",
-				required: true,
-				type: "number"
-			},
-			localizedDescription: {
-				key: "localized_description",
-				required: true,
-				type: "string"
-			},
-			localizedTitle: {
-				key: "localized_title",
-				required: true,
-				type: "string"
-			},
-			regionCode: {
-				key: "region_code",
-				required: false,
-				type: "string"
-			},
-			variationId: {
-				key: "paywall_variation_id",
-				required: true,
-				type: "string"
-			},
-			paywallABTestName: {
-				key: "paywall_ab_test_name",
-				required: true,
-				type: "string"
-			},
-			paywallName: {
-				key: "paywall_name",
-				required: true,
-				type: "string"
-			},
-			accessLevelId: {
-				key: "access_level_id",
-				required: true,
-				type: "string"
-			},
-			productType: {
-				key: "product_type",
-				required: true,
-				type: "string"
-			},
-			price: {
-				key: "price",
-				required: false,
-				type: "object",
-				converter: new AdaptyPriceCoder()
-			},
-			webPurchaseUrl: {
-				key: "web_purchase_url",
-				required: false,
-				type: "string"
-			},
-			payloadData: {
-				key: "payload_data",
-				required: false,
-				type: "string"
-			},
-			subscription: {
-				key: "subscription",
-				required: false,
-				type: "object",
-				converter: new AdaptySubscriptionDetailsCoder()
-			},
-			ios: { isFamilyShareable: {
-				key: "is_family_shareable",
-				required: true,
-				type: "boolean"
-			} }
-		};
-	}
-	getInput(data) {
-		return {
-			adapty_product_id: data.adapty_product_id,
-			access_level_id: data.access_level_id,
-			product_type: data.product_type,
-			paywall_product_index: data.paywall_product_index,
-			paywall_ab_test_name: data.paywall_ab_test_name,
-			payload_data: data.payload_data,
-			paywall_name: data.paywall_name,
-			paywall_variation_id: data.paywall_variation_id,
-			subscription_offer_identifier: data.subscription?.offer?.offer_identifier,
-			vendor_product_id: data.vendor_product_id
-		};
-	}
-};
-
-//#endregion
-//#region src/coders/product-reference.ts
-var ProductReferenceCoder = class extends SimpleCoder {
-	constructor(..._args) {
-		super(..._args);
-		this.properties = {
-			vendorId: {
-				key: "vendor_product_id",
-				required: true,
-				type: "string"
-			},
-			adaptyId: {
-				key: "adapty_product_id",
-				required: true,
-				type: "string"
-			},
-			accessLevelId: {
-				key: "access_level_id",
-				required: true,
-				type: "string"
-			},
-			productType: {
-				key: "product_type",
-				required: true,
-				type: "string"
-			},
-			ios: {
-				promotionalOfferId: {
-					key: "promotional_offer_id",
-					required: false,
-					type: "string"
-				},
-				winBackOfferId: {
-					key: "win_back_offer_id",
-					required: false,
-					type: "string"
-				}
-			},
-			android: {
-				basePlanId: {
-					key: "base_plan_id",
-					required: false,
-					type: "string"
-				},
-				offerId: {
-					key: "offer_id",
-					required: false,
-					type: "string"
-				}
-			}
-		};
-	}
-};
-
-//#endregion
-//#region src/coders/adapty-paywall.ts
-var AdaptyPaywallCoder = class extends Coder {
-	constructor(..._args) {
-		super(..._args);
-		this.properties = {
-			placement: {
-				key: "placement",
-				required: true,
-				type: "object",
-				converter: new AdaptyPlacementCoder()
+				required: true,
+				type: "string"
 			},
-			id: {
-				key: "paywall_id",
+			adaptyId: {
+				key: "adapty_product_id",
 				required: true,
 				type: "string"
 			},
-			name: {
-				key: "paywall_name",
+			paywallProductIndex: {
+				key: "paywall_product_index",
+				required: true,
+				type: "number"
+			},
+			localizedDescription: {
+				key: "localized_description",
 				required: true,
 				type: "string"
 			},
-			products: {
-				key: "products",
+			localizedTitle: {
+				key: "localized_title",
 				required: true,
-				type: "array",
-				converter: new ArrayCoder(() => new ProductReferenceCoder())
+				type: "string"
 			},
-			remoteConfig: {
-				key: "remote_config",
+			regionCode: {
+				key: "region_code",
 				required: false,
-				type: "object",
-				converter: new AdaptyRemoteConfigCoder()
+				type: "string"
 			},
 			variationId: {
-				key: "variation_id",
+				key: "paywall_variation_id",
 				required: true,
 				type: "string"
 			},
-			version: {
-				key: "response_created_at",
-				required: false,
-				type: "number"
+			paywallABTestName: {
+				key: "paywall_ab_test_name",
+				required: true,
+				type: "string"
+			},
+			paywallName: {
+				key: "paywall_name",
+				required: true,
+				type: "string"
+			},
+			accessLevelId: {
+				key: "access_level_id",
+				required: true,
+				type: "string"
+			},
+			productType: {
+				key: "product_type",
+				required: true,
+				type: "string"
 			},
-			paywallBuilder: {
-				key: "paywall_builder",
+			price: {
+				key: "price",
 				required: false,
 				type: "object",
-				converter: new AdaptyPaywallBuilderCoder()
+				converter: new AdaptyPriceCoder()
 			},
 			webPurchaseUrl: {
 				key: "web_purchase_url",
@@ -1498,29 +1510,33 @@ var AdaptyPaywallCoder = class extends Coder {
 				required: false,
 				type: "string"
 			},
-			requestLocale: {
-				key: "request_locale",
+			subscription: {
+				key: "subscription",
+				required: false,
+				type: "object",
+				converter: new AdaptySubscriptionDetailsCoder()
+			},
+			ios: { isFamilyShareable: {
+				key: "is_family_shareable",
 				required: true,
-				type: "string"
-			}
+				type: "boolean"
+			} }
 		};
 	}
-	decode(data) {
-		const codablePart = super.decode(data);
+	getInput(data) {
 		return {
-			...codablePart,
-			hasViewConfiguration: codablePart.paywallBuilder !== void 0,
-			productIdentifiers: codablePart.products.map((product) => ({
-				vendorProductId: product.vendorId,
-				adaptyProductId: product.adaptyId,
-				basePlanId: product.android?.basePlanId
-			}))
+			adapty_product_id: data.adapty_product_id,
+			access_level_id: data.access_level_id,
+			product_type: data.product_type,
+			paywall_product_index: data.paywall_product_index,
+			paywall_ab_test_name: data.paywall_ab_test_name,
+			payload_data: data.payload_data,
+			paywall_name: data.paywall_name,
+			paywall_variation_id: data.paywall_variation_id,
+			subscription_offer_identifier: data.subscription?.offer?.offer_identifier,
+			vendor_product_id: data.vendor_product_id
 		};
 	}
-	encode(data) {
-		const { hasViewConfiguration, productIdentifiers,...codablePart } = data;
-		return super.encode(codablePart);
-	}
 };
 
 //#endregion
@@ -1769,9 +1785,6 @@ var AdaptyProfileCoder = class extends SimpleCoder {
 
 //#endregion
 //#region src/coders/adapty-purchase-params.ts
-function isDeprecatedType(data) {
-	return typeof data === "object" && data !== null && "android" in data && typeof data.android === "object" && data.android !== null && "oldSubVendorProductId" in data.android && "prorationMode" in data.android;
-}
 var AdaptyPurchaseParamsCoder = class {
 	constructor(platform) {
 		this.platform = platform;
@@ -1779,16 +1792,6 @@ var AdaptyPurchaseParamsCoder = class {
 	encode(data) {
 		if (this.platform.OS !== "android") return {};
 		const purchaseParams = {};
-		if (isDeprecatedType(data)) {
-			if (data.android) {
-				purchaseParams["subscription_update_params"] = {
-					replacement_mode: data.android.prorationMode,
-					old_sub_vendor_product_id: data.android.oldSubVendorProductId
-				};
-				if (data.android.isOfferPersonalized) purchaseParams["is_offer_personalized"] = data.android.isOfferPersonalized;
-			}
-			return purchaseParams;
-		}
 		if (data.android) {
 			if (data.android.subscriptionUpdateParams) purchaseParams["subscription_update_params"] = {
 				replacement_mode: data.android.subscriptionUpdateParams.prorationMode,
@@ -1921,14 +1924,15 @@ const resolveAssetId = (asset, platformOS) => {
 };
 
 //#endregion
-//#region src/coders/adapty-ui-create-paywall-view-params.ts
-var AdaptyUICreatePaywallViewParamsCoder = class {
+//#region src/coders/adapty-ui-create-flow-view-params.ts
+var AdaptyUICreateFlowViewParamsCoder = class {
 	constructor(platform) {
 		this.platform = platform;
 	}
 	encode(data) {
 		const result = {};
 		if (data.prefetchProducts !== void 0) result.preload_products = data.prefetchProducts;
+		if (data.android?.enableSafeArea !== void 0) result.enable_safe_area_paddings = data.android.enableSafeArea;
 		if (data.loadTimeoutMs !== void 0) result.load_timeout = data.loadTimeoutMs / 1e3;
 		if (data.customTags) result.custom_tags = data.customTags;
 		if (data.customTimers) result.custom_timers = this.encodeCustomTimers(data.customTimers);
@@ -2263,11 +2267,11 @@ var CoderFactory = class {
 	createOnboardingCoder() {
 		return new AdaptyOnboardingCoder(this.deps.platform);
 	}
-	createPaywallBuilderCoder() {
-		return new AdaptyPaywallBuilderCoder(this.deps.platform);
+	createFlowCoder() {
+		return new AdaptyFlowCoder(this.deps.platform);
 	}
-	createPaywallCoder() {
-		return new AdaptyPaywallCoder(this.deps.platform);
+	createFlowPaywallCoder() {
+		return new AdaptyFlowPaywallCoder(this.deps.platform);
 	}
 	createPaywallProductCoder() {
 		return new AdaptyPaywallProductCoder(this.deps.platform);
@@ -2308,8 +2312,8 @@ var CoderFactory = class {
 	createUiCreateOnboardingViewParamsCoder() {
 		return new AdaptyUICreateOnboardingViewParamsCoder();
 	}
-	createUiCreatePaywallViewParamsCoder() {
-		return new AdaptyUICreatePaywallViewParamsCoder(this.deps.platform);
+	createUiCreateFlowViewParamsCoder() {
+		return new AdaptyUICreateFlowViewParamsCoder(this.deps.platform);
 	}
 	createUiDialogConfigCoder() {
 		return new AdaptyUiDialogConfigCoder(this.deps.platform);
@@ -2389,21 +2393,26 @@ const RefundPreference = Object.freeze({
 });
 
 //#endregion
-//#region src/types/paywall-events.ts
-const PaywallEventId = {
-	DidAppear: "paywall_view_did_appear",
-	DidDisappear: "paywall_view_did_disappear",
-	DidPerformAction: "paywall_view_did_perform_action",
-	DidSelectProduct: "paywall_view_did_select_product",
-	DidStartPurchase: "paywall_view_did_start_purchase",
-	DidFinishPurchase: "paywall_view_did_finish_purchase",
-	DidFailPurchase: "paywall_view_did_fail_purchase",
-	DidStartRestore: "paywall_view_did_start_restore",
-	DidFinishRestore: "paywall_view_did_finish_restore",
-	DidFailRestore: "paywall_view_did_fail_restore",
-	DidFailRendering: "paywall_view_did_fail_rendering",
-	DidFailLoadingProducts: "paywall_view_did_fail_loading_products",
-	DidFinishWebPaymentNavigation: "paywall_view_did_finish_web_payment_navigation"
+//#region src/types/flow-events.ts
+const FlowEventId = {
+	DidAppear: "flow_view_did_appear",
+	DidDisappear: "flow_view_did_disappear",
+	DidPerformAction: "flow_view_did_perform_action",
+	DidSelectProduct: "flow_view_did_select_product",
+	DidStartPurchase: "flow_view_did_start_purchase",
+	DidFinishPurchase: "flow_view_did_finish_purchase",
+	DidFailPurchase: "flow_view_did_fail_purchase",
+	DidStartRestore: "flow_view_did_start_restore",
+	DidFinishRestore: "flow_view_did_finish_restore",
+	DidFailRestore: "flow_view_did_fail_restore",
+	DidReceiveError: "flow_view_did_receive_error",
+	DidFailLoadingProducts: "flow_view_did_fail_loading_products",
+	DidFinishWebPaymentNavigation: "flow_view_did_finish_web_payment_navigation",
+	DidRequestAppReview: "flow_view_did_request_app_review",
+	DidReceiveAnalyticEvent: "flow_view_did_receive_analytic_event",
+	DidAskPermission: "flow_view_did_ask_permission",
+	ObserverDidInitiatePurchase: "flow_view_observer_did_initiate_purchase",
+	ObserverDidInitiateRestore: "flow_view_observer_did_initiate_restore"
 };
 
 //#endregion
@@ -2419,13 +2428,13 @@ const OnboardingEventId = {
 };
 
 //#endregion
-//#region src/ui-builder/paywall-event-mapping.ts
+//#region src/ui-builder/flow-event-mapping.ts
 /**
 * Resolves native event to handler name based on event data
 */
-({
-	[PaywallEventId.DidPerformAction]: (event) => {
-		if (event.id !== PaywallEventId.DidPerformAction) return null;
+const NATIVE_EVENT_RESOLVER$1 = {
+	[FlowEventId.DidPerformAction]: (event) => {
+		if (event.id !== FlowEventId.DidPerformAction) return null;
 		const actionMap = {
 			close: "onCloseButtonPress",
 			system_back: "onAndroidSystemBack",
@@ -2434,41 +2443,76 @@ const OnboardingEventId = {
 		};
 		return actionMap[event.action.type] || null;
 	},
-	[PaywallEventId.DidAppear]: () => "onPaywallShown",
-	[PaywallEventId.DidDisappear]: () => "onPaywallClosed",
-	[PaywallEventId.DidSelectProduct]: () => "onProductSelected",
-	[PaywallEventId.DidStartPurchase]: () => "onPurchaseStarted",
-	[PaywallEventId.DidFinishPurchase]: () => "onPurchaseCompleted",
-	[PaywallEventId.DidFailPurchase]: () => "onPurchaseFailed",
-	[PaywallEventId.DidStartRestore]: () => "onRestoreStarted",
-	[PaywallEventId.DidFinishRestore]: () => "onRestoreCompleted",
-	[PaywallEventId.DidFailRestore]: () => "onRestoreFailed",
-	[PaywallEventId.DidFailRendering]: () => "onRenderingFailed",
-	[PaywallEventId.DidFailLoadingProducts]: () => "onLoadingProductsFailed",
-	[PaywallEventId.DidFinishWebPaymentNavigation]: () => "onWebPaymentNavigationFinished"
-});
+	[FlowEventId.DidAppear]: () => "onAppeared",
+	[FlowEventId.DidDisappear]: () => "onDisappeared",
+	[FlowEventId.DidSelectProduct]: () => "onProductSelected",
+	[FlowEventId.DidStartPurchase]: () => "onPurchaseStarted",
+	[FlowEventId.DidFinishPurchase]: () => "onPurchaseCompleted",
+	[FlowEventId.DidFailPurchase]: () => "onPurchaseFailed",
+	[FlowEventId.DidStartRestore]: () => "onRestoreStarted",
+	[FlowEventId.DidFinishRestore]: () => "onRestoreCompleted",
+	[FlowEventId.DidFailRestore]: () => "onRestoreFailed",
+	[FlowEventId.DidReceiveError]: () => "onError",
+	[FlowEventId.DidFailLoadingProducts]: () => "onLoadingProductsFailed",
+	[FlowEventId.DidFinishWebPaymentNavigation]: () => "onWebPaymentNavigationFinished",
+	[FlowEventId.DidRequestAppReview]: () => "onRequestAppReview",
+	[FlowEventId.DidReceiveAnalyticEvent]: () => "onAnalytics",
+	[FlowEventId.DidAskPermission]: () => "onRequestPermission",
+	[FlowEventId.ObserverDidInitiatePurchase]: () => "onObserverPurchaseInitiated",
+	[FlowEventId.ObserverDidInitiateRestore]: () => "onObserverRestoreInitiated"
+};
 /**
 * Maps handler name to native event name
 * Used in addListener/addInternalListener to subscribe to correct native event
 */
-({
-	onCloseButtonPress: PaywallEventId.DidPerformAction,
-	onAndroidSystemBack: PaywallEventId.DidPerformAction,
-	onUrlPress: PaywallEventId.DidPerformAction,
-	onCustomAction: PaywallEventId.DidPerformAction,
-	onPaywallShown: PaywallEventId.DidAppear,
-	onPaywallClosed: PaywallEventId.DidDisappear,
-	onProductSelected: PaywallEventId.DidSelectProduct,
-	onPurchaseStarted: PaywallEventId.DidStartPurchase,
-	onPurchaseCompleted: PaywallEventId.DidFinishPurchase,
-	onPurchaseFailed: PaywallEventId.DidFailPurchase,
-	onRestoreStarted: PaywallEventId.DidStartRestore,
-	onRestoreCompleted: PaywallEventId.DidFinishRestore,
-	onRestoreFailed: PaywallEventId.DidFailRestore,
-	onRenderingFailed: PaywallEventId.DidFailRendering,
-	onLoadingProductsFailed: PaywallEventId.DidFailLoadingProducts,
-	onWebPaymentNavigationFinished: PaywallEventId.DidFinishWebPaymentNavigation
-});
+const HANDLER_TO_NATIVE_EVENT$1 = {
+	onCloseButtonPress: FlowEventId.DidPerformAction,
+	onAndroidSystemBack: FlowEventId.DidPerformAction,
+	onUrlPress: FlowEventId.DidPerformAction,
+	onCustomAction: FlowEventId.DidPerformAction,
+	onAppeared: FlowEventId.DidAppear,
+	onDisappeared: FlowEventId.DidDisappear,
+	onProductSelected: FlowEventId.DidSelectProduct,
+	onPurchaseStarted: FlowEventId.DidStartPurchase,
+	onPurchaseCompleted: FlowEventId.DidFinishPurchase,
+	onPurchaseFailed: FlowEventId.DidFailPurchase,
+	onRestoreStarted: FlowEventId.DidStartRestore,
+	onRestoreCompleted: FlowEventId.DidFinishRestore,
+	onRestoreFailed: FlowEventId.DidFailRestore,
+	onError: FlowEventId.DidReceiveError,
+	onLoadingProductsFailed: FlowEventId.DidFailLoadingProducts,
+	onWebPaymentNavigationFinished: FlowEventId.DidFinishWebPaymentNavigation,
+	onRequestAppReview: FlowEventId.DidRequestAppReview,
+	onAnalytics: FlowEventId.DidReceiveAnalyticEvent,
+	onRequestPermission: FlowEventId.DidAskPermission,
+	onObserverPurchaseInitiated: FlowEventId.ObserverDidInitiatePurchase,
+	onObserverRestoreInitiated: FlowEventId.ObserverDidInitiateRestore
+};
+function extractFlowCallbackArgs(handlerName, event) {
+	switch (event.id) {
+		case FlowEventId.DidSelectProduct: return [event.productId];
+		case FlowEventId.DidStartPurchase: return [event.product];
+		case FlowEventId.DidFinishPurchase: return [event.purchaseResult, event.product];
+		case FlowEventId.DidFailPurchase: return [event.error, event.product];
+		case FlowEventId.DidFinishRestore: return [event.profile];
+		case FlowEventId.DidFailRestore:
+		case FlowEventId.DidReceiveError:
+		case FlowEventId.DidFailLoadingProducts: return [event.error];
+		case FlowEventId.DidPerformAction:
+			if (handlerName === "onUrlPress" && event.action.type === "open_url") return [event.action.value, event.action.openIn];
+			if (handlerName === "onCustomAction" && event.action.type === "custom") return [event.action.value];
+			return [];
+		case FlowEventId.DidFinishWebPaymentNavigation: return [event.product, event.error];
+		case FlowEventId.DidReceiveAnalyticEvent: return [event.name, event.params];
+		case FlowEventId.DidAskPermission: return [event.permission, event.customArgs];
+		case FlowEventId.ObserverDidInitiatePurchase:
+		case FlowEventId.ObserverDidInitiateRestore: return [];
+		case FlowEventId.DidRequestAppReview:
+		case FlowEventId.DidAppear:
+		case FlowEventId.DidDisappear:
+		case FlowEventId.DidStartRestore: return [];
+	}
+}
 
 //#endregion
 //#region src/ui-builder/onboarding-event-mapping.ts
@@ -2497,6 +2541,13 @@ Object.entries(HANDLER_TO_EVENT_CONFIG).reduce((acc, [handlerName, config]) => {
 	return acc;
 }, {});
 
+//#endregion
+//#region src/ui-builder/types.ts
+const AdaptyUiDialogActionType = Object.freeze({
+	primary: "primary",
+	secondary: "secondary"
+});
+
 //#endregion
 //#region src/coders/parse.ts
 function parseMethodResult$1(factory, input, resultType, ctx) {
@@ -2549,10 +2600,9 @@ function getCoder(factory, type, ctx) {
 	switch (type) {
 		case "AdaptyError": return factory.createNativeErrorCoder();
 		case "AdaptyProfile": return factory.createProfileCoder();
-		case "AdaptyPaywall": return factory.createPaywallCoder();
+		case "AdaptyFlow": return factory.createFlowCoder();
 		case "AdaptyPaywallProduct": return factory.createPaywallProductCoder();
 		case "AdaptyRemoteConfig": return factory.createRemoteConfigCoder();
-		case "AdaptyPaywallBuilder": return factory.createPaywallBuilderCoder();
 		case "AdaptyOnboarding": return factory.createOnboardingCoder();
 		case "AdaptyPurchaseResult": return factory.createPurchaseResultCoder();
 		case "AdaptyInstallationStatus": return factory.createInstallationStatusCoder();
@@ -2568,8 +2618,8 @@ function getCoder(factory, type, ctx) {
 }
 
 //#endregion
-//#region src/coders/parse-paywall.ts
-function parsePaywallEvent$1(factory, input, ctx) {
+//#region src/coders/parse-flow.ts
+function parseFlowEvent$1(factory, input, ctx) {
 	let obj;
 	try {
 		obj = JSON.parse(input);
@@ -2577,7 +2627,7 @@ function parsePaywallEvent$1(factory, input, ctx) {
 		throw AdaptyError.failedToDecode(`Failed to decode event: ${error?.message}`);
 	}
 	const eventId = obj["id"];
-	if (!eventId?.startsWith("paywall_view_")) return null;
+	if (!eventId?.startsWith("flow_view_")) return null;
 	const viewObj = obj["view"];
 	const view = {
 		id: viewObj["id"],
@@ -2585,59 +2635,59 @@ function parsePaywallEvent$1(factory, input, ctx) {
 		variationId: viewObj["variation_id"]
 	};
 	switch (eventId) {
-		case PaywallEventId.DidAppear: return {
+		case FlowEventId.DidAppear: return {
 			id: eventId,
 			view
 		};
-		case PaywallEventId.DidDisappear: return {
+		case FlowEventId.DidDisappear: return {
 			id: eventId,
 			view
 		};
-		case PaywallEventId.DidPerformAction: {
+		case FlowEventId.DidPerformAction: {
 			const actionObj = obj["action"];
 			return {
 				id: eventId,
 				view,
-				action: parsePaywallUserAction(actionObj)
+				action: parseFlowUserAction(actionObj)
 			};
 		}
-		case PaywallEventId.DidSelectProduct: return {
+		case FlowEventId.DidSelectProduct: return {
 			id: eventId,
 			view,
 			productId: obj["product_id"] ?? ""
 		};
-		case PaywallEventId.DidStartPurchase: return {
+		case FlowEventId.DidStartPurchase: return {
 			id: eventId,
 			view,
-			product: getPaywallCoder(factory, "product").decode(obj["product"])
+			product: getFlowCoder(factory, "product").decode(obj["product"])
 		};
-		case PaywallEventId.DidFinishPurchase: return {
+		case FlowEventId.DidFinishPurchase: return {
 			id: eventId,
 			view,
-			purchaseResult: getPaywallCoder(factory, "purchaseResult").decode(obj["purchased_result"]),
-			product: getPaywallCoder(factory, "product").decode(obj["product"])
+			purchaseResult: getFlowCoder(factory, "purchaseResult").decode(obj["purchased_result"]),
+			product: getFlowCoder(factory, "product").decode(obj["product"])
 		};
-		case PaywallEventId.DidFailPurchase: {
-			const errorCoder = getPaywallCoder(factory, "error");
+		case FlowEventId.DidFailPurchase: {
+			const errorCoder = getFlowCoder(factory, "error");
 			const decodedError = errorCoder.decode(obj["error"]);
 			return {
 				id: eventId,
 				view,
 				error: errorCoder.getError(decodedError),
-				product: getPaywallCoder(factory, "product").decode(obj["product"])
+				product: getFlowCoder(factory, "product").decode(obj["product"])
 			};
 		}
-		case PaywallEventId.DidStartRestore: return {
+		case FlowEventId.DidStartRestore: return {
 			id: eventId,
 			view
 		};
-		case PaywallEventId.DidFinishRestore: return {
+		case FlowEventId.DidFinishRestore: return {
 			id: eventId,
 			view,
-			profile: getPaywallCoder(factory, "profile").decode(obj["profile"])
+			profile: getFlowCoder(factory, "profile").decode(obj["profile"])
 		};
-		case PaywallEventId.DidFailRestore: {
-			const errorCoder = getPaywallCoder(factory, "error");
+		case FlowEventId.DidFailRestore: {
+			const errorCoder = getFlowCoder(factory, "error");
 			const decodedError = errorCoder.decode(obj["error"]);
 			return {
 				id: eventId,
@@ -2645,8 +2695,8 @@ function parsePaywallEvent$1(factory, input, ctx) {
 				error: errorCoder.getError(decodedError)
 			};
 		}
-		case PaywallEventId.DidFailRendering: {
-			const errorCoder = getPaywallCoder(factory, "error");
+		case FlowEventId.DidReceiveError: {
+			const errorCoder = getFlowCoder(factory, "error");
 			const decodedError = errorCoder.decode(obj["error"]);
 			return {
 				id: eventId,
@@ -2654,8 +2704,8 @@ function parsePaywallEvent$1(factory, input, ctx) {
 				error: errorCoder.getError(decodedError)
 			};
 		}
-		case PaywallEventId.DidFailLoadingProducts: {
-			const errorCoder = getPaywallCoder(factory, "error");
+		case FlowEventId.DidFailLoadingProducts: {
+			const errorCoder = getFlowCoder(factory, "error");
 			const decodedError = errorCoder.decode(obj["error"]);
 			return {
 				id: eventId,
@@ -2663,20 +2713,51 @@ function parsePaywallEvent$1(factory, input, ctx) {
 				error: errorCoder.getError(decodedError)
 			};
 		}
-		case PaywallEventId.DidFinishWebPaymentNavigation: return {
+		case FlowEventId.DidFinishWebPaymentNavigation: return {
 			id: eventId,
 			view,
-			product: obj["product"] ? getPaywallCoder(factory, "product").decode(obj["product"]) : void 0,
+			product: obj["product"] ? getFlowCoder(factory, "product").decode(obj["product"]) : void 0,
 			error: obj["error"] ? (() => {
-				const errorCoder = getPaywallCoder(factory, "error");
+				const errorCoder = getFlowCoder(factory, "error");
 				const decodedError = errorCoder.decode(obj["error"]);
 				return errorCoder.getError(decodedError);
 			})() : void 0
 		};
+		case FlowEventId.DidRequestAppReview: return {
+			id: eventId,
+			view
+		};
+		case FlowEventId.DidReceiveAnalyticEvent: {
+			const params = obj["params"];
+			return {
+				id: eventId,
+				view,
+				name: typeof obj["name"] === "string" ? obj["name"] : "",
+				params: typeof params === "object" && params !== null ? params : {}
+			};
+		}
+		case FlowEventId.DidAskPermission: return {
+			id: eventId,
+			view,
+			eventId: typeof obj["event_id"] === "string" ? obj["event_id"] : "",
+			permission: typeof obj["permission"] === "string" ? obj["permission"] : "",
+			customArgs: typeof obj["custom_args"] === "object" && obj["custom_args"] !== null ? obj["custom_args"] : {}
+		};
+		case FlowEventId.ObserverDidInitiatePurchase: return {
+			id: eventId,
+			view,
+			eventId: typeof obj["event_id"] === "string" ? obj["event_id"] : "",
+			product: getFlowCoder(factory, "product").decode(obj["product"])
+		};
+		case FlowEventId.ObserverDidInitiateRestore: return {
+			id: eventId,
+			view,
+			eventId: typeof obj["event_id"] === "string" ? obj["event_id"] : ""
+		};
 		default: return null;
 	}
 }
-function parsePaywallUserAction(actionObj) {
+function parseFlowUserAction(actionObj) {
 	const type = actionObj["type"];
 	switch (type) {
 		case "open_url": return {
@@ -2692,7 +2773,7 @@ function parsePaywallUserAction(actionObj) {
 		case "system_back": return { type };
 	}
 }
-function getPaywallCoder(factory, type, _ctx) {
+function getFlowCoder(factory, type, _ctx) {
 	switch (type) {
 		case "product": return factory.createPaywallProductCoder();
 		case "profile": return factory.createProfileCoder();
@@ -2884,7 +2965,7 @@ const AdaptyCapacitorPlugin = core.registerPlugin('AdaptyCapacitorPlugin', {
     web: () => Promise.resolve().then(function () { return web; }).then((m) => new m.AdaptyCapacitorPluginWeb()),
 });
 
-var VERSION = '3.17.1';
+var VERSION = '4.0.0-beta.1';
 
 /**
  * Capacitor implementation of IPlatformAdapter
@@ -3110,13 +3191,13 @@ class AdaptyEmitter {
 }
 
 const defaultAdaptyOptions = {
-    get_paywall: {
+    get_flow: {
         params: {
             fetchPolicy: FetchPolicy.ReloadRevalidatingCacheData,
             loadTimeoutMs: 5000,
         },
     },
-    get_paywall_for_default_audience: {
+    get_flow_for_default_audience: {
         params: {
             fetchPolicy: FetchPolicy.ReloadRevalidatingCacheData,
         },
@@ -3152,7 +3233,7 @@ class Adapty {
         this.nonWaitingMethods = [
             'activate',
             'is_activated',
-            'get_paywall_for_default_audience',
+            'get_flow_for_default_audience',
             'get_onboarding_for_default_audience',
             'set_log_level',
             'set_fallback',
@@ -3270,8 +3351,6 @@ class Adapty {
      * so background activities can be performed and cache can be updated.
      *
      * @example
-     *
-     * @example
      * Usage with your user identifier from your system
      * ```typescript
      * await adapty.activate({
@@ -3404,39 +3483,37 @@ class Adapty {
         return await this.handleMethodCall(method, JSON.stringify(args), ctx, log, 'AdaptyInstallationStatus');
     }
     /**
-     * Fetches the paywall by the specified placement.
+     * Fetches the flow by the specified placement.
      *
      * @remarks
      * With Adapty, you can remotely configure the products and offers in your app
-     * by simply adding them to paywalls – no need for hardcoding them.
+     * by simply adding them to flows – no need for hardcoding them.
      * The only thing you hardcode is the placement ID.
-     * This flexibility allows you to easily update paywalls, products, and offers,
+     * This flexibility allows you to easily update flows, products, and offers,
      * or run A/B tests, all without the need for a new app release.
      *
-     * @param options - The options for fetching the paywall
+     * @param options - The options for fetching the flow
      * @param options.placementId - The identifier of the desired placement. This is the value you specified when creating a placement in the Adapty Dashboard.
-     * @param options.locale - Optional. The identifier of the paywall localization. Default: `'en'`. See {@link https://docs.adapty.io/docs/localizations-and-locale-codes | Localizations and locale codes} for more information.
-     * @param options.params - Optional. Additional parameters for fetching the paywall, including fetch policy and load timeout.
-     * @returns A promise that resolves with the requested {@link AdaptyPaywall}.
-     * @throws Error if the paywall with the specified ID is not found or if your bundle ID does not match with your Adapty Dashboard setup.
+     * @param options.params - Optional. Additional parameters for fetching the flow, including fetch policy and load timeout.
+     * @returns A promise that resolves with the requested {@link AdaptyFlow}.
+     * @throws Error if the flow with the specified ID is not found or if your bundle ID does not match with your Adapty Dashboard setup.
      *
      * @example
      * ```typescript
      * import { adapty } from '@adapty/capacitor';
      *
      * try {
-     *   const paywall = await adapty.getPaywall({
+     *   const flow = await adapty.getFlow({
      *     placementId: 'YOUR_PLACEMENT_ID',
-     *     locale: 'en',
      *   });
-     *   console.log('Paywall fetched successfully');
+     *   console.log('Flow fetched successfully');
      * } catch (error) {
-     *   console.error('Failed to fetch paywall:', error);
+     *   console.error('Failed to fetch flow:', error);
      * }
      * ```
      */
-    async getPaywall(options) {
-        const method = 'get_paywall';
+    async getFlow(options) {
+        const method = 'get_flow';
         const optionsWithDefault = mergeOptions(options, this.options[method]);
         const params = optionsWithDefault.params;
         const ctx = new LogContext();
@@ -3446,54 +3523,51 @@ class Adapty {
             method,
             placement_id: optionsWithDefault.placementId,
             load_timeout: params.loadTimeoutMs / 1000,
-            locale: optionsWithDefault.locale,
             fetch_policy: params.fetchPolicy === 'return_cache_data_if_not_expired_else_load'
                 ? { type: params.fetchPolicy, max_age: params.maxAgeSeconds }
                 : { type: params.fetchPolicy },
         };
         const args = filterUndefined(argsWithUndefined);
-        return await this.handleMethodCall(method, JSON.stringify(args), ctx, log, 'AdaptyPaywall');
+        return await this.handleMethodCall(method, JSON.stringify(args), ctx, log, 'AdaptyFlow');
     }
     /**
-     * Fetches the paywall of the specified placement for the **All Users** audience.
+     * Fetches the flow of the specified placement for the **All Users** audience.
      *
      * @remarks
      * With Adapty, you can remotely configure the products and offers in your app
-     * by simply adding them to paywalls – no need for hardcoding them.
+     * by simply adding them to flows – no need for hardcoding them.
      * The only thing you hardcode is the placement ID.
      *
-     * However, it's crucial to understand that the recommended approach is to fetch the paywall
-     * through the placement ID by the {@link getPaywall} method.
-     * The `getPaywallForDefaultAudience` method should be a last resort due to its significant drawbacks:
+     * However, it's crucial to understand that the recommended approach is to fetch the flow
+     * through the placement ID by the {@link getFlow} method.
+     * The `getFlowForDefaultAudience` method should be a last resort due to its significant drawbacks:
      * - Potential backward compatibility issues
-     * - Loss of targeting (all users see the same paywall)
+     * - Loss of targeting (all users see the same flow)
      *
      * See {@link https://docs.adapty.io/docs/capacitor-get-pb-paywalls#get-a-paywall-for-a-default-audience-to-fetch-it-faster | documentation} for more details.
      *
-     * @param options - The options for fetching the paywall
+     * @param options - The options for fetching the flow
      * @param options.placementId - The identifier of the desired placement.
-     * @param options.locale - Optional. The identifier of the paywall localization. Default: `'en'`.
-     * @param options.params - Optional. Additional parameters for fetching the paywall.
-     * @returns A promise that resolves with the requested {@link AdaptyPaywall}.
-     * @throws Error if the paywall with the specified ID is not found.
+     * @param options.params - Optional. Additional parameters for fetching the flow.
+     * @returns A promise that resolves with the requested {@link AdaptyFlow}.
+     * @throws Error if the flow with the specified ID is not found.
      *
      * @example
      * ```typescript
      * import { adapty } from '@adapty/capacitor';
      *
      * try {
-     *   const paywall = await adapty.getPaywallForDefaultAudience({
+     *   const flow = await adapty.getFlowForDefaultAudience({
      *     placementId: 'YOUR_PLACEMENT_ID',
-     *     locale: 'en',
      *   });
      * } catch (error) {
-     *   console.error('Failed to fetch paywall:', error);
+     *   console.error('Failed to fetch flow:', error);
      * }
      * ```
      */
-    async getPaywallForDefaultAudience(options) {
+    async getFlowForDefaultAudience(options) {
         var _a;
-        const method = 'get_paywall_for_default_audience';
+        const method = 'get_flow_for_default_audience';
         const optionsWithDefault = mergeOptions(options, this.options[method]);
         const params = optionsWithDefault.params;
         const ctx = new LogContext();
@@ -3502,20 +3576,19 @@ class Adapty {
         const argsWithUndefined = {
             method,
             placement_id: optionsWithDefault.placementId,
-            locale: optionsWithDefault.locale,
             fetch_policy: params.fetchPolicy === 'return_cache_data_if_not_expired_else_load'
                 ? { type: params.fetchPolicy, max_age: params.maxAgeSeconds }
                 : { type: (_a = params.fetchPolicy) !== null && _a !== void 0 ? _a : 'reload_revalidating_cache_data' },
         };
         const args = filterUndefined(argsWithUndefined);
-        return await this.handleMethodCall(method, JSON.stringify(args), ctx, log, 'AdaptyPaywall');
+        return await this.handleMethodCall(method, JSON.stringify(args), ctx, log, 'AdaptyFlow');
     }
     /**
-     * Fetches a list of products associated with a provided paywall.
+     * Fetches a list of products associated with a provided flow.
      *
      * @param options - The options object
-     * @param options.paywall - A paywall to fetch products for. You can get it using {@link getPaywall} method.
-     * @returns A promise that resolves with a list of {@link AdaptyPaywallProduct} associated with a provided paywall.
+     * @param options.flow - A flow to fetch products for. You can get it using {@link getFlow} method.
+     * @returns A promise that resolves with a list of {@link AdaptyPaywallProduct} associated with a provided flow.
      * @throws Error if an error occurs while fetching products.
      *
      * @example
@@ -3523,8 +3596,8 @@ class Adapty {
      * import { adapty } from '@adapty/capacitor';
      *
      * try {
-     *   const paywall = await adapty.getPaywall({ placementId: 'YOUR_PLACEMENT_ID' });
-     *   const products = await adapty.getPaywallProducts({ paywall });
+     *   const flow = await adapty.getFlow({ placementId: 'YOUR_PLACEMENT_ID' });
+     *   const products = await adapty.getPaywallProducts({ flow });
      *   console.log('Products:', products);
      * } catch (error) {
      *   console.error('Failed to fetch products:', error);
@@ -3536,10 +3609,10 @@ class Adapty {
         const ctx = new LogContext();
         const log = ctx.call({ methodName: method });
         log.start(() => ({ options }));
-        const paywallCoder = coderFactory.createPaywallCoder();
+        const coder = coderFactory.createFlowCoder();
         const argsWithUndefined = {
             method,
-            paywall: this.encodeWithLogging(paywallCoder, options.paywall, 'AdaptyPaywall', ctx),
+            flow: this.encodeWithLogging(coder, options.flow, 'AdaptyFlow', ctx),
         };
         const args = filterUndefined(argsWithUndefined);
         return await this.handleMethodCall(method, JSON.stringify(args), ctx, log, 'Array<AdaptyPaywallProduct>');
@@ -3547,6 +3620,8 @@ class Adapty {
     /**
      * Fetches the onboarding by the specified placement.
      *
+     * @deprecated Since 4.0.0. Migrate onboardings to the Flow Builder API.
+     *
      * @remarks
      * When you create an onboarding with the no-code builder, it's stored as a container with configuration
      * that your app needs to fetch and display. This container manages the entire experience - what content appears,
@@ -3600,6 +3675,8 @@ class Adapty {
     /**
      * Fetches the onboarding of the specified placement for the **All Users** audience.
      *
+     * @deprecated Since 4.0.0. Migrate onboardings to the Flow Builder API.
+     *
      * @remarks
      * It's crucial to understand that the recommended approach is to fetch the onboarding
      * by the {@link getOnboarding} method. The `getOnboardingForDefaultAudience` method
@@ -3733,19 +3810,19 @@ class Adapty {
         await this.handleMethodCall(method, JSON.stringify(args), ctx, log);
     }
     /**
-     * Logs a paywall view event.
+     * Logs a flow view event.
      *
      * @remarks
-     * Adapty helps you to measure the performance of the paywalls.
-     * We automatically collect all the metrics related to purchases except for custom paywall views.
-     * This is because only you know when the paywall was shown to a customer.
+     * Adapty helps you to measure the performance of the flows.
+     * We automatically collect all the metrics related to purchases except for custom flow views.
+     * This is because only you know when the flow was shown to a customer.
      *
-     * Whenever you show a paywall to your user,
+     * Whenever you show a flow to your user,
      * call this function to log the event,
-     * and it will be accumulated in the paywall metrics.
+     * and it will be accumulated in the flow metrics.
      *
      * @param options - The options object
-     * @param options.paywall - The paywall object that was shown to the user.
+     * @param options.flow - The flow object that was shown to the user.
      * @returns A promise that resolves when the event is logged.
      * @throws Error if an error occurs while logging the event.
      *
@@ -3753,20 +3830,20 @@ class Adapty {
      * ```typescript
      * import { adapty } from '@adapty/capacitor';
      *
-     * const paywall = await adapty.getPaywall({ placementId: 'YOUR_PLACEMENT_ID' });
-     * // ...after opening the paywall
-     * await adapty.logShowPaywall({ paywall });
+     * const flow = await adapty.getFlow({ placementId: 'YOUR_PLACEMENT_ID' });
+     * // ...after opening the flow
+     * await adapty.logShowFlow({ flow });
      * ```
      */
-    async logShowPaywall(options) {
-        const method = 'log_show_paywall';
+    async logShowFlow(options) {
+        const method = 'log_show_flow';
         const ctx = new LogContext();
         const log = ctx.call({ methodName: method });
         log.start(() => ({ options }));
-        const paywallCoder = coderFactory.createPaywallCoder();
+        const coder = coderFactory.createFlowCoder();
         const argsWithUndefined = {
             method,
-            paywall: this.encodeWithLogging(paywallCoder, options.paywall, 'AdaptyPaywall', ctx),
+            flow: this.encodeWithLogging(coder, options.flow, 'AdaptyFlow', ctx),
         };
         const args = filterUndefined(argsWithUndefined);
         await this.handleMethodCall(method, JSON.stringify(args), ctx, log);
@@ -3775,7 +3852,8 @@ class Adapty {
      * Opens a web paywall in the default browser.
      *
      * @param options - The options object
-     * @param options.paywallOrProduct - The paywall or product to open as a web paywall.
+     * @param options.paywallOrProduct - The flow paywall or product to open as a web paywall.
+     * @param options.openIn - Optional. Where to open the web paywall ({@link WebPresentation}).
      * @returns A promise that resolves when the web paywall is opened.
      * @throws Error if an error occurs while opening the web paywall.
      *
@@ -3784,8 +3862,8 @@ class Adapty {
      * import { adapty } from '@adapty/capacitor';
      *
      * try {
-     *   const paywall = await adapty.getPaywall({ placementId: 'YOUR_PLACEMENT_ID' });
-     *   await adapty.openWebPaywall({ paywallOrProduct: paywall });
+     *   const flow = await adapty.getFlow({ placementId: 'YOUR_PLACEMENT_ID' });
+     *   await adapty.openWebPaywall({ paywallOrProduct: flow.paywalls[0] });
      * } catch (error) {
      *   console.error('Failed to open web paywall:', error);
      * }
@@ -3796,11 +3874,11 @@ class Adapty {
         const ctx = new LogContext();
         const log = ctx.call({ methodName: method });
         log.start(() => ({ options }));
-        const paywallCoder = coderFactory.createPaywallCoder();
+        const flowPaywallCoder = coderFactory.createFlowPaywallCoder();
         const productCoder = coderFactory.createPaywallProductCoder();
         const argsWithUndefined = Object.assign(Object.assign({ method }, (this.isPaywallProduct(options.paywallOrProduct)
             ? { product: this.encodeWithLogging(productCoder, options.paywallOrProduct, 'AdaptyPaywallProduct', ctx) }
-            : { paywall: this.encodeWithLogging(paywallCoder, options.paywallOrProduct, 'AdaptyPaywall', ctx) })), (options.openIn ? { open_in: options.openIn } : {}));
+            : { paywall: this.encodeWithLogging(flowPaywallCoder, options.paywallOrProduct, 'AdaptyFlowPaywall', ctx) })), (options.openIn ? { open_in: options.openIn } : {}));
         const args = filterUndefined(argsWithUndefined);
         await this.handleMethodCall(method, JSON.stringify(args), ctx, log);
     }
@@ -3812,7 +3890,7 @@ class Adapty {
      * You can use this URL in a custom web view or a browser.
      *
      * @param options - The options object
-     * @param options.paywallOrProduct - The paywall or product to create a URL for.
+     * @param options.paywallOrProduct - The flow paywall or product to create a URL for.
      * @returns A promise that resolves with the web paywall URL.
      * @throws Error if an error occurs while creating the URL.
      *
@@ -3821,8 +3899,8 @@ class Adapty {
      * import { adapty } from '@adapty/capacitor';
      *
      * try {
-     *   const paywall = await adapty.getPaywall({ placementId: 'YOUR_PLACEMENT_ID' });
-     *   const url = await adapty.createWebPaywallUrl({ paywallOrProduct: paywall });
+     *   const flow = await adapty.getFlow({ placementId: 'YOUR_PLACEMENT_ID' });
+     *   const url = await adapty.createWebPaywallUrl({ paywallOrProduct: flow.paywalls[0] });
      *   console.log('Web paywall URL:', url);
      * } catch (error) {
      *   console.error('Failed to create web paywall URL:', error);
@@ -3834,14 +3912,80 @@ class Adapty {
         const ctx = new LogContext();
         const log = ctx.call({ methodName: method });
         log.start(() => ({ options }));
-        const paywallCoder = coderFactory.createPaywallCoder();
+        const flowPaywallCoder = coderFactory.createFlowPaywallCoder();
         const productCoder = coderFactory.createPaywallProductCoder();
         const argsWithUndefined = Object.assign({ method }, (this.isPaywallProduct(options.paywallOrProduct)
             ? { product: this.encodeWithLogging(productCoder, options.paywallOrProduct, 'AdaptyPaywallProduct', ctx) }
-            : { paywall: this.encodeWithLogging(paywallCoder, options.paywallOrProduct, 'AdaptyPaywall', ctx) }));
+            : { paywall: this.encodeWithLogging(flowPaywallCoder, options.paywallOrProduct, 'AdaptyFlowPaywall', ctx) }));
         const args = filterUndefined(argsWithUndefined);
         return await this.handleMethodCall(method, JSON.stringify(args), ctx, log, 'String');
     }
+    /**
+     * Opens a URL using the native browser.
+     *
+     * @remarks
+     * Backs the default `onUrlPress` flow handler. Call it directly from a custom
+     * `onUrlPress` handler when you want to run your own logic but keep the native
+     * open-URL behavior. `openIn`: `browser_out_app` → external browser,
+     * `browser_in_app` → in-app browser.
+     *
+     * @param options - The options object
+     * @param options.url - The URL to open.
+     * @param options.openIn - Optional. How to present the URL ({@link WebPresentation}). When omitted, the native SDK decides.
+     * @returns A promise that resolves when the URL is opened.
+     * @throws Error if an error occurs while opening the URL.
+     *
+     * @example
+     * ```typescript
+     * import { adapty } from '@adapty/capacitor';
+     *
+     * try {
+     *   await adapty.openWebUrl({ url: 'https://example.com' });
+     * } catch (error) {
+     *   console.error('Failed to open URL:', error);
+     * }
+     * ```
+     */
+    async openWebUrl(options) {
+        const method = 'adapty_ui_open_url';
+        const ctx = new LogContext();
+        const log = ctx.call({ methodName: method });
+        log.start(() => ({ options }));
+        const argsWithUndefined = Object.assign({ method, url: options.url }, (options.openIn ? { open_in: options.openIn } : {}));
+        const args = filterUndefined(argsWithUndefined);
+        await this.handleMethodCall(method, JSON.stringify(args), ctx, log);
+    }
+    /**
+     * Requests the native app-review prompt.
+     *
+     * @remarks
+     * Uses `SKStoreReviewController` on iOS and In-App Review on Android. Backs the
+     * default `onRequestAppReview` flow handler. Call it directly from a custom
+     * `onRequestAppReview` handler when you want to run your own logic but keep the
+     * native prompt.
+     *
+     * @returns A promise that resolves when the native call completes.
+     * @throws Error if an error occurs while requesting the app review.
+     *
+     * @example
+     * ```typescript
+     * import { adapty } from '@adapty/capacitor';
+     *
+     * try {
+     *   await adapty.requestAppReview();
+     * } catch (error) {
+     *   console.error('Failed to request app review:', error);
+     * }
+     * ```
+     */
+    async requestAppReview() {
+        const method = 'adapty_ui_request_app_review';
+        const ctx = new LogContext();
+        const log = ctx.call({ methodName: method });
+        log.start(() => ({}));
+        const args = { method };
+        await this.handleMethodCall(method, JSON.stringify(args), ctx, log);
+    }
     /**
      * Logs out the current user.
      *
@@ -3968,7 +4112,7 @@ class Adapty {
      *
      * @param options - The options object
      * @param options.transactionId - The transaction ID of the purchase.
-     * @param options.variationId - Optional. The variation ID from the {@link AdaptyPaywall}.
+     * @param options.variationId - Optional. The variation ID from the {@link AdaptyFlow}.
      * @returns A promise that resolves when the transaction is reported.
      * @throws Error if an error occurs while reporting the transaction.
      *
@@ -4403,7 +4547,14 @@ class Adapty {
     }
 }
 
-const parsePaywallEvent = (input, ctx) => parsePaywallEvent$1(coderFactory, input);
+/**
+ * The shared Adapty singleton. Extracted into its own module so UI default
+ * handlers can delegate to native handler methods (openWebUrl / requestAppReview)
+ * without importing the package entry point and creating an import cycle.
+ */
+const adapty = new Adapty();
+
+const parseFlowEvent = (input, ctx) => parseFlowEvent$1(coderFactory, input);
 
 /**
  * Base class for view event emitters that manages common event handling logic.
@@ -4416,6 +4567,14 @@ 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) {
@@ -4484,6 +4643,10 @@ 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) {
@@ -4531,14 +4694,25 @@ class BaseViewEmitter {
 }
 
 /**
- * PaywallViewEmitter manages event handlers for paywall view events.
+ * FlowViewEmitter manages event handlers for flow view events.
  * Each event type can have only one handler - new handlers replace existing ones.
+ *
+ * In addition to the standard synchronous dispatch inherited from
+ * {@link BaseViewEmitter}, this emitter handles three asynchronous round-trip
+ * events that must reply back to native:
+ * - `onRequestPermission` — awaits the async handler, then replies with the status.
+ * - `onObserverPurchaseInitiated` — injects start/finish callbacks (observer mode).
+ * - `onObserverRestoreInitiated` — injects start/finish callbacks (observer mode).
  */
-class PaywallViewEmitter extends BaseViewEmitter {
+class FlowViewEmitter extends BaseViewEmitter {
+    constructor(viewId, adapty) {
+        super(viewId);
+        this.adapty = adapty;
+    }
     parseEventData(rawEventData, ctx) {
-        const result = parsePaywallEvent(rawEventData);
+        const result = parseFlowEvent(rawEventData);
         if (!result) {
-            throw new Error('Failed to parse paywall event');
+            throw new Error('Failed to parse flow event');
         }
         return result;
     }
@@ -4546,135 +4720,192 @@ class PaywallViewEmitter extends BaseViewEmitter {
         return HANDLER_TO_NATIVE_EVENT$1[event];
     }
     getHandlerForNativeEvent(nativeEvent, eventData) {
-        const resolver = NATIVE_EVENT_RESOLVER$1[nativeEvent];
-        if (!resolver) {
-            return null;
-        }
-        return resolver(eventData);
+        var _a, _b;
+        return (_b = (_a = NATIVE_EVENT_RESOLVER$1[nativeEvent]) === null || _a === void 0 ? void 0 : _a.call(NATIVE_EVENT_RESOLVER$1, eventData)) !== null && _b !== void 0 ? _b : null;
     }
     extractCallbackArgs(handlerName, eventData) {
-        return extractCallbackArgs$1(handlerName, eventData);
+        return extractFlowCallbackArgs(handlerName, eventData);
     }
     getEventViewId(eventData) {
         var _a, _b;
         return (_b = (_a = eventData === null || eventData === void 0 ? void 0 : eventData.view) === null || _a === void 0 ? void 0 : _a.id) !== null && _b !== void 0 ? _b : null;
     }
     getEmitterName() {
-        return 'PaywallViewEmitter';
+        return 'FlowViewEmitter';
     }
-}
-const NATIVE_EVENT_RESOLVER$1 = {
-    [PaywallEventId.DidPerformAction]: (event) => {
-        var _a;
-        if (event.id !== PaywallEventId.DidPerformAction) {
-            return null;
+    /**
+     * Routes the three asynchronous round-trip events to their dedicated
+     * handlers, bypassing the standard synchronous boolean/close dispatch.
+     */
+    handleSpecialEvent(handlerName, eventData) {
+        if (handlerName === 'onRequestPermission' && eventData.id === FlowEventId.DidAskPermission) {
+            void this.handlePermissionRequest(eventData);
+            return true;
+        }
+        if (handlerName === 'onObserverPurchaseInitiated' && eventData.id === FlowEventId.ObserverDidInitiatePurchase) {
+            this.handleObserverPurchase(eventData);
+            return true;
+        }
+        if (handlerName === 'onObserverRestoreInitiated' && eventData.id === FlowEventId.ObserverDidInitiateRestore) {
+            this.handleObserverRestore(eventData);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Permission is an async round-trip: await the client handler, then reply to
+     * native with the resulting status (defaults to `denied` on error/no handler).
+     */
+    async handlePermissionRequest(event) {
+        const handlerData = this.handlers.get('onRequestPermission');
+        let status = 'denied';
+        let detail;
+        if (handlerData) {
+            try {
+                const handler = handlerData.handler;
+                const response = await handler(event.permission, event.customArgs);
+                status = response.status;
+                detail = response.detail;
+            }
+            catch (error) {
+                status = 'denied';
+                Log.warn('flow_view_did_answer_permission', () => `onRequestPermission handler threw; replying denied: ${error}`);
+            }
         }
-        const actionMap = {
-            close: 'onCloseButtonPress',
-            system_back: 'onAndroidSystemBack',
-            open_url: 'onUrlPress',
-            custom: 'onCustomAction',
+        const method = 'flow_view_did_answer_permission';
+        const ctx = new LogContext();
+        const log = ctx.call({ methodName: method });
+        const body = JSON.stringify(filterUndefined({
+            method,
+            event_id: event.eventId,
+            status,
+            detail,
+        }));
+        await this.adapty
+            .handleMethodCall(method, body, ctx, log)
+            .catch((error) => Log.warn(method, () => `Failed to reply to permission request: ${error}`));
+    }
+    // Pass a fully-typed request object into `send` so each literal is checked
+    // against its own `Req[...]` arm (a `satisfies` on a method-union body cannot
+    // narrow, so we type per-call instead).
+    handleObserverPurchase(event) {
+        const handlerData = this.handlers.get('onObserverPurchaseInitiated');
+        if (!handlerData)
+            return;
+        const { handler, onRequestClose } = handlerData;
+        const send = (body) => {
+            const ctx = new LogContext();
+            const log = ctx.call({ methodName: body.method });
+            void this.adapty
+                .handleMethodCall(body.method, JSON.stringify(body), ctx, log)
+                .catch((error) => Log.warn(body.method, () => `Failed observer purchase signal: ${error}`));
         };
-        return (_a = actionMap[event.action.type]) !== null && _a !== void 0 ? _a : null;
-    },
-    [PaywallEventId.DidAppear]: () => 'onAppeared',
-    [PaywallEventId.DidDisappear]: () => 'onDisappeared',
-    [PaywallEventId.DidSelectProduct]: () => 'onProductSelected',
-    [PaywallEventId.DidStartPurchase]: () => 'onPurchaseStarted',
-    [PaywallEventId.DidFinishPurchase]: () => 'onPurchaseCompleted',
-    [PaywallEventId.DidFailPurchase]: () => 'onPurchaseFailed',
-    [PaywallEventId.DidStartRestore]: () => 'onRestoreStarted',
-    [PaywallEventId.DidFinishRestore]: () => 'onRestoreCompleted',
-    [PaywallEventId.DidFailRestore]: () => 'onRestoreFailed',
-    [PaywallEventId.DidFailRendering]: () => 'onRenderingFailed',
-    [PaywallEventId.DidFailLoadingProducts]: () => 'onLoadingProductsFailed',
-    [PaywallEventId.DidFinishWebPaymentNavigation]: () => 'onWebPaymentNavigationFinished',
-};
-const HANDLER_TO_NATIVE_EVENT$1 = {
-    onCloseButtonPress: PaywallEventId.DidPerformAction,
-    onAndroidSystemBack: PaywallEventId.DidPerformAction,
-    onUrlPress: PaywallEventId.DidPerformAction,
-    onCustomAction: PaywallEventId.DidPerformAction,
-    onProductSelected: PaywallEventId.DidSelectProduct,
-    onPurchaseStarted: PaywallEventId.DidStartPurchase,
-    onPurchaseCompleted: PaywallEventId.DidFinishPurchase,
-    onPurchaseFailed: PaywallEventId.DidFailPurchase,
-    onRestoreStarted: PaywallEventId.DidStartRestore,
-    onRestoreCompleted: PaywallEventId.DidFinishRestore,
-    onRestoreFailed: PaywallEventId.DidFailRestore,
-    onAppeared: PaywallEventId.DidAppear,
-    onDisappeared: PaywallEventId.DidDisappear,
-    onRenderingFailed: PaywallEventId.DidFailRendering,
-    onLoadingProductsFailed: PaywallEventId.DidFailLoadingProducts,
-    onWebPaymentNavigationFinished: PaywallEventId.DidFinishWebPaymentNavigation,
-};
-function extractCallbackArgs$1(handlerName, event) {
-    switch (event.id) {
-        case PaywallEventId.DidSelectProduct:
-            return [event.productId];
-        case PaywallEventId.DidStartPurchase:
-            return [event.product];
-        case PaywallEventId.DidFinishPurchase:
-            return [event.purchaseResult, event.product];
-        case PaywallEventId.DidFailPurchase:
-            return [event.error, event.product];
-        case PaywallEventId.DidFinishRestore:
-            return [event.profile];
-        case PaywallEventId.DidFailRestore:
-        case PaywallEventId.DidFailRendering:
-        case PaywallEventId.DidFailLoadingProducts:
-            return [event.error];
-        case PaywallEventId.DidPerformAction:
-            if (handlerName === 'onUrlPress' && event.action.type === 'open_url') {
-                return [event.action.value, event.action.openIn];
+        const purchaseHandler = handler;
+        try {
+            // The observer's documented way to close the view after driving the
+            // purchase: returning `true` requests dismissal (close-on-`true`).
+            const shouldClose = purchaseHandler(event.product, () => send({ method: 'observer_purchase_did_start', event_id: event.eventId }), () => send({ method: 'observer_purchase_did_finish', event_id: event.eventId }));
+            if (shouldClose) {
+                onRequestClose().catch((error) => Log.warn('observer_purchase_did_initiate', () => `Failed to close view after observer purchase: ${error}`, () => ({ error })));
             }
-            if (handlerName === 'onCustomAction' && event.action.type === 'custom') {
-                return [event.action.value];
+        }
+        catch (error) {
+            Log.warn('observer_purchase_handler_failed', () => `onObserverPurchaseInitiated handler threw: ${error}`, () => ({ error }));
+        }
+    }
+    handleObserverRestore(event) {
+        const handlerData = this.handlers.get('onObserverRestoreInitiated');
+        if (!handlerData)
+            return;
+        const { handler, onRequestClose } = handlerData;
+        const send = (body) => {
+            const ctx = new LogContext();
+            const log = ctx.call({ methodName: body.method });
+            void this.adapty
+                .handleMethodCall(body.method, JSON.stringify(body), ctx, log)
+                .catch((error) => Log.warn(body.method, () => `Failed observer restore signal: ${error}`));
+        };
+        const restoreHandler = handler;
+        try {
+            // The observer's documented way to close the view after driving the
+            // restore: returning `true` requests dismissal (close-on-`true`).
+            const shouldClose = restoreHandler(() => send({ method: 'observer_restore_did_start', event_id: event.eventId }), () => send({ method: 'observer_restore_did_finish', event_id: event.eventId }));
+            if (shouldClose) {
+                onRequestClose().catch((error) => Log.warn('observer_restore_did_initiate', () => `Failed to close view after observer restore: ${error}`, () => ({ error })));
             }
-            return [];
-        case PaywallEventId.DidFinishWebPaymentNavigation:
-            return [event.product, event.error];
-        case PaywallEventId.DidAppear:
-        case PaywallEventId.DidDisappear:
-        case PaywallEventId.DidStartRestore:
-            return [];
+        }
+        catch (error) {
+            Log.warn('observer_restore_handler_failed', () => `onObserverRestoreInitiated handler threw: ${error}`, () => ({ error }));
+        }
     }
 }
 
 /**
- * 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
  */
-const DEFAULT_EVENT_HANDLERS = {
+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;
+    },
 };
+/**
+ * @internal
+ */
 const DEFAULT_ONBOARDING_EVENT_HANDLERS = {
     onClose: () => true,
 };
@@ -4682,44 +4913,47 @@ const DEFAULT_ONBOARDING_EVENT_HANDLERS = {
 const DEFAULT_PARAMS = {
     prefetchProducts: true,
     loadTimeoutMs: 5000,
+    android: {
+        enableSafeArea: true,
+    },
 };
 /**
- * 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
  */
-class PaywallViewController {
+class FlowViewController {
     /**
      * Intended way to create a ViewController instance.
      * It prepares a native controller to be presented
      * and creates reference between native controller and JS instance
      * @internal
      */
-    static async create(paywall, params, adaptyPlugin) {
-        const controller = new PaywallViewController(adaptyPlugin);
+    static async create(flow, params, adaptyPlugin) {
+        const controller = new FlowViewController(adaptyPlugin);
         const ctx = new LogContext();
-        const methodKey = 'adapty_ui_create_paywall_view';
+        const methodKey = 'adapty_ui_create_flow_view';
         const log = ctx.call({ methodName: methodKey });
-        log.start(() => ({ paywall, params }));
-        const paywallCoder = coderFactory.createPaywallCoder();
-        const paramsCoder = coderFactory.createUiCreatePaywallViewParamsCoder();
+        log.start(() => ({ flow, params }));
+        const flowCoder = coderFactory.createFlowCoder();
+        const paramsCoder = coderFactory.createUiCreateFlowViewParamsCoder();
         const paramsWithDefaults = Object.assign(Object.assign({}, DEFAULT_PARAMS), params);
-        const data = Object.assign({ method: methodKey, paywall: paywallCoder.encode(paywall) }, paramsCoder.encode(paramsWithDefaults));
+        const data = Object.assign({ method: methodKey, flow: flowCoder.encode(flow) }, paramsCoder.encode(paramsWithDefaults));
         const result = (await controller.adaptyPlugin.handleMethodCall(methodKey, JSON.stringify(data), ctx, log));
         controller.id = result.id;
-        controller.viewEmitter = new PaywallViewEmitter(controller.id);
-        await controller.setEventHandlers(DEFAULT_EVENT_HANDLERS);
+        controller.viewEmitter = new FlowViewEmitter(controller.id, controller.adaptyPlugin);
+        await controller.setEventHandlers(DEFAULT_FLOW_EVENT_HANDLERS);
         return controller;
     }
     /**
      * 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
      */
@@ -4731,31 +4965,31 @@ class PaywallViewController {
                 await this.dismiss();
             }
             catch (error) {
-                Log.warn('setEventHandlers', () => 'Failed to dismiss paywall', () => ({ error }));
+                Log.warn('setEventHandlers', () => 'Failed to dismiss flow', () => ({ error }));
             }
         };
         this.adaptyPlugin = adaptyPlugin;
     }
     /**
-     * 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();
      * ```
      *
@@ -4768,7 +5002,7 @@ class PaywallViewController {
     async present(options = {}) {
         var _a;
         const ctx = new LogContext();
-        const methodKey = 'adapty_ui_present_paywall_view';
+        const methodKey = 'adapty_ui_present_flow_view';
         const log = ctx.call({ methodName: methodKey });
         log.start(() => ({ _id: this.id, iosPresentationStyle: options.iosPresentationStyle }));
         if (this.id === null) {
@@ -4785,20 +5019,20 @@ class PaywallViewController {
         await this.adaptyPlugin.handleMethodCall(methodKey, JSON.stringify(data), ctx, log);
     }
     /**
-     * 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();
@@ -4806,7 +5040,7 @@ class PaywallViewController {
      */
     async dismiss() {
         const ctx = new LogContext();
-        const methodKey = 'adapty_ui_dismiss_paywall_view';
+        const methodKey = 'adapty_ui_dismiss_flow_view';
         const log = ctx.call({ methodName: methodKey });
         log.start(() => ({ _id: this.id }));
         if (this.id === null) {
@@ -4827,7 +5061,7 @@ 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.
      *
@@ -4879,20 +5113,20 @@ class PaywallViewController {
         return await this.adaptyPlugin.handleMethodCall(methodKey, JSON.stringify(data), ctx, log);
     }
     /**
-     * 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
-     *
-     * 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.
+     * 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`
+     *
+     * 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.
      *
@@ -4904,9 +5138,9 @@ 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) => {
@@ -4914,7 +5148,7 @@ 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) => {
@@ -4940,13 +5174,13 @@ class PaywallViewController {
             });
         }
         Log.verbose('setEventHandlers', () => 'Registering event handlers for view', () => ({ id: this.id }));
-        const viewEmitter = (_a = this.viewEmitter) !== null && _a !== void 0 ? _a : new PaywallViewEmitter(this.id);
+        const viewEmitter = (_a = this.viewEmitter) !== null && _a !== void 0 ? _a : new FlowViewEmitter(this.id, this.adaptyPlugin);
         this.viewEmitter = viewEmitter;
         const wrappedErrorLogEventHandlers = mapValues(eventHandlers, (handler, eventName) => handler && typeof handler === 'function'
-            ? withErrorContext(handler, eventName, 'PaywallViewController')
+            ? withErrorContext(handler, eventName, 'FlowViewController')
             : undefined);
         // Merge with defaults to ensure default behavior is preserved after unsubscribe/resubscribe cycles
-        const finalEventHandlers = Object.assign(Object.assign({}, DEFAULT_EVENT_HANDLERS), wrappedErrorLogEventHandlers);
+        const finalEventHandlers = Object.assign(Object.assign({}, DEFAULT_FLOW_EVENT_HANDLERS), wrappedErrorLogEventHandlers);
         for (const [eventName, handler] of Object.entries(finalEventHandlers)) {
             if (handler && typeof handler === 'function') {
                 try {
@@ -4980,7 +5214,7 @@ class PaywallViewController {
      *
      * @example
      * ```typescript
-     * const view = await createPaywallView(paywall);
+     * const view = await createFlowView(flow);
      * await view.setEventHandlers({ onPurchaseCompleted: handlePurchase });
      *
      * // Later, clear all handlers
@@ -5074,6 +5308,8 @@ const DEFAULT_ONBOARDING_PARAMS = {
 /**
  * Controller for managing onboarding views.
  *
+ * @deprecated Since 4.0.0. Migrate onboardings to the Flow Builder API.
+ *
  * @remarks
  * This class provides methods to present, dismiss, and handle events for onboarding views
  * created with the Onboarding Builder. Create instances using the {@link createOnboardingView} function
@@ -5106,7 +5342,7 @@ class OnboardingViewController {
     /**
      * Since constructors in JS cannot be async, it is not
      * preferred to create ViewControllers in direct way.
-     * Consider using @link{OnboardingViewController.create} instead
+     * Consider using {@link OnboardingViewController.create} instead
      *
      * @internal
      */
@@ -5235,11 +5471,11 @@ class OnboardingViewController {
      *     // Return true to keep default closing behavior
      *     return true;
      *   },
-     *   onActionPerformed: (action) => {
-     *     console.log('Action performed:', action.name);
+     *   onCustom: (actionId, meta) => {
+     *     console.log('Custom action:', actionId, meta);
      *   },
-     *   onProductSelected: (product) => {
-     *     console.log('Product selected:', product.vendorProductId);
+     *   onStateUpdated: (action, meta) => {
+     *     console.log('State updated:', action, meta);
      *   }
      * });
      *
@@ -5313,31 +5549,18 @@ class OnboardingViewController {
     }
 }
 
-const adaptyPlugin$1 = new Adapty();
 /**
- * Creates a paywall view controller.
- * You can use it to further configure a view or present it.
+ * 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 paywall view}
- *
- * @param {AdaptyPaywall} paywall - paywall that you want to present.
- * @param {CreatePaywallViewParamsInput | undefined} [params] - additional params.
- * @returns {Promise<PaywallViewController>} ViewController — A promise that resolves to a ViewController instance.
- *
- * @example
- * ```ts
- * const paywall = await adapty.getPaywall("MY_PAYWALL");
- * const view = await createPaywallView(paywall);
- * view.present();
- * ```
+ * @see {@link https://adapty.io/docs/capacitor-present-paywalls | [DOC] Creating a flow view}
  *
- * @throws {AdaptyError} — If paywall is not found,
- * does not have a no-code view configured
- * or if there is an error while creating a view.
+ * @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.
  */
-async function createPaywallView(paywall, params = {}) {
-    const controller = await PaywallViewController.create(paywall, params, adaptyPlugin$1);
-    return controller;
+async function createFlowView(flow, params = {}) {
+    return FlowViewController.create(flow, params, adapty);
 }
 
 const adaptyPlugin = new Adapty();
@@ -5345,6 +5568,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.
@@ -5374,8 +5599,6 @@ async function createOnboardingView(onboarding, params = {}) {
     return controller;
 }
 
-const adapty = new Adapty();
-
 class AdaptyCapacitorPluginWeb extends core.WebPlugin {
     addListener(eventName, listenerFunc) {
         return super.addListener(eventName, listenerFunc);
@@ -5398,26 +5621,27 @@ var web = /*#__PURE__*/Object.freeze({
 
 exports.AdaptyAndroidSubscriptionUpdateReplacementMode = AdaptyAndroidSubscriptionUpdateReplacementMode;
 exports.AdaptyError = AdaptyError;
+exports.AdaptyUiDialogActionType = AdaptyUiDialogActionType;
 exports.AppTrackingTransparencyStatus = AppTrackingTransparencyStatus;
 exports.CancellationReason = CancellationReason;
 exports.ErrorCode = ErrorCode;
 exports.ErrorCodeName = ErrorCodeName;
 exports.FetchPolicy = FetchPolicy;
+exports.FlowEventId = FlowEventId;
+exports.FlowViewController = FlowViewController;
 exports.Gender = Gender;
 exports.LogLevel = LogLevel;
 exports.OfferType = OfferType;
 exports.OnboardingEventId = OnboardingEventId;
 exports.OnboardingViewController = OnboardingViewController;
-exports.PaywallEventId = PaywallEventId;
-exports.PaywallViewController = PaywallViewController;
 exports.ProductPeriod = ProductPeriod;
 exports.RefundPreference = RefundPreference;
 exports.VendorStore = VendorStore;
 exports.WebPresentation = WebPresentation;
 exports.adapty = adapty;
 exports.consoleLogSink = consoleLogSink;
+exports.createFlowView = createFlowView;
 exports.createOnboardingView = createOnboardingView;
-exports.createPaywallView = createPaywallView;
 exports.getErrorCode = getErrorCode;
 exports.getErrorPrompt = getErrorPrompt;
 //# sourceMappingURL=plugin.cjs.js.map