@datadog/openfeature-node-server 0.1.0-preview.3

package/cjs/shards/sharders.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeterministicSharder = exports.MD5Sharder = exports.Sharder = void 0;
+const obfuscation_1 = require("./obfuscation");
+class Sharder {
+}
+exports.Sharder = Sharder;
+class MD5Sharder extends Sharder {
+    getShard(input, totalShards) {
+        const hashOutput = (0, obfuscation_1.getMD5Hash)(input);
+        // get the first 4 bytes of the md5 hex string and parse it using base 16
+        // (8 hex characters represent 4 bytes, e.g. 0xffffffff represents the max 4-byte integer)
+        const intFromHash = parseInt(hashOutput.slice(0, 8), 16);
+        return intFromHash % totalShards;
+    }
+}
+exports.MD5Sharder = MD5Sharder;
+class DeterministicSharder extends Sharder {
+    constructor(lookup) {
+        super();
+        this.lookup = lookup;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    getShard(input, _totalShards) {
+        var _a;
+        return (_a = this.lookup[input]) !== null && _a !== void 0 ? _a : 0;
+    }
+}
+exports.DeterministicSharder = DeterministicSharder;
+//# sourceMappingURL=sharders.js.map

package/cjs/shards/sharders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sharders.js","sourceRoot":"","sources":["../../src/shards/sharders.ts"],"names":[],"mappings":";;;AAAA,+CAA0C;AAE1C,MAAsB,OAAO;CAE5B;AAFD,0BAEC;AAED,MAAa,UAAW,SAAQ,OAAO;IACrC,QAAQ,CAAC,KAAa,EAAE,WAAmB;QACzC,MAAM,UAAU,GAAG,IAAA,wBAAU,EAAC,KAAK,CAAC,CAAA;QACpC,yEAAyE;QACzE,0FAA0F;QAC1F,MAAM,WAAW,GAAG,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QACxD,OAAO,WAAW,GAAG,WAAW,CAAA;IAClC,CAAC;CACF;AARD,gCAQC;AAED,MAAa,oBAAqB,SAAQ,OAAO;IAO/C,YAAY,MAA8B;QACxC,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;IAED,6DAA6D;IAC7D,QAAQ,CAAC,KAAa,EAAE,YAAoB;;QAC1C,OAAO,MAAA,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAI,CAAC,CAAA;IAChC,CAAC;CACF;AAhBD,oDAgBC"}

package/esm/configuration/evaluateForSubject.d.ts

@@ -0,0 +1,7 @@
+import { Rule } from '../rules/rules';
+import { Flag } from './ufc-v1';
+import { EvaluationContext, FlagValueType, Logger, ResolutionDetails } from '@openfeature/server-sdk';
+import { FlagTypeToValue } from '@datadog/flagging-core';
+export declare function evaluateForSubject<T extends FlagValueType>(flag: Flag | undefined, type: T, subjectKey: string, subjectAttributes: EvaluationContext, defaultValue: FlagTypeToValue<T>, logger: Logger): ResolutionDetails<FlagTypeToValue<T>>;
+export declare function containsMatchingRule(rules: Rule[] | undefined, subjectAttributes: EvaluationContext, logger: Logger): boolean;
+//# sourceMappingURL=evaluateForSubject.d.ts.map

package/esm/configuration/evaluateForSubject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluateForSubject.d.ts","sourceRoot":"","sources":["../../src/configuration/evaluateForSubject.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,IAAI,EAAE,MAAM,gBAAgB,CAAA;AAElD,OAAO,EAAE,IAAI,EAAsB,MAAM,UAAU,CAAA;AACnD,OAAO,EAAa,iBAAiB,EAAa,aAAa,EAAE,MAAM,EAAE,iBAAiB,EAA6B,MAAM,yBAAyB,CAAA;AACtJ,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAExD,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,aAAa,EACxD,IAAI,EAAE,IAAI,GAAG,SAAS,EACtB,IAAI,EAAE,CAAC,EACP,UAAU,EAAE,MAAM,EAClB,iBAAiB,EAAE,iBAAiB,EACpC,YAAY,EAAE,eAAe,CAAC,CAAC,CAAC,EAChC,MAAM,EAAE,MAAM,GACb,iBAAiB,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAuFvC;AAqBD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,IAAI,EAAE,GAAG,SAAS,EACzB,iBAAiB,EAAE,iBAAiB,EACpC,MAAM,EAAE,MAAM,GACb,OAAO,CAST"}

package/esm/configuration/evaluateForSubject.js

@@ -0,0 +1,147 @@
+import { matchesRule } from '../rules/rules';
+import { matchesShard } from '../shards/matchesShard';
+import { ErrorCode, StandardResolutionReasons } from '@openfeature/server-sdk';
+export function evaluateForSubject(flag, type, subjectKey, subjectAttributes, defaultValue, logger) {
+    if (!(flag === null || flag === void 0 ? void 0 : flag.enabled)) {
+        logger.debug(`returning default assignment because flag is disabled`, {
+            flagKey: flag ? flag.key : 'undefined',
+            subjectKey,
+        });
+        return {
+            value: defaultValue,
+            reason: StandardResolutionReasons.DISABLED,
+        };
+    }
+    const isValid = validateTypeMatch(type, flag.variationType);
+    if (!isValid) {
+        logger.debug(`variant value type mismatch, returning default value`, {
+            flagKey: flag.key,
+            subjectKey,
+            expectedType: type,
+            variantType: flag.variationType,
+        });
+        return {
+            value: defaultValue,
+            reason: StandardResolutionReasons.ERROR,
+            errorCode: ErrorCode.TYPE_MISMATCH,
+        };
+    }
+    const now = new Date();
+    for (const allocation of flag.allocations) {
+        if (allocation.startAt && now < new Date(allocation.startAt)) {
+            logger.debug(`allocation before start date`, {
+                flagKey: flag.key,
+                subjectKey,
+                allocationKey: allocation.key,
+                startAt: allocation.startAt,
+            });
+            continue;
+        }
+        if (allocation.endAt && now >= new Date(allocation.endAt)) {
+            logger.debug(`allocation after end date`, {
+                flagKey: flag.key,
+                subjectKey,
+                allocationKey: allocation.key,
+                endAt: allocation.endAt,
+            });
+            continue;
+        }
+        const matched = containsMatchingRule(allocation.rules, subjectAttributes, logger);
+        if (!matched) {
+            continue;
+        }
+        const selectedSplit = selectSplitUsingSharding(allocation.splits, subjectKey, flag.key, logger);
+        if (selectedSplit) {
+            const variation = flag.variations[selectedSplit.variationKey];
+            if (variation) {
+                logger.debug(`evaluated a flag`, {
+                    flagKey: flag.key,
+                    subjectKey,
+                    assignment: variation.value,
+                });
+                return {
+                    value: variation.value,
+                    reason: StandardResolutionReasons.TARGETING_MATCH,
+                };
+            }
+        }
+        else {
+            logger.debug(`no matching split found for subject`, {
+                flagKey: flag.key,
+                subjectKey,
+                allocationKey: allocation.key,
+            });
+        }
+    }
+    logger.debug(`returning default assignment because no allocation matched`, {
+        flagKey: flag.key,
+        subjectKey,
+    });
+    return {
+        value: defaultValue,
+        reason: StandardResolutionReasons.DEFAULT,
+    };
+}
+function validateTypeMatch(expectedType, variantType) {
+    if (expectedType === 'boolean') {
+        return variantType === 'BOOLEAN';
+    }
+    if (expectedType === 'string') {
+        return variantType === 'STRING';
+    }
+    if (expectedType === 'number') {
+        return variantType === 'INTEGER' || variantType === 'NUMERIC';
+    }
+    if (expectedType === 'object') {
+        return variantType === 'JSON';
+    }
+    throw new Error(`Invalid expected type: ${expectedType}`);
+}
+export function containsMatchingRule(rules, subjectAttributes, logger) {
+    if (!(rules === null || rules === void 0 ? void 0 : rules.length)) {
+        return true;
+    }
+    logger.debug(`evaluating rules`, {
+        rules: JSON.stringify(rules),
+        subjectAttributes,
+    });
+    return rules.some((rule) => matchesRule(rule, subjectAttributes));
+}
+function selectSplitUsingSharding(splits, subjectKey, flagKey, logger) {
+    if (!splits || splits.length === 0) {
+        return null;
+    }
+    for (const split of splits) {
+        logger.debug(`evaluating split sharding`, {
+            flagKey,
+            subjectKey,
+            variationKey: split.variationKey,
+            shards: split.shards,
+        });
+        const matches = split.shards.every((shard) => {
+            const shardMatches = matchesShard(shard, subjectKey);
+            logger.debug(`shard match result`, {
+                flagKey,
+                subjectKey,
+                variationKey: split.variationKey,
+                shard: shard,
+                matches: shardMatches,
+            });
+            return shardMatches;
+        });
+        if (matches) {
+            logger.debug(`subject matches split`, {
+                flagKey,
+                subjectKey,
+                variationKey: split.variationKey,
+            });
+            return split;
+        }
+    }
+    logger.debug(`subject matches no splits`, {
+        flagKey,
+        subjectKey,
+    });
+    return null;
+}
+//# sourceMappingURL=evaluateForSubject.js.map

package/esm/configuration/evaluateForSubject.js.map

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

package/esm/configuration/evaluation.d.ts

@@ -0,0 +1,5 @@
+import type { FlagTypeToValue } from '@datadog/flagging-core';
+import { EvaluationContext, FlagValueType, Logger, ResolutionDetails } from '@openfeature/server-sdk';
+import { UniversalFlagConfigurationV1 } from './ufc-v1';
+export declare function evaluate<T extends FlagValueType>(config: UniversalFlagConfigurationV1, type: T, flagKey: string, defaultValue: FlagTypeToValue<T>, context: EvaluationContext, logger: Logger): ResolutionDetails<FlagTypeToValue<T>>;
+//# sourceMappingURL=evaluation.d.ts.map

package/esm/configuration/evaluation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluation.d.ts","sourceRoot":"","sources":["../../src/configuration/evaluation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EAEL,iBAAiB,EACjB,aAAa,EACb,MAAM,EACN,iBAAiB,EAElB,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,4BAA4B,EAAE,MAAM,UAAU,CAAA;AAGvD,wBAAgB,QAAQ,CAAC,CAAC,SAAS,aAAa,EAC9C,MAAM,EAAE,4BAA4B,EACpC,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,eAAe,CAAC,CAAC,CAAC,EAChC,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,MAAM,GACb,iBAAiB,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAiCvC"}

package/esm/configuration/evaluation.js

@@ -0,0 +1,30 @@
+import { ErrorCode, StandardResolutionReasons, } from '@openfeature/server-sdk';
+import { evaluateForSubject } from './evaluateForSubject';
+export function evaluate(config, type, flagKey, defaultValue, context, logger) {
+    const { targetingKey: subjectKey, ...remainingContext } = context;
+    if (!subjectKey) {
+        return {
+            value: defaultValue,
+            reason: 'ERROR',
+            errorCode: ErrorCode.TARGETING_KEY_MISSING,
+        };
+    }
+    // Include the subjectKey as an "id" attribute for rule matching
+    const subjectAttributes = {
+        id: subjectKey,
+        ...remainingContext,
+    };
+    try {
+        const resultWithDetails = evaluateForSubject(config.flags[flagKey], type, subjectKey, subjectAttributes, defaultValue, logger);
+        return resultWithDetails;
+    }
+    catch (error) {
+        logger.error('Error evaluating flag', { error });
+        return {
+            value: defaultValue,
+            reason: StandardResolutionReasons.ERROR,
+            errorCode: ErrorCode.GENERAL,
+        };
+    }
+}
+//# sourceMappingURL=evaluation.js.map

package/esm/configuration/evaluation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluation.js","sourceRoot":"","sources":["../../src/configuration/evaluation.ts"],"names":[],"mappings":"AACA,OAAO,EACL,SAAS,EAKT,yBAAyB,GAC1B,MAAM,yBAAyB,CAAA;AAEhC,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAEzD,MAAM,UAAU,QAAQ,CACtB,MAAoC,EACpC,IAAO,EACP,OAAe,EACf,YAAgC,EAChC,OAA0B,EAC1B,MAAc;IAEd,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,GAAG,OAAO,CAAA;IACjE,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO;YACL,KAAK,EAAE,YAAY;YACnB,MAAM,EAAE,OAAO;YACf,SAAS,EAAE,SAAS,CAAC,qBAAqB;SAC3C,CAAA;IACH,CAAC;IAED,gEAAgE;IAChE,MAAM,iBAAiB,GAAG;QACxB,EAAE,EAAE,UAAU;QACd,GAAG,gBAAgB;KACpB,CAAA;IACD,IAAI,CAAC;QACH,MAAM,iBAAiB,GAAG,kBAAkB,CAC1C,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EACrB,IAAI,EACJ,UAAU,EACV,iBAAiB,EACjB,YAAY,EACZ,MAAM,CACP,CAAA;QACD,OAAO,iBAAiB,CAAA;IAC1B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;QAChD,OAAO;YACL,KAAK,EAAE,YAAY;YACnB,MAAM,EAAE,yBAAyB,CAAC,KAAK;YACvC,SAAS,EAAE,SAAS,CAAC,OAAO;SAC7B,CAAA;IACH,CAAC;AACH,CAAC"}

package/esm/configuration/ufc-v1.d.ts

@@ -0,0 +1,52 @@
+import { FlagValue } from '@openfeature/core';
+import { Rule } from '../rules/rules';
+export type VariantType = 'BOOLEAN' | 'INTEGER' | 'NUMERIC' | 'STRING' | 'JSON';
+export interface VariantConfiguration {
+    key: string;
+    value: FlagValue;
+}
+export interface ShardRange {
+    start: number;
+    end: number;
+}
+export interface Shard {
+    salt: string;
+    ranges: ShardRange[];
+    totalShards: number;
+}
+export interface Split {
+    variationKey: string;
+    shards: Shard[];
+    extraLogging?: Record<string, string>;
+}
+export interface Allocation {
+    key: string;
+    rules?: Rule[];
+    startAt?: Date;
+    endAt?: Date;
+    splits: Split[];
+    doLog?: boolean;
+}
+export interface Flag {
+    key: string;
+    enabled: boolean;
+    variationType: VariantType;
+    variations: Record<string, VariantConfiguration>;
+    allocations: Allocation[];
+}
+export interface UniversalFlagConfigurationV1 {
+    createdAt: string;
+    format: string;
+    environment: {
+        name: string;
+    };
+    flags: Record<string, Flag>;
+}
+export interface UniversalFlagConfigurationV1Response {
+    data: {
+        type: 'universal-flag-configuration';
+        id: string;
+        attributes: UniversalFlagConfigurationV1;
+    };
+}
+//# sourceMappingURL=ufc-v1.d.ts.map

package/esm/configuration/ufc-v1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ufc-v1.d.ts","sourceRoot":"","sources":["../../src/configuration/ufc-v1.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAiB,MAAM,mBAAmB,CAAA;AAC5D,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAA;AAErC,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAA;AAE/E,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,SAAS,CAAA;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,UAAU,EAAE,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,KAAK;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,KAAK,EAAE,CAAA;IACf,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACtC;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,IAAI,EAAE,CAAA;IACd,OAAO,CAAC,EAAE,IAAI,CAAA;IACd,KAAK,CAAC,EAAE,IAAI,CAAA;IACZ,MAAM,EAAE,KAAK,EAAE,CAAA;IACf,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,IAAI;IACnB,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,OAAO,CAAA;IAChB,aAAa,EAAE,WAAW,CAAA;IAC1B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAA;IAChD,WAAW,EAAE,UAAU,EAAE,CAAA;CAC1B;AAED,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,CAAA;KACb,CAAA;IACD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;CAC5B;AAED,MAAM,WAAW,oCAAoC;IACnD,IAAI,EAAE;QACJ,IAAI,EAAE,8BAA8B,CAAA;QACpC,EAAE,EAAE,MAAM,CAAA;QACV,UAAU,EAAE,4BAA4B,CAAA;KACzC,CAAA;CACF"}

package/esm/configuration/ufc-v1.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ufc-v1.js.map

package/esm/configuration/ufc-v1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ufc-v1.js","sourceRoot":"","sources":["../../src/configuration/ufc-v1.ts"],"names":[],"mappings":""}

package/esm/index.d.ts

@@ -0,0 +1,2 @@
+declare const SDK_VERSION: string;
+//# sourceMappingURL=index.d.ts.map

package/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,QAAA,MAAM,WAAW,QAA6B,CAAA"}

package/esm/index.js

@@ -0,0 +1,4 @@
+"use strict";
+// Build environment placeholder for testing
+const SDK_VERSION = "dev";
+//# sourceMappingURL=index.js.map

package/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,4CAA4C;AAC5C,MAAM,WAAW,GAAG,0BAA0B,CAAA"}

package/esm/provider.d.ts

@@ -0,0 +1,25 @@
+import type { JsonValue, Logger, Provider, ProviderMetadata, ResolutionDetails, Paradigm, Hook } from '@openfeature/server-sdk';
+import { EvaluationContext } from '@openfeature/core';
+import { ProviderStatus } from '@openfeature/server-sdk';
+import { UniversalFlagConfigurationV1 } from './configuration/ufc-v1';
+export interface DatadogNodeServerProviderOptions {
+    /**
+     * Remote config agent
+     */
+    configuration: UniversalFlagConfigurationV1;
+}
+export declare class DatadogNodeServerProvider implements Provider {
+    readonly metadata: ProviderMetadata;
+    readonly runsOn: Paradigm;
+    hooks?: Hook[];
+    status: ProviderStatus;
+    private configuration;
+    constructor(options: DatadogNodeServerProviderOptions);
+    getConfiguration(): UniversalFlagConfigurationV1;
+    setConfiguration(configuration: UniversalFlagConfigurationV1): void;
+    resolveBooleanEvaluation(flagKey: string, defaultValue: boolean, context: EvaluationContext, _logger: Logger): Promise<ResolutionDetails<boolean>>;
+    resolveStringEvaluation(flagKey: string, defaultValue: string, context: EvaluationContext, _logger: Logger): Promise<ResolutionDetails<string>>;
+    resolveNumberEvaluation(flagKey: string, defaultValue: number, context: EvaluationContext, _logger: Logger): Promise<ResolutionDetails<number>>;
+    resolveObjectEvaluation<T extends JsonValue>(flagKey: string, defaultValue: T, context: EvaluationContext, _logger: Logger): Promise<ResolutionDetails<T>>;
+}
+//# sourceMappingURL=provider.d.ts.map

package/esm/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,MAAM,EACN,QAAQ,EACR,gBAAgB,EAChB,iBAAiB,EACjB,QAAQ,EACR,IAAI,EACL,MAAM,yBAAyB,CAAA;AAEhC,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAExD,OAAO,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAA;AAErE,MAAM,WAAW,gCAAgC;IAC/C;;OAEG;IACH,aAAa,EAAE,4BAA4B,CAAA;CAC5C;AAED,qBAAa,yBAA0B,YAAW,QAAQ;IACxD,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAElC;IACD,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAW;IACpC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAA;IAEd,MAAM,EAAE,cAAc,CAA2B;IACjD,OAAO,CAAC,aAAa,CAA8B;gBAEvC,OAAO,EAAE,gCAAgC;IAKrD,gBAAgB;IAIhB,gBAAgB,CAAC,aAAa,EAAE,4BAA4B;IAItD,wBAAwB,CAC5B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,OAAO,EACrB,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAIhC,uBAAuB,CAC3B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAI/B,uBAAuB,CAC3B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAI/B,uBAAuB,CAAC,CAAC,SAAS,SAAS,EAC/C,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,CAAC,EACf,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;CASjC"}

package/esm/provider.js

@@ -0,0 +1,38 @@
+import { ProviderStatus } from '@openfeature/server-sdk';
+import { evaluate } from './configuration/evaluation';
+export class DatadogNodeServerProvider {
+    constructor(options) {
+        this.metadata = {
+            name: 'datadog-node-server',
+        };
+        this.runsOn = 'server';
+        this.status = ProviderStatus.NOT_READY;
+        this.configuration = options.configuration;
+        this.status = ProviderStatus.READY;
+    }
+    getConfiguration() {
+        return this.configuration;
+    }
+    setConfiguration(configuration) {
+        this.configuration = configuration;
+    }
+    async resolveBooleanEvaluation(flagKey, defaultValue, context, _logger) {
+        return evaluate(this.configuration, 'boolean', flagKey, defaultValue, context, _logger);
+    }
+    async resolveStringEvaluation(flagKey, defaultValue, context, _logger) {
+        return evaluate(this.configuration, 'string', flagKey, defaultValue, context, _logger);
+    }
+    async resolveNumberEvaluation(flagKey, defaultValue, context, _logger) {
+        return evaluate(this.configuration, 'number', flagKey, defaultValue, context, _logger);
+    }
+    async resolveObjectEvaluation(flagKey, defaultValue, context, _logger) {
+        // type safety: OpenFeature interface requires us to return a
+        // specific T for *any* value of T (which could be any subtype of
+        // JsonValue). We can't even theoretically implement it in a
+        // type-sound way because there's no runtime information passed to
+        // learn what type the user expects. So it's up to the user to
+        // make sure they pass the appropriate type.
+        return evaluate(this.configuration, 'object', flagKey, defaultValue, context, _logger);
+    }
+}
+//# sourceMappingURL=provider.js.map

package/esm/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AAUrD,MAAM,OAAO,yBAAyB;IAUpC,YAAY,OAAyC;QAT5C,aAAQ,GAAqB;YACpC,IAAI,EAAE,qBAAqB;SAC5B,CAAA;QACQ,WAAM,GAAa,QAAQ,CAAA;QAGpC,WAAM,GAAmB,cAAc,CAAC,SAAS,CAAA;QAI/C,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAA;QAC1C,IAAI,CAAC,MAAM,GAAG,cAAc,CAAC,KAAK,CAAA;IACpC,CAAC;IAED,gBAAgB;QACd,OAAO,IAAI,CAAC,aAAa,CAAA;IAC3B,CAAC;IAED,gBAAgB,CAAC,aAA2C;QAC1D,IAAI,CAAC,aAAa,GAAG,aAAa,CAAA;IACpC,CAAC;IAED,KAAK,CAAC,wBAAwB,CAC5B,OAAe,EACf,YAAqB,EACrB,OAA0B,EAC1B,OAAe;QAEf,OAAO,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IACzF,CAAC;IAED,KAAK,CAAC,uBAAuB,CAC3B,OAAe,EACf,YAAoB,EACpB,OAA0B,EAC1B,OAAe;QAEf,OAAO,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IACxF,CAAC;IAED,KAAK,CAAC,uBAAuB,CAC3B,OAAe,EACf,YAAoB,EACpB,OAA0B,EAC1B,OAAe;QAEf,OAAO,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IACxF,CAAC;IAED,KAAK,CAAC,uBAAuB,CAC3B,OAAe,EACf,YAAe,EACf,OAA0B,EAC1B,OAAe;QAEf,6DAA6D;QAC7D,iEAAiE;QACjE,4DAA4D;QAC5D,kEAAkE;QAClE,8DAA8D;QAC9D,4CAA4C;QAC5C,OAAO,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,CAAyB,CAAA;IAChH,CAAC;CACF"}

package/esm/rules/rules.d.ts

@@ -0,0 +1,51 @@
+import { EvaluationContext, EvaluationContextValue } from "@openfeature/server-sdk";
+export type ConditionValueType = EvaluationContextValue | EvaluationContextValue[];
+export declare enum OperatorType {
+    MATCHES = "MATCHES",
+    NOT_MATCHES = "NOT_MATCHES",
+    GTE = "GTE",
+    GT = "GT",
+    LTE = "LTE",
+    LT = "LT",
+    ONE_OF = "ONE_OF",
+    NOT_ONE_OF = "NOT_ONE_OF",
+    IS_NULL = "IS_NULL"
+}
+type NumericOperator = OperatorType.GTE | OperatorType.GT | OperatorType.LTE | OperatorType.LT;
+type MatchesCondition = {
+    operator: OperatorType.MATCHES;
+    attribute: string;
+    value: string;
+};
+type NotMatchesCondition = {
+    operator: OperatorType.NOT_MATCHES;
+    attribute: string;
+    value: string;
+};
+type OneOfCondition = {
+    operator: OperatorType.ONE_OF;
+    attribute: string;
+    value: string[];
+};
+type NotOneOfCondition = {
+    operator: OperatorType.NOT_ONE_OF;
+    attribute: string;
+    value: string[];
+};
+type NumericCondition = {
+    operator: NumericOperator;
+    attribute: string;
+    value: number;
+};
+type NullCondition = {
+    operator: OperatorType.IS_NULL;
+    attribute: string;
+    value: boolean;
+};
+export type Condition = MatchesCondition | NotMatchesCondition | OneOfCondition | NotOneOfCondition | NumericCondition | NullCondition;
+export interface Rule {
+    conditions: Condition[];
+}
+export declare function matchesRule(rule: Rule, subjectAttributes: EvaluationContext): boolean;
+export {};
+//# sourceMappingURL=rules.d.ts.map

package/esm/rules/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../src/rules/rules.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AAEnF,MAAM,MAAM,kBAAkB,GAAG,sBAAsB,GAAG,sBAAsB,EAAE,CAAA;AAElF,oBAAY,YAAY;IACtB,OAAO,YAAY;IACnB,WAAW,gBAAgB;IAC3B,GAAG,QAAQ;IACX,EAAE,OAAO;IACT,GAAG,QAAQ;IACX,EAAE,OAAO;IACT,MAAM,WAAW;IACjB,UAAU,eAAe;IACzB,OAAO,YAAY;CACpB;AAED,KAAK,eAAe,GAAG,YAAY,CAAC,GAAG,GAAG,YAAY,CAAC,EAAE,GAAG,YAAY,CAAC,GAAG,GAAG,YAAY,CAAC,EAAE,CAAA;AAE9F,KAAK,gBAAgB,GAAG;IACtB,QAAQ,EAAE,YAAY,CAAC,OAAO,CAAA;IAC9B,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,KAAK,mBAAmB,GAAG;IACzB,QAAQ,EAAE,YAAY,CAAC,WAAW,CAAA;IAClC,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,KAAK,cAAc,GAAG;IACpB,QAAQ,EAAE,YAAY,CAAC,MAAM,CAAA;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB,CAAA;AAED,KAAK,iBAAiB,GAAG;IACvB,QAAQ,EAAE,YAAY,CAAC,UAAU,CAAA;IACjC,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB,CAAA;AAED,KAAK,gBAAgB,GAAG;IACtB,QAAQ,EAAE,eAAe,CAAA;IACzB,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,KAAK,aAAa,GAAG;IACnB,QAAQ,EAAE,YAAY,CAAC,OAAO,CAAA;IAC9B,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,OAAO,CAAA;CACf,CAAA;AAED,MAAM,MAAM,SAAS,GACjB,gBAAgB,GAChB,mBAAmB,GACnB,cAAc,GACd,iBAAiB,GACjB,gBAAgB,GAChB,aAAa,CAAA;AAEjB,MAAM,WAAW,IAAI;IACnB,UAAU,EAAE,SAAS,EAAE,CAAA;CACxB;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,iBAAiB,EAAE,iBAAiB,GAAG,OAAO,CAIrF"}

package/esm/rules/rules.js

@@ -0,0 +1,67 @@
+export var OperatorType;
+(function (OperatorType) {
+    OperatorType["MATCHES"] = "MATCHES";
+    OperatorType["NOT_MATCHES"] = "NOT_MATCHES";
+    OperatorType["GTE"] = "GTE";
+    OperatorType["GT"] = "GT";
+    OperatorType["LTE"] = "LTE";
+    OperatorType["LT"] = "LT";
+    OperatorType["ONE_OF"] = "ONE_OF";
+    OperatorType["NOT_ONE_OF"] = "NOT_ONE_OF";
+    OperatorType["IS_NULL"] = "IS_NULL";
+})(OperatorType || (OperatorType = {}));
+export function matchesRule(rule, subjectAttributes) {
+    const conditionEvaluations = evaluateRuleConditions(subjectAttributes, rule.conditions);
+    // TODO: short-circuit return when false condition is found
+    return !conditionEvaluations.includes(false);
+}
+function evaluateRuleConditions(subjectAttributes, conditions) {
+    return conditions.map((condition) => evaluateCondition(subjectAttributes, condition));
+}
+function evaluateCondition(subjectAttributes, condition) {
+    const value = subjectAttributes[condition.attribute];
+    if (condition.operator === OperatorType.IS_NULL) {
+        if (condition.value) {
+            return value === null || value === undefined;
+        }
+        return value !== null && value !== undefined;
+    }
+    if (value !== null && value !== undefined) {
+        switch (condition.operator) {
+            case OperatorType.GTE:
+            case OperatorType.GT:
+            case OperatorType.LTE:
+            case OperatorType.LT: {
+                const comparator = (a, b) => condition.operator === OperatorType.GTE
+                    ? a >= b
+                    : condition.operator === OperatorType.GT
+                        ? a > b
+                        : condition.operator === OperatorType.LTE
+                            ? a <= b
+                            : a < b;
+                return compareNumber(value, condition.value, comparator);
+            }
+            case OperatorType.MATCHES:
+                // ReDoS mitigation should happen on user input to avoid event loop saturation (https://datadoghq.atlassian.net/browse/FFL-1060)
+                return new RegExp(condition.value).test(String(value)); // dd-iac-scan ignore-line
+            case OperatorType.NOT_MATCHES:
+                // ReDoS mitigation should happen on user input to avoid event loop saturation (https://datadoghq.atlassian.net/browse/FFL-1060)
+                return !new RegExp(condition.value).test(String(value)); // dd-iac-scan ignore-line
+            case OperatorType.ONE_OF:
+                return isOneOf(value.toString(), condition.value);
+            case OperatorType.NOT_ONE_OF:
+                return isNotOneOf(value.toString(), condition.value);
+        }
+    }
+    return false;
+}
+function isOneOf(attributeValue, conditionValues) {
+    return conditionValues.includes(attributeValue);
+}
+function isNotOneOf(attributeValue, conditionValues) {
+    return !isOneOf(attributeValue, conditionValues);
+}
+function compareNumber(attributeValue, conditionValue, compareFn) {
+    return compareFn(Number(attributeValue), Number(conditionValue));
+}
+//# sourceMappingURL=rules.js.map

package/esm/rules/rules.js.map

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

package/esm/shards/matchesShard.d.ts

@@ -0,0 +1,4 @@
+import { Shard } from '../configuration/ufc-v1';
+import { Sharder } from './sharders';
+export declare function matchesShard(shard: Shard, subjectKey: string, customSharder?: Sharder): boolean;
+//# sourceMappingURL=matchesShard.d.ts.map

package/esm/shards/matchesShard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matchesShard.d.ts","sourceRoot":"","sources":["../../src/shards/matchesShard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAc,MAAM,yBAAyB,CAAA;AAC3D,OAAO,EAAc,OAAO,EAAE,MAAM,YAAY,CAAA;AAEhD,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,OAAO,GAAG,OAAO,CAI/F"}

package/esm/shards/matchesShard.js

@@ -0,0 +1,13 @@
+import { MD5Sharder } from './sharders';
+export function matchesShard(shard, subjectKey, customSharder) {
+    const sharder = customSharder !== null && customSharder !== void 0 ? customSharder : new MD5Sharder();
+    const assignedShard = sharder.getShard(hashKey(shard.salt, subjectKey), shard.totalShards);
+    return shard.ranges.some((range) => isInShardRange(assignedShard, range));
+}
+function isInShardRange(shard, range) {
+    return range.start <= shard && shard < range.end;
+}
+function hashKey(salt, subjectKey) {
+    return `${salt}-${subjectKey}`;
+}
+//# sourceMappingURL=matchesShard.js.map

package/esm/shards/matchesShard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matchesShard.js","sourceRoot":"","sources":["../../src/shards/matchesShard.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAW,MAAM,YAAY,CAAA;AAEhD,MAAM,UAAU,YAAY,CAAC,KAAY,EAAE,UAAkB,EAAE,aAAuB;IACpF,MAAM,OAAO,GAAG,aAAa,aAAb,aAAa,cAAb,aAAa,GAAI,IAAI,UAAU,EAAE,CAAA;IACjD,MAAM,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,CAAA;IAC1F,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC,CAAA;AAC3E,CAAC;AAED,SAAS,cAAc,CAAC,KAAa,EAAE,KAAiB;IACtD,OAAO,KAAK,CAAC,KAAK,IAAI,KAAK,IAAI,KAAK,GAAG,KAAK,CAAC,GAAG,CAAA;AAClD,CAAC;AAED,SAAS,OAAO,CAAC,IAAY,EAAE,UAAkB;IAC/C,OAAO,GAAG,IAAI,IAAI,UAAU,EAAE,CAAA;AAChC,CAAC"}

package/esm/shards/obfuscation.d.ts

@@ -0,0 +1,9 @@
+export declare function getMD5Hash(input: string, salt?: string): string;
+/**
+ * Builds a storage key suffix from an API key.
+ * @param apiKey - The API key to build the suffix from
+ * @returns A string suffix for storage keys
+ * @public
+ */
+export declare function buildStorageKeySuffix(apiKey: string): string;
+//# sourceMappingURL=obfuscation.d.ts.map

package/esm/shards/obfuscation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"obfuscation.d.ts","sourceRoot":"","sources":["../../src/shards/obfuscation.ts"],"names":[],"mappings":"AAEA,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,SAAK,GAAG,MAAM,CAE3D;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAI5D"}

package/esm/shards/obfuscation.js

@@ -0,0 +1,16 @@
+import SparkMD5 from 'spark-md5';
+export function getMD5Hash(input, salt = '') {
+    return new SparkMD5().append(salt).append(input).end();
+}
+/**
+ * Builds a storage key suffix from an API key.
+ * @param apiKey - The API key to build the suffix from
+ * @returns A string suffix for storage keys
+ * @public
+ */
+export function buildStorageKeySuffix(apiKey) {
+    // Note that we hash the API key and use the first 16 characters of the digest.
+    const hashed = getMD5Hash(apiKey);
+    return hashed.slice(0, 16);
+}
+//# sourceMappingURL=obfuscation.js.map

package/esm/shards/obfuscation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"obfuscation.js","sourceRoot":"","sources":["../../src/shards/obfuscation.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,WAAW,CAAA;AAEhC,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,IAAI,GAAG,EAAE;IACjD,OAAO,IAAI,QAAQ,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAA;AACxD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAc;IAClD,+EAA+E;IAC/E,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAA;IACjC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;AAC5B,CAAC"}

package/esm/shards/sharders.d.ts

@@ -0,0 +1,12 @@
+export declare abstract class Sharder {
+    abstract getShard(input: string, totalShards: number): number;
+}
+export declare class MD5Sharder extends Sharder {
+    getShard(input: string, totalShards: number): number;
+}
+export declare class DeterministicSharder extends Sharder {
+    private lookup;
+    constructor(lookup: Record<string, number>);
+    getShard(input: string, _totalShards: number): number;
+}
+//# sourceMappingURL=sharders.d.ts.map

package/esm/shards/sharders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sharders.d.ts","sourceRoot":"","sources":["../../src/shards/sharders.ts"],"names":[],"mappings":"AAEA,8BAAsB,OAAO;IAC3B,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM;CAC9D;AAED,qBAAa,UAAW,SAAQ,OAAO;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM;CAOrD;AAED,qBAAa,oBAAqB,SAAQ,OAAO;IAK/C,OAAO,CAAC,MAAM,CAAwB;gBAE1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAM1C,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM;CAGtD"}