feat(paywalls): enable web_view component (7/7) by JZDesign · Pull Request #7233 · RevenueCat/purchases-ios

JZDesign · 2026-07-15T20:35:14Z

Checklist

If applicable, unit tests
If applicable, create follow-up issues for purchases-android and hybrids

Motivation

Part 7 of 7 splitting #7183. This is the activation PR — the only change that alters runtime behavior. Reverting it alone turns web_view off.

Description

Registers PaywallComponent.webView / ComponentType.webView, wires cache warming / presented-partials / view-model factory / ComponentsView, restores PaywallWebViewComponent.type to ComponentType, and adds decode + ViewModelFactory tests.

Also gates decoding on protocol_version: a web_view declaring a version this SDK doesn't implement is treated as an unrecognized component and renders the author's fallback (throws if none), as client-side defense in depth. Mirrors purchases-android (#3787) and purchases-js.

Until this merges, paywall JSON containing web_view behaves exactly as on main (unknown type → fallback path).

Stacking: Based on webview/6-view (Part 6). Retarget to main after Part 6 merges.

PR Plan

PWENG-99

Part	PR	Branch	Base
1/7	#7227	webview/1-public-api	main
2/7	#7228	webview/2-envelope	webview/1-public-api (retarget to main after I1)
3/7	#7229	webview/3-isolation-navigation	main
4/7	#7230	webview/4-schema	main
5/7	#7231	webview/5-session	webview/deps-123 (retarget after I1–I3)
6/7	#7232	webview/6-view	webview/deps-45 (retarget after I4–I5)
7/7	#7233	webview/7-activate	webview/6-view (retarget to main after I6)

also needs #7226 to merge, there will be some code changes when it does

Add PaywallWebViewMessage/Value/Controller/Action types and API baselines. Controller post APIs are no-ops until the session PR wires WebKit. Co-authored-by: Jacob Rakidzich <Jacob@JacobZivanDesign.com>

Add WebViewEnvelope encode/decode and input hardening tests. Inert until Part 7; builds on the public API from Part 1. Co-authored-by: Jacob Rakidzich <Jacob@JacobZivanDesign.com>

…3/7) Extract origin normalization, main-frame navigation policy, and WK content rule isolation as inert helpers used by later session/view PRs. Co-authored-by: Jacob Rakidzich <Jacob@JacobZivanDesign.com>

Add PaywallComponent.WebViewComponent as dead code without registering ComponentType.webView or PaywallComponent.webView, so paywall JSON is unchanged until the activation PR. Co-authored-by: Jacob Rakidzich <Jacob@JacobZivanDesign.com>

Co-authored-by: Jacob Rakidzich <Jacob@JacobZivanDesign.com>

… (5/7) Add WebViewSession (using WebViewOrigin), restore controller session wiring, and document-reset so reloads can re-handshake. Includes session tests plus reconnect/resize-threshold/onDocumentReset coverage. Co-authored-by: Jacob Rakidzich <Jacob@JacobZivanDesign.com>

Co-authored-by: Jacob Rakidzich <Jacob@JacobZivanDesign.com>

…6/7) Add WebViewComponentView/ViewModel with document-reset and content-process termination lifecycle, fit-axes identity, and coordinator tests. Still unreferenced by the render pipeline until Part 7. Co-authored-by: Jacob Rakidzich <Jacob@JacobZivanDesign.com>

Co-authored-by: Jacob Rakidzich <Jacob@JacobZivanDesign.com>

Register web_view in PaywallComponent decoding/encoding, view-model factory, and ComponentsView dispatch. Reverting this PR alone turns the feature off. Co-authored-by: Jacob Rakidzich <Jacob@JacobZivanDesign.com>

emerge-tools · 2026-07-15T20:39:24Z

4 builds increased size

Name	Version	Download	Change	Install	Change	Approval
RevenueCat com.revenuecat.PaywallsTester	1.0 (1)	19.3 MB	⬆️ 23.4 kB (0.12%)	70.0 MB	⬆️ 119.3 kB (0.17%)	N/A
BinarySizeTest com.revenuecat.binary-size-test.local-source	1.0 (1)	4.5 MB	⬆️ 19.3 kB (0.43%)	13.5 MB	⬆️ 49.9 kB (0.37%)	⏳ Needs approval
BinarySizeTest com.revenuecat.binary-size-test.cocoapods	1.0 (1)	6.8 MB	⬆️ 21.6 kB (0.32%)	29.7 MB	⬆️ 108.2 kB (0.37%)	⏳ Needs approval
BinarySizeTest com.revenuecat.binary-size-test.spm	1.0 (1)	4.6 MB	⬆️ 19.6 kB (0.43%)	11.8 MB	⬆️ 45.0 kB (0.39%)	⏳ Needs approval

RevenueCat 1.0 (1)
com.revenuecat.PaywallsTester

⚖️ Compare build
⏱️ Analyze build performance

Total install size change: ⬆️ 119.3 kB (0.17%)
Total download size change: ⬆️ 23.4 kB (0.12%)

Largest size changes

Item	Install Size Change
DYLD.String Table	⬆️ 60.2 kB
📝 RevenueCatUI.WebViewScrollOwnershipRecognizer.Objc Metadata	⬆️ 10.3 kB
Code Signature	⬆️ 2.7 kB
DYLD.Exports	⬆️ 1.9 kB
Strings.Unmapped	⬆️ 1.4 kB

View Treemap

BinarySizeTest 1.0 (1)
com.revenuecat.binary-size-test.local-source

⚖️ Compare build
📦 Install build
⏱️ Analyze build performance

Total install size change: ⬆️ 49.9 kB (0.37%)
Total download size change: ⬆️ 19.3 kB (0.43%)

Largest size changes

Item	Install Size Change
DYLD.String Table	⬆️ 7.6 kB
📝 RevenueCatUI.WebViewComponentView.body	⬆️ 2.0 kB
📝 RevenueCatUI.WebViewRepresentable.value witness	⬆️ 2.0 kB
📝 RevenueCatUI.BridgedWebViewComponentView.value witness	⬆️ 1.8 kB
📝 RevenueCatUI.View.webViewWidth(measuredWidth)	⬆️ 1.7 kB

View Treemap

BinarySizeTest 1.0 (1)
com.revenuecat.binary-size-test.cocoapods

⚖️ Compare build
📦 Install build
⏱️ Analyze build performance

Total install size change: ⬆️ 108.2 kB (0.37%)
Total download size change: ⬆️ 21.6 kB (0.32%)

Largest size changes

Item	Install Size Change
DYLD.String Table	⬆️ 39.0 kB
Code Signature	⬆️ 2.3 kB
📝 RevenueCatUI.WebViewComponentView.body	⬆️ 2.0 kB
📝 RevenueCatUI.WebViewRepresentable.value witness	⬆️ 2.0 kB
📝 RevenueCatUI.BridgedWebViewComponentView.value witness	⬆️ 1.8 kB

View Treemap

BinarySizeTest 1.0 (1)
com.revenuecat.binary-size-test.spm

⚖️ Compare build
📦 Install build
⏱️ Analyze build performance

Total install size change: ⬆️ 45.0 kB (0.39%)
Total download size change: ⬆️ 19.6 kB (0.43%)

Largest size changes

Item	Install Size Change
📝 RevenueCatUI.WebViewComponentView.body	⬆️ 2.0 kB
📝 RevenueCatUI.WebViewRepresentable.value witness	⬆️ 2.0 kB
📝 RevenueCatUI.BridgedWebViewComponentView.value witness	⬆️ 1.8 kB
Strings.Unmapped	⬆️ 1.8 kB
📝 RevenueCatUI.View.webViewWidth(measuredWidth)	⬆️ 1.7 kB

View Treemap

🛸 Powered by Emerge Tools

Comment trigger: Size diff threshold of 100.00kB exceeded

Co-authored-by: Jacob Rakidzich <Jacob@JacobZivanDesign.com>

…activate

cursor

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 1c4a04f. Configure here.}

Gate on the fallback key's presence so a keyNotFound thrown while decoding the fallback's own subtree is reported with its underlying error instead of being misclassified as a missing fallback. Co-authored-by: Cursor <cursoragent@cursor.com>

…esponse WebKit treats HTTP error status codes as successful navigations (the error body renders and didFail* never fires), so terminal load-failure handling missed them. Inspect the status code in decidePolicyFor navigationResponse and, on a main-frame 4xx/5xx, log an error, remove the web view, and cancel the load. Sub-frame/sub-resource errors are ignored so a single failing asset doesn't tear down the whole component. Co-authored-by: Cursor <cursoragent@cursor.com>

…tivate

cursoragent and others added 9 commits July 15, 2026 20:18

feat(paywalls): public API surface for web_view messages (1/7)

5cf1dfd

Add PaywallWebViewMessage/Value/Controller/Action types and API baselines. Controller post APIs are no-ops until the session PR wires WebKit. Co-authored-by: Jacob Rakidzich <Jacob@JacobZivanDesign.com>

feat(paywalls): web_view wire envelope + JSON hardening (2/7)

f7f5d16

Add WebViewEnvelope encode/decode and input hardening tests. Inert until Part 7; builds on the public API from Part 1. Co-authored-by: Jacob Rakidzich <Jacob@JacobZivanDesign.com>

feat(paywalls): web_view navigation policy + content-rule isolation (…

d331b34

…3/7) Extract origin normalization, main-frame navigation policy, and WK content rule isolation as inert helpers used by later session/view PRs. Co-authored-by: Jacob Rakidzich <Jacob@JacobZivanDesign.com>

Merge webview/3-isolation-navigation into webview/5-session base

7664d35

Co-authored-by: Jacob Rakidzich <Jacob@JacobZivanDesign.com>

Merge webview/4-schema into webview/6-view base

6a46822

Co-authored-by: Jacob Rakidzich <Jacob@JacobZivanDesign.com>

fix(tests): open session via connect in coordinator lifecycle test

c132a31

Co-authored-by: Jacob Rakidzich <Jacob@JacobZivanDesign.com>

JZDesign added feat:PaywallsV2 pr:feat A new feature pr:RevenueCatUI labels Jul 15, 2026 — with Cursor

cursoragent and others added 2 commits July 15, 2026 20:36

fix: remove extra vertical whitespace for SwiftLint

24f352c

Co-authored-by: Jacob Rakidzich <Jacob@JacobZivanDesign.com>

fix: SwiftLint whitespace, line length, and force_try

07383d3

Co-authored-by: Jacob Rakidzich <Jacob@JacobZivanDesign.com>

cursor Bot force-pushed the webview/7-activate branch from a9207e6 to 709203c Compare July 15, 2026 20:36

cursoragent and others added 2 commits July 15, 2026 20:36

fix: wrap web_view identity string under 120 columns

96d24e1

Co-authored-by: Jacob Rakidzich <Jacob@JacobZivanDesign.com>

feat(paywalls): enable web_view component (7/7)

ea83431

Register web_view in PaywallComponent decoding/encoding, view-model factory, and ComponentsView dispatch. Reverting this PR alone turns the feature off. Co-authored-by: Jacob Rakidzich <Jacob@JacobZivanDesign.com>

cursor Bot force-pushed the webview/7-activate branch from 890dd02 to ea83431 Compare July 15, 2026 20:36

JZDesign marked this pull request as ready for review July 16, 2026 12:48

JZDesign requested review from a team as code owners July 16, 2026 12:48

refactor(paywalls): keep web view bridge internal

e671378

Co-authored-by: Jacob Rakidzich <Jacob@JacobZivanDesign.com>

ajpallares added 2 commits July 23, 2026 12:11

Allow media playback without a user gesture in paywall web views

80ef6c3

Extract web view configuration builder and add media autoplay test

9637971

ajpallares changed the base branch from main to pallares/web-view-allow-media-autoplay July 23, 2026 10:18

Merge branch 'pallares/web-view-allow-media-autoplay' into webview/7-…

1c4a04f

…activate

cursor Bot reviewed Jul 23, 2026

View reviewed changes

Comment thread Sources/Paywalls/Components/Common/PaywallComponentBase.swift

Base automatically changed from pallares/web-view-allow-media-autoplay to main July 23, 2026 10:29

Harden paywall web view diagnostics and failure handling

5e2decb

ajpallares changed the base branch from main to pallares/web-view-hardening July 23, 2026 10:59

ajpallares and others added 10 commits July 23, 2026 12:59

Merge branch 'pallares/web-view-hardening' into webview/7-activate

4ae20ab

Gate web view inspector behind DEBUG in addition to log level

e33c775

Trim web view inspector comment and link WebKit reference

5add1ad

Merge branch 'pallares/web-view-hardening' into webview/7-activate

a0252d6

Fix duplicated punctuation in web view load failure log

65278eb

Gate web view render on non-empty component id

b9d9e12

Merge branch 'main' into pallares/web-view-hardening

50f426e

Merge branch 'pallares/web-view-hardening' into webview/7-activate

573c62f

Base automatically changed from pallares/web-view-hardening to main July 23, 2026 16:04

Merge branch 'main' into webview/7-activate

701da3e

ajpallares changed the base branch from main to pallares/webview-enable-scroll July 23, 2026 16:05

Merge branch 'pallares/webview-enable-scroll' into webview/7-activate

fe62e47

ajpallares changed the base branch from pallares/webview-enable-scroll to pallares/webview-gesture-arbitration July 24, 2026 09:17

ajpallares and others added 5 commits July 24, 2026 11:17

Merge branch 'pallares/webview-gesture-arbitration' into webview/7-ac…

c1b3d46

…tivate

Merge branch 'pallares/webview-gesture-arbitration' into webview/7-ac…

6420ecc

…tivate

Merge branch 'pallares/webview-gesture-arbitration' into webview/7-ac…

0bd007d

…tivate

Merge branch 'pallares/webview-gesture-arbitration' into webview/7-ac…

7a0956d

…tivate

Merge branch 'pallares/webview-gesture-arbitration' into webview/7-ac…

6827f72

…tivate

ajpallares force-pushed the pallares/webview-gesture-arbitration branch from 544d49c to a7ed568 Compare July 24, 2026 14:23

ajpallares force-pushed the webview/7-activate branch from 9e73e90 to 6827f72 Compare July 24, 2026 14:23

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat(paywalls): enable web_view component (7/7)#7233

feat(paywalls): enable web_view component (7/7)#7233
JZDesign wants to merge 113 commits into
pallares/webview-gesture-arbitrationfrom
webview/7-activate

JZDesign commented Jul 15, 2026 •

edited by ajpallares

Loading

Uh oh!

emerge-tools Bot commented Jul 15, 2026 •

edited

Loading

Uh oh!

cursor Bot left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

JZDesign commented Jul 15, 2026 • edited by ajpallares Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Checklist

Motivation

Description

PR Plan

Uh oh!

emerge-tools Bot commented Jul 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

4 builds increased size

RevenueCat 1.0 (1)com.revenuecat.PaywallsTester

BinarySizeTest 1.0 (1)com.revenuecat.binary-size-test.local-source

BinarySizeTest 1.0 (1)com.revenuecat.binary-size-test.cocoapods

BinarySizeTest 1.0 (1)com.revenuecat.binary-size-test.spm

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

JZDesign commented Jul 15, 2026 •

edited by ajpallares

Loading

emerge-tools Bot commented Jul 15, 2026 •

edited

Loading

RevenueCat 1.0 (1)
com.revenuecat.PaywallsTester

BinarySizeTest 1.0 (1)
com.revenuecat.binary-size-test.local-source

BinarySizeTest 1.0 (1)
com.revenuecat.binary-size-test.cocoapods

BinarySizeTest 1.0 (1)
com.revenuecat.binary-size-test.spm