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

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

@@ -0,0 +1,40 @@
+/*
+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
+}) => item => {
+  const {
+    type,
+    selector
+  } = item.getData() || {};
+  if (!selector || !type) {
+    return {
+      setRenderAttempted: false,
+      includeInNotification: false
+    };
+  }
+  if (!modules[type]) {
+    logger.warn("Invalid HTML content data", item.getData());
+    return {
+      setRenderAttempted: false,
+      includeInNotification: false
+    };
+  }
+  return {
+    render: () => {
+      modules[type](item.getData());
+    },
+    setRenderAttempted: true,
+    includeInNotification: true
+  };
+});

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

@@ -0,0 +1,77 @@
+/*
+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.
+*/
+import { APPLICATION_JSON } from "../../../constants/contentType.js";
+const DEFAULT_CONTENT = "defaultContent";
+const expectedProps = ["content", "contentType"];
+const expectedContentProps = ["mobileParameters", "webParameters", "html"];
+const isValidInAppMessage = (data, logger) => {
+  for (let i = 0; i < expectedProps.length; i += 1) {
+    const prop = expectedProps[i];
+    if (!Object.prototype.hasOwnProperty.call(data, prop)) {
+      logger.warn(`Invalid in-app message data: missing property '${prop}'.`, data);
+      return false;
+    }
+  }
+  const {
+    content,
+    contentType
+  } = data;
+  if (contentType === APPLICATION_JSON) {
+    for (let i = 0; i < expectedContentProps.length; i += 1) {
+      const prop = expectedContentProps[i];
+      if (!Object.prototype.hasOwnProperty.call(content, prop)) {
+        logger.warn(`Invalid in-app message data.content: missing property '${prop}'.`, data);
+        return false;
+      }
+    }
+  }
+  return true;
+};
+export default (({
+  modules,
+  logger
+}) => {
+  return item => {
+    const data = item.getData();
+    const meta = {
+      ...item.getProposition().getNotification()
+    };
+    if (!data) {
+      logger.warn("Invalid in-app message data: undefined.", data);
+      return {};
+    }
+    const {
+      type = DEFAULT_CONTENT
+    } = data;
+    if (!modules[type]) {
+      logger.warn("Invalid in-app message data: unknown type.", data);
+      return {};
+    }
+    if (!isValidInAppMessage(data, logger)) {
+      return {};
+    }
+    if (!meta) {
+      logger.warn("Invalid in-app message meta: undefined.", meta);
+      return {};
+    }
+    return {
+      render: () => {
+        return modules[type]({
+          ...data,
+          meta
+        });
+      },
+      setRenderAttempted: true,
+      includeInNotification: true
+    };
+  };
+});

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

@@ -0,0 +1,175 @@
+/*
+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 (({
+  schemaProcessors,
+  logger
+}) => {
+  const wrapRenderWithLogging = (render, item) => () => {
+    return Promise.resolve().then(render).then(() => {
+      if (logger.enabled) {
+        logger.info(`Action ${item.toString()} executed.`);
+      }
+      return true;
+    }).catch(error => {
+      if (logger.enabled) {
+        const {
+          message,
+          stack
+        } = error;
+        const warning = `Failed to execute action ${item.toString()}. ${message} ${stack}`;
+        logger.warn(warning);
+      }
+      return false;
+    });
+  };
+  const renderItems = (renderers, meta) => Promise.all(renderers.map(renderer => renderer())).then(successes => {
+    // as long as at least one renderer succeeds, we want to add the notification
+    // to the display notifications
+    if (!successes.includes(true)) {
+      return undefined;
+    }
+    return meta;
+  });
+  const processItem = item => {
+    const processor = schemaProcessors[item.getSchema()];
+    if (!processor) {
+      return {};
+    }
+    return processor(item);
+  };
+  const processItems = ({
+    renderers: existingRenderers,
+    returnedPropositions: existingReturnedPropositions,
+    returnedDecisions: existingReturnedDecisions,
+    items,
+    proposition
+  }) => {
+    let renderers = [...existingRenderers];
+    let returnedPropositions = [...existingReturnedPropositions];
+    let returnedDecisions = [...existingReturnedDecisions];
+    let renderedItems = [];
+    let nonRenderedItems = [];
+    let itemRenderers = [];
+    let atLeastOneWithNotification = false;
+    let render;
+    let setRenderAttempted;
+    let includeInNotification;
+    let onlyRenderThis = false;
+    let i = 0;
+    let item;
+    while (items.length > i) {
+      item = items[i];
+      ({
+        render,
+        setRenderAttempted,
+        includeInNotification,
+        onlyRenderThis
+      } = processItem(item));
+      if (onlyRenderThis) {
+        returnedPropositions = [];
+        returnedDecisions = [];
+        if (setRenderAttempted) {
+          renderedItems = [item];
+          nonRenderedItems = [];
+        } else {
+          renderedItems = [];
+          nonRenderedItems = [item];
+        }
+        renderers = [];
+        itemRenderers = [render];
+        atLeastOneWithNotification = includeInNotification;
+        break;
+      }
+      if (render) {
+        itemRenderers.push(wrapRenderWithLogging(render, item));
+      }
+      if (includeInNotification) {
+        atLeastOneWithNotification = true;
+      }
+      if (setRenderAttempted) {
+        renderedItems.push(item);
+      } else {
+        nonRenderedItems.push(item);
+      }
+      i += 1;
+    }
+    if (itemRenderers.length > 0) {
+      const meta = atLeastOneWithNotification ? proposition.getNotification() : undefined;
+      renderers.push(() => renderItems(itemRenderers, meta));
+    } else if (atLeastOneWithNotification) {
+      renderers.push(() => proposition.getNotification());
+    }
+    if (renderedItems.length > 0) {
+      proposition.addToReturnValues(returnedPropositions, returnedDecisions, renderedItems, true);
+    }
+    if (nonRenderedItems.length > 0) {
+      proposition.addToReturnValues(returnedPropositions, returnedDecisions, nonRenderedItems, false);
+    }
+    return {
+      renderers,
+      returnedPropositions,
+      returnedDecisions,
+      onlyRenderThis
+    };
+  };
+  return (renderPropositions, nonRenderPropositions = []) => {
+    let renderers = [];
+    let returnedPropositions = [];
+    let returnedDecisions = [];
+    let onlyRenderThis;
+    let i = 0;
+    let proposition;
+    let items;
+    while (renderPropositions.length > i) {
+      proposition = renderPropositions[i];
+      items = proposition.getItems();
+      ({
+        renderers,
+        returnedPropositions,
+        returnedDecisions,
+        onlyRenderThis
+      } = processItems({
+        renderers,
+        returnedPropositions,
+        returnedDecisions,
+        items,
+        proposition
+      }));
+      if (onlyRenderThis) {
+        break;
+      }
+      i += 1;
+    }
+    if (onlyRenderThis) {
+      // if onlyRenderThis is true, that means returnedPropositions and returnedDecisions
+      // only contains the proposition that triggered only rendering this. We need to
+      // add the other propositions to the returnedPropositions and returnedDecisions.
+      renderPropositions.forEach((p, index) => {
+        if (index !== i) {
+          p.addToReturnValues(returnedPropositions, returnedDecisions, p.getItems(), false);
+        }
+      });
+    }
+    nonRenderPropositions.forEach(p => {
+      p.addToReturnValues(returnedPropositions, returnedDecisions, p.getItems(), false);
+    });
+    const render = () => {
+      return Promise.all(renderers.map(renderer => renderer())).then(metas => metas.filter(meta => meta));
+    };
+    return {
+      returnedPropositions,
+      returnedDecisions,
+      render
+    };
+  };
+});

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

@@ -0,0 +1,41 @@
+/*
+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 (({
+  logger,
+  executeRedirect,
+  collect
+}) => item => {
+  const {
+    content
+  } = item.getData() || {};
+  if (!content) {
+    logger.warn("Invalid Redirect data", item.getData());
+    return {};
+  }
+  const render = () => {
+    return collect({
+      decisionsMeta: [item.getProposition().getNotification()],
+      documentMayUnload: true
+    }).then(() => {
+      return executeRedirect(content);
+      // Execute redirect will never resolve. If there are bottom of page events that are waiting
+      // for display notifications from this request, they will never run because this promise will
+      // not resolve. This is intentional because we don't want to run bottom of page events if
+      // there is a redirect.
+    });
+  };
+  return {
+    render,
+    setRenderAttempted: true,
+    onlyRenderThis: true
+  };
+});

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

@@ -0,0 +1,110 @@
+/*
+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.
+*/
+
+import PAGE_WIDE_SCOPE from "../../../constants/pageWideScope.js";
+import { VIEW_SCOPE_TYPE, PAGE_SCOPE_TYPE, PROPOSITION_SCOPE_TYPE } from "../constants/scopeType.js";
+export default (({
+  preprocess,
+  isPageWideSurface
+}) => {
+  const createItem = (item, proposition) => {
+    const {
+      schema,
+      data,
+      characteristics: {
+        trackingLabel
+      } = {}
+    } = item;
+    const processedData = preprocess(data);
+    return {
+      getSchema() {
+        return schema;
+      },
+      getData() {
+        return processedData;
+      },
+      getProposition() {
+        return proposition;
+      },
+      getTrackingLabel() {
+        return trackingLabel;
+      },
+      getOriginalItem() {
+        return item;
+      },
+      toString() {
+        return JSON.stringify(item);
+      },
+      toJSON() {
+        return item;
+      }
+    };
+  };
+  return (payload, visibleInReturnedItems = true) => {
+    const {
+      id,
+      scope,
+      scopeDetails,
+      items = []
+    } = payload;
+    const {
+      characteristics: {
+        scopeType
+      } = {}
+    } = scopeDetails || {};
+    return {
+      getScope() {
+        if (!scope) {
+          return scope;
+        }
+        return scope;
+      },
+      getScopeType() {
+        if (scope === PAGE_WIDE_SCOPE || isPageWideSurface(scope)) {
+          return PAGE_SCOPE_TYPE;
+        }
+        if (scopeType === VIEW_SCOPE_TYPE) {
+          return VIEW_SCOPE_TYPE;
+        }
+        return PROPOSITION_SCOPE_TYPE;
+      },
+      getItems() {
+        return items.map(item => createItem(item, this));
+      },
+      getNotification() {
+        return {
+          id,
+          scope,
+          scopeDetails
+        };
+      },
+      toJSON() {
+        return payload;
+      },
+      addToReturnValues(propositions, decisions, includedItems, renderAttempted) {
+        if (visibleInReturnedItems) {
+          propositions.push({
+            ...payload,
+            items: includedItems.map(i => i.getOriginalItem()),
+            renderAttempted
+          });
+          if (!renderAttempted) {
+            decisions.push({
+              ...payload,
+              items: includedItems.map(i => i.getOriginalItem())
+            });
+          }
+        }
+      }
+    };
+  };
+});

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

@@ -0,0 +1,17 @@
+/*
+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 (() => {
+  return {
+    setRenderAttempted: true,
+    includeInNotification: true
+  };
+});