@adobe/alloy 2.30.1-beta.2 → 2.30.1-beta.21

package/libEs6/components/Personalization/createComponent.js

@@ -82,11 +82,13 @@ export default ({
         if (personalizationDetails.shouldFetchData()) {
           const cacheUpdate = viewCache.createCacheUpdate(personalizationDetails.getViewName());
           onRequestFailure(() => cacheUpdate.cancel());
+          const identityMap = event.getUserIdentityMap();
           fetchDataHandler({
             cacheUpdate,
             personalizationDetails,
             event,
-            onResponse
+            onResponse,
+            identityMap
           });
         } else if (personalizationDetails.shouldUseCachedData()) {
           decisionsMetaPromises.push(viewChangeHandler({

package/libEs6/components/Personalization/createFetchDataHandler.js

@@ -27,7 +27,8 @@ export default ({
     cacheUpdate,
     personalizationDetails,
     event,
-    onResponse
+    onResponse,
+    identityMap
   }) => {
     const {
       state,
@@ -44,7 +45,7 @@ export default ({
 
     // This needs to be called before the response so that future sendEvent calls
     // can know to wait until this request is complete for pending display notifications.
-    const handleNotifications = notificationHandler(personalizationDetails.isRenderDecisions(), personalizationDetails.isSendDisplayEvent(), personalizationDetails.getViewName());
+    const handleNotifications = notificationHandler(personalizationDetails.isRenderDecisions(), personalizationDetails.isSendDisplayEvent(), personalizationDetails.getViewName(), identityMap);
     onResponse(({
       response
     }) => {
@@ -59,7 +60,7 @@ export default ({
           }
         });
       }
-      const propositions = handles.map(handle => createProposition(handle));
+      const propositions = handles.map(handle => createProposition(handle, true, false, identityMap));
       const {
         page: pagePropositions = [],
         view: viewPropositions = [],

package/libEs6/components/Personalization/createNotificationHandler.js

@@ -13,7 +13,7 @@ import { defer } from "../../utils/index.js";
 import { SUPPRESS } from "../../constants/eventType.js";
 import isNonEmptyArray from "../../utils/isNonEmptyArray.js";
 export default (collect, renderedPropositions) => {
-  return (isRenderDecisions, isSendDisplayEvent, viewName) => {
+  return (isRenderDecisions, isSendDisplayEvent, viewName, identityMap) => {
     if (!isRenderDecisions) {
       // If we aren't rendering anything, then we don't need to sendDisplayEvents.
       return () => undefined;
@@ -27,7 +27,8 @@ export default (collect, renderedPropositions) => {
       if (isNonEmptyArray(decisionsMetaDisplay)) {
         collect({
           decisionsMeta: decisionsMetaDisplay,
-          viewName
+          viewName,
+          identityMap
         });
       }
       if (isNonEmptyArray(decisionsMetaSuppressed)) {
@@ -37,7 +38,8 @@ export default (collect, renderedPropositions) => {
           propositionAction: {
             reason: "Conflict"
           },
-          viewName
+          viewName,
+          identityMap
         });
       }
     };

package/libEs6/components/Personalization/createOnDecisionHandler.js

@@ -38,7 +38,8 @@ export default ({
     renderDecisions,
     propositions,
     event,
-    personalization = {}
+    personalization = {},
+    identityMap
   }) => {
     if (!renderDecisions) {
       return Promise.resolve();
@@ -48,12 +49,12 @@ export default ({
     } = personalization;
     const viewName = event ? event.getViewName() : undefined;
     const shouldSuppressDisplay = createShouldSuppressDisplay();
-    const propositionsToExecute = propositions.map(proposition => createProposition(proposition, true, shouldSuppressDisplay(proposition)));
+    const propositionsToExecute = propositions.map(proposition => createProposition(proposition, true, shouldSuppressDisplay(proposition), identityMap));
     const {
       render,
       returnedPropositions
     } = processPropositions(propositionsToExecute);
-    const handleNotifications = notificationHandler(renderDecisions, sendDisplayEvent, viewName);
+    const handleNotifications = notificationHandler(renderDecisions, sendDisplayEvent, viewName, identityMap);
     const propositionsById = propositionsToExecute.reduce((tot, proposition) => {
       tot[proposition.getId()] = proposition;
       return tot;

package/libEs6/components/Personalization/createPersonalizationDetails.js

@@ -11,9 +11,9 @@ governing permissions and limitations under the License.
 */
 
 import { isNonEmptyString, isNonEmptyArray } from "../../utils/index.js";
-import { buildPageSurface, normalizeSurfaces } from "./utils/surfaceUtils.js";
 import PAGE_WIDE_SCOPE from "../../constants/pageWideScope.js";
 import { DEFAULT_CONTENT_ITEM, DOM_ACTION, HTML_CONTENT_ITEM, MESSAGE_IN_APP, JSON_CONTENT_ITEM, REDIRECT_ITEM, RULESET_ITEM, MESSAGE_CONTENT_CARD } from "../../constants/schema.js";
+import { buildPageSurface, normalizeSurfaces } from "../../utils/surfaceUtils.js";
 const addPageWideScope = scopes => {
   if (!scopes.includes(PAGE_WIDE_SCOPE)) {
     scopes.push(PAGE_WIDE_SCOPE);

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

@@ -46,7 +46,7 @@ export const DOM_ACTION_COLLECT_INTERACTIONS = "collectInteractions";
 export default () => {
   return {
     [DOM_ACTION_SET_HTML]: createAction(setHtml, true),
-    [DOM_ACTION_CUSTOM_CODE]: createAction(prependHtml),
+    [DOM_ACTION_CUSTOM_CODE]: createAction(prependHtml, true),
     [DOM_ACTION_SET_TEXT]: createAction(setText, true),
     [DOM_ACTION_SET_ATTRIBUTE]: createAction(setAttributes, true),
     [DOM_ACTION_SET_IMAGE_SOURCE]: createAction(swapImage, true),

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

@@ -69,7 +69,8 @@ export default ({
       render: () => {
         return shouldSuppressDisplay ? null : modules[type]({
           ...data,
-          meta
+          meta,
+          identityMap: proposition.getIdentityMap()
         });
       },
       setRenderAttempted: true,

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

@@ -27,7 +27,8 @@ export default ({
     hideElements(REDIRECT_HIDING_ELEMENT);
     return collect({
       decisionsMeta: [item.getProposition().getNotification()],
-      documentMayUnload: true
+      documentMayUnload: true,
+      identityMap: item.getProposition().getIdentityMap()
     }).then(() => {
       logger.logOnContentRendering({
         status: "rendering-redirect",

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

@@ -57,7 +57,7 @@ export default ({
       }
     };
   };
-  return (payload, visibleInReturnedItems = true, shouldSuppressDisplay = false) => {
+  return (payload, visibleInReturnedItems = true, shouldSuppressDisplay = false, identityMap = undefined) => {
     const {
       id,
       scope,
@@ -95,6 +95,9 @@ export default ({
       getId() {
         return id;
       },
+      getIdentityMap() {
+        return identityMap;
+      },
       toJSON() {
         return payload;
       },

package/libEs6/components/Personalization/in-app-message-actions/actions/displayIframeContent.js

@@ -271,7 +271,8 @@ export const displayHTMLContentInIframe = (settings = {}, interact) => {
 export default (settings, collect) => {
   return new Promise(resolve => {
     const {
-      meta
+      meta,
+      identityMap
     } = settings;
     displayHTMLContentInIframe(settings, (action, propositionAction) => {
       const propositionEventTypes = {};
@@ -283,7 +284,8 @@ export default (settings, collect) => {
         decisionsMeta: [meta],
         propositionAction,
         eventType: INTERACT,
-        propositionEventTypes: Object.keys(propositionEventTypes)
+        propositionEventTypes: Object.keys(propositionEventTypes),
+        identityMap
       });
     });
     resolve({

package/libEs6/components/Personalization/index.js

@@ -1,5 +1,5 @@
 /*
-Copyright 2019 Adobe. Ackll rights reserved.
+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
@@ -34,7 +34,7 @@ import injectCreateProposition from "./handlers/injectCreateProposition.js";
 import createAsyncArray from "./utils/createAsyncArray.js";
 import * as schema from "../../constants/schema.js";
 import processDefaultContent from "./handlers/processDefaultContent.js";
-import { isPageWideSurface } from "./utils/surfaceUtils.js";
+import { isPageWideSurface } from "../../utils/surfaceUtils.js";
 import createProcessDomAction from "./handlers/createProcessDomAction.js";
 import createProcessHtmlContent from "./handlers/createProcessHtmlContent.js";
 import createProcessRedirect from "./handlers/createProcessRedirect.js";

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

@@ -82,7 +82,7 @@ export default async ({
         throw new Error(`Cannot send tracking call. ${field.errorField} is missing.`);
       }
     }
-    const url = `https://${edgeDomain}/${edgeBasePath}/v1/interact?configId=${datastreamId}`;
+    const url = `https://${edgeDomain}/${edgeBasePath}/v1/interact?configId=${datastreamId}&requestId=${uuidv4()}`;
 
     /** @type {TrackingDataPayload} */
     const payload = {

package/libEs6/components/PushNotifications/types.js

@@ -1,3 +1,15 @@
+/*
+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 { Identity } from '../../utils/request/types.js' */
 
 /**

package/libEs6/components/RulesEngine/createApplyResponse.js

@@ -26,11 +26,13 @@ export default ({
       // We extract them and add the events to the event registry.
       const eventPayloads = extractPayloadsFromEventHistoryOperations(propositions);
       eventRegistry.addEventPayloads(eventPayloads);
+      const identityMap = event?.getUserIdentityMap();
       lifecycle.onDecision({
         renderDecisions,
         propositions,
         event,
-        personalization
+        personalization,
+        identityMap
       });
     }
     return {

package/libEs6/components/RulesEngine/types.js

@@ -1,3 +1,15 @@
+/*
+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.
+*/
+
 /**
  * @typedef {Record<string, EventRecord>} EventRegistry
  */

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.30.1-beta.2";
+export default "2.30.1-beta.21";

package/libEs6/constants/surface.js

@@ -0,0 +1,16 @@
+/*
+Copyright 2022 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 WEB = "web";
+export const WEBAPP = "webapp";
+export const SURFACE_TYPE_DELIMITER = "://";
+export const FRAGMENT_DELIMITER = "#";

package/libEs6/core/componentCreators.js

@@ -23,4 +23,5 @@ export { default as personalization } from "../components/Personalization/index.
 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 pushNotifications } from "../components/PushNotifications/index.js";
+export { default as pushNotifications } from "../components/PushNotifications/index.js";
+export { default as brandConcierge } from "../components/BrandConcierge/index.js";

package/libEs6/core/consent/types.js

@@ -1,3 +1,15 @@
+/*
+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.
+*/
+
 /**
  * @typedef {Object} ConsentStateMachine
  * @property {function(string): void} in

package/libEs6/core/createEvent.js

@@ -150,6 +150,9 @@ export default () => {
       }
       return userXdm.web.webPageDetails.viewName;
     },
+    getUserIdentityMap() {
+      return userXdm?.identityMap;
+    },
     toJSON() {
       if (!isFinalized) {
         throw new Error("toJSON called before finalize");

package/libEs6/core/edgeNetwork/types.js

@@ -1,3 +1,15 @@
+/*
+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 { Request } from '../../utils/request/types.js' */
 
 /**

package/libEs6/core/identity/types.js

@@ -1,3 +1,15 @@
+/*
+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 { CookieJar } from '../../utils/types.js' */
 

package/libEs6/core/index.js

@@ -181,6 +181,8 @@ export const createExecuteCommand = ({
       getImmediatelyAvailableTools(componentName) {
         const componentLogger = createComponentLogger(componentName);
         return {
+          loggingCookieJar,
+          instanceName,
           config,
           componentRegistry,
           consent,
@@ -196,7 +198,9 @@ export const createExecuteCommand = ({
           }),
           createNamespacedStorage,
           apexDomain,
-          getBrowser
+          getBrowser,
+          cookieTransfer,
+          createResponse
         };
       }
     });

package/libEs6/core/types.js

@@ -1,3 +1,15 @@
+/*
+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.
+*/
+
 /**
  * @typedef {object} AlloyMonitor
  * @property {function(any): void} [onBeforeLog]

package/libEs6/utils/createCollect.js

@@ -23,11 +23,13 @@ export default ({
     documentMayUnload = false,
     eventType = DISPLAY,
     propositionEventTypes = [getPropositionEventType(eventType)],
-    viewName
+    viewName,
+    identityMap
   }) => {
     const event = eventManager.createEvent();
     const data = {
-      eventType
+      eventType,
+      identityMap
     };
     if (viewName) {
       data.web = {

package/libEs6/utils/deepAssign.js

@@ -12,8 +12,14 @@ governing permissions and limitations under the License.
 
 import isNil from "./isNil.js";
 import isObject from "./isObject.js";
+
+// Keys that should never be copied to prevent prototype pollution.
+const DANGEROUS_KEYS = ["__proto__", "constructor", "prototype"];
 const deepAssignObject = (target, source) => {
   Object.keys(source).forEach(key => {
+    if (DANGEROUS_KEYS.includes(key)) {
+      return;
+    }
     if (isObject(target[key]) && isObject(source[key])) {
       deepAssignObject(target[key], source[key]);
       return;

package/libEs6/utils/dom/createGetPageLocation.js

@@ -0,0 +1,17 @@
+/*
+Copyright 2022 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 ({
+  window
+}) => () => {
+  return window.location;
+};

package/libEs6/utils/index.js

@@ -61,4 +61,5 @@ export { default as toISOStringLocal } from "./toISOStringLocal.js";
 export { default as uuid } from "./uuid.js";
 export { default as updateErrorMessage } from "./updateErrorMessage.js";
 export { default as validateIdentityMap } from "./validateIdentityMap.js";
-export { default as validateConfigOverride } from "./validateConfigOverride.js";
+export { default as validateConfigOverride } from "./validateConfigOverride.js";
+export { default as createGetPageLocation } from "./dom/createGetPageLocation.js";

package/libEs6/utils/request/createRequest.js

@@ -47,7 +47,8 @@ export default options => {
     getAction,
     getUseSendBeacon,
     datastreamIdOverride,
-    edgeSubPath
+    edgeSubPath,
+    requestParams = {}
   } = options;
   const id = uuid();
   let shouldUseThirdPartyDomain = false;
@@ -86,6 +87,9 @@ export default options => {
     },
     setIsIdentityEstablished() {
       isIdentityEstablished = true;
+    },
+    getRequestParams() {
+      return requestParams;
     }
   };
 };

package/libEs6/utils/request/types.js

@@ -1,3 +1,15 @@
+/*
+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.
+*/
+
 /**
  * Request object with methods to access and modify request properties.
  *

package/libEs6/utils/surfaceUtils.js

@@ -0,0 +1,76 @@
+/*
+Copyright 2022 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 { WEB, WEBAPP, SURFACE_TYPE_DELIMITER, FRAGMENT_DELIMITER } from "../constants/surface.js";
+import { isNil, isNonEmptyString } from "./index.js";
+const SURFACE_REGEX = /^(\w+):\/\/([^/#]+)(\/[^#]*)?(#.*)?$/;
+const AUTHORITY_REGEX = /^(?:.*@)?(?:[a-z\d\u00a1-\uffff.-]+|\[[a-f\d:]+])(?::\d+)?$/;
+const PATH_REGEX = /^\/(?:[/\w\u00a1-\uffff-.~]|%[a-fA-F\d]{2})*$/;
+const FRAGMENT_REGEX = /^#(?:[/\w\u00a1-\uffff-.~]|%[a-fA-F\d]{2})+$/;
+const normalizePath = (path = "/") => {
+  let end = path.length;
+  while (end > 0 && "/".indexOf(path.charAt(end - 1)) !== -1) {
+    end -= 1;
+  }
+  return path.substring(0, end) || "/";
+};
+const getSurfaceType = surfaceTypeMatch => isNonEmptyString(surfaceTypeMatch) ? surfaceTypeMatch.toLowerCase() : "";
+const getAuthority = authorityMatch => isNonEmptyString(authorityMatch) ? authorityMatch.toLowerCase() : "";
+const getPath = pathMatch => isNonEmptyString(pathMatch) ? normalizePath(pathMatch) : "/";
+const parseSurface = surfaceString => {
+  const matched = surfaceString.match(SURFACE_REGEX);
+  return matched ? {
+    surfaceType: getSurfaceType(matched[1]),
+    authority: getAuthority(matched[2]),
+    path: getPath(matched[3]),
+    fragment: matched[4]
+  } : null;
+};
+const stringifySurface = surface => `${surface.surfaceType}${SURFACE_TYPE_DELIMITER}${surface.authority}${surface.path || ""}${surface.fragment || ""}`;
+export const buildPageSurface = getPageLocation => {
+  const location = getPageLocation();
+  const host = location.host.toLowerCase();
+  const path = location.pathname;
+  return WEB + SURFACE_TYPE_DELIMITER + host + normalizePath(path);
+};
+const expandFragmentSurface = (surface, getPageLocation) => surface.startsWith(FRAGMENT_DELIMITER) ? buildPageSurface(getPageLocation) + surface : surface;
+const validateSurface = (surface, getPageLocation, logger) => {
+  const invalidateSurface = validationError => {
+    logger.warn(validationError);
+    return null;
+  };
+  if (!isNonEmptyString(surface)) {
+    return invalidateSurface(`Invalid surface: ${surface}`);
+  }
+  const expanded = expandFragmentSurface(surface, getPageLocation);
+  const parsed = parseSurface(expanded);
+  if (parsed === null) {
+    return invalidateSurface(`Invalid surface: ${surface}`);
+  }
+  if (![WEB, WEBAPP].includes(parsed.surfaceType)) {
+    return invalidateSurface(`Unsupported surface type ${parsed.surfaceType} in surface: ${surface}`);
+  }
+  if (!parsed.authority || !AUTHORITY_REGEX.test(parsed.authority)) {
+    return invalidateSurface(`Invalid authority ${parsed.authority} in surface: ${surface}`);
+  }
+  if (parsed.path && !PATH_REGEX.test(parsed.path)) {
+    return invalidateSurface(`Invalid path ${parsed.path} in surface: ${surface}`);
+  }
+  if (parsed.fragment && !FRAGMENT_REGEX.test(parsed.fragment)) {
+    return invalidateSurface(`Invalid fragment ${parsed.fragment} in surface: ${surface}`);
+  }
+  return parsed;
+};
+export const isPageWideSurface = scope => !!scope && scope.indexOf(WEB + SURFACE_TYPE_DELIMITER) === 0 && scope.indexOf(FRAGMENT_DELIMITER) === -1;
+
+// eslint-disable-next-line default-param-last
+export const normalizeSurfaces = (surfaces = [], getPageLocation, logger) => surfaces.map(surface => validateSurface(surface, getPageLocation, logger)).filter(surface => !isNil(surface)).map(stringifySurface);

package/libEs6/utils/types.js

@@ -1,3 +1,15 @@
+/*
+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.
+*/
+
 /**
  * @typedef {Object} Storage
  * @property {function(string): string|null} getItem

package/libEs6/utils/uuid.js

@@ -10,5 +10,6 @@ OF ANY KIND, either express or implied. See the License for the specific languag
 governing permissions and limitations under the License.
 */
 
+// eslint-disable-next-line import/no-unresolved
 import { v4 as uuidv4 } from "uuid";
 export default uuidv4;