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

package/dist/es/actions/{installation.mjs → installation/index.mjs}

@@ -12,12 +12,12 @@
  * governing permissions and limitations under the License.
  */
 
-import { n as logger, t as HttpActionRouter } from "../router-BxaxEEu3.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 { r as nonEmptyStringValueSchema } from "../../schemas-hRovglBF.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-BUX-w2Ji.mjs";
+import { t as validateCommerceAppConfig } from "../../validate-Dfajrp99.mjs";
+import { n as logger, t as HttpActionRouter } from "../../router-D58JJHHA.mjs";
 import * as v from "valibot";
-import { object, string } from "valibot";
+import { accepted, badRequest, conflict, internalServerError, noContent, ok } from "@adobe/aio-commerce-lib-core/responses";
 import { init } from "@adobe/aio-lib-files";
 import { init as init$1 } from "@adobe/aio-lib-state";
 import openwhisk from "openwhisk";
@@ -256,16 +256,19 @@ const AppDataSchema = v.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 = object({
+//#region source/actions/installation/schema.ts
+/** Request body for POST / and POST /validation (shared shape) */
+const InstallationRequestBodySchema = v.object({
 	appData: AppDataSchema,
-	commerceBaseUrl: string(),
-	commerceEnv: string(),
-	ioEventsUrl: string(),
-	ioEventsEnv: string()
+	commerceBaseUrl: v.string(),
+	commerceEnv: v.string(),
+	ioEventsUrl: v.string(),
+	ioEventsEnv: v.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({
@@ -348,14 +351,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 HttpActionRouter().use(logger({ name: () => "installation" }));
 /**
@@ -396,8 +399,9 @@ router.post("/", {
 			}
 			logger.debug("Previous installation failed, allowing retry");
 		}
-		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 rawAppConfig = rawParams.appConfig;
+		if (!rawAppConfig) return internalServerError("The app config is missing. Does the action receive it as a parameter?");
+		const appConfig = validateCommerceAppConfig(rawAppConfig);
 		const initialState = createInitialInstallationState({ config: appConfig });
 		logger.debug(`Created initial state: ${initialState.id}`);
 		await store.put(getStorageKey(), initialState);
@@ -424,16 +428,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 badRequest("initialState is required for execution");
-	if (!appConfig) return badRequest("appConfig is required for execution");
+	if (!rawAppConfig) return badRequest("appConfig is required for execution");
+	const appConfig = validateCommerceAppConfig(rawAppConfig);
 	const store = await createInstallationStore();
 	const hooks = createInstallationHooks(store, (msg) => logger.debug(msg));
 	const installationContext = buildInstallationContext(params, appConfig, logger);
@@ -469,8 +475,9 @@ router.post("/validation", {
 	body: InstallationRequestBodySchema,
 	handler: async (req, { logger, rawParams }) => {
 		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 rawAppConfig = rawParams.appConfig;
+		if (!rawAppConfig) return internalServerError("The app config is missing. Does the action receive it as a parameter?");
+		const appConfig = validateCommerceAppConfig(rawAppConfig);
 		const { appData, ...params } = buildWorkflowParams(req.body, rawParams);
 		const result = await runValidation({
 			validationContext: {
@@ -508,8 +515,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 internalServerError("Could not find or parse the app.commerce.manifest.json file, is it present and valid?");
+		const rawAppConfig = rawParams.appConfig;
+		if (!rawAppConfig) return internalServerError("The app config is missing. Does the action receive it as a parameter?");
+		const appConfig = validateCommerceAppConfig(rawAppConfig);
 		const store = await createUninstallationStore();
 		const existingState = await store.get(getStorageKey());
 		if (existingState && isInProgressState(existingState)) {
@@ -541,7 +549,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
@@ -552,9 +561,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 badRequest("initialState is required for execution");
-	if (!appConfig) return badRequest("appConfig is required for execution");
+	if (!rawAppConfig) return badRequest("appConfig is required for execution");
+	const appConfig = validateCommerceAppConfig(rawAppConfig);
 	const store = await createUninstallationStore();
 	const hooks = createInstallationHooks(store, (msg) => logger.debug(msg));
 	const installationContext = buildInstallationContext(params, appConfig, logger);
@@ -589,9 +599,17 @@ router.delete("/uninstallation", { handler: async (_req, { logger }) => {
 	logger.debug("Uninstallation state cleared");
 	return 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/{registration.d.mts → registration/index.d.mts}

@@ -12,22 +12,21 @@
  * 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 { n as AdminUiSdkRegistration } from "../../admin-ui-sdk-BwnD0xjK.mjs";
 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/es/actions/{registration.mjs → registration/index.mjs}

@@ -12,24 +12,34 @@
  * governing permissions and limitations under the License.
  */
 
-import { n as logger, t as HttpActionRouter } from "../router-BxaxEEu3.mjs";
+import { n as logger, t as HttpActionRouter } from "../../router-D58JJHHA.mjs";
 import { ok } from "@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 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 } });
 } });
+
+//#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/scope-tree.d.cts → es/actions/scope-tree/index.d.mts}

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

@@ -12,16 +12,44 @@
  * governing permissions and limitations under the License.
  */
 
-import { n as logger, t as HttpActionRouter } from "../router-BxaxEEu3.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";
+import { r as nonEmptyStringValueSchema } from "../../schemas-hRovglBF.mjs";
+import { t as inspect } from "../../logging-DbJHXSKh.mjs";
+import { n as logger, t as HttpActionRouter } from "../../router-D58JJHHA.mjs";
 import { getScopeTree, setCustomScopeTree, syncCommerceScopes, unsyncCommerceScopes } from "@adobe/aio-commerce-lib-config";
+import * as v from "valibot";
 import { resolveCommerceHttpClientParams } from "@adobe/aio-commerce-lib-api";
+import { badRequest, internalServerError, nonAuthoritativeInformation, ok } from "@adobe/aio-commerce-lib-core/responses";
+
+//#region source/actions/scope-tree/schema.ts
+const CustomScopeInputSchema = v.object({
+	id: v.optional(v.string()),
+	code: v.string(),
+	label: v.string(),
+	level: v.optional(v.string()),
+	is_editable: v.boolean(),
+	is_final: v.boolean(),
+	children: v.optional(v.array(v.lazy(() => CustomScopeInputSchema)))
+});
+/** Request body for PUT / */
+const SetCustomScopeTreeBodySchema = v.object({ scopes: v.array(CustomScopeInputSchema) });
+/** Request body for POST /commerce */
+const SyncCommerceScopesBodySchema = v.object({
+	commerceBaseUrl: nonEmptyStringValueSchema("commerceBaseUrl"),
+	commerceEnv: v.optional(nonEmptyStringValueSchema("commerceEnv"))
+});
 
-//#region source/actions/scope-tree.ts
-const router = new HttpActionRouter().use(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 HttpActionRouter().use(logger({ name: () => "scope-tree" }));
 /** GET / - Get scope tree */
 router.get("/", { handler: async (_req, ctx) => {
 	const { logger } = ctx;
@@ -33,15 +61,24 @@ router.get("/", { handler: async (_req, ctx) => {
 	});
 	return ok({ body: { scopes: result.scopeTree } });
 } });
-/** POST / - Set custom scope tree */
+/** PUT / - Set custom scope tree */
 router.put("/", {
-	body: v.object({ scopes: v.array(v.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: ${inspect(request)}`);
-		const result = await setCustomScopeTree(request);
+		try {
+			result = await setCustomScopeTree(request);
+		} catch (err) {
+			if (err instanceof Error && "isValidationError" in err) {
+				logger.debug(`Custom scope tree validation failed: ${err.message}`);
+				return badRequest({ body: { message: err.message } });
+			}
+			throw err;
+		}
 		logger.debug(`Successfully set custom scope tree: ${inspect(result)}`);
 		return ok({
 			body: { result },
@@ -51,10 +88,7 @@ router.put("/", {
 });
 /** POST /commerce - Sync commerce scopes */
 router.post("/commerce", {
-	body: v.object({
-		commerceBaseUrl: nonEmptyStringValueSchema("commerceBaseUrl"),
-		commerceEnv: v.optional(nonEmptyStringValueSchema("commerceEnv"))
-	}),
+	body: SyncCommerceScopesBodySchema,
 	handler: async (req, ctx) => {
 		const { logger } = ctx;
 		logger.debug("Syncing commerce scopes...");
@@ -102,6 +136,9 @@ router.delete("/commerce", { handler: async (_req, ctx) => {
 	logger.debug(message);
 	return 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/{admin-ui-sdk-CCo2SWiL.d.mts → admin-ui-sdk-BwnD0xjK.d.mts}

@@ -12,16 +12,9 @@
  * governing permissions and limitations under the License.
  */
 
-import { n as CommerceAppConfigOutputModel } from "./app-DcY6dJiQ.mjs";
+import { r as CommerceAppConfigOutputModel, t as AnyCommerceAppConfig } from "./app-DrYHK-z1.mjs";
 import * as v from "valibot";
-import { AdobeCommerceHttpClient } from "@adobe/aio-commerce-lib-api";
 
-//#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<{
@@ -658,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 };