flagsmith-nodejs 6.0.1 → 6.2.0

package/build/esm/flagsmith-engine/utils/hashing/index.js

@@ -1,4 +1,4 @@
-import { createHash } from "node:crypto";
+import { createHash } from 'node:crypto';
 const md5 = (data) => createHash('md5').update(data).digest('hex');
 const makeRepeated = (arr, repeats) => Array.from({ length: repeats }, () => arr).flat();
 // https://stackoverflow.com/questions/12532871/how-to-convert-a-very-large-hex-number-to-decimal-in-javascript
@@ -14,7 +14,7 @@ export function getHashedPercentateForObjIds(objectIds, iterations = 1) {
     let toHash = makeRepeated(objectIds, iterations).join(',');
     const hashedValue = md5(toHash);
     const hashedInt = BigInt('0x' + hashedValue);
-    const value = (Number((hashedInt % 9999n)) / 9998.0) * 100;
+    const value = (Number(hashedInt % 9999n) / 9998.0) * 100;
     // we ignore this for it's nearly impossible use case to catch
     /* istanbul ignore next */
     if (value === 100) {

package/build/esm/flagsmith-engine/utils/index.js

@@ -1,4 +1,4 @@
-import { removeSemverSuffix } from "../segments/util.js";
+import { removeSemverSuffix } from '../segments/util.js';
 export function getCastingFunction(traitType) {
     switch (traitType) {
         case 'boolean':

package/build/esm/index.d.ts

@@ -1,4 +1,4 @@
-export { AnalyticsProcessor, AnalyticsProcessorOptions, FlagsmithAPIError, FlagsmithClientError, EnvironmentDataPollingManager, FlagsmithCache, DefaultFlag, Flags, Flagsmith, } from './sdk/index.js';
-export { BaseOfflineHandler, LocalFileHandler, } from './sdk/offline_handlers.js';
-export { FlagsmithConfig } from './sdk/types.js';
-export { EnvironmentModel, FeatureStateModel, IdentityModel, TraitModel, SegmentModel, OrganisationModel } from './flagsmith-engine/index.js';
+export { AnalyticsProcessor, AnalyticsProcessorOptions, FlagsmithAPIError, FlagsmithClientError, EnvironmentDataPollingManager, FlagsmithCache, BaseFlag, DefaultFlag, Flags, Flagsmith } from './sdk/index.js';
+export { BaseOfflineHandler, LocalFileHandler } from './sdk/offline_handlers.js';
+export { FlagsmithConfig, FlagsmithValue, TraitConfig } from './sdk/types.js';
+export { EnvironmentModel, FeatureModel, FeatureStateModel, IdentityModel, TraitModel, SegmentModel, OrganisationModel } from './flagsmith-engine/index.js';

package/build/esm/index.js

@@ -1,3 +1,3 @@
-export { AnalyticsProcessor, FlagsmithAPIError, FlagsmithClientError, EnvironmentDataPollingManager, DefaultFlag, Flags, Flagsmith, } from './sdk/index.js';
-export { BaseOfflineHandler, LocalFileHandler, } from './sdk/offline_handlers.js';
-export { EnvironmentModel, FeatureStateModel, IdentityModel, TraitModel, SegmentModel, OrganisationModel } from './flagsmith-engine/index.js';
+export { AnalyticsProcessor, FlagsmithAPIError, FlagsmithClientError, EnvironmentDataPollingManager, BaseFlag, DefaultFlag, Flags, Flagsmith } from './sdk/index.js';
+export { BaseOfflineHandler, LocalFileHandler } from './sdk/offline_handlers.js';
+export { EnvironmentModel, FeatureModel, FeatureStateModel, IdentityModel, TraitModel, SegmentModel, OrganisationModel } from './flagsmith-engine/index.js';

package/build/esm/sdk/analytics.d.ts

@@ -1,5 +1,5 @@
 import { Logger } from 'pino';
-import { Fetch } from "./types.js";
+import { Fetch } from './types.js';
 export declare const ANALYTICS_ENDPOINT = "./analytics/flags/";
 export interface AnalyticsProcessorOptions {
     /** URL of the Flagsmith analytics events API endpoint

package/build/esm/sdk/analytics.js

@@ -1,4 +1,5 @@
 import { pino } from 'pino';
+import { getUserAgent } from './utils.js';
 export const ANALYTICS_ENDPOINT = './analytics/flags/';
 /** Duration in seconds to wait before trying to flush collected data after {@link trackFeature} is called. **/
 const ANALYTICS_TIMER = 10;
@@ -44,7 +45,8 @@ export class AnalyticsProcessor {
                 signal: AbortSignal.timeout(this.requestTimeoutMs),
                 headers: {
                     'Content-Type': 'application/json',
-                    'X-Environment-Key': this.environmentKey
+                    'X-Environment-Key': this.environmentKey,
+                    'User-Agent': getUserAgent()
                 }
             });
             await this.currentFlush;

package/build/esm/sdk/index.d.ts

@@ -5,10 +5,10 @@ import { BaseOfflineHandler } from './offline_handlers.js';
 import { DefaultFlag, Flags } from './models.js';
 import { EnvironmentDataPollingManager } from './polling_manager.js';
 import { SegmentModel } from '../flagsmith-engine/index.js';
-import { FlagsmithConfig, FlagsmithTraitValue, ITraitConfig } from './types.js';
+import { FlagsmithConfig, FlagsmithTraitValue, TraitConfig } from './types.js';
 export { AnalyticsProcessor, AnalyticsProcessorOptions } from './analytics.js';
 export { FlagsmithAPIError, FlagsmithClientError } from './errors.js';
-export { DefaultFlag, Flags } from './models.js';
+export { BaseFlag, DefaultFlag, Flags } from './models.js';
 export { EnvironmentDataPollingManager } from './polling_manager.js';
 export { FlagsmithCache, FlagsmithConfig } from './types.js';
 /**
@@ -34,7 +34,7 @@ export { FlagsmithCache, FlagsmithConfig } from './types.js';
  * const bannerVariation: string = identityFlags.getFeatureValue('banner_flag')
  *
  * @see FlagsmithConfig
-*/
+ */
 export declare class Flagsmith {
     environmentKey?: string;
     apiUrl?: string;
@@ -84,12 +84,12 @@ export declare class Flagsmith {
      *
      * @param  {string} identifier a unique identifier for the identity in the current
             environment, e.g. email address, username, uuid
-     * @param  {{[key:string]:any | ITraitConfig}} traits? a dictionary of traits to add / update on the identity in
+     * @param  {{[key:string]:any | TraitConfig}} traits? a dictionary of traits to add / update on the identity in
             Flagsmith, e.g. {"num_orders": 10} or {age: {value: 30, transient: true}}
      * @returns Flags object holding all the flags for the given identity.
      */
     getIdentityFlags(identifier: string, traits?: {
-        [key: string]: FlagsmithTraitValue | ITraitConfig;
+        [key: string]: FlagsmithTraitValue | TraitConfig;
     }, transient?: boolean): Promise<Flags>;
     /**
      * Get the segments for the current environment for a given identity. Will also

package/build/esm/sdk/index.js

@@ -6,12 +6,12 @@ import { ANALYTICS_ENDPOINT, AnalyticsProcessor } from './analytics.js';
 import { FlagsmithAPIError } from './errors.js';
 import { Flags } from './models.js';
 import { EnvironmentDataPollingManager } from './polling_manager.js';
-import { Deferred, generateIdentitiesData, retryFetch } from './utils.js';
+import { Deferred, generateIdentitiesData, getUserAgent, retryFetch } from './utils.js';
 import { getIdentitySegments } from '../flagsmith-engine/segments/evaluators.js';
 import { pino } from 'pino';
 export { AnalyticsProcessor } from './analytics.js';
 export { FlagsmithAPIError, FlagsmithClientError } from './errors.js';
-export { DefaultFlag, Flags } from './models.js';
+export { BaseFlag, DefaultFlag, Flags } from './models.js';
 export { EnvironmentDataPollingManager } from './polling_manager.js';
 const DEFAULT_API_URL = 'https://edge.api.flagsmith.com/api/v1/';
 const DEFAULT_REQUEST_TIMEOUT_SECONDS = 10;
@@ -38,7 +38,7 @@ const DEFAULT_REQUEST_TIMEOUT_SECONDS = 10;
  * const bannerVariation: string = identityFlags.getFeatureValue('banner_flag')
  *
  * @see FlagsmithConfig
-*/
+ */
 export class Flagsmith {
     environmentKey = undefined;
     apiUrl = undefined;
@@ -107,7 +107,8 @@ export class Flagsmith {
             }
             const apiUrl = data.apiUrl || DEFAULT_API_URL;
             this.apiUrl = apiUrl.endsWith('/') ? apiUrl : `${apiUrl}/`;
-            this.analyticsUrl = this.analyticsUrl || new URL(ANALYTICS_ENDPOINT, new Request(this.apiUrl).url).href;
+            this.analyticsUrl =
+                this.analyticsUrl || new URL(ANALYTICS_ENDPOINT, new Request(this.apiUrl).url).href;
             this.environmentFlagsUrl = `${this.apiUrl}flags/`;
             this.identitiesUrl = `${this.apiUrl}identities/`;
             this.environmentUrl = `${this.apiUrl}environment-document/`;
@@ -125,7 +126,7 @@ export class Flagsmith {
                     environmentKey: this.environmentKey,
                     analyticsUrl: this.analyticsUrl,
                     requestTimeoutMs: this.requestTimeoutMs,
-                    logger: this.logger,
+                    logger: this.logger
                 });
             }
         }
@@ -164,7 +165,7 @@ export class Flagsmith {
      *
      * @param  {string} identifier a unique identifier for the identity in the current
             environment, e.g. email address, username, uuid
-     * @param  {{[key:string]:any | ITraitConfig}} traits? a dictionary of traits to add / update on the identity in
+     * @param  {{[key:string]:any | TraitConfig}} traits? a dictionary of traits to add / update on the identity in
             Flagsmith, e.g. {"num_orders": 10} or {age: {value: 30, transient: true}}
      * @returns Flags object holding all the flags for the given identity.
      */
@@ -268,6 +269,7 @@ export class Flagsmith {
         if (this.environmentKey) {
             headers['X-Environment-Key'] = this.environmentKey;
         }
+        headers['User-Agent'] = getUserAgent();
         if (this.customHeaders) {
             for (const [k, v] of Object.entries(this.customHeaders)) {
                 headers[k] = v;
@@ -282,7 +284,7 @@ export class Flagsmith {
         if (data.status !== 200) {
             throw new FlagsmithAPIError(`Invalid request made to Flagsmith API. Response status code: ${data.status}`);
         }
-        return data.json();
+        return { response: data, data: await data.json() };
     }
     /**
      * This promise ensures that the environment is retrieved before attempting to locally evaluate.
@@ -309,8 +311,43 @@ export class Flagsmith {
         if (!this.environmentUrl) {
             throw new Error('`apiUrl` argument is missing or invalid.');
         }
-        const environment_data = await this.getJSONResponse(this.environmentUrl, 'GET');
-        return buildEnvironmentModel(environment_data);
+        const startTime = Date.now();
+        const documents = [];
+        let url = this.environmentUrl;
+        let loggedWarning = false;
+        while (true) {
+            try {
+                if (!loggedWarning) {
+                    const elapsedMs = Date.now() - startTime;
+                    if (elapsedMs > this.environmentRefreshIntervalSeconds * 1000) {
+                        this.logger.warn(`Environment document retrieval exceeded the polling interval of ${this.environmentRefreshIntervalSeconds} seconds.`);
+                        loggedWarning = true;
+                    }
+                }
+                const { response, data } = await this.getJSONResponse(url, 'GET');
+                documents.push(data);
+                const linkHeader = response.headers.get('link');
+                if (linkHeader) {
+                    const nextMatch = linkHeader.match(/<([^>]+)>;\s*rel="next"/);
+                    if (nextMatch) {
+                        const relativeUrl = decodeURIComponent(nextMatch[1]);
+                        url = new URL(relativeUrl, this.apiUrl).href;
+                        continue;
+                    }
+                }
+                break;
+            }
+            catch (error) {
+                throw error;
+            }
+        }
+        // Compile the document
+        const compiledDocument = documents[0];
+        for (let i = 1; i < documents.length; i++) {
+            compiledDocument.identity_overrides = compiledDocument.identity_overrides || [];
+            compiledDocument.identity_overrides.push(...(documents[i].identity_overrides || []));
+        }
+        return buildEnvironmentModel(compiledDocument);
     }
     async getEnvironmentFlagsFromDocument() {
         const environment = await this.getEnvironment();
@@ -346,7 +383,7 @@ export class Flagsmith {
         if (!this.environmentFlagsUrl) {
             throw new Error('`apiUrl` argument is missing or invalid.');
         }
-        const apiFlags = await this.getJSONResponse(this.environmentFlagsUrl, 'GET');
+        const { data: apiFlags } = await this.getJSONResponse(this.environmentFlagsUrl, 'GET');
         const flags = Flags.fromAPIFlags({
             apiFlags: apiFlags,
             analyticsProcessor: this.analyticsProcessor,
@@ -362,7 +399,7 @@ export class Flagsmith {
             throw new Error('`apiUrl` argument is missing or invalid.');
         }
         const data = generateIdentitiesData(identifier, traits, transient);
-        const jsonResponse = await this.getJSONResponse(this.identitiesUrl, 'POST', data);
+        const { data: jsonResponse } = await this.getJSONResponse(this.identitiesUrl, 'POST', data);
         const flags = Flags.fromAPIFlags({
             apiFlags: jsonResponse['flags'],
             analyticsProcessor: this.analyticsProcessor,

package/build/esm/sdk/models.d.ts

@@ -1,17 +1,42 @@
 import { FeatureStateModel } from '../flagsmith-engine/features/models.js';
 import { AnalyticsProcessor } from './analytics.js';
 type FlagValue = string | number | boolean | undefined;
+/**
+ * A Flagsmith feature. It has an enabled/disabled state, and an optional {@link FlagValue}.
+ */
 export declare class BaseFlag {
+    /**
+     * Indicates whether this feature is enabled.
+     */
     enabled: boolean;
+    /**
+     * An optional {@link FlagValue} for this feature.
+     */
     value: FlagValue;
+    /**
+     * If true, the state for this feature was determined by a default flag handler. See {@link DefaultFlag}.
+     */
     isDefault: boolean;
     constructor(value: FlagValue, enabled: boolean, isDefault: boolean);
 }
+/**
+ * A {@link BaseFlag} returned by a default flag handler when flag evaluation fails.
+ * @see FlagsmithConfig#defaultFlagHandler
+ */
 export declare class DefaultFlag extends BaseFlag {
     constructor(value: FlagValue, enabled: boolean);
 }
+/**
+ * A Flagsmith feature retrieved from a successful flag evaluation.
+ */
 export declare class Flag extends BaseFlag {
+    /**
+     * An identifier for this feature, unique in a single Flagsmith installation.
+     */
     featureId: number;
+    /**
+     * The programmatic name for this feature, unique per Flagsmith project.
+     */
     featureName: string;
     constructor(params: {
         value: FlagValue;

package/build/esm/sdk/models.js

@@ -1,6 +1,18 @@
+/**
+ * A Flagsmith feature. It has an enabled/disabled state, and an optional {@link FlagValue}.
+ */
 export class BaseFlag {
+    /**
+     * Indicates whether this feature is enabled.
+     */
     enabled;
+    /**
+     * An optional {@link FlagValue} for this feature.
+     */
     value;
+    /**
+     * If true, the state for this feature was determined by a default flag handler. See {@link DefaultFlag}.
+     */
     isDefault;
     constructor(value, enabled, isDefault) {
         this.value = value;
@@ -8,13 +20,26 @@ export class BaseFlag {
         this.isDefault = isDefault;
     }
 }
+/**
+ * A {@link BaseFlag} returned by a default flag handler when flag evaluation fails.
+ * @see FlagsmithConfig#defaultFlagHandler
+ */
 export class DefaultFlag extends BaseFlag {
     constructor(value, enabled) {
         super(value, enabled, true);
     }
 }
+/**
+ * A Flagsmith feature retrieved from a successful flag evaluation.
+ */
 export class Flag extends BaseFlag {
+    /**
+     * An identifier for this feature, unique in a single Flagsmith installation.
+     */
     featureId;
+    /**
+     * The programmatic name for this feature, unique per Flagsmith project.
+     */
     featureName;
     constructor(params) {
         super(params.value, params.enabled, !!params.isDefault);

package/build/esm/sdk/types.d.ts

@@ -3,7 +3,10 @@ import { EnvironmentModel } from '../flagsmith-engine/index.js';
 import { Dispatcher } from 'undici-types';
 import { Logger } from 'pino';
 import { BaseOfflineHandler } from './offline_handlers.js';
-export type IFlagsmithValue<T = string | number | boolean | null> = T;
+/**
+ * A concrete type for the possible values of a feature.
+ */
+export type FlagsmithValue<T = string | number | boolean | null> = T;
 /**
  * Stores and retrieves {@link Flags} from a cache.
  */
@@ -89,7 +92,7 @@ export interface FlagsmithConfig {
      * const defaultHandler = () => new DefaultFlag(undefined, false)
      *
      * // Enable only VIP flags by default
-     * const vipDefaultHandler = (key: string) => new Default(undefined, key.startsWith('vip_'))
+     * const vipDefaultHandler = (key: string) => new DefaultFlag(undefined, key.startsWith('vip_'))
      */
     defaultFlagHandler?: (flagKey: string) => DefaultFlag;
     cache?: FlagsmithCache;
@@ -109,8 +112,15 @@ export interface FlagsmithConfig {
      */
     offlineHandler?: BaseOfflineHandler;
 }
-export interface ITraitConfig {
+/**
+ * Represents the configuration for a trait in Flagsmith.
+ *
+ * @property value The {@link FlagsmithTraitValue} for this trait.
+ * @property [transient] Indicates whether the trait should be persisted when used in a remote flag evaluation context.
+ * Defaults to false.
+ */
+export interface TraitConfig {
     value: FlagsmithTraitValue;
     transient?: boolean;
 }
-export declare type FlagsmithTraitValue = IFlagsmithValue;
+export declare type FlagsmithTraitValue = FlagsmithValue;

package/build/esm/sdk/utils.d.ts

@@ -1,9 +1,9 @@
-import { Fetch, FlagsmithTraitValue, ITraitConfig } from './types.js';
-import { Dispatcher } from "undici-types";
+import { Fetch, FlagsmithTraitValue, TraitConfig } from './types.js';
+import { Dispatcher } from 'undici-types';
 type Traits = {
-    [key: string]: ITraitConfig | FlagsmithTraitValue;
+    [key: string]: TraitConfig | FlagsmithTraitValue;
 };
-export declare function isTraitConfig(traitValue: ITraitConfig | FlagsmithTraitValue): traitValue is ITraitConfig;
+export declare function isTraitConfig(traitValue: TraitConfig | FlagsmithTraitValue): traitValue is TraitConfig;
 export declare function generateIdentitiesData(identifier: string, traits: Traits, transient: boolean): {
     identifier: string;
     traits: ({
@@ -56,4 +56,5 @@ export declare class Deferred<T> {
     resolve(value: T | PromiseLike<T>): void;
     reject(reason?: unknown): void;
 }
+export declare function getUserAgent(): string;
 export {};

package/build/esm/sdk/utils.js

@@ -1,3 +1,5 @@
+const FLAGSMITH_USER_AGENT = 'flagsmith-nodejs-sdk';
+const FLAGSMITH_UNKNOWN_VERSION = 'unknown';
 export function isTraitConfig(traitValue) {
     return !!traitValue && typeof traitValue == 'object' && traitValue.value !== undefined;
 }
@@ -7,13 +9,13 @@ export function generateIdentitiesData(identifier, traits, transient) {
             return {
                 trait_key: key,
                 trait_value: value?.value,
-                transient: value?.transient,
+                transient: value?.transient
             };
         }
         else {
             return {
                 trait_key: key,
-                trait_value: value,
+                trait_value: value
             };
         }
     });
@@ -85,3 +87,13 @@ export class Deferred {
         this.rejectPromise(reason);
     }
 }
+export function getUserAgent() {
+    try {
+        const packageJson = require('../package.json');
+        const version = packageJson?.version;
+        return version ? `${FLAGSMITH_USER_AGENT}/${version}` : FLAGSMITH_UNKNOWN_VERSION;
+    }
+    catch {
+        return FLAGSMITH_UNKNOWN_VERSION;
+    }
+}

package/flagsmith-engine/environments/util.ts

@@ -15,8 +15,8 @@ export function buildEnvironmentModel(environmentJSON: any) {
     );
     environmentModel.featureStates = featureStates;
     if (!!environmentJSON.identity_overrides) {
-        environmentModel.identityOverrides = environmentJSON.identity_overrides.map((identityData: any) =>
-            buildIdentityModel(identityData)
+        environmentModel.identityOverrides = environmentJSON.identity_overrides.map(
+            (identityData: any) => buildIdentityModel(identityData)
         );
     }
     return environmentModel;

package/flagsmith-engine/features/models.ts

@@ -1,4 +1,4 @@
-import { randomUUID as uuidv4 } from "node:crypto";
+import { randomUUID as uuidv4 } from 'node:crypto';
 import { getHashedPercentateForObjIds } from '../utils/hashing/index.js';
 
 export class FeatureModel {

package/flagsmith-engine/features/util.ts

@@ -19,23 +19,23 @@ export function buildFeatureStateModel(featuresStateModelJSON: any): FeatureStat
         featuresStateModelJSON.featurestate_uuid
     );
 
-    featureStateModel.featureSegment = featuresStateModelJSON.feature_segment ?
-        buildFeatureSegment(featuresStateModelJSON.feature_segment) :
-        undefined;
+    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,
-                fsv.mv_fs_value_uuid
-            );
-        })
+              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/identities/models.ts

@@ -19,7 +19,7 @@ export class IdentityModel {
         environmentApiKey: string,
         identifier: string,
         identityUuid?: string,
-        djangoID?: number,
+        djangoID?: number
     ) {
         this.identityUuid = identityUuid || uuidv4();
         this.createdDate = Date.parse(created_date) || Date.now();

package/flagsmith-engine/index.ts

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

package/flagsmith-engine/segments/evaluators.ts

@@ -67,11 +67,10 @@ export function traitsMatchSegmentCondition(
     }
     const traits = identityTraits.filter(t => t.traitKey === condition.property_);
     const trait = traits.length > 0 ? traits[0] : undefined;
-    if (condition.operator === IS_SET ) {
+    if (condition.operator === IS_SET) {
         return !!trait;
-    } else if (condition.operator === IS_NOT_SET){
+    } else if (condition.operator === IS_NOT_SET) {
         return trait == undefined;
     }
     return trait ? condition.matchesTraitValue(trait.traitValue) : false;
-
 }

package/flagsmith-engine/segments/models.ts

@@ -27,21 +27,25 @@ export const matchingFunctions = {
         thisValue >= otherValue,
     [CONDITION_OPERATORS.NOT_EQUAL]: (thisValue: any, otherValue: any) => thisValue != otherValue,
     [CONDITION_OPERATORS.CONTAINS]: (thisValue: any, otherValue: any) =>
-        !!otherValue && otherValue.includes(thisValue),
+        !!otherValue && otherValue.includes(thisValue)
 };
 
 export const semverMatchingFunction = {
     ...matchingFunctions,
-    [CONDITION_OPERATORS.EQUAL]: (thisValue: any, otherValue: any) => semver.eq(thisValue, otherValue),
-    [CONDITION_OPERATORS.GREATER_THAN]: (thisValue: any, otherValue: any) => semver.gt(otherValue, thisValue),
+    [CONDITION_OPERATORS.EQUAL]: (thisValue: any, otherValue: any) =>
+        semver.eq(thisValue, otherValue),
+    [CONDITION_OPERATORS.GREATER_THAN]: (thisValue: any, otherValue: any) =>
+        semver.gt(otherValue, thisValue),
     [CONDITION_OPERATORS.GREATER_THAN_INCLUSIVE]: (thisValue: any, otherValue: any) =>
         semver.gte(otherValue, thisValue),
-    [CONDITION_OPERATORS.LESS_THAN]: (thisValue: any, otherValue: any) => semver.gt(thisValue, otherValue),
+    [CONDITION_OPERATORS.LESS_THAN]: (thisValue: any, otherValue: any) =>
+        semver.gt(thisValue, otherValue),
     [CONDITION_OPERATORS.LESS_THAN_INCLUSIVE]: (thisValue: any, otherValue: any) =>
-        semver.gte(thisValue, otherValue),
-}
+        semver.gte(thisValue, otherValue)
+};
 
-export const getMatchingFunctions = (semver: boolean) => (semver ? semverMatchingFunction : matchingFunctions);
+export const getMatchingFunctions = (semver: boolean) =>
+    semver ? semverMatchingFunction : matchingFunctions;
 
 export class SegmentConditionModel {
     EXCEPTION_OPERATOR_METHODS: { [key: string]: string } = {
@@ -55,7 +59,11 @@ export class SegmentConditionModel {
     value: string | null | undefined;
     property_: string | null | undefined;
 
-    constructor(operator: string, value?: string | null | undefined, property?: string | null | undefined) {
+    constructor(
+        operator: string,
+        value?: string | null | undefined,
+        property?: string | null | undefined
+    ) {
         this.operator = operator;
         this.value = value;
         this.property_ = property;
@@ -64,24 +72,26 @@ export class SegmentConditionModel {
     matchesTraitValue(traitValue: any) {
         const evaluators: { [key: string]: CallableFunction } = {
             evaluateNotContains: (traitValue: any) => {
-                return typeof traitValue == "string" &&
+                return (
+                    typeof traitValue == 'string' &&
                     !!this.value &&
-                    !traitValue.includes(this.value?.toString());
+                    !traitValue.includes(this.value?.toString())
+                );
             },
             evaluateRegex: (traitValue: any) => {
                 return !!this.value && !!traitValue?.toString().match(new RegExp(this.value));
             },
             evaluateModulo: (traitValue: any) => {
                 if (isNaN(parseFloat(traitValue)) || !this.value) {
-                    return false
+                    return false;
                 }
-                const parts = (this.value).split("|");
+                const parts = this.value.split('|');
                 const [divisor, reminder] = [parseFloat(parts[0]), parseFloat(parts[1])];
-                return traitValue % divisor === reminder
+                return traitValue % divisor === reminder;
             },
             evaluateIn: (traitValue: any) => {
-                return this.value?.split(',').includes(traitValue.toString())
-            },
+                return this.value?.split(',').includes(traitValue.toString());
+            }
         };
 
         // TODO: move this logic to the evaluator module

package/flagsmith-engine/utils/hashing/index.ts

@@ -1,6 +1,6 @@
-import {BinaryLike, createHash} from "node:crypto";
+import { BinaryLike, createHash } from 'node:crypto';
 
-const md5 = (data: BinaryLike) => createHash('md5').update(data).digest('hex')
+const md5 = (data: BinaryLike) => createHash('md5').update(data).digest('hex');
 
 const makeRepeated = (arr: Array<any>, repeats: number) =>
     Array.from({ length: repeats }, () => arr).flat();
@@ -18,7 +18,7 @@ export function getHashedPercentateForObjIds(objectIds: Array<any>, iterations =
     let toHash = makeRepeated(objectIds, iterations).join(',');
     const hashedValue = md5(toHash);
     const hashedInt = BigInt('0x' + hashedValue);
-    const value = (Number((hashedInt % 9999n)) / 9998.0) * 100;
+    const value = (Number(hashedInt % 9999n) / 9998.0) * 100;
 
     // we ignore this for it's nearly impossible use case to catch
     /* istanbul ignore next */

package/flagsmith-engine/utils/index.ts

@@ -1,6 +1,8 @@
-import { removeSemverSuffix } from "../segments/util.js";
+import { removeSemverSuffix } from '../segments/util.js';
 
-export function getCastingFunction(traitType: 'boolean' | 'string' | 'number' | 'semver' | any): CallableFunction {
+export function getCastingFunction(
+    traitType: 'boolean' | 'string' | 'number' | 'semver' | any
+): CallableFunction {
     switch (traitType) {
         case 'boolean':
             return (x: any) => !['False', 'false'].includes(x);