[gauthierpetetin]

Explanation

AnalyticsController and SubscriptionController already call GeolocationController:getGeolocationData through the wallet root messenger, but hosts still had to construct and register GeolocationController (and GeolocationApiService) themselves. That left a race when hosts called wallet.init() before registering geolocation on a later init path.

This PR adds GeolocationController and GeolocationApiService to the default @metamask/wallet initialization configurations, matching other migrated controllers. Optional instanceOptions.geolocationApiService accepts env, fetch, ttlMs, and policyOptions (defaults to production and globalThis.fetch). GeolocationController delegates GeolocationApiService:fetchGeolocationData. Hosts that enable Analytics geolocation enrichment no longer need to register GeolocationController themselves.

References

• Related to MUL-2022 (Migrate controllers initialization into Wallet Library)
• Follow-up to feat(wallet)!: wire AnalyticsController into default initialization #10901 (AnalyticsController default initialization)

Checklist

• I've updated the test suite for new or updated code as appropriate
• I've updated documentation (JSDoc, Markdown, etc.) for new or updated code as appropriate
• I've communicated my changes to consumers by updating changelogs for packages I've changed
• I've introduced breaking changes in this PR and have prepared draft pull requests for clients and consumer packages to resolve them
  • Hosts that already register GeolocationController or GeolocationApiService on the wallet root messenger must remove them before upgrading, or messenger registration will collide.

---

Note

Medium Risk
Breaking messenger registration change for existing hosts; default init also enables outbound geolocation API fetches when those code paths run.

Overview
Breaking: @metamask/wallet now constructs GeolocationController and GeolocationApiService as part of default initialization, so analytics/subscription flows can call GeolocationController:getGeolocationData without hosts wiring geolocation first.

Hosts may tune the API client via optional instanceOptions.geolocationApiService (env, fetch, ttlMs, policyOptions; defaults are production + globalThis.fetch). The controller’s messenger delegates GeolocationApiService:fetchGeolocationData. Documentation for analyticsController.isGeolocationEnabled now states wallet supplies geolocation instead of requiring host registration.

Upgrade note: remove any existing GeolocationController / GeolocationApiService registrations on the wallet root messenger before upgrading, or initialization will collide.

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

[Copilot]

🟢 Approval recommended

Static review found no blocking issues in initialization, messenger wiring, or migration guidance; tests were inspected but not executed.

No open issues 🎉

What changed in this PR

Adds wallet-owned geolocation initialization so Analytics and Subscription controllers no longer depend on hosts registering geolocation separately, addressing the initialization race.

Changes:

• Registers GeolocationController and GeolocationApiService by default, with messenger delegation and optional service settings.
• Adds tests for registration, initialization, environment selection, and geolocation requests.
• Updates dependencies, TypeScript references, and breaking-change guidance requiring hosts to remove duplicate registrations.

File	Description
yarn.lock	Records the wallet’s geolocation dependency.
packages/​wallet/​tsconfig.lint.json	Adds the geolocation lint project reference.
packages/​wallet/​tsconfig.json	Adds the geolocation development project reference.
packages/​wallet/​tsconfig.build.json	Adds the geolocation build project reference.
packages/​wallet/​src/​types.ts	Exposes optional geolocation service settings.
packages/​wallet/​src/​initialization/​instances/​index.ts	Exports both default geolocation configurations.
packages/​wallet/​src/​initialization/​instances/​geolocation-controller/​geolocation-controller.ts	Initializes the controller and delegates API access.
packages/​wallet/​src/​initialization/​instances/​geolocation-controller/​geolocation-controller.test.ts	Tests registration, state, delegation, and service integration.
packages/​wallet/​src/​initialization/​instances/​geolocation-api-service/​types.ts	Defines optional environment, fetch, cache, and policy settings.
packages/​wallet/​src/​initialization/​instances/​geolocation-api-service/​geolocation-api-service.ts	Initializes the service with configurable options.
packages/​wallet/​src/​initialization/​instances/​geolocation-api-service/​geolocation-api-service.test.ts	Tests registration, construction, and environment selection.
packages/​wallet/​src/​initialization/​instances/​analytics-controller/​types.ts	Updates documentation to describe wallet-owned geolocation.
packages/​wallet/​package.json	Declares the geolocation package dependency.
packages/​wallet/​CHANGELOG.md	Documents default initialization and migration requirements.

_{Review effort: Balanced}