@adobe/alloy 2.17.0 → 2.18.0-beta.0

package/libEs5/utils/validation/utils.js

@@ -0,0 +1,155 @@
+"use strict";
+
+exports.reverseNullSafeChainJoinErrors = exports.nullSafeChain = exports.chain = exports.assertValid = void 0;
+
+var _assign = require("../assign");
+
+/*
+Copyright 2023 Adobe. All rights reserved.
+This file is licensed to you under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License. You may obtain a copy
+of the License at http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed under
+the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+OF ANY KIND, either express or implied. See the License for the specific language
+governing permissions and limitations under the License.
+*/
+// This is used to add methods onto a function.
+
+/**
+ * Wraps a validator returning the value if it is null or undefined, otherwise
+ * it will call the original validator and return the result.
+ *
+ * @param {function} validator - the validator to call if the value is not null
+ */
+var skipIfNull = function skipIfNull(validator) {
+  return function skipIfNullValidator(value, path) {
+    return value == null ? value : validator.call(this, value, path);
+  };
+};
+/**
+ * Returns a new validator that calls the first validator and then calls the second
+ * validator with the result of the first validator. The result of the second validator
+ * is returned.
+ *
+ * @param {function} firstValidator - validator to call first
+ * @param {function} secondValidator - validator to call second
+ * @returns {function} - a new validator that calls the first and second validators
+ */
+
+
+var callSequentially = function callSequentially(firstValidator, secondValidator) {
+  return function callSequentiallyValidator(value, path) {
+    return secondValidator.call(this, firstValidator.call(this, value, path), path);
+  };
+};
+/**
+ * Just like callSequentially, but if either validator throws an error, the errors
+ * are collected and thrown at the end.
+ *
+ * @param {function} firstValidator
+ * @param {function} secondValidator
+ * @returns {function}
+ */
+
+
+var callSequentiallyJoinErrors = function callSequentiallyJoinErrors(firstValidator, secondValidator) {
+  return function callSequentiallyJoinErrorsValidator(value, path) {
+    var _this = this;
+
+    var errors = [];
+    var newValue = [firstValidator, secondValidator].reduce(function (memo, validator) {
+      try {
+        return validator.call(_this, memo, path);
+      } catch (e) {
+        errors.push(e);
+        return memo;
+      }
+    }, value);
+
+    if (errors.length) {
+      throw new Error(errors.join("\n"));
+    }
+
+    return newValue;
+  };
+};
+/**
+ * Chains two validators together. In addition to calling the validators in
+ * sequence, this will also copy over methods from the base validator to the
+ * resulting validator and include any additional methods.
+ *
+ * @param {function} baseValidator - This validator will be called first, and its
+ * methods will be copied over to the returned validator.
+ * @param {function} newValidator - This validator will be called second.
+ * @param {object} additionalMethods - Additional methods to include on the returned
+ * validator.
+ * @returns {function}
+ */
+
+
+var chain = function chain(baseValidator, newValidator, additionalMethods) {
+  return (0, _assign.default)(callSequentially(baseValidator, newValidator), baseValidator, additionalMethods);
+};
+/**
+ * Chains two validators together, but skips the second validator if the value
+ * is null. In addition to calling the validators in sequence, this will also
+ * copy over methods from the base validator to the resulting validator and
+ * include any additional methods.
+ *
+ * @param {function} baseValidator - This validator will be called first, and its
+ * methods will be copied over to the returned validator.
+ * @param {function} newValidator - This validator will be called second. If the value
+ * is null after the first validator is called, this validator will not be
+ * called.
+ * @param {object} additionalMethods - Additional methods to include on the returned
+ * validator.
+ * @returns {function}
+ */
+
+
+exports.chain = chain;
+
+var nullSafeChain = function nullSafeChain(baseValidator, newValidator, additionalMethods) {
+  return (0, _assign.default)(callSequentially(baseValidator, skipIfNull(newValidator)), baseValidator, additionalMethods);
+};
+/**
+ * Same as nullSafeChain, but calls the new validator first.
+ *
+ * @param {function} baseValidator - This validator will be called second, and its
+ * methods will be copied over to the returned validator.
+ * @param {function} newValidator - This validator will be called first. If the value
+ * is null, this validator will not be called.
+ * @param {function} additionalMethods - Additional methods to include on the returned
+ * validator.
+ * @returns {function}
+ */
+
+
+exports.nullSafeChain = nullSafeChain;
+
+var reverseNullSafeChainJoinErrors = function reverseNullSafeChainJoinErrors(baseValidator, newValidator, additionalMethods) {
+  return (0, _assign.default)(callSequentiallyJoinErrors(skipIfNull(newValidator), baseValidator), baseValidator, additionalMethods);
+};
+/**
+ * Throws an error if the value is not valid.
+ *
+ * @param {boolean} isValid - Whether or not the value is valid.
+ * @param {*} value - The value to validate.
+ * @param {string} path - The path to the value.
+ * @param {string} message - The expected part of the error message.
+ * @throws {Error} - Throws an error if the value is not valid.
+ * @returns {void}
+ */
+
+
+exports.reverseNullSafeChainJoinErrors = reverseNullSafeChainJoinErrors;
+
+var assertValid = function assertValid(isValid, value, path, message) {
+  if (!isValid) {
+    throw new Error("'" + path + "': Expected " + message + ", but got " + JSON.stringify(value) + ".");
+  }
+};
+
+exports.assertValid = assertValid;

package/libEs6/components/ActivityCollector/configValidators.js

@@ -9,9 +9,10 @@ the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTA
 OF ANY KIND, either express or implied. See the License for the specific language
 governing permissions and limitations under the License.
 */
-import { string, boolean, callback } from "../../utils/validation";
-export default {
+import { boolean, callback, objectOf, string } from "../../utils/validation";
+export const downloadLinkQualifier = string().regexp().default("\\.(exe|zip|wav|mp3|mov|mpg|avi|wmv|pdf|doc|docx|xls|xlsx|ppt|pptx)$");
+export default objectOf({
   clickCollectionEnabled: boolean().default(true),
-  downloadLinkQualifier: string().regexp().default("\\.(exe|zip|wav|mp3|mov|mpg|avi|wmv|pdf|doc|docx|xls|xlsx|ppt|pptx)$"),
-  onBeforeLinkClickSend: callback()
-};
+  onBeforeLinkClickSend: callback(),
+  downloadLinkQualifier
+});

package/libEs6/components/ActivityCollector/utils.js

@@ -54,15 +54,32 @@ const isSupportedAnchorElement = element => {
   return false;
 };
 
+const trimQueryFromUrl = url => {
+  const questionMarkIndex = url.indexOf("?");
+  const hashIndex = url.indexOf("#");
+
+  if (questionMarkIndex >= 0 && (questionMarkIndex < hashIndex || hashIndex < 0)) {
+    return url.substring(0, questionMarkIndex);
+  }
+
+  if (hashIndex >= 0) {
+    return url.substring(0, hashIndex);
+  }
+
+  return url;
+};
+
 const isDownloadLink = (downloadLinkQualifier, linkUrl, clickedObj) => {
   const re = new RegExp(downloadLinkQualifier);
-  return clickedObj.download ? true : re.test(linkUrl.toLowerCase());
+  const trimmedLinkUrl = trimQueryFromUrl(linkUrl).toLowerCase();
+  return clickedObj.download ? true : re.test(trimmedLinkUrl);
 };
 
 const isExitLink = (window, linkUrl) => {
   const currentHostname = window.location.hostname.toLowerCase();
+  const trimmedLinkUrl = trimQueryFromUrl(linkUrl).toLowerCase();
 
-  if (linkUrl.toLowerCase().indexOf(currentHostname) >= 0) {
+  if (trimmedLinkUrl.indexOf(currentHostname) >= 0) {
     return false;
   }
 
@@ -111,4 +128,4 @@ const findSupportedAnchorElement = targetElement => {
   return null;
 };
 
-export { urlStartsWithScheme, getAbsoluteUrlFromAnchorElement, isSupportedAnchorElement, isDownloadLink, isEmptyString, isExitLink, truncateWhiteSpace, findSupportedAnchorElement, determineLinkType };
+export { urlStartsWithScheme, getAbsoluteUrlFromAnchorElement, isSupportedAnchorElement, isDownloadLink, isEmptyString, isExitLink, trimQueryFromUrl, truncateWhiteSpace, findSupportedAnchorElement, determineLinkType };

package/libEs6/components/Audiences/index.js

@@ -45,5 +45,4 @@ const createAudiences = ({
 };
 
 createAudiences.namespace = "Audiences";
-createAudiences.configValidators = {};
 export default createAudiences;

package/libEs6/components/Context/index.js

@@ -17,7 +17,7 @@ import injectTimestamp from "./injectTimestamp";
 import implementationDetails from "./implementationDetails";
 import createComponent from "./createComponent";
 import injectHighEntropyUserAgentHints from "./injectHighEntropyUserAgentHints";
-import { arrayOf, string } from "../../utils/validation";
+import { arrayOf, objectOf, string } from "../../utils/validation";
 const web = injectWeb(window);
 const device = injectDevice(window);
 const environment = injectEnvironment(window);
@@ -46,7 +46,7 @@ const createContext = ({
 };
 
 createContext.namespace = "Context";
-createContext.configValidators = {
+createContext.configValidators = objectOf({
   context: arrayOf(string()).default(Object.keys(defaultEnabledContexts))
-};
+});
 export default createContext;

package/libEs6/components/DataCollector/index.js

@@ -72,7 +72,7 @@ const createDataCollector = ({
           }
 
           if (datasetId) {
-            logger.warn("The 'datasetId' option has been deprecated. Please use 'edgeConfigOverrides.experience_platform.datasets.event' instead.");
+            logger.warn("The 'datasetId' option has been deprecated. Please use 'edgeConfigOverrides.com_adobe_experience_platform.datasets.event.datasetId' instead.");
             sendEventOptions.edgeConfigOverrides = edgeConfigOverrides || {};
             deepAssign(sendEventOptions.edgeConfigOverrides, {
               com_adobe_experience_platform: {
@@ -116,5 +116,4 @@ const createDataCollector = ({
 };
 
 createDataCollector.namespace = "DataCollector";
-createDataCollector.configValidators = {};
 export default createDataCollector;

package/libEs6/components/EventMerge/index.js

@@ -19,5 +19,4 @@ const createEventMerge = () => {
 };
 
 createEventMerge.namespace = "EventMerge";
-createEventMerge.configValidators = {};
 export default createEventMerge;

package/libEs6/components/Identity/configValidators.js

@@ -9,9 +9,9 @@ the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTA
 OF ANY KIND, either express or implied. See the License for the specific language
 governing permissions and limitations under the License.
 */
-import { boolean } from "../../utils/validation";
-const configValidators = {
+import { boolean, objectOf } from "../../utils/validation";
+const configValidators = objectOf({
   thirdPartyCookiesEnabled: boolean().default(true),
   idMigrationEnabled: boolean().default(true)
-};
+});
 export default configValidators;

package/libEs6/components/Identity/getIdentity/createGetIdentity.js

@@ -9,6 +9,7 @@ the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTA
 OF ANY KIND, either express or implied. See the License for the specific language
 governing permissions and limitations under the License.
 */
+import { createRequestParams } from "../../../utils/request";
 export default (({
   sendEdgeNetworkRequest,
   createIdentityRequestPayload,
@@ -19,11 +20,12 @@ export default (({
     namespaces,
     edgeConfigOverrides: localConfigOverrides
   } = {}) => {
-    const payload = createIdentityRequestPayload(namespaces);
-    const request = createIdentityRequest(payload); // merge the configurations, but give preference to the command-local configs
-
-    payload.mergeConfigOverride(globalConfigOverrides);
-    payload.mergeConfigOverride(localConfigOverrides);
+    const requestParams = createRequestParams({
+      payload: createIdentityRequestPayload(namespaces),
+      globalConfigOverrides,
+      localConfigOverrides
+    });
+    const request = createIdentityRequest(requestParams);
     return sendEdgeNetworkRequest({
       request
     });

package/libEs6/components/Identity/getIdentity/createIdentityRequest.js

@@ -10,9 +10,13 @@ OF ANY KIND, either express or implied. See the License for the specific languag
 governing permissions and limitations under the License.
 */
 import { createRequest } from "../../../utils/request";
-export default (identityRequestPayload => {
+export default (({
+  payload,
+  datastreamIdOverride
+}) => {
   return createRequest({
-    payload: identityRequestPayload,
+    payload,
+    datastreamIdOverride,
 
     getAction() {
       return "identity/acquire";

package/libEs6/components/MachineLearning/index.js

@@ -21,5 +21,4 @@ const createMachineLearning = () => {
 };
 
 createMachineLearning.namespace = "MachineLearning";
-createMachineLearning.configValidators = {};
 export default createMachineLearning;

package/libEs6/components/Personalization/index.js

@@ -9,7 +9,7 @@ the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTA
 OF ANY KIND, either express or implied. See the License for the specific language
 governing permissions and limitations under the License.
 */
-import { string, boolean } from "../../utils/validation";
+import { string, boolean, objectOf } from "../../utils/validation";
 import createComponent from "./createComponent";
 import { initDomActionsModules, executeActions } from "./dom-actions";
 import createCollect from "./createCollect";
@@ -122,8 +122,8 @@ const createPersonalization = ({
 };
 
 createPersonalization.namespace = "Personalization";
-createPersonalization.configValidators = {
+createPersonalization.configValidators = objectOf({
   prehidingStyle: string().nonEmpty(),
   targetMigrationEnabled: boolean().default(false)
-};
+});
 export default createPersonalization;

package/libEs6/components/Privacy/createConsentRequest.js

@@ -10,9 +10,13 @@ OF ANY KIND, either express or implied. See the License for the specific languag
 governing permissions and limitations under the License.
 */
 import { createRequest } from "../../utils/request";
-export default (consentRequestPayload => {
+export default (({
+  payload,
+  datastreamIdOverride
+}) => {
   return createRequest({
-    payload: consentRequestPayload,
+    payload,
+    datastreamIdOverride,
 
     getAction() {
       return "privacy/set-consent";

package/libEs6/components/Privacy/injectSendSetConsentRequest.js

@@ -10,6 +10,7 @@ OF ANY KIND, either express or implied. See the License for the specific languag
 governing permissions and limitations under the License.
 */
 import { isObject } from "../../utils";
+import { createRequestParams } from "../../utils/request";
 export default (({
   createConsentRequestPayload,
   createConsentRequest,
@@ -20,20 +21,22 @@ export default (({
   identityMap,
   edgeConfigOverrides: localConfigOverrides
 }) => {
-  const payload = createConsentRequestPayload();
-  payload.setConsent(consentOptions);
-  payload.mergeConfigOverride(globalConfigOverrides);
-  payload.mergeConfigOverride(localConfigOverrides);
+  const requestParams = createRequestParams({
+    payload: createConsentRequestPayload(),
+    globalConfigOverrides,
+    localConfigOverrides
+  });
+  requestParams.payload.setConsent(consentOptions);
 
   if (isObject(identityMap)) {
     Object.keys(identityMap).forEach(key => {
       identityMap[key].forEach(identity => {
-        payload.addIdentity(key, identity);
+        requestParams.payload.addIdentity(key, identity);
       });
     });
   }
 
-  const request = createConsentRequest(payload);
+  const request = createConsentRequest(requestParams);
   return sendEdgeNetworkRequest({
     request
   }).then(() => {// Don't let response data disseminate beyond this

package/libEs6/constants/libraryVersion.js

@@ -11,4 +11,4 @@ governing permissions and limitations under the License.
 */
 // The __VERSION__ keyword will be replace at alloy build time with the package.json version.
 // see babel-plugin-version
-export default "2.17.0";
+export default "2.18.0-beta.0";

package/libEs6/core/buildAndValidateConfig.js

@@ -10,25 +10,18 @@ OF ANY KIND, either express or implied. See the License for the specific languag
 governing permissions and limitations under the License.
 */
 import { assign } from "../utils";
-import { objectOf } from "../utils/validation";
 const CONFIG_DOC_URI = "https://adobe.ly/3sHh553";
 
-const buildSchema = (coreConfigValidators, componentCreators) => {
-  const schema = {};
-  assign(schema, coreConfigValidators);
-  componentCreators.forEach(createComponent => {
-    const {
-      configValidators
-    } = createComponent;
-    assign(schema, configValidators);
-  });
-  return schema;
-};
-
-const transformOptions = (schema, options) => {
+const transformOptions = ({
+  combinedConfigValidator,
+  options,
+  logger
+}) => {
   try {
-    const validator = objectOf(schema).noUnknownFields().required();
-    return validator(options);
+    const validator = combinedConfigValidator.noUnknownFields().required();
+    return validator.call({
+      logger
+    }, options);
   } catch (e) {
     throw new Error(`Resolve these configuration problems:\n\t - ${e.message.split("\n").join("\n\t - ")}\nFor configuration documentation see: ${CONFIG_DOC_URI}`);
   }
@@ -49,6 +42,32 @@ const buildAllOnInstanceConfiguredExtraParams = (config, logger, componentCreato
   }, {});
 };
 
+const wrapLoggerInQueue = logger => {
+  const queue = [];
+  const queuedLogger = {
+    get enabled() {
+      return logger.enabled;
+    },
+
+    flush() {
+      queue.forEach(({
+        method,
+        args
+      }) => logger[method](...args));
+    }
+
+  };
+  Object.keys(logger).filter(key => typeof logger[key] === "function").forEach(method => {
+    queuedLogger[method] = (...args) => {
+      queue.push({
+        method,
+        args
+      });
+    };
+  });
+  return queuedLogger;
+};
+
 export default (({
   options,
   componentCreators,
@@ -57,11 +76,21 @@ export default (({
   logger,
   setDebugEnabled
 }) => {
-  const schema = buildSchema(coreConfigValidators, componentCreators);
-  const config = createConfig(transformOptions(schema, options));
+  // We wrap the logger in a queue in case debugEnabled is set in the config
+  // but we need to log something before the config is created.
+  const queuedLogger = wrapLoggerInQueue(logger);
+  const combinedConfigValidator = componentCreators.map(({
+    configValidators
+  }) => configValidators).filter(configValidators => configValidators).reduce((validator, configValidators) => validator.concat(configValidators), coreConfigValidators);
+  const config = createConfig(transformOptions({
+    combinedConfigValidator,
+    options,
+    logger: queuedLogger
+  }));
   setDebugEnabled(config.debugEnabled, {
     fromConfig: true
-  }); // eslint-disable-next-line no-underscore-dangle
+  });
+  queuedLogger.flush(); // eslint-disable-next-line no-underscore-dangle
 
   const extraParams = buildAllOnInstanceConfiguredExtraParams(config, logger, componentCreators);
   logger.logOnInstanceConfigured({ ...extraParams,

package/libEs6/core/config/createCoreConfigs.js

@@ -9,18 +9,18 @@ the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTA
 OF ANY KIND, either express or implied. See the License for the specific language
 governing permissions and limitations under the License.
 */
-import { boolean, string, callback, enumOf } from "../../utils/validation";
+import { boolean, string, callback, enumOf, objectOf } from "../../utils/validation";
 import { noop, validateConfigOverride } from "../../utils";
 import { EDGE as EDGE_DOMAIN } from "../../constants/domain";
 import EDGE_BASE_PATH from "../../constants/edgeBasePath";
 import { IN, OUT, PENDING } from "../../constants/consentStatus";
-export default (() => ({
+export default (() => objectOf({
   debugEnabled: boolean().default(false),
   defaultConsent: enumOf(IN, OUT, PENDING).default(IN),
-  edgeConfigId: string().unique().required(),
+  datastreamId: string().unique().required(),
   edgeDomain: string().domain().default(EDGE_DOMAIN),
   edgeBasePath: string().nonEmpty().default(EDGE_BASE_PATH),
   orgId: string().unique().required(),
   onBeforeEventSend: callback().default(noop),
   edgeConfigOverrides: validateConfigOverride
-}));
+}).deprecated("edgeConfigId", string().unique(), "datastreamId"));

package/libEs6/core/createEventManager.js

@@ -11,6 +11,7 @@ governing permissions and limitations under the License.
 */
 import PAGE_WIDE_SCOPE from "../constants/pageWideScope";
 import { createCallbackAggregator, noop } from "../utils";
+import { createRequestParams } from "../utils/request";
 const EVENT_CANCELLATION_MESSAGE = "Event was canceled because the onBeforeEventSend callback returned false.";
 export default (({
   config,
@@ -44,6 +45,9 @@ export default (({
      * @param {Object} [options.serverState]
      * This will be passed to components
      * so they can take appropriate action.
+     * @param {Object} [options.edgeConfigOverrides] Settings that take
+     * precedence over the global datastream configuration, including which
+     * datastream to use.
      * @returns {*}
      */
     sendEvent(event, options = {}) {
@@ -53,12 +57,14 @@ export default (({
         edgeConfigOverrides: localConfigOverrides,
         personalization
       } = options;
-      const payload = createDataCollectionRequestPayload();
-      const request = createDataCollectionRequest(payload);
+      const requestParams = createRequestParams({
+        payload: createDataCollectionRequestPayload(),
+        localConfigOverrides,
+        globalConfigOverrides
+      });
+      const request = createDataCollectionRequest(requestParams);
       const onResponseCallbackAggregator = createCallbackAggregator();
       const onRequestFailureCallbackAggregator = createCallbackAggregator();
-      payload.mergeConfigOverride(globalConfigOverrides);
-      payload.mergeConfigOverride(localConfigOverrides);
       return lifecycle.onBeforeEvent({
         event,
         renderDecisions,
@@ -67,7 +73,7 @@ export default (({
         onResponse: onResponseCallbackAggregator.add,
         onRequestFailure: onRequestFailureCallbackAggregator.add
       }).then(() => {
-        payload.addEvent(event);
+        requestParams.payload.addEvent(event);
         return consent.awaitConsent();
       }).then(() => {
         try {
@@ -113,7 +119,9 @@ export default (({
         }
       } = options;
       const payload = createDataCollectionRequestPayload();
-      const request = createDataCollectionRequest(payload);
+      const request = createDataCollectionRequest({
+        payload
+      });
       const onResponseCallbackAggregator = createCallbackAggregator();
       return lifecycle.onBeforeEvent({
         event,

package/libEs6/core/edgeNetwork/injectSendEdgeNetworkRequest.js

@@ -27,7 +27,7 @@ export default (({
   const {
     edgeDomain,
     edgeBasePath,
-    edgeConfigId
+    datastreamId
   } = config;
   /**
    * Sends a network request that is aware of payload interfaces,
@@ -53,7 +53,8 @@ export default (({
       const endpointDomain = request.getUseIdThirdPartyDomain() ? ID_THIRD_PARTY_DOMAIN : edgeDomain;
       const locationHint = getLocationHint();
       const edgeBasePathWithLocationHint = locationHint ? `${edgeBasePath}/${locationHint}` : edgeBasePath;
-      const url = `https://${endpointDomain}/${edgeBasePathWithLocationHint}/${apiVersion}/${request.getAction()}?configId=${edgeConfigId}&requestId=${request.getId()}${getAssuranceValidationTokenParams()}`;
+      const configId = request.getDatastreamIdOverride() || datastreamId;
+      const url = `https://${endpointDomain}/${edgeBasePathWithLocationHint}/${apiVersion}/${request.getAction()}?configId=${configId}&requestId=${request.getId()}${getAssuranceValidationTokenParams()}`;
       cookieTransfer.cookiesToPayload(request.getPayload(), endpointDomain);
       return sendNetworkRequest({
         requestId: request.getId(),

package/libEs6/utils/request/createDataCollectionRequest.js

@@ -10,7 +10,10 @@ OF ANY KIND, either express or implied. See the License for the specific languag
 governing permissions and limitations under the License.
 */
 import createRequest from "./createRequest";
-export default (dataCollectionRequestPayload => {
+export default (({
+  payload: dataCollectionRequestPayload,
+  datastreamIdOverride
+}) => {
   const getUseSendBeacon = ({
     isIdentityEstablished
   }) => {
@@ -62,6 +65,7 @@ export default (dataCollectionRequestPayload => {
       }) ? "collect" : "interact";
     },
 
-    getUseSendBeacon
+    getUseSendBeacon,
+    datastreamIdOverride
   });
 });

package/libEs6/utils/request/createRequest.js

@@ -15,7 +15,8 @@ export default (options => {
   const {
     payload,
     getAction,
-    getUseSendBeacon
+    getUseSendBeacon,
+    datastreamIdOverride
   } = options;
   const id = uuid();
   let shouldUseThirdPartyDomain = false;
@@ -35,6 +36,10 @@ export default (options => {
       });
     },
 
+    getDatastreamIdOverride() {
+      return datastreamIdOverride;
+    },
+
     getUseSendBeacon() {
       return getUseSendBeacon({
         isIdentityEstablished