@adobe/alloy 2.29.0-beta.5 → 2.29.0

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

@@ -19,6 +19,10 @@ governing permissions and limitations under the License.
 var _default = element => {
   let node = element;
   while (node) {
+    // Stop looking when BODY is reached
+    if (node.nodeName && node.nodeName === "BODY") {
+      break;
+    }
     if ((0, _isSupportedAnchorElement.default)(node) || (0, _elementHasClickHandler.default)(node) || (0, _isInputSubmitElement.default)(node) || (0, _isButtonSubmitElement.default)(node)) {
       return node;
     }

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

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

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

@@ -7,6 +7,7 @@ var _collectRampId = require("../identities/collectRampId.js");
 var _helpers = require("../utils/helpers.js");
 var _index = require("../constants/index.js");
 var _consentStatus = require("../../../constants/consentStatus.js");
+var _browser = require("../../../constants/browser.js");
 /*
 Copyright 2023 Adobe. All rights reserved.
 Licensed under the Apache License, Version 2.0.
@@ -14,10 +15,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 */
 
 const isAdvertisingDisabled = advertising => {
-  return ![_consentStatus.AUTO, _consentStatus.WAIT].includes(advertising?.handleAdvertisingData);
+  return ![_consentStatus.AUTO, _consentStatus.WAIT].includes(advertising?.handleAdvertisingData?.toLowerCase());
 };
 const waitForAdvertisingId = advertising => {
-  return advertising?.handleAdvertisingData === _consentStatus.WAIT;
+  return advertising?.handleAdvertisingData?.toLowerCase() === _consentStatus.WAIT;
 };
 
 /**
@@ -47,7 +48,11 @@ async function handleOnBeforeSendEvent({
   if (isAdvertisingDisabled(advertising) || isClickThru || (0, _helpers.isThrottled)(_index.SURFER_ID, cookieManager) && (0, _helpers.isThrottled)(_index.ID5_ID, cookieManager) && (0, _helpers.isThrottled)(_index.RAMP_ID, cookieManager)) return;
   try {
     const useShortTimeout = waitForAdvertisingId(advertising);
-    const [surferIdResult, id5IdResult, rampIdResult] = await Promise.allSettled([(0, _collectSurferId.default)(cookieManager, getBrowser, useShortTimeout), (0, _collectID5Id.getID5Id)(logger, componentConfig.id5PartnerId, useShortTimeout, useShortTimeout), (0, _collectRampId.getRampId)(logger, componentConfig.rampIdJSPath, cookieManager, useShortTimeout, useShortTimeout)]);
+    let rampIdPromise = null;
+    if (!getBrowser || getBrowser() !== _browser.CHROME) {
+      rampIdPromise = (0, _collectRampId.getRampId)(logger, componentConfig.rampIdJSPath, cookieManager, useShortTimeout, useShortTimeout);
+    }
+    const [surferIdResult, id5IdResult, rampIdResult] = await Promise.allSettled([(0, _collectSurferId.default)(cookieManager, getBrowser, useShortTimeout), (0, _collectID5Id.getID5Id)(logger, componentConfig.id5PartnerId, useShortTimeout, useShortTimeout), rampIdPromise]);
     const availableIds = {};
     if (surferIdResult.status === "fulfilled" && surferIdResult.value && !(0, _helpers.isThrottled)(_index.SURFER_ID, cookieManager)) {
       availableIds.surferId = surferIdResult.value;

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

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

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

@@ -17,7 +17,7 @@ governing permissions and limitations under the License.
 
 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/libEs5/components/Advertising/identities/collectRampId.js

@@ -20,7 +20,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/libEs5/components/Consent/createConsentRequestPayload.js

@@ -13,9 +13,15 @@ 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 { ConsentRequestPayload } from './types.js' */
+/**
+ * @function
+ *
+ * @returns {ConsentRequestPayload}
+ */
 var _default = () => {
   const content = {};
-  const payload = (0, _index.createRequestPayload)({
+  const requestPayload = (0, _index.createRequestPayload)({
     content,
     addIdentity: (namespaceCode, identity) => {
       content.identityMap = content.identityMap || {};
@@ -26,8 +32,13 @@ var _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/libEs5/components/Consent/types.js

@@ -0,0 +1,18 @@
+"use strict";
+
+exports.Types = void 0;
+/**
+ * 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
+ */
+
+const Types = exports.Types = {};

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

@@ -108,9 +108,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);
   });
@@ -121,8 +122,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.
  */
-const createAction = renderFunc => {
+const createAction = (renderFunc, alwaysRender = false) => {
   /**
    * Renders content into a container element.
    *
@@ -144,7 +146,8 @@ const createAction = renderFunc => {
         content,
         decorateProposition,
         renderFunc,
-        renderStatusHandler
+        renderStatusHandler,
+        alwaysRender
       });
     } finally {
       (0, _index2.showElements)(prehidingSelector);

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

@@ -48,22 +48,22 @@ const DOM_ACTION_CLICK = exports.DOM_ACTION_CLICK = "click";
 const DOM_ACTION_COLLECT_INTERACTIONS = exports.DOM_ACTION_COLLECT_INTERACTIONS = "collectInteractions";
 var _default = () => {
   return {
-    [DOM_ACTION_SET_HTML]: (0, _action.createAction)(_setHtml.default),
+    [DOM_ACTION_SET_HTML]: (0, _action.createAction)(_setHtml.default, true),
     [DOM_ACTION_CUSTOM_CODE]: (0, _action.createAction)(_prependHtml.default),
-    [DOM_ACTION_SET_TEXT]: (0, _action.createAction)(_setText.default),
-    [DOM_ACTION_SET_ATTRIBUTE]: (0, _action.createAction)(_setAttributes.default),
-    [DOM_ACTION_SET_IMAGE_SOURCE]: (0, _action.createAction)(_swapImage.default),
-    [DOM_ACTION_SET_STYLE]: (0, _action.createAction)(_setStyles.default),
-    [DOM_ACTION_MOVE]: (0, _action.createAction)(_move.default),
-    [DOM_ACTION_RESIZE]: (0, _action.createAction)(_resize.default),
+    [DOM_ACTION_SET_TEXT]: (0, _action.createAction)(_setText.default, true),
+    [DOM_ACTION_SET_ATTRIBUTE]: (0, _action.createAction)(_setAttributes.default, true),
+    [DOM_ACTION_SET_IMAGE_SOURCE]: (0, _action.createAction)(_swapImage.default, true),
+    [DOM_ACTION_SET_STYLE]: (0, _action.createAction)(_setStyles.default, true),
+    [DOM_ACTION_MOVE]: (0, _action.createAction)(_move.default, true),
+    [DOM_ACTION_RESIZE]: (0, _action.createAction)(_resize.default, true),
     [DOM_ACTION_REARRANGE]: (0, _action.createAction)(_rearrangeChildren.default),
-    [DOM_ACTION_REMOVE]: (0, _action.createAction)(_index.removeNode),
+    [DOM_ACTION_REMOVE]: (0, _action.createAction)(_index.removeNode, true),
     [DOM_ACTION_INSERT_AFTER]: (0, _action.createAction)(_insertHtmlAfter.default),
     [DOM_ACTION_INSERT_BEFORE]: (0, _action.createAction)(_insertHtmlBefore.default),
-    [DOM_ACTION_REPLACE_HTML]: (0, _action.createAction)(_replaceHtml.default),
+    [DOM_ACTION_REPLACE_HTML]: (0, _action.createAction)(_replaceHtml.default, true),
     [DOM_ACTION_PREPEND_HTML]: (0, _action.createAction)(_prependHtml.default),
     [DOM_ACTION_APPEND_HTML]: (0, _action.createAction)(_appendHtml.default),
-    [DOM_ACTION_COLLECT_INTERACTIONS]: (0, _action.createAction)(_collectInteractions.default)
+    [DOM_ACTION_COLLECT_INTERACTIONS]: (0, _action.createAction)(_collectInteractions.default, true)
   };
 };
 exports.default = _default;

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

@@ -0,0 +1,116 @@
+"use strict";
+
+exports.default = void 0;
+var _index = require("../../../utils/index.js");
+/*
+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' */
+
+/**
+ * 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: (0, _index.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: (0, _index.bytesToBase64)(new Uint8Array(subscription.getKey("p256dh")), {
+          urlSafe: true
+        }),
+        auth: (0, _index.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
+    });
+  }
+};
+var _default = exports.default = getPushSubscriptionDetails;

package/libEs5/components/PushNotifications/index.js

@@ -0,0 +1,96 @@
+"use strict";
+
+exports.default = void 0;
+var _index = require("../../utils/validation/index.js");
+var _index2 = require("../../utils/index.js");
+var _makeSendPushSubscriptionRequest = require("./request/makeSendPushSubscriptionRequest.js");
+/*
+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 { StorageCreator } from '../../utils/types.js' */
+/** @import { EventManager, Logger } from '../../core/types.js' */
+/** @import { IdentityManager } from '../../core/identity/types.js' */
+/** @import { ConsentManager } from '../../core/consent/types.js' */
+/** @import { EdgeRequestExecutor } from '../../core/edgeNetwork/types.js' */
+
+const isComponentConfigured = ({
+  orgId,
+  pushNotifications: {
+    vapidPublicKey
+  } = {
+    vapidPublicKey: undefined
+  }
+}) => orgId && vapidPublicKey;
+
+/**
+ * @function
+ *
+ * @param {Object} options
+ * @param {{ orgId: string, pushNotifications: { vapidPublicKey: string }}} options.config
+ * @param {StorageCreator} options.createNamespacedStorage
+ * @param {EventManager} options.eventManager
+ * @param {Logger} options.logger
+ * @param {ConsentManager} options.consent
+ * @param {IdentityManager} options.identity
+ * @param {EdgeRequestExecutor} options.sendEdgeNetworkRequest
+ * @returns {{  commands: { sendPushSubscription: object } }}
+ */
+const createPushNotifications = ({
+  createNamespacedStorage,
+  eventManager,
+  config,
+  logger,
+  consent,
+  identity,
+  sendEdgeNetworkRequest
+}) => {
+  return {
+    commands: {
+      sendPushSubscription: {
+        run: async () => {
+          if (!isComponentConfigured(config)) {
+            throw new Error("Push notifications module is not configured. No VAPID public key was provided.");
+          }
+          const {
+            orgId,
+            pushNotifications: {
+              vapidPublicKey
+            } = {
+              vapidPublicKey: undefined
+            }
+          } = config || {};
+          const storage = createNamespacedStorage((0, _index2.sanitizeOrgIdForCookieName)(orgId) + ".pushNotifications.");
+          return (0, _makeSendPushSubscriptionRequest.default)({
+            config: {
+              vapidPublicKey
+            },
+            storage: storage.persistent,
+            logger,
+            sendEdgeNetworkRequest,
+            consent,
+            eventManager,
+            identity,
+            window
+          });
+        },
+        optionsValidator: (0, _index.objectOf)({}).noUnknownFields()
+      }
+    }
+  };
+};
+createPushNotifications.namespace = "Push Notifications";
+createPushNotifications.configValidators = (0, _index.objectOf)({
+  pushNotifications: (0, _index.objectOf)({
+    vapidPublicKey: (0, _index.string)().required()
+  }).noUnknownFields()
+});
+var _default = exports.default = createPushNotifications;

package/libEs5/components/PushNotifications/request/createSendPushSubscriptionPayload.js

@@ -0,0 +1,62 @@
+"use strict";
+
+exports.default = void 0;
+var _createDataCollectionRequestPayload = require("../../../utils/request/createDataCollectionRequestPayload.js");
+/*
+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 { EventManager } from "../../../core/types.js" */
+/** @import { DataCollectionRequestPayload } from "../../../utils/request/types.js" */
+/**
+ * Creates a data collection request payload for sending push subscription details to Adobe Experience Platform.
+ *
+ * This function constructs an event containing push notification subscription information,
+ * including the subscription details, platform information, and identity data. The event
+ * is then packaged into a data collection request payload for transmission to the edge network.
+ *
+ * @async
+ * @function
+ *
+ * @param {Object} options
+ * @param {string} options.ecid
+ * @param {EventManager} options.eventManager
+ * @param {string} options.serializedPushSubscriptionDetails
+ * @param {Window} options.window
+ *
+ * @returns {Promise<DataCollectionRequestPayload>}
+ */
+var _default = async ({
+  ecid,
+  eventManager,
+  serializedPushSubscriptionDetails,
+  window
+}) => {
+  const event = eventManager.createEvent();
+  event.setUserData({
+    pushNotificationDetails: [{
+      appID: window.location.host,
+      token: serializedPushSubscriptionDetails,
+      platform: "web",
+      denylisted: false,
+      identity: {
+        namespace: {
+          code: "ECID"
+        },
+        id: ecid
+      }
+    }]
+  });
+  event.finalize();
+  const payload = (0, _createDataCollectionRequestPayload.default)();
+  payload.addEvent(event);
+  return payload;
+};
+exports.default = _default;

package/libEs5/components/PushNotifications/request/createSendPushSubscriptionRequest.js

@@ -0,0 +1,35 @@
+"use strict";
+
+exports.default = void 0;
+var _index = require("../../../utils/request/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.
+*/
+/** @import { DataCollectionRequestPayload, Request } from '../../../utils/request/types.js' */
+/**
+ * @function
+ *
+ * @param {{ payload: DataCollectionRequestPayload }} options
+ *
+ * @returns {Request}
+ */
+var _default = ({
+  payload
+}) => (0, _index.createRequest)({
+  payload,
+  getAction() {
+    return "interact";
+  },
+  getUseSendBeacon() {
+    return false;
+  }
+});
+exports.default = _default;

package/libEs5/components/PushNotifications/request/makeSendPushSubscriptionRequest.js

@@ -0,0 +1,88 @@
+"use strict";
+
+exports.default = void 0;
+var _index = require("../../../utils/index.js");
+var _getPushSubscriptionDetails = require("../helpers/getPushSubscriptionDetails.js");
+var _createSendPushSubscriptionRequest = require("./createSendPushSubscriptionRequest.js");
+var _createSendPushSubscriptionPayload = require("./createSendPushSubscriptionPayload.js");
+/*
+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 { Storage } from '../../../utils/types.js' */
+/** @import { EventManager, Logger } from '../../../core/types.js' */
+/** @import { IdentityManager } from '../../../core/identity/types.js' */
+/** @import { ConsentManager } from '../../../core/consent/types.js' */
+/** @import { EdgeRequestExecutor } from '../../../core/edgeNetwork/types.js' */
+
+const SUBSCRIPTION_DETAILS = "subscriptionDetails";
+
+/**
+ * Retrieves and returns push subscription details with sorted object keys.
+ *
+ * This function gets the push subscription details using the provided VAPID public key
+ * and returns the details with all object keys sorted recursively for consistent output.
+ *
+ * @async
+ * @function
+ *
+ * @param {Object} options
+ * @param {{vapidPublicKey: string}} options.config
+ * @param {Storage} options.storage
+ * @param {Logger} options.logger
+ * @param {EventManager} options.eventManager
+ * @param {IdentityManager} options.identity
+ * @param {EdgeRequestExecutor} options.sendEdgeNetworkRequest
+ * @param {ConsentManager} options.consent
+ * @param {Window} options.window
+ *
+ * @returns {Promise<void>}
+ */
+var _default = async ({
+  config: {
+    vapidPublicKey
+  },
+  storage,
+  logger,
+  sendEdgeNetworkRequest,
+  consent,
+  eventManager,
+  identity,
+  window
+}) => {
+  await identity.awaitIdentity();
+  const ecid = identity.getEcidFromCookie();
+  const pushSubscriptionDetails = await (0, _getPushSubscriptionDetails.default)({
+    vapidPublicKey,
+    window
+  });
+  const serializedPushSubscriptionDetails = JSON.stringify((0, _index.sortObjectKeysRecursively)(pushSubscriptionDetails));
+  const cacheValue = "" + ecid + serializedPushSubscriptionDetails;
+  if (cacheValue === storage.getItem(SUBSCRIPTION_DETAILS)) {
+    logger.info("Subscription details have not changed. Not sending to the server.");
+    return;
+  }
+  storage.setItem(SUBSCRIPTION_DETAILS, cacheValue);
+  const payload = await (0, _createSendPushSubscriptionPayload.default)({
+    eventManager,
+    ecid,
+    serializedPushSubscriptionDetails,
+    window
+  });
+  const request = (0, _createSendPushSubscriptionRequest.default)({
+    payload
+  });
+  await consent.awaitConsent();
+  await sendEdgeNetworkRequest({
+    request
+  });
+};
+exports.default = _default;

package/libEs5/components/PushNotifications/types.js

@@ -0,0 +1,14 @@
+"use strict";
+
+exports.Types = void 0;
+/** @import { Identity } from '../../utils/request/types.js' */
+
+/**
+ * @typedef {Object} PushSubscription
+ * @property {string} endpoint - The push service endpoint URL
+ * @property {Object} keys - The subscription keys object
+ * @property {string|null} keys.p256dh - The P-256 ECDH public key as an ArrayBuffer, or null if not available
+ * @property {string|null} keys.auth - The authentication secret as an ArrayBuffer, or null if not available
+ */
+
+const Types = exports.Types = {};

package/libEs5/constants/libraryVersion.js

@@ -14,4 +14,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
-var _default = exports.default = "2.29.0-beta.5";
+var _default = exports.default = "2.29.0";

package/libEs5/core/componentCreators.js

@@ -42,6 +42,12 @@ Object.defineProperty(exports, "personalization", {
     return _index6.default;
   }
 });
+Object.defineProperty(exports, "pushNotifications", {
+  enumerable: true,
+  get: function () {
+    return _index0.default;
+  }
+});
 Object.defineProperty(exports, "rulesEngine", {
   enumerable: true,
   get: function () {
@@ -62,4 +68,5 @@ var _index5 = require("../components/MediaAnalyticsBridge/index.js");
 var _index6 = require("../components/Personalization/index.js");
 var _index7 = require("../components/RulesEngine/index.js");
 var _index8 = require("../components/StreamingMedia/index.js");
-var _index9 = require("../components/Advertising/index.js");
+var _index9 = require("../components/Advertising/index.js");
+var _index0 = require("../components/PushNotifications/index.js");

package/libEs5/core/consent/createConsent.js

@@ -15,6 +15,16 @@ 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 { ConsentManager } from './types.js' */
+/**
+ * @function
+ *
+ * @param {Object} options
+ * @param {ConsentStateMachine} options.generalConsentState
+ * @param {Logger} options.logger
+ *
+ * @returns {ConsentManager}
+ */
 var _default = ({
   generalConsentState,
   logger