@microsoft/feature-management 2.0.2 → 2.1.0

package/dist/umd/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../src/filter/TimeWindowFilter.ts","../../src/common/targetingEvaluator.ts","../../src/filter/TargetingFilter.ts","../../src/variant/Variant.ts","../../src/featureManager.ts","../../src/schema/model.ts","../../src/schema/validator.ts","../../src/featureProvider.ts","../../src/version.ts","../../src/telemetry/featureEvaluationEvent.ts"],"sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT license.\n\nimport { IFeatureFilter } from \"./FeatureFilter.js\";\n\n// [Start, End)\ntype TimeWindowParameters = {\n    Start?: string;\n    End?: string;\n}\n\ntype TimeWindowFilterEvaluationContext = {\n    featureName: string;\n    parameters: TimeWindowParameters;\n}\n\nexport class TimeWindowFilter implements IFeatureFilter {\n    name: string = \"Microsoft.TimeWindow\";\n\n    evaluate(context: TimeWindowFilterEvaluationContext): boolean {\n        const {featureName, parameters} = context;\n        const startTime = parameters.Start !== undefined ? new Date(parameters.Start) : undefined;\n        const endTime = parameters.End !== undefined ? new Date(parameters.End) : undefined;\n\n        if (startTime === undefined && endTime === undefined) {\n            // If neither start nor end time is specified, then the filter is not applicable.\n            console.warn(`The ${this.name} feature filter is not valid for feature ${featureName}. It must specify either 'Start', 'End', or both.`);\n            return false;\n        }\n        const now = new Date();\n        return (startTime === undefined || startTime <= now) && (endTime === undefined || now < endTime);\n    }\n}\n","// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT license.\n\n/**\n * Determines if the user is part of the audience, based on the user id and the percentage range.\n *\n * @param userId user id from app context\n * @param hint hint string to be included in the context id\n * @param from percentage range start\n * @param to percentage range end\n * @returns true if the user is part of the audience, false otherwise\n */\nexport async function isTargetedPercentile(userId: string | undefined, hint: string, from: number, to: number): Promise<boolean> {\n    if (from < 0 || from > 100) {\n        throw new Error(\"The 'from' value must be between 0 and 100.\");\n    }\n    if (to < 0 || to > 100) {\n        throw new Error(\"The 'to' value must be between 0 and 100.\");\n    }\n    if (from > to) {\n        throw new Error(\"The 'from' value cannot be larger than the 'to' value.\");\n    }\n\n    const audienceContextId = constructAudienceContextId(userId, hint);\n\n    // Cryptographic hashing algorithms ensure adequate entropy across hash values.\n    const contextMarker = await stringToUint32(audienceContextId);\n    const contextPercentage = (contextMarker / 0xFFFFFFFF) * 100;\n\n    // Handle edge case of exact 100 bucket\n    if (to === 100) {\n        return contextPercentage >= from;\n    }\n\n    return contextPercentage >= from && contextPercentage < to;\n}\n\n/**\n * Determines if the user is part of the audience, based on the groups they belong to.\n *\n * @param sourceGroups user groups from app context\n * @param targetedGroups targeted groups from feature configuration\n * @returns true if the user is part of the audience, false otherwise\n */\nexport function isTargetedGroup(sourceGroups: string[] | undefined, targetedGroups: string[]): boolean {\n    if (sourceGroups === undefined) {\n        return false;\n    }\n\n    return sourceGroups.some(group => targetedGroups.includes(group));\n}\n\n/**\n * Determines if the user is part of the audience, based on the user id.\n * @param userId user id from app context\n * @param users targeted users from feature configuration\n * @returns true if the user is part of the audience, false otherwise\n */\nexport function isTargetedUser(userId: string | undefined, users: string[]): boolean {\n    if (userId === undefined) {\n        return false;\n    }\n\n    return users.includes(userId);\n}\n\n/**\n * Constructs the context id for the audience.\n * The context id is used to determine if the user is part of the audience for a feature.\n *\n * @param userId userId from app context\n * @param hint hint string to be included in the context id\n * @returns a string that represents the context id for the audience\n */\nfunction constructAudienceContextId(userId: string | undefined, hint: string): string {\n    return `${userId ?? \"\"}\\n${hint}`;\n}\n\n/**\n * Converts a string to a uint32 in little-endian encoding.\n * @param str the string to convert.\n * @returns a uint32 value.\n */\nasync function stringToUint32(str: string): Promise<number> {\n    let crypto;\n\n    // Check for browser environment\n    if (typeof window !== \"undefined\" && window.crypto && window.crypto.subtle) {\n        crypto = window.crypto;\n    }\n    // Check for Node.js environment\n    else if (typeof global !== \"undefined\" && global.crypto) {\n        crypto = global.crypto;\n    }\n    // Fallback to native Node.js crypto module\n    else {\n        try {\n            if (typeof module !== \"undefined\" && module.exports) {\n                crypto = require(\"crypto\");\n            }\n            else {\n                crypto = await import(\"crypto\");\n            }\n        } catch (error) {\n            console.error(\"Failed to load the crypto module:\", error.message);\n            throw error;\n        }\n    }\n\n    // In the browser, use crypto.subtle.digest\n    if (crypto.subtle) {\n        const data = new TextEncoder().encode(str);\n        const hashBuffer = await crypto.subtle.digest(\"SHA-256\", data);\n        const dataView = new DataView(hashBuffer);\n        const uint32 = dataView.getUint32(0, true);\n        return uint32;\n    }\n    // In Node.js, use the crypto module's hash function\n    else {\n        const hash = crypto.createHash(\"sha256\").update(str).digest();\n        const uint32 = hash.readUInt32LE(0);\n        return uint32;\n    }\n}\n","// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT license.\n\nimport { IFeatureFilter } from \"./FeatureFilter.js\";\nimport { isTargetedPercentile } from \"../common/targetingEvaluator.js\";\nimport { ITargetingContext } from \"../common/ITargetingContext.js\";\n\ntype TargetingFilterParameters = {\n    Audience: {\n        DefaultRolloutPercentage: number;\n        Users?: string[];\n        Groups?: {\n            Name: string;\n            RolloutPercentage: number;\n        }[];\n        Exclusion?: {\n            Users?: string[];\n            Groups?: string[];\n        };\n    }\n}\n\ntype TargetingFilterEvaluationContext = {\n    featureName: string;\n    parameters: TargetingFilterParameters;\n}\n\nexport class TargetingFilter implements IFeatureFilter {\n    name: string = \"Microsoft.Targeting\";\n\n    async evaluate(context: TargetingFilterEvaluationContext, appContext?: ITargetingContext): Promise<boolean> {\n        const { featureName, parameters } = context;\n        TargetingFilter.#validateParameters(featureName, parameters);\n\n        if (appContext === undefined) {\n            throw new Error(\"The app context is required for targeting filter.\");\n        }\n\n        if (parameters.Audience.Exclusion !== undefined) {\n            // check if the user is in the exclusion list\n            if (appContext?.userId !== undefined &&\n                parameters.Audience.Exclusion.Users !== undefined &&\n                parameters.Audience.Exclusion.Users.includes(appContext.userId)) {\n                return false;\n            }\n            // check if the user is in a group within exclusion list\n            if (appContext?.groups !== undefined &&\n                parameters.Audience.Exclusion.Groups !== undefined) {\n                for (const excludedGroup of parameters.Audience.Exclusion.Groups) {\n                    if (appContext.groups.includes(excludedGroup)) {\n                        return false;\n                    }\n                }\n            }\n        }\n\n        // check if the user is being targeted directly\n        if (appContext?.userId !== undefined &&\n            parameters.Audience.Users !== undefined &&\n            parameters.Audience.Users.includes(appContext.userId)) {\n            return true;\n        }\n\n        // check if the user is in a group that is being targeted\n        if (appContext?.groups !== undefined &&\n            parameters.Audience.Groups !== undefined) {\n            for (const group of parameters.Audience.Groups) {\n                if (appContext.groups.includes(group.Name)) {\n                    const hint = `${featureName}\\n${group.Name}`;\n                    if (await isTargetedPercentile(appContext.userId, hint, 0, group.RolloutPercentage)) {\n                        return true;\n                    }\n                }\n            }\n        }\n\n        // check if the user is being targeted by a default rollout percentage\n        const hint = featureName;\n        return isTargetedPercentile(appContext?.userId, hint, 0, parameters.Audience.DefaultRolloutPercentage);\n    }\n\n    static #validateParameters(featureName: string, parameters: TargetingFilterParameters): void {\n        if (parameters.Audience.DefaultRolloutPercentage < 0 || parameters.Audience.DefaultRolloutPercentage > 100) {\n            throw new Error(`Invalid feature flag: ${featureName}. Audience.DefaultRolloutPercentage must be a number between 0 and 100.`);\n        }\n        // validate RolloutPercentage for each group\n        if (parameters.Audience.Groups !== undefined) {\n            for (const group of parameters.Audience.Groups) {\n                if (group.RolloutPercentage < 0 || group.RolloutPercentage > 100) {\n                    throw new Error(`Invalid feature flag: ${featureName}. RolloutPercentage of group ${group.Name} must be a number between 0 and 100.`);\n                }\n            }\n        }\n    }\n}\n","// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT license.\n\nexport class Variant {\n    constructor(\n        public name: string,\n        public configuration: unknown\n    ) {}\n}\n","// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT license.\n\nimport { TimeWindowFilter } from \"./filter/TimeWindowFilter.js\";\nimport { IFeatureFilter } from \"./filter/FeatureFilter.js\";\nimport { FeatureFlag, RequirementType, VariantDefinition } from \"./schema/model.js\";\nimport { IFeatureFlagProvider } from \"./featureProvider.js\";\nimport { TargetingFilter } from \"./filter/TargetingFilter.js\";\nimport { Variant } from \"./variant/Variant.js\";\nimport { IFeatureManager } from \"./IFeatureManager.js\";\nimport { ITargetingContext } from \"./common/ITargetingContext.js\";\nimport { isTargetedGroup, isTargetedPercentile, isTargetedUser } from \"./common/targetingEvaluator.js\";\n\nexport class FeatureManager implements IFeatureManager {\n    #provider: IFeatureFlagProvider;\n    #featureFilters: Map<string, IFeatureFilter> = new Map();\n    #onFeatureEvaluated?: (event: EvaluationResult) => void;\n\n    constructor(provider: IFeatureFlagProvider, options?: FeatureManagerOptions) {\n        this.#provider = provider;\n\n        const builtinFilters = [new TimeWindowFilter(), new TargetingFilter()];\n\n        // If a custom filter shares a name with an existing filter, the custom filter overrides the existing one.\n        for (const filter of [...builtinFilters, ...(options?.customFilters ?? [])]) {\n            this.#featureFilters.set(filter.name, filter);\n        }\n\n        this.#onFeatureEvaluated = options?.onFeatureEvaluated;\n    }\n\n    async listFeatureNames(): Promise<string[]> {\n        const features = await this.#provider.getFeatureFlags();\n        const featureNameSet = new Set(features.map((feature) => feature.id));\n        return Array.from(featureNameSet);\n    }\n\n    // If multiple feature flags are found, the first one takes precedence.\n    async isEnabled(featureName: string, context?: unknown): Promise<boolean> {\n        const result = await this.#evaluateFeature(featureName, context);\n        return result.enabled;\n    }\n\n    async getVariant(featureName: string, context?: ITargetingContext): Promise<Variant | undefined> {\n        const result = await this.#evaluateFeature(featureName, context);\n        return result.variant;\n    }\n\n    async #assignVariant(featureFlag: FeatureFlag, context: ITargetingContext): Promise<VariantAssignment> {\n        // user allocation\n        if (featureFlag.allocation?.user !== undefined) {\n            for (const userAllocation of featureFlag.allocation.user) {\n                if (isTargetedUser(context.userId, userAllocation.users)) {\n                    return getVariantAssignment(featureFlag, userAllocation.variant, VariantAssignmentReason.User);\n                }\n            }\n        }\n\n        // group allocation\n        if (featureFlag.allocation?.group !== undefined) {\n            for (const groupAllocation of featureFlag.allocation.group) {\n                if (isTargetedGroup(context.groups, groupAllocation.groups)) {\n                    return getVariantAssignment(featureFlag, groupAllocation.variant, VariantAssignmentReason.Group);\n                }\n            }\n        }\n\n        // percentile allocation\n        if (featureFlag.allocation?.percentile !== undefined) {\n            for (const percentileAllocation of featureFlag.allocation.percentile) {\n                const hint = featureFlag.allocation.seed ?? `allocation\\n${featureFlag.id}`;\n                if (await isTargetedPercentile(context.userId, hint, percentileAllocation.from, percentileAllocation.to)) {\n                    return getVariantAssignment(featureFlag, percentileAllocation.variant, VariantAssignmentReason.Percentile);\n                }\n            }\n        }\n\n        return { variant: undefined, reason: VariantAssignmentReason.None };\n    }\n\n    async #isEnabled(featureFlag: FeatureFlag, context?: unknown): Promise<boolean> {\n        if (featureFlag.enabled !== true) {\n            // If the feature is not explicitly enabled, then it is disabled by default.\n            return false;\n        }\n\n        const clientFilters = featureFlag.conditions?.client_filters;\n        if (clientFilters === undefined || clientFilters.length <= 0) {\n            // If there are no client filters, then the feature is enabled.\n            return true;\n        }\n\n        const requirementType: RequirementType = featureFlag.conditions?.requirement_type ?? \"Any\"; // default to any.\n\n        /**\n         * While iterating through the client filters, we short-circuit the evaluation based on the requirement type.\n         * - When requirement type is \"All\", the feature is enabled if all client filters are matched. If any client filter is not matched, the feature is disabled, otherwise it is enabled. `shortCircuitEvaluationResult` is false.\n         * - When requirement type is \"Any\", the feature is enabled if any client filter is matched. If any client filter is matched, the feature is enabled, otherwise it is disabled. `shortCircuitEvaluationResult` is true.\n         */\n        const shortCircuitEvaluationResult: boolean = requirementType === \"Any\";\n\n        for (const clientFilter of clientFilters) {\n            const matchedFeatureFilter = this.#featureFilters.get(clientFilter.name);\n            const contextWithFeatureName = { featureName: featureFlag.id, parameters: clientFilter.parameters };\n            if (matchedFeatureFilter === undefined) {\n                console.warn(`Feature filter ${clientFilter.name} is not found.`);\n                return false;\n            }\n            if (await matchedFeatureFilter.evaluate(contextWithFeatureName, context) === shortCircuitEvaluationResult) {\n                return shortCircuitEvaluationResult;\n            }\n        }\n\n        // If we get here, then we have not found a client filter that matches the requirement type.\n        return !shortCircuitEvaluationResult;\n    }\n\n    async #evaluateFeature(featureName: string, context: unknown): Promise<EvaluationResult> {\n        const featureFlag = await this.#provider.getFeatureFlag(featureName);\n        const result = new EvaluationResult(featureFlag);\n\n        if (featureFlag === undefined) {\n            return result;\n        }\n\n        // Ensure that the feature flag is in the correct format. Feature providers should validate the feature flags, but we do it here as a safeguard.\n        // TODO: move to the feature flag provider implementation.\n        validateFeatureFlagFormat(featureFlag);\n\n        // Evaluate if the feature is enabled.\n        result.enabled = await this.#isEnabled(featureFlag, context);\n\n        const targetingContext = context as ITargetingContext;\n        result.targetingId = targetingContext?.userId;\n\n        // Determine Variant\n        let variantDef: VariantDefinition | undefined;\n        let reason: VariantAssignmentReason = VariantAssignmentReason.None;\n\n        // featureFlag.variant not empty\n        if (featureFlag.variants !== undefined && featureFlag.variants.length > 0) {\n            if (!result.enabled) {\n                // not enabled, assign default if specified\n                if (featureFlag.allocation?.default_when_disabled !== undefined) {\n                    variantDef = featureFlag.variants.find(v => v.name == featureFlag.allocation?.default_when_disabled);\n                    reason = VariantAssignmentReason.DefaultWhenDisabled;\n                } else {\n                    // no default specified\n                    variantDef = undefined;\n                    reason = VariantAssignmentReason.DefaultWhenDisabled;\n                }\n            } else {\n                // enabled, assign based on allocation\n                if (context !== undefined && featureFlag.allocation !== undefined) {\n                    const variantAndReason = await this.#assignVariant(featureFlag, targetingContext);\n                    variantDef = variantAndReason.variant;\n                    reason = variantAndReason.reason;\n                }\n\n                // allocation failed, assign default if specified\n                if (variantDef === undefined && reason === VariantAssignmentReason.None) {\n                    if (featureFlag.allocation?.default_when_enabled !== undefined) {\n                        variantDef = featureFlag.variants.find(v => v.name == featureFlag.allocation?.default_when_enabled);\n                        reason = VariantAssignmentReason.DefaultWhenEnabled;\n                    } else {\n                        variantDef = undefined;\n                        reason = VariantAssignmentReason.DefaultWhenEnabled;\n                    }\n                }\n            }\n        }\n\n        result.variant = variantDef !== undefined ? new Variant(variantDef.name, variantDef.configuration_value) : undefined;\n        result.variantAssignmentReason = reason;\n\n        // Status override for isEnabled\n        if (variantDef !== undefined && featureFlag.enabled) {\n            if (variantDef.status_override === \"Enabled\") {\n                result.enabled = true;\n            } else if (variantDef.status_override === \"Disabled\") {\n                result.enabled = false;\n            }\n        }\n\n        // The callback will only be executed if telemetry is enabled for the feature flag\n        if (featureFlag.telemetry?.enabled && this.#onFeatureEvaluated !== undefined) {\n            this.#onFeatureEvaluated(result);\n        }\n\n        return result;\n    }\n}\n\nexport interface FeatureManagerOptions {\n    /**\n     * The custom filters to be used by the feature manager.\n     */\n    customFilters?: IFeatureFilter[];\n\n    /**\n     * The callback function that is called when a feature flag is evaluated.\n     * The callback function is called only when telemetry is enabled for the feature flag.\n     */\n    onFeatureEvaluated?: (event: EvaluationResult) => void;\n}\n\nexport class EvaluationResult {\n    constructor(\n        // feature flag definition\n        public readonly feature: FeatureFlag | undefined,\n\n        // enabled state\n        public enabled: boolean = false,\n\n        // variant assignment\n        public targetingId: string | undefined = undefined,\n        public variant: Variant | undefined = undefined,\n        public variantAssignmentReason: VariantAssignmentReason = VariantAssignmentReason.None\n    ) { }\n}\n\nexport enum VariantAssignmentReason {\n    /**\n     * Variant allocation did not happen. No variant is assigned.\n     */\n    None = \"None\",\n\n    /**\n     * The default variant is assigned when a feature flag is disabled.\n     */\n    DefaultWhenDisabled = \"DefaultWhenDisabled\",\n\n    /**\n     * The default variant is assigned because of no applicable user/group/percentile allocation when a feature flag is enabled.\n     */\n    DefaultWhenEnabled = \"DefaultWhenEnabled\",\n\n    /**\n     * The variant is assigned because of the user allocation when a feature flag is enabled.\n     */\n    User = \"User\",\n\n    /**\n     * The variant is assigned because of the group allocation when a feature flag is enabled.\n     */\n    Group = \"Group\",\n\n    /**\n     * The variant is assigned because of the percentile allocation when a feature flag is enabled.\n     */\n    Percentile = \"Percentile\"\n}\n\n/**\n * Validates the format of the feature flag definition.\n *\n * FeatureFlag data objects are from IFeatureFlagProvider, depending on the implementation.\n * Thus the properties are not guaranteed to have the expected types.\n *\n * @param featureFlag The feature flag definition to validate.\n */\nfunction validateFeatureFlagFormat(featureFlag: any): void {\n    if (featureFlag.enabled !== undefined && typeof featureFlag.enabled !== \"boolean\") {\n        throw new Error(`Feature flag ${featureFlag.id} has an invalid 'enabled' value.`);\n    }\n    // TODO: add more validations.\n    // TODO: should be moved to the feature flag provider.\n}\n\n/**\n * Try to get the variant assignment for the given variant name. If the variant is not found, override the reason with VariantAssignmentReason.None.\n *\n * @param featureFlag feature flag definition\n * @param variantName variant name\n * @param reason variant assignment reason\n * @returns variant assignment containing the variant definition and the reason\n */\nfunction getVariantAssignment(featureFlag: FeatureFlag, variantName: string, reason: VariantAssignmentReason): VariantAssignment {\n    const variant = featureFlag.variants?.find(v => v.name == variantName);\n    if (variant !== undefined) {\n        return { variant, reason };\n    } else {\n        console.warn(`Variant ${variantName} not found for feature ${featureFlag.id}.`);\n        return { variant: undefined, reason: VariantAssignmentReason.None };\n    }\n}\n\ntype VariantAssignment = {\n    variant: VariantDefinition | undefined;\n    reason: VariantAssignmentReason;\n};\n","// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT license.\n\n// Converted from:\n// https://github.com/Azure/AppConfiguration/blob/6e544296a5607f922a423df165f60801717c7800/docs/FeatureManagement/FeatureFlag.v2.0.0.schema.json\n\n/**\n * A feature flag is a named property that can be toggled to enable or disable some feature of an application.\n */\nexport interface FeatureFlag {\n    /**\n     * An ID used to uniquely identify and reference the feature.\n     */\n    id: string;\n    /**\n     * A feature is OFF if enabled is false. If enabled is true, then the feature is ON if there are no conditions (null or empty) or if the conditions are satisfied.\n     */\n    enabled?: boolean;\n    /**\n     * The declaration of conditions used to dynamically enable the feature.\n     */\n    conditions?: FeatureEnablementConditions;\n    /**\n     * The list of variants defined for this feature. A variant represents a configuration value of a feature flag that can be a string, a number, a boolean, or a JSON object.\n     */\n    variants?: VariantDefinition[];\n    /**\n     * Determines how variants should be allocated for the feature to various users.\n     */\n    allocation?: VariantAllocation;\n    /**\n     * The declaration of options used to configure telemetry for this feature.\n     */\n    telemetry?: TelemetryOptions\n  }\n\n  /**\n  * The declaration of conditions used to dynamically enable the feature\n  */\n  interface FeatureEnablementConditions {\n    /**\n     * Determines whether any or all registered client filters must be evaluated as true for the feature to be considered enabled.\n     */\n    requirement_type?: RequirementType;\n    /**\n     * Filters that must run on the client and be evaluated as true for the feature to be considered enabled.\n     */\n    client_filters?: ClientFilter[];\n  }\n\n  export type RequirementType = \"Any\" | \"All\";\n\n  interface ClientFilter {\n    /**\n     * The name used to refer to a client filter.\n     */\n    name: string;\n    /**\n     * Parameters for a given client filter. A client filter can require any set of parameters of any type.\n     */\n    parameters?: Record<string, unknown>;\n  }\n\n  export interface VariantDefinition {\n    /**\n     * The name used to refer to a feature variant.\n     */\n    name: string;\n    /**\n     * The configuration value for this feature variant.\n     */\n    configuration_value?: unknown;\n    /**\n     * Overrides the enabled state of the feature if the given variant is assigned. Does not override the state if value is None.\n     */\n    status_override?: \"None\" | \"Enabled\" | \"Disabled\";\n  }\n\n  /**\n  * Determines how variants should be allocated for the feature to various users.\n  */\n  interface VariantAllocation {\n    /**\n     * Specifies which variant should be used when the feature is considered disabled.\n     */\n    default_when_disabled?: string;\n    /**\n     * Specifies which variant should be used when the feature is considered enabled and no other allocation rules are applicable.\n     */\n    default_when_enabled?: string;\n    /**\n     * A list of objects, each containing a variant name and list of users for whom that variant should be used.\n     */\n    user?: UserAllocation[];\n    /**\n     * A list of objects, each containing a variant name and list of groups for which that variant should be used.\n     */\n    group?: GroupAllocation[];\n    /**\n     * A list of objects, each containing a variant name and percentage range for which that variant should be used.\n     */\n    percentile?: PercentileAllocation[]\n    /**\n     * The value percentile calculations are based on. The calculated percentile is consistent across features for a given user if the same nonempty seed is used.\n     */\n    seed?: string;\n  }\n\n  interface UserAllocation {\n    /**\n     * The name of the variant to use if the user allocation matches the current user.\n     */\n    variant: string;\n    /**\n     * Collection of users where if any match the current user, the variant specified in the user allocation is used.\n     */\n    users: string[];\n  }\n\n  interface GroupAllocation {\n    /**\n     * The name of the variant to use if the group allocation matches a group the current user is in.\n     */\n    variant: string;\n    /**\n     * Collection of groups where if the current user is in any of these groups, the variant specified in the group allocation is used.\n     */\n    groups: string[];\n  }\n\n  interface PercentileAllocation {\n    /**\n     * The name of the variant to use if the calculated percentile for the current user falls in the provided range.\n     */\n    variant: string;\n    /**\n     * The lower end of the percentage range for which this variant will be used.\n     */\n    from: number;\n    /**\n     * The upper end of the percentage range for which this variant will be used.\n     */\n    to: number;\n  }\n\n  /**\n  * The declaration of options used to configure telemetry for this feature.\n  */\n  interface TelemetryOptions {\n    /**\n     * Indicates if telemetry is enabled.\n     */\n    enabled?: boolean;\n    /**\n     * A container for metadata that should be bundled with flag telemetry.\n     */\n    metadata?: Record<string, string>;\n  }\n\n  // Feature Management Section fed into feature manager.\n  // Converted from https://github.com/Azure/AppConfiguration/blob/main/docs/FeatureManagement/FeatureManagement.v1.0.0.schema.json\n\n  export const FEATURE_MANAGEMENT_KEY = \"feature_management\";\n  export const FEATURE_FLAGS_KEY = \"feature_flags\";\n\n  export interface FeatureManagementConfiguration {\n    feature_management: FeatureManagement\n  }\n\n  /**\n   * Declares feature management configuration.\n   */\n  export interface FeatureManagement {\n    feature_flags: FeatureFlag[];\n  }\n","// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT license.\n\n/**\n * Validates a feature flag object, checking if it conforms to the schema.\n * @param featureFlag The feature flag object to validate.\n */\nexport function validateFeatureFlag(featureFlag: any): void {\n    if (featureFlag === undefined) {\n        return; // no-op if feature flag is undefined, indicating that the feature flag is not found\n    }\n    if (featureFlag === null || typeof featureFlag !== \"object\") { // Note: typeof null = \"object\"\n        throw new TypeError(\"Feature flag must be an object.\");\n    }\n    if (typeof featureFlag.id !== \"string\") {\n        throw new TypeError(\"Feature flag 'id' must be a string.\");\n    }\n\n    if (featureFlag.enabled !== undefined && typeof featureFlag.enabled !== \"boolean\") {\n        throw new TypeError(`Invalid feature flag: ${featureFlag.id}. Feature flag 'enabled' must be a boolean.`);\n    }\n    if (featureFlag.conditions !== undefined) {\n        validateFeatureEnablementConditions(featureFlag.id, featureFlag.conditions);\n    }\n    if (featureFlag.variants !== undefined) {\n        validateVariants(featureFlag.id, featureFlag.variants);\n    }\n    if (featureFlag.allocation !== undefined) {\n        validateVariantAllocation(featureFlag.id, featureFlag.allocation);\n    }\n    if (featureFlag.telemetry !== undefined) {\n        validateTelemetryOptions(featureFlag.id, featureFlag.telemetry);\n    }\n}\n\nfunction validateFeatureEnablementConditions(id: string, conditions: any) {\n    if (typeof conditions !== \"object\") {\n        throw new TypeError(`Invalid feature flag: ${id}. Feature flag 'conditions' must be an object.`);\n    }\n    if (conditions.requirement_type !== undefined && conditions.requirement_type !== \"Any\" && conditions.requirement_type !== \"All\") {\n        throw new TypeError(`Invalid feature flag: ${id}. 'requirement_type' must be 'Any' or 'All'.`);\n    }\n    if (conditions.client_filters !== undefined) {\n        validateClientFilters(id, conditions.client_filters);\n    }\n}\n\nfunction validateClientFilters(id: string, client_filters: any) {\n    if (!Array.isArray(client_filters)) {\n        throw new TypeError(`Invalid feature flag: ${id}. Feature flag conditions 'client_filters' must be an array.`);\n    }\n\n    for (const filter of client_filters) {\n        if (typeof filter.name !== \"string\") {\n            throw new TypeError(`Invalid feature flag: ${id}. Client filter 'name' must be a string.`);\n        }\n        if (filter.parameters !== undefined && typeof filter.parameters !== \"object\") {\n            throw new TypeError(`Invalid feature flag: ${id}. Client filter 'parameters' must be an object.`);\n        }\n    }\n}\n\nfunction validateVariants(id: string, variants: any) {\n    if (!Array.isArray(variants)) {\n        throw new TypeError(`Invalid feature flag: ${id}. Feature flag 'variants' must be an array.`);\n    }\n\n    for (const variant of variants) {\n        if (typeof variant.name !== \"string\") {\n            throw new TypeError(`Invalid feature flag: ${id}. Variant 'name' must be a string.`);\n        }\n        // skip configuration_value validation as it accepts any type\n        if (variant.status_override !== undefined && typeof variant.status_override !== \"string\") {\n            throw new TypeError(`Invalid feature flag: ${id}. Variant 'status_override' must be a string.`);\n        }\n        if (variant.status_override !== undefined && variant.status_override !== \"None\" && variant.status_override !== \"Enabled\" && variant.status_override !== \"Disabled\") {\n            throw new TypeError(`Invalid feature flag: ${id}. Variant 'status_override' must be 'None', 'Enabled', or 'Disabled'.`);\n        }\n    }\n}\n\nfunction validateVariantAllocation(id: string, allocation: any) {\n    if (typeof allocation !== \"object\") {\n        throw new TypeError(`Invalid feature flag: ${id}. Variant 'allocation' must be an object.`);\n    }\n\n    if (allocation.default_when_disabled !== undefined && typeof allocation.default_when_disabled !== \"string\") {\n        throw new TypeError(`Invalid feature flag: ${id}. Variant allocation 'default_when_disabled' must be a string.`);\n    }\n    if (allocation.default_when_enabled !== undefined && typeof allocation.default_when_enabled !== \"string\") {\n        throw new TypeError(`Invalid feature flag: ${id}. Variant allocation 'default_when_enabled' must be a string.`);\n    }\n    if (allocation.user !== undefined) {\n        validateUserVariantAllocation(id, allocation.user);\n    }\n    if (allocation.group !== undefined) {\n        validateGroupVariantAllocation(id, allocation.group);\n    }\n    if (allocation.percentile !== undefined) {\n        validatePercentileVariantAllocation(id, allocation.percentile);\n    }\n    if (allocation.seed !== undefined && typeof allocation.seed !== \"string\") {\n        throw new TypeError(`Invalid feature flag: ${id}. Variant allocation 'seed' must be a string.`);\n    }\n}\n\nfunction validateUserVariantAllocation(id: string, UserAllocations: any) {\n    if (!Array.isArray(UserAllocations)) {\n        throw new TypeError(`Invalid feature flag: ${id}. Variant 'user' allocation must be an array.`);\n    }\n\n    for (const allocation of UserAllocations) {\n        if (typeof allocation !== \"object\") {\n            throw new TypeError(`Invalid feature flag: ${id}. Elements in variant 'user' allocation must be an object.`);\n        }\n        if (typeof allocation.variant !== \"string\") {\n            throw new TypeError(`Invalid feature flag: ${id}. User allocation 'variant' must be a string.`);\n        }\n        if (!Array.isArray(allocation.users)) {\n            throw new TypeError(`Invalid feature flag: ${id}. User allocation 'users' must be an array.`);\n        }\n        for (const user of allocation.users) {\n            if (typeof user !== \"string\") {\n                throw new TypeError(`Invalid feature flag: ${id}. Elements in user allocation 'users' must be strings.`);\n            }\n        }\n    }\n}\n\nfunction validateGroupVariantAllocation(id: string, groupAllocations: any) {\n    if (!Array.isArray(groupAllocations)) {\n        throw new TypeError(`Invalid feature flag: ${id}. Variant 'group' allocation must be an array.`);\n    }\n\n    for (const allocation of groupAllocations) {\n        if (typeof allocation !== \"object\") {\n            throw new TypeError(`Invalid feature flag: ${id}. Elements in variant 'group' allocation must be an object.`);\n        }\n        if (typeof allocation.variant !== \"string\") {\n            throw new TypeError(`Invalid feature flag: ${id}. Group allocation 'variant' must be a string.`);\n        }\n        if (!Array.isArray(allocation.groups)) {\n            throw new TypeError(`Invalid feature flag: ${id}. Group allocation 'groups' must be an array.`);\n        }\n        for (const group of allocation.groups) {\n            if (typeof group !== \"string\") {\n                throw new TypeError(`Invalid feature flag: ${id}. Elements in group allocation 'groups' must be strings.`);\n            }\n        }\n    }\n}\n\nfunction validatePercentileVariantAllocation(id: string, percentileAllocations: any) {\n    if (!Array.isArray(percentileAllocations)) {\n        throw new TypeError(`Invalid feature flag: ${id}. Variant 'percentile' allocation must be an array.`);\n    }\n\n    for (const allocation of percentileAllocations) {\n        if (typeof allocation !== \"object\") {\n            throw new TypeError(`Invalid feature flag: ${id}. Elements in variant 'percentile' allocation must be an object.`);\n        }\n        if (typeof allocation.variant !== \"string\") {\n            throw new TypeError(`Invalid feature flag: ${id}. Percentile allocation 'variant' must be a string.`);\n        }\n        if (typeof allocation.from !== \"number\" || allocation.from < 0 || allocation.from > 100) {\n            throw new TypeError(`Invalid feature flag: ${id}. Percentile allocation 'from' must be a number between 0 and 100.`);\n        }\n        if (typeof allocation.to !== \"number\" || allocation.to < 0 || allocation.to > 100) {\n            throw new TypeError(`Invalid feature flag: ${id}. Percentile allocation 'to' must be a number between 0 and 100.`);\n        }\n    }\n}\n// #endregion\n\n// #region Telemetry\nfunction validateTelemetryOptions(id: string, telemetry: any) {\n    if (typeof telemetry !== \"object\") {\n        throw new TypeError(`Invalid feature flag: ${id}. Feature flag 'telemetry' must be an object.`);\n    }\n    if (telemetry.enabled !== undefined && typeof telemetry.enabled !== \"boolean\") {\n        throw new TypeError(`Invalid feature flag: ${id}. Telemetry 'enabled' must be a boolean.`);\n    }\n    if (telemetry.metadata !== undefined && typeof telemetry.metadata !== \"object\") {\n        throw new TypeError(`Invalid feature flag: ${id}. Telemetry 'metadata' must be an object.`);\n    }\n}\n// #endregion\n","// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT license.\n\nimport { IGettable } from \"./gettable.js\";\nimport { FeatureFlag, FeatureManagementConfiguration, FEATURE_MANAGEMENT_KEY, FEATURE_FLAGS_KEY } from \"./schema/model.js\";\nimport { validateFeatureFlag } from \"./schema/validator.js\";\n\nexport interface IFeatureFlagProvider {\n    /**\n     * Get all feature flags.\n     */\n    getFeatureFlags(): Promise<FeatureFlag[]>;\n\n    /**\n     * Get a feature flag by name.\n     * @param featureName The name of the feature flag.\n     */\n    getFeatureFlag(featureName: string): Promise<FeatureFlag | undefined>;\n}\n\n/**\n * A feature flag provider that uses a map-like configuration to provide feature flags.\n */\nexport class ConfigurationMapFeatureFlagProvider implements IFeatureFlagProvider {\n    #configuration: IGettable;\n\n    constructor(configuration: IGettable) {\n        this.#configuration = configuration;\n    }\n    async getFeatureFlag(featureName: string): Promise<FeatureFlag | undefined> {\n        const featureConfig = this.#configuration.get<FeatureManagementConfiguration>(FEATURE_MANAGEMENT_KEY);\n        const featureFlag = featureConfig?.[FEATURE_FLAGS_KEY]?.findLast((feature) => feature.id === featureName);\n        validateFeatureFlag(featureFlag);\n        return featureFlag;\n    }\n\n    async getFeatureFlags(): Promise<FeatureFlag[]> {\n        const featureConfig = this.#configuration.get<FeatureManagementConfiguration>(FEATURE_MANAGEMENT_KEY);\n        const featureFlags = featureConfig?.[FEATURE_FLAGS_KEY] ?? [];\n        featureFlags.forEach(featureFlag => {\n            validateFeatureFlag(featureFlag);\n        });\n        return featureFlags;\n    }\n}\n\n/**\n * A feature flag provider that uses an object-like configuration to provide feature flags.\n */\nexport class ConfigurationObjectFeatureFlagProvider implements IFeatureFlagProvider {\n    #configuration: Record<string, unknown>;\n\n    constructor(configuration: Record<string, unknown>) {\n        this.#configuration = configuration;\n    }\n\n    async getFeatureFlag(featureName: string): Promise<FeatureFlag | undefined> {\n        const featureFlags = this.#configuration[FEATURE_MANAGEMENT_KEY]?.[FEATURE_FLAGS_KEY];\n        const featureFlag = featureFlags?.findLast((feature: FeatureFlag) => feature.id === featureName);\n        validateFeatureFlag(featureFlag);\n        return featureFlag;\n    }\n\n    async getFeatureFlags(): Promise<FeatureFlag[]> {\n        const featureFlags = this.#configuration[FEATURE_MANAGEMENT_KEY]?.[FEATURE_FLAGS_KEY] ?? [];\n        featureFlags.forEach(featureFlag => {\n            validateFeatureFlag(featureFlag);\n        });\n        return featureFlags;\n    }\n}\n","// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT license.\n\nexport const VERSION = \"2.0.2\";\nexport const EVALUATION_EVENT_VERSION = \"1.0.0\";\n","// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT license.\n\nimport { EvaluationResult } from \"../featureManager\";\nimport { EVALUATION_EVENT_VERSION } from \"../version.js\";\n\nconst VERSION = \"Version\";\nconst FEATURE_NAME = \"FeatureName\";\nconst ENABLED = \"Enabled\";\nconst TARGETING_ID = \"TargetingId\";\nconst VARIANT = \"Variant\";\nconst VARIANT_ASSIGNMENT_REASON = \"VariantAssignmentReason\";\n\nexport function createFeatureEvaluationEventProperties(result: EvaluationResult): any {\n    if (result.feature === undefined) {\n        return undefined;\n    }\n\n    const eventProperties = {\n        [VERSION]: EVALUATION_EVENT_VERSION,\n        [FEATURE_NAME]: result.feature ? result.feature.id : \"\",\n        [ENABLED]: result.enabled ? \"True\" : \"False\",\n        // Ensure targetingId is string so that it will be placed in customDimensions\n        [TARGETING_ID]: result.targetingId ? result.targetingId.toString() : \"\",\n        [VARIANT]: result.variant ? result.variant.name : \"\",\n        [VARIANT_ASSIGNMENT_REASON]: result.variantAssignmentReason,\n    };\n\n    const metadata = result.feature.telemetry?.metadata;\n    if (metadata) {\n        for (const key in metadata) {\n            if (!(key in eventProperties)) {\n                eventProperties[key] = metadata[key];\n            }\n        }\n    }\n\n    return eventProperties;\n}\n"],"names":["VariantAssignmentReason","VERSION"],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../../src/filter/TimeWindowFilter.ts","../../src/common/targetingEvaluator.ts","../../src/filter/TargetingFilter.ts","../../src/variant/Variant.ts","../../src/featureManager.ts","../../src/schema/model.ts","../../src/schema/validator.ts","../../src/featureProvider.ts","../../src/version.ts","../../src/telemetry/featureEvaluationEvent.ts"],"sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT license.\n\nimport { IFeatureFilter } from \"./FeatureFilter.js\";\n\n// [Start, End)\ntype TimeWindowParameters = {\n    Start?: string;\n    End?: string;\n}\n\ntype TimeWindowFilterEvaluationContext = {\n    featureName: string;\n    parameters: TimeWindowParameters;\n}\n\nexport class TimeWindowFilter implements IFeatureFilter {\n    readonly name: string = \"Microsoft.TimeWindow\";\n\n    evaluate(context: TimeWindowFilterEvaluationContext): boolean {\n        const {featureName, parameters} = context;\n        const startTime = parameters.Start !== undefined ? new Date(parameters.Start) : undefined;\n        const endTime = parameters.End !== undefined ? new Date(parameters.End) : undefined;\n\n        if (startTime === undefined && endTime === undefined) {\n            // If neither start nor end time is specified, then the filter is not applicable.\n            console.warn(`The ${this.name} feature filter is not valid for feature ${featureName}. It must specify either 'Start', 'End', or both.`);\n            return false;\n        }\n        const now = new Date();\n        return (startTime === undefined || startTime <= now) && (endTime === undefined || now < endTime);\n    }\n}\n","// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT license.\n\n/**\n * Determines if the user is part of the audience, based on the user id and the percentage range.\n *\n * @param userId user id from app context\n * @param hint hint string to be included in the context id\n * @param from percentage range start\n * @param to percentage range end\n * @returns true if the user is part of the audience, false otherwise\n */\nexport async function isTargetedPercentile(userId: string | undefined, hint: string, from: number, to: number): Promise<boolean> {\n    if (from < 0 || from > 100) {\n        throw new Error(\"The 'from' value must be between 0 and 100.\");\n    }\n    if (to < 0 || to > 100) {\n        throw new Error(\"The 'to' value must be between 0 and 100.\");\n    }\n    if (from > to) {\n        throw new Error(\"The 'from' value cannot be larger than the 'to' value.\");\n    }\n\n    const audienceContextId = constructAudienceContextId(userId, hint);\n\n    // Cryptographic hashing algorithms ensure adequate entropy across hash values.\n    const contextMarker = await stringToUint32(audienceContextId);\n    const contextPercentage = (contextMarker / 0xFFFFFFFF) * 100;\n\n    // Handle edge case of exact 100 bucket\n    if (to === 100) {\n        return contextPercentage >= from;\n    }\n\n    return contextPercentage >= from && contextPercentage < to;\n}\n\n/**\n * Determines if the user is part of the audience, based on the groups they belong to.\n *\n * @param sourceGroups user groups from app context\n * @param targetedGroups targeted groups from feature configuration\n * @returns true if the user is part of the audience, false otherwise\n */\nexport function isTargetedGroup(sourceGroups: string[] | undefined, targetedGroups: string[]): boolean {\n    if (sourceGroups === undefined) {\n        return false;\n    }\n\n    return sourceGroups.some(group => targetedGroups.includes(group));\n}\n\n/**\n * Determines if the user is part of the audience, based on the user id.\n * @param userId user id from app context\n * @param users targeted users from feature configuration\n * @returns true if the user is part of the audience, false otherwise\n */\nexport function isTargetedUser(userId: string | undefined, users: string[]): boolean {\n    if (userId === undefined) {\n        return false;\n    }\n\n    return users.includes(userId);\n}\n\n/**\n * Constructs the context id for the audience.\n * The context id is used to determine if the user is part of the audience for a feature.\n *\n * @param userId userId from app context\n * @param hint hint string to be included in the context id\n * @returns a string that represents the context id for the audience\n */\nfunction constructAudienceContextId(userId: string | undefined, hint: string): string {\n    return `${userId ?? \"\"}\\n${hint}`;\n}\n\n/**\n * Converts a string to a uint32 in little-endian encoding.\n * @param str the string to convert.\n * @returns a uint32 value.\n */\nasync function stringToUint32(str: string): Promise<number> {\n    let crypto;\n\n    // Check for browser environment\n    if (typeof window !== \"undefined\" && window.crypto && window.crypto.subtle) {\n        crypto = window.crypto;\n    }\n    // Check for Node.js environment\n    else if (typeof global !== \"undefined\" && global.crypto) {\n        crypto = global.crypto;\n    }\n    // Fallback to native Node.js crypto module\n    else {\n        try {\n            if (typeof module !== \"undefined\" && module.exports) {\n                crypto = require(\"crypto\");\n            }\n            else {\n                crypto = await import(\"crypto\");\n            }\n        } catch (error) {\n            console.error(\"Failed to load the crypto module:\", error.message);\n            throw error;\n        }\n    }\n\n    // In the browser, use crypto.subtle.digest\n    if (crypto.subtle) {\n        const data = new TextEncoder().encode(str);\n        const hashBuffer = await crypto.subtle.digest(\"SHA-256\", data);\n        const dataView = new DataView(hashBuffer);\n        const uint32 = dataView.getUint32(0, true);\n        return uint32;\n    }\n    // In Node.js, use the crypto module's hash function\n    else {\n        const hash = crypto.createHash(\"sha256\").update(str).digest();\n        const uint32 = hash.readUInt32LE(0);\n        return uint32;\n    }\n}\n","// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT license.\n\nimport { IFeatureFilter } from \"./FeatureFilter.js\";\nimport { isTargetedPercentile } from \"../common/targetingEvaluator.js\";\nimport { ITargetingContext, ITargetingContextAccessor } from \"../common/targetingContext.js\";\n\ntype TargetingFilterParameters = {\n    Audience: {\n        DefaultRolloutPercentage: number;\n        Users?: string[];\n        Groups?: {\n            Name: string;\n            RolloutPercentage: number;\n        }[];\n        Exclusion?: {\n            Users?: string[];\n            Groups?: string[];\n        };\n    }\n}\n\ntype TargetingFilterEvaluationContext = {\n    featureName: string;\n    parameters: TargetingFilterParameters;\n}\n\nexport class TargetingFilter implements IFeatureFilter {\n    readonly name: string = \"Microsoft.Targeting\";\n    readonly #targetingContextAccessor?: ITargetingContextAccessor;\n\n    constructor(targetingContextAccessor?: ITargetingContextAccessor) {\n        this.#targetingContextAccessor = targetingContextAccessor;\n    }\n\n    async evaluate(context: TargetingFilterEvaluationContext, appContext?: ITargetingContext): Promise<boolean> {\n        const { featureName, parameters } = context;\n        TargetingFilter.#validateParameters(featureName, parameters);\n\n        let targetingContext: ITargetingContext | undefined;\n        if (appContext?.userId !== undefined || appContext?.groups !== undefined) {\n            targetingContext = appContext;\n        } else if (this.#targetingContextAccessor !== undefined) {\n            targetingContext = this.#targetingContextAccessor.getTargetingContext();\n        }\n\n        if (parameters.Audience.Exclusion !== undefined) {\n            // check if the user is in the exclusion list\n            if (targetingContext?.userId !== undefined &&\n                parameters.Audience.Exclusion.Users !== undefined &&\n                parameters.Audience.Exclusion.Users.includes(targetingContext.userId)) {\n                return false;\n            }\n            // check if the user is in a group within exclusion list\n            if (targetingContext?.groups !== undefined &&\n                parameters.Audience.Exclusion.Groups !== undefined) {\n                for (const excludedGroup of parameters.Audience.Exclusion.Groups) {\n                    if (targetingContext.groups.includes(excludedGroup)) {\n                        return false;\n                    }\n                }\n            }\n        }\n\n        // check if the user is being targeted directly\n        if (targetingContext?.userId !== undefined &&\n            parameters.Audience.Users !== undefined &&\n            parameters.Audience.Users.includes(targetingContext.userId)) {\n            return true;\n        }\n\n        // check if the user is in a group that is being targeted\n        if (targetingContext?.groups !== undefined &&\n            parameters.Audience.Groups !== undefined) {\n            for (const group of parameters.Audience.Groups) {\n                if (targetingContext.groups.includes(group.Name)) {\n                    const hint = `${featureName}\\n${group.Name}`;\n                    if (await isTargetedPercentile(targetingContext.userId, hint, 0, group.RolloutPercentage)) {\n                        return true;\n                    }\n                }\n            }\n        }\n\n        // check if the user is being targeted by a default rollout percentage\n        const hint = featureName;\n        return isTargetedPercentile(targetingContext?.userId, hint, 0, parameters.Audience.DefaultRolloutPercentage);\n    }\n\n    static #validateParameters(featureName: string, parameters: TargetingFilterParameters): void {\n        if (parameters.Audience.DefaultRolloutPercentage < 0 || parameters.Audience.DefaultRolloutPercentage > 100) {\n            throw new Error(`Invalid feature flag: ${featureName}. Audience.DefaultRolloutPercentage must be a number between 0 and 100.`);\n        }\n        // validate RolloutPercentage for each group\n        if (parameters.Audience.Groups !== undefined) {\n            for (const group of parameters.Audience.Groups) {\n                if (group.RolloutPercentage < 0 || group.RolloutPercentage > 100) {\n                    throw new Error(`Invalid feature flag: ${featureName}. RolloutPercentage of group ${group.Name} must be a number between 0 and 100.`);\n                }\n            }\n        }\n    }\n}\n","// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT license.\n\nexport class Variant {\n    constructor(\n        public name: string,\n        public configuration: unknown\n    ) {}\n}\n","// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT license.\n\nimport { TimeWindowFilter } from \"./filter/TimeWindowFilter.js\";\nimport { IFeatureFilter } from \"./filter/FeatureFilter.js\";\nimport { FeatureFlag, RequirementType, VariantDefinition } from \"./schema/model.js\";\nimport { IFeatureFlagProvider } from \"./featureProvider.js\";\nimport { TargetingFilter } from \"./filter/TargetingFilter.js\";\nimport { Variant } from \"./variant/Variant.js\";\nimport { IFeatureManager } from \"./IFeatureManager.js\";\nimport { ITargetingContext, ITargetingContextAccessor } from \"./common/targetingContext.js\";\nimport { isTargetedGroup, isTargetedPercentile, isTargetedUser } from \"./common/targetingEvaluator.js\";\n\nexport class FeatureManager implements IFeatureManager {\n    readonly #provider: IFeatureFlagProvider;\n    readonly #featureFilters: Map<string, IFeatureFilter> = new Map();\n    readonly #onFeatureEvaluated?: (event: EvaluationResult) => void;\n    readonly #targetingContextAccessor?: ITargetingContextAccessor;\n\n    constructor(provider: IFeatureFlagProvider, options?: FeatureManagerOptions) {\n        this.#provider = provider;\n        this.#onFeatureEvaluated = options?.onFeatureEvaluated;\n        this.#targetingContextAccessor = options?.targetingContextAccessor;\n\n        const builtinFilters = [new TimeWindowFilter(), new TargetingFilter(options?.targetingContextAccessor)];\n        // If a custom filter shares a name with an existing filter, the custom filter overrides the existing one.\n        for (const filter of [...builtinFilters, ...(options?.customFilters ?? [])]) {\n            this.#featureFilters.set(filter.name, filter);\n        }\n    }\n\n    async listFeatureNames(): Promise<string[]> {\n        const features = await this.#provider.getFeatureFlags();\n        const featureNameSet = new Set(features.map((feature) => feature.id));\n        return Array.from(featureNameSet);\n    }\n\n    // If multiple feature flags are found, the first one takes precedence.\n    async isEnabled(featureName: string, context?: unknown): Promise<boolean> {\n        const result = await this.#evaluateFeature(featureName, context);\n        return result.enabled;\n    }\n\n    async getVariant(featureName: string, context?: ITargetingContext): Promise<Variant | undefined> {\n        const result = await this.#evaluateFeature(featureName, context);\n        return result.variant;\n    }\n\n    async #assignVariant(featureFlag: FeatureFlag, context: ITargetingContext): Promise<VariantAssignment> {\n        // user allocation\n        if (featureFlag.allocation?.user !== undefined) {\n            for (const userAllocation of featureFlag.allocation.user) {\n                if (isTargetedUser(context.userId, userAllocation.users)) {\n                    return getVariantAssignment(featureFlag, userAllocation.variant, VariantAssignmentReason.User);\n                }\n            }\n        }\n\n        // group allocation\n        if (featureFlag.allocation?.group !== undefined) {\n            for (const groupAllocation of featureFlag.allocation.group) {\n                if (isTargetedGroup(context.groups, groupAllocation.groups)) {\n                    return getVariantAssignment(featureFlag, groupAllocation.variant, VariantAssignmentReason.Group);\n                }\n            }\n        }\n\n        // percentile allocation\n        if (featureFlag.allocation?.percentile !== undefined) {\n            for (const percentileAllocation of featureFlag.allocation.percentile) {\n                const hint = featureFlag.allocation.seed ?? `allocation\\n${featureFlag.id}`;\n                if (await isTargetedPercentile(context.userId, hint, percentileAllocation.from, percentileAllocation.to)) {\n                    return getVariantAssignment(featureFlag, percentileAllocation.variant, VariantAssignmentReason.Percentile);\n                }\n            }\n        }\n\n        return { variant: undefined, reason: VariantAssignmentReason.None };\n    }\n\n    async #isEnabled(featureFlag: FeatureFlag, appContext?: unknown): Promise<boolean> {\n        if (featureFlag.enabled !== true) {\n            // If the feature is not explicitly enabled, then it is disabled by default.\n            return false;\n        }\n\n        const clientFilters = featureFlag.conditions?.client_filters;\n        if (clientFilters === undefined || clientFilters.length <= 0) {\n            // If there are no client filters, then the feature is enabled.\n            return true;\n        }\n\n        const requirementType: RequirementType = featureFlag.conditions?.requirement_type ?? \"Any\"; // default to any.\n\n        /**\n         * While iterating through the client filters, we short-circuit the evaluation based on the requirement type.\n         * - When requirement type is \"All\", the feature is enabled if all client filters are matched. If any client filter is not matched, the feature is disabled, otherwise it is enabled. `shortCircuitEvaluationResult` is false.\n         * - When requirement type is \"Any\", the feature is enabled if any client filter is matched. If any client filter is matched, the feature is enabled, otherwise it is disabled. `shortCircuitEvaluationResult` is true.\n         */\n        const shortCircuitEvaluationResult: boolean = requirementType === \"Any\";\n\n        for (const clientFilter of clientFilters) {\n            const matchedFeatureFilter = this.#featureFilters.get(clientFilter.name);\n            const contextWithFeatureName = { featureName: featureFlag.id, parameters: clientFilter.parameters };\n            if (matchedFeatureFilter === undefined) {\n                console.warn(`Feature filter ${clientFilter.name} is not found.`);\n                return false;\n            }\n            if (await matchedFeatureFilter.evaluate(contextWithFeatureName, appContext) === shortCircuitEvaluationResult) {\n                return shortCircuitEvaluationResult;\n            }\n        }\n\n        // If we get here, then we have not found a client filter that matches the requirement type.\n        return !shortCircuitEvaluationResult;\n    }\n\n    async #evaluateFeature(featureName: string, appContext: unknown): Promise<EvaluationResult> {\n        const featureFlag = await this.#provider.getFeatureFlag(featureName);\n        const result = new EvaluationResult(featureFlag);\n\n        if (featureFlag === undefined) {\n            return result;\n        }\n\n        // Ensure that the feature flag is in the correct format. Feature providers should validate the feature flags, but we do it here as a safeguard.\n        // TODO: move to the feature flag provider implementation.\n        validateFeatureFlagFormat(featureFlag);\n\n        // Evaluate if the feature is enabled.\n        result.enabled = await this.#isEnabled(featureFlag, appContext);\n\n        // Get targeting context from the app context or the targeting context accessor\n        const targetingContext = this.#getTargetingContext(appContext);\n        result.targetingId = targetingContext?.userId;\n\n        // Determine Variant\n        let variantDef: VariantDefinition | undefined;\n        let reason: VariantAssignmentReason = VariantAssignmentReason.None;\n\n        // featureFlag.variant not empty\n        if (featureFlag.variants !== undefined && featureFlag.variants.length > 0) {\n            if (!result.enabled) {\n                // not enabled, assign default if specified\n                if (featureFlag.allocation?.default_when_disabled !== undefined) {\n                    variantDef = featureFlag.variants.find(v => v.name == featureFlag.allocation?.default_when_disabled);\n                    reason = VariantAssignmentReason.DefaultWhenDisabled;\n                } else {\n                    // no default specified\n                    variantDef = undefined;\n                    reason = VariantAssignmentReason.DefaultWhenDisabled;\n                }\n            } else {\n                // enabled, assign based on allocation\n                if (targetingContext !== undefined && featureFlag.allocation !== undefined) {\n                    const variantAndReason = await this.#assignVariant(featureFlag, targetingContext);\n                    variantDef = variantAndReason.variant;\n                    reason = variantAndReason.reason;\n                }\n\n                // allocation failed, assign default if specified\n                if (variantDef === undefined && reason === VariantAssignmentReason.None) {\n                    if (featureFlag.allocation?.default_when_enabled !== undefined) {\n                        variantDef = featureFlag.variants.find(v => v.name == featureFlag.allocation?.default_when_enabled);\n                        reason = VariantAssignmentReason.DefaultWhenEnabled;\n                    } else {\n                        variantDef = undefined;\n                        reason = VariantAssignmentReason.DefaultWhenEnabled;\n                    }\n                }\n            }\n        }\n\n        result.variant = variantDef !== undefined ? new Variant(variantDef.name, variantDef.configuration_value) : undefined;\n        result.variantAssignmentReason = reason;\n\n        // Status override for isEnabled\n        if (variantDef !== undefined && featureFlag.enabled) {\n            if (variantDef.status_override === \"Enabled\") {\n                result.enabled = true;\n            } else if (variantDef.status_override === \"Disabled\") {\n                result.enabled = false;\n            }\n        }\n\n        // The callback will only be executed if telemetry is enabled for the feature flag\n        if (featureFlag.telemetry?.enabled && this.#onFeatureEvaluated !== undefined) {\n            this.#onFeatureEvaluated(result);\n        }\n\n        return result;\n    }\n\n    #getTargetingContext(context: unknown): ITargetingContext | undefined {\n        let targetingContext: ITargetingContext | undefined = context as ITargetingContext;\n        if (targetingContext?.userId === undefined &&\n            targetingContext?.groups === undefined &&\n            this.#targetingContextAccessor !== undefined) {\n            targetingContext = this.#targetingContextAccessor.getTargetingContext();\n        }\n        return targetingContext;\n    }\n}\n\nexport interface FeatureManagerOptions {\n    /**\n     * The custom filters to be used by the feature manager.\n     */\n    customFilters?: IFeatureFilter[];\n\n    /**\n     * The callback function that is called when a feature flag is evaluated.\n     * The callback function is called only when telemetry is enabled for the feature flag.\n     */\n    onFeatureEvaluated?: (event: EvaluationResult) => void;\n\n    /**\n     * The accessor function that provides the @see ITargetingContext for targeting evaluation.\n     */\n    targetingContextAccessor?: ITargetingContextAccessor;\n}\n\nexport class EvaluationResult {\n    constructor(\n        // feature flag definition\n        public readonly feature: FeatureFlag | undefined,\n\n        // enabled state\n        public enabled: boolean = false,\n\n        // variant assignment\n        public targetingId: string | undefined = undefined,\n        public variant: Variant | undefined = undefined,\n        public variantAssignmentReason: VariantAssignmentReason = VariantAssignmentReason.None\n    ) { }\n}\n\nexport enum VariantAssignmentReason {\n    /**\n     * Variant allocation did not happen. No variant is assigned.\n     */\n    None = \"None\",\n\n    /**\n     * The default variant is assigned when a feature flag is disabled.\n     */\n    DefaultWhenDisabled = \"DefaultWhenDisabled\",\n\n    /**\n     * The default variant is assigned because of no applicable user/group/percentile allocation when a feature flag is enabled.\n     */\n    DefaultWhenEnabled = \"DefaultWhenEnabled\",\n\n    /**\n     * The variant is assigned because of the user allocation when a feature flag is enabled.\n     */\n    User = \"User\",\n\n    /**\n     * The variant is assigned because of the group allocation when a feature flag is enabled.\n     */\n    Group = \"Group\",\n\n    /**\n     * The variant is assigned because of the percentile allocation when a feature flag is enabled.\n     */\n    Percentile = \"Percentile\"\n}\n\n/**\n * Validates the format of the feature flag definition.\n *\n * FeatureFlag data objects are from IFeatureFlagProvider, depending on the implementation.\n * Thus the properties are not guaranteed to have the expected types.\n *\n * @param featureFlag The feature flag definition to validate.\n */\nfunction validateFeatureFlagFormat(featureFlag: any): void {\n    if (featureFlag.enabled !== undefined && typeof featureFlag.enabled !== \"boolean\") {\n        throw new Error(`Feature flag ${featureFlag.id} has an invalid 'enabled' value.`);\n    }\n    // TODO: add more validations.\n    // TODO: should be moved to the feature flag provider.\n}\n\n/**\n * Try to get the variant assignment for the given variant name. If the variant is not found, override the reason with VariantAssignmentReason.None.\n *\n * @param featureFlag feature flag definition\n * @param variantName variant name\n * @param reason variant assignment reason\n * @returns variant assignment containing the variant definition and the reason\n */\nfunction getVariantAssignment(featureFlag: FeatureFlag, variantName: string, reason: VariantAssignmentReason): VariantAssignment {\n    const variant = featureFlag.variants?.find(v => v.name == variantName);\n    if (variant !== undefined) {\n        return { variant, reason };\n    } else {\n        console.warn(`Variant ${variantName} not found for feature ${featureFlag.id}.`);\n        return { variant: undefined, reason: VariantAssignmentReason.None };\n    }\n}\n\ntype VariantAssignment = {\n    variant: VariantDefinition | undefined;\n    reason: VariantAssignmentReason;\n};\n","// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT license.\n\n// Converted from:\n// https://github.com/Azure/AppConfiguration/blob/6e544296a5607f922a423df165f60801717c7800/docs/FeatureManagement/FeatureFlag.v2.0.0.schema.json\n\n/**\n * A feature flag is a named property that can be toggled to enable or disable some feature of an application.\n */\nexport interface FeatureFlag {\n    /**\n     * An ID used to uniquely identify and reference the feature.\n     */\n    id: string;\n    /**\n     * A feature is OFF if enabled is false. If enabled is true, then the feature is ON if there are no conditions (null or empty) or if the conditions are satisfied.\n     */\n    enabled?: boolean;\n    /**\n     * The declaration of conditions used to dynamically enable the feature.\n     */\n    conditions?: FeatureEnablementConditions;\n    /**\n     * The list of variants defined for this feature. A variant represents a configuration value of a feature flag that can be a string, a number, a boolean, or a JSON object.\n     */\n    variants?: VariantDefinition[];\n    /**\n     * Determines how variants should be allocated for the feature to various users.\n     */\n    allocation?: VariantAllocation;\n    /**\n     * The declaration of options used to configure telemetry for this feature.\n     */\n    telemetry?: TelemetryOptions\n  }\n\n  /**\n  * The declaration of conditions used to dynamically enable the feature\n  */\n  interface FeatureEnablementConditions {\n    /**\n     * Determines whether any or all registered client filters must be evaluated as true for the feature to be considered enabled.\n     */\n    requirement_type?: RequirementType;\n    /**\n     * Filters that must run on the client and be evaluated as true for the feature to be considered enabled.\n     */\n    client_filters?: ClientFilter[];\n  }\n\n  export type RequirementType = \"Any\" | \"All\";\n\n  interface ClientFilter {\n    /**\n     * The name used to refer to a client filter.\n     */\n    name: string;\n    /**\n     * Parameters for a given client filter. A client filter can require any set of parameters of any type.\n     */\n    parameters?: Record<string, unknown>;\n  }\n\n  export interface VariantDefinition {\n    /**\n     * The name used to refer to a feature variant.\n     */\n    name: string;\n    /**\n     * The configuration value for this feature variant.\n     */\n    configuration_value?: unknown;\n    /**\n     * Overrides the enabled state of the feature if the given variant is assigned. Does not override the state if value is None.\n     */\n    status_override?: \"None\" | \"Enabled\" | \"Disabled\";\n  }\n\n  /**\n  * Determines how variants should be allocated for the feature to various users.\n  */\n  interface VariantAllocation {\n    /**\n     * Specifies which variant should be used when the feature is considered disabled.\n     */\n    default_when_disabled?: string;\n    /**\n     * Specifies which variant should be used when the feature is considered enabled and no other allocation rules are applicable.\n     */\n    default_when_enabled?: string;\n    /**\n     * A list of objects, each containing a variant name and list of users for whom that variant should be used.\n     */\n    user?: UserAllocation[];\n    /**\n     * A list of objects, each containing a variant name and list of groups for which that variant should be used.\n     */\n    group?: GroupAllocation[];\n    /**\n     * A list of objects, each containing a variant name and percentage range for which that variant should be used.\n     */\n    percentile?: PercentileAllocation[]\n    /**\n     * The value percentile calculations are based on. The calculated percentile is consistent across features for a given user if the same nonempty seed is used.\n     */\n    seed?: string;\n  }\n\n  interface UserAllocation {\n    /**\n     * The name of the variant to use if the user allocation matches the current user.\n     */\n    variant: string;\n    /**\n     * Collection of users where if any match the current user, the variant specified in the user allocation is used.\n     */\n    users: string[];\n  }\n\n  interface GroupAllocation {\n    /**\n     * The name of the variant to use if the group allocation matches a group the current user is in.\n     */\n    variant: string;\n    /**\n     * Collection of groups where if the current user is in any of these groups, the variant specified in the group allocation is used.\n     */\n    groups: string[];\n  }\n\n  interface PercentileAllocation {\n    /**\n     * The name of the variant to use if the calculated percentile for the current user falls in the provided range.\n     */\n    variant: string;\n    /**\n     * The lower end of the percentage range for which this variant will be used.\n     */\n    from: number;\n    /**\n     * The upper end of the percentage range for which this variant will be used.\n     */\n    to: number;\n  }\n\n  /**\n  * The declaration of options used to configure telemetry for this feature.\n  */\n  interface TelemetryOptions {\n    /**\n     * Indicates if telemetry is enabled.\n     */\n    enabled?: boolean;\n    /**\n     * A container for metadata that should be bundled with flag telemetry.\n     */\n    metadata?: Record<string, string>;\n  }\n\n  // Feature Management Section fed into feature manager.\n  // Converted from https://github.com/Azure/AppConfiguration/blob/main/docs/FeatureManagement/FeatureManagement.v1.0.0.schema.json\n\n  export const FEATURE_MANAGEMENT_KEY = \"feature_management\";\n  export const FEATURE_FLAGS_KEY = \"feature_flags\";\n\n  export interface FeatureManagementConfiguration {\n    feature_management: FeatureManagement\n  }\n\n  /**\n   * Declares feature management configuration.\n   */\n  export interface FeatureManagement {\n    feature_flags: FeatureFlag[];\n  }\n","// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT license.\n\n/**\n * Validates a feature flag object, checking if it conforms to the schema.\n * @param featureFlag The feature flag object to validate.\n */\nexport function validateFeatureFlag(featureFlag: any): void {\n    if (featureFlag === undefined) {\n        return; // no-op if feature flag is undefined, indicating that the feature flag is not found\n    }\n    if (featureFlag === null || typeof featureFlag !== \"object\") { // Note: typeof null = \"object\"\n        throw new TypeError(\"Feature flag must be an object.\");\n    }\n    if (typeof featureFlag.id !== \"string\") {\n        throw new TypeError(\"Feature flag 'id' must be a string.\");\n    }\n\n    if (featureFlag.enabled !== undefined && typeof featureFlag.enabled !== \"boolean\") {\n        throw new TypeError(`Invalid feature flag: ${featureFlag.id}. Feature flag 'enabled' must be a boolean.`);\n    }\n    if (featureFlag.conditions !== undefined) {\n        validateFeatureEnablementConditions(featureFlag.id, featureFlag.conditions);\n    }\n    if (featureFlag.variants !== undefined) {\n        validateVariants(featureFlag.id, featureFlag.variants);\n    }\n    if (featureFlag.allocation !== undefined) {\n        validateVariantAllocation(featureFlag.id, featureFlag.allocation);\n    }\n    if (featureFlag.telemetry !== undefined) {\n        validateTelemetryOptions(featureFlag.id, featureFlag.telemetry);\n    }\n}\n\nfunction validateFeatureEnablementConditions(id: string, conditions: any) {\n    if (typeof conditions !== \"object\") {\n        throw new TypeError(`Invalid feature flag: ${id}. Feature flag 'conditions' must be an object.`);\n    }\n    if (conditions.requirement_type !== undefined && conditions.requirement_type !== \"Any\" && conditions.requirement_type !== \"All\") {\n        throw new TypeError(`Invalid feature flag: ${id}. 'requirement_type' must be 'Any' or 'All'.`);\n    }\n    if (conditions.client_filters !== undefined) {\n        validateClientFilters(id, conditions.client_filters);\n    }\n}\n\nfunction validateClientFilters(id: string, client_filters: any) {\n    if (!Array.isArray(client_filters)) {\n        throw new TypeError(`Invalid feature flag: ${id}. Feature flag conditions 'client_filters' must be an array.`);\n    }\n\n    for (const filter of client_filters) {\n        if (typeof filter.name !== \"string\") {\n            throw new TypeError(`Invalid feature flag: ${id}. Client filter 'name' must be a string.`);\n        }\n        if (filter.parameters !== undefined && typeof filter.parameters !== \"object\") {\n            throw new TypeError(`Invalid feature flag: ${id}. Client filter 'parameters' must be an object.`);\n        }\n    }\n}\n\nfunction validateVariants(id: string, variants: any) {\n    if (!Array.isArray(variants)) {\n        throw new TypeError(`Invalid feature flag: ${id}. Feature flag 'variants' must be an array.`);\n    }\n\n    for (const variant of variants) {\n        if (typeof variant.name !== \"string\") {\n            throw new TypeError(`Invalid feature flag: ${id}. Variant 'name' must be a string.`);\n        }\n        // skip configuration_value validation as it accepts any type\n        if (variant.status_override !== undefined && typeof variant.status_override !== \"string\") {\n            throw new TypeError(`Invalid feature flag: ${id}. Variant 'status_override' must be a string.`);\n        }\n        if (variant.status_override !== undefined && variant.status_override !== \"None\" && variant.status_override !== \"Enabled\" && variant.status_override !== \"Disabled\") {\n            throw new TypeError(`Invalid feature flag: ${id}. Variant 'status_override' must be 'None', 'Enabled', or 'Disabled'.`);\n        }\n    }\n}\n\nfunction validateVariantAllocation(id: string, allocation: any) {\n    if (typeof allocation !== \"object\") {\n        throw new TypeError(`Invalid feature flag: ${id}. Variant 'allocation' must be an object.`);\n    }\n\n    if (allocation.default_when_disabled !== undefined && typeof allocation.default_when_disabled !== \"string\") {\n        throw new TypeError(`Invalid feature flag: ${id}. Variant allocation 'default_when_disabled' must be a string.`);\n    }\n    if (allocation.default_when_enabled !== undefined && typeof allocation.default_when_enabled !== \"string\") {\n        throw new TypeError(`Invalid feature flag: ${id}. Variant allocation 'default_when_enabled' must be a string.`);\n    }\n    if (allocation.user !== undefined) {\n        validateUserVariantAllocation(id, allocation.user);\n    }\n    if (allocation.group !== undefined) {\n        validateGroupVariantAllocation(id, allocation.group);\n    }\n    if (allocation.percentile !== undefined) {\n        validatePercentileVariantAllocation(id, allocation.percentile);\n    }\n    if (allocation.seed !== undefined && typeof allocation.seed !== \"string\") {\n        throw new TypeError(`Invalid feature flag: ${id}. Variant allocation 'seed' must be a string.`);\n    }\n}\n\nfunction validateUserVariantAllocation(id: string, UserAllocations: any) {\n    if (!Array.isArray(UserAllocations)) {\n        throw new TypeError(`Invalid feature flag: ${id}. Variant 'user' allocation must be an array.`);\n    }\n\n    for (const allocation of UserAllocations) {\n        if (typeof allocation !== \"object\") {\n            throw new TypeError(`Invalid feature flag: ${id}. Elements in variant 'user' allocation must be an object.`);\n        }\n        if (typeof allocation.variant !== \"string\") {\n            throw new TypeError(`Invalid feature flag: ${id}. User allocation 'variant' must be a string.`);\n        }\n        if (!Array.isArray(allocation.users)) {\n            throw new TypeError(`Invalid feature flag: ${id}. User allocation 'users' must be an array.`);\n        }\n        for (const user of allocation.users) {\n            if (typeof user !== \"string\") {\n                throw new TypeError(`Invalid feature flag: ${id}. Elements in user allocation 'users' must be strings.`);\n            }\n        }\n    }\n}\n\nfunction validateGroupVariantAllocation(id: string, groupAllocations: any) {\n    if (!Array.isArray(groupAllocations)) {\n        throw new TypeError(`Invalid feature flag: ${id}. Variant 'group' allocation must be an array.`);\n    }\n\n    for (const allocation of groupAllocations) {\n        if (typeof allocation !== \"object\") {\n            throw new TypeError(`Invalid feature flag: ${id}. Elements in variant 'group' allocation must be an object.`);\n        }\n        if (typeof allocation.variant !== \"string\") {\n            throw new TypeError(`Invalid feature flag: ${id}. Group allocation 'variant' must be a string.`);\n        }\n        if (!Array.isArray(allocation.groups)) {\n            throw new TypeError(`Invalid feature flag: ${id}. Group allocation 'groups' must be an array.`);\n        }\n        for (const group of allocation.groups) {\n            if (typeof group !== \"string\") {\n                throw new TypeError(`Invalid feature flag: ${id}. Elements in group allocation 'groups' must be strings.`);\n            }\n        }\n    }\n}\n\nfunction validatePercentileVariantAllocation(id: string, percentileAllocations: any) {\n    if (!Array.isArray(percentileAllocations)) {\n        throw new TypeError(`Invalid feature flag: ${id}. Variant 'percentile' allocation must be an array.`);\n    }\n\n    for (const allocation of percentileAllocations) {\n        if (typeof allocation !== \"object\") {\n            throw new TypeError(`Invalid feature flag: ${id}. Elements in variant 'percentile' allocation must be an object.`);\n        }\n        if (typeof allocation.variant !== \"string\") {\n            throw new TypeError(`Invalid feature flag: ${id}. Percentile allocation 'variant' must be a string.`);\n        }\n        if (typeof allocation.from !== \"number\" || allocation.from < 0 || allocation.from > 100) {\n            throw new TypeError(`Invalid feature flag: ${id}. Percentile allocation 'from' must be a number between 0 and 100.`);\n        }\n        if (typeof allocation.to !== \"number\" || allocation.to < 0 || allocation.to > 100) {\n            throw new TypeError(`Invalid feature flag: ${id}. Percentile allocation 'to' must be a number between 0 and 100.`);\n        }\n    }\n}\n// #endregion\n\n// #region Telemetry\nfunction validateTelemetryOptions(id: string, telemetry: any) {\n    if (typeof telemetry !== \"object\") {\n        throw new TypeError(`Invalid feature flag: ${id}. Feature flag 'telemetry' must be an object.`);\n    }\n    if (telemetry.enabled !== undefined && typeof telemetry.enabled !== \"boolean\") {\n        throw new TypeError(`Invalid feature flag: ${id}. Telemetry 'enabled' must be a boolean.`);\n    }\n    if (telemetry.metadata !== undefined && typeof telemetry.metadata !== \"object\") {\n        throw new TypeError(`Invalid feature flag: ${id}. Telemetry 'metadata' must be an object.`);\n    }\n}\n// #endregion\n","// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT license.\n\nimport { IGettable } from \"./gettable.js\";\nimport { FeatureFlag, FeatureManagementConfiguration, FEATURE_MANAGEMENT_KEY, FEATURE_FLAGS_KEY } from \"./schema/model.js\";\nimport { validateFeatureFlag } from \"./schema/validator.js\";\n\nexport interface IFeatureFlagProvider {\n    /**\n     * Get all feature flags.\n     */\n    getFeatureFlags(): Promise<FeatureFlag[]>;\n\n    /**\n     * Get a feature flag by name.\n     * @param featureName The name of the feature flag.\n     */\n    getFeatureFlag(featureName: string): Promise<FeatureFlag | undefined>;\n}\n\n/**\n * A feature flag provider that uses a map-like configuration to provide feature flags.\n */\nexport class ConfigurationMapFeatureFlagProvider implements IFeatureFlagProvider {\n    #configuration: IGettable;\n\n    constructor(configuration: IGettable) {\n        this.#configuration = configuration;\n    }\n    async getFeatureFlag(featureName: string): Promise<FeatureFlag | undefined> {\n        const featureConfig = this.#configuration.get<FeatureManagementConfiguration>(FEATURE_MANAGEMENT_KEY);\n        const featureFlag = featureConfig?.[FEATURE_FLAGS_KEY]?.findLast((feature) => feature.id === featureName);\n        validateFeatureFlag(featureFlag);\n        return featureFlag;\n    }\n\n    async getFeatureFlags(): Promise<FeatureFlag[]> {\n        const featureConfig = this.#configuration.get<FeatureManagementConfiguration>(FEATURE_MANAGEMENT_KEY);\n        const featureFlags = featureConfig?.[FEATURE_FLAGS_KEY] ?? [];\n        featureFlags.forEach(featureFlag => {\n            validateFeatureFlag(featureFlag);\n        });\n        return featureFlags;\n    }\n}\n\n/**\n * A feature flag provider that uses an object-like configuration to provide feature flags.\n */\nexport class ConfigurationObjectFeatureFlagProvider implements IFeatureFlagProvider {\n    #configuration: Record<string, unknown>;\n\n    constructor(configuration: Record<string, unknown>) {\n        this.#configuration = configuration;\n    }\n\n    async getFeatureFlag(featureName: string): Promise<FeatureFlag | undefined> {\n        const featureFlags = this.#configuration[FEATURE_MANAGEMENT_KEY]?.[FEATURE_FLAGS_KEY];\n        const featureFlag = featureFlags?.findLast((feature: FeatureFlag) => feature.id === featureName);\n        validateFeatureFlag(featureFlag);\n        return featureFlag;\n    }\n\n    async getFeatureFlags(): Promise<FeatureFlag[]> {\n        const featureFlags = this.#configuration[FEATURE_MANAGEMENT_KEY]?.[FEATURE_FLAGS_KEY] ?? [];\n        featureFlags.forEach(featureFlag => {\n            validateFeatureFlag(featureFlag);\n        });\n        return featureFlags;\n    }\n}\n","// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT license.\n\nexport const VERSION = \"2.1.0\";\nexport const EVALUATION_EVENT_VERSION = \"1.0.0\";\n","// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT license.\n\nimport { EvaluationResult, VariantAssignmentReason } from \"../featureManager\";\nimport { EVALUATION_EVENT_VERSION } from \"../version.js\";\n\nconst VERSION = \"Version\";\nconst FEATURE_NAME = \"FeatureName\";\nconst ENABLED = \"Enabled\";\nconst TARGETING_ID = \"TargetingId\";\nconst VARIANT = \"Variant\";\nconst VARIANT_ASSIGNMENT_REASON = \"VariantAssignmentReason\";\nconst DEFAULT_WHEN_ENABLED = \"DefaultWhenEnabled\";\nconst VARIANT_ASSIGNMENT_PERCENTAGE = \"VariantAssignmentPercentage\";\n\nexport function createFeatureEvaluationEventProperties(result: EvaluationResult): any {\n    if (result.feature === undefined) {\n        return undefined;\n    }\n\n    const eventProperties = {\n        [VERSION]: EVALUATION_EVENT_VERSION,\n        [FEATURE_NAME]: result.feature ? result.feature.id : \"\",\n        [ENABLED]: result.enabled ? \"True\" : \"False\",\n        // Ensure targetingId is string so that it will be placed in customDimensions\n        [TARGETING_ID]: result.targetingId ? result.targetingId.toString() : \"\",\n        [VARIANT]: result.variant ? result.variant.name : \"\",\n        [VARIANT_ASSIGNMENT_REASON]: result.variantAssignmentReason,\n    };\n\n    if (result.feature.allocation?.default_when_enabled) {\n        eventProperties[DEFAULT_WHEN_ENABLED] = result.feature.allocation.default_when_enabled;\n    }\n\n    if (result.variantAssignmentReason === VariantAssignmentReason.DefaultWhenEnabled) {\n        let percentileAllocationPercentage = 0;\n        if (result.variant !== undefined && result.feature.allocation !== undefined && result.feature.allocation.percentile !== undefined) {\n            for (const percentile of result.feature.allocation.percentile) {\n                percentileAllocationPercentage += percentile.to - percentile.from;\n            }\n        }\n        eventProperties[VARIANT_ASSIGNMENT_PERCENTAGE] = (100 - percentileAllocationPercentage).toString();\n    }\n    else if (result.variantAssignmentReason === VariantAssignmentReason.Percentile) {\n        let percentileAllocationPercentage = 0;\n        if (result.variant !== undefined && result.feature.allocation !== undefined && result.feature.allocation.percentile !== undefined) {\n            for (const percentile of result.feature.allocation.percentile) {\n                if (percentile.variant === result.variant.name) {\n                    percentileAllocationPercentage += percentile.to - percentile.from;\n                }\n            }\n        }\n        eventProperties[VARIANT_ASSIGNMENT_PERCENTAGE] = percentileAllocationPercentage.toString();\n    }\n\n    const metadata = result.feature.telemetry?.metadata;\n    if (metadata) {\n        for (const key in metadata) {\n            if (!(key in eventProperties)) {\n                eventProperties[key] = metadata[key];\n            }\n        }\n    }\n\n    return eventProperties;\n}\n"],"names":["VariantAssignmentReason","VERSION"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@microsoft/feature-management",
-  "version": "2.0.2",
+  "version": "2.1.0",
   "description": "Feature Management is a library for enabling/disabling features at runtime. Developers can use feature flags in simple use cases like conditional statement to more advanced scenarios like conditionally adding routes.",
   "main": "./dist/commonjs/index.js",
   "module": "./dist/esm/index.js",

package/types/index.d.ts

@@ -191,10 +191,28 @@ declare class Variant {
     constructor(name: string, configuration: unknown);
 }
 
+/**
+ * Contextual information that is required to perform a targeting evaluation.
+ */
 interface ITargetingContext {
+    /**
+     * The user id that should be considered when evaluating if the context is being targeted.
+     */
     userId?: string;
+    /**
+     * The groups that should be considered when evaluating if the context is being targeted.
+     */
     groups?: string[];
 }
+/**
+ * Provides access to the current targeting context.
+ */
+interface ITargetingContextAccessor {
+    /**
+     * Retrieves the current targeting context.
+     */
+    getTargetingContext: () => ITargetingContext | undefined;
+}
 
 interface IFeatureManager {
     /**
@@ -232,6 +250,10 @@ interface FeatureManagerOptions {
      * The callback function is called only when telemetry is enabled for the feature flag.
      */
     onFeatureEvaluated?: (event: EvaluationResult) => void;
+    /**
+     * The accessor function that provides the @see ITargetingContext for targeting evaluation.
+     */
+    targetingContextAccessor?: ITargetingContextAccessor;
 }
 declare class EvaluationResult {
     readonly feature: FeatureFlag | undefined;
@@ -270,6 +292,6 @@ declare enum VariantAssignmentReason {
 
 declare function createFeatureEvaluationEventProperties(result: EvaluationResult): any;
 
-declare const VERSION = "2.0.2";
+declare const VERSION = "2.1.0";
 
-export { ConfigurationMapFeatureFlagProvider, ConfigurationObjectFeatureFlagProvider, EvaluationResult, FeatureManager, type FeatureManagerOptions, type IFeatureFilter, type IFeatureFlagProvider, VERSION, VariantAssignmentReason, createFeatureEvaluationEventProperties };
+export { ConfigurationMapFeatureFlagProvider, ConfigurationObjectFeatureFlagProvider, EvaluationResult, FeatureManager, type FeatureManagerOptions, type IFeatureFilter, type IFeatureFlagProvider, type ITargetingContext, type ITargetingContextAccessor, VERSION, VariantAssignmentReason, createFeatureEvaluationEventProperties };