@featbit/openfeature-provider-node-server 1.2.0 → 1.2.2

package/dist/FbProvider.d.ts

@@ -0,0 +1,84 @@
+import { EvaluationContext, Hook, JsonValue, OpenFeatureEventEmitter, Provider, ProviderStatus, ResolutionDetails } from "@openfeature/server-sdk";
+import { IFbClient, IOptions } from "@featbit/node-server-sdk";
+/**
+ * An OpenFeature provider for the FeatBit SDK for node.
+ */
+export declare class FbProvider implements Provider {
+    metadata: {
+        name: string;
+    };
+    private readonly logger;
+    private readonly client;
+    private readonly clientConstructionError;
+    private innerStatus;
+    readonly events: OpenFeatureEventEmitter;
+    /**
+     * Construct a {@link FbProvider}.
+     * @param options The {@link IOptions} to initialize the FeatBit client instance.
+     */
+    constructor(options: IOptions);
+    initialize(context?: EvaluationContext): Promise<void>;
+    /**
+     * Determines the boolean variation of a feature flag for a context, along with information about
+     * how it was calculated.
+     *
+     * If the flag does not evaluate to a boolean value, then the defaultValue will be returned.
+     *
+     * @param flagKey The unique key of the feature flag.
+     * @param defaultValue The default value of the flag, to be used if the value is not available
+     *   from FeatBit.
+     * @param context The context requesting the flag.
+     * @returns A promise which will resolve to a ResolutionDetails.
+     */
+    resolveBooleanEvaluation(flagKey: string, defaultValue: boolean, context: EvaluationContext): Promise<ResolutionDetails<boolean>>;
+    /**
+     * Determines the string variation of a feature flag for a context, along with information about
+     * how it was calculated.
+     *
+     * If the flag does not evaluate to a string value, then the defaultValue will be returned.
+     *
+     * @param flagKey The unique key of the feature flag.
+     * @param defaultValue The default value of the flag, to be used if the value is not available
+     *   from FeatBit.
+     * @param context The context requesting the flag.
+     * @returns A promise which will resolve to a ResolutionDetails.
+     */
+    resolveStringEvaluation(flagKey: string, defaultValue: string, context: EvaluationContext): Promise<ResolutionDetails<string>>;
+    /**
+     * Determines the numeric variation of a feature flag for a context, along with information about
+     * how it was calculated.
+     *
+     * If the flag does not evaluate to a numeric value, then the defaultValue will be returned.
+     *
+     * @param flagKey The unique key of the feature flag.
+     * @param defaultValue The default value of the flag, to be used if the value is not available
+     *   from FeatBit.
+     * @param context The context requesting the flag.
+     * @returns A promise which will resolve to a ResolutionDetails.
+     */
+    resolveNumberEvaluation(flagKey: string, defaultValue: number, context: EvaluationContext): Promise<ResolutionDetails<number>>;
+    /**
+     * Determines the object variation of a feature flag for a context, along with information about
+     * how it was calculated.
+     *
+     * @param flagKey The unique key of the feature flag.
+     * @param defaultValue The default value of the flag, to be used if the value is not available
+     *   from FeatBit.
+     * @param context The context requesting the flag.
+     * @returns A promise which will resolve to a ResolutionDetails.
+     */
+    resolveObjectEvaluation<T extends JsonValue>(flagKey: string, defaultValue: T, context: EvaluationContext): Promise<ResolutionDetails<T>>;
+    /**
+     * Get the status of the FeatBit provider.
+     */
+    get status(): ProviderStatus;
+    get hooks(): Hook[];
+    /**
+     * Get the IFbClientWithEvents instance used by this provider.
+     *
+     * @returns The client for this provider.
+     */
+    getClient(): IFbClient;
+    onClose(): Promise<void>;
+}
+//# sourceMappingURL=FbProvider.d.ts.map

package/dist/FbProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FbProvider.d.ts","sourceRoot":"","sources":["../src/FbProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,IAAI,EACJ,SAAS,EACT,uBAAuB,EACvB,QAAQ,EAER,cAAc,EACd,iBAAiB,EAClB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAIL,SAAS,EACT,QAAQ,EACT,MAAM,0BAA0B,CAAC;AAMlC;;GAEG;AACH,qBAAa,UAAW,YAAW,QAAQ;IACzC,QAAQ;;MAEN;IAEF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAM;IAC9C,OAAO,CAAC,WAAW,CAA4C;IAE/D,SAAgB,MAAM,0BAAiC;IAEvD;;;OAGG;gBACS,OAAO,EAAE,QAAQ;IAmBvB,UAAU,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB5D;;;;;;;;;;;OAWG;IACG,wBAAwB,CAC5B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,OAAO,EACrB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAUtC;;;;;;;;;;;OAWG;IACG,uBAAuB,CAC3B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAUrC;;;;;;;;;;;OAWG;IACG,uBAAuB,CAC3B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAUrC;;;;;;;;;OASG;IACG,uBAAuB,CAAC,CAAC,SAAS,SAAS,EAC/C,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,CAAC,EACf,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAUhC;;OAEG;IACH,IAAW,MAAM,mBAEhB;IAED,IAAI,KAAK,IAAI,IAAI,EAAE,CAElB;IAED;;;;OAIG;IACI,SAAS;IAIV,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B"}

package/dist/FbProvider.js

@@ -0,0 +1,166 @@
+"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 __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FbProvider = void 0;
+const server_sdk_1 = require("@openfeature/server-sdk");
+const node_server_sdk_1 = require("@featbit/node-server-sdk");
+const SafeLogger_1 = __importDefault(require("./SafeLogger"));
+const translateContext_1 = require("./translateContext");
+const translateResult_1 = require("./translateResult");
+/**
+ * An OpenFeature provider for the FeatBit SDK for node.
+ */
+class FbProvider {
+    /**
+     * Construct a {@link FbProvider}.
+     * @param options The {@link IOptions} to initialize the FeatBit client instance.
+     */
+    constructor(options) {
+        this.metadata = {
+            name: 'featbit-node-provider',
+        };
+        this.innerStatus = server_sdk_1.ProviderStatus.NOT_READY;
+        this.events = new server_sdk_1.OpenFeatureEventEmitter();
+        if (options.logger) {
+            this.logger = new SafeLogger_1.default(options.logger, new node_server_sdk_1.BasicLogger({ level: 'info' }));
+        }
+        else {
+            this.logger = new node_server_sdk_1.BasicLogger({ level: 'info' });
+        }
+        try {
+            this.client = new node_server_sdk_1.FbClientBuilder(options).build();
+            this.client.on('update', (keys) => {
+                this.events.emit(server_sdk_1.ProviderEvents.ConfigurationChanged, { flagsChanged: keys });
+            });
+        }
+        catch (err) {
+            this.clientConstructionError = err;
+            this.logger.error(`Encountered unrecoverable initialization error, ${err}`);
+            this.innerStatus = server_sdk_1.ProviderStatus.ERROR;
+        }
+    }
+    initialize(context) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.client) {
+                // The client could not be constructed.
+                if (this.clientConstructionError) {
+                    throw this.clientConstructionError;
+                }
+                throw new Error('Unknown problem encountered during initialization');
+            }
+            try {
+                yield this.client.waitForInitialization();
+                this.innerStatus = server_sdk_1.ProviderStatus.READY;
+            }
+            catch (e) {
+                this.innerStatus = server_sdk_1.ProviderStatus.ERROR;
+                throw e;
+            }
+        });
+    }
+    /**
+     * Determines the boolean variation of a feature flag for a context, along with information about
+     * how it was calculated.
+     *
+     * If the flag does not evaluate to a boolean value, then the defaultValue will be returned.
+     *
+     * @param flagKey The unique key of the feature flag.
+     * @param defaultValue The default value of the flag, to be used if the value is not available
+     *   from FeatBit.
+     * @param context The context requesting the flag.
+     * @returns A promise which will resolve to a ResolutionDetails.
+     */
+    resolveBooleanEvaluation(flagKey, defaultValue, context) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const res = yield this.client.boolVariationDetail(flagKey, (0, translateContext_1.translateContext)(this.logger, context), defaultValue);
+            return Promise.resolve((0, translateResult_1.translateResult)(res));
+        });
+    }
+    /**
+     * Determines the string variation of a feature flag for a context, along with information about
+     * how it was calculated.
+     *
+     * If the flag does not evaluate to a string value, then the defaultValue will be returned.
+     *
+     * @param flagKey The unique key of the feature flag.
+     * @param defaultValue The default value of the flag, to be used if the value is not available
+     *   from FeatBit.
+     * @param context The context requesting the flag.
+     * @returns A promise which will resolve to a ResolutionDetails.
+     */
+    resolveStringEvaluation(flagKey, defaultValue, context) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const res = yield this.client.stringVariationDetail(flagKey, (0, translateContext_1.translateContext)(this.logger, context), defaultValue);
+            return Promise.resolve((0, translateResult_1.translateResult)(res));
+        });
+    }
+    /**
+     * Determines the numeric variation of a feature flag for a context, along with information about
+     * how it was calculated.
+     *
+     * If the flag does not evaluate to a numeric value, then the defaultValue will be returned.
+     *
+     * @param flagKey The unique key of the feature flag.
+     * @param defaultValue The default value of the flag, to be used if the value is not available
+     *   from FeatBit.
+     * @param context The context requesting the flag.
+     * @returns A promise which will resolve to a ResolutionDetails.
+     */
+    resolveNumberEvaluation(flagKey, defaultValue, context) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const res = yield this.client.numberVariationDetail(flagKey, (0, translateContext_1.translateContext)(this.logger, context), defaultValue);
+            return Promise.resolve((0, translateResult_1.translateResult)(res));
+        });
+    }
+    /**
+     * Determines the object variation of a feature flag for a context, along with information about
+     * how it was calculated.
+     *
+     * @param flagKey The unique key of the feature flag.
+     * @param defaultValue The default value of the flag, to be used if the value is not available
+     *   from FeatBit.
+     * @param context The context requesting the flag.
+     * @returns A promise which will resolve to a ResolutionDetails.
+     */
+    resolveObjectEvaluation(flagKey, defaultValue, context) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const res = yield this.client.jsonVariationDetail(flagKey, (0, translateContext_1.translateContext)(this.logger, context), defaultValue);
+            return Promise.resolve((0, translateResult_1.translateResult)(res));
+        });
+    }
+    /**
+     * Get the status of the FeatBit provider.
+     */
+    get status() {
+        return this.innerStatus;
+    }
+    get hooks() {
+        return [];
+    }
+    /**
+     * Get the IFbClientWithEvents instance used by this provider.
+     *
+     * @returns The client for this provider.
+     */
+    getClient() {
+        return this.client;
+    }
+    onClose() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.client.close();
+        });
+    }
+}
+exports.FbProvider = FbProvider;
+//# sourceMappingURL=FbProvider.js.map

package/dist/FbProvider.js.map

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

package/dist/SafeLogger.d.ts

@@ -0,0 +1,28 @@
+import { ILogger } from "@featbit/node-server-sdk";
+/**
+ * The safeLogger logic exists because we allow the application to pass in a custom logger, but
+ * there is no guarantee that the logger works correctly and if it ever throws exceptions there
+ * could be serious consequences (e.g. an uncaught exception within an error event handler, due
+ * to the provider trying to log the error, can terminate the application). An exception could
+ * result from faulty logic in the logger implementation, or it could be that this is not a logger
+ * at all but some other kind of object; the former is handled by a catch block that logs an error
+ * message to the provider's default logger, and we can at least partly guard against the latter by
+ * checking for the presence of required methods at configuration time.
+ */
+export default class SafeLogger implements ILogger {
+    private logger;
+    private fallback;
+    /**
+     * Construct a safe logger with the specified logger.
+     * @param logger The logger to use.
+     * @param fallback A fallback logger to use in case an issue is  encountered using
+     * the provided logger.
+     */
+    constructor(logger: ILogger, fallback: ILogger);
+    private log;
+    error(...args: any[]): void;
+    warn(...args: any[]): void;
+    info(...args: any[]): void;
+    debug(...args: any[]): void;
+}
+//# sourceMappingURL=SafeLogger.d.ts.map

package/dist/SafeLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SafeLogger.d.ts","sourceRoot":"","sources":["../src/SafeLogger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAOnD;;;;;;;;;GASG;AACH,MAAM,CAAC,OAAO,OAAO,UAAW,YAAW,OAAO;IAChD,OAAO,CAAC,MAAM,CAAU;IAExB,OAAO,CAAC,QAAQ,CAAU;IAE1B;;;;;OAKG;gBACS,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO;IAc9C,OAAO,CAAC,GAAG;IASX,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAI3B,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAI1B,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAI1B,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;CAG5B"}

package/dist/SafeLogger.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Logging levels. Each should correspond to a method on the logger.
+ */
+const LEVELS = ['error', 'warn', 'info', 'debug'];
+/**
+ * The safeLogger logic exists because we allow the application to pass in a custom logger, but
+ * there is no guarantee that the logger works correctly and if it ever throws exceptions there
+ * could be serious consequences (e.g. an uncaught exception within an error event handler, due
+ * to the provider trying to log the error, can terminate the application). An exception could
+ * result from faulty logic in the logger implementation, or it could be that this is not a logger
+ * at all but some other kind of object; the former is handled by a catch block that logs an error
+ * message to the provider's default logger, and we can at least partly guard against the latter by
+ * checking for the presence of required methods at configuration time.
+ */
+class SafeLogger {
+    /**
+     * Construct a safe logger with the specified logger.
+     * @param logger The logger to use.
+     * @param fallback A fallback logger to use in case an issue is  encountered using
+     * the provided logger.
+     */
+    constructor(logger, fallback) {
+        LEVELS.forEach((level) => {
+            if (!logger[level] || typeof logger[level] !== 'function') {
+                throw new Error(`Provided logger instance must support logger.${level}(...) method`);
+                // Note that the provider normally does not throw exceptions to the application, but that
+                // rule does not apply to the constructor which will throw an exception if the parameters
+                // are so invalid that we cannot proceed with creating the client. An invalid logger meets
+                // those criteria since the SDK calls the logger during nearly all of its operations.
+            }
+        });
+        this.logger = logger;
+        this.fallback = fallback;
+    }
+    log(level, args) {
+        try {
+            this.logger[level](...args);
+        }
+        catch (_a) {
+            // If all else fails do not break.
+            this.fallback[level](...args);
+        }
+    }
+    error(...args) {
+        this.log('error', args);
+    }
+    warn(...args) {
+        this.log('warn', args);
+    }
+    info(...args) {
+        this.log('info', args);
+    }
+    debug(...args) {
+        this.log('debug', args);
+    }
+}
+exports.default = SafeLogger;
+//# sourceMappingURL=SafeLogger.js.map

package/dist/SafeLogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SafeLogger.js","sourceRoot":"","sources":["../src/SafeLogger.ts"],"names":[],"mappings":";;AAEA;;GAEG;AACH,MAAM,MAAM,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAElD;;;;;;;;;GASG;AACH,MAAqB,UAAU;IAK7B;;;;;OAKG;IACH,YAAY,MAAe,EAAE,QAAiB;QAC5C,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YACvB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,UAAU,EAAE,CAAC;gBAC1D,MAAM,IAAI,KAAK,CAAC,gDAAgD,KAAK,cAAc,CAAC,CAAC;gBACrF,yFAAyF;gBACzF,yFAAyF;gBACzF,0FAA0F;gBAC1F,qFAAqF;YACvF,CAAC;QACH,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAEO,GAAG,CAAC,KAA0C,EAAE,IAAW;QACjE,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAC9B,CAAC;QAAC,WAAM,CAAC;YACP,kCAAkC;YAClC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG,IAAW;QAClB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,IAAI,CAAC,GAAG,IAAW;QACjB,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACzB,CAAC;IAED,IAAI,CAAC,GAAG,IAAW;QACjB,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,GAAG,IAAW;QAClB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF;AAjDD,6BAiDC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import { FbProvider } from "./FbProvider";
+export { FbProvider };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,OAAO,EACH,UAAU,EACb,CAAA"}

package/dist/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FbProvider = void 0;
+const FbProvider_1 = require("./FbProvider");
+Object.defineProperty(exports, "FbProvider", { enumerable: true, get: function () { return FbProvider_1.FbProvider; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,6CAA0C;AAItC,2FAJK,uBAAU,OAIL"}

package/dist/translateContext.d.ts

@@ -0,0 +1,4 @@
+import { IUser, ILogger } from "@featbit/node-server-sdk";
+import { EvaluationContext } from "@openfeature/server-sdk";
+export declare function translateContext(logger: ILogger, evalContext: EvaluationContext): IUser;
+//# sourceMappingURL=translateContext.d.ts.map

package/dist/translateContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translateContext.d.ts","sourceRoot":"","sources":["../src/translateContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAiC,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACzF,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAI5D,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,iBAAiB,GAAG,KAAK,CAkCvF"}

package/dist/translateContext.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.translateContext = translateContext;
+const node_server_sdk_1 = require("@featbit/node-server-sdk");
+const builtInKeys = ['key', 'name', 'custom', 'targetingKey'];
+function translateContext(logger, evalContext) {
+    const custom = (evalContext.custom || []);
+    const name = evalContext.name || '';
+    const key = evalContext.targetingKey || evalContext.key || '';
+    if (key === '') {
+        logger.error("The EvaluationContext must contain either a 'targetingKey' or a 'key' and the "
+            + 'type must be a string.');
+    }
+    const builder = new node_server_sdk_1.UserBuilder(key)
+        .name(name);
+    if (custom) {
+        if (Array.isArray(custom)) {
+            custom.forEach(({ name, value }) => {
+                builder.custom(name, value);
+            });
+        }
+        else if (typeof custom === 'object') {
+            Object.entries(custom).forEach(([key, value]) => {
+                builder.custom(key, value);
+            });
+        }
+    }
+    Object.entries(evalContext).forEach(([key, value]) => {
+        if (builtInKeys.includes(key)) {
+            return;
+        }
+        builder.custom(key, value);
+    });
+    return builder.build();
+}
+//# sourceMappingURL=translateContext.js.map

package/dist/translateContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translateContext.js","sourceRoot":"","sources":["../src/translateContext.ts"],"names":[],"mappings":";;AAKA,4CAkCC;AAvCD,8DAAyF;AAGzF,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;AAE9D,SAAgB,gBAAgB,CAAC,MAAe,EAAE,WAA8B;IAC9E,MAAM,MAAM,GAAuB,CAAC,WAAW,CAAC,MAAM,IAAI,EAAE,CAAkC,CAAC;IAC/F,MAAM,IAAI,GAAW,WAAW,CAAC,IAAc,IAAI,EAAE,CAAC;IACtD,MAAM,GAAG,GAAW,WAAW,CAAC,YAAY,IAAI,WAAW,CAAC,GAAa,IAAI,EAAE,CAAC;IAEhF,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,gFAAgF;cACzF,wBAAwB,CAAC,CAAC;IAChC,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,6BAAW,CAAC,GAAG,CAAC;SACjC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,IAAI,MAAM,EAAE,CAAC;QACX,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;gBACjC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC9B,CAAC,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YACtC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;gBAC9C,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,KAAsB,CAAC,CAAC;YAC9C,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QACnD,IAAI,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC9B,OAAO;QACT,CAAC;QAED,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,KAAe,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC,KAAK,EAAE,CAAC;AACzB,CAAC"}

package/dist/translateResult.d.ts

@@ -0,0 +1,4 @@
+import { ResolutionDetails } from "@openfeature/server-sdk";
+import { IEvalDetail } from "@featbit/node-server-sdk";
+export declare function translateResult<T>(result: IEvalDetail<T>): ResolutionDetails<T>;
+//# sourceMappingURL=translateResult.d.ts.map

package/dist/translateResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translateResult.d.ts","sourceRoot":"","sources":["../src/translateResult.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,iBAAiB,EAA6B,MAAM,yBAAyB,CAAC;AAClG,OAAO,EAAe,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAiBpE,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAuB/E"}

package/dist/translateResult.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.translateResult = translateResult;
+const server_sdk_1 = require("@openfeature/server-sdk");
+const node_server_sdk_1 = require("@featbit/node-server-sdk");
+/**
+ * Create a ResolutionDetails for an evaluation that produced a type different
+ * than the expected type.
+ * @param value The default value to populate the ResolutionDetails with.
+ * @returns A ResolutionDetails with the default value.
+ */
+function errorResult(value, errorCode, errorMessage) {
+    return {
+        value,
+        reason: server_sdk_1.StandardResolutionReasons.ERROR,
+        errorCode,
+        errorMessage
+    };
+}
+function translateResult(result) {
+    if (result.kind === node_server_sdk_1.ReasonKinds.WrongType) {
+        return errorResult(result.value, server_sdk_1.ErrorCode.TYPE_MISMATCH, result.reason);
+    }
+    if (result.kind === node_server_sdk_1.ReasonKinds.FlagNotFound) {
+        return errorResult(result.value, server_sdk_1.ErrorCode.FLAG_NOT_FOUND, result.reason);
+    }
+    if (result.kind === node_server_sdk_1.ReasonKinds.Error) {
+        return errorResult(result.value, server_sdk_1.ErrorCode.GENERAL, result.reason);
+    }
+    if (result.kind === node_server_sdk_1.ReasonKinds.ClientNotReady) {
+        return errorResult(result.value, server_sdk_1.ErrorCode.PROVIDER_NOT_READY, result.reason);
+    }
+    const resolution = {
+        value: result.value,
+        reason: result.kind,
+    };
+    return resolution;
+}
+//# sourceMappingURL=translateResult.js.map

package/dist/translateResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translateResult.js","sourceRoot":"","sources":["../src/translateResult.ts"],"names":[],"mappings":";;AAkBA,0CAuBC;AAzCD,wDAAkG;AAClG,8DAAoE;AAEpE;;;;;GAKG;AACH,SAAS,WAAW,CAAI,KAAQ,EAAE,SAAoB,EAAE,YAAqB;IAC3E,OAAO;QACL,KAAK;QACL,MAAM,EAAE,sCAAyB,CAAC,KAAK;QACvC,SAAS;QACT,YAAY;KACb,CAAC;AACJ,CAAC;AAED,SAAgB,eAAe,CAAI,MAAsB;IACvD,IAAI,MAAM,CAAC,IAAI,KAAK,6BAAW,CAAC,SAAS,EAAE,CAAC;QAC1C,OAAO,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,sBAAS,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3E,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,6BAAW,CAAC,YAAY,EAAE,CAAC;QAC7C,OAAO,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,sBAAS,CAAC,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5E,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,6BAAW,CAAC,KAAK,EAAE,CAAC;QACtC,OAAO,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,sBAAS,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACrE,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,6BAAW,CAAC,cAAc,EAAE,CAAC;QAC/C,OAAO,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,sBAAS,CAAC,kBAAkB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAChF,CAAC;IAED,MAAM,UAAU,GAAyB;QACvC,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,IAAI;KACpB,CAAC;IAEF,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@featbit/openfeature-provider-node-server",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "A OpenFeature provider implementation for the FeatBit node SDK",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -13,6 +13,10 @@
     "type": "git",
     "url": "git+https://github.com/featbit/openfeature-provider-node-server.git"
   },
+  "files": [
+    "dist",
+    "src"
+  ],
   "keywords": [],
   "author": "",
   "license": "ISC",
@@ -22,15 +26,16 @@
   "homepage": "https://github.com/featbit/openfeature-provider-node-server#readme",
   "peerDependencies": {
     "@featbit/node-server-sdk": "^1.3.0",
-    "@openfeature/server-sdk": "1.9.0"
+    "@openfeature/server-sdk": "^1.20.0"
   },
   "devDependencies": {
     "@featbit/node-server-sdk": "^1.3.0",
-    "@openfeature/server-sdk": "1.9.0",
-    "@types/jest": "^29.5.11",
-    "jest": "^29.7.0",
-    "rimraf": "^5.0.5",
-    "ts-jest": "^29.1.1",
-    "typescript": "^5.3.3"
+    "@openfeature/server-sdk": "^1.20.0",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^20.11.0",
+    "jest": "^30.2.0",
+    "rimraf": "^6.1.2",
+    "ts-jest": "^29.4.6",
+    "typescript": "^5.5.0"
   }
 }

package/.github/workflows/publish-npm.yml

@@ -1,24 +0,0 @@
-name: Publish Package to npmjs
-on:
-  workflow_dispatch:
-  release:
-    types: [published]
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      # Setup .npmrc file to publish to npm
-      - uses: actions/setup-node@v3
-        with:
-          node-version: '20.x'
-          registry-url: 'https://registry.npmjs.org'
-
-      - run: npm ci
-
-      - run: npm test
-
-      - run: npm publish --access=public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/examples/console-app/README.md

@@ -1,25 +0,0 @@
-# Console example for @featbit/openfeature-provider-node-server
-
-## Introduction
-The current example APP contains two files in src folder:
-- `esm.ts`: example for using ES module and typescript.
-- `commonjs.cjs`: example for using commonjs.
-
-
-## Get started
-
-```bash
-npm install
-```
-
-### ES module
-
-```bash
-npm run esm
-```
-
-### CommonJs
-
-```bash
-npm run cjs
-```