@adobe/alloy 2.29.0-beta.5 → 2.30.0-beta.0

package/libEs5/utils/request/createRequestPayload.js

@@ -14,6 +14,8 @@ OF ANY KIND, either express or implied. See the License for the specific languag
 governing permissions and limitations under the License.
 */
 
+/** @import { RequestPayload, Identity } from './types.js' */
+
 /**
  * createMerger creates a function that does a deep merge. Example:
  * ```js
@@ -64,8 +66,19 @@ const createMergeConfigOverride = (content, key) => updates => {
   Object.assign(hostObjectForUpdates, updates);
 };
 
-// This provides the base functionality that all types of
-// request payloads share.
+/**
+ * Creates a request payload object with methods for merging different types of data.
+ * This provides the base functionality that all types of request payloads share.
+ *
+ * @function
+ *
+ * @param {Object} options
+ * @param {Object} options.content
+ * @param {function(string, Identity): void} options.addIdentity
+ * @param {function(string):  boolean} options.hasIdentity
+ *
+ * @returns {RequestPayload}
+ */
 var _default = options => {
   const {
     content,

package/libEs5/utils/request/types.js

@@ -0,0 +1,52 @@
+"use strict";
+
+exports.Types = void 0;
+/**
+ * Request object with methods to access and modify request properties.
+ *
+ * @typedef {Object} Request
+ * @property {function(): string} getId
+ * @property {function(): RequestPayload} getPayload
+ * @property {function({isIdentityEstablished: boolean}): string}  getAction
+ * @property {function(): string|undefined} getDatastreamIdOverride
+ * @property {Function} getUseSendBeacon
+ * @property {function(): string|undefined} getEdgeSubPath
+ * @property {Function} getUseIdThirdPartyDomain
+ * @property {Function} setUseIdThirdPartyDomain
+ * @property {Function} setIsIdentityEstablished
+ */
+
+/**
+ * Request payload object with methods for merging different types of data.
+ *
+ * @typedef {Object} RequestPayload
+ * @property {function(object): void} mergeMeta
+ * @property {function(object): void} mergeState
+ * @property {function(object): void} mergeQuery
+ * @property {function(object): void} mergeConfigOverride
+ * @property {function(string, Identity): void} options.addIdentity
+ * @property {function(string): boolean} options.hasIdentity
+ * @property {function(): object} toJSON
+ */
+
+/**
+ * Request payload object with methods for merging different types of data.
+ *
+ * @typedef {Object} DataCollectionRequestPayload
+ * @property {function(object): void} mergeMeta
+ * @property {function(object): void} mergeState
+ * @property {function(object): void} mergeQuery
+ * @property {function(object): void} mergeConfigOverride
+ * @property {function(string, Identity): void} options.addIdentity
+ * @property {function(string): boolean} options.hasIdentity
+ * @property {function(object): void} addEvent
+ * @property {function(): boolean} getDocumentMayUnload
+ * @property {function(): object} toJSON
+ */
+
+/**
+ * @typedef {Object} Identity
+ * @property {string} id
+ */
+
+const Types = exports.Types = {};

package/libEs5/utils/types.js

@@ -0,0 +1,39 @@
+"use strict";
+
+exports.Types = void 0;
+/**
+ * @typedef {Object} Storage
+ * @property {function(string): string|null} getItem
+ * @property {function(string, string): void} setItem
+ * @property {function(): void} clear
+ */
+
+/**
+ * @typedef {Object} CookieAttributes
+ * @property {number|Date} [expires] - Cookie expiration (number of days or Date object)
+ * @property {string} [path] - Cookie path (default: "/")
+ * @property {string} [domain] - Cookie domain
+ * @property {boolean} [secure] - Requires HTTPS transmission
+ * @property {"strict"|"lax"|"none"} [sameSite] - SameSite attribute
+ */
+
+/**
+ * @typedef {Object} CookieConverter
+ * @property {function(string, string): string} [read] - Custom decoder function
+ * @property {function(string, string): string} [write] - Custom encoder function
+ */
+
+/**
+ * @typedef {Object} CookieJar
+ * @property {function(string): string|undefined} get - Get cookie value by name, or get all cookies as object if no name provided
+ * @property {function(): Object<string, string>} get - Get all cookies as key-value object when called with no arguments
+ * @property {function(string, string, CookieAttributes=): string|undefined} set - Set cookie with optional attributes
+ * @property {function(string, CookieAttributes=): void} remove - Remove cookie with optional attributes (must match set attributes)
+ * @property {function(CookieConverter): CookieJar} withConverter - Create new instance with custom encoding/decoding
+ */
+
+/**
+ * @typedef {function(string): { session: Storage, persistent: Storage }} StorageCreator
+ */
+
+const Types = exports.Types = {};

package/libEs6/components/ActivityCollector/utils/dom/findClickableElement.js

@@ -17,6 +17,10 @@ import isButtonSubmitElement from "./isButtonSubmitElement.js";
 export default element => {
   let node = element;
   while (node) {
+    // Stop looking when BODY is reached
+    if (node.nodeName && node.nodeName === "BODY") {
+      break;
+    }
     if (isSupportedAnchorElement(node) || elementHasClickHandler(node) || isInputSubmitElement(node) || isButtonSubmitElement(node)) {
       return node;
     }

package/libEs6/components/Advertising/handlers/clickThroughHandler.js

@@ -62,7 +62,8 @@ export default async function handleClickThrough({
         }
       }
     },
-    eventType: AD_CONVERSION_CLICK_EVENT_TYPE
+    eventType: AD_CONVERSION_CLICK_EVENT_TYPE,
+    timestamp: new Date().toISOString()
   };
   event.setUserXdm(xdm);
   cookieManager.setValue(LAST_CONVERSION_TIME_KEY);

package/libEs6/components/Advertising/handlers/onBeforeSendEventHandler.js

@@ -10,11 +10,12 @@ import { getRampId } from "../identities/collectRampId.js";
 import { appendAdvertisingIdQueryToEvent, getUrlParams, isThrottled } from "../utils/helpers.js";
 import { SURFER_ID, ID5_ID, RAMP_ID } from "../constants/index.js";
 import { AUTO, WAIT } from "../../../constants/consentStatus.js";
+import { CHROME } from "../../../constants/browser.js";
 const isAdvertisingDisabled = advertising => {
-  return ![AUTO, WAIT].includes(advertising?.handleAdvertisingData);
+  return ![AUTO, WAIT].includes(advertising?.handleAdvertisingData?.toLowerCase());
 };
 const waitForAdvertisingId = advertising => {
-  return advertising?.handleAdvertisingData === WAIT;
+  return advertising?.handleAdvertisingData?.toLowerCase() === WAIT;
 };
 
 /**
@@ -44,7 +45,11 @@ export default async function handleOnBeforeSendEvent({
   if (isAdvertisingDisabled(advertising) || isClickThru || isThrottled(SURFER_ID, cookieManager) && isThrottled(ID5_ID, cookieManager) && isThrottled(RAMP_ID, cookieManager)) return;
   try {
     const useShortTimeout = waitForAdvertisingId(advertising);
-    const [surferIdResult, id5IdResult, rampIdResult] = await Promise.allSettled([collectSurferId(cookieManager, getBrowser, useShortTimeout), getID5Id(logger, componentConfig.id5PartnerId, useShortTimeout, useShortTimeout), getRampId(logger, componentConfig.rampIdJSPath, cookieManager, useShortTimeout, useShortTimeout)]);
+    let rampIdPromise = null;
+    if (!getBrowser || getBrowser() !== CHROME) {
+      rampIdPromise = getRampId(logger, componentConfig.rampIdJSPath, cookieManager, useShortTimeout, useShortTimeout);
+    }
+    const [surferIdResult, id5IdResult, rampIdResult] = await Promise.allSettled([collectSurferId(cookieManager, getBrowser, useShortTimeout), getID5Id(logger, componentConfig.id5PartnerId, useShortTimeout, useShortTimeout), rampIdPromise]);
     const availableIds = {};
     if (surferIdResult.status === "fulfilled" && surferIdResult.value && !isThrottled(SURFER_ID, cookieManager)) {
       availableIds.surferId = surferIdResult.value;

package/libEs6/components/Advertising/handlers/viewThroughHandler.js

@@ -23,7 +23,8 @@ export default async function handleViewThrough({
     try {
       const event = appendAdvertisingIdQueryToEvent(resolvedIds, eventManager.createEvent(), cookieManager, componentConfig, true);
       const xdm = {
-        eventType: AD_CONVERSION_VIEW_EVENT_TYPE
+        eventType: AD_CONVERSION_VIEW_EVENT_TYPE,
+        timestamp: new Date().toISOString()
       };
       event.setUserXdm(xdm);
       const result = await adConversionHandler.trackAdConversion({

package/libEs6/components/Advertising/identities/collectID5Id.js

@@ -13,7 +13,7 @@ import { loadScript } from "../../../utils/dom/index.js";
 import { ID5_SCRIPT_URL } from "../constants/index.js";
 let id5Id = "";
 let inProgressId5Promise = null;
-const SHORT_TIMEOUT_MS = 5000;
+const SHORT_TIMEOUT_MS = 2000;
 const DEFAULT_TIMEOUT_MS = 30000;
 const initiateID5Call = (partnerId, useShortTimeout, logger) => {
   partnerId = Math.floor(Number(partnerId));

package/libEs6/components/Advertising/identities/collectRampId.js

@@ -17,7 +17,7 @@ const RETRY_CONFIG = {
   MAX_TIME_MS: 30000,
   DELAY_BASE_MS: 500,
   MAX_DELAY_MS: 5000,
-  SHORT_TIMEOUT_MS: 5000
+  SHORT_TIMEOUT_MS: 2000
 };
 const state = {
   rampIdEnv: undefined,

package/libEs6/components/Consent/createConsentRequestPayload.js

@@ -10,10 +10,18 @@ OF ANY KIND, either express or implied. See the License for the specific languag
 governing permissions and limitations under the License.
 */
 
+/** @import { ConsentRequestPayload } from './types.js' */
+
 import { createRequestPayload } from "../../utils/request/index.js";
+
+/**
+ * @function
+ *
+ * @returns {ConsentRequestPayload}
+ */
 export default () => {
   const content = {};
-  const payload = createRequestPayload({
+  const requestPayload = createRequestPayload({
     content,
     addIdentity: (namespaceCode, identity) => {
       content.identityMap = content.identityMap || {};
@@ -24,8 +32,13 @@ export default () => {
       return (content.identityMap && content.identityMap[namespaceCode]) !== undefined;
     }
   });
-  payload.setConsent = consent => {
-    content.consent = consent;
+
+  /** @type {ConsentRequestPayload} */
+  const payload = {
+    ...requestPayload,
+    setConsent: consent => {
+      content.consent = consent;
+    }
   };
   return payload;
 };

package/libEs6/components/Consent/types.js

@@ -0,0 +1,15 @@
+/**
+ * Request payload object with methods for merging different types of data.
+ *
+ * @typedef {Object} ConsentRequestPayload
+ * @property {Function} mergeMeta
+ * @property {Function} mergeState
+ * @property {Function} mergeQuery
+ * @property {Function} mergeConfigOverride
+ * @property {Function} addIdentity
+ * @property {Function} hasIdentity
+ * @property {Function} toJSON
+ * @property {Function} setConsent
+ */
+
+export const Types = {};

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

@@ -40,9 +40,10 @@ const renderContent = ({
   content,
   decorateProposition,
   renderFunc,
-  renderStatusHandler
+  renderStatusHandler,
+  alwaysRender
 }) => {
-  const executions = containers.filter(renderStatusHandler.shouldRender).map(async container => {
+  const executions = containers.filter(element => alwaysRender || renderStatusHandler.shouldRender(element)).map(async container => {
     await renderFunc(container, content, decorateProposition);
     renderStatusHandler.markAsRendered(container);
   });
@@ -53,8 +54,9 @@ const renderContent = ({
  * Creates an action function that renders content into a container element.
  *
  * @param {Function} renderFunc - The function that performs the rendering.
+ * @param {boolean} alwaysRender - Whether to always render the content, even if it has already been rendered.
  */
-export const createAction = renderFunc => {
+export const createAction = (renderFunc, alwaysRender = false) => {
   /**
    * Renders content into a container element.
    *
@@ -76,7 +78,8 @@ export const createAction = renderFunc => {
         content,
         decorateProposition,
         renderFunc,
-        renderStatusHandler
+        renderStatusHandler,
+        alwaysRender
       });
     } finally {
       showElements(prehidingSelector);

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

@@ -45,21 +45,21 @@ export const DOM_ACTION_CLICK = "click";
 export const DOM_ACTION_COLLECT_INTERACTIONS = "collectInteractions";
 export default () => {
   return {
-    [DOM_ACTION_SET_HTML]: createAction(setHtml),
+    [DOM_ACTION_SET_HTML]: createAction(setHtml, true),
     [DOM_ACTION_CUSTOM_CODE]: createAction(prependHtml),
-    [DOM_ACTION_SET_TEXT]: createAction(setText),
-    [DOM_ACTION_SET_ATTRIBUTE]: createAction(setAttributes),
-    [DOM_ACTION_SET_IMAGE_SOURCE]: createAction(swapImage),
-    [DOM_ACTION_SET_STYLE]: createAction(setStyles),
-    [DOM_ACTION_MOVE]: createAction(move),
-    [DOM_ACTION_RESIZE]: createAction(resize),
+    [DOM_ACTION_SET_TEXT]: createAction(setText, true),
+    [DOM_ACTION_SET_ATTRIBUTE]: createAction(setAttributes, true),
+    [DOM_ACTION_SET_IMAGE_SOURCE]: createAction(swapImage, true),
+    [DOM_ACTION_SET_STYLE]: createAction(setStyles, true),
+    [DOM_ACTION_MOVE]: createAction(move, true),
+    [DOM_ACTION_RESIZE]: createAction(resize, true),
     [DOM_ACTION_REARRANGE]: createAction(rearrangeChildren),
-    [DOM_ACTION_REMOVE]: createAction(removeNode),
+    [DOM_ACTION_REMOVE]: createAction(removeNode, true),
     [DOM_ACTION_INSERT_AFTER]: createAction(insertHtmlAfter),
     [DOM_ACTION_INSERT_BEFORE]: createAction(insertHtmlBefore),
-    [DOM_ACTION_REPLACE_HTML]: createAction(replaceHtml),
+    [DOM_ACTION_REPLACE_HTML]: createAction(replaceHtml, true),
     [DOM_ACTION_PREPEND_HTML]: createAction(prependHtml),
     [DOM_ACTION_APPEND_HTML]: createAction(appendHtml),
-    [DOM_ACTION_COLLECT_INTERACTIONS]: createAction(collectInteractions)
+    [DOM_ACTION_COLLECT_INTERACTIONS]: createAction(collectInteractions, true)
   };
 };

package/libEs6/components/PushNotifications/helpers/constants.js

@@ -0,0 +1,16 @@
+/*
+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.
+*/
+
+export const DB_NAME = "alloyPushNotifications";
+export const DB_VERSION = 1;
+export const STORE_NAME = "config";
+export const INDEX_KEY = "alloyConfig";

package/libEs6/components/PushNotifications/helpers/getPushSubscriptionDetails.js

@@ -0,0 +1,114 @@
+/*
+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.
+*/
+
+/** @import { PushSubscription } from '../types.js' */
+
+import { base64ToBytes, bytesToBase64 } from "../../../utils/index.js";
+
+/**
+ * Gets push subscription details for the current browser.
+ *
+ * @async
+ * @function
+ *
+ * @param {object} options
+ * @param {string} options.vapidPublicKey - The VAPID public key in base64 format used for push notification authentication.
+ * @param {Window} options.window
+ *
+ * @returns {Promise<PushSubscription>} A promise that resolves to an object containing the push subscription details.
+
+ * @throws {Error} Throws an error if service workers are not supported in the browser.
+ * @throws {Error} Throws an error if user didn't approve push notifications for the domain.
+ * @throws {Error} Throws an error if push notifications are not supported in the browser.
+ * @throws {Error} Throws an error if no VAPID public key was provided.
+ *
+ * @example
+ * // Get subscription details with VAPID key
+ * const vapidKey = "BEl62iUYgUivxIkv69yViEuiBIa40HI5hmjHbKPlXO...";
+ * const subscription = await getPushSubscriptionDetails(vapidKey);
+ * console.log(subscription.endpoint); // "https://fcm.googleapis.com/fcm/send/..."
+ */
+const getPushSubscriptionDetails = async ({
+  vapidPublicKey,
+  window
+}) => {
+  if (!("serviceWorker" in window.navigator)) {
+    throw new Error("Service workers are not supported in this browser.");
+  }
+  if (!("PushManager" in window) || !("Notification" in window)) {
+    throw new Error("Push notifications are not supported in this browser.");
+  }
+
+  /** @type {object} */
+  const notification = window.Notification;
+  if (notification.permission !== "granted") {
+    throw new Error("The user has not given permission to send push notifications.");
+  }
+  const serviceWorkerRegistration =
+  // eslint-disable-next-line compat/compat
+  await window.navigator.serviceWorker.getRegistration();
+  if (!serviceWorkerRegistration) {
+    throw new Error("No service worker registration was found.");
+  }
+
+  // Even `applicationServerKey` is not required in the spec, some browsers like Chrome are requiring it.
+  if (!vapidPublicKey) {
+    throw new Error("No VAPID public key was provided.");
+  }
+  const subscriptionOptions = {
+    userVisibleOnly: true,
+    applicationServerKey: base64ToBytes(vapidPublicKey)
+  };
+
+  // Push subscription handling strategy:
+  //
+  // 1. We always call subscribe() to either get the current subscription or create a new one.
+  //    - If called with the same VAPID key as an existing subscription, it returns that subscription
+  //    - If called with a different VAPID key when a subscription exists, it throws an error
+  //
+  // 2. Error handling approach:
+  //    - Browser error messages vary and don't clearly indicate VAPID key conflicts
+  //    - When subscribe() fails, we assume it's likely due to a VAPID key mismatch
+  //    - We attempt recovery by unsubscribing the existing subscription and retrying
+  //    - If the retry also fails, we re-throw the original error
+  //
+  // This strategy ensures we can handle both new subscriptions and VAPID key changes
+  // while gracefully falling back to error reporting when recovery isn't possible.
+  try {
+    const subscription = await serviceWorkerRegistration.pushManager.subscribe(subscriptionOptions);
+    return {
+      endpoint: subscription.endpoint,
+      keys: {
+        p256dh: bytesToBase64(new Uint8Array(subscription.getKey("p256dh")), {
+          urlSafe: true
+        }),
+        auth: bytesToBase64(new Uint8Array(subscription.getKey("auth")), {
+          urlSafe: true
+        })
+      }
+    };
+  } catch (e) {
+    const subscription = await serviceWorkerRegistration.pushManager.getSubscription();
+    if (!subscription) {
+      throw e;
+    }
+    const unsubscribeResult = await subscription.unsubscribe();
+    if (!unsubscribeResult) {
+      throw e;
+    }
+    return getPushSubscriptionDetails({
+      vapidPublicKey,
+      window
+    });
+  }
+};
+export default getPushSubscriptionDetails;

package/libEs6/components/PushNotifications/helpers/readFromIndexedDb.js

@@ -0,0 +1,40 @@
+/*
+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.
+*/
+
+/** @import { ServiceWorkerLogger } from '../types.js' */
+
+import { getFromIndexedDbStore, openIndexedDb } from "../../../utils/indexedDb.js";
+import { DB_NAME, DB_VERSION, STORE_NAME, INDEX_KEY } from "./constants.js";
+
+/**
+ * @param {ServiceWorkerLogger} logger
+ * @returns {Promise<Object|undefined>}
+ * @throws {Error}
+ */
+export default async logger => {
+  try {
+    const db = await openIndexedDb(DB_NAME, DB_VERSION, (/** @type {IDBDatabase} */db) => {
+      if (!db.objectStoreNames.contains(STORE_NAME)) {
+        db.createObjectStore(STORE_NAME, {
+          keyPath: "id"
+        });
+      }
+    });
+    const existingConfigData = await getFromIndexedDbStore(db, STORE_NAME, INDEX_KEY);
+    db.close();
+    return existingConfigData;
+  } catch (error) {
+    logger.error("Failed to read data from IndexedDB", {
+      error
+    });
+  }
+};

package/libEs6/components/PushNotifications/helpers/saveToIndexedDb.js

@@ -0,0 +1,48 @@
+/*
+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.
+*/
+
+/** @import { Logger } from '../../../core/types.js' */
+
+import { openIndexedDb, getFromIndexedDbStore, putToIndexedDbStore } from "../../../utils/index.js";
+import { DB_NAME, DB_VERSION, STORE_NAME, INDEX_KEY } from "./constants.js";
+
+/**
+ * @param {Object} data
+ * @param {Logger} logger
+ *
+ * @returns {Promise<void>}
+ */
+export default async function saveToIndexedDB(data, logger) {
+  try {
+    const db = await openIndexedDb(DB_NAME, DB_VERSION, (/** @type {IDBDatabase} */db) => {
+      if (!db.objectStoreNames.contains(STORE_NAME)) {
+        db.createObjectStore(STORE_NAME, {
+          keyPath: "id"
+        });
+      }
+    });
+    const existingConfigData = await getFromIndexedDbStore(db, STORE_NAME, INDEX_KEY);
+    const updatedConfigData = {
+      ...(existingConfigData || {}),
+      ...data,
+      id: INDEX_KEY,
+      timestamp: Date.now()
+    };
+    await putToIndexedDbStore(db, STORE_NAME, updatedConfigData);
+    db.close();
+    logger.info("Successfully saved web SDK config to IndexedDB", updatedConfigData);
+  } catch (error) {
+    logger.error("Failed to save config to IndexedDB", {
+      error
+    });
+  }
+}

package/libEs6/components/PushNotifications/helpers/serviceWorkerNotificationClickListener.js

@@ -0,0 +1,82 @@
+/*
+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.
+*/
+
+// @ts-check
+/// <reference lib="webworker" />
+
+/** @import { ServiceWorkerLogger } from '../types.js' */
+
+import makeSendServiceWorkerTrackingData from "../request/makeSendServiceWorkerTrackingData.js";
+
+/**
+ * @param {string} type
+ * @returns {boolean}
+ */
+const canHandleUrl = type => ["DEEPLINK", "WEBURL"].includes(type);
+
+/**
+ * @function
+ *
+ * @param {Object} options
+ * @param {ServiceWorkerGlobalScope} options.sw
+ * @param {NotificationEvent} options.event
+ * @param {(url: string, options: object) => Promise<Response>} options.fetch
+ * @param {ServiceWorkerLogger} options.logger
+ */
+export default ({
+  event,
+  sw,
+  logger,
+  fetch
+}) => {
+  event.notification.close();
+  const data = event.notification.data;
+  let targetUrl = null;
+  let actionLabel = null;
+  if (event.action) {
+    const actionIndex = parseInt(event.action.replace("action_", ""), 10);
+    if (data?.actions?.buttons[actionIndex]) {
+      const button = data.actions.buttons[actionIndex];
+      actionLabel = button.label;
+      if (canHandleUrl(button.type) && button.uri) {
+        targetUrl = button.uri;
+      }
+    }
+  } else if (canHandleUrl(data?.interaction?.type) && data?.interaction?.uri) {
+    targetUrl = data.interaction.uri;
+  }
+  makeSendServiceWorkerTrackingData({
+    // eslint-disable-next-line no-underscore-dangle
+    xdm: data._xdm.mixins,
+    actionLabel,
+    applicationLaunches: 1
+  }, {
+    logger,
+    fetch
+  }).catch(error => {
+    logger.error("Failed to send tracking call:", error);
+  });
+  if (targetUrl) {
+    event.waitUntil(sw.clients.matchAll({
+      type: "window"
+    }).then(clientList => {
+      for (const client of clientList) {
+        if (client.url === targetUrl && "focus" in client) {
+          return client.focus();
+        }
+      }
+      if (sw.clients.openWindow) {
+        return sw.clients.openWindow(targetUrl);
+      }
+    }));
+  }
+};