@microsoft/feature-management 2.1.0 → 2.3.0

package/dist/esm/filter/recurrence/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sources":["../../../../src/filter/recurrence/validator.ts"],"sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT license.\n\nimport { RecurrenceParameters } from \"../timeWindowFilter.js\";\nimport { VALUE_OUT_OF_RANGE_ERROR_MESSAGE, UNRECOGNIZABLE_VALUE_ERROR_MESSAGE, REQUIRED_PARAMETER_MISSING_ERROR_MESSAGE, buildInvalidParameterErrorMessage } from \"../utils.js\";\nimport { DayOfWeek, RecurrenceSpec, RecurrencePattern, RecurrenceRange, RecurrencePatternType, RecurrenceRangeType, DAYS_PER_WEEK, ONE_DAY_IN_MILLISECONDS } from \"./model.js\";\nimport { calculateWeeklyDayOffset, sortDaysOfWeek, getDayOfWeek } from \"./utils.js\";\n\nexport const START_NOT_MATCHED_ERROR_MESSAGE = \"Start date is not a valid first occurrence.\";\nexport const TIME_WINDOW_DURATION_OUT_OF_RANGE_ERROR_MESSAGE = \"Time window duration cannot be longer than how frequently it occurs or be longer than 10 years.\";\nexport const PATTERN = \"Recurrence.Pattern\";\nexport const PATTERN_TYPE = \"Recurrence.Pattern.Type\";\nexport const INTERVAL = \"Recurrence.Pattern.Interval\";\nexport const DAYS_OF_WEEK = \"Recurrence.Pattern.DaysOfWeek\";\nexport const FIRST_DAY_OF_WEEK = \"Recurrence.Pattern.FirstDayOfWeek\";\nexport const RANGE = \"Recurrence.Range\";\nexport const RANGE_TYPE = \"Recurrence.Range.Type\";\nexport const END_DATE = \"Recurrence.Range.EndDate\";\nexport const NUMBER_OF_OCCURRENCES = \"Recurrence.Range.NumberOfOccurrences\";\n\n/**\n * Parses @see RecurrenceParameters into a @see RecurrenceSpec object. If the parameter is invalid, an error will be thrown.\n * @param startTime The start time of the base time window\n * @param day2 The end time of the base time window\n * @param recurrenceParameters The @see RecurrenceParameters to parse\n * @param TimeZoneOffset The time zone offset in milliseconds, by default 0\n * @returns A @see RecurrenceSpec object\n */\nexport function parseRecurrenceParameter(startTime: Date | undefined, endTime: Date | undefined, recurrenceParameters: RecurrenceParameters, TimeZoneOffset: number = 0): RecurrenceSpec {\n    if (startTime === undefined) {\n        throw new Error(buildInvalidParameterErrorMessage(\"Start\", REQUIRED_PARAMETER_MISSING_ERROR_MESSAGE));\n    }\n    if (endTime === undefined) {\n        throw new Error(buildInvalidParameterErrorMessage(\"End\", REQUIRED_PARAMETER_MISSING_ERROR_MESSAGE));\n    }\n    if (startTime >= endTime) {\n        throw new Error(buildInvalidParameterErrorMessage(\"End\", VALUE_OUT_OF_RANGE_ERROR_MESSAGE));\n    }\n    const timeWindowDuration = endTime.getTime() - startTime.getTime();\n    if (timeWindowDuration > 10 * 365 * ONE_DAY_IN_MILLISECONDS) { // time window duration cannot be longer than 10 years\n        throw new Error(buildInvalidParameterErrorMessage(\"End\", TIME_WINDOW_DURATION_OUT_OF_RANGE_ERROR_MESSAGE));\n    }\n\n    return {\n        startTime: startTime,\n        duration: timeWindowDuration,\n        pattern: parseRecurrencePattern(startTime, endTime, recurrenceParameters, TimeZoneOffset),\n        range: parseRecurrenceRange(startTime, recurrenceParameters),\n        timezoneOffset: TimeZoneOffset\n    };\n}\n\nfunction parseRecurrencePattern(startTime: Date, endTime: Date, recurrenceParameters: RecurrenceParameters, timeZoneOffset: number): RecurrencePattern {\n    const rawPattern = recurrenceParameters.Pattern;\n    if (rawPattern === undefined) {\n        throw new Error(buildInvalidParameterErrorMessage(PATTERN, REQUIRED_PARAMETER_MISSING_ERROR_MESSAGE));\n    }\n    if (rawPattern.Type === undefined) {\n        throw new Error(buildInvalidParameterErrorMessage(PATTERN_TYPE, REQUIRED_PARAMETER_MISSING_ERROR_MESSAGE));\n    }\n    const patternType = RecurrencePatternType[rawPattern.Type];\n    if (patternType === undefined) {\n        throw new Error(buildInvalidParameterErrorMessage(PATTERN_TYPE, UNRECOGNIZABLE_VALUE_ERROR_MESSAGE));\n    }\n    let interval = rawPattern.Interval;\n    if (interval !== undefined) {\n        if (typeof interval !== \"number\") {\n            throw new Error(buildInvalidParameterErrorMessage(INTERVAL, UNRECOGNIZABLE_VALUE_ERROR_MESSAGE));\n        } else if (interval <= 0 || !Number.isInteger(interval)) {\n            throw new Error(buildInvalidParameterErrorMessage(INTERVAL, VALUE_OUT_OF_RANGE_ERROR_MESSAGE));\n        }\n    } else {\n        interval = 1;\n    }\n    const parsedPattern: RecurrencePattern = {\n        type: patternType,\n        interval: interval\n    };\n    const timeWindowDuration = endTime.getTime() - startTime.getTime();\n    if (patternType === RecurrencePatternType.Daily) {\n        if (timeWindowDuration > interval * ONE_DAY_IN_MILLISECONDS) {\n            throw new Error(buildInvalidParameterErrorMessage(\"End\", TIME_WINDOW_DURATION_OUT_OF_RANGE_ERROR_MESSAGE));\n        }\n    } else if (patternType === RecurrencePatternType.Weekly) {\n        let firstDayOfWeek: DayOfWeek;\n        if (rawPattern.FirstDayOfWeek !== undefined) {\n            firstDayOfWeek = DayOfWeek[rawPattern.FirstDayOfWeek];\n            if (firstDayOfWeek === undefined) {\n                throw new Error(buildInvalidParameterErrorMessage(FIRST_DAY_OF_WEEK, UNRECOGNIZABLE_VALUE_ERROR_MESSAGE));\n            }\n        }\n        else {\n            firstDayOfWeek = DayOfWeek.Sunday;\n        }\n        parsedPattern.firstDayOfWeek = firstDayOfWeek;\n\n        if (rawPattern.DaysOfWeek === undefined || rawPattern.DaysOfWeek.length === 0) {\n            throw new Error(buildInvalidParameterErrorMessage(DAYS_OF_WEEK, REQUIRED_PARAMETER_MISSING_ERROR_MESSAGE));\n        }\n        if (!Array.isArray(rawPattern.DaysOfWeek)) {\n            throw new Error(buildInvalidParameterErrorMessage(DAYS_OF_WEEK, UNRECOGNIZABLE_VALUE_ERROR_MESSAGE));\n        }\n        const daysOfWeek = [...new Set(rawPattern.DaysOfWeek.map(day => DayOfWeek[day]))]; // dedup array\n        if (daysOfWeek.some(day => day === undefined)) {\n            throw new Error(buildInvalidParameterErrorMessage(DAYS_OF_WEEK, UNRECOGNIZABLE_VALUE_ERROR_MESSAGE));\n        }\n        if (timeWindowDuration > interval * DAYS_PER_WEEK * ONE_DAY_IN_MILLISECONDS ||\n            !isDurationCompliantWithDaysOfWeek(timeWindowDuration, interval, daysOfWeek, firstDayOfWeek)) {\n            throw new Error(buildInvalidParameterErrorMessage(\"End\", TIME_WINDOW_DURATION_OUT_OF_RANGE_ERROR_MESSAGE));\n        }\n        parsedPattern.daysOfWeek = daysOfWeek;\n\n        // check whether \"Start\" is a valid first occurrence\n        const alignedStartDay = getDayOfWeek(startTime, timeZoneOffset);\n        if (!daysOfWeek.find(day => day === alignedStartDay)) {\n            throw new Error(buildInvalidParameterErrorMessage(\"Start\", START_NOT_MATCHED_ERROR_MESSAGE));\n        }\n    }\n    return parsedPattern;\n}\n\nfunction parseRecurrenceRange(startTime: Date, recurrenceParameters: RecurrenceParameters): RecurrenceRange {\n    const rawRange = recurrenceParameters.Range;\n    if (rawRange === undefined) {\n        throw new Error(buildInvalidParameterErrorMessage(RANGE, REQUIRED_PARAMETER_MISSING_ERROR_MESSAGE));\n    }\n    if (rawRange.Type === undefined) {\n        throw new Error(buildInvalidParameterErrorMessage(RANGE_TYPE, REQUIRED_PARAMETER_MISSING_ERROR_MESSAGE));\n    }\n    const rangeType = RecurrenceRangeType[rawRange.Type];\n    if (rangeType === undefined) {\n        throw new Error(buildInvalidParameterErrorMessage(RANGE_TYPE, UNRECOGNIZABLE_VALUE_ERROR_MESSAGE));\n    }\n    const parsedRange: RecurrenceRange = { type: rangeType };\n    if (rangeType === RecurrenceRangeType.EndDate) {\n        let endDate: Date;\n        if (rawRange.EndDate !== undefined) {\n            endDate = new Date(rawRange.EndDate);\n            if (isNaN(endDate.getTime())) {\n                throw new Error(buildInvalidParameterErrorMessage(END_DATE, UNRECOGNIZABLE_VALUE_ERROR_MESSAGE));\n            }\n            if (endDate < startTime) {\n                throw new Error(buildInvalidParameterErrorMessage(END_DATE, VALUE_OUT_OF_RANGE_ERROR_MESSAGE));\n            }\n        } else {\n            endDate = new Date(8.64e15); // the maximum date in ECMAScript: https://262.ecma-international.org/5.1/#sec-15.9.1.1\n        }\n        parsedRange.endDate = endDate;\n    } else if (rangeType === RecurrenceRangeType.Numbered) {\n        let numberOfOccurrences = rawRange.NumberOfOccurrences;\n        if (numberOfOccurrences !== undefined) {\n            if (typeof numberOfOccurrences !== \"number\") {\n                throw new Error(buildInvalidParameterErrorMessage(NUMBER_OF_OCCURRENCES, UNRECOGNIZABLE_VALUE_ERROR_MESSAGE));\n            } else if (numberOfOccurrences <= 0 || !Number.isInteger(numberOfOccurrences)) {\n                throw new Error(buildInvalidParameterErrorMessage(NUMBER_OF_OCCURRENCES, VALUE_OUT_OF_RANGE_ERROR_MESSAGE));\n            }\n        } else {\n            numberOfOccurrences = Number.MAX_SAFE_INTEGER;\n        }\n        parsedRange.numberOfOccurrences = numberOfOccurrences;\n    }\n    return parsedRange;\n}\n\nfunction isDurationCompliantWithDaysOfWeek(duration: number, interval: number, daysOfWeek: DayOfWeek[], firstDayOfWeek: DayOfWeek): boolean {\n    if (daysOfWeek.length === 1) {\n        return true;\n    }\n    const sortedDaysOfWeek = sortDaysOfWeek(daysOfWeek, firstDayOfWeek);\n    let prev = sortedDaysOfWeek[0]; // the closest occurrence day to the first day of week\n    let minGap = DAYS_PER_WEEK * ONE_DAY_IN_MILLISECONDS;\n    for (let i = 1; i < sortedDaysOfWeek.length; i++) { // skip the first day\n        const gap = calculateWeeklyDayOffset(sortedDaysOfWeek[i], prev) * ONE_DAY_IN_MILLISECONDS;\n        minGap = gap < minGap ? gap : minGap;\n        prev = sortedDaysOfWeek[i];\n    }\n    // It may across weeks. Check the next week if the interval is one week.\n    if (interval == 1) {\n        const gap = calculateWeeklyDayOffset(sortedDaysOfWeek[0], prev) * ONE_DAY_IN_MILLISECONDS;\n        minGap = gap < minGap ? gap : minGap;\n    }\n    return minGap >= duration;\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/filter/{TargetingFilter.js → targetingFilter.js}

@@ -73,4 +73,4 @@ class TargetingFilter {
 }
 
 export { TargetingFilter };
-//# sourceMappingURL=TargetingFilter.js.map
+//# sourceMappingURL=targetingFilter.js.map

package/dist/esm/filter/{TargetingFilter.js.map → targetingFilter.js.map}

@@ -1 +1 @@
-{"version":3,"file":"TargetingFilter.js","sources":["../../../src/filter/TargetingFilter.ts"],"sourcesContent":["// 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"],"names":[],"mappings":"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"}
+{"version":3,"file":"targetingFilter.js","sources":["../../../src/filter/targetingFilter.ts"],"sourcesContent":["// 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"],"names":[],"mappings":"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"}

package/dist/esm/filter/timeWindowFilter.js

@@ -0,0 +1,47 @@
+import { parseRecurrenceParameter } from './recurrence/validator.js';
+import { matchRecurrence } from './recurrence/evaluator.js';
+import { buildInvalidParameterErrorMessage, UNRECOGNIZABLE_VALUE_ERROR_MESSAGE } from './utils.js';
+
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+class TimeWindowFilter {
+    name = "Microsoft.TimeWindow";
+    evaluate(context) {
+        const { featureName, parameters } = context;
+        const startTime = parameters.Start !== undefined ? new Date(parameters.Start) : undefined;
+        const endTime = parameters.End !== undefined ? new Date(parameters.End) : undefined;
+        const baseErrorMessage = `The ${this.name} feature filter is not valid for feature ${featureName}. `;
+        if (startTime === undefined && endTime === undefined) {
+            // If neither start nor end time is specified, then the filter is not applicable.
+            console.warn(baseErrorMessage + "It must specify either 'Start', 'End', or both.");
+            return false;
+        }
+        if (startTime !== undefined && isNaN(startTime.getTime())) {
+            console.warn(baseErrorMessage + buildInvalidParameterErrorMessage("Start", UNRECOGNIZABLE_VALUE_ERROR_MESSAGE));
+            return false;
+        }
+        if (endTime !== undefined && isNaN(endTime.getTime())) {
+            console.warn(baseErrorMessage + buildInvalidParameterErrorMessage("End", UNRECOGNIZABLE_VALUE_ERROR_MESSAGE));
+            return false;
+        }
+        const now = new Date();
+        if ((startTime === undefined || startTime <= now) && (endTime === undefined || now < endTime)) {
+            return true;
+        }
+        if (parameters.Recurrence !== undefined) {
+            let recurrence;
+            try {
+                recurrence = parseRecurrenceParameter(startTime, endTime, parameters.Recurrence);
+            }
+            catch (error) {
+                console.warn(baseErrorMessage + error.message);
+                return false;
+            }
+            return matchRecurrence(now, recurrence);
+        }
+        return false;
+    }
+}
+
+export { TimeWindowFilter };
+//# sourceMappingURL=timeWindowFilter.js.map

package/dist/esm/filter/timeWindowFilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeWindowFilter.js","sources":["../../../src/filter/timeWindowFilter.ts"],"sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT license.\n\nimport { IFeatureFilter } from \"./featureFilter.js\";\nimport { RecurrenceSpec } from \"./recurrence/model.js\";\nimport { parseRecurrenceParameter } from \"./recurrence/validator.js\";\nimport { matchRecurrence } from \"./recurrence/evaluator.js\";\nimport { UNRECOGNIZABLE_VALUE_ERROR_MESSAGE, buildInvalidParameterErrorMessage } from \"./utils.js\";\n\ntype TimeWindowFilterEvaluationContext = {\n    featureName: string;\n    parameters: TimeWindowParameters;\n};\n\ntype TimeWindowParameters = {\n    Start?: string;\n    End?: string;\n    Recurrence?: RecurrenceParameters;\n};\n\nexport type RecurrenceParameters = {\n    Pattern: {\n        Type: string;\n        Interval?: number;\n        DaysOfWeek?: string[];\n        FirstDayOfWeek?: string;\n    },\n    Range: {\n        Type: string;\n        EndDate?: string;\n        NumberOfOccurrences?: number;\n    }\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        const baseErrorMessage = `The ${this.name} feature filter is not valid for feature ${featureName}. `;\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(baseErrorMessage + \"It must specify either 'Start', 'End', or both.\");\n            return false;\n        }\n\n        if (startTime !== undefined && isNaN(startTime.getTime())) {\n            console.warn(baseErrorMessage + buildInvalidParameterErrorMessage(\"Start\", UNRECOGNIZABLE_VALUE_ERROR_MESSAGE));\n            return false;\n        }\n\n        if (endTime !== undefined && isNaN(endTime.getTime())) {\n            console.warn(baseErrorMessage + buildInvalidParameterErrorMessage(\"End\", UNRECOGNIZABLE_VALUE_ERROR_MESSAGE));\n            return false;\n        }\n\n        const now = new Date();\n\n        if ((startTime === undefined || startTime <= now) && (endTime === undefined || now < endTime)) {\n            return true;\n        }\n\n        if (parameters.Recurrence !== undefined) {\n            let recurrence: RecurrenceSpec;\n            try {\n                recurrence = parseRecurrenceParameter(startTime, endTime, parameters.Recurrence);\n            } catch (error) {\n                console.warn(baseErrorMessage + error.message);\n                return false;\n            }\n            return matchRecurrence(now, recurrence);\n        }\n\n        return false;\n    }\n}\n"],"names":[],"mappings":";;;;AAAA;AACA;MAiCa,gBAAgB,CAAA;IAChB,IAAI,GAAW,sBAAsB;AAE9C,IAAA,QAAQ,CAAC,OAA0C,EAAA;AAC/C,QAAA,MAAM,EAAC,WAAW,EAAE,UAAU,EAAC,GAAG,OAAO;QACzC,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,KAAK,SAAS,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,SAAS;QACzF,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,KAAK,SAAS,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,SAAS;QAEnF,MAAM,gBAAgB,GAAG,CAAA,IAAA,EAAO,IAAI,CAAC,IAAI,CAAA,yCAAA,EAA4C,WAAW,CAAA,EAAA,CAAI;QAEpG,IAAI,SAAS,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS,EAAE;;AAElD,YAAA,OAAO,CAAC,IAAI,CAAC,gBAAgB,GAAG,iDAAiD,CAAC;AAClF,YAAA,OAAO,KAAK;QAChB;AAEA,QAAA,IAAI,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,EAAE;AACvD,YAAA,OAAO,CAAC,IAAI,CAAC,gBAAgB,GAAG,iCAAiC,CAAC,OAAO,EAAE,kCAAkC,CAAC,CAAC;AAC/G,YAAA,OAAO,KAAK;QAChB;AAEA,QAAA,IAAI,OAAO,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,EAAE;AACnD,YAAA,OAAO,CAAC,IAAI,CAAC,gBAAgB,GAAG,iCAAiC,CAAC,KAAK,EAAE,kCAAkC,CAAC,CAAC;AAC7G,YAAA,OAAO,KAAK;QAChB;AAEA,QAAA,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE;QAEtB,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,SAAS,IAAI,GAAG,MAAM,OAAO,KAAK,SAAS,IAAI,GAAG,GAAG,OAAO,CAAC,EAAE;AAC3F,YAAA,OAAO,IAAI;QACf;AAEA,QAAA,IAAI,UAAU,CAAC,UAAU,KAAK,SAAS,EAAE;AACrC,YAAA,IAAI,UAA0B;AAC9B,YAAA,IAAI;gBACA,UAAU,GAAG,wBAAwB,CAAC,SAAS,EAAE,OAAO,EAAE,UAAU,CAAC,UAAU,CAAC;YACpF;YAAE,OAAO,KAAK,EAAE;gBACZ,OAAO,CAAC,IAAI,CAAC,gBAAgB,GAAG,KAAK,CAAC,OAAO,CAAC;AAC9C,gBAAA,OAAO,KAAK;YAChB;AACA,YAAA,OAAO,eAAe,CAAC,GAAG,EAAE,UAAU,CAAC;QAC3C;AAEA,QAAA,OAAO,KAAK;IAChB;AACH;;;;"}

package/dist/esm/filter/utils.js

@@ -0,0 +1,11 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+const VALUE_OUT_OF_RANGE_ERROR_MESSAGE = "The value is out of the accepted range.";
+const UNRECOGNIZABLE_VALUE_ERROR_MESSAGE = "The value is unrecognizable.";
+const REQUIRED_PARAMETER_MISSING_ERROR_MESSAGE = "Value cannot be undefined or empty.";
+function buildInvalidParameterErrorMessage(parameterName, additionalInfo) {
+    return `The ${parameterName} parameter is not valid. ` + (additionalInfo ?? "");
+}
+
+export { REQUIRED_PARAMETER_MISSING_ERROR_MESSAGE, UNRECOGNIZABLE_VALUE_ERROR_MESSAGE, VALUE_OUT_OF_RANGE_ERROR_MESSAGE, buildInvalidParameterErrorMessage };
+//# sourceMappingURL=utils.js.map

package/dist/esm/filter/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sources":["../../../src/filter/utils.ts"],"sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT license.\n\nexport const VALUE_OUT_OF_RANGE_ERROR_MESSAGE = \"The value is out of the accepted range.\";\nexport const UNRECOGNIZABLE_VALUE_ERROR_MESSAGE = \"The value is unrecognizable.\";\nexport const REQUIRED_PARAMETER_MISSING_ERROR_MESSAGE = \"Value cannot be undefined or empty.\";\n\nexport function buildInvalidParameterErrorMessage(parameterName: string, additionalInfo?: string): string {\n    return `The ${parameterName} parameter is not valid. ` + (additionalInfo ?? \"\");\n}\n"],"names":[],"mappings":"AAAA;AACA;AAEO,MAAM,gCAAgC,GAAG;AACzC,MAAM,kCAAkC,GAAG;AAC3C,MAAM,wCAAwC,GAAG;AAElD,SAAU,iCAAiC,CAAC,aAAqB,EAAE,cAAuB,EAAA;IAC5F,OAAO,CAAA,IAAA,EAAO,aAAa,CAAA,yBAAA,CAA2B,IAAI,cAAc,IAAI,EAAE,CAAC;AACnF;;;;"}

package/dist/esm/schema/model.js.map

@@ -1 +1 @@
-{"version":3,"file":"model.js","sources":["../../../src/schema/model.ts"],"sourcesContent":["// 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"],"names":[],"mappings":"AAAA;AACA;AA8JE;AACA;AAEO,MAAM,sBAAsB,GAAG,qBAAqB;AACpD,MAAM,iBAAiB,GAAG;;;;"}
+{"version":3,"file":"model.js","sources":["../../../src/schema/model.ts"],"sourcesContent":["// 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"],"names":[],"mappings":"AAAA;AACA;AA8JE;AACA;AAEO,MAAM,sBAAsB,GAAG;AAC/B,MAAM,iBAAiB,GAAG;;;;"}

package/dist/esm/schema/validator.js.map

@@ -1 +1 @@
-{"version":3,"file":"validator.js","sources":["../../../src/schema/validator.ts"],"sourcesContent":["// 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"],"names":[],"mappings":"AAAA;AACA;AAEA;;;AAGG;AACG,SAAU,mBAAmB,CAAC,WAAgB,EAAA;AAChD,IAAA,IAAI,WAAW,KAAK,SAAS,EAAE;AAC3B,QAAA,OAAO;KACV;IACD,IAAI,WAAW,KAAK,IAAI,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE;AACzD,QAAA,MAAM,IAAI,SAAS,CAAC,iCAAiC,CAAC,CAAC;KAC1D;AACD,IAAA,IAAI,OAAO,WAAW,CAAC,EAAE,KAAK,QAAQ,EAAE;AACpC,QAAA,MAAM,IAAI,SAAS,CAAC,qCAAqC,CAAC,CAAC;KAC9D;AAED,IAAA,IAAI,WAAW,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,WAAW,CAAC,OAAO,KAAK,SAAS,EAAE;QAC/E,MAAM,IAAI,SAAS,CAAC,CAAA,sBAAA,EAAyB,WAAW,CAAC,EAAE,CAA6C,2CAAA,CAAA,CAAC,CAAC;KAC7G;AACD,IAAA,IAAI,WAAW,CAAC,UAAU,KAAK,SAAS,EAAE;QACtC,mCAAmC,CAAC,WAAW,CAAC,EAAE,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;KAC/E;AACD,IAAA,IAAI,WAAW,CAAC,QAAQ,KAAK,SAAS,EAAE;QACpC,gBAAgB,CAAC,WAAW,CAAC,EAAE,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;KAC1D;AACD,IAAA,IAAI,WAAW,CAAC,UAAU,KAAK,SAAS,EAAE;QACtC,yBAAyB,CAAC,WAAW,CAAC,EAAE,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;KACrE;AACD,IAAA,IAAI,WAAW,CAAC,SAAS,KAAK,SAAS,EAAE;QACrC,wBAAwB,CAAC,WAAW,CAAC,EAAE,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;KACnE;AACL,CAAC;AAED,SAAS,mCAAmC,CAAC,EAAU,EAAE,UAAe,EAAA;AACpE,IAAA,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE;AAChC,QAAA,MAAM,IAAI,SAAS,CAAC,yBAAyB,EAAE,CAAA,8CAAA,CAAgD,CAAC,CAAC;KACpG;AACD,IAAA,IAAI,UAAU,CAAC,gBAAgB,KAAK,SAAS,IAAI,UAAU,CAAC,gBAAgB,KAAK,KAAK,IAAI,UAAU,CAAC,gBAAgB,KAAK,KAAK,EAAE;AAC7H,QAAA,MAAM,IAAI,SAAS,CAAC,yBAAyB,EAAE,CAAA,4CAAA,CAA8C,CAAC,CAAC;KAClG;AACD,IAAA,IAAI,UAAU,CAAC,cAAc,KAAK,SAAS,EAAE;AACzC,QAAA,qBAAqB,CAAC,EAAE,EAAE,UAAU,CAAC,cAAc,CAAC,CAAC;KACxD;AACL,CAAC;AAED,SAAS,qBAAqB,CAAC,EAAU,EAAE,cAAmB,EAAA;IAC1D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE;AAChC,QAAA,MAAM,IAAI,SAAS,CAAC,yBAAyB,EAAE,CAAA,4DAAA,CAA8D,CAAC,CAAC;KAClH;AAED,IAAA,KAAK,MAAM,MAAM,IAAI,cAAc,EAAE;AACjC,QAAA,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE;AACjC,YAAA,MAAM,IAAI,SAAS,CAAC,yBAAyB,EAAE,CAAA,wCAAA,CAA0C,CAAC,CAAC;SAC9F;AACD,QAAA,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,EAAE;AAC1E,YAAA,MAAM,IAAI,SAAS,CAAC,yBAAyB,EAAE,CAAA,+CAAA,CAAiD,CAAC,CAAC;SACrG;KACJ;AACL,CAAC;AAED,SAAS,gBAAgB,CAAC,EAAU,EAAE,QAAa,EAAA;IAC/C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;AAC1B,QAAA,MAAM,IAAI,SAAS,CAAC,yBAAyB,EAAE,CAAA,2CAAA,CAA6C,CAAC,CAAC;KACjG;AAED,IAAA,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE;AAC5B,QAAA,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE;AAClC,YAAA,MAAM,IAAI,SAAS,CAAC,yBAAyB,EAAE,CAAA,kCAAA,CAAoC,CAAC,CAAC;SACxF;;AAED,QAAA,IAAI,OAAO,CAAC,eAAe,KAAK,SAAS,IAAI,OAAO,OAAO,CAAC,eAAe,KAAK,QAAQ,EAAE;AACtF,YAAA,MAAM,IAAI,SAAS,CAAC,yBAAyB,EAAE,CAAA,6CAAA,CAA+C,CAAC,CAAC;SACnG;QACD,IAAI,OAAO,CAAC,eAAe,KAAK,SAAS,IAAI,OAAO,CAAC,eAAe,KAAK,MAAM,IAAI,OAAO,CAAC,eAAe,KAAK,SAAS,IAAI,OAAO,CAAC,eAAe,KAAK,UAAU,EAAE;AAChK,YAAA,MAAM,IAAI,SAAS,CAAC,yBAAyB,EAAE,CAAA,qEAAA,CAAuE,CAAC,CAAC;SAC3H;KACJ;AACL,CAAC;AAED,SAAS,yBAAyB,CAAC,EAAU,EAAE,UAAe,EAAA;AAC1D,IAAA,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE;AAChC,QAAA,MAAM,IAAI,SAAS,CAAC,yBAAyB,EAAE,CAAA,yCAAA,CAA2C,CAAC,CAAC;KAC/F;AAED,IAAA,IAAI,UAAU,CAAC,qBAAqB,KAAK,SAAS,IAAI,OAAO,UAAU,CAAC,qBAAqB,KAAK,QAAQ,EAAE;AACxG,QAAA,MAAM,IAAI,SAAS,CAAC,yBAAyB,EAAE,CAAA,8DAAA,CAAgE,CAAC,CAAC;KACpH;AACD,IAAA,IAAI,UAAU,CAAC,oBAAoB,KAAK,SAAS,IAAI,OAAO,UAAU,CAAC,oBAAoB,KAAK,QAAQ,EAAE;AACtG,QAAA,MAAM,IAAI,SAAS,CAAC,yBAAyB,EAAE,CAAA,6DAAA,CAA+D,CAAC,CAAC;KACnH;AACD,IAAA,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS,EAAE;AAC/B,QAAA,6BAA6B,CAAC,EAAE,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;KACtD;AACD,IAAA,IAAI,UAAU,CAAC,KAAK,KAAK,SAAS,EAAE;AAChC,QAAA,8BAA8B,CAAC,EAAE,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;KACxD;AACD,IAAA,IAAI,UAAU,CAAC,UAAU,KAAK,SAAS,EAAE;AACrC,QAAA,mCAAmC,CAAC,EAAE,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;KAClE;AACD,IAAA,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,UAAU,CAAC,IAAI,KAAK,QAAQ,EAAE;AACtE,QAAA,MAAM,IAAI,SAAS,CAAC,yBAAyB,EAAE,CAAA,6CAAA,CAA+C,CAAC,CAAC;KACnG;AACL,CAAC;AAED,SAAS,6BAA6B,CAAC,EAAU,EAAE,eAAoB,EAAA;IACnE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE;AACjC,QAAA,MAAM,IAAI,SAAS,CAAC,yBAAyB,EAAE,CAAA,6CAAA,CAA+C,CAAC,CAAC;KACnG;AAED,IAAA,KAAK,MAAM,UAAU,IAAI,eAAe,EAAE;AACtC,QAAA,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE;AAChC,YAAA,MAAM,IAAI,SAAS,CAAC,yBAAyB,EAAE,CAAA,0DAAA,CAA4D,CAAC,CAAC;SAChH;AACD,QAAA,IAAI,OAAO,UAAU,CAAC,OAAO,KAAK,QAAQ,EAAE;AACxC,YAAA,MAAM,IAAI,SAAS,CAAC,yBAAyB,EAAE,CAAA,6CAAA,CAA+C,CAAC,CAAC;SACnG;QACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE;AAClC,YAAA,MAAM,IAAI,SAAS,CAAC,yBAAyB,EAAE,CAAA,2CAAA,CAA6C,CAAC,CAAC;SACjG;AACD,QAAA,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,KAAK,EAAE;AACjC,YAAA,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE;AAC1B,gBAAA,MAAM,IAAI,SAAS,CAAC,yBAAyB,EAAE,CAAA,sDAAA,CAAwD,CAAC,CAAC;aAC5G;SACJ;KACJ;AACL,CAAC;AAED,SAAS,8BAA8B,CAAC,EAAU,EAAE,gBAAqB,EAAA;IACrE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE;AAClC,QAAA,MAAM,IAAI,SAAS,CAAC,yBAAyB,EAAE,CAAA,8CAAA,CAAgD,CAAC,CAAC;KACpG;AAED,IAAA,KAAK,MAAM,UAAU,IAAI,gBAAgB,EAAE;AACvC,QAAA,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE;AAChC,YAAA,MAAM,IAAI,SAAS,CAAC,yBAAyB,EAAE,CAAA,2DAAA,CAA6D,CAAC,CAAC;SACjH;AACD,QAAA,IAAI,OAAO,UAAU,CAAC,OAAO,KAAK,QAAQ,EAAE;AACxC,YAAA,MAAM,IAAI,SAAS,CAAC,yBAAyB,EAAE,CAAA,8CAAA,CAAgD,CAAC,CAAC;SACpG;QACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE;AACnC,YAAA,MAAM,IAAI,SAAS,CAAC,yBAAyB,EAAE,CAAA,6CAAA,CAA+C,CAAC,CAAC;SACnG;AACD,QAAA,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,MAAM,EAAE;AACnC,YAAA,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;AAC3B,gBAAA,MAAM,IAAI,SAAS,CAAC,yBAAyB,EAAE,CAAA,wDAAA,CAA0D,CAAC,CAAC;aAC9G;SACJ;KACJ;AACL,CAAC;AAED,SAAS,mCAAmC,CAAC,EAAU,EAAE,qBAA0B,EAAA;IAC/E,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,qBAAqB,CAAC,EAAE;AACvC,QAAA,MAAM,IAAI,SAAS,CAAC,yBAAyB,EAAE,CAAA,mDAAA,CAAqD,CAAC,CAAC;KACzG;AAED,IAAA,KAAK,MAAM,UAAU,IAAI,qBAAqB,EAAE;AAC5C,QAAA,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE;AAChC,YAAA,MAAM,IAAI,SAAS,CAAC,yBAAyB,EAAE,CAAA,gEAAA,CAAkE,CAAC,CAAC;SACtH;AACD,QAAA,IAAI,OAAO,UAAU,CAAC,OAAO,KAAK,QAAQ,EAAE;AACxC,YAAA,MAAM,IAAI,SAAS,CAAC,yBAAyB,EAAE,CAAA,mDAAA,CAAqD,CAAC,CAAC;SACzG;AACD,QAAA,IAAI,OAAO,UAAU,CAAC,IAAI,KAAK,QAAQ,IAAI,UAAU,CAAC,IAAI,GAAG,CAAC,IAAI,UAAU,CAAC,IAAI,GAAG,GAAG,EAAE;AACrF,YAAA,MAAM,IAAI,SAAS,CAAC,yBAAyB,EAAE,CAAA,kEAAA,CAAoE,CAAC,CAAC;SACxH;AACD,QAAA,IAAI,OAAO,UAAU,CAAC,EAAE,KAAK,QAAQ,IAAI,UAAU,CAAC,EAAE,GAAG,CAAC,IAAI,UAAU,CAAC,EAAE,GAAG,GAAG,EAAE;AAC/E,YAAA,MAAM,IAAI,SAAS,CAAC,yBAAyB,EAAE,CAAA,gEAAA,CAAkE,CAAC,CAAC;SACtH;KACJ;AACL,CAAC;AACD;AAEA;AACA,SAAS,wBAAwB,CAAC,EAAU,EAAE,SAAc,EAAA;AACxD,IAAA,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE;AAC/B,QAAA,MAAM,IAAI,SAAS,CAAC,yBAAyB,EAAE,CAAA,6CAAA,CAA+C,CAAC,CAAC;KACnG;AACD,IAAA,IAAI,SAAS,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,SAAS,CAAC,OAAO,KAAK,SAAS,EAAE;AAC3E,QAAA,MAAM,IAAI,SAAS,CAAC,yBAAyB,EAAE,CAAA,wCAAA,CAA0C,CAAC,CAAC;KAC9F;AACD,IAAA,IAAI,SAAS,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,SAAS,CAAC,QAAQ,KAAK,QAAQ,EAAE;AAC5E,QAAA,MAAM,IAAI,SAAS,CAAC,yBAAyB,EAAE,CAAA,yCAAA,CAA2C,CAAC,CAAC;KAC/F;AACL,CAAC;AACD;;;;"}
+{"version":3,"file":"validator.js","sources":["../../../src/schema/validator.ts"],"sourcesContent":["// 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"],"names":[],"mappings":"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"}

package/dist/esm/telemetry/featureEvaluationEvent.js.map

@@ -1 +1 @@
-{"version":3,"file":"featureEvaluationEvent.js","sources":["../../../src/telemetry/featureEvaluationEvent.ts"],"sourcesContent":["// 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":[],"mappings":"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"}
+{"version":3,"file":"featureEvaluationEvent.js","sources":["../../../src/telemetry/featureEvaluationEvent.ts"],"sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT license.\n\nimport { EvaluationResult, VariantAssignmentReason } from \"../featureManager.js\";\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":[],"mappings":"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"}

package/dist/esm/variant/{Variant.js → variant.js}

@@ -10,4 +10,4 @@ class Variant {
 }
 
 export { Variant };
-//# sourceMappingURL=Variant.js.map
+//# sourceMappingURL=variant.js.map

package/dist/esm/variant/variant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"variant.js","sources":["../../../src/variant/variant.ts"],"sourcesContent":["// 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"],"names":[],"mappings":"AAAA;AACA;MAEa,OAAO,CAAA;AAEL,IAAA,IAAA;AACA,IAAA,aAAA;IAFX,WAAA,CACW,IAAY,EACZ,aAAsB,EAAA;QADtB,IAAA,CAAA,IAAI,GAAJ,IAAI;QACJ,IAAA,CAAA,aAAa,GAAb,aAAa;IACrB;AACN;;;;"}

package/dist/esm/version.js

@@ -1,6 +1,6 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT license.
-const VERSION = "2.1.0";
+const VERSION = "2.3.0";
 const EVALUATION_EVENT_VERSION = "1.0.0";
 
 export { EVALUATION_EVENT_VERSION, VERSION };

package/dist/esm/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sources":["../../src/version.ts"],"sourcesContent":["// 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"],"names":[],"mappings":"AAAA;AACA;AAEO,MAAM,OAAO,GAAG,QAAQ;AACxB,MAAM,wBAAwB,GAAG;;;;"}
+{"version":3,"file":"version.js","sources":["../../src/version.ts"],"sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT license.\n\nexport const VERSION = \"2.3.0\";\nexport const EVALUATION_EVENT_VERSION = \"1.0.0\";\n"],"names":[],"mappings":"AAAA;AACA;AAEO,MAAM,OAAO,GAAG;AAChB,MAAM,wBAAwB,GAAG;;;;"}

package/{types → dist/types}/index.d.ts

@@ -151,46 +151,6 @@ interface TelemetryOptions {
     metadata?: Record<string, string>;
 }
 
-interface IGettable {
-    get<T>(key: string): T | undefined;
-}
-
-interface IFeatureFlagProvider {
-    /**
-     * Get all feature flags.
-     */
-    getFeatureFlags(): Promise<FeatureFlag[]>;
-    /**
-     * Get a feature flag by name.
-     * @param featureName The name of the feature flag.
-     */
-    getFeatureFlag(featureName: string): Promise<FeatureFlag | undefined>;
-}
-/**
- * A feature flag provider that uses a map-like configuration to provide feature flags.
- */
-declare class ConfigurationMapFeatureFlagProvider implements IFeatureFlagProvider {
-    #private;
-    constructor(configuration: IGettable);
-    getFeatureFlag(featureName: string): Promise<FeatureFlag | undefined>;
-    getFeatureFlags(): Promise<FeatureFlag[]>;
-}
-/**
- * A feature flag provider that uses an object-like configuration to provide feature flags.
- */
-declare class ConfigurationObjectFeatureFlagProvider implements IFeatureFlagProvider {
-    #private;
-    constructor(configuration: Record<string, unknown>);
-    getFeatureFlag(featureName: string): Promise<FeatureFlag | undefined>;
-    getFeatureFlags(): Promise<FeatureFlag[]>;
-}
-
-declare class Variant {
-    name: string;
-    configuration: unknown;
-    constructor(name: string, configuration: unknown);
-}
-
 /**
  * Contextual information that is required to perform a targeting evaluation.
  */
@@ -214,6 +174,12 @@ interface ITargetingContextAccessor {
     getTargetingContext: () => ITargetingContext | undefined;
 }
 
+declare class Variant {
+    name: string;
+    configuration: unknown;
+    constructor(name: string, configuration: unknown);
+}
+
 interface IFeatureManager {
     /**
      * Get the list of feature names.
@@ -232,6 +198,17 @@ interface IFeatureManager {
      */
     getVariant(featureName: string, context: ITargetingContext): Promise<Variant | undefined>;
 }
+interface IFeatureFlagProvider {
+    /**
+     * Get all feature flags.
+     */
+    getFeatureFlags(): Promise<FeatureFlag[]>;
+    /**
+     * Get a feature flag by name.
+     * @param featureName The name of the feature flag.
+     */
+    getFeatureFlag(featureName: string): Promise<FeatureFlag | undefined>;
+}
 
 declare class FeatureManager implements IFeatureManager {
     #private;
@@ -290,8 +267,32 @@ declare enum VariantAssignmentReason {
     Percentile = "Percentile"
 }
 
+interface IGettable {
+    get<T>(key: string): T | undefined;
+}
+
+/**
+ * A feature flag provider that uses a map-like configuration to provide feature flags.
+ */
+declare class ConfigurationMapFeatureFlagProvider implements IFeatureFlagProvider {
+    #private;
+    constructor(configuration: IGettable);
+    getFeatureFlag(featureName: string): Promise<FeatureFlag | undefined>;
+    getFeatureFlags(): Promise<FeatureFlag[]>;
+}
+/**
+ * A feature flag provider that uses an object-like configuration to provide feature flags.
+ */
+declare class ConfigurationObjectFeatureFlagProvider implements IFeatureFlagProvider {
+    #private;
+    constructor(configuration: Record<string, unknown>);
+    getFeatureFlag(featureName: string): Promise<FeatureFlag | undefined>;
+    getFeatureFlags(): Promise<FeatureFlag[]>;
+}
+
 declare function createFeatureEvaluationEventProperties(result: EvaluationResult): any;
 
-declare const VERSION = "2.1.0";
+declare const VERSION = "2.3.0";
 
-export { ConfigurationMapFeatureFlagProvider, ConfigurationObjectFeatureFlagProvider, EvaluationResult, FeatureManager, type FeatureManagerOptions, type IFeatureFilter, type IFeatureFlagProvider, type ITargetingContext, type ITargetingContextAccessor, VERSION, VariantAssignmentReason, createFeatureEvaluationEventProperties };
+export { ConfigurationMapFeatureFlagProvider, ConfigurationObjectFeatureFlagProvider, EvaluationResult, FeatureManager, VERSION, VariantAssignmentReason, createFeatureEvaluationEventProperties };
+export type { FeatureManagerOptions, IFeatureFilter, IFeatureFilterEvaluationContext, IFeatureFlagProvider, IFeatureManager, ITargetingContext, ITargetingContextAccessor };