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

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

@@ -1,42 +1,29 @@
-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;
 import { createServicePolicy, DEFAULT_CIRCUIT_BREAK_DURATION, DEFAULT_MAX_CONSECUTIVE_FAILURES, DEFAULT_MAX_RETRIES, } from '@metamask/controller-utils';
 import { BASE_URL } from '../constants.js';
 /**
  * This service is responsible for fetching feature flags from the ClientConfig API.
  */
 export class ClientConfigApiService {
+    #fetch;
+    #policy;
+    #client;
+    #distribution;
+    #environment;
     constructor({ fetch: fetchFunction, retries = DEFAULT_MAX_RETRIES, maximumConsecutiveFailures = DEFAULT_MAX_CONSECUTIVE_FAILURES, circuitBreakDuration = 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, createServicePolicy({
+        this.#fetch = fetchFunction;
+        this.#client = config.client;
+        this.#distribution = config.distribution;
+        this.#environment = config.environment;
+        this.#policy = createServicePolicy({
             maxRetries: retries,
             maxConsecutiveFailures: maximumConsecutiveFailures,
             circuitBreakDuration,
-        }), "f");
+        });
         if (onBreak) {
-            __classPrivateFieldGet(this, _ClientConfigApiService_policy, "f").onBreak(onBreak);
+            this.#policy.onBreak(onBreak);
         }
         if (onDegraded) {
-            __classPrivateFieldGet(this, _ClientConfigApiService_policy, "f").onDegraded(onDegraded);
+            this.#policy.onDegraded(onDegraded);
         }
     }
     /**
@@ -47,7 +34,7 @@ export class ClientConfigApiService {
      * @returns What {@link ServicePolicy.onBreak} returns.
      */
     onBreak(...args) {
-        return __classPrivateFieldGet(this, _ClientConfigApiService_policy, "f").onBreak(...args);
+        return this.#policy.onBreak(...args);
     }
     /**
      * Listens for when the API is degraded.
@@ -57,7 +44,7 @@ export class ClientConfigApiService {
      * @returns What {@link ServicePolicy.onDegraded} returns.
      */
     onDegraded(...args) {
-        return __classPrivateFieldGet(this, _ClientConfigApiService_policy, "f").onDegraded(...args);
+        return this.#policy.onDegraded(...args);
     }
     /**
      * Fetches feature flags from the API with specific client, distribution, and environment parameters.
@@ -66,8 +53,8 @@ export class ClientConfigApiService {
      * @returns An object of feature flags and their boolean values or a structured error object.
      */
     async fetchRemoteFeatureFlags() {
-        const url = `${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' }));
+        const url = `${BASE_URL}/flags?client=${this.#client}&distribution=${this.#distribution}&environment=${this.#environment}`;
+        const response = await this.#policy.execute(() => this.#fetch(url, { cache: 'no-cache' }));
         if (!response.ok) {
             throw new Error('Failed to fetch remote feature flags');
         }
@@ -75,16 +62,25 @@ export class ClientConfigApiService {
         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);
+        const remoteFeatureFlags = this.#flattenFeatureFlags(data);
         return {
             remoteFeatureFlags,
             cacheTimestamp: Date.now(),
         };
     }
+    /**
+     * Flattens an array of feature flag objects into a single feature flags object.
+     *
+     * @param responseData - Array of objects containing feature flag key-value pairs
+     * @returns A single object containing all feature flags merged together
+     * @example
+     * // Input: [{ flag1: true }, { flag2: [] }]
+     * // Output: { flag1: true, flag2: [] }
+     */
+    #flattenFeatureFlags(responseData) {
+        return responseData.reduce((acc, curr) => {
+            return { ...acc, ...curr };
+        }, {});
+    }
 }
-_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.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"client-config-api-service.js","sourceRoot":"","sources":["../../src/client-config-api-service/client-config-api-service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,OAAO,EACL,mBAAmB,EACnB,8BAA8B,EAC9B,gCAAgC,EAChC,mBAAmB,GACpB,MAAM,4BAA4B,CAAC;AAIpC,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;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"]}
+{"version":3,"file":"client-config-api-service.js","sourceRoot":"","sources":["../../src/client-config-api-service/client-config-api-service.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,8BAA8B,EAC9B,gCAAgC,EAChC,mBAAmB,GACpB,MAAM,4BAA4B,CAAC;AAIpC,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAW3C;;GAEG;AACH,MAAM,OAAO,sBAAsB;IACxB,MAAM,CAAe;IAErB,OAAO,CAAgB;IAEvB,OAAO,CAAa;IAEpB,aAAa,CAAmB;IAEhC,YAAY,CAAkB;IA+EvC,YAAY,EACV,KAAK,EAAE,aAAa,EACpB,OAAO,GAAG,mBAAmB,EAC7B,0BAA0B,GAAG,gCAAgC,EAC7D,oBAAoB,GAAG,8BAA8B,EACrD,OAAO,EACP,UAAU,EACV,MAAM,GAaP;QACC,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,YAAY,CAAC;QACzC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,WAAW,CAAC;QAEvC,IAAI,CAAC,OAAO,GAAG,mBAAmB,CAAC;YACjC,UAAU,EAAE,OAAO;YACnB,sBAAsB,EAAE,0BAA0B;YAClD,oBAAoB;SACrB,CAAC,CAAC;QACH,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;QACD,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,OAAO,CAAC,GAAG,IAA0C;QACnD,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IACvC,CAAC;IAED;;;;;;OAMG;IACH,UAAU,CAAC,GAAG,IAA6C;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,uBAAuB;QAClC,MAAM,GAAG,GAAG,GAAG,QAAQ,iBAAiB,IAAI,CAAC,OAAO,iBAClD,IAAI,CAAC,aACP,gBAAgB,IAAI,CAAC,YAAY,EAAE,CAAC;QAEpC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAC/C,IAAI,CAAC,MAAM,CAAC,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,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAE3D,OAAO;YACL,kBAAkB;YAClB,cAAc,EAAE,IAAI,CAAC,GAAG,EAAE;SAC3B,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,oBAAoB,CAAC,YAA6B;QAChD,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;YACvC,OAAO,EAAE,GAAG,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;QAC7B,CAAC,EAAE,EAAE,CAAC,CAAC;IACT,CAAC;CACF","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/remote-feature-flag-controller.js

@@ -1,15 +1,3 @@
-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 _RemoteFeatureFlagController_instances, _RemoteFeatureFlagController_fetchInterval, _RemoteFeatureFlagController_disabled, _RemoteFeatureFlagController_clientConfigApiService, _RemoteFeatureFlagController_inProgressFlagUpdate, _RemoteFeatureFlagController_getMetaMetricsId, _RemoteFeatureFlagController_getCanonicalProfileId, _RemoteFeatureFlagController_metaMetricsFlags, _RemoteFeatureFlagController_clientVersion, _RemoteFeatureFlagController_defaultFeatureFlags, _RemoteFeatureFlagController_processedRemoteFeatureFlags, _RemoteFeatureFlagController_getEffectiveFeatureFlags, _RemoteFeatureFlagController_isCacheExpired, _RemoteFeatureFlagController_updateCache, _RemoteFeatureFlagController_processVersionBasedFlag, _RemoteFeatureFlagController_getSegmentationId, _RemoteFeatureFlagController_processRemoteFeatureFlags;
 import { BaseController, } from '@metamask/base-controller';
 import { isValidSemVerVersion } from '@metamask/utils';
 import { calculateThresholdForFlag, isFeatureFlagWithScopeValue, } from './utils/user-segmentation-utils.js';
@@ -111,6 +99,16 @@ function findExplicitIdMatch(entries, normalizedId) {
  * a specified interval and handles cases where the controller is disabled or the network is unavailable.
  */
 export class RemoteFeatureFlagController extends BaseController {
+    #fetchInterval;
+    #disabled;
+    #clientConfigApiService;
+    #inProgressFlagUpdate;
+    #getMetaMetricsId;
+    #getCanonicalProfileId;
+    #metaMetricsFlags;
+    #clientVersion;
+    #defaultFeatureFlags;
+    #processedRemoteFeatureFlags;
     /**
      * Constructs a new RemoteFeatureFlagController instance.
      *
@@ -148,32 +146,47 @@ export class RemoteFeatureFlagController extends BaseController {
                     : initialState.cacheTimestamp,
             },
         });
-        _RemoteFeatureFlagController_instances.add(this);
-        _RemoteFeatureFlagController_fetchInterval.set(this, void 0);
-        _RemoteFeatureFlagController_disabled.set(this, void 0);
-        _RemoteFeatureFlagController_clientConfigApiService.set(this, void 0);
-        _RemoteFeatureFlagController_inProgressFlagUpdate.set(this, void 0);
-        _RemoteFeatureFlagController_getMetaMetricsId.set(this, void 0);
-        _RemoteFeatureFlagController_getCanonicalProfileId.set(this, void 0);
-        _RemoteFeatureFlagController_metaMetricsFlags.set(this, void 0);
-        _RemoteFeatureFlagController_clientVersion.set(this, void 0);
-        _RemoteFeatureFlagController_defaultFeatureFlags.set(this, void 0);
-        _RemoteFeatureFlagController_processedRemoteFeatureFlags.set(this, void 0);
-        __classPrivateFieldSet(this, _RemoteFeatureFlagController_defaultFeatureFlags, defaultFeatureFlags, "f");
+        this.#defaultFeatureFlags = defaultFeatureFlags;
         // Last session's effective flags stand in for the remote layer until
         // `init` re-derives it from the persisted raw flags, or a fetch replaces
         // it. Overrides are layered on top rather than subtracted out, so a remote
         // flag that happens to share an override's value is not lost.
-        __classPrivateFieldSet(this, _RemoteFeatureFlagController_processedRemoteFeatureFlags, initialState.remoteFeatureFlags, "f");
-        __classPrivateFieldSet(this, _RemoteFeatureFlagController_fetchInterval, fetchInterval, "f");
-        __classPrivateFieldSet(this, _RemoteFeatureFlagController_disabled, disabled, "f");
-        __classPrivateFieldSet(this, _RemoteFeatureFlagController_clientConfigApiService, clientConfigApiService, "f");
-        __classPrivateFieldSet(this, _RemoteFeatureFlagController_getMetaMetricsId, getMetaMetricsId, "f");
-        __classPrivateFieldSet(this, _RemoteFeatureFlagController_getCanonicalProfileId, getCanonicalProfileId, "f");
-        __classPrivateFieldSet(this, _RemoteFeatureFlagController_metaMetricsFlags, new Set(metaMetricsFlags), "f");
-        __classPrivateFieldSet(this, _RemoteFeatureFlagController_clientVersion, clientVersion, "f");
+        this.#processedRemoteFeatureFlags = initialState.remoteFeatureFlags;
+        this.#fetchInterval = fetchInterval;
+        this.#disabled = disabled;
+        this.#clientConfigApiService = clientConfigApiService;
+        this.#getMetaMetricsId = getMetaMetricsId;
+        this.#getCanonicalProfileId = getCanonicalProfileId;
+        this.#metaMetricsFlags = new Set(metaMetricsFlags);
+        this.#clientVersion = clientVersion;
         this.messenger.registerMethodActionHandlers(this, MESSENGER_EXPOSED_METHODS);
     }
+    /**
+     * Computes effective feature flags with precedence:
+     * defaults < processed remote < local overrides.
+     *
+     * @param options - The layers to merge. Each defaults to the current layer.
+     * @param options.processedRemoteFeatureFlags - The processed remote feature
+     * flags. Defaults to the currently resolved remote layer.
+     * @param options.localOverrides - Local overrides. Defaults to current state
+     * overrides.
+     * @returns The effective feature flags.
+     */
+    #getEffectiveFeatureFlags({ processedRemoteFeatureFlags = this.#processedRemoteFeatureFlags, localOverrides = this.state.localOverrides, } = {}) {
+        return {
+            ...this.#defaultFeatureFlags,
+            ...processedRemoteFeatureFlags,
+            ...localOverrides,
+        };
+    }
+    /**
+     * Checks if the cached feature flags are expired based on the fetch interval.
+     *
+     * @returns Whether the cache is expired (`true`) or still valid (`false`).
+     */
+    #isCacheExpired() {
+        return Date.now() - this.state.cacheTimestamp > this.#fetchInterval;
+    }
     /**
      * Retrieves the remote feature flags, fetching from the API if necessary.
      * Uses caching to prevent redundant API calls and handles concurrent fetches.
@@ -183,22 +196,23 @@ export class RemoteFeatureFlagController extends BaseController {
      * @returns A promise that resolves to the current set of feature flags.
      */
     async updateRemoteFeatureFlags(force = false) {
-        if (__classPrivateFieldGet(this, _RemoteFeatureFlagController_disabled, "f") || (!force && !__classPrivateFieldGet(this, _RemoteFeatureFlagController_instances, "m", _RemoteFeatureFlagController_isCacheExpired).call(this))) {
+        if (this.#disabled || (!force && !this.#isCacheExpired())) {
             return;
         }
         let serverData;
-        if (__classPrivateFieldGet(this, _RemoteFeatureFlagController_inProgressFlagUpdate, "f")) {
-            await __classPrivateFieldGet(this, _RemoteFeatureFlagController_inProgressFlagUpdate, "f");
+        if (this.#inProgressFlagUpdate) {
+            await this.#inProgressFlagUpdate;
             return;
         }
         try {
-            __classPrivateFieldSet(this, _RemoteFeatureFlagController_inProgressFlagUpdate, __classPrivateFieldGet(this, _RemoteFeatureFlagController_clientConfigApiService, "f").fetchRemoteFeatureFlags(), "f");
-            serverData = await __classPrivateFieldGet(this, _RemoteFeatureFlagController_inProgressFlagUpdate, "f");
+            this.#inProgressFlagUpdate =
+                this.#clientConfigApiService.fetchRemoteFeatureFlags();
+            serverData = await this.#inProgressFlagUpdate;
         }
         finally {
-            __classPrivateFieldSet(this, _RemoteFeatureFlagController_inProgressFlagUpdate, undefined, "f");
+            this.#inProgressFlagUpdate = undefined;
         }
-        await __classPrivateFieldGet(this, _RemoteFeatureFlagController_instances, "m", _RemoteFeatureFlagController_updateCache).call(this, serverData.remoteFeatureFlags);
+        await this.#updateCache(serverData.remoteFeatureFlags);
     }
     /**
      * Computes the effective feature flags, re-deriving the remote layer from the
@@ -215,13 +229,14 @@ export class RemoteFeatureFlagController extends BaseController {
         const { rawRemoteFeatureFlags } = this.state;
         const hasRawRemoteFeatureFlags = rawRemoteFeatureFlags && Object.keys(rawRemoteFeatureFlags).length > 0;
         const resolved = hasRawRemoteFeatureFlags
-            ? await __classPrivateFieldGet(this, _RemoteFeatureFlagController_instances, "m", _RemoteFeatureFlagController_processRemoteFeatureFlags).call(this, rawRemoteFeatureFlags)
+            ? await this.#processRemoteFeatureFlags(rawRemoteFeatureFlags)
             : undefined;
-        __classPrivateFieldSet(this, _RemoteFeatureFlagController_processedRemoteFeatureFlags, resolved?.processedFlags ?? this.state.remoteFeatureFlags, "f");
+        this.#processedRemoteFeatureFlags =
+            resolved?.processedFlags ?? this.state.remoteFeatureFlags;
         this.update(() => {
             return {
                 ...this.state,
-                remoteFeatureFlags: __classPrivateFieldGet(this, _RemoteFeatureFlagController_instances, "m", _RemoteFeatureFlagController_getEffectiveFeatureFlags).call(this),
+                remoteFeatureFlags: this.#getEffectiveFeatureFlags(),
                 ...(resolved && {
                     thresholdCache: resolved.thresholdCache,
                     featureFlagThresholdGroups: resolved.featureFlagThresholdGroups,
@@ -229,17 +244,159 @@ export class RemoteFeatureFlagController extends BaseController {
             };
         });
     }
+    /**
+     * Updates the controller's state with new feature flags and resets the cache timestamp.
+     *
+     * @param remoteFeatureFlags - The new feature flags to cache.
+     */
+    async #updateCache(remoteFeatureFlags) {
+        const resolved = await this.#processRemoteFeatureFlags(remoteFeatureFlags);
+        this.#processedRemoteFeatureFlags = resolved.processedFlags;
+        // Single state update with all changes batched together
+        this.update(() => {
+            return {
+                ...this.state,
+                remoteFeatureFlags: this.#getEffectiveFeatureFlags({
+                    processedRemoteFeatureFlags: resolved.processedFlags,
+                }),
+                rawRemoteFeatureFlags: remoteFeatureFlags,
+                cacheTimestamp: Date.now(),
+                thresholdCache: resolved.thresholdCache,
+                featureFlagThresholdGroups: resolved.featureFlagThresholdGroups,
+            };
+        });
+    }
+    /**
+     * Processes a version-based feature flag to get the appropriate value for the current client version.
+     *
+     * @param flagValue - The feature flag value to process
+     * @returns The processed value, or null if no version qualifies (skip this flag)
+     */
+    #processVersionBasedFlag(flagValue) {
+        if (!isVersionFeatureFlag(flagValue)) {
+            return flagValue;
+        }
+        return getVersionData(flagValue, this.#clientVersion);
+    }
+    /**
+     * Selects the identifier used to bucket a threshold flag. Flags named in
+     * `metaMetricsFlags` segment by MetaMetrics ID; all others segment by
+     * canonical profile ID.
+     *
+     * @param featureFlagName - The name of the feature flag being processed.
+     * @returns The segmentation identifier, which may be empty when unavailable.
+     */
+    #getSegmentationId(featureFlagName) {
+        if (this.#metaMetricsFlags.has(featureFlagName)) {
+            return this.#getMetaMetricsId();
+        }
+        return this.#getCanonicalProfileId();
+    }
+    /**
+     * Resolves raw feature flags into the values that apply to this client and
+     * user, selecting version and threshold entries and reconciling the
+     * threshold cache against the flags the server currently serves.
+     *
+     * @param remoteFeatureFlags - The unprocessed feature flags.
+     * @returns The processed flags, the updated threshold cache, and the
+     * selected threshold group names.
+     */
+    async #processRemoteFeatureFlags(remoteFeatureFlags) {
+        const processedFlags = {};
+        const metaMetricsId = this.#getMetaMetricsId();
+        const thresholdCacheUpdates = {};
+        const featureFlagThresholdGroups = {};
+        for (const [remoteFeatureFlagName, remoteFeatureFlagValue,] of Object.entries(remoteFeatureFlags)) {
+            let processedValue = this.#processVersionBasedFlag(remoteFeatureFlagValue);
+            if (processedValue === null) {
+                continue;
+            }
+            if (Array.isArray(processedValue)) {
+                // Validate array has valid threshold items before doing expensive crypto operation
+                const hasValidThresholds = processedValue.some(isFeatureFlagWithScopeValue);
+                if (!hasValidThresholds) {
+                    // Not a threshold array - preserve as-is
+                    processedFlags[remoteFeatureFlagName] = processedValue;
+                    continue;
+                }
+                // Explicit-ID matching: check before hash-based threshold, bypasses cache
+                const normalizedMetaMetricsId = metaMetricsId.trim().toLowerCase();
+                const explicitMatch = normalizedMetaMetricsId
+                    ? findExplicitIdMatch(processedValue, normalizedMetaMetricsId)
+                    : undefined;
+                if (explicitMatch) {
+                    processedValue = explicitMatch.value;
+                    if (explicitMatch.name) {
+                        featureFlagThresholdGroups[remoteFeatureFlagName] =
+                            explicitMatch.name;
+                    }
+                }
+                else {
+                    const segmentationId = this.#getSegmentationId(remoteFeatureFlagName);
+                    if (!segmentationId) {
+                        processedFlags[remoteFeatureFlagName] = processedValue;
+                        continue;
+                    }
+                    // Fall back to hash-based threshold selection with cache
+                    const cacheKey = `${segmentationId}:${remoteFeatureFlagName}`;
+                    let thresholdValue = this.state.thresholdCache?.[cacheKey];
+                    if (thresholdValue === undefined) {
+                        thresholdValue = await calculateThresholdForFlag(segmentationId, remoteFeatureFlagName);
+                        // Collect new threshold for batched state update
+                        thresholdCacheUpdates[cacheKey] = thresholdValue;
+                    }
+                    const threshold = thresholdValue;
+                    const selectedGroup = processedValue.find((featureFlag) => {
+                        if (!isFeatureFlagWithScopeValue(featureFlag)) {
+                            return false;
+                        }
+                        return threshold <= featureFlag.scope.value;
+                    });
+                    if (selectedGroup) {
+                        processedValue = selectedGroup.value;
+                        if (selectedGroup.name) {
+                            featureFlagThresholdGroups[remoteFeatureFlagName] =
+                                selectedGroup.name;
+                        }
+                    }
+                }
+            }
+            processedFlags[remoteFeatureFlagName] = processedValue;
+        }
+        const thresholdCache = {
+            ...this.state.thresholdCache,
+            ...thresholdCacheUpdates,
+        };
+        // Drop cached thresholds for flags this user is no longer served, under
+        // either identifier they may have been bucketed by.
+        const canonicalProfileId = this.#getCanonicalProfileId();
+        const currentFlagNames = Object.keys(remoteFeatureFlags);
+        for (const cacheKey of Object.keys(thresholdCache)) {
+            const [cachedSegmentationId, ...cachedFlagNameParts] = cacheKey.split(':');
+            const cachedFlagName = cachedFlagNameParts.join(':');
+            if ((cachedSegmentationId === metaMetricsId ||
+                cachedSegmentationId === canonicalProfileId) &&
+                !currentFlagNames.includes(cachedFlagName)) {
+                delete thresholdCache[cacheKey];
+            }
+        }
+        return {
+            processedFlags,
+            thresholdCache,
+            featureFlagThresholdGroups,
+        };
+    }
     /**
      * Enables the controller, allowing it to make network requests.
      */
     enable() {
-        __classPrivateFieldSet(this, _RemoteFeatureFlagController_disabled, false, "f");
+        this.#disabled = false;
     }
     /**
      * Disables the controller, preventing it from making network requests.
      */
     disable() {
-        __classPrivateFieldSet(this, _RemoteFeatureFlagController_disabled, true, "f");
+        this.#disabled = true;
     }
     /**
      * Sets a local override for a specific feature flag.
@@ -256,7 +413,7 @@ export class RemoteFeatureFlagController extends BaseController {
             return {
                 ...this.state,
                 localOverrides,
-                remoteFeatureFlags: __classPrivateFieldGet(this, _RemoteFeatureFlagController_instances, "m", _RemoteFeatureFlagController_getEffectiveFeatureFlags).call(this, { localOverrides }),
+                remoteFeatureFlags: this.#getEffectiveFeatureFlags({ localOverrides }),
             };
         });
     }
@@ -272,7 +429,7 @@ export class RemoteFeatureFlagController extends BaseController {
             return {
                 ...this.state,
                 localOverrides: newLocalOverrides,
-                remoteFeatureFlags: __classPrivateFieldGet(this, _RemoteFeatureFlagController_instances, "m", _RemoteFeatureFlagController_getEffectiveFeatureFlags).call(this, {
+                remoteFeatureFlags: this.#getEffectiveFeatureFlags({
                     localOverrides: newLocalOverrides,
                 }),
             };
@@ -286,146 +443,11 @@ export class RemoteFeatureFlagController extends BaseController {
             return {
                 ...this.state,
                 localOverrides: {},
-                remoteFeatureFlags: __classPrivateFieldGet(this, _RemoteFeatureFlagController_instances, "m", _RemoteFeatureFlagController_getEffectiveFeatureFlags).call(this, {
+                remoteFeatureFlags: this.#getEffectiveFeatureFlags({
                     localOverrides: {},
                 }),
             };
         });
     }
 }
-_RemoteFeatureFlagController_fetchInterval = new WeakMap(), _RemoteFeatureFlagController_disabled = new WeakMap(), _RemoteFeatureFlagController_clientConfigApiService = new WeakMap(), _RemoteFeatureFlagController_inProgressFlagUpdate = new WeakMap(), _RemoteFeatureFlagController_getMetaMetricsId = new WeakMap(), _RemoteFeatureFlagController_getCanonicalProfileId = new WeakMap(), _RemoteFeatureFlagController_metaMetricsFlags = new WeakMap(), _RemoteFeatureFlagController_clientVersion = new WeakMap(), _RemoteFeatureFlagController_defaultFeatureFlags = new WeakMap(), _RemoteFeatureFlagController_processedRemoteFeatureFlags = new WeakMap(), _RemoteFeatureFlagController_instances = new WeakSet(), _RemoteFeatureFlagController_getEffectiveFeatureFlags = function _RemoteFeatureFlagController_getEffectiveFeatureFlags({ processedRemoteFeatureFlags = __classPrivateFieldGet(this, _RemoteFeatureFlagController_processedRemoteFeatureFlags, "f"), localOverrides = this.state.localOverrides, } = {}) {
-    return {
-        ...__classPrivateFieldGet(this, _RemoteFeatureFlagController_defaultFeatureFlags, "f"),
-        ...processedRemoteFeatureFlags,
-        ...localOverrides,
-    };
-}, _RemoteFeatureFlagController_isCacheExpired = function _RemoteFeatureFlagController_isCacheExpired() {
-    return Date.now() - this.state.cacheTimestamp > __classPrivateFieldGet(this, _RemoteFeatureFlagController_fetchInterval, "f");
-}, _RemoteFeatureFlagController_updateCache = 
-/**
- * Updates the controller's state with new feature flags and resets the cache timestamp.
- *
- * @param remoteFeatureFlags - The new feature flags to cache.
- */
-async function _RemoteFeatureFlagController_updateCache(remoteFeatureFlags) {
-    const resolved = await __classPrivateFieldGet(this, _RemoteFeatureFlagController_instances, "m", _RemoteFeatureFlagController_processRemoteFeatureFlags).call(this, remoteFeatureFlags);
-    __classPrivateFieldSet(this, _RemoteFeatureFlagController_processedRemoteFeatureFlags, resolved.processedFlags, "f");
-    // Single state update with all changes batched together
-    this.update(() => {
-        return {
-            ...this.state,
-            remoteFeatureFlags: __classPrivateFieldGet(this, _RemoteFeatureFlagController_instances, "m", _RemoteFeatureFlagController_getEffectiveFeatureFlags).call(this, {
-                processedRemoteFeatureFlags: resolved.processedFlags,
-            }),
-            rawRemoteFeatureFlags: remoteFeatureFlags,
-            cacheTimestamp: Date.now(),
-            thresholdCache: resolved.thresholdCache,
-            featureFlagThresholdGroups: resolved.featureFlagThresholdGroups,
-        };
-    });
-}, _RemoteFeatureFlagController_processVersionBasedFlag = function _RemoteFeatureFlagController_processVersionBasedFlag(flagValue) {
-    if (!isVersionFeatureFlag(flagValue)) {
-        return flagValue;
-    }
-    return getVersionData(flagValue, __classPrivateFieldGet(this, _RemoteFeatureFlagController_clientVersion, "f"));
-}, _RemoteFeatureFlagController_getSegmentationId = function _RemoteFeatureFlagController_getSegmentationId(featureFlagName) {
-    if (__classPrivateFieldGet(this, _RemoteFeatureFlagController_metaMetricsFlags, "f").has(featureFlagName)) {
-        return __classPrivateFieldGet(this, _RemoteFeatureFlagController_getMetaMetricsId, "f").call(this);
-    }
-    return __classPrivateFieldGet(this, _RemoteFeatureFlagController_getCanonicalProfileId, "f").call(this);
-}, _RemoteFeatureFlagController_processRemoteFeatureFlags = 
-/**
- * Resolves raw feature flags into the values that apply to this client and
- * user, selecting version and threshold entries and reconciling the
- * threshold cache against the flags the server currently serves.
- *
- * @param remoteFeatureFlags - The unprocessed feature flags.
- * @returns The processed flags, the updated threshold cache, and the
- * selected threshold group names.
- */
-async function _RemoteFeatureFlagController_processRemoteFeatureFlags(remoteFeatureFlags) {
-    const processedFlags = {};
-    const metaMetricsId = __classPrivateFieldGet(this, _RemoteFeatureFlagController_getMetaMetricsId, "f").call(this);
-    const thresholdCacheUpdates = {};
-    const featureFlagThresholdGroups = {};
-    for (const [remoteFeatureFlagName, remoteFeatureFlagValue,] of Object.entries(remoteFeatureFlags)) {
-        let processedValue = __classPrivateFieldGet(this, _RemoteFeatureFlagController_instances, "m", _RemoteFeatureFlagController_processVersionBasedFlag).call(this, remoteFeatureFlagValue);
-        if (processedValue === null) {
-            continue;
-        }
-        if (Array.isArray(processedValue)) {
-            // Validate array has valid threshold items before doing expensive crypto operation
-            const hasValidThresholds = processedValue.some(isFeatureFlagWithScopeValue);
-            if (!hasValidThresholds) {
-                // Not a threshold array - preserve as-is
-                processedFlags[remoteFeatureFlagName] = processedValue;
-                continue;
-            }
-            // Explicit-ID matching: check before hash-based threshold, bypasses cache
-            const normalizedMetaMetricsId = metaMetricsId.trim().toLowerCase();
-            const explicitMatch = normalizedMetaMetricsId
-                ? findExplicitIdMatch(processedValue, normalizedMetaMetricsId)
-                : undefined;
-            if (explicitMatch) {
-                processedValue = explicitMatch.value;
-                if (explicitMatch.name) {
-                    featureFlagThresholdGroups[remoteFeatureFlagName] =
-                        explicitMatch.name;
-                }
-            }
-            else {
-                const segmentationId = __classPrivateFieldGet(this, _RemoteFeatureFlagController_instances, "m", _RemoteFeatureFlagController_getSegmentationId).call(this, remoteFeatureFlagName);
-                if (!segmentationId) {
-                    processedFlags[remoteFeatureFlagName] = processedValue;
-                    continue;
-                }
-                // Fall back to hash-based threshold selection with cache
-                const cacheKey = `${segmentationId}:${remoteFeatureFlagName}`;
-                let thresholdValue = this.state.thresholdCache?.[cacheKey];
-                if (thresholdValue === undefined) {
-                    thresholdValue = await calculateThresholdForFlag(segmentationId, remoteFeatureFlagName);
-                    // Collect new threshold for batched state update
-                    thresholdCacheUpdates[cacheKey] = thresholdValue;
-                }
-                const threshold = thresholdValue;
-                const selectedGroup = processedValue.find((featureFlag) => {
-                    if (!isFeatureFlagWithScopeValue(featureFlag)) {
-                        return false;
-                    }
-                    return threshold <= featureFlag.scope.value;
-                });
-                if (selectedGroup) {
-                    processedValue = selectedGroup.value;
-                    if (selectedGroup.name) {
-                        featureFlagThresholdGroups[remoteFeatureFlagName] =
-                            selectedGroup.name;
-                    }
-                }
-            }
-        }
-        processedFlags[remoteFeatureFlagName] = processedValue;
-    }
-    const thresholdCache = {
-        ...this.state.thresholdCache,
-        ...thresholdCacheUpdates,
-    };
-    // Drop cached thresholds for flags this user is no longer served, under
-    // either identifier they may have been bucketed by.
-    const canonicalProfileId = __classPrivateFieldGet(this, _RemoteFeatureFlagController_getCanonicalProfileId, "f").call(this);
-    const currentFlagNames = Object.keys(remoteFeatureFlags);
-    for (const cacheKey of Object.keys(thresholdCache)) {
-        const [cachedSegmentationId, ...cachedFlagNameParts] = cacheKey.split(':');
-        const cachedFlagName = cachedFlagNameParts.join(':');
-        if ((cachedSegmentationId === metaMetricsId ||
-            cachedSegmentationId === canonicalProfileId) &&
-            !currentFlagNames.includes(cachedFlagName)) {
-            delete thresholdCache[cacheKey];
-        }
-    }
-    return {
-        processedFlags,
-        thresholdCache,
-        featureFlagThresholdGroups,
-    };
-};
 //# sourceMappingURL=remote-feature-flag-controller.js.map

package/dist/remote-feature-flag-controller.js.map

@@ -1 +1 @@
-{"version":3,"file":"remote-feature-flag-controller.js","sourceRoot":"","sources":["../src/remote-feature-flag-controller.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  BaseController,\n  ControllerGetStateAction,\n} from '@metamask/base-controller';\nimport type { ControllerStateChangeEvent } from '@metamask/base-controller';\nimport type { Messenger } from '@metamask/messenger';\nimport { isValidSemVerVersion } from '@metamask/utils';\nimport type { Json, SemVerVersion } from '@metamask/utils';\n\nimport type { AbstractClientConfigApiService } from './client-config-api-service/abstract-client-config-api-service.js';\nimport type { RemoteFeatureFlagControllerMethodActions } from './remote-feature-flag-controller-method-action-types.js';\nimport type {\n  FeatureFlags,\n  ServiceResponse,\n  FeatureFlagScopeValue,\n} from './remote-feature-flag-controller-types.js';\nimport {\n  calculateThresholdForFlag,\n  isFeatureFlagWithScopeValue,\n} from './utils/user-segmentation-utils.js';\nimport { isVersionFeatureFlag, getVersionData } from './utils/version.js';\n\n// === GENERAL ===\n\nexport const controllerName = 'RemoteFeatureFlagController';\nexport const DEFAULT_CACHE_DURATION = 24 * 60 * 60 * 1000; // 1 day\n\n// === STATE ===\n\nexport type RemoteFeatureFlagControllerState = {\n  remoteFeatureFlags: FeatureFlags;\n  localOverrides?: FeatureFlags;\n  rawRemoteFeatureFlags?: FeatureFlags;\n  cacheTimestamp: number;\n  thresholdCache?: Record<string, number>;\n  featureFlagThresholdGroups?: Record<string, string>;\n};\n\nconst remoteFeatureFlagControllerMetadata = {\n  remoteFeatureFlags: {\n    includeInStateLogs: true,\n    persist: true,\n    includeInDebugSnapshot: true,\n    usedInUi: true,\n  },\n  localOverrides: {\n    includeInStateLogs: true,\n    persist: true,\n    includeInDebugSnapshot: true,\n    usedInUi: true,\n  },\n  rawRemoteFeatureFlags: {\n    includeInStateLogs: true,\n    persist: true,\n    includeInDebugSnapshot: true,\n    usedInUi: false,\n  },\n  cacheTimestamp: {\n    includeInStateLogs: true,\n    persist: true,\n    includeInDebugSnapshot: true,\n    usedInUi: false,\n  },\n  thresholdCache: {\n    includeInStateLogs: false,\n    persist: true,\n    includeInDebugSnapshot: false,\n    usedInUi: false,\n  },\n  featureFlagThresholdGroups: {\n    includeInStateLogs: true,\n    persist: true,\n    includeInDebugSnapshot: true,\n    usedInUi: false,\n  },\n};\n\n// === MESSENGER ===\n\nconst MESSENGER_EXPOSED_METHODS = [\n  'clearAllFlagOverrides',\n  'disable',\n  'enable',\n  'removeFlagOverride',\n  'setFlagOverride',\n  'updateRemoteFeatureFlags',\n] as const;\n\nexport type RemoteFeatureFlagControllerGetStateAction =\n  ControllerGetStateAction<\n    typeof controllerName,\n    RemoteFeatureFlagControllerState\n  >;\n\nexport type RemoteFeatureFlagControllerActions =\n  | RemoteFeatureFlagControllerGetStateAction\n  | RemoteFeatureFlagControllerMethodActions;\n\nexport type RemoteFeatureFlagControllerStateChangeEvent =\n  ControllerStateChangeEvent<\n    typeof controllerName,\n    RemoteFeatureFlagControllerState\n  >;\n\nexport type RemoteFeatureFlagControllerEvents =\n  RemoteFeatureFlagControllerStateChangeEvent;\n\nexport type RemoteFeatureFlagControllerMessenger = Messenger<\n  typeof controllerName,\n  RemoteFeatureFlagControllerActions,\n  RemoteFeatureFlagControllerEvents\n>;\n\n/**\n * Returns the default state for the RemoteFeatureFlagController.\n *\n * @returns The default controller state.\n */\nexport function getDefaultRemoteFeatureFlagControllerState(): RemoteFeatureFlagControllerState {\n  return {\n    remoteFeatureFlags: {},\n    localOverrides: {},\n    rawRemoteFeatureFlags: {},\n    cacheTimestamp: 0,\n  };\n}\n\n/**\n * Searches threshold entries for an explicit MetaMetrics ID match.\n * Returns the first entry whose `metaMetricsIds` list contains the given\n * normalized ID. Entries with malformed `metaMetricsIds` (not an array) are\n * skipped without throwing.\n *\n * @param entries - The array of raw threshold entries for a feature flag.\n * @param normalizedId - The current user's MetaMetrics ID, already trimmed and\n * lower-cased.\n * @returns The first matching entry, or `undefined` if none match.\n */\nfunction findExplicitIdMatch(\n  entries: Json[],\n  normalizedId: string,\n): FeatureFlagScopeValue | undefined {\n  for (const entry of entries) {\n    if (!isFeatureFlagWithScopeValue(entry)) {\n      continue;\n    }\n    const { metaMetricsIds } = entry;\n    if (!Array.isArray(metaMetricsIds)) {\n      continue;\n    }\n    const hasMatch = metaMetricsIds.some(\n      (id) =>\n        typeof id === 'string' && id.trim().toLowerCase() === normalizedId,\n    );\n    if (hasMatch) {\n      return entry;\n    }\n  }\n  return undefined;\n}\n\n/**\n * The RemoteFeatureFlagController manages the retrieval and caching of remote feature flags.\n * It fetches feature flags from a remote API, caches them, and provides methods to access\n * and manage these flags. The controller ensures that feature flags are refreshed based on\n * a specified interval and handles cases where the controller is disabled or the network is unavailable.\n */\nexport class RemoteFeatureFlagController extends BaseController<\n  typeof controllerName,\n  RemoteFeatureFlagControllerState,\n  RemoteFeatureFlagControllerMessenger\n> {\n  readonly #fetchInterval: number;\n\n  #disabled: boolean;\n\n  readonly #clientConfigApiService: AbstractClientConfigApiService;\n\n  #inProgressFlagUpdate?: Promise<ServiceResponse>;\n\n  readonly #getMetaMetricsId: () => string;\n\n  readonly #getCanonicalProfileId: () => string;\n\n  readonly #metaMetricsFlags: ReadonlySet<string>;\n\n  readonly #clientVersion: SemVerVersion;\n\n  readonly #defaultFeatureFlags: FeatureFlags;\n\n  #processedRemoteFeatureFlags: FeatureFlags;\n\n  /**\n   * Constructs a new RemoteFeatureFlagController instance.\n   *\n   * @param options - The controller options.\n   * @param options.messenger - The messenger used for communication.\n   * @param options.state - The initial state of the controller.\n   * @param options.clientConfigApiService - The service instance to fetch remote feature flags.\n   * @param options.fetchInterval - The interval in milliseconds before cached flags expire. Defaults to 1 day.\n   * @param options.disabled - Determines if the controller should be disabled initially. Defaults to false.\n   * @param options.getMetaMetricsId - Returns metaMetricsId.\n   * @param options.getCanonicalProfileId - Returns the canonical profile identifier used for threshold flags by default. Must return an empty string, rather than throwing, when the identifier is unavailable.\n   * @param options.metaMetricsFlags - Names of feature flags that should use MetaMetrics ID for threshold assignment.\n   * @param options.clientVersion - The current client version for version-based feature flag filtering. Must be a valid 3-part SemVer version string.\n   * @param options.prevClientVersion - The previous client version for feature flag cache invalidation.\n   * @param options.defaultFeatureFlags - Client-side default feature flags used as the lowest-precedence layer under processed remote flags and local overrides. Not persisted.\n   */\n  constructor({\n    messenger,\n    state,\n    clientConfigApiService,\n    fetchInterval = DEFAULT_CACHE_DURATION,\n    disabled = false,\n    getMetaMetricsId,\n    getCanonicalProfileId,\n    metaMetricsFlags = [],\n    clientVersion,\n    prevClientVersion,\n    defaultFeatureFlags = {},\n  }: {\n    messenger: RemoteFeatureFlagControllerMessenger;\n    state?: Partial<RemoteFeatureFlagControllerState>;\n    clientConfigApiService: AbstractClientConfigApiService;\n    getMetaMetricsId: () => string;\n    getCanonicalProfileId: () => string;\n    metaMetricsFlags?: readonly string[];\n    fetchInterval?: number;\n    disabled?: boolean;\n    clientVersion: string;\n    prevClientVersion?: string;\n    defaultFeatureFlags?: FeatureFlags;\n  }) {\n    if (!isValidSemVerVersion(clientVersion)) {\n      throw new Error(\n        `Invalid clientVersion: \"${clientVersion}\". Must be a valid 3-part SemVer version string`,\n      );\n    }\n\n    const initialState: RemoteFeatureFlagControllerState = {\n      ...getDefaultRemoteFeatureFlagControllerState(),\n      ...state,\n    };\n\n    const hasClientVersionChanged =\n      isValidSemVerVersion(prevClientVersion) &&\n      prevClientVersion !== clientVersion;\n\n    super({\n      name: controllerName,\n      metadata: remoteFeatureFlagControllerMetadata,\n      messenger,\n      state: {\n        ...initialState,\n        cacheTimestamp: hasClientVersionChanged\n          ? 0\n          : initialState.cacheTimestamp,\n      },\n    });\n\n    this.#defaultFeatureFlags = defaultFeatureFlags;\n    // Last session's effective flags stand in for the remote layer until\n    // `init` re-derives it from the persisted raw flags, or a fetch replaces\n    // it. Overrides are layered on top rather than subtracted out, so a remote\n    // flag that happens to share an override's value is not lost.\n    this.#processedRemoteFeatureFlags = initialState.remoteFeatureFlags;\n    this.#fetchInterval = fetchInterval;\n    this.#disabled = disabled;\n    this.#clientConfigApiService = clientConfigApiService;\n    this.#getMetaMetricsId = getMetaMetricsId;\n    this.#getCanonicalProfileId = getCanonicalProfileId;\n    this.#metaMetricsFlags = new Set(metaMetricsFlags);\n    this.#clientVersion = clientVersion;\n\n    this.messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n  }\n\n  /**\n   * Computes effective feature flags with precedence:\n   * defaults < processed remote < local overrides.\n   *\n   * @param options - The layers to merge. Each defaults to the current layer.\n   * @param options.processedRemoteFeatureFlags - The processed remote feature\n   * flags. Defaults to the currently resolved remote layer.\n   * @param options.localOverrides - Local overrides. Defaults to current state\n   * overrides.\n   * @returns The effective feature flags.\n   */\n  #getEffectiveFeatureFlags({\n    processedRemoteFeatureFlags = this.#processedRemoteFeatureFlags,\n    localOverrides = this.state.localOverrides,\n  }: {\n    processedRemoteFeatureFlags?: FeatureFlags;\n    localOverrides?: FeatureFlags;\n  } = {}): FeatureFlags {\n    return {\n      ...this.#defaultFeatureFlags,\n      ...processedRemoteFeatureFlags,\n      ...localOverrides,\n    };\n  }\n\n  /**\n   * Checks if the cached feature flags are expired based on the fetch interval.\n   *\n   * @returns Whether the cache is expired (`true`) or still valid (`false`).\n   */\n  #isCacheExpired(): boolean {\n    return Date.now() - this.state.cacheTimestamp > this.#fetchInterval;\n  }\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   */\n  async updateRemoteFeatureFlags(force = false): Promise<void> {\n    if (this.#disabled || (!force && !this.#isCacheExpired())) {\n      return;\n    }\n\n    let serverData;\n\n    if (this.#inProgressFlagUpdate) {\n      await this.#inProgressFlagUpdate;\n      return;\n    }\n\n    try {\n      this.#inProgressFlagUpdate =\n        this.#clientConfigApiService.fetchRemoteFeatureFlags();\n\n      serverData = await this.#inProgressFlagUpdate;\n    } finally {\n      this.#inProgressFlagUpdate = undefined;\n    }\n\n    await this.#updateCache(serverData.remoteFeatureFlags);\n  }\n\n  /**\n   * Computes the effective feature flags, re-deriving the remote layer from the\n   * raw flags already in state. Threshold selection needs to await a hash and\n   * so cannot run in the constructor, which is why this cannot be part of\n   * construction. Clients must call this once after constructing the\n   * controller.\n   *\n   * When there are no persisted raw flags, as on a fresh install or for state\n   * persisted before raw flags were stored, the previous session's flags stand\n   * in for the remote layer so that nothing is lost.\n   */\n  async init(): Promise<void> {\n    const { rawRemoteFeatureFlags } = this.state;\n    const hasRawRemoteFeatureFlags =\n      rawRemoteFeatureFlags && Object.keys(rawRemoteFeatureFlags).length > 0;\n\n    const resolved = hasRawRemoteFeatureFlags\n      ? await this.#processRemoteFeatureFlags(rawRemoteFeatureFlags)\n      : undefined;\n\n    this.#processedRemoteFeatureFlags =\n      resolved?.processedFlags ?? this.state.remoteFeatureFlags;\n\n    this.update(() => {\n      return {\n        ...this.state,\n        remoteFeatureFlags: this.#getEffectiveFeatureFlags(),\n        ...(resolved && {\n          thresholdCache: resolved.thresholdCache,\n          featureFlagThresholdGroups: resolved.featureFlagThresholdGroups,\n        }),\n      };\n    });\n  }\n\n  /**\n   * Updates the controller's state with new feature flags and resets the cache timestamp.\n   *\n   * @param remoteFeatureFlags - The new feature flags to cache.\n   */\n  async #updateCache(remoteFeatureFlags: FeatureFlags): Promise<void> {\n    const resolved = await this.#processRemoteFeatureFlags(remoteFeatureFlags);\n\n    this.#processedRemoteFeatureFlags = resolved.processedFlags;\n\n    // Single state update with all changes batched together\n    this.update(() => {\n      return {\n        ...this.state,\n        remoteFeatureFlags: this.#getEffectiveFeatureFlags({\n          processedRemoteFeatureFlags: resolved.processedFlags,\n        }),\n        rawRemoteFeatureFlags: remoteFeatureFlags,\n        cacheTimestamp: Date.now(),\n        thresholdCache: resolved.thresholdCache,\n        featureFlagThresholdGroups: resolved.featureFlagThresholdGroups,\n      };\n    });\n  }\n\n  /**\n   * Processes a version-based feature flag to get the appropriate value for the current client version.\n   *\n   * @param flagValue - The feature flag value to process\n   * @returns The processed value, or null if no version qualifies (skip this flag)\n   */\n  #processVersionBasedFlag(flagValue: Json): Json | null {\n    if (!isVersionFeatureFlag(flagValue)) {\n      return flagValue;\n    }\n\n    return getVersionData(flagValue, this.#clientVersion);\n  }\n\n  /**\n   * Selects the identifier used to bucket a threshold flag. Flags named in\n   * `metaMetricsFlags` segment by MetaMetrics ID; all others segment by\n   * canonical profile ID.\n   *\n   * @param featureFlagName - The name of the feature flag being processed.\n   * @returns The segmentation identifier, which may be empty when unavailable.\n   */\n  #getSegmentationId(featureFlagName: string): string {\n    if (this.#metaMetricsFlags.has(featureFlagName)) {\n      return this.#getMetaMetricsId();\n    }\n    return this.#getCanonicalProfileId();\n  }\n\n  /**\n   * Resolves raw feature flags into the values that apply to this client and\n   * user, selecting version and threshold entries and reconciling the\n   * threshold cache against the flags the server currently serves.\n   *\n   * @param remoteFeatureFlags - The unprocessed feature flags.\n   * @returns The processed flags, the updated threshold cache, and the\n   * selected threshold group names.\n   */\n  async #processRemoteFeatureFlags(remoteFeatureFlags: FeatureFlags): Promise<{\n    processedFlags: FeatureFlags;\n    thresholdCache: Record<string, number>;\n    featureFlagThresholdGroups: Record<string, string>;\n  }> {\n    const processedFlags: FeatureFlags = {};\n    const metaMetricsId = this.#getMetaMetricsId();\n    const thresholdCacheUpdates: Record<string, number> = {};\n    const featureFlagThresholdGroups: Record<string, string> = {};\n\n    for (const [\n      remoteFeatureFlagName,\n      remoteFeatureFlagValue,\n    ] of Object.entries(remoteFeatureFlags)) {\n      let processedValue = this.#processVersionBasedFlag(\n        remoteFeatureFlagValue,\n      );\n      if (processedValue === null) {\n        continue;\n      }\n\n      if (Array.isArray(processedValue)) {\n        // Validate array has valid threshold items before doing expensive crypto operation\n        const hasValidThresholds = processedValue.some(\n          isFeatureFlagWithScopeValue,\n        );\n\n        if (!hasValidThresholds) {\n          // Not a threshold array - preserve as-is\n          processedFlags[remoteFeatureFlagName] = processedValue;\n          continue;\n        }\n\n        // Explicit-ID matching: check before hash-based threshold, bypasses cache\n        const normalizedMetaMetricsId = metaMetricsId.trim().toLowerCase();\n        const explicitMatch = normalizedMetaMetricsId\n          ? findExplicitIdMatch(processedValue, normalizedMetaMetricsId)\n          : undefined;\n\n        if (explicitMatch) {\n          processedValue = explicitMatch.value;\n          if (explicitMatch.name) {\n            featureFlagThresholdGroups[remoteFeatureFlagName] =\n              explicitMatch.name;\n          }\n        } else {\n          const segmentationId = this.#getSegmentationId(remoteFeatureFlagName);\n\n          if (!segmentationId) {\n            processedFlags[remoteFeatureFlagName] = processedValue;\n            continue;\n          }\n\n          // Fall back to hash-based threshold selection with cache\n          const cacheKey =\n            `${segmentationId}:${remoteFeatureFlagName}` as const;\n          let thresholdValue = this.state.thresholdCache?.[cacheKey];\n\n          if (thresholdValue === undefined) {\n            thresholdValue = await calculateThresholdForFlag(\n              segmentationId,\n              remoteFeatureFlagName,\n            );\n\n            // Collect new threshold for batched state update\n            thresholdCacheUpdates[cacheKey] = thresholdValue;\n          }\n\n          const threshold = thresholdValue;\n          const selectedGroup = processedValue.find(\n            (featureFlag): featureFlag is FeatureFlagScopeValue => {\n              if (!isFeatureFlagWithScopeValue(featureFlag)) {\n                return false;\n              }\n\n              return threshold <= featureFlag.scope.value;\n            },\n          );\n\n          if (selectedGroup) {\n            processedValue = selectedGroup.value;\n            if (selectedGroup.name) {\n              featureFlagThresholdGroups[remoteFeatureFlagName] =\n                selectedGroup.name;\n            }\n          }\n        }\n      }\n\n      processedFlags[remoteFeatureFlagName] = processedValue;\n    }\n\n    const thresholdCache = {\n      ...this.state.thresholdCache,\n      ...thresholdCacheUpdates,\n    };\n\n    // Drop cached thresholds for flags this user is no longer served, under\n    // either identifier they may have been bucketed by.\n    const canonicalProfileId = this.#getCanonicalProfileId();\n    const currentFlagNames = Object.keys(remoteFeatureFlags);\n    for (const cacheKey of Object.keys(thresholdCache)) {\n      const [cachedSegmentationId, ...cachedFlagNameParts] =\n        cacheKey.split(':');\n      const cachedFlagName = cachedFlagNameParts.join(':');\n      if (\n        (cachedSegmentationId === metaMetricsId ||\n          cachedSegmentationId === canonicalProfileId) &&\n        !currentFlagNames.includes(cachedFlagName)\n      ) {\n        delete thresholdCache[cacheKey];\n      }\n    }\n\n    return {\n      processedFlags,\n      thresholdCache,\n      featureFlagThresholdGroups,\n    };\n  }\n\n  /**\n   * Enables the controller, allowing it to make network requests.\n   */\n  enable(): void {\n    this.#disabled = false;\n  }\n\n  /**\n   * Disables the controller, preventing it from making network requests.\n   */\n  disable(): void {\n    this.#disabled = true;\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   */\n  setFlagOverride(flagName: string, value: Json): void {\n    this.update(() => {\n      const localOverrides = {\n        ...this.state.localOverrides,\n        [flagName]: value,\n      };\n\n      return {\n        ...this.state,\n        localOverrides,\n        remoteFeatureFlags: this.#getEffectiveFeatureFlags({ localOverrides }),\n      };\n    });\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   */\n  removeFlagOverride(flagName: string): void {\n    const newLocalOverrides = { ...this.state.localOverrides };\n    delete newLocalOverrides[flagName];\n\n    this.update(() => {\n      return {\n        ...this.state,\n        localOverrides: newLocalOverrides,\n        remoteFeatureFlags: this.#getEffectiveFeatureFlags({\n          localOverrides: newLocalOverrides,\n        }),\n      };\n    });\n  }\n\n  /**\n   * Clears all local feature flag overrides.\n   */\n  clearAllFlagOverrides(): void {\n    this.update(() => {\n      return {\n        ...this.state,\n        localOverrides: {},\n        remoteFeatureFlags: this.#getEffectiveFeatureFlags({\n          localOverrides: {},\n        }),\n      };\n    });\n  }\n}\n"]}
+{"version":3,"file":"remote-feature-flag-controller.js","sourceRoot":"","sources":["../src/remote-feature-flag-controller.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,GAEf,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAUvD,OAAO,EACL,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE1E,kBAAkB;AAElB,MAAM,CAAC,MAAM,cAAc,GAAG,6BAA6B,CAAC;AAC5D,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,QAAQ;AAanE,MAAM,mCAAmC,GAAG;IAC1C,kBAAkB,EAAE;QAClB,kBAAkB,EAAE,IAAI;QACxB,OAAO,EAAE,IAAI;QACb,sBAAsB,EAAE,IAAI;QAC5B,QAAQ,EAAE,IAAI;KACf;IACD,cAAc,EAAE;QACd,kBAAkB,EAAE,IAAI;QACxB,OAAO,EAAE,IAAI;QACb,sBAAsB,EAAE,IAAI;QAC5B,QAAQ,EAAE,IAAI;KACf;IACD,qBAAqB,EAAE;QACrB,kBAAkB,EAAE,IAAI;QACxB,OAAO,EAAE,IAAI;QACb,sBAAsB,EAAE,IAAI;QAC5B,QAAQ,EAAE,KAAK;KAChB;IACD,cAAc,EAAE;QACd,kBAAkB,EAAE,IAAI;QACxB,OAAO,EAAE,IAAI;QACb,sBAAsB,EAAE,IAAI;QAC5B,QAAQ,EAAE,KAAK;KAChB;IACD,cAAc,EAAE;QACd,kBAAkB,EAAE,KAAK;QACzB,OAAO,EAAE,IAAI;QACb,sBAAsB,EAAE,KAAK;QAC7B,QAAQ,EAAE,KAAK;KAChB;IACD,0BAA0B,EAAE;QAC1B,kBAAkB,EAAE,IAAI;QACxB,OAAO,EAAE,IAAI;QACb,sBAAsB,EAAE,IAAI;QAC5B,QAAQ,EAAE,KAAK;KAChB;CACF,CAAC;AAEF,oBAAoB;AAEpB,MAAM,yBAAyB,GAAG;IAChC,uBAAuB;IACvB,SAAS;IACT,QAAQ;IACR,oBAAoB;IACpB,iBAAiB;IACjB,0BAA0B;CAClB,CAAC;AA2BX;;;;GAIG;AACH,MAAM,UAAU,0CAA0C;IACxD,OAAO;QACL,kBAAkB,EAAE,EAAE;QACtB,cAAc,EAAE,EAAE;QAClB,qBAAqB,EAAE,EAAE;QACzB,cAAc,EAAE,CAAC;KAClB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,mBAAmB,CAC1B,OAAe,EACf,YAAoB;IAEpB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,2BAA2B,CAAC,KAAK,CAAC,EAAE,CAAC;YACxC,SAAS;QACX,CAAC;QACD,MAAM,EAAE,cAAc,EAAE,GAAG,KAAK,CAAC;QACjC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;YACnC,SAAS;QACX,CAAC;QACD,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,CAClC,CAAC,EAAE,EAAE,EAAE,CACL,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,YAAY,CACrE,CAAC;QACF,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,OAAO,2BAA4B,SAAQ,cAIhD;IACU,cAAc,CAAS;IAEhC,SAAS,CAAU;IAEV,uBAAuB,CAAiC;IAEjE,qBAAqB,CAA4B;IAExC,iBAAiB,CAAe;IAEhC,sBAAsB,CAAe;IAErC,iBAAiB,CAAsB;IAEvC,cAAc,CAAgB;IAE9B,oBAAoB,CAAe;IAE5C,4BAA4B,CAAe;IAE3C;;;;;;;;;;;;;;;OAeG;IACH,YAAY,EACV,SAAS,EACT,KAAK,EACL,sBAAsB,EACtB,aAAa,GAAG,sBAAsB,EACtC,QAAQ,GAAG,KAAK,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,GAAG,EAAE,EACrB,aAAa,EACb,iBAAiB,EACjB,mBAAmB,GAAG,EAAE,GAazB;QACC,IAAI,CAAC,oBAAoB,CAAC,aAAa,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CACb,2BAA2B,aAAa,iDAAiD,CAC1F,CAAC;QACJ,CAAC;QAED,MAAM,YAAY,GAAqC;YACrD,GAAG,0CAA0C,EAAE;YAC/C,GAAG,KAAK;SACT,CAAC;QAEF,MAAM,uBAAuB,GAC3B,oBAAoB,CAAC,iBAAiB,CAAC;YACvC,iBAAiB,KAAK,aAAa,CAAC;QAEtC,KAAK,CAAC;YACJ,IAAI,EAAE,cAAc;YACpB,QAAQ,EAAE,mCAAmC;YAC7C,SAAS;YACT,KAAK,EAAE;gBACL,GAAG,YAAY;gBACf,cAAc,EAAE,uBAAuB;oBACrC,CAAC,CAAC,CAAC;oBACH,CAAC,CAAC,YAAY,CAAC,cAAc;aAChC;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,oBAAoB,GAAG,mBAAmB,CAAC;QAChD,qEAAqE;QACrE,yEAAyE;QACzE,2EAA2E;QAC3E,8DAA8D;QAC9D,IAAI,CAAC,4BAA4B,GAAG,YAAY,CAAC,kBAAkB,CAAC;QACpE,IAAI,CAAC,cAAc,GAAG,aAAa,CAAC;QACpC,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,uBAAuB,GAAG,sBAAsB,CAAC;QACtD,IAAI,CAAC,iBAAiB,GAAG,gBAAgB,CAAC;QAC1C,IAAI,CAAC,sBAAsB,GAAG,qBAAqB,CAAC;QACpD,IAAI,CAAC,iBAAiB,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAAC,CAAC;QACnD,IAAI,CAAC,cAAc,GAAG,aAAa,CAAC;QAEpC,IAAI,CAAC,SAAS,CAAC,4BAA4B,CACzC,IAAI,EACJ,yBAAyB,CAC1B,CAAC;IACJ,CAAC;IAED;;;;;;;;;;OAUG;IACH,yBAAyB,CAAC,EACxB,2BAA2B,GAAG,IAAI,CAAC,4BAA4B,EAC/D,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,GAC3C,GAGG,EAAE;QACJ,OAAO;YACL,GAAG,IAAI,CAAC,oBAAoB;YAC5B,GAAG,2BAA2B;YAC9B,GAAG,cAAc;SAClB,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,eAAe;QACb,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;IACtE,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,wBAAwB,CAAC,KAAK,GAAG,KAAK;QAC1C,IAAI,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,EAAE,CAAC;YAC1D,OAAO;QACT,CAAC;QAED,IAAI,UAAU,CAAC;QAEf,IAAI,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAC/B,MAAM,IAAI,CAAC,qBAAqB,CAAC;YACjC,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,IAAI,CAAC,qBAAqB;gBACxB,IAAI,CAAC,uBAAuB,CAAC,uBAAuB,EAAE,CAAC;YAEzD,UAAU,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC;QAChD,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,qBAAqB,GAAG,SAAS,CAAC;QACzC,CAAC;QAED,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;IACzD,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,IAAI;QACR,MAAM,EAAE,qBAAqB,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;QAC7C,MAAM,wBAAwB,GAC5B,qBAAqB,IAAI,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QAEzE,MAAM,QAAQ,GAAG,wBAAwB;YACvC,CAAC,CAAC,MAAM,IAAI,CAAC,0BAA0B,CAAC,qBAAqB,CAAC;YAC9D,CAAC,CAAC,SAAS,CAAC;QAEd,IAAI,CAAC,4BAA4B;YAC/B,QAAQ,EAAE,cAAc,IAAI,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC;QAE5D,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE;YACf,OAAO;gBACL,GAAG,IAAI,CAAC,KAAK;gBACb,kBAAkB,EAAE,IAAI,CAAC,yBAAyB,EAAE;gBACpD,GAAG,CAAC,QAAQ,IAAI;oBACd,cAAc,EAAE,QAAQ,CAAC,cAAc;oBACvC,0BAA0B,EAAE,QAAQ,CAAC,0BAA0B;iBAChE,CAAC;aACH,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,YAAY,CAAC,kBAAgC;QACjD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,0BAA0B,CAAC,kBAAkB,CAAC,CAAC;QAE3E,IAAI,CAAC,4BAA4B,GAAG,QAAQ,CAAC,cAAc,CAAC;QAE5D,wDAAwD;QACxD,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE;YACf,OAAO;gBACL,GAAG,IAAI,CAAC,KAAK;gBACb,kBAAkB,EAAE,IAAI,CAAC,yBAAyB,CAAC;oBACjD,2BAA2B,EAAE,QAAQ,CAAC,cAAc;iBACrD,CAAC;gBACF,qBAAqB,EAAE,kBAAkB;gBACzC,cAAc,EAAE,IAAI,CAAC,GAAG,EAAE;gBAC1B,cAAc,EAAE,QAAQ,CAAC,cAAc;gBACvC,0BAA0B,EAAE,QAAQ,CAAC,0BAA0B;aAChE,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,wBAAwB,CAAC,SAAe;QACtC,IAAI,CAAC,oBAAoB,CAAC,SAAS,CAAC,EAAE,CAAC;YACrC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,cAAc,CAAC,SAAS,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;IACxD,CAAC;IAED;;;;;;;OAOG;IACH,kBAAkB,CAAC,eAAuB;QACxC,IAAI,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC;YAChD,OAAO,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAClC,CAAC;QACD,OAAO,IAAI,CAAC,sBAAsB,EAAE,CAAC;IACvC,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,0BAA0B,CAAC,kBAAgC;QAK/D,MAAM,cAAc,GAAiB,EAAE,CAAC;QACxC,MAAM,aAAa,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC/C,MAAM,qBAAqB,GAA2B,EAAE,CAAC;QACzD,MAAM,0BAA0B,GAA2B,EAAE,CAAC;QAE9D,KAAK,MAAM,CACT,qBAAqB,EACrB,sBAAsB,EACvB,IAAI,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACxC,IAAI,cAAc,GAAG,IAAI,CAAC,wBAAwB,CAChD,sBAAsB,CACvB,CAAC;YACF,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;gBAC5B,SAAS;YACX,CAAC;YAED,IAAI,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;gBAClC,mFAAmF;gBACnF,MAAM,kBAAkB,GAAG,cAAc,CAAC,IAAI,CAC5C,2BAA2B,CAC5B,CAAC;gBAEF,IAAI,CAAC,kBAAkB,EAAE,CAAC;oBACxB,yCAAyC;oBACzC,cAAc,CAAC,qBAAqB,CAAC,GAAG,cAAc,CAAC;oBACvD,SAAS;gBACX,CAAC;gBAED,0EAA0E;gBAC1E,MAAM,uBAAuB,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;gBACnE,MAAM,aAAa,GAAG,uBAAuB;oBAC3C,CAAC,CAAC,mBAAmB,CAAC,cAAc,EAAE,uBAAuB,CAAC;oBAC9D,CAAC,CAAC,SAAS,CAAC;gBAEd,IAAI,aAAa,EAAE,CAAC;oBAClB,cAAc,GAAG,aAAa,CAAC,KAAK,CAAC;oBACrC,IAAI,aAAa,CAAC,IAAI,EAAE,CAAC;wBACvB,0BAA0B,CAAC,qBAAqB,CAAC;4BAC/C,aAAa,CAAC,IAAI,CAAC;oBACvB,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,MAAM,cAAc,GAAG,IAAI,CAAC,kBAAkB,CAAC,qBAAqB,CAAC,CAAC;oBAEtE,IAAI,CAAC,cAAc,EAAE,CAAC;wBACpB,cAAc,CAAC,qBAAqB,CAAC,GAAG,cAAc,CAAC;wBACvD,SAAS;oBACX,CAAC;oBAED,yDAAyD;oBACzD,MAAM,QAAQ,GACZ,GAAG,cAAc,IAAI,qBAAqB,EAAW,CAAC;oBACxD,IAAI,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC,QAAQ,CAAC,CAAC;oBAE3D,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;wBACjC,cAAc,GAAG,MAAM,yBAAyB,CAC9C,cAAc,EACd,qBAAqB,CACtB,CAAC;wBAEF,iDAAiD;wBACjD,qBAAqB,CAAC,QAAQ,CAAC,GAAG,cAAc,CAAC;oBACnD,CAAC;oBAED,MAAM,SAAS,GAAG,cAAc,CAAC;oBACjC,MAAM,aAAa,GAAG,cAAc,CAAC,IAAI,CACvC,CAAC,WAAW,EAAwC,EAAE;wBACpD,IAAI,CAAC,2BAA2B,CAAC,WAAW,CAAC,EAAE,CAAC;4BAC9C,OAAO,KAAK,CAAC;wBACf,CAAC;wBAED,OAAO,SAAS,IAAI,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC;oBAC9C,CAAC,CACF,CAAC;oBAEF,IAAI,aAAa,EAAE,CAAC;wBAClB,cAAc,GAAG,aAAa,CAAC,KAAK,CAAC;wBACrC,IAAI,aAAa,CAAC,IAAI,EAAE,CAAC;4BACvB,0BAA0B,CAAC,qBAAqB,CAAC;gCAC/C,aAAa,CAAC,IAAI,CAAC;wBACvB,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;YAED,cAAc,CAAC,qBAAqB,CAAC,GAAG,cAAc,CAAC;QACzD,CAAC;QAED,MAAM,cAAc,GAAG;YACrB,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc;YAC5B,GAAG,qBAAqB;SACzB,CAAC;QAEF,wEAAwE;QACxE,oDAAoD;QACpD,MAAM,kBAAkB,GAAG,IAAI,CAAC,sBAAsB,EAAE,CAAC;QACzD,MAAM,gBAAgB,GAAG,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACzD,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC;YACnD,MAAM,CAAC,oBAAoB,EAAE,GAAG,mBAAmB,CAAC,GAClD,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACtB,MAAM,cAAc,GAAG,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACrD,IACE,CAAC,oBAAoB,KAAK,aAAa;gBACrC,oBAAoB,KAAK,kBAAkB,CAAC;gBAC9C,CAAC,gBAAgB,CAAC,QAAQ,CAAC,cAAc,CAAC,EAC1C,CAAC;gBACD,OAAO,cAAc,CAAC,QAAQ,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QAED,OAAO;YACL,cAAc;YACd,cAAc;YACd,0BAA0B;SAC3B,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,OAAO;QACL,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;IACxB,CAAC;IAED;;;;;OAKG;IACH,eAAe,CAAC,QAAgB,EAAE,KAAW;QAC3C,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE;YACf,MAAM,cAAc,GAAG;gBACrB,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc;gBAC5B,CAAC,QAAQ,CAAC,EAAE,KAAK;aAClB,CAAC;YAEF,OAAO;gBACL,GAAG,IAAI,CAAC,KAAK;gBACb,cAAc;gBACd,kBAAkB,EAAE,IAAI,CAAC,yBAAyB,CAAC,EAAE,cAAc,EAAE,CAAC;aACvE,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,kBAAkB,CAAC,QAAgB;QACjC,MAAM,iBAAiB,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC;QAC3D,OAAO,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAEnC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE;YACf,OAAO;gBACL,GAAG,IAAI,CAAC,KAAK;gBACb,cAAc,EAAE,iBAAiB;gBACjC,kBAAkB,EAAE,IAAI,CAAC,yBAAyB,CAAC;oBACjD,cAAc,EAAE,iBAAiB;iBAClC,CAAC;aACH,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,qBAAqB;QACnB,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE;YACf,OAAO;gBACL,GAAG,IAAI,CAAC,KAAK;gBACb,cAAc,EAAE,EAAE;gBAClB,kBAAkB,EAAE,IAAI,CAAC,yBAAyB,CAAC;oBACjD,cAAc,EAAE,EAAE;iBACnB,CAAC;aACH,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["import {\n  BaseController,\n  ControllerGetStateAction,\n} from '@metamask/base-controller';\nimport type { ControllerStateChangeEvent } from '@metamask/base-controller';\nimport type { Messenger } from '@metamask/messenger';\nimport { isValidSemVerVersion } from '@metamask/utils';\nimport type { Json, SemVerVersion } from '@metamask/utils';\n\nimport type { AbstractClientConfigApiService } from './client-config-api-service/abstract-client-config-api-service.js';\nimport type { RemoteFeatureFlagControllerMethodActions } from './remote-feature-flag-controller-method-action-types.js';\nimport type {\n  FeatureFlags,\n  ServiceResponse,\n  FeatureFlagScopeValue,\n} from './remote-feature-flag-controller-types.js';\nimport {\n  calculateThresholdForFlag,\n  isFeatureFlagWithScopeValue,\n} from './utils/user-segmentation-utils.js';\nimport { isVersionFeatureFlag, getVersionData } from './utils/version.js';\n\n// === GENERAL ===\n\nexport const controllerName = 'RemoteFeatureFlagController';\nexport const DEFAULT_CACHE_DURATION = 24 * 60 * 60 * 1000; // 1 day\n\n// === STATE ===\n\nexport type RemoteFeatureFlagControllerState = {\n  remoteFeatureFlags: FeatureFlags;\n  localOverrides?: FeatureFlags;\n  rawRemoteFeatureFlags?: FeatureFlags;\n  cacheTimestamp: number;\n  thresholdCache?: Record<string, number>;\n  featureFlagThresholdGroups?: Record<string, string>;\n};\n\nconst remoteFeatureFlagControllerMetadata = {\n  remoteFeatureFlags: {\n    includeInStateLogs: true,\n    persist: true,\n    includeInDebugSnapshot: true,\n    usedInUi: true,\n  },\n  localOverrides: {\n    includeInStateLogs: true,\n    persist: true,\n    includeInDebugSnapshot: true,\n    usedInUi: true,\n  },\n  rawRemoteFeatureFlags: {\n    includeInStateLogs: true,\n    persist: true,\n    includeInDebugSnapshot: true,\n    usedInUi: false,\n  },\n  cacheTimestamp: {\n    includeInStateLogs: true,\n    persist: true,\n    includeInDebugSnapshot: true,\n    usedInUi: false,\n  },\n  thresholdCache: {\n    includeInStateLogs: false,\n    persist: true,\n    includeInDebugSnapshot: false,\n    usedInUi: false,\n  },\n  featureFlagThresholdGroups: {\n    includeInStateLogs: true,\n    persist: true,\n    includeInDebugSnapshot: true,\n    usedInUi: false,\n  },\n};\n\n// === MESSENGER ===\n\nconst MESSENGER_EXPOSED_METHODS = [\n  'clearAllFlagOverrides',\n  'disable',\n  'enable',\n  'removeFlagOverride',\n  'setFlagOverride',\n  'updateRemoteFeatureFlags',\n] as const;\n\nexport type RemoteFeatureFlagControllerGetStateAction =\n  ControllerGetStateAction<\n    typeof controllerName,\n    RemoteFeatureFlagControllerState\n  >;\n\nexport type RemoteFeatureFlagControllerActions =\n  | RemoteFeatureFlagControllerGetStateAction\n  | RemoteFeatureFlagControllerMethodActions;\n\nexport type RemoteFeatureFlagControllerStateChangeEvent =\n  ControllerStateChangeEvent<\n    typeof controllerName,\n    RemoteFeatureFlagControllerState\n  >;\n\nexport type RemoteFeatureFlagControllerEvents =\n  RemoteFeatureFlagControllerStateChangeEvent;\n\nexport type RemoteFeatureFlagControllerMessenger = Messenger<\n  typeof controllerName,\n  RemoteFeatureFlagControllerActions,\n  RemoteFeatureFlagControllerEvents\n>;\n\n/**\n * Returns the default state for the RemoteFeatureFlagController.\n *\n * @returns The default controller state.\n */\nexport function getDefaultRemoteFeatureFlagControllerState(): RemoteFeatureFlagControllerState {\n  return {\n    remoteFeatureFlags: {},\n    localOverrides: {},\n    rawRemoteFeatureFlags: {},\n    cacheTimestamp: 0,\n  };\n}\n\n/**\n * Searches threshold entries for an explicit MetaMetrics ID match.\n * Returns the first entry whose `metaMetricsIds` list contains the given\n * normalized ID. Entries with malformed `metaMetricsIds` (not an array) are\n * skipped without throwing.\n *\n * @param entries - The array of raw threshold entries for a feature flag.\n * @param normalizedId - The current user's MetaMetrics ID, already trimmed and\n * lower-cased.\n * @returns The first matching entry, or `undefined` if none match.\n */\nfunction findExplicitIdMatch(\n  entries: Json[],\n  normalizedId: string,\n): FeatureFlagScopeValue | undefined {\n  for (const entry of entries) {\n    if (!isFeatureFlagWithScopeValue(entry)) {\n      continue;\n    }\n    const { metaMetricsIds } = entry;\n    if (!Array.isArray(metaMetricsIds)) {\n      continue;\n    }\n    const hasMatch = metaMetricsIds.some(\n      (id) =>\n        typeof id === 'string' && id.trim().toLowerCase() === normalizedId,\n    );\n    if (hasMatch) {\n      return entry;\n    }\n  }\n  return undefined;\n}\n\n/**\n * The RemoteFeatureFlagController manages the retrieval and caching of remote feature flags.\n * It fetches feature flags from a remote API, caches them, and provides methods to access\n * and manage these flags. The controller ensures that feature flags are refreshed based on\n * a specified interval and handles cases where the controller is disabled or the network is unavailable.\n */\nexport class RemoteFeatureFlagController extends BaseController<\n  typeof controllerName,\n  RemoteFeatureFlagControllerState,\n  RemoteFeatureFlagControllerMessenger\n> {\n  readonly #fetchInterval: number;\n\n  #disabled: boolean;\n\n  readonly #clientConfigApiService: AbstractClientConfigApiService;\n\n  #inProgressFlagUpdate?: Promise<ServiceResponse>;\n\n  readonly #getMetaMetricsId: () => string;\n\n  readonly #getCanonicalProfileId: () => string;\n\n  readonly #metaMetricsFlags: ReadonlySet<string>;\n\n  readonly #clientVersion: SemVerVersion;\n\n  readonly #defaultFeatureFlags: FeatureFlags;\n\n  #processedRemoteFeatureFlags: FeatureFlags;\n\n  /**\n   * Constructs a new RemoteFeatureFlagController instance.\n   *\n   * @param options - The controller options.\n   * @param options.messenger - The messenger used for communication.\n   * @param options.state - The initial state of the controller.\n   * @param options.clientConfigApiService - The service instance to fetch remote feature flags.\n   * @param options.fetchInterval - The interval in milliseconds before cached flags expire. Defaults to 1 day.\n   * @param options.disabled - Determines if the controller should be disabled initially. Defaults to false.\n   * @param options.getMetaMetricsId - Returns metaMetricsId.\n   * @param options.getCanonicalProfileId - Returns the canonical profile identifier used for threshold flags by default. Must return an empty string, rather than throwing, when the identifier is unavailable.\n   * @param options.metaMetricsFlags - Names of feature flags that should use MetaMetrics ID for threshold assignment.\n   * @param options.clientVersion - The current client version for version-based feature flag filtering. Must be a valid 3-part SemVer version string.\n   * @param options.prevClientVersion - The previous client version for feature flag cache invalidation.\n   * @param options.defaultFeatureFlags - Client-side default feature flags used as the lowest-precedence layer under processed remote flags and local overrides. Not persisted.\n   */\n  constructor({\n    messenger,\n    state,\n    clientConfigApiService,\n    fetchInterval = DEFAULT_CACHE_DURATION,\n    disabled = false,\n    getMetaMetricsId,\n    getCanonicalProfileId,\n    metaMetricsFlags = [],\n    clientVersion,\n    prevClientVersion,\n    defaultFeatureFlags = {},\n  }: {\n    messenger: RemoteFeatureFlagControllerMessenger;\n    state?: Partial<RemoteFeatureFlagControllerState>;\n    clientConfigApiService: AbstractClientConfigApiService;\n    getMetaMetricsId: () => string;\n    getCanonicalProfileId: () => string;\n    metaMetricsFlags?: readonly string[];\n    fetchInterval?: number;\n    disabled?: boolean;\n    clientVersion: string;\n    prevClientVersion?: string;\n    defaultFeatureFlags?: FeatureFlags;\n  }) {\n    if (!isValidSemVerVersion(clientVersion)) {\n      throw new Error(\n        `Invalid clientVersion: \"${clientVersion}\". Must be a valid 3-part SemVer version string`,\n      );\n    }\n\n    const initialState: RemoteFeatureFlagControllerState = {\n      ...getDefaultRemoteFeatureFlagControllerState(),\n      ...state,\n    };\n\n    const hasClientVersionChanged =\n      isValidSemVerVersion(prevClientVersion) &&\n      prevClientVersion !== clientVersion;\n\n    super({\n      name: controllerName,\n      metadata: remoteFeatureFlagControllerMetadata,\n      messenger,\n      state: {\n        ...initialState,\n        cacheTimestamp: hasClientVersionChanged\n          ? 0\n          : initialState.cacheTimestamp,\n      },\n    });\n\n    this.#defaultFeatureFlags = defaultFeatureFlags;\n    // Last session's effective flags stand in for the remote layer until\n    // `init` re-derives it from the persisted raw flags, or a fetch replaces\n    // it. Overrides are layered on top rather than subtracted out, so a remote\n    // flag that happens to share an override's value is not lost.\n    this.#processedRemoteFeatureFlags = initialState.remoteFeatureFlags;\n    this.#fetchInterval = fetchInterval;\n    this.#disabled = disabled;\n    this.#clientConfigApiService = clientConfigApiService;\n    this.#getMetaMetricsId = getMetaMetricsId;\n    this.#getCanonicalProfileId = getCanonicalProfileId;\n    this.#metaMetricsFlags = new Set(metaMetricsFlags);\n    this.#clientVersion = clientVersion;\n\n    this.messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n  }\n\n  /**\n   * Computes effective feature flags with precedence:\n   * defaults < processed remote < local overrides.\n   *\n   * @param options - The layers to merge. Each defaults to the current layer.\n   * @param options.processedRemoteFeatureFlags - The processed remote feature\n   * flags. Defaults to the currently resolved remote layer.\n   * @param options.localOverrides - Local overrides. Defaults to current state\n   * overrides.\n   * @returns The effective feature flags.\n   */\n  #getEffectiveFeatureFlags({\n    processedRemoteFeatureFlags = this.#processedRemoteFeatureFlags,\n    localOverrides = this.state.localOverrides,\n  }: {\n    processedRemoteFeatureFlags?: FeatureFlags;\n    localOverrides?: FeatureFlags;\n  } = {}): FeatureFlags {\n    return {\n      ...this.#defaultFeatureFlags,\n      ...processedRemoteFeatureFlags,\n      ...localOverrides,\n    };\n  }\n\n  /**\n   * Checks if the cached feature flags are expired based on the fetch interval.\n   *\n   * @returns Whether the cache is expired (`true`) or still valid (`false`).\n   */\n  #isCacheExpired(): boolean {\n    return Date.now() - this.state.cacheTimestamp > this.#fetchInterval;\n  }\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   */\n  async updateRemoteFeatureFlags(force = false): Promise<void> {\n    if (this.#disabled || (!force && !this.#isCacheExpired())) {\n      return;\n    }\n\n    let serverData;\n\n    if (this.#inProgressFlagUpdate) {\n      await this.#inProgressFlagUpdate;\n      return;\n    }\n\n    try {\n      this.#inProgressFlagUpdate =\n        this.#clientConfigApiService.fetchRemoteFeatureFlags();\n\n      serverData = await this.#inProgressFlagUpdate;\n    } finally {\n      this.#inProgressFlagUpdate = undefined;\n    }\n\n    await this.#updateCache(serverData.remoteFeatureFlags);\n  }\n\n  /**\n   * Computes the effective feature flags, re-deriving the remote layer from the\n   * raw flags already in state. Threshold selection needs to await a hash and\n   * so cannot run in the constructor, which is why this cannot be part of\n   * construction. Clients must call this once after constructing the\n   * controller.\n   *\n   * When there are no persisted raw flags, as on a fresh install or for state\n   * persisted before raw flags were stored, the previous session's flags stand\n   * in for the remote layer so that nothing is lost.\n   */\n  async init(): Promise<void> {\n    const { rawRemoteFeatureFlags } = this.state;\n    const hasRawRemoteFeatureFlags =\n      rawRemoteFeatureFlags && Object.keys(rawRemoteFeatureFlags).length > 0;\n\n    const resolved = hasRawRemoteFeatureFlags\n      ? await this.#processRemoteFeatureFlags(rawRemoteFeatureFlags)\n      : undefined;\n\n    this.#processedRemoteFeatureFlags =\n      resolved?.processedFlags ?? this.state.remoteFeatureFlags;\n\n    this.update(() => {\n      return {\n        ...this.state,\n        remoteFeatureFlags: this.#getEffectiveFeatureFlags(),\n        ...(resolved && {\n          thresholdCache: resolved.thresholdCache,\n          featureFlagThresholdGroups: resolved.featureFlagThresholdGroups,\n        }),\n      };\n    });\n  }\n\n  /**\n   * Updates the controller's state with new feature flags and resets the cache timestamp.\n   *\n   * @param remoteFeatureFlags - The new feature flags to cache.\n   */\n  async #updateCache(remoteFeatureFlags: FeatureFlags): Promise<void> {\n    const resolved = await this.#processRemoteFeatureFlags(remoteFeatureFlags);\n\n    this.#processedRemoteFeatureFlags = resolved.processedFlags;\n\n    // Single state update with all changes batched together\n    this.update(() => {\n      return {\n        ...this.state,\n        remoteFeatureFlags: this.#getEffectiveFeatureFlags({\n          processedRemoteFeatureFlags: resolved.processedFlags,\n        }),\n        rawRemoteFeatureFlags: remoteFeatureFlags,\n        cacheTimestamp: Date.now(),\n        thresholdCache: resolved.thresholdCache,\n        featureFlagThresholdGroups: resolved.featureFlagThresholdGroups,\n      };\n    });\n  }\n\n  /**\n   * Processes a version-based feature flag to get the appropriate value for the current client version.\n   *\n   * @param flagValue - The feature flag value to process\n   * @returns The processed value, or null if no version qualifies (skip this flag)\n   */\n  #processVersionBasedFlag(flagValue: Json): Json | null {\n    if (!isVersionFeatureFlag(flagValue)) {\n      return flagValue;\n    }\n\n    return getVersionData(flagValue, this.#clientVersion);\n  }\n\n  /**\n   * Selects the identifier used to bucket a threshold flag. Flags named in\n   * `metaMetricsFlags` segment by MetaMetrics ID; all others segment by\n   * canonical profile ID.\n   *\n   * @param featureFlagName - The name of the feature flag being processed.\n   * @returns The segmentation identifier, which may be empty when unavailable.\n   */\n  #getSegmentationId(featureFlagName: string): string {\n    if (this.#metaMetricsFlags.has(featureFlagName)) {\n      return this.#getMetaMetricsId();\n    }\n    return this.#getCanonicalProfileId();\n  }\n\n  /**\n   * Resolves raw feature flags into the values that apply to this client and\n   * user, selecting version and threshold entries and reconciling the\n   * threshold cache against the flags the server currently serves.\n   *\n   * @param remoteFeatureFlags - The unprocessed feature flags.\n   * @returns The processed flags, the updated threshold cache, and the\n   * selected threshold group names.\n   */\n  async #processRemoteFeatureFlags(remoteFeatureFlags: FeatureFlags): Promise<{\n    processedFlags: FeatureFlags;\n    thresholdCache: Record<string, number>;\n    featureFlagThresholdGroups: Record<string, string>;\n  }> {\n    const processedFlags: FeatureFlags = {};\n    const metaMetricsId = this.#getMetaMetricsId();\n    const thresholdCacheUpdates: Record<string, number> = {};\n    const featureFlagThresholdGroups: Record<string, string> = {};\n\n    for (const [\n      remoteFeatureFlagName,\n      remoteFeatureFlagValue,\n    ] of Object.entries(remoteFeatureFlags)) {\n      let processedValue = this.#processVersionBasedFlag(\n        remoteFeatureFlagValue,\n      );\n      if (processedValue === null) {\n        continue;\n      }\n\n      if (Array.isArray(processedValue)) {\n        // Validate array has valid threshold items before doing expensive crypto operation\n        const hasValidThresholds = processedValue.some(\n          isFeatureFlagWithScopeValue,\n        );\n\n        if (!hasValidThresholds) {\n          // Not a threshold array - preserve as-is\n          processedFlags[remoteFeatureFlagName] = processedValue;\n          continue;\n        }\n\n        // Explicit-ID matching: check before hash-based threshold, bypasses cache\n        const normalizedMetaMetricsId = metaMetricsId.trim().toLowerCase();\n        const explicitMatch = normalizedMetaMetricsId\n          ? findExplicitIdMatch(processedValue, normalizedMetaMetricsId)\n          : undefined;\n\n        if (explicitMatch) {\n          processedValue = explicitMatch.value;\n          if (explicitMatch.name) {\n            featureFlagThresholdGroups[remoteFeatureFlagName] =\n              explicitMatch.name;\n          }\n        } else {\n          const segmentationId = this.#getSegmentationId(remoteFeatureFlagName);\n\n          if (!segmentationId) {\n            processedFlags[remoteFeatureFlagName] = processedValue;\n            continue;\n          }\n\n          // Fall back to hash-based threshold selection with cache\n          const cacheKey =\n            `${segmentationId}:${remoteFeatureFlagName}` as const;\n          let thresholdValue = this.state.thresholdCache?.[cacheKey];\n\n          if (thresholdValue === undefined) {\n            thresholdValue = await calculateThresholdForFlag(\n              segmentationId,\n              remoteFeatureFlagName,\n            );\n\n            // Collect new threshold for batched state update\n            thresholdCacheUpdates[cacheKey] = thresholdValue;\n          }\n\n          const threshold = thresholdValue;\n          const selectedGroup = processedValue.find(\n            (featureFlag): featureFlag is FeatureFlagScopeValue => {\n              if (!isFeatureFlagWithScopeValue(featureFlag)) {\n                return false;\n              }\n\n              return threshold <= featureFlag.scope.value;\n            },\n          );\n\n          if (selectedGroup) {\n            processedValue = selectedGroup.value;\n            if (selectedGroup.name) {\n              featureFlagThresholdGroups[remoteFeatureFlagName] =\n                selectedGroup.name;\n            }\n          }\n        }\n      }\n\n      processedFlags[remoteFeatureFlagName] = processedValue;\n    }\n\n    const thresholdCache = {\n      ...this.state.thresholdCache,\n      ...thresholdCacheUpdates,\n    };\n\n    // Drop cached thresholds for flags this user is no longer served, under\n    // either identifier they may have been bucketed by.\n    const canonicalProfileId = this.#getCanonicalProfileId();\n    const currentFlagNames = Object.keys(remoteFeatureFlags);\n    for (const cacheKey of Object.keys(thresholdCache)) {\n      const [cachedSegmentationId, ...cachedFlagNameParts] =\n        cacheKey.split(':');\n      const cachedFlagName = cachedFlagNameParts.join(':');\n      if (\n        (cachedSegmentationId === metaMetricsId ||\n          cachedSegmentationId === canonicalProfileId) &&\n        !currentFlagNames.includes(cachedFlagName)\n      ) {\n        delete thresholdCache[cacheKey];\n      }\n    }\n\n    return {\n      processedFlags,\n      thresholdCache,\n      featureFlagThresholdGroups,\n    };\n  }\n\n  /**\n   * Enables the controller, allowing it to make network requests.\n   */\n  enable(): void {\n    this.#disabled = false;\n  }\n\n  /**\n   * Disables the controller, preventing it from making network requests.\n   */\n  disable(): void {\n    this.#disabled = true;\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   */\n  setFlagOverride(flagName: string, value: Json): void {\n    this.update(() => {\n      const localOverrides = {\n        ...this.state.localOverrides,\n        [flagName]: value,\n      };\n\n      return {\n        ...this.state,\n        localOverrides,\n        remoteFeatureFlags: this.#getEffectiveFeatureFlags({ localOverrides }),\n      };\n    });\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   */\n  removeFlagOverride(flagName: string): void {\n    const newLocalOverrides = { ...this.state.localOverrides };\n    delete newLocalOverrides[flagName];\n\n    this.update(() => {\n      return {\n        ...this.state,\n        localOverrides: newLocalOverrides,\n        remoteFeatureFlags: this.#getEffectiveFeatureFlags({\n          localOverrides: newLocalOverrides,\n        }),\n      };\n    });\n  }\n\n  /**\n   * Clears all local feature flag overrides.\n   */\n  clearAllFlagOverrides(): void {\n    this.update(() => {\n      return {\n        ...this.state,\n        localOverrides: {},\n        remoteFeatureFlags: this.#getEffectiveFeatureFlags({\n          localOverrides: {},\n        }),\n      };\n    });\n  }\n}\n"]}

package/dist/utils/user-segmentation-utils.js

@@ -40,7 +40,7 @@ export async function calculateThresholdForFlag(segmentationId, featureFlagName)
     const hashBigInt = BigInt(hash);
     const maxValue = BigInt(`0x${'f'.repeat(64)}`);
     // Use BigInt division first, then convert to number to maintain precision
-    return Number((hashBigInt * BigInt(1000000)) / maxValue) / 1000000;
+    return Number((hashBigInt * BigInt(1_000_000)) / maxValue) / 1_000_000;
 }
 /**
  * Generates a deterministic random number between 0 and 1 based on a metaMetricsId.
@@ -84,7 +84,7 @@ export function generateDeterministicRandomNumber(metaMetricsId) {
         maxValue = BigInt(`0x${'f'.repeat(cleanId.length)}`);
     }
     // Use BigInt division first, then convert to number to maintain precision
-    return Number((idValue * BigInt(1000000)) / maxValue) / 1000000;
+    return Number((idValue * BigInt(1_000_000)) / maxValue) / 1_000_000;
 }
 /**
  * Type guard to check if a value is a feature flag with scope.

package/dist/utils/user-segmentation-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"user-segmentation-utils.js","sourceRoot":"","sources":["../../src/utils/user-segmentation-utils.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Json } from '@metamask/utils';\nimport { sha256, bytesToHex } from '@metamask/utils';\nimport { validate as uuidValidate, version as uuidVersion } from 'uuid';\n\nimport type { FeatureFlagScopeValue } from '../remote-feature-flag-controller-types.js';\n\n/**\n * Converts a UUID string to a BigInt by removing dashes and converting to hexadecimal.\n *\n * @param uuid - The UUID string to convert\n * @returns The UUID as a BigInt value\n */\nfunction uuidStringToBigInt(uuid: string): bigint {\n  return BigInt(`0x${uuid.replace(/-/gu, '')}`);\n}\n\nconst MIN_UUID_V4 = '00000000-0000-4000-8000-000000000000';\nconst MAX_UUID_V4 = 'ffffffff-ffff-4fff-bfff-ffffffffffff';\nconst MIN_UUID_V4_BIGINT = uuidStringToBigInt(MIN_UUID_V4);\nconst MAX_UUID_V4_BIGINT = uuidStringToBigInt(MAX_UUID_V4);\nconst UUID_V4_VALUE_RANGE_BIGINT = MAX_UUID_V4_BIGINT - MIN_UUID_V4_BIGINT;\n\n/**\n * Calculates a deterministic threshold value between 0 and 1 for A/B testing.\n * This function hashes the segmentation ID combined with the feature flag name\n * to ensure consistent group assignment across sessions while varying across different flags.\n *\n * @param segmentationId - The identifier used for threshold segmentation (must be non-empty)\n * @param featureFlagName - The feature flag name to create unique threshold per flag\n * @returns A promise that resolves to a number between 0 and 1\n * @throws Error if segmentationId is empty\n */\nexport async function calculateThresholdForFlag(\n  segmentationId: string,\n  featureFlagName: string,\n): Promise<number> {\n  if (!segmentationId) {\n    throw new Error('Segmentation ID cannot be empty');\n  }\n\n  if (!featureFlagName) {\n    throw new Error('Feature flag name cannot be empty');\n  }\n\n  const seed = segmentationId + featureFlagName;\n\n  // Hash the combined seed\n  const encoder = new TextEncoder();\n  const hashBuffer = await sha256(encoder.encode(seed));\n\n  // Convert hash bytes directly to 0-1 range\n  const hash = bytesToHex(hashBuffer);\n  const hashBigInt = BigInt(hash);\n  const maxValue = BigInt(`0x${'f'.repeat(64)}`);\n\n  // Use BigInt division first, then convert to number to maintain precision\n  return Number((hashBigInt * BigInt(1_000_000)) / maxValue) / 1_000_000;\n}\n\n/**\n * Generates a deterministic random number between 0 and 1 based on a metaMetricsId.\n * This is useful for A/B testing and feature flag rollouts where we want\n * consistent group assignment for the same user.\n *\n * @param metaMetricsId - The unique identifier used to generate the deterministic random number. Must be either:\n * - A UUIDv4 string (e.g., '123e4567-e89b-12d3-a456-426614174000'\n * - A hex string with '0x' prefix (e.g., '0x86bacb9b2bf9a7e8d2b147eadb95ac9aaa26842327cd24afc8bd4b3c1d136420')\n * @returns A number between 0 and 1, deterministically generated from the input ID.\n * The same input will always produce the same output.\n */\nexport function generateDeterministicRandomNumber(\n  metaMetricsId: string,\n): number {\n  if (!metaMetricsId) {\n    throw new Error('MetaMetrics ID cannot be empty');\n  }\n\n  let idValue: bigint;\n  let maxValue: bigint;\n\n  // uuidv4 format\n  if (uuidValidate(metaMetricsId)) {\n    if (uuidVersion(metaMetricsId) !== 4) {\n      throw new Error(\n        `Invalid UUID version. Expected v4, got v${uuidVersion(metaMetricsId)}`,\n      );\n    }\n    idValue = uuidStringToBigInt(metaMetricsId) - MIN_UUID_V4_BIGINT;\n    maxValue = UUID_V4_VALUE_RANGE_BIGINT;\n  } else {\n    // hex format with 0x prefix\n    if (!metaMetricsId.startsWith('0x')) {\n      throw new Error('Hex ID must start with 0x prefix');\n    }\n\n    const cleanId = metaMetricsId.slice(2);\n    const EXPECTED_HEX_LENGTH = 64; // 32 bytes = 64 hex characters\n\n    if (cleanId.length !== EXPECTED_HEX_LENGTH) {\n      throw new Error(\n        `Invalid hex ID length. Expected ${EXPECTED_HEX_LENGTH} characters, got ${cleanId.length}`,\n      );\n    }\n\n    if (!/^[0-9a-f]+$/iu.test(cleanId)) {\n      throw new Error('Hex ID contains invalid characters');\n    }\n\n    idValue = BigInt(`0x${cleanId}`);\n    maxValue = BigInt(`0x${'f'.repeat(cleanId.length)}`);\n  }\n\n  // Use BigInt division first, then convert to number to maintain precision\n  return Number((idValue * BigInt(1_000_000)) / maxValue) / 1_000_000;\n}\n\n/**\n * Type guard to check if a value is a feature flag with scope.\n * Used to validate feature flag objects that contain scope-based configurations.\n *\n * @param featureFlag - The value to check if it's a feature flag with scope\n * @returns True if the value is a feature flag with scope, false otherwise\n */\nexport const isFeatureFlagWithScopeValue = (\n  featureFlag: Json,\n): featureFlag is FeatureFlagScopeValue => {\n  return (\n    typeof featureFlag === 'object' &&\n    featureFlag !== null &&\n    'scope' in featureFlag\n  );\n};\n"]}
+{"version":3,"file":"user-segmentation-utils.js","sourceRoot":"","sources":["../../src/utils/user-segmentation-utils.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Json } from '@metamask/utils';\nimport { sha256, bytesToHex } from '@metamask/utils';\nimport { validate as uuidValidate, version as uuidVersion } from 'uuid';\n\nimport type { FeatureFlagScopeValue } from '../remote-feature-flag-controller-types.js';\n\n/**\n * Converts a UUID string to a BigInt by removing dashes and converting to hexadecimal.\n *\n * @param uuid - The UUID string to convert\n * @returns The UUID as a BigInt value\n */\nfunction uuidStringToBigInt(uuid: string): bigint {\n  return BigInt(`0x${uuid.replace(/-/gu, '')}`);\n}\n\nconst MIN_UUID_V4 = '00000000-0000-4000-8000-000000000000';\nconst MAX_UUID_V4 = 'ffffffff-ffff-4fff-bfff-ffffffffffff';\nconst MIN_UUID_V4_BIGINT = uuidStringToBigInt(MIN_UUID_V4);\nconst MAX_UUID_V4_BIGINT = uuidStringToBigInt(MAX_UUID_V4);\nconst UUID_V4_VALUE_RANGE_BIGINT = MAX_UUID_V4_BIGINT - MIN_UUID_V4_BIGINT;\n\n/**\n * Calculates a deterministic threshold value between 0 and 1 for A/B testing.\n * This function hashes the segmentation ID combined with the feature flag name\n * to ensure consistent group assignment across sessions while varying across different flags.\n *\n * @param segmentationId - The identifier used for threshold segmentation (must be non-empty)\n * @param featureFlagName - The feature flag name to create unique threshold per flag\n * @returns A promise that resolves to a number between 0 and 1\n * @throws Error if segmentationId is empty\n */\nexport async function calculateThresholdForFlag(\n  segmentationId: string,\n  featureFlagName: string,\n): Promise<number> {\n  if (!segmentationId) {\n    throw new Error('Segmentation ID cannot be empty');\n  }\n\n  if (!featureFlagName) {\n    throw new Error('Feature flag name cannot be empty');\n  }\n\n  const seed = segmentationId + featureFlagName;\n\n  // Hash the combined seed\n  const encoder = new TextEncoder();\n  const hashBuffer = await sha256(encoder.encode(seed));\n\n  // Convert hash bytes directly to 0-1 range\n  const hash = bytesToHex(hashBuffer);\n  const hashBigInt = BigInt(hash);\n  const maxValue = BigInt(`0x${'f'.repeat(64)}`);\n\n  // Use BigInt division first, then convert to number to maintain precision\n  return Number((hashBigInt * BigInt(1_000_000)) / maxValue) / 1_000_000;\n}\n\n/**\n * Generates a deterministic random number between 0 and 1 based on a metaMetricsId.\n * This is useful for A/B testing and feature flag rollouts where we want\n * consistent group assignment for the same user.\n *\n * @param metaMetricsId - The unique identifier used to generate the deterministic random number. Must be either:\n * - A UUIDv4 string (e.g., '123e4567-e89b-12d3-a456-426614174000'\n * - A hex string with '0x' prefix (e.g., '0x86bacb9b2bf9a7e8d2b147eadb95ac9aaa26842327cd24afc8bd4b3c1d136420')\n * @returns A number between 0 and 1, deterministically generated from the input ID.\n * The same input will always produce the same output.\n */\nexport function generateDeterministicRandomNumber(\n  metaMetricsId: string,\n): number {\n  if (!metaMetricsId) {\n    throw new Error('MetaMetrics ID cannot be empty');\n  }\n\n  let idValue: bigint;\n  let maxValue: bigint;\n\n  // uuidv4 format\n  if (uuidValidate(metaMetricsId)) {\n    if (uuidVersion(metaMetricsId) !== 4) {\n      throw new Error(\n        `Invalid UUID version. Expected v4, got v${uuidVersion(metaMetricsId)}`,\n      );\n    }\n    idValue = uuidStringToBigInt(metaMetricsId) - MIN_UUID_V4_BIGINT;\n    maxValue = UUID_V4_VALUE_RANGE_BIGINT;\n  } else {\n    // hex format with 0x prefix\n    if (!metaMetricsId.startsWith('0x')) {\n      throw new Error('Hex ID must start with 0x prefix');\n    }\n\n    const cleanId = metaMetricsId.slice(2);\n    const EXPECTED_HEX_LENGTH = 64; // 32 bytes = 64 hex characters\n\n    if (cleanId.length !== EXPECTED_HEX_LENGTH) {\n      throw new Error(\n        `Invalid hex ID length. Expected ${EXPECTED_HEX_LENGTH} characters, got ${cleanId.length}`,\n      );\n    }\n\n    if (!/^[0-9a-f]+$/iu.test(cleanId)) {\n      throw new Error('Hex ID contains invalid characters');\n    }\n\n    idValue = BigInt(`0x${cleanId}`);\n    maxValue = BigInt(`0x${'f'.repeat(cleanId.length)}`);\n  }\n\n  // Use BigInt division first, then convert to number to maintain precision\n  return Number((idValue * BigInt(1_000_000)) / maxValue) / 1_000_000;\n}\n\n/**\n * Type guard to check if a value is a feature flag with scope.\n * Used to validate feature flag objects that contain scope-based configurations.\n *\n * @param featureFlag - The value to check if it's a feature flag with scope\n * @returns True if the value is a feature flag with scope, false otherwise\n */\nexport const isFeatureFlagWithScopeValue = (\n  featureFlag: Json,\n): featureFlag is FeatureFlagScopeValue => {\n  return (\n    typeof featureFlag === 'object' &&\n    featureFlag !== null &&\n    'scope' in featureFlag\n  );\n};\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask-previews/remote-feature-flag-controller",
-  "version": "6.1.0-preview-4f4c98e",
+  "version": "6.1.0-preview-3866c0ff1",
   "description": "The RemoteFeatureFlagController manages the retrieval and caching of remote feature flags",
   "keywords": [
     "Ethereum",