@metamask-previews/config-registry-controller 0.0.1-preview-ab102d86

package/CHANGELOG.md

@@ -0,0 +1,21 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+
+- Initial release of `@metamask/config-registry-controller` ([#7668](https://github.com/MetaMask/core/pull/7668))
+  - Controller for fetching and managing network configurations from a remote API
+  - ConfigRegistryApiService with ETag support, retries, circuit breaker, and timeout handling
+  - Network filtering to only include featured, active, non-testnet networks
+  - Feature flag integration using `config_registry_api_enabled` to enable/disable API fetching
+  - Fallback configuration support when API is unavailable or feature flag is disabled
+  - State persistence for configs, version, lastFetched, and etag
+  - Uses StaticIntervalPollingController for periodic updates (default: 24 hours)
+
+[Unreleased]: https://github.com/MetaMask/core/

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2025 MetaMask
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE

package/README.md

@@ -0,0 +1,15 @@
+# `@metamask/config-registry-controller`
+
+Manages configuration registry for MetaMask
+
+## Installation
+
+`yarn add @metamask/config-registry-controller`
+
+or
+
+`npm install @metamask/config-registry-controller`
+
+## Contributing
+
+This package is part of a monorepo. Instructions for contributing can be found in the [monorepo README](https://github.com/MetaMask/core#readme).

package/dist/ConfigRegistryController.cjs

@@ -0,0 +1,205 @@
+"use strict";
+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 _ConfigRegistryController_instances, _ConfigRegistryController_fallbackConfig, _ConfigRegistryController_apiService, _ConfigRegistryController_useFallbackConfig, _ConfigRegistryController_handleFetchError;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigRegistryController = exports.DEFAULT_POLLING_INTERVAL = void 0;
+const polling_controller_1 = require("@metamask/polling-controller");
+const config_registry_api_service_1 = require("./config-registry-api-service/index.cjs");
+const feature_flags_1 = require("./utils/feature-flags.cjs");
+const controllerName = 'ConfigRegistryController';
+exports.DEFAULT_POLLING_INTERVAL = 24 * 60 * 60 * 1000;
+const stateMetadata = {
+    configs: {
+        persist: true,
+        anonymous: false,
+        includeInStateLogs: false,
+        includeInDebugSnapshot: true,
+        usedInUi: true,
+    },
+    version: {
+        persist: true,
+        anonymous: false,
+        includeInStateLogs: true,
+        includeInDebugSnapshot: true,
+        usedInUi: false,
+    },
+    lastFetched: {
+        persist: true,
+        anonymous: false,
+        includeInStateLogs: true,
+        includeInDebugSnapshot: true,
+        usedInUi: false,
+    },
+    fetchError: {
+        persist: true,
+        anonymous: false,
+        includeInStateLogs: true,
+        includeInDebugSnapshot: true,
+        usedInUi: false,
+    },
+    etag: {
+        persist: true,
+        anonymous: false,
+        includeInStateLogs: false,
+        includeInDebugSnapshot: false,
+        usedInUi: false,
+    },
+};
+const DEFAULT_FALLBACK_CONFIG = {};
+class ConfigRegistryController extends (0, polling_controller_1.StaticIntervalPollingController)() {
+    /**
+     * @param options - The controller options.
+     * @param options.messenger - The controller messenger.
+     * @param options.state - Initial state.
+     * @param options.pollingInterval - Polling interval in milliseconds.
+     * @param options.fallbackConfig - Fallback configuration.
+     * @param options.apiService - The API service.
+     */
+    constructor({ messenger, state = {}, pollingInterval = exports.DEFAULT_POLLING_INTERVAL, fallbackConfig = DEFAULT_FALLBACK_CONFIG, apiService = new config_registry_api_service_1.ConfigRegistryApiService(), }) {
+        super({
+            name: controllerName,
+            metadata: stateMetadata,
+            messenger,
+            state: {
+                configs: { networks: {} },
+                version: null,
+                lastFetched: null,
+                fetchError: null,
+                etag: null,
+                ...state,
+            },
+        });
+        _ConfigRegistryController_instances.add(this);
+        _ConfigRegistryController_fallbackConfig.set(this, void 0);
+        _ConfigRegistryController_apiService.set(this, void 0);
+        this.setIntervalLength(pollingInterval);
+        __classPrivateFieldSet(this, _ConfigRegistryController_fallbackConfig, fallbackConfig, "f");
+        __classPrivateFieldSet(this, _ConfigRegistryController_apiService, apiService, "f");
+        this.messenger.registerActionHandler(`${controllerName}:getConfig`, (key) => this.getConfig(key));
+        this.messenger.registerActionHandler(`${controllerName}:setConfig`, (key, value, metadata) => this.setConfig(key, value, metadata));
+        this.messenger.registerActionHandler(`${controllerName}:getAllConfigs`, () => this.getAllConfigs());
+        this.messenger.registerActionHandler(`${controllerName}:startPolling`, (input) => this.startPolling(input));
+        this.messenger.registerActionHandler(`${controllerName}:stopPolling`, () => this.stopPolling());
+    }
+    async _executePoll(_input) {
+        const isApiEnabled = (0, feature_flags_1.isConfigRegistryApiEnabled)(this.messenger);
+        if (!isApiEnabled) {
+            __classPrivateFieldGet(this, _ConfigRegistryController_instances, "m", _ConfigRegistryController_useFallbackConfig).call(this, 'Feature flag disabled - using fallback configuration');
+            return;
+        }
+        try {
+            const result = await __classPrivateFieldGet(this, _ConfigRegistryController_apiService, "f").fetchConfig({
+                etag: this.state.etag ?? undefined,
+            });
+            if (result.notModified) {
+                this.update((state) => {
+                    state.fetchError = null;
+                });
+                return;
+            }
+            // Filter networks: only featured, active, non-testnet networks
+            const filteredNetworks = (0, config_registry_api_service_1.filterNetworks)(result.data.data.networks, {
+                isFeatured: true,
+                isActive: true,
+                isTestnet: false,
+            });
+            const newConfigs = {};
+            for (const network of filteredNetworks) {
+                newConfigs[network.chainId] = {
+                    key: network.chainId,
+                    value: network,
+                };
+            }
+            this.update((state) => {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                state.configs = { networks: newConfigs };
+                state.version = result.data.data.version;
+                state.lastFetched = Date.now();
+                state.fetchError = null;
+                state.etag = result.etag ?? null;
+            });
+        }
+        catch (error) {
+            __classPrivateFieldGet(this, _ConfigRegistryController_instances, "m", _ConfigRegistryController_handleFetchError).call(this, error);
+        }
+    }
+    getConfig(key) {
+        return this.state.configs?.networks?.[key];
+    }
+    getAllConfigs() {
+        return { ...(this.state.configs?.networks ?? {}) };
+    }
+    getConfigValue(key) {
+        const entry = this.state.configs?.networks?.[key];
+        return entry?.value;
+    }
+    setConfig(key, value, metadata) {
+        this.update((state) => {
+            if (!state.configs) {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                state.configs = { networks: {} };
+            }
+            if (!state.configs.networks) {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                state.configs.networks = {};
+            }
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            state.configs.networks[key] = {
+                key,
+                value,
+                metadata,
+            };
+        });
+    }
+    removeConfig(key) {
+        this.update((state) => {
+            if (state.configs?.networks) {
+                delete state.configs.networks[key];
+            }
+        });
+    }
+    clearConfigs() {
+        this.update((state) => {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            state.configs = { networks: {} };
+        });
+    }
+    startPolling(input = {}) {
+        return super.startPolling(input);
+    }
+    stopPolling() {
+        super.stopAllPolling();
+    }
+}
+exports.ConfigRegistryController = ConfigRegistryController;
+_ConfigRegistryController_fallbackConfig = new WeakMap(), _ConfigRegistryController_apiService = new WeakMap(), _ConfigRegistryController_instances = new WeakSet(), _ConfigRegistryController_useFallbackConfig = function _ConfigRegistryController_useFallbackConfig(errorMessage) {
+    this.update((state) => {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        state.configs = { networks: { ...__classPrivateFieldGet(this, _ConfigRegistryController_fallbackConfig, "f") } };
+        state.fetchError =
+            errorMessage ?? 'Using fallback configuration - API unavailable';
+        state.etag = null;
+    });
+}, _ConfigRegistryController_handleFetchError = function _ConfigRegistryController_handleFetchError(error) {
+    const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
+    const hasNoConfigs = Object.keys(this.state.configs?.networks ?? {}).length === 0;
+    if (hasNoConfigs) {
+        __classPrivateFieldGet(this, _ConfigRegistryController_instances, "m", _ConfigRegistryController_useFallbackConfig).call(this, errorMessage);
+    }
+    else {
+        this.update((state) => {
+            state.fetchError = errorMessage;
+        });
+    }
+};
+//# sourceMappingURL=ConfigRegistryController.cjs.map

package/dist/ConfigRegistryController.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigRegistryController.cjs","sourceRoot":"","sources":["../src/ConfigRegistryController.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  ControllerGetStateAction,\n  ControllerStateChangeEvent,\n} from '@metamask/base-controller';\nimport type { Messenger } from '@metamask/messenger';\nimport { StaticIntervalPollingController } from '@metamask/polling-controller';\nimport type { RemoteFeatureFlagControllerState } from '@metamask/remote-feature-flag-controller';\nimport type { Json } from '@metamask/utils';\n\nimport type {\n  AbstractConfigRegistryApiService,\n  FetchConfigResult,\n} from './config-registry-api-service';\nimport {\n  ConfigRegistryApiService,\n  filterNetworks,\n} from './config-registry-api-service';\nimport { isConfigRegistryApiEnabled } from './utils/feature-flags';\n\nconst controllerName = 'ConfigRegistryController';\n\nexport const DEFAULT_POLLING_INTERVAL = 24 * 60 * 60 * 1000;\n\nexport type RegistryConfigEntry = {\n  key: string;\n  value: Json;\n  metadata?: Json;\n};\n\nexport type ConfigRegistryState = {\n  configs: {\n    networks?: Record<string, RegistryConfigEntry>;\n  };\n  version: string | null;\n  lastFetched: number | null;\n  fetchError: string | null;\n  etag: string | null;\n};\n\nconst stateMetadata = {\n  configs: {\n    persist: true,\n    anonymous: false,\n    includeInStateLogs: false,\n    includeInDebugSnapshot: true,\n    usedInUi: true,\n  },\n  version: {\n    persist: true,\n    anonymous: false,\n    includeInStateLogs: true,\n    includeInDebugSnapshot: true,\n    usedInUi: false,\n  },\n  lastFetched: {\n    persist: true,\n    anonymous: false,\n    includeInStateLogs: true,\n    includeInDebugSnapshot: true,\n    usedInUi: false,\n  },\n  fetchError: {\n    persist: true,\n    anonymous: false,\n    includeInStateLogs: true,\n    includeInDebugSnapshot: true,\n    usedInUi: false,\n  },\n  etag: {\n    persist: true,\n    anonymous: false,\n    includeInStateLogs: false,\n    includeInDebugSnapshot: false,\n    usedInUi: false,\n  },\n};\n\nconst DEFAULT_FALLBACK_CONFIG: Record<string, RegistryConfigEntry> = {};\n\ntype ConfigRegistryPollingInput = Record<string, never>;\n\nexport type ConfigRegistryControllerStateChangeEvent =\n  ControllerStateChangeEvent<typeof controllerName, ConfigRegistryState>;\n\nexport type ConfigRegistryControllerGetStateAction = ControllerGetStateAction<\n  typeof controllerName,\n  ConfigRegistryState\n>;\n\nexport type ConfigRegistryControllerGetConfigAction = {\n  type: `${typeof controllerName}:getConfig`;\n  handler: ConfigRegistryController['getConfig'];\n};\n\nexport type ConfigRegistryControllerSetConfigAction = {\n  type: `${typeof controllerName}:setConfig`;\n  handler: ConfigRegistryController['setConfig'];\n};\n\nexport type ConfigRegistryControllerGetAllConfigsAction = {\n  type: `${typeof controllerName}:getAllConfigs`;\n  handler: ConfigRegistryController['getAllConfigs'];\n};\n\nexport type ConfigRegistryControllerStartPollingAction = {\n  type: `${typeof controllerName}:startPolling`;\n  handler: (input: ConfigRegistryPollingInput) => string;\n};\n\nexport type ConfigRegistryControllerStopPollingAction = {\n  type: `${typeof controllerName}:stopPolling`;\n  handler: () => void;\n};\n\nexport type ConfigRegistryControllerActions =\n  | ConfigRegistryControllerGetStateAction\n  | ConfigRegistryControllerGetConfigAction\n  | ConfigRegistryControllerSetConfigAction\n  | ConfigRegistryControllerGetAllConfigsAction\n  | ConfigRegistryControllerStartPollingAction\n  | ConfigRegistryControllerStopPollingAction\n  | {\n      type: 'RemoteFeatureFlagController:getState';\n      handler: () => RemoteFeatureFlagControllerState;\n    };\n\nexport type ConfigRegistryControllerEvents =\n  ConfigRegistryControllerStateChangeEvent;\n\nexport type ConfigRegistryMessenger = Messenger<\n  typeof controllerName,\n  ConfigRegistryControllerActions,\n  ConfigRegistryControllerEvents\n>;\n\nexport type ConfigRegistryControllerOptions = {\n  messenger: ConfigRegistryMessenger;\n  state?: Partial<ConfigRegistryState>;\n  pollingInterval?: number;\n  fallbackConfig?: Record<string, RegistryConfigEntry>;\n  apiService?: AbstractConfigRegistryApiService;\n};\n\nexport class ConfigRegistryController extends StaticIntervalPollingController<ConfigRegistryPollingInput>()<\n  typeof controllerName,\n  ConfigRegistryState,\n  ConfigRegistryMessenger\n> {\n  readonly #fallbackConfig: Record<string, RegistryConfigEntry>;\n\n  readonly #apiService: AbstractConfigRegistryApiService;\n\n  /**\n   * @param options - The controller options.\n   * @param options.messenger - The controller messenger.\n   * @param options.state - Initial state.\n   * @param options.pollingInterval - Polling interval in milliseconds.\n   * @param options.fallbackConfig - Fallback configuration.\n   * @param options.apiService - The API service.\n   */\n  constructor({\n    messenger,\n    state = {},\n    pollingInterval = DEFAULT_POLLING_INTERVAL,\n    fallbackConfig = DEFAULT_FALLBACK_CONFIG,\n    apiService = new ConfigRegistryApiService(),\n  }: ConfigRegistryControllerOptions) {\n    super({\n      name: controllerName,\n      metadata: stateMetadata,\n      messenger,\n      state: {\n        configs: { networks: {} },\n        version: null,\n        lastFetched: null,\n        fetchError: null,\n        etag: null,\n        ...state,\n      },\n    });\n\n    this.setIntervalLength(pollingInterval);\n    this.#fallbackConfig = fallbackConfig;\n    this.#apiService = apiService;\n\n    this.messenger.registerActionHandler(\n      `${controllerName}:getConfig`,\n      (key: string) => this.getConfig(key),\n    );\n\n    this.messenger.registerActionHandler(\n      `${controllerName}:setConfig`,\n      (key: string, value: Json, metadata?: Json) =>\n        this.setConfig(key, value, metadata),\n    );\n\n    this.messenger.registerActionHandler(\n      `${controllerName}:getAllConfigs`,\n      () => this.getAllConfigs(),\n    );\n\n    this.messenger.registerActionHandler(\n      `${controllerName}:startPolling`,\n      (input: ConfigRegistryPollingInput) => this.startPolling(input),\n    );\n\n    this.messenger.registerActionHandler(`${controllerName}:stopPolling`, () =>\n      this.stopPolling(),\n    );\n  }\n\n  async _executePoll(_input: ConfigRegistryPollingInput): Promise<void> {\n    const isApiEnabled = isConfigRegistryApiEnabled(this.messenger);\n\n    if (!isApiEnabled) {\n      this.#useFallbackConfig(\n        'Feature flag disabled - using fallback configuration',\n      );\n      return;\n    }\n\n    try {\n      const result: FetchConfigResult = await this.#apiService.fetchConfig({\n        etag: this.state.etag ?? undefined,\n      });\n\n      if (result.notModified) {\n        this.update((state) => {\n          state.fetchError = null;\n        });\n        return;\n      }\n\n      // Filter networks: only featured, active, non-testnet networks\n      const filteredNetworks = filterNetworks(result.data.data.networks, {\n        isFeatured: true,\n        isActive: true,\n        isTestnet: false,\n      });\n\n      const newConfigs: Record<string, RegistryConfigEntry> = {};\n      for (const network of filteredNetworks) {\n        newConfigs[network.chainId] = {\n          key: network.chainId,\n          value: network as unknown as Json,\n        };\n      }\n\n      this.update((state) => {\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        (state.configs as any) = { networks: newConfigs };\n        state.version = result.data.data.version;\n        state.lastFetched = Date.now();\n        state.fetchError = null;\n        state.etag = result.etag ?? null;\n      });\n    } catch (error) {\n      this.#handleFetchError(error);\n    }\n  }\n\n  #useFallbackConfig(errorMessage?: string): void {\n    this.update((state) => {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      (state.configs as any) = { networks: { ...this.#fallbackConfig } };\n      state.fetchError =\n        errorMessage ?? 'Using fallback configuration - API unavailable';\n      state.etag = null;\n    });\n  }\n\n  #handleFetchError(error: unknown): void {\n    const errorMessage =\n      error instanceof Error ? error.message : 'Unknown error occurred';\n\n    const hasNoConfigs =\n      Object.keys(this.state.configs?.networks ?? {}).length === 0;\n\n    if (hasNoConfigs) {\n      this.#useFallbackConfig(errorMessage);\n    } else {\n      this.update((state) => {\n        state.fetchError = errorMessage;\n      });\n    }\n  }\n\n  getConfig(key: string): RegistryConfigEntry | undefined {\n    return this.state.configs?.networks?.[key];\n  }\n\n  getAllConfigs(): Record<string, RegistryConfigEntry> {\n    return { ...(this.state.configs?.networks ?? {}) };\n  }\n\n  getConfigValue<TValue = Json>(key: string): TValue | undefined {\n    const entry = this.state.configs?.networks?.[key];\n    return entry?.value as TValue | undefined;\n  }\n\n  setConfig(key: string, value: Json, metadata?: Json): void {\n    this.update((state) => {\n      if (!state.configs) {\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        (state.configs as any) = { networks: {} };\n      }\n      if (!state.configs.networks) {\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        (state.configs.networks as any) = {};\n      }\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      (state.configs.networks as any)[key] = {\n        key,\n        value,\n        metadata,\n      };\n    });\n  }\n\n  removeConfig(key: string): void {\n    this.update((state) => {\n      if (state.configs?.networks) {\n        delete state.configs.networks[key];\n      }\n    });\n  }\n\n  clearConfigs(): void {\n    this.update((state) => {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      (state.configs as any) = { networks: {} };\n    });\n  }\n\n  startPolling(input: ConfigRegistryPollingInput = {}): string {\n    return super.startPolling(input);\n  }\n\n  stopPolling(): void {\n    super.stopAllPolling();\n  }\n}\n"]}

package/dist/ConfigRegistryController.d.cts

@@ -0,0 +1,95 @@
+import type { ControllerGetStateAction, ControllerStateChangeEvent } from "@metamask/base-controller";
+import type { Messenger } from "@metamask/messenger";
+import type { RemoteFeatureFlagControllerState } from "@metamask/remote-feature-flag-controller";
+import type { Json } from "@metamask/utils";
+import type { AbstractConfigRegistryApiService } from "./config-registry-api-service/index.cjs";
+declare const controllerName = "ConfigRegistryController";
+export declare const DEFAULT_POLLING_INTERVAL: number;
+export type RegistryConfigEntry = {
+    key: string;
+    value: Json;
+    metadata?: Json;
+};
+export type ConfigRegistryState = {
+    configs: {
+        networks?: Record<string, RegistryConfigEntry>;
+    };
+    version: string | null;
+    lastFetched: number | null;
+    fetchError: string | null;
+    etag: string | null;
+};
+type ConfigRegistryPollingInput = Record<string, never>;
+export type ConfigRegistryControllerStateChangeEvent = ControllerStateChangeEvent<typeof controllerName, ConfigRegistryState>;
+export type ConfigRegistryControllerGetStateAction = ControllerGetStateAction<typeof controllerName, ConfigRegistryState>;
+export type ConfigRegistryControllerGetConfigAction = {
+    type: `${typeof controllerName}:getConfig`;
+    handler: ConfigRegistryController['getConfig'];
+};
+export type ConfigRegistryControllerSetConfigAction = {
+    type: `${typeof controllerName}:setConfig`;
+    handler: ConfigRegistryController['setConfig'];
+};
+export type ConfigRegistryControllerGetAllConfigsAction = {
+    type: `${typeof controllerName}:getAllConfigs`;
+    handler: ConfigRegistryController['getAllConfigs'];
+};
+export type ConfigRegistryControllerStartPollingAction = {
+    type: `${typeof controllerName}:startPolling`;
+    handler: (input: ConfigRegistryPollingInput) => string;
+};
+export type ConfigRegistryControllerStopPollingAction = {
+    type: `${typeof controllerName}:stopPolling`;
+    handler: () => void;
+};
+export type ConfigRegistryControllerActions = ConfigRegistryControllerGetStateAction | ConfigRegistryControllerGetConfigAction | ConfigRegistryControllerSetConfigAction | ConfigRegistryControllerGetAllConfigsAction | ConfigRegistryControllerStartPollingAction | ConfigRegistryControllerStopPollingAction | {
+    type: 'RemoteFeatureFlagController:getState';
+    handler: () => RemoteFeatureFlagControllerState;
+};
+export type ConfigRegistryControllerEvents = ConfigRegistryControllerStateChangeEvent;
+export type ConfigRegistryMessenger = Messenger<typeof controllerName, ConfigRegistryControllerActions, ConfigRegistryControllerEvents>;
+export type ConfigRegistryControllerOptions = {
+    messenger: ConfigRegistryMessenger;
+    state?: Partial<ConfigRegistryState>;
+    pollingInterval?: number;
+    fallbackConfig?: Record<string, RegistryConfigEntry>;
+    apiService?: AbstractConfigRegistryApiService;
+};
+declare const ConfigRegistryController_base: (abstract new (...args: any[]) => {
+    readonly "__#15@#intervalIds": Record<string, NodeJS.Timeout>;
+    "__#15@#intervalLength": number | undefined;
+    setIntervalLength(intervalLength: number): void;
+    getIntervalLength(): number | undefined;
+    _startPolling(input: ConfigRegistryPollingInput): void;
+    _stopPollingByPollingTokenSetId(key: string): void;
+    readonly "__#3@#pollingTokenSets": Map<string, Set<string>>;
+    readonly "__#3@#callbacks": Map<string, Set<(input: ConfigRegistryPollingInput) => void>>;
+    _executePoll(input: ConfigRegistryPollingInput): Promise<void>;
+    startPolling(input: ConfigRegistryPollingInput): string;
+    stopAllPolling(): void;
+    stopPollingByPollingToken(pollingToken: string): void;
+    onPollingComplete(input: ConfigRegistryPollingInput, callback: (input: ConfigRegistryPollingInput) => void): void;
+}) & typeof import("@metamask/base-controller").BaseController;
+export declare class ConfigRegistryController extends ConfigRegistryController_base<typeof controllerName, ConfigRegistryState, ConfigRegistryMessenger> {
+    #private;
+    /**
+     * @param options - The controller options.
+     * @param options.messenger - The controller messenger.
+     * @param options.state - Initial state.
+     * @param options.pollingInterval - Polling interval in milliseconds.
+     * @param options.fallbackConfig - Fallback configuration.
+     * @param options.apiService - The API service.
+     */
+    constructor({ messenger, state, pollingInterval, fallbackConfig, apiService, }: ConfigRegistryControllerOptions);
+    _executePoll(_input: ConfigRegistryPollingInput): Promise<void>;
+    getConfig(key: string): RegistryConfigEntry | undefined;
+    getAllConfigs(): Record<string, RegistryConfigEntry>;
+    getConfigValue<TValue = Json>(key: string): TValue | undefined;
+    setConfig(key: string, value: Json, metadata?: Json): void;
+    removeConfig(key: string): void;
+    clearConfigs(): void;
+    startPolling(input?: ConfigRegistryPollingInput): string;
+    stopPolling(): void;
+}
+export {};
+//# sourceMappingURL=ConfigRegistryController.d.cts.map

package/dist/ConfigRegistryController.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigRegistryController.d.cts","sourceRoot":"","sources":["../src/ConfigRegistryController.ts"],"names":[],"mappings":"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"}

package/dist/ConfigRegistryController.d.mts

@@ -0,0 +1,95 @@
+import type { ControllerGetStateAction, ControllerStateChangeEvent } from "@metamask/base-controller";
+import type { Messenger } from "@metamask/messenger";
+import type { RemoteFeatureFlagControllerState } from "@metamask/remote-feature-flag-controller";
+import type { Json } from "@metamask/utils";
+import type { AbstractConfigRegistryApiService } from "./config-registry-api-service/index.mjs";
+declare const controllerName = "ConfigRegistryController";
+export declare const DEFAULT_POLLING_INTERVAL: number;
+export type RegistryConfigEntry = {
+    key: string;
+    value: Json;
+    metadata?: Json;
+};
+export type ConfigRegistryState = {
+    configs: {
+        networks?: Record<string, RegistryConfigEntry>;
+    };
+    version: string | null;
+    lastFetched: number | null;
+    fetchError: string | null;
+    etag: string | null;
+};
+type ConfigRegistryPollingInput = Record<string, never>;
+export type ConfigRegistryControllerStateChangeEvent = ControllerStateChangeEvent<typeof controllerName, ConfigRegistryState>;
+export type ConfigRegistryControllerGetStateAction = ControllerGetStateAction<typeof controllerName, ConfigRegistryState>;
+export type ConfigRegistryControllerGetConfigAction = {
+    type: `${typeof controllerName}:getConfig`;
+    handler: ConfigRegistryController['getConfig'];
+};
+export type ConfigRegistryControllerSetConfigAction = {
+    type: `${typeof controllerName}:setConfig`;
+    handler: ConfigRegistryController['setConfig'];
+};
+export type ConfigRegistryControllerGetAllConfigsAction = {
+    type: `${typeof controllerName}:getAllConfigs`;
+    handler: ConfigRegistryController['getAllConfigs'];
+};
+export type ConfigRegistryControllerStartPollingAction = {
+    type: `${typeof controllerName}:startPolling`;
+    handler: (input: ConfigRegistryPollingInput) => string;
+};
+export type ConfigRegistryControllerStopPollingAction = {
+    type: `${typeof controllerName}:stopPolling`;
+    handler: () => void;
+};
+export type ConfigRegistryControllerActions = ConfigRegistryControllerGetStateAction | ConfigRegistryControllerGetConfigAction | ConfigRegistryControllerSetConfigAction | ConfigRegistryControllerGetAllConfigsAction | ConfigRegistryControllerStartPollingAction | ConfigRegistryControllerStopPollingAction | {
+    type: 'RemoteFeatureFlagController:getState';
+    handler: () => RemoteFeatureFlagControllerState;
+};
+export type ConfigRegistryControllerEvents = ConfigRegistryControllerStateChangeEvent;
+export type ConfigRegistryMessenger = Messenger<typeof controllerName, ConfigRegistryControllerActions, ConfigRegistryControllerEvents>;
+export type ConfigRegistryControllerOptions = {
+    messenger: ConfigRegistryMessenger;
+    state?: Partial<ConfigRegistryState>;
+    pollingInterval?: number;
+    fallbackConfig?: Record<string, RegistryConfigEntry>;
+    apiService?: AbstractConfigRegistryApiService;
+};
+declare const ConfigRegistryController_base: (abstract new (...args: any[]) => {
+    readonly "__#15@#intervalIds": Record<string, NodeJS.Timeout>;
+    "__#15@#intervalLength": number | undefined;
+    setIntervalLength(intervalLength: number): void;
+    getIntervalLength(): number | undefined;
+    _startPolling(input: ConfigRegistryPollingInput): void;
+    _stopPollingByPollingTokenSetId(key: string): void;
+    readonly "__#3@#pollingTokenSets": Map<string, Set<string>>;
+    readonly "__#3@#callbacks": Map<string, Set<(input: ConfigRegistryPollingInput) => void>>;
+    _executePoll(input: ConfigRegistryPollingInput): Promise<void>;
+    startPolling(input: ConfigRegistryPollingInput): string;
+    stopAllPolling(): void;
+    stopPollingByPollingToken(pollingToken: string): void;
+    onPollingComplete(input: ConfigRegistryPollingInput, callback: (input: ConfigRegistryPollingInput) => void): void;
+}) & typeof import("@metamask/base-controller").BaseController;
+export declare class ConfigRegistryController extends ConfigRegistryController_base<typeof controllerName, ConfigRegistryState, ConfigRegistryMessenger> {
+    #private;
+    /**
+     * @param options - The controller options.
+     * @param options.messenger - The controller messenger.
+     * @param options.state - Initial state.
+     * @param options.pollingInterval - Polling interval in milliseconds.
+     * @param options.fallbackConfig - Fallback configuration.
+     * @param options.apiService - The API service.
+     */
+    constructor({ messenger, state, pollingInterval, fallbackConfig, apiService, }: ConfigRegistryControllerOptions);
+    _executePoll(_input: ConfigRegistryPollingInput): Promise<void>;
+    getConfig(key: string): RegistryConfigEntry | undefined;
+    getAllConfigs(): Record<string, RegistryConfigEntry>;
+    getConfigValue<TValue = Json>(key: string): TValue | undefined;
+    setConfig(key: string, value: Json, metadata?: Json): void;
+    removeConfig(key: string): void;
+    clearConfigs(): void;
+    startPolling(input?: ConfigRegistryPollingInput): string;
+    stopPolling(): void;
+}
+export {};
+//# sourceMappingURL=ConfigRegistryController.d.mts.map

package/dist/ConfigRegistryController.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigRegistryController.d.mts","sourceRoot":"","sources":["../src/ConfigRegistryController.ts"],"names":[],"mappings":"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"}