@adobe/alloy 2.30.1-beta.9 → 2.31.0

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/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/components/StreamingMedia/createMediaEventManager.js

@@ -28,7 +28,7 @@ export default ({
       const {
         xdm
       } = options;
-      setTimestamp(xdm);
+      setTimestamp(event);
       event.setUserXdm(xdm);
       if (xdm.eventType === MediaEvents.AD_START) {
         const {

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.9";
+export default "2.31.0";

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

@@ -24,6 +24,7 @@ const getXdmPropositions = xdm => {
 };
 export default () => {
   const content = {};
+  const createdAt = Date.now();
   let userXdm;
   let userData;
   let documentMayUnload = false;
@@ -138,6 +139,9 @@ export default () => {
     getDocumentMayUnload() {
       return documentMayUnload;
     },
+    getCreatedAt() {
+      return createdAt;
+    },
     isEmpty() {
       return isEmptyObject(content) && (!userXdm || isEmptyObject(userXdm)) && (!userData || isEmptyObject(userData));
     },
@@ -150,6 +154,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/injectSendEdgeNetworkRequest.js

@@ -17,8 +17,25 @@ import { ID_THIRD_PARTY as ID_THIRD_PARTY_DOMAIN } from "../../constants/domain.
 import apiVersion from "../../constants/apiVersion.js";
 import { createCallbackAggregator, noop } from "../../utils/index.js";
 import { isNetworkError } from "../../utils/networkErrors.js";
+import clamp from "../../utils/clamp.js";
 import mergeLifecycleResponses from "./mergeLifecycleResponses.js";
 import handleRequestFailure from "./handleRequestFailure.js";
+const MAX_QUEUE_TIME_MILLIS = 300000; // 5 minutes
+
+const calculateQueueTimeMillis = payload => {
+  if (typeof payload.getEvents !== "function") {
+    return undefined;
+  }
+  const events = payload.getEvents();
+  if (events.length === 0) {
+    return undefined;
+  }
+
+  // In practice, there should only be one event in the payload, in the future if this changes we'll need to
+  // evaluate what timestamp to use (earliest, average, latest), or move the queueTime to the event meta
+  const earliestCreatedAt = Math.min(...events.map(event => event.getCreatedAt()));
+  return clamp(Date.now() - earliestCreatedAt, 0, MAX_QUEUE_TIME_MILLIS);
+};
 const isDemdexBlockedError = (error, request) => {
   return request.getUseIdThirdPartyDomain() && isNetworkError(error);
 };
@@ -94,6 +111,12 @@ export default ({
       const endpointDomain = hasDemdexFailed || !request.getUseIdThirdPartyDomain() ? edgeDomain : ID_THIRD_PARTY_DOMAIN;
       const url = buildEndpointUrl(endpointDomain, request);
       const payload = request.getPayload();
+      const queueTimeMillis = calculateQueueTimeMillis(payload);
+      if (queueTimeMillis !== undefined) {
+        payload.mergeMeta({
+          queueTimeMillis
+        });
+      }
       cookieTransfer.cookiesToPayload(payload, endpointDomain);
       return sendNetworkRequest({
         requestId: request.getId(),

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

@@ -0,0 +1,22 @@
+/*
+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.
+*/
+
+/**
+ * Clamps a value between a minimum and maximum value.
+ * @param {number} value - The value to clamp.
+ * @param {number} min - The minimum value.
+ * @param {number} max - The maximum value.
+ * @returns {number} The clamped value.
+ */
+export default (value, min, max) => {
+  return Math.max(min, Math.min(value, max));
+};

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

@@ -43,7 +43,7 @@ const filterObject = (obj, predicate) => {
       };
     }
     // value is not an object, test predicate
-    if (predicate(value)) {
+    if (predicate(value, key)) {
       return {
         ...result,
         [key]: value

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

@@ -25,11 +25,13 @@ export default configuration => {
     return null;
   }
   // remove entries that are empty strings or arrays
-  const configOverrides = filterObject(configuration, value => {
+  const configOverrides = filterObject(configuration, (value, key) => {
     if (isNil(value)) {
       return false;
     }
-    if (isBoolean(value)) {
+    // We want to remove all the { enabled: true } values, but leave any other boolean values.
+    // Experience Edge will not accept { enabled: true } values as true is the default for "enabled".
+    if (isBoolean(value) && (key !== "enabled" || value === false)) {
       return true;
     }
     if (isNumber(value)) {

package/libEs6/utils/request/createDataCollectionRequestPayload.js

@@ -34,6 +34,9 @@ export default () => {
       content.events = content.events || [];
       content.events.push(event);
     },
+    getEvents: () => {
+      return content.events || [];
+    },
     getDocumentMayUnload: () => {
       return (content.events || []).some(event => event.getDocumentMayUnload());
     }

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

@@ -42,5 +42,6 @@ export default ({
   if (localConfigOverridesWithoutDatastreamId && !isEmptyObject(localConfigOverridesWithoutDatastreamId)) {
     payload.mergeConfigOverride(localConfigOverridesWithoutDatastreamId);
   }
+  payload.finalizeConfigOverrides();
   return requestParams;
 };

package/libEs6/utils/request/createRequestPayload.js

@@ -88,7 +88,17 @@ export default options => {
     mergeMeta: createMerger(content, "meta"),
     mergeState: createMerger(content, "meta.state"),
     mergeQuery: createMerger(content, "query"),
-    mergeConfigOverride: updates => mergeConfigOverrides(prepareConfigOverridesForEdge(updates)),
+    mergeConfigOverride: updates => mergeConfigOverrides(updates),
+    finalizeConfigOverrides: () => {
+      if (content.meta?.configOverrides) {
+        const prepared = prepareConfigOverridesForEdge(content.meta.configOverrides);
+        if (prepared === null) {
+          delete content.meta.configOverrides;
+        } else {
+          content.meta.configOverrides = prepared;
+        }
+      }
+    },
     addIdentity,
     hasIdentity,
     toJSON() {

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.
  *
@@ -37,6 +49,7 @@
  * @property {function(string, Identity): void} options.addIdentity
  * @property {function(string): boolean} options.hasIdentity
  * @property {function(object): void} addEvent
+ * @property {function(): Array} getEvents
  * @property {function(): boolean} getDocumentMayUnload
  * @property {function(): object} toJSON
  */

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