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

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # @adobe/aio-commerce-lib-app
 
+## 1.3.0
+
+### Minor Changes
+
+- [#369](https://github.com/adobe/aio-commerce-sdk/pull/369) [`d8b0fa9`](https://github.com/adobe/aio-commerce-sdk/commit/d8b0fa9e3370b7abd0fb71b42d0078c375f63fb3) Thanks [@oshmyheliuk](https://github.com/oshmyheliuk)! - Add uninstallation flow for both native steps and custom steps. `defineCustomInstallationStep` now accepts an object with `install` and an optional `uninstall` handler in addition to a plain function, enabling per-step cleanup logic.
+
+- [#387](https://github.com/adobe/aio-commerce-sdk/pull/387) [`0803ecb`](https://github.com/adobe/aio-commerce-sdk/commit/0803ecb143ee6a0e6d4113cb380d625e20ee4e2f) Thanks [@obarcelonap](https://github.com/obarcelonap)! - Adding new PATCH endpoint for configuration which allows to partially set configuration values. Deprecating PUT endpoint in favor of PATCH.
+
+### Patch Changes
+
+- [#375](https://github.com/adobe/aio-commerce-sdk/pull/375) [`f5ac1a1`](https://github.com/adobe/aio-commerce-sdk/commit/f5ac1a1a400a6e609f296ef8de21ef6b20602120) Thanks [@iivvaannxx](https://github.com/iivvaannxx)! - Fix an issue where the Commerce Eventing module was constantly being updated for each provider of an app.
+
+- Updated dependencies [[`d8b0fa9`](https://github.com/adobe/aio-commerce-sdk/commit/d8b0fa9e3370b7abd0fb71b42d0078c375f63fb3), [`0803ecb`](https://github.com/adobe/aio-commerce-sdk/commit/0803ecb143ee6a0e6d4113cb380d625e20ee4e2f)]:
+  - @adobe/aio-commerce-lib-events@1.1.0
+  - @adobe/aio-commerce-lib-config@1.2.0
+
+## 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

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

@@ -15,7 +15,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_schemas = require('../schemas-nkIxa8sL.cjs');
 const require_router = require('../router-KeQRduO3.cjs');
-const require_validate = require('../validate-CwwYD8aC.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

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

@@ -12,8 +12,8 @@
  * governing permissions and limitations under the License.
  */
 
-import { n as CommerceAppConfigOutputModel } from "../app-lymFcs59.cjs";
-import * as _adobe_aio_commerce_lib_core_responses0 from "@adobe/aio-commerce-lib-core/responses";
+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
@@ -24,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

@@ -15,7 +15,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_schemas = require('../schemas-nkIxa8sL.cjs');
 const require_router = require('../router-KeQRduO3.cjs');
-const require_validate = require('../validate-CwwYD8aC.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);
@@ -59,7 +59,11 @@ router.get("/", {
 		} });
 	}
 });
-/** POST / - Set configuration */
+/**
+* PUT / - Set configuration (deprecated)
+* @deprecated Use PATCH instead. This endpoint overwrites all values for the scope
+* and does not support partial updates or unset semantics.
+*/
 router.put("/", {
 	body: valibot.object({
 		scopeId: require_schemas.nonEmptyStringValueSchema("scopeId"),
@@ -73,8 +77,35 @@ router.put("/", {
 		const { configSchema } = rawParams;
 		logger.debug(`Setting configuration with scope id: ${req.body.scopeId}`);
 		const { scopeId, config } = req.body;
+		(0, _adobe_aio_commerce_lib_config.initialize)({ schema: require_validate.validateCommerceAppConfigDomain(configSchema, "businessConfig.schema") });
 		const result = await (0, _adobe_aio_commerce_lib_config.setConfiguration)({ config: config.filter((item) => item.value !== MASKED_PASSWORD_VALUE) }, (0, _adobe_aio_commerce_lib_config.byScopeId)(scopeId), { encryptionKey: rawParams.AIO_COMMERCE_CONFIG_ENCRYPTION_KEY });
 		result.config = filterPasswordFields(configSchema, result.config);
+		return (0, _adobe_aio_commerce_lib_core_responses.ok)({
+			body: result,
+			headers: {
+				"Cache-Control": "no-store",
+				Deprecation: "Wed, 15 Apr 2026 00:00:00 GMT"
+			}
+		});
+	}
+});
+/** PATCH / - Partially update configuration */
+router.patch("/", {
+	body: valibot.object({
+		scopeId: require_schemas.nonEmptyStringValueSchema("scopeId"),
+		config: valibot.array(valibot.object({
+			name: require_schemas.nonEmptyStringValueSchema("config.name"),
+			value: valibot.nullable(valibot.union([valibot.string(), valibot.array(valibot.string())]))
+		}))
+	}),
+	handler: async (req, ctx) => {
+		const { logger, rawParams } = ctx;
+		const { configSchema } = rawParams;
+		logger.debug(`Patching configuration with scope id: ${req.body.scopeId}`);
+		const { scopeId, config } = req.body;
+		(0, _adobe_aio_commerce_lib_config.initialize)({ schema: require_validate.validateCommerceAppConfigDomain(configSchema, "businessConfig.schema") });
+		const result = await (0, _adobe_aio_commerce_lib_config.setConfiguration)({ config }, (0, _adobe_aio_commerce_lib_config.byScopeId)(scopeId), { encryptionKey: rawParams.AIO_COMMERCE_CONFIG_ENCRYPTION_KEY });
+		result.config = filterPasswordFields(configSchema, result.config);
 		return (0, _adobe_aio_commerce_lib_core_responses.ok)({
 			body: result,
 			headers: { "Cache-Control": "no-store" }

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

@@ -12,7 +12,7 @@
  * 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_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";
 
@@ -24,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

@@ -15,7 +15,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_schemas = require('../schemas-nkIxa8sL.cjs');
 const require_router = require('../router-KeQRduO3.cjs');
-const require_management = require('../management-PZtLe4Ji.cjs');
+const require_management = require('../management-C6xG5bfl.cjs');
 let _adobe_aio_commerce_lib_core_responses = require("@adobe/aio-commerce-lib-core/responses");
 let valibot = require("valibot");
 valibot = require_schemas.__toESM(valibot);
@@ -268,21 +268,68 @@ const InstallationRequestBodySchema = (0, valibot.object)({
 	ioEventsUrl: (0, valibot.string)(),
 	ioEventsEnv: (0, valibot.string)()
 });
-/** Creates an installation state store using lib-core combined storage. */
-function createInstallationStore() {
+/** Creates a workflow state store with the given prefix. */
+function createWorkflowStore(prefix) {
 	return createCombinedStore({
-		cache: { keyPrefix: "installation" },
+		cache: { keyPrefix: prefix },
 		persistent: {
-			dirPrefix: "installation",
+			dirPrefix: prefix,
 			shouldPersist: require_management.isCompletedState
 		}
 	});
 }
+/** Creates the installation state store. */
+function createInstallationStore() {
+	return createWorkflowStore("installation");
+}
+/** Creates the uninstallation state store. */
+function createUninstallationStore() {
+	return createWorkflowStore("uninstallation");
+}
 /** Returns the storage key used to store the current installation ID. */
 function getStorageKey() {
 	return "current";
 }
 /**
+* Merges rawParams with body fields, overriding API URLs.
+* Shared by POST /, POST /execution, POST /uninstallation, POST /uninstallation/execution.
+*/
+function buildWorkflowParams(body, rawParams) {
+	return {
+		...rawParams,
+		appData: body.appData,
+		AIO_EVENTS_API_BASE_URL: body.ioEventsUrl,
+		AIO_COMMERCE_AUTH_IMS_ENVIRONMENT: body.ioEventsEnv,
+		AIO_COMMERCE_API_BASE_URL: body.commerceBaseUrl,
+		AIO_COMMERCE_API_FLAVOR: body.commerceEnv
+	};
+}
+/**
+* Builds an InstallationContext from merged workflow params.
+* Shared by POST /execution and POST /uninstallation/execution.
+*/
+function buildInstallationContext(params, appConfig, logFn) {
+	return {
+		appData: params.appData,
+		params,
+		logger: logFn,
+		customScripts: params.customScriptsLoader?.(appConfig, logFn) ?? {}
+	};
+}
+/**
+* Reads state from a store and returns 200 with body or 204.
+* Shared by GET / and GET /uninstallation.
+*/
+async function readStateFromStore(store, logFn) {
+	const state = await store.get(getStorageKey());
+	if (state) {
+		logFn(`Found state: ${state.status}`);
+		return (0, _adobe_aio_commerce_lib_core_responses.ok)({ body: state });
+	}
+	logFn("No state found");
+	return (0, _adobe_aio_commerce_lib_core_responses.noContent)();
+}
+/**
 * Creates hooks to sync installation state to storage.
 */
 function createInstallationHooks(store, logFn) {
@@ -303,9 +350,14 @@ function createInstallationHooks(store, logFn) {
 * Installation action router.
 *
 * Routes:
-* - POST /installation - Start installation (creates plan, invokes execution async)
-* - GET /installation/execution - Get current execution status
-* - POST /installation/execution - Execute installation (internal, called async)
+* - GET /installation             - Get current installation status
+* - POST /installation            - Start installation (creates plan, invokes execution async)
+* - POST /installation/execution  - Execute installation (internal, called async)
+* - POST /installation/validation - Pre-installation validation
+* - POST /installation/uninstallation           - Start uninstallation (async)
+* - GET /installation/uninstallation            - Get current uninstallation status
+* - POST /installation/uninstallation/execution - Execute uninstallation (internal, called async)
+* - DELETE /installation/uninstallation         - Clear uninstallation state only (no offboarding)
 */
 const router = new require_router.HttpActionRouter().use(require_router.logger({ name: () => "installation" }));
 /**
@@ -318,13 +370,7 @@ const router = new require_router.HttpActionRouter().use(require_router.logger({
 */
 router.get("/", { handler: async (_req, { logger }) => {
 	logger.debug("Getting installation execution status...");
-	const state = await (await createInstallationStore()).get(getStorageKey());
-	if (state) {
-		logger.debug(`Found execution: ${state.status}`);
-		return (0, _adobe_aio_commerce_lib_core_responses.ok)({ body: state });
-	}
-	logger.debug("No execution found");
-	return (0, _adobe_aio_commerce_lib_core_responses.noContent)();
+	return readStateFromStore(await createInstallationStore(), (msg) => logger.debug(msg));
 } });
 /**
 * POST / - Start installation
@@ -356,17 +402,14 @@ router.post("/", {
 		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({
+		const ow = (0, openwhisk.default)();
+		const mergedParams = buildWorkflowParams(req.body, rawParams);
+		const activation = await ow.actions.invoke({
 			name: DEFAULT_ACTION_NAME,
 			blocking: false,
 			result: false,
 			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,
+				...mergedParams,
 				initialState,
 				appConfig,
 				__ow_path: "/execution",
@@ -388,18 +431,13 @@ router.post("/", {
 * It runs the actual installation workflow and saves state.
 */
 router.post("/execution", { handler: async (_req, { logger, rawParams }) => {
-	const { appData, ...params } = rawParams;
+	const params = rawParams;
 	const { initialState, appConfig } = params;
 	if (!initialState) return (0, _adobe_aio_commerce_lib_core_responses.badRequest)("initialState is required for execution");
 	if (!appConfig) return (0, _adobe_aio_commerce_lib_core_responses.badRequest)("appConfig is required for execution");
 	const store = await createInstallationStore();
 	const hooks = createInstallationHooks(store, (msg) => logger.debug(msg));
-	const installationContext = {
-		appData,
-		params,
-		logger,
-		customScripts: params.customScriptsLoader?.(appConfig, logger) || {}
-	};
+	const installationContext = buildInstallationContext(params, appConfig, logger);
 	logger.debug(`Executing installation: ${initialState.id}`);
 	const result = await require_management.runInstallation({
 		installationContext,
@@ -434,14 +472,7 @@ router.post("/validation", {
 		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 { appData, ...params } = buildWorkflowParams(req.body, rawParams);
 		const result = await require_management.runValidation({
 			validationContext: {
 				appData,
@@ -455,14 +486,107 @@ router.post("/validation", {
 	}
 });
 /**
-* DELETE / - Clear installation state
+* GET /uninstallation - Get current uninstallation status
+*
+* Returns 200 with state if an uninstallation has been started, 204 otherwise.
+*/
+router.get("/uninstallation", { handler: async (_req, { logger }) => {
+	logger.debug("Getting uninstallation execution status...");
+	return readStateFromStore(await createUninstallationStore(), (msg) => logger.debug(msg));
+} });
+/**
+* POST /uninstallation - Start uninstallation (async)
+*
+* Flow:
+* 1. Check uninstallation store for existing state
+* 2. If in-progress: return 409 Conflict
+* 3. Create initial uninstall state, save to store
+* 4. Invoke POST /uninstallation/execution async via openwhisk
+* 5. Return 202 Accepted with initial state
+*/
+router.post("/uninstallation", {
+	body: InstallationRequestBodySchema,
+	handler: async (req, { logger, rawParams }) => {
+		logger.debug("Starting async uninstallation...");
+		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 store = await createUninstallationStore();
+		const existingState = await store.get(getStorageKey());
+		if (existingState && require_management.isInProgressState(existingState)) {
+			logger.debug(`Uninstallation already in progress: ${existingState.status}`);
+			return (0, _adobe_aio_commerce_lib_core_responses.conflict)("Uninstallation is already in progress. Wait for it to complete.");
+		}
+		const initialState = require_management.createInitialUninstallationState({ config: appConfig });
+		logger.debug(`Created initial uninstall state: ${initialState.id}`);
+		await store.put(getStorageKey(), initialState);
+		const workflowParams = buildWorkflowParams(req.body, rawParams);
+		const activation = await (0, openwhisk.default)().actions.invoke({
+			name: DEFAULT_ACTION_NAME,
+			blocking: false,
+			result: false,
+			params: {
+				...workflowParams,
+				initialState,
+				appConfig,
+				__ow_path: "/uninstallation/execution",
+				__ow_method: "post"
+			}
+		});
+		logger.debug(`Async uninstallation started: ${activation.activationId}`);
+		return (0, _adobe_aio_commerce_lib_core_responses.accepted)({ body: {
+			message: "Uninstallation started",
+			activationId: activation.activationId,
+			...initialState
+		} });
+	}
+});
+/**
+* POST /uninstallation/execution - Execute uninstallation (internal, called async by POST /uninstallation)
+*
+* Flow:
+* 1. Build InstallationContext from params
+* 2. Run uninstallation workflow with hooks (hooks persist state per step)
+* 3. Save final state to uninstallation store
+* 4. On success, clear installation store
+* 5. Return 200 on success, 500 on failure
+*/
+router.post("/uninstallation/execution", { handler: async (_req, { logger, rawParams }) => {
+	const params = rawParams;
+	const { initialState, appConfig } = params;
+	if (!initialState) return (0, _adobe_aio_commerce_lib_core_responses.badRequest)("initialState is required for execution");
+	if (!appConfig) return (0, _adobe_aio_commerce_lib_core_responses.badRequest)("appConfig is required for execution");
+	const store = await createUninstallationStore();
+	const hooks = createInstallationHooks(store, (msg) => logger.debug(msg));
+	const installationContext = buildInstallationContext(params, appConfig, logger);
+	logger.debug(`Executing uninstallation: ${initialState.id}`);
+	const result = await require_management.runUninstallation({
+		installationContext,
+		config: appConfig,
+		initialState,
+		hooks
+	});
+	await store.put(getStorageKey(), result);
+	logger.debug(`Uninstallation completed: ${result.status}`);
+	if (require_management.isSucceededState(result)) {
+		await (await createInstallationStore()).delete(getStorageKey());
+		logger.debug("Cleared installation state after successful uninstallation");
+	}
+	if (require_management.isFailedState(result)) return (0, _adobe_aio_commerce_lib_core_responses.internalServerError)({ body: {
+		message: "Uninstallation failed",
+		error: result.error,
+		state: result
+	} });
+	return (0, _adobe_aio_commerce_lib_core_responses.ok)({ body: result });
+} });
+/**
+* DELETE /uninstallation - Clear uninstallation state
 *
-* This endpoint allows clearing the installation state.
+* Removes the stored uninstallation state without triggering any offboarding.
 */
-router.delete("/", { handler: async (_req, { logger }) => {
-	logger.debug("Clearing installation state...");
-	await (await createInstallationStore()).delete(getStorageKey());
-	logger.debug("Installation state cleared");
+router.delete("/uninstallation", { handler: async (_req, { logger }) => {
+	logger.debug("Clearing uninstallation state...");
+	await (await createUninstallationStore()).delete(getStorageKey());
+	logger.debug("Uninstallation state cleared");
 	return (0, _adobe_aio_commerce_lib_core_responses.noContent)();
 } });
 /** Factory to create the route handler for the `installation` action. */

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

@@ -12,9 +12,9 @@
  * governing permissions and limitations under the License.
  */
 
-import { n as CommerceAppConfigOutputModel } from "../app-lymFcs59.cjs";
-import { V as InstallationContext } from "../index-DRhLtRrX.cjs";
-import * as _adobe_aio_commerce_lib_core_responses0 from "@adobe/aio-commerce-lib-core/responses";
+import { n as CommerceAppConfigOutputModel } from "../app-DcQMhW2N.cjs";
+import { q as InstallationContext } from "../index-BVwQk9bx.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
@@ -28,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.d.cts

@@ -12,11 +12,11 @@
  * 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";
+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-lymFcs59.d.cts → app-DcQMhW2N.d.cts}

@@ -18,7 +18,7 @@ import * as v from "valibot";
 /** 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: Major.Minor.Patch (e.g., '1.0.0', '2.3.1')">]>;
@@ -171,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>;

package/dist/cjs/commands/index.cjs

@@ -14,9 +14,9 @@
  */
 
 const require_schemas = require('../schemas-nkIxa8sL.cjs');
-const require_validate = require('../validate-CwwYD8aC.cjs');
-const require_webhooks = require('../webhooks-CbZpv9y_.cjs');
-const require_config = require('../config-YEeaEqzi.cjs');
+const require_webhooks = require('../webhooks-CLtDxwMa.cjs');
+const require_validate = require('../validate-CeUCT_7k.cjs');
+const require_config = require('../config-BppBKCFj.cjs');
 const require_error = require('../error-Dn7ool6k.cjs');
 const require_logging = require('../logging-4s36JTiN.cjs');
 let _adobe_aio_commerce_lib_core_error = require("@adobe/aio-commerce-lib-core/error");

package/dist/cjs/config/index.cjs

@@ -13,9 +13,9 @@
  */
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_validate = require('../validate-CwwYD8aC.cjs');
-const require_webhooks = require('../webhooks-CbZpv9y_.cjs');
-const require_config = require('../config-YEeaEqzi.cjs');
+const require_webhooks = require('../webhooks-CLtDxwMa.cjs');
+const require_validate = require('../validate-CeUCT_7k.cjs');
+const require_config = require('../config-BppBKCFj.cjs');
 
 exports.CommerceAppConfigSchemas = require_validate.CommerceAppConfigSchemas;
 exports.defineConfig = require_config.defineConfig;

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

@@ -12,7 +12,7 @@
  * governing permissions and limitations under the License.
  */
 
-import { n as CommerceAppConfigOutputModel, t as CommerceAppConfig } from "../app-lymFcs59.cjs";
+import { n as CommerceAppConfigOutputModel, t as CommerceAppConfig } from "../app-DcQMhW2N.cjs";
 import * as v from "valibot";
 import { Get, SetRequiredDeep } from "type-fest";
 
@@ -134,6 +134,18 @@ declare function defineConfig(config: CommerceAppConfig): {
       }[];
     }[] | undefined;
   } | undefined;
+  adminUiSdk?: {
+    registration: {
+      menuItems: {
+        id: string;
+        title?: string | undefined;
+        parent?: string | undefined;
+        sortOrder?: number | undefined;
+        sandbox?: string | undefined;
+        isSection?: boolean | undefined;
+      }[];
+    };
+  } | undefined;
   installation?: {
     messages?: {
       preInstallation?: string | undefined;
@@ -355,6 +367,18 @@ declare function parseCommerceAppConfig(cwd?: string): Promise<{
       }[];
     }[] | undefined;
   } | undefined;
+  adminUiSdk?: {
+    registration: {
+      menuItems: {
+        id: string;
+        title?: string | undefined;
+        parent?: string | undefined;
+        sortOrder?: number | undefined;
+        sandbox?: string | undefined;
+        isSection?: boolean | undefined;
+      }[];
+    };
+  } | undefined;
   installation?: {
     messages?: {
       preInstallation?: string | undefined;
@@ -440,7 +464,7 @@ declare function parseCommerceAppConfig(cwd?: string): Promise<{
 /** The individual validatable domains of the app config. */
 declare const CommerceAppConfigSchemas: {
   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: Major.Minor.Patch (e.g., '1.0.0', '2.3.1')">]>;
@@ -888,6 +912,18 @@ declare const CommerceAppConfigSchemas: {
     readonly 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.MaxLengthAction<string, 255, "The step name must not be longer than 255 characters">]>;
     readonly description: 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, 255, "The step description must not be longer than 255 characters">]>;
   }, undefined>, "Expected an array of custom installation steps">;
+  readonly adminUiSdk: 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>;
 };
 /** Individual validatable domains of the commerce app config. */
 type CommerceAppConfigDomain = keyof typeof CommerceAppConfigSchemas;
@@ -1169,7 +1205,7 @@ declare function hasCustomInstallationSteps(config: CommerceAppConfigOutputModel
 //#region source/config/schema/metadata.d.ts
 /** The schema for the metadata of the application. */
 declare const MetadataSchema: 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: Major.Minor.Patch (e.g., '1.0.0', '2.3.1')">]>;

package/dist/cjs/{config-YEeaEqzi.cjs → config-BppBKCFj.cjs}

@@ -13,7 +13,7 @@
  */
 
 const require_schemas = require('./schemas-nkIxa8sL.cjs');
-const require_validate = require('./validate-CwwYD8aC.cjs');
+const require_validate = require('./validate-CeUCT_7k.cjs');
 const require_error = require('./error-Dn7ool6k.cjs');
 let path = require("path");
 let fs = require("fs");