@metamask-previews/perps-controller 0.0.0-preview-ce3ee897a → 0.0.0-preview-e4aa1532

package/dist/services/FeatureFlagConfigurationService.mjs

@@ -0,0 +1,254 @@
+/* eslint-disable id-denylist, no-restricted-syntax, no-negated-condition */
+// TODO: Fix ESLint errors in this file - tracked for Phase 5 cleanup
+import { hasProperty } from "@metamask/utils";
+import { parseCommaSeparatedString, stripQuotes } from "../utils/stringParseUtils.mjs";
+/**
+ * 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.
+ */
+export 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 = parseCommaSeparatedString(remoteValue).map(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) => 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 = hasProperty(remoteFlags, 'perpsHip3AllowlistMarkets')
+            ? this.validateMarketList(remoteFlags.perpsHip3AllowlistMarkets, 'allowlistMarkets', currentConfig.allowlistMarkets)
+            : undefined;
+        const validatedBlocklistMarkets = 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 },
+                },
+            });
+        });
+    }
+}
+//# sourceMappingURL=FeatureFlagConfigurationService.mjs.map

package/dist/services/FeatureFlagConfigurationService.mjs.map

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