flagsmith-nodejs 2.5.1 → 3.0.0

package/.github/workflows/publish.yml

@@ -0,0 +1,25 @@
+name: Publish NPM Package
+
+on:
+  push:
+    tags:
+      - '*'
+
+jobs:
+  package:
+    runs-on: ubuntu-latest
+    name: Publish NPM Package
+
+    steps:
+      - name: Cloning repo
+        uses: actions/checkout@v3
+
+      - uses: actions/setup-node@v3
+        with:
+          node-version: '16.x'
+          registry-url: 'https://registry.npmjs.org'
+
+      - run: npm ci
+      - run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/examples/README.md

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

package/flagsmith-engine/identities/models.ts

@@ -19,7 +19,8 @@ export class IdentityModel {
         identityFeatures: IdentityFeaturesList,
         environmentApiKey: string,
         identifier: string,
-        identityUuid?: string
+        identityUuid?: string,
+        djangoID?: number
     ) {
         this.identityUuid = identityUuid || uuidv4();
         this.createdDate = Date.parse(created_date) || Date.now();
@@ -27,6 +28,7 @@ export class IdentityModel {
         this.identityFeatures = new IdentityFeaturesList(...identityFeatures);
         this.environmentApiKey = environmentApiKey;
         this.identifier = identifier;
+        this.djangoID = djangoID;
     }
 
     get compositeKey() {

package/flagsmith-engine/segments/evaluators.ts

@@ -27,7 +27,7 @@ export function evaluateIdentityInSegment(
                 overrideTraits || identity.identityTraits,
                 rule,
                 segment.id,
-                identity.compositeKey
+                identity.djangoID || identity.compositeKey
             )
         ).length === segment.rules.length
     );
@@ -62,7 +62,8 @@ export function traitsMatchSegmentCondition(
     identityId: number | string
 ): boolean {
     if (condition.operator == PERCENTAGE_SPLIT) {
-        return getHashedPercentateForObjIds([segmentId, identityId]) <= parseFloat(String(condition.value));
+        var hashedPercentage = getHashedPercentateForObjIds([segmentId, identityId]);
+        return hashedPercentage <= parseFloat(String(condition.value));
     }
     const traits = identityTraits.filter(t => t.traitKey === condition.property_);
     const trait = traits.length > 0 ? traits[0] : undefined;
@@ -73,4 +74,4 @@ export function traitsMatchSegmentCondition(
     }
     return trait ? condition.matchesTraitValue(trait.traitValue) : false;
 
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flagsmith-nodejs",
-  "version": "2.5.1",
+  "version": "3.0.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

@@ -283,11 +283,11 @@ export class Flagsmith {
             {
                 agent: this.agent,
                 method: method,
-                timeout: this.requestTimeoutMs || undefined,
                 body: JSON.stringify(body),
                 headers: headers
             },
-            this.retries
+            this.retries,
+            this.requestTimeoutMs || undefined,
         );
 
         if (data.status !== 200) {

package/sdk/utils.ts

@@ -23,22 +23,28 @@ export const retryFetch = (
     timeout?: number // set an overall timeout for this function
 ): Promise<Response> => {
     return new Promise((resolve, reject) => {
-        // check for timeout
-        if (timeout) setTimeout(() => reject('error: timeout'), timeout);
-
-        const wrapper = (n: number) => {
-            fetch(url, fetchOptions)
+        const retryWrapper = (n: number) => {
+            requestWrapper()
                 .then(res => resolve(res))
                 .catch(async err => {
                     if (n > 0) {
                         await delay(1000);
-                        wrapper(--n);
+                        retryWrapper(--n);
                     } else {
                         reject(err);
                     }
                 });
         };
 
-        wrapper(retries);
+        const requestWrapper = (): Promise<Response> => {
+            return new Promise((resolve, reject) => {
+                if (timeout) setTimeout(() => reject('error: timeout'), timeout);
+                return fetch(url, fetchOptions)
+                    .then(res => resolve(res))
+                    .catch(err => reject(err))
+            })
+        }
+
+        retryWrapper(retries);
     });
 };

package/tests/engine/unit/segments/segment_evaluators.test.ts

@@ -1,11 +1,21 @@
 import {
+    ALL_RULE,
     CONDITION_OPERATORS,
+    PERCENTAGE_SPLIT,
 } from '../../../../flagsmith-engine/segments/constants';
-import {
-    SegmentConditionModel,
-} from '../../../../flagsmith-engine/segments/models';
-import {traitsMatchSegmentCondition} from "../../../../flagsmith-engine/segments/evaluators";
-import {TraitModel} from "../../../../flagsmith-engine";
+import {SegmentConditionModel} from '../../../../flagsmith-engine/segments/models';
+import {traitsMatchSegmentCondition, evaluateIdentityInSegment} from "../../../../flagsmith-engine/segments/evaluators";
+import {TraitModel, IdentityModel} from "../../../../flagsmith-engine";
+import {environment} from "../utils";
+import { buildSegmentModel } from '../../../../flagsmith-engine/segments/util';
+import { getHashedPercentateForObjIds } from '../../../../flagsmith-engine/utils/hashing';
+
+
+// todo: work out how to implement this in a test function or before hook
+jest.mock('../../../../flagsmith-engine/utils/hashing', () => ({
+    getHashedPercentateForObjIds: jest.fn(() => 1)
+}));
+
 
 let traitExistenceTestCases: [string, string | null | undefined, string | null | undefined, TraitModel [],boolean][] = [
     [CONDITION_OPERATORS.IS_SET,'foo', null,[] , false],
@@ -24,4 +34,34 @@ test('test_traits_match_segment_condition_for_trait_existence_operators', () =>
            traitsMatchSegmentCondition (traits, segmentModel, 'any','any')
         ).toBe(expectedResult);
     }
-});
+});
+
+
+test('evaluateIdentityInSegment uses django ID for hashed percentage when present', () => {
+    var identityModel = new IdentityModel(Date.now().toString(), [], [], environment().apiKey, 'identity_1', undefined, 1);
+    const segmentDefinition = {
+        id: 1,
+        name: 'percentage_split_segment',
+        rules: [
+            {
+                type: ALL_RULE,
+                conditions: [
+                    {
+                        operator: PERCENTAGE_SPLIT,
+                        property_: null,
+                        value: "10"
+                    }
+                ],
+                rules: []
+            }
+        ],
+        feature_states: []
+    };
+    const segmentModel = buildSegmentModel(segmentDefinition);
+
+    var result = evaluateIdentityInSegment(identityModel, segmentModel);
+
+    expect(result).toBe(true);
+    expect(getHashedPercentateForObjIds).toHaveBeenCalledTimes(1)
+    expect(getHashedPercentateForObjIds).toHaveBeenCalledWith([segmentModel.id, identityModel.djangoID])
+});

package/tests/engine/unit/utils/utils.test.ts

@@ -42,7 +42,6 @@ describe('getHashedPercentageForObjIds', () => {
         let objectIdPairs = Array.from(Array(testSample).keys()).flatMap(d => Array.from(Array(testSample).keys()).map(e => [d, e].flat()))
 
         // When
-        console.log(objectIdPairs);
         let values = objectIdPairs.map((objIds) => getHashedPercentateForObjIds(objIds));
 
         // Then

package/tests/sdk/flagsmith.test.ts

@@ -172,6 +172,27 @@ test('test_default_flag_used_after_multiple_API_errors', async () => {
     expect(flag.value).toBe(defaultFlag.value);
 });
 
+test('default flag handler used when timeout occurs', async () => {
+    // @ts-ignore
+    fetch.mockReturnValue(Promise.resolve(sleep(10000)));
+
+    const defaultFlag = new DefaultFlag('some-default-value', true);
+
+    const defaultFlagHandler = (featureName: string) => defaultFlag;
+
+    const flg = new Flagsmith({
+        environmentKey: 'key',
+        defaultFlagHandler: defaultFlagHandler,
+        requestTimeoutSeconds: 0.1,
+    });
+
+    const flags = await flg.getEnvironmentFlags();
+    const flag = flags.getFlag('some_feature');
+    expect(flag.isDefault).toBe(true);
+    expect(flag.enabled).toBe(defaultFlag.enabled);
+    expect(flag.value).toBe(defaultFlag.value);
+})
+
 test('test_throws_when_no_identity_flags_returned_due_to_error', async () => {
     // @ts-ignore
     fetch.mockReturnValue(Promise.resolve(new Response('bad data')));
@@ -245,7 +266,6 @@ test('getIdentitySegments throws error if identifier is empty string', () => {
 })
 
 
-
 async function wipeFeatureStateUUIDs (enviromentModel: 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.
@@ -264,3 +284,9 @@ async function wipeFeatureStateUUIDs (enviromentModel: EnvironmentModel) {
         })
     })
 }
+
+function sleep(ms: number) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}

package/.vscode/launch.json

@@ -1,18 +0,0 @@
-{
-    "version": "1.0.0",
-    "configurations": [
-      {
-        "type": "node",
-        "request": "launch",
-        "name": "Jest: current file",
-        //"env": { "NODE_ENV": "test" },
-        "program": "${workspaceFolder}/node_modules/.bin/jest",
-        "args": ["${file}", "--config", "jest.config.js"],
-        "console": "integratedTerminal",
-        "disableOptimisticBPs": true,
-        "windows": {
-          "program": "${workspaceFolder}/node_modules/jest/bin/jest"
-        }
-      }
-    ]
-  }

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/build/flagsmith-engine/environments/models.d.ts

@@ -1,25 +0,0 @@
-import { FeatureStateModel } from '../features/models';
-import { ProjectModel } from '../projects/models';
-import { IntegrationModel } from './integrations/models';
-export declare class EnvironmentAPIKeyModel {
-    id: number;
-    key: string;
-    createdAt: number;
-    name: string;
-    clientApiKey: string;
-    expiresAt?: number;
-    active: boolean;
-    constructor(id: number, key: string, createdAt: number, name: string, clientApiKey: string, expiresAt?: number);
-    isValid(): boolean;
-}
-export declare class EnvironmentModel {
-    id: number;
-    apiKey: string;
-    project: ProjectModel;
-    featureStates: FeatureStateModel[];
-    amplitude_config?: IntegrationModel;
-    segment_config?: IntegrationModel;
-    mixpanel_config?: IntegrationModel;
-    heap_config?: IntegrationModel;
-    constructor(id: number, apiKey: string, project: ProjectModel);
-}

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

@@ -1,29 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.EnvironmentModel = exports.EnvironmentAPIKeyModel = void 0;
-var EnvironmentAPIKeyModel = /** @class */ (function () {
-    function EnvironmentAPIKeyModel(id, key, createdAt, name, clientApiKey, expiresAt) {
-        this.active = true;
-        this.id = id;
-        this.key = key;
-        this.createdAt = createdAt;
-        this.name = name;
-        this.clientApiKey = clientApiKey;
-        this.expiresAt = expiresAt;
-    }
-    EnvironmentAPIKeyModel.prototype.isValid = function () {
-        return !!this.active && (!this.expiresAt || this.expiresAt > Date.now());
-    };
-    return EnvironmentAPIKeyModel;
-}());
-exports.EnvironmentAPIKeyModel = EnvironmentAPIKeyModel;
-var EnvironmentModel = /** @class */ (function () {
-    function EnvironmentModel(id, apiKey, project) {
-        this.featureStates = [];
-        this.id = id;
-        this.apiKey = apiKey;
-        this.project = project;
-    }
-    return EnvironmentModel;
-}());
-exports.EnvironmentModel = EnvironmentModel;

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

@@ -1,3 +0,0 @@
-import { EnvironmentAPIKeyModel, EnvironmentModel } from './models';
-export declare function buildEnvironmentModel(environmentJSON: any): EnvironmentModel;
-export declare function buildEnvironmentAPIKeyModel(apiKeyJSON: any): EnvironmentAPIKeyModel;

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

@@ -1,21 +0,0 @@
-"use strict";
-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 models_1 = require("./models");
-function buildEnvironmentModel(environmentJSON) {
-    var project = (0, util_2.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;
-    return environmentModel;
-}
-exports.buildEnvironmentModel = buildEnvironmentModel;
-function buildEnvironmentAPIKeyModel(apiKeyJSON) {
-    var model = new models_1.EnvironmentAPIKeyModel(apiKeyJSON.id, apiKeyJSON.key, Date.parse(apiKeyJSON.created_at), apiKeyJSON.name, apiKeyJSON.client_api_key);
-    return model;
-}
-exports.buildEnvironmentAPIKeyModel = buildEnvironmentAPIKeyModel;

package/build/flagsmith-engine/features/constants.d.ts

@@ -1,4 +0,0 @@
-export declare const CONSTANTS: {
-    STANDARD: string;
-    MULTIVARIATE: string;
-};

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

@@ -1,7 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CONSTANTS = void 0;
-exports.CONSTANTS = {
-    STANDARD: 'STANDARD',
-    MULTIVARIATE: 'MULTIVARIATE'
-};

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

@@ -1,37 +0,0 @@
-export declare class FeatureModel {
-    id: number;
-    name: string;
-    type: string;
-    constructor(id: number, name: string, type: string);
-    eq(other: FeatureModel): boolean;
-}
-export declare class MultivariateFeatureOptionModel {
-    value: any;
-    id: number | undefined;
-    constructor(value: any, id?: number);
-}
-export declare class MultivariateFeatureStateValueModel {
-    multivariateFeatureOption: MultivariateFeatureOptionModel;
-    percentageAllocation: number;
-    id: number;
-    mvFsValueUuid: string;
-    constructor(multivariate_feature_option: MultivariateFeatureOptionModel, percentage_allocation: number, id: number, mvFsValueUuid?: string);
-}
-export declare class FeatureStateModel {
-    feature: FeatureModel;
-    enabled: boolean;
-    djangoID: number;
-    featurestateUUID: string;
-    featureSegment?: FeatureSegment;
-    private value;
-    multivariateFeatureStateValues: MultivariateFeatureStateValueModel[];
-    constructor(feature: FeatureModel, enabled: boolean, djangoID: number, value?: any, featurestateUuid?: string);
-    setValue(value: any): void;
-    getValue(identityId?: number | string): any;
-    isHigherSegmentPriority(other: FeatureStateModel): boolean;
-    getMultivariateValue(identityID: number | string): any;
-}
-export declare class FeatureSegment {
-    priority: number;
-    constructor(priority: number);
-}

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

@@ -1,122 +0,0 @@
-"use strict";
-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.");
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FeatureSegment = exports.FeatureStateModel = exports.MultivariateFeatureStateValueModel = exports.MultivariateFeatureOptionModel = exports.FeatureModel = void 0;
-var uuid_1 = require("uuid");
-var hashing_1 = require("../utils/hashing");
-var FeatureModel = /** @class */ (function () {
-    function FeatureModel(id, name, type) {
-        this.id = id;
-        this.name = name;
-        this.type = type;
-    }
-    FeatureModel.prototype.eq = function (other) {
-        return !!other && this.id === other.id;
-    };
-    return FeatureModel;
-}());
-exports.FeatureModel = FeatureModel;
-var MultivariateFeatureOptionModel = /** @class */ (function () {
-    function MultivariateFeatureOptionModel(value, id) {
-        this.value = value;
-        this.id = id;
-    }
-    return MultivariateFeatureOptionModel;
-}());
-exports.MultivariateFeatureOptionModel = MultivariateFeatureOptionModel;
-var MultivariateFeatureStateValueModel = /** @class */ (function () {
-    function MultivariateFeatureStateValueModel(multivariate_feature_option, percentage_allocation, id, mvFsValueUuid) {
-        this.mvFsValueUuid = (0, uuid_1.v4)();
-        this.id = id;
-        this.percentageAllocation = percentage_allocation;
-        this.multivariateFeatureOption = multivariate_feature_option;
-        this.mvFsValueUuid = mvFsValueUuid || this.mvFsValueUuid;
-    }
-    return MultivariateFeatureStateValueModel;
-}());
-exports.MultivariateFeatureStateValueModel = MultivariateFeatureStateValueModel;
-var FeatureStateModel = /** @class */ (function () {
-    function FeatureStateModel(feature, enabled, djangoID, value, featurestateUuid) {
-        if (featurestateUuid === void 0) { featurestateUuid = (0, uuid_1.v4)(); }
-        this.featurestateUUID = (0, uuid_1.v4)();
-        this.multivariateFeatureStateValues = [];
-        this.feature = feature;
-        this.enabled = enabled;
-        this.djangoID = djangoID;
-        this.value = value;
-        this.featurestateUUID = featurestateUuid;
-    }
-    FeatureStateModel.prototype.setValue = function (value) {
-        this.value = value;
-    };
-    FeatureStateModel.prototype.getValue = function (identityId) {
-        if (!!identityId && this.multivariateFeatureStateValues.length > 0) {
-            return this.getMultivariateValue(identityId);
-        }
-        return this.value;
-    };
-    /*
-        Returns `True` if `this` is higher segment priority than `other`
-        (i.e. has lower value for featureSegment.priority)
-        NOTE:
-            A segment will be considered higher priority only if:
-            1. `other` does not have a feature segment(i.e: it is an environment feature state or it's a
-            feature state with feature segment but from an old document that does not have `featureSegment.priority`)
-            but `this` does.
-            2. `other` have a feature segment with high priority
-    */
-    FeatureStateModel.prototype.isHigherSegmentPriority = function (other) {
-        if (!other.featureSegment || !this.featureSegment) {
-            return !!this.featureSegment && !other.featureSegment;
-        }
-        return this.featureSegment.priority < other.featureSegment.priority;
-    };
-    FeatureStateModel.prototype.getMultivariateValue = function (identityID) {
-        var e_1, _a;
-        var percentageValue = (0, hashing_1.getHashedPercentateForObjIds)([
-            this.djangoID || this.featurestateUUID,
-            identityID
-        ]);
-        var startPercentage = 0;
-        var sortedF = this.multivariateFeatureStateValues.sort(function (a, b) {
-            return a.id - b.id;
-        });
-        try {
-            for (var sortedF_1 = __values(sortedF), sortedF_1_1 = sortedF_1.next(); !sortedF_1_1.done; sortedF_1_1 = sortedF_1.next()) {
-                var myValue = sortedF_1_1.value;
-                var limit = myValue.percentageAllocation + startPercentage;
-                if (startPercentage <= percentageValue && percentageValue < limit) {
-                    return myValue.multivariateFeatureOption.value;
-                }
-                startPercentage = limit;
-            }
-        }
-        catch (e_1_1) { e_1 = { error: e_1_1 }; }
-        finally {
-            try {
-                if (sortedF_1_1 && !sortedF_1_1.done && (_a = sortedF_1.return)) _a.call(sortedF_1);
-            }
-            finally { if (e_1) throw e_1.error; }
-        }
-        return this.value;
-    };
-    return FeatureStateModel;
-}());
-exports.FeatureStateModel = FeatureStateModel;
-var FeatureSegment = /** @class */ (function () {
-    function FeatureSegment(priority) {
-        this.priority = priority;
-    }
-    return FeatureSegment;
-}());
-exports.FeatureSegment = FeatureSegment;

package/build/flagsmith-engine/features/util.d.ts

@@ -1,4 +0,0 @@
-import { FeatureModel, FeatureSegment, FeatureStateModel } from './models';
-export declare function buildFeatureModel(featuresModelJSON: any): FeatureModel;
-export declare function buildFeatureStateModel(featuresStateModelJSON: any): FeatureStateModel;
-export declare function buildFeatureSegment(featureSegmentJSON: any): FeatureSegment;

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

@@ -1,27 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildFeatureSegment = exports.buildFeatureStateModel = exports.buildFeatureModel = void 0;
-var models_1 = require("./models");
-function buildFeatureModel(featuresModelJSON) {
-    return new models_1.FeatureModel(featuresModelJSON.id, featuresModelJSON.name, featuresModelJSON.type);
-}
-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);
-    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);
-        })
-        : [];
-    featureStateModel.multivariateFeatureStateValues = multivariateFeatureStateValues;
-    return featureStateModel;
-}
-exports.buildFeatureStateModel = buildFeatureStateModel;
-function buildFeatureSegment(featureSegmentJSON) {
-    return new models_1.FeatureSegment(featureSegmentJSON.priority);
-}
-exports.buildFeatureSegment = buildFeatureSegment;

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

@@ -1,15 +0,0 @@
-import { IdentityFeaturesList } from '../utils/collections';
-import { TraitModel } from './traits/models';
-export declare class IdentityModel {
-    identifier: string;
-    environmentApiKey: string;
-    createdDate?: number;
-    identityFeatures: IdentityFeaturesList;
-    identityTraits: TraitModel[];
-    identityUuid: string;
-    djangoID: number | undefined;
-    constructor(created_date: string, identityTraits: TraitModel[], identityFeatures: IdentityFeaturesList, environmentApiKey: string, identifier: string, identityUuid?: string);
-    get compositeKey(): string;
-    static generateCompositeKey(env_key: string, identifier: string): string;
-    updateTraits(traits: TraitModel[]): void;
-}