@splitsoftware/splitio-commons 1.4.2-rc.4 → 1.4.2-rc.5

package/CHANGES.txt

@@ -1,7 +1,10 @@
-1.4.2 (June XX, 2022)
- - Added `sync.enabled` property to SDK configuration to allow synchronize splits and segments only once.
- - Updated telemetry to submit data even if user consent is not granted.
- - Updated submitters logic, to avoid duplicating the post of impressions to Split cloud when the SDK is destroyed while performing its periodic post of impressions.
+1.6.0 (June XX, 2022)
+ - Added `autoRequire` configuration option to the Google Analytics to Split integration (See https://help.split.io/hc/en-us/articles/360040838752#set-up-with-gtm-and-gtag.js).
+
+1.5.0 (June 24, 2022)
+- Added a new config option to control the tasks that listen or poll for updates on feature flags and segments, via the new config sync.enabled . Running online Split will always pull the most recent updates upon initialization, this only affects updates fetching on a running instance. Useful when a consistent session experience is a must or to save resources when updates are not being used.
+- Updated telemetry logic to track the anonymous config for user consent flag set to declined or unknown.
+- Updated submitters logic, to avoid duplicating the post of impressions to Split cloud when the SDK is destroyed while its periodic post of impressions is running.
 
 1.4.1 (June 13, 2022)
  - Bugfixing - Updated submitters logic, to avoid dropping impressions and events that are being tracked while POST request is pending.

package/cjs/integrations/ga/GaToSplit.js

@@ -10,23 +10,24 @@ var logNameMapper = 'ga-to-split:mapper';
 /**
  * Provides a plugin to use with analytics.js, accounting for the possibility
  * that the global command queue has been renamed or not yet defined.
- * @param {string} pluginName The plugin name identifier.
- * @param {Function} pluginConstructor The plugin constructor function.
+ * @param window Reference to global object.
+ * @param pluginName The plugin name identifier.
+ * @param pluginConstructor The plugin constructor function.
+ * @param log Logger instance.
+ * @param autoRequire If true, log error when auto-require script is not detected
  */
-function providePlugin(pluginName, pluginConstructor) {
+function providePlugin(window, pluginName, pluginConstructor, log, autoRequire) {
     // get reference to global command queue. Init it if not defined yet.
-    // @ts-expect-error
     var gaAlias = window.GoogleAnalyticsObject || 'ga';
     window[gaAlias] = window[gaAlias] || function () {
-        var args = [];
-        for (var _i = 0; _i < arguments.length; _i++) {
-            args[_i] = arguments[_i];
-        }
-        (window[gaAlias].q = window[gaAlias].q || []).push(args);
+        (window[gaAlias].q = window[gaAlias].q || []).push(arguments);
     };
     // provides the plugin for use with analytics.js.
-    // @ts-expect-error
     window[gaAlias]('provide', pluginName, pluginConstructor);
+    if (autoRequire && (!window[gaAlias].q || window[gaAlias].q.push === [].push)) {
+        // Expecting spy on ga.q push method but not found
+        log.error(logPrefix + 'integration is configured to autorequire the splitTracker plugin, but the necessary script does not seem to have run.');
+    }
 }
 // Default mapping: object used for building the default mapper from hits to Split events
 var defaultMapping = {
@@ -246,6 +247,6 @@ function GaToSplit(sdkOptions, params) {
         return SplitTracker;
     }());
     // Register the plugin, even if config is invalid, since, if not provided, it will block `ga` command queue.
-    providePlugin('splitTracker', SplitTracker);
+    providePlugin(window, 'splitTracker', SplitTracker, log, sdkOptions.autoRequire);
 }
 exports.GaToSplit = GaToSplit;

package/cjs/listeners/browser.js

@@ -8,12 +8,11 @@ var objectAssign_1 = require("../utils/lang/objectAssign");
 var constants_2 = require("../logger/constants");
 var consent_1 = require("../consent");
 var telemetrySubmitter_1 = require("../sync/submitters/telemetrySubmitter");
-var VISIBILITYCHANGE_EVENT = 'visibilitychange';
-var PAGEHIDE_EVENT = 'pagehide';
+// 'unload' event is used instead of 'beforeunload', since 'unload' is not a cancelable event, so no other listeners can stop the event from occurring.
 var UNLOAD_DOM_EVENT = 'unload';
 var EVENT_NAME = 'for unload page event.';
 /**
- * We'll listen for events over the window object.
+ * We'll listen for 'unload' event over the window object, since it's the standard way to listen page reload and close.
  */
 var BrowserSignalListener = /** @class */ (function () {
     function BrowserSignalListener(syncManager, settings, storage, serviceApi) {
@@ -22,43 +21,30 @@ var BrowserSignalListener = /** @class */ (function () {
         this.storage = storage;
         this.serviceApi = serviceApi;
         this.flushData = this.flushData.bind(this);
-        this.flushDataIfHidden = this.flushDataIfHidden.bind(this);
-        this.stopSync = this.stopSync.bind(this);
         this.fromImpressionsCollector = impressionsSubmitter_1.fromImpressionsCollector.bind(undefined, settings.core.labelsEnabled);
     }
     /**
      * start method.
-     * Called when SplitFactory is initialized, it adds event listeners to close streaming and flush impressions and events.
+     * Called when SplitFactory is initialized.
+     * We add a handler on unload events. The handler flushes remaining impressions and events to the backend.
      */
     BrowserSignalListener.prototype.start = function () {
         if (typeof window !== 'undefined' && window.addEventListener) {
             this.settings.log.debug(constants_2.CLEANUP_REGISTERING, [EVENT_NAME]);
-            // Flush data whenever the page is hidden or unloaded.
-            window.addEventListener(VISIBILITYCHANGE_EVENT, this.flushDataIfHidden);
-            // Some browsers like Safari does not fire the `visibilitychange` event when the page is being unloaded. So we also flush data in the `pagehide` event.
-            // If both events are triggered, the last one will find the storage empty, so no duplicated data will be submitted.
-            window.addEventListener(PAGEHIDE_EVENT, this.flushData);
-            // Stop streaming on 'unload' event. Used instead of 'beforeunload', because 'unload' is not a cancelable event, so no other listeners can stop the event from occurring.
-            window.addEventListener(UNLOAD_DOM_EVENT, this.stopSync);
+            window.addEventListener(UNLOAD_DOM_EVENT, this.flushData);
         }
     };
     /**
      * stop method.
-     * Called when client is destroyed, it removes event listeners.
+     * Called when client is destroyed.
+     * We need to remove the handler for unload events, since it can break if called when Split context was destroyed.
      */
     BrowserSignalListener.prototype.stop = function () {
         if (typeof window !== 'undefined' && window.removeEventListener) {
             this.settings.log.debug(constants_2.CLEANUP_DEREGISTERING, [EVENT_NAME]);
-            window.removeEventListener(VISIBILITYCHANGE_EVENT, this.flushDataIfHidden);
-            window.removeEventListener(PAGEHIDE_EVENT, this.flushData);
-            window.removeEventListener(UNLOAD_DOM_EVENT, this.stopSync);
+            window.removeEventListener(UNLOAD_DOM_EVENT, this.flushData);
         }
     };
-    BrowserSignalListener.prototype.stopSync = function () {
-        // Close streaming connection
-        if (this.syncManager && this.syncManager.pushManager)
-            this.syncManager.pushManager.stop();
-    };
     /**
      * flushData method.
      * Called when unload event is triggered. It flushed remaining impressions and events to the backend,
@@ -85,10 +71,9 @@ var BrowserSignalListener = /** @class */ (function () {
             var telemetryCacheAdapter = (0, telemetrySubmitter_1.telemetryCacheStatsAdapter)(this.storage.telemetry, this.storage.splits, this.storage.segments);
             this._flushData(telemetryUrl + '/v1/metrics/usage/beacon', telemetryCacheAdapter, this.serviceApi.postMetricsUsage);
         }
-    };
-    BrowserSignalListener.prototype.flushDataIfHidden = function () {
-        if (typeof document !== 'undefined' && document.visibilityState === 'hidden')
-            this.flushData(); // On a 'visibilitychange' event, flush data if state is hidden
+        // Close streaming connection
+        if (this.syncManager.pushManager)
+            this.syncManager.pushManager.stop();
     };
     BrowserSignalListener.prototype._flushData = function (url, cache, postService, fromCacheToPayload, extraMetadata) {
         // if there is data in cache, send it to backend

package/esm/integrations/ga/GaToSplit.js

@@ -7,23 +7,24 @@ var logNameMapper = 'ga-to-split:mapper';
 /**
  * Provides a plugin to use with analytics.js, accounting for the possibility
  * that the global command queue has been renamed or not yet defined.
- * @param {string} pluginName The plugin name identifier.
- * @param {Function} pluginConstructor The plugin constructor function.
+ * @param window Reference to global object.
+ * @param pluginName The plugin name identifier.
+ * @param pluginConstructor The plugin constructor function.
+ * @param log Logger instance.
+ * @param autoRequire If true, log error when auto-require script is not detected
  */
-function providePlugin(pluginName, pluginConstructor) {
+function providePlugin(window, pluginName, pluginConstructor, log, autoRequire) {
     // get reference to global command queue. Init it if not defined yet.
-    // @ts-expect-error
     var gaAlias = window.GoogleAnalyticsObject || 'ga';
     window[gaAlias] = window[gaAlias] || function () {
-        var args = [];
-        for (var _i = 0; _i < arguments.length; _i++) {
-            args[_i] = arguments[_i];
-        }
-        (window[gaAlias].q = window[gaAlias].q || []).push(args);
+        (window[gaAlias].q = window[gaAlias].q || []).push(arguments);
     };
     // provides the plugin for use with analytics.js.
-    // @ts-expect-error
     window[gaAlias]('provide', pluginName, pluginConstructor);
+    if (autoRequire && (!window[gaAlias].q || window[gaAlias].q.push === [].push)) {
+        // Expecting spy on ga.q push method but not found
+        log.error(logPrefix + 'integration is configured to autorequire the splitTracker plugin, but the necessary script does not seem to have run.');
+    }
 }
 // Default mapping: object used for building the default mapper from hits to Split events
 var defaultMapping = {
@@ -240,5 +241,5 @@ export function GaToSplit(sdkOptions, params) {
         return SplitTracker;
     }());
     // Register the plugin, even if config is invalid, since, if not provided, it will block `ga` command queue.
-    providePlugin('splitTracker', SplitTracker);
+    providePlugin(window, 'splitTracker', SplitTracker, log, sdkOptions.autoRequire);
 }

package/esm/listeners/browser.js

@@ -5,12 +5,11 @@ import { objectAssign } from '../utils/lang/objectAssign';
 import { CLEANUP_REGISTERING, CLEANUP_DEREGISTERING } from '../logger/constants';
 import { isConsentGranted } from '../consent';
 import { telemetryCacheStatsAdapter } from '../sync/submitters/telemetrySubmitter';
-var VISIBILITYCHANGE_EVENT = 'visibilitychange';
-var PAGEHIDE_EVENT = 'pagehide';
+// 'unload' event is used instead of 'beforeunload', since 'unload' is not a cancelable event, so no other listeners can stop the event from occurring.
 var UNLOAD_DOM_EVENT = 'unload';
 var EVENT_NAME = 'for unload page event.';
 /**
- * We'll listen for events over the window object.
+ * We'll listen for 'unload' event over the window object, since it's the standard way to listen page reload and close.
  */
 var BrowserSignalListener = /** @class */ (function () {
     function BrowserSignalListener(syncManager, settings, storage, serviceApi) {
@@ -19,43 +18,30 @@ var BrowserSignalListener = /** @class */ (function () {
         this.storage = storage;
         this.serviceApi = serviceApi;
         this.flushData = this.flushData.bind(this);
-        this.flushDataIfHidden = this.flushDataIfHidden.bind(this);
-        this.stopSync = this.stopSync.bind(this);
         this.fromImpressionsCollector = fromImpressionsCollector.bind(undefined, settings.core.labelsEnabled);
     }
     /**
      * start method.
-     * Called when SplitFactory is initialized, it adds event listeners to close streaming and flush impressions and events.
+     * Called when SplitFactory is initialized.
+     * We add a handler on unload events. The handler flushes remaining impressions and events to the backend.
      */
     BrowserSignalListener.prototype.start = function () {
         if (typeof window !== 'undefined' && window.addEventListener) {
             this.settings.log.debug(CLEANUP_REGISTERING, [EVENT_NAME]);
-            // Flush data whenever the page is hidden or unloaded.
-            window.addEventListener(VISIBILITYCHANGE_EVENT, this.flushDataIfHidden);
-            // Some browsers like Safari does not fire the `visibilitychange` event when the page is being unloaded. So we also flush data in the `pagehide` event.
-            // If both events are triggered, the last one will find the storage empty, so no duplicated data will be submitted.
-            window.addEventListener(PAGEHIDE_EVENT, this.flushData);
-            // Stop streaming on 'unload' event. Used instead of 'beforeunload', because 'unload' is not a cancelable event, so no other listeners can stop the event from occurring.
-            window.addEventListener(UNLOAD_DOM_EVENT, this.stopSync);
+            window.addEventListener(UNLOAD_DOM_EVENT, this.flushData);
         }
     };
     /**
      * stop method.
-     * Called when client is destroyed, it removes event listeners.
+     * Called when client is destroyed.
+     * We need to remove the handler for unload events, since it can break if called when Split context was destroyed.
      */
     BrowserSignalListener.prototype.stop = function () {
         if (typeof window !== 'undefined' && window.removeEventListener) {
             this.settings.log.debug(CLEANUP_DEREGISTERING, [EVENT_NAME]);
-            window.removeEventListener(VISIBILITYCHANGE_EVENT, this.flushDataIfHidden);
-            window.removeEventListener(PAGEHIDE_EVENT, this.flushData);
-            window.removeEventListener(UNLOAD_DOM_EVENT, this.stopSync);
+            window.removeEventListener(UNLOAD_DOM_EVENT, this.flushData);
         }
     };
-    BrowserSignalListener.prototype.stopSync = function () {
-        // Close streaming connection
-        if (this.syncManager && this.syncManager.pushManager)
-            this.syncManager.pushManager.stop();
-    };
     /**
      * flushData method.
      * Called when unload event is triggered. It flushed remaining impressions and events to the backend,
@@ -82,10 +68,9 @@ var BrowserSignalListener = /** @class */ (function () {
             var telemetryCacheAdapter = telemetryCacheStatsAdapter(this.storage.telemetry, this.storage.splits, this.storage.segments);
             this._flushData(telemetryUrl + '/v1/metrics/usage/beacon', telemetryCacheAdapter, this.serviceApi.postMetricsUsage);
         }
-    };
-    BrowserSignalListener.prototype.flushDataIfHidden = function () {
-        if (typeof document !== 'undefined' && document.visibilityState === 'hidden')
-            this.flushData(); // On a 'visibilitychange' event, flush data if state is hidden
+        // Close streaming connection
+        if (this.syncManager.pushManager)
+            this.syncManager.pushManager.stop();
     };
     BrowserSignalListener.prototype._flushData = function (url, cache, postService, fromCacheToPayload, extraMetadata) {
         // if there is data in cache, send it to backend

package/package.json

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

package/src/integrations/ga/GaToSplit.ts

@@ -19,20 +19,26 @@ const logNameMapper = 'ga-to-split:mapper';
 /**
  * Provides a plugin to use with analytics.js, accounting for the possibility
  * that the global command queue has been renamed or not yet defined.
- * @param {string} pluginName The plugin name identifier.
- * @param {Function} pluginConstructor The plugin constructor function.
+ * @param window Reference to global object.
+ * @param pluginName The plugin name identifier.
+ * @param pluginConstructor The plugin constructor function.
+ * @param log Logger instance.
+ * @param autoRequire If true, log error when auto-require script is not detected
  */
-function providePlugin(pluginName: string, pluginConstructor: Function) {
+function providePlugin(window: any, pluginName: string, pluginConstructor: Function, log: ILogger, autoRequire?: boolean) {
   // get reference to global command queue. Init it if not defined yet.
-  // @ts-expect-error
   const gaAlias = window.GoogleAnalyticsObject || 'ga';
-  window[gaAlias] = window[gaAlias] || function (...args: any[]) { // @ts-expect-error
-    (window[gaAlias].q = window[gaAlias].q || []).push(args);
+  window[gaAlias] = window[gaAlias] || function () {
+    (window[gaAlias].q = window[gaAlias].q || []).push(arguments);
   };
 
   // provides the plugin for use with analytics.js.
-  // @ts-expect-error
   window[gaAlias]('provide', pluginName, pluginConstructor);
+
+  if (autoRequire && (!window[gaAlias].q || window[gaAlias].q.push === [].push)) {
+    // Expecting spy on ga.q push method but not found
+    log.error(logPrefix + 'integration is configured to autorequire the splitTracker plugin, but the necessary script does not seem to have run.');
+  }
 }
 
 // Default mapping: object used for building the default mapper from hits to Split events
@@ -284,5 +290,5 @@ export function GaToSplit(sdkOptions: GoogleAnalyticsToSplitOptions, params: IIn
   }
 
   // Register the plugin, even if config is invalid, since, if not provided, it will block `ga` command queue.
-  providePlugin('splitTracker', SplitTracker);
+  providePlugin(window, 'splitTracker', SplitTracker, log, sdkOptions.autoRequire);
 }

package/src/integrations/ga/autoRequire.js

@@ -0,0 +1,33 @@
+/* eslint-disable no-undef */
+/**
+ * Auto-require script to use with GoogleAnalyticsToSplit integration
+ */
+(function (i, r, s) {
+  i[s] = i[s] || r;
+  i[r] = i[r] || function () { i[r].q.push(arguments); };
+  i[r].q = i[r].q || [];
+
+  var ts = {}; // Tracker names
+  function n(arg) { return typeof arg === 'object' && typeof arg.name === 'string' && arg.name; }
+
+  function p(v) { // Queue a `require` command if v is a `create` command
+    if (v && v[0] === 'create') {
+      var t = n(v[1]) || n(v[2]) || n(v[3]) || (typeof v[3] === 'string' ? v[3] : undefined); // Get tracker name
+
+      if (!ts[t]) {
+        ts[t] = true;
+        i[r]((t ? t + '.' : '') + 'require', 'splitTracker'); // Auto-require
+      }
+    }
+  }
+
+  i[r].q.forEach(function (v) { p(v); }); // Process already queued commands
+
+  var o = i[r].q.push;
+  i[r].q.push = function (v) { // Spy new queued commands
+    var result = o.apply(this, arguments);
+    p(v);
+    return result;
+  };
+
+})(window, 'ga', 'GoogleAnalyticsObject');

package/src/integrations/ga/types.ts

@@ -53,13 +53,24 @@ export interface GoogleAnalyticsToSplitOptions {
    * If not provided, events are sent using the key and traffic type provided at SDK config
    */
   identities?: Identity[],
+  /**
+   * Optional flag to log an error if the `auto-require` script is not detected.
+   * The auto-require script automatically requires the `splitTracker` plugin for created trackers,
+   * and should be placed right after your Google Analytics, GTM or gtag.js script tag.
+   *
+   * @see {@link https://help.split.io/hc/en-us/articles/360040838752#google-tag-manager}
+   *
+   * @property {boolean} autoRequire
+   * @default false
+   */
+  autoRequire?: boolean,
 }
 
 /**
  * Enable 'Google Analytics to Split' integration, to track Google Analytics hits as Split events.
  * Used by the browser variant of the isomorphic JS SDK.
  *
- * @see {@link https://help.split.io/hc/en-us/articles/360020448791-JavaScript-SDK#google-analytics-to-split}
+ * @see {@link https://help.split.io/hc/en-us/articles/360040838752#google-analytics-to-split}
  */
 export interface IGoogleAnalyticsToSplitConfig extends GoogleAnalyticsToSplitOptions {
   type: 'GOOGLE_ANALYTICS_TO_SPLIT'
@@ -129,7 +140,7 @@ export interface SplitToGoogleAnalyticsOptions {
  * Enable 'Split to Google Analytics' integration, to track Split impressions and events as Google Analytics hits.
  * Used by the browser variant of the isomorphic JS SDK.
  *
- * @see {@link https://help.split.io/hc/en-us/articles/360020448791-JavaScript-SDK#split-to-google-analytics}
+ * @see {@link https://help.split.io/hc/en-us/articles/360040838752#split-to-google-analytics}
  */
 export interface ISplitToGoogleAnalyticsConfig extends SplitToGoogleAnalyticsOptions {
   type: 'SPLIT_TO_GOOGLE_ANALYTICS'

package/src/listeners/browser.ts

@@ -14,13 +14,12 @@ import { ISyncManager } from '../sync/types';
 import { isConsentGranted } from '../consent';
 import { telemetryCacheStatsAdapter } from '../sync/submitters/telemetrySubmitter';
 
-const VISIBILITYCHANGE_EVENT = 'visibilitychange';
-const PAGEHIDE_EVENT = 'pagehide';
+// 'unload' event is used instead of 'beforeunload', since 'unload' is not a cancelable event, so no other listeners can stop the event from occurring.
 const UNLOAD_DOM_EVENT = 'unload';
 const EVENT_NAME = 'for unload page event.';
 
 /**
- * We'll listen for events over the window object.
+ * We'll listen for 'unload' event over the window object, since it's the standard way to listen page reload and close.
  */
 export class BrowserSignalListener implements ISignalListener {
 
@@ -33,47 +32,33 @@ export class BrowserSignalListener implements ISignalListener {
     private serviceApi: ISplitApi,
   ) {
     this.flushData = this.flushData.bind(this);
-    this.flushDataIfHidden = this.flushDataIfHidden.bind(this);
-    this.stopSync = this.stopSync.bind(this);
     this.fromImpressionsCollector = fromImpressionsCollector.bind(undefined, settings.core.labelsEnabled);
   }
 
   /**
    * start method.
-   * Called when SplitFactory is initialized, it adds event listeners to close streaming and flush impressions and events.
+   * Called when SplitFactory is initialized.
+   * We add a handler on unload events. The handler flushes remaining impressions and events to the backend.
    */
   start() {
     if (typeof window !== 'undefined' && window.addEventListener) {
       this.settings.log.debug(CLEANUP_REGISTERING, [EVENT_NAME]);
-
-      // Flush data whenever the page is hidden or unloaded.
-      window.addEventListener(VISIBILITYCHANGE_EVENT, this.flushDataIfHidden);
-      // Some browsers like Safari does not fire the `visibilitychange` event when the page is being unloaded. So we also flush data in the `pagehide` event.
-      // If both events are triggered, the last one will find the storage empty, so no duplicated data will be submitted.
-      window.addEventListener(PAGEHIDE_EVENT, this.flushData);
-      // Stop streaming on 'unload' event. Used instead of 'beforeunload', because 'unload' is not a cancelable event, so no other listeners can stop the event from occurring.
-      window.addEventListener(UNLOAD_DOM_EVENT, this.stopSync);
+      window.addEventListener(UNLOAD_DOM_EVENT, this.flushData);
     }
   }
 
   /**
    * stop method.
-   * Called when client is destroyed, it removes event listeners.
+   * Called when client is destroyed.
+   * We need to remove the handler for unload events, since it can break if called when Split context was destroyed.
    */
   stop() {
     if (typeof window !== 'undefined' && window.removeEventListener) {
       this.settings.log.debug(CLEANUP_DEREGISTERING, [EVENT_NAME]);
-      window.removeEventListener(VISIBILITYCHANGE_EVENT, this.flushDataIfHidden);
-      window.removeEventListener(PAGEHIDE_EVENT, this.flushData);
-      window.removeEventListener(UNLOAD_DOM_EVENT, this.stopSync);
+      window.removeEventListener(UNLOAD_DOM_EVENT, this.flushData);
     }
   }
 
-  stopSync() {
-    // Close streaming connection
-    if (this.syncManager && this.syncManager.pushManager) this.syncManager.pushManager.stop();
-  }
-
   /**
    * flushData method.
    * Called when unload event is triggered. It flushed remaining impressions and events to the backend,
@@ -101,10 +86,9 @@ export class BrowserSignalListener implements ISignalListener {
       const telemetryCacheAdapter = telemetryCacheStatsAdapter(this.storage.telemetry, this.storage.splits, this.storage.segments);
       this._flushData(telemetryUrl + '/v1/metrics/usage/beacon', telemetryCacheAdapter, this.serviceApi.postMetricsUsage);
     }
-  }
 
-  flushDataIfHidden() {
-    if (typeof document !== 'undefined' && document.visibilityState === 'hidden') this.flushData(); // On a 'visibilitychange' event, flush data if state is hidden
+    // Close streaming connection
+    if (this.syncManager.pushManager) this.syncManager.pushManager.stop();
   }
 
   private _flushData<T>(url: string, cache: IRecorderCacheProducerSync<T>, postService: (body: string) => Promise<IResponse>, fromCacheToPayload?: (cacheData: T) => any, extraMetadata?: {}) {

package/types/integrations/ga/types.d.ts

@@ -52,12 +52,23 @@ export interface GoogleAnalyticsToSplitOptions {
      * If not provided, events are sent using the key and traffic type provided at SDK config
      */
     identities?: Identity[];
+    /**
+     * Optional flag to log an error if the `auto-require` script is not detected.
+     * The auto-require script automatically requires the `splitTracker` plugin for created trackers,
+     * and should be placed right after your Google Analytics, GTM or gtag.js script tag.
+     *
+     * @see {@link https://help.split.io/hc/en-us/articles/360040838752#google-tag-manager}
+     *
+     * @property {boolean} autoRequire
+     * @default false
+     */
+    autoRequire?: boolean;
 }
 /**
  * Enable 'Google Analytics to Split' integration, to track Google Analytics hits as Split events.
  * Used by the browser variant of the isomorphic JS SDK.
  *
- * @see {@link https://help.split.io/hc/en-us/articles/360020448791-JavaScript-SDK#google-analytics-to-split}
+ * @see {@link https://help.split.io/hc/en-us/articles/360040838752#google-analytics-to-split}
  */
 export interface IGoogleAnalyticsToSplitConfig extends GoogleAnalyticsToSplitOptions {
     type: 'GOOGLE_ANALYTICS_TO_SPLIT';
@@ -125,7 +136,7 @@ export interface SplitToGoogleAnalyticsOptions {
  * Enable 'Split to Google Analytics' integration, to track Split impressions and events as Google Analytics hits.
  * Used by the browser variant of the isomorphic JS SDK.
  *
- * @see {@link https://help.split.io/hc/en-us/articles/360020448791-JavaScript-SDK#split-to-google-analytics}
+ * @see {@link https://help.split.io/hc/en-us/articles/360040838752#split-to-google-analytics}
  */
 export interface ISplitToGoogleAnalyticsConfig extends SplitToGoogleAnalyticsOptions {
     type: 'SPLIT_TO_GOOGLE_ANALYTICS';

package/types/listeners/browser.d.ts

@@ -4,7 +4,7 @@ import { ISplitApi } from '../services/types';
 import { ISettings } from '../types';
 import { ISyncManager } from '../sync/types';
 /**
- * We'll listen for events over the window object.
+ * We'll listen for 'unload' event over the window object, since it's the standard way to listen page reload and close.
  */
 export declare class BrowserSignalListener implements ISignalListener {
     private syncManager;
@@ -15,22 +15,22 @@ export declare class BrowserSignalListener implements ISignalListener {
     constructor(syncManager: ISyncManager | undefined, settings: ISettings, storage: IStorageSync, serviceApi: ISplitApi);
     /**
      * start method.
-     * Called when SplitFactory is initialized, it adds event listeners to close streaming and flush impressions and events.
+     * Called when SplitFactory is initialized.
+     * We add a handler on unload events. The handler flushes remaining impressions and events to the backend.
      */
     start(): void;
     /**
      * stop method.
-     * Called when client is destroyed, it removes event listeners.
+     * Called when client is destroyed.
+     * We need to remove the handler for unload events, since it can break if called when Split context was destroyed.
      */
     stop(): void;
-    stopSync(): void;
     /**
      * flushData method.
      * Called when unload event is triggered. It flushed remaining impressions and events to the backend,
      * using beacon API if possible, or falling back to regular post transport.
      */
     flushData(): void;
-    flushDataIfHidden(): void;
     private _flushData;
     /**
      * _sendBeacon method.