flagsmith-nodejs 3.2.0 → 3.3.0

package/.husky/pre-commit

@@ -2,5 +2,5 @@
 . "$(dirname "$0")/_/husky.sh"
 
 npm run lint
-git add ./flagsmith-engine ./sdk ./tests ./example ./index.ts ./.github
+git add ./flagsmith-engine ./sdk ./tests ./index.ts ./.github
 npm run test

package/README.md

@@ -22,7 +22,8 @@ If you encounter a bug or feature request we would like to hear about it. Before
 ## Testing
 
 To run the local tests you need to run following command beforehand:
-```
+
+```bash
 git submodule add git@github.com:Flagsmith/engine-test-data.git tests/engine/engine-tests/engine-test-data/
 ```
 

package/build/flagsmith-engine/environments/models.d.ts

@@ -1,6 +1,6 @@
 import { FeatureStateModel } from '../features/models';
+import { IdentityModel } from '../identities/models';
 import { ProjectModel } from '../projects/models';
-import { IntegrationModel } from './integrations/models';
 export declare class EnvironmentAPIKeyModel {
     id: number;
     key: string;
@@ -17,9 +17,6 @@ export declare class EnvironmentModel {
     apiKey: string;
     project: ProjectModel;
     featureStates: FeatureStateModel[];
-    amplitude_config?: IntegrationModel;
-    segment_config?: IntegrationModel;
-    mixpanel_config?: IntegrationModel;
-    heap_config?: IntegrationModel;
+    identityOverrides: IdentityModel[];
     constructor(id: number, apiKey: string, project: ProjectModel);
 }

package/build/flagsmith-engine/environments/models.js

@@ -20,6 +20,7 @@ exports.EnvironmentAPIKeyModel = EnvironmentAPIKeyModel;
 var EnvironmentModel = /** @class */ (function () {
     function EnvironmentModel(id, apiKey, project) {
         this.featureStates = [];
+        this.identityOverrides = [];
         this.id = id;
         this.apiKey = apiKey;
         this.project = project;

package/build/flagsmith-engine/environments/util.js

@@ -2,15 +2,21 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildEnvironmentAPIKeyModel = exports.buildEnvironmentModel = void 0;
 var util_1 = require("../features/util");
-var util_2 = require("../projects/util");
+var util_2 = require("../identities/util");
+var util_3 = require("../projects/util");
 var models_1 = require("./models");
 function buildEnvironmentModel(environmentJSON) {
-    var project = (0, util_2.buildProjectModel)(environmentJSON.project);
+    var project = (0, util_3.buildProjectModel)(environmentJSON.project);
     var featureStates = environmentJSON.feature_states.map(function (fs) {
         return (0, util_1.buildFeatureStateModel)(fs);
     });
     var environmentModel = new models_1.EnvironmentModel(environmentJSON.id, environmentJSON.api_key, project);
     environmentModel.featureStates = featureStates;
+    if (!!environmentJSON.identity_overrides) {
+        environmentModel.identityOverrides = environmentJSON.identity_overrides.map(function (identityData) {
+            return (0, util_2.buildIdentityModel)(identityData);
+        });
+    }
     return environmentModel;
 }
 exports.buildEnvironmentModel = buildEnvironmentModel;

package/build/flagsmith-engine/features/util.js

@@ -7,14 +7,14 @@ function buildFeatureModel(featuresModelJSON) {
 }
 exports.buildFeatureModel = buildFeatureModel;
 function buildFeatureStateModel(featuresStateModelJSON) {
-    var featureStateModel = new models_1.FeatureStateModel(buildFeatureModel(featuresStateModelJSON.feature), featuresStateModelJSON.enabled, featuresStateModelJSON.django_id, featuresStateModelJSON.feature_state_value, featuresStateModelJSON.uuid);
+    var featureStateModel = new models_1.FeatureStateModel(buildFeatureModel(featuresStateModelJSON.feature), featuresStateModelJSON.enabled, featuresStateModelJSON.django_id, featuresStateModelJSON.feature_state_value, featuresStateModelJSON.featurestate_uuid);
     featureStateModel.featureSegment = featuresStateModelJSON.feature_segment ?
         buildFeatureSegment(featuresStateModelJSON.feature_segment) :
         undefined;
     var multivariateFeatureStateValues = featuresStateModelJSON.multivariate_feature_state_values
         ? featuresStateModelJSON.multivariate_feature_state_values.map(function (fsv) {
             var featureOption = new models_1.MultivariateFeatureOptionModel(fsv.multivariate_feature_option.value, fsv.multivariate_feature_option.id);
-            return new models_1.MultivariateFeatureStateValueModel(featureOption, fsv.percentage_allocation, fsv.id);
+            return new models_1.MultivariateFeatureStateValueModel(featureOption, fsv.percentage_allocation, fsv.id, fsv.mv_fs_value_uuid);
         })
         : [];
     featureStateModel.multivariateFeatureStateValues = multivariateFeatureStateValues;

package/build/flagsmith-engine/index.d.ts

@@ -3,7 +3,6 @@ import { FeatureStateModel } from './features/models';
 import { IdentityModel } from './identities/models';
 import { TraitModel } from './identities/traits/models';
 export { EnvironmentModel } from './environments/models';
-export { IntegrationModel } from './environments/integrations/models';
 export { FeatureStateModel } from './features/models';
 export { IdentityModel } from './identities/models';
 export { TraitModel } from './identities/traits/models';

package/build/flagsmith-engine/index.js

@@ -11,23 +11,21 @@ var __values = (this && this.__values) || function(o) {
     throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getEnvironmentFeatureStates = exports.getEnvironmentFeatureState = exports.getIdentityFeatureStates = exports.getIdentityFeatureState = exports.OrganisationModel = exports.SegmentModel = exports.TraitModel = exports.IdentityModel = exports.FeatureStateModel = exports.IntegrationModel = exports.EnvironmentModel = void 0;
+exports.getEnvironmentFeatureStates = exports.getEnvironmentFeatureState = exports.getIdentityFeatureStates = exports.getIdentityFeatureState = exports.OrganisationModel = exports.SegmentModel = exports.TraitModel = exports.IdentityModel = exports.FeatureStateModel = exports.EnvironmentModel = void 0;
 var evaluators_1 = require("./segments/evaluators");
 var errors_1 = require("./utils/errors");
 var models_1 = require("./environments/models");
 Object.defineProperty(exports, "EnvironmentModel", { enumerable: true, get: function () { return models_1.EnvironmentModel; } });
-var models_2 = require("./environments/integrations/models");
-Object.defineProperty(exports, "IntegrationModel", { enumerable: true, get: function () { return models_2.IntegrationModel; } });
-var models_3 = require("./features/models");
-Object.defineProperty(exports, "FeatureStateModel", { enumerable: true, get: function () { return models_3.FeatureStateModel; } });
-var models_4 = require("./identities/models");
-Object.defineProperty(exports, "IdentityModel", { enumerable: true, get: function () { return models_4.IdentityModel; } });
-var models_5 = require("./identities/traits/models");
-Object.defineProperty(exports, "TraitModel", { enumerable: true, get: function () { return models_5.TraitModel; } });
-var models_6 = require("./segments/models");
-Object.defineProperty(exports, "SegmentModel", { enumerable: true, get: function () { return models_6.SegmentModel; } });
-var models_7 = require("./organisations/models");
-Object.defineProperty(exports, "OrganisationModel", { enumerable: true, get: function () { return models_7.OrganisationModel; } });
+var models_2 = require("./features/models");
+Object.defineProperty(exports, "FeatureStateModel", { enumerable: true, get: function () { return models_2.FeatureStateModel; } });
+var models_3 = require("./identities/models");
+Object.defineProperty(exports, "IdentityModel", { enumerable: true, get: function () { return models_3.IdentityModel; } });
+var models_4 = require("./identities/traits/models");
+Object.defineProperty(exports, "TraitModel", { enumerable: true, get: function () { return models_4.TraitModel; } });
+var models_5 = require("./segments/models");
+Object.defineProperty(exports, "SegmentModel", { enumerable: true, get: function () { return models_5.SegmentModel; } });
+var models_6 = require("./organisations/models");
+Object.defineProperty(exports, "OrganisationModel", { enumerable: true, get: function () { return models_6.OrganisationModel; } });
 function getIdentityFeatureStatesDict(environment, identity, overrideTraits) {
     var e_1, _a, e_2, _b, e_3, _c, e_4, _d;
     // Get feature states from the environment

package/build/index.d.ts

@@ -1,2 +1,3 @@
 export { AnalyticsProcessor, FlagsmithAPIError, FlagsmithClientError, EnvironmentDataPollingManager, FlagsmithCache, DefaultFlag, Flags, default } from './sdk';
-export { EnvironmentModel, IntegrationModel, FeatureStateModel, IdentityModel, TraitModel, SegmentModel, OrganisationModel } from './flagsmith-engine';
+export { FlagsmithConfig } from './sdk/types';
+export { EnvironmentModel, FeatureStateModel, IdentityModel, TraitModel, SegmentModel, OrganisationModel } from './flagsmith-engine';

package/build/index.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OrganisationModel = exports.SegmentModel = exports.TraitModel = exports.IdentityModel = exports.FeatureStateModel = exports.IntegrationModel = exports.EnvironmentModel = exports.default = exports.Flags = exports.DefaultFlag = exports.EnvironmentDataPollingManager = exports.FlagsmithClientError = exports.FlagsmithAPIError = exports.AnalyticsProcessor = void 0;
+exports.OrganisationModel = exports.SegmentModel = exports.TraitModel = exports.IdentityModel = exports.FeatureStateModel = exports.EnvironmentModel = exports.default = exports.Flags = exports.DefaultFlag = exports.EnvironmentDataPollingManager = exports.FlagsmithClientError = exports.FlagsmithAPIError = exports.AnalyticsProcessor = void 0;
 var sdk_1 = __importDefault(require("./sdk"));
 var sdk_2 = require("./sdk");
 Object.defineProperty(exports, "AnalyticsProcessor", { enumerable: true, get: function () { return sdk_2.AnalyticsProcessor; } });
@@ -15,7 +15,6 @@ Object.defineProperty(exports, "Flags", { enumerable: true, get: function () { r
 Object.defineProperty(exports, "default", { enumerable: true, get: function () { return __importDefault(sdk_2).default; } });
 var flagsmith_engine_1 = require("./flagsmith-engine");
 Object.defineProperty(exports, "EnvironmentModel", { enumerable: true, get: function () { return flagsmith_engine_1.EnvironmentModel; } });
-Object.defineProperty(exports, "IntegrationModel", { enumerable: true, get: function () { return flagsmith_engine_1.IntegrationModel; } });
 Object.defineProperty(exports, "FeatureStateModel", { enumerable: true, get: function () { return flagsmith_engine_1.FeatureStateModel; } });
 Object.defineProperty(exports, "IdentityModel", { enumerable: true, get: function () { return flagsmith_engine_1.IdentityModel; } });
 Object.defineProperty(exports, "TraitModel", { enumerable: true, get: function () { return flagsmith_engine_1.TraitModel; } });

package/build/sdk/index.d.ts

@@ -1,5 +1,6 @@
 import { RequestInit } from 'node-fetch';
 import { EnvironmentModel } from '../flagsmith-engine/environments/models';
+import { IdentityModel } from '../flagsmith-engine/identities/models';
 import { BaseOfflineHandler } from './offline_handlers';
 import { DefaultFlag, Flags } from './models';
 import { EnvironmentDataPollingManager } from './polling_manager';
@@ -30,6 +31,7 @@ export declare class Flagsmith {
     environment: EnvironmentModel;
     offlineMode: boolean;
     offlineHandler?: BaseOfflineHandler;
+    identitiesWithOverridesByIdentifier?: Map<string, IdentityModel>;
     private cache?;
     private onEnvironmentChange?;
     private analyticsProcessor?;
@@ -123,6 +125,6 @@ export declare class Flagsmith {
     private getIdentityFlagsFromDocument;
     private getEnvironmentFlagsFromApi;
     private getIdentityFlagsFromApi;
-    private buildIdentityModel;
+    private getIdentityModel;
 }
 export default Flagsmith;

package/build/sdk/index.js

@@ -307,7 +307,7 @@ var Flagsmith = /** @class */ (function () {
         if (this.enableLocalEvaluation) {
             return new Promise(function (resolve, reject) {
                 return _this.environmentPromise.then(function () {
-                    var identityModel = _this.buildIdentityModel(identifier, Object.keys(traits || {}).map(function (key) { return ({
+                    var identityModel = _this.getIdentityModel(identifier, Object.keys(traits || {}).map(function (key) { return ({
                         key: key,
                         value: traits === null || traits === void 0 ? void 0 : traits[key]
                     }); }));
@@ -325,13 +325,14 @@ var Flagsmith = /** @class */ (function () {
      * You only need to call this if you wish to bypass environmentRefreshIntervalSeconds.
      */
     Flagsmith.prototype.updateEnvironment = function () {
+        var _a;
         return __awaiter(this, void 0, void 0, function () {
-            var request, _a, e_1;
+            var request, _b, e_1;
             var _this = this;
-            return __generator(this, function (_b) {
-                switch (_b.label) {
+            return __generator(this, function (_c) {
+                switch (_c.label) {
                     case 0:
-                        _b.trys.push([0, 5, , 6]);
+                        _c.trys.push([0, 5, , 6]);
                         request = this.getEnvironmentFromApi();
                         if (!!this.environmentPromise) return [3 /*break*/, 2];
                         this.environmentPromise = request.then(function (res) {
@@ -339,21 +340,24 @@ var Flagsmith = /** @class */ (function () {
                         });
                         return [4 /*yield*/, this.environmentPromise];
                     case 1:
-                        _b.sent();
+                        _c.sent();
                         return [3 /*break*/, 4];
                     case 2:
-                        _a = this;
+                        _b = this;
                         return [4 /*yield*/, request];
                     case 3:
-                        _a.environment = _b.sent();
-                        _b.label = 4;
+                        _b.environment = _c.sent();
+                        _c.label = 4;
                     case 4:
+                        if ((_a = this.environment.identityOverrides) === null || _a === void 0 ? void 0 : _a.length) {
+                            this.identitiesWithOverridesByIdentifier = new Map(this.environment.identityOverrides.map(function (identity) { return [identity.identifier, identity]; }));
+                        }
                         if (this.onEnvironmentChange) {
                             this.onEnvironmentChange(null, this.environment);
                         }
                         return [3 /*break*/, 6];
                     case 5:
-                        e_1 = _b.sent();
+                        e_1 = _c.sent();
                         if (this.onEnvironmentChange) {
                             this.onEnvironmentChange(e_1, this.environment);
                         }
@@ -460,7 +464,7 @@ var Flagsmith = /** @class */ (function () {
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
-                        identityModel = this.buildIdentityModel(identifier, Object.keys(traits).map(function (key) { return ({
+                        identityModel = this.getIdentityModel(identifier, Object.keys(traits).map(function (key) { return ({
                             key: key,
                             value: traits[key]
                         }); }));
@@ -574,8 +578,14 @@ var Flagsmith = /** @class */ (function () {
             });
         });
     };
-    Flagsmith.prototype.buildIdentityModel = function (identifier, traits) {
+    Flagsmith.prototype.getIdentityModel = function (identifier, traits) {
+        var _a;
         var traitModels = traits.map(function (trait) { return new models_2.TraitModel(trait.key, trait.value); });
+        var identityWithOverrides = (_a = this.identitiesWithOverridesByIdentifier) === null || _a === void 0 ? void 0 : _a.get(identifier);
+        if (identityWithOverrides) {
+            identityWithOverrides.updateTraits(traitModels);
+            return identityWithOverrides;
+        }
         return new models_1.IdentityModel('0', traitModels, [], this.environment.apiKey, identifier);
     };
     return Flagsmith;

package/flagsmith-engine/environments/models.ts

@@ -1,6 +1,6 @@
 import { FeatureStateModel } from '../features/models';
+import { IdentityModel } from '../identities/models';
 import { ProjectModel } from '../projects/models';
-import { IntegrationModel } from './integrations/models';
 
 export class EnvironmentAPIKeyModel {
     id: number;
@@ -37,10 +37,7 @@ export class EnvironmentModel {
     apiKey: string;
     project: ProjectModel;
     featureStates: FeatureStateModel[] = [];
-    amplitude_config?: IntegrationModel;
-    segment_config?: IntegrationModel;
-    mixpanel_config?: IntegrationModel;
-    heap_config?: IntegrationModel;
+    identityOverrides: IdentityModel[] = [];
 
     constructor(id: number, apiKey: string, project: ProjectModel) {
         this.id = id;

package/flagsmith-engine/environments/util.ts

@@ -1,4 +1,5 @@
 import { buildFeatureStateModel } from '../features/util';
+import { buildIdentityModel } from '../identities/util';
 import { buildProjectModel } from '../projects/util';
 import { EnvironmentAPIKeyModel, EnvironmentModel } from './models';
 
@@ -13,6 +14,11 @@ export function buildEnvironmentModel(environmentJSON: any) {
         project
     );
     environmentModel.featureStates = featureStates;
+    if (!!environmentJSON.identity_overrides) {
+        environmentModel.identityOverrides = environmentJSON.identity_overrides.map((identityData: any) =>
+            buildIdentityModel(identityData)
+        );
+    }
     return environmentModel;
 }
 

package/flagsmith-engine/features/util.ts

@@ -16,25 +16,26 @@ export function buildFeatureStateModel(featuresStateModelJSON: any): FeatureStat
         featuresStateModelJSON.enabled,
         featuresStateModelJSON.django_id,
         featuresStateModelJSON.feature_state_value,
-        featuresStateModelJSON.uuid
+        featuresStateModelJSON.featurestate_uuid
     );
 
-    featureStateModel.featureSegment = featuresStateModelJSON.feature_segment ? 
-        buildFeatureSegment(featuresStateModelJSON.feature_segment) : 
+    featureStateModel.featureSegment = featuresStateModelJSON.feature_segment ?
+        buildFeatureSegment(featuresStateModelJSON.feature_segment) :
         undefined;
 
     const multivariateFeatureStateValues = featuresStateModelJSON.multivariate_feature_state_values
         ? featuresStateModelJSON.multivariate_feature_state_values.map((fsv: any) => {
-              const featureOption = new MultivariateFeatureOptionModel(
-                  fsv.multivariate_feature_option.value,
-                  fsv.multivariate_feature_option.id
-              );
-              return new MultivariateFeatureStateValueModel(
-                  featureOption,
-                  fsv.percentage_allocation,
-                  fsv.id
-              );
-          })
+            const featureOption = new MultivariateFeatureOptionModel(
+                fsv.multivariate_feature_option.value,
+                fsv.multivariate_feature_option.id
+            );
+            return new MultivariateFeatureStateValueModel(
+                featureOption,
+                fsv.percentage_allocation,
+                fsv.id,
+                fsv.mv_fs_value_uuid
+            );
+        })
         : [];
 
     featureStateModel.multivariateFeatureStateValues = multivariateFeatureStateValues;

package/flagsmith-engine/index.ts

@@ -7,7 +7,6 @@ import { SegmentModel } from './segments/models';
 import { FeatureStateNotFound } from './utils/errors';
 
 export { EnvironmentModel } from './environments/models';
-export { IntegrationModel } from './environments/integrations/models';
 export { FeatureStateModel } from './features/models';
 export { IdentityModel } from './identities/models';
 export { TraitModel } from './identities/traits/models';

package/index.ts

@@ -11,9 +11,12 @@ export {
   default
 } from './sdk';
 
+export {
+  FlagsmithConfig
+} from './sdk/types'
+
 export {
   EnvironmentModel,
-  IntegrationModel,
   FeatureStateModel,
   IdentityModel,
   TraitModel,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flagsmith-nodejs",
-  "version": "3.2.0",
+  "version": "3.3.0",
   "description": "Flagsmith lets you manage features flags and remote config across web, mobile and server side applications. Deliver true Continuous Integration. Get builds out faster. Control who has access to new features.",
   "main": "build/index.js",
   "repository": {

package/sdk/index.ts

@@ -49,6 +49,8 @@ export class Flagsmith {
     offlineMode: boolean = false;
     offlineHandler?: BaseOfflineHandler = undefined;
 
+    identitiesWithOverridesByIdentifier?: Map<string, IdentityModel>;
+
     private cache?: FlagsmithCache;
     private onEnvironmentChange?: (error: Error | null, result: EnvironmentModel) => void;
     private analyticsProcessor?: AnalyticsProcessor;
@@ -143,13 +145,13 @@ export class Flagsmith {
             if (!this.environmentKey) {
                 throw new Error('ValueError: environmentKey is required.');
             }
-    
+
             const apiUrl = data.apiUrl || DEFAULT_API_URL;
             this.apiUrl = apiUrl.endsWith('/') ? apiUrl : `${apiUrl}/`;
             this.environmentFlagsUrl = `${this.apiUrl}flags/`;
             this.identitiesUrl = `${this.apiUrl}identities/`;
             this.environmentUrl = `${this.apiUrl}environment-document/`;
-    
+
             if (this.enableLocalEvaluation) {
                 if (!this.environmentKey.startsWith('ser.')) {
                     console.error(
@@ -166,11 +168,11 @@ export class Flagsmith {
 
             this.analyticsProcessor = data.enableAnalytics
                 ? new AnalyticsProcessor({
-                      environmentKey: this.environmentKey,
-                      baseApiUrl: this.apiUrl,
-                      requestTimeoutMs: this.requestTimeoutMs,
-                      logger: this.logger
-                  })
+                    environmentKey: this.environmentKey,
+                    baseApiUrl: this.apiUrl,
+                    requestTimeoutMs: this.requestTimeoutMs,
+                    logger: this.logger
+                })
                 : undefined;
         }
     }
@@ -256,7 +258,7 @@ export class Flagsmith {
         if (this.enableLocalEvaluation) {
             return new Promise((resolve, reject) => {
                 return this.environmentPromise!.then(() => {
-                    const identityModel = this.buildIdentityModel(
+                    const identityModel = this.getIdentityModel(
                         identifier,
                         Object.keys(traits || {}).map(key => ({
                             key,
@@ -289,6 +291,11 @@ export class Flagsmith {
             } else {
                 this.environment = await request;
             }
+            if (this.environment.identityOverrides?.length) {
+                this.identitiesWithOverridesByIdentifier = new Map<string, IdentityModel>(
+                    this.environment.identityOverrides.map(identity => [identity.identifier, identity]
+                    ));
+            }
             if (this.onEnvironmentChange) {
                 this.onEnvironmentChange(null, this.environment);
             }
@@ -370,7 +377,7 @@ export class Flagsmith {
         identifier: string,
         traits: { [key: string]: any }
     ): Promise<Flags> {
-        const identityModel = this.buildIdentityModel(
+        const identityModel = this.getIdentityModel(
             identifier,
             Object.keys(traits).map(key => ({
                 key,
@@ -458,8 +465,13 @@ export class Flagsmith {
         }
     }
 
-    private buildIdentityModel(identifier: string, traits: { key: string; value: any }[]) {
+    private getIdentityModel(identifier: string, traits: { key: string; value: any }[]) {
         const traitModels = traits.map(trait => new TraitModel(trait.key, trait.value));
+        let identityWithOverrides = this.identitiesWithOverridesByIdentifier?.get(identifier);
+        if (identityWithOverrides) {
+            identityWithOverrides.updateTraits(traitModels);
+            return identityWithOverrides;
+        }
         return new IdentityModel('0', traitModels, [], this.environment.apiKey, identifier);
     }
 }

package/tests/sdk/data/environment.json

@@ -17,6 +17,7 @@
         "feature_states": [
           {
             "feature_state_value": "segment_override",
+            "featurestate_uuid": "dd77a1ab-08cf-4743-8a3b-19e730444a14",
             "multivariate_feature_state_values": [],
             "django_id": 81027,
             "feature": {
@@ -88,5 +89,30 @@
       "featurestate_uuid": "96fc3503-09d7-48f1-a83b-2dc903d5c08a",
       "enabled": false
     }
+  ],
+  "identity_overrides": [
+    {
+      "identifier": "overridden-id",
+      "identity_uuid": "0f21cde8-63c5-4e50-baca-87897fa6cd01",
+      "created_date": "2019-08-27T14:53:45.698555Z",
+      "updated_at": "2023-07-14 16:12:00.000000",
+      "environment_api_key": "B62qaMZNwfiqT76p38ggrQ",
+      "identity_features": [
+        {
+          "id": 1,
+          "feature": {
+            "id": 1,
+            "name": "some_feature",
+            "type": "STANDARD"
+          },
+          "featurestate_uuid": "1bddb9a5-7e59-42c6-9be9-625fa369749f",
+          "feature_state_value": "some-overridden-value",
+          "enabled": false,
+          "environment": 1,
+          "identity": null,
+          "feature_segment": null
+        }
+      ]
+    }
   ]
-}
+}

package/tests/sdk/flagsmith.test.ts

@@ -1,10 +1,9 @@
 import Flagsmith from '../../sdk';
 import { EnvironmentDataPollingManager } from '../../sdk/polling_manager';
-import fetch, {RequestInit} from 'node-fetch';
+import fetch, { RequestInit } from 'node-fetch';
 import { environmentJSON, environmentModel, flagsJSON, flagsmith, identitiesJSON } from './utils';
 import { DefaultFlag, Flags } from '../../sdk/models';
-import {delay, retryFetch} from '../../sdk/utils';
-import * as utils from '../../sdk/utils';
+import { delay } from '../../sdk/utils';
 import { EnvironmentModel } from '../../flagsmith-engine/environments/models';
 import https from 'https'
 import { BaseOfflineHandler } from '../../sdk/offline_handlers';
@@ -48,9 +47,6 @@ test('test_update_environment_sets_environment', async () => {
 
     const model = environmentModel(JSON.parse(environmentJSON()));
 
-    wipeFeatureStateUUIDs(flg.environment)
-    wipeFeatureStateUUIDs(model)
-
     expect(flg.environment).toStrictEqual(model);
 });
 
@@ -58,8 +54,8 @@ test('test_set_agent_options', async () => {
     const agent = new https.Agent({})
 
     // @ts-ignore
-    fetch.mockImplementation((url:string, options:RequestInit)=>{
-        if(options.agent!==agent) {
+    fetch.mockImplementation((url: string, options: RequestInit) => {
+        if (options.agent !== agent) {
             throw new Error("Agent has not been set on retry fetch")
         }
         return Promise.resolve(new Response(environmentJSON()))
@@ -276,7 +272,7 @@ test('getIdentitySegments throws error if identifier is empty string', () => {
 })
 
 
-test('offline_mode', async() => {
+test('offline_mode', async () => {
     // Given
     const environment: EnvironmentModel = environmentModel(JSON.parse(environmentJSON('offline-environment.json')));
 
@@ -311,19 +307,19 @@ test('test_flagsmith_uses_offline_handler_if_set_and_no_api_response', async ()
     const environment: EnvironmentModel = environmentModel(JSON.parse(environmentJSON('offline-environment.json')));
     const api_url = 'http://some.flagsmith.com/api/v1/';
     const mock_offline_handler = new BaseOfflineHandler() as jest.Mocked<BaseOfflineHandler>;
-  
+
     jest.spyOn(mock_offline_handler, 'getEnvironment').mockReturnValue(environment);
 
     const flagsmith = new Flagsmith({
-      environmentKey: 'some-key',
-      apiUrl: api_url,
-      offlineHandler: mock_offline_handler,
+        environmentKey: 'some-key',
+        apiUrl: api_url,
+        offlineHandler: mock_offline_handler,
     });
 
     jest.spyOn(flagsmith, 'getEnvironmentFlags');
     jest.spyOn(flagsmith, 'getIdentityFlags');
 
-  
+
     flagsmith.environmentFlagsUrl = 'http://some.flagsmith.com/api/v1/environment-flags';
     flagsmith.identitiesUrl = 'http://some.flagsmith.com/api/v1/identities';
 
@@ -337,17 +333,17 @@ test('test_flagsmith_uses_offline_handler_if_set_and_no_api_response', async ()
     fetch.mockReturnValue(Promise.resolve(errorResponse));
 
     // When
-    const environmentFlags:Flags = await flagsmith.getEnvironmentFlags();
-    const identityFlags:Flags = await flagsmith.getIdentityFlags('identity', {});
+    const environmentFlags: Flags = await flagsmith.getEnvironmentFlags();
+    const identityFlags: Flags = await flagsmith.getIdentityFlags('identity', {});
 
     // Then
     expect(mock_offline_handler.getEnvironment).toHaveBeenCalledTimes(1);
     expect(flagsmith.getEnvironmentFlags).toHaveBeenCalled();
     expect(flagsmith.getIdentityFlags).toHaveBeenCalled();
-    
+
     expect(environmentFlags.isFeatureEnabled('some_feature')).toBe(true);
     expect(environmentFlags.getFeatureValue('some_feature')).toBe('offline-value');
-  
+
     expect(identityFlags.isFeatureEnabled('some_feature')).toBe(true);
     expect(identityFlags.getFeatureValue('some_feature')).toBe('offline-value');
 });
@@ -355,18 +351,18 @@ test('test_flagsmith_uses_offline_handler_if_set_and_no_api_response', async ()
 test('cannot use offline mode without offline handler', () => {
     // When and Then
     expect(() => new Flagsmith({ offlineMode: true, offlineHandler: undefined })).toThrowError(
-      'ValueError: offlineHandler must be provided to use offline mode.'
+        'ValueError: offlineHandler must be provided to use offline mode.'
     );
 });
-  
+
 test('cannot use both default handler and offline handler', () => {
     // When and Then
     expect(() => new Flagsmith({
-      offlineHandler: new BaseOfflineHandler(),
-      defaultFlagHandler: (flagName) => new DefaultFlag('foo', true)
+        offlineHandler: new BaseOfflineHandler(),
+        defaultFlagHandler: (flagName) => new DefaultFlag('foo', true)
     })).toThrowError('ValueError: Cannot use both defaultFlagHandler and offlineHandler.');
 });
-  
+
 test('cannot create Flagsmith client in remote evaluation without API key', () => {
     // When and Then
     // @ts-ignore
@@ -374,27 +370,20 @@ test('cannot create Flagsmith client in remote evaluation without API key', () =
 });
 
 
-async function wipeFeatureStateUUIDs (environmentModel: EnvironmentModel) {
-    // TODO: this has been pulled out of tests above as a helper function.
-    //  I'm not entirely sure why it's necessary, however, we should look to remove.
-    environmentModel.featureStates.forEach(fs => {
-        // @ts-ignore
-        fs.featurestateUUID = undefined;
-        fs.multivariateFeatureStateValues.forEach(mvfsv => {
-            // @ts-ignore
-            mvfsv.mvFsValueUuid = undefined;
-        })
-    });
-    environmentModel.project.segments.forEach(s => {
-        s.featureStates.forEach(fs => {
-            // @ts-ignore
-            fs.featurestateUUID = undefined;
-        })
-    })
-}
-
 function sleep(ms: number) {
     return new Promise((resolve) => {
         setTimeout(resolve, ms);
     });
 }
+test('test_localEvaluation_true__identity_overrides_evaluated', async () => {
+    // @ts-ignore
+    fetch.mockReturnValue(Promise.resolve(new Response(environmentJSON())));
+
+    const flg = new Flagsmith({
+        environmentKey: 'ser.key',
+        enableLocalEvaluation: true,
+    });
+
+    const flags = await flg.getIdentityFlags("overridden-id");
+    expect(flags.getFeatureValue("some_feature")).toEqual("some-overridden-value");
+});

package/build/flagsmith-engine/environments/integrations/models.d.ts

@@ -1,4 +0,0 @@
-export declare class IntegrationModel {
-    api_key?: string;
-    base_url?: string;
-}

package/build/flagsmith-engine/environments/integrations/models.js

@@ -1,11 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.IntegrationModel = void 0;
-var IntegrationModel = /** @class */ (function () {
-    function IntegrationModel() {
-        this.api_key = undefined;
-        this.base_url = undefined;
-    }
-    return IntegrationModel;
-}());
-exports.IntegrationModel = IntegrationModel;

package/examples/README.md

@@ -1,3 +0,0 @@
-# Flagsmith NodeJS Examples
-
-Check out our [NodeJS Examples repository](https://github.com/Flagsmith/flagsmith-nodejs-examples).

package/flagsmith-engine/environments/integrations/models.ts

@@ -1,4 +0,0 @@
-export class IntegrationModel {
-    api_key?: string = undefined;
-    base_url?: string = undefined;
-}