@adobe/aio-commerce-lib-app 1.3.1 → 1.5.0

package/CHANGELOG.md

@@ -1,5 +1,58 @@
 # @adobe/aio-commerce-lib-app
 
+## 1.5.0
+
+### Minor Changes
+
+- [#345](https://github.com/adobe/aio-commerce-sdk/pull/345) [`38adb09`](https://github.com/adobe/aio-commerce-sdk/commit/38adb09e1e2bd1b8fa764ecc2e0d21ecc0071ca7) Thanks [@iivvaannxx](https://github.com/iivvaannxx)! - Drop Node 20 support (EOL April 2026).
+
+### Patch Changes
+
+- Updated dependencies [[`38adb09`](https://github.com/adobe/aio-commerce-sdk/commit/38adb09e1e2bd1b8fa764ecc2e0d21ecc0071ca7)]:
+  - @adobe/aio-commerce-lib-api@1.2.0
+  - @adobe/aio-commerce-lib-auth@1.1.0
+  - @adobe/aio-commerce-lib-config@1.4.0
+  - @adobe/aio-commerce-lib-core@1.1.0
+  - @adobe/aio-commerce-lib-events@1.2.0
+  - @adobe/aio-commerce-lib-webhooks@1.1.0
+
+## 1.4.0
+
+### Minor Changes
+
+- [#402](https://github.com/adobe/aio-commerce-sdk/pull/402) [`e824ef6`](https://github.com/adobe/aio-commerce-sdk/commit/e824ef6f0d1da56f95b6830966e4f05d8168545d) Thanks [@oshmyheliuk](https://github.com/oshmyheliuk)! - Add full Admin UI SDK support: generate the `commerce/backend-ui/1` registration action from `adminUiSdk.registration` config, covering menu items, mass actions, grid columns, view buttons, custom fees, and banner notifications.
+
+- [#418](https://github.com/adobe/aio-commerce-sdk/pull/418) [`402948e`](https://github.com/adobe/aio-commerce-sdk/commit/402948eaeaba09ecd8397ed3b9b7ba1c8f6114c4) Thanks [@vinayrao2000](https://github.com/vinayrao2000)! - Support ability to filter configuration fields of applications by the Commerce environment where they are installed.
+
+- [#392](https://github.com/adobe/aio-commerce-sdk/pull/392) [`9ccbbde`](https://github.com/adobe/aio-commerce-sdk/commit/9ccbbdeb7bfca645d1b2b5750b18f36a16f59d82) Thanks [@asalloum5](https://github.com/asalloum5)! - Support boolean field in PATCH config values
+
+### Patch Changes
+
+- [#403](https://github.com/adobe/aio-commerce-sdk/pull/403) [`dd249cc`](https://github.com/adobe/aio-commerce-sdk/commit/dd249cca536e4a26ae6fff042e6e776f81dcc608) Thanks [@iivvaannxx](https://github.com/iivvaannxx)! - Improve error logging and fix an issue where the project root directory was not derived correctly in some situations.
+
+- [#443](https://github.com/adobe/aio-commerce-sdk/pull/443) [`7cb6bb5`](https://github.com/adobe/aio-commerce-sdk/commit/7cb6bb59887a4f3109ace7078de0b3fc1f20c94c) Thanks [@obarcelonap](https://github.com/obarcelonap)! - Mark Admin UI SDK APIs as experimental.
+
+- [#393](https://github.com/adobe/aio-commerce-sdk/pull/393) [`aeb0411`](https://github.com/adobe/aio-commerce-sdk/commit/aeb0411521c0cd8bc9e878beb160eeb92e98d090) Thanks [@oshmyheliuk](https://github.com/oshmyheliuk)! - Improve installation and uninstallation error messages: HTTP API errors from Commerce and Adobe IO Events now include the response body in the error message, making it clearer which entity failed and why.
+
+- [#440](https://github.com/adobe/aio-commerce-sdk/pull/440) [`83879b6`](https://github.com/adobe/aio-commerce-sdk/commit/83879b64d399ce790842dfb21dad3fa34992c0d1) Thanks [@jcuerdo](https://github.com/jcuerdo)! - Installation now retries once on failure. The retry resumes from the failed step, preserving progress from the first attempt. When a retry was attempted, the final state (whether succeeded or failed) includes `metadata: { isRetry: true }`.
+
+- [#444](https://github.com/adobe/aio-commerce-sdk/pull/444) [`6d61ce6`](https://github.com/adobe/aio-commerce-sdk/commit/6d61ce6182f19269c33bd92d63e9befcec1ff5ac) Thanks [@oshmyheliuk](https://github.com/oshmyheliuk)! - Fix event subscriptions failing with 400 when a Commerce event provider exists with the same instance ID but a stale provider ID from a previous installation.
+
+  Add character validation to provider and event label/description fields in the eventing schema, rejecting values with characters not accepted by the Adobe I/O Events API (valid characters: letters, numbers, spaces, underscores, hyphens, dots, colons, parentheses, commas, @, and /).
+
+  Add validation for at least one field requirement in the Commerce event `fields` arrays.
+
+- [#405](https://github.com/adobe/aio-commerce-sdk/pull/405) [`775860b`](https://github.com/adobe/aio-commerce-sdk/commit/775860bdf654b2fedeffeaa328a110dfc10daa85) Thanks [@iivvaannxx](https://github.com/iivvaannxx)! - Fix hook and post-install scripts failing to resolve CLI binaries under pnpm and yarn. Generated commands now use `pnpm exec` / `yarn exec` instead of `pnpx` / `yarn dlx`, which bypass local `node_modules/.bin` resolution.
+
+- [#403](https://github.com/adobe/aio-commerce-sdk/pull/403) [`dd249cc`](https://github.com/adobe/aio-commerce-sdk/commit/dd249cca536e4a26ae6fff042e6e776f81dcc608) Thanks [@iivvaannxx](https://github.com/iivvaannxx)! - Regenerate action source code during the `pre-app-build` hook.
+
+- Updated dependencies [[`aa2ac1a`](https://github.com/adobe/aio-commerce-sdk/commit/aa2ac1a33df543c7f62675f1c920722969fc0a30), [`775860b`](https://github.com/adobe/aio-commerce-sdk/commit/775860bdf654b2fedeffeaa328a110dfc10daa85), [`402948e`](https://github.com/adobe/aio-commerce-sdk/commit/402948eaeaba09ecd8397ed3b9b7ba1c8f6114c4), [`aeb0411`](https://github.com/adobe/aio-commerce-sdk/commit/aeb0411521c0cd8bc9e878beb160eeb92e98d090), [`9ccbbde`](https://github.com/adobe/aio-commerce-sdk/commit/9ccbbdeb7bfca645d1b2b5750b18f36a16f59d82), [`3207ff2`](https://github.com/adobe/aio-commerce-sdk/commit/3207ff247b06c4889795d50f82e219eec70d6b16), [`dd249cc`](https://github.com/adobe/aio-commerce-sdk/commit/dd249cca536e4a26ae6fff042e6e776f81dcc608)]:
+  - @adobe/aio-commerce-lib-webhooks@1.0.0
+  - @adobe/aio-commerce-lib-config@1.3.0
+  - @adobe/aio-commerce-lib-auth@1.0.2
+  - @adobe/aio-commerce-lib-api@1.1.0
+  - @adobe/aio-commerce-lib-events@1.1.1
+
 ## 1.3.1
 
 ### Patch Changes

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

@@ -13,9 +13,9 @@
  */
 
 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-CeUCT_7k.cjs');
+const require_chunk = require('../chunk-DS2yp5vX.cjs');
+const require_router = require('../router-CFErodHU.cjs');
+const require_validate = require('../validate-b_bI4mDb.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,7 +12,7 @@
  * governing permissions and limitations under the License.
  */
 
-import { n as CommerceAppConfigOutputModel } from "../app-DcQMhW2N.cjs";
+import { n as CommerceAppConfigOutputModel } from "../app-C6kImBl7.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";
 

package/dist/cjs/actions/config.cjs

@@ -13,16 +13,29 @@
  */
 
 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-CeUCT_7k.cjs');
+const require_chunk = require('../chunk-DS2yp5vX.cjs');
+const require_router = require('../router-CFErodHU.cjs');
+const require_schemas = require('../schemas-CukVpc19.cjs');
+const require_validate = require('../validate-b_bI4mDb.cjs');
 let _adobe_aio_commerce_lib_core_responses = require("@adobe/aio-commerce-lib-core/responses");
 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/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.
@@ -41,20 +54,25 @@ function filterPasswordFields(schema, values) {
 const router = new require_router.HttpActionRouter().use(require_router.logger());
 /** GET / - Retrieve configuration */
 router.get("/", {
-	query: valibot.object({ scopeId: require_schemas.nonEmptyStringValueSchema("scopeId") }),
+	query: valibot.object({
+		scopeId: require_schemas.nonEmptyStringValueSchema("scopeId"),
+		commerceEnv: valibot.optional(valibot.picklist(COMMERCE_ENVS))
+	}),
 	handler: async (req, ctx) => {
 		const { logger, rawParams } = ctx;
 		const configSchema = rawParams.configSchema;
 		logger.debug("Validating configuration schema...");
 		const validatedSchema = require_validate.validateCommerceAppConfigDomain(configSchema, "businessConfig.schema");
-		(0, _adobe_aio_commerce_lib_config.initialize)({ schema: validatedSchema });
+		const env = req.query.commerceEnv;
+		const filteredSchema = env ? filterSchemaByEnv(validatedSchema, env) : validatedSchema;
+		(0, _adobe_aio_commerce_lib_config.initialize)({ schema: filteredSchema });
 		const { scopeId } = req.query;
 		logger.debug(`Retrieving configuration with scope id: ${scopeId}`);
 		const appConfiguration = await (0, _adobe_aio_commerce_lib_config.getConfiguration)((0, _adobe_aio_commerce_lib_config.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 (0, _adobe_aio_commerce_lib_core_responses.ok)({ body: {
-			schema: validatedSchema,
+			schema: filteredSchema,
 			values: appConfiguration
 		} });
 	}
@@ -95,7 +113,11 @@ router.patch("/", {
 		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())]))
+			value: valibot.nullable(valibot.union([
+				valibot.boolean(),
+				valibot.string(),
+				valibot.array(valibot.string())
+			]))
 		}))
 	}),
 	handler: async (req, ctx) => {

package/dist/cjs/actions/installation.cjs

@@ -13,16 +13,17 @@
  */
 
 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-C6xG5bfl.cjs');
+const require_chunk = require('../chunk-DS2yp5vX.cjs');
+const require_router = require('../router-CFErodHU.cjs');
+const require_schemas = require('../schemas-CukVpc19.cjs');
+const require_management = require('../management-D1QXg4YU.cjs');
 let _adobe_aio_commerce_lib_core_responses = require("@adobe/aio-commerce-lib-core/responses");
 let valibot = require("valibot");
-valibot = require_schemas.__toESM(valibot);
+valibot = require_chunk.__toESM(valibot, 1);
 let _adobe_aio_lib_files = require("@adobe/aio-lib-files");
 let _adobe_aio_lib_state = require("@adobe/aio-lib-state");
 let openwhisk = require("openwhisk");
-openwhisk = require_schemas.__toESM(openwhisk);
+openwhisk = require_chunk.__toESM(openwhisk, 1);
 
 //#region ../../packages-private/common-utils/source/storage/files-store.ts
 /** Default directory prefix. */
@@ -340,10 +341,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)
 	};
 }
 /**
@@ -383,7 +384,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) {
@@ -432,13 +434,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 (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 = 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 require_management.runInstallation({
 		installationContext,
 		config: appConfig,
@@ -507,7 +509,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 (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();
@@ -552,13 +555,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 (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}`);
+	logger.debug(`Executing uninstallation ${initialState.id} for app "${appData.projectName}" (workspace: "${appData.workspaceName}", commerce: "${AIO_COMMERCE_API_BASE_URL}")`);
 	const result = await require_management.runUninstallation({
 		installationContext,
 		config: appConfig,

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

@@ -12,8 +12,8 @@
  * governing permissions and limitations under the License.
  */
 
-import { n as CommerceAppConfigOutputModel } from "../app-DcQMhW2N.cjs";
-import { q as InstallationContext } from "../index-BVwQk9bx.cjs";
+import { n as CommerceAppConfigOutputModel } from "../app-C6kImBl7.cjs";
+import { o as InstallationContext } from "../step-CWYnKbga.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";
 

package/dist/cjs/actions/registration.cjs

@@ -0,0 +1,41 @@
+/**
+ * @license
+ *
+ * Copyright 2026 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_chunk = require('../chunk-DS2yp5vX.cjs');
+const require_router = require('../router-CFErodHU.cjs');
+let _adobe_aio_commerce_lib_core_responses = require("@adobe/aio-commerce-lib-core/responses");
+
+//#region source/actions/registration.ts
+/** Router for the registration action. */
+const router = new require_router.HttpActionRouter().use(require_router.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 (0, _adobe_aio_commerce_lib_core_responses.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
+exports.registrationRuntimeAction = registrationRuntimeAction;

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

@@ -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-BiSopnKI.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/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/cjs/actions/scope-tree.cjs

@@ -13,12 +13,13 @@
  */
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_schemas = require('../schemas-nkIxa8sL.cjs');
-const require_router = require('../router-KeQRduO3.cjs');
-const require_logging = require('../logging-4s36JTiN.cjs');
+const require_chunk = require('../chunk-DS2yp5vX.cjs');
+const require_router = require('../router-CFErodHU.cjs');
+const require_schemas = require('../schemas-CukVpc19.cjs');
+const require_logging = require('../logging-BTevALnL.cjs');
 let _adobe_aio_commerce_lib_core_responses = require("@adobe/aio-commerce-lib-core/responses");
 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");
 let _adobe_aio_commerce_lib_api = require("@adobe/aio-commerce-lib-api");