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

package/dist/cjs/{webhooks-Bcq2Qy7q.cjs → webhooks-zXjrg32x.cjs}

@@ -20,6 +20,60 @@ let _adobe_aio_commerce_lib_admin_ui_api = require("@adobe/aio-commerce-lib-admi
 let _adobe_aio_commerce_lib_admin_ui_menu = require("@adobe/aio-commerce-lib-admin-ui/menu");
 let _adobe_aio_commerce_lib_core_commerce = require("@adobe/aio-commerce-lib-core/commerce");
 
+//#region source/config/schema/installation.ts
+const MAX_DESCRIPTION_LENGTH$1 = 255;
+const MAX_NAME_LENGTH = 255;
+const MAX_MESSAGE_LENGTH = 1e3;
+/**
+* Regex for script paths that can be relative or absolute.
+* Must end with a .js or .ts extension
+* Examples:
+*   - "./scripts/setup.js"
+*   - "./setup.ts"
+*   - "../../scripts/setup.js"
+*/
+const SCRIPT_PATH_REGEX = /^(?:\.{0,2}\/)*(?:[\w-]+\/)*[\w-]+\.(?:js|ts)$/;
+/**
+* Schema for custom installation step configuration
+*/
+const CustomInstallationStepSchema = valibot.object({
+	description: valibot.pipe(require_schemas.nonEmptyStringValueSchema("step description"), valibot.maxLength(MAX_DESCRIPTION_LENGTH$1, `The step description must not be longer than ${MAX_DESCRIPTION_LENGTH$1} characters`)),
+	name: valibot.pipe(require_schemas.nonEmptyStringValueSchema("step name"), valibot.maxLength(MAX_NAME_LENGTH, `The step name must not be longer than ${MAX_NAME_LENGTH} characters`)),
+	script: valibot.pipe(require_schemas.nonEmptyStringValueSchema("script path"), valibot.regex(SCRIPT_PATH_REGEX, "Script path must end with .js or .ts (e.g., \"./setup.js\", \"./scripts/setup.ts\", or \"../../scripts/setup.js\")"))
+});
+/**
+* Schema for installation messages configuration
+*/
+const MessagesSchema = valibot.object({
+	postInstallation: valibot.optional(valibot.pipe(require_schemas.nonEmptyStringValueSchema("postInstallation message"), valibot.maxLength(MAX_MESSAGE_LENGTH, `The postInstallation message must not be longer than ${MAX_MESSAGE_LENGTH} characters`))),
+	preInstallation: valibot.optional(valibot.pipe(require_schemas.nonEmptyStringValueSchema("preInstallation message"), valibot.maxLength(MAX_MESSAGE_LENGTH, `The preInstallation message must not be longer than ${MAX_MESSAGE_LENGTH} characters`)))
+});
+/**
+* Schema for installation configuration
+*/
+const InstallationSchema = valibot.object({
+	customInstallationSteps: valibot.pipe(valibot.optional(valibot.array(CustomInstallationStepSchema, "Expected an array of custom installation steps")), valibot.check((input) => {
+		const steps = input || [];
+		return new Set(steps.map((step) => step.name)).size === steps.length;
+	}, "Duplicate step names detected in custom installation steps. Each step must have a unique name.")),
+	messages: valibot.optional(MessagesSchema)
+});
+/**
+* Check if config has custom installation settings.
+* @param config - The configuration to check.
+*/
+function hasCustomInstallation(config) {
+	return config.installation !== void 0;
+}
+/**
+* Check if config has custom installation steps.
+* @param config - The configuration to check.
+*/
+function hasCustomInstallationSteps(config) {
+	return Array.isArray(config?.installation?.customInstallationSteps) && config.installation.customInstallationSteps.length > 0;
+}
+
+//#endregion
 //#region source/config/schema/admin-ui.ts
 /**
 * Whether the given items have distinct ids once Commerce sanitizes them into resource ids.
@@ -229,7 +283,7 @@ function hasAdminUi(config) {
 
 //#endregion
 //#region source/config/schema/eventing.ts
-const MAX_DESCRIPTION_LENGTH$1 = 255;
+const MAX_DESCRIPTION_LENGTH = 255;
 const MAX_LABEL_LENGTH = 100;
 const MAX_KEY_LENGTH = 50;
 const MAX_EVENT_NAME_LENGTH = 180;
@@ -298,13 +352,13 @@ function commerceEventFieldSchema() {
 }
 /** Schema for event provider configuration */
 const ProviderSchema = valibot.object({
-	description: valibot.pipe(require_schemas.nonEmptyStringValueSchema("provider description"), ioEventsTextSchema("Provider description"), valibot.maxLength(MAX_DESCRIPTION_LENGTH$1, `The provider description must not be longer than ${MAX_DESCRIPTION_LENGTH$1} characters`)),
+	description: valibot.pipe(require_schemas.nonEmptyStringValueSchema("provider description"), ioEventsTextSchema("Provider description"), valibot.maxLength(MAX_DESCRIPTION_LENGTH, `The provider description must not be longer than ${MAX_DESCRIPTION_LENGTH} characters`)),
 	key: valibot.optional(valibot.pipe(require_schemas.alphaNumericOrHyphenSchema("provider key"), valibot.maxLength(MAX_KEY_LENGTH, `The provider key must not be longer than ${MAX_KEY_LENGTH} characters`))),
 	label: valibot.pipe(require_schemas.nonEmptyStringValueSchema("provider label"), ioEventsTextSchema("Provider label"), valibot.maxLength(MAX_LABEL_LENGTH, `The provider label must not be longer than ${MAX_LABEL_LENGTH} characters`))
 });
 /** Schema for base shared properties between event types. */
 const BaseEventSchema = valibot.object({
-	description: valibot.pipe(require_schemas.nonEmptyStringValueSchema("event description"), ioEventsTextSchema("Event description"), valibot.maxLength(MAX_DESCRIPTION_LENGTH$1, `The event description must not be longer than ${MAX_DESCRIPTION_LENGTH$1} characters`)),
+	description: valibot.pipe(require_schemas.nonEmptyStringValueSchema("event description"), ioEventsTextSchema("Event description"), valibot.maxLength(MAX_DESCRIPTION_LENGTH, `The event description must not be longer than ${MAX_DESCRIPTION_LENGTH} characters`)),
 	env: valibot.optional(_adobe_aio_commerce_lib_core_commerce.CommerceEnvArraySchema),
 	label: valibot.pipe(require_schemas.nonEmptyStringValueSchema("event label"), ioEventsTextSchema("Event label"), valibot.maxLength(MAX_LABEL_LENGTH, `The event label must not be longer than ${MAX_LABEL_LENGTH} characters`)),
 	runtimeActions: valibot.array(valibot.pipe(require_schemas.nonEmptyStringValueSchema("runtime action"), valibot.regex(/^[a-z0-9-]+\/[a-z0-9-]+$/i, "Runtime action must be in the format \"<package>/<action>\" (e.g., \"my-package/my-action\")")), "Expected an array of runtime actions in the format <package>/<action>")
@@ -382,60 +436,6 @@ function hasEventing(config) {
 	return config.eventing !== void 0;
 }
 
-//#endregion
-//#region source/config/schema/installation.ts
-const MAX_DESCRIPTION_LENGTH = 255;
-const MAX_NAME_LENGTH = 255;
-const MAX_MESSAGE_LENGTH = 1e3;
-/**
-* Regex for script paths that can be relative or absolute.
-* Must end with a .js or .ts extension
-* Examples:
-*   - "./scripts/setup.js"
-*   - "./setup.ts"
-*   - "../../scripts/setup.js"
-*/
-const SCRIPT_PATH_REGEX = /^(?:\.{0,2}\/)*(?:[\w-]+\/)*[\w-]+\.(?:js|ts)$/;
-/**
-* Schema for custom installation step configuration
-*/
-const CustomInstallationStepSchema = valibot.object({
-	description: valibot.pipe(require_schemas.nonEmptyStringValueSchema("step description"), valibot.maxLength(MAX_DESCRIPTION_LENGTH, `The step description must not be longer than ${MAX_DESCRIPTION_LENGTH} characters`)),
-	name: valibot.pipe(require_schemas.nonEmptyStringValueSchema("step name"), valibot.maxLength(MAX_NAME_LENGTH, `The step name must not be longer than ${MAX_NAME_LENGTH} characters`)),
-	script: valibot.pipe(require_schemas.nonEmptyStringValueSchema("script path"), valibot.regex(SCRIPT_PATH_REGEX, "Script path must end with .js or .ts (e.g., \"./setup.js\", \"./scripts/setup.ts\", or \"../../scripts/setup.js\")"))
-});
-/**
-* Schema for installation messages configuration
-*/
-const MessagesSchema = valibot.object({
-	postInstallation: valibot.optional(valibot.pipe(require_schemas.nonEmptyStringValueSchema("postInstallation message"), valibot.maxLength(MAX_MESSAGE_LENGTH, `The postInstallation message must not be longer than ${MAX_MESSAGE_LENGTH} characters`))),
-	preInstallation: valibot.optional(valibot.pipe(require_schemas.nonEmptyStringValueSchema("preInstallation message"), valibot.maxLength(MAX_MESSAGE_LENGTH, `The preInstallation message must not be longer than ${MAX_MESSAGE_LENGTH} characters`)))
-});
-/**
-* Schema for installation configuration
-*/
-const InstallationSchema = valibot.object({
-	customInstallationSteps: valibot.pipe(valibot.optional(valibot.array(CustomInstallationStepSchema, "Expected an array of custom installation steps")), valibot.check((input) => {
-		const steps = input || [];
-		return new Set(steps.map((step) => step.name)).size === steps.length;
-	}, "Duplicate step names detected in custom installation steps. Each step must have a unique name.")),
-	messages: valibot.optional(MessagesSchema)
-});
-/**
-* Check if config has custom installation settings.
-* @param config - The configuration to check.
-*/
-function hasCustomInstallation(config) {
-	return config.installation !== void 0;
-}
-/**
-* Check if config has custom installation steps.
-* @param config - The configuration to check.
-*/
-function hasCustomInstallationSteps(config) {
-	return Array.isArray(config?.installation?.customInstallationSteps) && config.installation.customInstallationSteps.length > 0;
-}
-
 //#endregion
 //#region source/config/schema/webhooks.ts
 /** Schema for webhook field configuration (name and optional source). */

package/dist/es/actions/app-config/index.mjs

@@ -13,12 +13,12 @@
  */
 
 import { n as filterAppConfigByEnv } from "../../environment-C84BPRJZ.mjs";
-import { i as requiresInstallationFromDomains, o as getConfigDomains, t as validateCommerceAppConfig, u as hasBusinessConfigSchema } from "../../validate-NzW1FQwL.mjs";
+import { i as requiresInstallationFromDomains, o as getConfigDomains, t as validateCommerceAppConfig, u as hasBusinessConfigSchema } from "../../validate-Pd7RIA_3.mjs";
 import { n as logger, t as HttpActionRouter } from "../../router-BshIPAR1.mjs";
 import { resolveBusinessConfigSchema } from "@adobe/aio-commerce-lib-config";
+import { internalServerError, ok } from "@adobe/aio-commerce-lib-core/responses";
 import * as v from "valibot";
 import { CommerceEnvSchema } from "@adobe/aio-commerce-lib-core/commerce";
-import { internalServerError, ok } from "@adobe/aio-commerce-lib-core/responses";
 import { createHash } from "crypto";
 
 //#region source/actions/app-config/openapi.ts
@@ -77,7 +77,7 @@ function pruneUnusedTags(spec) {
 * @param domains - The active config domains.
 */
 function getOpenApiCacheKey(domains) {
-	const input = `2.0.0:${[...domains].sort().join(",")}:3.0.0`;
+	const input = `2.0.1-alpha-20260923160203:${[...domains].sort().join(",")}:3.0.0`;
 	return createHash("sha256").update(input).digest("hex").slice(0, 8);
 }
 /** Returns the server URL to be set in the OpenAPI spec, based on the current namespace. */

package/dist/es/actions/association/index.mjs

@@ -14,9 +14,9 @@
 
 import { r as setAssociationData, t as clearAssociationData } from "../../repository-BGmy0YeZ.mjs";
 import { n as logger, t as HttpActionRouter } from "../../router-BshIPAR1.mjs";
+import { noContent } from "@adobe/aio-commerce-lib-core/responses";
 import * as v from "valibot";
 import { CommerceEnvSchema } from "@adobe/aio-commerce-lib-core/commerce";
-import { noContent } from "@adobe/aio-commerce-lib-core/responses";
 
 //#region source/actions/association/schema.ts
 /** Request body for POST / — store association data. */

package/dist/es/actions/config/index.mjs

@@ -16,9 +16,9 @@ import { r as nonEmptyStringValueSchema } from "../../schemas-hRovglBF.mjs";
 import { r as filterSchemaByEnv } from "../../environment-C84BPRJZ.mjs";
 import { n as logger, t as HttpActionRouter } from "../../router-BshIPAR1.mjs";
 import { byScopeId, getConfiguration, initialize, setConfiguration } from "@adobe/aio-commerce-lib-config";
+import { ok } from "@adobe/aio-commerce-lib-core/responses";
 import * as v from "valibot";
 import { CommerceEnvSchema } from "@adobe/aio-commerce-lib-core/commerce";
-import { ok } from "@adobe/aio-commerce-lib-core/responses";
 
 //#region source/actions/config/schema.ts
 const AcceptedConfigurationValuesSchema = v.union([

package/dist/es/actions/installation/index.mjs

@@ -13,14 +13,14 @@
  */
 
 import { n as getAssociationData } from "../../repository-BGmy0YeZ.mjs";
+import { _ as CURRENT_STATE_KEY, a as buildWorkflowParams, b as requireCurrentAttempt, c as createLifecyclePersistence, d as getExecutedCustomInstallationSteps, f as getStorageKey, g as getCurrentLifecycleBaseline, h as createOrchestrationStateStore, i as buildLifecycleContext, l as createLifecycleRuntime, m as readStateFromStore, o as createInstallationHooks, p as isPostAppDeployInvocation, s as createInstallationStore, t as DEFAULT_ACTION_NAME, u as createUninstallationStore, v as normalizeExpiredAttempt, x as requireState, y as readOrInitializeState } from "../../common-BWUDGasu.mjs";
+import { C as callHook, S as isLeafStep, _ as isStepConfigured, a as runValidation, b as setAtPath, d as isSucceededState, f as createRetryState, g as getAtPath, h as createWorkflowError, i as runUninstallation, l as isFailedState, m as createSucceededState, n as createInitialUninstallationState, p as createFailedState, r as runInstallation, t as createInitialInstallationState, u as isInProgressState, v as nowIsoString, x as isBranchStep, y as pathsEqual } from "../../management-YDkb15SJ.mjs";
 import { r as nonEmptyStringValueSchema } from "../../schemas-hRovglBF.mjs";
-import { r as validateRecordedCommerceAppConfig, t as validateCommerceAppConfig } from "../../validate-NzW1FQwL.mjs";
-import { _ as CURRENT_STATE_KEY, a as buildWorkflowParams, b as requireCurrentAttempt, c as createLifecyclePersistence, d as getExecutedCustomInstallationSteps, f as getStorageKey, g as getCurrentLifecycleBaseline, h as createOrchestrationStateStore, i as buildLifecycleContext, l as createLifecycleRuntime, m as readStateFromStore, o as createInstallationHooks, p as isPostAppDeployInvocation, s as createInstallationStore, t as DEFAULT_ACTION_NAME, u as createUninstallationStore, v as normalizeExpiredAttempt, x as requireState, y as readOrInitializeState } from "../../common-dy6NrZt8.mjs";
-import { C as callHook, S as isLeafStep, _ as isStepConfigured, a as runValidation, b as setAtPath, d as isSucceededState, f as createRetryState, g as getAtPath, h as createWorkflowError, i as runUninstallation, l as isFailedState, m as createSucceededState, n as createInitialUninstallationState, p as createFailedState, r as runInstallation, t as createInitialInstallationState, u as isInProgressState, v as nowIsoString, x as isBranchStep, y as pathsEqual } from "../../management-DgwAhaaJ.mjs";
+import { r as validateRecordedCommerceAppConfig, t as validateCommerceAppConfig } from "../../validate-Pd7RIA_3.mjs";
 import { n as logger, t as HttpActionRouter } from "../../router-BshIPAR1.mjs";
+import { accepted, badRequest, conflict, internalServerError, noContent, ok } from "@adobe/aio-commerce-lib-core/responses";
 import * as v from "valibot";
 import { CommerceEnvSchema } from "@adobe/aio-commerce-lib-core/commerce";
-import { accepted, badRequest, conflict, internalServerError, noContent, ok } from "@adobe/aio-commerce-lib-core/responses";
 import openwhisk from "openwhisk";
 
 //#region source/management/common/workflow/execute.ts

package/dist/es/actions/scope-tree/index.mjs

@@ -13,13 +13,14 @@
  */
 
 import { r as nonEmptyStringValueSchema } from "../../schemas-hRovglBF.mjs";
-import { n as LIFECYCLE_HTTP_CLIENT_TIMEOUT_MS, t as inspect } from "../../logging-CXesop3u.mjs";
+import { t as LIFECYCLE_HTTP_CLIENT_TIMEOUT_MS } from "../../constants-CSQsZaDP.mjs";
+import { t as inspect } from "../../logging-DbJHXSKh.mjs";
 import { n as logger, t as HttpActionRouter } from "../../router-BshIPAR1.mjs";
 import { resolveCommerceHttpClientParams } from "@adobe/aio-commerce-lib-api";
 import { getScopeTree, setCustomScopeTree, syncCommerceScopes, unsyncCommerceScopes } from "@adobe/aio-commerce-lib-config";
+import { badRequest, internalServerError, nonAuthoritativeInformation, ok } from "@adobe/aio-commerce-lib-core/responses";
 import * as v from "valibot";
 import { CommerceEnvSchema } from "@adobe/aio-commerce-lib-core/commerce";
-import { badRequest, internalServerError, nonAuthoritativeInformation, ok } from "@adobe/aio-commerce-lib-core/responses";
 
 //#region source/actions/scope-tree/schema.ts
 const CustomScopeInputSchema = v.object({

package/dist/es/cli/index.d.mts

@@ -0,0 +1,31 @@
+/**
+ * @license
+ *
+ * Copyright 2026 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+//#region source/commands/hooks/pre-app-build.d.ts
+/** The extensions that register a `pre-app-build` hook. */
+type Extension = "extensibility/1" | "configuration/1" | "backend-ui/2";
+//#endregion
+//#region source/cli/index.d.ts
+/**
+ * Creates the `pre-app-build` hook for the given extension.
+ * @param extension - The extension the hook is registered for.
+ */
+export declare function preAppBuild(extension: Extension): () => Promise<void>;
+/** Creates the `pre-app-run` hook. */
+export declare function preAppRun(): () => Promise<void>;
+/** Creates the `pre-app-dev` hook. */
+export declare function preAppDev(): () => Promise<void>;
+/** Creates the `post-app-deploy` hook. */
+export declare function postAppDeploy(): () => Promise<void>;
+//#endregion

package/dist/es/cli/index.mjs

@@ -0,0 +1,381 @@
+/**
+ * @license
+ *
+ * Copyright 2026 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+import { p as getProjectRootDirectory, r as parseCommerceAppConfig } from "../index.node-DPiidKGS.mjs";
+import { O as TEMPLATES_DIR, S as BACKEND_UI_V2_EXTENSION_POINT_ID, T as EXTENSIBILITY_EXTENSION_POINT_ID, c as run$4, d as readExtConfig, f as updateExtConfig, g as getRuntimeActions, l as generateActionFiles, n as prepareWebSourceImportAlias, o as run$5, t as generateWebSrc, u as prepareRuntimeAppConfigModule, v as loadAppManifest, w as CONFIGURATION_EXTENSION_POINT_ID } from "../web-src-CM_09qwk.mjs";
+import { n as INSTALLATION_INVOCATION_SOURCE_HEADER, r as POST_APP_DEPLOY_INVOCATION_SOURCE } from "../common-BWUDGasu.mjs";
+import { l as hasBackendUiV2Components } from "../webhooks-BMBfTqwi.mjs";
+import { CommerceSdkValidationError } from "@adobe/aio-commerce-lib-core/error";
+import { existsSync, readFileSync, writeFileSync } from "fs";
+import path from "path";
+import consola$1, { consola } from "consola";
+import aioIms from "@adobe/aio-lib-ims";
+import config from "@adobe/aio-lib-core-config";
+import { colors } from "consola/utils";
+import ky, { HTTPError } from "ky";
+import * as v from "valibot";
+import { setTimeout } from "timers/promises";
+import dotenv from "dotenv";
+
+//#region ../../packages-private/scripting-utils/source/aio/auth.ts
+const { context: context$1, getToken } = aioIms;
+/** 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 = config.get("project");
+	const namespace = config.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 config.get("cli.env") === "stage" ? "stage" : "prod";
+}
+
+//#endregion
+//#region source/commands/hooks/post-app-deploy/polling.ts
+const POLL_INTERVAL_MS = 1e3;
+const UpgradeStateSchema = v.object({
+	failure: v.optional(v.object({
+		key: v.string(),
+		message: v.optional(v.string())
+	})),
+	id: v.string(),
+	status: v.picklist([
+		"pending",
+		"in-progress",
+		"succeeded",
+		"failed"
+	])
+});
+/** Reads the latest upgrade state from the installation action. */
+async function getUpgradeState(request) {
+	try {
+		const response = await ky.get(request.endpoint, { headers: request.headers });
+		if (response.status === 204) return null;
+		const parsed = v.safeParse(UpgradeStateSchema, await response.json());
+		return parsed.success ? parsed.output : null;
+	} catch (error) {
+		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.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.start("App upgrade is in progress...");
+	await 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}`,
+			[INSTALLATION_INVOCATION_SOURCE_HEADER]: POST_APP_DEPLOY_INVOCATION_SOURCE,
+			"x-gw-ims-org-id": project.org.ims_org_id
+		}
+	};
+}
+/** Invokes the upgrade action. */
+async function invokeAction(request) {
+	consola.debug(`Upgrade endpoint: ${request.endpoint}`);
+	try {
+		return await ky.post(request.endpoint, {
+			headers: request.headers,
+			json: request.body
+		}).json();
+	} catch (error) {
+		if (error instanceof 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$3() {
+	const { upgradeMode } = (await parseCommerceAppConfig()).metadata;
+	consola.log("");
+	consola.start("Checking for app upgrades...");
+	const request = await createUpgradeRequest();
+	const result = await invokeAction(request);
+	if (isSkippedResult(result)) {
+		consola.info(`No upgrade was run: ${result.reason}.\n`);
+		return result;
+	}
+	if (upgradeMode === "manual") consola.success(`You have set ${colors.cyan("metadata.upgradeMode")} to ${colors.cyan("manual")}. The upgrade plan has been created but will not be executed.`);
+	else consola.success(`You have set ${colors.cyan("metadata.upgradeMode")} to ${colors.cyan("auto")}. The upgrade plan has been created. Execution will begin shortly.`);
+	consola.box(["Upgrade plan", JSON.stringify(result.plan, null, 2)].join("\n\n"));
+	if (upgradeMode === "auto") await waitForAutomaticUpgrade(request);
+	return result;
+}
+
+//#endregion
+//#region ../../packages-private/scripting-utils/source/env.ts
+/**
+* This module exports shared environment utilities for the AIO Commerce SDK.
+* @packageDocumentation
+*/
+const { context } = aioIms;
+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.resolve(filePath);
+	const envLines = 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}`);
+	writeFileSync(envPath, updatedLines.join("\n"), "utf8");
+}
+/**
+* Sets the `NODE_ENV` environment variable in the current process and 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 set in `NODE_ENV`.
+* @param projectRoot - Resolved project root containing the `.env` file.
+*/
+function setNodeEnv(mode, projectRoot) {
+	const envPath = path.join(projectRoot, ".env");
+	if (!existsSync(envPath)) writeFileSync(envPath, "", "utf8");
+	replaceEnvVar(envPath, "NODE_ENV", mode);
+	process.env.NODE_ENV = mode;
+}
+/** Resolves the IMS server to server context from the project workspace credentials. */
+function resolveImsS2SContext() {
+	const [credential] = (config.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.join(projectRoot, ".env");
+	if (!existsSync(envPath)) return {
+		ok: false,
+		reason: "missing-env"
+	};
+	const envVars = dotenv.parse(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.
+* @param options - Hook options.
+* @param options.isDevSession - Whether the build runs within `aio app run` or `aio app dev`, which keeps `NODE_ENV` untouched.
+*/
+async function run$2(extension, projectRoot, templatesDir = TEMPLATES_DIR, { isDevSession = false } = {}) {
+	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$4(appManifest, projectRoot);
+		await generateActionFiles(appManifest, getRuntimeActions(extensibilityExtConfig.toJS(), "app-management"), EXTENSIBILITY_EXTENSION_POINT_ID, templatesDir, projectRoot);
+		consola$1.info("Syncing IMS credentials...");
+		await syncImsCredentials(projectRoot);
+		return;
+	}
+	if (extension === "configuration/1") {
+		const { doc: businessConfigExtConfig } = await readExtConfig(CONFIGURATION_EXTENSION_POINT_ID, projectRoot);
+		await run$5(appManifest, projectRoot);
+		await generateActionFiles(appManifest, getRuntimeActions(businessConfigExtConfig.toJS(), "business-configuration"), CONFIGURATION_EXTENSION_POINT_ID, templatesDir, projectRoot);
+		return;
+	}
+	if (extension === "backend-ui/2") {
+		if (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);
+				if (!isDevSession) await setNodeEnv("production", projectRoot);
+			}
+		}
+		return;
+	}
+	throw new Error(`Unsupported extension: ${extension}`);
+}
+
+//#endregion
+//#region source/commands/hooks/pre-app-dev.ts
+/**
+* Resets the web build back to development by setting `NODE_ENV` in the process and the project `.env`.
+* @param projectRoot - Resolved project root containing the `.env` file.
+*/
+async function run$1(projectRoot) {
+	await setNodeEnv("development", projectRoot);
+}
+
+//#endregion
+//#region source/commands/hooks/pre-app-run.ts
+/**
+* Resets the web build back to development by setting `NODE_ENV` in the process and the project `.env`.
+* @param projectRoot - Resolved project root containing the `.env` file.
+*/
+async function run(projectRoot) {
+	await setNodeEnv("development", projectRoot);
+}
+
+//#endregion
+//#region source/cli/index.ts
+/**
+* Internal App Builder hook handlers, loaded by the hook files that
+* `@adobe/aio-commerce-lib-app` generates. Not part of the public API.
+* @packageDocumentation
+*/
+let isDevSession = false;
+/**
+* Creates an async App Builder hook that runs the given function, logging any
+* error and exiting the process with code 1.
+*
+* @param fn - The hook implementation.
+*/
+function createHook(fn) {
+	return async () => {
+		try {
+			await fn();
+		} catch (error) {
+			if (error instanceof CommerceSdkValidationError) consola$1.error(error.display());
+			else consola$1.error(error);
+			process.exit(1);
+		}
+	};
+}
+/**
+* Creates the `pre-app-build` hook for the given extension.
+* @param extension - The extension the hook is registered for.
+*/
+function preAppBuild(extension) {
+	return createHook(async () => {
+		const projectRoot = await getProjectRootDirectory();
+		await run$2(extension, projectRoot, TEMPLATES_DIR, { isDevSession });
+	});
+}
+/** Creates the `pre-app-run` hook. */
+function preAppRun() {
+	return createHook(async () => {
+		isDevSession = true;
+		await run(await getProjectRootDirectory());
+	});
+}
+/** Creates the `pre-app-dev` hook. */
+function preAppDev() {
+	return createHook(async () => {
+		isDevSession = true;
+		await run$1(await getProjectRootDirectory());
+	});
+}
+/** Creates the `post-app-deploy` hook. */
+function postAppDeploy() {
+	return createHook(run$3);
+}
+
+//#endregion
+export { postAppDeploy, preAppBuild, preAppDev, preAppRun };