@adobe/alloy 2.20.0-beta.2 → 2.20.0-beta.4

package/libEs6/components/Personalization/dom-actions/initDomActionsModules.js

@@ -0,0 +1,33 @@
+/*
+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.
+*/
+
+import { removeNode } from "../../../utils/dom/index.js";
+import { createAction, setHtml, setText, setAttributes, swapImage, setStyles, rearrangeChildren, replaceHtml, appendHtml, prependHtml, insertHtmlAfter, insertHtmlBefore } from "./action.js";
+export default (() => {
+  return {
+    setHtml: createAction(setHtml),
+    customCode: createAction(prependHtml),
+    setText: createAction(setText),
+    setAttribute: createAction(setAttributes),
+    setImageSource: createAction(swapImage),
+    setStyle: createAction(setStyles),
+    move: createAction(setStyles),
+    resize: createAction(setStyles),
+    rearrange: createAction(rearrangeChildren),
+    remove: createAction(removeNode),
+    insertAfter: createAction(insertHtmlAfter),
+    insertBefore: createAction(insertHtmlBefore),
+    replaceHtml: createAction(replaceHtml),
+    prependHtml: createAction(prependHtml),
+    appendHtml: createAction(appendHtml)
+  };
+});

package/libEs6/components/Personalization/dom-actions/insertHtmlAfter.js

@@ -0,0 +1,29 @@
+/*
+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.
+*/
+
+import { createFragment, getChildNodes, insertAfter } from "./dom/index.js";
+import { loadImages } from "./images.js";
+import addNonceToInlineStyleElements from "./addNonceToInlineStyleElements.js";
+import { getInlineScripts, getRemoteScriptsUrls, executeInlineScripts, executeRemoteScripts } from "./scripts.js";
+export default ((container, html) => {
+  const fragment = createFragment(html);
+  addNonceToInlineStyleElements(fragment);
+  const elements = getChildNodes(fragment);
+  const scripts = getInlineScripts(fragment);
+  const scriptsUrls = getRemoteScriptsUrls(fragment);
+  loadImages(fragment);
+  elements.forEach(element => {
+    insertAfter(container, element);
+  });
+  executeInlineScripts(container, scripts);
+  return executeRemoteScripts(scriptsUrls);
+});

package/libEs6/components/Personalization/dom-actions/insertHtmlBefore.js

@@ -0,0 +1,29 @@
+/*
+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.
+*/
+
+import { createFragment, getChildNodes, insertBefore } from "./dom/index.js";
+import { loadImages } from "./images.js";
+import addNonceToInlineStyleElements from "./addNonceToInlineStyleElements.js";
+import { getInlineScripts, getRemoteScriptsUrls, executeInlineScripts, executeRemoteScripts } from "./scripts.js";
+export default ((container, html) => {
+  const fragment = createFragment(html);
+  addNonceToInlineStyleElements(fragment);
+  const elements = getChildNodes(fragment);
+  const scripts = getInlineScripts(fragment);
+  const scriptsUrls = getRemoteScriptsUrls(fragment);
+  loadImages(fragment);
+  elements.forEach(element => {
+    insertBefore(container, element);
+  });
+  executeInlineScripts(container, scripts);
+  return executeRemoteScripts(scriptsUrls);
+});

package/libEs6/components/Personalization/dom-actions/prependHtml.js

@@ -0,0 +1,45 @@
+/*
+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.
+*/
+
+import { appendNode } from "../../../utils/dom/index.js";
+import { createFragment, getChildNodes, getFirstChild, insertBefore } from "./dom/index.js";
+import { loadImages } from "./images.js";
+import addNonceToInlineStyleElements from "./addNonceToInlineStyleElements.js";
+import { getInlineScripts, getRemoteScriptsUrls, executeInlineScripts, executeRemoteScripts } from "./scripts.js";
+export default ((container, html) => {
+  const fragment = createFragment(html);
+  addNonceToInlineStyleElements(fragment);
+  const elements = getChildNodes(fragment);
+  const scripts = getInlineScripts(fragment);
+  const scriptsUrls = getRemoteScriptsUrls(fragment);
+  const {
+    length
+  } = elements;
+  let i = length - 1;
+
+  // We have to proactively load images to avoid flicker
+  loadImages(fragment);
+
+  // We are inserting elements in reverse order
+  while (i >= 0) {
+    const element = elements[i];
+    const firstChild = getFirstChild(container);
+    if (firstChild) {
+      insertBefore(firstChild, element);
+    } else {
+      appendNode(container, element);
+    }
+    i -= 1;
+  }
+  executeInlineScripts(container, scripts);
+  return executeRemoteScripts(scriptsUrls);
+});

package/libEs6/components/Personalization/dom-actions/rearrangeChildren.js

@@ -0,0 +1,31 @@
+/*
+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.
+*/
+
+import { getChildren, insertAfter, insertBefore } from "./dom/index.js";
+export default ((container, {
+  from,
+  to
+}) => {
+  const children = getChildren(container);
+  const elementFrom = children[from];
+  const elementTo = children[to];
+  if (!elementFrom || !elementTo) {
+    // TODO: We will need to add logging
+    // to ease troubleshooting
+    return;
+  }
+  if (from < to) {
+    insertAfter(elementTo, elementFrom);
+  } else {
+    insertBefore(elementTo, elementFrom);
+  }
+});

package/libEs6/components/Personalization/dom-actions/remapCustomCodeOffers.js

@@ -0,0 +1,34 @@
+/*
+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.
+*/
+
+/*
+ * Preprocess customCode actions before rendering, so that offer selectors are remapped appropriately for
+ * target offers, to align with the way it works in at.js.
+ */
+import { assign } from "../../../utils/index.js";
+const ACTION_CUSTOM_CODE = "customCode";
+const TARGET_BODY_SELECTOR = "BODY > *:eq(0)";
+export default (action => {
+  const {
+    selector,
+    type
+  } = action;
+  if (type !== ACTION_CUSTOM_CODE) {
+    return action;
+  }
+  if (selector !== TARGET_BODY_SELECTOR) {
+    return action;
+  }
+  return assign({}, action, {
+    selector: "BODY"
+  });
+});

package/libEs6/components/Personalization/dom-actions/remapHeadOffers.js

@@ -0,0 +1,51 @@
+/*
+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.
+*/
+
+/*
+ * Preprocess actions before rendering, so that offers are remapped to appendHtml when these are
+ * to be applied to page HEAD, to align with the way it works in at.js.
+ * Offer content should also be filtered, so that only tags allowed in HEAD are preserved.
+ */
+
+import { selectNodes } from "../../../utils/dom/index.js";
+import { is } from "./scripts.js";
+import { createFragment, selectNodesWithEq } from "./dom/index.js";
+import { assign } from "../../../utils/index.js";
+import isBlankString from "../../../utils/isBlankString.js";
+import { HEAD } from "../../../constants/tagName.js";
+const APPEND_HTML = "appendHtml";
+const HEAD_TAGS_SELECTOR = "SCRIPT,LINK,STYLE";
+const filterHeadContent = content => {
+  const container = createFragment(content);
+  const headNodes = selectNodes(HEAD_TAGS_SELECTOR, container);
+  return headNodes.map(node => node.outerHTML).join("");
+};
+export default (action => {
+  const result = assign({}, action);
+  const {
+    content,
+    selector
+  } = result;
+  if (isBlankString(content)) {
+    return result;
+  }
+  if (selector == null) {
+    return result;
+  }
+  const container = selectNodesWithEq(selector);
+  if (!is(container[0], HEAD)) {
+    return result;
+  }
+  result.type = APPEND_HTML;
+  result.content = filterHeadContent(content);
+  return result;
+});

package/libEs6/components/Personalization/dom-actions/replaceHtml.js

@@ -0,0 +1,18 @@
+/*
+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.
+*/
+
+import { removeNode } from "../../../utils/dom/index.js";
+import insertHtmlBefore from "./insertHtmlBefore.js";
+export default ((container, html) => {
+  insertHtmlBefore(container, html);
+  removeNode(container);
+});

package/libEs6/components/Personalization/dom-actions/scripts.js

@@ -0,0 +1,85 @@
+/*
+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.
+*/
+
+import loadScript from "@adobe/reactor-load-script";
+import { selectNodes, createNode } from "../../../utils/dom/index.js";
+import { SCRIPT } from "../../../constants/tagName.js";
+import { SRC } from "../../../constants/elementAttribute.js";
+import { getAttribute, getNonce } from "./dom/index.js";
+export const is = (element, tagName) => !!element && element.tagName === tagName;
+const isInlineScript = element => is(element, SCRIPT) && !getAttribute(element, SRC);
+const isRemoteScript = element => is(element, SCRIPT) && getAttribute(element, SRC);
+export const getInlineScripts = fragment => {
+  const scripts = selectNodes(SCRIPT, fragment);
+  const result = [];
+  const {
+    length
+  } = scripts;
+  const nonce = getNonce();
+  const attributes = {
+    ...(nonce && {
+      nonce
+    })
+  };
+
+  /* eslint-disable no-continue */
+  for (let i = 0; i < length; i += 1) {
+    const element = scripts[i];
+    if (!isInlineScript(element)) {
+      continue;
+    }
+    const {
+      textContent
+    } = element;
+    if (!textContent) {
+      continue;
+    }
+    result.push(createNode(SCRIPT, attributes, {
+      textContent
+    }));
+  }
+  /* eslint-enable no-continue */
+
+  return result;
+};
+export const getRemoteScriptsUrls = fragment => {
+  const scripts = selectNodes(SCRIPT, fragment);
+  const result = [];
+  const {
+    length
+  } = scripts;
+
+  /* eslint-disable no-continue */
+  for (let i = 0; i < length; i += 1) {
+    const element = scripts[i];
+    if (!isRemoteScript(element)) {
+      continue;
+    }
+    const url = getAttribute(element, SRC);
+    if (!url) {
+      continue;
+    }
+    result.push(url);
+  }
+  /* eslint-enable no-continue */
+
+  return result;
+};
+export const executeInlineScripts = (parent, scripts) => {
+  scripts.forEach(script => {
+    parent.appendChild(script);
+    parent.removeChild(script);
+  });
+};
+export const executeRemoteScripts = urls => {
+  return Promise.all(urls.map(loadScript));
+};

package/libEs6/components/Personalization/dom-actions/setAttributes.js

@@ -0,0 +1,18 @@
+/*
+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.
+*/
+
+import { setAttribute } from "./dom/index.js";
+export default ((container, attributes) => {
+  Object.keys(attributes).forEach(key => {
+    setAttribute(container, key, attributes[key]);
+  });
+});

package/libEs6/components/Personalization/dom-actions/setHtml.js

@@ -0,0 +1,24 @@
+/*
+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.
+*/
+
+import { removeNode } from "../../../utils/dom/index.js";
+import { getChildNodes } from "./dom/index.js";
+import appendHtml from "./appendHtml.js";
+const clear = container => {
+  // We want to remove ALL nodes, text, comments etc
+  const childNodes = getChildNodes(container);
+  childNodes.forEach(removeNode);
+};
+export default ((container, html) => {
+  clear(container);
+  appendHtml(container, html);
+});

package/libEs6/components/Personalization/dom-actions/setStyles.js

@@ -0,0 +1,22 @@
+/*
+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.
+*/
+
+import { setStyle } from "./dom/index.js";
+export default ((container, styles) => {
+  const {
+    priority,
+    ...style
+  } = styles;
+  Object.keys(style).forEach(key => {
+    setStyle(container, key, style[key], priority);
+  });
+});

package/libEs6/components/Personalization/dom-actions/setText.js

@@ -0,0 +1,15 @@
+/*
+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.
+*/
+
+export default ((container, text) => {
+  container.textContent = text;
+});

package/libEs6/components/Personalization/dom-actions/swapImage.js

@@ -0,0 +1,29 @@
+/*
+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.
+*/
+
+import { SRC } from "../../../constants/elementAttribute.js";
+import { setAttribute, removeAttribute } from "./dom/index.js";
+import { isImage, loadImage } from "./images.js";
+export default ((container, url) => {
+  if (!isImage(container)) {
+    return;
+  }
+
+  // Start downloading the image
+  loadImage(url);
+
+  // Remove "src" so there is no flicker
+  removeAttribute(container, SRC);
+
+  // Replace the image "src"
+  setAttribute(container, SRC, url);
+});

package/libEs6/components/Personalization/event.js

@@ -0,0 +1,45 @@
+/*
+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.
+*/
+
+import { EVENT_TYPE_TRUE } from "../../constants/eventType.js";
+
+/* eslint-disable no-underscore-dangle */
+export const mergeDecisionsMeta = (event, decisionsMeta, propositionEventTypes, propositionAction) => {
+  // Do not send a display notification with no decisions. Even empty view changes
+  // should include a proposition.
+  if (decisionsMeta.length === 0) {
+    return;
+  }
+  const propositionEventType = {};
+  propositionEventTypes.forEach(type => {
+    propositionEventType[type] = EVENT_TYPE_TRUE;
+  });
+  const xdm = {
+    _experience: {
+      decisioning: {
+        propositions: decisionsMeta,
+        propositionEventType
+      }
+    }
+  };
+  if (propositionAction) {
+    xdm._experience.decisioning.propositionAction = propositionAction;
+  }
+  event.mergeXdm(xdm);
+};
+export const mergeQuery = (event, details) => {
+  event.mergeQuery({
+    personalization: {
+      ...details
+    }
+  });
+};

package/libEs6/components/Personalization/flicker/index.js

@@ -0,0 +1,82 @@
+/*
+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.
+*/
+
+import { createNode, appendNode, removeNode } from "../../../utils/dom/index.js";
+import { STYLE } from "../../../constants/tagName.js";
+import { getElementById, getNonce } from "../dom-actions/dom/index.js";
+const PREHIDING_ID = "alloy-prehiding";
+const HIDING_STYLE_DEFINITION = "{ visibility: hidden }";
+
+// Using global is OK since we have a single DOM
+// so storing nodes even for multiple Alloy instances is fine
+const styleNodes = {};
+export const hideElements = prehidingSelector => {
+  // if we have different events with the same
+  // prehiding selector we don't want to recreate
+  // the style tag
+  if (styleNodes[prehidingSelector]) {
+    return;
+  }
+  const nonce = getNonce();
+  const attrs = {
+    ...(nonce && {
+      nonce
+    })
+  };
+  const props = {
+    textContent: `${prehidingSelector} ${HIDING_STYLE_DEFINITION}`
+  };
+  const node = createNode(STYLE, attrs, props);
+  appendNode(document.head, node);
+  styleNodes[prehidingSelector] = node;
+};
+export const showElements = prehidingSelector => {
+  const node = styleNodes[prehidingSelector];
+  if (node) {
+    removeNode(node);
+    delete styleNodes[prehidingSelector];
+  }
+};
+export const hideContainers = prehidingStyle => {
+  if (!prehidingStyle) {
+    return;
+  }
+
+  // If containers prehiding style has been added
+  // by customer's prehiding snippet we don't
+  // want to add the same node
+  const node = getElementById(PREHIDING_ID);
+  if (node) {
+    return;
+  }
+  const nonce = getNonce();
+  const attrs = {
+    id: PREHIDING_ID,
+    ...(nonce && {
+      nonce
+    })
+  };
+  const props = {
+    textContent: prehidingStyle
+  };
+  const styleNode = createNode(STYLE, attrs, props);
+  appendNode(document.head, styleNode);
+};
+export const showContainers = () => {
+  // If containers prehiding style exists
+  // we will remove it
+  const node = getElementById(PREHIDING_ID);
+  if (!node) {
+    return;
+  }
+  removeNode(node);
+};

package/libEs6/components/Personalization/handlers/createProcessDomAction.js

@@ -0,0 +1,61 @@
+/*
+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.
+*/
+export default (({
+  modules,
+  logger,
+  storeClickMetrics
+}) => item => {
+  const {
+    type,
+    selector
+  } = item.getData() || {};
+  if (!type) {
+    logger.warn("Invalid DOM action data: missing type.", item.getData());
+    return {
+      setRenderAttempted: false,
+      includeInNotification: false
+    };
+  }
+  if (type === "click") {
+    if (!selector) {
+      logger.warn("Invalid DOM action data: missing selector.", item.getData());
+      return {
+        setRenderAttempted: false,
+        includeInNotification: false
+      };
+    }
+    storeClickMetrics({
+      selector,
+      meta: {
+        ...item.getProposition().getNotification(),
+        trackingLabel: item.getTrackingLabel(),
+        scopeType: item.getProposition().getScopeType()
+      }
+    });
+    return {
+      setRenderAttempted: true,
+      includeInNotification: false
+    };
+  }
+  if (!modules[type]) {
+    logger.warn("Invalid DOM action data: unknown type.", item.getData());
+    return {
+      setRenderAttempted: false,
+      includeInNotification: false
+    };
+  }
+  return {
+    render: () => modules[type](item.getData()),
+    setRenderAttempted: true,
+    includeInNotification: true
+  };
+});