@metamask-previews/remote-feature-flag-controller 6.1.0-preview-4f4c98e → 6.1.0-preview-c61613ed2

package/CHANGELOG.md

@@ -51,7 +51,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 
-- **BREAKING:** Bump minimum Node.js version to 22 ([#9168](https://github.com/MetaMask/core/pull/9168))
 - **BREAKING:** Threshold feature flags now return the selected `value` directly instead of a `{ name, value }` wrapper. The selected threshold group name is stored separately in `featureFlagThresholdGroups` on controller state when the selected threshold entry includes `name` ([#9289](https://github.com/MetaMask/core/pull/9289))
 - Merge `localOverrides` into `remoteFeatureFlags` at the controller level so consumers receive effective flag values directly ([#9259](https://github.com/MetaMask/core/pull/9259))
 - Bump `@metamask/utils` from `^11.9.0` to `^11.11.0` ([#9074](https://github.com/MetaMask/core/pull/9074))

package/dist/client-config-api-service/abstract-client-config-api-service.cjs

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=abstract-client-config-api-service.cjs.map

package/dist/client-config-api-service/abstract-client-config-api-service.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract-client-config-api-service.cjs","sourceRoot":"","sources":["../../src/client-config-api-service/abstract-client-config-api-service.ts"],"names":[],"mappings":"","sourcesContent":["import type { ServicePolicy } from '@metamask/controller-utils';\n\nimport type { ServiceResponse } from '../remote-feature-flag-controller-types.js';\n\n/**\n * A service object responsible for fetching feature flags.\n */\nexport type AbstractClientConfigApiService = Partial<\n  Pick<ServicePolicy, 'onBreak' | 'onDegraded'>\n> & {\n  /**\n   * Fetches feature flags from the API with specific client, distribution, and\n   * environment parameters. Provides structured error handling, including\n   * fallback to cached data if available.\n   *\n   * @returns An object of feature flags and their boolean values or a\n   * structured error object.\n   */\n  fetchRemoteFeatureFlags(): Promise<ServiceResponse>;\n};\n"]}

package/dist/client-config-api-service/{abstract-client-config-api-service.d.ts → abstract-client-config-api-service.d.cts}

@@ -1,5 +1,5 @@
-import type { ServicePolicy } from '@metamask/controller-utils';
-import type { ServiceResponse } from '../remote-feature-flag-controller-types.js';
+import type { ServicePolicy } from "@metamask/controller-utils";
+import type { ServiceResponse } from "../remote-feature-flag-controller-types.cjs";
 /**
  * A service object responsible for fetching feature flags.
  */
@@ -14,4 +14,4 @@ export type AbstractClientConfigApiService = Partial<Pick<ServicePolicy, 'onBrea
      */
     fetchRemoteFeatureFlags(): Promise<ServiceResponse>;
 };
-//# sourceMappingURL=abstract-client-config-api-service.d.ts.map
+//# sourceMappingURL=abstract-client-config-api-service.d.cts.map

package/dist/client-config-api-service/abstract-client-config-api-service.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract-client-config-api-service.d.cts","sourceRoot":"","sources":["../../src/client-config-api-service/abstract-client-config-api-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,mCAAmC;AAEhE,OAAO,KAAK,EAAE,eAAe,EAAE,oDAAmD;AAElF;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG,OAAO,CAClD,IAAI,CAAC,aAAa,EAAE,SAAS,GAAG,YAAY,CAAC,CAC9C,GAAG;IACF;;;;;;;OAOG;IACH,uBAAuB,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;CACrD,CAAC"}

package/dist/client-config-api-service/abstract-client-config-api-service.d.mts

@@ -0,0 +1,17 @@
+import type { ServicePolicy } from "@metamask/controller-utils";
+import type { ServiceResponse } from "../remote-feature-flag-controller-types.mjs";
+/**
+ * A service object responsible for fetching feature flags.
+ */
+export type AbstractClientConfigApiService = Partial<Pick<ServicePolicy, 'onBreak' | 'onDegraded'>> & {
+    /**
+     * Fetches feature flags from the API with specific client, distribution, and
+     * environment parameters. Provides structured error handling, including
+     * fallback to cached data if available.
+     *
+     * @returns An object of feature flags and their boolean values or a
+     * structured error object.
+     */
+    fetchRemoteFeatureFlags(): Promise<ServiceResponse>;
+};
+//# sourceMappingURL=abstract-client-config-api-service.d.mts.map

package/dist/client-config-api-service/abstract-client-config-api-service.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract-client-config-api-service.d.mts","sourceRoot":"","sources":["../../src/client-config-api-service/abstract-client-config-api-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,mCAAmC;AAEhE,OAAO,KAAK,EAAE,eAAe,EAAE,oDAAmD;AAElF;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG,OAAO,CAClD,IAAI,CAAC,aAAa,EAAE,SAAS,GAAG,YAAY,CAAC,CAC9C,GAAG;IACF;;;;;;;OAOG;IACH,uBAAuB,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;CACrD,CAAC"}

package/dist/client-config-api-service/abstract-client-config-api-service.mjs

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=abstract-client-config-api-service.mjs.map

package/dist/client-config-api-service/abstract-client-config-api-service.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract-client-config-api-service.mjs","sourceRoot":"","sources":["../../src/client-config-api-service/abstract-client-config-api-service.ts"],"names":[],"mappings":"","sourcesContent":["import type { ServicePolicy } from '@metamask/controller-utils';\n\nimport type { ServiceResponse } from '../remote-feature-flag-controller-types.js';\n\n/**\n * A service object responsible for fetching feature flags.\n */\nexport type AbstractClientConfigApiService = Partial<\n  Pick<ServicePolicy, 'onBreak' | 'onDegraded'>\n> & {\n  /**\n   * Fetches feature flags from the API with specific client, distribution, and\n   * environment parameters. Provides structured error handling, including\n   * fallback to cached data if available.\n   *\n   * @returns An object of feature flags and their boolean values or a\n   * structured error object.\n   */\n  fetchRemoteFeatureFlags(): Promise<ServiceResponse>;\n};\n"]}

package/dist/client-config-api-service/client-config-api-service.cjs

@@ -0,0 +1,94 @@
+"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 _ClientConfigApiService_instances, _ClientConfigApiService_fetch, _ClientConfigApiService_policy, _ClientConfigApiService_client, _ClientConfigApiService_distribution, _ClientConfigApiService_environment, _ClientConfigApiService_flattenFeatureFlags;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClientConfigApiService = void 0;
+const controller_utils_1 = require("@metamask/controller-utils");
+const constants_js_1 = require("../constants.cjs");
+/**
+ * This service is responsible for fetching feature flags from the ClientConfig API.
+ */
+class ClientConfigApiService {
+    constructor({ fetch: fetchFunction, retries = controller_utils_1.DEFAULT_MAX_RETRIES, maximumConsecutiveFailures = controller_utils_1.DEFAULT_MAX_CONSECUTIVE_FAILURES, circuitBreakDuration = controller_utils_1.DEFAULT_CIRCUIT_BREAK_DURATION, onBreak, onDegraded, config, }) {
+        _ClientConfigApiService_instances.add(this);
+        _ClientConfigApiService_fetch.set(this, void 0);
+        _ClientConfigApiService_policy.set(this, void 0);
+        _ClientConfigApiService_client.set(this, void 0);
+        _ClientConfigApiService_distribution.set(this, void 0);
+        _ClientConfigApiService_environment.set(this, void 0);
+        __classPrivateFieldSet(this, _ClientConfigApiService_fetch, fetchFunction, "f");
+        __classPrivateFieldSet(this, _ClientConfigApiService_client, config.client, "f");
+        __classPrivateFieldSet(this, _ClientConfigApiService_distribution, config.distribution, "f");
+        __classPrivateFieldSet(this, _ClientConfigApiService_environment, config.environment, "f");
+        __classPrivateFieldSet(this, _ClientConfigApiService_policy, (0, controller_utils_1.createServicePolicy)({
+            maxRetries: retries,
+            maxConsecutiveFailures: maximumConsecutiveFailures,
+            circuitBreakDuration,
+        }), "f");
+        if (onBreak) {
+            __classPrivateFieldGet(this, _ClientConfigApiService_policy, "f").onBreak(onBreak);
+        }
+        if (onDegraded) {
+            __classPrivateFieldGet(this, _ClientConfigApiService_policy, "f").onDegraded(onDegraded);
+        }
+    }
+    /**
+     * Listens for when the request to the API fails too many times in a row.
+     *
+     * @param args - The same arguments that {@link ServicePolicy.onBreak}
+     * takes.
+     * @returns What {@link ServicePolicy.onBreak} returns.
+     */
+    onBreak(...args) {
+        return __classPrivateFieldGet(this, _ClientConfigApiService_policy, "f").onBreak(...args);
+    }
+    /**
+     * Listens for when the API is degraded.
+     *
+     * @param args - The same arguments that {@link ServicePolicy.onDegraded}
+     * takes.
+     * @returns What {@link ServicePolicy.onDegraded} returns.
+     */
+    onDegraded(...args) {
+        return __classPrivateFieldGet(this, _ClientConfigApiService_policy, "f").onDegraded(...args);
+    }
+    /**
+     * Fetches feature flags from the API with specific client, distribution, and environment parameters.
+     * Provides structured error handling, including fallback to cached data if available.
+     *
+     * @returns An object of feature flags and their boolean values or a structured error object.
+     */
+    async fetchRemoteFeatureFlags() {
+        const url = `${constants_js_1.BASE_URL}/flags?client=${__classPrivateFieldGet(this, _ClientConfigApiService_client, "f")}&distribution=${__classPrivateFieldGet(this, _ClientConfigApiService_distribution, "f")}&environment=${__classPrivateFieldGet(this, _ClientConfigApiService_environment, "f")}`;
+        const response = await __classPrivateFieldGet(this, _ClientConfigApiService_policy, "f").execute(() => __classPrivateFieldGet(this, _ClientConfigApiService_fetch, "f").call(this, url, { cache: 'no-cache' }));
+        if (!response.ok) {
+            throw new Error('Failed to fetch remote feature flags');
+        }
+        const data = await response.json();
+        if (!Array.isArray(data)) {
+            throw new Error('Feature flags api did not return an array');
+        }
+        const remoteFeatureFlags = __classPrivateFieldGet(this, _ClientConfigApiService_instances, "m", _ClientConfigApiService_flattenFeatureFlags).call(this, data);
+        return {
+            remoteFeatureFlags,
+            cacheTimestamp: Date.now(),
+        };
+    }
+}
+exports.ClientConfigApiService = ClientConfigApiService;
+_ClientConfigApiService_fetch = new WeakMap(), _ClientConfigApiService_policy = new WeakMap(), _ClientConfigApiService_client = new WeakMap(), _ClientConfigApiService_distribution = new WeakMap(), _ClientConfigApiService_environment = new WeakMap(), _ClientConfigApiService_instances = new WeakSet(), _ClientConfigApiService_flattenFeatureFlags = function _ClientConfigApiService_flattenFeatureFlags(responseData) {
+    return responseData.reduce((acc, curr) => {
+        return { ...acc, ...curr };
+    }, {});
+};
+//# sourceMappingURL=client-config-api-service.cjs.map

package/dist/client-config-api-service/client-config-api-service.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-config-api-service.cjs","sourceRoot":"","sources":["../../src/client-config-api-service/client-config-api-service.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,iEAKoC;AAIpC,mDAA2C;AAW3C;;GAEG;AACH,MAAa,sBAAsB;IAwFjC,YAAY,EACV,KAAK,EAAE,aAAa,EACpB,OAAO,GAAG,sCAAmB,EAC7B,0BAA0B,GAAG,mDAAgC,EAC7D,oBAAoB,GAAG,iDAA8B,EACrD,OAAO,EACP,UAAU,EACV,MAAM,GAaP;;QA3GQ,gDAAqB;QAErB,iDAAuB;QAEvB,iDAAoB;QAEpB,uDAAgC;QAEhC,sDAA8B;QAoGrC,uBAAA,IAAI,iCAAU,aAAa,MAAA,CAAC;QAC5B,uBAAA,IAAI,kCAAW,MAAM,CAAC,MAAM,MAAA,CAAC;QAC7B,uBAAA,IAAI,wCAAiB,MAAM,CAAC,YAAY,MAAA,CAAC;QACzC,uBAAA,IAAI,uCAAgB,MAAM,CAAC,WAAW,MAAA,CAAC;QAEvC,uBAAA,IAAI,kCAAW,IAAA,sCAAmB,EAAC;YACjC,UAAU,EAAE,OAAO;YACnB,sBAAsB,EAAE,0BAA0B;YAClD,oBAAoB;SACrB,CAAC,MAAA,CAAC;QACH,IAAI,OAAO,EAAE,CAAC;YACZ,uBAAA,IAAI,sCAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;QACD,IAAI,UAAU,EAAE,CAAC;YACf,uBAAA,IAAI,sCAAQ,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,OAAO,CAAC,GAAG,IAA0C;QACnD,OAAO,uBAAA,IAAI,sCAAQ,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IACvC,CAAC;IAED;;;;;;OAMG;IACH,UAAU,CAAC,GAAG,IAA6C;QACzD,OAAO,uBAAA,IAAI,sCAAQ,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,uBAAuB;QAClC,MAAM,GAAG,GAAG,GAAG,uBAAQ,iBAAiB,uBAAA,IAAI,sCAAQ,iBAClD,uBAAA,IAAI,4CACN,gBAAgB,uBAAA,IAAI,2CAAa,EAAE,CAAC;QAEpC,MAAM,QAAQ,GAAG,MAAM,uBAAA,IAAI,sCAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,CAC/C,uBAAA,IAAI,qCAAO,MAAX,IAAI,EAAQ,GAAG,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CACxC,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAEnC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC/D,CAAC;QAED,MAAM,kBAAkB,GAAG,uBAAA,IAAI,sFAAqB,MAAzB,IAAI,EAAsB,IAAI,CAAC,CAAC;QAE3D,OAAO;YACL,kBAAkB;YAClB,cAAc,EAAE,IAAI,CAAC,GAAG,EAAE;SAC3B,CAAC;IACJ,CAAC;CAgBF;AApMD,wDAoMC;gZALsB,YAA6B;IAChD,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;QACvC,OAAO,EAAE,GAAG,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;IAC7B,CAAC,EAAE,EAAE,CAAC,CAAC;AACT,CAAC","sourcesContent":["import {\n  createServicePolicy,\n  DEFAULT_CIRCUIT_BREAK_DURATION,\n  DEFAULT_MAX_CONSECUTIVE_FAILURES,\n  DEFAULT_MAX_RETRIES,\n} from '@metamask/controller-utils';\nimport type { ServicePolicy } from '@metamask/controller-utils';\nimport type { IDisposable } from 'cockatiel';\n\nimport { BASE_URL } from '../constants.js';\nimport type {\n  FeatureFlags,\n  ClientType,\n  DistributionType,\n  EnvironmentType,\n  ServiceResponse,\n  ApiDataResponse,\n} from '../remote-feature-flag-controller-types.js';\nimport type { AbstractClientConfigApiService } from './abstract-client-config-api-service.js';\n\n/**\n * This service is responsible for fetching feature flags from the ClientConfig API.\n */\nexport class ClientConfigApiService implements AbstractClientConfigApiService {\n  readonly #fetch: typeof fetch;\n\n  readonly #policy: ServicePolicy;\n\n  readonly #client: ClientType;\n\n  readonly #distribution: DistributionType;\n\n  readonly #environment: EnvironmentType;\n\n  /**\n   * Constructs a new ClientConfigApiService object.\n   *\n   * @param args - The arguments.\n   * @param args.fetch - A function that can be used to make an HTTP request.\n   * If your JavaScript environment supports `fetch` natively, you'll probably\n   * want to pass that; otherwise you can pass an equivalent (such as `fetch`\n   * via `node-fetch`).\n   * @param args.retries - Number of retry attempts for each fetch request.\n   * @param args.maximumConsecutiveFailures - The maximum number of consecutive\n   * failures allowed before breaking the circuit and pausing further fetch\n   * attempts.\n   * @param args.circuitBreakDuration - The amount of time to wait when the\n   * circuit breaks from too many consecutive failures.\n   * @param args.config - The configuration object, includes client,\n   * distribution, and environment.\n   * @param args.config.client - The client type (e.g., 'extension', 'mobile').\n   * @param args.config.distribution - The distribution type (e.g., 'main',\n   * 'flask').\n   * @param args.config.environment - The environment type (e.g., 'prod', 'rc',\n   * 'dev').\n   */\n  constructor(args: {\n    fetch: typeof fetch;\n    retries?: number;\n    maximumConsecutiveFailures?: number;\n    circuitBreakDuration?: number;\n    config: {\n      client: ClientType;\n      distribution: DistributionType;\n      environment: EnvironmentType;\n    };\n  });\n\n  /**\n   * Constructs a new ClientConfigApiService object.\n   *\n   * @deprecated This signature is deprecated; please use the `onBreak` and\n   * `onDegraded` methods instead.\n   * @param args - The arguments.\n   * @param args.fetch - A function that can be used to make an HTTP request.\n   * If your JavaScript environment supports `fetch` natively, you'll probably\n   * want to pass that; otherwise you can pass an equivalent (such as `fetch`\n   * via `node-fetch`).\n   * @param args.retries - Number of retry attempts for each fetch request.\n   * @param args.maximumConsecutiveFailures - The maximum number of consecutive\n   * failures allowed before breaking the circuit and pausing further fetch\n   * attempts.\n   * @param args.circuitBreakDuration - The amount of time to wait when the\n   * circuit breaks from too many consecutive failures.\n   * @param args.onBreak - Callback for when the circuit breaks, useful\n   * for capturing metrics about network failures.\n   * @param args.onDegraded - Callback for when the API responds successfully\n   * but takes too long to respond (5 seconds or more).\n   * @param args.config - The configuration object, includes client,\n   * distribution, and environment.\n   * @param args.config.client - The client type (e.g., 'extension', 'mobile').\n   * @param args.config.distribution - The distribution type (e.g., 'main',\n   * 'flask').\n   * @param args.config.environment - The environment type (e.g., 'prod', 'rc',\n   * 'dev').\n   */\n  // eslint-disable-next-line @typescript-eslint/unified-signatures\n  constructor(args: {\n    fetch: typeof fetch;\n    retries?: number;\n    maximumConsecutiveFailures?: number;\n    circuitBreakDuration?: number;\n    onBreak?: () => void;\n    onDegraded?: () => void;\n    config: {\n      client: ClientType;\n      distribution: DistributionType;\n      environment: EnvironmentType;\n    };\n  });\n\n  constructor({\n    fetch: fetchFunction,\n    retries = DEFAULT_MAX_RETRIES,\n    maximumConsecutiveFailures = DEFAULT_MAX_CONSECUTIVE_FAILURES,\n    circuitBreakDuration = DEFAULT_CIRCUIT_BREAK_DURATION,\n    onBreak,\n    onDegraded,\n    config,\n  }: {\n    fetch: typeof fetch;\n    retries?: number;\n    maximumConsecutiveFailures?: number;\n    circuitBreakDuration?: number;\n    onBreak?: () => void;\n    onDegraded?: () => void;\n    config: {\n      client: ClientType;\n      distribution: DistributionType;\n      environment: EnvironmentType;\n    };\n  }) {\n    this.#fetch = fetchFunction;\n    this.#client = config.client;\n    this.#distribution = config.distribution;\n    this.#environment = config.environment;\n\n    this.#policy = createServicePolicy({\n      maxRetries: retries,\n      maxConsecutiveFailures: maximumConsecutiveFailures,\n      circuitBreakDuration,\n    });\n    if (onBreak) {\n      this.#policy.onBreak(onBreak);\n    }\n    if (onDegraded) {\n      this.#policy.onDegraded(onDegraded);\n    }\n  }\n\n  /**\n   * Listens for when the request to the API fails too many times in a row.\n   *\n   * @param args - The same arguments that {@link ServicePolicy.onBreak}\n   * takes.\n   * @returns What {@link ServicePolicy.onBreak} returns.\n   */\n  onBreak(...args: Parameters<ServicePolicy['onBreak']>): IDisposable {\n    return this.#policy.onBreak(...args);\n  }\n\n  /**\n   * Listens for when the API is degraded.\n   *\n   * @param args - The same arguments that {@link ServicePolicy.onDegraded}\n   * takes.\n   * @returns What {@link ServicePolicy.onDegraded} returns.\n   */\n  onDegraded(...args: Parameters<ServicePolicy['onDegraded']>): IDisposable {\n    return this.#policy.onDegraded(...args);\n  }\n\n  /**\n   * Fetches feature flags from the API with specific client, distribution, and environment parameters.\n   * Provides structured error handling, including fallback to cached data if available.\n   *\n   * @returns An object of feature flags and their boolean values or a structured error object.\n   */\n  public async fetchRemoteFeatureFlags(): Promise<ServiceResponse> {\n    const url = `${BASE_URL}/flags?client=${this.#client}&distribution=${\n      this.#distribution\n    }&environment=${this.#environment}`;\n\n    const response = await this.#policy.execute(() =>\n      this.#fetch(url, { cache: 'no-cache' }),\n    );\n\n    if (!response.ok) {\n      throw new Error('Failed to fetch remote feature flags');\n    }\n\n    const data = await response.json();\n\n    if (!Array.isArray(data)) {\n      throw new Error('Feature flags api did not return an array');\n    }\n\n    const remoteFeatureFlags = this.#flattenFeatureFlags(data);\n\n    return {\n      remoteFeatureFlags,\n      cacheTimestamp: Date.now(),\n    };\n  }\n\n  /**\n   * Flattens an array of feature flag objects into a single feature flags object.\n   *\n   * @param responseData - Array of objects containing feature flag key-value pairs\n   * @returns A single object containing all feature flags merged together\n   * @example\n   * // Input: [{ flag1: true }, { flag2: [] }]\n   * // Output: { flag1: true, flag2: [] }\n   */\n  #flattenFeatureFlags(responseData: ApiDataResponse): FeatureFlags {\n    return responseData.reduce((acc, curr) => {\n      return { ...acc, ...curr };\n    }, {});\n  }\n}\n"]}

package/dist/client-config-api-service/{client-config-api-service.d.ts → client-config-api-service.d.cts}

@@ -1,7 +1,7 @@
-import type { ServicePolicy } from '@metamask/controller-utils';
-import type { IDisposable } from 'cockatiel';
-import type { ClientType, DistributionType, EnvironmentType, ServiceResponse } from '../remote-feature-flag-controller-types.js';
-import type { AbstractClientConfigApiService } from './abstract-client-config-api-service.js';
+import type { ServicePolicy } from "@metamask/controller-utils";
+import type { IDisposable } from "cockatiel";
+import type { ClientType, DistributionType, EnvironmentType, ServiceResponse } from "../remote-feature-flag-controller-types.cjs";
+import type { AbstractClientConfigApiService } from "./abstract-client-config-api-service.cjs";
 /**
  * This service is responsible for fetching feature flags from the ClientConfig API.
  */
@@ -105,4 +105,4 @@ export declare class ClientConfigApiService implements AbstractClientConfigApiSe
      */
     fetchRemoteFeatureFlags(): Promise<ServiceResponse>;
 }
-//# sourceMappingURL=client-config-api-service.d.ts.map
+//# sourceMappingURL=client-config-api-service.d.cts.map

package/dist/client-config-api-service/client-config-api-service.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-config-api-service.d.cts","sourceRoot":"","sources":["../../src/client-config-api-service/client-config-api-service.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,mCAAmC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB;AAG7C,OAAO,KAAK,EAEV,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,eAAe,EAEhB,oDAAmD;AACpD,OAAO,KAAK,EAAE,8BAA8B,EAAE,iDAAgD;AAE9F;;GAEG;AACH,qBAAa,sBAAuB,YAAW,8BAA8B;;IAW3E;;;;;;;;;;;;;;;;;;;;;OAqBG;gBACS,IAAI,EAAE;QAChB,KAAK,EAAE,OAAO,KAAK,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,0BAA0B,CAAC,EAAE,MAAM,CAAC;QACpC,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,MAAM,EAAE;YACN,MAAM,EAAE,UAAU,CAAC;YACnB,YAAY,EAAE,gBAAgB,CAAC;YAC/B,WAAW,EAAE,eAAe,CAAC;SAC9B,CAAC;KACH;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;gBAES,IAAI,EAAE;QAChB,KAAK,EAAE,OAAO,KAAK,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,0BAA0B,CAAC,EAAE,MAAM,CAAC;QACpC,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;QACxB,MAAM,EAAE;YACN,MAAM,EAAE,UAAU,CAAC;YACnB,YAAY,EAAE,gBAAgB,CAAC;YAC/B,WAAW,EAAE,eAAe,CAAC;SAC9B,CAAC;KACH;IAyCD;;;;;;OAMG;IACH,OAAO,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,GAAG,WAAW;IAInE;;;;;;OAMG;IACH,UAAU,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,GAAG,WAAW;IAIzE;;;;;OAKG;IACU,uBAAuB,IAAI,OAAO,CAAC,eAAe,CAAC;CAyCjE"}

package/dist/client-config-api-service/client-config-api-service.d.mts

@@ -0,0 +1,108 @@
+import type { ServicePolicy } from "@metamask/controller-utils";
+import type { IDisposable } from "cockatiel";
+import type { ClientType, DistributionType, EnvironmentType, ServiceResponse } from "../remote-feature-flag-controller-types.mjs";
+import type { AbstractClientConfigApiService } from "./abstract-client-config-api-service.mjs";
+/**
+ * This service is responsible for fetching feature flags from the ClientConfig API.
+ */
+export declare class ClientConfigApiService implements AbstractClientConfigApiService {
+    #private;
+    /**
+     * Constructs a new ClientConfigApiService object.
+     *
+     * @param args - The arguments.
+     * @param args.fetch - A function that can be used to make an HTTP request.
+     * If your JavaScript environment supports `fetch` natively, you'll probably
+     * want to pass that; otherwise you can pass an equivalent (such as `fetch`
+     * via `node-fetch`).
+     * @param args.retries - Number of retry attempts for each fetch request.
+     * @param args.maximumConsecutiveFailures - The maximum number of consecutive
+     * failures allowed before breaking the circuit and pausing further fetch
+     * attempts.
+     * @param args.circuitBreakDuration - The amount of time to wait when the
+     * circuit breaks from too many consecutive failures.
+     * @param args.config - The configuration object, includes client,
+     * distribution, and environment.
+     * @param args.config.client - The client type (e.g., 'extension', 'mobile').
+     * @param args.config.distribution - The distribution type (e.g., 'main',
+     * 'flask').
+     * @param args.config.environment - The environment type (e.g., 'prod', 'rc',
+     * 'dev').
+     */
+    constructor(args: {
+        fetch: typeof fetch;
+        retries?: number;
+        maximumConsecutiveFailures?: number;
+        circuitBreakDuration?: number;
+        config: {
+            client: ClientType;
+            distribution: DistributionType;
+            environment: EnvironmentType;
+        };
+    });
+    /**
+     * Constructs a new ClientConfigApiService object.
+     *
+     * @deprecated This signature is deprecated; please use the `onBreak` and
+     * `onDegraded` methods instead.
+     * @param args - The arguments.
+     * @param args.fetch - A function that can be used to make an HTTP request.
+     * If your JavaScript environment supports `fetch` natively, you'll probably
+     * want to pass that; otherwise you can pass an equivalent (such as `fetch`
+     * via `node-fetch`).
+     * @param args.retries - Number of retry attempts for each fetch request.
+     * @param args.maximumConsecutiveFailures - The maximum number of consecutive
+     * failures allowed before breaking the circuit and pausing further fetch
+     * attempts.
+     * @param args.circuitBreakDuration - The amount of time to wait when the
+     * circuit breaks from too many consecutive failures.
+     * @param args.onBreak - Callback for when the circuit breaks, useful
+     * for capturing metrics about network failures.
+     * @param args.onDegraded - Callback for when the API responds successfully
+     * but takes too long to respond (5 seconds or more).
+     * @param args.config - The configuration object, includes client,
+     * distribution, and environment.
+     * @param args.config.client - The client type (e.g., 'extension', 'mobile').
+     * @param args.config.distribution - The distribution type (e.g., 'main',
+     * 'flask').
+     * @param args.config.environment - The environment type (e.g., 'prod', 'rc',
+     * 'dev').
+     */
+    constructor(args: {
+        fetch: typeof fetch;
+        retries?: number;
+        maximumConsecutiveFailures?: number;
+        circuitBreakDuration?: number;
+        onBreak?: () => void;
+        onDegraded?: () => void;
+        config: {
+            client: ClientType;
+            distribution: DistributionType;
+            environment: EnvironmentType;
+        };
+    });
+    /**
+     * Listens for when the request to the API fails too many times in a row.
+     *
+     * @param args - The same arguments that {@link ServicePolicy.onBreak}
+     * takes.
+     * @returns What {@link ServicePolicy.onBreak} returns.
+     */
+    onBreak(...args: Parameters<ServicePolicy['onBreak']>): IDisposable;
+    /**
+     * Listens for when the API is degraded.
+     *
+     * @param args - The same arguments that {@link ServicePolicy.onDegraded}
+     * takes.
+     * @returns What {@link ServicePolicy.onDegraded} returns.
+     */
+    onDegraded(...args: Parameters<ServicePolicy['onDegraded']>): IDisposable;
+    /**
+     * Fetches feature flags from the API with specific client, distribution, and environment parameters.
+     * Provides structured error handling, including fallback to cached data if available.
+     *
+     * @returns An object of feature flags and their boolean values or a structured error object.
+     */
+    fetchRemoteFeatureFlags(): Promise<ServiceResponse>;
+}
+//# sourceMappingURL=client-config-api-service.d.mts.map

package/dist/client-config-api-service/client-config-api-service.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-config-api-service.d.mts","sourceRoot":"","sources":["../../src/client-config-api-service/client-config-api-service.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,mCAAmC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB;AAG7C,OAAO,KAAK,EAEV,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,eAAe,EAEhB,oDAAmD;AACpD,OAAO,KAAK,EAAE,8BAA8B,EAAE,iDAAgD;AAE9F;;GAEG;AACH,qBAAa,sBAAuB,YAAW,8BAA8B;;IAW3E;;;;;;;;;;;;;;;;;;;;;OAqBG;gBACS,IAAI,EAAE;QAChB,KAAK,EAAE,OAAO,KAAK,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,0BAA0B,CAAC,EAAE,MAAM,CAAC;QACpC,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,MAAM,EAAE;YACN,MAAM,EAAE,UAAU,CAAC;YACnB,YAAY,EAAE,gBAAgB,CAAC;YAC/B,WAAW,EAAE,eAAe,CAAC;SAC9B,CAAC;KACH;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;gBAES,IAAI,EAAE;QAChB,KAAK,EAAE,OAAO,KAAK,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,0BAA0B,CAAC,EAAE,MAAM,CAAC;QACpC,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;QACxB,MAAM,EAAE;YACN,MAAM,EAAE,UAAU,CAAC;YACnB,YAAY,EAAE,gBAAgB,CAAC;YAC/B,WAAW,EAAE,eAAe,CAAC;SAC9B,CAAC;KACH;IAyCD;;;;;;OAMG;IACH,OAAO,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,GAAG,WAAW;IAInE;;;;;;OAMG;IACH,UAAU,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,GAAG,WAAW;IAIzE;;;;;OAKG;IACU,uBAAuB,IAAI,OAAO,CAAC,eAAe,CAAC;CAyCjE"}

package/dist/client-config-api-service/{client-config-api-service.js → client-config-api-service.mjs}

@@ -10,8 +10,8 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
 var _ClientConfigApiService_instances, _ClientConfigApiService_fetch, _ClientConfigApiService_policy, _ClientConfigApiService_client, _ClientConfigApiService_distribution, _ClientConfigApiService_environment, _ClientConfigApiService_flattenFeatureFlags;
-import { createServicePolicy, DEFAULT_CIRCUIT_BREAK_DURATION, DEFAULT_MAX_CONSECUTIVE_FAILURES, DEFAULT_MAX_RETRIES, } from '@metamask/controller-utils';
-import { BASE_URL } from '../constants.js';
+import { createServicePolicy, DEFAULT_CIRCUIT_BREAK_DURATION, DEFAULT_MAX_CONSECUTIVE_FAILURES, DEFAULT_MAX_RETRIES } from "@metamask/controller-utils";
+import { BASE_URL } from "../constants.mjs";
 /**
  * This service is responsible for fetching feature flags from the ClientConfig API.
  */
@@ -87,4 +87,4 @@ _ClientConfigApiService_fetch = new WeakMap(), _ClientConfigApiService_policy =
         return { ...acc, ...curr };
     }, {});
 };
-//# sourceMappingURL=client-config-api-service.js.map
+//# sourceMappingURL=client-config-api-service.mjs.map

package/dist/client-config-api-service/client-config-api-service.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-config-api-service.mjs","sourceRoot":"","sources":["../../src/client-config-api-service/client-config-api-service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,OAAO,EACL,mBAAmB,EACnB,8BAA8B,EAC9B,gCAAgC,EAChC,mBAAmB,EACpB,mCAAmC;AAIpC,OAAO,EAAE,QAAQ,EAAE,yBAAwB;AAW3C;;GAEG;AACH,MAAM,OAAO,sBAAsB;IAwFjC,YAAY,EACV,KAAK,EAAE,aAAa,EACpB,OAAO,GAAG,mBAAmB,EAC7B,0BAA0B,GAAG,gCAAgC,EAC7D,oBAAoB,GAAG,8BAA8B,EACrD,OAAO,EACP,UAAU,EACV,MAAM,GAaP;;QA3GQ,gDAAqB;QAErB,iDAAuB;QAEvB,iDAAoB;QAEpB,uDAAgC;QAEhC,sDAA8B;QAoGrC,uBAAA,IAAI,iCAAU,aAAa,MAAA,CAAC;QAC5B,uBAAA,IAAI,kCAAW,MAAM,CAAC,MAAM,MAAA,CAAC;QAC7B,uBAAA,IAAI,wCAAiB,MAAM,CAAC,YAAY,MAAA,CAAC;QACzC,uBAAA,IAAI,uCAAgB,MAAM,CAAC,WAAW,MAAA,CAAC;QAEvC,uBAAA,IAAI,kCAAW,mBAAmB,CAAC;YACjC,UAAU,EAAE,OAAO;YACnB,sBAAsB,EAAE,0BAA0B;YAClD,oBAAoB;SACrB,CAAC,MAAA,CAAC;QACH,IAAI,OAAO,EAAE,CAAC;YACZ,uBAAA,IAAI,sCAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;QACD,IAAI,UAAU,EAAE,CAAC;YACf,uBAAA,IAAI,sCAAQ,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,OAAO,CAAC,GAAG,IAA0C;QACnD,OAAO,uBAAA,IAAI,sCAAQ,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IACvC,CAAC;IAED;;;;;;OAMG;IACH,UAAU,CAAC,GAAG,IAA6C;QACzD,OAAO,uBAAA,IAAI,sCAAQ,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,uBAAuB;QAClC,MAAM,GAAG,GAAG,GAAG,QAAQ,iBAAiB,uBAAA,IAAI,sCAAQ,iBAClD,uBAAA,IAAI,4CACN,gBAAgB,uBAAA,IAAI,2CAAa,EAAE,CAAC;QAEpC,MAAM,QAAQ,GAAG,MAAM,uBAAA,IAAI,sCAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,CAC/C,uBAAA,IAAI,qCAAO,MAAX,IAAI,EAAQ,GAAG,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CACxC,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAEnC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC/D,CAAC;QAED,MAAM,kBAAkB,GAAG,uBAAA,IAAI,sFAAqB,MAAzB,IAAI,EAAsB,IAAI,CAAC,CAAC;QAE3D,OAAO;YACL,kBAAkB;YAClB,cAAc,EAAE,IAAI,CAAC,GAAG,EAAE;SAC3B,CAAC;IACJ,CAAC;CAgBF;gZALsB,YAA6B;IAChD,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;QACvC,OAAO,EAAE,GAAG,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;IAC7B,CAAC,EAAE,EAAE,CAAC,CAAC;AACT,CAAC","sourcesContent":["import {\n  createServicePolicy,\n  DEFAULT_CIRCUIT_BREAK_DURATION,\n  DEFAULT_MAX_CONSECUTIVE_FAILURES,\n  DEFAULT_MAX_RETRIES,\n} from '@metamask/controller-utils';\nimport type { ServicePolicy } from '@metamask/controller-utils';\nimport type { IDisposable } from 'cockatiel';\n\nimport { BASE_URL } from '../constants.js';\nimport type {\n  FeatureFlags,\n  ClientType,\n  DistributionType,\n  EnvironmentType,\n  ServiceResponse,\n  ApiDataResponse,\n} from '../remote-feature-flag-controller-types.js';\nimport type { AbstractClientConfigApiService } from './abstract-client-config-api-service.js';\n\n/**\n * This service is responsible for fetching feature flags from the ClientConfig API.\n */\nexport class ClientConfigApiService implements AbstractClientConfigApiService {\n  readonly #fetch: typeof fetch;\n\n  readonly #policy: ServicePolicy;\n\n  readonly #client: ClientType;\n\n  readonly #distribution: DistributionType;\n\n  readonly #environment: EnvironmentType;\n\n  /**\n   * Constructs a new ClientConfigApiService object.\n   *\n   * @param args - The arguments.\n   * @param args.fetch - A function that can be used to make an HTTP request.\n   * If your JavaScript environment supports `fetch` natively, you'll probably\n   * want to pass that; otherwise you can pass an equivalent (such as `fetch`\n   * via `node-fetch`).\n   * @param args.retries - Number of retry attempts for each fetch request.\n   * @param args.maximumConsecutiveFailures - The maximum number of consecutive\n   * failures allowed before breaking the circuit and pausing further fetch\n   * attempts.\n   * @param args.circuitBreakDuration - The amount of time to wait when the\n   * circuit breaks from too many consecutive failures.\n   * @param args.config - The configuration object, includes client,\n   * distribution, and environment.\n   * @param args.config.client - The client type (e.g., 'extension', 'mobile').\n   * @param args.config.distribution - The distribution type (e.g., 'main',\n   * 'flask').\n   * @param args.config.environment - The environment type (e.g., 'prod', 'rc',\n   * 'dev').\n   */\n  constructor(args: {\n    fetch: typeof fetch;\n    retries?: number;\n    maximumConsecutiveFailures?: number;\n    circuitBreakDuration?: number;\n    config: {\n      client: ClientType;\n      distribution: DistributionType;\n      environment: EnvironmentType;\n    };\n  });\n\n  /**\n   * Constructs a new ClientConfigApiService object.\n   *\n   * @deprecated This signature is deprecated; please use the `onBreak` and\n   * `onDegraded` methods instead.\n   * @param args - The arguments.\n   * @param args.fetch - A function that can be used to make an HTTP request.\n   * If your JavaScript environment supports `fetch` natively, you'll probably\n   * want to pass that; otherwise you can pass an equivalent (such as `fetch`\n   * via `node-fetch`).\n   * @param args.retries - Number of retry attempts for each fetch request.\n   * @param args.maximumConsecutiveFailures - The maximum number of consecutive\n   * failures allowed before breaking the circuit and pausing further fetch\n   * attempts.\n   * @param args.circuitBreakDuration - The amount of time to wait when the\n   * circuit breaks from too many consecutive failures.\n   * @param args.onBreak - Callback for when the circuit breaks, useful\n   * for capturing metrics about network failures.\n   * @param args.onDegraded - Callback for when the API responds successfully\n   * but takes too long to respond (5 seconds or more).\n   * @param args.config - The configuration object, includes client,\n   * distribution, and environment.\n   * @param args.config.client - The client type (e.g., 'extension', 'mobile').\n   * @param args.config.distribution - The distribution type (e.g., 'main',\n   * 'flask').\n   * @param args.config.environment - The environment type (e.g., 'prod', 'rc',\n   * 'dev').\n   */\n  // eslint-disable-next-line @typescript-eslint/unified-signatures\n  constructor(args: {\n    fetch: typeof fetch;\n    retries?: number;\n    maximumConsecutiveFailures?: number;\n    circuitBreakDuration?: number;\n    onBreak?: () => void;\n    onDegraded?: () => void;\n    config: {\n      client: ClientType;\n      distribution: DistributionType;\n      environment: EnvironmentType;\n    };\n  });\n\n  constructor({\n    fetch: fetchFunction,\n    retries = DEFAULT_MAX_RETRIES,\n    maximumConsecutiveFailures = DEFAULT_MAX_CONSECUTIVE_FAILURES,\n    circuitBreakDuration = DEFAULT_CIRCUIT_BREAK_DURATION,\n    onBreak,\n    onDegraded,\n    config,\n  }: {\n    fetch: typeof fetch;\n    retries?: number;\n    maximumConsecutiveFailures?: number;\n    circuitBreakDuration?: number;\n    onBreak?: () => void;\n    onDegraded?: () => void;\n    config: {\n      client: ClientType;\n      distribution: DistributionType;\n      environment: EnvironmentType;\n    };\n  }) {\n    this.#fetch = fetchFunction;\n    this.#client = config.client;\n    this.#distribution = config.distribution;\n    this.#environment = config.environment;\n\n    this.#policy = createServicePolicy({\n      maxRetries: retries,\n      maxConsecutiveFailures: maximumConsecutiveFailures,\n      circuitBreakDuration,\n    });\n    if (onBreak) {\n      this.#policy.onBreak(onBreak);\n    }\n    if (onDegraded) {\n      this.#policy.onDegraded(onDegraded);\n    }\n  }\n\n  /**\n   * Listens for when the request to the API fails too many times in a row.\n   *\n   * @param args - The same arguments that {@link ServicePolicy.onBreak}\n   * takes.\n   * @returns What {@link ServicePolicy.onBreak} returns.\n   */\n  onBreak(...args: Parameters<ServicePolicy['onBreak']>): IDisposable {\n    return this.#policy.onBreak(...args);\n  }\n\n  /**\n   * Listens for when the API is degraded.\n   *\n   * @param args - The same arguments that {@link ServicePolicy.onDegraded}\n   * takes.\n   * @returns What {@link ServicePolicy.onDegraded} returns.\n   */\n  onDegraded(...args: Parameters<ServicePolicy['onDegraded']>): IDisposable {\n    return this.#policy.onDegraded(...args);\n  }\n\n  /**\n   * Fetches feature flags from the API with specific client, distribution, and environment parameters.\n   * Provides structured error handling, including fallback to cached data if available.\n   *\n   * @returns An object of feature flags and their boolean values or a structured error object.\n   */\n  public async fetchRemoteFeatureFlags(): Promise<ServiceResponse> {\n    const url = `${BASE_URL}/flags?client=${this.#client}&distribution=${\n      this.#distribution\n    }&environment=${this.#environment}`;\n\n    const response = await this.#policy.execute(() =>\n      this.#fetch(url, { cache: 'no-cache' }),\n    );\n\n    if (!response.ok) {\n      throw new Error('Failed to fetch remote feature flags');\n    }\n\n    const data = await response.json();\n\n    if (!Array.isArray(data)) {\n      throw new Error('Feature flags api did not return an array');\n    }\n\n    const remoteFeatureFlags = this.#flattenFeatureFlags(data);\n\n    return {\n      remoteFeatureFlags,\n      cacheTimestamp: Date.now(),\n    };\n  }\n\n  /**\n   * Flattens an array of feature flag objects into a single feature flags object.\n   *\n   * @param responseData - Array of objects containing feature flag key-value pairs\n   * @returns A single object containing all feature flags merged together\n   * @example\n   * // Input: [{ flag1: true }, { flag2: [] }]\n   * // Output: { flag1: true, flag2: [] }\n   */\n  #flattenFeatureFlags(responseData: ApiDataResponse): FeatureFlags {\n    return responseData.reduce((acc, curr) => {\n      return { ...acc, ...curr };\n    }, {});\n  }\n}\n"]}

package/dist/constants.cjs

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BASE_URL = void 0;
+/**
+ * ClientConfig API base URL.
+ */
+exports.BASE_URL = 'https://client-config.api.cx.metamask.io/v1';
+//# sourceMappingURL=constants.cjs.map

package/dist/constants.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.cjs","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACU,QAAA,QAAQ,GAAG,6CAA6C,CAAC","sourcesContent":["/**\n * ClientConfig API base URL.\n */\nexport const BASE_URL = 'https://client-config.api.cx.metamask.io/v1';\n"]}

package/dist/{constants.d.ts → constants.d.cts}

@@ -2,4 +2,4 @@
  * ClientConfig API base URL.
  */
 export declare const BASE_URL = "https://client-config.api.cx.metamask.io/v1";
-//# sourceMappingURL=constants.d.ts.map
+//# sourceMappingURL=constants.d.cts.map

package/dist/constants.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.cts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,QAAQ,gDAAgD,CAAC"}

package/dist/constants.d.mts

@@ -0,0 +1,5 @@
+/**
+ * ClientConfig API base URL.
+ */
+export declare const BASE_URL = "https://client-config.api.cx.metamask.io/v1";
+//# sourceMappingURL=constants.d.mts.map

package/dist/constants.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.mts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,QAAQ,gDAAgD,CAAC"}

package/dist/{constants.js → constants.mjs}

@@ -2,4 +2,4 @@
  * ClientConfig API base URL.
  */
 export const BASE_URL = 'https://client-config.api.cx.metamask.io/v1';
-//# sourceMappingURL=constants.js.map
+//# sourceMappingURL=constants.mjs.map

package/dist/constants.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.mjs","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,6CAA6C,CAAC","sourcesContent":["/**\n * ClientConfig API base URL.\n */\nexport const BASE_URL = 'https://client-config.api.cx.metamask.io/v1';\n"]}

package/dist/index.cjs

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateDeterministicRandomNumber = exports.ClientConfigApiService = exports.ThresholdVersion = exports.EnvironmentType = exports.DistributionType = exports.ClientType = exports.RemoteFeatureFlagController = void 0;
+var remote_feature_flag_controller_js_1 = require("./remote-feature-flag-controller.cjs");
+Object.defineProperty(exports, "RemoteFeatureFlagController", { enumerable: true, get: function () { return remote_feature_flag_controller_js_1.RemoteFeatureFlagController; } });
+var remote_feature_flag_controller_types_js_1 = require("./remote-feature-flag-controller-types.cjs");
+Object.defineProperty(exports, "ClientType", { enumerable: true, get: function () { return remote_feature_flag_controller_types_js_1.ClientType; } });
+Object.defineProperty(exports, "DistributionType", { enumerable: true, get: function () { return remote_feature_flag_controller_types_js_1.DistributionType; } });
+Object.defineProperty(exports, "EnvironmentType", { enumerable: true, get: function () { return remote_feature_flag_controller_types_js_1.EnvironmentType; } });
+Object.defineProperty(exports, "ThresholdVersion", { enumerable: true, get: function () { return remote_feature_flag_controller_types_js_1.ThresholdVersion; } });
+var client_config_api_service_js_1 = require("./client-config-api-service/client-config-api-service.cjs");
+Object.defineProperty(exports, "ClientConfigApiService", { enumerable: true, get: function () { return client_config_api_service_js_1.ClientConfigApiService; } });
+var user_segmentation_utils_js_1 = require("./utils/user-segmentation-utils.cjs");
+Object.defineProperty(exports, "generateDeterministicRandomNumber", { enumerable: true, get: function () { return user_segmentation_utils_js_1.generateDeterministicRandomNumber; } });
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,0FAAkF;AAAzE,gJAAA,2BAA2B,OAAA;AAkBpC,sGAKmD;AAJjD,qIAAA,UAAU,OAAA;AACV,2IAAA,gBAAgB,OAAA;AAChB,0IAAA,eAAe,OAAA;AACf,2IAAA,gBAAgB,OAAA;AAIlB,0GAAkG;AAAzF,sIAAA,sBAAsB,OAAA;AAC/B,kFAAuF;AAA9E,+IAAA,iCAAiC,OAAA","sourcesContent":["export { RemoteFeatureFlagController } from './remote-feature-flag-controller.js';\nexport type {\n  RemoteFeatureFlagControllerState,\n  RemoteFeatureFlagControllerMessenger,\n  RemoteFeatureFlagControllerActions,\n  RemoteFeatureFlagControllerGetStateAction,\n  RemoteFeatureFlagControllerEvents,\n  RemoteFeatureFlagControllerStateChangeEvent,\n} from './remote-feature-flag-controller.js';\nexport type {\n  RemoteFeatureFlagControllerClearAllFlagOverridesAction,\n  RemoteFeatureFlagControllerDisableAction,\n  RemoteFeatureFlagControllerEnableAction,\n  RemoteFeatureFlagControllerMethodActions,\n  RemoteFeatureFlagControllerRemoveFlagOverrideAction,\n  RemoteFeatureFlagControllerSetFlagOverrideAction,\n  RemoteFeatureFlagControllerUpdateRemoteFeatureFlagsAction,\n} from './remote-feature-flag-controller-method-action-types.js';\nexport {\n  ClientType,\n  DistributionType,\n  EnvironmentType,\n  ThresholdVersion,\n} from './remote-feature-flag-controller-types.js';\n\nexport type { FeatureFlags } from './remote-feature-flag-controller-types.js';\nexport { ClientConfigApiService } from './client-config-api-service/client-config-api-service.js';\nexport { generateDeterministicRandomNumber } from './utils/user-segmentation-utils.js';\n"]}

package/dist/index.d.cts

@@ -0,0 +1,8 @@
+export { RemoteFeatureFlagController } from "./remote-feature-flag-controller.cjs";
+export type { RemoteFeatureFlagControllerState, RemoteFeatureFlagControllerMessenger, RemoteFeatureFlagControllerActions, RemoteFeatureFlagControllerGetStateAction, RemoteFeatureFlagControllerEvents, RemoteFeatureFlagControllerStateChangeEvent, } from "./remote-feature-flag-controller.cjs";
+export type { RemoteFeatureFlagControllerClearAllFlagOverridesAction, RemoteFeatureFlagControllerDisableAction, RemoteFeatureFlagControllerEnableAction, RemoteFeatureFlagControllerMethodActions, RemoteFeatureFlagControllerRemoveFlagOverrideAction, RemoteFeatureFlagControllerSetFlagOverrideAction, RemoteFeatureFlagControllerUpdateRemoteFeatureFlagsAction, } from "./remote-feature-flag-controller-method-action-types.cjs";
+export { ClientType, DistributionType, EnvironmentType, ThresholdVersion, } from "./remote-feature-flag-controller-types.cjs";
+export type { FeatureFlags } from "./remote-feature-flag-controller-types.cjs";
+export { ClientConfigApiService } from "./client-config-api-service/client-config-api-service.cjs";
+export { generateDeterministicRandomNumber } from "./utils/user-segmentation-utils.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,OAAO,EAAE,2BAA2B,EAAE,6CAA4C;AAClF,YAAY,EACV,gCAAgC,EAChC,oCAAoC,EACpC,kCAAkC,EAClC,yCAAyC,EACzC,iCAAiC,EACjC,2CAA2C,GAC5C,6CAA4C;AAC7C,YAAY,EACV,sDAAsD,EACtD,wCAAwC,EACxC,uCAAuC,EACvC,wCAAwC,EACxC,mDAAmD,EACnD,gDAAgD,EAChD,yDAAyD,GAC1D,iEAAgE;AACjE,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,gBAAgB,GACjB,mDAAkD;AAEnD,YAAY,EAAE,YAAY,EAAE,mDAAkD;AAC9E,OAAO,EAAE,sBAAsB,EAAE,kEAAiE;AAClG,OAAO,EAAE,iCAAiC,EAAE,4CAA2C"}

package/dist/index.d.mts

@@ -0,0 +1,8 @@
+export { RemoteFeatureFlagController } from "./remote-feature-flag-controller.mjs";
+export type { RemoteFeatureFlagControllerState, RemoteFeatureFlagControllerMessenger, RemoteFeatureFlagControllerActions, RemoteFeatureFlagControllerGetStateAction, RemoteFeatureFlagControllerEvents, RemoteFeatureFlagControllerStateChangeEvent, } from "./remote-feature-flag-controller.mjs";
+export type { RemoteFeatureFlagControllerClearAllFlagOverridesAction, RemoteFeatureFlagControllerDisableAction, RemoteFeatureFlagControllerEnableAction, RemoteFeatureFlagControllerMethodActions, RemoteFeatureFlagControllerRemoveFlagOverrideAction, RemoteFeatureFlagControllerSetFlagOverrideAction, RemoteFeatureFlagControllerUpdateRemoteFeatureFlagsAction, } from "./remote-feature-flag-controller-method-action-types.mjs";
+export { ClientType, DistributionType, EnvironmentType, ThresholdVersion, } from "./remote-feature-flag-controller-types.mjs";
+export type { FeatureFlags } from "./remote-feature-flag-controller-types.mjs";
+export { ClientConfigApiService } from "./client-config-api-service/client-config-api-service.mjs";
+export { generateDeterministicRandomNumber } from "./utils/user-segmentation-utils.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,OAAO,EAAE,2BAA2B,EAAE,6CAA4C;AAClF,YAAY,EACV,gCAAgC,EAChC,oCAAoC,EACpC,kCAAkC,EAClC,yCAAyC,EACzC,iCAAiC,EACjC,2CAA2C,GAC5C,6CAA4C;AAC7C,YAAY,EACV,sDAAsD,EACtD,wCAAwC,EACxC,uCAAuC,EACvC,wCAAwC,EACxC,mDAAmD,EACnD,gDAAgD,EAChD,yDAAyD,GAC1D,iEAAgE;AACjE,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,gBAAgB,GACjB,mDAAkD;AAEnD,YAAY,EAAE,YAAY,EAAE,mDAAkD;AAC9E,OAAO,EAAE,sBAAsB,EAAE,kEAAiE;AAClG,OAAO,EAAE,iCAAiC,EAAE,4CAA2C"}

package/dist/index.mjs

@@ -0,0 +1,5 @@
+export { RemoteFeatureFlagController } from "./remote-feature-flag-controller.mjs";
+export { ClientType, DistributionType, EnvironmentType, ThresholdVersion } from "./remote-feature-flag-controller-types.mjs";
+export { ClientConfigApiService } from "./client-config-api-service/client-config-api-service.mjs";
+export { generateDeterministicRandomNumber } from "./utils/user-segmentation-utils.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":"AAAA,OAAO,EAAE,2BAA2B,EAAE,6CAA4C;AAkBlF,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EACjB,mDAAkD;AAGnD,OAAO,EAAE,sBAAsB,EAAE,kEAAiE;AAClG,OAAO,EAAE,iCAAiC,EAAE,4CAA2C","sourcesContent":["export { RemoteFeatureFlagController } from './remote-feature-flag-controller.js';\nexport type {\n  RemoteFeatureFlagControllerState,\n  RemoteFeatureFlagControllerMessenger,\n  RemoteFeatureFlagControllerActions,\n  RemoteFeatureFlagControllerGetStateAction,\n  RemoteFeatureFlagControllerEvents,\n  RemoteFeatureFlagControllerStateChangeEvent,\n} from './remote-feature-flag-controller.js';\nexport type {\n  RemoteFeatureFlagControllerClearAllFlagOverridesAction,\n  RemoteFeatureFlagControllerDisableAction,\n  RemoteFeatureFlagControllerEnableAction,\n  RemoteFeatureFlagControllerMethodActions,\n  RemoteFeatureFlagControllerRemoveFlagOverrideAction,\n  RemoteFeatureFlagControllerSetFlagOverrideAction,\n  RemoteFeatureFlagControllerUpdateRemoteFeatureFlagsAction,\n} from './remote-feature-flag-controller-method-action-types.js';\nexport {\n  ClientType,\n  DistributionType,\n  EnvironmentType,\n  ThresholdVersion,\n} from './remote-feature-flag-controller-types.js';\n\nexport type { FeatureFlags } from './remote-feature-flag-controller-types.js';\nexport { ClientConfigApiService } from './client-config-api-service/client-config-api-service.js';\nexport { generateDeterministicRandomNumber } from './utils/user-segmentation-utils.js';\n"]}

package/dist/remote-feature-flag-controller-method-action-types.cjs

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * This file is auto generated.
+ * Do not edit manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=remote-feature-flag-controller-method-action-types.cjs.map

package/dist/remote-feature-flag-controller-method-action-types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-feature-flag-controller-method-action-types.cjs","sourceRoot":"","sources":["../src/remote-feature-flag-controller-method-action-types.ts"],"names":[],"mappings":";AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { RemoteFeatureFlagController } from './remote-feature-flag-controller.js';\n\n/**\n * Retrieves the remote feature flags, fetching from the API if necessary.\n * Uses caching to prevent redundant API calls and handles concurrent fetches.\n *\n * @param force - When `true`, fetch even if the cache has not expired.\n * Defaults to `false`. Has no effect when the controller is disabled.\n * @returns A promise that resolves to the current set of feature flags.\n */\nexport type RemoteFeatureFlagControllerUpdateRemoteFeatureFlagsAction = {\n  type: `RemoteFeatureFlagController:updateRemoteFeatureFlags`;\n  handler: RemoteFeatureFlagController['updateRemoteFeatureFlags'];\n};\n\n/**\n * Enables the controller, allowing it to make network requests.\n */\nexport type RemoteFeatureFlagControllerEnableAction = {\n  type: `RemoteFeatureFlagController:enable`;\n  handler: RemoteFeatureFlagController['enable'];\n};\n\n/**\n * Disables the controller, preventing it from making network requests.\n */\nexport type RemoteFeatureFlagControllerDisableAction = {\n  type: `RemoteFeatureFlagController:disable`;\n  handler: RemoteFeatureFlagController['disable'];\n};\n\n/**\n * Sets a local override for a specific feature flag.\n *\n * @param flagName - The name of the feature flag to override.\n * @param value - The override value for the feature flag.\n */\nexport type RemoteFeatureFlagControllerSetFlagOverrideAction = {\n  type: `RemoteFeatureFlagController:setFlagOverride`;\n  handler: RemoteFeatureFlagController['setFlagOverride'];\n};\n\n/**\n * Clears the local override for a specific feature flag.\n *\n * @param flagName - The name of the feature flag to clear.\n */\nexport type RemoteFeatureFlagControllerRemoveFlagOverrideAction = {\n  type: `RemoteFeatureFlagController:removeFlagOverride`;\n  handler: RemoteFeatureFlagController['removeFlagOverride'];\n};\n\n/**\n * Clears all local feature flag overrides.\n */\nexport type RemoteFeatureFlagControllerClearAllFlagOverridesAction = {\n  type: `RemoteFeatureFlagController:clearAllFlagOverrides`;\n  handler: RemoteFeatureFlagController['clearAllFlagOverrides'];\n};\n\n/**\n * Union of all RemoteFeatureFlagController action types.\n */\nexport type RemoteFeatureFlagControllerMethodActions =\n  | RemoteFeatureFlagControllerUpdateRemoteFeatureFlagsAction\n  | RemoteFeatureFlagControllerEnableAction\n  | RemoteFeatureFlagControllerDisableAction\n  | RemoteFeatureFlagControllerSetFlagOverrideAction\n  | RemoteFeatureFlagControllerRemoveFlagOverrideAction\n  | RemoteFeatureFlagControllerClearAllFlagOverridesAction;\n"]}

package/dist/{remote-feature-flag-controller-method-action-types.d.ts → remote-feature-flag-controller-method-action-types.d.cts}

@@ -2,7 +2,7 @@
  * This file is auto generated.
  * Do not edit manually.
  */
-import type { RemoteFeatureFlagController } from './remote-feature-flag-controller.js';
+import type { RemoteFeatureFlagController } from "./remote-feature-flag-controller.cjs";
 /**
  * Retrieves the remote feature flags, fetching from the API if necessary.
  * Uses caching to prevent redundant API calls and handles concurrent fetches.
@@ -59,4 +59,4 @@ export type RemoteFeatureFlagControllerClearAllFlagOverridesAction = {
  * Union of all RemoteFeatureFlagController action types.
  */
 export type RemoteFeatureFlagControllerMethodActions = RemoteFeatureFlagControllerUpdateRemoteFeatureFlagsAction | RemoteFeatureFlagControllerEnableAction | RemoteFeatureFlagControllerDisableAction | RemoteFeatureFlagControllerSetFlagOverrideAction | RemoteFeatureFlagControllerRemoveFlagOverrideAction | RemoteFeatureFlagControllerClearAllFlagOverridesAction;
-//# sourceMappingURL=remote-feature-flag-controller-method-action-types.d.ts.map
+//# sourceMappingURL=remote-feature-flag-controller-method-action-types.d.cts.map

package/dist/remote-feature-flag-controller-method-action-types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-feature-flag-controller-method-action-types.d.cts","sourceRoot":"","sources":["../src/remote-feature-flag-controller-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,2BAA2B,EAAE,6CAA4C;AAEvF;;;;;;;GAOG;AACH,MAAM,MAAM,yDAAyD,GAAG;IACtE,IAAI,EAAE,sDAAsD,CAAC;IAC7D,OAAO,EAAE,2BAA2B,CAAC,0BAA0B,CAAC,CAAC;CAClE,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,uCAAuC,GAAG;IACpD,IAAI,EAAE,oCAAoC,CAAC;IAC3C,OAAO,EAAE,2BAA2B,CAAC,QAAQ,CAAC,CAAC;CAChD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,wCAAwC,GAAG;IACrD,IAAI,EAAE,qCAAqC,CAAC;IAC5C,OAAO,EAAE,2BAA2B,CAAC,SAAS,CAAC,CAAC;CACjD,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,gDAAgD,GAAG;IAC7D,IAAI,EAAE,6CAA6C,CAAC;IACpD,OAAO,EAAE,2BAA2B,CAAC,iBAAiB,CAAC,CAAC;CACzD,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,mDAAmD,GAAG;IAChE,IAAI,EAAE,gDAAgD,CAAC;IACvD,OAAO,EAAE,2BAA2B,CAAC,oBAAoB,CAAC,CAAC;CAC5D,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sDAAsD,GAAG;IACnE,IAAI,EAAE,mDAAmD,CAAC;IAC1D,OAAO,EAAE,2BAA2B,CAAC,uBAAuB,CAAC,CAAC;CAC/D,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,wCAAwC,GAChD,yDAAyD,GACzD,uCAAuC,GACvC,wCAAwC,GACxC,gDAAgD,GAChD,mDAAmD,GACnD,sDAAsD,CAAC"}

package/dist/remote-feature-flag-controller-method-action-types.d.mts

@@ -0,0 +1,62 @@
+/**
+ * This file is auto generated.
+ * Do not edit manually.
+ */
+import type { RemoteFeatureFlagController } from "./remote-feature-flag-controller.mjs";
+/**
+ * Retrieves the remote feature flags, fetching from the API if necessary.
+ * Uses caching to prevent redundant API calls and handles concurrent fetches.
+ *
+ * @param force - When `true`, fetch even if the cache has not expired.
+ * Defaults to `false`. Has no effect when the controller is disabled.
+ * @returns A promise that resolves to the current set of feature flags.
+ */
+export type RemoteFeatureFlagControllerUpdateRemoteFeatureFlagsAction = {
+    type: `RemoteFeatureFlagController:updateRemoteFeatureFlags`;
+    handler: RemoteFeatureFlagController['updateRemoteFeatureFlags'];
+};
+/**
+ * Enables the controller, allowing it to make network requests.
+ */
+export type RemoteFeatureFlagControllerEnableAction = {
+    type: `RemoteFeatureFlagController:enable`;
+    handler: RemoteFeatureFlagController['enable'];
+};
+/**
+ * Disables the controller, preventing it from making network requests.
+ */
+export type RemoteFeatureFlagControllerDisableAction = {
+    type: `RemoteFeatureFlagController:disable`;
+    handler: RemoteFeatureFlagController['disable'];
+};
+/**
+ * Sets a local override for a specific feature flag.
+ *
+ * @param flagName - The name of the feature flag to override.
+ * @param value - The override value for the feature flag.
+ */
+export type RemoteFeatureFlagControllerSetFlagOverrideAction = {
+    type: `RemoteFeatureFlagController:setFlagOverride`;
+    handler: RemoteFeatureFlagController['setFlagOverride'];
+};
+/**
+ * Clears the local override for a specific feature flag.
+ *
+ * @param flagName - The name of the feature flag to clear.
+ */
+export type RemoteFeatureFlagControllerRemoveFlagOverrideAction = {
+    type: `RemoteFeatureFlagController:removeFlagOverride`;
+    handler: RemoteFeatureFlagController['removeFlagOverride'];
+};
+/**
+ * Clears all local feature flag overrides.
+ */
+export type RemoteFeatureFlagControllerClearAllFlagOverridesAction = {
+    type: `RemoteFeatureFlagController:clearAllFlagOverrides`;
+    handler: RemoteFeatureFlagController['clearAllFlagOverrides'];
+};
+/**
+ * Union of all RemoteFeatureFlagController action types.
+ */
+export type RemoteFeatureFlagControllerMethodActions = RemoteFeatureFlagControllerUpdateRemoteFeatureFlagsAction | RemoteFeatureFlagControllerEnableAction | RemoteFeatureFlagControllerDisableAction | RemoteFeatureFlagControllerSetFlagOverrideAction | RemoteFeatureFlagControllerRemoveFlagOverrideAction | RemoteFeatureFlagControllerClearAllFlagOverridesAction;
+//# sourceMappingURL=remote-feature-flag-controller-method-action-types.d.mts.map

package/dist/remote-feature-flag-controller-method-action-types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-feature-flag-controller-method-action-types.d.mts","sourceRoot":"","sources":["../src/remote-feature-flag-controller-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,2BAA2B,EAAE,6CAA4C;AAEvF;;;;;;;GAOG;AACH,MAAM,MAAM,yDAAyD,GAAG;IACtE,IAAI,EAAE,sDAAsD,CAAC;IAC7D,OAAO,EAAE,2BAA2B,CAAC,0BAA0B,CAAC,CAAC;CAClE,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,uCAAuC,GAAG;IACpD,IAAI,EAAE,oCAAoC,CAAC;IAC3C,OAAO,EAAE,2BAA2B,CAAC,QAAQ,CAAC,CAAC;CAChD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,wCAAwC,GAAG;IACrD,IAAI,EAAE,qCAAqC,CAAC;IAC5C,OAAO,EAAE,2BAA2B,CAAC,SAAS,CAAC,CAAC;CACjD,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,gDAAgD,GAAG;IAC7D,IAAI,EAAE,6CAA6C,CAAC;IACpD,OAAO,EAAE,2BAA2B,CAAC,iBAAiB,CAAC,CAAC;CACzD,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,mDAAmD,GAAG;IAChE,IAAI,EAAE,gDAAgD,CAAC;IACvD,OAAO,EAAE,2BAA2B,CAAC,oBAAoB,CAAC,CAAC;CAC5D,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sDAAsD,GAAG;IACnE,IAAI,EAAE,mDAAmD,CAAC;IAC1D,OAAO,EAAE,2BAA2B,CAAC,uBAAuB,CAAC,CAAC;CAC/D,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,wCAAwC,GAChD,yDAAyD,GACzD,uCAAuC,GACvC,wCAAwC,GACxC,gDAAgD,GAChD,mDAAmD,GACnD,sDAAsD,CAAC"}

package/dist/{remote-feature-flag-controller-method-action-types.js → remote-feature-flag-controller-method-action-types.mjs}

@@ -3,4 +3,4 @@
  * Do not edit manually.
  */
 export {};
-//# sourceMappingURL=remote-feature-flag-controller-method-action-types.js.map
+//# sourceMappingURL=remote-feature-flag-controller-method-action-types.mjs.map