[alyssoncm]

What

• Monthly only in the direct checkout. Paywall checkouts open on the monthly price, with no yearly option. Plan Usage defaults back to Monthly; yearly stays one toggle away there.
• Gate views only on real paywalls. baas_upgrade_gate_viewed fires only on paywalls the user reaches by trying the feature (logView). Always-on Overview buttons (plan badge/card, MongoDB 8, web hosting, HTTPS, compliance) log only the click.

Why

Since the paywalls went direct-to-checkout, MVP yearly ($180 today) converted 0/61 openings (Oct 6–12, Paddle export), and the Overview buttons inflated gate views on every visit.

Note

This branch is based on #835 and conflicts with production2 (#836/#837 touched UpgradeCheckout.react.js, DomainSettings.react.js and the checkout tests). The conflicts are not resolved yet; the gates added after #835 (usage limit, backup, region, etc.) still need a logView decision during the resolution.

🤖 Generated with Claude Code

---

Also in this PR: what Paddle reports from inside the checkout (f411bff9)

The Backend checkout only logged opened and closed, so a drop in payments couldn't tell "never saw the form" from "saw it and left" from "tried to pay and was declined". Both places that open the Paddle checkout (the paywall modal and the Plan Usage page) now log:

Event	When
baas_checkout_loaded	Paddle checkout.loaded
baas_payment_initiated	Paddle checkout.payment.initiated, when the card is sent
baas_payment_failed	Paddle checkout.payment.failed, with error_type, error_code and error_detail
baas_checkout_event	everything else Paddle reports, with name set to Paddle's name (checkout.error, checkout.warning, checkout.failed, checkout.payment.selected, …)

• Each event carries the checkout's funnel context (app_id, plan, cycle, source, gate) and checkout_id, the che_ that Paddle support asks for.
• Each name and error code is sent once per checkout. Frame plumbing that says nothing about the buyer (ping.size, removespinner, frame.revealed) is left out.
• No card or email data is read.
• The logic is paddleEventToTrack in lib/upgradeEvents, tested on its own. trackPaddleEvent only logs for a checkout the page opened.
• Same instrumentation as Containers (back4app/back4app2#1298) and the Agent (back4app/back4app-frontend#225).

Checks

• Tests: upgradeEvents.test.js and UpgradeCheckout.test.js pass (21 tests, 5 of them new).
• eslint is clean on the changed files except AppPlan.react.js. Its 8 errors (b4aSettings no-undef and a missing newline at the end of the file) are already on the base branch.
• Full jest run: the same 8 suites and 4 tests fail with and without this change.
• Not tested in a browser.