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

package/dist/remote-feature-flag-controller.cjs

@@ -1,436 +0,0 @@
-"use strict";
-var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
-    if (kind === "m") throw new TypeError("Private method is not writable");
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
-    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
-};
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var _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;
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RemoteFeatureFlagController = exports.getDefaultRemoteFeatureFlagControllerState = exports.DEFAULT_CACHE_DURATION = exports.controllerName = void 0;
-const base_controller_1 = require("@metamask/base-controller");
-const utils_1 = require("@metamask/utils");
-const user_segmentation_utils_js_1 = require("./utils/user-segmentation-utils.cjs");
-const version_js_1 = require("./utils/version.cjs");
-// === GENERAL ===
-exports.controllerName = 'RemoteFeatureFlagController';
-exports.DEFAULT_CACHE_DURATION = 24 * 60 * 60 * 1000; // 1 day
-const remoteFeatureFlagControllerMetadata = {
-    remoteFeatureFlags: {
-        includeInStateLogs: true,
-        persist: true,
-        includeInDebugSnapshot: true,
-        usedInUi: true,
-    },
-    localOverrides: {
-        includeInStateLogs: true,
-        persist: true,
-        includeInDebugSnapshot: true,
-        usedInUi: true,
-    },
-    rawRemoteFeatureFlags: {
-        includeInStateLogs: true,
-        persist: true,
-        includeInDebugSnapshot: true,
-        usedInUi: false,
-    },
-    cacheTimestamp: {
-        includeInStateLogs: true,
-        persist: true,
-        includeInDebugSnapshot: true,
-        usedInUi: false,
-    },
-    thresholdCache: {
-        includeInStateLogs: false,
-        persist: true,
-        includeInDebugSnapshot: false,
-        usedInUi: false,
-    },
-    featureFlagThresholdGroups: {
-        includeInStateLogs: true,
-        persist: true,
-        includeInDebugSnapshot: true,
-        usedInUi: false,
-    },
-};
-// === MESSENGER ===
-const MESSENGER_EXPOSED_METHODS = [
-    'clearAllFlagOverrides',
-    'disable',
-    'enable',
-    'removeFlagOverride',
-    'setFlagOverride',
-    'updateRemoteFeatureFlags',
-];
-/**
- * Returns the default state for the RemoteFeatureFlagController.
- *
- * @returns The default controller state.
- */
-function getDefaultRemoteFeatureFlagControllerState() {
-    return {
-        remoteFeatureFlags: {},
-        localOverrides: {},
-        rawRemoteFeatureFlags: {},
-        cacheTimestamp: 0,
-    };
-}
-exports.getDefaultRemoteFeatureFlagControllerState = getDefaultRemoteFeatureFlagControllerState;
-/**
- * Searches threshold entries for an explicit MetaMetrics ID match.
- * Returns the first entry whose `metaMetricsIds` list contains the given
- * normalized ID. Entries with malformed `metaMetricsIds` (not an array) are
- * skipped without throwing.
- *
- * @param entries - The array of raw threshold entries for a feature flag.
- * @param normalizedId - The current user's MetaMetrics ID, already trimmed and
- * lower-cased.
- * @returns The first matching entry, or `undefined` if none match.
- */
-function findExplicitIdMatch(entries, normalizedId) {
-    for (const entry of entries) {
-        if (!(0, user_segmentation_utils_js_1.isFeatureFlagWithScopeValue)(entry)) {
-            continue;
-        }
-        const { metaMetricsIds } = entry;
-        if (!Array.isArray(metaMetricsIds)) {
-            continue;
-        }
-        const hasMatch = metaMetricsIds.some((id) => typeof id === 'string' && id.trim().toLowerCase() === normalizedId);
-        if (hasMatch) {
-            return entry;
-        }
-    }
-    return undefined;
-}
-/**
- * The RemoteFeatureFlagController manages the retrieval and caching of remote feature flags.
- * It fetches feature flags from a remote API, caches them, and provides methods to access
- * and manage these flags. The controller ensures that feature flags are refreshed based on
- * a specified interval and handles cases where the controller is disabled or the network is unavailable.
- */
-class RemoteFeatureFlagController extends base_controller_1.BaseController {
-    /**
-     * Constructs a new RemoteFeatureFlagController instance.
-     *
-     * @param options - The controller options.
-     * @param options.messenger - The messenger used for communication.
-     * @param options.state - The initial state of the controller.
-     * @param options.clientConfigApiService - The service instance to fetch remote feature flags.
-     * @param options.fetchInterval - The interval in milliseconds before cached flags expire. Defaults to 1 day.
-     * @param options.disabled - Determines if the controller should be disabled initially. Defaults to false.
-     * @param options.getMetaMetricsId - Returns metaMetricsId.
-     * @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.
-     * @param options.metaMetricsFlags - Names of feature flags that should use MetaMetrics ID for threshold assignment.
-     * @param options.clientVersion - The current client version for version-based feature flag filtering. Must be a valid 3-part SemVer version string.
-     * @param options.prevClientVersion - The previous client version for feature flag cache invalidation.
-     * @param options.defaultFeatureFlags - Client-side default feature flags used as the lowest-precedence layer under processed remote flags and local overrides. Not persisted.
-     */
-    constructor({ messenger, state, clientConfigApiService, fetchInterval = exports.DEFAULT_CACHE_DURATION, disabled = false, getMetaMetricsId, getCanonicalProfileId, metaMetricsFlags = [], clientVersion, prevClientVersion, defaultFeatureFlags = {}, }) {
-        if (!(0, utils_1.isValidSemVerVersion)(clientVersion)) {
-            throw new Error(`Invalid clientVersion: "${clientVersion}". Must be a valid 3-part SemVer version string`);
-        }
-        const initialState = {
-            ...getDefaultRemoteFeatureFlagControllerState(),
-            ...state,
-        };
-        const hasClientVersionChanged = (0, utils_1.isValidSemVerVersion)(prevClientVersion) &&
-            prevClientVersion !== clientVersion;
-        super({
-            name: exports.controllerName,
-            metadata: remoteFeatureFlagControllerMetadata,
-            messenger,
-            state: {
-                ...initialState,
-                cacheTimestamp: hasClientVersionChanged
-                    ? 0
-                    : 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");
-        // 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.messenger.registerMethodActionHandlers(this, MESSENGER_EXPOSED_METHODS);
-    }
-    /**
-     * Retrieves the remote feature flags, fetching from the API if necessary.
-     * Uses caching to prevent redundant API calls and handles concurrent fetches.
-     *
-     * @param force - When `true`, fetch even if the cache has not expired.
-     * Defaults to `false`. Has no effect when the controller is disabled.
-     * @returns A promise that resolves to the current set of feature flags.
-     */
-    async updateRemoteFeatureFlags(force = false) {
-        if (__classPrivateFieldGet(this, _RemoteFeatureFlagController_disabled, "f") || (!force && !__classPrivateFieldGet(this, _RemoteFeatureFlagController_instances, "m", _RemoteFeatureFlagController_isCacheExpired).call(this))) {
-            return;
-        }
-        let serverData;
-        if (__classPrivateFieldGet(this, _RemoteFeatureFlagController_inProgressFlagUpdate, "f")) {
-            await __classPrivateFieldGet(this, _RemoteFeatureFlagController_inProgressFlagUpdate, "f");
-            return;
-        }
-        try {
-            __classPrivateFieldSet(this, _RemoteFeatureFlagController_inProgressFlagUpdate, __classPrivateFieldGet(this, _RemoteFeatureFlagController_clientConfigApiService, "f").fetchRemoteFeatureFlags(), "f");
-            serverData = await __classPrivateFieldGet(this, _RemoteFeatureFlagController_inProgressFlagUpdate, "f");
-        }
-        finally {
-            __classPrivateFieldSet(this, _RemoteFeatureFlagController_inProgressFlagUpdate, undefined, "f");
-        }
-        await __classPrivateFieldGet(this, _RemoteFeatureFlagController_instances, "m", _RemoteFeatureFlagController_updateCache).call(this, serverData.remoteFeatureFlags);
-    }
-    /**
-     * Computes the effective feature flags, re-deriving the remote layer from the
-     * raw flags already in state. Threshold selection needs to await a hash and
-     * so cannot run in the constructor, which is why this cannot be part of
-     * construction. Clients must call this once after constructing the
-     * controller.
-     *
-     * When there are no persisted raw flags, as on a fresh install or for state
-     * persisted before raw flags were stored, the previous session's flags stand
-     * in for the remote layer so that nothing is lost.
-     */
-    async init() {
-        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)
-            : undefined;
-        __classPrivateFieldSet(this, _RemoteFeatureFlagController_processedRemoteFeatureFlags, resolved?.processedFlags ?? this.state.remoteFeatureFlags, "f");
-        this.update(() => {
-            return {
-                ...this.state,
-                remoteFeatureFlags: __classPrivateFieldGet(this, _RemoteFeatureFlagController_instances, "m", _RemoteFeatureFlagController_getEffectiveFeatureFlags).call(this),
-                ...(resolved && {
-                    thresholdCache: resolved.thresholdCache,
-                    featureFlagThresholdGroups: resolved.featureFlagThresholdGroups,
-                }),
-            };
-        });
-    }
-    /**
-     * Enables the controller, allowing it to make network requests.
-     */
-    enable() {
-        __classPrivateFieldSet(this, _RemoteFeatureFlagController_disabled, false, "f");
-    }
-    /**
-     * Disables the controller, preventing it from making network requests.
-     */
-    disable() {
-        __classPrivateFieldSet(this, _RemoteFeatureFlagController_disabled, true, "f");
-    }
-    /**
-     * Sets a local override for a specific feature flag.
-     *
-     * @param flagName - The name of the feature flag to override.
-     * @param value - The override value for the feature flag.
-     */
-    setFlagOverride(flagName, value) {
-        this.update(() => {
-            const localOverrides = {
-                ...this.state.localOverrides,
-                [flagName]: value,
-            };
-            return {
-                ...this.state,
-                localOverrides,
-                remoteFeatureFlags: __classPrivateFieldGet(this, _RemoteFeatureFlagController_instances, "m", _RemoteFeatureFlagController_getEffectiveFeatureFlags).call(this, { localOverrides }),
-            };
-        });
-    }
-    /**
-     * Clears the local override for a specific feature flag.
-     *
-     * @param flagName - The name of the feature flag to clear.
-     */
-    removeFlagOverride(flagName) {
-        const newLocalOverrides = { ...this.state.localOverrides };
-        delete newLocalOverrides[flagName];
-        this.update(() => {
-            return {
-                ...this.state,
-                localOverrides: newLocalOverrides,
-                remoteFeatureFlags: __classPrivateFieldGet(this, _RemoteFeatureFlagController_instances, "m", _RemoteFeatureFlagController_getEffectiveFeatureFlags).call(this, {
-                    localOverrides: newLocalOverrides,
-                }),
-            };
-        });
-    }
-    /**
-     * Clears all local feature flag overrides.
-     */
-    clearAllFlagOverrides() {
-        this.update(() => {
-            return {
-                ...this.state,
-                localOverrides: {},
-                remoteFeatureFlags: __classPrivateFieldGet(this, _RemoteFeatureFlagController_instances, "m", _RemoteFeatureFlagController_getEffectiveFeatureFlags).call(this, {
-                    localOverrides: {},
-                }),
-            };
-        });
-    }
-}
-exports.RemoteFeatureFlagController = RemoteFeatureFlagController;
-_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 (!(0, version_js_1.isVersionFeatureFlag)(flagValue)) {
-        return flagValue;
-    }
-    return (0, version_js_1.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(user_segmentation_utils_js_1.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 (0, user_segmentation_utils_js_1.calculateThresholdForFlag)(segmentationId, remoteFeatureFlagName);
-                    // Collect new threshold for batched state update
-                    thresholdCacheUpdates[cacheKey] = thresholdValue;
-                }
-                const threshold = thresholdValue;
-                const selectedGroup = processedValue.find((featureFlag) => {
-                    if (!(0, user_segmentation_utils_js_1.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.cjs.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"remote-feature-flag-controller.cjs","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"]}

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

@@ -1 +0,0 @@
-{"version":3,"file":"remote-feature-flag-controller.d.cts","sourceRoot":"","sources":["../src/remote-feature-flag-controller.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,wBAAwB,EACzB,kCAAkC;AACnC,OAAO,KAAK,EAAE,0BAA0B,EAAE,kCAAkC;AAC5E,OAAO,KAAK,EAAE,SAAS,EAAE,4BAA4B;AAErD,OAAO,KAAK,EAAE,IAAI,EAAiB,wBAAwB;AAE3D,OAAO,KAAK,EAAE,8BAA8B,EAAE,2EAA0E;AACxH,OAAO,KAAK,EAAE,wCAAwC,EAAE,iEAAgE;AACxH,OAAO,KAAK,EACV,YAAY,EAGb,mDAAkD;AASnD,eAAO,MAAM,cAAc,gCAAgC,CAAC;AAC5D,eAAO,MAAM,sBAAsB,QAAsB,CAAC;AAI1D,MAAM,MAAM,gCAAgC,GAAG;IAC7C,kBAAkB,EAAE,YAAY,CAAC;IACjC,cAAc,CAAC,EAAE,YAAY,CAAC;IAC9B,qBAAqB,CAAC,EAAE,YAAY,CAAC;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,0BAA0B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrD,CAAC;AAoDF,MAAM,MAAM,yCAAyC,GACnD,wBAAwB,CACtB,OAAO,cAAc,EACrB,gCAAgC,CACjC,CAAC;AAEJ,MAAM,MAAM,kCAAkC,GAC1C,yCAAyC,GACzC,wCAAwC,CAAC;AAE7C,MAAM,MAAM,2CAA2C,GACrD,0BAA0B,CACxB,OAAO,cAAc,EACrB,gCAAgC,CACjC,CAAC;AAEJ,MAAM,MAAM,iCAAiC,GAC3C,2CAA2C,CAAC;AAE9C,MAAM,MAAM,oCAAoC,GAAG,SAAS,CAC1D,OAAO,cAAc,EACrB,kCAAkC,EAClC,iCAAiC,CAClC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,0CAA0C,IAAI,gCAAgC,CAO7F;AAoCD;;;;;GAKG;AACH,qBAAa,2BAA4B,SAAQ,cAAc,CAC7D,OAAO,cAAc,EACrB,gCAAgC,EAChC,oCAAoC,CACrC;;IAqBC;;;;;;;;;;;;;;;OAeG;gBACS,EACV,SAAS,EACT,KAAK,EACL,sBAAsB,EACtB,aAAsC,EACtC,QAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,gBAAqB,EACrB,aAAa,EACb,iBAAiB,EACjB,mBAAwB,GACzB,EAAE;QACD,SAAS,EAAE,oCAAoC,CAAC;QAChD,KAAK,CAAC,EAAE,OAAO,CAAC,gCAAgC,CAAC,CAAC;QAClD,sBAAsB,EAAE,8BAA8B,CAAC;QACvD,gBAAgB,EAAE,MAAM,MAAM,CAAC;QAC/B,qBAAqB,EAAE,MAAM,MAAM,CAAC;QACpC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QACrC,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,aAAa,EAAE,MAAM,CAAC;QACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,mBAAmB,CAAC,EAAE,YAAY,CAAC;KACpC;IAkFD;;;;;;;OAOG;IACG,wBAAwB,CAAC,KAAK,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB5D;;;;;;;;;;OAUG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAgN3B;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;OAEG;IACH,OAAO,IAAI,IAAI;IAIf;;;;;OAKG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,GAAG,IAAI;IAepD;;;;OAIG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAe1C;;OAEG;IACH,qBAAqB,IAAI,IAAI;CAW9B"}

package/dist/remote-feature-flag-controller.d.mts

@@ -1,113 +0,0 @@
-import { BaseController, ControllerGetStateAction } from "@metamask/base-controller";
-import type { ControllerStateChangeEvent } from "@metamask/base-controller";
-import type { Messenger } from "@metamask/messenger";
-import type { Json } from "@metamask/utils";
-import type { AbstractClientConfigApiService } from "./client-config-api-service/abstract-client-config-api-service.mjs";
-import type { RemoteFeatureFlagControllerMethodActions } from "./remote-feature-flag-controller-method-action-types.mjs";
-import type { FeatureFlags } from "./remote-feature-flag-controller-types.mjs";
-export declare const controllerName = "RemoteFeatureFlagController";
-export declare const DEFAULT_CACHE_DURATION: number;
-export type RemoteFeatureFlagControllerState = {
-    remoteFeatureFlags: FeatureFlags;
-    localOverrides?: FeatureFlags;
-    rawRemoteFeatureFlags?: FeatureFlags;
-    cacheTimestamp: number;
-    thresholdCache?: Record<string, number>;
-    featureFlagThresholdGroups?: Record<string, string>;
-};
-export type RemoteFeatureFlagControllerGetStateAction = ControllerGetStateAction<typeof controllerName, RemoteFeatureFlagControllerState>;
-export type RemoteFeatureFlagControllerActions = RemoteFeatureFlagControllerGetStateAction | RemoteFeatureFlagControllerMethodActions;
-export type RemoteFeatureFlagControllerStateChangeEvent = ControllerStateChangeEvent<typeof controllerName, RemoteFeatureFlagControllerState>;
-export type RemoteFeatureFlagControllerEvents = RemoteFeatureFlagControllerStateChangeEvent;
-export type RemoteFeatureFlagControllerMessenger = Messenger<typeof controllerName, RemoteFeatureFlagControllerActions, RemoteFeatureFlagControllerEvents>;
-/**
- * Returns the default state for the RemoteFeatureFlagController.
- *
- * @returns The default controller state.
- */
-export declare function getDefaultRemoteFeatureFlagControllerState(): RemoteFeatureFlagControllerState;
-/**
- * The RemoteFeatureFlagController manages the retrieval and caching of remote feature flags.
- * It fetches feature flags from a remote API, caches them, and provides methods to access
- * and manage these flags. The controller ensures that feature flags are refreshed based on
- * a specified interval and handles cases where the controller is disabled or the network is unavailable.
- */
-export declare class RemoteFeatureFlagController extends BaseController<typeof controllerName, RemoteFeatureFlagControllerState, RemoteFeatureFlagControllerMessenger> {
-    #private;
-    /**
-     * Constructs a new RemoteFeatureFlagController instance.
-     *
-     * @param options - The controller options.
-     * @param options.messenger - The messenger used for communication.
-     * @param options.state - The initial state of the controller.
-     * @param options.clientConfigApiService - The service instance to fetch remote feature flags.
-     * @param options.fetchInterval - The interval in milliseconds before cached flags expire. Defaults to 1 day.
-     * @param options.disabled - Determines if the controller should be disabled initially. Defaults to false.
-     * @param options.getMetaMetricsId - Returns metaMetricsId.
-     * @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.
-     * @param options.metaMetricsFlags - Names of feature flags that should use MetaMetrics ID for threshold assignment.
-     * @param options.clientVersion - The current client version for version-based feature flag filtering. Must be a valid 3-part SemVer version string.
-     * @param options.prevClientVersion - The previous client version for feature flag cache invalidation.
-     * @param options.defaultFeatureFlags - Client-side default feature flags used as the lowest-precedence layer under processed remote flags and local overrides. Not persisted.
-     */
-    constructor({ messenger, state, clientConfigApiService, fetchInterval, disabled, getMetaMetricsId, getCanonicalProfileId, metaMetricsFlags, clientVersion, prevClientVersion, defaultFeatureFlags, }: {
-        messenger: RemoteFeatureFlagControllerMessenger;
-        state?: Partial<RemoteFeatureFlagControllerState>;
-        clientConfigApiService: AbstractClientConfigApiService;
-        getMetaMetricsId: () => string;
-        getCanonicalProfileId: () => string;
-        metaMetricsFlags?: readonly string[];
-        fetchInterval?: number;
-        disabled?: boolean;
-        clientVersion: string;
-        prevClientVersion?: string;
-        defaultFeatureFlags?: FeatureFlags;
-    });
-    /**
-     * Retrieves the remote feature flags, fetching from the API if necessary.
-     * Uses caching to prevent redundant API calls and handles concurrent fetches.
-     *
-     * @param force - When `true`, fetch even if the cache has not expired.
-     * Defaults to `false`. Has no effect when the controller is disabled.
-     * @returns A promise that resolves to the current set of feature flags.
-     */
-    updateRemoteFeatureFlags(force?: boolean): Promise<void>;
-    /**
-     * Computes the effective feature flags, re-deriving the remote layer from the
-     * raw flags already in state. Threshold selection needs to await a hash and
-     * so cannot run in the constructor, which is why this cannot be part of
-     * construction. Clients must call this once after constructing the
-     * controller.
-     *
-     * When there are no persisted raw flags, as on a fresh install or for state
-     * persisted before raw flags were stored, the previous session's flags stand
-     * in for the remote layer so that nothing is lost.
-     */
-    init(): Promise<void>;
-    /**
-     * Enables the controller, allowing it to make network requests.
-     */
-    enable(): void;
-    /**
-     * Disables the controller, preventing it from making network requests.
-     */
-    disable(): void;
-    /**
-     * Sets a local override for a specific feature flag.
-     *
-     * @param flagName - The name of the feature flag to override.
-     * @param value - The override value for the feature flag.
-     */
-    setFlagOverride(flagName: string, value: Json): void;
-    /**
-     * Clears the local override for a specific feature flag.
-     *
-     * @param flagName - The name of the feature flag to clear.
-     */
-    removeFlagOverride(flagName: string): void;
-    /**
-     * Clears all local feature flag overrides.
-     */
-    clearAllFlagOverrides(): void;
-}
-//# sourceMappingURL=remote-feature-flag-controller.d.mts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"remote-feature-flag-controller.d.mts","sourceRoot":"","sources":["../src/remote-feature-flag-controller.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,wBAAwB,EACzB,kCAAkC;AACnC,OAAO,KAAK,EAAE,0BAA0B,EAAE,kCAAkC;AAC5E,OAAO,KAAK,EAAE,SAAS,EAAE,4BAA4B;AAErD,OAAO,KAAK,EAAE,IAAI,EAAiB,wBAAwB;AAE3D,OAAO,KAAK,EAAE,8BAA8B,EAAE,2EAA0E;AACxH,OAAO,KAAK,EAAE,wCAAwC,EAAE,iEAAgE;AACxH,OAAO,KAAK,EACV,YAAY,EAGb,mDAAkD;AASnD,eAAO,MAAM,cAAc,gCAAgC,CAAC;AAC5D,eAAO,MAAM,sBAAsB,QAAsB,CAAC;AAI1D,MAAM,MAAM,gCAAgC,GAAG;IAC7C,kBAAkB,EAAE,YAAY,CAAC;IACjC,cAAc,CAAC,EAAE,YAAY,CAAC;IAC9B,qBAAqB,CAAC,EAAE,YAAY,CAAC;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,0BAA0B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrD,CAAC;AAoDF,MAAM,MAAM,yCAAyC,GACnD,wBAAwB,CACtB,OAAO,cAAc,EACrB,gCAAgC,CACjC,CAAC;AAEJ,MAAM,MAAM,kCAAkC,GAC1C,yCAAyC,GACzC,wCAAwC,CAAC;AAE7C,MAAM,MAAM,2CAA2C,GACrD,0BAA0B,CACxB,OAAO,cAAc,EACrB,gCAAgC,CACjC,CAAC;AAEJ,MAAM,MAAM,iCAAiC,GAC3C,2CAA2C,CAAC;AAE9C,MAAM,MAAM,oCAAoC,GAAG,SAAS,CAC1D,OAAO,cAAc,EACrB,kCAAkC,EAClC,iCAAiC,CAClC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,0CAA0C,IAAI,gCAAgC,CAO7F;AAoCD;;;;;GAKG;AACH,qBAAa,2BAA4B,SAAQ,cAAc,CAC7D,OAAO,cAAc,EACrB,gCAAgC,EAChC,oCAAoC,CACrC;;IAqBC;;;;;;;;;;;;;;;OAeG;gBACS,EACV,SAAS,EACT,KAAK,EACL,sBAAsB,EACtB,aAAsC,EACtC,QAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,gBAAqB,EACrB,aAAa,EACb,iBAAiB,EACjB,mBAAwB,GACzB,EAAE;QACD,SAAS,EAAE,oCAAoC,CAAC;QAChD,KAAK,CAAC,EAAE,OAAO,CAAC,gCAAgC,CAAC,CAAC;QAClD,sBAAsB,EAAE,8BAA8B,CAAC;QACvD,gBAAgB,EAAE,MAAM,MAAM,CAAC;QAC/B,qBAAqB,EAAE,MAAM,MAAM,CAAC;QACpC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QACrC,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,aAAa,EAAE,MAAM,CAAC;QACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,mBAAmB,CAAC,EAAE,YAAY,CAAC;KACpC;IAkFD;;;;;;;OAOG;IACG,wBAAwB,CAAC,KAAK,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB5D;;;;;;;;;;OAUG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAgN3B;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;OAEG;IACH,OAAO,IAAI,IAAI;IAIf;;;;;OAKG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,GAAG,IAAI;IAepD;;;;OAIG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAe1C;;OAEG;IACH,qBAAqB,IAAI,IAAI;CAW9B"}