@adobe/aio-commerce-lib-app 2.0.0-beta-20260820174436 → 2.0.0

package/dist/cjs/commands/index.cjs

@@ -15,10 +15,10 @@
 
 const require_rolldown_runtime = require('../rolldown-runtime-CDQd2xEI.cjs');
 const require_error = require('../error-D-N0PKSl.cjs');
-const require_index_node = require('../index.node-CXeIG8SS.cjs');
-const require_webhooks = require('../webhooks-E1KDx3Yu.cjs');
-const require_validate = require('../validate-Dff0nrqM.cjs');
-const require_common = require('../common-B70f39vI.cjs');
+const require_index_node = require('../index.node-vcOo1rt0.cjs');
+const require_webhooks = require('../webhooks-Bcq2Qy7q.cjs');
+const require_validate = require('../validate-CwWYtRsS.cjs');
+const require_common = require('../common-VSsQEHDv.cjs');
 const require_logging = require('../logging-Br3xfBNe.cjs');
 let _adobe_aio_commerce_lib_config = require("@adobe/aio-commerce-lib-config");
 let _adobe_aio_commerce_lib_core_error = require("@adobe/aio-commerce-lib-core/error");
@@ -371,13 +371,14 @@ const TSX_FILE_EXTENSION = ".tsx";
 const APP_TITLE_PLACEHOLDER = "APP_TITLE";
 const WEB_SOURCE_ENTRYPOINT_FILE = "index.html";
 const WEB_SOURCE_IMPORT_ALIAS = "#web/*";
+const WEB_SOURCE_REQUIRED_FILES = [".babelrc"];
 const WEB_SOURCE_TSCONFIG_FILE = "tsconfig.json";
 const LEADING_DOT_SLASH_PATTERN$1 = /^\.\//u;
 /** Runtime dependencies required by the generated web-src app. */
 const WEB_SOURCE_DEPENDENCIES = [
 	{
 		name: "@adobe/aio-commerce-lib-admin-ui",
-		version: "^1.1.0-beta-20260820174436"
+		version: "^1.1.0"
 	},
 	{
 		name: "react",
@@ -392,14 +393,26 @@ const WEB_SOURCE_DEPENDENCIES = [
 		version: "^1.5.1"
 	}
 ];
-/** Development dependencies required by the generated web-src app. */
-const WEB_SOURCE_DEV_DEPENDENCIES = [{
-	name: "@types/react",
-	version: "^19.2.17"
+const WEB_SOURCE_BABEL_DEV_DEPENDENCIES = [{
+	name: "@babel/core",
+	version: "^7.29.7"
 }, {
-	name: "@types/react-dom",
-	version: "^19.2.3"
+	name: "@babel/preset-react",
+	version: "^7.29.7"
 }];
+/** Development dependencies required by the generated web-src app. */
+const WEB_SOURCE_DEV_DEPENDENCIES = [
+	...WEB_SOURCE_BABEL_DEV_DEPENDENCIES,
+	{
+		name: "@types/react",
+		version: "^19.2.17"
+	},
+	{
+		name: "@types/react-dom",
+		version: "^19.2.3"
+	}
+];
+const WEB_SOURCE_REQUIRED_DEV_DEPENDENCIES = WEB_SOURCE_BABEL_DEV_DEPENDENCIES;
 const WEB_SOURCE_SHARED_BUNDLES = [{
 	assets: ["**/@react-spectrum/s2/**", "src/commerce-backend-ui-2/web-src/*.{js,jsx,ts,tsx}"],
 	name: "s2-styles",
@@ -444,34 +457,37 @@ function getWebSourceEntrypoint(extConfig) {
 * @param projectRoot - Resolved project root containing package.json.
 * @param extension - Web source extension whose tooling is configured.
 */
-async function prepareWebSourcePackage(projectRoot, extension) {
+async function prepareWebSourcePackage(projectRoot, extension, scaffoldRequired) {
 	const pkg = await require_index_node.loadPackageJson(projectRoot);
 	if (pkg === null) throw new Error("Could not find package.json.");
-	const requiredDevDependencies = [...WEB_SOURCE_DEV_DEPENDENCIES, ...extension === "tsx" ? SHARED_TYPESCRIPT_DEV_DEPENDENCIES : []];
-	const installPlan = await require_index_node.getPackageDependencyInstallPlan([...WEB_SOURCE_DEPENDENCIES, ...requiredDevDependencies], projectRoot);
+	const dependencies = scaffoldRequired ? WEB_SOURCE_DEPENDENCIES : [];
+	const requiredDevDependencies = scaffoldRequired ? [...WEB_SOURCE_DEV_DEPENDENCIES, ...extension === "tsx" ? SHARED_TYPESCRIPT_DEV_DEPENDENCIES : []] : WEB_SOURCE_REQUIRED_DEV_DEPENDENCIES;
+	const installPlan = await require_index_node.getPackageDependencyInstallPlan([...dependencies, ...requiredDevDependencies], projectRoot);
 	if (installPlan.incompatible.length > 0) {
 		const incompatibleDependencies = installPlan.incompatible.map(({ name, version, installedVersion }) => `${name}@${installedVersion} does not satisfy ${version}`).join("\n");
 		throw new Error(`Cannot scaffold web-src because installed dependencies are incompatible:\n${incompatibleDependencies}`);
 	}
-	const dependencies = pkg.content.dependencies ?? {};
+	const existingDependencies = pkg.content.dependencies ?? {};
 	const devDependencies = pkg.content.devDependencies ?? {};
-	const dependencyMaps = [dependencies, devDependencies];
+	const dependencyMaps = [existingDependencies, devDependencies];
 	const declaredDependencyNames = new Set(dependencyMaps.flatMap((depMap) => Object.keys(depMap)));
-	const dependenciesToDeclare = [...WEB_SOURCE_DEPENDENCIES, ...requiredDevDependencies].filter(({ name }) => !declaredDependencyNames.has(name));
+	const dependenciesToDeclare = [...dependencies, ...requiredDevDependencies].filter(({ name }) => !declaredDependencyNames.has(name));
 	if (dependenciesToDeclare.length > 0) {
 		consola.consola.info("Adding web-src dependencies in package.json:");
 		consola.consola.log.raw((0, consola_utils.formatTree)(dependenciesToDeclare.map(({ name, version }) => ` ${name}@${version}`)));
 	} else consola.consola.info("web-src dependencies are already declared in package.json.");
 	pkg.update({
-		"@parcel/bundler-default": {
-			...pkg.content["@parcel/bundler-default"],
-			manualSharedBundles: WEB_SOURCE_SHARED_BUNDLES
-		},
-		"@parcel/resolver-default": {
-			...pkg.content["@parcel/resolver-default"],
-			packageExports: true
+		...scaffoldRequired && {
+			"@parcel/bundler-default": {
+				...pkg.content["@parcel/bundler-default"],
+				manualSharedBundles: WEB_SOURCE_SHARED_BUNDLES
+			},
+			"@parcel/resolver-default": {
+				...pkg.content["@parcel/resolver-default"],
+				packageExports: true
+			},
+			dependencies: require_index_node.mergePackageJsonDependencies(existingDependencies, WEB_SOURCE_DEPENDENCIES, dependencyMaps)
 		},
-		dependencies: require_index_node.mergePackageJsonDependencies(dependencies, WEB_SOURCE_DEPENDENCIES, dependencyMaps),
 		devDependencies: require_index_node.mergePackageJsonDependencies(devDependencies, requiredDevDependencies, dependencyMaps)
 	});
 	await pkg.save();
@@ -485,6 +501,20 @@ async function prepareWebSourcePackage(projectRoot, extension) {
 	runProjectInstall(packageManager, projectRoot);
 }
 /**
+* Copies required web-src support files that are not already present.
+* @param sourceDir - Directory containing required web source files.
+* @param targetDir - Generated or existing web source directory.
+* @param projectRoot - Resolved project root used to format output paths.
+*/
+async function copyMissingWebSourceFiles(sourceDir, targetDir, projectRoot) {
+	return (await Promise.all(WEB_SOURCE_REQUIRED_FILES.map(async (file) => {
+		const targetPath = (0, path.join)(targetDir, file);
+		if ((0, fs.existsSync)(targetPath)) return null;
+		await (0, fs_promises.copyFile)((0, path.join)(sourceDir, file), targetPath, fs.constants.COPYFILE_EXCL);
+		return ` ${(0, path.relative)(projectRoot, targetPath)}`;
+	}))).filter((path$10) => path$10 !== null);
+}
+/**
 * Add the package import alias for an existing or generated web-src.
 * @param extConfig - Extension config containing the view operation.
 * @param projectRoot - Resolved project root containing package.json.
@@ -557,23 +587,29 @@ async function generateWebSrc(extConfig, appName, projectRoot, templatesDir = TE
 	const entrypoint = getWebSourceEntrypoint(extConfig);
 	if (entrypoint === null) return;
 	const entrypointPath = (0, path.join)(projectRoot, entrypoint);
-	if ((0, fs.existsSync)(entrypointPath)) {
-		consola.consola.info(`web-src entrypoint already exists, skipping scaffold: ${(0, path.relative)(projectRoot, entrypointPath)}`);
-		return;
-	}
-	consola.consola.start(`Scaffolding web-src for ${BACKEND_UI_V2_EXTENSION_POINT_ID}...`);
-	const sourceDir = (0, path.join)(templatesDir, "admin-ui", "web-src");
+	const scaffoldRequired = !(0, fs.existsSync)(entrypointPath);
 	const targetDir = (0, path.dirname)(entrypointPath);
 	const extension = await resolveWebSourceExtension(projectRoot);
-	const outputFiles = await copyWebSourceTemplates(sourceDir, targetDir, extension, appName, projectRoot);
-	if (extension === "tsx") {
-		const tsconfigPath = await writeWebSourceTypeScriptConfig(targetDir);
-		outputFiles.push(` ${(0, path.relative)(projectRoot, tsconfigPath)}`);
-		await syncWebSourceTypecheckScript(projectRoot);
+	const sourceDir = (0, path.join)(templatesDir, "admin-ui", "web-src");
+	let outputFiles = [];
+	if (scaffoldRequired) {
+		consola.consola.start(`Scaffolding web-src for ${BACKEND_UI_V2_EXTENSION_POINT_ID}...`);
+		outputFiles = await copyWebSourceTemplates(sourceDir, targetDir, extension, appName, projectRoot);
+		if (extension === "tsx") {
+			const tsconfigPath = await writeWebSourceTypeScriptConfig(targetDir);
+			outputFiles.push(` ${(0, path.relative)(projectRoot, tsconfigPath)}`);
+			await syncWebSourceTypecheckScript(projectRoot);
+		}
+	} else consola.consola.info(`web-src entrypoint already exists, skipping scaffold: ${(0, path.relative)(projectRoot, entrypointPath)}`);
+	const requiredFiles = await copyMissingWebSourceFiles(sourceDir, targetDir, projectRoot);
+	if (scaffoldRequired || requiredFiles.length > 0) await prepareWebSourcePackage(projectRoot, extension, scaffoldRequired);
+	if (scaffoldRequired) {
+		consola.consola.success(`Scaffolded ${(0, path.relative)(projectRoot, targetDir)}`);
+		consola.consola.log.raw((0, consola_utils.formatTree)([...outputFiles, ...requiredFiles]));
+	} else if (requiredFiles.length > 0) {
+		consola.consola.success(`Added required files to ${(0, path.relative)(projectRoot, targetDir)}`);
+		consola.consola.log.raw((0, consola_utils.formatTree)(requiredFiles));
 	}
-	await prepareWebSourcePackage(projectRoot, extension);
-	consola.consola.success(`Scaffolded ${(0, path.relative)(projectRoot, targetDir)}`);
-	consola.consola.log.raw((0, consola_utils.formatTree)(outputFiles));
 }
 
 //#endregion
@@ -1021,14 +1057,16 @@ async function updateAppConfigImportAlias(projectRoot, runtimeConfigPath) {
 async function writeJavaScriptAppConfigModule(configFilePath, outputPath) {
 	const configImportPath = normalizeImportPath((0, path.relative)((0, path.dirname)(outputPath), configFilePath));
 	const isJson = (0, path.extname)(configFilePath) === ".json";
+	const importAttributes = isJson ? " with { type: \"json\" }" : "";
+	const defaultExport = isJson ? `export default /** @type {import("@adobe/aio-commerce-lib-app/config").CommerceAppConfig} */ (appConfig);` : "export default appConfig;";
 	await (0, fs_promises.writeFile)(outputPath, [
 		"// This file has been auto-generated by `@adobe/aio-commerce-lib-app`",
 		"// Do not modify this file directly",
 		"",
-		`import appConfig from "${configImportPath}"${isJson ? " with { type: \"json\" }" : ""};`,
+		`import appConfig from "${configImportPath}"${importAttributes};`,
 		"",
 		isJson ? null : `export * from "${configImportPath}";`,
-		"export default appConfig;",
+		defaultExport,
 		""
 	].filter((item) => item !== null).join("\n"), "utf-8");
 }
@@ -1212,7 +1250,7 @@ async function run$8(appManifest, projectRoot, templatesDir = TEMPLATES_DIR) {
 		const businessConfigExtConfig = await updateExtConfig(appManifest, CONFIGURATION_EXTENSION_POINT_ID, projectRoot);
 		await generateActionFiles(appManifest, getRuntimeActions(businessConfigExtConfig, "business-configuration"), CONFIGURATION_EXTENSION_POINT_ID, templatesDir, projectRoot);
 	}
-	if (require_webhooks.hasAdminUi(appManifest)) {
+	if (require_webhooks.hasBackendUiV2Components(appManifest)) {
 		const extConfig = await updateExtConfig(appManifest, BACKEND_UI_V2_EXTENSION_POINT_ID, projectRoot);
 		if (extConfig.operations?.view) {
 			await prepareWebSourceImportAlias(extConfig, projectRoot);
@@ -1621,7 +1659,7 @@ async function run$3(extension, projectRoot, templatesDir = TEMPLATES_DIR) {
 		return;
 	}
 	if (extension === "backend-ui/2") {
-		if (require_webhooks.hasAdminUi(appManifest)) {
+		if (require_webhooks.hasBackendUiV2Components(appManifest)) {
 			const extConfig = await updateExtConfig(appManifest, BACKEND_UI_V2_EXTENSION_POINT_ID, projectRoot);
 			if (extConfig.operations?.view) {
 				await prepareWebSourceImportAlias(extConfig, projectRoot);
@@ -2041,11 +2079,12 @@ async function writePostinstallHook(execCommand, projectRoot) {
 /**
 * Ensures app.config.yaml references the enabled domain extensions.
 * @param domains - Domains enabled in the app configuration.
+* @param config - The validated app configuration.
 * @param projectRoot - Resolved project root containing app.config.yaml.
 */
-async function ensureAppConfig(domains, projectRoot) {
+async function ensureAppConfig(domains, config, projectRoot) {
 	if (domains.has("businessConfig.schema")) await addExtensionPointToAppConfig(CONFIGURATION_EXTENSION_POINT_ID, projectRoot, " This extension is required for business configuration. Do not remove.");
-	if (domains.has("adminUi")) await addExtensionPointToAppConfig(BACKEND_UI_V2_EXTENSION_POINT_ID, projectRoot, " This extension is required for Admin UI. Do not remove.");
+	if (require_webhooks.hasBackendUiV2Components(config)) await addExtensionPointToAppConfig(BACKEND_UI_V2_EXTENSION_POINT_ID, projectRoot, " This extension is required for Admin UI. Do not remove.");
 	await addExtensionPointToAppConfig(EXTENSIBILITY_EXTENSION_POINT_ID, projectRoot, " This extension is required for app management. Do not remove.");
 }
 /**
@@ -2056,7 +2095,7 @@ async function ensureAppConfig(domains, projectRoot) {
 */
 function installDependencies(packageManager, domains, projectRoot) {
 	const packages = [];
-	if (domains.has("businessConfig.schema")) packages.push(`@adobe/aio-commerce-lib-config@^1.6.1`);
+	if (domains.has("businessConfig.schema")) packages.push(`@adobe/aio-commerce-lib-config@^1.8.0`);
 	if (packages.length === 0) {
 		consola.consola.info("No additional domain dependencies to install.");
 		return;
@@ -2081,17 +2120,18 @@ async function runGeneration(appConfig, execCommand, projectRoot) {
 /**
 * Ensures install.yaml references the enabled domain extensions.
 * @param domains - Domains enabled in the app configuration.
+* @param config - The validated app configuration.
 * @param projectRoot - Resolved project root containing install.yaml.
 */
-async function ensureInstallYaml(domains, projectRoot) {
+async function ensureInstallYaml(domains, config, projectRoot) {
 	if (domains.has("businessConfig.schema")) await addExtensionPointToInstallYaml(CONFIGURATION_EXTENSION_POINT_ID, projectRoot, " This extension is required for business configuration. Do not remove.");
-	if (domains.has("adminUi")) await addExtensionPointToInstallYaml(BACKEND_UI_V2_EXTENSION_POINT_ID, projectRoot, " This extension is required for Admin UI. Do not remove.");
+	if (require_webhooks.hasBackendUiV2Components(config)) await addExtensionPointToInstallYaml(BACKEND_UI_V2_EXTENSION_POINT_ID, projectRoot, " This extension is required for Admin UI. Do not remove.");
 	await addExtensionPointToInstallYaml(EXTENSIBILITY_EXTENSION_POINT_ID, projectRoot, " This extension is required for app management. Do not remove.");
 }
 
 //#endregion
 //#region source/commands/init/main.ts
-const REQUIRED_DEPENDENCIES = ["@adobe/aio-commerce-sdk", `@adobe/aio-commerce-lib-app@2.0.0-beta-20260820174436`];
+const REQUIRED_DEPENDENCIES = ["@adobe/aio-commerce-sdk", `@adobe/aio-commerce-lib-app@2.0.0`];
 /**
 * Initializes a Commerce App project.
 * @param flags - Non-interactive initialization answers.
@@ -2116,8 +2156,8 @@ async function run(flags, extraOptions) {
 	await pkg.save();
 	if (isTypeScriptProject) await syncActionsTypecheckScript(projectRoot);
 	await runGeneration(config, execCommand, projectRoot);
-	await ensureAppConfig(domains, projectRoot);
-	await ensureInstallYaml(domains, projectRoot);
+	await ensureAppConfig(domains, config, projectRoot);
+	await ensureInstallYaml(domains, config, projectRoot);
 	await writePostinstallHook(execCommand, projectRoot);
 	consola.consola.success("Initialization complete!");
 	consola.consola.box([

package/dist/cjs/commands/templates/admin-ui/web-src/.babelrc

@@ -0,0 +1,14 @@
+{
+  "env": {
+    "development": {
+      "presets": [
+        ["@babel/preset-react", { "runtime": "automatic", "development": true }]
+      ]
+    },
+    "production": {
+      "presets": [
+        ["@babel/preset-react", { "runtime": "automatic", "development": false }]
+      ]
+    }
+  }
+}

package/dist/cjs/commands/templates/business-configuration/config.js.template

@@ -5,5 +5,11 @@ import { configRuntimeAction } from "@adobe/aio-commerce-lib-app/actions/config"
 
 import config from "#app.commerce.config";
 
-const args = { configSchema: config.businessConfig.schema };
+const businessConfig = /** @type {NonNullable<typeof config.businessConfig>} */ (
+  config.businessConfig
+);
+const configSchema = /** @type {NonNullable<typeof businessConfig.schema>} */ (
+  businessConfig.schema
+);
+const args = { configSchema };
 export const main = configRuntimeAction(args);

package/dist/cjs/{common-B70f39vI.cjs → common-VSsQEHDv.cjs}

@@ -12,7 +12,7 @@
  * governing permissions and limitations under the License.
  */
 
-const require_management = require('./management-BhMdRr8i.cjs');
+const require_management = require('./management-Bki3hlxL.cjs');
 let _adobe_aio_lib_state = require("@adobe/aio-lib-state");
 let _adobe_aio_commerce_lib_core_headers = require("@adobe/aio-commerce-lib-core/headers");
 let _adobe_aio_commerce_lib_core_responses = require("@adobe/aio-commerce-lib-core/responses");
@@ -469,6 +469,13 @@ async function getInstallationSnapshot() {
 		id: installSnapshot.id
 	};
 }
+/**
+* Reads the persisted custom installation step history from a lifecycle snapshot's data. Returns
+* `[]` when there's no snapshot or none was recorded (e.g. an install from before this feature).
+*/
+function getExecutedCustomInstallationSteps(data) {
+	return (data?.installation?.customInstallationSteps?.reconciliation)?.executedSteps ?? [];
+}
 /** Creates the shared storage read/write dependencies used by lifecycle orchestration. */
 async function createLifecyclePersistence() {
 	const [stateStore, snapshotStore] = await Promise.all([createOrchestrationStateStore(), createAppStateSnapshotStore()]);
@@ -483,7 +490,7 @@ async function createLifecycleRuntime(params, appConfig, logger) {
 	return {
 		...await createLifecyclePersistence(),
 		lifecycleContext: buildLifecycleContext(params, appConfig, logger),
-		rootStep: require_management.createRootInstallationStep(appConfig)
+		rootStep: require_management.createRootInstallationStep(appConfig, { forUpgrade: true })
 	};
 }
 
@@ -566,6 +573,12 @@ Object.defineProperty(exports, 'getCurrentLifecycleBaseline', {
     return getCurrentLifecycleBaseline;
   }
 });
+Object.defineProperty(exports, 'getExecutedCustomInstallationSteps', {
+  enumerable: true,
+  get: function () {
+    return getExecutedCustomInstallationSteps;
+  }
+});
 Object.defineProperty(exports, 'getStorageKey', {
   enumerable: true,
   get: function () {

package/dist/cjs/config/index.browser.d.cts

@@ -12,5 +12,5 @@
  * governing permissions and limitations under the License.
  */
 
-import { t as defineConfig } from "../define-B-_oKmCe.cjs";
+import { t as defineConfig } from "../define-Cc3AaVmY.cjs";
 export { defineConfig };

package/dist/cjs/config/index.node.cjs

@@ -13,15 +13,16 @@
  */
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_index_node = require('../index.node-CXeIG8SS.cjs');
+const require_index_node = require('../index.node-vcOo1rt0.cjs');
 const require_define = require('../define-C-Xq1pCa.cjs');
-const require_webhooks = require('../webhooks-E1KDx3Yu.cjs');
-const require_validate = require('../validate-Dff0nrqM.cjs');
+const require_webhooks = require('../webhooks-Bcq2Qy7q.cjs');
+const require_validate = require('../validate-CwWYtRsS.cjs');
 
 exports.CommerceAppConfigSchemas = require_validate.CommerceAppConfigSchemas;
 exports.defineConfig = require_define.defineConfig;
 exports.getConfigDomains = require_validate.getConfigDomains;
 exports.hasAdminUi = require_webhooks.hasAdminUi;
+exports.hasBackendUiV2Components = require_webhooks.hasBackendUiV2Components;
 exports.hasBusinessConfig = require_validate.hasBusinessConfig;
 exports.hasBusinessConfigSchema = require_validate.hasBusinessConfigSchema;
 exports.hasCommerceEvents = require_webhooks.hasCommerceEvents;