@adobe/alloy 2.29.0-beta.4 → 2.29.0

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/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/index.js

@@ -0,0 +1,93 @@
+/*
+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' */
+
+import { objectOf, string } from "../../utils/validation/index.js";
+import { sanitizeOrgIdForCookieName } from "../../utils/index.js";
+import makeSendPushSubscriptionRequest from "./request/makeSendPushSubscriptionRequest.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(`${sanitizeOrgIdForCookieName(orgId)}.pushNotifications.`);
+          return makeSendPushSubscriptionRequest({
+            config: {
+              vapidPublicKey
+            },
+            storage: storage.persistent,
+            logger,
+            sendEdgeNetworkRequest,
+            consent,
+            eventManager,
+            identity,
+            window
+          });
+        },
+        optionsValidator: objectOf({}).noUnknownFields()
+      }
+    }
+  };
+};
+createPushNotifications.namespace = "Push Notifications";
+createPushNotifications.configValidators = objectOf({
+  pushNotifications: objectOf({
+    vapidPublicKey: string().required()
+  }).noUnknownFields()
+});
+export default createPushNotifications;

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

@@ -0,0 +1,61 @@
+/*
+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" */
+
+import createDataCollectionRequestPayload from "../../../utils/request/createDataCollectionRequestPayload.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>}
+ */
+export 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 = createDataCollectionRequestPayload();
+  payload.addEvent(event);
+  return payload;
+};

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

@@ -0,0 +1,34 @@
+/*
+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' */
+
+import { createRequest } from "../../../utils/request/index.js";
+
+/**
+ * @function
+ *
+ * @param {{ payload: DataCollectionRequestPayload }} options
+ *
+ * @returns {Request}
+ */
+export default ({
+  payload
+}) => createRequest({
+  payload,
+  getAction() {
+    return "interact";
+  },
+  getUseSendBeacon() {
+    return false;
+  }
+});

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

@@ -0,0 +1,84 @@
+/*
+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' */
+
+import { sortObjectKeysRecursively } from "../../../utils/index.js";
+import getPushSubscriptionDetails from "../helpers/getPushSubscriptionDetails.js";
+import createSendPushSubscriptionRequest from "./createSendPushSubscriptionRequest.js";
+import createSendPushSubscriptionPayload from "./createSendPushSubscriptionPayload.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>}
+ */
+export default async ({
+  config: {
+    vapidPublicKey
+  },
+  storage,
+  logger,
+  sendEdgeNetworkRequest,
+  consent,
+  eventManager,
+  identity,
+  window
+}) => {
+  await identity.awaitIdentity();
+  const ecid = identity.getEcidFromCookie();
+  const pushSubscriptionDetails = await getPushSubscriptionDetails({
+    vapidPublicKey,
+    window
+  });
+  const serializedPushSubscriptionDetails = JSON.stringify(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 createSendPushSubscriptionPayload({
+    eventManager,
+    ecid,
+    serializedPushSubscriptionDetails,
+    window
+  });
+  const request = createSendPushSubscriptionRequest({
+    payload
+  });
+  await consent.awaitConsent();
+  await sendEdgeNetworkRequest({
+    request
+  });
+};

package/libEs6/components/PushNotifications/types.js

@@ -0,0 +1,11 @@
+/** @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
+ */
+
+export const Types = {};

package/libEs6/constants/libraryVersion.js

@@ -13,4 +13,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
 
-export default "2.29.0-beta.4";
+export default "2.29.0";

package/libEs6/core/componentCreators.js

@@ -22,4 +22,5 @@ export { default as mediaAnalyticsBridge } from "../components/MediaAnalyticsBri
 export { default as personalization } from "../components/Personalization/index.js";
 export { default as rulesEngine } from "../components/RulesEngine/index.js";
 export { default as streamingMedia } from "../components/StreamingMedia/index.js";
-export { default as advertising } from "../components/Advertising/index.js";
+export { default as advertising } from "../components/Advertising/index.js";
+export { default as pushNotifications } from "../components/PushNotifications/index.js";