@splitsoftware/splitio-browserjs 0.10.1 → 0.10.2-rc.0

package/CHANGES.txt

@@ -1,3 +1,6 @@
+0.10.2 (October 20, 2023)
+ - Added Split Suite module for browser. The Split Suite is an extension of the SDK that sets up the Browser RUM Agent automatically. It can be imported via `import { SplitSuite } from '@splitsoftware/splitio-browserjs/suite';` or `const { SplitSuite } = require('@splitsoftware/splitio-browserjs/suite');`. See https://help.split.io/hc/en-us/articles/360030898431-Browser-RUM-agent#sdk-integration for more information.
+
 0.10.1 (September 22, 2023)
  - Updated @splitsoftware/splitio-commons package to version 1.9.1. This update removes the handler for 'unload' DOM events, that can prevent browsers from being able to put pages in the back/forward cache for faster back and forward loads (Related to issue https://github.com/splitio/javascript-client/issues/759).
 

package/cjs/settings/defaults.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.defaults = void 0;
 var index_1 = require("@splitsoftware/splitio-commons/cjs/logger/index");
 var constants_1 = require("@splitsoftware/splitio-commons/cjs/utils/constants");
-var packageVersion = '0.10.1';
+var packageVersion = '0.10.2-rc.0';
 /**
  * In browser, the default debug level, can be set via the `localStorage.splitio_debug` item.
  * Acceptable values are: 'DEBUG', 'INFO', 'WARN', 'ERROR', 'NONE'.

package/cjs/suite/browserSuite.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SplitSuite = void 0;
+var objectAssign_1 = require("@splitsoftware/splitio-commons/cjs/utils/lang/objectAssign");
+var sets_1 = require("@splitsoftware/splitio-commons/cjs/utils/lang/sets");
+var constants_1 = require("@splitsoftware/splitio-commons/cjs/utils/constants");
+var browser_rum_agent_1 = require("@splitsoftware/browser-rum-agent");
+var splitFactory_1 = require("../full/splitFactory");
+var DEFAULT_TRAFFIC_TYPE = 'user';
+/**
+ * SplitFactory for client-side with RUM Agent.
+ *
+ * @param config configuration object used to instantiate the Suite
+ * @param __updateModules optional function that lets redefine internal SDK modules. Use with
+ * caution since, unlike `config`, this param is not validated neither considered part of the public API.
+ * @throws Will throw an error if the provided config is invalid.
+ */
+function SplitSuite(config, __updateModules) {
+    var sdk = (0, splitFactory_1.SplitFactory)(config, __updateModules);
+    var settings = sdk.settings;
+    // Do not setup RUM Agent if not in standalone mode
+    if (settings.mode !== constants_1.STANDALONE_MODE)
+        return sdk;
+    // Setup RUM Agent
+    var agentConfig = browser_rum_agent_1.SplitRumAgent.__getConfig();
+    if (agentConfig.a) {
+        settings.log.warn('RUM Agent already setup. The new Suite instance will reset the RUM Agent configuration.');
+    }
+    agentConfig.log = settings.log;
+    browser_rum_agent_1.SplitRumAgent.removeIdentities(); // reset identities for new Suite
+    browser_rum_agent_1.SplitRumAgent.setup(settings.core.authorizationKey, (0, objectAssign_1.objectAssign)({
+        url: settings.urls.events,
+        userConsent: settings.userConsent
+    }, settings.rumAgent));
+    var clients = new sets_1._Set();
+    // Override UserConsent.setStatus to update RUM Agent consent
+    var originalSetStatus = sdk.UserConsent.setStatus;
+    sdk.UserConsent.setStatus = function (newStatus) {
+        browser_rum_agent_1.SplitRumAgent.setUserConsent(newStatus);
+        return originalSetStatus.apply(this, arguments);
+    };
+    // Create Suite instance extending SDK
+    return (0, objectAssign_1.objectAssign)({}, sdk, {
+        client: function () {
+            var client = sdk.client.apply(sdk, arguments);
+            if (!clients.has(client)) {
+                clients.add(client);
+                browser_rum_agent_1.SplitRumAgent.addIdentity({
+                    key: client.key,
+                    // For main client, use trafficType from settings. For shared clients, use second argument. If not provided, use default.
+                    trafficType: (arguments[0] ? arguments[1] : settings.core.trafficType) || DEFAULT_TRAFFIC_TYPE
+                });
+                // override client.destroy to remove identity from RUM Agent
+                var originalDestroy_1 = client.destroy;
+                client.destroy = function () {
+                    browser_rum_agent_1.SplitRumAgent.removeIdentity({
+                        key: client.key,
+                        trafficType: client.trafficType || DEFAULT_TRAFFIC_TYPE
+                    });
+                    return originalDestroy_1.apply(client, arguments);
+                };
+            }
+            return client;
+        },
+        destroy: function () {
+            return Promise.all((0, sets_1.setToArray)(clients).map(function (client) { return client.destroy(); }));
+        }
+    });
+}
+exports.SplitSuite = SplitSuite;

package/cjs/suite/index.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DebugLogger = exports.InfoLogger = exports.WarnLogger = exports.ErrorLogger = exports.InLocalStorage = exports.SplitSuite = void 0;
+var browserSuite_1 = require("./browserSuite");
+Object.defineProperty(exports, "SplitSuite", { enumerable: true, get: function () { return browserSuite_1.SplitSuite; } });
+var index_1 = require("@splitsoftware/splitio-commons/cjs/storages/inLocalStorage/index");
+Object.defineProperty(exports, "InLocalStorage", { enumerable: true, get: function () { return index_1.InLocalStorage; } });
+var ErrorLogger_1 = require("@splitsoftware/splitio-commons/cjs/logger/browser/ErrorLogger");
+Object.defineProperty(exports, "ErrorLogger", { enumerable: true, get: function () { return ErrorLogger_1.ErrorLogger; } });
+var WarnLogger_1 = require("@splitsoftware/splitio-commons/cjs/logger/browser/WarnLogger");
+Object.defineProperty(exports, "WarnLogger", { enumerable: true, get: function () { return WarnLogger_1.WarnLogger; } });
+var InfoLogger_1 = require("@splitsoftware/splitio-commons/cjs/logger/browser/InfoLogger");
+Object.defineProperty(exports, "InfoLogger", { enumerable: true, get: function () { return InfoLogger_1.InfoLogger; } });
+var DebugLogger_1 = require("@splitsoftware/splitio-commons/cjs/logger/browser/DebugLogger");
+Object.defineProperty(exports, "DebugLogger", { enumerable: true, get: function () { return DebugLogger_1.DebugLogger; } });

package/esm/settings/defaults.js

@@ -1,6 +1,6 @@
 import { LogLevels, isLogLevelString } from '@splitsoftware/splitio-commons/esm/logger/index';
 import { CONSENT_GRANTED } from '@splitsoftware/splitio-commons/esm/utils/constants';
-var packageVersion = '0.10.1';
+var packageVersion = '0.10.2-rc.0';
 /**
  * In browser, the default debug level, can be set via the `localStorage.splitio_debug` item.
  * Acceptable values are: 'DEBUG', 'INFO', 'WARN', 'ERROR', 'NONE'.

package/esm/suite/browserSuite.js

@@ -0,0 +1,66 @@
+import { objectAssign } from '@splitsoftware/splitio-commons/esm/utils/lang/objectAssign';
+import { _Set, setToArray } from '@splitsoftware/splitio-commons/esm/utils/lang/sets';
+import { STANDALONE_MODE } from '@splitsoftware/splitio-commons/esm/utils/constants';
+import { SplitRumAgent } from '@splitsoftware/browser-rum-agent';
+import { SplitFactory } from '../full/splitFactory';
+var DEFAULT_TRAFFIC_TYPE = 'user';
+/**
+ * SplitFactory for client-side with RUM Agent.
+ *
+ * @param config configuration object used to instantiate the Suite
+ * @param __updateModules optional function that lets redefine internal SDK modules. Use with
+ * caution since, unlike `config`, this param is not validated neither considered part of the public API.
+ * @throws Will throw an error if the provided config is invalid.
+ */
+export function SplitSuite(config, __updateModules) {
+    var sdk = SplitFactory(config, __updateModules);
+    var settings = sdk.settings;
+    // Do not setup RUM Agent if not in standalone mode
+    if (settings.mode !== STANDALONE_MODE)
+        return sdk;
+    // Setup RUM Agent
+    var agentConfig = SplitRumAgent.__getConfig();
+    if (agentConfig.a) {
+        settings.log.warn('RUM Agent already setup. The new Suite instance will reset the RUM Agent configuration.');
+    }
+    agentConfig.log = settings.log;
+    SplitRumAgent.removeIdentities(); // reset identities for new Suite
+    SplitRumAgent.setup(settings.core.authorizationKey, objectAssign({
+        url: settings.urls.events,
+        userConsent: settings.userConsent
+    }, settings.rumAgent));
+    var clients = new _Set();
+    // Override UserConsent.setStatus to update RUM Agent consent
+    var originalSetStatus = sdk.UserConsent.setStatus;
+    sdk.UserConsent.setStatus = function (newStatus) {
+        SplitRumAgent.setUserConsent(newStatus);
+        return originalSetStatus.apply(this, arguments);
+    };
+    // Create Suite instance extending SDK
+    return objectAssign({}, sdk, {
+        client: function () {
+            var client = sdk.client.apply(sdk, arguments);
+            if (!clients.has(client)) {
+                clients.add(client);
+                SplitRumAgent.addIdentity({
+                    key: client.key,
+                    // For main client, use trafficType from settings. For shared clients, use second argument. If not provided, use default.
+                    trafficType: (arguments[0] ? arguments[1] : settings.core.trafficType) || DEFAULT_TRAFFIC_TYPE
+                });
+                // override client.destroy to remove identity from RUM Agent
+                var originalDestroy_1 = client.destroy;
+                client.destroy = function () {
+                    SplitRumAgent.removeIdentity({
+                        key: client.key,
+                        trafficType: client.trafficType || DEFAULT_TRAFFIC_TYPE
+                    });
+                    return originalDestroy_1.apply(client, arguments);
+                };
+            }
+            return client;
+        },
+        destroy: function () {
+            return Promise.all(setToArray(clients).map(function (client) { return client.destroy(); }));
+        }
+    });
+}

package/esm/suite/index.js

@@ -0,0 +1,6 @@
+export { SplitSuite } from './browserSuite';
+export { InLocalStorage } from '@splitsoftware/splitio-commons/esm/storages/inLocalStorage/index';
+export { ErrorLogger } from '@splitsoftware/splitio-commons/esm/logger/browser/ErrorLogger';
+export { WarnLogger } from '@splitsoftware/splitio-commons/esm/logger/browser/WarnLogger';
+export { InfoLogger } from '@splitsoftware/splitio-commons/esm/logger/browser/InfoLogger';
+export { DebugLogger } from '@splitsoftware/splitio-commons/esm/logger/browser/DebugLogger';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@splitsoftware/splitio-browserjs",
-  "version": "0.10.1",
+  "version": "0.10.2-rc.0",
   "description": "Split SDK for JavaScript on Browser",
   "main": "cjs/index.js",
   "module": "esm/index.js",
@@ -15,7 +15,8 @@
     "src",
     "types",
     "full",
-    "scripts/ga-to-split-autorequire.js"
+    "scripts/ga-to-split-autorequire.js",
+    "suite"
   ],
   "scripts": {
     "check": "npm run check:lint && npm run check:types && npm run check:version",
@@ -30,7 +31,7 @@
     "build:ga-to-split-autorequire": "terser ./node_modules/@splitsoftware/splitio-commons/src/integrations/ga/autoRequire.js --mangle --output ./scripts/ga-to-split-autorequire.js",
     "test": "npm run test:unit && npm run test:e2e",
     "test:unit": "jest",
-    "test:e2e": "npm run test:e2e-logger && npm run test:e2e-offline && npm run test:e2e-online && npm run test:e2e-destroy && npm run test:e2e-errorCatching && npm run test:e2e-push && npm run test:e2e-gaIntegration && npm run test:e2e-consumer",
+    "test:e2e": "npm run test:e2e-logger && npm run test:e2e-offline && npm run test:e2e-online && npm run test:e2e-destroy && npm run test:e2e-errorCatching && npm run test:e2e-push && npm run test:e2e-gaIntegration && npm run test:e2e-consumer && npm run test:e2e-suite",
     "test:e2e-logger": "karma start karma/e2e.logger.karma.conf.js",
     "test:e2e-offline": "karma start karma/e2e.offline.karma.conf.js",
     "test:e2e-online": "karma start karma/e2e.online.karma.conf.js",
@@ -39,6 +40,7 @@
     "test:e2e-push": "karma start karma/e2e.push.karma.conf.js",
     "test:e2e-gaIntegration": "karma start karma/e2e.gaIntegration.karma.conf.js",
     "test:e2e-consumer": "karma start karma/e2e.consumer.karma.conf.js",
+    "test:e2e-suite": "karma start karma/e2e.suite.karma.conf.js",
     "pretest-ts-decls": "npm run build:esm && npm run build:cjs && npm link",
     "test-ts-decls": "./scripts/ts-tests.sh",
     "posttest-ts-decls": "npm rm --location=global @splitsoftware/splitio-browserjs && npm install",
@@ -64,7 +66,8 @@
   "bugs": "https://github.com/splitio/javascript-browser-client/issues",
   "homepage": "https://github.com/splitio/javascript-browser-client#readme",
   "dependencies": {
-    "@splitsoftware/splitio-commons": "1.9.1",
+    "@splitsoftware/browser-rum-agent": "0.3.2-rc.1",
+    "@splitsoftware/splitio-commons": "1.9.2-rc.2",
     "@types/google.analytics": "0.0.40",
     "unfetch": "^4.2.0"
   },

package/src/settings/defaults.ts

@@ -2,7 +2,7 @@ import { LogLevels, isLogLevelString } from '@splitsoftware/splitio-commons/src/
 import { ConsentStatus, LogLevel } from '@splitsoftware/splitio-commons/src/types';
 import { CONSENT_GRANTED } from '@splitsoftware/splitio-commons/src/utils/constants';
 
-const packageVersion = '0.10.1';
+const packageVersion = '0.10.2-rc.0';
 
 /**
  * In browser, the default debug level, can be set via the `localStorage.splitio_debug` item.

package/src/suite/browserSuite.ts

@@ -0,0 +1,80 @@
+import { objectAssign } from '@splitsoftware/splitio-commons/src/utils/lang/objectAssign';
+import { _Set, setToArray } from '@splitsoftware/splitio-commons/src/utils/lang/sets';
+import { STANDALONE_MODE } from '@splitsoftware/splitio-commons/src/utils/constants';
+import { ISdkFactoryParams } from '@splitsoftware/splitio-commons/src/sdkFactory/types';
+import { SplitRumAgent } from '@splitsoftware/browser-rum-agent';
+import { SplitFactory } from '../full/splitFactory';
+import { IBrowserSuiteSettings } from '../../types/splitio';
+
+const DEFAULT_TRAFFIC_TYPE = 'user';
+
+/**
+ * SplitFactory for client-side with RUM Agent.
+ *
+ * @param config configuration object used to instantiate the Suite
+ * @param __updateModules optional function that lets redefine internal SDK modules. Use with
+ * caution since, unlike `config`, this param is not validated neither considered part of the public API.
+ * @throws Will throw an error if the provided config is invalid.
+ */
+export function SplitSuite(config: IBrowserSuiteSettings, __updateModules?: (modules: ISdkFactoryParams) => void) {
+  const sdk = SplitFactory(config, __updateModules) as any;
+
+  const settings = sdk.settings;
+
+  // Do not setup RUM Agent if not in standalone mode
+  if (settings.mode !== STANDALONE_MODE) return sdk;
+
+  // Setup RUM Agent
+  const agentConfig = SplitRumAgent.__getConfig();
+  if (agentConfig.a) {
+    settings.log.warn('RUM Agent already setup. The new Suite instance will reset the RUM Agent configuration.');
+  }
+  agentConfig.log = settings.log;
+  SplitRumAgent.removeIdentities(); // reset identities for new Suite
+  SplitRumAgent.setup(settings.core.authorizationKey, objectAssign({
+    url: settings.urls.events,
+    userConsent: settings.userConsent
+  }, settings.rumAgent));
+
+  const clients = new _Set();
+
+  // Override UserConsent.setStatus to update RUM Agent consent
+  const originalSetStatus = sdk.UserConsent.setStatus;
+  sdk.UserConsent.setStatus = function (newStatus: boolean) {
+    SplitRumAgent.setUserConsent(newStatus);
+    return originalSetStatus.apply(this, arguments);
+  };
+
+  // Create Suite instance extending SDK
+  return objectAssign({}, sdk, {
+    client() {
+      const client = sdk.client.apply(sdk, arguments);
+
+      if (!clients.has(client)) {
+        clients.add(client);
+
+        SplitRumAgent.addIdentity({
+          key: client.key,
+          // For main client, use trafficType from settings. For shared clients, use second argument. If not provided, use default.
+          trafficType: (arguments[0] ? arguments[1] : settings.core.trafficType) || DEFAULT_TRAFFIC_TYPE
+        });
+
+        // override client.destroy to remove identity from RUM Agent
+        const originalDestroy = client.destroy;
+        client.destroy = function () {
+          SplitRumAgent.removeIdentity({
+            key: client.key,
+            trafficType: client.trafficType || DEFAULT_TRAFFIC_TYPE
+          });
+          return originalDestroy.apply(client, arguments);
+        };
+      }
+
+      return client;
+    },
+
+    destroy() {
+      return Promise.all(setToArray(clients).map(client => client.destroy()));
+    }
+  });
+}

package/src/suite/index.ts

@@ -0,0 +1,6 @@
+export { SplitSuite } from './browserSuite';
+export { InLocalStorage } from '@splitsoftware/splitio-commons/src/storages/inLocalStorage/index';
+export { ErrorLogger } from '@splitsoftware/splitio-commons/src/logger/browser/ErrorLogger';
+export { WarnLogger } from '@splitsoftware/splitio-commons/src/logger/browser/WarnLogger';
+export { InfoLogger } from '@splitsoftware/splitio-commons/src/logger/browser/InfoLogger';
+export { DebugLogger } from '@splitsoftware/splitio-commons/src/logger/browser/DebugLogger';

package/suite/package.json

@@ -0,0 +1,5 @@
+{
+  "main": "../cjs/suite/index.js",
+  "module": "../esm/suite/index.js",
+  "types": "../types/suite/index.d.ts"
+}

package/types/full/index.d.ts

@@ -67,7 +67,6 @@ declare module JsSdk {
    */
   export function WarnLogger(): SplitIO.ILogger;
 
-
   /**
    * Creates a logger instance that enables descriptive log messages with ERROR log level when passed in the factory settings.
    *

package/types/index.d.ts

@@ -67,7 +67,6 @@ declare module JsSdk {
    */
   export function WarnLogger(): SplitIO.ILogger;
 
-
   /**
    * Creates a logger instance that enables descriptive log messages with ERROR log level when passed in the factory settings.
    *

package/types/splitio.d.ts

@@ -3,6 +3,7 @@
 // Definitions by: Nico Zelaya <https://github.com/NicoZelaya/>
 
 /// <reference types="google.analytics" />
+import { SplitRumAgentConfig } from '@splitsoftware/browser-rum-agent';
 
 export as namespace SplitIO;
 export = SplitIO;
@@ -1021,6 +1022,29 @@ declare namespace SplitIO {
       pushRetryBackoffBase?: number,
     }
   }
+  /**
+   * Settings interface for Suite instances created on the browser.
+   * @interface IBrowserSuiteSettings
+   * @extends IBrowserSettings
+   * @see {@link https://help.split.io/hc/en-us/articles/360058730852-Browser-SDK#configuration}
+   */
+  interface IBrowserSuiteSettings extends IBrowserSettings {
+    core: IBrowserBasicSettings['core'] & {
+      /**
+       * Traffic type of the identity provided to the RUM Agent for event tracking. @see {@link https://help.split.io/hc/en-us/articles/360019916311-Traffic-type}
+       * If no provided, 'user' is used as default.
+       * This does not affect the behavior of the SDK client: even if provided, you still need to specify the traffic type in `client.track()` calls.
+       *
+       * @property {string=} trafficType
+       */
+      trafficType?: string,
+    },
+    /**
+     * Optional configuration object for the RUM agent.
+     * @see {@link https://help.split.io/hc/en-us/articles/360030898431-Browser-RUM-agent#configuration}
+     */
+    rumAgent?: SplitRumAgentConfig
+  }
   /**
    * Settings interface with async storage for SDK instances created on the browser.
    * If your storage is synchronous (by defaut we use memory, which is sync) use SplitIO.IBrowserSettings instead.
@@ -1143,6 +1167,41 @@ declare namespace SplitIO {
      */
     manager(): IManager
   }
+  /**
+   * This represents the interface for the Suite instance, that is an extension of the ISDK interface.
+   * @interface ISuiteSDK
+   * @extends ISDK
+   */
+  interface ISuiteSDK extends ISDK {
+    /**
+     * Returns the default client instance of the SDK and adds its identity (i.e., user key and traffic type pair) to the RUM agent for event tracking.
+     *
+     * NOTE: if no traffic type is provided in the SDK config, 'user' will be used as default for the RUM Agent.
+     *
+     * @function client
+     * @returns {IClient} The client instance.
+     */
+    client(): IClient,
+    /**
+     * Returns a shared client of the SDK and adds its identity (i.e., user key and traffic type pair) to the RUM agent for event tracking.
+     *
+     * NOTE: if no traffic type is provided as second argument, 'user' will be used as default for the RUM Agent.
+     *
+     * @function client
+     * @param {SplitKey} key The key for the new client instance.
+     * @param {string=} trafficType The traffic type of the provided key, used to pass an identity to the RUM agent. If not provided, 'user' will be used as default.
+     * @returns {IClient} The client instance.
+     */
+    client(key: SplitKey, trafficType?: string): IClient
+    /**
+     * Destroys all client instances and remove identities from the RUM agent to stop tracking events for them.
+     * This method will flush any pending impressions and events, and stop the synchronization of feature flag definitions with the backend.
+     *
+     * @function destroy
+     * @returns {Promise<void>} A promise that resolves once the client is destroyed.
+     */
+    destroy(): Promise<void>
+  }
   /**
    * This represents the interface for the SDK instance with asynchronous storage and client-side API,
    * i.e., where client instances have a bound user key.

package/types/suite/index.d.ts

@@ -0,0 +1,50 @@
+// Declaration file for JavaScript Browser Split Software SDK
+// Project: http://www.split.io/
+
+/// <reference path="../splitio.d.ts" />
+export = JsSdk;
+
+declare module JsSdk {
+  /**
+   * Split.io Suite factory function.
+   *
+   * The settings parameter should be an object that complies with the SplitIO.IBrowserSuiteSettings.
+   * For more information read the corresponding article: @see {@link https://help.split.io/hc/en-us/articles/360030898431-Browser-RUM-agent#sdk-integration}
+   */
+  export function SplitSuite(settings: SplitIO.IBrowserSuiteSettings): SplitIO.ISuiteSDK;
+
+  /**
+   * Persistent storage based on the LocalStorage Web API for browsers.
+   *
+   * @see {@link https://help.split.io/hc/en-us/articles/360058730852-Browser-SDK#storage}
+   */
+  export function InLocalStorage(options?: SplitIO.InLocalStorageOptions): SplitIO.StorageSyncFactory;
+
+  /**
+   * Creates a logger instance that enables descriptive log messages with DEBUG log level when passed in the factory settings.
+   *
+   * @see {@link https://help.split.io/hc/en-us/articles/360058730852-Browser-SDK#logging}
+   */
+  export function DebugLogger(): SplitIO.ILogger;
+
+  /**
+   * Creates a logger instance that enables descriptive log messages with INFO log level when passed in the factory settings.
+   *
+   * @see {@link https://help.split.io/hc/en-us/articles/360058730852-Browser-SDK#logging}
+   */
+  export function InfoLogger(): SplitIO.ILogger;
+
+  /**
+   * Creates a logger instance that enables descriptive log messages with WARN log level when passed in the factory settings.
+   *
+   * @see {@link https://help.split.io/hc/en-us/articles/360058730852-Browser-SDK#logging}
+   */
+  export function WarnLogger(): SplitIO.ILogger;
+
+  /**
+   * Creates a logger instance that enables descriptive log messages with ERROR log level when passed in the factory settings.
+   *
+   * @see {@link https://help.split.io/hc/en-us/articles/360058730852-Browser-SDK#logging}
+   */
+  export function ErrorLogger(): SplitIO.ILogger;
+}