feat: update action types

Author: MarioAslau

packages/geolocation-controller/src/GeolocationController-method-action-types.ts

@@ -6,11 +6,11 @@
 import type { GeolocationController } from './GeolocationController';
 
 /**
- * Returns the geolocation country code. Delegates to the
+ * Returns the geolocation code. Delegates to the
  * {@link GeolocationApiService} for network fetching and caching, then
  * updates controller state with the result.
  *
- * @returns The ISO country code string.
+ * @returns The ISO 3166-2 location code string.
  */
 export type GeolocationControllerGetGeolocationAction = {
   type: `GeolocationController:getGeolocation`;
@@ -20,7 +20,7 @@ export type GeolocationControllerGetGeolocationAction = {
 /**
  * Forces a fresh geolocation fetch, bypassing the service's cache.
  *
- * @returns The ISO country code string.
+ * @returns The ISO 3166-2 location code string.
  */
 export type GeolocationControllerRefreshGeolocationAction = {
   type: `GeolocationController:refreshGeolocation`;

packages/geolocation-controller/src/geolocation-api-service/geolocation-api-service-method-action-types.ts

@@ -6,15 +6,15 @@
 import type { GeolocationApiService } from './geolocation-api-service';
 
 /**
- * Returns the geolocation country code. Serves from cache when the TTL has
- * not expired, otherwise performs a network fetch. Concurrent callers are
+ * Returns the geolocation code. Serves from cache when the TTL has not
+ * expired, otherwise performs a network fetch. Concurrent callers are
  * deduplicated to a single in-flight request.
  *
  * @param options - Optional fetch options.
  * @param options.bypassCache - When true, invalidates the cache and forces a
  * fresh network request.
- * @returns The ISO 3166-1 alpha-2 country code, or `UNKNOWN_LOCATION`
- * when the API returns an empty or invalid body.
+ * @returns An ISO 3166-2 location code (e.g. `US`, `US-NY`, `CA-ON`), or
+ * `UNKNOWN_LOCATION` when the API returns an empty or invalid body.
  */
 export type GeolocationApiServiceFetchGeolocationAction = {
   type: `GeolocationApiService:fetchGeolocation`;