@adobe/aio-commerce-lib-app 1.3.0 → 1.4.0

package/dist/es/commands/index.mjs

@@ -13,9 +13,9 @@
  * governing permissions and limitations under the License.
  */
 
-import { a as hasCustomInstallationSteps } from "../webhooks-CYo-pqbR.mjs";
-import { c as hasBusinessConfigSchema, i as getConfigDomains, t as validateCommerceAppConfig } from "../validate-CqJdGzyZ.mjs";
-import { a as findNearestPackageJson, c as isESM, i as detectPackageManager, l as makeOutputDirFor, n as readCommerceAppConfig, o as getExecCommand, s as getProjectRootDirectory, t as parseCommerceAppConfig, u as readPackageJson } from "../config-BohwKkQS.mjs";
+import { a as hasCustomInstallationSteps, d as hasAdminUiSdk } from "../webhooks-Dhrkkip7.mjs";
+import { c as hasBusinessConfigSchema, i as getConfigDomains, t as validateCommerceAppConfig } from "../validate-Dn3lLTGj.mjs";
+import { a as getExecCommand, c as isESM, i as detectPackageManager, l as makeOutputDirFor, n as readCommerceAppConfig, o as getInstallCommand, s as getProjectRootDirectory, t as parseCommerceAppConfig, u as readPackageJson } from "../config-DGPFTk6w.mjs";
 import { t as stringifyError } from "../error-DHlYzkbb.mjs";
 import { t as inspect } from "../logging-XIUXDK5T.mjs";
 import { CommerceSdkValidationError } from "@adobe/aio-commerce-lib-core/error";
@@ -23,16 +23,257 @@ import path, { basename, dirname, join, relative, resolve } from "path";
 import { existsSync, readFileSync, writeFileSync } from "fs";
 import { readFile, writeFile } from "fs/promises";
 import consola, { consola as consola$1 } from "consola";
+import * as prettier from "prettier";
 import { fileURLToPath } from "url";
 import { Document, YAMLMap, YAMLSeq, isMap, isSeq, parseDocument } from "yaml";
 import { colorize, formatTree } from "consola/utils";
-import { stringify } from "safe-stable-stringify";
-import { execSync } from "child_process";
+import stringify, { stringify as stringify$1 } from "safe-stable-stringify";
+import { execSync, spawnSync } from "child_process";
 import config from "@adobe/aio-lib-core-config";
 import aioIms from "@adobe/aio-lib-ims";
 import dotenv from "dotenv";
-import * as prettier from "prettier";
+import NpmPackageJson from "@npmcli/package-json";
+
+//#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 SDK. */
+const BACKEND_UI_EXTENSION_POINT_ID = "commerce/backend-ui/1";
+/** The name of the package containing the admin UI SDK generated actions */
+const ADMIN_UI_SDK_PACKAGE_NAME = "admin-ui-sdk";
+/** The path to the directory containing the generated Admin UI SDK actions. */
+const ADMIN_UI_SDK_ACTIONS_PATH = `${GENERATED_PATH}/actions/registration`;
+/** The name of the configuration schema file */
+const APP_MANIFEST_FILE = "app.commerce.manifest.json";
+/** The name of the commerce app configuration file */
+const COMMERCE_APP_CONFIG_FILE = "app.commerce.config";
+/** 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/utils.ts
+/** Format file content using prettier, inferring the parser from the file path. */
+function prettierFormat(content, filepath) {
+	return prettier.format(content, {
+		semi: true,
+		quoteStyle: "double",
+		arrowParens: "always",
+		bracketSameLine: true,
+		bracketSpacing: true,
+		trailingComma: "all",
+		tabWidth: 2,
+		useTabs: false,
+		printWidth: 80,
+		filepath
+	});
+}
+/** Load the app commerce config */
+async function loadAppManifest() {
+	const appConfig = await parseCommerceAppConfig();
+	consola.debug("Loaded app commerce config");
+	return appConfig;
+}
+/**
+* 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 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 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 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 join(getExtensionPointFolderPath(extensionPointId), "ext.config.yaml");
+}
+/**
+* Path to an Admin UI SDK generated actions directory, relative to the project root.
+* @param extensionPointId - The extension point ID, e.g. "commerce/backend-ui/1"
+*/
+function getAdminUiSdkActionsDir(extensionPointId) {
+	return join(getExtensionPointFolderPath(extensionPointId), ADMIN_UI_SDK_ACTIONS_PATH);
+}
+/**
+* Path to the generated Admin UI SDK registration action file, relative to the project root.
+* @param extensionPointId - The extension point ID, e.g. "commerce/backend-ui/1"
+*/
+function getAdminUiSdkRegistrationActionPath(extensionPointId) {
+	return join(getAdminUiSdkActionsDir(extensionPointId), "index.js");
+}
 
+//#endregion
+//#region source/commands/generate/actions/config.ts
+/** 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}}";
+const REGISTRATION_JSON_PLACEHOLDER = "// {{REGISTRATION_JSON}}";
+/**
+* Creates a runtime action configuration.
+* @param actionName - The name of the action.
+* @param options - Optional configuration options.
+*/
+function createActionDefinition(actionName, config = {}, options = {}) {
+	const def = {
+		...options,
+		function: `${GENERATED_ACTIONS_PATH}/${actionName}.js`,
+		web: options.web ?? "yes",
+		runtime: "nodejs:22",
+		annotations: {
+			"require-adobe-auth": true,
+			final: true
+		}
+	};
+	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.
+*/
+function getRuntimeActions(extConfig, dir) {
+	return Object.entries(extConfig.runtimeManifest?.packages?.["app-management"]?.actions ?? {}).map(([name, _]) => ({
+		name,
+		templateFile: join(dir, `${name}.js.template`)
+	}));
+}
+/**
+* Builds the ext.config.yaml configuration for the extensibility extension.
+* @param features - The features that are enabled for the app.
+*/
+function buildAppManagementExtConfig(appConfig) {
+	const features = getConfigDomains(appConfig);
+	const hasPasswordFieldsInSchema = hasBusinessConfigSchema(appConfig) && appConfig.businessConfig.schema.some((field) => field.type === "password");
+	const extConfig = {
+		hooks: { "pre-app-build": "EXTENSION=extensibility/1 $packageExec aio-commerce-lib-app hooks pre-app-build" },
+		operations: { workerProcess: [{
+			type: "action",
+			impl: `${PACKAGE_NAME}/app-config`
+		}] },
+		runtimeManifest: { packages: { [PACKAGE_NAME]: {
+			license: "Apache-2.0",
+			actions: { "app-config": createActionDefinition("app-config") }
+		} } }
+	};
+	if ([
+		"installation.customInstallationSteps",
+		"eventing.commerce",
+		"eventing.external",
+		"webhooks",
+		"adminUiSdk"
+	].some((feature) => features.has(feature))) {
+		extConfig.operations.workerProcess.push({
+			type: "action",
+			impl: `${PACKAGE_NAME}/installation`
+		});
+		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",
+		templateFile: "config.js.template",
+		requiresEncryptionKey: true
+	}, {
+		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) => ({
+			type: "action",
+			impl: `${PACKAGE_NAME}/${action.name}`
+		})) },
+		runtimeManifest: { packages: { [PACKAGE_NAME]: {
+			license: "Apache-2.0",
+			actions: Object.fromEntries(actions.map((action) => [action.name, createActionDefinition(action.name, action)]))
+		} } }
+	};
+}
+/**
+* Builds the ext.config.yaml configuration for the Admin UI SDK backend-ui extension.
+*/
+function buildAdminUiSdkExtConfig() {
+	return {
+		hooks: { "pre-app-build": "EXTENSION=backend-ui/1 $packageExec aio-commerce-lib-app hooks pre-app-build" },
+		operations: { view: [{
+			type: "web",
+			impl: "index.html"
+		}] },
+		web: "web-src",
+		runtimeManifest: { packages: { [ADMIN_UI_SDK_PACKAGE_NAME]: {
+			license: "Apache-2.0",
+			actions: { registration: {
+				function: `${ADMIN_UI_SDK_ACTIONS_PATH}/index.js`,
+				web: "yes",
+				runtime: "nodejs:22",
+				annotations: {
+					"require-adobe-auth": true,
+					final: true
+				}
+			} }
+		} } }
+	};
+}
+
+//#endregion
 //#region ../../packages-private/scripting-utils/source/yaml/helpers.ts
 /**
 * Read a YAML file and return a {@link Document}
@@ -42,7 +283,7 @@ async function readYamlFile(path) {
 	let doc = new Document();
 	if (existsSync(path)) try {
 		doc = parseDocument(await readFile(path, "utf-8"), { keepSourceTokens: true });
-	} catch (_) {
+	} catch {
 		const file = basename(path);
 		throw new Error(`Failed to parse ${file}`);
 	}
@@ -107,16 +348,23 @@ function getOrCreateMap(doc, path, options) {
 */
 async function createOrUpdateExtConfig(path, config, doc) {
 	const extConfigDoc = doc ?? new Document({});
+	if (config.web !== void 0) buildWeb(extConfigDoc, config.web);
 	config.hooks ??= {};
-	config.operations ??= { workerProcess: [] };
 	config.runtimeManifest ??= { packages: {} };
 	await buildHooks(extConfigDoc, config.hooks);
-	buildOperations(extConfigDoc, config.operations);
+	if (config.operations !== void 0) buildOperations(extConfigDoc, config.operations);
 	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
 * @param name - The name of the action
 * @param path - The path where the action is located
@@ -154,20 +402,36 @@ function buildActionDefinition(action) {
 * @param operations - The operations to build
 */
 function buildOperations(extConfig, operations) {
-	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 = [];
 	const ourOps = operations.workerProcess ?? [];
-	workerProcess.items.push(...ourOps.map((op) => {
-		const map = new YAMLMap();
-		map.set("type", op.type);
-		map.set("impl", op.impl);
-		return map;
-	}));
+	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 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 YAMLMap();
+			map.set("type", v.type);
+			map.set("impl", v.impl);
+			return map;
+		}));
+	}
+	const operationsMap = extConfig.getIn(["operations"]);
+	if (operationsMap instanceof YAMLMap && operationsMap.items.length === 0) extConfig.deleteIn(["operations"]);
 }
 /**
 * Build the `runtimeManifest` section of the `ext.config.yaml` file
@@ -231,175 +495,35 @@ async function writeExtConfig(configPath, doc) {
 }
 
 //#endregion
-//#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 configuration schema file */
-const APP_MANIFEST_FILE = "app.commerce.manifest.json";
-/** The name of the commerce app configuration file */
-const COMMERCE_APP_CONFIG_FILE = "app.commerce.config";
-/** 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/utils.ts
-/** Load the app commerce config */
-async function loadAppManifest() {
-	const appConfig = await parseCommerceAppConfig();
-	consola.debug("Loaded app commerce config");
-	return appConfig;
-}
-
-//#endregion
-//#region source/commands/generate/actions/config.ts
-/** 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}}";
-/**
-* Creates a runtime action configuration.
-* @param actionName - The name of the action.
-* @param options - Optional configuration options.
-*/
-function createActionDefinition(actionName, config = {}, options = {}) {
-	const def = {
-		...options,
-		function: `${GENERATED_ACTIONS_PATH}/${actionName}.js`,
-		web: options.web ?? "yes",
-		runtime: "nodejs:22",
-		annotations: {
-			"require-adobe-auth": true,
-			final: true
-		}
-	};
-	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.
-*/
-function getRuntimeActions(extConfig, dir) {
-	return Object.entries(extConfig.runtimeManifest?.packages?.["app-management"]?.actions ?? {}).map(([name, _]) => ({
-		name,
-		templateFile: join(dir, `${name}.js.template`)
-	}));
-}
+//#region source/commands/generate/actions/lib.ts
+const __dirname = dirname(fileURLToPath(import.meta.url));
+/** The path to the action templates directory, sibling to this file. */
+const TEMPLATES_DIR = join(__dirname, "templates");
 /**
-* Builds the ext.config.yaml configuration for the extensibility extension.
-* @param features - The features that are enabled for the app.
+* Read an extension point's ext.config.yaml file and return it as a JS object.
+* @param extensionPointId - The extension point ID to read the config for.
 */
-function buildAppManagementExtConfig(appConfig) {
-	const features = getConfigDomains(appConfig);
-	const hasPasswordFieldsInSchema = hasBusinessConfigSchema(appConfig) && appConfig.businessConfig.schema.some((field) => field.type === "password");
-	const extConfig = {
-		hooks: { "pre-app-build": "EXTENSION=extensibility/1 $packageExec aio-commerce-lib-app hooks pre-app-build" },
-		operations: { workerProcess: [{
-			type: "action",
-			impl: `${PACKAGE_NAME}/app-config`
-		}] },
-		runtimeManifest: { packages: { [PACKAGE_NAME]: {
-			license: "Apache-2.0",
-			actions: { "app-config": createActionDefinition("app-config") }
-		} } }
-	};
-	if ([
-		"installation.customInstallationSteps",
-		"eventing.commerce",
-		"eventing.external"
-	].some((feature) => features.has(feature))) {
-		extConfig.operations.workerProcess.push({
-			type: "action",
-			impl: `${PACKAGE_NAME}/installation`
-		});
-		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",
-		templateFile: "config.js.template",
-		requiresEncryptionKey: true
-	}, {
-		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) => ({
-			type: "action",
-			impl: `${PACKAGE_NAME}/${action.name}`
-		})) },
-		runtimeManifest: { packages: { [PACKAGE_NAME]: {
-			license: "Apache-2.0",
-			actions: Object.fromEntries(actions.map((action) => [action.name, createActionDefinition(action.name, action)]))
-		} } }
-	};
-}
-
-//#endregion
-//#region source/commands/generate/actions/main.ts
-const __dirname = dirname(fileURLToPath(import.meta.url));
-async function run$4(appManifest) {
-	await generateActionFiles(appManifest, getRuntimeActions(await updateExtConfig(appManifest, EXTENSIBILITY_EXTENSION_POINT_ID), "app-management"), EXTENSIBILITY_EXTENSION_POINT_ID);
-	if (hasBusinessConfigSchema(appManifest)) await generateActionFiles(appManifest, getRuntimeActions(await updateExtConfig(appManifest, CONFIGURATION_EXTENSION_POINT_ID), "business-configuration"), CONFIGURATION_EXTENSION_POINT_ID);
-}
-/** Run the generate actions command */
-async function exec$5() {
+async function readExtConfig(extensionPointId) {
+	const extConfigPath = join(await getProjectRootDirectory(), getExtConfigPath(extensionPointId));
 	try {
-		await run$4(await loadAppManifest());
+		return {
+			path: extConfigPath,
+			doc: await readYamlFile(extConfigPath)
+		};
 	} catch (error) {
-		if (error instanceof CommerceSdkValidationError) consola$1.error(error.display());
-		consola$1.error(error);
-		process.exit(1);
+		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"));
 	}
 }
 /** Update the ext.config.yaml file */
 async function updateExtConfig(appConfig, extensionPointId) {
 	consola$1.info(`Updating ext.config.yaml for ${extensionPointId}...`);
-	const extConfigPath = join(await makeOutputDirFor(getExtensionPointFolderPath(extensionPointId)), "ext.config.yaml");
-	const extConfigDoc = await readYamlFile(extConfigPath);
+	await makeOutputDirFor(getExtensionPointFolderPath(extensionPointId));
+	const { path: extConfigPath, doc: extConfigDoc } = await readExtConfig(extensionPointId);
 	let extConfig;
 	switch (extensionPointId) {
 		case EXTENSIBILITY_EXTENSION_POINT_ID:
@@ -408,24 +532,26 @@ async function updateExtConfig(appConfig, extensionPointId) {
 		case CONFIGURATION_EXTENSION_POINT_ID:
 			extConfig = buildBusinessConfigurationExtConfig();
 			break;
-		default: throw new Error(`Unsupported extension point ID: ${extensionPointId}`);
+		case BACKEND_UI_EXTENSION_POINT_ID:
+			extConfig = buildAdminUiSdkExtConfig();
+			break;
 	}
 	await createOrUpdateExtConfig(extConfigPath, extConfig, extConfigDoc);
 	return extConfig;
 }
 /** Generate the action files */
-async function generateActionFiles(appManifest, actions, extensionPointId) {
+async function generateActionFiles(appManifest, actions, extensionPointId, templatesDir) {
 	consola$1.start("Generating runtime actions...");
-	const outputDir = await makeOutputDirFor(join(getExtensionPointFolderPath(extensionPointId), GENERATED_ACTIONS_PATH));
+	await makeOutputDirFor(getActionsDir(extensionPointId));
+	const projectRoot = await getProjectRootDirectory();
 	const outputFiles = [];
-	const templatesDir = join(__dirname, "generate/actions/templates");
 	for (const action of actions) {
 		let template = await readFile(join(templatesDir, action.templateFile), "utf-8");
 		if (action.name === "installation") {
 			const scriptsTemplate = await generateCustomScriptsTemplate(await readFile(join(templatesDir, "app-management", "custom-scripts.js.template"), "utf-8"), appManifest);
 			template = applyCustomScripts(template, scriptsTemplate);
 		}
-		const actionPath = join(outputDir, `${action.name}.js`);
+		const actionPath = join(projectRoot, getActionPath(extensionPointId, action.name));
 		await writeFile(actionPath, template, "utf-8");
 		outputFiles.push(` ${relative(process.cwd(), actionPath)}`);
 	}
@@ -448,7 +574,7 @@ function applyCustomScripts(installationTemplate, customScriptsTemplate) {
 async function generateCustomScriptsTemplate(template, appManifest) {
 	if (!hasCustomInstallationSteps(appManifest)) return null;
 	const projectRoot = await getProjectRootDirectory();
-	const installationActionDir = join(projectRoot, getExtensionPointFolderPath(EXTENSIBILITY_EXTENSION_POINT_ID), GENERATED_ACTIONS_PATH);
+	const installationActionDir = join(projectRoot, getActionsDir(EXTENSIBILITY_EXTENSION_POINT_ID));
 	const customSteps = appManifest.installation.customInstallationSteps;
 	const importStatements = customSteps.map((step, index) => {
 		let relativeImportPath = relative(installationActionDir, join(projectRoot, step.script));
@@ -462,72 +588,128 @@ async function generateCustomScriptsTemplate(template, appManifest) {
 	}).join("\n");
 	return template.replace(CUSTOM_IMPORTS_PLACEHOLDER, importStatements).replace(CUSTOM_SCRIPTS_MAP_PLACEHOLDER, scriptMap);
 }
+/**
+* Generates `registration/index.js` with the Admin UI SDK registration config
+* inlined as a JS object literal.
+* @param appManifest - The validated app config; must satisfy `hasAdminUiSdk`.
+* @param extensionPointId - The extension point ID that owns the registration action.
+* @param templatesDir - The root directory containing the action templates.
+*/
+async function generateRegistrationActionFile(appManifest, extensionPointId, templatesDir = TEMPLATES_DIR) {
+	consola$1.start("Generating Admin UI SDK registration action...");
+	await makeOutputDirFor(getAdminUiSdkActionsDir(extensionPointId));
+	const projectRoot = await getProjectRootDirectory();
+	const template = await readFile(join(templatesDir, "admin-ui-sdk", "registration.js.template"), "utf-8");
+	const { registration } = appManifest.adminUiSdk;
+	const actionPath = join(projectRoot, getAdminUiSdkRegistrationActionPath(extensionPointId));
+	await writeFile(actionPath, await prettierFormat(template.replace(REGISTRATION_JSON_PLACEHOLDER, `const registration = ${stringify(registration)};`), actionPath), "utf-8");
+	consola$1.success(`Generated registration action at ${relative(process.cwd(), actionPath)}`);
+}
+
+//#endregion
+//#region source/commands/generate/actions/main.ts
+/**
+* Runs the generate actions command for the given extension point.
+* @param appManifest - The app manifest, used to determine which actions to generate and their content.
+* @param templatesDir - The directory to load templates from, for testing purposes. Defaults to the generated actions template root.
+*/
+async function run$5(appManifest, templatesDir = TEMPLATES_DIR) {
+	await generateActionFiles(appManifest, getRuntimeActions(await updateExtConfig(appManifest, EXTENSIBILITY_EXTENSION_POINT_ID), "app-management"), EXTENSIBILITY_EXTENSION_POINT_ID, templatesDir);
+	if (hasBusinessConfigSchema(appManifest)) await generateActionFiles(appManifest, getRuntimeActions(await updateExtConfig(appManifest, CONFIGURATION_EXTENSION_POINT_ID), "business-configuration"), CONFIGURATION_EXTENSION_POINT_ID, templatesDir);
+	if (hasAdminUiSdk(appManifest)) {
+		await updateExtConfig(appManifest, BACKEND_UI_EXTENSION_POINT_ID);
+		await generateRegistrationActionFile(appManifest, BACKEND_UI_EXTENSION_POINT_ID, templatesDir);
+	}
+}
+/** Run the generate actions command */
+async function exec$5() {
+	try {
+		await run$5(await loadAppManifest());
+	} catch (error) {
+		if (error instanceof CommerceSdkValidationError) consola$1.error(error.display());
+		else consola$1.error(error);
+		process.exit(1);
+	}
+}
 
 //#endregion
 //#region source/commands/generate/manifest/main.ts
-async function run$3(appConfig) {
+async function run$4(appConfig) {
 	consola$1.info("Generating app manifest...");
-	const contents = stringify(appConfig, null, 2);
-	await writeFile(join(await makeOutputDirFor(`${getExtensionPointFolderPath(EXTENSIBILITY_EXTENSION_POINT_ID)}/.generated`), APP_MANIFEST_FILE), contents, "utf-8");
+	const contents = stringify$1(appConfig, null, 2);
+	await writeFile(join(await makeOutputDirFor(getGeneratedDir(EXTENSIBILITY_EXTENSION_POINT_ID)), APP_MANIFEST_FILE), contents, "utf-8");
 	consola$1.success(`Generated ${APP_MANIFEST_FILE}`);
 }
 /** Run the generate manifest command */
 async function exec$4() {
 	try {
-		await run$3(await loadAppManifest());
+		await run$4(await loadAppManifest());
 	} catch (error) {
 		if (error instanceof CommerceSdkValidationError) consola$1.error(error.display());
-		consola$1.error(error);
+		else consola$1.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 writeFile(filePath, "", { flag: "wx" }).catch((e) => {
+		if (e.code !== "EEXIST") throw e;
+	});
+}
+
 //#endregion
 //#region source/commands/generate/schema/main.ts
-async function run$2(appConfig) {
-	consola$1.info("Generating configuration schema...");
+async function run$3(appConfig) {
 	if (!hasBusinessConfigSchema(appConfig)) {
-		consola$1.warn("Business configuration schema not found");
+		consola$1.debug("Business configuration schema not found in application configuration. Nothing to do.");
 		return;
 	}
-	const projectDir = dirname(await findNearestPackageJson() ?? process.cwd());
+	consola$1.info("Generating configuration schema...");
+	const projectDir = await getProjectRootDirectory();
 	const envPath = join(projectDir, ".env");
+	await touch(envPath);
 	process.loadEnvFile(envPath);
 	if (appConfig.businessConfig.schema.some((field) => field.type === "password")) {
 		const packageExec = getExecCommand(await detectPackageManager(projectDir));
 		if ("AIO_COMMERCE_CONFIG_ENCRYPTION_KEY" in process.env && String(process.env.AIO_COMMERCE_CONFIG_ENCRYPTION_KEY).trim().length > 0) execSync(`${packageExec} aio-commerce-lib-config encryption validate`);
 		else execSync(`${packageExec} aio-commerce-lib-config encryption setup`);
 	}
-	const contents = stringify(appConfig.businessConfig.schema, null, 2);
-	await writeFile(join(await makeOutputDirFor(`${getExtensionPointFolderPath(CONFIGURATION_EXTENSION_POINT_ID)}/.generated`), CONFIG_SCHEMA_FILE_NAME), contents, "utf-8");
+	const contents = stringify$1(appConfig.businessConfig.schema, null, 2);
+	await writeFile(join(await makeOutputDirFor(getGeneratedDir(CONFIGURATION_EXTENSION_POINT_ID)), CONFIG_SCHEMA_FILE_NAME), contents, "utf-8");
 	consola$1.success(`Generated ${CONFIG_SCHEMA_FILE_NAME}`);
 }
-/** Run the generate manifest command */
+/** Run the generate schema command */
 async function exec$3() {
 	try {
-		await run$2(await loadAppManifest());
+		await run$3(await loadAppManifest());
 	} catch (error) {
 		if (error instanceof CommerceSdkValidationError) consola$1.error(error.display());
-		consola$1.error(error);
+		else consola$1.error(error);
 		process.exit(1);
 	}
 }
 
 //#endregion
 //#region source/commands/hooks/postinstall.ts
-async function run$1(appManifest) {
+async function run$2(appManifest, templatesDir) {
+	await run$5(appManifest, templatesDir);
 	await run$4(appManifest);
 	await run$3(appManifest);
-	await run$2(appManifest);
 }
 /** Runs the postinstall hook */
 async function exec$2() {
 	consola.debug("Running lib-app postinstall hook");
 	try {
-		await run$1(await loadAppManifest());
+		await run$2(await loadAppManifest());
 	} catch (error) {
 		if (error instanceof CommerceSdkValidationError) consola.error(error.display());
-		consola.error(error);
+		else consola.error(error);
 		process.exit(1);
 	}
 }
@@ -583,19 +765,27 @@ function resolveImsS2SContext() {
 }
 /**
 * 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`
+* the .env file, in a way that is compatible with `@adobe/aio-commerce-lib-auth`.
 */
 async function syncImsCredentials() {
 	const envPath = resolveEnvPath();
+	if (!existsSync(envPath)) return {
+		ok: false,
+		reason: "missing-env"
+	};
 	const envVars = dotenv.parse(readFileSync(envPath, "utf8"));
 	const imsContext = await resolveImsS2SContext();
-	if (!imsContext) return;
+	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
@@ -603,17 +793,26 @@ async function syncImsCredentials() {
 /**
 * Runs the pre-app-build hook for the given extension.
 * @param extension - The extension to run the hook for.
+* @param templatesDir - The directory to load templates from, for testing purposes. Defaults to the generated actions template root.
 */
-async function run(extension) {
+async function run$1(extension, templatesDir = TEMPLATES_DIR) {
 	const appManifest = await loadAppManifest();
 	if (extension === "extensibility/1") {
-		await run$3(appManifest);
+		const { doc: extensibilityExtConfig } = await readExtConfig(EXTENSIBILITY_EXTENSION_POINT_ID);
+		await run$4(appManifest);
+		await generateActionFiles(appManifest, getRuntimeActions(extensibilityExtConfig.toJS(), "app-management"), EXTENSIBILITY_EXTENSION_POINT_ID, templatesDir);
 		consola.info("Syncing IMS credentials...");
 		await syncImsCredentials();
 		return;
 	}
 	if (extension === "configuration/1") {
-		await run$2(appManifest);
+		const { doc: businessConfigExtConfig } = await readExtConfig(CONFIGURATION_EXTENSION_POINT_ID);
+		await run$3(appManifest);
+		await generateActionFiles(appManifest, getRuntimeActions(businessConfigExtConfig.toJS(), "business-configuration"), CONFIGURATION_EXTENSION_POINT_ID, templatesDir);
+		return;
+	}
+	if (extension === "backend-ui/1") {
+		if (hasAdminUiSdk(appManifest)) await generateRegistrationActionFile(appManifest, BACKEND_UI_EXTENSION_POINT_ID);
 		return;
 	}
 	throw new Error(`Unsupported extension: ${extension}`);
@@ -624,10 +823,10 @@ async function exec$1() {
 	const extension = process.env.EXTENSION;
 	try {
 		if (!extension) throw new Error("EXTENSION environment variable is not set");
-		await run(extension);
+		await run$1(extension);
 	} catch (error) {
 		if (error instanceof CommerceSdkValidationError) consola.error(error.display());
-		consola.error(error);
+		else consola.error(error);
 		process.exit(1);
 	}
 }
@@ -662,7 +861,7 @@ const DOMAIN_DEFAULTS = {
 		},
 		events: [{
 			name: "plugin.sample_event",
-			fields: [],
+			fields: [{ name: "*" }],
 			label: "Sample Event",
 			description: "Use case description for the event.",
 			runtimeActions: ["my-package/handle-sample-event"]
@@ -684,12 +883,50 @@ const DOMAIN_DEFAULTS = {
 		name: "sample-step",
 		description: "Use case description for the step.",
 		script: "./path/to/script.js"
+	}],
+	webhooks: [{
+		label: "Sample Webhook",
+		description: "A sample Commerce Webhook handler.",
+		runtimeAction: "my-package/handle-webhook",
+		category: "modification",
+		webhook: {
+			webhook_method: "plugin.sample.event",
+			webhook_type: "after",
+			batch_name: "my_app",
+			hook_name: "sample_hook",
+			method: "POST"
+		}
+	}, {
+		label: "Sample Webhook with URL",
+		description: "A sample Commerce Webhook handler using an explicit URL.",
+		category: "modification",
+		webhook: {
+			webhook_method: "plugin.sample.event",
+			webhook_type: "after",
+			batch_name: "my_app",
+			hook_name: "sample_hook_url",
+			method: "POST",
+			url: "https://example.com/webhook"
+		}
 	}]
 };
 
 //#endregion
 //#region source/commands/init/utils.ts
-/** Prompt the user to scaffold a new Commerce App configuration. */
+/**
+* Convert the given init options to answers for scaffolding the app config. This is useful for non-interactive use cases, such as running the command with a config file or from another script.
+* @param flags - The initialization options
+*/
+function initFlagsToScaffoldAppAnswers(flags) {
+	const configFile = `${COMMERCE_APP_CONFIG_FILE}.${flags.configFormat}`;
+	return {
+		appName: flags.appName,
+		configFile,
+		configFormat: flags.configFormat,
+		domains: new Set(flags.domains)
+	};
+}
+/** Prompt the user to scaffold a new Commerce App configuration. When options are provided, prompts are skipped. */
 async function promptForCommerceAppConfig() {
 	const configFormat = await consola.prompt("What format do you want to use for the config file?", {
 		type: "select",
@@ -725,6 +962,10 @@ async function promptForCommerceAppConfig() {
 				label: "Commerce Events",
 				value: "eventing.commerce"
 			},
+			{
+				label: "Commerce Webhooks",
+				value: "webhooks"
+			},
 			{
 				label: "External Events",
 				value: "eventing.external"
@@ -735,10 +976,13 @@ async function promptForCommerceAppConfig() {
 			}
 		]
 	});
+	const configFile = `${COMMERCE_APP_CONFIG_FILE}.${configFormat}`;
+	const domains = new Set(featuresToAdd);
+	consola.log("");
 	return {
 		appName,
-		configFile: `${COMMERCE_APP_CONFIG_FILE}.${configFormat}`,
-		domains: new Set(featuresToAdd),
+		configFile,
+		domains,
 		configFormat
 	};
 }
@@ -763,6 +1007,7 @@ async function getDefaultCommerceAppConfig(cwd, { appName, configFormat, domains
 		external: DOMAIN_DEFAULTS["eventing.external"]
 	};
 	if (domains.has("installation.customInstallationSteps")) defaultConfig.installation = { customInstallationSteps: DOMAIN_DEFAULTS["installation.customInstallationSteps"] };
+	if (domains.has("webhooks")) defaultConfig.webhooks = DOMAIN_DEFAULTS.webhooks;
 	return [
 		importStatement,
 		"",
@@ -777,9 +1022,8 @@ async function getDefaultCommerceAppConfig(cwd, { appName, configFormat, domains
 */
 async function addExtensionPointToAppConfig(extensionPointId, rootDirectory, commentBefore) {
 	const appConfigPath = join(rootDirectory, APP_CONFIG_FILE);
-	const extensionPointFolderPath = join(rootDirectory, getExtensionPointFolderPath(extensionPointId));
 	let doc;
-	const includePath = relative(rootDirectory, join(extensionPointFolderPath, "ext.config.yaml"));
+	const includePath = relative(rootDirectory, join(rootDirectory, getExtConfigPath(extensionPointId)));
 	try {
 		doc = await readYamlFile(appConfigPath);
 	} catch (error) {
@@ -837,12 +1081,12 @@ async function addExtensionPointToInstallYaml(extensionPointId, rootDirectory, c
 
 //#endregion
 //#region source/commands/init/lib.ts
-/** Ensure app.commerce.config file exists, allow creating if it doesn't */
-async function ensureCommerceAppConfig(cwd = process.cwd()) {
+/** Ensure app.commerce.config file exists, allow creating if it doesn't. When options are provided, prompts are skipped. */
+async function ensureCommerceAppConfig(cwd = process.cwd(), formatConfig = true, flags) {
 	let config = null;
 	try {
 		config = await readCommerceAppConfig(cwd);
-	} catch (_) {}
+	} catch {}
 	if (config) try {
 		const validatedConfig = validateCommerceAppConfig(config);
 		consola$1.success(`${COMMERCE_APP_CONFIG_FILE} found and is valid. Continuing...`);
@@ -853,119 +1097,126 @@ async function ensureCommerceAppConfig(cwd = process.cwd()) {
 	} catch (error) {
 		throw new Error(`${COMMERCE_APP_CONFIG_FILE} is invalid`, { cause: error });
 	}
-	consola$1.warn(`${COMMERCE_APP_CONFIG_FILE} not found.`);
-	if (!await consola$1.prompt(`Do you want to create a ${"app.commerce.config"} file? (y/n)`, {
-		type: "confirm",
-		initial: true,
-		default: false
-	})) throw new Error("Initialization cancelled.");
-	const answers = await promptForCommerceAppConfig();
+	if (!flags) {
+		consola$1.warn(`${COMMERCE_APP_CONFIG_FILE} not found.`);
+		if (!await consola$1.prompt(`Do you want to create a ${"app.commerce.config"} file? (y/n)`, {
+			type: "confirm",
+			initial: true,
+			default: false
+		})) throw new Error("Initialization cancelled.");
+	}
+	const answers = flags ? initFlagsToScaffoldAppAnswers(flags) : await promptForCommerceAppConfig();
 	try {
 		const configContent = await getDefaultCommerceAppConfig(cwd, answers);
-		consola$1.info(`Creating ${answers.configFile}...`);
 		const path = join(await getProjectRootDirectory(cwd), answers.configFile);
-		await writeFile(path, await prettier.format(configContent, {
-			semi: true,
-			quoteStyle: "double",
-			arrowParens: "always",
-			bracketSameLine: true,
-			bracketSpacing: true,
-			trailingComma: "all",
-			tabWidth: 2,
-			useTabs: false,
-			printWidth: 80,
-			filepath: path
-		}), "utf-8");
+		consola$1.info(`Creating ${answers.configFile}...`);
+		if (formatConfig) await writeFile(path, await prettierFormat(configContent, path), "utf-8");
+		else await writeFile(path, configContent, "utf-8");
+		const config = await parseCommerceAppConfig(cwd);
 		consola$1.success(`Created ${answers.configFile}`);
 		return {
-			config: await parseCommerceAppConfig(cwd),
+			config,
 			domains: answers.domains
 		};
 	} catch (error) {
 		throw new Error(`Failed to create ${answers.configFile}`, { cause: error });
 	}
 }
-/** Ensure package.json has the postinstall script */
+/**
+* Ensure a package.json exists and detect the package manager.
+* @param cwd - Directory to check; defaults to `process.cwd()`
+*/
 async function ensurePackageJson(cwd = process.cwd()) {
-	const packageJson = await readPackageJson(cwd);
-	if (!packageJson) {
+	const existing = await readPackageJson(cwd);
+	let packageJson;
+	if (existing) packageJson = existing;
+	else {
 		consola$1.warn("package.json not found. Creating one...");
-		const packageJsonContent = {
+		packageJson = {
 			name: "my-commerce-app",
 			version: "1.0.0",
-			private: true,
-			scripts: { postinstall: "npx aio-commerce-lib-app hooks postinstall" }
+			private: true
 		};
-		await writeFile(join(resolve(cwd), PACKAGE_JSON_FILE), JSON.stringify(packageJsonContent, null, 2), "utf-8");
+		await writeFile(join(resolve(cwd), PACKAGE_JSON_FILE), JSON.stringify(packageJson, null, 2), "utf-8");
 		consola$1.success("Wrote package.json");
-		return {
-			packageJson: packageJsonContent,
-			packageManager: "npm",
-			execCommand: "npx"
-		};
 	}
-	const packageManager = await detectPackageManager();
+	const packageManager = await detectPackageManager(cwd);
 	const execCommand = getExecCommand(packageManager);
-	const postinstallScript = `${execCommand} aio-commerce-lib-app hooks postinstall`;
-	packageJson.scripts ??= {};
-	if (packageJson.scripts.postinstall === postinstallScript || packageJson.scripts.postinstall?.includes(postinstallScript)) {
-		consola$1.success(`postinstall script already configured in ${PACKAGE_JSON_FILE}`);
-		return {
-			packageJson,
-			packageManager,
-			execCommand
-		};
-	}
-	if (packageJson.scripts.postinstall) {
-		consola$1.warn(`${PACKAGE_JSON_FILE} already has a postinstall script. Adding a new one...`);
-		execSync(`npm pkg set scripts.postinstall="${`${packageJson.scripts.postinstall} && ${postinstallScript}`}"`);
-	} else {
-		consola$1.info(`Adding postinstall script to ${PACKAGE_JSON_FILE}...`);
-		execSync(`npm pkg set scripts.postinstall="${postinstallScript}"`);
-	}
-	consola$1.success(`Added postinstall script to ${PACKAGE_JSON_FILE}`);
 	return {
 		packageJson,
 		packageManager,
 		execCommand
 	};
 }
+/**
+* Register the `hooks postinstall` script in package.json.
+* @param execCommand - Prefix for running local binaries (e.g. `pnpm exec`, `npx`)
+* @param cwd - Directory containing the package.json to update
+*/
+async function writePostinstallHook(execCommand, cwd = process.cwd()) {
+	const postinstallScript = `${execCommand} aio-commerce-lib-app hooks postinstall`;
+	const pkg = await NpmPackageJson.load(cwd);
+	const existing = pkg.content.scripts?.postinstall;
+	if (existing === postinstallScript || existing?.includes(postinstallScript)) {
+		consola$1.success(`postinstall script already configured in ${PACKAGE_JSON_FILE}`);
+		return;
+	}
+	const nextPostinstall = existing ? `${existing} && ${postinstallScript}` : postinstallScript;
+	if (existing) consola$1.warn(`${PACKAGE_JSON_FILE} already has a postinstall script. Adding a new one...`);
+	else consola$1.info(`Adding postinstall script to ${PACKAGE_JSON_FILE}...`);
+	pkg.update({ scripts: {
+		...pkg.content.scripts,
+		postinstall: nextPostinstall
+	} });
+	await pkg.save();
+	consola$1.success(`Added postinstall script to ${PACKAGE_JSON_FILE}`);
+}
 /** Ensure app.config.yaml has the extension reference */
 async function ensureAppConfig(domains, cwd = process.cwd()) {
 	const rootDirectory = await getProjectRootDirectory(cwd);
 	if (domains.has("businessConfig.schema")) await addExtensionPointToAppConfig(CONFIGURATION_EXTENSION_POINT_ID, rootDirectory, " This extension is required for business configuration. Do not remove.");
+	if (domains.has("adminUiSdk")) await addExtensionPointToAppConfig(BACKEND_UI_EXTENSION_POINT_ID, rootDirectory, " This extension is required for Admin UI SDK. Do not remove.");
 	await addExtensionPointToAppConfig(EXTENSIBILITY_EXTENSION_POINT_ID, rootDirectory, " This extension is required for app management. Do not remove.");
 }
-/** Install the given dependencies */
+/**
+* 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
+*/
 function runInstall(packageManager, dependencies, cwd = process.cwd()) {
+	if (dependencies.length === 0) return;
 	const dependencyListString = dependencies.map((dependency) => `  - ${dependency}`).join("\n");
-	consola$1.info(`Installing the following dependencies with ${packageManager}:\n${dependencyListString}`);
-	const packagesToInstall = dependencies.join(" ");
-	const installCommand = {
-		pnpm: `pnpm add ${packagesToInstall}`,
-		yarn: `yarn add ${packagesToInstall}`,
-		bun: `bun add ${packagesToInstall}`,
-		npm: `npm install ${packagesToInstall}`
-	}[packageManager];
-	try {
-		execSync(installCommand, {
-			cwd,
-			stdio: "inherit"
-		});
-		consola$1.success("Dependencies installed successfully");
-	} catch (error) {
-		throw new Error(`Failed to install dependencies automatically. Please install manually: ${installCommand}`, { cause: error });
-	}
+	consola$1.start([`Installing the following dependencies with ${packageManager}:\n${dependencyListString}\n`, "This may take a few seconds...\n"].join("\n"));
+	const { command, args } = getInstallCommand(packageManager, dependencies);
+	const displayCommand = [command, ...args].join(" ");
+	const result = 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$1.log("");
+	consola$1.success("Dependencies installed successfully");
 }
-/** Install required dependencies */
+/**
+* Install the domain-specific dependencies derived from the selected domains.
+* @param packageManager - The detected package manager
+* @param domains - Domains enabled in the commerce app config
+* @param cwd - Working directory for the install command
+*/
 function installDependencies(packageManager, domains, cwd = process.cwd()) {
 	const packages = [];
-	if (domains.has("businessConfig.schema")) packages.push("@adobe/aio-commerce-lib-config");
+	if (domains.has("businessConfig.schema")) packages.push(`@adobe/aio-commerce-lib-config@^1.3.0`);
+	if (packages.length === 0) {
+		consola$1.info("No additional domain dependencies to install.");
+		return;
+	}
 	runInstall(packageManager, packages, cwd);
 }
 /** Run the generation command */
 async function runGeneration(appConfig, execCommand) {
 	try {
+		await run$5(appConfig);
 		await run$4(appConfig);
 		await run$3(appConfig);
 	} catch (error) {
@@ -976,35 +1227,45 @@ async function runGeneration(appConfig, execCommand) {
 async function ensureInstallYaml(domains, cwd = process.cwd()) {
 	const rootDirectory = await getProjectRootDirectory(cwd);
 	if (domains.has("businessConfig.schema")) await addExtensionPointToInstallYaml(CONFIGURATION_EXTENSION_POINT_ID, rootDirectory, " This extension is required for business configuration. Do not remove.");
+	if (domains.has("adminUiSdk")) await addExtensionPointToInstallYaml(BACKEND_UI_EXTENSION_POINT_ID, rootDirectory, " This extension is required for Admin UI SDK. Do not remove.");
 	await addExtensionPointToInstallYaml(EXTENSIBILITY_EXTENSION_POINT_ID, rootDirectory, " This extension is required for app management. Do not remove.");
 }
 
 //#endregion
 //#region source/commands/init/main.ts
-const REQUIRED_DEPENDENCIES = ["@adobe/aio-commerce-lib-app", "@adobe/aio-commerce-sdk"];
-/** Initialize the project with @adobe/aio-commerce-lib-config */
+const REQUIRED_DEPENDENCIES = ["@adobe/aio-commerce-sdk", `@adobe/aio-commerce-lib-app@1.4.0`];
+/** Initialize the project */
+async function run(flags, extraOptions) {
+	consola$1.start("Initializing app...");
+	const { execCommand, packageManager } = await ensurePackageJson();
+	runInstall(packageManager, REQUIRED_DEPENDENCIES);
+	const { config, domains } = await ensureCommerceAppConfig(process.cwd(), extraOptions?.formatConfig ?? true, flags);
+	installDependencies(packageManager, domains);
+	const pkg = await NpmPackageJson.load(process.cwd());
+	pkg.update({
+		name: config.metadata.id,
+		version: config.metadata.version,
+		description: config.metadata.description
+	});
+	await pkg.save();
+	await runGeneration(config, execCommand);
+	await ensureAppConfig(domains);
+	await ensureInstallYaml(domains);
+	await writePostinstallHook(execCommand);
+	consola$1.success("Initialization complete!");
+	consola$1.box([
+		"Next steps:",
+		"  - Review and customize app.commerce.config.*",
+		"  - Build and deploy your app"
+	].join("\n"));
+}
+/** Run the init command */
 async function exec() {
 	try {
-		consola$1.start("Initializing app...");
-		const { execCommand, packageManager } = await ensurePackageJson();
-		runInstall(packageManager, REQUIRED_DEPENDENCIES);
-		const { config, domains } = await ensureCommerceAppConfig();
-		installDependencies(packageManager, domains);
-		execSync(`npm pkg set name="${config.metadata.id}"`);
-		execSync(`npm pkg set version="${config.metadata.version}"`);
-		execSync(`npm pkg set description="${config.metadata.description}"`);
-		await runGeneration(config, execCommand);
-		await ensureAppConfig(domains);
-		await ensureInstallYaml(domains);
-		consola$1.success("Initialization complete!");
-		consola$1.box([
-			"Next steps:",
-			"  - Review and customize app.commerce.config.*",
-			"  - Build and deploy your app"
-		].join("\n"));
+		await run();
 	} catch (error) {
 		if (error instanceof CommerceSdkValidationError) consola$1.error(error.display());
-		consola$1.error(error);
+		else consola$1.error(error);
 		process.exit(1);
 	}
 }