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

package/dist/cjs/actions/{installation.cjs → installation/index.cjs}

@@ -13,13 +13,14 @@
  */
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-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");
+const require_chunk = require('../../chunk-Cozy-1ZF.cjs');
+const require_schemas = require('../../schemas-FngDuIeo.cjs');
+const require_management = require('../../management-Dehz9qSJ.cjs');
+const require_validate = require('../../validate-oAOpyFyb.cjs');
+const require_router = require('../../router-BOR7T6qR.cjs');
 let valibot = require("valibot");
 valibot = require_chunk.__toESM(valibot, 1);
+let _adobe_aio_commerce_lib_core_responses = require("@adobe/aio-commerce-lib-core/responses");
 let _adobe_aio_lib_files = require("@adobe/aio-lib-files");
 let _adobe_aio_lib_state = require("@adobe/aio-lib-state");
 let openwhisk = require("openwhisk");
@@ -259,16 +260,19 @@ const AppDataSchema = valibot.object({
 });
 
 //#endregion
-//#region source/actions/installation.ts
-const DEFAULT_ACTION_NAME = "app-management/installation";
-/** Request body schema shared by POST / and POST /validation. */
-const InstallationRequestBodySchema = (0, valibot.object)({
+//#region source/actions/installation/schema.ts
+/** Request body for POST / and POST /validation (shared shape) */
+const InstallationRequestBodySchema = valibot.object({
 	appData: AppDataSchema,
-	commerceBaseUrl: (0, valibot.string)(),
-	commerceEnv: (0, valibot.string)(),
-	ioEventsUrl: (0, valibot.string)(),
-	ioEventsEnv: (0, valibot.string)()
+	commerceBaseUrl: valibot.string(),
+	commerceEnv: valibot.string(),
+	ioEventsUrl: valibot.string(),
+	ioEventsEnv: valibot.string()
 });
+
+//#endregion
+//#region source/actions/installation/router.ts
+const DEFAULT_ACTION_NAME = "app-management/installation";
 /** Creates a workflow state store with the given prefix. */
 function createWorkflowStore(prefix) {
 	return createCombinedStore({
@@ -351,14 +355,14 @@ function createInstallationHooks(store, logFn) {
 * Installation action router.
 *
 * Routes:
-* - 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)
+* - GET /                            Get current installation status
+* - POST /                           Start installation (creates plan, invokes execution async)
+* - POST /execution                  Execute installation (internal, called async)
+* - POST /validation                 Pre-installation validation
+* - POST /uninstallation             Start uninstallation (creates plan, invokes execution async)
+* - GET /uninstallation              Get current uninstallation status
+* - POST /uninstallation/execution   Execute uninstallation (internal, called async)
+* - DELETE /uninstallation           Clear uninstallation state only (no offboarding)
 */
 const router = new require_router.HttpActionRouter().use(require_router.logger({ name: () => "installation" }));
 /**
@@ -399,8 +403,9 @@ router.post("/", {
 			}
 			logger.debug("Previous installation failed, allowing retry");
 		}
-		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 rawAppConfig = rawParams.appConfig;
+		if (!rawAppConfig) return (0, _adobe_aio_commerce_lib_core_responses.internalServerError)("The app config is missing. Does the action receive it as a parameter?");
+		const appConfig = require_validate.validateCommerceAppConfig(rawAppConfig);
 		const initialState = require_management.createInitialInstallationState({ config: appConfig });
 		logger.debug(`Created initial state: ${initialState.id}`);
 		await store.put(getStorageKey(), initialState);
@@ -427,16 +432,18 @@ router.post("/", {
 	}
 });
 /**
-* POST /installation/execution - Execute installation (internal)
+* POST /installation/execution - Execute installation
+* @internal - Do not add to OpenAPI Spec.
 *
 * This endpoint is called asynchronously by POST /installation.
 * It runs the actual installation workflow and saves state.
 */
 router.post("/execution", { handler: async (_req, { logger, rawParams }) => {
 	const params = rawParams;
-	const { initialState, appConfig, appData, AIO_COMMERCE_API_BASE_URL } = params;
+	const { initialState, appConfig: rawAppConfig, 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");
+	if (!rawAppConfig) return (0, _adobe_aio_commerce_lib_core_responses.badRequest)("appConfig is required for execution");
+	const appConfig = require_validate.validateCommerceAppConfig(rawAppConfig);
 	const store = await createInstallationStore();
 	const hooks = createInstallationHooks(store, (msg) => logger.debug(msg));
 	const installationContext = buildInstallationContext(params, appConfig, logger);
@@ -472,8 +479,9 @@ router.post("/validation", {
 	body: InstallationRequestBodySchema,
 	handler: async (req, { logger, rawParams }) => {
 		logger.debug("Running pre-installation validation...");
-		const appConfig = rawParams.appConfig;
-		if (!appConfig) return (0, _adobe_aio_commerce_lib_core_responses.internalServerError)("Could not find or parse the app.commerce.manifest.json file, is it present and valid?");
+		const rawAppConfig = rawParams.appConfig;
+		if (!rawAppConfig) return (0, _adobe_aio_commerce_lib_core_responses.internalServerError)("The app config is missing. Does the action receive it as a parameter?");
+		const appConfig = require_validate.validateCommerceAppConfig(rawAppConfig);
 		const { appData, ...params } = buildWorkflowParams(req.body, rawParams);
 		const result = await require_management.runValidation({
 			validationContext: {
@@ -511,8 +519,9 @@ router.post("/uninstallation", {
 	handler: async (req, { logger, rawParams }) => {
 		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 rawAppConfig = rawParams.appConfig;
+		if (!rawAppConfig) return (0, _adobe_aio_commerce_lib_core_responses.internalServerError)("The app config is missing. Does the action receive it as a parameter?");
+		const appConfig = require_validate.validateCommerceAppConfig(rawAppConfig);
 		const store = await createUninstallationStore();
 		const existingState = await store.get(getStorageKey());
 		if (existingState && require_management.isInProgressState(existingState)) {
@@ -544,7 +553,8 @@ router.post("/uninstallation", {
 	}
 });
 /**
-* POST /uninstallation/execution - Execute uninstallation (internal, called async by POST /uninstallation)
+* POST /uninstallation/execution - Execute uninstallation
+* @internal - Do not add to OpenAPI Spec.
 *
 * Flow:
 * 1. Build InstallationContext from params
@@ -555,9 +565,10 @@ router.post("/uninstallation", {
 */
 router.post("/uninstallation/execution", { handler: async (_req, { logger, rawParams }) => {
 	const params = rawParams;
-	const { initialState, appConfig, appData, AIO_COMMERCE_API_BASE_URL } = params;
+	const { initialState, appConfig: rawAppConfig, 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");
+	if (!rawAppConfig) return (0, _adobe_aio_commerce_lib_core_responses.badRequest)("appConfig is required for execution");
+	const appConfig = require_validate.validateCommerceAppConfig(rawAppConfig);
 	const store = await createUninstallationStore();
 	const hooks = createInstallationHooks(store, (msg) => logger.debug(msg));
 	const installationContext = buildInstallationContext(params, appConfig, logger);
@@ -592,9 +603,17 @@ router.delete("/uninstallation", { handler: async (_req, { logger }) => {
 	logger.debug("Uninstallation state cleared");
 	return (0, _adobe_aio_commerce_lib_core_responses.noContent)();
 } });
-/** Factory to create the route handler for the `installation` action. */
-const installationRuntimeAction = ({ appConfig, customScriptsLoader }) => async (params) => {
-	return await router.handler()({
+
+//#endregion
+//#region source/actions/installation/index.ts
+/**
+* Factory to create the route handler for the `installation` action.
+* @param args - The arguments required to create the runtime action.
+*/
+const installationRuntimeAction = (args) => async (params) => {
+	const handler = router.handler();
+	const { appConfig, customScriptsLoader } = args;
+	return await handler({
 		...params,
 		appConfig,
 		customScriptsLoader

package/dist/{es/actions/installation.d.mts → cjs/actions/installation/index.d.cts}

@@ -12,22 +12,23 @@
  * governing permissions and limitations under the License.
  */
 
-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 { n as CommerceAppConfig, r as CommerceAppConfigOutputModel } from "../../app-DrYHK-z1.cjs";
+import { Y as InstallationContext } from "../../index-B5gJ-q4U.cjs";
 import { RuntimeActionParams } from "@adobe/aio-commerce-lib-core/params";
 
-//#region source/actions/installation.d.ts
+//#region source/actions/installation/router.d.ts
 type CustomScriptsLoader = (config: CommerceAppConfigOutputModel, logger: InstallationContext["logger"]) => Record<string, unknown>;
 /** Arguments for the runtime action factory. */
 type RuntimeActionFactoryArgs = {
-  appConfig: CommerceAppConfigOutputModel;
+  appConfig: CommerceAppConfig;
   customScriptsLoader?: CustomScriptsLoader;
 };
-/** Factory to create the route handler for the `installation` action. */
-declare const installationRuntimeAction: ({
-  appConfig,
-  customScriptsLoader
-}: RuntimeActionFactoryArgs) => (params: RuntimeActionParams) => Promise<_$_adobe_aio_commerce_lib_core_responses0.ActionResponse>;
+//#endregion
+//#region source/actions/installation/index.d.ts
+/**
+ * Factory to create the route handler for the `installation` action.
+ * @param args - The arguments required to create the runtime action.
+ */
+declare const installationRuntimeAction: (args: RuntimeActionFactoryArgs) => (params: RuntimeActionParams) => Promise<import("@adobe/aio-commerce-lib-core/responses").ActionResponse>;
 //#endregion
 export { installationRuntimeAction };

package/dist/cjs/actions/{registration.cjs → registration/index.cjs}

@@ -13,25 +13,34 @@
  */
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_chunk = require('../chunk-DS2yp5vX.cjs');
-const require_router = require('../router-CFErodHU.cjs');
+const require_router = require('../../router-BOR7T6qR.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. */
+//#region source/actions/registration/router.ts
+/**
+* Registration action router.
+*
+* Routes:
+* - GET /   Retrieve the Admin UI SDK registration.
+*/
 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 } });
 } });
+
+//#endregion
+//#region source/actions/registration/index.ts
 /**
 * Factory to create the route handler for the `registration` action.
-* @param args - The registration configuration to inline in the action.
+* @param args - The arguments required to create the runtime action.
 * @experimental
 */
-const registrationRuntimeAction = ({ registration }) => async (params) => {
-	return await router.handler()({
+const registrationRuntimeAction = (args) => async (params) => {
+	const handler = router.handler();
+	const { registration } = args;
+	return await handler({
 		...params,
 		registration
 	});

package/dist/cjs/actions/{registration.d.cts → registration/index.d.cts}

@@ -12,22 +12,21 @@
  * 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 { n as AdminUiSdkRegistration } from "../../admin-ui-sdk-EU915zlR.cjs";
 import { RuntimeActionParams } from "@adobe/aio-commerce-lib-core/params";
 
-//#region source/actions/registration.d.ts
-/** Arguments for the registration runtime action factory. */
-type RegistrationActionArgs = {
+//#region source/actions/registration/router.d.ts
+/** The arguments required to create the runtime action for the registration action. */
+type RuntimeActionFactoryArgs = {
   registration: AdminUiSdkRegistration;
 };
+//#endregion
+//#region source/actions/registration/index.d.ts
 /**
  * Factory to create the route handler for the `registration` action.
- * @param args - The registration configuration to inline in the action.
+ * @param args - The arguments required to create the runtime action.
  * @experimental
  */
-declare const registrationRuntimeAction: ({
-  registration
-}: RegistrationActionArgs) => (params: RuntimeActionParams) => Promise<_$_adobe_aio_commerce_lib_core_responses0.ActionResponse>;
+declare const registrationRuntimeAction: (args: RuntimeActionFactoryArgs) => (params: RuntimeActionParams) => Promise<import("@adobe/aio-commerce-lib-core/responses").ActionResponse>;
 //#endregion
 export { registrationRuntimeAction };

package/dist/cjs/actions/{scope-tree.cjs → scope-tree/index.cjs}

@@ -13,18 +13,46 @@
  */
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-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");
+const require_chunk = require('../../chunk-Cozy-1ZF.cjs');
+const require_schemas = require('../../schemas-FngDuIeo.cjs');
+const require_logging = require('../../logging-BVz3weoC.cjs');
+const require_router = require('../../router-BOR7T6qR.cjs');
+let _adobe_aio_commerce_lib_config = require("@adobe/aio-commerce-lib-config");
 let valibot = require("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");
+let _adobe_aio_commerce_lib_core_responses = require("@adobe/aio-commerce-lib-core/responses");
+
+//#region source/actions/scope-tree/schema.ts
+const CustomScopeInputSchema = valibot.object({
+	id: valibot.optional(valibot.string()),
+	code: valibot.string(),
+	label: valibot.string(),
+	level: valibot.optional(valibot.string()),
+	is_editable: valibot.boolean(),
+	is_final: valibot.boolean(),
+	children: valibot.optional(valibot.array(valibot.lazy(() => CustomScopeInputSchema)))
+});
+/** Request body for PUT / */
+const SetCustomScopeTreeBodySchema = valibot.object({ scopes: valibot.array(CustomScopeInputSchema) });
+/** Request body for POST /commerce */
+const SyncCommerceScopesBodySchema = valibot.object({
+	commerceBaseUrl: require_schemas.nonEmptyStringValueSchema("commerceBaseUrl"),
+	commerceEnv: valibot.optional(require_schemas.nonEmptyStringValueSchema("commerceEnv"))
+});
 
-//#region source/actions/scope-tree.ts
-const router = new require_router.HttpActionRouter().use(require_router.logger());
+//#endregion
+//#region source/actions/scope-tree/router.ts
+/**
+* Scope Tree action router.
+*
+* Routes:
+* - GET /              Retrieve the scope tree.
+* - PUT /              Set custom scope tree.
+* - POST /commerce     Sync commerce scopes
+* - DELETE /commerce   Unsync commerce scopes
+*/
+const router = new require_router.HttpActionRouter().use(require_router.logger({ name: () => "scope-tree" }));
 /** GET / - Get scope tree */
 router.get("/", { handler: async (_req, ctx) => {
 	const { logger } = ctx;
@@ -36,15 +64,24 @@ router.get("/", { handler: async (_req, ctx) => {
 	});
 	return (0, _adobe_aio_commerce_lib_core_responses.ok)({ body: { scopes: result.scopeTree } });
 } });
-/** POST / - Set custom scope tree */
+/** PUT / - Set custom scope tree */
 router.put("/", {
-	body: valibot.object({ scopes: valibot.array(valibot.any()) }),
+	body: SetCustomScopeTreeBodySchema,
 	handler: async (req, ctx) => {
 		const { logger } = ctx;
 		logger.debug(`Setting custom scope tree with ${req.body.scopes?.length || 0} scopes`);
 		const request = { scopes: req.body.scopes };
+		let result;
 		logger.debug(`Setting custom scope tree: ${require_logging.inspect(request)}`);
-		const result = await (0, _adobe_aio_commerce_lib_config.setCustomScopeTree)(request);
+		try {
+			result = await (0, _adobe_aio_commerce_lib_config.setCustomScopeTree)(request);
+		} catch (err) {
+			if (err instanceof Error && "isValidationError" in err) {
+				logger.debug(`Custom scope tree validation failed: ${err.message}`);
+				return (0, _adobe_aio_commerce_lib_core_responses.badRequest)({ body: { message: err.message } });
+			}
+			throw err;
+		}
 		logger.debug(`Successfully set custom scope tree: ${require_logging.inspect(result)}`);
 		return (0, _adobe_aio_commerce_lib_core_responses.ok)({
 			body: { result },
@@ -54,10 +91,7 @@ router.put("/", {
 });
 /** POST /commerce - Sync commerce scopes */
 router.post("/commerce", {
-	body: valibot.object({
-		commerceBaseUrl: require_schemas.nonEmptyStringValueSchema("commerceBaseUrl"),
-		commerceEnv: valibot.optional(require_schemas.nonEmptyStringValueSchema("commerceEnv"))
-	}),
+	body: SyncCommerceScopesBodySchema,
 	handler: async (req, ctx) => {
 		const { logger } = ctx;
 		logger.debug("Syncing commerce scopes...");
@@ -105,6 +139,9 @@ router.delete("/commerce", { handler: async (_req, ctx) => {
 	logger.debug(message);
 	return (0, _adobe_aio_commerce_lib_core_responses.ok)(message);
 } });
+
+//#endregion
+//#region source/actions/scope-tree/index.ts
 /** The handler method for the `scope-tree` action. */
 const scopeTreeRuntimeAction = router.handler();
 

package/dist/{es/actions/scope-tree.d.mts → cjs/actions/scope-tree/index.d.cts}

@@ -12,11 +12,8 @@
  * governing permissions and limitations under the License.
  */
 
-import * as _$_adobe_aio_commerce_lib_core_responses0 from "@adobe/aio-commerce-lib-core/responses";
-import * as _$_adobe_aio_commerce_lib_core_params0 from "@adobe/aio-commerce-lib-core/params";
-
-//#region source/actions/scope-tree.d.ts
+//#region source/actions/scope-tree/index.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: import("@adobe/aio-commerce-lib-core/params").RuntimeActionParams) => Promise<import("@adobe/aio-commerce-lib-core/responses").ActionResponse>;
 //#endregion
 export { scopeTreeRuntimeAction };

package/dist/cjs/{admin-ui-sdk-BiSopnKI.d.cts → admin-ui-sdk-EU915zlR.d.cts}

@@ -12,14 +12,9 @@
  * governing permissions and limitations under the License.
  */
 
-import { n as CommerceAppConfigOutputModel } from "./app-C6kImBl7.cjs";
+import { r as CommerceAppConfigOutputModel, t as AnyCommerceAppConfig } from "./app-DrYHK-z1.cjs";
 import * as v from "valibot";
-//#region source/management/installation/admin-ui-sdk/utils.d.ts
-/** Config type when Admin UI SDK registration is configured. */
-type AdminUiSdkConfig = CommerceAppConfigOutputModel & {
-  adminUiSdk: NonNullable<CommerceAppConfigOutputModel["adminUiSdk"]>;
-};
-//#endregion
+
 //#region source/config/schema/admin-ui-sdk.d.ts
 declare const GridColumnsSchema: v.ObjectSchema<{
   readonly data: v.ObjectSchema<{
@@ -656,10 +651,14 @@ type BannerNotification = v.InferInput<typeof BannerNotificationSchema>;
  * @experimental
  */
 type MenuItem = v.InferInput<typeof MenuItemSchema>;
+/** Config type when Admin UI SDK registration is configured. */
+type AppConfigWithAdminUiSdk<T extends AnyCommerceAppConfig = CommerceAppConfigOutputModel> = T & {
+  adminUiSdk: NonNullable<T["adminUiSdk"]>;
+};
 /**
  * Check if config has Admin UI SDK registration configuration.
  * @experimental
  */
-declare function hasAdminUiSdk(config: CommerceAppConfigOutputModel): config is AdminUiSdkConfig;
+declare function hasAdminUiSdk<T extends AnyCommerceAppConfig>(config: T): config is T & AppConfigWithAdminUiSdk<T>;
 //#endregion
 export { CustomerMassAction as a, OrderMassAction as c, hasAdminUiSdk as d, CustomFee as i, OrderViewButton as l, AdminUiSdkRegistration as n, GridColumns as o, BannerNotification as r, MenuItem as s, AdminUiSdkConfiguration as t, ProductMassAction as u };