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

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

@@ -1 +0,0 @@
-{"version":3,"file":"remote-feature-flag-controller.mjs","sourceRoot":"","sources":["../src/remote-feature-flag-controller.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,OAAO,EACL,cAAc,EAEf,kCAAkC;AAGnC,OAAO,EAAE,oBAAoB,EAAE,wBAAwB;AAUvD,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC5B,4CAA2C;AAC5C,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,4BAA2B;AAE1E,kBAAkB;AAElB,MAAM,CAAC,MAAM,cAAc,GAAG,6BAA6B,CAAC;AAC5D,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,QAAQ;AAanE,MAAM,mCAAmC,GAAG;IAC1C,kBAAkB,EAAE;QAClB,kBAAkB,EAAE,IAAI;QACxB,OAAO,EAAE,IAAI;QACb,sBAAsB,EAAE,IAAI;QAC5B,QAAQ,EAAE,IAAI;KACf;IACD,cAAc,EAAE;QACd,kBAAkB,EAAE,IAAI;QACxB,OAAO,EAAE,IAAI;QACb,sBAAsB,EAAE,IAAI;QAC5B,QAAQ,EAAE,IAAI;KACf;IACD,qBAAqB,EAAE;QACrB,kBAAkB,EAAE,IAAI;QACxB,OAAO,EAAE,IAAI;QACb,sBAAsB,EAAE,IAAI;QAC5B,QAAQ,EAAE,KAAK;KAChB;IACD,cAAc,EAAE;QACd,kBAAkB,EAAE,IAAI;QACxB,OAAO,EAAE,IAAI;QACb,sBAAsB,EAAE,IAAI;QAC5B,QAAQ,EAAE,KAAK;KAChB;IACD,cAAc,EAAE;QACd,kBAAkB,EAAE,KAAK;QACzB,OAAO,EAAE,IAAI;QACb,sBAAsB,EAAE,KAAK;QAC7B,QAAQ,EAAE,KAAK;KAChB;IACD,0BAA0B,EAAE;QAC1B,kBAAkB,EAAE,IAAI;QACxB,OAAO,EAAE,IAAI;QACb,sBAAsB,EAAE,IAAI;QAC5B,QAAQ,EAAE,KAAK;KAChB;CACF,CAAC;AAEF,oBAAoB;AAEpB,MAAM,yBAAyB,GAAG;IAChC,uBAAuB;IACvB,SAAS;IACT,QAAQ;IACR,oBAAoB;IACpB,iBAAiB;IACjB,0BAA0B;CAClB,CAAC;AA2BX;;;;GAIG;AACH,MAAM,UAAU,0CAA0C;IACxD,OAAO;QACL,kBAAkB,EAAE,EAAE;QACtB,cAAc,EAAE,EAAE;QAClB,qBAAqB,EAAE,EAAE;QACzB,cAAc,EAAE,CAAC;KAClB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,mBAAmB,CAC1B,OAAe,EACf,YAAoB;IAEpB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,2BAA2B,CAAC,KAAK,CAAC,EAAE,CAAC;YACxC,SAAS;QACX,CAAC;QACD,MAAM,EAAE,cAAc,EAAE,GAAG,KAAK,CAAC;QACjC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;YACnC,SAAS;QACX,CAAC;QACD,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,CAClC,CAAC,EAAE,EAAE,EAAE,CACL,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,YAAY,CACrE,CAAC;QACF,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,OAAO,2BAA4B,SAAQ,cAIhD;IAqBC;;;;;;;;;;;;;;;OAeG;IACH,YAAY,EACV,SAAS,EACT,KAAK,EACL,sBAAsB,EACtB,aAAa,GAAG,sBAAsB,EACtC,QAAQ,GAAG,KAAK,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,GAAG,EAAE,EACrB,aAAa,EACb,iBAAiB,EACjB,mBAAmB,GAAG,EAAE,GAazB;QACC,IAAI,CAAC,oBAAoB,CAAC,aAAa,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CACb,2BAA2B,aAAa,iDAAiD,CAC1F,CAAC;QACJ,CAAC;QAED,MAAM,YAAY,GAAqC;YACrD,GAAG,0CAA0C,EAAE;YAC/C,GAAG,KAAK;SACT,CAAC;QAEF,MAAM,uBAAuB,GAC3B,oBAAoB,CAAC,iBAAiB,CAAC;YACvC,iBAAiB,KAAK,aAAa,CAAC;QAEtC,KAAK,CAAC;YACJ,IAAI,EAAE,cAAc;YACpB,QAAQ,EAAE,mCAAmC;YAC7C,SAAS;YACT,KAAK,EAAE;gBACL,GAAG,YAAY;gBACf,cAAc,EAAE,uBAAuB;oBACrC,CAAC,CAAC,CAAC;oBACH,CAAC,CAAC,YAAY,CAAC,cAAc;aAChC;SACF,CAAC,CAAC;;QAtFI,6DAAuB;QAEhC,wDAAmB;QAEV,sEAAwD;QAEjE,oEAAiD;QAExC,gEAAgC;QAEhC,qEAAqC;QAErC,gEAAuC;QAEvC,6DAA8B;QAE9B,mEAAmC;QAE5C,2EAA2C;QAsEzC,uBAAA,IAAI,oDAAwB,mBAAmB,MAAA,CAAC;QAChD,qEAAqE;QACrE,yEAAyE;QACzE,2EAA2E;QAC3E,8DAA8D;QAC9D,uBAAA,IAAI,4DAAgC,YAAY,CAAC,kBAAkB,MAAA,CAAC;QACpE,uBAAA,IAAI,8CAAkB,aAAa,MAAA,CAAC;QACpC,uBAAA,IAAI,yCAAa,QAAQ,MAAA,CAAC;QAC1B,uBAAA,IAAI,uDAA2B,sBAAsB,MAAA,CAAC;QACtD,uBAAA,IAAI,iDAAqB,gBAAgB,MAAA,CAAC;QAC1C,uBAAA,IAAI,sDAA0B,qBAAqB,MAAA,CAAC;QACpD,uBAAA,IAAI,iDAAqB,IAAI,GAAG,CAAC,gBAAgB,CAAC,MAAA,CAAC;QACnD,uBAAA,IAAI,8CAAkB,aAAa,MAAA,CAAC;QAEpC,IAAI,CAAC,SAAS,CAAC,4BAA4B,CACzC,IAAI,EACJ,yBAAyB,CAC1B,CAAC;IACJ,CAAC;IAoCD;;;;;;;OAOG;IACH,KAAK,CAAC,wBAAwB,CAAC,KAAK,GAAG,KAAK;QAC1C,IAAI,uBAAA,IAAI,6CAAU,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,uBAAA,IAAI,2FAAgB,MAApB,IAAI,CAAkB,CAAC,EAAE,CAAC;YAC1D,OAAO;QACT,CAAC;QAED,IAAI,UAAU,CAAC;QAEf,IAAI,uBAAA,IAAI,yDAAsB,EAAE,CAAC;YAC/B,MAAM,uBAAA,IAAI,yDAAsB,CAAC;YACjC,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,uBAAA,IAAI,qDACF,uBAAA,IAAI,2DAAwB,CAAC,uBAAuB,EAAE,MAAA,CAAC;YAEzD,UAAU,GAAG,MAAM,uBAAA,IAAI,yDAAsB,CAAC;QAChD,CAAC;gBAAS,CAAC;YACT,uBAAA,IAAI,qDAAyB,SAAS,MAAA,CAAC;QACzC,CAAC;QAED,MAAM,uBAAA,IAAI,wFAAa,MAAjB,IAAI,EAAc,UAAU,CAAC,kBAAkB,CAAC,CAAC;IACzD,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,IAAI;QACR,MAAM,EAAE,qBAAqB,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;QAC7C,MAAM,wBAAwB,GAC5B,qBAAqB,IAAI,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QAEzE,MAAM,QAAQ,GAAG,wBAAwB;YACvC,CAAC,CAAC,MAAM,uBAAA,IAAI,sGAA2B,MAA/B,IAAI,EAA4B,qBAAqB,CAAC;YAC9D,CAAC,CAAC,SAAS,CAAC;QAEd,uBAAA,IAAI,4DACF,QAAQ,EAAE,cAAc,IAAI,IAAI,CAAC,KAAK,CAAC,kBAAkB,MAAA,CAAC;QAE5D,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE;YACf,OAAO;gBACL,GAAG,IAAI,CAAC,KAAK;gBACb,kBAAkB,EAAE,uBAAA,IAAI,qGAA0B,MAA9B,IAAI,CAA4B;gBACpD,GAAG,CAAC,QAAQ,IAAI;oBACd,cAAc,EAAE,QAAQ,CAAC,cAAc;oBACvC,0BAA0B,EAAE,QAAQ,CAAC,0BAA0B;iBAChE,CAAC;aACH,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IA0LD;;OAEG;IACH,MAAM;QACJ,uBAAA,IAAI,yCAAa,KAAK,MAAA,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,OAAO;QACL,uBAAA,IAAI,yCAAa,IAAI,MAAA,CAAC;IACxB,CAAC;IAED;;;;;OAKG;IACH,eAAe,CAAC,QAAgB,EAAE,KAAW;QAC3C,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE;YACf,MAAM,cAAc,GAAG;gBACrB,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc;gBAC5B,CAAC,QAAQ,CAAC,EAAE,KAAK;aAClB,CAAC;YAEF,OAAO;gBACL,GAAG,IAAI,CAAC,KAAK;gBACb,cAAc;gBACd,kBAAkB,EAAE,uBAAA,IAAI,qGAA0B,MAA9B,IAAI,EAA2B,EAAE,cAAc,EAAE,CAAC;aACvE,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,kBAAkB,CAAC,QAAgB;QACjC,MAAM,iBAAiB,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC;QAC3D,OAAO,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAEnC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE;YACf,OAAO;gBACL,GAAG,IAAI,CAAC,KAAK;gBACb,cAAc,EAAE,iBAAiB;gBACjC,kBAAkB,EAAE,uBAAA,IAAI,qGAA0B,MAA9B,IAAI,EAA2B;oBACjD,cAAc,EAAE,iBAAiB;iBAClC,CAAC;aACH,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,qBAAqB;QACnB,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE;YACf,OAAO;gBACL,GAAG,IAAI,CAAC,KAAK;gBACb,cAAc,EAAE,EAAE;gBAClB,kBAAkB,EAAE,uBAAA,IAAI,qGAA0B,MAA9B,IAAI,EAA2B;oBACjD,cAAc,EAAE,EAAE;iBACnB,CAAC;aACH,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;CACF;ozBAvV2B,EACxB,2BAA2B,GAAG,uBAAA,IAAI,gEAA6B,EAC/D,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,MAIxC,EAAE;IACJ,OAAO;QACL,GAAG,uBAAA,IAAI,wDAAqB;QAC5B,GAAG,2BAA2B;QAC9B,GAAG,cAAc;KAClB,CAAC;AACJ,CAAC;IAQC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,uBAAA,IAAI,kDAAe,CAAC;AACtE,CAAC;AAqED;;;;GAIG;AACH,KAAK,mDAAc,kBAAgC;IACjD,MAAM,QAAQ,GAAG,MAAM,uBAAA,IAAI,sGAA2B,MAA/B,IAAI,EAA4B,kBAAkB,CAAC,CAAC;IAE3E,uBAAA,IAAI,4DAAgC,QAAQ,CAAC,cAAc,MAAA,CAAC;IAE5D,wDAAwD;IACxD,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE;QACf,OAAO;YACL,GAAG,IAAI,CAAC,KAAK;YACb,kBAAkB,EAAE,uBAAA,IAAI,qGAA0B,MAA9B,IAAI,EAA2B;gBACjD,2BAA2B,EAAE,QAAQ,CAAC,cAAc;aACrD,CAAC;YACF,qBAAqB,EAAE,kBAAkB;YACzC,cAAc,EAAE,IAAI,CAAC,GAAG,EAAE;YAC1B,cAAc,EAAE,QAAQ,CAAC,cAAc;YACvC,0BAA0B,EAAE,QAAQ,CAAC,0BAA0B;SAChE,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,uHAQwB,SAAe;IACtC,IAAI,CAAC,oBAAoB,CAAC,SAAS,CAAC,EAAE,CAAC;QACrC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,cAAc,CAAC,SAAS,EAAE,uBAAA,IAAI,kDAAe,CAAC,CAAC;AACxD,CAAC,2GAUkB,eAAuB;IACxC,IAAI,uBAAA,IAAI,qDAAkB,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC;QAChD,OAAO,uBAAA,IAAI,qDAAkB,MAAtB,IAAI,CAAoB,CAAC;IAClC,CAAC;IACD,OAAO,uBAAA,IAAI,0DAAuB,MAA3B,IAAI,CAAyB,CAAC;AACvC,CAAC;AAED;;;;;;;;GAQG;AACH,KAAK,iEAA4B,kBAAgC;IAK/D,MAAM,cAAc,GAAiB,EAAE,CAAC;IACxC,MAAM,aAAa,GAAG,uBAAA,IAAI,qDAAkB,MAAtB,IAAI,CAAoB,CAAC;IAC/C,MAAM,qBAAqB,GAA2B,EAAE,CAAC;IACzD,MAAM,0BAA0B,GAA2B,EAAE,CAAC;IAE9D,KAAK,MAAM,CACT,qBAAqB,EACrB,sBAAsB,EACvB,IAAI,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACxC,IAAI,cAAc,GAAG,uBAAA,IAAI,oGAAyB,MAA7B,IAAI,EACvB,sBAAsB,CACvB,CAAC;QACF,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;YAC5B,SAAS;QACX,CAAC;QAED,IAAI,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;YAClC,mFAAmF;YACnF,MAAM,kBAAkB,GAAG,cAAc,CAAC,IAAI,CAC5C,2BAA2B,CAC5B,CAAC;YAEF,IAAI,CAAC,kBAAkB,EAAE,CAAC;gBACxB,yCAAyC;gBACzC,cAAc,CAAC,qBAAqB,CAAC,GAAG,cAAc,CAAC;gBACvD,SAAS;YACX,CAAC;YAED,0EAA0E;YAC1E,MAAM,uBAAuB,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YACnE,MAAM,aAAa,GAAG,uBAAuB;gBAC3C,CAAC,CAAC,mBAAmB,CAAC,cAAc,EAAE,uBAAuB,CAAC;gBAC9D,CAAC,CAAC,SAAS,CAAC;YAEd,IAAI,aAAa,EAAE,CAAC;gBAClB,cAAc,GAAG,aAAa,CAAC,KAAK,CAAC;gBACrC,IAAI,aAAa,CAAC,IAAI,EAAE,CAAC;oBACvB,0BAA0B,CAAC,qBAAqB,CAAC;wBAC/C,aAAa,CAAC,IAAI,CAAC;gBACvB,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,MAAM,cAAc,GAAG,uBAAA,IAAI,8FAAmB,MAAvB,IAAI,EAAoB,qBAAqB,CAAC,CAAC;gBAEtE,IAAI,CAAC,cAAc,EAAE,CAAC;oBACpB,cAAc,CAAC,qBAAqB,CAAC,GAAG,cAAc,CAAC;oBACvD,SAAS;gBACX,CAAC;gBAED,yDAAyD;gBACzD,MAAM,QAAQ,GACZ,GAAG,cAAc,IAAI,qBAAqB,EAAW,CAAC;gBACxD,IAAI,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC,QAAQ,CAAC,CAAC;gBAE3D,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;oBACjC,cAAc,GAAG,MAAM,yBAAyB,CAC9C,cAAc,EACd,qBAAqB,CACtB,CAAC;oBAEF,iDAAiD;oBACjD,qBAAqB,CAAC,QAAQ,CAAC,GAAG,cAAc,CAAC;gBACnD,CAAC;gBAED,MAAM,SAAS,GAAG,cAAc,CAAC;gBACjC,MAAM,aAAa,GAAG,cAAc,CAAC,IAAI,CACvC,CAAC,WAAW,EAAwC,EAAE;oBACpD,IAAI,CAAC,2BAA2B,CAAC,WAAW,CAAC,EAAE,CAAC;wBAC9C,OAAO,KAAK,CAAC;oBACf,CAAC;oBAED,OAAO,SAAS,IAAI,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC;gBAC9C,CAAC,CACF,CAAC;gBAEF,IAAI,aAAa,EAAE,CAAC;oBAClB,cAAc,GAAG,aAAa,CAAC,KAAK,CAAC;oBACrC,IAAI,aAAa,CAAC,IAAI,EAAE,CAAC;wBACvB,0BAA0B,CAAC,qBAAqB,CAAC;4BAC/C,aAAa,CAAC,IAAI,CAAC;oBACvB,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,cAAc,CAAC,qBAAqB,CAAC,GAAG,cAAc,CAAC;IACzD,CAAC;IAED,MAAM,cAAc,GAAG;QACrB,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc;QAC5B,GAAG,qBAAqB;KACzB,CAAC;IAEF,wEAAwE;IACxE,oDAAoD;IACpD,MAAM,kBAAkB,GAAG,uBAAA,IAAI,0DAAuB,MAA3B,IAAI,CAAyB,CAAC;IACzD,MAAM,gBAAgB,GAAG,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IACzD,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC;QACnD,MAAM,CAAC,oBAAoB,EAAE,GAAG,mBAAmB,CAAC,GAClD,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACtB,MAAM,cAAc,GAAG,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrD,IACE,CAAC,oBAAoB,KAAK,aAAa;YACrC,oBAAoB,KAAK,kBAAkB,CAAC;YAC9C,CAAC,gBAAgB,CAAC,QAAQ,CAAC,cAAc,CAAC,EAC1C,CAAC;YACD,OAAO,cAAc,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED,OAAO;QACL,cAAc;QACd,cAAc;QACd,0BAA0B;KAC3B,CAAC;AACJ,CAAC","sourcesContent":["import {\n  BaseController,\n  ControllerGetStateAction,\n} from '@metamask/base-controller';\nimport type { ControllerStateChangeEvent } from '@metamask/base-controller';\nimport type { Messenger } from '@metamask/messenger';\nimport { isValidSemVerVersion } from '@metamask/utils';\nimport type { Json, SemVerVersion } from '@metamask/utils';\n\nimport type { AbstractClientConfigApiService } from './client-config-api-service/abstract-client-config-api-service.js';\nimport type { RemoteFeatureFlagControllerMethodActions } from './remote-feature-flag-controller-method-action-types.js';\nimport type {\n  FeatureFlags,\n  ServiceResponse,\n  FeatureFlagScopeValue,\n} from './remote-feature-flag-controller-types.js';\nimport {\n  calculateThresholdForFlag,\n  isFeatureFlagWithScopeValue,\n} from './utils/user-segmentation-utils.js';\nimport { isVersionFeatureFlag, getVersionData } from './utils/version.js';\n\n// === GENERAL ===\n\nexport const controllerName = 'RemoteFeatureFlagController';\nexport const DEFAULT_CACHE_DURATION = 24 * 60 * 60 * 1000; // 1 day\n\n// === STATE ===\n\nexport type RemoteFeatureFlagControllerState = {\n  remoteFeatureFlags: FeatureFlags;\n  localOverrides?: FeatureFlags;\n  rawRemoteFeatureFlags?: FeatureFlags;\n  cacheTimestamp: number;\n  thresholdCache?: Record<string, number>;\n  featureFlagThresholdGroups?: Record<string, string>;\n};\n\nconst remoteFeatureFlagControllerMetadata = {\n  remoteFeatureFlags: {\n    includeInStateLogs: true,\n    persist: true,\n    includeInDebugSnapshot: true,\n    usedInUi: true,\n  },\n  localOverrides: {\n    includeInStateLogs: true,\n    persist: true,\n    includeInDebugSnapshot: true,\n    usedInUi: true,\n  },\n  rawRemoteFeatureFlags: {\n    includeInStateLogs: true,\n    persist: true,\n    includeInDebugSnapshot: true,\n    usedInUi: false,\n  },\n  cacheTimestamp: {\n    includeInStateLogs: true,\n    persist: true,\n    includeInDebugSnapshot: true,\n    usedInUi: false,\n  },\n  thresholdCache: {\n    includeInStateLogs: false,\n    persist: true,\n    includeInDebugSnapshot: false,\n    usedInUi: false,\n  },\n  featureFlagThresholdGroups: {\n    includeInStateLogs: true,\n    persist: true,\n    includeInDebugSnapshot: true,\n    usedInUi: false,\n  },\n};\n\n// === MESSENGER ===\n\nconst MESSENGER_EXPOSED_METHODS = [\n  'clearAllFlagOverrides',\n  'disable',\n  'enable',\n  'removeFlagOverride',\n  'setFlagOverride',\n  'updateRemoteFeatureFlags',\n] as const;\n\nexport type RemoteFeatureFlagControllerGetStateAction =\n  ControllerGetStateAction<\n    typeof controllerName,\n    RemoteFeatureFlagControllerState\n  >;\n\nexport type RemoteFeatureFlagControllerActions =\n  | RemoteFeatureFlagControllerGetStateAction\n  | RemoteFeatureFlagControllerMethodActions;\n\nexport type RemoteFeatureFlagControllerStateChangeEvent =\n  ControllerStateChangeEvent<\n    typeof controllerName,\n    RemoteFeatureFlagControllerState\n  >;\n\nexport type RemoteFeatureFlagControllerEvents =\n  RemoteFeatureFlagControllerStateChangeEvent;\n\nexport type RemoteFeatureFlagControllerMessenger = Messenger<\n  typeof controllerName,\n  RemoteFeatureFlagControllerActions,\n  RemoteFeatureFlagControllerEvents\n>;\n\n/**\n * Returns the default state for the RemoteFeatureFlagController.\n *\n * @returns The default controller state.\n */\nexport function getDefaultRemoteFeatureFlagControllerState(): RemoteFeatureFlagControllerState {\n  return {\n    remoteFeatureFlags: {},\n    localOverrides: {},\n    rawRemoteFeatureFlags: {},\n    cacheTimestamp: 0,\n  };\n}\n\n/**\n * Searches threshold entries for an explicit MetaMetrics ID match.\n * Returns the first entry whose `metaMetricsIds` list contains the given\n * normalized ID. Entries with malformed `metaMetricsIds` (not an array) are\n * skipped without throwing.\n *\n * @param entries - The array of raw threshold entries for a feature flag.\n * @param normalizedId - The current user's MetaMetrics ID, already trimmed and\n * lower-cased.\n * @returns The first matching entry, or `undefined` if none match.\n */\nfunction findExplicitIdMatch(\n  entries: Json[],\n  normalizedId: string,\n): FeatureFlagScopeValue | undefined {\n  for (const entry of entries) {\n    if (!isFeatureFlagWithScopeValue(entry)) {\n      continue;\n    }\n    const { metaMetricsIds } = entry;\n    if (!Array.isArray(metaMetricsIds)) {\n      continue;\n    }\n    const hasMatch = metaMetricsIds.some(\n      (id) =>\n        typeof id === 'string' && id.trim().toLowerCase() === normalizedId,\n    );\n    if (hasMatch) {\n      return entry;\n    }\n  }\n  return undefined;\n}\n\n/**\n * The RemoteFeatureFlagController manages the retrieval and caching of remote feature flags.\n * It fetches feature flags from a remote API, caches them, and provides methods to access\n * and manage these flags. The controller ensures that feature flags are refreshed based on\n * a specified interval and handles cases where the controller is disabled or the network is unavailable.\n */\nexport class RemoteFeatureFlagController extends BaseController<\n  typeof controllerName,\n  RemoteFeatureFlagControllerState,\n  RemoteFeatureFlagControllerMessenger\n> {\n  readonly #fetchInterval: number;\n\n  #disabled: boolean;\n\n  readonly #clientConfigApiService: AbstractClientConfigApiService;\n\n  #inProgressFlagUpdate?: Promise<ServiceResponse>;\n\n  readonly #getMetaMetricsId: () => string;\n\n  readonly #getCanonicalProfileId: () => string;\n\n  readonly #metaMetricsFlags: ReadonlySet<string>;\n\n  readonly #clientVersion: SemVerVersion;\n\n  readonly #defaultFeatureFlags: FeatureFlags;\n\n  #processedRemoteFeatureFlags: FeatureFlags;\n\n  /**\n   * Constructs a new RemoteFeatureFlagController instance.\n   *\n   * @param options - The controller options.\n   * @param options.messenger - The messenger used for communication.\n   * @param options.state - The initial state of the controller.\n   * @param options.clientConfigApiService - The service instance to fetch remote feature flags.\n   * @param options.fetchInterval - The interval in milliseconds before cached flags expire. Defaults to 1 day.\n   * @param options.disabled - Determines if the controller should be disabled initially. Defaults to false.\n   * @param options.getMetaMetricsId - Returns metaMetricsId.\n   * @param options.getCanonicalProfileId - Returns the canonical profile identifier used for threshold flags by default. Must return an empty string, rather than throwing, when the identifier is unavailable.\n   * @param options.metaMetricsFlags - Names of feature flags that should use MetaMetrics ID for threshold assignment.\n   * @param options.clientVersion - The current client version for version-based feature flag filtering. Must be a valid 3-part SemVer version string.\n   * @param options.prevClientVersion - The previous client version for feature flag cache invalidation.\n   * @param options.defaultFeatureFlags - Client-side default feature flags used as the lowest-precedence layer under processed remote flags and local overrides. Not persisted.\n   */\n  constructor({\n    messenger,\n    state,\n    clientConfigApiService,\n    fetchInterval = DEFAULT_CACHE_DURATION,\n    disabled = false,\n    getMetaMetricsId,\n    getCanonicalProfileId,\n    metaMetricsFlags = [],\n    clientVersion,\n    prevClientVersion,\n    defaultFeatureFlags = {},\n  }: {\n    messenger: RemoteFeatureFlagControllerMessenger;\n    state?: Partial<RemoteFeatureFlagControllerState>;\n    clientConfigApiService: AbstractClientConfigApiService;\n    getMetaMetricsId: () => string;\n    getCanonicalProfileId: () => string;\n    metaMetricsFlags?: readonly string[];\n    fetchInterval?: number;\n    disabled?: boolean;\n    clientVersion: string;\n    prevClientVersion?: string;\n    defaultFeatureFlags?: FeatureFlags;\n  }) {\n    if (!isValidSemVerVersion(clientVersion)) {\n      throw new Error(\n        `Invalid clientVersion: \"${clientVersion}\". Must be a valid 3-part SemVer version string`,\n      );\n    }\n\n    const initialState: RemoteFeatureFlagControllerState = {\n      ...getDefaultRemoteFeatureFlagControllerState(),\n      ...state,\n    };\n\n    const hasClientVersionChanged =\n      isValidSemVerVersion(prevClientVersion) &&\n      prevClientVersion !== clientVersion;\n\n    super({\n      name: controllerName,\n      metadata: remoteFeatureFlagControllerMetadata,\n      messenger,\n      state: {\n        ...initialState,\n        cacheTimestamp: hasClientVersionChanged\n          ? 0\n          : initialState.cacheTimestamp,\n      },\n    });\n\n    this.#defaultFeatureFlags = defaultFeatureFlags;\n    // Last session's effective flags stand in for the remote layer until\n    // `init` re-derives it from the persisted raw flags, or a fetch replaces\n    // it. Overrides are layered on top rather than subtracted out, so a remote\n    // flag that happens to share an override's value is not lost.\n    this.#processedRemoteFeatureFlags = initialState.remoteFeatureFlags;\n    this.#fetchInterval = fetchInterval;\n    this.#disabled = disabled;\n    this.#clientConfigApiService = clientConfigApiService;\n    this.#getMetaMetricsId = getMetaMetricsId;\n    this.#getCanonicalProfileId = getCanonicalProfileId;\n    this.#metaMetricsFlags = new Set(metaMetricsFlags);\n    this.#clientVersion = clientVersion;\n\n    this.messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n  }\n\n  /**\n   * Computes effective feature flags with precedence:\n   * defaults < processed remote < local overrides.\n   *\n   * @param options - The layers to merge. Each defaults to the current layer.\n   * @param options.processedRemoteFeatureFlags - The processed remote feature\n   * flags. Defaults to the currently resolved remote layer.\n   * @param options.localOverrides - Local overrides. Defaults to current state\n   * overrides.\n   * @returns The effective feature flags.\n   */\n  #getEffectiveFeatureFlags({\n    processedRemoteFeatureFlags = this.#processedRemoteFeatureFlags,\n    localOverrides = this.state.localOverrides,\n  }: {\n    processedRemoteFeatureFlags?: FeatureFlags;\n    localOverrides?: FeatureFlags;\n  } = {}): FeatureFlags {\n    return {\n      ...this.#defaultFeatureFlags,\n      ...processedRemoteFeatureFlags,\n      ...localOverrides,\n    };\n  }\n\n  /**\n   * Checks if the cached feature flags are expired based on the fetch interval.\n   *\n   * @returns Whether the cache is expired (`true`) or still valid (`false`).\n   */\n  #isCacheExpired(): boolean {\n    return Date.now() - this.state.cacheTimestamp > this.#fetchInterval;\n  }\n\n  /**\n   * Retrieves the remote feature flags, fetching from the API if necessary.\n   * Uses caching to prevent redundant API calls and handles concurrent fetches.\n   *\n   * @param force - When `true`, fetch even if the cache has not expired.\n   * Defaults to `false`. Has no effect when the controller is disabled.\n   * @returns A promise that resolves to the current set of feature flags.\n   */\n  async updateRemoteFeatureFlags(force = false): Promise<void> {\n    if (this.#disabled || (!force && !this.#isCacheExpired())) {\n      return;\n    }\n\n    let serverData;\n\n    if (this.#inProgressFlagUpdate) {\n      await this.#inProgressFlagUpdate;\n      return;\n    }\n\n    try {\n      this.#inProgressFlagUpdate =\n        this.#clientConfigApiService.fetchRemoteFeatureFlags();\n\n      serverData = await this.#inProgressFlagUpdate;\n    } finally {\n      this.#inProgressFlagUpdate = undefined;\n    }\n\n    await this.#updateCache(serverData.remoteFeatureFlags);\n  }\n\n  /**\n   * Computes the effective feature flags, re-deriving the remote layer from the\n   * raw flags already in state. Threshold selection needs to await a hash and\n   * so cannot run in the constructor, which is why this cannot be part of\n   * construction. Clients must call this once after constructing the\n   * controller.\n   *\n   * When there are no persisted raw flags, as on a fresh install or for state\n   * persisted before raw flags were stored, the previous session's flags stand\n   * in for the remote layer so that nothing is lost.\n   */\n  async init(): Promise<void> {\n    const { rawRemoteFeatureFlags } = this.state;\n    const hasRawRemoteFeatureFlags =\n      rawRemoteFeatureFlags && Object.keys(rawRemoteFeatureFlags).length > 0;\n\n    const resolved = hasRawRemoteFeatureFlags\n      ? await this.#processRemoteFeatureFlags(rawRemoteFeatureFlags)\n      : undefined;\n\n    this.#processedRemoteFeatureFlags =\n      resolved?.processedFlags ?? this.state.remoteFeatureFlags;\n\n    this.update(() => {\n      return {\n        ...this.state,\n        remoteFeatureFlags: this.#getEffectiveFeatureFlags(),\n        ...(resolved && {\n          thresholdCache: resolved.thresholdCache,\n          featureFlagThresholdGroups: resolved.featureFlagThresholdGroups,\n        }),\n      };\n    });\n  }\n\n  /**\n   * Updates the controller's state with new feature flags and resets the cache timestamp.\n   *\n   * @param remoteFeatureFlags - The new feature flags to cache.\n   */\n  async #updateCache(remoteFeatureFlags: FeatureFlags): Promise<void> {\n    const resolved = await this.#processRemoteFeatureFlags(remoteFeatureFlags);\n\n    this.#processedRemoteFeatureFlags = resolved.processedFlags;\n\n    // Single state update with all changes batched together\n    this.update(() => {\n      return {\n        ...this.state,\n        remoteFeatureFlags: this.#getEffectiveFeatureFlags({\n          processedRemoteFeatureFlags: resolved.processedFlags,\n        }),\n        rawRemoteFeatureFlags: remoteFeatureFlags,\n        cacheTimestamp: Date.now(),\n        thresholdCache: resolved.thresholdCache,\n        featureFlagThresholdGroups: resolved.featureFlagThresholdGroups,\n      };\n    });\n  }\n\n  /**\n   * Processes a version-based feature flag to get the appropriate value for the current client version.\n   *\n   * @param flagValue - The feature flag value to process\n   * @returns The processed value, or null if no version qualifies (skip this flag)\n   */\n  #processVersionBasedFlag(flagValue: Json): Json | null {\n    if (!isVersionFeatureFlag(flagValue)) {\n      return flagValue;\n    }\n\n    return getVersionData(flagValue, this.#clientVersion);\n  }\n\n  /**\n   * Selects the identifier used to bucket a threshold flag. Flags named in\n   * `metaMetricsFlags` segment by MetaMetrics ID; all others segment by\n   * canonical profile ID.\n   *\n   * @param featureFlagName - The name of the feature flag being processed.\n   * @returns The segmentation identifier, which may be empty when unavailable.\n   */\n  #getSegmentationId(featureFlagName: string): string {\n    if (this.#metaMetricsFlags.has(featureFlagName)) {\n      return this.#getMetaMetricsId();\n    }\n    return this.#getCanonicalProfileId();\n  }\n\n  /**\n   * Resolves raw feature flags into the values that apply to this client and\n   * user, selecting version and threshold entries and reconciling the\n   * threshold cache against the flags the server currently serves.\n   *\n   * @param remoteFeatureFlags - The unprocessed feature flags.\n   * @returns The processed flags, the updated threshold cache, and the\n   * selected threshold group names.\n   */\n  async #processRemoteFeatureFlags(remoteFeatureFlags: FeatureFlags): Promise<{\n    processedFlags: FeatureFlags;\n    thresholdCache: Record<string, number>;\n    featureFlagThresholdGroups: Record<string, string>;\n  }> {\n    const processedFlags: FeatureFlags = {};\n    const metaMetricsId = this.#getMetaMetricsId();\n    const thresholdCacheUpdates: Record<string, number> = {};\n    const featureFlagThresholdGroups: Record<string, string> = {};\n\n    for (const [\n      remoteFeatureFlagName,\n      remoteFeatureFlagValue,\n    ] of Object.entries(remoteFeatureFlags)) {\n      let processedValue = this.#processVersionBasedFlag(\n        remoteFeatureFlagValue,\n      );\n      if (processedValue === null) {\n        continue;\n      }\n\n      if (Array.isArray(processedValue)) {\n        // Validate array has valid threshold items before doing expensive crypto operation\n        const hasValidThresholds = processedValue.some(\n          isFeatureFlagWithScopeValue,\n        );\n\n        if (!hasValidThresholds) {\n          // Not a threshold array - preserve as-is\n          processedFlags[remoteFeatureFlagName] = processedValue;\n          continue;\n        }\n\n        // Explicit-ID matching: check before hash-based threshold, bypasses cache\n        const normalizedMetaMetricsId = metaMetricsId.trim().toLowerCase();\n        const explicitMatch = normalizedMetaMetricsId\n          ? findExplicitIdMatch(processedValue, normalizedMetaMetricsId)\n          : undefined;\n\n        if (explicitMatch) {\n          processedValue = explicitMatch.value;\n          if (explicitMatch.name) {\n            featureFlagThresholdGroups[remoteFeatureFlagName] =\n              explicitMatch.name;\n          }\n        } else {\n          const segmentationId = this.#getSegmentationId(remoteFeatureFlagName);\n\n          if (!segmentationId) {\n            processedFlags[remoteFeatureFlagName] = processedValue;\n            continue;\n          }\n\n          // Fall back to hash-based threshold selection with cache\n          const cacheKey =\n            `${segmentationId}:${remoteFeatureFlagName}` as const;\n          let thresholdValue = this.state.thresholdCache?.[cacheKey];\n\n          if (thresholdValue === undefined) {\n            thresholdValue = await calculateThresholdForFlag(\n              segmentationId,\n              remoteFeatureFlagName,\n            );\n\n            // Collect new threshold for batched state update\n            thresholdCacheUpdates[cacheKey] = thresholdValue;\n          }\n\n          const threshold = thresholdValue;\n          const selectedGroup = processedValue.find(\n            (featureFlag): featureFlag is FeatureFlagScopeValue => {\n              if (!isFeatureFlagWithScopeValue(featureFlag)) {\n                return false;\n              }\n\n              return threshold <= featureFlag.scope.value;\n            },\n          );\n\n          if (selectedGroup) {\n            processedValue = selectedGroup.value;\n            if (selectedGroup.name) {\n              featureFlagThresholdGroups[remoteFeatureFlagName] =\n                selectedGroup.name;\n            }\n          }\n        }\n      }\n\n      processedFlags[remoteFeatureFlagName] = processedValue;\n    }\n\n    const thresholdCache = {\n      ...this.state.thresholdCache,\n      ...thresholdCacheUpdates,\n    };\n\n    // Drop cached thresholds for flags this user is no longer served, under\n    // either identifier they may have been bucketed by.\n    const canonicalProfileId = this.#getCanonicalProfileId();\n    const currentFlagNames = Object.keys(remoteFeatureFlags);\n    for (const cacheKey of Object.keys(thresholdCache)) {\n      const [cachedSegmentationId, ...cachedFlagNameParts] =\n        cacheKey.split(':');\n      const cachedFlagName = cachedFlagNameParts.join(':');\n      if (\n        (cachedSegmentationId === metaMetricsId ||\n          cachedSegmentationId === canonicalProfileId) &&\n        !currentFlagNames.includes(cachedFlagName)\n      ) {\n        delete thresholdCache[cacheKey];\n      }\n    }\n\n    return {\n      processedFlags,\n      thresholdCache,\n      featureFlagThresholdGroups,\n    };\n  }\n\n  /**\n   * Enables the controller, allowing it to make network requests.\n   */\n  enable(): void {\n    this.#disabled = false;\n  }\n\n  /**\n   * Disables the controller, preventing it from making network requests.\n   */\n  disable(): void {\n    this.#disabled = true;\n  }\n\n  /**\n   * Sets a local override for a specific feature flag.\n   *\n   * @param flagName - The name of the feature flag to override.\n   * @param value - The override value for the feature flag.\n   */\n  setFlagOverride(flagName: string, value: Json): void {\n    this.update(() => {\n      const localOverrides = {\n        ...this.state.localOverrides,\n        [flagName]: value,\n      };\n\n      return {\n        ...this.state,\n        localOverrides,\n        remoteFeatureFlags: this.#getEffectiveFeatureFlags({ localOverrides }),\n      };\n    });\n  }\n\n  /**\n   * Clears the local override for a specific feature flag.\n   *\n   * @param flagName - The name of the feature flag to clear.\n   */\n  removeFlagOverride(flagName: string): void {\n    const newLocalOverrides = { ...this.state.localOverrides };\n    delete newLocalOverrides[flagName];\n\n    this.update(() => {\n      return {\n        ...this.state,\n        localOverrides: newLocalOverrides,\n        remoteFeatureFlags: this.#getEffectiveFeatureFlags({\n          localOverrides: newLocalOverrides,\n        }),\n      };\n    });\n  }\n\n  /**\n   * Clears all local feature flag overrides.\n   */\n  clearAllFlagOverrides(): void {\n    this.update(() => {\n      return {\n        ...this.state,\n        localOverrides: {},\n        remoteFeatureFlags: this.#getEffectiveFeatureFlags({\n          localOverrides: {},\n        }),\n      };\n    });\n  }\n}\n"]}

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

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

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

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

package/dist/utils/user-segmentation-utils.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"user-segmentation-utils.d.cts","sourceRoot":"","sources":["../../src/utils/user-segmentation-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,wBAAwB;AAI5C,OAAO,KAAK,EAAE,qBAAqB,EAAE,oDAAmD;AAkBxF;;;;;;;;;GASG;AACH,wBAAsB,yBAAyB,CAC7C,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,MAAM,CAAC,CAsBjB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iCAAiC,CAC/C,aAAa,EAAE,MAAM,GACpB,MAAM,CA0CR;AAED;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,gBACzB,IAAI,yCAOlB,CAAC"}

package/dist/utils/user-segmentation-utils.d.mts

@@ -1,34 +0,0 @@
-import type { Json } from "@metamask/utils";
-import type { FeatureFlagScopeValue } from "../remote-feature-flag-controller-types.mjs";
-/**
- * Calculates a deterministic threshold value between 0 and 1 for A/B testing.
- * This function hashes the segmentation ID combined with the feature flag name
- * to ensure consistent group assignment across sessions while varying across different flags.
- *
- * @param segmentationId - The identifier used for threshold segmentation (must be non-empty)
- * @param featureFlagName - The feature flag name to create unique threshold per flag
- * @returns A promise that resolves to a number between 0 and 1
- * @throws Error if segmentationId is empty
- */
-export declare function calculateThresholdForFlag(segmentationId: string, featureFlagName: string): Promise<number>;
-/**
- * Generates a deterministic random number between 0 and 1 based on a metaMetricsId.
- * This is useful for A/B testing and feature flag rollouts where we want
- * consistent group assignment for the same user.
- *
- * @param metaMetricsId - The unique identifier used to generate the deterministic random number. Must be either:
- * - A UUIDv4 string (e.g., '123e4567-e89b-12d3-a456-426614174000'
- * - A hex string with '0x' prefix (e.g., '0x86bacb9b2bf9a7e8d2b147eadb95ac9aaa26842327cd24afc8bd4b3c1d136420')
- * @returns A number between 0 and 1, deterministically generated from the input ID.
- * The same input will always produce the same output.
- */
-export declare function generateDeterministicRandomNumber(metaMetricsId: string): number;
-/**
- * Type guard to check if a value is a feature flag with scope.
- * Used to validate feature flag objects that contain scope-based configurations.
- *
- * @param featureFlag - The value to check if it's a feature flag with scope
- * @returns True if the value is a feature flag with scope, false otherwise
- */
-export declare const isFeatureFlagWithScopeValue: (featureFlag: Json) => featureFlag is FeatureFlagScopeValue;
-//# sourceMappingURL=user-segmentation-utils.d.mts.map

package/dist/utils/user-segmentation-utils.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"user-segmentation-utils.d.mts","sourceRoot":"","sources":["../../src/utils/user-segmentation-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,wBAAwB;AAI5C,OAAO,KAAK,EAAE,qBAAqB,EAAE,oDAAmD;AAkBxF;;;;;;;;;GASG;AACH,wBAAsB,yBAAyB,CAC7C,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,MAAM,CAAC,CAsBjB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iCAAiC,CAC/C,aAAa,EAAE,MAAM,GACpB,MAAM,CA0CR;AAED;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,gBACzB,IAAI,yCAOlB,CAAC"}

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

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

package/dist/utils/version.cjs

@@ -1,78 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getVersionData = exports.isVersionFeatureFlag = exports.MULTI_VERSION_FLAG_KEYS = void 0;
-const utils_1 = require("@metamask/utils");
-/**
- * Constants for MultiVersionFeatureFlagValue property names
- * to ensure consistency across validation, type checking, and other usage.
- */
-exports.MULTI_VERSION_FLAG_KEYS = {
-    VERSIONS: 'versions',
-};
-/**
- * Checks if a feature flag value is a multi-version gated flag (contains versions object with valid SemVer keys).
- *
- * @param value - The feature flag value to check
- * @returns true if the value is a multi-version feature flag with valid SemVer version keys, false otherwise
- */
-function isVersionFeatureFlag(value) {
-    if (typeof value !== 'object' ||
-        value === null ||
-        Array.isArray(value) ||
-        !(exports.MULTI_VERSION_FLAG_KEYS.VERSIONS in value)) {
-        return false;
-    }
-    const versions = value[exports.MULTI_VERSION_FLAG_KEYS.VERSIONS];
-    if (typeof versions !== 'object' ||
-        versions === null ||
-        Array.isArray(versions)) {
-        return false;
-    }
-    // Validate that all version keys are valid SemVer versions
-    const versionKeys = Object.keys(versions);
-    return versionKeys.every((versionKey) => (0, utils_1.isValidSemVerVersion)(versionKey));
-}
-exports.isVersionFeatureFlag = isVersionFeatureFlag;
-/**
- * Selects the appropriate version value from a multi-version feature flag based on current app version.
- * Returns the value from the highest version that the app version meets or exceeds.
- *
- * @param multiVersionFlag - The multi-version feature flag
- * @param currentAppVersion - The current application version
- * @returns The selected version value, or null if no version requirements are met
- */
-function getVersionData(multiVersionFlag, currentAppVersion) {
-    const sortedVersions = getObjectEntries(multiVersionFlag.versions).sort(([versionA], [versionB]) => {
-        return isVersionAtLeast(versionA, versionB) ? -1 : 1;
-    });
-    for (const [version, data] of sortedVersions) {
-        if (isVersionAtLeast(currentAppVersion, version)) {
-            return data;
-        }
-    }
-    return null;
-}
-exports.getVersionData = getVersionData;
-/**
- * Compares two semantic version strings.
- * Both versions are expected to be valid SemVer format (e.g., "13.9.5").
- *
- * @param currentVersion - The current version (e.g., "13.9.5")
- * @param requiredVersion - The required minimum version (e.g., "13.10.0")
- * @returns true if currentVersion >= requiredVersion, false otherwise
- */
-function isVersionAtLeast(currentVersion, requiredVersion) {
-    return (currentVersion === requiredVersion ||
-        (0, utils_1.gtVersion)(currentVersion, requiredVersion));
-}
-/**
- * A utility function that calls `Object.entries` while preserving the index type.
- *
- * @param input - The object to get the entries of.
- * @returns - The object entries.
- */
-function getObjectEntries(input) {
-    // Use cast to preserve index type. Object.entries always widens to string.
-    return Object.entries(input);
-}
-//# sourceMappingURL=version.cjs.map

package/dist/utils/version.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"version.cjs","sourceRoot":"","sources":["../../src/utils/version.ts"],"names":[],"mappings":";;;AAAA,2CAAkE;AAKlE;;;GAGG;AACU,QAAA,uBAAuB,GAAG;IACrC,QAAQ,EAAE,UAAU;CACZ,CAAC;AAEX;;;;;GAKG;AACH,SAAgB,oBAAoB,CAClC,KAAW;IAEX,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACpB,CAAC,CAAC,+BAAuB,CAAC,QAAQ,IAAI,KAAK,CAAC,EAC5C,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,+BAAuB,CAAC,QAAQ,CAAC,CAAC;IAEzD,IACE,OAAO,QAAQ,KAAK,QAAQ;QAC5B,QAAQ,KAAK,IAAI;QACjB,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EACvB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,2DAA2D;IAC3D,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC1C,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,IAAA,4BAAoB,EAAC,UAAU,CAAC,CAAC,CAAC;AAC7E,CAAC;AAzBD,oDAyBC;AAED;;;;;;;GAOG;AACH,SAAgB,cAAc,CAC5B,gBAA8C,EAC9C,iBAAgC;IAEhC,MAAM,cAAc,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,IAAI,CACrE,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE;QACzB,OAAO,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC,CACF,CAAC;IAEF,KAAK,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,cAAc,EAAE,CAAC;QAC7C,IAAI,gBAAgB,CAAC,iBAAiB,EAAE,OAAO,CAAC,EAAE,CAAC;YACjD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAjBD,wCAiBC;AAED;;;;;;;GAOG;AACH,SAAS,gBAAgB,CACvB,cAA6B,EAC7B,eAA8B;IAE9B,OAAO,CACL,cAAc,KAAK,eAAe;QAClC,IAAA,iBAAS,EAAC,cAAc,EAAE,eAAe,CAAC,CAC3C,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAS,gBAAgB,CACvB,KAAY;IAEZ,2EAA2E;IAC3E,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAwC,CAAC;AACtE,CAAC","sourcesContent":["import { gtVersion, isValidSemVerVersion } from '@metamask/utils';\nimport type { Json, SemVerVersion } from '@metamask/utils';\n\nimport type { MultiVersionFeatureFlagValue } from '../remote-feature-flag-controller-types.js';\n\n/**\n * Constants for MultiVersionFeatureFlagValue property names\n * to ensure consistency across validation, type checking, and other usage.\n */\nexport const MULTI_VERSION_FLAG_KEYS = {\n  VERSIONS: 'versions',\n} as const;\n\n/**\n * Checks if a feature flag value is a multi-version gated flag (contains versions object with valid SemVer keys).\n *\n * @param value - The feature flag value to check\n * @returns true if the value is a multi-version feature flag with valid SemVer version keys, false otherwise\n */\nexport function isVersionFeatureFlag(\n  value: Json,\n): value is MultiVersionFeatureFlagValue {\n  if (\n    typeof value !== 'object' ||\n    value === null ||\n    Array.isArray(value) ||\n    !(MULTI_VERSION_FLAG_KEYS.VERSIONS in value)\n  ) {\n    return false;\n  }\n\n  const versions = value[MULTI_VERSION_FLAG_KEYS.VERSIONS];\n\n  if (\n    typeof versions !== 'object' ||\n    versions === null ||\n    Array.isArray(versions)\n  ) {\n    return false;\n  }\n\n  // Validate that all version keys are valid SemVer versions\n  const versionKeys = Object.keys(versions);\n  return versionKeys.every((versionKey) => isValidSemVerVersion(versionKey));\n}\n\n/**\n * Selects the appropriate version value from a multi-version feature flag based on current app version.\n * Returns the value from the highest version that the app version meets or exceeds.\n *\n * @param multiVersionFlag - The multi-version feature flag\n * @param currentAppVersion - The current application version\n * @returns The selected version value, or null if no version requirements are met\n */\nexport function getVersionData(\n  multiVersionFlag: MultiVersionFeatureFlagValue,\n  currentAppVersion: SemVerVersion,\n): Json | null {\n  const sortedVersions = getObjectEntries(multiVersionFlag.versions).sort(\n    ([versionA], [versionB]) => {\n      return isVersionAtLeast(versionA, versionB) ? -1 : 1;\n    },\n  );\n\n  for (const [version, data] of sortedVersions) {\n    if (isVersionAtLeast(currentAppVersion, version)) {\n      return data;\n    }\n  }\n\n  return null;\n}\n\n/**\n * Compares two semantic version strings.\n * Both versions are expected to be valid SemVer format (e.g., \"13.9.5\").\n *\n * @param currentVersion - The current version (e.g., \"13.9.5\")\n * @param requiredVersion - The required minimum version (e.g., \"13.10.0\")\n * @returns true if currentVersion >= requiredVersion, false otherwise\n */\nfunction isVersionAtLeast(\n  currentVersion: SemVerVersion,\n  requiredVersion: SemVerVersion,\n): boolean {\n  return (\n    currentVersion === requiredVersion ||\n    gtVersion(currentVersion, requiredVersion)\n  );\n}\n\n/**\n * A utility function that calls `Object.entries` while preserving the index type.\n *\n * @param input - The object to get the entries of.\n * @returns - The object entries.\n */\nfunction getObjectEntries<Input extends Record<string, unknown>>(\n  input: Input,\n): [keyof Input, Input[keyof Input]][] {\n  // Use cast to preserve index type. Object.entries always widens to string.\n  return Object.entries(input) as [keyof Input, Input[keyof Input]][];\n}\n"]}

package/dist/utils/version.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"version.d.cts","sourceRoot":"","sources":["../../src/utils/version.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,wBAAwB;AAE3D,OAAO,KAAK,EAAE,4BAA4B,EAAE,oDAAmD;AAE/F;;;GAGG;AACH,eAAO,MAAM,uBAAuB;;CAE1B,CAAC;AAEX;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,IAAI,GACV,KAAK,IAAI,4BAA4B,CAuBvC;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,gBAAgB,EAAE,4BAA4B,EAC9C,iBAAiB,EAAE,aAAa,GAC/B,IAAI,GAAG,IAAI,CAcb"}

package/dist/utils/version.d.mts

@@ -1,26 +0,0 @@
-import type { Json, SemVerVersion } from "@metamask/utils";
-import type { MultiVersionFeatureFlagValue } from "../remote-feature-flag-controller-types.mjs";
-/**
- * Constants for MultiVersionFeatureFlagValue property names
- * to ensure consistency across validation, type checking, and other usage.
- */
-export declare const MULTI_VERSION_FLAG_KEYS: {
-    readonly VERSIONS: "versions";
-};
-/**
- * Checks if a feature flag value is a multi-version gated flag (contains versions object with valid SemVer keys).
- *
- * @param value - The feature flag value to check
- * @returns true if the value is a multi-version feature flag with valid SemVer version keys, false otherwise
- */
-export declare function isVersionFeatureFlag(value: Json): value is MultiVersionFeatureFlagValue;
-/**
- * Selects the appropriate version value from a multi-version feature flag based on current app version.
- * Returns the value from the highest version that the app version meets or exceeds.
- *
- * @param multiVersionFlag - The multi-version feature flag
- * @param currentAppVersion - The current application version
- * @returns The selected version value, or null if no version requirements are met
- */
-export declare function getVersionData(multiVersionFlag: MultiVersionFeatureFlagValue, currentAppVersion: SemVerVersion): Json | null;
-//# sourceMappingURL=version.d.mts.map

package/dist/utils/version.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"version.d.mts","sourceRoot":"","sources":["../../src/utils/version.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,wBAAwB;AAE3D,OAAO,KAAK,EAAE,4BAA4B,EAAE,oDAAmD;AAE/F;;;GAGG;AACH,eAAO,MAAM,uBAAuB;;CAE1B,CAAC;AAEX;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,IAAI,GACV,KAAK,IAAI,4BAA4B,CAuBvC;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,gBAAgB,EAAE,4BAA4B,EAC9C,iBAAiB,EAAE,aAAa,GAC/B,IAAI,GAAG,IAAI,CAcb"}

package/dist/utils/version.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"version.mjs","sourceRoot":"","sources":["../../src/utils/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,wBAAwB;AAKlE;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,QAAQ,EAAE,UAAU;CACZ,CAAC;AAEX;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAW;IAEX,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACpB,CAAC,CAAC,uBAAuB,CAAC,QAAQ,IAAI,KAAK,CAAC,EAC5C,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IAEzD,IACE,OAAO,QAAQ,KAAK,QAAQ;QAC5B,QAAQ,KAAK,IAAI;QACjB,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EACvB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,2DAA2D;IAC3D,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC1C,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAC5B,gBAA8C,EAC9C,iBAAgC;IAEhC,MAAM,cAAc,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,IAAI,CACrE,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE;QACzB,OAAO,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC,CACF,CAAC;IAEF,KAAK,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,cAAc,EAAE,CAAC;QAC7C,IAAI,gBAAgB,CAAC,iBAAiB,EAAE,OAAO,CAAC,EAAE,CAAC;YACjD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,gBAAgB,CACvB,cAA6B,EAC7B,eAA8B;IAE9B,OAAO,CACL,cAAc,KAAK,eAAe;QAClC,SAAS,CAAC,cAAc,EAAE,eAAe,CAAC,CAC3C,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAS,gBAAgB,CACvB,KAAY;IAEZ,2EAA2E;IAC3E,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAwC,CAAC;AACtE,CAAC","sourcesContent":["import { gtVersion, isValidSemVerVersion } from '@metamask/utils';\nimport type { Json, SemVerVersion } from '@metamask/utils';\n\nimport type { MultiVersionFeatureFlagValue } from '../remote-feature-flag-controller-types.js';\n\n/**\n * Constants for MultiVersionFeatureFlagValue property names\n * to ensure consistency across validation, type checking, and other usage.\n */\nexport const MULTI_VERSION_FLAG_KEYS = {\n  VERSIONS: 'versions',\n} as const;\n\n/**\n * Checks if a feature flag value is a multi-version gated flag (contains versions object with valid SemVer keys).\n *\n * @param value - The feature flag value to check\n * @returns true if the value is a multi-version feature flag with valid SemVer version keys, false otherwise\n */\nexport function isVersionFeatureFlag(\n  value: Json,\n): value is MultiVersionFeatureFlagValue {\n  if (\n    typeof value !== 'object' ||\n    value === null ||\n    Array.isArray(value) ||\n    !(MULTI_VERSION_FLAG_KEYS.VERSIONS in value)\n  ) {\n    return false;\n  }\n\n  const versions = value[MULTI_VERSION_FLAG_KEYS.VERSIONS];\n\n  if (\n    typeof versions !== 'object' ||\n    versions === null ||\n    Array.isArray(versions)\n  ) {\n    return false;\n  }\n\n  // Validate that all version keys are valid SemVer versions\n  const versionKeys = Object.keys(versions);\n  return versionKeys.every((versionKey) => isValidSemVerVersion(versionKey));\n}\n\n/**\n * Selects the appropriate version value from a multi-version feature flag based on current app version.\n * Returns the value from the highest version that the app version meets or exceeds.\n *\n * @param multiVersionFlag - The multi-version feature flag\n * @param currentAppVersion - The current application version\n * @returns The selected version value, or null if no version requirements are met\n */\nexport function getVersionData(\n  multiVersionFlag: MultiVersionFeatureFlagValue,\n  currentAppVersion: SemVerVersion,\n): Json | null {\n  const sortedVersions = getObjectEntries(multiVersionFlag.versions).sort(\n    ([versionA], [versionB]) => {\n      return isVersionAtLeast(versionA, versionB) ? -1 : 1;\n    },\n  );\n\n  for (const [version, data] of sortedVersions) {\n    if (isVersionAtLeast(currentAppVersion, version)) {\n      return data;\n    }\n  }\n\n  return null;\n}\n\n/**\n * Compares two semantic version strings.\n * Both versions are expected to be valid SemVer format (e.g., \"13.9.5\").\n *\n * @param currentVersion - The current version (e.g., \"13.9.5\")\n * @param requiredVersion - The required minimum version (e.g., \"13.10.0\")\n * @returns true if currentVersion >= requiredVersion, false otherwise\n */\nfunction isVersionAtLeast(\n  currentVersion: SemVerVersion,\n  requiredVersion: SemVerVersion,\n): boolean {\n  return (\n    currentVersion === requiredVersion ||\n    gtVersion(currentVersion, requiredVersion)\n  );\n}\n\n/**\n * A utility function that calls `Object.entries` while preserving the index type.\n *\n * @param input - The object to get the entries of.\n * @returns - The object entries.\n */\nfunction getObjectEntries<Input extends Record<string, unknown>>(\n  input: Input,\n): [keyof Input, Input[keyof Input]][] {\n  // Use cast to preserve index type. Object.entries always widens to string.\n  return Object.entries(input) as [keyof Input, Input[keyof Input]][];\n}\n"]}