@splitsoftware/splitio-commons 3.1.1-rc.5 → 3.1.1-rc.6

package/CHANGES.txt

@@ -1,5 +1,6 @@
-3.2.0 (August 28, 2026)
+3.2.0 (September 18, 2026)
  - Added support for AI configs.
+ - Updated submitters to allow starting and executing them when the Configs SDK is ready.
  - Removed Configs SDK-related types and modules and moved them to the Configs SDK repository.
 
 3.1.0 (July 23, 2026)

package/cjs/sync/submitters/submitterManager.js

@@ -6,41 +6,64 @@ var impressionsSubmitter_1 = require("./impressionsSubmitter");
 var impressionCountsSubmitter_1 = require("./impressionCountsSubmitter");
 var telemetrySubmitter_1 = require("./telemetrySubmitter");
 var uniqueKeysSubmitter_1 = require("./uniqueKeysSubmitter");
-function submitterManagerFactory(params) {
-    var submitters = [
-        (0, impressionsSubmitter_1.impressionsSubmitterFactory)(params),
-        (0, eventsSubmitter_1.eventsSubmitterFactory)(params),
-        (0, impressionCountsSubmitter_1.impressionCountsSubmitterFactory)(params),
-        (0, uniqueKeysSubmitter_1.uniqueKeysSubmitterFactory)(params)
-    ];
-    var telemetrySubmitter = (0, telemetrySubmitter_1.telemetrySubmitterFactory)(params);
-    return {
-        // `onlyTelemetry` true if SDK is created with userConsent not GRANTED
-        start: function (onlyTelemetry) {
+var constants_1 = require("../../readiness/constants");
+/**
+ * Creates a submitter manager.
+ *
+ * @param startWhenReady - If true, the submitters will only start and execute the underlying submitters when the SDK is ready.
+ * `true` for Configs SDK, `false` for Flags SDKs.
+ */
+function submitterManagerFactory(startWhenReady) {
+    return function (params) {
+        var readiness = params.readiness;
+        var submitters = [
+            (0, impressionsSubmitter_1.impressionsSubmitterFactory)(params),
+            (0, eventsSubmitter_1.eventsSubmitterFactory)(params),
+            (0, impressionCountsSubmitter_1.impressionCountsSubmitterFactory)(params),
+            (0, uniqueKeysSubmitter_1.uniqueKeysSubmitterFactory)(params)
+        ];
+        var telemetrySubmitter = (0, telemetrySubmitter_1.telemetrySubmitterFactory)(params);
+        var isRunning = false;
+        function startSubmitters(onlyTelemetry) {
+            if (!isRunning)
+                return;
             if (!onlyTelemetry)
                 submitters.forEach(function (submitter) { return submitter.start(); });
             if (telemetrySubmitter)
                 telemetrySubmitter.start();
-        },
-        // `allExceptTelemetry` true if userConsent is changed to DECLINED
-        stop: function (allExceptTelemetry) {
-            submitters.forEach(function (submitter) { return submitter.stop(); });
-            if (!allExceptTelemetry && telemetrySubmitter)
-                telemetrySubmitter.stop();
-        },
-        isRunning: function () {
-            return submitters.some(function (submitter) { return submitter.isRunning(); });
-        },
-        // Flush data. Called with `onlyTelemetry` true if SDK is destroyed with userConsent not GRANTED
-        execute: function (onlyTelemetry) {
-            var promises = onlyTelemetry ? [] : submitters.map(function (submitter) { return submitter.execute(); });
-            if (telemetrySubmitter)
-                promises.push(telemetrySubmitter.execute());
-            return Promise.all(promises).then(function () { });
-        },
-        isExecuting: function () {
-            return submitters.some(function (submitter) { return submitter.isExecuting(); });
         }
+        return {
+            // `onlyTelemetry` true if SDK is created with userConsent not GRANTED
+            start: function (onlyTelemetry) {
+                isRunning = true;
+                if (!startWhenReady || readiness.isReady())
+                    startSubmitters(onlyTelemetry);
+                else
+                    readiness.gate.once(constants_1.SDK_READY, function () { return startSubmitters(onlyTelemetry); });
+            },
+            // `allExceptTelemetry` true if userConsent is changed to DECLINED
+            stop: function (allExceptTelemetry) {
+                isRunning = false;
+                submitters.forEach(function (submitter) { return submitter.stop(); });
+                if (!allExceptTelemetry && telemetrySubmitter)
+                    telemetrySubmitter.stop();
+            },
+            isRunning: function () {
+                return isRunning;
+            },
+            // Flush data. Called with `onlyTelemetry` true if SDK is destroyed with userConsent not GRANTED
+            execute: function (onlyTelemetry) {
+                if (startWhenReady && !readiness.isReady())
+                    return Promise.resolve();
+                var promises = onlyTelemetry ? [] : submitters.map(function (submitter) { return submitter.execute(); });
+                if (telemetrySubmitter)
+                    promises.push(telemetrySubmitter.execute());
+                return Promise.all(promises).then(function () { });
+            },
+            isExecuting: function () {
+                return submitters.some(function (submitter) { return submitter.isExecuting(); });
+            }
+        };
     };
 }
 exports.submitterManagerFactory = submitterManagerFactory;

package/cjs/sync/syncManagerOnline.js

@@ -15,8 +15,10 @@ var AbstractDefinitionsCacheSync_1 = require("../storages/AbstractDefinitionsCac
  * @param pollingManagerFactory - allows to specialize the SyncManager for server-side or client-side API by passing
  * `pollingManagerSSFactory` or `pollingManagerCSFactory` respectively.
  * @param pushManagerFactory - optional to build a SyncManager with or without streaming support
+ * @param submitterManagerFactory - specify the submitter manager factory to use
  */
-function syncManagerOnlineFactory(pollingManagerFactory, pushManagerFactory) {
+function syncManagerOnlineFactory(pollingManagerFactory, pushManagerFactory, _submitterManagerFactory) {
+    if (_submitterManagerFactory === void 0) { _submitterManagerFactory = (0, submitterManager_1.submitterManagerFactory)(); }
     /**
      * SyncManager factory for modular SDK
      */
@@ -30,7 +32,7 @@ function syncManagerOnlineFactory(pollingManagerFactory, pushManagerFactory) {
             undefined;
         /** Submitter Manager */
         // It is not injected as push and polling managers, because at the moment it is required
-        var submitterManager = (0, submitterManager_1.submitterManagerFactory)(params);
+        var submitterManager = _submitterManagerFactory(params);
         /** Sync Manager logic */
         function startPolling() {
             if (pollingManager.isRunning()) {

package/esm/sync/submitters/submitterManager.js

@@ -3,40 +3,63 @@ import { impressionsSubmitterFactory } from './impressionsSubmitter';
 import { impressionCountsSubmitterFactory } from './impressionCountsSubmitter';
 import { telemetrySubmitterFactory } from './telemetrySubmitter';
 import { uniqueKeysSubmitterFactory } from './uniqueKeysSubmitter';
-export function submitterManagerFactory(params) {
-    var submitters = [
-        impressionsSubmitterFactory(params),
-        eventsSubmitterFactory(params),
-        impressionCountsSubmitterFactory(params),
-        uniqueKeysSubmitterFactory(params)
-    ];
-    var telemetrySubmitter = telemetrySubmitterFactory(params);
-    return {
-        // `onlyTelemetry` true if SDK is created with userConsent not GRANTED
-        start: function (onlyTelemetry) {
+import { SDK_READY } from '../../readiness/constants';
+/**
+ * Creates a submitter manager.
+ *
+ * @param startWhenReady - If true, the submitters will only start and execute the underlying submitters when the SDK is ready.
+ * `true` for Configs SDK, `false` for Flags SDKs.
+ */
+export function submitterManagerFactory(startWhenReady) {
+    return function (params) {
+        var readiness = params.readiness;
+        var submitters = [
+            impressionsSubmitterFactory(params),
+            eventsSubmitterFactory(params),
+            impressionCountsSubmitterFactory(params),
+            uniqueKeysSubmitterFactory(params)
+        ];
+        var telemetrySubmitter = telemetrySubmitterFactory(params);
+        var isRunning = false;
+        function startSubmitters(onlyTelemetry) {
+            if (!isRunning)
+                return;
             if (!onlyTelemetry)
                 submitters.forEach(function (submitter) { return submitter.start(); });
             if (telemetrySubmitter)
                 telemetrySubmitter.start();
-        },
-        // `allExceptTelemetry` true if userConsent is changed to DECLINED
-        stop: function (allExceptTelemetry) {
-            submitters.forEach(function (submitter) { return submitter.stop(); });
-            if (!allExceptTelemetry && telemetrySubmitter)
-                telemetrySubmitter.stop();
-        },
-        isRunning: function () {
-            return submitters.some(function (submitter) { return submitter.isRunning(); });
-        },
-        // Flush data. Called with `onlyTelemetry` true if SDK is destroyed with userConsent not GRANTED
-        execute: function (onlyTelemetry) {
-            var promises = onlyTelemetry ? [] : submitters.map(function (submitter) { return submitter.execute(); });
-            if (telemetrySubmitter)
-                promises.push(telemetrySubmitter.execute());
-            return Promise.all(promises).then(function () { });
-        },
-        isExecuting: function () {
-            return submitters.some(function (submitter) { return submitter.isExecuting(); });
         }
+        return {
+            // `onlyTelemetry` true if SDK is created with userConsent not GRANTED
+            start: function (onlyTelemetry) {
+                isRunning = true;
+                if (!startWhenReady || readiness.isReady())
+                    startSubmitters(onlyTelemetry);
+                else
+                    readiness.gate.once(SDK_READY, function () { return startSubmitters(onlyTelemetry); });
+            },
+            // `allExceptTelemetry` true if userConsent is changed to DECLINED
+            stop: function (allExceptTelemetry) {
+                isRunning = false;
+                submitters.forEach(function (submitter) { return submitter.stop(); });
+                if (!allExceptTelemetry && telemetrySubmitter)
+                    telemetrySubmitter.stop();
+            },
+            isRunning: function () {
+                return isRunning;
+            },
+            // Flush data. Called with `onlyTelemetry` true if SDK is destroyed with userConsent not GRANTED
+            execute: function (onlyTelemetry) {
+                if (startWhenReady && !readiness.isReady())
+                    return Promise.resolve();
+                var promises = onlyTelemetry ? [] : submitters.map(function (submitter) { return submitter.execute(); });
+                if (telemetrySubmitter)
+                    promises.push(telemetrySubmitter.execute());
+                return Promise.all(promises).then(function () { });
+            },
+            isExecuting: function () {
+                return submitters.some(function (submitter) { return submitter.isExecuting(); });
+            }
+        };
     };
 }

package/esm/sync/syncManagerOnline.js

@@ -12,8 +12,10 @@ import { usesSegmentsSync } from '../storages/AbstractDefinitionsCacheSync';
  * @param pollingManagerFactory - allows to specialize the SyncManager for server-side or client-side API by passing
  * `pollingManagerSSFactory` or `pollingManagerCSFactory` respectively.
  * @param pushManagerFactory - optional to build a SyncManager with or without streaming support
+ * @param submitterManagerFactory - specify the submitter manager factory to use
  */
-export function syncManagerOnlineFactory(pollingManagerFactory, pushManagerFactory) {
+export function syncManagerOnlineFactory(pollingManagerFactory, pushManagerFactory, _submitterManagerFactory) {
+    if (_submitterManagerFactory === void 0) { _submitterManagerFactory = submitterManagerFactory(); }
     /**
      * SyncManager factory for modular SDK
      */
@@ -27,7 +29,7 @@ export function syncManagerOnlineFactory(pollingManagerFactory, pushManagerFacto
             undefined;
         /** Submitter Manager */
         // It is not injected as push and polling managers, because at the moment it is required
-        var submitterManager = submitterManagerFactory(params);
+        var submitterManager = _submitterManagerFactory(params);
         /** Sync Manager logic */
         function startPolling() {
             if (pollingManager.isRunning()) {

package/package.json

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

package/src/sync/submitters/submitterManager.ts

@@ -5,44 +5,70 @@ import { telemetrySubmitterFactory } from './telemetrySubmitter';
 import { ISdkFactoryContextSync } from '../../sdkFactory/types';
 import { ISubmitterManager } from './types';
 import { uniqueKeysSubmitterFactory } from './uniqueKeysSubmitter';
+import { SDK_READY } from '../../readiness/constants';
 
-export function submitterManagerFactory(params: ISdkFactoryContextSync): ISubmitterManager {
+/**
+ * Creates a submitter manager.
+ *
+ * @param startWhenReady - If true, the submitters will only start and execute the underlying submitters when the SDK is ready.
+ * `true` for Configs SDK, `false` for Flags SDKs.
+ */
+export function submitterManagerFactory(startWhenReady?: boolean) {
 
-  const submitters = [
-    impressionsSubmitterFactory(params),
-    eventsSubmitterFactory(params),
-    impressionCountsSubmitterFactory(params),
-    uniqueKeysSubmitterFactory(params)
-  ];
+  return function (params: ISdkFactoryContextSync): ISubmitterManager {
 
-  const telemetrySubmitter = telemetrySubmitterFactory(params);
+    const { readiness } = params;
+
+    const submitters = [
+      impressionsSubmitterFactory(params),
+      eventsSubmitterFactory(params),
+      impressionCountsSubmitterFactory(params),
+      uniqueKeysSubmitterFactory(params)
+    ];
+
+    const telemetrySubmitter = telemetrySubmitterFactory(params);
+    let isRunning = false;
+
+    function startSubmitters(onlyTelemetry?: boolean) {
+      if (!isRunning) return;
 
-  return {
-    // `onlyTelemetry` true if SDK is created with userConsent not GRANTED
-    start(onlyTelemetry?: boolean) {
       if (!onlyTelemetry) submitters.forEach(submitter => submitter.start());
       if (telemetrySubmitter) telemetrySubmitter.start();
-    },
-
-    // `allExceptTelemetry` true if userConsent is changed to DECLINED
-    stop(allExceptTelemetry?: boolean) {
-      submitters.forEach(submitter => submitter.stop());
-      if (!allExceptTelemetry && telemetrySubmitter) telemetrySubmitter.stop();
-    },
-
-    isRunning() {
-      return submitters.some(submitter => submitter.isRunning());
-    },
-
-    // Flush data. Called with `onlyTelemetry` true if SDK is destroyed with userConsent not GRANTED
-    execute(onlyTelemetry?: boolean) {
-      const promises = onlyTelemetry ? [] : submitters.map(submitter => submitter.execute());
-      if (telemetrySubmitter) promises.push(telemetrySubmitter.execute());
-      return Promise.all(promises).then(() => { });
-    },
-
-    isExecuting() {
-      return submitters.some(submitter => submitter.isExecuting());
     }
+
+    return {
+      // `onlyTelemetry` true if SDK is created with userConsent not GRANTED
+      start(onlyTelemetry?: boolean) {
+        isRunning = true;
+
+        if (!startWhenReady || readiness.isReady()) startSubmitters(onlyTelemetry);
+        else readiness.gate.once(SDK_READY, () => startSubmitters(onlyTelemetry));
+      },
+
+      // `allExceptTelemetry` true if userConsent is changed to DECLINED
+      stop(allExceptTelemetry?: boolean) {
+        isRunning = false;
+
+        submitters.forEach(submitter => submitter.stop());
+        if (!allExceptTelemetry && telemetrySubmitter) telemetrySubmitter.stop();
+      },
+
+      isRunning() {
+        return isRunning;
+      },
+
+      // Flush data. Called with `onlyTelemetry` true if SDK is destroyed with userConsent not GRANTED
+      execute(onlyTelemetry?: boolean) {
+        if (startWhenReady && !readiness.isReady()) return Promise.resolve();
+
+        const promises = onlyTelemetry ? [] : submitters.map(submitter => submitter.execute());
+        if (telemetrySubmitter) promises.push(telemetrySubmitter.execute());
+        return Promise.all(promises).then(() => { });
+      },
+
+      isExecuting() {
+        return submitters.some(submitter => submitter.isExecuting());
+      }
+    };
   };
 }

package/src/sync/syncManagerOnline.ts

@@ -19,10 +19,12 @@ import { usesSegmentsSync } from '../storages/AbstractDefinitionsCacheSync';
  * @param pollingManagerFactory - allows to specialize the SyncManager for server-side or client-side API by passing
  * `pollingManagerSSFactory` or `pollingManagerCSFactory` respectively.
  * @param pushManagerFactory - optional to build a SyncManager with or without streaming support
+ * @param submitterManagerFactory - specify the submitter manager factory to use
  */
 export function syncManagerOnlineFactory(
   pollingManagerFactory?: (params: ISdkFactoryContextSync) => IPollingManager,
   pushManagerFactory?: (params: ISdkFactoryContextSync, pollingManager: IPollingManager) => IPushManager | undefined,
+  _submitterManagerFactory = submitterManagerFactory(),
 ): (params: ISdkFactoryContextSync) => ISyncManagerCS {
 
   /**
@@ -42,7 +44,7 @@ export function syncManagerOnlineFactory(
 
     /** Submitter Manager */
     // It is not injected as push and polling managers, because at the moment it is required
-    const submitterManager = submitterManagerFactory(params);
+    const submitterManager = _submitterManagerFactory(params);
 
     /** Sync Manager logic */