@splitsoftware/splitio-commons 3.0.0-rc.7 → 3.0.0

package/CHANGES.txt

@@ -1,4 +1,4 @@
-3.0.0 (June XX, 2026)
+3.0.0 (June 26, 2026)
  - Extracted SDK lifecycle methods (`init`, `flush`, and `destroy`) into a reusable `sdkLifecycle` module.
  - Extracted the `track` method into a standalone `trackMethod` factory for reuse across SDKs.
  - Added a bloom filter utility and platform-specific modules (`src/platform/`) for reuse across SDKs.
@@ -12,7 +12,7 @@
  - Removed the misleading warning log 'No listeners for SDK_READY event detected', since users can use the `whenReady` method to wait for the SDK to be ready.
  - BREAKING CHANGES: Renamed some types and modules, and updated the signatures of others for clarity and reusability.
 
-2.12.1 (April 30, 2026)
+2.12.1 (June 25, 2026)
  - Updated internal modules to handle `null` values from `/splitChanges` response.
  - Updated some dependencies for vulnerability fixes.
 

package/cjs/listeners/node.js

@@ -47,13 +47,13 @@ var NodeSignalListener = /** @class */ (function () {
             // eslint-disable-next-line no-undef
             process.kill(process.pid, SIGTERM);
         };
-        this.settings.log.debug("".concat(constants_1.LOG_PREFIX_CLEANUP, "Split SDK graceful shutdown after SIGTERM."));
+        this.settings.log.debug("".concat(constants_1.LOG_PREFIX_CLEANUP, "SDK graceful shutdown after SIGTERM."));
         var handlerResult = null;
         try {
             handlerResult = this.handler();
         }
         catch (err) {
-            this.settings.log.error("".concat(constants_1.LOG_PREFIX_CLEANUP, "Error with Split SDK graceful shutdown: ").concat(err));
+            this.settings.log.error("".concat(constants_1.LOG_PREFIX_CLEANUP, "Error with SDK graceful shutdown: ").concat(err));
         }
         if ((0, thenable_1.thenable)(handlerResult)) {
             // Always exit, even with errors. The promise is returned for UT purposes.

package/cjs/logger/messages/info.js

@@ -4,7 +4,7 @@ exports.codesInfo = void 0;
 var tslib_1 = require("tslib");
 var c = tslib_1.__importStar(require("../constants"));
 var warn_1 = require("./warn");
-var READY_MSG = 'Split SDK client is ready';
+var READY_MSG = 'SDK client is ready';
 exports.codesInfo = warn_1.codesWarn.concat([
     // client status
     [c.CLIENT_READY_FROM_CACHE, READY_MSG + ' from cache'],
@@ -12,7 +12,7 @@ exports.codesInfo = warn_1.codesWarn.concat([
     // SDK
     [c.IMPRESSION_QUEUEING, c.LOG_PREFIX_IMPRESSIONS_TRACKER + 'Queueing impression. %s: %s. Key: %s. Evaluation: %s. Label: %s'],
     [c.NEW_SHARED_CLIENT, 'New shared client instance created.'],
-    [c.NEW_FACTORY, 'New Split SDK instance created. %s'],
+    [c.NEW_FACTORY, 'New SDK instance created. %s'],
     [c.EVENTS_TRACKER_SUCCESS, c.LOG_PREFIX_EVENTS_TRACKER + 'Successfully queued %s'],
     [c.IMPRESSIONS_TRACKER_SUCCESS, c.LOG_PREFIX_IMPRESSIONS_TRACKER + 'Successfully stored %s impression(s).'],
     [c.USER_CONSENT_UPDATED, 'UserConsent: consent status changed from %s to %s.'],

package/cjs/logger/messages/warn.js

@@ -23,9 +23,9 @@ exports.codesWarn = error_1.codesError.concat([
     [c.WARN_TRIMMING_PROPERTIES, '%s: more than 300 properties were provided. Some of them will be trimmed when processed.'],
     [c.WARN_CONVERTING, '%s: %s "%s" is not of type string, converting.'],
     [c.WARN_TRIMMING, '%s: %s "%s" has extra whitespace, trimming.'],
-    [c.WARN_NOT_EXISTENT_DEFINITION, '%s: "%s" does not exist in this environment. Please double check that it exists in Harness UI.'],
+    [c.WARN_NOT_EXISTENT_DEFINITION, '%s: "%s" does not exist in this environment. Please double check that it exists in Harness FME UI.'],
     [c.WARN_LOWERCASE_TRAFFIC_TYPE, '%s: traffic_type_name should be all lowercase - converting string to lowercase.'],
-    [c.WARN_NOT_EXISTENT_TT, '%s: traffic type "%s" does not have any corresponding feature flag in this environment, make sure you\'re tracking your events to a valid traffic type defined in Harness UI.'],
+    [c.WARN_NOT_EXISTENT_TT, '%s: traffic type "%s" does not have any corresponding feature flag in this environment, make sure you\'re tracking your events to a valid traffic type defined in Harness FME UI.'],
     [c.WARN_FLAGSET_NOT_CONFIGURED, '%s: you passed %s which is not part of the configured FlagSetsFilter, ignoring Flag Set.'],
     // initialization / settings validation
     [c.WARN_INTEGRATION_INVALID, c.LOG_PREFIX_SETTINGS + ': %s integration item(s) at settings is invalid. %s'],
@@ -37,5 +37,5 @@ exports.codesWarn = error_1.codesError.concat([
     [c.STREAMING_PARSING_SPLIT_UPDATE, c.LOG_PREFIX_SYNC_STREAMING + 'Fetching SplitChanges due to an error processing %s notification: %s'],
     [c.WARN_INVALID_FLAGSET, '%s: you passed %s, flag set must adhere to the regular expressions %s. This means a flag set must start with a letter or number, be in lowercase, alphanumeric and have a max length of 50 characters. %s was discarded.'],
     [c.WARN_LOWERCASE_FLAGSET, '%s: flag set %s should be all lowercase - converting string to lowercase.'],
-    [c.WARN_FLAGSET_WITHOUT_FLAGS, '%s: you passed %s flag set that does not contain cached feature flag names. Please double check what flag sets are in use in Harness UI.'],
+    [c.WARN_FLAGSET_WITHOUT_FLAGS, '%s: you passed %s flag set that does not contain cached feature flag names. Please double check what flag sets are in use in Harness FME UI.'],
 ]);

package/cjs/readiness/readinessManager.js

@@ -55,7 +55,7 @@ function readinessManagerFactory(EventEmitter, settings, definitions, isShared)
             return;
         hasTimedout = true;
         syncLastUpdate();
-        gate.emit(constants_1.SDK_READY_TIMED_OUT, 'Split SDK emitted SDK_READY_TIMED_OUT event.');
+        gate.emit(constants_1.SDK_READY_TIMED_OUT, 'SDK client emitted SDK_READY_TIMED_OUT event.');
     }
     // emit SDK_READY and SDK_UPDATE
     var isReady = false;

package/cjs/readiness/sdkReadinessManager.js

@@ -79,7 +79,7 @@ function sdkReadinessManagerFactory(EventEmitter, settings, readinessManager) {
             ready: function () {
                 if (readinessManager.hasTimedout()) {
                     if (!readinessManager.isReady()) {
-                        return (0, wrapper_1.promiseWrapper)(Promise.reject(new Error('Split SDK has emitted SDK_READY_TIMED_OUT event.')), defaultOnRejected);
+                        return (0, wrapper_1.promiseWrapper)(Promise.reject(new Error('SDK client has emitted SDK_READY_TIMED_OUT event.')), defaultOnRejected);
                     }
                     else {
                         return Promise.resolve();

package/cjs/sync/polling/updaters/segmentChangesUpdater.js

@@ -84,7 +84,7 @@ function segmentChangesUpdaterFactory(log, segmentChangesFetcher, segments, read
                 // @TODO although factory status is destroyed, synchronization is not stopped
                 if (readiness)
                     readiness.setDestroyed();
-                log.error("".concat(constants_2.LOG_PREFIX_INSTANTIATION, ": you passed a client-side type authorizationKey, please grab an SDK Key from Harness UI that is of type server-side."));
+                log.error("".concat(constants_2.LOG_PREFIX_INSTANTIATION, ": you passed a client-side type authorizationKey, please grab an SDK Key from Harness FME UI that is of type server-side."));
             }
             else {
                 log.warn("".concat(constants_2.LOG_PREFIX_SYNC, "Error while doing fetch of segments. ").concat(error));

package/esm/listeners/node.js

@@ -44,13 +44,13 @@ var NodeSignalListener = /** @class */ (function () {
             // eslint-disable-next-line no-undef
             process.kill(process.pid, SIGTERM);
         };
-        this.settings.log.debug("".concat(LOG_PREFIX_CLEANUP, "Split SDK graceful shutdown after SIGTERM."));
+        this.settings.log.debug("".concat(LOG_PREFIX_CLEANUP, "SDK graceful shutdown after SIGTERM."));
         var handlerResult = null;
         try {
             handlerResult = this.handler();
         }
         catch (err) {
-            this.settings.log.error("".concat(LOG_PREFIX_CLEANUP, "Error with Split SDK graceful shutdown: ").concat(err));
+            this.settings.log.error("".concat(LOG_PREFIX_CLEANUP, "Error with SDK graceful shutdown: ").concat(err));
         }
         if (thenable(handlerResult)) {
             // Always exit, even with errors. The promise is returned for UT purposes.

package/esm/logger/messages/info.js

@@ -1,6 +1,6 @@
 import * as c from '../constants';
 import { codesWarn } from './warn';
-var READY_MSG = 'Split SDK client is ready';
+var READY_MSG = 'SDK client is ready';
 export var codesInfo = codesWarn.concat([
     // client status
     [c.CLIENT_READY_FROM_CACHE, READY_MSG + ' from cache'],
@@ -8,7 +8,7 @@ export var codesInfo = codesWarn.concat([
     // SDK
     [c.IMPRESSION_QUEUEING, c.LOG_PREFIX_IMPRESSIONS_TRACKER + 'Queueing impression. %s: %s. Key: %s. Evaluation: %s. Label: %s'],
     [c.NEW_SHARED_CLIENT, 'New shared client instance created.'],
-    [c.NEW_FACTORY, 'New Split SDK instance created. %s'],
+    [c.NEW_FACTORY, 'New SDK instance created. %s'],
     [c.EVENTS_TRACKER_SUCCESS, c.LOG_PREFIX_EVENTS_TRACKER + 'Successfully queued %s'],
     [c.IMPRESSIONS_TRACKER_SUCCESS, c.LOG_PREFIX_IMPRESSIONS_TRACKER + 'Successfully stored %s impression(s).'],
     [c.USER_CONSENT_UPDATED, 'UserConsent: consent status changed from %s to %s.'],

package/esm/logger/messages/warn.js

@@ -19,9 +19,9 @@ export var codesWarn = codesError.concat([
     [c.WARN_TRIMMING_PROPERTIES, '%s: more than 300 properties were provided. Some of them will be trimmed when processed.'],
     [c.WARN_CONVERTING, '%s: %s "%s" is not of type string, converting.'],
     [c.WARN_TRIMMING, '%s: %s "%s" has extra whitespace, trimming.'],
-    [c.WARN_NOT_EXISTENT_DEFINITION, '%s: "%s" does not exist in this environment. Please double check that it exists in Harness UI.'],
+    [c.WARN_NOT_EXISTENT_DEFINITION, '%s: "%s" does not exist in this environment. Please double check that it exists in Harness FME UI.'],
     [c.WARN_LOWERCASE_TRAFFIC_TYPE, '%s: traffic_type_name should be all lowercase - converting string to lowercase.'],
-    [c.WARN_NOT_EXISTENT_TT, '%s: traffic type "%s" does not have any corresponding feature flag in this environment, make sure you\'re tracking your events to a valid traffic type defined in Harness UI.'],
+    [c.WARN_NOT_EXISTENT_TT, '%s: traffic type "%s" does not have any corresponding feature flag in this environment, make sure you\'re tracking your events to a valid traffic type defined in Harness FME UI.'],
     [c.WARN_FLAGSET_NOT_CONFIGURED, '%s: you passed %s which is not part of the configured FlagSetsFilter, ignoring Flag Set.'],
     // initialization / settings validation
     [c.WARN_INTEGRATION_INVALID, c.LOG_PREFIX_SETTINGS + ': %s integration item(s) at settings is invalid. %s'],
@@ -33,5 +33,5 @@ export var codesWarn = codesError.concat([
     [c.STREAMING_PARSING_SPLIT_UPDATE, c.LOG_PREFIX_SYNC_STREAMING + 'Fetching SplitChanges due to an error processing %s notification: %s'],
     [c.WARN_INVALID_FLAGSET, '%s: you passed %s, flag set must adhere to the regular expressions %s. This means a flag set must start with a letter or number, be in lowercase, alphanumeric and have a max length of 50 characters. %s was discarded.'],
     [c.WARN_LOWERCASE_FLAGSET, '%s: flag set %s should be all lowercase - converting string to lowercase.'],
-    [c.WARN_FLAGSET_WITHOUT_FLAGS, '%s: you passed %s flag set that does not contain cached feature flag names. Please double check what flag sets are in use in Harness UI.'],
+    [c.WARN_FLAGSET_WITHOUT_FLAGS, '%s: you passed %s flag set that does not contain cached feature flag names. Please double check what flag sets are in use in Harness FME UI.'],
 ]);

package/esm/readiness/readinessManager.js

@@ -52,7 +52,7 @@ export function readinessManagerFactory(EventEmitter, settings, definitions, isS
             return;
         hasTimedout = true;
         syncLastUpdate();
-        gate.emit(SDK_READY_TIMED_OUT, 'Split SDK emitted SDK_READY_TIMED_OUT event.');
+        gate.emit(SDK_READY_TIMED_OUT, 'SDK client emitted SDK_READY_TIMED_OUT event.');
     }
     // emit SDK_READY and SDK_UPDATE
     var isReady = false;

package/esm/readiness/sdkReadinessManager.js

@@ -76,7 +76,7 @@ export function sdkReadinessManagerFactory(EventEmitter, settings, readinessMana
             ready: function () {
                 if (readinessManager.hasTimedout()) {
                     if (!readinessManager.isReady()) {
-                        return promiseWrapper(Promise.reject(new Error('Split SDK has emitted SDK_READY_TIMED_OUT event.')), defaultOnRejected);
+                        return promiseWrapper(Promise.reject(new Error('SDK client has emitted SDK_READY_TIMED_OUT event.')), defaultOnRejected);
                     }
                     else {
                         return Promise.resolve();

package/esm/sync/polling/updaters/segmentChangesUpdater.js

@@ -81,7 +81,7 @@ export function segmentChangesUpdaterFactory(log, segmentChangesFetcher, segment
                 // @TODO although factory status is destroyed, synchronization is not stopped
                 if (readiness)
                     readiness.setDestroyed();
-                log.error("".concat(LOG_PREFIX_INSTANTIATION, ": you passed a client-side type authorizationKey, please grab an SDK Key from Harness UI that is of type server-side."));
+                log.error("".concat(LOG_PREFIX_INSTANTIATION, ": you passed a client-side type authorizationKey, please grab an SDK Key from Harness FME UI that is of type server-side."));
             }
             else {
                 log.warn("".concat(LOG_PREFIX_SYNC, "Error while doing fetch of segments. ").concat(error));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@splitsoftware/splitio-commons",
-  "version": "3.0.0-rc.7",
+  "version": "3.0.0",
   "description": "Split JavaScript SDK common components",
   "main": "cjs/index.js",
   "module": "esm/index.js",

package/src/listeners/node.ts

@@ -58,14 +58,14 @@ export class NodeSignalListener implements ISignalListener {
       process.kill(process.pid, SIGTERM);
     };
 
-    this.settings.log.debug(`${LOG_PREFIX_CLEANUP}Split SDK graceful shutdown after SIGTERM.`);
+    this.settings.log.debug(`${LOG_PREFIX_CLEANUP}SDK graceful shutdown after SIGTERM.`);
 
     let handlerResult = null;
 
     try {
       handlerResult = this.handler();
     } catch (err) {
-      this.settings.log.error(`${LOG_PREFIX_CLEANUP}Error with Split SDK graceful shutdown: ${err}`);
+      this.settings.log.error(`${LOG_PREFIX_CLEANUP}Error with SDK graceful shutdown: ${err}`);
     }
 
     if (thenable(handlerResult)) {

package/src/logger/messages/info.ts

@@ -1,7 +1,7 @@
 import * as c from '../constants';
 import { codesWarn } from './warn';
 
-const READY_MSG = 'Split SDK client is ready';
+const READY_MSG = 'SDK client is ready';
 
 export const codesInfo: [number, string][] = codesWarn.concat([
   // client status
@@ -10,7 +10,7 @@ export const codesInfo: [number, string][] = codesWarn.concat([
   // SDK
   [c.IMPRESSION_QUEUEING, c.LOG_PREFIX_IMPRESSIONS_TRACKER +'Queueing impression. %s: %s. Key: %s. Evaluation: %s. Label: %s'],
   [c.NEW_SHARED_CLIENT, 'New shared client instance created.'],
-  [c.NEW_FACTORY, 'New Split SDK instance created. %s'],
+  [c.NEW_FACTORY, 'New SDK instance created. %s'],
   [c.EVENTS_TRACKER_SUCCESS, c.LOG_PREFIX_EVENTS_TRACKER + 'Successfully queued %s'],
   [c.IMPRESSIONS_TRACKER_SUCCESS, c.LOG_PREFIX_IMPRESSIONS_TRACKER + 'Successfully stored %s impression(s).'],
   [c.USER_CONSENT_UPDATED, 'UserConsent: consent status changed from %s to %s.'],

package/src/logger/messages/warn.ts

@@ -20,9 +20,9 @@ export const codesWarn: [number, string][] = codesError.concat([
   [c.WARN_TRIMMING_PROPERTIES, '%s: more than 300 properties were provided. Some of them will be trimmed when processed.'],
   [c.WARN_CONVERTING, '%s: %s "%s" is not of type string, converting.'],
   [c.WARN_TRIMMING, '%s: %s "%s" has extra whitespace, trimming.'],
-  [c.WARN_NOT_EXISTENT_DEFINITION, '%s: "%s" does not exist in this environment. Please double check that it exists in Harness UI.'],
+  [c.WARN_NOT_EXISTENT_DEFINITION, '%s: "%s" does not exist in this environment. Please double check that it exists in Harness FME UI.'],
   [c.WARN_LOWERCASE_TRAFFIC_TYPE, '%s: traffic_type_name should be all lowercase - converting string to lowercase.'],
-  [c.WARN_NOT_EXISTENT_TT, '%s: traffic type "%s" does not have any corresponding feature flag in this environment, make sure you\'re tracking your events to a valid traffic type defined in Harness UI.'],
+  [c.WARN_NOT_EXISTENT_TT, '%s: traffic type "%s" does not have any corresponding feature flag in this environment, make sure you\'re tracking your events to a valid traffic type defined in Harness FME UI.'],
   [c.WARN_FLAGSET_NOT_CONFIGURED, '%s: you passed %s which is not part of the configured FlagSetsFilter, ignoring Flag Set.'],
   // initialization / settings validation
   [c.WARN_INTEGRATION_INVALID, c.LOG_PREFIX_SETTINGS + ': %s integration item(s) at settings is invalid. %s'],
@@ -35,5 +35,5 @@ export const codesWarn: [number, string][] = codesError.concat([
   [c.STREAMING_PARSING_SPLIT_UPDATE, c.LOG_PREFIX_SYNC_STREAMING + 'Fetching SplitChanges due to an error processing %s notification: %s'],
   [c.WARN_INVALID_FLAGSET, '%s: you passed %s, flag set must adhere to the regular expressions %s. This means a flag set must start with a letter or number, be in lowercase, alphanumeric and have a max length of 50 characters. %s was discarded.'],
   [c.WARN_LOWERCASE_FLAGSET, '%s: flag set %s should be all lowercase - converting string to lowercase.'],
-  [c.WARN_FLAGSET_WITHOUT_FLAGS, '%s: you passed %s flag set that does not contain cached feature flag names. Please double check what flag sets are in use in Harness UI.'],
+  [c.WARN_FLAGSET_WITHOUT_FLAGS, '%s: you passed %s flag set that does not contain cached feature flag names. Please double check what flag sets are in use in Harness FME UI.'],
 ]);

package/src/readiness/readinessManager.ts

@@ -69,7 +69,7 @@ export function readinessManagerFactory(
     if (hasTimedout || isReady) return;
     hasTimedout = true;
     syncLastUpdate();
-    gate.emit(SDK_READY_TIMED_OUT, 'Split SDK emitted SDK_READY_TIMED_OUT event.');
+    gate.emit(SDK_READY_TIMED_OUT, 'SDK client emitted SDK_READY_TIMED_OUT event.');
   }
 
 

package/src/readiness/sdkReadinessManager.ts

@@ -96,7 +96,7 @@ export function sdkReadinessManagerFactory(
         ready() {
           if (readinessManager.hasTimedout()) {
             if (!readinessManager.isReady()) {
-              return promiseWrapper(Promise.reject(new Error('Split SDK has emitted SDK_READY_TIMED_OUT event.')), defaultOnRejected);
+              return promiseWrapper(Promise.reject(new Error('SDK client has emitted SDK_READY_TIMED_OUT event.')), defaultOnRejected);
             } else {
               return Promise.resolve();
             }

package/src/sync/polling/updaters/segmentChangesUpdater.ts

@@ -102,7 +102,7 @@ export function segmentChangesUpdaterFactory(
           // If the operation is forbidden, it may be due to permissions. Destroy the SDK instance.
           // @TODO although factory status is destroyed, synchronization is not stopped
           if (readiness) readiness.setDestroyed();
-          log.error(`${LOG_PREFIX_INSTANTIATION}: you passed a client-side type authorizationKey, please grab an SDK Key from Harness UI that is of type server-side.`);
+          log.error(`${LOG_PREFIX_INSTANTIATION}: you passed a client-side type authorizationKey, please grab an SDK Key from Harness FME UI that is of type server-side.`);
         } else {
           log.warn(`${LOG_PREFIX_SYNC}Error while doing fetch of segments. ${error}`);
         }

package/types/splitio.d.ts

@@ -79,7 +79,7 @@ interface ISharedSettings {
        *           'Authorization': context.headers['Authorization'] + ', other-value',
        *           'custom-header': 'custom-value'
        *         };
-       *       };
+       *       }
        *     }
        *   }
        * });
@@ -925,7 +925,7 @@ declare namespace SplitIO {
   type AsyncTreatmentWithConfig = Promise<TreatmentWithConfig>;
   /**
    * An object with the treatments with configs for a bulk of feature flags, returned by getTreatmentsWithConfig.
-   * Each existing configuration is a stringified version of the JSON you defined on the Split user interface. For example:
+   * Each existing configuration is a stringified version of the JSON you defined on Harness FME UI. For example:
    * ```
    *   {
    *     feature1: { treatment: 'on', config: null }
@@ -1080,7 +1080,7 @@ declare namespace SplitIO {
     changeNumber: number;
     /**
      * Map of configurations per treatment.
-     * Each existing configuration is a stringified version of the JSON you defined on the Split user interface.
+     * Each existing configuration is a stringified version of the JSON you defined on Harness FME UI.
      */
     configs: {
       [treatmentName: string]: string;
@@ -1599,7 +1599,7 @@ declare namespace SplitIO {
          *           'Authorization': context.headers['Authorization'] + ', other-value',
          *           'custom-header': 'custom-value'
          *         };
-         *       };
+         *       }
          *     }
          *   }
          * });
@@ -2394,7 +2394,7 @@ declare namespace SplitIO {
        * You can use it, for example, for certificate pinning or setting a network proxy:
        *
        * ```
-       * const { ConfigsClient } = require('@splitsoftware/splitio-configs');
+       * const { ConfigsClient } = require('@splitsoftware/configs');
        * const { HttpsProxyAgent } = require('https-proxy-agent');
        *
        * const proxyAgent = new HttpsProxyAgent(process.env.HTTPS_PROXY || 'http://10.10.1.10:1080');