@metamask-previews/geolocation-controller 0.1.0-preview-0aca970c8

package/dist/geolocation-api-service/geolocation-api-service.d.mts

@@ -0,0 +1,127 @@
+import type { CreateServicePolicyOptions, ServicePolicy } from "@metamask/controller-utils";
+import type { Messenger } from "@metamask/messenger";
+import type { IDisposable } from "cockatiel";
+import type { GeolocationApiServiceMethodActions } from "./geolocation-api-service-method-action-types.mjs";
+import { Env } from "../types.mjs";
+/**
+ * The name of the {@link GeolocationApiService}, used to namespace the
+ * service's actions and events.
+ */
+export declare const serviceName = "GeolocationApiService";
+/**
+ * Sentinel value used when the geolocation has not been determined yet or when
+ * the API returns an empty / invalid response.
+ */
+export declare const UNKNOWN_LOCATION = "UNKNOWN";
+/**
+ * Actions that {@link GeolocationApiService} exposes to other consumers.
+ */
+export type GeolocationApiServiceActions = GeolocationApiServiceMethodActions;
+/**
+ * Actions from other messengers that {@link GeolocationApiServiceMessenger}
+ * calls.
+ */
+type AllowedActions = never;
+/**
+ * Events that {@link GeolocationApiService} exposes to other consumers.
+ */
+export type GeolocationApiServiceEvents = never;
+/**
+ * Events from other messengers that {@link GeolocationApiService} subscribes
+ * to.
+ */
+type AllowedEvents = never;
+/**
+ * The messenger restricted to actions and events accessed by
+ * {@link GeolocationApiService}.
+ */
+export type GeolocationApiServiceMessenger = Messenger<typeof serviceName, GeolocationApiServiceActions | AllowedActions, GeolocationApiServiceEvents | AllowedEvents>;
+/**
+ * Options accepted by {@link GeolocationApiService.fetchGeolocation}.
+ */
+export type FetchGeolocationOptions = {
+    /** When true, the TTL cache is invalidated so the next request fetches fresh data. */
+    bypassCache?: boolean;
+};
+/**
+ * Low-level data service that fetches a country code from the geolocation API.
+ *
+ * Responsibilities:
+ * - HTTP request to the geolocation endpoint (wrapped in a service policy)
+ * - ISO 3166-1 alpha-2 response validation
+ * - TTL-based in-memory cache
+ * - Promise deduplication (concurrent callers share a single in-flight request)
+ *
+ * This class is intentionally not a controller: it does not manage UI state.
+ * Its {@link fetchGeolocation} method is automatically registered on the
+ * messenger so that controllers and other packages can call it directly.
+ */
+export declare class GeolocationApiService {
+    #private;
+    /**
+     * The name of the service.
+     */
+    readonly name: typeof serviceName;
+    /**
+     * Constructs a new {@link GeolocationApiService}.
+     *
+     * @param args - The constructor arguments.
+     * @param args.messenger - The messenger suited for this service.
+     * @param args.env - The environment to determine the correct API endpoint.
+     * Defaults to PRD.
+     * @param args.fetch - A function that can be used to make an HTTP request.
+     * Defaults to the global fetch.
+     * @param args.ttlMs - Cache TTL in milliseconds. Defaults to 5 minutes.
+     * @param args.policyOptions - Options to pass to `createServicePolicy`, which
+     * is used to wrap each request. See {@link CreateServicePolicyOptions}.
+     */
+    constructor({ messenger, env, fetch: fetchFunction, ttlMs, policyOptions, }: {
+        messenger: GeolocationApiServiceMessenger;
+        env?: Env;
+        fetch?: typeof fetch;
+        ttlMs?: number;
+        policyOptions?: CreateServicePolicyOptions;
+    });
+    /**
+     * Registers a handler that will be called after a request returns a 5xx
+     * response, causing a retry.
+     *
+     * @param listener - The handler to be called.
+     * @returns An object that can be used to unregister the handler.
+     * @see {@link createServicePolicy}
+     */
+    onRetry(listener: Parameters<ServicePolicy['onRetry']>[0]): IDisposable;
+    /**
+     * Registers a handler that will be called after a set number of retry rounds
+     * prove that requests to the API endpoint consistently return a 5xx response.
+     *
+     * @param listener - The handler to be called.
+     * @returns An object that can be used to unregister the handler.
+     * @see {@link createServicePolicy}
+     */
+    onBreak(listener: Parameters<ServicePolicy['onBreak']>[0]): IDisposable;
+    /**
+     * Registers a handler that will be called when requests are consistently
+     * failing or when a successful request takes longer than the degraded
+     * threshold.
+     *
+     * @param listener - The handler to be called.
+     * @returns An object that can be used to unregister the handler.
+     */
+    onDegraded(listener: Parameters<ServicePolicy['onDegraded']>[0]): IDisposable;
+    /**
+     * Returns the geolocation country 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 TTL cache. If a
+     * request is already in-flight it will be reused (deduplication always
+     * applies).
+     * @returns The ISO 3166-1 alpha-2 country code, or {@link UNKNOWN_LOCATION}
+     * when the API returns an empty or invalid body.
+     */
+    fetchGeolocation(options?: FetchGeolocationOptions): Promise<string>;
+}
+export {};
+//# sourceMappingURL=geolocation-api-service.d.mts.map

package/dist/geolocation-api-service/geolocation-api-service.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geolocation-api-service.d.mts","sourceRoot":"","sources":["../../src/geolocation-api-service/geolocation-api-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,0BAA0B,EAC1B,aAAa,EACd,mCAAmC;AAEpC,OAAO,KAAK,EAAE,SAAS,EAAE,4BAA4B;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB;AAE7C,OAAO,KAAK,EAAE,kCAAkC,EAAE,0DAAsD;AACxG,OAAO,EAAE,GAAG,EAAE,qBAAiB;AAQ/B;;;GAGG;AACH,eAAO,MAAM,WAAW,0BAA0B,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAM1C;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG,kCAAkC,CAAC;AAE9E;;;GAGG;AACH,KAAK,cAAc,GAAG,KAAK,CAAC;AAE5B;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG,KAAK,CAAC;AAEhD;;;GAGG;AACH,KAAK,aAAa,GAAG,KAAK,CAAC;AAE3B;;;GAGG;AACH,MAAM,MAAM,8BAA8B,GAAG,SAAS,CACpD,OAAO,WAAW,EAClB,4BAA4B,GAAG,cAAc,EAC7C,2BAA2B,GAAG,aAAa,CAC5C,CAAC;AAeF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,sFAAsF;IACtF,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,qBAAa,qBAAqB;;IAChC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,WAAW,CAAC;IAuBlC;;;;;;;;;;;;OAYG;gBACS,EACV,SAAS,EACT,GAAa,EACb,KAAK,EAAE,aAAgC,EACvC,KAAK,EACL,aAAkB,GACnB,EAAE;QACD,SAAS,EAAE,8BAA8B,CAAC;QAC1C,GAAG,CAAC,EAAE,GAAG,CAAC;QACV,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,aAAa,CAAC,EAAE,0BAA0B,CAAC;KAC5C;IAcD;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW;IAIvE;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW;IAIvE;;;;;;;OAOG;IACH,UAAU,CACR,QAAQ,EAAE,UAAU,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,GACnD,WAAW;IAId;;;;;;;;;;;OAWG;IACG,gBAAgB,CAAC,OAAO,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC;CA+D3E"}

package/dist/geolocation-api-service/geolocation-api-service.mjs

@@ -0,0 +1,182 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _GeolocationApiService_instances, _GeolocationApiService_messenger, _GeolocationApiService_fetch, _GeolocationApiService_url, _GeolocationApiService_ttlMs, _GeolocationApiService_policy, _GeolocationApiService_cachedLocation, _GeolocationApiService_lastFetchedAt, _GeolocationApiService_fetchPromise, _GeolocationApiService_isCacheValid, _GeolocationApiService_performFetch;
+import { createServicePolicy, HttpError } from "@metamask/controller-utils";
+import { Env } from "../types.mjs";
+const DEFAULT_TTL_MS = 5 * 60 * 1000;
+const ENDPOINT_PATH = '/geolocation';
+// === GENERAL ===
+/**
+ * The name of the {@link GeolocationApiService}, used to namespace the
+ * service's actions and events.
+ */
+export const serviceName = 'GeolocationApiService';
+/**
+ * Sentinel value used when the geolocation has not been determined yet or when
+ * the API returns an empty / invalid response.
+ */
+export const UNKNOWN_LOCATION = 'UNKNOWN';
+// === MESSENGER ===
+const MESSENGER_EXPOSED_METHODS = ['fetchGeolocation'];
+// === SERVICE DEFINITION ===
+/**
+ * Returns the base URL for the geolocation API for the given environment.
+ *
+ * @param env - The environment to get the URL for.
+ * @returns The full URL for the geolocation endpoint.
+ */
+function getGeolocationUrl(env) {
+    const envPrefix = env === Env.PRD ? '' : `${env}-`;
+    return `https://on-ramp.${envPrefix}api.cx.metamask.io${ENDPOINT_PATH}`;
+}
+/**
+ * Low-level data service that fetches a country code from the geolocation API.
+ *
+ * Responsibilities:
+ * - HTTP request to the geolocation endpoint (wrapped in a service policy)
+ * - ISO 3166-1 alpha-2 response validation
+ * - TTL-based in-memory cache
+ * - Promise deduplication (concurrent callers share a single in-flight request)
+ *
+ * This class is intentionally not a controller: it does not manage UI state.
+ * Its {@link fetchGeolocation} method is automatically registered on the
+ * messenger so that controllers and other packages can call it directly.
+ */
+export class GeolocationApiService {
+    /**
+     * Constructs a new {@link GeolocationApiService}.
+     *
+     * @param args - The constructor arguments.
+     * @param args.messenger - The messenger suited for this service.
+     * @param args.env - The environment to determine the correct API endpoint.
+     * Defaults to PRD.
+     * @param args.fetch - A function that can be used to make an HTTP request.
+     * Defaults to the global fetch.
+     * @param args.ttlMs - Cache TTL in milliseconds. Defaults to 5 minutes.
+     * @param args.policyOptions - Options to pass to `createServicePolicy`, which
+     * is used to wrap each request. See {@link CreateServicePolicyOptions}.
+     */
+    constructor({ messenger, env = Env.PRD, fetch: fetchFunction = globalThis.fetch, ttlMs, policyOptions = {}, }) {
+        _GeolocationApiService_instances.add(this);
+        _GeolocationApiService_messenger.set(this, void 0);
+        _GeolocationApiService_fetch.set(this, void 0);
+        _GeolocationApiService_url.set(this, void 0);
+        _GeolocationApiService_ttlMs.set(this, void 0);
+        /**
+         * The policy that wraps each HTTP request.
+         *
+         * @see {@link createServicePolicy}
+         */
+        _GeolocationApiService_policy.set(this, void 0);
+        _GeolocationApiService_cachedLocation.set(this, UNKNOWN_LOCATION);
+        _GeolocationApiService_lastFetchedAt.set(this, null);
+        _GeolocationApiService_fetchPromise.set(this, null);
+        this.name = serviceName;
+        __classPrivateFieldSet(this, _GeolocationApiService_messenger, messenger, "f");
+        __classPrivateFieldSet(this, _GeolocationApiService_url, getGeolocationUrl(env), "f");
+        __classPrivateFieldSet(this, _GeolocationApiService_fetch, fetchFunction, "f");
+        __classPrivateFieldSet(this, _GeolocationApiService_ttlMs, ttlMs ?? DEFAULT_TTL_MS, "f");
+        __classPrivateFieldSet(this, _GeolocationApiService_policy, createServicePolicy(policyOptions), "f");
+        __classPrivateFieldGet(this, _GeolocationApiService_messenger, "f").registerMethodActionHandlers(this, MESSENGER_EXPOSED_METHODS);
+    }
+    /**
+     * Registers a handler that will be called after a request returns a 5xx
+     * response, causing a retry.
+     *
+     * @param listener - The handler to be called.
+     * @returns An object that can be used to unregister the handler.
+     * @see {@link createServicePolicy}
+     */
+    onRetry(listener) {
+        return __classPrivateFieldGet(this, _GeolocationApiService_policy, "f").onRetry(listener);
+    }
+    /**
+     * Registers a handler that will be called after a set number of retry rounds
+     * prove that requests to the API endpoint consistently return a 5xx response.
+     *
+     * @param listener - The handler to be called.
+     * @returns An object that can be used to unregister the handler.
+     * @see {@link createServicePolicy}
+     */
+    onBreak(listener) {
+        return __classPrivateFieldGet(this, _GeolocationApiService_policy, "f").onBreak(listener);
+    }
+    /**
+     * Registers a handler that will be called when requests are consistently
+     * failing or when a successful request takes longer than the degraded
+     * threshold.
+     *
+     * @param listener - The handler to be called.
+     * @returns An object that can be used to unregister the handler.
+     */
+    onDegraded(listener) {
+        return __classPrivateFieldGet(this, _GeolocationApiService_policy, "f").onDegraded(listener);
+    }
+    /**
+     * Returns the geolocation country 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 TTL cache. If a
+     * request is already in-flight it will be reused (deduplication always
+     * applies).
+     * @returns The ISO 3166-1 alpha-2 country code, or {@link UNKNOWN_LOCATION}
+     * when the API returns an empty or invalid body.
+     */
+    async fetchGeolocation(options) {
+        if (options?.bypassCache) {
+            __classPrivateFieldSet(this, _GeolocationApiService_lastFetchedAt, null, "f");
+        }
+        if (__classPrivateFieldGet(this, _GeolocationApiService_instances, "m", _GeolocationApiService_isCacheValid).call(this)) {
+            return __classPrivateFieldGet(this, _GeolocationApiService_cachedLocation, "f");
+        }
+        if (__classPrivateFieldGet(this, _GeolocationApiService_fetchPromise, "f")) {
+            return __classPrivateFieldGet(this, _GeolocationApiService_fetchPromise, "f");
+        }
+        const promise = __classPrivateFieldGet(this, _GeolocationApiService_instances, "m", _GeolocationApiService_performFetch).call(this);
+        __classPrivateFieldSet(this, _GeolocationApiService_fetchPromise, promise, "f");
+        try {
+            return await promise;
+        }
+        finally {
+            __classPrivateFieldSet(this, _GeolocationApiService_fetchPromise, null, "f");
+        }
+    }
+}
+_GeolocationApiService_messenger = new WeakMap(), _GeolocationApiService_fetch = new WeakMap(), _GeolocationApiService_url = new WeakMap(), _GeolocationApiService_ttlMs = new WeakMap(), _GeolocationApiService_policy = new WeakMap(), _GeolocationApiService_cachedLocation = new WeakMap(), _GeolocationApiService_lastFetchedAt = new WeakMap(), _GeolocationApiService_fetchPromise = new WeakMap(), _GeolocationApiService_instances = new WeakSet(), _GeolocationApiService_isCacheValid = function _GeolocationApiService_isCacheValid() {
+    return (__classPrivateFieldGet(this, _GeolocationApiService_lastFetchedAt, "f") !== null &&
+        Date.now() - __classPrivateFieldGet(this, _GeolocationApiService_lastFetchedAt, "f") < __classPrivateFieldGet(this, _GeolocationApiService_ttlMs, "f"));
+}, _GeolocationApiService_performFetch = 
+/**
+ * Performs the actual HTTP fetch, wrapped in the service policy for automatic
+ * retry and circuit-breaking, and validates the response.
+ *
+ * @returns The ISO country code string.
+ */
+async function _GeolocationApiService_performFetch() {
+    const response = await __classPrivateFieldGet(this, _GeolocationApiService_policy, "f").execute(async () => {
+        const localResponse = await __classPrivateFieldGet(this, _GeolocationApiService_fetch, "f").call(this, __classPrivateFieldGet(this, _GeolocationApiService_url, "f"));
+        if (!localResponse.ok) {
+            throw new HttpError(localResponse.status, `Geolocation fetch failed: ${localResponse.status}`);
+        }
+        return localResponse;
+    });
+    const raw = (await response.text()).trim();
+    const location = /^[A-Z]{2}$/u.test(raw) ? raw : UNKNOWN_LOCATION;
+    if (location !== UNKNOWN_LOCATION) {
+        __classPrivateFieldSet(this, _GeolocationApiService_cachedLocation, location, "f");
+        __classPrivateFieldSet(this, _GeolocationApiService_lastFetchedAt, Date.now(), "f");
+    }
+    return location;
+};
+//# sourceMappingURL=geolocation-api-service.mjs.map

package/dist/geolocation-api-service/geolocation-api-service.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"geolocation-api-service.mjs","sourceRoot":"","sources":["../../src/geolocation-api-service/geolocation-api-service.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  CreateServicePolicyOptions,\n  ServicePolicy,\n} from '@metamask/controller-utils';\nimport { createServicePolicy, HttpError } from '@metamask/controller-utils';\nimport type { Messenger } from '@metamask/messenger';\nimport type { IDisposable } from 'cockatiel';\n\nimport type { GeolocationApiServiceMethodActions } from './geolocation-api-service-method-action-types';\nimport { Env } from '../types';\n\nconst DEFAULT_TTL_MS = 5 * 60 * 1000;\n\nconst ENDPOINT_PATH = '/geolocation';\n\n// === GENERAL ===\n\n/**\n * The name of the {@link GeolocationApiService}, used to namespace the\n * service's actions and events.\n */\nexport const serviceName = 'GeolocationApiService';\n\n/**\n * Sentinel value used when the geolocation has not been determined yet or when\n * the API returns an empty / invalid response.\n */\nexport const UNKNOWN_LOCATION = 'UNKNOWN';\n\n// === MESSENGER ===\n\nconst MESSENGER_EXPOSED_METHODS = ['fetchGeolocation'] as const;\n\n/**\n * Actions that {@link GeolocationApiService} exposes to other consumers.\n */\nexport type GeolocationApiServiceActions = GeolocationApiServiceMethodActions;\n\n/**\n * Actions from other messengers that {@link GeolocationApiServiceMessenger}\n * calls.\n */\ntype AllowedActions = never;\n\n/**\n * Events that {@link GeolocationApiService} exposes to other consumers.\n */\nexport type GeolocationApiServiceEvents = never;\n\n/**\n * Events from other messengers that {@link GeolocationApiService} subscribes\n * to.\n */\ntype AllowedEvents = never;\n\n/**\n * The messenger restricted to actions and events accessed by\n * {@link GeolocationApiService}.\n */\nexport type GeolocationApiServiceMessenger = Messenger<\n  typeof serviceName,\n  GeolocationApiServiceActions | AllowedActions,\n  GeolocationApiServiceEvents | AllowedEvents\n>;\n\n// === SERVICE DEFINITION ===\n\n/**\n * Returns the base URL for the geolocation API for the given environment.\n *\n * @param env - The environment to get the URL for.\n * @returns The full URL for the geolocation endpoint.\n */\nfunction getGeolocationUrl(env: Env): string {\n  const envPrefix = env === Env.PRD ? '' : `${env}-`;\n  return `https://on-ramp.${envPrefix}api.cx.metamask.io${ENDPOINT_PATH}`;\n}\n\n/**\n * Options accepted by {@link GeolocationApiService.fetchGeolocation}.\n */\nexport type FetchGeolocationOptions = {\n  /** When true, the TTL cache is invalidated so the next request fetches fresh data. */\n  bypassCache?: boolean;\n};\n\n/**\n * Low-level data service that fetches a country code from the geolocation API.\n *\n * Responsibilities:\n * - HTTP request to the geolocation endpoint (wrapped in a service policy)\n * - ISO 3166-1 alpha-2 response validation\n * - TTL-based in-memory cache\n * - Promise deduplication (concurrent callers share a single in-flight request)\n *\n * This class is intentionally not a controller: it does not manage UI state.\n * Its {@link fetchGeolocation} method is automatically registered on the\n * messenger so that controllers and other packages can call it directly.\n */\nexport class GeolocationApiService {\n  /**\n   * The name of the service.\n   */\n  readonly name: typeof serviceName;\n\n  readonly #messenger: GeolocationApiServiceMessenger;\n\n  readonly #fetch: typeof globalThis.fetch;\n\n  readonly #url: string;\n\n  readonly #ttlMs: number;\n\n  /**\n   * The policy that wraps each HTTP request.\n   *\n   * @see {@link createServicePolicy}\n   */\n  readonly #policy: ServicePolicy;\n\n  #cachedLocation: string = UNKNOWN_LOCATION;\n\n  #lastFetchedAt: number | null = null;\n\n  #fetchPromise: Promise<string> | null = null;\n\n  /**\n   * Constructs a new {@link GeolocationApiService}.\n   *\n   * @param args - The constructor arguments.\n   * @param args.messenger - The messenger suited for this service.\n   * @param args.env - The environment to determine the correct API endpoint.\n   * Defaults to PRD.\n   * @param args.fetch - A function that can be used to make an HTTP request.\n   * Defaults to the global fetch.\n   * @param args.ttlMs - Cache TTL in milliseconds. Defaults to 5 minutes.\n   * @param args.policyOptions - Options to pass to `createServicePolicy`, which\n   * is used to wrap each request. See {@link CreateServicePolicyOptions}.\n   */\n  constructor({\n    messenger,\n    env = Env.PRD,\n    fetch: fetchFunction = globalThis.fetch,\n    ttlMs,\n    policyOptions = {},\n  }: {\n    messenger: GeolocationApiServiceMessenger;\n    env?: Env;\n    fetch?: typeof fetch;\n    ttlMs?: number;\n    policyOptions?: CreateServicePolicyOptions;\n  }) {\n    this.name = serviceName;\n    this.#messenger = messenger;\n    this.#url = getGeolocationUrl(env);\n    this.#fetch = fetchFunction;\n    this.#ttlMs = ttlMs ?? DEFAULT_TTL_MS;\n    this.#policy = createServicePolicy(policyOptions);\n\n    this.#messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n  }\n\n  /**\n   * Registers a handler that will be called after a request returns a 5xx\n   * response, causing a retry.\n   *\n   * @param listener - The handler to be called.\n   * @returns An object that can be used to unregister the handler.\n   * @see {@link createServicePolicy}\n   */\n  onRetry(listener: Parameters<ServicePolicy['onRetry']>[0]): IDisposable {\n    return this.#policy.onRetry(listener);\n  }\n\n  /**\n   * Registers a handler that will be called after a set number of retry rounds\n   * prove that requests to the API endpoint consistently return a 5xx response.\n   *\n   * @param listener - The handler to be called.\n   * @returns An object that can be used to unregister the handler.\n   * @see {@link createServicePolicy}\n   */\n  onBreak(listener: Parameters<ServicePolicy['onBreak']>[0]): IDisposable {\n    return this.#policy.onBreak(listener);\n  }\n\n  /**\n   * Registers a handler that will be called when requests are consistently\n   * failing or when a successful request takes longer than the degraded\n   * threshold.\n   *\n   * @param listener - The handler to be called.\n   * @returns An object that can be used to unregister the handler.\n   */\n  onDegraded(\n    listener: Parameters<ServicePolicy['onDegraded']>[0],\n  ): IDisposable {\n    return this.#policy.onDegraded(listener);\n  }\n\n  /**\n   * Returns the geolocation country code. Serves from cache when the TTL has\n   * not expired, otherwise performs a network fetch. Concurrent callers are\n   * deduplicated to a single in-flight request.\n   *\n   * @param options - Optional fetch options.\n   * @param options.bypassCache - When true, invalidates the TTL cache. If a\n   * request is already in-flight it will be reused (deduplication always\n   * applies).\n   * @returns The ISO 3166-1 alpha-2 country code, or {@link UNKNOWN_LOCATION}\n   * when the API returns an empty or invalid body.\n   */\n  async fetchGeolocation(options?: FetchGeolocationOptions): Promise<string> {\n    if (options?.bypassCache) {\n      this.#lastFetchedAt = null;\n    }\n\n    if (this.#isCacheValid()) {\n      return this.#cachedLocation;\n    }\n\n    if (this.#fetchPromise) {\n      return this.#fetchPromise;\n    }\n\n    const promise = this.#performFetch();\n    this.#fetchPromise = promise;\n\n    try {\n      return await promise;\n    } finally {\n      this.#fetchPromise = null;\n    }\n  }\n\n  /**\n   * Checks whether the cached geolocation is still within the TTL window.\n   *\n   * @returns True if the cache is valid.\n   */\n  #isCacheValid(): boolean {\n    return (\n      this.#lastFetchedAt !== null &&\n      Date.now() - this.#lastFetchedAt < this.#ttlMs\n    );\n  }\n\n  /**\n   * Performs the actual HTTP fetch, wrapped in the service policy for automatic\n   * retry and circuit-breaking, and validates the response.\n   *\n   * @returns The ISO country code string.\n   */\n  async #performFetch(): Promise<string> {\n    const response = await this.#policy.execute(async () => {\n      const localResponse = await this.#fetch(this.#url);\n      if (!localResponse.ok) {\n        throw new HttpError(\n          localResponse.status,\n          `Geolocation fetch failed: ${localResponse.status}`,\n        );\n      }\n      return localResponse;\n    });\n\n    const raw = (await response.text()).trim();\n    const location = /^[A-Z]{2}$/u.test(raw) ? raw : UNKNOWN_LOCATION;\n\n    if (location !== UNKNOWN_LOCATION) {\n      this.#cachedLocation = location;\n      this.#lastFetchedAt = Date.now();\n    }\n\n    return location;\n  }\n}\n"]}

package/dist/index.cjs

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UNKNOWN_LOCATION = exports.GeolocationApiService = exports.getDefaultGeolocationControllerState = exports.GeolocationController = exports.Env = void 0;
+var types_1 = require("./types.cjs");
+Object.defineProperty(exports, "Env", { enumerable: true, get: function () { return types_1.Env; } });
+var GeolocationController_1 = require("./GeolocationController.cjs");
+Object.defineProperty(exports, "GeolocationController", { enumerable: true, get: function () { return GeolocationController_1.GeolocationController; } });
+Object.defineProperty(exports, "getDefaultGeolocationControllerState", { enumerable: true, get: function () { return GeolocationController_1.getDefaultGeolocationControllerState; } });
+var geolocation_api_service_1 = require("./geolocation-api-service/geolocation-api-service.cjs");
+Object.defineProperty(exports, "GeolocationApiService", { enumerable: true, get: function () { return geolocation_api_service_1.GeolocationApiService; } });
+Object.defineProperty(exports, "UNKNOWN_LOCATION", { enumerable: true, get: function () { return geolocation_api_service_1.UNKNOWN_LOCATION; } });
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAcA,qCAA8B;AAArB,4FAAA,GAAG,OAAA;AACZ,qEAGiC;AAF/B,8HAAA,qBAAqB,OAAA;AACrB,6IAAA,oCAAoC,OAAA;AAEtC,iGAG2D;AAFzD,gIAAA,qBAAqB,OAAA;AACrB,2HAAA,gBAAgB,OAAA","sourcesContent":["export type {\n  GeolocationControllerState,\n  GeolocationControllerGetStateAction,\n  GeolocationControllerActions,\n  GeolocationControllerStateChangeEvent,\n  GeolocationControllerEvents,\n  GeolocationControllerMessenger,\n  GeolocationControllerOptions,\n} from './GeolocationController';\nexport type {\n  GeolocationControllerGetGeolocationAction,\n  GeolocationControllerRefreshGeolocationAction,\n} from './GeolocationController-method-action-types';\nexport type { GeolocationRequestStatus } from './types';\nexport { Env } from './types';\nexport {\n  GeolocationController,\n  getDefaultGeolocationControllerState,\n} from './GeolocationController';\nexport {\n  GeolocationApiService,\n  UNKNOWN_LOCATION,\n} from './geolocation-api-service/geolocation-api-service';\nexport type {\n  GeolocationApiServiceMessenger,\n  GeolocationApiServiceActions,\n  GeolocationApiServiceEvents,\n  FetchGeolocationOptions,\n} from './geolocation-api-service/geolocation-api-service';\nexport type { GeolocationApiServiceFetchGeolocationAction } from './geolocation-api-service/geolocation-api-service-method-action-types';\n"]}

package/dist/index.d.cts

@@ -0,0 +1,9 @@
+export type { GeolocationControllerState, GeolocationControllerGetStateAction, GeolocationControllerActions, GeolocationControllerStateChangeEvent, GeolocationControllerEvents, GeolocationControllerMessenger, GeolocationControllerOptions, } from "./GeolocationController.cjs";
+export type { GeolocationControllerGetGeolocationAction, GeolocationControllerRefreshGeolocationAction, } from "./GeolocationController-method-action-types.cjs";
+export type { GeolocationRequestStatus } from "./types.cjs";
+export { Env } from "./types.cjs";
+export { GeolocationController, getDefaultGeolocationControllerState, } from "./GeolocationController.cjs";
+export { GeolocationApiService, UNKNOWN_LOCATION, } from "./geolocation-api-service/geolocation-api-service.cjs";
+export type { GeolocationApiServiceMessenger, GeolocationApiServiceActions, GeolocationApiServiceEvents, FetchGeolocationOptions, } from "./geolocation-api-service/geolocation-api-service.cjs";
+export type { GeolocationApiServiceFetchGeolocationAction } from "./geolocation-api-service/geolocation-api-service-method-action-types.cjs";
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,0BAA0B,EAC1B,mCAAmC,EACnC,4BAA4B,EAC5B,qCAAqC,EACrC,2BAA2B,EAC3B,8BAA8B,EAC9B,4BAA4B,GAC7B,oCAAgC;AACjC,YAAY,EACV,yCAAyC,EACzC,6CAA6C,GAC9C,wDAAoD;AACrD,YAAY,EAAE,wBAAwB,EAAE,oBAAgB;AACxD,OAAO,EAAE,GAAG,EAAE,oBAAgB;AAC9B,OAAO,EACL,qBAAqB,EACrB,oCAAoC,GACrC,oCAAgC;AACjC,OAAO,EACL,qBAAqB,EACrB,gBAAgB,GACjB,8DAA0D;AAC3D,YAAY,EACV,8BAA8B,EAC9B,4BAA4B,EAC5B,2BAA2B,EAC3B,uBAAuB,GACxB,8DAA0D;AAC3D,YAAY,EAAE,2CAA2C,EAAE,kFAA8E"}

package/dist/index.d.mts

@@ -0,0 +1,9 @@
+export type { GeolocationControllerState, GeolocationControllerGetStateAction, GeolocationControllerActions, GeolocationControllerStateChangeEvent, GeolocationControllerEvents, GeolocationControllerMessenger, GeolocationControllerOptions, } from "./GeolocationController.mjs";
+export type { GeolocationControllerGetGeolocationAction, GeolocationControllerRefreshGeolocationAction, } from "./GeolocationController-method-action-types.mjs";
+export type { GeolocationRequestStatus } from "./types.mjs";
+export { Env } from "./types.mjs";
+export { GeolocationController, getDefaultGeolocationControllerState, } from "./GeolocationController.mjs";
+export { GeolocationApiService, UNKNOWN_LOCATION, } from "./geolocation-api-service/geolocation-api-service.mjs";
+export type { GeolocationApiServiceMessenger, GeolocationApiServiceActions, GeolocationApiServiceEvents, FetchGeolocationOptions, } from "./geolocation-api-service/geolocation-api-service.mjs";
+export type { GeolocationApiServiceFetchGeolocationAction } from "./geolocation-api-service/geolocation-api-service-method-action-types.mjs";
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,0BAA0B,EAC1B,mCAAmC,EACnC,4BAA4B,EAC5B,qCAAqC,EACrC,2BAA2B,EAC3B,8BAA8B,EAC9B,4BAA4B,GAC7B,oCAAgC;AACjC,YAAY,EACV,yCAAyC,EACzC,6CAA6C,GAC9C,wDAAoD;AACrD,YAAY,EAAE,wBAAwB,EAAE,oBAAgB;AACxD,OAAO,EAAE,GAAG,EAAE,oBAAgB;AAC9B,OAAO,EACL,qBAAqB,EACrB,oCAAoC,GACrC,oCAAgC;AACjC,OAAO,EACL,qBAAqB,EACrB,gBAAgB,GACjB,8DAA0D;AAC3D,YAAY,EACV,8BAA8B,EAC9B,4BAA4B,EAC5B,2BAA2B,EAC3B,uBAAuB,GACxB,8DAA0D;AAC3D,YAAY,EAAE,2CAA2C,EAAE,kFAA8E"}

package/dist/index.mjs

@@ -0,0 +1,4 @@
+export { Env } from "./types.mjs";
+export { GeolocationController, getDefaultGeolocationControllerState } from "./GeolocationController.mjs";
+export { GeolocationApiService, UNKNOWN_LOCATION } from "./geolocation-api-service/geolocation-api-service.mjs";
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,GAAG,EAAE,oBAAgB;AAC9B,OAAO,EACL,qBAAqB,EACrB,oCAAoC,EACrC,oCAAgC;AACjC,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EACjB,8DAA0D","sourcesContent":["export type {\n  GeolocationControllerState,\n  GeolocationControllerGetStateAction,\n  GeolocationControllerActions,\n  GeolocationControllerStateChangeEvent,\n  GeolocationControllerEvents,\n  GeolocationControllerMessenger,\n  GeolocationControllerOptions,\n} from './GeolocationController';\nexport type {\n  GeolocationControllerGetGeolocationAction,\n  GeolocationControllerRefreshGeolocationAction,\n} from './GeolocationController-method-action-types';\nexport type { GeolocationRequestStatus } from './types';\nexport { Env } from './types';\nexport {\n  GeolocationController,\n  getDefaultGeolocationControllerState,\n} from './GeolocationController';\nexport {\n  GeolocationApiService,\n  UNKNOWN_LOCATION,\n} from './geolocation-api-service/geolocation-api-service';\nexport type {\n  GeolocationApiServiceMessenger,\n  GeolocationApiServiceActions,\n  GeolocationApiServiceEvents,\n  FetchGeolocationOptions,\n} from './geolocation-api-service/geolocation-api-service';\nexport type { GeolocationApiServiceFetchGeolocationAction } from './geolocation-api-service/geolocation-api-service-method-action-types';\n"]}

package/dist/types.cjs

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Env = void 0;
+/**
+ * Deployment environment for API endpoint selection.
+ */
+var Env;
+(function (Env) {
+    Env["DEV"] = "dev";
+    Env["UAT"] = "uat";
+    Env["PRD"] = "prd";
+})(Env || (exports.Env = Env = {}));
+//# sourceMappingURL=types.cjs.map

package/dist/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.cjs","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AASA;;GAEG;AACH,IAAY,GAIX;AAJD,WAAY,GAAG;IACb,kBAAW,CAAA;IACX,kBAAW,CAAA;IACX,kBAAW,CAAA;AACb,CAAC,EAJW,GAAG,mBAAH,GAAG,QAId","sourcesContent":["/**\n * The status of a geolocation fetch operation.\n */\nexport type GeolocationRequestStatus =\n  | 'idle'\n  | 'loading'\n  | 'complete'\n  | 'error';\n\n/**\n * Deployment environment for API endpoint selection.\n */\nexport enum Env {\n  DEV = 'dev',\n  UAT = 'uat',\n  PRD = 'prd',\n}\n"]}

package/dist/types.d.cts

@@ -0,0 +1,13 @@
+/**
+ * The status of a geolocation fetch operation.
+ */
+export type GeolocationRequestStatus = 'idle' | 'loading' | 'complete' | 'error';
+/**
+ * Deployment environment for API endpoint selection.
+ */
+export declare enum Env {
+    DEV = "dev",
+    UAT = "uat",
+    PRD = "prd"
+}
+//# sourceMappingURL=types.d.cts.map

package/dist/types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAChC,MAAM,GACN,SAAS,GACT,UAAU,GACV,OAAO,CAAC;AAEZ;;GAEG;AACH,oBAAY,GAAG;IACb,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;CACZ"}

package/dist/types.d.mts

@@ -0,0 +1,13 @@
+/**
+ * The status of a geolocation fetch operation.
+ */
+export type GeolocationRequestStatus = 'idle' | 'loading' | 'complete' | 'error';
+/**
+ * Deployment environment for API endpoint selection.
+ */
+export declare enum Env {
+    DEV = "dev",
+    UAT = "uat",
+    PRD = "prd"
+}
+//# sourceMappingURL=types.d.mts.map

package/dist/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAChC,MAAM,GACN,SAAS,GACT,UAAU,GACV,OAAO,CAAC;AAEZ;;GAEG;AACH,oBAAY,GAAG;IACb,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;CACZ"}

package/dist/types.mjs

@@ -0,0 +1,10 @@
+/**
+ * Deployment environment for API endpoint selection.
+ */
+export var Env;
+(function (Env) {
+    Env["DEV"] = "dev";
+    Env["UAT"] = "uat";
+    Env["PRD"] = "prd";
+})(Env || (Env = {}));
+//# sourceMappingURL=types.mjs.map

package/dist/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AASA;;GAEG;AACH,MAAM,CAAN,IAAY,GAIX;AAJD,WAAY,GAAG;IACb,kBAAW,CAAA;IACX,kBAAW,CAAA;IACX,kBAAW,CAAA;AACb,CAAC,EAJW,GAAG,KAAH,GAAG,QAId","sourcesContent":["/**\n * The status of a geolocation fetch operation.\n */\nexport type GeolocationRequestStatus =\n  | 'idle'\n  | 'loading'\n  | 'complete'\n  | 'error';\n\n/**\n * Deployment environment for API endpoint selection.\n */\nexport enum Env {\n  DEV = 'dev',\n  UAT = 'uat',\n  PRD = 'prd',\n}\n"]}

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@metamask-previews/geolocation-controller",
+  "version": "0.1.0-preview-0aca970c8",
+  "description": "Centralised geolocation controller with TTL caching and request deduplication",
+  "keywords": [
+    "MetaMask",
+    "Ethereum"
+  ],
+  "homepage": "https://github.com/MetaMask/core/tree/main/packages/geolocation-controller#readme",
+  "bugs": {
+    "url": "https://github.com/MetaMask/core/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MetaMask/core.git"
+  },
+  "license": "MIT",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.cjs",
+  "types": "./dist/index.d.cts",
+  "files": [
+    "dist/"
+  ],
+  "scripts": {
+    "build": "ts-bridge --project tsconfig.build.json --verbose --clean --no-references",
+    "build:all": "ts-bridge --project tsconfig.build.json --verbose --clean",
+    "build:docs": "typedoc",
+    "changelog:update": "../../scripts/update-changelog.sh @metamask/geolocation-controller",
+    "changelog:validate": "../../scripts/validate-changelog.sh @metamask/geolocation-controller",
+    "generate-method-action-types": "tsx ../../scripts/generate-method-action-types.ts",
+    "since-latest-release": "../../scripts/since-latest-release.sh",
+    "test": "NODE_OPTIONS=--experimental-vm-modules jest --reporters=jest-silent-reporter",
+    "test:clean": "NODE_OPTIONS=--experimental-vm-modules jest --clearCache",
+    "test:verbose": "NODE_OPTIONS=--experimental-vm-modules jest --verbose",
+    "test:watch": "NODE_OPTIONS=--experimental-vm-modules jest --watch"
+  },
+  "dependencies": {
+    "@metamask/base-controller": "^9.0.0",
+    "@metamask/controller-utils": "^11.19.0",
+    "@metamask/messenger": "^0.3.0"
+  },
+  "devDependencies": {
+    "@metamask/auto-changelog": "^3.4.4",
+    "@ts-bridge/cli": "^0.6.4",
+    "@types/jest": "^29.5.14",
+    "deepmerge": "^4.2.2",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.2.5",
+    "tsx": "^4.20.5",
+    "typedoc": "^0.25.13",
+    "typedoc-plugin-missing-exports": "^2.0.0",
+    "typescript": "~5.3.3"
+  },
+  "engines": {
+    "node": "^18.18 || >=20"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}