@adobe/alloy 2.28.0 → 2.28.1-beta.1

package/libEs5/core/createLogController.js

@@ -0,0 +1,71 @@
+"use strict";
+
+exports.default = void 0;
+var _index = require("../utils/index.js");
+var _debugQueryParam = require("../constants/debugQueryParam.js");
+/*
+Copyright 2019 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.
+*/
+var _default = ({
+  console,
+  locationSearch,
+  createLogger,
+  instanceName,
+  createNamespacedStorage,
+  getMonitors
+}) => {
+  const parsedQueryString = _index.queryString.parse(locationSearch);
+  const storage = createNamespacedStorage("instance." + instanceName + ".");
+  const debugSessionValue = storage.session.getItem("debug");
+  let debugEnabled = debugSessionValue === "true";
+  let debugEnabledWritableFromConfig = debugSessionValue === null;
+  const getDebugEnabled = () => debugEnabled;
+  const setDebugEnabled = (value, {
+    fromConfig
+  }) => {
+    if (!fromConfig || debugEnabledWritableFromConfig) {
+      debugEnabled = value;
+    }
+    if (!fromConfig) {
+      // Web storage only allows strings, so we explicitly convert to string.
+      storage.session.setItem("debug", value.toString());
+      debugEnabledWritableFromConfig = false;
+    }
+  };
+  if (parsedQueryString[_debugQueryParam.default] !== undefined) {
+    setDebugEnabled((0, _index.stringToBoolean)(parsedQueryString[_debugQueryParam.default]), {
+      fromConfig: false
+    });
+  }
+  return {
+    setDebugEnabled,
+    logger: createLogger({
+      getDebugEnabled,
+      context: {
+        instanceName
+      },
+      getMonitors,
+      console
+    }),
+    createComponentLogger(componentName) {
+      return createLogger({
+        getDebugEnabled,
+        context: {
+          instanceName,
+          componentName
+        },
+        getMonitors,
+        console
+      });
+    }
+  };
+};
+exports.default = _default;

package/libEs5/core/createLogger.js

@@ -0,0 +1,117 @@
+"use strict";
+
+exports.default = void 0;
+/*
+Copyright 2019 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.
+*/
+var _default = ({
+  getDebugEnabled,
+  console,
+  getMonitors,
+  context
+}) => {
+  let prefix = "[" + context.instanceName + "]";
+  if (context.componentName) {
+    prefix += " [" + context.componentName + "]";
+  }
+  const notifyMonitors = (method, data) => {
+    const monitors = getMonitors();
+    if (monitors.length > 0) {
+      const dataWithContext = {
+        ...context,
+        ...data
+      };
+      monitors.forEach(monitor => {
+        if (monitor[method]) {
+          monitor[method](dataWithContext);
+        }
+      });
+    }
+  };
+  const log = (level, ...rest) => {
+    notifyMonitors("onBeforeLog", {
+      level,
+      arguments: rest
+    });
+    if (getDebugEnabled()) {
+      console[level](prefix, ...rest);
+    }
+  };
+  return {
+    get enabled() {
+      return getMonitors().length > 0 || getDebugEnabled();
+    },
+    logOnInstanceCreated(data) {
+      notifyMonitors("onInstanceCreated", data);
+      log("info", "Instance initialized.");
+    },
+    logOnInstanceConfigured(data) {
+      notifyMonitors("onInstanceConfigured", data);
+      log("info", "Instance configured. Computed configuration:", data.config);
+    },
+    logOnBeforeCommand(data) {
+      notifyMonitors("onBeforeCommand", data);
+      log("info", "Executing " + data.commandName + " command. Options:", data.options);
+    },
+    logOnCommandResolved(data) {
+      notifyMonitors("onCommandResolved", data);
+      log("info", data.commandName + " command resolved. Result:", data.result);
+    },
+    logOnCommandRejected(data) {
+      notifyMonitors("onCommandRejected", data);
+      log("error", data.commandName + " command was rejected. Error:", data.error);
+    },
+    logOnBeforeNetworkRequest(data) {
+      notifyMonitors("onBeforeNetworkRequest", data);
+      log("info", "Request " + data.requestId + ": Sending request.", data.payload);
+    },
+    logOnNetworkResponse(data) {
+      notifyMonitors("onNetworkResponse", data);
+      const messagesSuffix = data.parsedBody || data.body ? "response body:" : "no response body.";
+      log("info", "Request " + data.requestId + ": Received response with status code " + data.statusCode + " and " + messagesSuffix, data.parsedBody || data.body);
+    },
+    logOnNetworkError(data) {
+      notifyMonitors("onNetworkError", data);
+      log("error", "Request " + data.requestId + ": Network request failed.", data.error);
+    },
+    logOnContentHiding(data) {
+      notifyMonitors("onContentHiding", {
+        status: data.status
+      });
+      log(data.logLevel, data.message);
+    },
+    logOnContentRendering(data) {
+      notifyMonitors("onContentRendering", {
+        status: data.status,
+        payload: data.detail
+      });
+      log(data.logLevel, data.message);
+    },
+    /**
+     * Outputs informational message to the web console. In some
+     * browsers a small "i" icon is displayed next to these items
+     * in the web console's log.
+     * @param {...*} arg Any argument to be logged.
+     */
+    info: log.bind(null, "info"),
+    /**
+     * Outputs a warning message to the web console.
+     * @param {...*} arg Any argument to be logged.
+     */
+    warn: log.bind(null, "warn"),
+    /**
+     * Outputs an error message to the web console.
+     * @param {...*} arg Any argument to be logged.
+     */
+    error: log.bind(null, "error")
+  };
+};
+exports.default = _default;

package/libEs5/core/edgeNetwork/handleRequestFailure.js

@@ -0,0 +1,28 @@
+"use strict";
+
+exports.default = void 0;
+/*
+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.
+*/
+var _default = onRequestFailureCallbackAggregator => {
+  return error => {
+    // Regardless of whether the network call failed, an unexpected status
+    // code was returned, or the response body was malformed, we want to call
+    // the onRequestFailure callbacks, but still throw the exception.
+    const throwError = () => {
+      throw error;
+    };
+    return onRequestFailureCallbackAggregator.call({
+      error
+    }).then(throwError, throwError);
+  };
+};
+exports.default = _default;

package/libEs5/core/edgeNetwork/injectApplyResponse.js

@@ -0,0 +1,63 @@
+"use strict";
+
+exports.default = void 0;
+var _index = require("../../utils/index.js");
+var _mergeLifecycleResponses = require("./mergeLifecycleResponses.js");
+var _handleRequestFailure = require("./handleRequestFailure.js");
+/*
+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.
+*/
+
+const HTTP_STATUS_OK = 200;
+var _default = ({
+  cookieTransfer,
+  lifecycle,
+  createResponse,
+  processWarningsAndErrors
+}) => {
+  return ({
+    request,
+    responseHeaders,
+    responseBody,
+    runOnResponseCallbacks = _index.noop,
+    runOnRequestFailureCallbacks = _index.noop
+  }) => {
+    const onResponseCallbackAggregator = (0, _index.createCallbackAggregator)();
+    onResponseCallbackAggregator.add(lifecycle.onResponse);
+    onResponseCallbackAggregator.add(runOnResponseCallbacks);
+    const onRequestFailureCallbackAggregator = (0, _index.createCallbackAggregator)();
+    onRequestFailureCallbackAggregator.add(lifecycle.onRequestFailure);
+    onRequestFailureCallbackAggregator.add(runOnRequestFailureCallbacks);
+    const getHeader = key => responseHeaders[key];
+    return lifecycle.onBeforeRequest({
+      request,
+      onResponse: onResponseCallbackAggregator.add,
+      onRequestFailure: onRequestFailureCallbackAggregator.add
+    }).then(() => processWarningsAndErrors({
+      statusCode: HTTP_STATUS_OK,
+      getHeader,
+      body: JSON.stringify(responseBody),
+      parsedBody: responseBody
+    })).catch((0, _handleRequestFailure.default)(onRequestFailureCallbackAggregator)).then(() => {
+      const response = createResponse({
+        content: responseBody,
+        getHeader
+      });
+
+      // This will clobber any cookies set via HTTP from the server.  So care should be given to remove any state:store handles if that is not desirable
+      cookieTransfer.responseToCookies(response);
+      return onResponseCallbackAggregator.call({
+        response
+      }).then(_mergeLifecycleResponses.default);
+    });
+  };
+};
+exports.default = _default;

package/libEs5/core/edgeNetwork/injectExtractEdgeInfo.js

@@ -0,0 +1,36 @@
+"use strict";
+
+exports.default = void 0;
+/*
+Copyright 2021 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.
+*/
+var _default = ({
+  logger
+}) => adobeEdgeHeader => {
+  if (adobeEdgeHeader) {
+    const headerParts = adobeEdgeHeader.split(";");
+    if (headerParts.length >= 2 && headerParts[1].length > 0) {
+      try {
+        const regionId = parseInt(headerParts[1], 10);
+        if (!Number.isNaN(regionId)) {
+          return {
+            regionId
+          };
+        }
+      } catch {
+        // No need to do anything. The log statement below will log an error
+      }
+    }
+    logger.warn("Invalid adobe edge: \"" + adobeEdgeHeader + "\"");
+  }
+  return {};
+};
+exports.default = _default;

package/libEs5/core/edgeNetwork/injectGetLocationHint.js

@@ -0,0 +1,35 @@
+"use strict";
+
+exports.default = void 0;
+var _index = require("../../utils/index.js");
+var _cookieNameKey = require("../../constants/cookieNameKey.js");
+var _legacyCookies = require("../../constants/legacyCookies.js");
+/*
+Copyright 2022 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.
+*/
+var _default = ({
+  orgId,
+  cookieJar
+}) => {
+  const clusterCookieName = (0, _index.getNamespacedCookieName)(orgId, _cookieNameKey.CLUSTER);
+  const fromClusterCookie = () => cookieJar.get(clusterCookieName);
+  const fromTarget = () => {
+    const mboxEdgeCluster = cookieJar.get(_legacyCookies.MBOX_EDGE_CLUSTER);
+    if (mboxEdgeCluster) {
+      return "t" + mboxEdgeCluster;
+    }
+    return undefined;
+  };
+  return () => {
+    return fromClusterCookie() || fromTarget();
+  };
+};
+exports.default = _default;

package/libEs5/core/edgeNetwork/injectProcessWarningsAndErrors.js

@@ -0,0 +1,46 @@
+"use strict";
+
+exports.default = void 0;
+var _httpStatusCode = require("../../constants/httpStatusCode.js");
+/*
+Copyright 2019 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.
+*/
+
+const MESSAGE_PREFIX = "The server responded with a";
+var _default = ({
+  logger
+}) => {
+  return networkResponse => {
+    const {
+      statusCode,
+      body,
+      parsedBody
+    } = networkResponse;
+    if (statusCode < 200 || statusCode >= 300 || !parsedBody && statusCode !== _httpStatusCode.NO_CONTENT || parsedBody && !Array.isArray(parsedBody.handle)) {
+      const bodyToLog = parsedBody ? JSON.stringify(parsedBody, null, 2) : body;
+      const messageSuffix = bodyToLog ? "response body:\n" + bodyToLog : "no response body.";
+      throw new Error(MESSAGE_PREFIX + " status code " + statusCode + " and " + messageSuffix);
+    }
+    if (parsedBody) {
+      const {
+        warnings = [],
+        errors = []
+      } = parsedBody;
+      warnings.forEach(warning => {
+        logger.warn(MESSAGE_PREFIX + " warning:", warning);
+      });
+      errors.forEach(error => {
+        logger.error(MESSAGE_PREFIX + " non-fatal error:", error);
+      });
+    }
+  };
+};
+exports.default = _default;

package/libEs5/core/edgeNetwork/injectSendEdgeNetworkRequest.js

@@ -0,0 +1,127 @@
+"use strict";
+
+exports.default = void 0;
+var _domain = require("../../constants/domain.js");
+var _apiVersion = require("../../constants/apiVersion.js");
+var _index = require("../../utils/index.js");
+var _networkErrors = require("../../utils/networkErrors.js");
+var _mergeLifecycleResponses = require("./mergeLifecycleResponses.js");
+var _handleRequestFailure = require("./handleRequestFailure.js");
+/*
+Copyright 2019 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.
+*/
+
+const isDemdexBlockedError = (error, request) => {
+  return request.getUseIdThirdPartyDomain() && (0, _networkErrors.isNetworkError)(error);
+};
+var _default = ({
+  config,
+  lifecycle,
+  cookieTransfer,
+  sendNetworkRequest,
+  createResponse,
+  processWarningsAndErrors,
+  getLocationHint,
+  getAssuranceValidationTokenParams
+}) => {
+  const {
+    edgeDomain,
+    edgeBasePath,
+    datastreamId
+  } = config;
+  let hasDemdexFailed = false;
+  const buildEndpointUrl = (endpointDomain, request) => {
+    const locationHint = getLocationHint();
+    const edgeBasePathWithLocationHint = locationHint ? edgeBasePath + "/" + locationHint + request.getEdgeSubPath() : "" + edgeBasePath + request.getEdgeSubPath();
+    const configId = request.getDatastreamIdOverride() || datastreamId;
+    if (configId !== datastreamId) {
+      request.getPayload().mergeMeta({
+        sdkConfig: {
+          datastream: {
+            original: datastreamId
+          }
+        }
+      });
+    }
+    return "https://" + endpointDomain + "/" + edgeBasePathWithLocationHint + "/" + _apiVersion.default + "/" + request.getAction() + "?configId=" + configId + "&requestId=" + request.getId() + getAssuranceValidationTokenParams();
+  };
+
+  /**
+   * Sends a network request that is aware of payload interfaces,
+   * lifecycle methods, configured edge domains, response structures, etc.
+   */
+  return ({
+    request,
+    runOnResponseCallbacks = _index.noop,
+    runOnRequestFailureCallbacks = _index.noop
+  }) => {
+    const onResponseCallbackAggregator = (0, _index.createCallbackAggregator)();
+    onResponseCallbackAggregator.add(lifecycle.onResponse);
+    onResponseCallbackAggregator.add(runOnResponseCallbacks);
+    const onRequestFailureCallbackAggregator = (0, _index.createCallbackAggregator)();
+    onRequestFailureCallbackAggregator.add(lifecycle.onRequestFailure);
+    onRequestFailureCallbackAggregator.add(runOnRequestFailureCallbacks);
+    return lifecycle.onBeforeRequest({
+      request,
+      onResponse: onResponseCallbackAggregator.add,
+      onRequestFailure: onRequestFailureCallbackAggregator.add
+    }).then(() => {
+      const endpointDomain = hasDemdexFailed || !request.getUseIdThirdPartyDomain() ? edgeDomain : _domain.ID_THIRD_PARTY;
+      const url = buildEndpointUrl(endpointDomain, request);
+      const payload = request.getPayload();
+      cookieTransfer.cookiesToPayload(payload, endpointDomain);
+      return sendNetworkRequest({
+        requestId: request.getId(),
+        url,
+        payload,
+        useSendBeacon: request.getUseSendBeacon()
+      });
+    }).then(networkResponse => {
+      processWarningsAndErrors(networkResponse);
+      return networkResponse;
+    }).catch(error => {
+      if (isDemdexBlockedError(error, request)) {
+        hasDemdexFailed = true;
+        request.setUseIdThirdPartyDomain(false);
+        const url = buildEndpointUrl(edgeDomain, request);
+        const payload = request.getPayload();
+        cookieTransfer.cookiesToPayload(payload, edgeDomain);
+        return sendNetworkRequest({
+          requestId: request.getId(),
+          url,
+          payload,
+          useSendBeacon: request.getUseSendBeacon()
+        });
+      }
+      return (0, _handleRequestFailure.default)(onRequestFailureCallbackAggregator)(error);
+    }).then(({
+      parsedBody,
+      getHeader
+    }) => {
+      // Note that networkResponse.parsedBody may be undefined if it was a
+      // 204 No Content response. That's fine.
+      const response = createResponse({
+        content: parsedBody,
+        getHeader
+      });
+      cookieTransfer.responseToCookies(response);
+
+      // Notice we're calling the onResponse lifecycle method even if there are errors
+      // inside the response body. This is because the full request didn't actually fail--
+      // only portions of it that are considered non-fatal (a specific, non-critical
+      // Konductor plugin, for example).
+      return onResponseCallbackAggregator.call({
+        response
+      }).then(_mergeLifecycleResponses.default);
+    });
+  };
+};
+exports.default = _default;

package/libEs5/core/edgeNetwork/mergeLifecycleResponses.js

@@ -0,0 +1,24 @@
+"use strict";
+
+exports.default = void 0;
+var _index = require("../../utils/index.js");
+/*
+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.
+*/
+var _default = returnValues => {
+  // Merges all returned objects from all `onResponse` callbacks into
+  // a single object that can later be returned to the customer.
+  const lifecycleOnResponseReturnValues = returnValues.shift() || [];
+  const consumerOnResponseReturnValues = returnValues.shift() || [];
+  const lifecycleOnBeforeRequestReturnValues = returnValues;
+  return (0, _index.assignConcatArrayValues)({}, ...lifecycleOnResponseReturnValues, ...consumerOnResponseReturnValues, ...lifecycleOnBeforeRequestReturnValues);
+};
+exports.default = _default;

package/libEs5/core/getMonitors.js

@@ -0,0 +1,32 @@
+"use strict";
+
+exports.default = void 0;
+/*
+Copyright 2025 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.
+*/
+/* eslint-disable dot-notation */
+/** @import { AlloyMonitor } from './types.js' */
+/**
+ * This factory function creates a getter that combines both provided monitors
+ * and any monitors found in the global window.__alloyMonitors array.
+ *
+ * @param {Array<AlloyMonitor>} [monitors] - Optional array of monitor objects to append to the current one
+ * @returns {Function} A function that when called, returns all available monitors
+ */
+var _default = monitors => {
+  /** @type {Array<AlloyMonitor>} */
+  let alloyMonitors = window["__alloyMonitors"] || [];
+  if (monitors) {
+    alloyMonitors = alloyMonitors.concat(monitors);
+  }
+  return alloyMonitors;
+};
+exports.default = _default;