@adobe/aio-commerce-lib-app 1.0.2 → 1.2.0

package/CHANGELOG.md

@@ -1,5 +1,43 @@
 # @adobe/aio-commerce-lib-app
 
+## 1.2.0
+
+### Minor Changes
+
+- [#351](https://github.com/adobe/aio-commerce-sdk/pull/351) [`8af56e1`](https://github.com/adobe/aio-commerce-sdk/commit/8af56e142179b4d15249ce385bda23117003c133) Thanks [@oshmyheliuk](https://github.com/oshmyheliuk)! - Add workspace ID to the event provider instance ID to ensure uniqueness within the IMS org.
+
+- [#372](https://github.com/adobe/aio-commerce-sdk/pull/372) [`a04ee2b`](https://github.com/adobe/aio-commerce-sdk/commit/a04ee2b511aa7169e9fcc827f8eddab6192f00ba) Thanks [@asalloum5](https://github.com/asalloum5)! - Added Admin UI SDK installation step to correctly configure extensions in Adobe Commerce instance.
+
+### Patch Changes
+
+- [#370](https://github.com/adobe/aio-commerce-sdk/pull/370) [`a627efc`](https://github.com/adobe/aio-commerce-sdk/commit/a627efc95d8176ff20a4506f9cadd828c9886d84) Thanks [@iivvaannxx](https://github.com/iivvaannxx)! - Only configure the Commerce Eventing Module when it doesn't have a default provider or a workspace configuration.
+
+- Updated dependencies [[`fe79660`](https://github.com/adobe/aio-commerce-sdk/commit/fe79660a9f010b5651f36e4e9d85bb11fc856296), [`fe79660`](https://github.com/adobe/aio-commerce-sdk/commit/fe79660a9f010b5651f36e4e9d85bb11fc856296), [`eeef589`](https://github.com/adobe/aio-commerce-sdk/commit/eeef589461f9bd684ed1fcf23ff97dfeba88723e), [`3e4b765`](https://github.com/adobe/aio-commerce-sdk/commit/3e4b7657cd34ff45317d29067846a4a113a3d37f)]:
+  - @adobe/aio-commerce-lib-config@1.1.0
+
+## 1.1.0
+
+### Minor Changes
+
+- [#273](https://github.com/adobe/aio-commerce-sdk/pull/273) [`660cf05`](https://github.com/adobe/aio-commerce-sdk/commit/660cf058d2439de82b3e22376c3d494b2a83045f) Thanks [@oshmyheliuk](https://github.com/oshmyheliuk)! - Added the functionality to define and install webhooks in the installation flow of the app.
+
+- [#285](https://github.com/adobe/aio-commerce-sdk/pull/285) [`cda7712`](https://github.com/adobe/aio-commerce-sdk/commit/cda7712ac74b3bd9700aaa243a8b67d3a3d74d91) Thanks [@oshmyheliuk](https://github.com/oshmyheliuk)! - Added a new endpoint /installation/validation to perform validation before the app is installed. Added webhook-specific validation for possible conflicts.
+
+### Patch Changes
+
+- [#349](https://github.com/adobe/aio-commerce-sdk/pull/349) [`3abfe95`](https://github.com/adobe/aio-commerce-sdk/commit/3abfe9503f491aad3a2105d617fc8aa1c7b4725e) Thanks [@oshmyheliuk](https://github.com/oshmyheliuk)! - Normalize event names and application IDs to lowercase to prevent case-sensitivity issues and ensure consistent event delivery.
+
+- [#343](https://github.com/adobe/aio-commerce-sdk/pull/343) [`4883afa`](https://github.com/adobe/aio-commerce-sdk/commit/4883afaec90451cd7daf280f0def83ea45a3c87c) Thanks [@oshmyheliuk](https://github.com/oshmyheliuk)! - Fixed IMS client secret parsing logic for the webhook subscription
+
+- [#310](https://github.com/adobe/aio-commerce-sdk/pull/310) [`8f6ad9d`](https://github.com/adobe/aio-commerce-sdk/commit/8f6ad9ddcaae0f0a5a116bcbbefaae49f97697eb) Thanks [@oshmyheliuk](https://github.com/oshmyheliuk)! - Improved validation error messages across schema files.
+
+- Updated dependencies [[`660cf05`](https://github.com/adobe/aio-commerce-sdk/commit/660cf058d2439de82b3e22376c3d494b2a83045f), [`cb9c11d`](https://github.com/adobe/aio-commerce-sdk/commit/cb9c11dfd243d3034763374fe5416645015b46a9), [`4883afa`](https://github.com/adobe/aio-commerce-sdk/commit/4883afaec90451cd7daf280f0def83ea45a3c87c)]:
+  - @adobe/aio-commerce-lib-webhooks@0.1.0
+  - @adobe/aio-commerce-lib-auth@1.0.1
+  - @adobe/aio-commerce-lib-api@1.0.1
+  - @adobe/aio-commerce-lib-events@1.0.1
+  - @adobe/aio-commerce-lib-config@1.0.3
+
 ## 1.0.2
 
 ### Patch Changes

package/dist/cjs/actions/app-config.cjs

@@ -1,12 +1,26 @@
+/**
+ * @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.
+ */
+
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_schemas = require('../schemas-CZ6c8Id9.cjs');
-const require_router = require('../router-DCw7oEQ9.cjs');
-const require_validate = require('../validate-Btzn9ilZ.cjs');
+const require_schemas = require('../schemas-nkIxa8sL.cjs');
+const require_router = require('../router-KeQRduO3.cjs');
+const require_validate = require('../validate-CeUCT_7k.cjs');
 let _adobe_aio_commerce_lib_core_responses = require("@adobe/aio-commerce-lib-core/responses");
 
 //#region source/actions/app-config.ts
 /** Router for the app config actions. */
-const router = new require_router.HttpActionRouter().use(require_router.logger({ name: () => "get-app-config" }));
+const router = new require_router.HttpActionRouter().use(require_router.logger({ name: () => "app-config" }));
 /** GET / - Get app config */
 router.get("/", { handler: async (_req, { logger, rawParams }) => {
 	logger.debug("Validating app config...");

package/dist/cjs/actions/app-config.d.cts

@@ -1,5 +1,19 @@
-import { n as CommerceAppConfigOutputModel } from "../app-DWX5-Hsf.cjs";
-import * as _adobe_aio_commerce_lib_core_responses0 from "@adobe/aio-commerce-lib-core/responses";
+/**
+ * @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 { n as CommerceAppConfigOutputModel } from "../app-DcQMhW2N.cjs";
+import * as _$_adobe_aio_commerce_lib_core_responses0 from "@adobe/aio-commerce-lib-core/responses";
 import { RuntimeActionParams } from "@adobe/aio-commerce-lib-core/params";
 
 //#region source/actions/app-config.d.ts
@@ -10,6 +24,6 @@ type RuntimeActionFactoryArgs = {
 /** Factory to create the route handler for the `app-config` action. */
 declare const appConfigRuntimeAction: ({
   appConfig
-}: RuntimeActionFactoryArgs) => (params: RuntimeActionParams) => Promise<_adobe_aio_commerce_lib_core_responses0.ActionResponse>;
+}: RuntimeActionFactoryArgs) => (params: RuntimeActionParams) => Promise<_$_adobe_aio_commerce_lib_core_responses0.ActionResponse>;
 //#endregion
 export { appConfigRuntimeAction };

package/dist/cjs/actions/config.cjs

@@ -1,7 +1,21 @@
+/**
+ * @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.
+ */
+
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_schemas = require('../schemas-CZ6c8Id9.cjs');
-const require_router = require('../router-DCw7oEQ9.cjs');
-const require_validate = require('../validate-Btzn9ilZ.cjs');
+const require_schemas = require('../schemas-nkIxa8sL.cjs');
+const require_router = require('../router-KeQRduO3.cjs');
+const require_validate = require('../validate-CeUCT_7k.cjs');
 let _adobe_aio_commerce_lib_core_responses = require("@adobe/aio-commerce-lib-core/responses");
 let valibot = require("valibot");
 valibot = require_schemas.__toESM(valibot);

package/dist/cjs/actions/config.d.cts

@@ -1,4 +1,18 @@
-import * as _adobe_aio_commerce_lib_core_responses0 from "@adobe/aio-commerce-lib-core/responses";
+/**
+ * @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 * as _$_adobe_aio_commerce_lib_core_responses0 from "@adobe/aio-commerce-lib-core/responses";
 import { RuntimeActionParams } from "@adobe/aio-commerce-lib-core/params";
 import { BusinessConfigSchema } from "@adobe/aio-commerce-lib-config";
 
@@ -10,6 +24,6 @@ type ConfigActionFactoryArgs = {
 /** Factory to create the route handler for the `config` action. */
 declare const configRuntimeAction: ({
   configSchema
-}: ConfigActionFactoryArgs) => (params: RuntimeActionParams) => Promise<_adobe_aio_commerce_lib_core_responses0.ActionResponse>;
+}: ConfigActionFactoryArgs) => (params: RuntimeActionParams) => Promise<_$_adobe_aio_commerce_lib_core_responses0.ActionResponse>;
 //#endregion
 export { configRuntimeAction };

package/dist/cjs/actions/installation.cjs

@@ -1,7 +1,21 @@
+/**
+ * @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.
+ */
+
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_schemas = require('../schemas-CZ6c8Id9.cjs');
-const require_router = require('../router-DCw7oEQ9.cjs');
-const require_runner = require('../runner-NHMvoMO2.cjs');
+const require_schemas = require('../schemas-nkIxa8sL.cjs');
+const require_router = require('../router-KeQRduO3.cjs');
+const require_management = require('../management-iLQubQ7K.cjs');
 let _adobe_aio_commerce_lib_core_responses = require("@adobe/aio-commerce-lib-core/responses");
 let valibot = require("valibot");
 valibot = require_schemas.__toESM(valibot);
@@ -246,13 +260,21 @@ const AppDataSchema = valibot.object({
 //#endregion
 //#region source/actions/installation.ts
 const DEFAULT_ACTION_NAME = "app-management/installation";
+/** Request body schema shared by POST / and POST /validation. */
+const InstallationRequestBodySchema = (0, valibot.object)({
+	appData: AppDataSchema,
+	commerceBaseUrl: (0, valibot.string)(),
+	commerceEnv: (0, valibot.string)(),
+	ioEventsUrl: (0, valibot.string)(),
+	ioEventsEnv: (0, valibot.string)()
+});
 /** Creates an installation state store using lib-core combined storage. */
 function createInstallationStore() {
 	return createCombinedStore({
 		cache: { keyPrefix: "installation" },
 		persistent: {
 			dirPrefix: "installation",
-			shouldPersist: require_runner.isCompletedState
+			shouldPersist: require_management.isCompletedState
 		}
 	});
 }
@@ -313,23 +335,17 @@ router.get("/", { handler: async (_req, { logger }) => {
 * 3. If not found or failed: create plan, invoke execution async, return 202 Accepted
 */
 router.post("/", {
-	body: (0, valibot.object)({
-		appData: AppDataSchema,
-		commerceBaseUrl: (0, valibot.string)(),
-		commerceEnv: (0, valibot.string)(),
-		ioEventsUrl: (0, valibot.string)(),
-		ioEventsEnv: (0, valibot.string)()
-	}),
+	body: InstallationRequestBodySchema,
 	handler: async (req, { logger, rawParams }) => {
 		logger.debug("Starting installation...");
 		const store = await createInstallationStore();
 		const existingState = await store.get(getStorageKey());
 		if (existingState) {
-			if (require_runner.isInProgressState(existingState)) {
+			if (require_management.isInProgressState(existingState)) {
 				logger.debug(`Installation already in progress: ${existingState.status}`);
 				return (0, _adobe_aio_commerce_lib_core_responses.conflict)(`Installation is already ${existingState.status}. Wait for it to complete.`);
 			}
-			if (require_runner.isSucceededState(existingState)) {
+			if (require_management.isSucceededState(existingState)) {
 				logger.debug("Installation already succeeded");
 				return (0, _adobe_aio_commerce_lib_core_responses.conflict)("Installation has already completed successfully.");
 			}
@@ -337,7 +353,7 @@ router.post("/", {
 		}
 		const appConfig = rawParams.appConfig;
 		if (!appConfig) return (0, _adobe_aio_commerce_lib_core_responses.internalServerError)("Could not find or parse the app.commerce.manifest.json file, is it present and valid?");
-		const initialState = require_runner.createInitialInstallationState({ config: appConfig });
+		const initialState = require_management.createInitialInstallationState({ config: appConfig });
 		logger.debug(`Created initial state: ${initialState.id}`);
 		await store.put(getStorageKey(), initialState);
 		const activation = await (0, openwhisk.default)().actions.invoke({
@@ -385,7 +401,7 @@ router.post("/execution", { handler: async (_req, { logger, rawParams }) => {
 		customScripts: params.customScriptsLoader?.(appConfig, logger) || {}
 	};
 	logger.debug(`Executing installation: ${initialState.id}`);
-	const result = await require_runner.runInstallation({
+	const result = await require_management.runInstallation({
 		installationContext,
 		config: appConfig,
 		initialState,
@@ -393,7 +409,7 @@ router.post("/execution", { handler: async (_req, { logger, rawParams }) => {
 	});
 	await store.put(getStorageKey(), result);
 	logger.debug(`Installation completed: ${result.status}`);
-	if (require_runner.isFailedState(result)) return (0, _adobe_aio_commerce_lib_core_responses.internalServerError)({ body: {
+	if (require_management.isFailedState(result)) return (0, _adobe_aio_commerce_lib_core_responses.internalServerError)({ body: {
 		message: "Installation failed",
 		error: result.error,
 		state: result
@@ -401,6 +417,44 @@ router.post("/execution", { handler: async (_req, { logger, rawParams }) => {
 	return (0, _adobe_aio_commerce_lib_core_responses.ok)({ body: result });
 } });
 /**
+* POST /installation/validation - Pre-installation validation
+*
+* Synchronously validates the step tree before installation begins.
+* Accepts the same request body as POST / (installation start) so the
+* frontend can reuse the same parameters without any extra mapping.
+*
+* Flow:
+* 1. Build a ValidationContext from the request parameters
+* 2. Call runValidation() — traverses the step tree and collects issues
+* 3. Return the structured ValidationResult immediately (no async invoke)
+*/
+router.post("/validation", {
+	body: InstallationRequestBodySchema,
+	handler: async (req, { logger, rawParams }) => {
+		logger.debug("Running pre-installation validation...");
+		const appConfig = rawParams.appConfig;
+		if (!appConfig) return (0, _adobe_aio_commerce_lib_core_responses.internalServerError)("Could not find or parse the app.commerce.manifest.json file, is it present and valid?");
+		const { appData, ...params } = {
+			...rawParams,
+			appData: req.body.appData,
+			AIO_EVENTS_API_BASE_URL: req.body.ioEventsUrl,
+			AIO_COMMERCE_AUTH_IMS_ENVIRONMENT: req.body.ioEventsEnv,
+			AIO_COMMERCE_API_BASE_URL: req.body.commerceBaseUrl,
+			AIO_COMMERCE_API_FLAVOR: req.body.commerceEnv
+		};
+		const result = await require_management.runValidation({
+			validationContext: {
+				appData,
+				params,
+				logger
+			},
+			config: appConfig
+		});
+		logger.debug(`Validation complete — valid: ${result.valid}, errors: ${result.summary.errors}, warnings: ${result.summary.warnings}`);
+		return (0, _adobe_aio_commerce_lib_core_responses.ok)({ body: result });
+	}
+});
+/**
 * DELETE / - Clear installation state
 *
 * This endpoint allows clearing the installation state.

package/dist/cjs/actions/installation.d.cts

@@ -1,6 +1,20 @@
-import { n as CommerceAppConfigOutputModel } from "../app-DWX5-Hsf.cjs";
-import { P as InstallationContext } from "../runner-DemKouFJ.cjs";
-import * as _adobe_aio_commerce_lib_core_responses0 from "@adobe/aio-commerce-lib-core/responses";
+/**
+ * @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 { n as CommerceAppConfigOutputModel } from "../app-DcQMhW2N.cjs";
+import { V as InstallationContext } from "../index-DZxladgt.cjs";
+import * as _$_adobe_aio_commerce_lib_core_responses0 from "@adobe/aio-commerce-lib-core/responses";
 import { RuntimeActionParams } from "@adobe/aio-commerce-lib-core/params";
 
 //#region source/actions/installation.d.ts
@@ -14,6 +28,6 @@ type RuntimeActionFactoryArgs = {
 declare const installationRuntimeAction: ({
   appConfig,
   customScriptsLoader
-}: RuntimeActionFactoryArgs) => (params: RuntimeActionParams) => Promise<_adobe_aio_commerce_lib_core_responses0.ActionResponse>;
+}: RuntimeActionFactoryArgs) => (params: RuntimeActionParams) => Promise<_$_adobe_aio_commerce_lib_core_responses0.ActionResponse>;
 //#endregion
 export { installationRuntimeAction };

package/dist/cjs/actions/scope-tree.cjs

@@ -1,7 +1,21 @@
+/**
+ * @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.
+ */
+
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_schemas = require('../schemas-CZ6c8Id9.cjs');
-const require_router = require('../router-DCw7oEQ9.cjs');
-const require_logging = require('../logging-IDRQG0as.cjs');
+const require_schemas = require('../schemas-nkIxa8sL.cjs');
+const require_router = require('../router-KeQRduO3.cjs');
+const require_logging = require('../logging-4s36JTiN.cjs');
 let _adobe_aio_commerce_lib_core_responses = require("@adobe/aio-commerce-lib-core/responses");
 let valibot = require("valibot");
 valibot = require_schemas.__toESM(valibot);

package/dist/cjs/actions/scope-tree.d.cts

@@ -1,8 +1,22 @@
-import * as _adobe_aio_commerce_lib_core_responses0 from "@adobe/aio-commerce-lib-core/responses";
-import * as _adobe_aio_commerce_lib_core_params0 from "@adobe/aio-commerce-lib-core/params";
+/**
+ * @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 * as _$_adobe_aio_commerce_lib_core_responses0 from "@adobe/aio-commerce-lib-core/responses";
+import * as _$_adobe_aio_commerce_lib_core_params0 from "@adobe/aio-commerce-lib-core/params";
 
 //#region source/actions/scope-tree.d.ts
 /** The handler method for the `scope-tree` action. */
-declare const scopeTreeRuntimeAction: (args: _adobe_aio_commerce_lib_core_params0.RuntimeActionParams) => Promise<_adobe_aio_commerce_lib_core_responses0.ActionResponse>;
+declare const scopeTreeRuntimeAction: (args: _$_adobe_aio_commerce_lib_core_params0.RuntimeActionParams) => Promise<_$_adobe_aio_commerce_lib_core_responses0.ActionResponse>;
 //#endregion
 export { scopeTreeRuntimeAction };

package/dist/cjs/{app-DWX5-Hsf.d.cts → app-DcQMhW2N.d.cts}

@@ -1,13 +1,27 @@
+/**
+ * @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 * as v from "valibot";
 
 //#region source/config/schema/app.d.ts
 /** The schema used to validate the commerce app config file. */
 declare const CommerceAppConfigSchema: v.LooseObjectSchema<{
   readonly metadata: v.ObjectSchema<{
-    readonly id: 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}`>]>;
+    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 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 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 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">]>;
+    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 businessConfig: v.OptionalSchema<v.ObjectSchema<{
     readonly schema: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.VariantSchema<"type", [v.VariantSchema<"selectionMode", [v.ObjectSchema<{
@@ -157,6 +171,18 @@ declare const CommerceAppConfigSchema: v.LooseObjectSchema<{
       }, undefined>, "Expected an array of external events">;
     }, undefined>, "Expected an array of external event sources">, undefined>;
   }, undefined>, undefined>;
+  readonly adminUiSdk: v.OptionalSchema<v.ObjectSchema<{
+    readonly registration: v.ObjectSchema<{
+      readonly menuItems: v.ArraySchema<v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly title: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly parent: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly sortOrder: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly sandbox: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly isSection: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+      }, undefined>, undefined>;
+    }, undefined>;
+  }, undefined>, undefined>;
   readonly installation: v.OptionalSchema<v.ObjectSchema<{
     readonly messages: v.OptionalSchema<v.ObjectSchema<{
       readonly preInstallation: v.OptionalSchema<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.MaxLengthAction<string, 1000, "The preInstallation message must not be longer than 1000 characters">]>, undefined>;
@@ -172,6 +198,137 @@ declare const CommerceAppConfigSchema: v.LooseObjectSchema<{
       description: string;
     }[] | undefined, "Duplicate step names detected in custom installation steps. Each step must have a unique name.">]>;
   }, undefined>, undefined>;
+  readonly webhooks: v.OptionalSchema<v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.UnionSchema<[v.ObjectSchema<{
+    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 description: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
+    readonly category: v.OptionalSchema<v.PicklistSchema<readonly ["validation", "append", "modification"], `Webhook category must be one of: ${string}`>, undefined>;
+    readonly runtimeAction: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
+    readonly requireAdobeAuth: v.OptionalSchema<v.BooleanSchema<`Expected a boolean value for '${string}'`>, undefined>;
+    readonly webhook: v.ObjectSchema<{
+      readonly webhook_method: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
+      readonly webhook_type: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
+      readonly batch_name: 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, "batch_name must contain only letters, numbers, and underscores">]>;
+      readonly batch_order: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<`Expected a number value for '${string}'`>, v.MinValueAction<number, 0, `The value of ${string} must be a non-negative number`>]>, undefined>;
+      readonly hook_name: 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, "hook_name must contain only letters, numbers, and underscores">]>;
+      readonly priority: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<`Expected a number value for '${string}'`>, v.MinValueAction<number, 0, `The value of ${string} must be a non-negative number`>]>, undefined>;
+      readonly required: v.OptionalSchema<v.BooleanSchema<`Expected a boolean value for '${string}'`>, undefined>;
+      readonly soft_timeout: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<`Expected a number value for '${string}'`>, v.MinValueAction<number, 0, `The value of ${string} must be a non-negative number`>]>, undefined>;
+      readonly timeout: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<`Expected a number value for '${string}'`>, v.MinValueAction<number, 0, `The value of ${string} must be a non-negative number`>]>, undefined>;
+      readonly method: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
+      readonly fallback_error_message: v.OptionalSchema<v.StringSchema<`Expected a string value for '${string}'`>, undefined>;
+      readonly ttl: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<`Expected a number value for '${string}'`>, v.MinValueAction<number, 0, `The value of ${string} must be a non-negative number`>]>, undefined>;
+      readonly fields: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+        readonly name: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
+        readonly source: v.OptionalSchema<v.StringSchema<`Expected a string value for '${string}'`>, undefined>;
+      }, undefined>, "Expected an array of webhook field objects">, undefined>;
+      readonly rules: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+        readonly field: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
+        readonly operator: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
+        readonly value: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
+      }, undefined>, "Expected an array of webhook rule objects">, undefined>;
+      readonly headers: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+        readonly name: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
+        readonly value: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
+      }, undefined>, "Expected an array of webhook header objects">, undefined>;
+    }, undefined>;
+  }, undefined>, v.ObjectSchema<{
+    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 description: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
+    readonly category: v.OptionalSchema<v.PicklistSchema<readonly ["validation", "append", "modification"], `Webhook category must be one of: ${string}`>, undefined>;
+    readonly webhook: v.ObjectSchema<{
+      readonly url: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.UrlAction<string, "The 'url' field must be a valid absolute URL (e.g., 'https://example.com/webhook')">]>;
+      readonly webhook_method: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
+      readonly webhook_type: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
+      readonly batch_name: 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, "batch_name must contain only letters, numbers, and underscores">]>;
+      readonly batch_order: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<`Expected a number value for '${string}'`>, v.MinValueAction<number, 0, `The value of ${string} must be a non-negative number`>]>, undefined>;
+      readonly hook_name: 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, "hook_name must contain only letters, numbers, and underscores">]>;
+      readonly priority: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<`Expected a number value for '${string}'`>, v.MinValueAction<number, 0, `The value of ${string} must be a non-negative number`>]>, undefined>;
+      readonly required: v.OptionalSchema<v.BooleanSchema<`Expected a boolean value for '${string}'`>, undefined>;
+      readonly soft_timeout: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<`Expected a number value for '${string}'`>, v.MinValueAction<number, 0, `The value of ${string} must be a non-negative number`>]>, undefined>;
+      readonly timeout: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<`Expected a number value for '${string}'`>, v.MinValueAction<number, 0, `The value of ${string} must be a non-negative number`>]>, undefined>;
+      readonly method: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
+      readonly fallback_error_message: v.OptionalSchema<v.StringSchema<`Expected a string value for '${string}'`>, undefined>;
+      readonly ttl: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<`Expected a number value for '${string}'`>, v.MinValueAction<number, 0, `The value of ${string} must be a non-negative number`>]>, undefined>;
+      readonly fields: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+        readonly name: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
+        readonly source: v.OptionalSchema<v.StringSchema<`Expected a string value for '${string}'`>, undefined>;
+      }, undefined>, "Expected an array of webhook field objects">, undefined>;
+      readonly rules: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+        readonly field: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
+        readonly operator: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
+        readonly value: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
+      }, undefined>, "Expected an array of webhook rule objects">, undefined>;
+      readonly headers: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+        readonly name: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
+        readonly value: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
+      }, undefined>, "Expected an array of webhook header objects">, undefined>;
+    }, undefined>;
+  }, undefined>], "Each webhook entry must define either a 'runtimeAction' (to resolve the URL from a runtime action) or an explicit 'url' inside the 'webhook' object, but not both">, "Expected an array of webhook entries">, v.MinLengthAction<({
+    label: string;
+    description: string;
+    category?: "validation" | "append" | "modification" | undefined;
+    runtimeAction: string;
+    requireAdobeAuth?: boolean | undefined;
+    webhook: {
+      webhook_method: string;
+      webhook_type: string;
+      batch_name: string;
+      batch_order?: number | undefined;
+      hook_name: string;
+      priority?: number | undefined;
+      required?: boolean | undefined;
+      soft_timeout?: number | undefined;
+      timeout?: number | undefined;
+      method: string;
+      fallback_error_message?: string | undefined;
+      ttl?: number | undefined;
+      fields?: {
+        name: string;
+        source?: string | undefined;
+      }[] | undefined;
+      rules?: {
+        field: string;
+        operator: string;
+        value: string;
+      }[] | undefined;
+      headers?: {
+        name: string;
+        value: string;
+      }[] | undefined;
+    };
+  } | {
+    label: string;
+    description: string;
+    category?: "validation" | "append" | "modification" | undefined;
+    webhook: {
+      url: string;
+      webhook_method: string;
+      webhook_type: string;
+      batch_name: string;
+      batch_order?: number | undefined;
+      hook_name: string;
+      priority?: number | undefined;
+      required?: boolean | undefined;
+      soft_timeout?: number | undefined;
+      timeout?: number | undefined;
+      method: string;
+      fallback_error_message?: string | undefined;
+      ttl?: number | undefined;
+      fields?: {
+        name: string;
+        source?: string | undefined;
+      }[] | undefined;
+      rules?: {
+        field: string;
+        operator: string;
+        value: string;
+      }[] | undefined;
+      headers?: {
+        name: string;
+        value: string;
+      }[] | undefined;
+    };
+  })[], 1, "webhooks array must contain at least one webhook when present">]>, undefined>, undefined>;
 }, undefined>;
 /** The input shape of the commerce app config schema. */
 type CommerceAppConfig = v.InferInput<typeof CommerceAppConfigSchema>;