npm - @datadog/flagging-core - Versions diffs - 0.2.0 → 0.3.0 - Mend

@datadog/flagging-core 0.2.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (34) hide show

package/LICENSE CHANGED Viewed

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
-   Copyright 2025 Datadog, Inc.
+   Copyright 2025-present Datadog, Inc.
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

package/cjs/configuration/flagEvaluationAggregator.d.ts ADDED Viewed

@@ -0,0 +1,15 @@
+import type { EvaluationContext, EvaluationDetails, FlagValue } from '@openfeature/core';
+import type { FlagEvaluationEvent } from './flagEvaluationEvent.types';
+export declare class FlagEvaluationAggregator {
+    private aggregatedData;
+    private intervalId?;
+    private readonly flushInterval;
+    private readonly onFlush;
+    constructor(flushInterval: number, onFlush: (events: FlagEvaluationEvent[]) => void);
+    start(): void;
+    stop(): void;
+    addEvaluation<T extends FlagValue>(context: EvaluationContext, details: EvaluationDetails<T>, error?: string): void;
+    flush(): void;
+    private createAggregationKeyString;
+}
+//# sourceMappingURL=flagEvaluationAggregator.d.ts.map

package/cjs/configuration/flagEvaluationAggregator.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"flagEvaluationAggregator.d.ts","sourceRoot":"","sources":["../../src/configuration/flagEvaluationAggregator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAA0B,iBAAiB,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAGhH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AAgBtE,qBAAa,wBAAwB;IACnC,OAAO,CAAC,cAAc,CAAmD;IACzE,OAAO,CAAC,UAAU,CAAC,CAAgB;IACnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAQ;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyC;gBAErD,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,mBAAmB,EAAE,KAAK,IAAI;IAKnF,KAAK,IAAI,IAAI;IAMb,IAAI,IAAI,IAAI;IAQZ,aAAa,CAAC,CAAC,SAAS,SAAS,EAAE,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAiCnH,KAAK,IAAI,IAAI;IAYb,OAAO,CAAC,0BAA0B;CAsBnC"}

package/cjs/configuration/flagEvaluationAggregator.js ADDED Viewed

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlagEvaluationAggregator = void 0;
+const obfuscation_1 = require("../obfuscation");
+const flagEvaluationEvent_1 = require("./flagEvaluationEvent");
+class FlagEvaluationAggregator {
+    constructor(flushInterval, onFlush) {
+        this.aggregatedData = new Map();
+        this.flushInterval = flushInterval;
+        this.onFlush = onFlush;
+    }
+    start() {
+        this.intervalId = setInterval(() => {
+            this.flush();
+        }, this.flushInterval);
+    }
+    stop() {
+        if (this.intervalId) {
+            clearInterval(this.intervalId);
+            this.intervalId = undefined;
+        }
+        this.flush();
+    }
+    addEvaluation(context, details, error) {
+        var _a, _b;
+        const keyString = this.createAggregationKeyString(context, details, error);
+        const timestamp = Date.now();
+        const existingData = this.aggregatedData.get(keyString);
+        if (existingData) {
+            existingData.count++;
+            existingData.lastEvaluation = timestamp;
+            if (error) {
+                existingData.error = error;
+            }
+        }
+        else {
+            const runtimeDefaultUsed = details.reason === 'DEFAULT' || details.reason === 'ERROR';
+            const allocationKey = (_a = details.flagMetadata) === null || _a === void 0 ? void 0 : _a.allocationKey;
+            const targetingRuleKey = (_b = details.flagMetadata) === null || _b === void 0 ? void 0 : _b.targetingRuleKey;
+            const { targetingKey, ...targetingContext } = context;
+            this.aggregatedData.set(keyString, {
+                flagKey: details.flagKey,
+                variantKey: details.variant,
+                allocationKey,
+                targetingRuleKey,
+                targetingKey,
+                targetingContext,
+                count: 1,
+                firstEvaluation: timestamp,
+                lastEvaluation: timestamp,
+                runtimeDefaultUsed,
+                error,
+            });
+        }
+    }
+    flush() {
+        if (this.aggregatedData.size === 0) {
+            return;
+        }
+        const events = Array.from(this.aggregatedData.values()).map((data) => (0, flagEvaluationEvent_1.createFlagEvaluationEvent)(data, data.firstEvaluation));
+        this.aggregatedData.clear();
+        this.onFlush(events);
+    }
+    createAggregationKeyString(context, details, error) {
+        var _a, _b;
+        const allocationKey = (_a = details.flagMetadata) === null || _a === void 0 ? void 0 : _a.allocationKey;
+        const targetingRuleKey = (_b = details.flagMetadata) === null || _b === void 0 ? void 0 : _b.targetingRuleKey;
+        const { targetingKey, ...targetingContext } = context;
+        // Hash the deterministic object representation
+        return (0, obfuscation_1.getMD5Hash)(JSON.stringify({
+            flagKey: details.flagKey,
+            variant: details.variant || '',
+            allocationKey: allocationKey || '',
+            targetingRuleKey: targetingRuleKey || '',
+            targetingKey: targetingKey || '',
+            targetingContext,
+            error: error || '',
+        }));
+    }
+}
+exports.FlagEvaluationAggregator = FlagEvaluationAggregator;
+//# sourceMappingURL=flagEvaluationAggregator.js.map

package/cjs/configuration/flagEvaluationAggregator.js.map ADDED Viewed

@@ -0,0 +1 @@

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

package/cjs/configuration/flagEvaluationEvent.d.ts ADDED Viewed

@@ -0,0 +1,18 @@
+import type { EvaluationContextValue } from '@openfeature/core';
+import type { FlagEvaluationEvent } from './flagEvaluationEvent.types';
+interface FlagEvaluationAggregationData {
+    flagKey: string;
+    variantKey?: string;
+    allocationKey?: string;
+    targetingRuleKey?: string;
+    targetingKey?: string;
+    targetingContext?: Record<string, EvaluationContextValue>;
+    count: number;
+    firstEvaluation: number;
+    lastEvaluation: number;
+    runtimeDefaultUsed: boolean;
+    error?: string;
+}
+export declare function createFlagEvaluationEvent(data: FlagEvaluationAggregationData, timestamp: number): FlagEvaluationEvent;
+export {};
+//# sourceMappingURL=flagEvaluationEvent.d.ts.map

package/cjs/configuration/flagEvaluationEvent.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"flagEvaluationEvent.d.ts","sourceRoot":"","sources":["../../src/configuration/flagEvaluationEvent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAA;AAC/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AAEtE,UAAU,6BAA6B;IACrC,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAA;IACzD,KAAK,EAAE,MAAM,CAAA;IACb,eAAe,EAAE,MAAM,CAAA;IACvB,cAAc,EAAE,MAAM,CAAA;IACtB,kBAAkB,EAAE,OAAO,CAAA;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,6BAA6B,EAAE,SAAS,EAAE,MAAM,GAAG,mBAAmB,CAwCrH"}

package/cjs/configuration/flagEvaluationEvent.js ADDED Viewed

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createFlagEvaluationEvent = createFlagEvaluationEvent;
+function createFlagEvaluationEvent(data, timestamp) {
+    const event = {
+        flag: {
+            key: data.flagKey,
+        },
+        first_evaluation: data.firstEvaluation,
+        last_evaluation: data.lastEvaluation,
+        evaluation_count: data.count,
+        runtime_default_used: data.runtimeDefaultUsed,
+        timestamp,
+    };
+    if (data.targetingKey) {
+        event.targeting_key = data.targetingKey;
+    }
+    if (data.error) {
+        event.error = { message: data.error };
+    }
+    if (data.variantKey) {
+        event.variant = { key: data.variantKey };
+    }
+    if (data.allocationKey) {
+        event.allocation = { key: data.allocationKey };
+    }
+    if (data.targetingRuleKey) {
+        event.targeting_rule = { key: data.targetingRuleKey };
+    }
+    // Add context data if targeting context exists
+    if (data.targetingContext && Object.keys(data.targetingContext).length > 0) {
+        event.context = {
+            evaluation: data.targetingContext,
+        };
+    }
+    return event;
+}
+//# sourceMappingURL=flagEvaluationEvent.js.map

package/cjs/configuration/flagEvaluationEvent.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"flagEvaluationEvent.js","sourceRoot":"","sources":["../../src/configuration/flagEvaluationEvent.ts"],"names":[],"mappings":";;AAiBA,8DAwCC;AAxCD,SAAgB,yBAAyB,CAAC,IAAmC,EAAE,SAAiB;IAC9F,MAAM,KAAK,GAAwB;QACjC,IAAI,EAAE;YACJ,GAAG,EAAE,IAAI,CAAC,OAAO;SAClB;QACD,gBAAgB,EAAE,IAAI,CAAC,eAAe;QACtC,eAAe,EAAE,IAAI,CAAC,cAAc;QACpC,gBAAgB,EAAE,IAAI,CAAC,KAAK;QAC5B,oBAAoB,EAAE,IAAI,CAAC,kBAAkB;QAC7C,SAAS;KACV,CAAA;IAED,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC,YAAY,CAAA;IACzC,CAAC;IAED,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,KAAK,CAAC,KAAK,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,CAAA;IACvC,CAAC;IAED,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,KAAK,CAAC,OAAO,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,CAAA;IAC1C,CAAC;IAED,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QACvB,KAAK,CAAC,UAAU,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,aAAa,EAAE,CAAA;IAChD,CAAC;IAED,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC1B,KAAK,CAAC,cAAc,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,gBAAgB,EAAE,CAAA;IACvD,CAAC;IAED,+CAA+C;IAC/C,IAAI,IAAI,CAAC,gBAAgB,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3E,KAAK,CAAC,OAAO,GAAG;YACd,UAAU,EAAE,IAAI,CAAC,gBAAgB;SAClC,CAAA;IACH,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC"}

package/cjs/configuration/flagEvaluationEvent.types.d.ts ADDED Viewed

@@ -0,0 +1,55 @@
+import type { EvaluationContextValue } from '@openfeature/core';
+export interface FlagEvaluationEvent {
+    flag: {
+        key: string;
+    };
+    first_evaluation: number;
+    last_evaluation: number;
+    evaluation_count: number;
+    runtime_default_used: boolean;
+    timestamp: number;
+    targeting_key?: string;
+    error?: {
+        message: string;
+    };
+    variant?: {
+        key: string;
+    };
+    allocation?: {
+        key: string;
+    };
+    targeting_rule?: {
+        key: string;
+    };
+    context?: {
+        evaluation?: Record<string, EvaluationContextValue>;
+        dd?: {
+            service?: string;
+            rum?: {
+                application?: {
+                    id?: string;
+                };
+                view?: {
+                    url?: string;
+                };
+            };
+        };
+    };
+}
+export interface FlagEvaluationAggregationKey {
+    flagKey: string;
+    variantKey?: string;
+    allocationKey?: string;
+    targetingRuleKey?: string;
+    targetingKey?: string;
+    targetingContext?: Record<string, EvaluationContextValue>;
+}
+export interface FlagEvaluationAggregationData {
+    key: FlagEvaluationAggregationKey;
+    count: number;
+    firstEvaluation: number;
+    lastEvaluation: number;
+    runtimeDefaultUsed: boolean;
+    error?: string;
+}
+//# sourceMappingURL=flagEvaluationEvent.types.d.ts.map

package/cjs/configuration/flagEvaluationEvent.types.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"flagEvaluationEvent.types.d.ts","sourceRoot":"","sources":["../../src/configuration/flagEvaluationEvent.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAA;AAE/D,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE;QACJ,GAAG,EAAE,MAAM,CAAA;KACZ,CAAA;IACD,gBAAgB,EAAE,MAAM,CAAA;IACxB,eAAe,EAAE,MAAM,CAAA;IACvB,gBAAgB,EAAE,MAAM,CAAA;IACxB,oBAAoB,EAAE,OAAO,CAAA;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,MAAM,CAAA;KAChB,CAAA;IACD,OAAO,CAAC,EAAE;QACR,GAAG,EAAE,MAAM,CAAA;KACZ,CAAA;IACD,UAAU,CAAC,EAAE;QACX,GAAG,EAAE,MAAM,CAAA;KACZ,CAAA;IACD,cAAc,CAAC,EAAE;QACf,GAAG,EAAE,MAAM,CAAA;KACZ,CAAA;IACD,OAAO,CAAC,EAAE;QACR,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAA;QACnD,EAAE,CAAC,EAAE;YACH,OAAO,CAAC,EAAE,MAAM,CAAA;YAChB,GAAG,CAAC,EAAE;gBACJ,WAAW,CAAC,EAAE;oBACZ,EAAE,CAAC,EAAE,MAAM,CAAA;iBACZ,CAAA;gBACD,IAAI,CAAC,EAAE;oBACL,GAAG,CAAC,EAAE,MAAM,CAAA;iBACb,CAAA;aACF,CAAA;SACF,CAAA;KACF,CAAA;CACF;AAED,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAA;CAC1D;AAED,MAAM,WAAW,6BAA6B;IAC5C,GAAG,EAAE,4BAA4B,CAAA;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,eAAe,EAAE,MAAM,CAAA;IACvB,cAAc,EAAE,MAAM,CAAA;IACtB,kBAAkB,EAAE,OAAO,CAAA;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;CACf"}

package/cjs/configuration/flagEvaluationEvent.types.js ADDED Viewed

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=flagEvaluationEvent.types.js.map

package/cjs/configuration/flagEvaluationEvent.types.js.map ADDED Viewed

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

package/cjs/configuration/index.d.ts CHANGED Viewed

@@ -1,5 +1,8 @@
 export * from './configuration';
 export * from './exposureEvent';
 export * from './exposureEvent.types';
+export * from './flagEvaluationAggregator';
+export * from './flagEvaluationEvent';
+export * from './flagEvaluationEvent.types';
 export * from './wire';
 //# sourceMappingURL=index.d.ts.map

package/cjs/configuration/index.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/configuration/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,uBAAuB,CAAA;AACrC,cAAc,QAAQ,CAAA"}
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/configuration/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,uBAAuB,CAAA;AACrC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,uBAAuB,CAAA;AACrC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,QAAQ,CAAA"}

package/cjs/configuration/index.js CHANGED Viewed

@@ -17,5 +17,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./configuration"), exports);
 __exportStar(require("./exposureEvent"), exports);
 __exportStar(require("./exposureEvent.types"), exports);
+__exportStar(require("./flagEvaluationAggregator"), exports);
+__exportStar(require("./flagEvaluationEvent"), exports);
+__exportStar(require("./flagEvaluationEvent.types"), exports);
 __exportStar(require("./wire"), exports);
 //# sourceMappingURL=index.js.map

package/cjs/configuration/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/configuration/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAA+B;AAC/B,kDAA+B;AAC/B,wDAAqC;AACrC,yCAAsB"}
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/configuration/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAA+B;AAC/B,kDAA+B;AAC/B,wDAAqC;AACrC,6DAA0C;AAC1C,wDAAqC;AACrC,8DAA2C;AAC3C,yCAAsB"}

package/esm/configuration/flagEvaluationAggregator.d.ts ADDED Viewed

@@ -0,0 +1,15 @@
+import type { EvaluationContext, EvaluationDetails, FlagValue } from '@openfeature/core';
+import type { FlagEvaluationEvent } from './flagEvaluationEvent.types';
+export declare class FlagEvaluationAggregator {
+    private aggregatedData;
+    private intervalId?;
+    private readonly flushInterval;
+    private readonly onFlush;
+    constructor(flushInterval: number, onFlush: (events: FlagEvaluationEvent[]) => void);
+    start(): void;
+    stop(): void;
+    addEvaluation<T extends FlagValue>(context: EvaluationContext, details: EvaluationDetails<T>, error?: string): void;
+    flush(): void;
+    private createAggregationKeyString;
+}
+//# sourceMappingURL=flagEvaluationAggregator.d.ts.map

package/esm/configuration/flagEvaluationAggregator.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

package/esm/configuration/flagEvaluationAggregator.js ADDED Viewed

@@ -0,0 +1,78 @@
+import { getMD5Hash } from '../obfuscation';
+import { createFlagEvaluationEvent } from './flagEvaluationEvent';
+export class FlagEvaluationAggregator {
+    constructor(flushInterval, onFlush) {
+        this.aggregatedData = new Map();
+        this.flushInterval = flushInterval;
+        this.onFlush = onFlush;
+    }
+    start() {
+        this.intervalId = setInterval(() => {
+            this.flush();
+        }, this.flushInterval);
+    }
+    stop() {
+        if (this.intervalId) {
+            clearInterval(this.intervalId);
+            this.intervalId = undefined;
+        }
+        this.flush();
+    }
+    addEvaluation(context, details, error) {
+        var _a, _b;
+        const keyString = this.createAggregationKeyString(context, details, error);
+        const timestamp = Date.now();
+        const existingData = this.aggregatedData.get(keyString);
+        if (existingData) {
+            existingData.count++;
+            existingData.lastEvaluation = timestamp;
+            if (error) {
+                existingData.error = error;
+            }
+        }
+        else {
+            const runtimeDefaultUsed = details.reason === 'DEFAULT' || details.reason === 'ERROR';
+            const allocationKey = (_a = details.flagMetadata) === null || _a === void 0 ? void 0 : _a.allocationKey;
+            const targetingRuleKey = (_b = details.flagMetadata) === null || _b === void 0 ? void 0 : _b.targetingRuleKey;
+            const { targetingKey, ...targetingContext } = context;
+            this.aggregatedData.set(keyString, {
+                flagKey: details.flagKey,
+                variantKey: details.variant,
+                allocationKey,
+                targetingRuleKey,
+                targetingKey,
+                targetingContext,
+                count: 1,
+                firstEvaluation: timestamp,
+                lastEvaluation: timestamp,
+                runtimeDefaultUsed,
+                error,
+            });
+        }
+    }
+    flush() {
+        if (this.aggregatedData.size === 0) {
+            return;
+        }
+        const events = Array.from(this.aggregatedData.values()).map((data) => createFlagEvaluationEvent(data, data.firstEvaluation));
+        this.aggregatedData.clear();
+        this.onFlush(events);
+    }
+    createAggregationKeyString(context, details, error) {
+        var _a, _b;
+        const allocationKey = (_a = details.flagMetadata) === null || _a === void 0 ? void 0 : _a.allocationKey;
+        const targetingRuleKey = (_b = details.flagMetadata) === null || _b === void 0 ? void 0 : _b.targetingRuleKey;
+        const { targetingKey, ...targetingContext } = context;
+        // Hash the deterministic object representation
+        return getMD5Hash(JSON.stringify({
+            flagKey: details.flagKey,
+            variant: details.variant || '',
+            allocationKey: allocationKey || '',
+            targetingRuleKey: targetingRuleKey || '',
+            targetingKey: targetingKey || '',
+            targetingContext,
+            error: error || '',
+        }));
+    }
+}
+//# sourceMappingURL=flagEvaluationAggregator.js.map

package/esm/configuration/flagEvaluationAggregator.js.map ADDED Viewed

@@ -0,0 +1 @@

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

package/esm/configuration/flagEvaluationEvent.d.ts ADDED Viewed

@@ -0,0 +1,18 @@
+import type { EvaluationContextValue } from '@openfeature/core';
+import type { FlagEvaluationEvent } from './flagEvaluationEvent.types';
+interface FlagEvaluationAggregationData {
+    flagKey: string;
+    variantKey?: string;
+    allocationKey?: string;
+    targetingRuleKey?: string;
+    targetingKey?: string;
+    targetingContext?: Record<string, EvaluationContextValue>;
+    count: number;
+    firstEvaluation: number;
+    lastEvaluation: number;
+    runtimeDefaultUsed: boolean;
+    error?: string;
+}
+export declare function createFlagEvaluationEvent(data: FlagEvaluationAggregationData, timestamp: number): FlagEvaluationEvent;
+export {};
+//# sourceMappingURL=flagEvaluationEvent.d.ts.map

package/esm/configuration/flagEvaluationEvent.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

package/esm/configuration/flagEvaluationEvent.js ADDED Viewed

@@ -0,0 +1,35 @@
+export function createFlagEvaluationEvent(data, timestamp) {
+    const event = {
+        flag: {
+            key: data.flagKey,
+        },
+        first_evaluation: data.firstEvaluation,
+        last_evaluation: data.lastEvaluation,
+        evaluation_count: data.count,
+        runtime_default_used: data.runtimeDefaultUsed,
+        timestamp,
+    };
+    if (data.targetingKey) {
+        event.targeting_key = data.targetingKey;
+    }
+    if (data.error) {
+        event.error = { message: data.error };
+    }
+    if (data.variantKey) {
+        event.variant = { key: data.variantKey };
+    }
+    if (data.allocationKey) {
+        event.allocation = { key: data.allocationKey };
+    }
+    if (data.targetingRuleKey) {
+        event.targeting_rule = { key: data.targetingRuleKey };
+    }
+    // Add context data if targeting context exists
+    if (data.targetingContext && Object.keys(data.targetingContext).length > 0) {
+        event.context = {
+            evaluation: data.targetingContext,
+        };
+    }
+    return event;
+}
+//# sourceMappingURL=flagEvaluationEvent.js.map

package/esm/configuration/flagEvaluationEvent.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"flagEvaluationEvent.js","sourceRoot":"","sources":["../../src/configuration/flagEvaluationEvent.ts"],"names":[],"mappings":"AAiBA,MAAM,UAAU,yBAAyB,CAAC,IAAmC,EAAE,SAAiB;IAC9F,MAAM,KAAK,GAAwB;QACjC,IAAI,EAAE;YACJ,GAAG,EAAE,IAAI,CAAC,OAAO;SAClB;QACD,gBAAgB,EAAE,IAAI,CAAC,eAAe;QACtC,eAAe,EAAE,IAAI,CAAC,cAAc;QACpC,gBAAgB,EAAE,IAAI,CAAC,KAAK;QAC5B,oBAAoB,EAAE,IAAI,CAAC,kBAAkB;QAC7C,SAAS;KACV,CAAA;IAED,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC,YAAY,CAAA;IACzC,CAAC;IAED,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,KAAK,CAAC,KAAK,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,CAAA;IACvC,CAAC;IAED,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,KAAK,CAAC,OAAO,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,CAAA;IAC1C,CAAC;IAED,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QACvB,KAAK,CAAC,UAAU,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,aAAa,EAAE,CAAA;IAChD,CAAC;IAED,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC1B,KAAK,CAAC,cAAc,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,gBAAgB,EAAE,CAAA;IACvD,CAAC;IAED,+CAA+C;IAC/C,IAAI,IAAI,CAAC,gBAAgB,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3E,KAAK,CAAC,OAAO,GAAG;YACd,UAAU,EAAE,IAAI,CAAC,gBAAgB;SAClC,CAAA;IACH,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC"}

package/esm/configuration/flagEvaluationEvent.types.d.ts ADDED Viewed

@@ -0,0 +1,55 @@
+import type { EvaluationContextValue } from '@openfeature/core';
+export interface FlagEvaluationEvent {
+    flag: {
+        key: string;
+    };
+    first_evaluation: number;
+    last_evaluation: number;
+    evaluation_count: number;
+    runtime_default_used: boolean;
+    timestamp: number;
+    targeting_key?: string;
+    error?: {
+        message: string;
+    };
+    variant?: {
+        key: string;
+    };
+    allocation?: {
+        key: string;
+    };
+    targeting_rule?: {
+        key: string;
+    };
+    context?: {
+        evaluation?: Record<string, EvaluationContextValue>;
+        dd?: {
+            service?: string;
+            rum?: {
+                application?: {
+                    id?: string;
+                };
+                view?: {
+                    url?: string;
+                };
+            };
+        };
+    };
+}
+export interface FlagEvaluationAggregationKey {
+    flagKey: string;
+    variantKey?: string;
+    allocationKey?: string;
+    targetingRuleKey?: string;
+    targetingKey?: string;
+    targetingContext?: Record<string, EvaluationContextValue>;
+}
+export interface FlagEvaluationAggregationData {
+    key: FlagEvaluationAggregationKey;
+    count: number;
+    firstEvaluation: number;
+    lastEvaluation: number;
+    runtimeDefaultUsed: boolean;
+    error?: string;
+}
+//# sourceMappingURL=flagEvaluationEvent.types.d.ts.map

package/esm/configuration/flagEvaluationEvent.types.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

package/esm/configuration/flagEvaluationEvent.types.js ADDED Viewed

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

package/esm/configuration/flagEvaluationEvent.types.js.map ADDED Viewed

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

package/esm/configuration/index.d.ts CHANGED Viewed

@@ -1,5 +1,8 @@
 export * from './configuration';
 export * from './exposureEvent';
 export * from './exposureEvent.types';
+export * from './flagEvaluationAggregator';
+export * from './flagEvaluationEvent';
+export * from './flagEvaluationEvent.types';
 export * from './wire';
 //# sourceMappingURL=index.d.ts.map

package/esm/configuration/index.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/configuration/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,uBAAuB,CAAA;AACrC,cAAc,QAAQ,CAAA"}
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/configuration/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,uBAAuB,CAAA;AACrC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,uBAAuB,CAAA;AACrC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,QAAQ,CAAA"}

package/esm/configuration/index.js CHANGED Viewed

@@ -1,5 +1,8 @@
 export * from './configuration';
 export * from './exposureEvent';
 export * from './exposureEvent.types';
+export * from './flagEvaluationAggregator';
+export * from './flagEvaluationEvent';
+export * from './flagEvaluationEvent.types';
 export * from './wire';
 //# sourceMappingURL=index.js.map

package/esm/configuration/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/configuration/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,uBAAuB,CAAA;AACrC,cAAc,QAAQ,CAAA"}
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/configuration/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,uBAAuB,CAAA;AACrC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,uBAAuB,CAAA;AACrC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,QAAQ,CAAA"}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@datadog/flagging-core",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Runtime-agnostic flag-evaluation logic for Datadog Flagging",
   "license": "Apache-2.0",
   "repository": {