feat(paywalls): enable web_view component (8)

[JZDesign]

Checklist

• If applicable, unit tests

Motivation

Final part of the web_view series (splitting #3757). This is the activation PR: the only change that alters runtime behavior, so reverting it alone turns the web_view feature off. All downstack parts (schema, transport envelope, navigation policy, JS bridge, Compose view, kotlinx transport refactor, WebView profile isolation) are merged; this now sits standalone on main.

Description

• Register "web_view" in the PaywallComponent deserializer
• Replace the StyleFactory stub (Result.Success(null)) with createWebViewComponentStyle
• Add WebViewComponent.SUPPORTED_PROTOCOL_VERSION as the single source of truth for the supported version; the runtime handshake in :ui:revenuecatui derives from it, so the decode-time gate and the handshake cannot disagree
• Absent, malformed, or unsupported protocol_version renders the component fallback (same path as an unknown component), gated on the raw value before decode for forward compatibility
• Tests: WebViewComponentTests decode and version-gate cases, StyleFactoryTests, and e2e WebViewOfferingToStateTest (a config with web_view produces a WebViewComponentStyle in the paywall state)

Submodule

No web_view preview fixtures on the resources submodule; pointer left untouched.

Verified locally: WebViewComponentTests, StyleFactoryTests, webview.* (incl. e2e), detektAll.

Labels: pr:feat, pr:RevenueCatUI, feat:Paywalls_V2

After merge

Close #3757 as superseded (do not merge it).

---

Note

Medium Risk
Enables hosted WebView content in paywalls (new attack/rendering surface), though unsupported protocol versions and missing fallbacks are gated; misconfigured paywalls without fallbacks can still fail deserialization.

Overview
Turns on Paywalls V2 web_view end-to-end: configs with type: "web_view" now deserialize through PaywallComponent and map to WebViewComponentStyle instead of being dropped by the StyleFactory stub.

Decoding: "web_view" is registered in PaywallComponentSerializer. protocol_version is checked on the raw JSON before decoding the body; only version 1 (WebViewComponent.SUPPORTED_PROTOCOL_VERSION) becomes a WebViewComponent. Missing, malformed, or unsupported versions use the same fallback path as unknown components (including forward-incompatible future payloads), with a shared decodeFallback helper.

Runtime alignment: WebViewEnvelope.DEFAULT_PROTOCOL_VERSION now derives from WebViewComponent.SUPPORTED_PROTOCOL_VERSION so the schema gate and JS bridge handshake stay in sync.

Tests: Polymorphic decode and version-gate cases in WebViewComponentTests, StyleFactory coverage, and WebViewOfferingToStateTest (config → paywall state includes WebViewComponentStyle).

^{Reviewed by Cursor Bugbot for commit 346e2c8. Bugbot is set up for automated code reviews on this repo. Configure here.}

[AlvaroBrey]

• feat(paywalls): enable web_view component (8) #3787 👈 (View in Graphite)
• fix(RevenueCatUI): host web_view in a FrameLayout to prevent off-screen RenderThread crash #3829
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[codecov]

Codecov Report

❌ Patch coverage is 92.85714% with 1 line in your changes missing coverage. Please review.
✅ Project coverage is 80.44%. Comparing base (ca2c344) to head (346e2c8).
⚠️ Report is 1 commits behind head on main.

Files with missing lines	Patch %	Lines
.../purchases/paywalls/components/PaywallComponent.kt	92.30%	0 Missing and 1 partial ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #3787      +/-   ##
==========================================
+ Coverage   80.43%   80.44%   +0.01%     
==========================================
  Files         408      408              
  Lines       16890    16900      +10     
  Branches     2467     2469       +2     
==========================================
+ Hits        13586    13596      +10     
  Misses       2342     2342              
  Partials      962      962              

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[emerge-tools]

📸 Snapshot Test

621 unchanged

Name	Added	Removed	Modified	Renamed	Unchanged	Errored	Approval
TestPurchasesUIAndroidCompatibility com.revenuecat.testpurchasesuiandroidcompatibility	0	0	0	0	339	0	N/A
TestPurchasesUIAndroidCompatibility Paparazzi com.revenuecat.testpurchasesuiandroidcompatibility.paparazzi	0	0	0	0	282	0	N/A

---

🛸 Powered by Emerge Tools

[AlvaroBrey]

@cursor review

[cursor]

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

^{Reviewed by Cursor Bugbot for commit 12112d7. Configure here.}

[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 ec6fa0b. Configure here.}