@adobe/aio-commerce-lib-app 2.0.0 → 2.0.1-alpha-20260923160203

package/dist/cjs/commands/index.cjs

@@ -14,1227 +14,20 @@
  */
 
 const require_rolldown_runtime = require('../rolldown-runtime-CDQd2xEI.cjs');
+const require_index_node = require('../index.node-DwuJfAiP.cjs');
+const require_web_src = require('../web-src-CCzvhSf0.cjs');
+const require_webhooks = require('../webhooks-zXjrg32x.cjs');
+const require_logging = require('../logging-QTsrSwPc.cjs');
 const require_error = require('../error-D-N0PKSl.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");
+const require_validate = require('../validate-DkmBVWFX.cjs');
 let _adobe_aio_commerce_lib_core_error = require("@adobe/aio-commerce-lib-core/error");
-let safe_stable_stringify = require("safe-stable-stringify");
-let consola = require("consola");
-consola = require_rolldown_runtime.__toESM(consola, 1);
-let fs = require("fs");
 let fs_promises = require("fs/promises");
 let path = require("path");
-path = require_rolldown_runtime.__toESM(path, 1);
+let consola = require("consola");
+consola = require_rolldown_runtime.__toESM(consola, 1);
 let consola_utils = require("consola/utils");
-let url = require("url");
-let child_process = require("child_process");
-let prettier = require("prettier");
-prettier = require_rolldown_runtime.__toESM(prettier, 1);
-let valibot = require("valibot");
-valibot = require_rolldown_runtime.__toESM(valibot, 1);
 let yaml = require("yaml");
-let _adobe_aio_lib_ims = require("@adobe/aio-lib-ims");
-_adobe_aio_lib_ims = require_rolldown_runtime.__toESM(_adobe_aio_lib_ims, 1);
-let _adobe_aio_lib_core_config = require("@adobe/aio-lib-core-config");
-_adobe_aio_lib_core_config = require_rolldown_runtime.__toESM(_adobe_aio_lib_core_config, 1);
-let ky = require("ky");
-ky = require_rolldown_runtime.__toESM(ky, 1);
-let timers_promises = require("timers/promises");
-let dotenv = require("dotenv");
-dotenv = require_rolldown_runtime.__toESM(dotenv, 1);
-
-//#region source/commands/constants.ts
-/** The name of the package containing all the generated runtime actions */
-const PACKAGE_NAME = "app-management";
-/** The path to the directory containing the generated files */
-const GENERATED_PATH = ".generated";
-/** The folder name containing the runtime actions */
-const ACTIONS_FOLDER = `actions/${PACKAGE_NAME}`;
-/** The path to the directory containing the generated actions */
-const GENERATED_ACTIONS_PATH = `${GENERATED_PATH}/${ACTIONS_FOLDER}`;
-/** The name of the extension point for extensibility. */
-const EXTENSIBILITY_EXTENSION_POINT_ID = "commerce/extensibility/1";
-/** The name of the extension point for configuration. */
-const CONFIGURATION_EXTENSION_POINT_ID = "commerce/configuration/1";
-/** The name of the extension point for Admin UI. */
-const BACKEND_UI_V2_EXTENSION_POINT_ID = "commerce/backend-ui/2";
-/** The name of the configuration schema file */
-const APP_MANIFEST_FILE = "app.commerce.manifest.json";
-/** The name of the generated runtime-safe app config module (dynamic schemas only). */
-const RUNTIME_APP_CONFIG_FILE = "app.commerce.config.js";
-/** Package import alias for the generated runtime-safe app config module. */
-const APP_CONFIG_IMPORT_ALIAS = "#app.commerce.config";
-/** The name of the commerce app configuration file */
-const COMMERCE_APP_CONFIG_FILE = "app.commerce.config";
-/** TypeScript development dependencies shared by root and web-src scaffolding. */
-const SHARED_TYPESCRIPT_DEV_DEPENDENCIES = [{
-	name: "@tsconfig/bases",
-	version: "^1.0.26"
-}, {
-	name: "typescript",
-	version: "^6.0.3"
-}];
-/** Node.js type definitions required only by root Runtime action scaffolding. */
-const TYPESCRIPT_NODE_DEV_DEPENDENCY = {
-	name: "@types/node",
-	version: "^24.12.0"
-};
-/** TypeScript loader required only by root Runtime action scaffolding. */
-const TYPESCRIPT_WEBPACK_DEV_DEPENDENCY = {
-	name: "ts-loader",
-	version: "^9.6.2"
-};
-/** The name of the configuration schema file */
-const CONFIG_SCHEMA_FILE_NAME = "configuration-schema.json";
-/** The name of the project package file */
-const PACKAGE_JSON_FILE = "package.json";
-/** The name of the app configuration file */
-const APP_CONFIG_FILE = "app.config.yaml";
-/** The name of the install configuration file */
-const INSTALL_YAML_FILE = "install.yaml";
-/** Get the path to the extension point folder */
-function getExtensionPointFolderPath(extensionPointId) {
-	return `src/${extensionPointId.replaceAll("/", "-")}`;
-}
-
-//#endregion
-//#region source/commands/generate/actions/constants.ts
-const __filename$1 = (0, url.fileURLToPath)(require("url").pathToFileURL(__filename).href);
-const __dirname$1 = (0, path.dirname)(__filename$1);
-/** The path to the action templates directory, sibling to this file. */
-const TEMPLATES_DIR = (0, path.join)(__dirname$1, "templates");
-/** The list of Commerce variables that are required for the runtime actions. */
-const COMMERCE_VARIABLES = [
-	"AIO_COMMERCE_AUTH_IMS_CLIENT_ID",
-	"AIO_COMMERCE_AUTH_IMS_CLIENT_SECRETS",
-	"AIO_COMMERCE_AUTH_IMS_TECHNICAL_ACCOUNT_ID",
-	"AIO_COMMERCE_AUTH_IMS_TECHNICAL_ACCOUNT_EMAIL",
-	"AIO_COMMERCE_AUTH_IMS_ORG_ID",
-	"AIO_COMMERCE_AUTH_IMS_SCOPES"
-];
-/** The inputs for the generated runtime actions. */
-const COMMERCE_ACTION_INPUTS = Object.fromEntries(COMMERCE_VARIABLES.map((variable) => [variable, `$${variable}`]));
-const CUSTOM_IMPORTS_PLACEHOLDER = "// {{CUSTOM_SCRIPTS_IMPORTS}}";
-const CUSTOM_SCRIPTS_MAP_PLACEHOLDER = "// {{CUSTOM_SCRIPTS_MAP}}";
-const CUSTOM_SCRIPTS_LOADER_PLACEHOLDER = "// {{CUSTOM_SCRIPTS_LOADER}}";
-
-//#endregion
-//#region source/commands/utils.ts
-/** Format file content using prettier, inferring the parser from the file path. */
-function prettierFormat(content, filepath) {
-	return prettier.format(content, {
-		arrowParens: "always",
-		bracketSameLine: true,
-		bracketSpacing: true,
-		filepath,
-		printWidth: 80,
-		quoteStyle: "double",
-		semi: true,
-		tabWidth: 2,
-		trailingComma: "all",
-		useTabs: false
-	});
-}
-/**
-* Load the app commerce config.
-* @param projectRoot - Resolved project root containing the app configuration.
-*/
-async function loadAppManifest(projectRoot) {
-	const appConfig = await require_index_node.parseCommerceAppConfig(projectRoot);
-	consola.default.debug("Loaded app commerce config");
-	return appConfig;
-}
-/**
-* Install the given dependencies.
-* @param packageManager - The detected package manager.
-* @param dependencies - Package specifiers to install; no-op when empty.
-* @param cwd - Working directory for the install command.
-* @param options - Install command options.
-*/
-function runInstall(packageManager, dependencies, cwd = process.cwd(), options = {}) {
-	if (dependencies.length === 0) return;
-	const dependencyListString = dependencies.map((dependency) => `  - ${dependency}`).join("\n");
-	consola.default.start([`Installing the following dependencies with ${packageManager}:\n${dependencyListString}\n`, "This may take a few seconds...\n"].join("\n"));
-	const { command, args } = require_index_node.getInstallCommand(packageManager, dependencies, options);
-	const displayCommand = [command, ...args].join(" ");
-	const result = (0, child_process.spawnSync)(command, args, {
-		cwd,
-		stdio: "inherit"
-	});
-	if (result.error || result.status !== 0) throw new Error(`Failed to install dependencies automatically. Please install manually: ${displayCommand}`, { cause: result.error ?? /* @__PURE__ */ new Error(`Install exited with code ${result.status}`) });
-	consola.default.log("");
-	consola.default.success("Dependencies installed successfully");
-}
-/**
-* Install dependencies declared in package.json.
-* @param packageManager - The detected package manager.
-* @param cwd - Working directory for the install command.
-*/
-function runProjectInstall(packageManager, cwd = process.cwd()) {
-	consola.default.start([`Installing project dependencies with ${packageManager}...`, "This may take a few seconds...\n"].join("\n"));
-	const { command, args } = require_index_node.getProjectInstallCommand(packageManager);
-	const displayCommand = [command, ...args].join(" ");
-	const result = (0, child_process.spawnSync)(command, args, {
-		cwd,
-		stdio: "inherit"
-	});
-	if (result.error || result.status !== 0) throw new Error(`Failed to install dependencies automatically. Please install manually: ${displayCommand}`, { cause: result.error ?? /* @__PURE__ */ new Error(`Install exited with code ${result.status}`) });
-	consola.default.log("");
-	consola.default.success("Dependencies installed successfully");
-}
-/**
-* Whether the app config contains anything that can't be JSON-serialized as-is
-* and therefore requires generating a runtime-safe ESM config module.
-*/
-function hasDynamicAppConfig(appConfig) {
-	const schema = appConfig.businessConfig?.schema;
-	return Array.isArray(schema) && (0, _adobe_aio_commerce_lib_config.hasDynamicSchema)(schema);
-}
-/**
-* Whether preserving the app config requires generating a JavaScript module.
-* @param appConfig - The parsed app config.
-* @param projectRoot - Resolved project root containing the source config.
-*/
-async function requiresJavaScriptAppConfig(appConfig, projectRoot) {
-	return hasDynamicAppConfig(appConfig) || await require_index_node.hasNamedCommerceAppConfigExports(projectRoot);
-}
-/**
-* Path to an extension point's `.generated` directory, relative to the project root.
-* @param extensionPointId - The extension point ID, e.g. "commerce/extensibility/1"
-*/
-function getGeneratedDir(extensionPointId) {
-	return (0, path.join)(getExtensionPointFolderPath(extensionPointId), GENERATED_PATH);
-}
-/**
-* Path to an extension point's generated actions directory, relative to the project root.
-* @param extensionPointId - The extension point ID, e.g. "commerce/extensibility/1"
-*/
-function getActionsDir(extensionPointId) {
-	return (0, path.join)(getExtensionPointFolderPath(extensionPointId), GENERATED_ACTIONS_PATH);
-}
-/**
-* Path to a specific generated action file, relative to the project root.
-* @param extensionPointId - The extension point ID, e.g. "commerce/extensibility/1"
-* @param actionName - The name of the action, e.g. "my-action"
-*/
-function getActionPath(extensionPointId, actionName) {
-	return (0, path.join)(getActionsDir(extensionPointId), `${actionName}.js`);
-}
-/**
-* Path to an extension point's `ext.config.yaml`, relative to the project root.
-* @param extensionPointId - The extension point ID, e.g. "commerce/extensibility/1"
-*/
-function getExtConfigPath(extensionPointId) {
-	return (0, path.join)(getExtensionPointFolderPath(extensionPointId), "ext.config.yaml");
-}
-/** Path to the generated app manifest JSON file, relative to the project root. */
-function getManifestPath() {
-	return (0, path.join)(getGeneratedDir(EXTENSIBILITY_EXTENSION_POINT_ID), APP_MANIFEST_FILE);
-}
-/**
-* Path to the generated runtime-safe app config ESM module, relative to the
-* project root. Used when the business config schema contains dynamic options.
-*/
-function getRuntimeAppConfigPath() {
-	return (0, path.join)(getGeneratedDir(EXTENSIBILITY_EXTENSION_POINT_ID), RUNTIME_APP_CONFIG_FILE);
-}
-/** Path to the generated configuration schema file, relative to the project root. */
-function getSchemaPath() {
-	return (0, path.join)(getGeneratedDir(CONFIGURATION_EXTENSION_POINT_ID), CONFIG_SCHEMA_FILE_NAME);
-}
-
-//#endregion
-//#region source/commands/typescript.ts
-const WEBPACK_CONFIG_PATTERN = /^webpack-config\.(?:cjs|js)$/u;
-const WEBPACK_CONFIG_FILE = "webpack-config.cjs";
-const TSCONFIG_FILE = "tsconfig.json";
-const ROOT_TYPESCRIPT_CONFIG = {
-	compilerOptions: {
-		allowJs: true,
-		checkJs: true,
-		module: "esnext",
-		moduleResolution: "bundler",
-		noEmit: true
-	},
-	exclude: ["src/**/web-src/**"],
-	extends: [
-		"@tsconfig/bases/recommended",
-		"@tsconfig/bases/node-ts",
-		"@tsconfig/bases/node24"
-	],
-	include: [
-		"src/**/.generated/actions/**/*.js",
-		"app.commerce.config.ts",
-		"app.commerce.config.mts",
-		"app.commerce.config.cts",
-		"src/**/*.ts",
-		"src/**/*.mts",
-		"src/**/*.cts"
-	]
-};
-const TYPESCRIPT_DEV_DEPENDENCIES = [
-	...SHARED_TYPESCRIPT_DEV_DEPENDENCIES,
-	TYPESCRIPT_NODE_DEV_DEPENDENCY,
-	TYPESCRIPT_WEBPACK_DEV_DEPENDENCY
-];
-const ACTIONS_TYPECHECK_SCRIPT = "typecheck:actions";
-const WEB_SOURCE_TYPECHECK_SCRIPT = "typecheck:web-src";
-const ACTIONS_TYPECHECK_COMMAND = "tsc --noEmit -p tsconfig.json";
-const WEB_SOURCE_TYPECHECK_COMMAND = `tsc --noEmit -p ${`${getExtensionPointFolderPath(BACKEND_UI_V2_EXTENSION_POINT_ID)}/web-src/tsconfig.json`}`;
-/**
-* Create the default Webpack configuration when the project has none.
-* @param projectRoot Project root directory.
-*/
-async function scaffoldWebpackConfig(projectRoot) {
-	const existingConfig = (await (0, fs_promises.readdir)(projectRoot, { withFileTypes: true })).find((entry) => entry.isFile() && WEBPACK_CONFIG_PATTERN.test(entry.name));
-	if (existingConfig !== void 0) {
-		consola.consola.info(`Found ${existingConfig.name}; leaving it unchanged.`);
-		return;
-	}
-	await (0, fs_promises.copyFile)((0, path.join)(TEMPLATES_DIR, "typescript", WEBPACK_CONFIG_FILE), (0, path.join)(projectRoot, WEBPACK_CONFIG_FILE));
-}
-/**
-* Create the Runtime actions TypeScript configuration when it does not exist.
-* @param projectRoot Project root directory.
-*/
-async function scaffoldTypeScriptConfig(projectRoot) {
-	const rootConfigPath = (0, path.join)(projectRoot, TSCONFIG_FILE);
-	if (!(0, fs.existsSync)(rootConfigPath)) await (0, fs_promises.writeFile)(rootConfigPath, `${JSON.stringify(ROOT_TYPESCRIPT_CONFIG, null, 2)}\n`, "utf-8");
-}
-/**
-* Install missing TypeScript tooling after validating installed versions.
-* @param packageManager Package manager used by the project.
-* @param projectRoot Project root directory.
-*/
-async function installTypeScriptDependencies(packageManager, projectRoot) {
-	const installPlan = await require_index_node.getPackageDependencyInstallPlan(TYPESCRIPT_DEV_DEPENDENCIES, projectRoot);
-	if (installPlan.incompatible.length > 0) {
-		const dependencies = installPlan.incompatible.map(({ name, version, installedVersion }) => `${name}@${installedVersion} does not satisfy ${version}`).join("\n");
-		throw new Error(`Cannot configure TypeScript because installed dependencies are incompatible:\n${dependencies}`);
-	}
-	runInstall(packageManager, installPlan.missing.map(({ name, version }) => `${name}@${version}`), projectRoot, { dev: true });
-}
-/**
-* Scaffold the files and dependencies for a new TypeScript Commerce project.
-* @param packageManager Package manager used by the initialized project.
-* @param projectRoot Resolved project root.
-*/
-async function scaffoldTypeScriptProject(packageManager, projectRoot) {
-	await scaffoldWebpackConfig(projectRoot);
-	await scaffoldTypeScriptConfig(projectRoot);
-	await installTypeScriptDependencies(packageManager, projectRoot);
-}
-/**
-* Add a generated typecheck script and compose it into the root typecheck script.
-* @param scriptName Generated package script name.
-* @param command TypeScript command run by the generated script.
-* @param projectRoot Resolved project root.
-*/
-async function syncTypecheckScript(scriptName, command, projectRoot) {
-	const pkg = await require_index_node.loadPackageJson(projectRoot);
-	if (pkg === null) throw new Error("Could not find package.json.");
-	const scripts = {
-		...pkg.content.scripts,
-		[scriptName]: command
-	};
-	const packageManager = await require_index_node.detectPackageManager(projectRoot);
-	const typecheck = require_index_node.appendCommand(scripts.typecheck, require_index_node.getRunScriptCommand(packageManager, scriptName));
-	pkg.update({ scripts: {
-		...scripts,
-		typecheck
-	} });
-	await pkg.save();
-}
-/**
-* Add the Runtime actions typecheck script to a project.
-* @param projectRoot Resolved project root.
-*/
-async function syncActionsTypecheckScript(projectRoot) {
-	await syncTypecheckScript(ACTIONS_TYPECHECK_SCRIPT, ACTIONS_TYPECHECK_COMMAND, projectRoot);
-}
-/**
-* Add the web-src typecheck script to a project.
-* @param projectRoot Resolved project root.
-*/
-async function syncWebSourceTypecheckScript(projectRoot) {
-	await syncTypecheckScript(WEB_SOURCE_TYPECHECK_SCRIPT, WEB_SOURCE_TYPECHECK_COMMAND, projectRoot);
-}
-
-//#endregion
-//#region source/commands/generate/web-src.ts
-const JSX_FILE_EXTENSION = ".jsx";
-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"
-	},
-	{
-		name: "react",
-		version: "^19.2.7"
-	},
-	{
-		name: "react-dom",
-		version: "^19.2.7"
-	},
-	{
-		name: "@react-spectrum/s2",
-		version: "^1.5.1"
-	}
-];
-const WEB_SOURCE_BABEL_DEV_DEPENDENCIES = [{
-	name: "@babel/core",
-	version: "^7.29.7"
-}, {
-	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",
-	types: ["css"]
-}];
-const WEB_SOURCE_TYPESCRIPT_CONFIG = {
-	compilerOptions: {
-		allowImportingTsExtensions: true,
-		allowJs: true,
-		checkJs: true,
-		jsx: "react-jsx",
-		jsxImportSource: "react",
-		module: "esnext",
-		moduleResolution: "bundler",
-		noEmit: true,
-		rewriteRelativeImportExtensions: false
-	},
-	extends: ["@tsconfig/bases/recommended"],
-	include: [
-		"src/**/*.js",
-		"src/**/*.ts",
-		"src/**/*.tsx",
-		"src/**/*.jsx"
-	]
-};
-/** Normalize a generated file path for package.json imports. */
-function normalizePackageJsonPath$1(path$9) {
-	const normalizedPath = path$9.split(path.sep).join("/");
-	return (normalizedPath.startsWith(".") ? normalizedPath : `./${normalizedPath}`).replace(LEADING_DOT_SLASH_PATTERN$1, "./");
-}
-/**
-* Resolve the generated web-src entrypoint path from an extension config.
-* @param extConfig - Extension config containing the view operation.
-*/
-function getWebSourceEntrypoint(extConfig) {
-	const viewEntrypoint = extConfig.operations?.view?.[0]?.impl;
-	if (viewEntrypoint === void 0) return null;
-	return (0, path.join)(getExtensionPointFolderPath(BACKEND_UI_V2_EXTENSION_POINT_ID), extConfig.web ?? "web-src", viewEntrypoint);
-}
-/**
-* Ensure package.json has the dependencies and Parcel config needed by web-src.
-* @param projectRoot - Resolved project root containing package.json.
-* @param extension - Web source extension whose tooling is configured.
-*/
-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 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 existingDependencies = pkg.content.dependencies ?? {};
-	const devDependencies = pkg.content.devDependencies ?? {};
-	const dependencyMaps = [existingDependencies, devDependencies];
-	const declaredDependencyNames = new Set(dependencyMaps.flatMap((depMap) => Object.keys(depMap)));
-	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({
-		...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)
-		},
-		devDependencies: require_index_node.mergePackageJsonDependencies(devDependencies, requiredDevDependencies, dependencyMaps)
-	});
-	await pkg.save();
-	if (installPlan.missing.length === 0) {
-		consola.consola.info("web-src dependencies are already installed.");
-		return;
-	}
-	consola.consola.info("Installing missing web-src dependencies from package.json:");
-	consola.consola.log.raw((0, consola_utils.formatTree)(installPlan.missing.map(({ name, version }) => ` ${name}@${version}`)));
-	const packageManager = await require_index_node.detectPackageManager(projectRoot);
-	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.
-*/
-async function prepareWebSourceImportAlias(extConfig, projectRoot) {
-	const entrypoint = getWebSourceEntrypoint(extConfig);
-	if (entrypoint === null) return;
-	const pkg = await require_index_node.loadPackageJson(projectRoot);
-	if (pkg === null) throw new Error("Could not find package.json.");
-	const existingImports = typeof pkg.content.imports === "object" && pkg.content.imports !== null ? pkg.content.imports : {};
-	const webSourceSrcPath = (0, path.join)((0, path.dirname)(entrypoint), "src");
-	pkg.update({ imports: {
-		...existingImports,
-		[WEB_SOURCE_IMPORT_ALIAS]: `${normalizePackageJsonPath$1(webSourceSrcPath)}/*`
-	} });
-	await pkg.save();
-}
-/** Resolve the generated web-src file extension from the app config file type. */
-async function resolveWebSourceExtension(projectRoot) {
-	const configFilePath = await require_index_node.resolveCommerceAppConfig(projectRoot);
-	return configFilePath !== null && require_index_node.isTypeScriptConfig(configFilePath) ? "tsx" : "jsx";
-}
-async function writeWebSourceTypeScriptConfig(targetDir) {
-	const tsconfigPath = (0, path.join)(targetDir, WEB_SOURCE_TSCONFIG_FILE);
-	await (0, fs_promises.writeFile)(tsconfigPath, `${JSON.stringify(WEB_SOURCE_TYPESCRIPT_CONFIG, null, 2)}\n`, "utf-8");
-	return tsconfigPath;
-}
-/**
-* Resolve the destination path for a web-src template file.
-* @param templatePath - Template file path relative to its source directory.
-* @param extension - Web source extension to generate.
-*/
-function getWebSourceTemplateTargetPath(templatePath, extension) {
-	if (extension === "jsx" || !templatePath.endsWith(JSX_FILE_EXTENSION)) return templatePath;
-	return `${templatePath.slice(0, -4)}${TSX_FILE_EXTENSION}`;
-}
-/**
-* Copy web-src templates directly to the final file extension and entrypoint.
-* @param sourceDir - Template web-src directory.
-* @param targetDir - Generated web-src directory.
-* @param extension - Web source extension to generate.
-* @param appTitle - Application title used by the entrypoint template.
-* @param projectRoot - Resolved project root used to format output paths.
-*/
-async function copyWebSourceTemplates(sourceDir, targetDir, extension, appTitle, projectRoot) {
-	await (0, fs_promises.mkdir)(targetDir, { recursive: true });
-	const entries = await (0, fs_promises.readdir)(sourceDir, { withFileTypes: true });
-	return (await Promise.all(entries.map(async (entry) => {
-		const sourcePath = (0, path.join)(sourceDir, entry.name);
-		const targetPath = (0, path.join)(targetDir, getWebSourceTemplateTargetPath(entry.name, extension));
-		if (entry.isDirectory()) return await copyWebSourceTemplates(sourcePath, targetPath, extension, appTitle, projectRoot);
-		let content = await (0, fs_promises.readFile)(sourcePath, "utf-8");
-		if (extension === "tsx") content = content.replaceAll(`${JSX_FILE_EXTENSION}"`, `${TSX_FILE_EXTENSION}"`);
-		if (targetPath.endsWith(WEB_SOURCE_ENTRYPOINT_FILE)) content = content.replaceAll(APP_TITLE_PLACEHOLDER, appTitle);
-		await (0, fs_promises.writeFile)(targetPath, content, {
-			encoding: "utf-8",
-			flag: "wx"
-		});
-		return ` ${(0, path.relative)(projectRoot, targetPath)}`;
-	}))).flat();
-}
-/**
-* Generates the web source scaffold for an iframe-based Admin UI extension.
-* @param extConfig - Extension config containing the web entrypoint.
-* @param appName - Application name inserted into the generated entrypoint.
-* @param projectRoot - Resolved project root where web source is generated.
-* @param templatesDir - Directory containing web source templates.
-*/
-async function generateWebSrc(extConfig, appName, projectRoot, templatesDir = TEMPLATES_DIR) {
-	const entrypoint = getWebSourceEntrypoint(extConfig);
-	if (entrypoint === null) return;
-	const entrypointPath = (0, path.join)(projectRoot, entrypoint);
-	const scaffoldRequired = !(0, fs.existsSync)(entrypointPath);
-	const targetDir = (0, path.dirname)(entrypointPath);
-	const extension = await resolveWebSourceExtension(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));
-	}
-}
-
-//#endregion
-//#region source/commands/generate/actions/config.ts
-/**
-* Creates a runtime action configuration.
-* @param actionName - The name of the action.
-* @param config - Action generation options.
-* @param options - Optional configuration options.
-*/
-function createActionDefinition(actionName, config = {}, options = {}) {
-	const def = {
-		...options,
-		annotations: {
-			final: true,
-			"require-adobe-auth": true
-		},
-		function: `${GENERATED_ACTIONS_PATH}/${actionName}.js`,
-		runtime: "nodejs:24",
-		web: options.web ?? "yes"
-	};
-	if (config.requiresEncryptionKey) def.inputs = {
-		...def.inputs,
-		AIO_COMMERCE_CONFIG_ENCRYPTION_KEY: "$AIO_COMMERCE_CONFIG_ENCRYPTION_KEY"
-	};
-	return def;
-}
-/**
-* Gets the runtime actions to be generated from the ext.config.yaml configuration.
-* @param extConfig - The ext.config.yaml configuration.
-* @param dir - Directory containing the runtime action templates.
-*/
-function getRuntimeActions(extConfig, dir) {
-	return Object.entries(extConfig.runtimeManifest?.packages?.["app-management"]?.actions ?? {}).map(([name]) => ({
-		name,
-		templateFile: (0, path.join)(dir, `${name}.js.template`)
-	}));
-}
-/**
-* Builds the ext.config.yaml configuration for the extensibility extension.
-* @param appConfig - Parsed app configuration.
-*/
-function buildAppManagementExtConfig(appConfig) {
-	const extConfig = {
-		hooks: {
-			"post-app-deploy": "EXTENSION=extensibility/1 $packageExec aio-commerce-lib-app hooks post-app-deploy",
-			"pre-app-build": "EXTENSION=extensibility/1 $packageExec aio-commerce-lib-app hooks pre-app-build"
-		},
-		operations: { workerProcess: [{
-			impl: `${PACKAGE_NAME}/app-config`,
-			type: "action"
-		}, {
-			impl: `${PACKAGE_NAME}/association`,
-			type: "action"
-		}] },
-		runtimeManifest: { packages: { [PACKAGE_NAME]: {
-			actions: {
-				"app-config": createActionDefinition("app-config"),
-				association: createActionDefinition("association")
-			},
-			license: "Apache-2.0"
-		} } }
-	};
-	const hasPasswordFieldsInSchema = require_validate.hasBusinessConfigSchema(appConfig) && appConfig.businessConfig.schema.some((field) => field.type === "password");
-	extConfig.operations.workerProcess.push({
-		impl: `${PACKAGE_NAME}/installation`,
-		type: "action"
-	});
-	extConfig.runtimeManifest.packages[PACKAGE_NAME].actions.installation = createActionDefinition("installation", { requiresEncryptionKey: hasPasswordFieldsInSchema }, {
-		inputs: {
-			...COMMERCE_ACTION_INPUTS,
-			LOG_LEVEL: "$LOG_LEVEL"
-		},
-		limits: { timeout: 6e5 }
-	});
-	return extConfig;
-}
-/** Builds the ext.config.yaml configuration for the business configuration extension. */
-function buildBusinessConfigurationExtConfig() {
-	const actions = [{
-		name: "config",
-		requiresEncryptionKey: true,
-		templateFile: "config.js.template"
-	}, {
-		name: "scope-tree",
-		templateFile: "scope-tree.js.template"
-	}];
-	return {
-		hooks: { "pre-app-build": "EXTENSION=configuration/1 $packageExec aio-commerce-lib-app hooks pre-app-build" },
-		operations: { workerProcess: actions.map((action) => ({
-			impl: `${PACKAGE_NAME}/${action.name}`,
-			type: "action"
-		})) },
-		runtimeManifest: { packages: { [PACKAGE_NAME]: {
-			actions: Object.fromEntries(actions.map((action) => [action.name, createActionDefinition(action.name, action)])),
-			license: "Apache-2.0"
-		} } }
-	};
-}
-/** Collects unique `runtimeAction` strings from all worker entries in an `adminUi` config. */
-function collectUniqueRuntimeActions(adminUi) {
-	const entities = [
-		"order",
-		"product",
-		"customer"
-	].map((key) => adminUi?.[key]);
-	const gridRuntimeActions = entities.map((entity) => entity?.gridColumns?.runtimeAction).filter((action) => action !== void 0);
-	const massActionRuntimeActions = entities.flatMap((entity) => entity?.massActions ?? []).filter((action) => action.type === "worker").map((action) => action.runtimeAction);
-	const viewButtonRuntimeActions = (adminUi?.order?.viewButtons ?? []).filter((button) => button.type === "worker").map((button) => button.runtimeAction);
-	return [.../* @__PURE__ */ new Set([
-		...gridRuntimeActions,
-		...massActionRuntimeActions,
-		...viewButtonRuntimeActions
-	])];
-}
-/** Returns true if the `adminUi` config requires a `view` operation and `web` source in ext.config.yaml. */
-function requiresWebSource(adminUi) {
-	if (adminUi?.menu !== void 0) return true;
-	if ((adminUi?.order?.viewButtons ?? []).some((button) => button.type === "view")) return true;
-	return [
-		"order",
-		"product",
-		"customer"
-	].map((key) => adminUi?.[key]).flatMap((entity) => entity?.massActions ?? []).some((action) => action.type === "view");
-}
-/**
-* Builds the ext.config.yaml for the Admin UI v2 extension (`commerce/backend-ui/2`).
-* Derives `workerProcess` and `view` operation declarations from `adminUi` config.
-* Adds a `view` operation and `web` source when view-type entries or `adminUi.menu` is configured.
-* @param appConfig - Parsed app configuration.
-*/
-function buildAdminUiV2ExtConfig(appConfig) {
-	const { adminUi } = appConfig;
-	const runtimeActions = collectUniqueRuntimeActions(adminUi);
-	const requiresWeb = requiresWebSource(adminUi);
-	return {
-		hooks: {
-			"pre-app-build": "EXTENSION=backend-ui/2 $packageExec aio-commerce-lib-app hooks pre-app-build",
-			"pre-app-dev": "EXTENSION=backend-ui/2 $packageExec aio-commerce-lib-app hooks pre-app-dev",
-			"pre-app-run": "EXTENSION=backend-ui/2 $packageExec aio-commerce-lib-app hooks pre-app-run"
-		},
-		operations: {
-			...requiresWeb && { view: [{
-				impl: "index.html",
-				type: "web"
-			}] },
-			...runtimeActions.length > 0 && { workerProcess: runtimeActions.map((impl) => ({
-				impl,
-				type: "action"
-			})) }
-		},
-		...requiresWeb && { web: "web-src" }
-	};
-}
-
-//#endregion
-//#region ../../packages-private/scripting-utils/source/yaml/helpers.ts
-/**
-* Read a YAML file and return a {@link Document}
-* @param path - The path to the YAML file
-*/
-async function readYamlFile(path$5) {
-	let doc = new yaml.Document();
-	if ((0, fs.existsSync)(path$5)) try {
-		const fileContent = await (0, fs_promises.readFile)(path$5, "utf-8");
-		doc = (0, yaml.parseDocument)(fileContent, { keepSourceTokens: true });
-	} catch (err) {
-		const file = (0, path.basename)(path$5);
-		throw new Error(`Failed to parse ${file}`, { cause: err });
-	}
-	if (doc.contents === null) doc.contents = new yaml.YAMLMap();
-	return doc;
-}
-/**
-* Generic helper to get or create a YAML node at the given path
-* @param doc - The YAML document
-* @param path - The path to the node
-* @param options - The options for the node
-* @param typeConfig - Configuration for the node type
-* @returns The existing or newly created node
-*/
-function getOrCreateNode(doc, path$6, options, typeConfig) {
-	const node = doc.getIn(path$6);
-	if (node) {
-		if (!typeConfig.typeGuard(node)) throw new Error(`Expected ${typeConfig.typeName} at path "${path$6.join(".")}".`);
-		return node;
-	}
-	if (doc.hasIn(path$6)) doc.deleteIn(path$6);
-	const pair = doc.createPair(path$6.at(-1), typeConfig.createNode());
-	options.onBeforeCreate?.(pair);
-	if (path$6.length === 1) doc.add(pair);
-	else doc.addIn(path$6.slice(0, -1), pair);
-	return doc.getIn(path$6);
-}
-/**
-* Get or create a sequence at the given path
-* @param doc - The YAML document
-* @param path - The path to the sequence
-* @param options - The options for the sequence
-*/
-function getOrCreateSeq(doc, path$7, options) {
-	return getOrCreateNode(doc, path$7, options ?? {}, {
-		createNode: () => new yaml.YAMLSeq(),
-		typeGuard: yaml.isSeq,
-		typeName: "sequence"
-	});
-}
-/**
-* Get or create a map at the given path
-* @param doc - The YAML document
-* @param path - The path to the map
-* @param options - The options for the map
-*/
-function getOrCreateMap(doc, path$8, options) {
-	return getOrCreateNode(doc, path$8, options ?? {}, {
-		createNode: () => new yaml.YAMLMap(),
-		typeGuard: yaml.isMap,
-		typeName: "map"
-	});
-}
-/**
-* Read the `inputs` map from an existing YAML action definition into a plain
-* object. Used by codegen to merge developer-added inputs with the ones the
-* generator manages, so regeneration does not strip user-added entries.
-*
-* @param existingAction - The YAML map representing the existing action.
-*/
-function getExistingInputs(existingAction) {
-	const inputs = existingAction?.get("inputs");
-	if (!(0, yaml.isMap)(inputs)) return {};
-	return Object.fromEntries(inputs.items.map((item) => {
-		if (!(0, yaml.isPair)(item)) return [];
-		return [String(item.key), item.value];
-	}));
-}
-/**
-* Read a string field from an existing YAML action definition. Used by codegen
-* to preserve developer-set values (e.g. `runtime`) across regeneration
-* instead of overwriting them.
-*
-* @param key - The field to read.
-* @param existingAction - The YAML map representing the existing action.
-*/
-function getExistingString(key, existingAction) {
-	const value = existingAction?.get(key);
-	return typeof value === "string" ? value : void 0;
-}
-
-//#endregion
-//#region ../../packages-private/scripting-utils/source/yaml/codegen.ts
-/**
-* Create an ext.config.yaml file
-* @param path - The path to the ext.config.yaml file
-* @param config - The config to build
-* @param doc - The document to modify (a new one is created if not provided)
-*/
-async function createOrUpdateExtConfig(path, config, doc) {
-	const extConfigDoc = doc ?? new yaml.Document({});
-	if (config.web !== void 0) buildWeb(extConfigDoc, config.web);
-	config.hooks ??= {};
-	await buildHooks(extConfigDoc, config.hooks);
-	if (config.operations !== void 0) buildOperations(extConfigDoc, config.operations);
-	if (config.runtimeManifest !== void 0) buildRuntimeManifest(extConfigDoc, config.runtimeManifest);
-	await writeExtConfig(path, extConfigDoc);
-	return extConfigDoc;
-}
-/**
-* Set the top-level `web` scalar only if it's missing.
-* Preserves any user-customized value already present.
-*/
-function buildWeb(extConfig, web) {
-	if (!extConfig.hasIn(["web"])) extConfig.add(extConfig.createPair("web", web));
-}
-/**
-* Build the definition for a runtime action.
-*
-* Developer-added `inputs` keys (anything not in the generator-managed set) on
-* `existingAction` are preserved so that hand-written entries — for example
-* factory credentials for `dynamicList` fields — survive regeneration.
-*
-* A `runtime` already set on `existingAction` is likewise preserved, so a
-* developer can pin a different Node runtime (e.g. `nodejs:24`) in
-* `ext.config.yaml` once without codegen reverting it on the next run.
-*
-* @param action - The action definition to build.
-* @param existingAction - The action's previous YAML definition, if any.
-*/
-function buildActionDefinition(action, existingAction) {
-	const actionDef = new yaml.YAMLMap();
-	const existingInputs = getExistingInputs(existingAction);
-	const existingRuntime = getExistingString("runtime", existingAction);
-	const managedInputs = { LOG_LEVEL: "$LOG_LEVEL" };
-	actionDef.set("function", action.function);
-	actionDef.set("web", action.web ?? "yes");
-	actionDef.set("runtime", existingRuntime ?? action.runtime ?? "nodejs:24");
-	actionDef.set("inputs", {
-		...existingInputs,
-		...managedInputs,
-		...action.inputs ?? {}
-	});
-	actionDef.set("annotations", { ...action.annotations ?? {
-		final: true,
-		"require-adobe-auth": true
-	} });
-	const includes = action.include ?? [];
-	if (includes.length > 0) {
-		const itemSeq = new yaml.YAMLSeq();
-		itemSeq.flow = true;
-		for (const [source, target] of includes) itemSeq.items.push(source, target);
-		const seq = new yaml.YAMLSeq();
-		seq.items.push(itemSeq);
-		actionDef.set("include", seq);
-	}
-	if (action.limits !== void 0) actionDef.set("limits", action.limits);
-	return actionDef;
-}
-/**
-* Build the `operations` section of the `ext.config.yaml` file
-* @param extConfig - The ext.config.yaml file
-* @param operations - The operations to build
-*/
-function buildOperations(extConfig, operations) {
-	const ourOps = operations.workerProcess ?? [];
-	if (ourOps.length > 0) {
-		getOrCreateMap(extConfig, ["operations"], { onBeforeCreate: (pair) => {
-			pair.key.spaceBefore = true;
-		} });
-		const workerProcess = getOrCreateSeq(extConfig, ["operations", "workerProcess"], { onBeforeCreate: (pair) => {
-			pair.key.commentBefore = " These worker processes definitions are auto-generated. Do not remove or manually edit.";
-		} });
-		workerProcess.items = [];
-		workerProcess.items.push(...ourOps.map((op) => {
-			const map = new yaml.YAMLMap();
-			map.set("type", op.type);
-			map.set("impl", op.impl);
-			return map;
-		}));
-	} else if (extConfig.hasIn(["operations", "workerProcess"])) extConfig.deleteIn(["operations", "workerProcess"]);
-	if (operations.view !== void 0) {
-		getOrCreateMap(extConfig, ["operations"], { onBeforeCreate: (pair) => {
-			pair.key.spaceBefore = true;
-		} });
-		const view = getOrCreateSeq(extConfig, ["operations", "view"]);
-		if (view.items.length === 0) view.items.push(...operations.view.map((v) => {
-			const map = new yaml.YAMLMap();
-			map.set("type", v.type);
-			map.set("impl", v.impl);
-			return map;
-		}));
-	}
-	const operationsMap = extConfig.getIn(["operations"]);
-	if (operationsMap instanceof yaml.YAMLMap && operationsMap.items.length === 0) extConfig.deleteIn(["operations"]);
-}
-/**
-* Build the `runtimeManifest` section of the `ext.config.yaml` file
-* @param extConfig - The ext.config.yaml file
-* @param packages - The packages to build
-*/
-function buildRuntimeManifest(extConfig, manifest) {
-	const packages = manifest.packages ?? {};
-	if (Object.keys(packages).length === 0) return;
-	getOrCreateMap(extConfig, ["runtimeManifest"], { onBeforeCreate: (pair) => {
-		pair.key.spaceBefore = true;
-	} });
-	getOrCreateMap(extConfig, ["runtimeManifest", "packages"]);
-	for (const [name, pkg] of Object.entries(packages)) {
-		const packageDef = getOrCreateMap(extConfig, [
-			"runtimeManifest",
-			"packages",
-			name
-		], { onBeforeCreate: (pair) => {
-			pair.key.commentBefore = " This package definition is auto-generated. Do not remove or manually edit.";
-		} });
-		const existingActions = packageDef.get("actions");
-		const actions = new yaml.YAMLMap();
-		packageDef.set("license", pkg.license ?? "Apache-2.0");
-		packageDef.set("actions", actions);
-		for (const [actionName, action] of Object.entries(pkg.actions ?? {})) {
-			const existingAction = (0, yaml.isMap)(existingActions) ? existingActions.get(actionName) : void 0;
-			const actionDef = buildActionDefinition(action, (0, yaml.isMap)(existingAction) ? existingAction : void 0);
-			actions.set(actionName, actionDef);
-		}
-	}
-}
-/**
-* Build the `hooks` section of the `ext.config.yaml` file
-* @param extConfig - The ext.config.yaml file
-* @param hooks - The hooks to build
-*/
-async function buildHooks(extConfig, hooks) {
-	const generatedHooks = `[${Object.keys(hooks).join(", ")}]`;
-	const hooksMap = getOrCreateMap(extConfig, ["hooks"], { onBeforeCreate: (pair) => {
-		pair.key.spaceBefore = true;
-		pair.key.commentBefore = ` The ${generatedHooks} hooks are auto-generated. Do not remove or manually edit.`;
-	} });
-	const projectRoot = await require_index_node.getProjectRootDirectory();
-	const packageManager = await require_index_node.detectPackageManager(projectRoot);
-	const execCommand = require_index_node.getExecCommand(packageManager);
-	for (const [name, command] of Object.entries(hooks)) {
-		const fullCommand = `${command.replaceAll("$packageExec", execCommand)}`;
-		const prevValue = (hooksMap.get(name) ?? "").trim();
-		if (prevValue.endsWith("js") || prevValue.endsWith("ts")) throw new Error(`Conflicting hook definition found. The "${name}" hook needs to be a command, not a script.`);
-		hooksMap.set(name, require_index_node.appendCommand(prevValue || void 0, fullCommand));
-	}
-}
-/**
-* Write the ext.config.yaml file
-* @param configPath - The path to the ext.config.yaml file
-* @param config - The config to write
-*/
-async function writeExtConfig(configPath, doc) {
-	const yamlContent = doc.toString({
-		defaultStringType: "PLAIN",
-		indent: 2,
-		lineWidth: 0
-	});
-	await (0, fs_promises.writeFile)(configPath, yamlContent, "utf-8");
-}
-
-//#endregion
-//#region source/commands/generate/actions/lib.ts
-const ESBUILD_PACKAGE = "esbuild@0.28.0";
-const LEADING_DOT_SLASH_PATTERN = /^\.\//u;
-/** Normalize a path for use as an ESM import specifier. */
-function normalizeImportPath(path$3) {
-	const normalizedPath = path$3.split(path.sep).join("/");
-	return normalizedPath.startsWith(".") ? normalizedPath : `./${normalizedPath}`;
-}
-/** Normalize a generated file path for package.json imports. */
-function normalizePackageJsonPath(path$4) {
-	return normalizeImportPath(path$4).replace(LEADING_DOT_SLASH_PATTERN, "./");
-}
-/** Add or update the package import alias used by dynamic generated actions. */
-async function updateAppConfigImportAlias(projectRoot, runtimeConfigPath) {
-	const pkg = await require_index_node.loadPackageJson(projectRoot);
-	if (pkg === null) throw new Error("Could not find package.json.");
-	const existingImports = typeof pkg.content.imports === "object" && pkg.content.imports !== null ? pkg.content.imports : {};
-	pkg.update({ imports: {
-		...existingImports,
-		[APP_CONFIG_IMPORT_ALIAS]: normalizePackageJsonPath(runtimeConfigPath)
-	} });
-	await pkg.save();
-}
-/** Write an ESM passthrough module that re-exports an app config file. */
-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}"${importAttributes};`,
-		"",
-		isJson ? null : `export * from "${configImportPath}";`,
-		defaultExport,
-		""
-	].filter((item) => item !== null).join("\n"), "utf-8");
-}
-/**
-* Bundles a TypeScript app config file into runtime-safe ESM.
-* @param configFilePath - Source TypeScript app config path.
-* @param outputPath - Generated ESM module path.
-* @param projectRoot - Resolved project root used to run the bundler.
-*/
-async function bundleTypeScriptAppConfigModule(configFilePath, outputPath, projectRoot) {
-	const packageManager = await require_index_node.detectPackageManager(projectRoot);
-	const { command, args } = require_index_node.getPackageExecutionCommand(packageManager, [
-		ESBUILD_PACKAGE,
-		configFilePath,
-		"--bundle",
-		"--format=esm",
-		"--log-level=silent",
-		`--outfile=${outputPath}`,
-		"--packages=external",
-		"--platform=node",
-		"--target=node22"
-	], { allowBuild: "esbuild" });
-	const result = (0, child_process.spawnSync)(command, args, {
-		cwd: projectRoot,
-		stdio: "inherit"
-	});
-	if (result.error || result.status !== 0) throw new Error(`Could not bundle the TypeScript app config with ${ESBUILD_PACKAGE}.`, { cause: result.error ?? /* @__PURE__ */ new Error(`Bundle command exited with code ${result.status}`) });
-}
-/**
-* Write an ESM module that re-exports the static app manifest JSON so generated
-* actions can import it via the alias without needing a JSON import attribute.
-* @param projectRoot - Resolved project root where the module is generated.
-*/
-async function prepareStaticAppConfigImportAlias(projectRoot) {
-	const runtimeConfigPath = getRuntimeAppConfigPath();
-	const outputPath = (0, path.join)(projectRoot, runtimeConfigPath);
-	await require_index_node.makeOutputDirFor((0, path.dirname)(runtimeConfigPath), projectRoot);
-	await writeJavaScriptAppConfigModule((0, path.join)(projectRoot, getManifestPath()), outputPath);
-}
-/**
-* Prepare the runtime config module consumed by generated actions and its
-* `#app.commerce.config` package import alias.
-*
-* TypeScript configs are bundled into a generated runtime module. JavaScript
-* configs use a passthrough module, while serializable default-only configs use
-* a re-export of the validated JSON manifest.
-* @param appManifest - App configuration used to select the module format.
-* @param projectRoot - Resolved project root where the module is generated.
-*/
-async function prepareRuntimeAppConfigModule(appManifest, projectRoot) {
-	const configFilePath = await require_index_node.resolveCommerceAppConfig(projectRoot);
-	if (await requiresJavaScriptAppConfig(appManifest, projectRoot)) {
-		if (configFilePath === null) throw new Error("Generating a runtime config module requires an app.commerce.config.* file.");
-		await require_index_node.makeOutputDirFor((0, path.dirname)(getRuntimeAppConfigPath()), projectRoot);
-		const outputPath = (0, path.join)(projectRoot, getRuntimeAppConfigPath());
-		if (require_index_node.isTypeScriptConfig(configFilePath)) await bundleTypeScriptAppConfigModule(configFilePath, outputPath, projectRoot);
-		else await writeJavaScriptAppConfigModule(configFilePath, outputPath);
-	} else await prepareStaticAppConfigImportAlias(projectRoot);
-	await updateAppConfigImportAlias(projectRoot, getRuntimeAppConfigPath());
-}
-/**
-* Reads an extension point's ext.config.yaml document and path.
-* @param extensionPointId - The extension point ID to read the config for.
-* @param projectRoot - Resolved project root containing the extension config.
-*/
-async function readExtConfig(extensionPointId, projectRoot) {
-	const extConfigPath = (0, path.join)(projectRoot, getExtConfigPath(extensionPointId));
-	try {
-		return {
-			doc: await readYamlFile(extConfigPath),
-			path: extConfigPath
-		};
-	} catch (error) {
-		const reason = error instanceof Error ? error.message : "Unexpected error while reading the file.";
-		throw new Error([
-			`Could not read ext.config.yaml for ${extensionPointId} at ${extConfigPath}.`,
-			`Make sure the file exists and is valid YAML. You can regenerate it with "aio-commerce-lib-app generate actions".`,
-			`Reason: ${reason}`
-		].join("\n"), { cause: error });
-	}
-}
-/**
-* Updates an extension point's ext.config.yaml with generated configuration.
-* @param appConfig - App configuration used to build the extension config.
-* @param extensionPointId - Extension point whose config is updated.
-* @param projectRoot - Resolved project root containing the extension config.
-*/
-async function updateExtConfig(appConfig, extensionPointId, projectRoot) {
-	consola.consola.info(`Updating ext.config.yaml for ${extensionPointId}...`);
-	await require_index_node.makeOutputDirFor(getExtensionPointFolderPath(extensionPointId), projectRoot);
-	const { path: extConfigPath, doc: extConfigDoc } = await readExtConfig(extensionPointId, projectRoot);
-	let extConfig;
-	switch (extensionPointId) {
-		case EXTENSIBILITY_EXTENSION_POINT_ID:
-			extConfig = buildAppManagementExtConfig(appConfig);
-			break;
-		case CONFIGURATION_EXTENSION_POINT_ID:
-			extConfig = buildBusinessConfigurationExtConfig();
-			break;
-		case BACKEND_UI_V2_EXTENSION_POINT_ID:
-			extConfig = buildAdminUiV2ExtConfig(appConfig);
-			break;
-		default: throw new Error(`Unsupported extension point: ${extensionPointId}`);
-	}
-	await createOrUpdateExtConfig(extConfigPath, extConfig, extConfigDoc);
-	return extConfig;
-}
-/**
-* Generates runtime action files from templates.
-* @param appManifest - App configuration used to populate action templates.
-* @param actions - Runtime actions to generate.
-* @param extensionPointId - Extension point receiving the generated actions.
-* @param templatesDir - Directory containing action templates.
-* @param projectRoot - Resolved project root where actions are generated.
-*/
-async function generateActionFiles(appManifest, actions, extensionPointId, templatesDir, projectRoot) {
-	consola.consola.start("Generating runtime actions...");
-	await require_index_node.makeOutputDirFor(getActionsDir(extensionPointId), projectRoot);
-	const outputFiles = await Promise.all(actions.map(async (action) => {
-		const templatePath = (0, path.join)(templatesDir, action.templateFile);
-		let template = await (0, fs_promises.readFile)(templatePath, "utf-8");
-		if (action.name === "installation") {
-			const customScriptsTemplatePath = (0, path.join)(templatesDir, "app-management", "custom-scripts.js.template");
-			const scriptsTemplate = await generateCustomScriptsTemplate(await (0, fs_promises.readFile)(customScriptsTemplatePath, "utf-8"), appManifest, projectRoot);
-			template = applyCustomScripts(template, scriptsTemplate);
-		}
-		const actionPath = (0, path.join)(projectRoot, getActionPath(extensionPointId, action.name));
-		await (0, fs_promises.writeFile)(actionPath, template, "utf-8");
-		return ` ${(0, path.relative)(projectRoot, actionPath)}`;
-	}));
-	consola.consola.success(`Generated ${actions.length} action(s)`);
-	consola.consola.log.raw((0, consola_utils.formatTree)(outputFiles));
-}
-/**
-* Applies the given custom scripts template code to the given installation template.
-* @param installationTemplate - The installation code runtime action template
-* @param customScriptsTemplate - The custom scripts dynamically generated template.
-*/
-function applyCustomScripts(installationTemplate, customScriptsTemplate) {
-	if (customScriptsTemplate !== null) return installationTemplate.replace(CUSTOM_SCRIPTS_LOADER_PLACEHOLDER, customScriptsTemplate).replace("const args = { appConfig };", "const args = { appConfig, customScriptsLoader };");
-	consola.consola.debug("No custom installation steps found, skipping custom-scripts.js generation...");
-	return installationTemplate.replace(CUSTOM_SCRIPTS_LOADER_PLACEHOLDER, "// No custom installation scripts configured");
-}
-/**
-* Generates installation code that imports configured custom scripts.
-* @param template - Custom scripts template content.
-* @param appManifest - App configuration containing custom installation steps.
-* @param projectRoot - Resolved project root used to resolve script paths.
-*/
-async function generateCustomScriptsTemplate(template, appManifest, projectRoot) {
-	if (!require_webhooks.hasCustomInstallationSteps(appManifest)) return null;
-	const installationActionDir = (0, path.join)(projectRoot, getActionsDir(EXTENSIBILITY_EXTENSION_POINT_ID));
-	const customSteps = appManifest.installation.customInstallationSteps;
-	const importStatements = customSteps.map((step, index) => {
-		const absoluteScriptPath = (0, path.join)(projectRoot, step.script);
-		let relativeImportPath = (0, path.relative)(installationActionDir, absoluteScriptPath);
-		if (!relativeImportPath.startsWith(".")) relativeImportPath = `./${relativeImportPath}`;
-		relativeImportPath = relativeImportPath.replace(/\\/g, "/");
-		return `import * as ${`customScript${index}`} from "${relativeImportPath}";`;
-	}).join("\n");
-	const scriptMap = customSteps.map((step, index) => {
-		const entry = `"${step.script}": ${`customScript${index}`},`;
-		return entry.padStart(entry.length + 6);
-	}).join("\n");
-	return template.replace(CUSTOM_IMPORTS_PLACEHOLDER, importStatements).replace(CUSTOM_SCRIPTS_MAP_PLACEHOLDER, scriptMap);
-}
 
-//#endregion
 //#region source/commands/generate/actions/main.ts
 /**
 * Generates extension configs, runtime actions, and Admin UI web source for the configured domains.
@@ -1242,283 +35,27 @@ async function generateCustomScriptsTemplate(template, appManifest, projectRoot)
 * @param projectRoot - Resolved project root where files are generated.
 * @param templatesDir - Directory containing generation templates.
 */
-async function run$8(appManifest, projectRoot, templatesDir = TEMPLATES_DIR) {
-	await prepareRuntimeAppConfigModule(appManifest, projectRoot);
-	const appManagementExtConfig = await updateExtConfig(appManifest, EXTENSIBILITY_EXTENSION_POINT_ID, projectRoot);
-	await generateActionFiles(appManifest, getRuntimeActions(appManagementExtConfig, "app-management"), EXTENSIBILITY_EXTENSION_POINT_ID, templatesDir, projectRoot);
+async function run$2(appManifest, projectRoot, templatesDir = require_web_src.TEMPLATES_DIR) {
+	await require_web_src.prepareRuntimeAppConfigModule(appManifest, projectRoot);
+	const appManagementExtConfig = await require_web_src.updateExtConfig(appManifest, require_web_src.EXTENSIBILITY_EXTENSION_POINT_ID, projectRoot);
+	await require_web_src.generateActionFiles(appManifest, require_web_src.getRuntimeActions(appManagementExtConfig, "app-management"), require_web_src.EXTENSIBILITY_EXTENSION_POINT_ID, templatesDir, projectRoot);
 	if (require_validate.hasBusinessConfigSchema(appManifest)) {
-		const businessConfigExtConfig = await updateExtConfig(appManifest, CONFIGURATION_EXTENSION_POINT_ID, projectRoot);
-		await generateActionFiles(appManifest, getRuntimeActions(businessConfigExtConfig, "business-configuration"), CONFIGURATION_EXTENSION_POINT_ID, templatesDir, projectRoot);
+		const businessConfigExtConfig = await require_web_src.updateExtConfig(appManifest, require_web_src.CONFIGURATION_EXTENSION_POINT_ID, projectRoot);
+		await require_web_src.generateActionFiles(appManifest, require_web_src.getRuntimeActions(businessConfigExtConfig, "business-configuration"), require_web_src.CONFIGURATION_EXTENSION_POINT_ID, templatesDir, projectRoot);
 	}
 	if (require_webhooks.hasBackendUiV2Components(appManifest)) {
-		const extConfig = await updateExtConfig(appManifest, BACKEND_UI_V2_EXTENSION_POINT_ID, projectRoot);
+		const extConfig = await require_web_src.updateExtConfig(appManifest, require_web_src.BACKEND_UI_V2_EXTENSION_POINT_ID, projectRoot);
 		if (extConfig.operations?.view) {
-			await prepareWebSourceImportAlias(extConfig, projectRoot);
-			await generateWebSrc(extConfig, appManifest.metadata.displayName, projectRoot, templatesDir);
+			await require_web_src.prepareWebSourceImportAlias(extConfig, projectRoot);
+			await require_web_src.generateWebSrc(extConfig, appManifest.metadata.displayName, projectRoot, templatesDir);
 		}
 	}
 }
 /** Run the generate actions command */
-async function exec$8() {
-	try {
-		const projectRoot = await require_index_node.getProjectRootDirectory();
-		await run$8(await loadAppManifest(projectRoot), projectRoot);
-	} catch (error) {
-		if (error instanceof _adobe_aio_commerce_lib_core_error.CommerceSdkValidationError) consola.consola.error(error.display());
-		else consola.consola.error(error);
-		process.exit(1);
-	}
-}
-
-//#endregion
-//#region source/commands/generate/manifest/main.ts
-/**
-* Generates or removes the static app manifest as required by the app config.
-* @param appConfig - Validated app configuration to serialize.
-* @param projectRoot - Resolved project root where the manifest is generated.
-*/
-async function run$7(appConfig, projectRoot) {
-	if (await requiresJavaScriptAppConfig(appConfig, projectRoot)) {
-		const stalePath = (0, path.join)(projectRoot, getManifestPath());
-		if (await (0, fs_promises.access)(stalePath).then(() => true, () => false)) {
-			await (0, fs_promises.rm)(stalePath, { force: true });
-			consola.consola.success(`Removed stale ${APP_MANIFEST_FILE}`);
-		}
-		return;
-	}
-	consola.consola.info("Generating app manifest...");
-	const contents = (0, safe_stable_stringify.stringify)(appConfig, null, 2);
-	const outputDir = await require_index_node.makeOutputDirFor(getGeneratedDir(EXTENSIBILITY_EXTENSION_POINT_ID), projectRoot);
-	const manifestPath = (0, path.join)(outputDir, APP_MANIFEST_FILE);
-	await (0, fs_promises.writeFile)(manifestPath, contents, "utf-8");
-	consola.consola.success(`Generated ${APP_MANIFEST_FILE}\n`);
-}
-/** Run the generate manifest command */
-async function exec$7() {
-	try {
-		const projectRoot = await require_index_node.getProjectRootDirectory();
-		await run$7(await loadAppManifest(projectRoot), projectRoot);
-	} catch (error) {
-		if (error instanceof _adobe_aio_commerce_lib_core_error.CommerceSdkValidationError) consola.consola.error(error.display());
-		else consola.consola.error(error);
-		process.exit(1);
-	}
-}
-
-//#endregion
-//#region ../../packages-private/scripting-utils/source/filesystem/helpers.ts
-/**
-* Touch a file, creating it if it doesn't exist.
-* @param filePath The path of the file to touch
-*/
-async function touch(filePath) {
-	await (0, fs_promises.writeFile)(filePath, "", { flag: "wx" }).catch((e) => {
-		if (e.code !== "EEXIST") throw e;
-	});
-}
-
-//#endregion
-//#region source/commands/generate/schema/main.ts
-/**
-* Generates the business configuration schema and prepares encryption when needed.
-* @param appConfig - Validated app configuration containing the schema.
-* @param projectRoot - Resolved project root where schema files are managed.
-*/
-async function run$6(appConfig, projectRoot) {
-	if (!require_validate.hasBusinessConfigSchema(appConfig)) {
-		consola.consola.debug("Business configuration schema not found in application configuration. Nothing to do.");
-		return;
-	}
-	const envPath = (0, path.join)(projectRoot, ".env");
-	await touch(envPath);
-	process.loadEnvFile(envPath);
-	if (appConfig.businessConfig.schema.some((field) => field.type === "password")) {
-		const packageExec = require_index_node.getExecCommand(await require_index_node.detectPackageManager(projectRoot));
-		if ("AIO_COMMERCE_CONFIG_ENCRYPTION_KEY" in process.env && String(process.env.AIO_COMMERCE_CONFIG_ENCRYPTION_KEY).trim().length > 0) (0, child_process.execSync)(`${packageExec} aio-commerce-lib-config encryption validate`);
-		else (0, child_process.execSync)(`${packageExec} aio-commerce-lib-config encryption setup`);
-	}
-	if (hasDynamicAppConfig(appConfig)) {
-		const stalePath = (0, path.join)(projectRoot, getSchemaPath());
-		if (await (0, fs_promises.access)(stalePath).then(() => true, () => false)) {
-			await (0, fs_promises.rm)(stalePath, { force: true });
-			consola.consola.success(`Removed stale ${CONFIG_SCHEMA_FILE_NAME}`);
-		}
-		return;
-	}
-	consola.consola.info("Generating configuration schema...");
-	const outputDir = await require_index_node.makeOutputDirFor(getGeneratedDir(CONFIGURATION_EXTENSION_POINT_ID), projectRoot);
-	const contents = (0, safe_stable_stringify.stringify)(appConfig.businessConfig.schema, null, 2);
-	const schemaPath = (0, path.join)(outputDir, CONFIG_SCHEMA_FILE_NAME);
-	await (0, fs_promises.writeFile)(schemaPath, contents, "utf-8");
-	consola.consola.success(`Generated ${CONFIG_SCHEMA_FILE_NAME}\n`);
-}
-/** Run the generate schema command */
-async function exec$6() {
+async function exec$2() {
 	try {
 		const projectRoot = await require_index_node.getProjectRootDirectory();
-		await run$6(await loadAppManifest(projectRoot), projectRoot);
-	} catch (error) {
-		if (error instanceof _adobe_aio_commerce_lib_core_error.CommerceSdkValidationError) consola.consola.error(error.display());
-		else consola.consola.error(error);
-		process.exit(1);
-	}
-}
-
-//#endregion
-//#region ../../packages-private/scripting-utils/source/aio/auth.ts
-const { context: context$1, getToken } = _adobe_aio_lib_ims.default;
-/** Gets an IMS access token for the current CLI IMS context. */
-async function getUserToken() {
-	const contextName = await context$1.getCurrent() ?? "cli";
-	return getToken(contextName, {});
-}
-
-//#endregion
-//#region ../../packages-private/scripting-utils/source/aio/context.ts
-/**
-* Reads the current App Builder project and Runtime namespace from the local AIO CLI config.
-* @throws If either the project or the runtime namespace is not configured.
-*/
-function getAioProjectContext() {
-	const project = _adobe_aio_lib_core_config.default.get("project");
-	const namespace = _adobe_aio_lib_core_config.default.get("runtime.namespace");
-	if (!(project && namespace)) throw new Error("The current App Builder project and Runtime namespace are required");
-	return {
-		namespace,
-		project
-	};
-}
-/** Reads the configured AIO CLI environment, defaulting to `"prod"`. */
-function getAioCliEnv() {
-	return _adobe_aio_lib_core_config.default.get("cli.env") === "stage" ? "stage" : "prod";
-}
-
-//#endregion
-//#region source/commands/hooks/post-app-deploy/polling.ts
-const POLL_INTERVAL_MS = 1e3;
-const UpgradeStateSchema = valibot.object({
-	failure: valibot.optional(valibot.object({
-		key: valibot.string(),
-		message: valibot.optional(valibot.string())
-	})),
-	id: valibot.string(),
-	status: valibot.picklist([
-		"pending",
-		"in-progress",
-		"succeeded",
-		"failed"
-	])
-});
-/** Reads the latest upgrade state from the installation action. */
-async function getUpgradeState(request) {
-	try {
-		const response = await ky.default.get(request.endpoint, { headers: request.headers });
-		if (response.status === 204) return null;
-		const parsed = valibot.safeParse(UpgradeStateSchema, await response.json());
-		return parsed.success ? parsed.output : null;
-	} catch (error) {
-		consola.consola.debug("Unable to read upgrade status; stopping upgrade polling.", { error });
-		return null;
-	}
-}
-/** Waits for an automatic upgrade when its status remains available. */
-async function waitForAutomaticUpgrade(request) {
-	const state = await getUpgradeState(request);
-	if (!state) return;
-	if (state.status === "succeeded") {
-		consola.consola.success("App upgrade completed.\n");
-		return;
-	}
-	if (state.status === "failed") {
-		const reason = state.failure?.message ?? state.failure?.key ?? "The lifecycle attempt failed";
-		throw new Error(`App upgrade failed: ${reason}`);
-	}
-	consola.consola.start("App upgrade is in progress...");
-	await (0, timers_promises.setTimeout)(POLL_INTERVAL_MS);
-	return waitForAutomaticUpgrade(request);
-}
-
-//#endregion
-//#region source/commands/hooks/post-app-deploy/main.ts
-/** Returns true for a no-op reason defined by the upgrade API contract. */
-function isSkippedReason(reason) {
-	return reason === "already-current" || reason === "not-associated" || reason === "not-installed";
-}
-/** Returns true if the result indicates that the upgrade was skipped. */
-function isSkippedResult(result) {
-	return "skipped" in result;
-}
-/** Invokes the upgrade action. */
-async function createUpgradeRequest() {
-	const { project, namespace } = getAioProjectContext();
-	const token = await getUserToken();
-	const endpoint = `https://${namespace}.adobeioruntime.net/api/v1/web/app-management/installation`;
-	const ioEventsEnv = getAioCliEnv();
-	const ioEventsUrl = ioEventsEnv === "stage" ? "https://events-stage.adobe.io" : "https://events.adobe.io";
-	return {
-		body: {
-			appData: {
-				consumerOrgId: project.org.id,
-				orgName: project.org.name,
-				projectId: project.id,
-				projectName: project.name,
-				projectTitle: project.title,
-				workspaceId: project.workspace.id,
-				workspaceName: project.workspace.name,
-				workspaceTitle: project.workspace.title
-			},
-			ioEventsEnv,
-			ioEventsUrl
-		},
-		endpoint,
-		headers: {
-			Authorization: `Bearer ${token}`,
-			[require_common.INSTALLATION_INVOCATION_SOURCE_HEADER]: require_common.POST_APP_DEPLOY_INVOCATION_SOURCE,
-			"x-gw-ims-org-id": project.org.ims_org_id
-		}
-	};
-}
-/** Invokes the upgrade action. */
-async function invokeAction(request) {
-	consola.consola.debug(`Upgrade endpoint: ${request.endpoint}`);
-	try {
-		return await ky.default.post(request.endpoint, {
-			headers: request.headers,
-			json: request.body
-		}).json();
-	} catch (error) {
-		if (error instanceof ky.HTTPError) {
-			const details = await error.response.json();
-			if (error.response.status === 409 && isSkippedReason(details.reason)) return {
-				reason: details.reason,
-				skipped: true
-			};
-			throw new Error(`Failed to trigger app upgrade (HTTP ${error.response.status}): ${JSON.stringify(details, null, 2)}`, { cause: error });
-		}
-		throw error;
-	}
-}
-/** Invokes the deployed app's upgrade endpoint. */
-async function run$5() {
-	const { upgradeMode } = (await require_index_node.parseCommerceAppConfig()).metadata;
-	consola.consola.log("");
-	consola.consola.start("Checking for app upgrades...");
-	const request = await createUpgradeRequest();
-	const result = await invokeAction(request);
-	if (isSkippedResult(result)) {
-		consola.consola.info(`No upgrade was run: ${result.reason}.\n`);
-		return result;
-	}
-	if (upgradeMode === "manual") consola.consola.success(`You have set ${consola_utils.colors.cyan("metadata.upgradeMode")} to ${consola_utils.colors.cyan("manual")}. The upgrade plan has been created but will not be executed.`);
-	else consola.consola.success(`You have set ${consola_utils.colors.cyan("metadata.upgradeMode")} to ${consola_utils.colors.cyan("auto")}. The upgrade plan has been created. Execution will begin shortly.`);
-	consola.consola.box(["Upgrade plan", JSON.stringify(result.plan, null, 2)].join("\n\n"));
-	if (upgradeMode === "auto") await waitForAutomaticUpgrade(request);
-	return result;
-}
-/** Runs the post-app-deploy hook. */
-async function exec$5() {
-	try {
-		await run$5();
+		await run$2(await require_web_src.loadAppManifest(projectRoot), projectRoot);
 	} catch (error) {
 		if (error instanceof _adobe_aio_commerce_lib_core_error.CommerceSdkValidationError) consola.consola.error(error.display());
 		else consola.consola.error(error);
@@ -1534,192 +71,17 @@ async function exec$5() {
 * @param projectRoot - Resolved project root where artifacts are generated.
 * @param templatesDir - Optional directory containing generation templates.
 */
-async function run$4(appManifest, projectRoot, templatesDir) {
-	await run$8(appManifest, projectRoot, templatesDir);
-	await run$7(appManifest, projectRoot);
-	await run$6(appManifest, projectRoot);
+async function run$1(appManifest, projectRoot, templatesDir) {
+	await run$2(appManifest, projectRoot, templatesDir);
+	await require_web_src.run$1(appManifest, projectRoot);
+	await require_web_src.run(appManifest, projectRoot);
 }
 /** Runs the postinstall hook */
-async function exec$4() {
+async function exec$1() {
 	consola.default.debug("Running lib-app postinstall hook");
 	try {
 		const projectRoot = await require_index_node.getProjectRootDirectory();
-		await run$4(await loadAppManifest(projectRoot), projectRoot);
-	} catch (error) {
-		if (error instanceof _adobe_aio_commerce_lib_core_error.CommerceSdkValidationError) consola.default.error(error.display());
-		else consola.default.error(error);
-		process.exit(1);
-	}
-}
-
-//#endregion
-//#region ../../packages-private/scripting-utils/source/env.ts
-/**
-* This module exports shared environment utilities for the AIO Commerce SDK.
-* @packageDocumentation
-*/
-const { context } = _adobe_aio_lib_ims.default;
-const IMS_KEYS = {
-	client_id: "AIO_COMMERCE_AUTH_IMS_CLIENT_ID",
-	client_secrets: "AIO_COMMERCE_AUTH_IMS_CLIENT_SECRETS",
-	ims_org_id: "AIO_COMMERCE_AUTH_IMS_ORG_ID",
-	scopes: "AIO_COMMERCE_AUTH_IMS_SCOPES",
-	technical_account_email: "AIO_COMMERCE_AUTH_IMS_TECHNICAL_ACCOUNT_EMAIL",
-	technical_account_id: "AIO_COMMERCE_AUTH_IMS_TECHNICAL_ACCOUNT_ID"
-};
-/**
-* Replaces or creates an environment variable in a .env file
-* @param filePath - The path to the .env file
-* @param key - The environment variable key to replace or create
-* @param value - The new value for the environment variable
-*/
-function replaceEnvVar(filePath, key, value) {
-	const envPath = path.default.resolve(filePath);
-	const envLines = (0, fs.readFileSync)(envPath, "utf8").split("\n");
-	const formattedValue = value.includes(" ") ? `"${value}"` : value;
-	let keyExists = false;
-	const updatedLines = envLines.map((line) => {
-		if (line.trim().startsWith("#") || !line.includes("=")) return line;
-		const [currentKey] = line.split("=");
-		if (currentKey === key) {
-			keyExists = true;
-			return `${key}=${formattedValue}`;
-		}
-		return line;
-	});
-	if (!keyExists) updatedLines.push(`${key}=${formattedValue}`);
-	(0, fs.writeFileSync)(envPath, updatedLines.join("\n"), "utf8");
-}
-/**
-* Sets the `NODE_ENV` environment variable in the app `.env` file, so the web
-* bundler (Parcel) ships the matching React build. Creates the `.env` if absent.
-* @param mode - The environment mode to write into `NODE_ENV`.
-* @param projectRoot - Resolved project root containing the `.env` file.
-*/
-function setNodeEnv(mode, projectRoot) {
-	const envPath = path.default.join(projectRoot, ".env");
-	if (!(0, fs.existsSync)(envPath)) (0, fs.writeFileSync)(envPath, "", "utf8");
-	replaceEnvVar(envPath, "NODE_ENV", mode);
-}
-/** Resolves the IMS server to server context from the project workspace credentials. */
-function resolveImsS2SContext() {
-	const [credential] = (_adobe_aio_lib_core_config.default.get("project.workspace.details.credentials") ?? []).filter(({ integration_type }) => integration_type === "oauth_server_to_server").map(({ name }) => name);
-	if (!credential) return Promise.resolve(null);
-	return context.get(credential);
-}
-/**
-* Syncs the IMS credentials environment variables from the configured IMS context in
-* the .env file, in a way that is compatible with `@adobe/aio-commerce-lib-auth`.
-* @param projectRoot - Resolved project root containing the `.env` file.
-*/
-async function syncImsCredentials(projectRoot) {
-	const envPath = path.default.join(projectRoot, ".env");
-	if (!(0, fs.existsSync)(envPath)) return {
-		ok: false,
-		reason: "missing-env"
-	};
-	const envVars = dotenv.default.parse((0, fs.readFileSync)(envPath, "utf8"));
-	const imsContext = await resolveImsS2SContext();
-	if (!imsContext) return {
-		ok: false,
-		reason: "no-ims-context"
-	};
-	const { data } = imsContext;
-	for (const [key, value] of Object.entries(data)) {
-		const oauthKey = IMS_KEYS[key];
-		if (!oauthKey) continue;
-		if (!envVars[oauthKey] || envVars[oauthKey] !== value) replaceEnvVar(envPath, oauthKey, value);
-	}
-	return { ok: true };
-}
-
-//#endregion
-//#region source/commands/hooks/pre-app-build.ts
-/**
-* Runs the pre-app-build hook for the given extension.
-* @param extension - The extension to run the hook for.
-* @param projectRoot - Resolved project root containing extension files.
-* @param templatesDir - Directory containing action templates.
-*/
-async function run$3(extension, projectRoot, templatesDir = TEMPLATES_DIR) {
-	const appManifest = await loadAppManifest(projectRoot);
-	await prepareRuntimeAppConfigModule(appManifest, projectRoot);
-	if (extension === "extensibility/1") {
-		const { doc: extensibilityExtConfig } = await readExtConfig(EXTENSIBILITY_EXTENSION_POINT_ID, projectRoot);
-		await run$7(appManifest, projectRoot);
-		await generateActionFiles(appManifest, getRuntimeActions(extensibilityExtConfig.toJS(), "app-management"), EXTENSIBILITY_EXTENSION_POINT_ID, templatesDir, projectRoot);
-		consola.default.info("Syncing IMS credentials...");
-		await syncImsCredentials(projectRoot);
-		return;
-	}
-	if (extension === "configuration/1") {
-		const { doc: businessConfigExtConfig } = await readExtConfig(CONFIGURATION_EXTENSION_POINT_ID, projectRoot);
-		await run$6(appManifest, projectRoot);
-		await generateActionFiles(appManifest, getRuntimeActions(businessConfigExtConfig.toJS(), "business-configuration"), CONFIGURATION_EXTENSION_POINT_ID, templatesDir, projectRoot);
-		return;
-	}
-	if (extension === "backend-ui/2") {
-		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);
-				await generateWebSrc(extConfig, appManifest.metadata.displayName, projectRoot, templatesDir);
-				await setNodeEnv("production", projectRoot);
-			}
-		}
-		return;
-	}
-	throw new Error(`Unsupported extension: ${extension}`);
-}
-/** Runs the pre-app-build hook */
-async function exec$3() {
-	consola.default.debug("Running lib-app pre-app-build hook");
-	const rawExtension = process.env.EXTENSION;
-	try {
-		if (!rawExtension) throw new Error("EXTENSION environment variable is not set");
-		await run$3(rawExtension, await require_index_node.getProjectRootDirectory());
-	} catch (error) {
-		if (error instanceof _adobe_aio_commerce_lib_core_error.CommerceSdkValidationError) consola.default.error(error.display());
-		else consola.default.error(error);
-		process.exit(1);
-	}
-}
-
-//#endregion
-//#region source/commands/hooks/pre-app-dev.ts
-/**
-* Resets the web build back to development by writing `NODE_ENV` to the project `.env`.
-* @param projectRoot - Resolved project root containing the `.env` file.
-*/
-async function run$2(projectRoot) {
-	await setNodeEnv("development", projectRoot);
-}
-/** Runs the pre-app-dev hook. */
-async function exec$2() {
-	consola.default.debug("Running lib-app pre-app-dev hook");
-	try {
-		await run$2(await require_index_node.getProjectRootDirectory());
-	} catch (error) {
-		if (error instanceof _adobe_aio_commerce_lib_core_error.CommerceSdkValidationError) consola.default.error(error.display());
-		else consola.default.error(error);
-		process.exit(1);
-	}
-}
-
-//#endregion
-//#region source/commands/hooks/pre-app-run.ts
-/**
-* Resets the web build back to development by writing `NODE_ENV` to the project `.env`.
-* @param projectRoot - Resolved project root containing the `.env` file.
-*/
-async function run$1(projectRoot) {
-	await setNodeEnv("development", projectRoot);
-}
-/** Runs the pre-app-run hook. */
-async function exec$1() {
-	consola.default.debug("Running lib-app pre-app-run hook");
-	try {
-		await run$1(await require_index_node.getProjectRootDirectory());
+		await run$1(await require_web_src.loadAppManifest(projectRoot), projectRoot);
 	} catch (error) {
 		if (error instanceof _adobe_aio_commerce_lib_core_error.CommerceSdkValidationError) consola.default.error(error.display());
 		else consola.default.error(error);
@@ -1814,7 +176,7 @@ const DOMAIN_DEFAULTS = {
 * @param flags - The initialization options
 */
 function initFlagsToScaffoldAppAnswers(flags) {
-	const configFile = `${COMMERCE_APP_CONFIG_FILE}.${flags.configFormat}`;
+	const configFile = `${require_web_src.COMMERCE_APP_CONFIG_FILE}.${flags.configFormat}`;
 	return {
 		appName: flags.appName,
 		configFile,
@@ -1872,7 +234,7 @@ async function promptForCommerceAppConfig() {
 		required: true,
 		type: "multiselect"
 	});
-	const configFile = `${COMMERCE_APP_CONFIG_FILE}.${configFormat}`;
+	const configFile = `${require_web_src.COMMERCE_APP_CONFIG_FILE}.${configFormat}`;
 	const domains = new Set(featuresToAdd);
 	consola.default.log("");
 	return {
@@ -1917,28 +279,28 @@ async function getDefaultCommerceAppConfig(cwd, { appName, configFormat, domains
 * @param commentBefore - The comment to add before the extension point include pair.
 */
 async function addExtensionPointToAppConfig(extensionPointId, rootDirectory, commentBefore) {
-	const appConfigPath = (0, path.join)(rootDirectory, APP_CONFIG_FILE);
+	const appConfigPath = (0, path.join)(rootDirectory, require_web_src.APP_CONFIG_FILE);
 	let doc;
-	const includePath = (0, path.relative)(rootDirectory, (0, path.join)(rootDirectory, getExtConfigPath(extensionPointId)));
+	const includePath = (0, path.relative)(rootDirectory, (0, path.join)(rootDirectory, require_web_src.getExtConfigPath(extensionPointId)));
 	try {
-		doc = await readYamlFile(appConfigPath);
+		doc = await require_web_src.readYamlFile(appConfigPath);
 	} catch (error) {
 		const fallbackContent = `extensions:\n  ${extensionPointId}:\n    $include: "${includePath}"`;
-		throw new Error(`Failed to parse ${APP_CONFIG_FILE}. \nPlease add manually: \n\n${fallbackContent}`, { cause: error });
+		throw new Error(`Failed to parse ${require_web_src.APP_CONFIG_FILE}. \nPlease add manually: \n\n${fallbackContent}`, { cause: error });
 	}
 	if (doc.getIn([
 		"extensions",
 		extensionPointId,
 		"$include"
 	]) === includePath) {
-		consola.default.success(`Extension "${extensionPointId}" already configured in ${APP_CONFIG_FILE}`);
+		consola.default.success(`Extension "${extensionPointId}" already configured in ${require_web_src.APP_CONFIG_FILE}`);
 		return;
 	}
-	consola.default.info(`Adding extension "${extensionPointId}" to ${APP_CONFIG_FILE}...`);
-	const extensions = getOrCreateMap(doc, ["extensions"], { onBeforeCreate: (pair) => {
+	consola.default.info(`Adding extension "${extensionPointId}" to ${require_web_src.APP_CONFIG_FILE}...`);
+	const extensions = require_web_src.getOrCreateMap(doc, ["extensions"], { onBeforeCreate: (pair) => {
 		pair.key.spaceBefore = true;
 	} });
-	getOrCreateMap(doc, ["extensions", extensionPointId], { onBeforeCreate: (pair) => {
+	require_web_src.getOrCreateMap(doc, ["extensions", extensionPointId], { onBeforeCreate: (pair) => {
 		pair.key.spaceBefore = extensions.items.length > 0;
 		pair.key.commentBefore = commentBefore;
 	} }).set("$include", includePath);
@@ -1951,23 +313,23 @@ async function addExtensionPointToAppConfig(extensionPointId, rootDirectory, com
 * @param commentBefore - The comment to add before the extension point include pair.
 */
 async function addExtensionPointToInstallYaml(extensionPointId, rootDirectory, commentBefore) {
-	const installYamlPath = (0, path.join)(rootDirectory, INSTALL_YAML_FILE);
+	const installYamlPath = (0, path.join)(rootDirectory, require_web_src.INSTALL_YAML_FILE);
 	let doc;
 	let extensions;
 	try {
-		doc = await readYamlFile(installYamlPath);
-		extensions = getOrCreateSeq(doc, ["extensions"], { onBeforeCreate: (pair) => {
+		doc = await require_web_src.readYamlFile(installYamlPath);
+		extensions = require_web_src.getOrCreateSeq(doc, ["extensions"], { onBeforeCreate: (pair) => {
 			pair.key.spaceBefore = true;
 		} });
 	} catch (error) {
 		const fallbackContent = `\nextensions:\n  - extensionPointId: ${extensionPointId}`;
-		throw new Error(`Failed to parse ${INSTALL_YAML_FILE}. \nPlease add manually: \n\n${fallbackContent}`, { cause: error });
+		throw new Error(`Failed to parse ${require_web_src.INSTALL_YAML_FILE}. \nPlease add manually: \n\n${fallbackContent}`, { cause: error });
 	}
 	if (extensions.items.some((item) => (0, yaml.isMap)(item) && item.get("extensionPointId") === extensionPointId)) {
-		consola.default.success(`Extension "${extensionPointId}" already configured in ${INSTALL_YAML_FILE}`);
+		consola.default.success(`Extension "${extensionPointId}" already configured in ${require_web_src.INSTALL_YAML_FILE}`);
 		return;
 	}
-	consola.default.info(`Adding extension "${extensionPointId}" to ${INSTALL_YAML_FILE}...`);
+	consola.default.info(`Adding extension "${extensionPointId}" to ${require_web_src.INSTALL_YAML_FILE}...`);
 	const extension = doc.createPair("extensionPointId", extensionPointId);
 	extension.key.spaceBefore = extensions.items.length > 0;
 	extension.key.commentBefore = commentBefore;
@@ -1988,17 +350,17 @@ async function ensureCommerceAppConfig(projectRoot, formatConfig = true, flags)
 	if (configFilePath !== null) try {
 		const config = await require_index_node.readCommerceAppConfig(projectRoot);
 		const validatedConfig = require_validate.validateCommerceAppConfig(config);
-		consola.consola.success(`${COMMERCE_APP_CONFIG_FILE} found and is valid. Continuing...`);
+		consola.consola.success(`${require_web_src.COMMERCE_APP_CONFIG_FILE} found and is valid. Continuing...`);
 		return {
 			config: validatedConfig,
 			configFormat: require_index_node.isTypeScriptConfig(configFilePath) ? "ts" : "js",
 			domains: require_validate.getConfigDomains(validatedConfig)
 		};
 	} catch (error) {
-		throw new Error(`${COMMERCE_APP_CONFIG_FILE} is invalid`, { cause: error });
+		throw new Error(`${require_web_src.COMMERCE_APP_CONFIG_FILE} is invalid`, { cause: error });
 	}
 	if (!flags) {
-		consola.consola.warn(`${COMMERCE_APP_CONFIG_FILE} not found.`);
+		consola.consola.warn(`${require_web_src.COMMERCE_APP_CONFIG_FILE} not found.`);
 		if (!await consola.consola.prompt(`Do you want to create a ${"app.commerce.config"} file? (y/n)`, {
 			default: false,
 			initial: true,
@@ -2008,12 +370,12 @@ async function ensureCommerceAppConfig(projectRoot, formatConfig = true, flags)
 	const answers = flags ? initFlagsToScaffoldAppAnswers(flags) : await promptForCommerceAppConfig();
 	try {
 		const configContent = await getDefaultCommerceAppConfig(projectRoot, answers);
-		const path$2 = (0, path.join)(projectRoot, answers.configFile);
+		const path$1 = (0, path.join)(projectRoot, answers.configFile);
 		consola.consola.info(`Creating ${answers.configFile}...`);
 		if (formatConfig) {
-			const formattedConfig = await prettierFormat(configContent, path$2);
-			await (0, fs_promises.writeFile)(path$2, formattedConfig, "utf-8");
-		} else await (0, fs_promises.writeFile)(path$2, configContent, "utf-8");
+			const formattedConfig = await require_web_src.prettierFormat(configContent, path$1);
+			await (0, fs_promises.writeFile)(path$1, formattedConfig, "utf-8");
+		} else await (0, fs_promises.writeFile)(path$1, configContent, "utf-8");
 		const createdConfig = await require_index_node.parseCommerceAppConfig(projectRoot);
 		consola.consola.success(`Created ${answers.configFile}`);
 		return {
@@ -2040,7 +402,7 @@ async function ensurePackageJson(cwd = process.cwd()) {
 			private: true,
 			version: "1.0.0"
 		};
-		await (0, fs_promises.writeFile)((0, path.join)((0, path.resolve)(cwd), PACKAGE_JSON_FILE), JSON.stringify(packageJson, null, 2), "utf-8");
+		await (0, fs_promises.writeFile)((0, path.join)((0, path.resolve)(cwd), require_web_src.PACKAGE_JSON_FILE), JSON.stringify(packageJson, null, 2), "utf-8");
 		consola.consola.success("Wrote package.json");
 	}
 	const projectRoot = await require_index_node.getProjectRootDirectory(cwd);
@@ -2063,18 +425,18 @@ async function writePostinstallHook(execCommand, projectRoot) {
 	if (pkg === null) throw new Error("Could not find package.json.");
 	const existing = pkg.content.scripts?.postinstall;
 	if (existing === postinstallScript || existing?.includes(postinstallScript)) {
-		consola.consola.success(`postinstall script already configured in ${PACKAGE_JSON_FILE}`);
+		consola.consola.success(`postinstall script already configured in ${require_web_src.PACKAGE_JSON_FILE}`);
 		return;
 	}
 	const nextPostinstall = require_index_node.appendCommand(existing, postinstallScript);
-	if (existing) consola.consola.warn(`${PACKAGE_JSON_FILE} already has a postinstall script. Adding a new one...`);
-	else consola.consola.info(`Adding postinstall script to ${PACKAGE_JSON_FILE}...`);
+	if (existing) consola.consola.warn(`${require_web_src.PACKAGE_JSON_FILE} already has a postinstall script. Adding a new one...`);
+	else consola.consola.info(`Adding postinstall script to ${require_web_src.PACKAGE_JSON_FILE}...`);
 	pkg.update({ scripts: {
 		...pkg.content.scripts,
 		postinstall: nextPostinstall
 	} });
 	await pkg.save();
-	consola.consola.success(`Added postinstall script to ${PACKAGE_JSON_FILE}`);
+	consola.consola.success(`Added postinstall script to ${require_web_src.PACKAGE_JSON_FILE}`);
 }
 /**
 * Ensures app.config.yaml references the enabled domain extensions.
@@ -2083,9 +445,9 @@ async function writePostinstallHook(execCommand, projectRoot) {
 * @param projectRoot - Resolved project root containing app.config.yaml.
 */
 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 (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.");
+	if (domains.has("businessConfig.schema")) await addExtensionPointToAppConfig(require_web_src.CONFIGURATION_EXTENSION_POINT_ID, projectRoot, " This extension is required for business configuration. Do not remove.");
+	if (require_webhooks.hasBackendUiV2Components(config)) await addExtensionPointToAppConfig(require_web_src.BACKEND_UI_V2_EXTENSION_POINT_ID, projectRoot, " This extension is required for Admin UI. Do not remove.");
+	await addExtensionPointToAppConfig(require_web_src.EXTENSIBILITY_EXTENSION_POINT_ID, projectRoot, " This extension is required for app management. Do not remove.");
 }
 /**
 * Install the domain-specific dependencies derived from the selected domains.
@@ -2100,7 +462,7 @@ function installDependencies(packageManager, domains, projectRoot) {
 		consola.consola.info("No additional domain dependencies to install.");
 		return;
 	}
-	runInstall(packageManager, packages, projectRoot);
+	require_web_src.runInstall(packageManager, packages, projectRoot);
 }
 /**
 * Generates all project artifacts during initialization.
@@ -2110,9 +472,9 @@ function installDependencies(packageManager, domains, projectRoot) {
 */
 async function runGeneration(appConfig, execCommand, projectRoot) {
 	try {
-		await run$8(appConfig, projectRoot);
-		await run$7(appConfig, projectRoot);
-		await run$6(appConfig, projectRoot);
+		await run$2(appConfig, projectRoot);
+		await require_web_src.run$1(appConfig, projectRoot);
+		await require_web_src.run(appConfig, projectRoot);
 	} catch (error) {
 		throw new Error(`Failed to run generation command. Please run manually: ${execCommand} aio-commerce-lib-app generate all`, { cause: error });
 	}
@@ -2124,14 +486,14 @@ async function runGeneration(appConfig, execCommand, projectRoot) {
 * @param projectRoot - Resolved project root containing install.yaml.
 */
 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 (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.");
+	if (domains.has("businessConfig.schema")) await addExtensionPointToInstallYaml(require_web_src.CONFIGURATION_EXTENSION_POINT_ID, projectRoot, " This extension is required for business configuration. Do not remove.");
+	if (require_webhooks.hasBackendUiV2Components(config)) await addExtensionPointToInstallYaml(require_web_src.BACKEND_UI_V2_EXTENSION_POINT_ID, projectRoot, " This extension is required for Admin UI. Do not remove.");
+	await addExtensionPointToInstallYaml(require_web_src.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`];
+const REQUIRED_DEPENDENCIES = ["@adobe/aio-commerce-sdk", `@adobe/aio-commerce-lib-app@2.0.1-alpha-20260923160203`];
 /**
 * Initializes a Commerce App project.
 * @param flags - Non-interactive initialization answers.
@@ -2141,11 +503,11 @@ async function run(flags, extraOptions) {
 	consola.consola.start("Initializing app...");
 	const cwd = extraOptions?.cwd ?? process.cwd();
 	const { execCommand, packageManager, projectRoot } = await ensurePackageJson(cwd);
-	runInstall(packageManager, REQUIRED_DEPENDENCIES, projectRoot);
+	require_web_src.runInstall(packageManager, REQUIRED_DEPENDENCIES, projectRoot);
 	const { config, domains, configFormat } = await ensureCommerceAppConfig(projectRoot, extraOptions?.formatConfig ?? true, flags);
 	const isTypeScriptProject = configFormat === "ts";
 	installDependencies(packageManager, domains, projectRoot);
-	if (isTypeScriptProject) await scaffoldTypeScriptProject(packageManager, projectRoot);
+	if (isTypeScriptProject) await require_web_src.scaffoldTypeScriptProject(packageManager, projectRoot);
 	const pkg = await require_index_node.loadPackageJson(projectRoot);
 	if (pkg === null) throw new Error("Could not find package.json.");
 	pkg.update({
@@ -2154,7 +516,7 @@ async function run(flags, extraOptions) {
 		version: config.metadata.version
 	});
 	await pkg.save();
-	if (isTypeScriptProject) await syncActionsTypecheckScript(projectRoot);
+	if (isTypeScriptProject) await require_web_src.syncActionsTypecheckScript(projectRoot);
 	await runGeneration(config, execCommand, projectRoot);
 	await ensureAppConfig(domains, config, projectRoot);
 	await ensureInstallYaml(domains, config, projectRoot);
@@ -2204,25 +566,19 @@ Examples:
 `;
 /** Run all generate targets in sequence */
 async function generateAll() {
-	await exec$8();
-	await exec$7();
-	await exec$6();
+	await exec$2();
+	await require_web_src.exec$1();
+	await require_web_src.exec();
 }
 /** Command handlers registry mapping command names to their subcommand handlers */
 const COMMANDS = {
 	generate: {
-		actions: exec$8,
+		actions: exec$2,
 		all: generateAll,
-		manifest: exec$7,
-		schema: exec$6
-	},
-	hooks: {
-		"post-app-deploy": exec$5,
-		postinstall: exec$4,
-		"pre-app-build": exec$3,
-		"pre-app-dev": exec$2,
-		"pre-app-run": exec$1
+		manifest: require_web_src.exec$1,
+		schema: require_web_src.exec
 	},
+	hooks: { postinstall: exec$1 },
 	init: exec
 };
 /**