@reflag/openfeature-node-provider 1.0.0-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Bucket ApS
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,196 @@
+# Reflag Node.js OpenFeature Provider
+
+The official OpenFeature Node.js provider for [Reflag](https://reflag.com) feature management service.
+
+## Installation
+
+```shell
+npm install @reflag/openfeature-node-provider
+```
+
+### Required peer dependencies
+
+The OpenFeature SDK is required as peer dependency.
+The minimum required version of `@openfeature/server-sdk` currently is `1.13.5`.
+The minimum required version of `@reflag/node-sdk` currently is `2.0.0`.
+
+```shell
+npm install @openfeature/server-sdk @reflag/node-sdk
+```
+
+## Usage
+
+The provider uses the [Reflag Node.js SDK](https://docs.reflag.com/quickstart/supported-languages-frameworks/node.js-sdk).
+The available options can be found in the [Reflag Node.js SDK](https://github.com/reflagcom/javascript/tree/main/packages/node-sdk#initialization-options).
+
+### Example using the default configuration
+
+```typescript
+import { ReflagNodeProvider } from "@reflag/openfeature-node-provider";
+import { OpenFeature } from "@openfeature/server-sdk";
+
+const provider = new ReflagNodeProvider({ secretKey });
+
+await OpenFeature.setProviderAndWait(provider);
+
+// set a value to the global context
+OpenFeature.setContext({ region: "us-east-1" });
+
+// set a value to the invocation context
+// this is merged with the global context
+const requestContext = {
+  targetingKey: req.user.id,
+  email: req.user.email,
+  companyPlan: req.locals.plan,
+};
+
+const client = OpenFeature.getClient();
+
+const enterpriseFeatureEnabled = await client.getBooleanValue(
+  "enterpriseFlag",
+  false,
+  requestContext,
+);
+```
+
+## Feature resolution methods
+
+The Reflag OpenFeature Provider implements the OpenFeature evaluation interface for different value types. Each method handles the resolution of flags according to the OpenFeature specification.
+
+### Common behavior
+
+All resolution methods share these behaviors:
+
+- Return default value with `PROVIDER_NOT_READY` if client is not initialized,
+- Return default value with `FLAG_NOT_FOUND` if flag doesn't exist,
+- Return default value with `ERROR` if there was a type mismatch,
+- Return evaluated value with `TARGETING_MATCH` on successful resolution.
+
+### Type-Specific Methods
+
+#### Boolean Resolution
+
+```ts
+client.getBooleanValue("my-flag", false);
+```
+
+Returns the feature's enabled state. This is the most common use case for flags.
+
+#### String Resolution
+
+```ts
+client.getStringValue("my-flag", "default");
+```
+
+Returns the feature's remote config key (also known as "variant"). Useful for multi-variate use cases.
+
+#### Number Resolution
+
+```ts
+client.getNumberValue("my-flag", 0);
+```
+
+Not directly supported by Reflag. Use `getObjectValue` instead for numeric configurations.
+
+#### Object Resolution
+
+```ts
+// works for any type:
+client.getObjectValue("my-flag", { defaultValue: true });
+client.getObjectValue("my-flag", "string-value");
+client.getObjectValue("my-flag", 199);
+```
+
+Returns the feature's remote config payload with type validation. This is the most flexible method,
+allowing for complex configuration objects or simple types.
+
+The object resolution performs runtime type checking between the default value and the feature payload to ensure type safety.
+
+## Translating Evaluation Context
+
+Reflag uses a context object of the following shape:
+
+```ts
+/**
+ * Describes the current user context, company context, and other context.
+ * This is used to determine if feature targeting matches and to track events.
+ **/
+export type ReflagContext = {
+  /**
+   * The user context. If the user is set, the user ID is required.
+   */
+  user?: {
+    id: string;
+    name?: string;
+    email?: string;
+    avatar?: string;
+    [k: string]: any;
+  };
+
+  /**
+   * The company context. If the company is set, the company ID is required.
+   */
+  company?: { id: string; name?: string; avatar?: string; [k: string]: any };
+
+  /**
+   * The other context. This is used for any additional context that is not related to user or company.
+   */
+  other?: Record<string, any>;
+};
+```
+
+To use the Reflag Node.js OpenFeature provider, you must convert your OpenFeature contexts to Reflag contexts.
+You can achieve this by supplying a context translation function which takes the Open Feature context and returns
+a corresponding Reflag Context:
+
+```ts
+import { ReflagNodeProvider } from "@openfeature/reflag-node-provider";
+
+const contextTranslator = (context: EvaluationContext): ReflagContext => {
+  return {
+    user: {
+      id: context.targetingKey ?? context["userId"]?.toString(),
+      name: context["name"]?.toString(),
+      email: context["email"]?.toString(),
+      avatar: context["avatar"]?.toString(),
+      country: context["country"]?.toString(),
+    },
+    company: {
+      id: context["companyId"]?.toString(),
+      name: context["companyName"]?.toString(),
+      avatar: context["companyAvatar"]?.toString(),
+      plan: context["companyPlan"]?.toString(),
+    },
+  };
+};
+
+const provider = new ReflagNodeProvider({ secretKey, contextTranslator });
+
+OpenFeature.setProvider(provider);
+```
+
+## Tracking feature adoption
+
+The Reflag OpenFeature provider supports the OpenFeature Tracking API.
+It's straight forward to start sending tracking events through OpenFeature.
+
+Simply call the "track" method on the OpenFeature client:
+
+```typescript
+import { ReflagNodeProvider } from "@reflag/openfeature-node-provider";
+import { OpenFeature } from "@openfeature/server-sdk";
+
+const provider = new ReflagNodeProvider({ secretKey });
+
+await OpenFeature.setProviderAndWait(provider);
+
+const client = OpenFeature.getClient();
+
+// `evaluationContext` is whatever you use to evaluate features based off
+const enterpriseFlagEnabled = await client.track("huddles", evaluationContext);
+```
+
+## License
+
+> MIT License
+> Copyright (c) 2025 Bucket ApS

package/dist/index.js

@@ -0,0 +1,174 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReflagNodeProvider = exports.defaultContextTranslator = void 0;
+const server_sdk_1 = require("@openfeature/server-sdk");
+const node_sdk_1 = require("@reflag/node-sdk");
+const defaultContextTranslator = (context) => {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+    const user = {
+        id: (_a = context.targetingKey) !== null && _a !== void 0 ? _a : (_b = context["userId"]) === null || _b === void 0 ? void 0 : _b.toString(),
+        name: (_c = context["name"]) === null || _c === void 0 ? void 0 : _c.toString(),
+        email: (_d = context["email"]) === null || _d === void 0 ? void 0 : _d.toString(),
+        avatar: (_e = context["avatar"]) === null || _e === void 0 ? void 0 : _e.toString(),
+        country: (_f = context["country"]) === null || _f === void 0 ? void 0 : _f.toString(),
+    };
+    const company = {
+        id: (_g = context["companyId"]) === null || _g === void 0 ? void 0 : _g.toString(),
+        name: (_h = context["companyName"]) === null || _h === void 0 ? void 0 : _h.toString(),
+        avatar: (_j = context["companyAvatar"]) === null || _j === void 0 ? void 0 : _j.toString(),
+        plan: (_k = context["companyPlan"]) === null || _k === void 0 ? void 0 : _k.toString(),
+    };
+    return {
+        user,
+        company,
+    };
+};
+exports.defaultContextTranslator = defaultContextTranslator;
+class ReflagNodeProvider {
+    get client() {
+        return this._client;
+    }
+    constructor(_a) {
+        var { contextTranslator } = _a, opts = __rest(_a, ["contextTranslator"]);
+        this.events = new server_sdk_1.OpenFeatureEventEmitter();
+        this.runsOn = "server";
+        this.status = server_sdk_1.ServerProviderStatus.NOT_READY;
+        this.metadata = {
+            name: "reflag-node",
+        };
+        this._client = new node_sdk_1.ReflagClient(opts);
+        this.contextTranslator = contextTranslator !== null && contextTranslator !== void 0 ? contextTranslator : exports.defaultContextTranslator;
+    }
+    initialize() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this._client.initialize();
+            this.status = server_sdk_1.ServerProviderStatus.READY;
+        });
+    }
+    resolveFlag(flagKey, defaultValue, context, resolveFn) {
+        var _a;
+        if (this.status !== server_sdk_1.ServerProviderStatus.READY) {
+            return Promise.resolve({
+                value: defaultValue,
+                reason: server_sdk_1.StandardResolutionReasons.ERROR,
+                errorCode: server_sdk_1.ErrorCode.PROVIDER_NOT_READY,
+                errorMessage: "Reflag client not initialized",
+            });
+        }
+        if (!((_a = context.user) === null || _a === void 0 ? void 0 : _a.id)) {
+            return Promise.resolve({
+                value: defaultValue,
+                reason: server_sdk_1.StandardResolutionReasons.ERROR,
+                errorCode: server_sdk_1.ErrorCode.INVALID_CONTEXT,
+                errorMessage: "At least a user ID is required",
+            });
+        }
+        const featureDefs = this._client.getFlagDefinitions();
+        if (featureDefs.some(({ key }) => key === flagKey)) {
+            return resolveFn(this._client.getFlag(context, flagKey));
+        }
+        return Promise.resolve({
+            value: defaultValue,
+            reason: server_sdk_1.StandardResolutionReasons.ERROR,
+            errorCode: server_sdk_1.ErrorCode.FLAG_NOT_FOUND,
+            errorMessage: `Flag ${flagKey} not found`,
+        });
+    }
+    resolveBooleanEvaluation(flagKey, defaultValue, context) {
+        return this.resolveFlag(flagKey, defaultValue, this.contextTranslator(context), (feature) => {
+            var _a;
+            return Promise.resolve({
+                value: feature.isEnabled,
+                variant: (_a = feature.config) === null || _a === void 0 ? void 0 : _a.key,
+                reason: server_sdk_1.StandardResolutionReasons.TARGETING_MATCH,
+            });
+        });
+    }
+    resolveStringEvaluation(flagKey, defaultValue, context) {
+        return this.resolveFlag(flagKey, defaultValue, this.contextTranslator(context), (feature) => {
+            if (!feature.config.key) {
+                return Promise.resolve({
+                    value: defaultValue,
+                    reason: server_sdk_1.StandardResolutionReasons.DEFAULT,
+                });
+            }
+            return Promise.resolve({
+                value: feature.config.key,
+                variant: feature.config.key,
+                reason: server_sdk_1.StandardResolutionReasons.TARGETING_MATCH,
+            });
+        });
+    }
+    resolveNumberEvaluation(_flagKey, defaultValue) {
+        return Promise.resolve({
+            value: defaultValue,
+            reason: server_sdk_1.StandardResolutionReasons.ERROR,
+            errorCode: server_sdk_1.ErrorCode.GENERAL,
+            errorMessage: "Reflag doesn't support this method. Use `resolveObjectEvaluation` instead.",
+        });
+    }
+    resolveObjectEvaluation(flagKey, defaultValue, context) {
+        return this.resolveFlag(flagKey, defaultValue, this.contextTranslator(context), (feature) => {
+            const expType = typeof defaultValue;
+            const payloadType = typeof feature.config.payload;
+            if (feature.config.payload === undefined ||
+                feature.config.payload === null ||
+                payloadType !== expType) {
+                return Promise.resolve({
+                    value: defaultValue,
+                    variant: feature.config.key,
+                    reason: server_sdk_1.StandardResolutionReasons.ERROR,
+                    errorCode: server_sdk_1.ErrorCode.TYPE_MISMATCH,
+                    errorMessage: `Expected remote config payload of type \`${expType}\` but got \`${payloadType}\`.`,
+                });
+            }
+            return Promise.resolve({
+                value: feature.config.payload,
+                variant: feature.config.key,
+                reason: server_sdk_1.StandardResolutionReasons.TARGETING_MATCH,
+            });
+        });
+    }
+    track(trackingEventName, context, trackingEventDetails) {
+        var _a, _b, _c, _d;
+        const translatedContext = context
+            ? this.contextTranslator(context)
+            : undefined;
+        const userId = (_a = translatedContext === null || translatedContext === void 0 ? void 0 : translatedContext.user) === null || _a === void 0 ? void 0 : _a.id;
+        if (!userId) {
+            (_b = this._client.logger) === null || _b === void 0 ? void 0 : _b.warn("No user ID provided for tracking event");
+            return;
+        }
+        void this._client.track(String(userId), trackingEventName, {
+            attributes: trackingEventDetails,
+            companyId: (_d = (_c = translatedContext === null || translatedContext === void 0 ? void 0 : translatedContext.company) === null || _c === void 0 ? void 0 : _c.id) === null || _d === void 0 ? void 0 : _d.toString(),
+        });
+    }
+    onClose() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this._client.flush();
+        });
+    }
+}
+exports.ReflagNodeProvider = ReflagNodeProvider;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/index.test.js

@@ -0,0 +1,252 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const server_sdk_1 = require("@openfeature/server-sdk");
+const vitest_1 = require("vitest");
+const node_sdk_1 = require("@reflag/node-sdk");
+const index_1 = require("./index");
+vitest_1.vi.mock("@reflag/node-sdk", () => {
+    const actualModule = vitest_1.vi.importActual("@reflag/node-sdk");
+    return Object.assign(Object.assign({ __esModule: true }, actualModule), { ReflagClient: vitest_1.vi.fn() });
+});
+const reflagClientMock = {
+    getFlag: vitest_1.vi.fn(),
+    getFlagDefinitions: vitest_1.vi.fn().mockReturnValue([]),
+    initialize: vitest_1.vi.fn().mockResolvedValue({}),
+    flush: vitest_1.vi.fn(),
+    track: vitest_1.vi.fn(),
+};
+const secretKey = "sec_fakeSecretKey______"; // must be 23 characters long
+const context = {
+    targetingKey: "abc",
+    name: "John Doe",
+    email: "john@acme.inc",
+};
+const reflagContext = {
+    user: { id: "42" },
+    company: { id: "99" },
+};
+const testFlagKey = "a-key";
+(0, vitest_1.beforeEach)(() => {
+    vitest_1.vi.clearAllMocks();
+});
+(0, vitest_1.describe)("ReflagNodeProvider", () => {
+    let provider;
+    const mockReflagClient = node_sdk_1.ReflagClient;
+    mockReflagClient.mockReturnValue(reflagClientMock);
+    let mockTranslatorFn;
+    function mockFlag(enabled, configKey, configPayload, flagKey = testFlagKey) {
+        const config = {
+            key: configKey,
+            payload: configPayload,
+        };
+        reflagClientMock.getFlag = vitest_1.vi.fn().mockReturnValue({
+            isEnabled: enabled,
+            config,
+        });
+        // Mock getFlagDefinitions to return feature definitions that include the specified flag
+        reflagClientMock.getFlagDefinitions = vitest_1.vi.fn().mockReturnValue([
+            {
+                key: flagKey,
+                description: "Test flag",
+                flag: {},
+                config: {},
+            },
+        ]);
+    }
+    (0, vitest_1.beforeEach)(() => __awaiter(void 0, void 0, void 0, function* () {
+        mockTranslatorFn = vitest_1.vi.fn().mockReturnValue(reflagContext);
+        provider = new index_1.ReflagNodeProvider({
+            secretKey,
+            contextTranslator: mockTranslatorFn,
+        });
+        yield provider.initialize();
+    }));
+    (0, vitest_1.describe)("contextTranslator", () => {
+        (0, vitest_1.it)("defaultContextTranslator provides the correct context", () => __awaiter(void 0, void 0, void 0, function* () {
+            (0, vitest_1.expect)((0, index_1.defaultContextTranslator)({
+                userId: 123,
+                name: "John Doe",
+                email: "ron@reflag.co",
+                avatar: "https://reflag.com/avatar.png",
+                companyId: "456",
+                companyName: "Acme, Inc.",
+                companyAvatar: "https://acme.com/company-avatar.png",
+                companyPlan: "pro",
+            })).toEqual({
+                user: {
+                    id: "123",
+                    name: "John Doe",
+                    email: "ron@reflag.co",
+                    avatar: "https://reflag.com/avatar.png",
+                },
+                company: {
+                    id: "456",
+                    name: "Acme, Inc.",
+                    plan: "pro",
+                    avatar: "https://acme.com/company-avatar.png",
+                },
+            });
+        }));
+        (0, vitest_1.it)("defaultContextTranslator uses targetingKey if provided", () => __awaiter(void 0, void 0, void 0, function* () {
+            (0, vitest_1.expect)((0, index_1.defaultContextTranslator)({
+                targetingKey: "123",
+            })).toMatchObject({
+                user: {
+                    id: "123",
+                },
+                company: {
+                    id: undefined,
+                },
+            });
+        }));
+    });
+    (0, vitest_1.describe)("lifecycle", () => {
+        (0, vitest_1.it)("calls the constructor of ReflagClient", () => {
+            mockReflagClient.mockClear();
+            provider = new index_1.ReflagNodeProvider({
+                secretKey,
+                contextTranslator: mockTranslatorFn,
+            });
+            (0, vitest_1.expect)(mockReflagClient).toHaveBeenCalledTimes(1);
+            (0, vitest_1.expect)(mockReflagClient).toHaveBeenCalledWith({ secretKey });
+        });
+        (0, vitest_1.it)("should set the status to READY if initialization succeeds", () => __awaiter(void 0, void 0, void 0, function* () {
+            provider = new index_1.ReflagNodeProvider({
+                secretKey,
+                contextTranslator: mockTranslatorFn,
+            });
+            yield provider.initialize();
+            (0, vitest_1.expect)(provider.status).toBe(server_sdk_1.ProviderStatus.READY);
+        }));
+        (0, vitest_1.it)("should keep the status as READY after closing", () => __awaiter(void 0, void 0, void 0, function* () {
+            provider = new index_1.ReflagNodeProvider({
+                secretKey: "invalid",
+                contextTranslator: mockTranslatorFn,
+            });
+            yield provider.initialize();
+            yield provider.onClose();
+            (0, vitest_1.expect)(provider.status).toBe(server_sdk_1.ProviderStatus.READY);
+        }));
+        (0, vitest_1.it)("calls flush when provider is closed", () => __awaiter(void 0, void 0, void 0, function* () {
+            yield provider.onClose();
+            (0, vitest_1.expect)(reflagClientMock.flush).toHaveBeenCalledTimes(1);
+        }));
+        (0, vitest_1.it)("uses the contextTranslator function", () => __awaiter(void 0, void 0, void 0, function* () {
+            mockFlag(true);
+            yield provider.resolveBooleanEvaluation(testFlagKey, false, context);
+            (0, vitest_1.expect)(mockTranslatorFn).toHaveBeenCalledTimes(1);
+            (0, vitest_1.expect)(mockTranslatorFn).toHaveBeenCalledWith(context);
+            (0, vitest_1.expect)(reflagClientMock.getFlagDefinitions).toHaveBeenCalledTimes(1);
+            (0, vitest_1.expect)(reflagClientMock.getFlag).toHaveBeenCalledWith(reflagContext, testFlagKey);
+        }));
+    });
+    (0, vitest_1.describe)("resolving flags", () => {
+        (0, vitest_1.beforeEach)(() => __awaiter(void 0, void 0, void 0, function* () {
+            yield provider.initialize();
+        }));
+        (0, vitest_1.it)("returns error if provider is not initialized", () => __awaiter(void 0, void 0, void 0, function* () {
+            provider = new index_1.ReflagNodeProvider({
+                secretKey: "invalid",
+                contextTranslator: mockTranslatorFn,
+            });
+            const val = yield provider.resolveBooleanEvaluation(testFlagKey, true, context);
+            (0, vitest_1.expect)(val).toMatchObject({
+                reason: "ERROR",
+                errorCode: "PROVIDER_NOT_READY",
+                value: true,
+            });
+        }));
+        (0, vitest_1.it)("returns error if flag is not found", () => __awaiter(void 0, void 0, void 0, function* () {
+            mockFlag(true, "key", true);
+            const val = yield provider.resolveBooleanEvaluation("missing-key", true, context);
+            (0, vitest_1.expect)(val).toMatchObject({
+                reason: "ERROR",
+                errorCode: "FLAG_NOT_FOUND",
+                value: true,
+            });
+        }));
+        (0, vitest_1.it)("calls the client correctly when evaluating", () => __awaiter(void 0, void 0, void 0, function* () {
+            mockFlag(true, "key", true);
+            const val = yield provider.resolveBooleanEvaluation(testFlagKey, false, context);
+            (0, vitest_1.expect)(val).toMatchObject({
+                reason: "TARGETING_MATCH",
+                value: true,
+            });
+            (0, vitest_1.expect)(reflagClientMock.getFlagDefinitions).toHaveBeenCalled();
+            (0, vitest_1.expect)(reflagClientMock.getFlag).toHaveBeenCalledWith(reflagContext, testFlagKey);
+        }));
+        vitest_1.it.each([
+            [true, false, true, "TARGETING_MATCH", undefined],
+            [undefined, true, true, "ERROR", "FLAG_NOT_FOUND"],
+            [undefined, false, false, "ERROR", "FLAG_NOT_FOUND"],
+        ])("should return the correct result when evaluating boolean. enabled: %s, value: %s, default: %s, expected: %s, reason: %s, errorCode: %s`", (enabled, def, expected, reason, errorCode) => __awaiter(void 0, void 0, void 0, function* () {
+            const configKey = enabled !== undefined ? "variant-1" : undefined;
+            mockFlag(enabled !== null && enabled !== void 0 ? enabled : false, configKey);
+            const flagKey = enabled ? testFlagKey : "missing-key";
+            (0, vitest_1.expect)(yield provider.resolveBooleanEvaluation(flagKey, def, context)).toMatchObject(Object.assign(Object.assign({ reason, value: expected }, (configKey ? { variant: configKey } : {})), (errorCode ? { errorCode } : {})));
+        }));
+        (0, vitest_1.it)("should return error when context is missing user ID", () => __awaiter(void 0, void 0, void 0, function* () {
+            mockTranslatorFn.mockReturnValue({ user: {} });
+            (0, vitest_1.expect)(yield provider.resolveBooleanEvaluation(testFlagKey, true, context)).toMatchObject({
+                reason: "ERROR",
+                errorCode: "INVALID_CONTEXT",
+                value: true,
+            });
+        }));
+        (0, vitest_1.it)("should return error when evaluating number", () => __awaiter(void 0, void 0, void 0, function* () {
+            (0, vitest_1.expect)(yield provider.resolveNumberEvaluation(testFlagKey, 1)).toMatchObject({
+                reason: "ERROR",
+                errorCode: "GENERAL",
+                value: 1,
+            });
+        }));
+        vitest_1.it.each([
+            ["key-1", "default", "key-1", "TARGETING_MATCH"],
+            [null, "default", "default", "DEFAULT"],
+            [undefined, "default", "default", "DEFAULT"],
+        ])("should return the correct result when evaluating string. variant: %s, def: %s, expected: %s, reason: %s, errorCode: %s`", (variant, def, expected, reason) => __awaiter(void 0, void 0, void 0, function* () {
+            mockFlag(true, variant, {});
+            (0, vitest_1.expect)(yield provider.resolveStringEvaluation(testFlagKey, def, context)).toMatchObject(Object.assign({ reason, value: expected }, (variant ? { variant } : {})));
+        }));
+        vitest_1.it.each([
+            [{}, { a: 1 }, {}, "TARGETING_MATCH", undefined],
+            ["string", "default", "string", "TARGETING_MATCH", undefined],
+            [15, -15, 15, "TARGETING_MATCH", undefined],
+            [true, false, true, "TARGETING_MATCH", undefined],
+            [null, { a: 2 }, { a: 2 }, "ERROR", "TYPE_MISMATCH"],
+            [100, "string", "string", "ERROR", "TYPE_MISMATCH"],
+            [true, 1337, 1337, "ERROR", "TYPE_MISMATCH"],
+            ["string", 1337, 1337, "ERROR", "TYPE_MISMATCH"],
+            [undefined, "default", "default", "ERROR", "TYPE_MISMATCH"],
+        ])("should return the correct result when evaluating object. payload: %s, default: %s, expected: %s, reason: %s, errorCode: %s`", (value, def, expected, reason, errorCode) => __awaiter(void 0, void 0, void 0, function* () {
+            const configKey = value === undefined ? undefined : "config-key";
+            mockFlag(true, configKey, value);
+            (0, vitest_1.expect)(yield provider.resolveObjectEvaluation(testFlagKey, def, context)).toMatchObject(Object.assign({ reason, value: expected }, (errorCode ? { errorCode, variant: configKey } : {})));
+        }));
+    });
+    (0, vitest_1.describe)("track", () => {
+        (0, vitest_1.it)("should track", () => __awaiter(void 0, void 0, void 0, function* () {
+            (0, vitest_1.expect)(mockTranslatorFn).toHaveBeenCalledTimes(0);
+            provider.track("event", context, {
+                action: "click",
+            });
+            (0, vitest_1.expect)(mockTranslatorFn).toHaveBeenCalledTimes(1);
+            (0, vitest_1.expect)(mockTranslatorFn).toHaveBeenCalledWith(context);
+            (0, vitest_1.expect)(reflagClientMock.track).toHaveBeenCalledTimes(1);
+            (0, vitest_1.expect)(reflagClientMock.track).toHaveBeenCalledWith("42", "event", {
+                attributes: { action: "click" },
+                companyId: reflagContext.company.id,
+            });
+        }));
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/index.test.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,27 @@
+import { EvaluationContext, JsonValue, OpenFeatureEventEmitter, Paradigm, Provider, ResolutionDetails, ServerProviderStatus, TrackingEventDetails } from "@openfeature/server-sdk";
+import { ClientOptions, Context as ReflagContext, ReflagClient } from "@reflag/node-sdk";
+type ProviderOptions = ClientOptions & {
+    contextTranslator?: (context: EvaluationContext) => ReflagContext;
+};
+export declare const defaultContextTranslator: (context: EvaluationContext) => ReflagContext;
+export declare class ReflagNodeProvider implements Provider {
+    readonly events: OpenFeatureEventEmitter;
+    private _client;
+    private contextTranslator;
+    runsOn: Paradigm;
+    status: ServerProviderStatus;
+    metadata: {
+        name: string;
+    };
+    get client(): ReflagClient;
+    constructor({ contextTranslator, ...opts }: ProviderOptions);
+    initialize(): Promise<void>;
+    private resolveFlag;
+    resolveBooleanEvaluation(flagKey: string, defaultValue: boolean, context: EvaluationContext): Promise<ResolutionDetails<boolean>>;
+    resolveStringEvaluation(flagKey: string, defaultValue: string, context: EvaluationContext): Promise<ResolutionDetails<string>>;
+    resolveNumberEvaluation(_flagKey: string, defaultValue: number): Promise<ResolutionDetails<number>>;
+    resolveObjectEvaluation<T extends JsonValue>(flagKey: string, defaultValue: T, context: EvaluationContext): Promise<ResolutionDetails<T>>;
+    track(trackingEventName: string, context?: EvaluationContext, trackingEventDetails?: TrackingEventDetails): void;
+    onClose(): Promise<void>;
+}
+export {};

package/dist/types/index.test.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@reflag/openfeature-node-provider",
+  "version": "1.0.0-alpha.1",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/reflagcom/javascript.git"
+  },
+  "scripts": {
+    "dev": "vite",
+    "start": "vite",
+    "build": "tsc --project tsconfig.build.json",
+    "test": "vitest -c vite.config.js",
+    "test:ci": "vitest run -c vite.config.js --reporter=default --reporter=junit --outputFile=junit.xml",
+    "coverage": "vitest run --coverage",
+    "lint": "eslint .",
+    "lint:ci": "eslint --output-file eslint-report.json --format json .",
+    "prettier": "prettier --check .",
+    "format": "yarn lint --fix && yarn prettier --write",
+    "preversion": "yarn lint && yarn prettier && yarn vitest run -c vite.config.js && yarn build"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "require": "./dist/index.js"
+    }
+  },
+  "devDependencies": {
+    "@babel/core": "~7.24.7",
+    "@openfeature/core": "^1.5.0",
+    "@openfeature/server-sdk": ">=1.16.1",
+    "@reflag/eslint-config": "~0.0.2",
+    "@reflag/tsconfig": "~0.0.2",
+    "@types/node": "^22.12.0",
+    "eslint": "^9.21.0",
+    "flush-promises": "~1.0.2",
+    "prettier": "^3.5.2",
+    "ts-node": "~10.9.2",
+    "typescript": "^5.7.3",
+    "vite": "~5.4.18",
+    "vite-plugin-dts": "~3.9.1",
+    "vitest": "~1.6.0"
+  },
+  "dependencies": {
+    "@reflag/node-sdk": "1.0.0-alpha.1"
+  },
+  "peerDependencies": {
+    "@openfeature/server-sdk": ">=1.16.1"
+  },
+  "gitHead": "d70378c8d717b140cfbaf5f05ec018d60fc26724"
+}