Age range verification

[RafaelKayumov]

Temporary: Will re-create this PR targeting the 23.8.1 hotfix.

WOOMOB-1862

Description

• Integrate Apple’s Declared Age Range API flow (iOS 26+) and hook it into app entry points:
  • Runs on login and after the main UI is shown for already-authenticated users.
  • Presents a SwiftUI blocking screen for underage/declined cases; CTA logs out and returns to login.
  • Age verification service/coordinator lives in ServiceLocator; AppCoordinator triggers and handles blocking.
• Added SwiftUI blocker (AgeGateBlockedHostingController) for “too young” / “consent revoked” states.
• Declared Age capability/entitlement is already wired; code now uses the centralized service.

Unit tests are added in the separate PR: #16482

Test Steps

Age range data access declined [any age] -> no blocker

• Use iOS 26 device
• Have the app in logged in state
• Launch the app and make sure the system age verification dialogue is displayed
• Refuse from sharing
• Make sure dialogue disappears and app works as usual

Age range data access provided [13+] -> no blocker

• Use iOS 26 device
• Have the app in logged in state
• Use Apple account with 13+ age
• Launch the app and make sure the system age verification dialogue is displayed
• Provide access
• Make sure dialogue disappears and app works as usual

Age range data access provided -> [under 13] -> blocker UI

• Use iOS 26 device
• Have the app in logged in state
• Use Apple account with age below 13
• Launch the app
• Make sure the system age verification dialogue is displayed (if age range wasn't shared before)
• Provide access
• The blocking overlay should display
• Tap on blocking UI CTA and make sure to be navigated to start(logged off) screen

[under 13][logged out] Age range data access provided -> blocker UI

• Use iOS 26 device
• Have the app in logged OUT state
• Use Apple account with age below 13
• Launch the app
• Start authentication
• Make sure the system age verification dialogue is displayed (if age range wasn't shared before)
• Provide access
• The blocking overlay should display
• Tap on blocking UI CTA and make sure to be taken back to the start(logged off) screen.

[under 13][logged out][iOS 18] SDK not supported -> no blockers

• Use iOS 18 device (any non-iOS 26 device)
• Use apple account with an age below 13
• Smoke the app - both logged in and logged out state
• Since we don't have the SDK working here - there should be no blockers even for underage accounts.

Screenshots

TBD

---

• I have considered if this change warrants user-facing release notes and have added them to RELEASE-NOTES.txt if necessary.

[dangermattic]

	1 Warning
⚠️	This PR is larger than 300 lines of changes. Please consider splitting it into smaller PRs for easier and faster reviews.

	1 Message
📖	This PR is still a Draft: some checks will be skipped.

Generated by 🚫 Danger

[wpmobilebot]

📲 You can test the changes from this Pull Request in WooCommerce iOS Prototype by scanning the QR code below to install the corresponding build.

	App Name	WooCommerce iOS Prototype
	Build Number	pr16452-ad62e5b
	Version	23.8
	Bundle ID	com.automattic.alpha.woocommerce
	Commit	ad62e5b
	Installation URL	12tehih60o75g

Automatticians: You can use our internal self-serve MC tool to give yourself access to those builds if needed.