@metamask-previews/perps-controller 0.0.0-preview-e4aa1532 → 0.0.0-preview-6dfa4aeba

package/dist/services/FeatureFlagConfigurationService.cjs

@@ -1,258 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FeatureFlagConfigurationService = void 0;
-/* eslint-disable id-denylist, no-restricted-syntax, no-negated-condition */
-// TODO: Fix ESLint errors in this file - tracked for Phase 5 cleanup
-const utils_1 = require("@metamask/utils");
-const stringParseUtils_1 = require("../utils/stringParseUtils.cjs");
-/**
- * Check if a value is a valid version gated feature flag.
- *
- * @param flag - The value to check
- * @returns True if the value has a boolean 'value' property
- */
-function isVersionGatedFeatureFlag(flag) {
-    return (typeof flag === 'object' &&
-        flag !== null &&
-        'value' in flag &&
-        typeof flag.value === 'boolean');
-}
-/**
- * Extract the boolean value from a version gated feature flag.
- *
- * @param flag - The version gated feature flag
- * @returns The boolean value or undefined if invalid
- */
-function validatedVersionGatedFeatureFlag(flag) {
-    return flag.value;
-}
-/**
- * FeatureFlagConfigurationService
- *
- * Handles HIP-3 configuration and geo-blocking configuration from remote feature flags.
- * Implements "sticky remote" pattern: once remote config is loaded, never downgrade to fallback.
- * Orchestrates validation, change detection, and version management for feature flag updates.
- *
- * Responsibilities:
- * - Remote feature flag validation and parsing
- * - HIP-3 configuration management (equity, allowlist, blocklist)
- * - Geo-blocking configuration from remote flags
- * - Change detection and version management
- * - "Sticky remote" pattern enforcement (never downgrade)
- *
- * Instance-based service with constructor injection of platform dependencies.
- */
-class FeatureFlagConfigurationService {
-    /**
-     * Create a new FeatureFlagConfigurationService instance.
-     *
-     * @param deps - Platform dependencies for logging, metrics, etc.
-     */
-    constructor(deps) {
-        this.deps = deps;
-    }
-    /**
-     * Validate and parse market list from remote feature flags.
-     * Handles both string (comma-separated) and array formats from LaunchDarkly.
-     *
-     * @param remoteValue - The raw value from remote feature flags
-     * @param fieldName - The name of the field for logging
-     * @param currentValue - The current value to use as fallback
-     * @returns The validated market list or undefined if validation fails
-     */
-    validateMarketList(remoteValue, fieldName, currentValue) {
-        this.deps.debugLogger.log(`PerpsController: HIP-3 ${fieldName} validation`, {
-            remoteValue,
-            type: typeof remoteValue,
-            isArray: Array.isArray(remoteValue),
-        });
-        // LaunchDarkly returns comma-separated strings for list values
-        // Values may have literal quotes (e.g., '"xyz"') due to JSON encoding quirks
-        if (typeof remoteValue === 'string') {
-            const parsed = (0, stringParseUtils_1.parseCommaSeparatedString)(remoteValue).map(stringParseUtils_1.stripQuotes);
-            if (parsed.length > 0) {
-                this.deps.debugLogger.log(`PerpsController: HIP-3 ${fieldName} validated from string`, { validatedMarkets: parsed });
-                return parsed;
-            }
-            this.deps.debugLogger.log(`PerpsController: HIP-3 ${fieldName} string was empty after parsing`, { fallbackValue: currentValue });
-            return undefined;
-        }
-        // Fallback: Validate array of non-empty strings
-        if (Array.isArray(remoteValue) &&
-            remoteValue.every((item) => typeof item === 'string' && item.length > 0)) {
-            const validatedMarkets = remoteValue
-                .map((market) => (0, stringParseUtils_1.stripQuotes)(market.trim()))
-                .filter((market) => market.length > 0);
-            this.deps.debugLogger.log(`PerpsController: HIP-3 ${fieldName} validated from array`, { validatedMarkets });
-            return validatedMarkets;
-        }
-        this.deps.debugLogger.log(`PerpsController: HIP-3 ${fieldName} validation FAILED - falling back to local config`, {
-            reason: Array.isArray(remoteValue)
-                ? 'Array contains non-string or empty values'
-                : 'Invalid type (expected string or array)',
-            fallbackValue: currentValue,
-        });
-        return undefined;
-    }
-    /**
-     * Check if arrays have different values (order-independent comparison).
-     *
-     * @param a - First array
-     * @param b - Second array
-     * @returns True if arrays have different values
-     */
-    arraysHaveDifferentValues(a, b) {
-        return (JSON.stringify([...a].sort((itemA, itemB) => itemA.localeCompare(itemB))) !==
-            JSON.stringify([...b].sort((itemA, itemB) => itemA.localeCompare(itemB))));
-    }
-    /**
-     * Refresh HIP-3 configuration when remote feature flags change.
-     * This method extracts HIP-3 settings from remote flags, validates them,
-     * and updates internal state if they differ from current values.
-     * When config changes, increments hip3ConfigVersion to trigger ConnectionManager reconnection.
-     *
-     * Follows the "sticky remote" pattern: once remote config is loaded, never downgrade to fallback.
-     *
-     * @param options - Configuration object
-     * @param options.remoteFeatureFlagControllerState - State from RemoteFeatureFlagController
-     * @param options.context - ServiceContext providing state access callbacks
-     */
-    refreshHip3Config(options) {
-        const { remoteFeatureFlagControllerState, context } = options;
-        if (!context.getHip3Config ||
-            !context.setHip3Config ||
-            !context.incrementHip3ConfigVersion) {
-            throw new Error('Required HIP-3 callbacks not available in ServiceContext');
-        }
-        const remoteFlags = remoteFeatureFlagControllerState.remoteFeatureFlags;
-        const currentConfig = context.getHip3Config();
-        // Extract and validate remote HIP-3 equity enabled flag
-        const equityFlag = remoteFlags?.perpsHip3Enabled;
-        // Use type guard to validate before calling - validatedVersionGatedFeatureFlag also
-        // handles invalid flags internally, but proper typing requires the guard
-        const validatedEquity = isVersionGatedFeatureFlag(equityFlag)
-            ? validatedVersionGatedFeatureFlag(equityFlag)
-            : undefined;
-        this.deps.debugLogger.log('PerpsController: HIP-3 equity flag validation', {
-            equityFlag,
-            validatedEquity,
-            willUse: validatedEquity !== undefined ? 'remote' : 'fallback',
-        });
-        // Extract and validate remote HIP-3 market lists
-        const validatedAllowlistMarkets = (0, utils_1.hasProperty)(remoteFlags, 'perpsHip3AllowlistMarkets')
-            ? this.validateMarketList(remoteFlags.perpsHip3AllowlistMarkets, 'allowlistMarkets', currentConfig.allowlistMarkets)
-            : undefined;
-        const validatedBlocklistMarkets = (0, utils_1.hasProperty)(remoteFlags, 'perpsHip3BlocklistMarkets')
-            ? this.validateMarketList(remoteFlags.perpsHip3BlocklistMarkets, 'blocklistMarkets', currentConfig.blocklistMarkets)
-            : undefined;
-        // Detect changes (only if we have valid remote values)
-        const equityChanged = validatedEquity !== undefined &&
-            validatedEquity !== currentConfig.enabled;
-        const allowlistMarketsChanged = validatedAllowlistMarkets !== undefined &&
-            this.arraysHaveDifferentValues(validatedAllowlistMarkets, currentConfig.allowlistMarkets);
-        const blocklistMarketsChanged = validatedBlocklistMarkets !== undefined &&
-            this.arraysHaveDifferentValues(validatedBlocklistMarkets, currentConfig.blocklistMarkets);
-        if (equityChanged || allowlistMarketsChanged || blocklistMarketsChanged) {
-            this.deps.debugLogger.log('PerpsController: HIP-3 config changed via remote feature flags', {
-                equityChanged,
-                allowlistMarketsChanged,
-                blocklistMarketsChanged,
-                oldEquity: currentConfig.enabled,
-                newEquity: validatedEquity,
-                oldAllowlistMarkets: currentConfig.allowlistMarkets,
-                newAllowlistMarkets: validatedAllowlistMarkets,
-                oldBlocklistMarkets: currentConfig.blocklistMarkets,
-                newBlocklistMarkets: validatedBlocklistMarkets,
-                source: 'remote',
-            });
-            // Update internal state (sticky remote - never downgrade)
-            context.setHip3Config({
-                enabled: validatedEquity,
-                allowlistMarkets: validatedAllowlistMarkets
-                    ? [...validatedAllowlistMarkets]
-                    : undefined,
-                blocklistMarkets: validatedBlocklistMarkets
-                    ? [...validatedBlocklistMarkets]
-                    : undefined,
-                source: 'remote',
-            });
-            // Increment version to trigger ConnectionManager reconnection and cache clearing
-            const newVersion = context.incrementHip3ConfigVersion();
-            this.deps.debugLogger.log('PerpsController: Incremented hip3ConfigVersion to trigger reconnection', {
-                newVersion,
-                newHip3Enabled: validatedEquity ?? currentConfig.enabled,
-                newHip3AllowlistMarkets: validatedAllowlistMarkets ?? currentConfig.allowlistMarkets,
-                newHip3BlocklistMarkets: validatedBlocklistMarkets ?? currentConfig.blocklistMarkets,
-            });
-            // Note: ConnectionManager will handle:
-            // 1. Detecting hip3ConfigVersion change via Redux monitoring
-            // 2. Clearing all StreamManager caches
-            // 3. Calling reconnectWithNewContext() -> initializeProviders()
-            // 4. Provider reinitialization will read the new HIP-3 config below
-        }
-    }
-    /**
-     * Respond to RemoteFeatureFlagController state changes.
-     * Refreshes user eligibility based on geo-blocked regions defined in remote feature flag.
-     * Uses fallback configuration when remote feature flag is undefined.
-     * Note: Initial eligibility is set in the constructor if fallback regions are provided.
-     *
-     * @param options - Configuration object
-     * @param options.remoteFeatureFlagControllerState - State from RemoteFeatureFlagController
-     * @param options.context - ServiceContext providing callbacks
-     */
-    refreshEligibility(options) {
-        const { remoteFeatureFlagControllerState, context } = options;
-        const perpsGeoBlockedRegionsFeatureFlag = 
-        // NOTE: Do not use perpsPerpTradingGeoBlockedCountries as it is deprecated.
-        remoteFeatureFlagControllerState.remoteFeatureFlags
-            ?.perpsPerpTradingGeoBlockedCountriesV2;
-        const remoteBlockedRegions = perpsGeoBlockedRegionsFeatureFlag?.blockedRegions;
-        if (Array.isArray(remoteBlockedRegions)) {
-            this.setBlockedRegions({
-                list: remoteBlockedRegions,
-                source: 'remote',
-                context,
-            });
-        }
-        // Also check for HIP-3 config changes
-        this.refreshHip3Config({ remoteFeatureFlagControllerState, context });
-    }
-    /**
-     * Set blocked region list with "never downgrade" pattern enforcement.
-     * Updates the blocked region list and triggers eligibility refresh.
-     * Implements "sticky remote": once remote regions are set, never downgrade to fallback.
-     *
-     * @param options - Configuration object
-     * @param options.list - Array of blocked region codes
-     * @param options.source - Source of the list ('remote' or 'fallback')
-     * @param options.context - ServiceContext providing callbacks
-     */
-    setBlockedRegions(options) {
-        const { list, source, context } = options;
-        if (!context.getBlockedRegionList ||
-            !context.setBlockedRegionList ||
-            !context.refreshEligibility) {
-            throw new Error('Required blocked region callbacks not available in ServiceContext');
-        }
-        const currentList = context.getBlockedRegionList();
-        // Never downgrade from remote to fallback
-        if (source === 'fallback' && currentList.source === 'remote') {
-            return;
-        }
-        if (Array.isArray(list)) {
-            context.setBlockedRegionList(list, source);
-        }
-        context.refreshEligibility().catch((err) => {
-            const error = err instanceof Error ? err : new Error(String(err));
-            this.deps.logger.error(error, {
-                context: {
-                    name: 'FeatureFlagConfigurationService.setBlockedRegions',
-                    data: { source },
-                },
-            });
-        });
-    }
-}
-exports.FeatureFlagConfigurationService = FeatureFlagConfigurationService;
-//# sourceMappingURL=FeatureFlagConfigurationService.cjs.map

package/dist/services/FeatureFlagConfigurationService.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"FeatureFlagConfigurationService.cjs","sourceRoot":"","sources":["../../src/services/FeatureFlagConfigurationService.ts"],"names":[],"mappings":";;;AAAA,4EAA4E;AAC5E,qEAAqE;AACrE,2CAA8C;AAI9C,oEAGmC;AAkBnC;;;;;GAKG;AACH,SAAS,yBAAyB,CAChC,IAAa;IAEb,OAAO,CACL,OAAO,IAAI,KAAK,QAAQ;QACxB,IAAI,KAAK,IAAI;QACb,OAAO,IAAI,IAAI;QACf,OAAQ,IAAgC,CAAC,KAAK,KAAK,SAAS,CAC7D,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAS,gCAAgC,CACvC,IAA6B;IAE7B,OAAO,IAAI,CAAC,KAAK,CAAC;AACpB,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAa,+BAA+B;IAG1C;;;;OAIG;IACH,YAAY,IAA+B;QACzC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;;;;;;;OAQG;IACK,kBAAkB,CACxB,WAAoB,EACpB,SAAiB,EACjB,YAAsB;QAEtB,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CACvB,0BAA0B,SAAS,aAAa,EAChD;YACE,WAAW;YACX,IAAI,EAAE,OAAO,WAAW;YACxB,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;SACpC,CACF,CAAC;QAEF,+DAA+D;QAC/D,6EAA6E;QAC7E,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,IAAA,4CAAyB,EAAC,WAAW,CAAC,CAAC,GAAG,CAAC,8BAAW,CAAC,CAAC;YAEvE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtB,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CACvB,0BAA0B,SAAS,wBAAwB,EAC3D,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAC7B,CAAC;gBACF,OAAO,MAAM,CAAC;YAChB,CAAC;YAED,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CACvB,0BAA0B,SAAS,iCAAiC,EACpE,EAAE,aAAa,EAAE,YAAY,EAAE,CAChC,CAAC;YACF,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,gDAAgD;QAChD,IACE,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;YAC1B,WAAW,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,EACxE,CAAC;YACD,MAAM,gBAAgB,GAAI,WAAwB;iBAC/C,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAA,8BAAW,EAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;iBAC3C,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAEzC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CACvB,0BAA0B,SAAS,uBAAuB,EAC1D,EAAE,gBAAgB,EAAE,CACrB,CAAC;YACF,OAAO,gBAAgB,CAAC;QAC1B,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CACvB,0BAA0B,SAAS,mDAAmD,EACtF;YACE,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;gBAChC,CAAC,CAAC,2CAA2C;gBAC7C,CAAC,CAAC,yCAAyC;YAC7C,aAAa,EAAE,YAAY;SAC5B,CACF,CAAC;QACF,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;;;OAMG;IACK,yBAAyB,CAAC,CAAW,EAAE,CAAW;QACxD,OAAO,CACL,IAAI,CAAC,SAAS,CACZ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAC1D;YACD,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAC1E,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;OAWG;IACH,iBAAiB,CAAC,OAGjB;QACC,MAAM,EAAE,gCAAgC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAE9D,IACE,CAAC,OAAO,CAAC,aAAa;YACtB,CAAC,OAAO,CAAC,aAAa;YACtB,CAAC,OAAO,CAAC,0BAA0B,EACnC,CAAC;YACD,MAAM,IAAI,KAAK,CACb,0DAA0D,CAC3D,CAAC;QACJ,CAAC;QAED,MAAM,WAAW,GAAG,gCAAgC,CAAC,kBAAkB,CAAC;QACxE,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;QAE9C,wDAAwD;QACxD,MAAM,UAAU,GAAG,WAAW,EAAE,gBAAgB,CAAC;QACjD,oFAAoF;QACpF,yEAAyE;QACzE,MAAM,eAAe,GAAG,yBAAyB,CAAC,UAAU,CAAC;YAC3D,CAAC,CAAC,gCAAgC,CAAC,UAAU,CAAC;YAC9C,CAAC,CAAC,SAAS,CAAC;QAEd,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,+CAA+C,EAAE;YACzE,UAAU;YACV,eAAe;YACf,OAAO,EAAE,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU;SAC/D,CAAC,CAAC;QAEH,iDAAiD;QACjD,MAAM,yBAAyB,GAAG,IAAA,mBAAW,EAC3C,WAAW,EACX,2BAA2B,CAC5B;YACC,CAAC,CAAC,IAAI,CAAC,kBAAkB,CACrB,WAAW,CAAC,yBAAyB,EACrC,kBAAkB,EAClB,aAAa,CAAC,gBAAgB,CAC/B;YACH,CAAC,CAAC,SAAS,CAAC;QAEd,MAAM,yBAAyB,GAAG,IAAA,mBAAW,EAC3C,WAAW,EACX,2BAA2B,CAC5B;YACC,CAAC,CAAC,IAAI,CAAC,kBAAkB,CACrB,WAAW,CAAC,yBAAyB,EACrC,kBAAkB,EAClB,aAAa,CAAC,gBAAgB,CAC/B;YACH,CAAC,CAAC,SAAS,CAAC;QAEd,uDAAuD;QACvD,MAAM,aAAa,GACjB,eAAe,KAAK,SAAS;YAC7B,eAAe,KAAK,aAAa,CAAC,OAAO,CAAC;QAC5C,MAAM,uBAAuB,GAC3B,yBAAyB,KAAK,SAAS;YACvC,IAAI,CAAC,yBAAyB,CAC5B,yBAAyB,EACzB,aAAa,CAAC,gBAAgB,CAC/B,CAAC;QACJ,MAAM,uBAAuB,GAC3B,yBAAyB,KAAK,SAAS;YACvC,IAAI,CAAC,yBAAyB,CAC5B,yBAAyB,EACzB,aAAa,CAAC,gBAAgB,CAC/B,CAAC;QAEJ,IAAI,aAAa,IAAI,uBAAuB,IAAI,uBAAuB,EAAE,CAAC;YACxE,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CACvB,gEAAgE,EAChE;gBACE,aAAa;gBACb,uBAAuB;gBACvB,uBAAuB;gBACvB,SAAS,EAAE,aAAa,CAAC,OAAO;gBAChC,SAAS,EAAE,eAAe;gBAC1B,mBAAmB,EAAE,aAAa,CAAC,gBAAgB;gBACnD,mBAAmB,EAAE,yBAAyB;gBAC9C,mBAAmB,EAAE,aAAa,CAAC,gBAAgB;gBACnD,mBAAmB,EAAE,yBAAyB;gBAC9C,MAAM,EAAE,QAAQ;aACjB,CACF,CAAC;YAEF,0DAA0D;YAC1D,OAAO,CAAC,aAAa,CAAC;gBACpB,OAAO,EAAE,eAAe;gBACxB,gBAAgB,EAAE,yBAAyB;oBACzC,CAAC,CAAC,CAAC,GAAG,yBAAyB,CAAC;oBAChC,CAAC,CAAC,SAAS;gBACb,gBAAgB,EAAE,yBAAyB;oBACzC,CAAC,CAAC,CAAC,GAAG,yBAAyB,CAAC;oBAChC,CAAC,CAAC,SAAS;gBACb,MAAM,EAAE,QAAQ;aACjB,CAAC,CAAC;YAEH,iFAAiF;YACjF,MAAM,UAAU,GAAG,OAAO,CAAC,0BAA0B,EAAE,CAAC;YAExD,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CACvB,wEAAwE,EACxE;gBACE,UAAU;gBACV,cAAc,EAAE,eAAe,IAAI,aAAa,CAAC,OAAO;gBACxD,uBAAuB,EACrB,yBAAyB,IAAI,aAAa,CAAC,gBAAgB;gBAC7D,uBAAuB,EACrB,yBAAyB,IAAI,aAAa,CAAC,gBAAgB;aAC9D,CACF,CAAC;YAEF,uCAAuC;YACvC,6DAA6D;YAC7D,uCAAuC;YACvC,gEAAgE;YAChE,oEAAoE;QACtE,CAAC;IACH,CAAC;IAED;;;;;;;;;OASG;IACH,kBAAkB,CAAC,OAGlB;QACC,MAAM,EAAE,gCAAgC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAE9D,MAAM,iCAAiC;QACrC,4EAA4E;QAC5E,gCAAgC,CAAC,kBAAkB;YACjD,EAAE,qCAAqC,CAAC;QAE5C,MAAM,oBAAoB,GACxB,iCACD,EAAE,cAAc,CAAC;QAElB,IAAI,KAAK,CAAC,OAAO,CAAC,oBAAoB,CAAC,EAAE,CAAC;YACxC,IAAI,CAAC,iBAAiB,CAAC;gBACrB,IAAI,EAAE,oBAAoB;gBAC1B,MAAM,EAAE,QAAQ;gBAChB,OAAO;aACR,CAAC,CAAC;QACL,CAAC;QAED,sCAAsC;QACtC,IAAI,CAAC,iBAAiB,CAAC,EAAE,gCAAgC,EAAE,OAAO,EAAE,CAAC,CAAC;IACxE,CAAC;IAED;;;;;;;;;OASG;IACH,iBAAiB,CAAC,OAIjB;QACC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAE1C,IACE,CAAC,OAAO,CAAC,oBAAoB;YAC7B,CAAC,OAAO,CAAC,oBAAoB;YAC7B,CAAC,OAAO,CAAC,kBAAkB,EAC3B,CAAC;YACD,MAAM,IAAI,KAAK,CACb,mEAAmE,CACpE,CAAC;QACJ,CAAC;QAED,MAAM,WAAW,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;QAEnD,0CAA0C;QAC1C,IAAI,MAAM,KAAK,UAAU,IAAI,WAAW,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC7D,OAAO;QACT,CAAC;QAED,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,OAAO,CAAC,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC7C,CAAC;QAED,OAAO,CAAC,kBAAkB,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACzC,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAClE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE;gBAC5B,OAAO,EAAE;oBACP,IAAI,EAAE,mDAAmD;oBACzD,IAAI,EAAE,EAAE,MAAM,EAAE;iBACjB;aACF,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAjUD,0EAiUC","sourcesContent":["/* eslint-disable id-denylist, no-restricted-syntax, no-negated-condition */\n// TODO: Fix ESLint errors in this file - tracked for Phase 5 cleanup\nimport { hasProperty } from '@metamask/utils';\n\nimport type { ServiceContext } from './ServiceContext';\nimport type { PerpsPlatformDependencies } from '../types';\nimport {\n  parseCommaSeparatedString,\n  stripQuotes,\n} from '../utils/stringParseUtils';\n\n/**\n * Remote feature flags state shape for perps-related flags.\n * This is a minimal type definition to avoid direct dependency on\n * RemoteFeatureFlagController which can cause build issues.\n */\ntype RemoteFeatureFlagState = {\n  remoteFeatureFlags: Record<string, unknown>;\n};\n\n/**\n * Version gated feature flag structure for validating remote flags.\n */\ntype VersionGatedFeatureFlag = {\n  value?: boolean;\n};\n\n/**\n * Check if a value is a valid version gated feature flag.\n *\n * @param flag - The value to check\n * @returns True if the value has a boolean 'value' property\n */\nfunction isVersionGatedFeatureFlag(\n  flag: unknown,\n): flag is VersionGatedFeatureFlag {\n  return (\n    typeof flag === 'object' &&\n    flag !== null &&\n    'value' in flag &&\n    typeof (flag as VersionGatedFeatureFlag).value === 'boolean'\n  );\n}\n\n/**\n * Extract the boolean value from a version gated feature flag.\n *\n * @param flag - The version gated feature flag\n * @returns The boolean value or undefined if invalid\n */\nfunction validatedVersionGatedFeatureFlag(\n  flag: VersionGatedFeatureFlag,\n): boolean | undefined {\n  return flag.value;\n}\n\n/**\n * FeatureFlagConfigurationService\n *\n * Handles HIP-3 configuration and geo-blocking configuration from remote feature flags.\n * Implements \"sticky remote\" pattern: once remote config is loaded, never downgrade to fallback.\n * Orchestrates validation, change detection, and version management for feature flag updates.\n *\n * Responsibilities:\n * - Remote feature flag validation and parsing\n * - HIP-3 configuration management (equity, allowlist, blocklist)\n * - Geo-blocking configuration from remote flags\n * - Change detection and version management\n * - \"Sticky remote\" pattern enforcement (never downgrade)\n *\n * Instance-based service with constructor injection of platform dependencies.\n */\nexport class FeatureFlagConfigurationService {\n  private readonly deps: PerpsPlatformDependencies;\n\n  /**\n   * Create a new FeatureFlagConfigurationService instance.\n   *\n   * @param deps - Platform dependencies for logging, metrics, etc.\n   */\n  constructor(deps: PerpsPlatformDependencies) {\n    this.deps = deps;\n  }\n\n  /**\n   * Validate and parse market list from remote feature flags.\n   * Handles both string (comma-separated) and array formats from LaunchDarkly.\n   *\n   * @param remoteValue - The raw value from remote feature flags\n   * @param fieldName - The name of the field for logging\n   * @param currentValue - The current value to use as fallback\n   * @returns The validated market list or undefined if validation fails\n   */\n  private validateMarketList(\n    remoteValue: unknown,\n    fieldName: string,\n    currentValue: string[],\n  ): string[] | undefined {\n    this.deps.debugLogger.log(\n      `PerpsController: HIP-3 ${fieldName} validation`,\n      {\n        remoteValue,\n        type: typeof remoteValue,\n        isArray: Array.isArray(remoteValue),\n      },\n    );\n\n    // LaunchDarkly returns comma-separated strings for list values\n    // Values may have literal quotes (e.g., '\"xyz\"') due to JSON encoding quirks\n    if (typeof remoteValue === 'string') {\n      const parsed = parseCommaSeparatedString(remoteValue).map(stripQuotes);\n\n      if (parsed.length > 0) {\n        this.deps.debugLogger.log(\n          `PerpsController: HIP-3 ${fieldName} validated from string`,\n          { validatedMarkets: parsed },\n        );\n        return parsed;\n      }\n\n      this.deps.debugLogger.log(\n        `PerpsController: HIP-3 ${fieldName} string was empty after parsing`,\n        { fallbackValue: currentValue },\n      );\n      return undefined;\n    }\n\n    // Fallback: Validate array of non-empty strings\n    if (\n      Array.isArray(remoteValue) &&\n      remoteValue.every((item) => typeof item === 'string' && item.length > 0)\n    ) {\n      const validatedMarkets = (remoteValue as string[])\n        .map((market) => stripQuotes(market.trim()))\n        .filter((market) => market.length > 0);\n\n      this.deps.debugLogger.log(\n        `PerpsController: HIP-3 ${fieldName} validated from array`,\n        { validatedMarkets },\n      );\n      return validatedMarkets;\n    }\n\n    this.deps.debugLogger.log(\n      `PerpsController: HIP-3 ${fieldName} validation FAILED - falling back to local config`,\n      {\n        reason: Array.isArray(remoteValue)\n          ? 'Array contains non-string or empty values'\n          : 'Invalid type (expected string or array)',\n        fallbackValue: currentValue,\n      },\n    );\n    return undefined;\n  }\n\n  /**\n   * Check if arrays have different values (order-independent comparison).\n   *\n   * @param a - First array\n   * @param b - Second array\n   * @returns True if arrays have different values\n   */\n  private arraysHaveDifferentValues(a: string[], b: string[]): boolean {\n    return (\n      JSON.stringify(\n        [...a].sort((itemA, itemB) => itemA.localeCompare(itemB)),\n      ) !==\n      JSON.stringify([...b].sort((itemA, itemB) => itemA.localeCompare(itemB)))\n    );\n  }\n\n  /**\n   * Refresh HIP-3 configuration when remote feature flags change.\n   * This method extracts HIP-3 settings from remote flags, validates them,\n   * and updates internal state if they differ from current values.\n   * When config changes, increments hip3ConfigVersion to trigger ConnectionManager reconnection.\n   *\n   * Follows the \"sticky remote\" pattern: once remote config is loaded, never downgrade to fallback.\n   *\n   * @param options - Configuration object\n   * @param options.remoteFeatureFlagControllerState - State from RemoteFeatureFlagController\n   * @param options.context - ServiceContext providing state access callbacks\n   */\n  refreshHip3Config(options: {\n    remoteFeatureFlagControllerState: RemoteFeatureFlagState;\n    context: ServiceContext;\n  }): void {\n    const { remoteFeatureFlagControllerState, context } = options;\n\n    if (\n      !context.getHip3Config ||\n      !context.setHip3Config ||\n      !context.incrementHip3ConfigVersion\n    ) {\n      throw new Error(\n        'Required HIP-3 callbacks not available in ServiceContext',\n      );\n    }\n\n    const remoteFlags = remoteFeatureFlagControllerState.remoteFeatureFlags;\n    const currentConfig = context.getHip3Config();\n\n    // Extract and validate remote HIP-3 equity enabled flag\n    const equityFlag = remoteFlags?.perpsHip3Enabled;\n    // Use type guard to validate before calling - validatedVersionGatedFeatureFlag also\n    // handles invalid flags internally, but proper typing requires the guard\n    const validatedEquity = isVersionGatedFeatureFlag(equityFlag)\n      ? validatedVersionGatedFeatureFlag(equityFlag)\n      : undefined;\n\n    this.deps.debugLogger.log('PerpsController: HIP-3 equity flag validation', {\n      equityFlag,\n      validatedEquity,\n      willUse: validatedEquity !== undefined ? 'remote' : 'fallback',\n    });\n\n    // Extract and validate remote HIP-3 market lists\n    const validatedAllowlistMarkets = hasProperty(\n      remoteFlags,\n      'perpsHip3AllowlistMarkets',\n    )\n      ? this.validateMarketList(\n          remoteFlags.perpsHip3AllowlistMarkets,\n          'allowlistMarkets',\n          currentConfig.allowlistMarkets,\n        )\n      : undefined;\n\n    const validatedBlocklistMarkets = hasProperty(\n      remoteFlags,\n      'perpsHip3BlocklistMarkets',\n    )\n      ? this.validateMarketList(\n          remoteFlags.perpsHip3BlocklistMarkets,\n          'blocklistMarkets',\n          currentConfig.blocklistMarkets,\n        )\n      : undefined;\n\n    // Detect changes (only if we have valid remote values)\n    const equityChanged =\n      validatedEquity !== undefined &&\n      validatedEquity !== currentConfig.enabled;\n    const allowlistMarketsChanged =\n      validatedAllowlistMarkets !== undefined &&\n      this.arraysHaveDifferentValues(\n        validatedAllowlistMarkets,\n        currentConfig.allowlistMarkets,\n      );\n    const blocklistMarketsChanged =\n      validatedBlocklistMarkets !== undefined &&\n      this.arraysHaveDifferentValues(\n        validatedBlocklistMarkets,\n        currentConfig.blocklistMarkets,\n      );\n\n    if (equityChanged || allowlistMarketsChanged || blocklistMarketsChanged) {\n      this.deps.debugLogger.log(\n        'PerpsController: HIP-3 config changed via remote feature flags',\n        {\n          equityChanged,\n          allowlistMarketsChanged,\n          blocklistMarketsChanged,\n          oldEquity: currentConfig.enabled,\n          newEquity: validatedEquity,\n          oldAllowlistMarkets: currentConfig.allowlistMarkets,\n          newAllowlistMarkets: validatedAllowlistMarkets,\n          oldBlocklistMarkets: currentConfig.blocklistMarkets,\n          newBlocklistMarkets: validatedBlocklistMarkets,\n          source: 'remote',\n        },\n      );\n\n      // Update internal state (sticky remote - never downgrade)\n      context.setHip3Config({\n        enabled: validatedEquity,\n        allowlistMarkets: validatedAllowlistMarkets\n          ? [...validatedAllowlistMarkets]\n          : undefined,\n        blocklistMarkets: validatedBlocklistMarkets\n          ? [...validatedBlocklistMarkets]\n          : undefined,\n        source: 'remote',\n      });\n\n      // Increment version to trigger ConnectionManager reconnection and cache clearing\n      const newVersion = context.incrementHip3ConfigVersion();\n\n      this.deps.debugLogger.log(\n        'PerpsController: Incremented hip3ConfigVersion to trigger reconnection',\n        {\n          newVersion,\n          newHip3Enabled: validatedEquity ?? currentConfig.enabled,\n          newHip3AllowlistMarkets:\n            validatedAllowlistMarkets ?? currentConfig.allowlistMarkets,\n          newHip3BlocklistMarkets:\n            validatedBlocklistMarkets ?? currentConfig.blocklistMarkets,\n        },\n      );\n\n      // Note: ConnectionManager will handle:\n      // 1. Detecting hip3ConfigVersion change via Redux monitoring\n      // 2. Clearing all StreamManager caches\n      // 3. Calling reconnectWithNewContext() -> initializeProviders()\n      // 4. Provider reinitialization will read the new HIP-3 config below\n    }\n  }\n\n  /**\n   * Respond to RemoteFeatureFlagController state changes.\n   * Refreshes user eligibility based on geo-blocked regions defined in remote feature flag.\n   * Uses fallback configuration when remote feature flag is undefined.\n   * Note: Initial eligibility is set in the constructor if fallback regions are provided.\n   *\n   * @param options - Configuration object\n   * @param options.remoteFeatureFlagControllerState - State from RemoteFeatureFlagController\n   * @param options.context - ServiceContext providing callbacks\n   */\n  refreshEligibility(options: {\n    remoteFeatureFlagControllerState: RemoteFeatureFlagState;\n    context: ServiceContext;\n  }): void {\n    const { remoteFeatureFlagControllerState, context } = options;\n\n    const perpsGeoBlockedRegionsFeatureFlag =\n      // NOTE: Do not use perpsPerpTradingGeoBlockedCountries as it is deprecated.\n      remoteFeatureFlagControllerState.remoteFeatureFlags\n        ?.perpsPerpTradingGeoBlockedCountriesV2;\n\n    const remoteBlockedRegions = (\n      perpsGeoBlockedRegionsFeatureFlag as { blockedRegions?: string[] }\n    )?.blockedRegions;\n\n    if (Array.isArray(remoteBlockedRegions)) {\n      this.setBlockedRegions({\n        list: remoteBlockedRegions,\n        source: 'remote',\n        context,\n      });\n    }\n\n    // Also check for HIP-3 config changes\n    this.refreshHip3Config({ remoteFeatureFlagControllerState, context });\n  }\n\n  /**\n   * Set blocked region list with \"never downgrade\" pattern enforcement.\n   * Updates the blocked region list and triggers eligibility refresh.\n   * Implements \"sticky remote\": once remote regions are set, never downgrade to fallback.\n   *\n   * @param options - Configuration object\n   * @param options.list - Array of blocked region codes\n   * @param options.source - Source of the list ('remote' or 'fallback')\n   * @param options.context - ServiceContext providing callbacks\n   */\n  setBlockedRegions(options: {\n    list: string[];\n    source: 'remote' | 'fallback';\n    context: ServiceContext;\n  }): void {\n    const { list, source, context } = options;\n\n    if (\n      !context.getBlockedRegionList ||\n      !context.setBlockedRegionList ||\n      !context.refreshEligibility\n    ) {\n      throw new Error(\n        'Required blocked region callbacks not available in ServiceContext',\n      );\n    }\n\n    const currentList = context.getBlockedRegionList();\n\n    // Never downgrade from remote to fallback\n    if (source === 'fallback' && currentList.source === 'remote') {\n      return;\n    }\n\n    if (Array.isArray(list)) {\n      context.setBlockedRegionList(list, source);\n    }\n\n    context.refreshEligibility().catch((err) => {\n      const error = err instanceof Error ? err : new Error(String(err));\n      this.deps.logger.error(error, {\n        context: {\n          name: 'FeatureFlagConfigurationService.setBlockedRegions',\n          data: { source },\n        },\n      });\n    });\n  }\n}\n"]}

package/dist/services/FeatureFlagConfigurationService.d.cts

@@ -1,100 +0,0 @@
-import type { ServiceContext } from "./ServiceContext.cjs";
-import type { PerpsPlatformDependencies } from "../types/index.cjs";
-/**
- * Remote feature flags state shape for perps-related flags.
- * This is a minimal type definition to avoid direct dependency on
- * RemoteFeatureFlagController which can cause build issues.
- */
-type RemoteFeatureFlagState = {
-    remoteFeatureFlags: Record<string, unknown>;
-};
-/**
- * FeatureFlagConfigurationService
- *
- * Handles HIP-3 configuration and geo-blocking configuration from remote feature flags.
- * Implements "sticky remote" pattern: once remote config is loaded, never downgrade to fallback.
- * Orchestrates validation, change detection, and version management for feature flag updates.
- *
- * Responsibilities:
- * - Remote feature flag validation and parsing
- * - HIP-3 configuration management (equity, allowlist, blocklist)
- * - Geo-blocking configuration from remote flags
- * - Change detection and version management
- * - "Sticky remote" pattern enforcement (never downgrade)
- *
- * Instance-based service with constructor injection of platform dependencies.
- */
-export declare class FeatureFlagConfigurationService {
-    private readonly deps;
-    /**
-     * Create a new FeatureFlagConfigurationService instance.
-     *
-     * @param deps - Platform dependencies for logging, metrics, etc.
-     */
-    constructor(deps: PerpsPlatformDependencies);
-    /**
-     * Validate and parse market list from remote feature flags.
-     * Handles both string (comma-separated) and array formats from LaunchDarkly.
-     *
-     * @param remoteValue - The raw value from remote feature flags
-     * @param fieldName - The name of the field for logging
-     * @param currentValue - The current value to use as fallback
-     * @returns The validated market list or undefined if validation fails
-     */
-    private validateMarketList;
-    /**
-     * Check if arrays have different values (order-independent comparison).
-     *
-     * @param a - First array
-     * @param b - Second array
-     * @returns True if arrays have different values
-     */
-    private arraysHaveDifferentValues;
-    /**
-     * Refresh HIP-3 configuration when remote feature flags change.
-     * This method extracts HIP-3 settings from remote flags, validates them,
-     * and updates internal state if they differ from current values.
-     * When config changes, increments hip3ConfigVersion to trigger ConnectionManager reconnection.
-     *
-     * Follows the "sticky remote" pattern: once remote config is loaded, never downgrade to fallback.
-     *
-     * @param options - Configuration object
-     * @param options.remoteFeatureFlagControllerState - State from RemoteFeatureFlagController
-     * @param options.context - ServiceContext providing state access callbacks
-     */
-    refreshHip3Config(options: {
-        remoteFeatureFlagControllerState: RemoteFeatureFlagState;
-        context: ServiceContext;
-    }): void;
-    /**
-     * Respond to RemoteFeatureFlagController state changes.
-     * Refreshes user eligibility based on geo-blocked regions defined in remote feature flag.
-     * Uses fallback configuration when remote feature flag is undefined.
-     * Note: Initial eligibility is set in the constructor if fallback regions are provided.
-     *
-     * @param options - Configuration object
-     * @param options.remoteFeatureFlagControllerState - State from RemoteFeatureFlagController
-     * @param options.context - ServiceContext providing callbacks
-     */
-    refreshEligibility(options: {
-        remoteFeatureFlagControllerState: RemoteFeatureFlagState;
-        context: ServiceContext;
-    }): void;
-    /**
-     * Set blocked region list with "never downgrade" pattern enforcement.
-     * Updates the blocked region list and triggers eligibility refresh.
-     * Implements "sticky remote": once remote regions are set, never downgrade to fallback.
-     *
-     * @param options - Configuration object
-     * @param options.list - Array of blocked region codes
-     * @param options.source - Source of the list ('remote' or 'fallback')
-     * @param options.context - ServiceContext providing callbacks
-     */
-    setBlockedRegions(options: {
-        list: string[];
-        source: 'remote' | 'fallback';
-        context: ServiceContext;
-    }): void;
-}
-export {};
-//# sourceMappingURL=FeatureFlagConfigurationService.d.cts.map

package/dist/services/FeatureFlagConfigurationService.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"FeatureFlagConfigurationService.d.cts","sourceRoot":"","sources":["../../src/services/FeatureFlagConfigurationService.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,6BAAyB;AACvD,OAAO,KAAK,EAAE,yBAAyB,EAAE,2BAAiB;AAM1D;;;;GAIG;AACH,KAAK,sBAAsB,GAAG;IAC5B,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C,CAAC;AAsCF;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,+BAA+B;IAC1C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA4B;IAEjD;;;;OAIG;gBACS,IAAI,EAAE,yBAAyB;IAI3C;;;;;;;;OAQG;IACH,OAAO,CAAC,kBAAkB;IA8D1B;;;;;;OAMG;IACH,OAAO,CAAC,yBAAyB;IASjC;;;;;;;;;;;OAWG;IACH,iBAAiB,CAAC,OAAO,EAAE;QACzB,gCAAgC,EAAE,sBAAsB,CAAC;QACzD,OAAO,EAAE,cAAc,CAAC;KACzB,GAAG,IAAI;IA0HR;;;;;;;;;OASG;IACH,kBAAkB,CAAC,OAAO,EAAE;QAC1B,gCAAgC,EAAE,sBAAsB,CAAC;QACzD,OAAO,EAAE,cAAc,CAAC;KACzB,GAAG,IAAI;IAwBR;;;;;;;;;OASG;IACH,iBAAiB,CAAC,OAAO,EAAE;QACzB,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;QAC9B,OAAO,EAAE,cAAc,CAAC;KACzB,GAAG,IAAI;CAkCT"}

package/dist/services/FeatureFlagConfigurationService.d.mts

@@ -1,100 +0,0 @@
-import type { ServiceContext } from "./ServiceContext.mjs";
-import type { PerpsPlatformDependencies } from "../types/index.mjs";
-/**
- * Remote feature flags state shape for perps-related flags.
- * This is a minimal type definition to avoid direct dependency on
- * RemoteFeatureFlagController which can cause build issues.
- */
-type RemoteFeatureFlagState = {
-    remoteFeatureFlags: Record<string, unknown>;
-};
-/**
- * FeatureFlagConfigurationService
- *
- * Handles HIP-3 configuration and geo-blocking configuration from remote feature flags.
- * Implements "sticky remote" pattern: once remote config is loaded, never downgrade to fallback.
- * Orchestrates validation, change detection, and version management for feature flag updates.
- *
- * Responsibilities:
- * - Remote feature flag validation and parsing
- * - HIP-3 configuration management (equity, allowlist, blocklist)
- * - Geo-blocking configuration from remote flags
- * - Change detection and version management
- * - "Sticky remote" pattern enforcement (never downgrade)
- *
- * Instance-based service with constructor injection of platform dependencies.
- */
-export declare class FeatureFlagConfigurationService {
-    private readonly deps;
-    /**
-     * Create a new FeatureFlagConfigurationService instance.
-     *
-     * @param deps - Platform dependencies for logging, metrics, etc.
-     */
-    constructor(deps: PerpsPlatformDependencies);
-    /**
-     * Validate and parse market list from remote feature flags.
-     * Handles both string (comma-separated) and array formats from LaunchDarkly.
-     *
-     * @param remoteValue - The raw value from remote feature flags
-     * @param fieldName - The name of the field for logging
-     * @param currentValue - The current value to use as fallback
-     * @returns The validated market list or undefined if validation fails
-     */
-    private validateMarketList;
-    /**
-     * Check if arrays have different values (order-independent comparison).
-     *
-     * @param a - First array
-     * @param b - Second array
-     * @returns True if arrays have different values
-     */
-    private arraysHaveDifferentValues;
-    /**
-     * Refresh HIP-3 configuration when remote feature flags change.
-     * This method extracts HIP-3 settings from remote flags, validates them,
-     * and updates internal state if they differ from current values.
-     * When config changes, increments hip3ConfigVersion to trigger ConnectionManager reconnection.
-     *
-     * Follows the "sticky remote" pattern: once remote config is loaded, never downgrade to fallback.
-     *
-     * @param options - Configuration object
-     * @param options.remoteFeatureFlagControllerState - State from RemoteFeatureFlagController
-     * @param options.context - ServiceContext providing state access callbacks
-     */
-    refreshHip3Config(options: {
-        remoteFeatureFlagControllerState: RemoteFeatureFlagState;
-        context: ServiceContext;
-    }): void;
-    /**
-     * Respond to RemoteFeatureFlagController state changes.
-     * Refreshes user eligibility based on geo-blocked regions defined in remote feature flag.
-     * Uses fallback configuration when remote feature flag is undefined.
-     * Note: Initial eligibility is set in the constructor if fallback regions are provided.
-     *
-     * @param options - Configuration object
-     * @param options.remoteFeatureFlagControllerState - State from RemoteFeatureFlagController
-     * @param options.context - ServiceContext providing callbacks
-     */
-    refreshEligibility(options: {
-        remoteFeatureFlagControllerState: RemoteFeatureFlagState;
-        context: ServiceContext;
-    }): void;
-    /**
-     * Set blocked region list with "never downgrade" pattern enforcement.
-     * Updates the blocked region list and triggers eligibility refresh.
-     * Implements "sticky remote": once remote regions are set, never downgrade to fallback.
-     *
-     * @param options - Configuration object
-     * @param options.list - Array of blocked region codes
-     * @param options.source - Source of the list ('remote' or 'fallback')
-     * @param options.context - ServiceContext providing callbacks
-     */
-    setBlockedRegions(options: {
-        list: string[];
-        source: 'remote' | 'fallback';
-        context: ServiceContext;
-    }): void;
-}
-export {};
-//# sourceMappingURL=FeatureFlagConfigurationService.d.mts.map

package/dist/services/FeatureFlagConfigurationService.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"FeatureFlagConfigurationService.d.mts","sourceRoot":"","sources":["../../src/services/FeatureFlagConfigurationService.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,6BAAyB;AACvD,OAAO,KAAK,EAAE,yBAAyB,EAAE,2BAAiB;AAM1D;;;;GAIG;AACH,KAAK,sBAAsB,GAAG;IAC5B,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C,CAAC;AAsCF;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,+BAA+B;IAC1C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA4B;IAEjD;;;;OAIG;gBACS,IAAI,EAAE,yBAAyB;IAI3C;;;;;;;;OAQG;IACH,OAAO,CAAC,kBAAkB;IA8D1B;;;;;;OAMG;IACH,OAAO,CAAC,yBAAyB;IASjC;;;;;;;;;;;OAWG;IACH,iBAAiB,CAAC,OAAO,EAAE;QACzB,gCAAgC,EAAE,sBAAsB,CAAC;QACzD,OAAO,EAAE,cAAc,CAAC;KACzB,GAAG,IAAI;IA0HR;;;;;;;;;OASG;IACH,kBAAkB,CAAC,OAAO,EAAE;QAC1B,gCAAgC,EAAE,sBAAsB,CAAC;QACzD,OAAO,EAAE,cAAc,CAAC;KACzB,GAAG,IAAI;IAwBR;;;;;;;;;OASG;IACH,iBAAiB,CAAC,OAAO,EAAE;QACzB,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;QAC9B,OAAO,EAAE,cAAc,CAAC;KACzB,GAAG,IAAI;CAkCT"}