flagsmith-nodejs 5.0.0 → 5.1.0

package/.github/workflows/pull_request.yaml

@@ -12,6 +12,9 @@ on:
       - main
 jobs:
   build-and-test:
+    strategy:
+      matrix:
+        node-version: [18.x, 20.x, 22.x]
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
@@ -19,14 +22,14 @@ jobs:
           submodules: true
       - uses: actions/setup-node@v4
         with:
-          node-version: "18.x"
+          node-version: "${{ matrix.node-version }}"
       - name: cache node modules
         uses: actions/cache@v4
         with:
           path: ~/.npm # npm cache files are stored in `~/.npm` on Linux/macOS
-          key: npm-${{ hashFiles('package-lock.json') }}
+          key: npm-${{ matrix.node-version }}-${{ hashFiles('package-lock.json') }}
           restore-keys: |
-            npm-${{ hashFiles('package-lock.json') }}
+            npm-${{ matrix.node-version }}-${{ hashFiles('package-lock.json') }}
             npm-
       - run: npm ci
       - run: npm test

package/build/cjs/index.d.ts

@@ -1,4 +1,4 @@
-export { AnalyticsProcessor, FlagsmithAPIError, FlagsmithClientError, EnvironmentDataPollingManager, FlagsmithCache, DefaultFlag, Flags, Flagsmith, } from './sdk/index.js';
+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';

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

@@ -1,7 +1,32 @@
 import { Logger } from 'pino';
 import { Fetch } from "./types.js";
+export declare const ANALYTICS_ENDPOINT = "./analytics/flags/";
+export interface AnalyticsProcessorOptions {
+    /** URL of the Flagsmith analytics events API endpoint
+     * @example https://flagsmith.example.com/api/v1/analytics
+     */
+    analyticsUrl?: string;
+    /** Client-side key of the environment that analytics will be recorded for. **/
+    environmentKey: string;
+    /** Duration in milliseconds to wait for API requests to complete before timing out. Defaults to {@link DEFAULT_REQUEST_TIMEOUT_MS}. **/
+    requestTimeoutMs?: number;
+    logger?: Logger;
+    /** Custom {@link fetch} implementation to use for API requests. **/
+    fetch?: Fetch;
+    /** @deprecated Use {@link analyticsUrl} instead. **/
+    baseApiUrl?: string;
+}
+/**
+ * Tracks how often individual features are evaluated whenever {@link trackFeature} is called.
+ *
+ * Analytics data is posted after {@link trackFeature} is called and at least {@link ANALYTICS_TIMER} seconds have
+ * passed since the previous analytics API request was made (if any), or by calling {@link flush}.
+ *
+ * Data will stay in memory indefinitely until it can be successfully posted to the API.
+ * @see https://docs.flagsmith.com/advanced-use/flag-analytics.
+ */
 export declare class AnalyticsProcessor {
-    private analyticsEndpoint;
+    private analyticsUrl;
     private environmentKey;
     private lastFlushed;
     analyticsData: {
@@ -11,25 +36,15 @@ export declare class AnalyticsProcessor {
     private logger;
     private currentFlush;
     private customFetch;
+    constructor(data: AnalyticsProcessorOptions);
     /**
-     * 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.requestTimeoutMs used to tell requests to stop waiting for a response after a
-            given number of milliseconds
+     * Try to flush pending collected data to the Flagsmith analytics API.
      */
-    constructor(data: {
-        environmentKey: string;
-        baseApiUrl: string;
-        requestTimeoutMs?: number;
-        logger?: Logger;
-        fetch?: Fetch;
-    });
+    flush(): Promise<void>;
     /**
-     * Sends all the collected data to the api asynchronously and resets the timer
+     * Track a single evaluation event for a feature.
+     *
+     * This method is called whenever {@link Flags.isFeatureEnabled}, {@link Flags.getFeatureValue} or {@link Flags.getFlag} are called.
      */
-    flush(): Promise<void>;
     trackFeature(featureName: string): void;
 }

package/build/cjs/sdk/analytics.js

@@ -1,30 +1,31 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AnalyticsProcessor = void 0;
+exports.AnalyticsProcessor = exports.ANALYTICS_ENDPOINT = void 0;
 const pino_1 = require("pino");
-const ANALYTICS_ENDPOINT = 'analytics/flags/';
-// Used to control how often we send data(in seconds)
+exports.ANALYTICS_ENDPOINT = './analytics/flags/';
+/** Duration in seconds to wait before trying to flush collected data after {@link trackFeature} is called. **/
 const ANALYTICS_TIMER = 10;
+const DEFAULT_REQUEST_TIMEOUT_MS = 3000;
+/**
+ * Tracks how often individual features are evaluated whenever {@link trackFeature} is called.
+ *
+ * Analytics data is posted after {@link trackFeature} is called and at least {@link ANALYTICS_TIMER} seconds have
+ * passed since the previous analytics API request was made (if any), or by calling {@link flush}.
+ *
+ * Data will stay in memory indefinitely until it can be successfully posted to the API.
+ * @see https://docs.flagsmith.com/advanced-use/flag-analytics.
+ */
 class AnalyticsProcessor {
-    analyticsEndpoint;
+    analyticsUrl;
     environmentKey;
     lastFlushed;
     analyticsData;
-    requestTimeoutMs = 3000;
+    requestTimeoutMs = DEFAULT_REQUEST_TIMEOUT_MS;
     logger;
     currentFlush;
     customFetch;
-    /**
-     * 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.requestTimeoutMs used to tell requests to stop waiting for a response after a
-            given number of milliseconds
-     */
     constructor(data) {
-        this.analyticsEndpoint = data.baseApiUrl + ANALYTICS_ENDPOINT;
+        this.analyticsUrl = data.analyticsUrl || data.baseApiUrl + exports.ANALYTICS_ENDPOINT;
         this.environmentKey = data.environmentKey;
         this.lastFlushed = Date.now();
         this.analyticsData = {};
@@ -33,14 +34,14 @@ class AnalyticsProcessor {
         this.customFetch = data.fetch ?? fetch;
     }
     /**
-     * Sends all the collected data to the api asynchronously and resets the timer
+     * Try to flush pending collected data to the Flagsmith analytics API.
      */
     async flush() {
         if (this.currentFlush || !Object.keys(this.analyticsData).length) {
             return;
         }
         try {
-            this.currentFlush = this.customFetch(this.analyticsEndpoint, {
+            this.currentFlush = this.customFetch(this.analyticsUrl, {
                 method: 'POST',
                 body: JSON.stringify(this.analyticsData),
                 signal: AbortSignal.timeout(this.requestTimeoutMs),
@@ -63,6 +64,11 @@ class AnalyticsProcessor {
         this.analyticsData = {};
         this.lastFlushed = Date.now();
     }
+    /**
+     * Track a single evaluation event for a feature.
+     *
+     * This method is called whenever {@link Flags.isFeatureEnabled}, {@link Flags.getFeatureValue} or {@link Flags.getFlag} are called.
+     */
     trackFeature(featureName) {
         this.analyticsData[featureName] = (this.analyticsData[featureName] || 0) + 1;
         if (Date.now() - this.lastFlushed > ANALYTICS_TIMER * 1000) {

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

@@ -6,7 +6,7 @@ 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';
-export { AnalyticsProcessor } from './analytics.js';
+export { AnalyticsProcessor, AnalyticsProcessorOptions } from './analytics.js';
 export { FlagsmithAPIError, FlagsmithClientError } from './errors.js';
 export { DefaultFlag, Flags } from './models.js';
 export { EnvironmentDataPollingManager } from './polling_manager.js';
@@ -14,6 +14,7 @@ export { FlagsmithCache, FlagsmithConfig } from './types.js';
 export declare class Flagsmith {
     environmentKey?: string;
     apiUrl?: string;
+    analyticsUrl?: string;
     customHeaders?: {
         [key: string]: any;
     };

package/build/cjs/sdk/index.js

@@ -27,6 +27,7 @@ const DEFAULT_REQUEST_TIMEOUT_SECONDS = 10;
 class Flagsmith {
     environmentKey = undefined;
     apiUrl = undefined;
+    analyticsUrl = undefined;
     customHeaders;
     agent;
     requestTimeoutMs;
@@ -125,6 +126,7 @@ class Flagsmith {
             }
             const apiUrl = data.apiUrl || DEFAULT_API_URL;
             this.apiUrl = apiUrl.endsWith('/') ? apiUrl : `${apiUrl}/`;
+            this.analyticsUrl = this.analyticsUrl || new URL(analytics_js_1.ANALYTICS_ENDPOINT, new Request(this.apiUrl).url).href;
             this.environmentFlagsUrl = `${this.apiUrl}flags/`;
             this.identitiesUrl = `${this.apiUrl}identities/`;
             this.environmentUrl = `${this.apiUrl}environment-document/`;
@@ -136,14 +138,14 @@ class Flagsmith {
                 this.environmentDataPollingManager.start();
                 this.updateEnvironment();
             }
-            this.analyticsProcessor = data.enableAnalytics
-                ? new analytics_js_1.AnalyticsProcessor({
+            if (data.enableAnalytics) {
+                this.analyticsProcessor = new analytics_js_1.AnalyticsProcessor({
                     environmentKey: this.environmentKey,
-                    baseApiUrl: this.apiUrl,
+                    analyticsUrl: this.analyticsUrl,
                     requestTimeoutMs: this.requestTimeoutMs,
-                    logger: this.logger
-                })
-                : undefined;
+                    logger: this.logger,
+                });
+            }
         }
     }
     /**

package/build/cjs/sdk/models.js

@@ -37,7 +37,7 @@ class Flag extends BaseFlag {
     static fromAPIFlag(flagData) {
         return new Flag({
             enabled: flagData['enabled'],
-            value: flagData['feature_state_value'] || flagData['value'],
+            value: flagData['feature_state_value'] ?? flagData['value'],
             featureId: flagData['feature']['id'],
             featureName: flagData['feature']['name']
         });

package/build/esm/index.d.ts

@@ -1,4 +1,4 @@
-export { AnalyticsProcessor, FlagsmithAPIError, FlagsmithClientError, EnvironmentDataPollingManager, FlagsmithCache, DefaultFlag, Flags, Flagsmith, } from './sdk/index.js';
+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';

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

@@ -1,7 +1,32 @@
 import { Logger } from 'pino';
 import { Fetch } from "./types.js";
+export declare const ANALYTICS_ENDPOINT = "./analytics/flags/";
+export interface AnalyticsProcessorOptions {
+    /** URL of the Flagsmith analytics events API endpoint
+     * @example https://flagsmith.example.com/api/v1/analytics
+     */
+    analyticsUrl?: string;
+    /** Client-side key of the environment that analytics will be recorded for. **/
+    environmentKey: string;
+    /** Duration in milliseconds to wait for API requests to complete before timing out. Defaults to {@link DEFAULT_REQUEST_TIMEOUT_MS}. **/
+    requestTimeoutMs?: number;
+    logger?: Logger;
+    /** Custom {@link fetch} implementation to use for API requests. **/
+    fetch?: Fetch;
+    /** @deprecated Use {@link analyticsUrl} instead. **/
+    baseApiUrl?: string;
+}
+/**
+ * Tracks how often individual features are evaluated whenever {@link trackFeature} is called.
+ *
+ * Analytics data is posted after {@link trackFeature} is called and at least {@link ANALYTICS_TIMER} seconds have
+ * passed since the previous analytics API request was made (if any), or by calling {@link flush}.
+ *
+ * Data will stay in memory indefinitely until it can be successfully posted to the API.
+ * @see https://docs.flagsmith.com/advanced-use/flag-analytics.
+ */
 export declare class AnalyticsProcessor {
-    private analyticsEndpoint;
+    private analyticsUrl;
     private environmentKey;
     private lastFlushed;
     analyticsData: {
@@ -11,25 +36,15 @@ export declare class AnalyticsProcessor {
     private logger;
     private currentFlush;
     private customFetch;
+    constructor(data: AnalyticsProcessorOptions);
     /**
-     * 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.requestTimeoutMs used to tell requests to stop waiting for a response after a
-            given number of milliseconds
+     * Try to flush pending collected data to the Flagsmith analytics API.
      */
-    constructor(data: {
-        environmentKey: string;
-        baseApiUrl: string;
-        requestTimeoutMs?: number;
-        logger?: Logger;
-        fetch?: Fetch;
-    });
+    flush(): Promise<void>;
     /**
-     * Sends all the collected data to the api asynchronously and resets the timer
+     * Track a single evaluation event for a feature.
+     *
+     * This method is called whenever {@link Flags.isFeatureEnabled}, {@link Flags.getFeatureValue} or {@link Flags.getFlag} are called.
      */
-    flush(): Promise<void>;
     trackFeature(featureName: string): void;
 }

package/build/esm/sdk/analytics.js

@@ -1,27 +1,28 @@
 import { pino } from 'pino';
-const ANALYTICS_ENDPOINT = 'analytics/flags/';
-// Used to control how often we send data(in seconds)
+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;
+const DEFAULT_REQUEST_TIMEOUT_MS = 3000;
+/**
+ * Tracks how often individual features are evaluated whenever {@link trackFeature} is called.
+ *
+ * Analytics data is posted after {@link trackFeature} is called and at least {@link ANALYTICS_TIMER} seconds have
+ * passed since the previous analytics API request was made (if any), or by calling {@link flush}.
+ *
+ * Data will stay in memory indefinitely until it can be successfully posted to the API.
+ * @see https://docs.flagsmith.com/advanced-use/flag-analytics.
+ */
 export class AnalyticsProcessor {
-    analyticsEndpoint;
+    analyticsUrl;
     environmentKey;
     lastFlushed;
     analyticsData;
-    requestTimeoutMs = 3000;
+    requestTimeoutMs = DEFAULT_REQUEST_TIMEOUT_MS;
     logger;
     currentFlush;
     customFetch;
-    /**
-     * 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.requestTimeoutMs used to tell requests to stop waiting for a response after a
-            given number of milliseconds
-     */
     constructor(data) {
-        this.analyticsEndpoint = data.baseApiUrl + ANALYTICS_ENDPOINT;
+        this.analyticsUrl = data.analyticsUrl || data.baseApiUrl + ANALYTICS_ENDPOINT;
         this.environmentKey = data.environmentKey;
         this.lastFlushed = Date.now();
         this.analyticsData = {};
@@ -30,14 +31,14 @@ export class AnalyticsProcessor {
         this.customFetch = data.fetch ?? fetch;
     }
     /**
-     * Sends all the collected data to the api asynchronously and resets the timer
+     * Try to flush pending collected data to the Flagsmith analytics API.
      */
     async flush() {
         if (this.currentFlush || !Object.keys(this.analyticsData).length) {
             return;
         }
         try {
-            this.currentFlush = this.customFetch(this.analyticsEndpoint, {
+            this.currentFlush = this.customFetch(this.analyticsUrl, {
                 method: 'POST',
                 body: JSON.stringify(this.analyticsData),
                 signal: AbortSignal.timeout(this.requestTimeoutMs),
@@ -60,6 +61,11 @@ export class AnalyticsProcessor {
         this.analyticsData = {};
         this.lastFlushed = Date.now();
     }
+    /**
+     * Track a single evaluation event for a feature.
+     *
+     * This method is called whenever {@link Flags.isFeatureEnabled}, {@link Flags.getFeatureValue} or {@link Flags.getFlag} are called.
+     */
     trackFeature(featureName) {
         this.analyticsData[featureName] = (this.analyticsData[featureName] || 0) + 1;
         if (Date.now() - this.lastFlushed > ANALYTICS_TIMER * 1000) {

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

@@ -6,7 +6,7 @@ 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';
-export { AnalyticsProcessor } from './analytics.js';
+export { AnalyticsProcessor, AnalyticsProcessorOptions } from './analytics.js';
 export { FlagsmithAPIError, FlagsmithClientError } from './errors.js';
 export { DefaultFlag, Flags } from './models.js';
 export { EnvironmentDataPollingManager } from './polling_manager.js';
@@ -14,6 +14,7 @@ export { FlagsmithCache, FlagsmithConfig } from './types.js';
 export declare class Flagsmith {
     environmentKey?: string;
     apiUrl?: string;
+    analyticsUrl?: string;
     customHeaders?: {
         [key: string]: any;
     };

package/build/esm/sdk/index.js

@@ -2,7 +2,7 @@ import { getEnvironmentFeatureStates, getIdentityFeatureStates } from '../flagsm
 import { buildEnvironmentModel } from '../flagsmith-engine/environments/util.js';
 import { IdentityModel } from '../flagsmith-engine/index.js';
 import { TraitModel } from '../flagsmith-engine/index.js';
-import { AnalyticsProcessor } from './analytics.js';
+import { ANALYTICS_ENDPOINT, AnalyticsProcessor } from './analytics.js';
 import { FlagsmithAPIError } from './errors.js';
 import { Flags } from './models.js';
 import { EnvironmentDataPollingManager } from './polling_manager.js';
@@ -18,6 +18,7 @@ const DEFAULT_REQUEST_TIMEOUT_SECONDS = 10;
 export class Flagsmith {
     environmentKey = undefined;
     apiUrl = undefined;
+    analyticsUrl = undefined;
     customHeaders;
     agent;
     requestTimeoutMs;
@@ -116,6 +117,7 @@ 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.environmentFlagsUrl = `${this.apiUrl}flags/`;
             this.identitiesUrl = `${this.apiUrl}identities/`;
             this.environmentUrl = `${this.apiUrl}environment-document/`;
@@ -127,14 +129,14 @@ export class Flagsmith {
                 this.environmentDataPollingManager.start();
                 this.updateEnvironment();
             }
-            this.analyticsProcessor = data.enableAnalytics
-                ? new AnalyticsProcessor({
+            if (data.enableAnalytics) {
+                this.analyticsProcessor = new AnalyticsProcessor({
                     environmentKey: this.environmentKey,
-                    baseApiUrl: this.apiUrl,
+                    analyticsUrl: this.analyticsUrl,
                     requestTimeoutMs: this.requestTimeoutMs,
-                    logger: this.logger
-                })
-                : undefined;
+                    logger: this.logger,
+                });
+            }
         }
     }
     /**

package/build/esm/sdk/models.js

@@ -32,7 +32,7 @@ export class Flag extends BaseFlag {
     static fromAPIFlag(flagData) {
         return new Flag({
             enabled: flagData['enabled'],
-            value: flagData['feature_state_value'] || flagData['value'],
+            value: flagData['feature_state_value'] ?? flagData['value'],
             featureId: flagData['feature']['id'],
             featureName: flagData['feature']['name']
         });

package/index.ts

@@ -1,5 +1,6 @@
 export {
   AnalyticsProcessor,
+  AnalyticsProcessorOptions,
   FlagsmithAPIError,
   FlagsmithClientError,
   EnvironmentDataPollingManager,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flagsmith-nodejs",
-  "version": "5.0.0",
+  "version": "5.1.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/cjs/index.js",
   "type": "module",

package/sdk/analytics.ts

@@ -1,32 +1,52 @@
 import { pino, Logger } from 'pino';
 import { Fetch } from "./types.js";
+import { Flags } from "./models.js";
 
-const ANALYTICS_ENDPOINT = 'analytics/flags/';
+export const ANALYTICS_ENDPOINT = './analytics/flags/';
 
-// Used to control how often we send data(in seconds)
+/** Duration in seconds to wait before trying to flush collected data after {@link trackFeature} is called. **/
 const ANALYTICS_TIMER = 10;
 
+const DEFAULT_REQUEST_TIMEOUT_MS = 3000
+
+export interface AnalyticsProcessorOptions {
+    /** URL of the Flagsmith analytics events API endpoint
+     * @example https://flagsmith.example.com/api/v1/analytics
+     */
+    analyticsUrl?: string;
+    /** Client-side key of the environment that analytics will be recorded for. **/
+    environmentKey: string;
+    /** Duration in milliseconds to wait for API requests to complete before timing out. Defaults to {@link DEFAULT_REQUEST_TIMEOUT_MS}. **/
+    requestTimeoutMs?: number;
+    logger?: Logger;
+    /** Custom {@link fetch} implementation to use for API requests. **/
+    fetch?: Fetch
+    
+    /** @deprecated Use {@link analyticsUrl} instead. **/
+    baseApiUrl?: string;
+}
+
+/**
+ * Tracks how often individual features are evaluated whenever {@link trackFeature} is called.
+ * 
+ * Analytics data is posted after {@link trackFeature} is called and at least {@link ANALYTICS_TIMER} seconds have
+ * passed since the previous analytics API request was made (if any), or by calling {@link flush}.
+ * 
+ * Data will stay in memory indefinitely until it can be successfully posted to the API.
+ * @see https://docs.flagsmith.com/advanced-use/flag-analytics.
+ */
 export class AnalyticsProcessor {
-    private analyticsEndpoint: string;
+    private analyticsUrl: string;
     private environmentKey: string;
     private lastFlushed: number;
     analyticsData: { [key: string]: any };
-    private requestTimeoutMs: number = 3000;
+    private requestTimeoutMs: number = DEFAULT_REQUEST_TIMEOUT_MS;
     private logger: Logger;
     private currentFlush: ReturnType<typeof fetch> | undefined;
     private customFetch: Fetch;
 
-    /**
-     * 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.requestTimeoutMs used to tell requests to stop waiting for a response after a
-            given number of milliseconds
-     */
-    constructor(data: { environmentKey: string; baseApiUrl: string; requestTimeoutMs?: number, logger?: Logger, fetch?: Fetch }) {
-        this.analyticsEndpoint = data.baseApiUrl + ANALYTICS_ENDPOINT;
+    constructor(data: AnalyticsProcessorOptions) {
+        this.analyticsUrl = data.analyticsUrl || data.baseApiUrl + ANALYTICS_ENDPOINT;
         this.environmentKey = data.environmentKey;
         this.lastFlushed = Date.now();
         this.analyticsData = {};
@@ -35,7 +55,7 @@ export class AnalyticsProcessor {
         this.customFetch = data.fetch ?? fetch;
     }
     /**
-     * Sends all the collected data to the api asynchronously and resets the timer
+     * Try to flush pending collected data to the Flagsmith analytics API.
      */
     async flush() {
         if (this.currentFlush || !Object.keys(this.analyticsData).length) {
@@ -43,7 +63,7 @@ export class AnalyticsProcessor {
         }
 
         try {
-            this.currentFlush = this.customFetch(this.analyticsEndpoint, {
+            this.currentFlush = this.customFetch(this.analyticsUrl, {
                 method: 'POST',
                 body: JSON.stringify(this.analyticsData),
                 signal: AbortSignal.timeout(this.requestTimeoutMs),
@@ -66,6 +86,11 @@ export class AnalyticsProcessor {
         this.lastFlushed = Date.now();
     }
 
+    /**
+     * Track a single evaluation event for a feature.
+     *
+     * This method is called whenever {@link Flags.isFeatureEnabled}, {@link Flags.getFeatureValue} or {@link Flags.getFlag} are called.
+     */
     trackFeature(featureName: string) {
         this.analyticsData[featureName] = (this.analyticsData[featureName] || 0) + 1;
         if (Date.now() - this.lastFlushed > ANALYTICS_TIMER * 1000) {

package/sdk/index.ts

@@ -5,7 +5,7 @@ import { buildEnvironmentModel } from '../flagsmith-engine/environments/util.js'
 import { IdentityModel } from '../flagsmith-engine/index.js';
 import { TraitModel } from '../flagsmith-engine/index.js';
 
-import { AnalyticsProcessor } from './analytics.js';
+import {ANALYTICS_ENDPOINT, AnalyticsProcessor} from './analytics.js';
 import { BaseOfflineHandler } from './offline_handlers.js';
 import { FlagsmithAPIError, FlagsmithClientError } from './errors.js';
 
@@ -17,7 +17,7 @@ import { getIdentitySegments } from '../flagsmith-engine/segments/evaluators.js'
 import { Fetch, FlagsmithCache, FlagsmithConfig, FlagsmithTraitValue, ITraitConfig } from './types.js';
 import { pino, Logger } from 'pino';
 
-export { AnalyticsProcessor } from './analytics.js';
+export { AnalyticsProcessor, AnalyticsProcessorOptions } from './analytics.js';
 export { FlagsmithAPIError, FlagsmithClientError } from './errors.js';
 
 export { DefaultFlag, Flags } from './models.js';
@@ -30,6 +30,7 @@ const DEFAULT_REQUEST_TIMEOUT_SECONDS = 10;
 export class Flagsmith {
     environmentKey?: string = undefined;
     apiUrl?: string = undefined;
+    analyticsUrl?: string = undefined;
     customHeaders?: { [key: string]: any };
     agent?: Dispatcher;
     requestTimeoutMs?: number;
@@ -138,6 +139,7 @@ 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.environmentFlagsUrl = `${this.apiUrl}flags/`;
             this.identitiesUrl = `${this.apiUrl}identities/`;
             this.environmentUrl = `${this.apiUrl}environment-document/`;
@@ -156,14 +158,14 @@ export class Flagsmith {
                 this.updateEnvironment();
             }
 
-            this.analyticsProcessor = data.enableAnalytics
-                ? new AnalyticsProcessor({
-                      environmentKey: this.environmentKey,
-                      baseApiUrl: this.apiUrl,
-                      requestTimeoutMs: this.requestTimeoutMs,
-                      logger: this.logger
-                  })
-                : undefined;
+            if (data.enableAnalytics) {
+                this.analyticsProcessor = new AnalyticsProcessor({
+                    environmentKey: this.environmentKey,
+                    analyticsUrl: this.analyticsUrl,
+                    requestTimeoutMs: this.requestTimeoutMs,
+                    logger: this.logger,
+                })
+            }
         }
     }
     /**

package/sdk/models.ts

@@ -54,7 +54,7 @@ export class Flag extends BaseFlag {
     static fromAPIFlag(flagData: any): Flag {
         return new Flag({
             enabled: flagData['enabled'],
-            value: flagData['feature_state_value'] || flagData['value'],
+            value: flagData['feature_state_value'] ?? flagData['value'],
             featureId: flagData['feature']['id'],
             featureName: flagData['feature']['name']
         });

package/tests/sdk/analytics.test.ts

@@ -26,7 +26,7 @@ test('test_analytics_processor_flush_post_request_data_match_ananlytics_data', a
     aP.trackFeature("myFeature2");
     await aP.flush();
     expect(fetch).toHaveBeenCalledTimes(1);
-    expect(fetch).toHaveBeenCalledWith('http://testUrlanalytics/flags/', expect.objectContaining({
+    expect(fetch).toHaveBeenCalledWith('http://testUrl/analytics/flags/', expect.objectContaining({
         body: '{"myFeature1":1,"myFeature2":1}',
         headers: { 'Content-Type': 'application/json', 'X-Environment-Key': 'test-key' },
         method: 'POST',

package/tests/sdk/utils.ts

@@ -24,7 +24,7 @@ export const fetch = vi.fn(global.fetch)
 export function analyticsProcessor() {
     return new AnalyticsProcessor({
         environmentKey: 'test-key',
-        baseApiUrl: 'http://testUrl',
+        analyticsUrl: 'http://testUrl/analytics/flags/',
         fetch,
     });
 }