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

package/dist/cjs/{validate-CwwYD8aC.cjs → validate-CeUCT_7k.cjs}

@@ -13,7 +13,7 @@
  */
 
 const require_schemas = require('./schemas-nkIxa8sL.cjs');
-const require_webhooks = require('./webhooks-CbZpv9y_.cjs');
+const require_webhooks = require('./webhooks-CLtDxwMa.cjs');
 let _adobe_aio_commerce_lib_core_error = require("@adobe/aio-commerce-lib-core/error");
 let valibot = require("valibot");
 valibot = require_schemas.__toESM(valibot);
@@ -37,6 +37,7 @@ function hasBusinessConfigSchema(config) {
 
 //#endregion
 //#region source/config/schema/metadata.ts
+const MAX_ID_LENGTH = 100;
 const MAX_DESCRIPTION_LENGTH = 255;
 const MAX_DISPLAY_NAME_LENGTH = 50;
 const NUMERIC_IDENTIFIER = "(0|[1-9]\\d*)";
@@ -46,7 +47,7 @@ function nonEmptyString(fieldName) {
 }
 /** The schema for the metadata of the application. */
 const MetadataSchema = valibot.object({
-	id: require_schemas.alphaNumericOrHyphenSchema("application id (metadata.id)"),
+	id: valibot.pipe(require_schemas.alphaNumericOrHyphenSchema("application id (metadata.id)"), valibot.maxLength(MAX_ID_LENGTH, `The application id must not be longer than ${MAX_ID_LENGTH} characters`)),
 	displayName: valibot.pipe(nonEmptyString("application display name"), valibot.maxLength(MAX_DISPLAY_NAME_LENGTH, `The application display name must not be longer than ${MAX_DISPLAY_NAME_LENGTH} characters`)),
 	description: valibot.pipe(nonEmptyString("metadata description"), valibot.maxLength(MAX_DESCRIPTION_LENGTH, `The metadata description must not be longer than ${MAX_DESCRIPTION_LENGTH} characters`)),
 	version: valibot.pipe(nonEmptyString("version"), valibot.regex(SEMVER_REGEX, "The version must follow semantic versioning (semver) format: Major.Minor.Patch (e.g., '1.0.0', '2.3.1')"))
@@ -67,6 +68,7 @@ const CommerceAppConfigSchema = valibot.looseObject({
 	metadata: MetadataSchema,
 	businessConfig: valibot.optional(_adobe_aio_commerce_lib_config.SchemaBusinessConfig),
 	eventing: valibot.optional(require_webhooks.EventingSchema),
+	adminUiSdk: valibot.optional(require_webhooks.AdminUiSdkSchema),
 	installation: valibot.optional(require_webhooks.InstallationSchema),
 	webhooks: valibot.optional(require_webhooks.WebhooksSchema)
 });
@@ -83,7 +85,8 @@ const CommerceAppConfigSchemas = {
 	"businessConfig.schema": valibot.unwrap(_adobe_aio_commerce_lib_config.SchemaBusinessConfig.entries.schema),
 	"eventing.commerce": valibot.unwrap(require_webhooks.EventingSchema.entries.commerce),
 	"eventing.external": valibot.unwrap(require_webhooks.EventingSchema.entries.external),
-	"installation.customInstallationSteps": valibot.unwrap(require_webhooks.InstallationSchema.entries.customInstallationSteps)
+	"installation.customInstallationSteps": valibot.unwrap(require_webhooks.InstallationSchema.entries.customInstallationSteps),
+	adminUiSdk: require_webhooks.AdminUiSdkSchema
 };
 /**
 * Get the config domains that are present in the config.
@@ -98,6 +101,7 @@ function getConfigDomains(config) {
 		eventing: withCommerceEvents || withExternalEvents,
 		installation: require_webhooks.hasCustomInstallation(config),
 		webhooks: require_webhooks.hasWebhooks(config),
+		adminUiSdk: require_webhooks.hasAdminUiSdk(config),
 		"businessConfig.schema": hasBusinessConfigSchema(config),
 		"eventing.commerce": withCommerceEvents,
 		"eventing.external": withExternalEvents,

package/dist/cjs/{webhooks-CbZpv9y_.cjs → webhooks-CLtDxwMa.cjs}

@@ -16,6 +16,27 @@ const require_schemas = require('./schemas-nkIxa8sL.cjs');
 let valibot = require("valibot");
 valibot = require_schemas.__toESM(valibot);
 
+//#region source/config/schema/admin-ui-sdk.ts
+/**
+* Schema for the Admin UI SDK registration parameters (for the `adminUiSdk.registration` config section).
+* @see https://developer.adobe.com/commerce/extensibility/admin-ui-sdk/extension-points/ for more details.
+*/
+const AdminUiSdkRegistrationSchema = valibot.object({ menuItems: valibot.array(valibot.object({
+	id: valibot.string(),
+	title: valibot.optional(valibot.string()),
+	parent: valibot.optional(valibot.string()),
+	sortOrder: valibot.optional(valibot.number()),
+	sandbox: valibot.optional(valibot.string()),
+	isSection: valibot.optional(valibot.boolean())
+})) });
+/** Schema for Admin UI SDK configuration. */
+const AdminUiSdkSchema = valibot.object({ registration: AdminUiSdkRegistrationSchema });
+/** Check if config has Admin UI SDK registration configuration. */
+function hasAdminUiSdk(config) {
+	return config.adminUiSdk !== void 0 && config.adminUiSdk.registration !== void 0;
+}
+
+//#endregion
 //#region source/config/schema/eventing.ts
 const MAX_DESCRIPTION_LENGTH$1 = 255;
 const MAX_LABEL_LENGTH = 100;
@@ -291,6 +312,12 @@ function hasWebhooks(config) {
 }
 
 //#endregion
+Object.defineProperty(exports, 'AdminUiSdkSchema', {
+  enumerable: true,
+  get: function () {
+    return AdminUiSdkSchema;
+  }
+});
 Object.defineProperty(exports, 'EventingSchema', {
   enumerable: true,
   get: function () {
@@ -309,6 +336,12 @@ Object.defineProperty(exports, 'WebhooksSchema', {
     return WebhooksSchema;
   }
 });
+Object.defineProperty(exports, 'hasAdminUiSdk', {
+  enumerable: true,
+  get: function () {
+    return hasAdminUiSdk;
+  }
+});
 Object.defineProperty(exports, 'hasCommerceEvents', {
   enumerable: true,
   get: function () {

package/dist/es/actions/app-config.d.mts

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

@@ -13,7 +13,7 @@
  */
 
 import { n as logger, t as HttpActionRouter } from "../router-BxaxEEu3.mjs";
-import { t as validateCommerceAppConfig } from "../validate-qRpfubPo.mjs";
+import { t as validateCommerceAppConfig } from "../validate-CqJdGzyZ.mjs";
 import { ok } from "@adobe/aio-commerce-lib-core/responses";
 
 //#region source/actions/app-config.ts

package/dist/es/actions/config.d.mts

@@ -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 { BusinessConfigSchema } from "@adobe/aio-commerce-lib-config";
 import { RuntimeActionParams } from "@adobe/aio-commerce-lib-core/params";
 
@@ -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/es/actions/config.mjs

@@ -13,8 +13,8 @@
  */
 
 import { n as logger, t as HttpActionRouter } from "../router-BxaxEEu3.mjs";
-import { n as validateCommerceAppConfigDomain } from "../validate-qRpfubPo.mjs";
-import { r as nonEmptyStringValueSchema } from "../schemas-BvPxQwgQ.mjs";
+import { n as validateCommerceAppConfigDomain } from "../validate-CqJdGzyZ.mjs";
+import { r as nonEmptyStringValueSchema } from "../schemas-CVXHgUhv.mjs";
 import { ok } from "@adobe/aio-commerce-lib-core/responses";
 import * as v from "valibot";
 import { byScopeId, getConfiguration, initialize, setConfiguration } from "@adobe/aio-commerce-lib-config";
@@ -57,7 +57,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: v.object({
 		scopeId: nonEmptyStringValueSchema("scopeId"),
@@ -71,8 +75,35 @@ router.put("/", {
 		const { configSchema } = rawParams;
 		logger.debug(`Setting configuration with scope id: ${req.body.scopeId}`);
 		const { scopeId, config } = req.body;
+		initialize({ schema: validateCommerceAppConfigDomain(configSchema, "businessConfig.schema") });
 		const result = await setConfiguration({ config: config.filter((item) => item.value !== MASKED_PASSWORD_VALUE) }, byScopeId(scopeId), { encryptionKey: rawParams.AIO_COMMERCE_CONFIG_ENCRYPTION_KEY });
 		result.config = filterPasswordFields(configSchema, result.config);
+		return ok({
+			body: result,
+			headers: {
+				"Cache-Control": "no-store",
+				Deprecation: "Wed, 15 Apr 2026 00:00:00 GMT"
+			}
+		});
+	}
+});
+/** PATCH / - Partially update configuration */
+router.patch("/", {
+	body: v.object({
+		scopeId: nonEmptyStringValueSchema("scopeId"),
+		config: v.array(v.object({
+			name: nonEmptyStringValueSchema("config.name"),
+			value: v.nullable(v.union([v.string(), v.array(v.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;
+		initialize({ schema: validateCommerceAppConfigDomain(configSchema, "businessConfig.schema") });
+		const result = await setConfiguration({ config }, byScopeId(scopeId), { encryptionKey: rawParams.AIO_COMMERCE_CONFIG_ENCRYPTION_KEY });
+		result.config = filterPasswordFields(configSchema, result.config);
 		return ok({
 			body: result,
 			headers: { "Cache-Control": "no-store" }

package/dist/es/actions/installation.d.mts

@@ -12,9 +12,9 @@
  * governing permissions and limitations under the License.
  */
 
-import { n as CommerceAppConfigOutputModel } from "../app-Ct7Y0NP8.mjs";
-import { V as InstallationContext } from "../index-D33OCH0D.mjs";
-import * as _adobe_aio_commerce_lib_core_responses0 from "@adobe/aio-commerce-lib-core/responses";
+import { n as CommerceAppConfigOutputModel } from "../app-DJr-mN9d.mjs";
+import { q as InstallationContext } from "../index-BENO5T7n.mjs";
+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/es/actions/installation.mjs

@@ -13,8 +13,8 @@
  */
 
 import { n as logger, t as HttpActionRouter } from "../router-BxaxEEu3.mjs";
-import { r as nonEmptyStringValueSchema } from "../schemas-BvPxQwgQ.mjs";
-import { a as isCompletedState, c as isSucceededState, n as runInstallation, o as isFailedState, r as runValidation, s as isInProgressState, t as createInitialInstallationState } from "../management-CIoVWirU.mjs";
+import { r as nonEmptyStringValueSchema } from "../schemas-CVXHgUhv.mjs";
+import { a as runValidation, c as isFailedState, i as runUninstallation, l as isInProgressState, n as createInitialUninstallationState, r as runInstallation, s as isCompletedState, t as createInitialInstallationState, u as isSucceededState } from "../management-ByHvVJ12.mjs";
 import { accepted, badRequest, conflict, internalServerError, noContent, ok } from "@adobe/aio-commerce-lib-core/responses";
 import * as v from "valibot";
 import { object, string } from "valibot";
@@ -266,21 +266,68 @@ const InstallationRequestBodySchema = object({
 	ioEventsUrl: string(),
 	ioEventsEnv: 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: 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 ok({ body: state });
+	}
+	logFn("No state found");
+	return noContent();
+}
+/**
 * Creates hooks to sync installation state to storage.
 */
 function createInstallationHooks(store, logFn) {
@@ -301,9 +348,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 HttpActionRouter().use(logger({ name: () => "installation" }));
 /**
@@ -316,13 +368,7 @@ const router = new HttpActionRouter().use(logger({ name: () => "installation" })
 */
 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 ok({ body: state });
-	}
-	logger.debug("No execution found");
-	return noContent();
+	return readStateFromStore(await createInstallationStore(), (msg) => logger.debug(msg));
 } });
 /**
 * POST / - Start installation
@@ -354,17 +400,14 @@ router.post("/", {
 		const initialState = createInitialInstallationState({ config: appConfig });
 		logger.debug(`Created initial state: ${initialState.id}`);
 		await store.put(getStorageKey(), initialState);
-		const activation = await openwhisk().actions.invoke({
+		const ow = openwhisk();
+		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",
@@ -386,18 +429,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 badRequest("initialState is required for execution");
 	if (!appConfig) return 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 runInstallation({
 		installationContext,
@@ -432,14 +470,7 @@ router.post("/validation", {
 		logger.debug("Running pre-installation validation...");
 		const appConfig = rawParams.appConfig;
 		if (!appConfig) return 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 runValidation({
 			validationContext: {
 				appData,
@@ -453,14 +484,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 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 && isInProgressState(existingState)) {
+			logger.debug(`Uninstallation already in progress: ${existingState.status}`);
+			return conflict("Uninstallation is already in progress. Wait for it to complete.");
+		}
+		const initialState = 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 openwhisk().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 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 badRequest("initialState is required for execution");
+	if (!appConfig) return 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 runUninstallation({
+		installationContext,
+		config: appConfig,
+		initialState,
+		hooks
+	});
+	await store.put(getStorageKey(), result);
+	logger.debug(`Uninstallation completed: ${result.status}`);
+	if (isSucceededState(result)) {
+		await (await createInstallationStore()).delete(getStorageKey());
+		logger.debug("Cleared installation state after successful uninstallation");
+	}
+	if (isFailedState(result)) return internalServerError({ body: {
+		message: "Uninstallation failed",
+		error: result.error,
+		state: result
+	} });
+	return 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 noContent();
 } });
 /** Factory to create the route handler for the `installation` action. */

package/dist/es/actions/scope-tree.d.mts

@@ -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/es/actions/scope-tree.mjs

@@ -13,7 +13,7 @@
  */
 
 import { n as logger, t as HttpActionRouter } from "../router-BxaxEEu3.mjs";
-import { r as nonEmptyStringValueSchema } from "../schemas-BvPxQwgQ.mjs";
+import { r as nonEmptyStringValueSchema } from "../schemas-CVXHgUhv.mjs";
 import { t as inspect } from "../logging-XIUXDK5T.mjs";
 import { internalServerError, nonAuthoritativeInformation, ok } from "@adobe/aio-commerce-lib-core/responses";
 import * as v from "valibot";

package/dist/es/{app-Ct7Y0NP8.d.mts → app-DJr-mN9d.d.mts}

@@ -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/es/commands/index.mjs

@@ -13,9 +13,9 @@
  * governing permissions and limitations under the License.
  */
 
-import { c as hasBusinessConfigSchema, i as getConfigDomains, t as validateCommerceAppConfig } from "../validate-qRpfubPo.mjs";
-import { a as hasCustomInstallationSteps } from "../webhooks-NgM6k3_r.mjs";
-import { a as findNearestPackageJson, c as isESM, i as detectPackageManager, l as makeOutputDirFor, n as readCommerceAppConfig, o as getExecCommand, s as getProjectRootDirectory, t as parseCommerceAppConfig, u as readPackageJson } from "../config-BbrkH0Xt.mjs";
+import { a as hasCustomInstallationSteps } from "../webhooks-CYo-pqbR.mjs";
+import { c as hasBusinessConfigSchema, i as getConfigDomains, t as validateCommerceAppConfig } from "../validate-CqJdGzyZ.mjs";
+import { a as findNearestPackageJson, c as isESM, i as detectPackageManager, l as makeOutputDirFor, n as readCommerceAppConfig, o as getExecCommand, s as getProjectRootDirectory, t as parseCommerceAppConfig, u as readPackageJson } from "../config-BohwKkQS.mjs";
 import { t as stringifyError } from "../error-DHlYzkbb.mjs";
 import { t as inspect } from "../logging-XIUXDK5T.mjs";
 import { CommerceSdkValidationError } from "@adobe/aio-commerce-lib-core/error";