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

package/dist/es/{app-Cf3EmtUh.d.mts → app-DwSqUkJA.d.mts}

@@ -17,6 +17,41 @@ import * as v from "valibot";
 /** The individual validatable domains of the app config. */
 declare const CommerceAppConfigSchemas: {
   readonly adminUi: v.ObjectSchema<{
+    readonly acl: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.StrictObjectSchema<{
+      readonly children: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.StrictObjectSchema<{
+        readonly id: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>, v.RegexAction<string, "ACL resource ID may contain only lowercase letters, digits, and \"_\"">]>;
+        readonly label: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>, v.MinLengthAction<string, 3, "acl resource label must be at least 3 characters">, v.MaxLengthAction<string, 50, "acl resource label must be at most 50 characters">]>;
+      }, undefined>, undefined>, v.MinLengthAction<{
+        id: string;
+        label: string;
+      }[], 1, "An ACL resource group must contain at least one child">, v.CheckAction<{
+        id: string;
+        label: string;
+      }[], "Child ACL resource ids must be unique within a group.">]>, undefined>;
+      readonly id: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>, v.RegexAction<string, "ACL resource ID may contain only lowercase letters, digits, and \"_\"">]>;
+      readonly label: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>, v.MinLengthAction<string, 3, "acl resource label must be at least 3 characters">, v.MaxLengthAction<string, 50, "acl resource label must be at most 50 characters">]>;
+    }, undefined>, undefined>, v.MinLengthAction<{
+      children?: {
+        id: string;
+        label: string;
+      }[] | undefined;
+      id: string;
+      label: string;
+    }[], 1, "At least one ACL resource is required when acl is defined">, v.CheckAction<{
+      children?: {
+        id: string;
+        label: string;
+      }[] | undefined;
+      id: string;
+      label: string;
+    }[], "Top-level ACL resource ids must be unique.">, v.CheckAction<{
+      children?: {
+        id: string;
+        label: string;
+      }[] | undefined;
+      id: string;
+      label: string;
+    }[], "Custom ACL resource ids must stay unique after Commerce derivation: a top-level resource id must not equal a group's \"<group>_<child>\" combination.">]>, undefined>;
     readonly customer: v.OptionalSchema<v.ObjectSchema<{
       readonly gridColumns: v.OptionalSchema<v.ObjectSchema<{
         readonly columns: v.SchemaWithPipe<readonly [v.ArraySchema<v.StrictObjectSchema<{
@@ -31,7 +66,13 @@ declare const CommerceAppConfigSchemas: {
           id: string;
           label: string;
           type: "string" | "boolean" | "date" | "datetime" | "float" | "integer";
-        }[], 1, "At least one grid column is required">]>;
+        }[], 1, "At least one grid column is required">, v.CheckAction<{
+          aclProtected?: boolean | undefined;
+          align: "left" | "right" | "center";
+          id: string;
+          label: string;
+          type: "string" | "boolean" | "date" | "datetime" | "float" | "integer";
+        }[], "Grid column ids must be unique after Commerce id sanitization.">]>;
         readonly description: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
         readonly label: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
         readonly runtimeAction: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
@@ -108,7 +149,7 @@ declare const CommerceAppConfigSchemas: {
         } | undefined;
         selectionLimit?: number | undefined;
         title?: string | undefined;
-      })[], "Mass action ids must be unique.">]>, undefined>;
+      })[], "Mass action ids must be unique after Commerce id sanitization.">]>, undefined>;
     }, undefined>, undefined>;
     readonly menu: v.OptionalSchema<v.ObjectSchema<{
       readonly aclProtected: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
@@ -133,7 +174,13 @@ declare const CommerceAppConfigSchemas: {
           id: string;
           label: string;
           type: "string" | "boolean" | "date" | "datetime" | "float" | "integer";
-        }[], 1, "At least one grid column is required">]>;
+        }[], 1, "At least one grid column is required">, v.CheckAction<{
+          aclProtected?: boolean | undefined;
+          align: "left" | "right" | "center";
+          id: string;
+          label: string;
+          type: "string" | "boolean" | "date" | "datetime" | "float" | "integer";
+        }[], "Grid column ids must be unique after Commerce id sanitization.">]>;
         readonly description: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
         readonly label: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
         readonly runtimeAction: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
@@ -210,7 +257,7 @@ declare const CommerceAppConfigSchemas: {
         } | undefined;
         selectionLimit?: number | undefined;
         title?: string | undefined;
-      })[], "Mass action ids must be unique.">]>, undefined>;
+      })[], "Mass action ids must be unique after Commerce id sanitization.">]>, undefined>;
       readonly viewButtons: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.VariantSchema<"type", [v.StrictObjectSchema<{
         readonly aclProtected: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
         readonly confirm: v.OptionalSchema<v.ObjectSchema<{
@@ -283,7 +330,7 @@ declare const CommerceAppConfigSchemas: {
         sortOrder?: number | undefined;
         timeout?: number | undefined;
         type: "worker";
-      })[], "Order view button ids must be unique.">]>, undefined>;
+      })[], "Order view button ids must be unique after Commerce id sanitization.">]>, undefined>;
     }, undefined>, undefined>;
     readonly product: v.OptionalSchema<v.ObjectSchema<{
       readonly gridColumns: v.OptionalSchema<v.ObjectSchema<{
@@ -299,7 +346,13 @@ declare const CommerceAppConfigSchemas: {
           id: string;
           label: string;
           type: "string" | "boolean" | "date" | "datetime" | "float" | "integer";
-        }[], 1, "At least one grid column is required">]>;
+        }[], 1, "At least one grid column is required">, v.CheckAction<{
+          aclProtected?: boolean | undefined;
+          align: "left" | "right" | "center";
+          id: string;
+          label: string;
+          type: "string" | "boolean" | "date" | "datetime" | "float" | "integer";
+        }[], "Grid column ids must be unique after Commerce id sanitization.">]>;
         readonly description: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
         readonly label: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
         readonly runtimeAction: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
@@ -376,7 +429,7 @@ declare const CommerceAppConfigSchemas: {
         } | undefined;
         selectionLimit?: number | undefined;
         title?: string | undefined;
-      })[], "Mass action ids must be unique.">]>, undefined>;
+      })[], "Mass action ids must be unique after Commerce id sanitization.">]>, undefined>;
     }, undefined>, undefined>;
   }, undefined>;
   readonly businessConfig: v.ObjectSchema<{
@@ -1091,7 +1144,7 @@ declare const CommerceAppConfigSchemas: {
     readonly description: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string for the ${string}`>, v.NonEmptyAction<string, `The ${string} must not be empty`>]>, v.MaxLengthAction<string, 255, "The metadata description must not be longer than 255 characters">]>;
     readonly displayName: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string for the ${string}`>, v.NonEmptyAction<string, `The ${string} must not be empty`>]>, v.MaxLengthAction<string, 50, "The application display name must not be longer than 50 characters">]>;
     readonly id: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.RegexAction<string, `Only alphanumeric characters and hyphens are allowed in string value of "${string}"${string}`>]>, v.MaxLengthAction<string, 100, "The application id must not be longer than 100 characters">]>;
-    readonly upgradeMode: v.OptionalSchema<v.PicklistSchema<["auto", "manual"], undefined>, "auto">;
+    readonly upgradeMode: v.OptionalSchema<v.PicklistSchema<["auto", "manual"], undefined>, "manual">;
     readonly version: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string for the ${string}`>, v.NonEmptyAction<string, `The ${string} must not be empty`>]>, v.RegexAction<string, "The version must follow semantic versioning (semver) format: Major.Minor.Patch (e.g., '1.0.0', '2.3.1')">]>;
   }, undefined>;
   readonly webhooks: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.UnionSchema<[v.ObjectSchema<{
@@ -1248,6 +1301,41 @@ declare function hasConfigDomain(config: AnyCommerceAppConfig, domain: CommerceA
 /** The schema used to validate the commerce app config file. */
 declare const CommerceAppConfigSchema: v.LooseObjectSchema<{
   readonly adminUi: v.OptionalSchema<v.ObjectSchema<{
+    readonly acl: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.StrictObjectSchema<{
+      readonly children: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.StrictObjectSchema<{
+        readonly id: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>, v.RegexAction<string, "ACL resource ID may contain only lowercase letters, digits, and \"_\"">]>;
+        readonly label: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>, v.MinLengthAction<string, 3, "acl resource label must be at least 3 characters">, v.MaxLengthAction<string, 50, "acl resource label must be at most 50 characters">]>;
+      }, undefined>, undefined>, v.MinLengthAction<{
+        id: string;
+        label: string;
+      }[], 1, "An ACL resource group must contain at least one child">, v.CheckAction<{
+        id: string;
+        label: string;
+      }[], "Child ACL resource ids must be unique within a group.">]>, undefined>;
+      readonly id: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>, v.RegexAction<string, "ACL resource ID may contain only lowercase letters, digits, and \"_\"">]>;
+      readonly label: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>, v.MinLengthAction<string, 3, "acl resource label must be at least 3 characters">, v.MaxLengthAction<string, 50, "acl resource label must be at most 50 characters">]>;
+    }, undefined>, undefined>, v.MinLengthAction<{
+      children?: {
+        id: string;
+        label: string;
+      }[] | undefined;
+      id: string;
+      label: string;
+    }[], 1, "At least one ACL resource is required when acl is defined">, v.CheckAction<{
+      children?: {
+        id: string;
+        label: string;
+      }[] | undefined;
+      id: string;
+      label: string;
+    }[], "Top-level ACL resource ids must be unique.">, v.CheckAction<{
+      children?: {
+        id: string;
+        label: string;
+      }[] | undefined;
+      id: string;
+      label: string;
+    }[], "Custom ACL resource ids must stay unique after Commerce derivation: a top-level resource id must not equal a group's \"<group>_<child>\" combination.">]>, undefined>;
     readonly customer: v.OptionalSchema<v.ObjectSchema<{
       readonly gridColumns: v.OptionalSchema<v.ObjectSchema<{
         readonly columns: v.SchemaWithPipe<readonly [v.ArraySchema<v.StrictObjectSchema<{
@@ -1262,7 +1350,13 @@ declare const CommerceAppConfigSchema: v.LooseObjectSchema<{
           id: string;
           label: string;
           type: "string" | "boolean" | "date" | "datetime" | "float" | "integer";
-        }[], 1, "At least one grid column is required">]>;
+        }[], 1, "At least one grid column is required">, v.CheckAction<{
+          aclProtected?: boolean | undefined;
+          align: "left" | "right" | "center";
+          id: string;
+          label: string;
+          type: "string" | "boolean" | "date" | "datetime" | "float" | "integer";
+        }[], "Grid column ids must be unique after Commerce id sanitization.">]>;
         readonly description: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
         readonly label: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
         readonly runtimeAction: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
@@ -1339,7 +1433,7 @@ declare const CommerceAppConfigSchema: v.LooseObjectSchema<{
         } | undefined;
         selectionLimit?: number | undefined;
         title?: string | undefined;
-      })[], "Mass action ids must be unique.">]>, undefined>;
+      })[], "Mass action ids must be unique after Commerce id sanitization.">]>, undefined>;
     }, undefined>, undefined>;
     readonly menu: v.OptionalSchema<v.ObjectSchema<{
       readonly aclProtected: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
@@ -1364,7 +1458,13 @@ declare const CommerceAppConfigSchema: v.LooseObjectSchema<{
           id: string;
           label: string;
           type: "string" | "boolean" | "date" | "datetime" | "float" | "integer";
-        }[], 1, "At least one grid column is required">]>;
+        }[], 1, "At least one grid column is required">, v.CheckAction<{
+          aclProtected?: boolean | undefined;
+          align: "left" | "right" | "center";
+          id: string;
+          label: string;
+          type: "string" | "boolean" | "date" | "datetime" | "float" | "integer";
+        }[], "Grid column ids must be unique after Commerce id sanitization.">]>;
         readonly description: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
         readonly label: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
         readonly runtimeAction: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
@@ -1441,7 +1541,7 @@ declare const CommerceAppConfigSchema: v.LooseObjectSchema<{
         } | undefined;
         selectionLimit?: number | undefined;
         title?: string | undefined;
-      })[], "Mass action ids must be unique.">]>, undefined>;
+      })[], "Mass action ids must be unique after Commerce id sanitization.">]>, undefined>;
       readonly viewButtons: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.VariantSchema<"type", [v.StrictObjectSchema<{
         readonly aclProtected: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
         readonly confirm: v.OptionalSchema<v.ObjectSchema<{
@@ -1514,7 +1614,7 @@ declare const CommerceAppConfigSchema: v.LooseObjectSchema<{
         sortOrder?: number | undefined;
         timeout?: number | undefined;
         type: "worker";
-      })[], "Order view button ids must be unique.">]>, undefined>;
+      })[], "Order view button ids must be unique after Commerce id sanitization.">]>, undefined>;
     }, undefined>, undefined>;
     readonly product: v.OptionalSchema<v.ObjectSchema<{
       readonly gridColumns: v.OptionalSchema<v.ObjectSchema<{
@@ -1530,7 +1630,13 @@ declare const CommerceAppConfigSchema: v.LooseObjectSchema<{
           id: string;
           label: string;
           type: "string" | "boolean" | "date" | "datetime" | "float" | "integer";
-        }[], 1, "At least one grid column is required">]>;
+        }[], 1, "At least one grid column is required">, v.CheckAction<{
+          aclProtected?: boolean | undefined;
+          align: "left" | "right" | "center";
+          id: string;
+          label: string;
+          type: "string" | "boolean" | "date" | "datetime" | "float" | "integer";
+        }[], "Grid column ids must be unique after Commerce id sanitization.">]>;
         readonly description: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
         readonly label: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
         readonly runtimeAction: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
@@ -1607,7 +1713,7 @@ declare const CommerceAppConfigSchema: v.LooseObjectSchema<{
         } | undefined;
         selectionLimit?: number | undefined;
         title?: string | undefined;
-      })[], "Mass action ids must be unique.">]>, undefined>;
+      })[], "Mass action ids must be unique after Commerce id sanitization.">]>, undefined>;
     }, undefined>, undefined>;
   }, undefined>, undefined>;
   readonly businessConfig: v.OptionalSchema<v.ObjectSchema<{
@@ -1975,7 +2081,7 @@ declare const CommerceAppConfigSchema: v.LooseObjectSchema<{
     readonly description: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string for the ${string}`>, v.NonEmptyAction<string, `The ${string} must not be empty`>]>, v.MaxLengthAction<string, 255, "The metadata description must not be longer than 255 characters">]>;
     readonly displayName: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string for the ${string}`>, v.NonEmptyAction<string, `The ${string} must not be empty`>]>, v.MaxLengthAction<string, 50, "The application display name must not be longer than 50 characters">]>;
     readonly id: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.RegexAction<string, `Only alphanumeric characters and hyphens are allowed in string value of "${string}"${string}`>]>, v.MaxLengthAction<string, 100, "The application id must not be longer than 100 characters">]>;
-    readonly upgradeMode: v.OptionalSchema<v.PicklistSchema<["auto", "manual"], undefined>, "auto">;
+    readonly upgradeMode: v.OptionalSchema<v.PicklistSchema<["auto", "manual"], undefined>, "manual">;
     readonly version: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string for the ${string}`>, v.NonEmptyAction<string, `The ${string} must not be empty`>]>, v.RegexAction<string, "The version must follow semantic versioning (semver) format: Major.Minor.Patch (e.g., '1.0.0', '2.3.1')">]>;
   }, undefined>;
   readonly webhooks: v.OptionalSchema<v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.UnionSchema<[v.ObjectSchema<{

package/dist/es/commands/index.mjs

@@ -14,16 +14,16 @@
  */
 
 import { t as stringifyError } from "../error-_RMwtrUA.mjs";
-import { _ as makeOutputDirFor, a as resolveCommerceAppConfig, c as getExecCommand, d as getPackageExecutionCommand, f as getProjectInstallCommand, g as loadPackageJson, h as isESM, i as readCommerceAppConfig, l as getInstallCommand, m as getRunScriptCommand, n as isTypeScriptConfig, o as appendCommand, p as getProjectRootDirectory, r as parseCommerceAppConfig, s as detectPackageManager, t as hasNamedCommerceAppConfigExports, u as getPackageDependencyInstallPlan, v as mergePackageJsonDependencies, y as readPackageJson } from "../index.node-DRTF5Hue.mjs";
-import { a as hasCustomInstallationSteps, d as hasAdminUi } from "../webhooks-BQ8kSN2Z.mjs";
-import { a as getConfigDomains, l as hasBusinessConfigSchema, t as validateCommerceAppConfig } from "../validate-8AXMGEwr.mjs";
-import { n as INSTALLATION_INVOCATION_SOURCE_HEADER, r as POST_APP_DEPLOY_INVOCATION_SOURCE } from "../common-BVG9tiX0.mjs";
+import { _ as makeOutputDirFor, a as resolveCommerceAppConfig, c as getExecCommand, d as getPackageExecutionCommand, f as getProjectInstallCommand, g as loadPackageJson, h as isESM, i as readCommerceAppConfig, l as getInstallCommand, m as getRunScriptCommand, n as isTypeScriptConfig, o as appendCommand, p as getProjectRootDirectory, r as parseCommerceAppConfig, s as detectPackageManager, t as hasNamedCommerceAppConfigExports, u as getPackageDependencyInstallPlan, v as mergePackageJsonDependencies, y as readPackageJson } from "../index.node-CW46zuxW.mjs";
+import { a as hasCustomInstallationSteps, f as hasBackendUiV2Components } from "../webhooks-CHZ1SXxw.mjs";
+import { o as getConfigDomains, t as validateCommerceAppConfig, u as hasBusinessConfigSchema } from "../validate-NzW1FQwL.mjs";
+import { n as INSTALLATION_INVOCATION_SOURCE_HEADER, r as POST_APP_DEPLOY_INVOCATION_SOURCE } from "../common-dy6NrZt8.mjs";
 import { t as inspect } from "../logging-CXesop3u.mjs";
 import { hasDynamicSchema } from "@adobe/aio-commerce-lib-config";
 import { CommerceSdkValidationError } from "@adobe/aio-commerce-lib-core/error";
 import { stringify as stringify$1 } from "safe-stable-stringify";
 import consola$1, { consola } from "consola";
-import { existsSync, readFileSync, writeFileSync } from "fs";
+import { constants, existsSync, readFileSync, writeFileSync } from "fs";
 import { access, copyFile, mkdir, readFile, readdir, rm, writeFile } from "fs/promises";
 import path, { basename, dirname, extname, join, relative, resolve, sep } from "path";
 import { colorize, colors, formatTree } from "consola/utils";
@@ -362,13 +362,14 @@ const TSX_FILE_EXTENSION = ".tsx";
 const APP_TITLE_PLACEHOLDER = "APP_TITLE";
 const WEB_SOURCE_ENTRYPOINT_FILE = "index.html";
 const WEB_SOURCE_IMPORT_ALIAS = "#web/*";
+const WEB_SOURCE_REQUIRED_FILES = [".babelrc"];
 const WEB_SOURCE_TSCONFIG_FILE = "tsconfig.json";
 const LEADING_DOT_SLASH_PATTERN$1 = /^\.\//u;
 /** Runtime dependencies required by the generated web-src app. */
 const WEB_SOURCE_DEPENDENCIES = [
 	{
 		name: "@adobe/aio-commerce-lib-admin-ui",
-		version: "^1.1.0-beta-20260820174436"
+		version: "^1.1.0"
 	},
 	{
 		name: "react",
@@ -383,14 +384,26 @@ const WEB_SOURCE_DEPENDENCIES = [
 		version: "^1.5.1"
 	}
 ];
-/** Development dependencies required by the generated web-src app. */
-const WEB_SOURCE_DEV_DEPENDENCIES = [{
-	name: "@types/react",
-	version: "^19.2.17"
+const WEB_SOURCE_BABEL_DEV_DEPENDENCIES = [{
+	name: "@babel/core",
+	version: "^7.29.7"
 }, {
-	name: "@types/react-dom",
-	version: "^19.2.3"
+	name: "@babel/preset-react",
+	version: "^7.29.7"
 }];
+/** Development dependencies required by the generated web-src app. */
+const WEB_SOURCE_DEV_DEPENDENCIES = [
+	...WEB_SOURCE_BABEL_DEV_DEPENDENCIES,
+	{
+		name: "@types/react",
+		version: "^19.2.17"
+	},
+	{
+		name: "@types/react-dom",
+		version: "^19.2.3"
+	}
+];
+const WEB_SOURCE_REQUIRED_DEV_DEPENDENCIES = WEB_SOURCE_BABEL_DEV_DEPENDENCIES;
 const WEB_SOURCE_SHARED_BUNDLES = [{
 	assets: ["**/@react-spectrum/s2/**", "src/commerce-backend-ui-2/web-src/*.{js,jsx,ts,tsx}"],
 	name: "s2-styles",
@@ -435,34 +448,37 @@ function getWebSourceEntrypoint(extConfig) {
 * @param projectRoot - Resolved project root containing package.json.
 * @param extension - Web source extension whose tooling is configured.
 */
-async function prepareWebSourcePackage(projectRoot, extension) {
+async function prepareWebSourcePackage(projectRoot, extension, scaffoldRequired) {
 	const pkg = await loadPackageJson(projectRoot);
 	if (pkg === null) throw new Error("Could not find package.json.");
-	const requiredDevDependencies = [...WEB_SOURCE_DEV_DEPENDENCIES, ...extension === "tsx" ? SHARED_TYPESCRIPT_DEV_DEPENDENCIES : []];
-	const installPlan = await getPackageDependencyInstallPlan([...WEB_SOURCE_DEPENDENCIES, ...requiredDevDependencies], projectRoot);
+	const dependencies = scaffoldRequired ? WEB_SOURCE_DEPENDENCIES : [];
+	const requiredDevDependencies = scaffoldRequired ? [...WEB_SOURCE_DEV_DEPENDENCIES, ...extension === "tsx" ? SHARED_TYPESCRIPT_DEV_DEPENDENCIES : []] : WEB_SOURCE_REQUIRED_DEV_DEPENDENCIES;
+	const installPlan = await getPackageDependencyInstallPlan([...dependencies, ...requiredDevDependencies], projectRoot);
 	if (installPlan.incompatible.length > 0) {
 		const incompatibleDependencies = installPlan.incompatible.map(({ name, version, installedVersion }) => `${name}@${installedVersion} does not satisfy ${version}`).join("\n");
 		throw new Error(`Cannot scaffold web-src because installed dependencies are incompatible:\n${incompatibleDependencies}`);
 	}
-	const dependencies = pkg.content.dependencies ?? {};
+	const existingDependencies = pkg.content.dependencies ?? {};
 	const devDependencies = pkg.content.devDependencies ?? {};
-	const dependencyMaps = [dependencies, devDependencies];
+	const dependencyMaps = [existingDependencies, devDependencies];
 	const declaredDependencyNames = new Set(dependencyMaps.flatMap((depMap) => Object.keys(depMap)));
-	const dependenciesToDeclare = [...WEB_SOURCE_DEPENDENCIES, ...requiredDevDependencies].filter(({ name }) => !declaredDependencyNames.has(name));
+	const dependenciesToDeclare = [...dependencies, ...requiredDevDependencies].filter(({ name }) => !declaredDependencyNames.has(name));
 	if (dependenciesToDeclare.length > 0) {
 		consola.info("Adding web-src dependencies in package.json:");
 		consola.log.raw(formatTree(dependenciesToDeclare.map(({ name, version }) => ` ${name}@${version}`)));
 	} else consola.info("web-src dependencies are already declared in package.json.");
 	pkg.update({
-		"@parcel/bundler-default": {
-			...pkg.content["@parcel/bundler-default"],
-			manualSharedBundles: WEB_SOURCE_SHARED_BUNDLES
-		},
-		"@parcel/resolver-default": {
-			...pkg.content["@parcel/resolver-default"],
-			packageExports: true
+		...scaffoldRequired && {
+			"@parcel/bundler-default": {
+				...pkg.content["@parcel/bundler-default"],
+				manualSharedBundles: WEB_SOURCE_SHARED_BUNDLES
+			},
+			"@parcel/resolver-default": {
+				...pkg.content["@parcel/resolver-default"],
+				packageExports: true
+			},
+			dependencies: mergePackageJsonDependencies(existingDependencies, WEB_SOURCE_DEPENDENCIES, dependencyMaps)
 		},
-		dependencies: mergePackageJsonDependencies(dependencies, WEB_SOURCE_DEPENDENCIES, dependencyMaps),
 		devDependencies: mergePackageJsonDependencies(devDependencies, requiredDevDependencies, dependencyMaps)
 	});
 	await pkg.save();
@@ -476,6 +492,20 @@ async function prepareWebSourcePackage(projectRoot, extension) {
 	runProjectInstall(packageManager, projectRoot);
 }
 /**
+* Copies required web-src support files that are not already present.
+* @param sourceDir - Directory containing required web source files.
+* @param targetDir - Generated or existing web source directory.
+* @param projectRoot - Resolved project root used to format output paths.
+*/
+async function copyMissingWebSourceFiles(sourceDir, targetDir, projectRoot) {
+	return (await Promise.all(WEB_SOURCE_REQUIRED_FILES.map(async (file) => {
+		const targetPath = join(targetDir, file);
+		if (existsSync(targetPath)) return null;
+		await copyFile(join(sourceDir, file), targetPath, constants.COPYFILE_EXCL);
+		return ` ${relative(projectRoot, targetPath)}`;
+	}))).filter((path) => path !== 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.
@@ -548,23 +578,29 @@ async function generateWebSrc(extConfig, appName, projectRoot, templatesDir = TE
 	const entrypoint = getWebSourceEntrypoint(extConfig);
 	if (entrypoint === null) return;
 	const entrypointPath = join(projectRoot, entrypoint);
-	if (existsSync(entrypointPath)) {
-		consola.info(`web-src entrypoint already exists, skipping scaffold: ${relative(projectRoot, entrypointPath)}`);
-		return;
-	}
-	consola.start(`Scaffolding web-src for ${BACKEND_UI_V2_EXTENSION_POINT_ID}...`);
-	const sourceDir = join(templatesDir, "admin-ui", "web-src");
+	const scaffoldRequired = !existsSync(entrypointPath);
 	const targetDir = dirname(entrypointPath);
 	const extension = await resolveWebSourceExtension(projectRoot);
-	const outputFiles = await copyWebSourceTemplates(sourceDir, targetDir, extension, appName, projectRoot);
-	if (extension === "tsx") {
-		const tsconfigPath = await writeWebSourceTypeScriptConfig(targetDir);
-		outputFiles.push(` ${relative(projectRoot, tsconfigPath)}`);
-		await syncWebSourceTypecheckScript(projectRoot);
+	const sourceDir = join(templatesDir, "admin-ui", "web-src");
+	let outputFiles = [];
+	if (scaffoldRequired) {
+		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(` ${relative(projectRoot, tsconfigPath)}`);
+			await syncWebSourceTypecheckScript(projectRoot);
+		}
+	} else consola.info(`web-src entrypoint already exists, skipping scaffold: ${relative(projectRoot, entrypointPath)}`);
+	const requiredFiles = await copyMissingWebSourceFiles(sourceDir, targetDir, projectRoot);
+	if (scaffoldRequired || requiredFiles.length > 0) await prepareWebSourcePackage(projectRoot, extension, scaffoldRequired);
+	if (scaffoldRequired) {
+		consola.success(`Scaffolded ${relative(projectRoot, targetDir)}`);
+		consola.log.raw(formatTree([...outputFiles, ...requiredFiles]));
+	} else if (requiredFiles.length > 0) {
+		consola.success(`Added required files to ${relative(projectRoot, targetDir)}`);
+		consola.log.raw(formatTree(requiredFiles));
 	}
-	await prepareWebSourcePackage(projectRoot, extension);
-	consola.success(`Scaffolded ${relative(projectRoot, targetDir)}`);
-	consola.log.raw(formatTree(outputFiles));
 }
 
 //#endregion
@@ -1012,14 +1048,16 @@ async function updateAppConfigImportAlias(projectRoot, runtimeConfigPath) {
 async function writeJavaScriptAppConfigModule(configFilePath, outputPath) {
 	const configImportPath = normalizeImportPath(relative(dirname(outputPath), configFilePath));
 	const isJson = 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 writeFile(outputPath, [
 		"// This file has been auto-generated by `@adobe/aio-commerce-lib-app`",
 		"// Do not modify this file directly",
 		"",
-		`import appConfig from "${configImportPath}"${isJson ? " with { type: \"json\" }" : ""};`,
+		`import appConfig from "${configImportPath}"${importAttributes};`,
 		"",
 		isJson ? null : `export * from "${configImportPath}";`,
-		"export default appConfig;",
+		defaultExport,
 		""
 	].filter((item) => item !== null).join("\n"), "utf-8");
 }
@@ -1203,7 +1241,7 @@ async function run$8(appManifest, projectRoot, templatesDir = TEMPLATES_DIR) {
 		const businessConfigExtConfig = await updateExtConfig(appManifest, CONFIGURATION_EXTENSION_POINT_ID, projectRoot);
 		await generateActionFiles(appManifest, getRuntimeActions(businessConfigExtConfig, "business-configuration"), CONFIGURATION_EXTENSION_POINT_ID, templatesDir, projectRoot);
 	}
-	if (hasAdminUi(appManifest)) {
+	if (hasBackendUiV2Components(appManifest)) {
 		const extConfig = await updateExtConfig(appManifest, BACKEND_UI_V2_EXTENSION_POINT_ID, projectRoot);
 		if (extConfig.operations?.view) {
 			await prepareWebSourceImportAlias(extConfig, projectRoot);
@@ -1612,7 +1650,7 @@ async function run$3(extension, projectRoot, templatesDir = TEMPLATES_DIR) {
 		return;
 	}
 	if (extension === "backend-ui/2") {
-		if (hasAdminUi(appManifest)) {
+		if (hasBackendUiV2Components(appManifest)) {
 			const extConfig = await updateExtConfig(appManifest, BACKEND_UI_V2_EXTENSION_POINT_ID, projectRoot);
 			if (extConfig.operations?.view) {
 				await prepareWebSourceImportAlias(extConfig, projectRoot);
@@ -2032,11 +2070,12 @@ async function writePostinstallHook(execCommand, projectRoot) {
 /**
 * Ensures app.config.yaml references the enabled domain extensions.
 * @param domains - Domains enabled in the app configuration.
+* @param config - The validated app configuration.
 * @param projectRoot - Resolved project root containing app.config.yaml.
 */
-async function ensureAppConfig(domains, projectRoot) {
+async function ensureAppConfig(domains, config, projectRoot) {
 	if (domains.has("businessConfig.schema")) await addExtensionPointToAppConfig(CONFIGURATION_EXTENSION_POINT_ID, projectRoot, " This extension is required for business configuration. Do not remove.");
-	if (domains.has("adminUi")) await addExtensionPointToAppConfig(BACKEND_UI_V2_EXTENSION_POINT_ID, projectRoot, " This extension is required for Admin UI. Do not remove.");
+	if (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.");
 }
 /**
@@ -2047,7 +2086,7 @@ async function ensureAppConfig(domains, projectRoot) {
 */
 function installDependencies(packageManager, domains, projectRoot) {
 	const packages = [];
-	if (domains.has("businessConfig.schema")) packages.push(`@adobe/aio-commerce-lib-config@^1.6.1`);
+	if (domains.has("businessConfig.schema")) packages.push(`@adobe/aio-commerce-lib-config@^1.8.0`);
 	if (packages.length === 0) {
 		consola.info("No additional domain dependencies to install.");
 		return;
@@ -2072,17 +2111,18 @@ async function runGeneration(appConfig, execCommand, projectRoot) {
 /**
 * Ensures install.yaml references the enabled domain extensions.
 * @param domains - Domains enabled in the app configuration.
+* @param config - The validated app configuration.
 * @param projectRoot - Resolved project root containing install.yaml.
 */
-async function ensureInstallYaml(domains, projectRoot) {
+async function ensureInstallYaml(domains, config, projectRoot) {
 	if (domains.has("businessConfig.schema")) await addExtensionPointToInstallYaml(CONFIGURATION_EXTENSION_POINT_ID, projectRoot, " This extension is required for business configuration. Do not remove.");
-	if (domains.has("adminUi")) await addExtensionPointToInstallYaml(BACKEND_UI_V2_EXTENSION_POINT_ID, projectRoot, " This extension is required for Admin UI. Do not remove.");
+	if (hasBackendUiV2Components(config)) await addExtensionPointToInstallYaml(BACKEND_UI_V2_EXTENSION_POINT_ID, projectRoot, " This extension is required for Admin UI. Do not remove.");
 	await addExtensionPointToInstallYaml(EXTENSIBILITY_EXTENSION_POINT_ID, projectRoot, " This extension is required for app management. Do not remove.");
 }
 
 //#endregion
 //#region source/commands/init/main.ts
-const REQUIRED_DEPENDENCIES = ["@adobe/aio-commerce-sdk", `@adobe/aio-commerce-lib-app@2.0.0-beta-20260820174436`];
+const REQUIRED_DEPENDENCIES = ["@adobe/aio-commerce-sdk", `@adobe/aio-commerce-lib-app@2.0.0`];
 /**
 * Initializes a Commerce App project.
 * @param flags - Non-interactive initialization answers.
@@ -2107,8 +2147,8 @@ async function run(flags, extraOptions) {
 	await pkg.save();
 	if (isTypeScriptProject) await syncActionsTypecheckScript(projectRoot);
 	await runGeneration(config, execCommand, projectRoot);
-	await ensureAppConfig(domains, projectRoot);
-	await ensureInstallYaml(domains, projectRoot);
+	await ensureAppConfig(domains, config, projectRoot);
+	await ensureInstallYaml(domains, config, projectRoot);
 	await writePostinstallHook(execCommand, projectRoot);
 	consola.success("Initialization complete!");
 	consola.box([

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

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

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

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

package/dist/es/{common-BVG9tiX0.mjs → common-dy6NrZt8.mjs}

@@ -12,7 +12,7 @@
  * governing permissions and limitations under the License.
  */
 
-import { c as isCompletedState, d as isSucceededState, o as createRootInstallationStep } from "./management-BTWQdJNO.mjs";
+import { c as isCompletedState, d as isSucceededState, o as createRootInstallationStep } from "./management-DgwAhaaJ.mjs";
 import { init } from "@adobe/aio-lib-state";
 import { getHeader } from "@adobe/aio-commerce-lib-core/headers";
 import { noContent, ok } from "@adobe/aio-commerce-lib-core/responses";
@@ -469,6 +469,13 @@ async function getInstallationSnapshot() {
 		id: installSnapshot.id
 	};
 }
+/**
+* Reads the persisted custom installation step history from a lifecycle snapshot's data. Returns
+* `[]` when there's no snapshot or none was recorded (e.g. an install from before this feature).
+*/
+function getExecutedCustomInstallationSteps(data) {
+	return (data?.installation?.customInstallationSteps?.reconciliation)?.executedSteps ?? [];
+}
 /** Creates the shared storage read/write dependencies used by lifecycle orchestration. */
 async function createLifecyclePersistence() {
 	const [stateStore, snapshotStore] = await Promise.all([createOrchestrationStateStore(), createAppStateSnapshotStore()]);
@@ -483,9 +490,9 @@ async function createLifecycleRuntime(params, appConfig, logger) {
 	return {
 		...await createLifecyclePersistence(),
 		lifecycleContext: buildLifecycleContext(params, appConfig, logger),
-		rootStep: createRootInstallationStep(appConfig)
+		rootStep: createRootInstallationStep(appConfig, { forUpgrade: true })
 	};
 }
 
 //#endregion
-export { normalizeExpiredAttempt as _, buildWorkflowParams as a, requireState as b, createLifecyclePersistence as c, getStorageKey as d, isPostAppDeployInvocation as f, CURRENT_STATE_KEY as g, getCurrentLifecycleBaseline as h, buildLifecycleContext as i, createLifecycleRuntime as l, createOrchestrationStateStore as m, INSTALLATION_INVOCATION_SOURCE_HEADER as n, createInstallationHooks as o, readStateFromStore as p, POST_APP_DEPLOY_INVOCATION_SOURCE as r, createInstallationStore as s, DEFAULT_ACTION_NAME as t, createUninstallationStore as u, readOrInitializeState as v, requireCurrentAttempt as y };
+export { CURRENT_STATE_KEY as _, buildWorkflowParams as a, requireCurrentAttempt as b, createLifecyclePersistence as c, getExecutedCustomInstallationSteps as d, getStorageKey as f, getCurrentLifecycleBaseline as g, createOrchestrationStateStore as h, buildLifecycleContext as i, createLifecycleRuntime as l, readStateFromStore as m, INSTALLATION_INVOCATION_SOURCE_HEADER as n, createInstallationHooks as o, isPostAppDeployInvocation as p, POST_APP_DEPLOY_INVOCATION_SOURCE as r, createInstallationStore as s, DEFAULT_ACTION_NAME as t, createUninstallationStore as u, normalizeExpiredAttempt as v, requireState as x, readOrInitializeState as y };

package/dist/es/config/index.browser.d.mts

@@ -12,5 +12,5 @@
  * governing permissions and limitations under the License.
  */
 
-import { t as defineConfig } from "../define-DSU8Kgu0.mjs";
+import { t as defineConfig } from "../define-Bq1zw9Lr.mjs";
 export { defineConfig };