flagsmith-nodejs 2.0.0-beta.3 → 2.0.0-beta.6

package/build/sdk/analytics.js

@@ -0,0 +1,103 @@
+"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 __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (_) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnalyticsProcessor = void 0;
+var node_fetch_1 = __importDefault(require("node-fetch"));
+var ANALYTICS_ENDPOINT = 'analytics/flags/';
+// Used to control how often we send data(in seconds)
+var ANALYTICS_TIMER = 10;
+var delay = function (ms) { return new Promise(function (resolve) { return setTimeout(function () { return resolve(undefined); }, ms); }); };
+var AnalyticsProcessor = /** @class */ (function () {
+    /**
+     * AnalyticsProcessor is used to track how often individual Flags are evaluated within
+     * the Flagsmith SDK. Docs: https://docs.flagsmith.com/advanced-use/flag-analytics.
+     *
+     * @param data.environmentKey environment key obtained from the Flagsmith UI
+     * @param data.baseApiUrl base api url to override when using self hosted version
+     * @param data.timeout used to tell requests to stop waiting for a response after a
+            given number of seconds
+     */
+    function AnalyticsProcessor(data) {
+        this.timeout = 3;
+        this.analyticsEndpoint = data.baseApiUrl + ANALYTICS_ENDPOINT;
+        this.environmentKey = data.environmentKey;
+        this.lastFlushed = Date.now();
+        this.analyticsData = {};
+        this.timeout = data.timeout || this.timeout;
+    }
+    /**
+     * Sends all the collected data to the api asynchronously and resets the timer
+     */
+    AnalyticsProcessor.prototype.flush = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (!Object.keys(this.analyticsData).length) {
+                            return [2 /*return*/];
+                        }
+                        return [4 /*yield*/, (0, node_fetch_1.default)(this.analyticsEndpoint, {
+                                method: 'POST',
+                                body: JSON.stringify(this.analyticsData),
+                                timeout: this.timeout,
+                                headers: {
+                                    'Content-Type': 'application/json',
+                                    'X-Environment-Key': this.environmentKey
+                                }
+                            })];
+                    case 1:
+                        _a.sent();
+                        this.analyticsData = {};
+                        this.lastFlushed = Date.now();
+                        return [2 /*return*/];
+                }
+            });
+        });
+    };
+    AnalyticsProcessor.prototype.trackFeature = function (featureId) {
+        this.analyticsData[featureId] = (this.analyticsData[featureId] || 0) + 1;
+        if (Date.now() - this.lastFlushed > ANALYTICS_TIMER * 1000) {
+            this.flush();
+        }
+    };
+    return AnalyticsProcessor;
+}());
+exports.AnalyticsProcessor = AnalyticsProcessor;

package/build/sdk/errors.d.ts

@@ -0,0 +1,4 @@
+export declare class FlagsmithClientError extends Error {
+}
+export declare class FlagsmithAPIError extends Error {
+}

package/build/sdk/errors.js

@@ -0,0 +1,34 @@
+"use strict";
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlagsmithAPIError = exports.FlagsmithClientError = void 0;
+var FlagsmithClientError = /** @class */ (function (_super) {
+    __extends(FlagsmithClientError, _super);
+    function FlagsmithClientError() {
+        return _super !== null && _super.apply(this, arguments) || this;
+    }
+    return FlagsmithClientError;
+}(Error));
+exports.FlagsmithClientError = FlagsmithClientError;
+var FlagsmithAPIError = /** @class */ (function (_super) {
+    __extends(FlagsmithAPIError, _super);
+    function FlagsmithAPIError() {
+        return _super !== null && _super.apply(this, arguments) || this;
+    }
+    return FlagsmithAPIError;
+}(Error));
+exports.FlagsmithAPIError = FlagsmithAPIError;

package/build/sdk/index.d.ts

@@ -0,0 +1,118 @@
+import { EnvironmentModel } from '../flagsmith-engine/environments/models';
+import { DefaultFlag, Flags } from './models';
+import { EnvironmentDataPollingManager } from './polling_manager';
+import { SegmentModel } from '../flagsmith-engine/segments/models';
+export declare class Flagsmith {
+    environmentKey?: string;
+    apiUrl: string;
+    customHeaders?: {
+        [key: string]: any;
+    };
+    requestTimeoutSeconds?: number;
+    enableLocalEvaluation?: boolean;
+    environmentRefreshIntervalSeconds: number;
+    retries?: number;
+    enableAnalytics: boolean;
+    defaultFlagHandler?: (featureName: string) => DefaultFlag;
+    environmentFlagsUrl: string;
+    identitiesUrl: string;
+    environmentUrl: string;
+    environmentDataPollingManager?: EnvironmentDataPollingManager;
+    environment: EnvironmentModel;
+    private analyticsProcessor?;
+    /**
+     * A Flagsmith client.
+     *
+     * Provides an interface for interacting with the Flagsmith http API.
+     * Basic Usage::
+     *
+     * import flagsmith from Flagsmith
+     * const flagsmith = new Flagsmith({environmentKey: '<your API key>'});
+     * const environmentFlags = flagsmith.getEnvironmentFlags();
+     * const featureEnabled = environmentFlags.isFeatureEnabled('foo');
+     * const identityFlags = flagsmith.getIdentityFlags('identifier', {'foo': 'bar'});
+     * const featureEnabledForIdentity = identityFlags.isFeatureEnabled("foo")
+     *
+     *  @param {string} data.environmentKey: The environment key obtained from Flagsmith interface
+        @param {string} data.apiUrl: Override the URL of the Flagsmith API to communicate with
+        @param  data.customHeaders: Additional headers to add to requests made to the
+            Flagsmith API
+        @param {number} data.requestTimeoutSeconds: Number of seconds to wait for a request to
+            complete before terminating the request
+        @param {boolean} data.enableLocalEvaluation: Enables local evaluation of flags
+        @param {number} data.environmentRefreshIntervalSeconds: If using local evaluation,
+            specify the interval period between refreshes of local environment data
+        @param {number} data.retries: a urllib3.Retry object to use on all http requests to the
+            Flagsmith API
+        @param {boolean} data.enableAnalytics: if enabled, sends additional requests to the Flagsmith
+            API to power flag analytics charts
+        @param data.defaultFlagHandler: callable which will be used in the case where
+            flags cannot be retrieved from the API or a non existent feature is
+            requested
+     */
+    constructor(data: {
+        environmentKey: string;
+        apiUrl?: string;
+        customHeaders?: {
+            [key: string]: any;
+        };
+        requestTimeoutSeconds?: number;
+        enableLocalEvaluation?: boolean;
+        environmentRefreshIntervalSeconds?: number;
+        retries?: number;
+        enableAnalytics?: boolean;
+        defaultFlagHandler?: (featureName: string) => DefaultFlag;
+    });
+    /**
+     * Get all the default for flags for the current environment.
+     *
+     * @returns Flags object holding all the flags for the current environment.
+     */
+    getEnvironmentFlags(): Promise<Flags>;
+    /**
+     * Get all the flags for the current environment for a given identity. Will also
+        upsert all traits to the Flagsmith API for future evaluations. Providing a
+        trait with a value of None will remove the trait from the identity if it exists.
+     *
+     * @param  {string} identifier a unique identifier for the identity in the current
+            environment, e.g. email address, username, uuid
+     * @param  {{[key:string]:any}} traits? a dictionary of traits to add / update on the identity in
+            Flagsmith, e.g. {"num_orders": 10}
+     * @returns Flags object holding all the flags for the given identity.
+     */
+    getIdentityFlags(identifier: string, traits?: {
+        [key: string]: any;
+    }): Promise<Flags>;
+    /**
+     * Get the segments for the current environment for a given identity. Will also
+        upsert all traits to the Flagsmith API for future evaluations. Providing a
+        trait with a value of None will remove the trait from the identity if it exists.
+     *
+     * @param  {string} identifier a unique identifier for the identity in the current
+            environment, e.g. email address, username, uuid
+     * @param  {{[key:string]:any}} traits? a dictionary of traits to add / update on the identity in
+            Flagsmith, e.g. {"num_orders": 10}
+     * @returns Segments that the given identity belongs to.
+     */
+    getIdentitySegments(identifier: string, traits?: {
+        [key: string]: any;
+    }): Promise<SegmentModel[]>;
+    /**
+     * Updates the environment state for local flag evaluation.
+     * Sets a local promise to prevent race conditions in getIdentityFlags / getIdentitySegments.
+     * You only need to call this if you wish to bypass environmentRefreshIntervalSeconds.
+     */
+    updateEnvironment(): Promise<void>;
+    private getJSONResponse;
+    /**
+     * This promise ensures that the environment is retrieved before attempting to locally evaluate.
+     */
+    private environmentPromise;
+    private getEnvironmentFromApi;
+    private getEnvironmentFlagsFromDocument;
+    private getIdentityFlagsFromDocument;
+    private getEnvironmentFlagsFromApi;
+    private getIdentityFlagsFromApi;
+    private buildIdentityModel;
+}
+export default Flagsmith;

package/build/sdk/index.js

@@ -0,0 +1,386 @@
+"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 __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (_) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __values = (this && this.__values) || function(o) {
+    var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
+    if (m) return m.call(o);
+    if (o && typeof o.length === "number") return {
+        next: function () {
+            if (o && i >= o.length) o = void 0;
+            return { value: o && o[i++], done: !o };
+        }
+    };
+    throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
+};
+var __read = (this && this.__read) || function (o, n) {
+    var m = typeof Symbol === "function" && o[Symbol.iterator];
+    if (!m) return o;
+    var i = m.call(o), r, ar = [], e;
+    try {
+        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
+    }
+    catch (error) { e = { error: error }; }
+    finally {
+        try {
+            if (r && !r.done && (m = i["return"])) m.call(i);
+        }
+        finally { if (e) throw e.error; }
+    }
+    return ar;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Flagsmith = void 0;
+var flagsmith_engine_1 = require("../flagsmith-engine");
+var util_1 = require("../flagsmith-engine/environments/util");
+var models_1 = require("../flagsmith-engine/identities/models");
+var models_2 = require("../flagsmith-engine/identities/traits/models");
+var analytics_1 = require("./analytics");
+var errors_1 = require("./errors");
+var models_3 = require("./models");
+var polling_manager_1 = require("./polling_manager");
+var utils_1 = require("./utils");
+var evaluators_1 = require("../flagsmith-engine/segments/evaluators");
+var DEFAULT_API_URL = 'https://api.flagsmith.com/api/v1/';
+var Flagsmith = /** @class */ (function () {
+    /**
+     * A Flagsmith client.
+     *
+     * Provides an interface for interacting with the Flagsmith http API.
+     * Basic Usage::
+     *
+     * import flagsmith from Flagsmith
+     * const flagsmith = new Flagsmith({environmentKey: '<your API key>'});
+     * const environmentFlags = flagsmith.getEnvironmentFlags();
+     * const featureEnabled = environmentFlags.isFeatureEnabled('foo');
+     * const identityFlags = flagsmith.getIdentityFlags('identifier', {'foo': 'bar'});
+     * const featureEnabledForIdentity = identityFlags.isFeatureEnabled("foo")
+     *
+     *  @param {string} data.environmentKey: The environment key obtained from Flagsmith interface
+        @param {string} data.apiUrl: Override the URL of the Flagsmith API to communicate with
+        @param  data.customHeaders: Additional headers to add to requests made to the
+            Flagsmith API
+        @param {number} data.requestTimeoutSeconds: Number of seconds to wait for a request to
+            complete before terminating the request
+        @param {boolean} data.enableLocalEvaluation: Enables local evaluation of flags
+        @param {number} data.environmentRefreshIntervalSeconds: If using local evaluation,
+            specify the interval period between refreshes of local environment data
+        @param {number} data.retries: a urllib3.Retry object to use on all http requests to the
+            Flagsmith API
+        @param {boolean} data.enableAnalytics: if enabled, sends additional requests to the Flagsmith
+            API to power flag analytics charts
+        @param data.defaultFlagHandler: callable which will be used in the case where
+            flags cannot be retrieved from the API or a non existent feature is
+            requested
+     */
+    function Flagsmith(data) {
+        this.apiUrl = DEFAULT_API_URL;
+        this.enableLocalEvaluation = false;
+        this.environmentRefreshIntervalSeconds = 60;
+        this.enableAnalytics = false;
+        this.environmentKey = data.environmentKey;
+        this.apiUrl = data.apiUrl || this.apiUrl;
+        this.customHeaders = data.customHeaders;
+        this.requestTimeoutSeconds = data.requestTimeoutSeconds;
+        this.enableLocalEvaluation = data.enableLocalEvaluation;
+        this.environmentRefreshIntervalSeconds =
+            data.environmentRefreshIntervalSeconds || this.environmentRefreshIntervalSeconds;
+        this.retries = data.retries;
+        this.enableAnalytics = data.enableAnalytics || false;
+        this.defaultFlagHandler = data.defaultFlagHandler;
+        this.environmentFlagsUrl = "".concat(this.apiUrl, "flags/");
+        this.identitiesUrl = "".concat(this.apiUrl, "identities/");
+        this.environmentUrl = "".concat(this.apiUrl, "environment-document/");
+        if (this.enableLocalEvaluation) {
+            if (!this.environmentKey.startsWith('ser.')) {
+                console.error('In order to use local evaluation, please generate a server key in the environment settings page.');
+            }
+            this.environmentDataPollingManager = new polling_manager_1.EnvironmentDataPollingManager(this, this.environmentRefreshIntervalSeconds);
+            this.environmentDataPollingManager.start();
+            this.updateEnvironment();
+        }
+        this.analyticsProcessor = data.enableAnalytics
+            ? new analytics_1.AnalyticsProcessor({
+                environmentKey: this.environmentKey,
+                baseApiUrl: this.apiUrl,
+                timeout: this.requestTimeoutSeconds
+            })
+            : undefined;
+    }
+    /**
+     * Get all the default for flags for the current environment.
+     *
+     * @returns Flags object holding all the flags for the current environment.
+     */
+    Flagsmith.prototype.getEnvironmentFlags = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var _this = this;
+            return __generator(this, function (_a) {
+                if (this.environment) {
+                    return [2 /*return*/, new Promise(function (resolve) { return resolve(_this.getEnvironmentFlagsFromDocument()); })];
+                }
+                return [2 /*return*/, this.getEnvironmentFlagsFromApi()];
+            });
+        });
+    };
+    /**
+     * Get all the flags for the current environment for a given identity. Will also
+        upsert all traits to the Flagsmith API for future evaluations. Providing a
+        trait with a value of None will remove the trait from the identity if it exists.
+     *
+     * @param  {string} identifier a unique identifier for the identity in the current
+            environment, e.g. email address, username, uuid
+     * @param  {{[key:string]:any}} traits? a dictionary of traits to add / update on the identity in
+            Flagsmith, e.g. {"num_orders": 10}
+     * @returns Flags object holding all the flags for the given identity.
+     */
+    Flagsmith.prototype.getIdentityFlags = function (identifier, traits) {
+        var _this = this;
+        traits = traits || {};
+        if (this.enableLocalEvaluation) {
+            return new Promise(function (resolve) {
+                return _this.environmentPromise.then(function () {
+                    resolve(_this.getIdentityFlagsFromDocument(identifier, traits || {}));
+                });
+            });
+        }
+        return this.getIdentityFlagsFromApi(identifier, traits);
+    };
+    /**
+     * Get the segments for the current environment for a given identity. Will also
+        upsert all traits to the Flagsmith API for future evaluations. Providing a
+        trait with a value of None will remove the trait from the identity if it exists.
+     *
+     * @param  {string} identifier a unique identifier for the identity in the current
+            environment, e.g. email address, username, uuid
+     * @param  {{[key:string]:any}} traits? a dictionary of traits to add / update on the identity in
+            Flagsmith, e.g. {"num_orders": 10}
+     * @returns Segments that the given identity belongs to.
+     */
+    Flagsmith.prototype.getIdentitySegments = function (identifier, traits) {
+        var _this = this;
+        traits = traits || {};
+        if (this.enableLocalEvaluation) {
+            return this.environmentPromise.then(function () {
+                return new Promise(function (resolve) {
+                    var identityModel = _this.buildIdentityModel(identifier, Object.keys(traits || {}).map(function (key) { return ({
+                        key: key,
+                        value: traits === null || traits === void 0 ? void 0 : traits[key]
+                    }); }));
+                    var segments = (0, evaluators_1.getIdentitySegments)(_this.environment, identityModel);
+                    return resolve(segments);
+                });
+            });
+        }
+        console.error('This function is only permitted with local evaluation.');
+        return Promise.resolve([]);
+    };
+    /**
+     * Updates the environment state for local flag evaluation.
+     * Sets a local promise to prevent race conditions in getIdentityFlags / getIdentitySegments.
+     * You only need to call this if you wish to bypass environmentRefreshIntervalSeconds.
+     */
+    Flagsmith.prototype.updateEnvironment = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var request, _a;
+            var _this = this;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        request = this.getEnvironmentFromApi();
+                        if (!!this.environmentPromise) return [3 /*break*/, 2];
+                        this.environmentPromise = request.then(function (res) {
+                            _this.environment = res;
+                        });
+                        return [4 /*yield*/, this.environmentPromise];
+                    case 1:
+                        _b.sent();
+                        return [3 /*break*/, 4];
+                    case 2:
+                        _a = this;
+                        return [4 /*yield*/, request];
+                    case 3:
+                        _a.environment = _b.sent();
+                        _b.label = 4;
+                    case 4: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    Flagsmith.prototype.getJSONResponse = function (url, method, body) {
+        return __awaiter(this, void 0, void 0, function () {
+            var headers, _a, _b, _c, k, v, data;
+            var e_1, _d;
+            return __generator(this, function (_e) {
+                switch (_e.label) {
+                    case 0:
+                        headers = { 'Content-Type': 'application/json' };
+                        if (this.environmentKey) {
+                            headers['X-Environment-Key'] = this.environmentKey;
+                        }
+                        if (this.customHeaders) {
+                            try {
+                                for (_a = __values(Object.entries(this.customHeaders)), _b = _a.next(); !_b.done; _b = _a.next()) {
+                                    _c = __read(_b.value, 2), k = _c[0], v = _c[1];
+                                    headers[k] = v;
+                                }
+                            }
+                            catch (e_1_1) { e_1 = { error: e_1_1 }; }
+                            finally {
+                                try {
+                                    if (_b && !_b.done && (_d = _a.return)) _d.call(_a);
+                                }
+                                finally { if (e_1) throw e_1.error; }
+                            }
+                        }
+                        return [4 /*yield*/, (0, utils_1.retryFetch)(url, {
+                                method: method,
+                                timeout: this.requestTimeoutSeconds || undefined,
+                                body: JSON.stringify(body),
+                                headers: headers
+                            }, this.retries, 1000, (this.requestTimeoutSeconds || 10) * 1000)];
+                    case 1:
+                        data = _e.sent();
+                        if (data.status !== 200) {
+                            throw new errors_1.FlagsmithAPIError("Invalid request made to Flagsmith API. Response status code: ".concat(data.status));
+                        }
+                        return [2 /*return*/, data.json()];
+                }
+            });
+        });
+    };
+    Flagsmith.prototype.getEnvironmentFromApi = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var environment_data;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, this.getJSONResponse(this.environmentUrl, 'GET')];
+                    case 1:
+                        environment_data = _a.sent();
+                        return [2 /*return*/, (0, util_1.buildEnvironmentModel)(environment_data)];
+                }
+            });
+        });
+    };
+    Flagsmith.prototype.getEnvironmentFlagsFromDocument = function () {
+        return models_3.Flags.fromFeatureStateModels({
+            featureStates: (0, flagsmith_engine_1.getEnvironmentFeatureStates)(this.environment),
+            analyticsProcessor: this.analyticsProcessor,
+            defaultFlagHandler: this.defaultFlagHandler
+        });
+    };
+    Flagsmith.prototype.getIdentityFlagsFromDocument = function (identifier, traits) {
+        var identityModel = this.buildIdentityModel(identifier, Object.keys(traits).map(function (key) { return ({
+            key: key,
+            value: traits[key]
+        }); }));
+        var featureStates = (0, flagsmith_engine_1.getIdentityFeatureStates)(this.environment, identityModel);
+        return models_3.Flags.fromFeatureStateModels({
+            featureStates: featureStates,
+            analyticsProcessor: this.analyticsProcessor,
+            defaultFlagHandler: this.defaultFlagHandler
+        });
+    };
+    Flagsmith.prototype.getEnvironmentFlagsFromApi = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var apiFlags, e_2;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        _a.trys.push([0, 2, , 3]);
+                        return [4 /*yield*/, this.getJSONResponse(this.environmentFlagsUrl, 'GET')];
+                    case 1:
+                        apiFlags = _a.sent();
+                        return [2 /*return*/, models_3.Flags.fromAPIFlags({
+                                apiFlags: apiFlags,
+                                analyticsProcessor: this.analyticsProcessor,
+                                defaultFlagHandler: this.defaultFlagHandler
+                            })];
+                    case 2:
+                        e_2 = _a.sent();
+                        if (this.defaultFlagHandler) {
+                            return [2 /*return*/, new models_3.Flags({
+                                    flags: {},
+                                    defaultFlagHandler: this.defaultFlagHandler
+                                })];
+                        }
+                        throw e_2;
+                    case 3: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    Flagsmith.prototype.getIdentityFlagsFromApi = function (identifier, traits) {
+        return __awaiter(this, void 0, void 0, function () {
+            var data, jsonResponse, e_3;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        _a.trys.push([0, 2, , 3]);
+                        data = (0, utils_1.generateIdentitiesData)(identifier, traits);
+                        return [4 /*yield*/, this.getJSONResponse(this.identitiesUrl, 'POST', data)];
+                    case 1:
+                        jsonResponse = _a.sent();
+                        return [2 /*return*/, models_3.Flags.fromAPIFlags({
+                                apiFlags: jsonResponse['flags'],
+                                analyticsProcessor: this.analyticsProcessor,
+                                defaultFlagHandler: this.defaultFlagHandler
+                            })];
+                    case 2:
+                        e_3 = _a.sent();
+                        if (this.defaultFlagHandler) {
+                            return [2 /*return*/, new models_3.Flags({
+                                    flags: {},
+                                    defaultFlagHandler: this.defaultFlagHandler
+                                })];
+                        }
+                        throw e_3;
+                    case 3: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    Flagsmith.prototype.buildIdentityModel = function (identifier, traits) {
+        if (!this.environment) {
+            throw new errors_1.FlagsmithClientError('Unable to build identity model when no local environment present.');
+        }
+        var traitModels = traits.map(function (trait) { return new models_2.TraitModel(trait.key, trait.value); });
+        return new models_1.IdentityModel('0', traitModels, [], this.environment.apiKey, identifier);
+    };
+    return Flagsmith;
+}());
+exports.Flagsmith = Flagsmith;
+exports.default = Flagsmith;