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

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

@@ -12,11 +12,12 @@
  * governing permissions and limitations under the License.
  */
 
-const require_schemas = require('./schemas-nkIxa8sL.cjs');
-const require_webhooks = require('./webhooks-CLtDxwMa.cjs');
+const require_chunk = require('./chunk-DS2yp5vX.cjs');
+const require_schemas = require('./schemas-CukVpc19.cjs');
+const require_webhooks = require('./webhooks-DS1BtgED.cjs');
 let _adobe_aio_commerce_lib_core_error = require("@adobe/aio-commerce-lib-core/error");
 let valibot = require("valibot");
-valibot = require_schemas.__toESM(valibot);
+valibot = require_chunk.__toESM(valibot, 1);
 let _adobe_aio_commerce_lib_config = require("@adobe/aio-commerce-lib-config");
 
 //#region source/config/schema/business-configuration.ts

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

@@ -12,26 +12,156 @@
  * governing permissions and limitations under the License.
  */
 
-const require_schemas = require('./schemas-nkIxa8sL.cjs');
+const require_chunk = require('./chunk-DS2yp5vX.cjs');
+const require_schemas = require('./schemas-CukVpc19.cjs');
 let valibot = require("valibot");
-valibot = require_schemas.__toESM(valibot);
+valibot = require_chunk.__toESM(valibot, 1);
 
 //#region source/config/schema/admin-ui-sdk.ts
+const SANDBOX_VALUES = [
+	"allow-downloads",
+	"allow-modals",
+	"allow-popups"
+];
+function isSandboxValue(value) {
+	return SANDBOX_VALUES.includes(value);
+}
+const SandboxSchema = valibot.pipe(valibot.string("Expected a string value for \"sandbox\""), valibot.check((val) => val.split(" ").every(isSandboxValue), `sandbox must contain only single-space-separated values from: ${SANDBOX_VALUES.map((t) => `"${t}"`).join(", ")}`));
+const ColumnTypeSchema = valibot.picklist([
+	"boolean",
+	"date",
+	"float",
+	"integer",
+	"string"
+]);
+const ColumnAlignSchema = valibot.picklist([
+	"left",
+	"right",
+	"center"
+]);
+const ViewButtonLevelSchema = valibot.picklist([
+	-1,
+	0,
+	1
+]);
+const MassActionConfirmSchema = valibot.object({
+	title: valibot.optional(require_schemas.nonEmptyStringValueSchema("confirm title")),
+	message: valibot.optional(require_schemas.nonEmptyStringValueSchema("confirm message"))
+});
+const ViewButtonConfirmSchema = valibot.object({ message: valibot.optional(require_schemas.nonEmptyStringValueSchema("confirm message")) });
+const iframeActionEntries = {
+	displayIframe: valibot.optional(require_schemas.booleanValueSchema("displayIframe")),
+	timeout: valibot.optional(require_schemas.positiveNumberValueSchema("timeout")),
+	sandbox: valibot.optional(SandboxSchema)
+};
+const GridColumnPropertySchema = valibot.object({
+	label: require_schemas.nonEmptyStringValueSchema("column label"),
+	columnId: require_schemas.nonEmptyStringValueSchema("column ID"),
+	type: ColumnTypeSchema,
+	align: ColumnAlignSchema
+});
+const GridColumnsSchema = valibot.object({
+	data: valibot.object({ meshId: require_schemas.nonEmptyStringValueSchema("mesh ID") }),
+	properties: valibot.pipe(valibot.array(GridColumnPropertySchema), valibot.minLength(1, "At least one grid column property is required"))
+});
+const massActionBaseEntries = {
+	actionId: require_schemas.nonEmptyStringValueSchema("mass action ID"),
+	label: require_schemas.nonEmptyStringValueSchema("mass action label"),
+	title: valibot.optional(require_schemas.nonEmptyStringValueSchema("mass action page title")),
+	confirm: valibot.optional(MassActionConfirmSchema),
+	path: require_schemas.nonEmptyStringValueSchema("mass action path"),
+	...iframeActionEntries
+};
+const sandboxDisplayIframeCheck = valibot.forward(valibot.partialCheck([["sandbox"], ["displayIframe"]], (input) => input.sandbox === void 0 || input.displayIframe === true, "sandbox is only relevant when displayIframe is set to true"), ["sandbox"]);
+function withSandboxDisplayIframeCheck(schema) {
+	return valibot.pipe(schema, sandboxDisplayIframeCheck);
+}
+function createMassActionSchema(variantEntries) {
+	return withSandboxDisplayIframeCheck(valibot.strictObject({
+		...massActionBaseEntries,
+		...variantEntries
+	}));
+}
+const OrderMassActionSchema = createMassActionSchema({ selectionLimit: valibot.optional(require_schemas.positiveNumberValueSchema("selectionLimit")) });
+const ProductMassActionSchema = createMassActionSchema({ productSelectLimit: valibot.optional(require_schemas.positiveNumberValueSchema("productSelectLimit")) });
+const CustomerMassActionSchema = createMassActionSchema({ customerSelectLimit: valibot.optional(require_schemas.positiveNumberValueSchema("customerSelectLimit")) });
+const OrderViewButtonSchema = withSandboxDisplayIframeCheck(valibot.object({
+	buttonId: require_schemas.nonEmptyStringValueSchema("view button ID"),
+	label: require_schemas.nonEmptyStringValueSchema("view button label"),
+	confirm: valibot.optional(ViewButtonConfirmSchema),
+	path: require_schemas.nonEmptyStringValueSchema("view button path"),
+	level: valibot.optional(ViewButtonLevelSchema),
+	sortOrder: valibot.optional(require_schemas.positiveNumberValueSchema("sortOrder")),
+	...iframeActionEntries
+}));
+const CustomFeeSchema = valibot.object({
+	id: require_schemas.nonEmptyStringValueSchema("custom fee ID"),
+	label: require_schemas.nonEmptyStringValueSchema("custom fee label"),
+	value: valibot.number("Custom fee value must be a number"),
+	orderMinimumAmount: valibot.optional(valibot.number("orderMinimumAmount must be a number")),
+	applyFeeOnLastInvoice: valibot.optional(require_schemas.booleanValueSchema("applyFeeOnLastInvoice")),
+	applyFeeOnLastCreditMemo: valibot.optional(require_schemas.booleanValueSchema("applyFeeOnLastCreditMemo"))
+});
+const OrderExtensionPointsSchema = valibot.object({
+	massActions: valibot.optional(valibot.array(OrderMassActionSchema)),
+	gridColumns: valibot.optional(GridColumnsSchema),
+	viewButtons: valibot.optional(valibot.array(OrderViewButtonSchema)),
+	customFees: valibot.optional(valibot.array(CustomFeeSchema))
+});
+const ProductExtensionPointsSchema = valibot.object({
+	massActions: valibot.optional(valibot.array(ProductMassActionSchema)),
+	gridColumns: valibot.optional(GridColumnsSchema)
+});
+const CustomerExtensionPointsSchema = valibot.object({
+	massActions: valibot.optional(valibot.array(CustomerMassActionSchema)),
+	gridColumns: valibot.optional(GridColumnsSchema)
+});
+const MassActionBannerSchema = valibot.object({
+	actionId: require_schemas.nonEmptyStringValueSchema("mass action ID"),
+	successMessage: valibot.optional(require_schemas.nonEmptyStringValueSchema("success message")),
+	errorMessage: valibot.optional(require_schemas.nonEmptyStringValueSchema("error message"))
+});
+const OrderViewButtonBannerSchema = valibot.object({
+	buttonId: require_schemas.nonEmptyStringValueSchema("view button ID"),
+	successMessage: valibot.optional(require_schemas.nonEmptyStringValueSchema("success message")),
+	errorMessage: valibot.optional(require_schemas.nonEmptyStringValueSchema("error message"))
+});
+const BannerNotificationSchema = valibot.object({
+	massActions: valibot.optional(valibot.object({
+		order: valibot.optional(valibot.array(MassActionBannerSchema)),
+		product: valibot.optional(valibot.array(MassActionBannerSchema)),
+		customer: valibot.optional(valibot.array(MassActionBannerSchema))
+	})),
+	orderViewButtons: valibot.optional(valibot.array(OrderViewButtonBannerSchema))
+});
+const MenuItemSchema = valibot.object({
+	id: require_schemas.nonEmptyStringValueSchema("menu item ID"),
+	title: valibot.optional(require_schemas.nonEmptyStringValueSchema("menu item title")),
+	parent: valibot.optional(require_schemas.nonEmptyStringValueSchema("menu item parent")),
+	sortOrder: valibot.optional(valibot.number()),
+	isSection: valibot.optional(require_schemas.booleanValueSchema("isSection")),
+	sandbox: valibot.optional(SandboxSchema)
+});
 /**
 * 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 AdminUiSdkRegistrationSchema = valibot.object({
+	menuItems: valibot.optional(valibot.array(MenuItemSchema)),
+	order: valibot.optional(OrderExtensionPointsSchema),
+	product: valibot.optional(ProductExtensionPointsSchema),
+	customer: valibot.optional(CustomerExtensionPointsSchema),
+	bannerNotification: valibot.optional(BannerNotificationSchema)
+});
+/**
+* Schema for Admin UI SDK configuration.
+* @experimental
+*/
 const AdminUiSdkSchema = valibot.object({ registration: AdminUiSdkRegistrationSchema });
-/** Check if config has Admin UI SDK registration configuration. */
+/**
+* Check if config has Admin UI SDK registration configuration.
+* @experimental
+*/
 function hasAdminUiSdk(config) {
 	return config.adminUiSdk !== void 0 && config.adminUiSdk.registration !== void 0;
 }
@@ -61,6 +191,12 @@ const EXTERNAL_EVENT_NAME_REGEX = /^[\w\-_.]+$/;
 */
 const FIELD_NAME_REGEX = /^([a-zA-Z0-9_\-.[\]]+|\*)$/;
 /**
+* Regex for Adobe I/O Events API text fields (label, description).
+* Valid characters per API: letters, numbers, spaces, underscores, hyphens,
+* dots, colons, parentheses, commas, @, and /.
+*/
+const IO_EVENTS_TEXT_REGEX = /^[a-zA-Z0-9 _.:()\-,@/]+$/;
+/**
 * Schema for Commerce event names.
 * Validates that the event name starts with "plugin." or "observer."
 * followed by one or more dot-separated lowercase segments containing letters
@@ -85,6 +221,10 @@ function externalEventNameSchema() {
 function fieldNameSchema() {
 	return valibot.pipe(require_schemas.nonEmptyStringValueSchema("field name"), valibot.regex(FIELD_NAME_REGEX, "Field name must contain only letters (a-z, A-Z), numbers (0-9), underscores (_), dashes (-), dots (.), and square brackets ([, ]), or be exactly \"*\""));
 }
+/** Validates that a text field contains only characters accepted by the Adobe I/O Events API. */
+function ioEventsTextSchema(name) {
+	return valibot.regex(IO_EVENTS_TEXT_REGEX, `${name} can only contain letters, numbers, spaces, underscores, hyphens, dots, colons, parentheses, commas, @, and /`);
+}
 /**
 * Schema for field objects in Commerce events.
 * Each field has a required name and an optional source.
@@ -97,14 +237,14 @@ function commerceEventFieldSchema() {
 }
 /** Schema for event provider configuration */
 const ProviderSchema = valibot.object({
-	label: valibot.pipe(require_schemas.nonEmptyStringValueSchema("provider label"), valibot.maxLength(MAX_LABEL_LENGTH, `The provider label must not be longer than ${MAX_LABEL_LENGTH} characters`)),
-	description: valibot.pipe(require_schemas.nonEmptyStringValueSchema("provider description"), valibot.maxLength(MAX_DESCRIPTION_LENGTH$1, `The provider description must not be longer than ${MAX_DESCRIPTION_LENGTH$1} characters`)),
+	label: valibot.pipe(require_schemas.nonEmptyStringValueSchema("provider label"), ioEventsTextSchema("Provider label"), valibot.maxLength(MAX_LABEL_LENGTH, `The provider label must not be longer than ${MAX_LABEL_LENGTH} characters`)),
+	description: valibot.pipe(require_schemas.nonEmptyStringValueSchema("provider description"), ioEventsTextSchema("Provider description"), valibot.maxLength(MAX_DESCRIPTION_LENGTH$1, `The provider description must not be longer than ${MAX_DESCRIPTION_LENGTH$1} characters`)),
 	key: valibot.optional(valibot.pipe(require_schemas.alphaNumericOrHyphenSchema("provider key"), valibot.maxLength(MAX_KEY_LENGTH, `The provider key must not be longer than ${MAX_KEY_LENGTH} characters`)))
 });
 /** Schema for base shared properties between event types. */
 const BaseEventSchema = valibot.object({
-	label: valibot.pipe(require_schemas.nonEmptyStringValueSchema("event label"), valibot.maxLength(MAX_LABEL_LENGTH, `The event label must not be longer than ${MAX_LABEL_LENGTH} characters`)),
-	description: valibot.pipe(require_schemas.nonEmptyStringValueSchema("event description"), valibot.maxLength(MAX_DESCRIPTION_LENGTH$1, `The event description must not be longer than ${MAX_DESCRIPTION_LENGTH$1} characters`)),
+	label: valibot.pipe(require_schemas.nonEmptyStringValueSchema("event label"), ioEventsTextSchema("Event label"), valibot.maxLength(MAX_LABEL_LENGTH, `The event label must not be longer than ${MAX_LABEL_LENGTH} characters`)),
+	description: valibot.pipe(require_schemas.nonEmptyStringValueSchema("event description"), ioEventsTextSchema("Event description"), valibot.maxLength(MAX_DESCRIPTION_LENGTH$1, `The event description must not be longer than ${MAX_DESCRIPTION_LENGTH$1} characters`)),
 	runtimeActions: valibot.array(valibot.pipe(require_schemas.nonEmptyStringValueSchema("runtime action"), valibot.regex(/^[a-z0-9-]+\/[a-z0-9-]+$/i, "Runtime action must be in the format \"<package>/<action>\" (e.g., \"my-package/my-action\")")), "Expected an array of runtime actions in the format <package>/<action>")
 });
 /**
@@ -130,7 +270,7 @@ const CommerceEventRuleSchema = valibot.object({
 const CommerceEventSchema = valibot.object({
 	...BaseEventSchema.entries,
 	name: commerceEventNameSchema(),
-	fields: valibot.array(commerceEventFieldSchema(), "Expected an array of event field objects with a 'name' property"),
+	fields: valibot.pipe(valibot.array(commerceEventFieldSchema(), "Expected an array of event field objects with a 'name' property"), valibot.minLength(1, "The Commerce event configuration must define at least one field")),
 	rules: valibot.optional(valibot.array(CommerceEventRuleSchema, "Expected an array of event rules with field, operator, and value")),
 	destination: valibot.optional(require_schemas.nonEmptyStringValueSchema("destination")),
 	hipaa_audit_required: valibot.optional(require_schemas.booleanValueSchema("hipaa_audit_required")),

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

@@ -12,7 +12,7 @@
  * governing permissions and limitations under the License.
  */
 
-import { n as CommerceAppConfigOutputModel } from "../app-DJr-mN9d.mjs";
+import { n as CommerceAppConfigOutputModel } from "../app-DcY6dJiQ.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";
 

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-CqJdGzyZ.mjs";
+import { t as validateCommerceAppConfig } from "../validate-Dn3lLTGj.mjs";
 import { ok } from "@adobe/aio-commerce-lib-core/responses";
 
 //#region source/actions/app-config.ts

package/dist/es/actions/config.mjs

@@ -13,14 +13,26 @@
  */
 
 import { n as logger, t as HttpActionRouter } from "../router-BxaxEEu3.mjs";
-import { n as validateCommerceAppConfigDomain } from "../validate-CqJdGzyZ.mjs";
-import { r as nonEmptyStringValueSchema } from "../schemas-CVXHgUhv.mjs";
+import { r as nonEmptyStringValueSchema } from "../schemas-DOcnD16x.mjs";
+import { n as validateCommerceAppConfigDomain } from "../validate-Dn3lLTGj.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";
 
 //#region source/actions/config.ts
 const MASKED_PASSWORD_VALUE = "*****";
+/** The set of valid Commerce environments a configuration field can be scoped to. */
+const COMMERCE_ENVS = ["paas", "saas"];
+/**
+* Filters a business configuration schema to the fields applicable to the
+* given Commerce environment. Fields without an `env` property apply to all
+* environments and are always included.
+* @param schema - The business configuration schema to filter.
+* @param env - The Commerce environment to filter by.
+*/
+function filterSchemaByEnv(schema, env) {
+	return schema.filter((field) => field.env === void 0 || field.env.includes(env));
+}
 /**
 * Filters password fields from the configuration values.
 * @param schema - The schema to use to filter the values.
@@ -39,20 +51,25 @@ function filterPasswordFields(schema, values) {
 const router = new HttpActionRouter().use(logger());
 /** GET / - Retrieve configuration */
 router.get("/", {
-	query: v.object({ scopeId: nonEmptyStringValueSchema("scopeId") }),
+	query: v.object({
+		scopeId: nonEmptyStringValueSchema("scopeId"),
+		commerceEnv: v.optional(v.picklist(COMMERCE_ENVS))
+	}),
 	handler: async (req, ctx) => {
 		const { logger, rawParams } = ctx;
 		const configSchema = rawParams.configSchema;
 		logger.debug("Validating configuration schema...");
 		const validatedSchema = validateCommerceAppConfigDomain(configSchema, "businessConfig.schema");
-		initialize({ schema: validatedSchema });
+		const env = req.query.commerceEnv;
+		const filteredSchema = env ? filterSchemaByEnv(validatedSchema, env) : validatedSchema;
+		initialize({ schema: filteredSchema });
 		const { scopeId } = req.query;
 		logger.debug(`Retrieving configuration with scope id: ${scopeId}`);
 		const appConfiguration = await getConfiguration(byScopeId(scopeId), { encryptionKey: rawParams.AIO_COMMERCE_CONFIG_ENCRYPTION_KEY });
 		logger.debug("Masking password values...");
-		appConfiguration.config = filterPasswordFields(configSchema, appConfiguration.config);
+		appConfiguration.config = filterPasswordFields(filteredSchema, appConfiguration.config);
 		return ok({ body: {
-			schema: validatedSchema,
+			schema: filteredSchema,
 			values: appConfiguration
 		} });
 	}
@@ -93,7 +110,11 @@ router.patch("/", {
 		scopeId: nonEmptyStringValueSchema("scopeId"),
 		config: v.array(v.object({
 			name: nonEmptyStringValueSchema("config.name"),
-			value: v.nullable(v.union([v.string(), v.array(v.string())]))
+			value: v.nullable(v.union([
+				v.boolean(),
+				v.string(),
+				v.array(v.string())
+			]))
 		}))
 	}),
 	handler: async (req, ctx) => {

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

@@ -12,8 +12,8 @@
  * governing permissions and limitations under the License.
  */
 
-import { n as CommerceAppConfigOutputModel } from "../app-DJr-mN9d.mjs";
-import { q as InstallationContext } from "../index-BENO5T7n.mjs";
+import { n as CommerceAppConfigOutputModel } from "../app-DcY6dJiQ.mjs";
+import { o as InstallationContext } from "../step-0eI2x4C9.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";
 

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-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 { r as nonEmptyStringValueSchema } from "../schemas-DOcnD16x.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-CCsOfniv.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";
@@ -338,10 +338,10 @@ function createInstallationHooks(store, logFn) {
 	return {
 		onInstallationStart: (state) => logAndSave("Installation started", state),
 		onInstallationFailure: (state) => logAndSave("Installation failed", state),
-		onInstallationSuccess: (state) => logAndSave("Installation succeeded", state),
+		onInstallationSuccess: (state) => logAndSave(state.status === "succeeded" && state.metadata?.isRetry ? "Installation succeeded on retry" : "Installation succeeded", state),
 		onStepStart: (event, state) => logAndSave(`Step started: ${event.stepName}`, state),
 		onStepSuccess: (event, state) => logAndSave(`Step succeeded: ${event.stepName}`, state),
-		onStepFailure: (event, state) => logAndSave(`Step failed: ${event.stepName}`, state)
+		onStepFailure: (event, state) => logAndSave(`Step failed: ${event.stepName} — ${event.error.message ?? `(key: ${event.error.key})`}`, state)
 	};
 }
 /**
@@ -381,7 +381,8 @@ router.get("/", { handler: async (_req, { logger }) => {
 router.post("/", {
 	body: InstallationRequestBodySchema,
 	handler: async (req, { logger, rawParams }) => {
-		logger.debug("Starting installation...");
+		const { appData, commerceBaseUrl } = req.body;
+		logger.debug(`Starting installation for app "${appData.projectName}" (workspace: "${appData.workspaceName}", commerce: "${commerceBaseUrl}")`);
 		const store = await createInstallationStore();
 		const existingState = await store.get(getStorageKey());
 		if (existingState) {
@@ -430,13 +431,13 @@ router.post("/", {
 */
 router.post("/execution", { handler: async (_req, { logger, rawParams }) => {
 	const params = rawParams;
-	const { initialState, appConfig } = params;
+	const { initialState, appConfig, appData, AIO_COMMERCE_API_BASE_URL } = 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 = buildInstallationContext(params, appConfig, logger);
-	logger.debug(`Executing installation: ${initialState.id}`);
+	logger.debug(`Executing installation ${initialState.id} for app "${appData.projectName}" (workspace: "${appData.workspaceName}", commerce: "${AIO_COMMERCE_API_BASE_URL}")`);
 	const result = await runInstallation({
 		installationContext,
 		config: appConfig,
@@ -505,7 +506,8 @@ router.get("/uninstallation", { handler: async (_req, { logger }) => {
 router.post("/uninstallation", {
 	body: InstallationRequestBodySchema,
 	handler: async (req, { logger, rawParams }) => {
-		logger.debug("Starting async uninstallation...");
+		const { appData, commerceBaseUrl } = req.body;
+		logger.debug(`Starting uninstallation for app "${appData.projectName}" (workspace: "${appData.workspaceName}", commerce: "${commerceBaseUrl}")`);
 		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();
@@ -550,13 +552,13 @@ router.post("/uninstallation", {
 */
 router.post("/uninstallation/execution", { handler: async (_req, { logger, rawParams }) => {
 	const params = rawParams;
-	const { initialState, appConfig } = params;
+	const { initialState, appConfig, appData, AIO_COMMERCE_API_BASE_URL } = 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}`);
+	logger.debug(`Executing uninstallation ${initialState.id} for app "${appData.projectName}" (workspace: "${appData.workspaceName}", commerce: "${AIO_COMMERCE_API_BASE_URL}")`);
 	const result = await runUninstallation({
 		installationContext,
 		config: appConfig,

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

@@ -0,0 +1,33 @@
+/**
+ * @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 AdminUiSdkRegistration } from "../admin-ui-sdk-CCo2SWiL.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/registration.d.ts
+/** Arguments for the registration runtime action factory. */
+type RegistrationActionArgs = {
+  registration: AdminUiSdkRegistration;
+};
+/**
+ * Factory to create the route handler for the `registration` action.
+ * @param args - The registration configuration to inline in the action.
+ * @experimental
+ */
+declare const registrationRuntimeAction: ({
+  registration
+}: RegistrationActionArgs) => (params: RuntimeActionParams) => Promise<_$_adobe_aio_commerce_lib_core_responses0.ActionResponse>;
+//#endregion
+export { registrationRuntimeAction };

package/dist/es/actions/registration.mjs

@@ -0,0 +1,39 @@
+/**
+ * @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 logger, t as HttpActionRouter } from "../router-BxaxEEu3.mjs";
+import { ok } from "@adobe/aio-commerce-lib-core/responses";
+
+//#region source/actions/registration.ts
+/** Router for the registration action. */
+const router = new HttpActionRouter().use(logger({ name: () => "registration" }));
+/** GET / - Return Admin UI SDK registration object */
+router.get("/", { handler: async (_req, { logger, rawParams }) => {
+	logger.debug("Returning Admin UI SDK registration...");
+	return ok({ body: { registration: rawParams.registration } });
+} });
+/**
+* Factory to create the route handler for the `registration` action.
+* @param args - The registration configuration to inline in the action.
+* @experimental
+*/
+const registrationRuntimeAction = ({ registration }) => async (params) => {
+	return await router.handler()({
+		...params,
+		registration
+	});
+};
+
+//#endregion
+export { registrationRuntimeAction };

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-CVXHgUhv.mjs";
+import { r as nonEmptyStringValueSchema } from "../schemas-DOcnD16x.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";