@adobe/alloy 2.32.1-beta.0 → 2.33.0-beta.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/alloy",
-  "version": "2.32.1-beta.0",
+  "version": "2.33.0-beta.2",
   "description": "Adobe Experience Platform Web SDK",
   "type": "module",
   "repository": {
@@ -16,12 +16,12 @@
   "files": [
     "src",
     "dist",
+    "components.json",
     "scripts/alloyBuilder.js",
-    "scripts/helpers/entryPointGeneratorBabelPlugin.js",
+    "scripts/helpers/componentMetadata.js",
+    "scripts/helpers/generateEntryPoint.js",
     "scripts/helpers/path.js",
     "rollup.config.js",
-    "babel.config.js",
-    ".browserslistrc",
     "LICENSE_BANNER"
   ],
   "exports": {
@@ -56,32 +56,28 @@
     "./libEs6/components/EventMerge/createEventMergeId": {
       "types": "./dist/types/browser/src/utils/createEventMergeId.d.ts",
       "default": "./dist/utils/createEventMergeId.js"
-    }
+    },
+    "./components.json": "./components.json"
   },
   "dependencies": {
-    "@babel/core": "^7.28.5",
-    "@babel/plugin-transform-modules-commonjs": "^7.27.1",
-    "@babel/plugin-transform-template-literals": "^7.27.1",
-    "@babel/preset-env": "^7.28.5",
     "@inquirer/prompts": "^7.9.0",
-    "@rollup/plugin-babel": "^6.1.0",
     "@rollup/plugin-commonjs": "^29.0.0",
     "@rollup/plugin-node-resolve": "^16.0.3",
+    "@rollup/plugin-replace": "^6.0.0",
     "@rollup/plugin-terser": "^0.4.4",
     "commander": "^14.0.2",
     "rollup": "^4.52.5",
     "rollup-plugin-license": "^3.6.0",
-    "@adobe/alloy-core": "^1.1.2-beta.0"
+    "@adobe/alloy-core": "^1.1.2-beta.3"
   },
   "devDependencies": {
-    "@babel/cli": "^7.28.3",
     "glob": "^11.0.3",
     "msw": "^2.11.6",
     "read-cache": "^1.0.0",
     "rimraf": "^6.1.0",
     "testcafe": "^3.7.2",
     "testcafe-browser-provider-playwright": "^1.1.0",
-    "uuid": "^13.0.0",
+    "uuid": "^14.0.0",
     "vitest": "^4.0.6"
   },
   "scripts": {

package/rollup.config.js

@@ -13,13 +13,15 @@ governing permissions and limitations under the License.
 import path from "path";
 import resolve from "@rollup/plugin-node-resolve";
 import commonjs from "@rollup/plugin-commonjs";
-import babel from "@rollup/plugin-babel";
+import replace from "@rollup/plugin-replace";
 import terser from "@rollup/plugin-terser";
 import license from "rollup-plugin-license";
 import { fileURLToPath } from "url";
 import { gzip, brotliCompress as br, constants as zlibConstants } from "zlib";
 import { promisify } from "util";
 import { readFile, writeFile } from "fs/promises";
+import packageJson from "./package.json" with { type: "json" };
+const { version } = packageJson;
 
 const INCLUDE_BUNDLESIZE = process.env.BUNDLESIZE === "true";
 /**
@@ -148,8 +150,12 @@ export const utilityExportBuilds = [
   },
 ];
 
-const buildPlugins = ({ variant, minify, babelPlugins }) => {
+const buildPlugins = ({ variant, minify }) => {
   const plugins = [
+    replace({
+      __VERSION__: version,
+      preventAssignment: true,
+    }),
     resolve({
       preferBuiltins: false,
       // Support the browser field in dependencies' package.json.
@@ -159,17 +165,6 @@ const buildPlugins = ({ variant, minify, babelPlugins }) => {
     commonjs(),
   ];
 
-  if (variant !== SERVICE_WORKER) {
-    plugins.push(
-      babel({
-        envName: "rollup",
-        babelHelpers: "bundled",
-        configFile: path.resolve(dirname, "babel.config.js"),
-        plugins: babelPlugins,
-      }),
-    );
-  }
-
   if (INCLUDE_BUNDLESIZE) {
     plugins.push(
       bundleSizePlugin({
@@ -220,11 +215,10 @@ const buildPlugins = ({ variant, minify, babelPlugins }) => {
 export const buildConfig = ({
   variant = STANDALONE,
   minify = false,
-  babelPlugins = [],
   input = `${dirname}/src/standalone.js`,
   file,
 }) => {
-  const plugins = buildPlugins({ variant, minify, babelPlugins });
+  const plugins = buildPlugins({ variant, minify });
   const minifiedExtension = minify ? ".min" : "";
 
   if (variant === SERVICE_WORKER) {

package/scripts/alloyBuilder.js

@@ -11,7 +11,6 @@ OF ANY KIND, either express or implied. See the License for the specific languag
 governing permissions and limitations under the License.
 */
 
-import babel from "@babel/core";
 import terser from "@rollup/plugin-terser";
 import resolve from "@rollup/plugin-node-resolve";
 import commonjs from "@rollup/plugin-commonjs";
@@ -23,11 +22,11 @@ import fs from "fs";
 import path from "path";
 import { rollup } from "rollup";
 import { buildConfig } from "../rollup.config.js";
-import entryPointGeneratorBabelPlugin from "./helpers/entryPointGeneratorBabelPlugin.js";
+import { generateEntryPointSource } from "./helpers/generateEntryPoint.js";
 import {
   optionalComponentNames,
   requiredComponentNames,
-} from "@adobe/alloy-core/componentMetadata.js";
+} from "./helpers/componentMetadata.js";
 import { getBrowserPackageRoot, safePathJoin } from "./helpers/path.js";
 
 const dirname = path.dirname(fileURLToPath(import.meta.url));
@@ -40,22 +39,7 @@ const packageJsonContent = fs.readFileSync(
 );
 const { version } = JSON.parse(packageJsonContent);
 
-const resolveSourceRootPath = () => {
-  const candidates = ["src", "libEs6"];
-
-  for (const candidate of candidates) {
-    const candidatePath = safePathJoin(browserPackageRoot, candidate);
-    if (fs.existsSync(candidatePath)) {
-      return candidatePath;
-    }
-  }
-
-  throw new Error(
-    "Unable to locate source directory. Expected to find 'src' or 'libEs6' within the browser package.",
-  );
-};
-
-const sourceRootPath = resolveSourceRootPath();
+const sourceRootPath = safePathJoin(browserPackageRoot, "src");
 
 const arrayDifference = (arr1, arr2) => arr1.filter((x) => !arr2.includes(x));
 
@@ -91,14 +75,12 @@ const generateInputEntryFile = ({
   outputFile = "input.js",
   includedModules,
 }) => {
-  const output = babel.transformFileSync(inputPath, {
-    plugins: [entryPointGeneratorBabelPlugin(babel.types, includedModules)],
-  }).code;
+  const source = generateEntryPointSource(includedModules);
 
   const destinationDirectory = path.dirname(inputPath);
   const outputPath = safePathJoin(destinationDirectory, outputFile);
 
-  fs.writeFileSync(outputPath, output);
+  fs.writeFileSync(outputPath, source);
 
   return outputPath;
 };
@@ -116,16 +98,22 @@ const build = async (argv) => {
     minify: argv.minify,
   });
 
-  const bundle = await rollup(rollupConfig);
-  await bundle.write(rollupConfig.output[0]);
-
-  console.log(
-    `🎉 Wrote ${
-      path.isAbsolute(argv.outputDir)
-        ? rollupConfig.output[0].file
-        : path.relative(process.cwd(), rollupConfig.output[0].file)
-    } (${getFileSizeInKB(rollupConfig.output[0].file)}).`,
-  );
+  let bundle;
+  try {
+    bundle = await rollup(rollupConfig);
+    await bundle.write(rollupConfig.output[0]);
+
+    console.log(
+      `🎉 Wrote ${
+        path.isAbsolute(argv.outputDir)
+          ? rollupConfig.output[0].file
+          : path.relative(process.cwd(), rollupConfig.output[0].file)
+      } (${getFileSizeInKB(rollupConfig.output[0].file)}).`,
+    );
+  } finally {
+    await bundle?.close();
+    fs.rmSync(inputFile, { force: true });
+  }
 };
 
 const buildPushNotificationsServiceWorker = async (argv) => {
@@ -168,15 +156,19 @@ const buildPushNotificationsServiceWorker = async (argv) => {
   };
 
   const bundle = await rollup(rollupConfig);
-  await bundle.write(rollupConfig.output[0]);
-
-  console.log(
-    `🎉 Wrote ${
-      path.isAbsolute(argv.outputDir)
-        ? rollupConfig.output[0].file
-        : path.relative(process.cwd(), rollupConfig.output[0].file)
-    } (${getFileSizeInKB(rollupConfig.output[0].file)}).`,
-  );
+  try {
+    await bundle.write(rollupConfig.output[0]);
+
+    console.log(
+      `🎉 Wrote ${
+        path.isAbsolute(argv.outputDir)
+          ? rollupConfig.output[0].file
+          : path.relative(process.cwd(), rollupConfig.output[0].file)
+      } (${getFileSizeInKB(rollupConfig.output[0].file)}).`,
+    );
+  } finally {
+    await bundle.close();
+  }
 };
 
 const getMakeBuildCommand = () => {

package/scripts/helpers/componentMetadata.js

@@ -0,0 +1,25 @@
+/*
+Copyright 2026 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 {
+  optionalComponentNames as coreOptional,
+  requiredComponentNames,
+} from "@adobe/alloy-core/componentMetadata.js";
+import browserManifest from "../../components.json" with { type: "json" };
+
+const browserOptional = browserManifest.optional.map((c) => c.name);
+
+export const optionalComponentNames = Object.freeze([
+  ...new Set([...coreOptional, ...browserOptional]),
+]);
+
+export { requiredComponentNames };

package/scripts/helpers/generateEntryPoint.js

@@ -0,0 +1,29 @@
+/*
+Copyright 2026 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 generateEntryPointSource = (includedModules) => {
+  const hasComponents = includedModules.length > 0;
+  const componentList = includedModules.join(", ");
+
+  const importLine = hasComponents
+    ? `import { ${componentList} } from "./allOptionalComponents.js";`
+    : "";
+
+  const componentsArray = hasComponents ? `[${componentList}]` : "[]";
+
+  return `\
+import initializeStandalone from "./initializeStandalone.js";
+${importLine}
+
+initializeStandalone({ components: ${componentsArray} });
+`;
+};

package/src/allOptionalComponents.js

@@ -0,0 +1,14 @@
+/*
+Copyright 2026 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 * from "@adobe/alloy-core/core/componentCreators.js";
+export * from "./components/componentCreators.js";

package/src/components/ActivityCollector/attachClickActivityCollector.js

@@ -0,0 +1,55 @@
+/*
+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 { noop } from "@adobe/alloy-core/utils";
+
+const createClickHandler = ({ eventManager, lifecycle, handleError }) => {
+  return (clickEvent) => {
+    // Ignore repropagated clicks from AppMeasurement
+    if (clickEvent.s_fe) {
+      return Promise.resolve();
+    }
+    // TODO: Consider safeguarding from the same object being clicked multiple times in rapid succession?
+    const clickedElement =
+      "composedPath" in clickEvent && clickEvent.composedPath().length > 0
+        ? clickEvent.composedPath()[0]
+        : clickEvent.target;
+    const event = eventManager.createEvent();
+    // this is to make sure a exit link personalization metric use send beacon
+    event.documentMayUnload();
+    return (
+      lifecycle
+        .onClick({ event, clickedElement })
+        .then(() => {
+          if (event.isEmpty()) {
+            return Promise.resolve();
+          }
+          return eventManager.sendEvent(event);
+        })
+        // eventManager.sendEvent() will return a promise resolved to an
+        // object and we want to avoid returning any value to the customer
+        .then(noop)
+        .catch((error) => {
+          handleError(error, "click collection");
+        })
+    );
+  };
+};
+
+export default ({ eventManager, lifecycle, handleError }) => {
+  const clickHandler = createClickHandler({
+    eventManager,
+    lifecycle,
+    handleError,
+  });
+  document.addEventListener("click", clickHandler, true);
+};

package/src/components/ActivityCollector/configValidators.js

@@ -0,0 +1,52 @@
+/*
+Copyright 2019 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 {
+  boolean,
+  callback,
+  objectOf,
+  string,
+} from "@adobe/alloy-core/utils/validation";
+
+const DEFAULT_DOWNLOAD_QUALIFIER =
+  "\\.(exe|zip|wav|mp3|mov|mpg|avi|wmv|pdf|doc|docx|xls|xlsx|ppt|pptx)$";
+
+export const downloadLinkQualifier = string()
+  .regexp()
+  .default(DEFAULT_DOWNLOAD_QUALIFIER);
+
+const validators = objectOf({
+  clickCollectionEnabled: boolean().default(true),
+  clickCollection: objectOf({
+    internalLinkEnabled: boolean().default(true),
+    externalLinkEnabled: boolean().default(true),
+    downloadLinkEnabled: boolean().default(true),
+    // TODO: Consider moving downloadLinkQualifier here.
+    sessionStorageEnabled: boolean().default(false),
+    eventGroupingEnabled: boolean().default(false),
+    filterClickProperties: callback(),
+  }).default({
+    internalLinkEnabled: true,
+    externalLinkEnabled: true,
+    downloadLinkEnabled: true,
+    sessionStorageEnabled: false,
+    eventGroupingEnabled: false,
+  }),
+  downloadLinkQualifier,
+  onBeforeLinkClickSend: callback().deprecated(
+    'The field "onBeforeLinkClickSend" has been deprecated. Use "clickCollection.filterClickDetails" instead.',
+  ),
+});
+
+// Export both the validators and the default qualifier
+export { DEFAULT_DOWNLOAD_QUALIFIER };
+export default validators;

package/src/components/ActivityCollector/createClickActivityStorage.js

@@ -0,0 +1,33 @@
+/*
+Copyright 2024 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.
+*/
+
+const CLICK_ACTIVITY_DATA = "clickData";
+
+export default ({ storage }) => {
+  return {
+    save: (data) => {
+      const jsonData = JSON.stringify(data);
+      storage.setItem(CLICK_ACTIVITY_DATA, jsonData);
+    },
+    load: () => {
+      let jsonData = null;
+      const data = storage.getItem(CLICK_ACTIVITY_DATA);
+      if (data) {
+        jsonData = JSON.parse(data);
+      }
+      return jsonData;
+    },
+    remove: () => {
+      storage.removeItem(CLICK_ACTIVITY_DATA);
+    },
+  };
+};

package/src/components/ActivityCollector/createClickedElementProperties.js

@@ -0,0 +1,224 @@
+/*
+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.
+*/
+
+const buildXdmFromClickedElementProperties = (props) => {
+  return {
+    eventType: "web.webinteraction.linkClicks",
+    web: {
+      webInteraction: {
+        name: props.linkName,
+        region: props.linkRegion,
+        type: props.linkType,
+        URL: props.linkUrl,
+        linkClicks: {
+          value: 1,
+        },
+      },
+    },
+  };
+};
+
+const buildDataFromClickedElementProperties = (props) => {
+  return {
+    __adobe: {
+      analytics: {
+        contextData: {
+          a: {
+            activitymap: {
+              page: props.pageName,
+              link: props.linkName,
+              region: props.linkRegion,
+              pageIDType: props.pageIDType,
+            },
+          },
+        },
+      },
+    },
+  };
+};
+
+const populateClickedElementPropertiesFromOptions = (options, props) => {
+  const { xdm, data, clickedElement } = options;
+  props.clickedElement = clickedElement;
+  if (xdm && xdm.web && xdm.web.webInteraction) {
+    const { name, region, type, URL } = xdm.web.webInteraction;
+    props.linkName = name;
+    props.linkRegion = region;
+    props.linkType = type;
+    props.linkUrl = URL;
+  }
+  // DATA has priority over XDM
+  /* eslint no-underscore-dangle: 0 */
+  if (data && data.__adobe && data.__adobe.analytics) {
+    const { contextData } = data.__adobe.analytics;
+    if (contextData && contextData.a && contextData.a.activitymap) {
+      // Set the properties if they exists
+      const { page, link, region, pageIDType } = contextData.a.activitymap;
+      props.pageName = page || props.pageName;
+      props.linkName = link || props.linkName;
+      props.linkRegion = region || props.linkRegion;
+      if (pageIDType !== undefined) {
+        props.pageIDType = pageIDType;
+      }
+    }
+  }
+};
+
+export default ({ properties, logger } = {}) => {
+  let props = properties || {};
+  const clickedElementProperties = {
+    get pageName() {
+      return props.pageName;
+    },
+    set pageName(value) {
+      props.pageName = value;
+    },
+    get linkName() {
+      return props.linkName;
+    },
+    set linkName(value) {
+      props.linkName = value;
+    },
+    get linkRegion() {
+      return props.linkRegion;
+    },
+    set linkRegion(value) {
+      props.linkRegion = value;
+    },
+    get linkType() {
+      return props.linkType;
+    },
+    set linkType(value) {
+      props.linkType = value;
+    },
+    get linkUrl() {
+      return props.linkUrl;
+    },
+    set linkUrl(value) {
+      props.linkUrl = value;
+    },
+    get pageIDType() {
+      return props.pageIDType;
+    },
+    set pageIDType(value) {
+      props.pageIDType = value;
+    },
+    get clickedElement() {
+      return props.clickedElement;
+    },
+    set clickedElement(value) {
+      props.clickedElement = value;
+    },
+    get properties() {
+      return {
+        pageName: props.pageName,
+        linkName: props.linkName,
+        linkRegion: props.linkRegion,
+        linkType: props.linkType,
+        linkUrl: props.linkUrl,
+        pageIDType: props.pageIDType,
+      };
+    },
+    isValidLink() {
+      return (
+        !!props.linkUrl &&
+        !!props.linkType &&
+        !!props.linkName &&
+        !!props.linkRegion
+      );
+    },
+    isInternalLink() {
+      return this.isValidLink() && props.linkType === "other";
+    },
+    isValidActivityMapData() {
+      return (
+        !!props.pageName &&
+        !!props.linkName &&
+        !!props.linkRegion &&
+        props.pageIDType !== undefined
+      );
+    },
+    get xdm() {
+      if (props.filteredXdm) {
+        return props.filteredXdm;
+      }
+      return buildXdmFromClickedElementProperties(this);
+    },
+    get data() {
+      if (props.filteredData) {
+        return props.filteredData;
+      }
+      return buildDataFromClickedElementProperties(this);
+    },
+    applyPropertyFilter(filter) {
+      if (filter && filter(props) === false) {
+        if (logger) {
+          logger.info(
+            `Clicked element properties were rejected by filter function: ${JSON.stringify(
+              this.properties,
+              null,
+              2,
+            )}`,
+          );
+        }
+        props = {};
+      }
+    },
+    applyOptionsFilter(filter) {
+      const opts = this.options;
+      if (opts && opts.clickedElement && (opts.xdm || opts.data)) {
+        // Properties are rejected if filter is explicitly false.
+        if (filter && filter(opts) === false) {
+          if (logger) {
+            logger.info(
+              `Clicked element properties were rejected by filter function: ${JSON.stringify(
+                this.properties,
+                null,
+                2,
+              )}`,
+            );
+          }
+          this.options = undefined;
+          return;
+        }
+        this.options = opts;
+        // This is just to ensure that any fields outside clicked element properties
+        // set by the user filter persists.
+        props.filteredXdm = opts.xdm;
+        props.filteredData = opts.data;
+      }
+    },
+    get options() {
+      const opts = {};
+      if (this.isValidLink()) {
+        opts.xdm = this.xdm;
+      }
+      if (this.isValidActivityMapData()) {
+        opts.data = this.data;
+      }
+      if (this.clickedElement) {
+        opts.clickedElement = this.clickedElement;
+      }
+      if (!opts.xdm && !opts.data) {
+        return undefined;
+      }
+      return opts;
+    },
+    set options(value) {
+      props = {};
+      if (value) {
+        populateClickedElementPropertiesFromOptions(value, props);
+      }
+    },
+  };
+  return clickedElementProperties;
+};