@adobe/aio-commerce-lib-app 1.7.0 → 1.8.0-alpha-20260717142750

package/CHANGELOG.md

@@ -1,5 +1,93 @@
 # @adobe/aio-commerce-lib-app
 
+## 1.8.0-alpha-20260717142750
+### Minor Changes
+
+
+
+- [#528](https://github.com/adobe/aio-commerce-sdk/pull/528) [`0bb7d15`](https://github.com/adobe/aio-commerce-sdk/commit/0bb7d150961f631116b1ac421124960b5b857896) Thanks [@oshmyheliuk](https://github.com/oshmyheliuk)! - Add the optional `aclProtected` field to Admin UI grid columns, mass actions, and order view buttons. When `true`, Commerce auto-generates a per-app ACL resource for the component from `metadata.id` for role-based access control, matching the existing menu behaviour.
+
+
+
+- [#522](https://github.com/adobe/aio-commerce-sdk/pull/522) [`4396a64`](https://github.com/adobe/aio-commerce-sdk/commit/4396a647ad22dba063cdf03a16e04aef9387212f) Thanks [@oshmyheliuk](https://github.com/oshmyheliuk)! - Add optional `aclProtected` field to Admin UI menu configuration. When `true`, Commerce auto-generates a per-app ACL resource from `metadata.id` for role-based menu access control.
+
+
+
+- [#561](https://github.com/adobe/aio-commerce-sdk/pull/561) [`e85bec4`](https://github.com/adobe/aio-commerce-sdk/commit/e85bec40f1eaa91dd6bb7bc6954b2ecfc3ea4029) Thanks [@jcuerdo](https://github.com/jcuerdo)! - New `publishEvent` export for publishing a configured I/O Event from a runtime action by provider key and event name as declared in `app.commerce.config.ts`. Provider and event resolution happens automatically from metadata stored at installation time.
+
+
+
+- [#511](https://github.com/adobe/aio-commerce-sdk/pull/511) [`caed6d5`](https://github.com/adobe/aio-commerce-sdk/commit/caed6d5cbc526bc980221a06a59542427752a1ab) Thanks [@vinayrao2000](https://github.com/vinayrao2000)! - Add helpers to retrieve the Commerce instance an app is associated with from any runtime action: `getCommerceInstance()` returns the stored instance data, and `getCommerceClient(auth)` returns a ready-to-use Commerce HTTP client built from that instance.
+
+
+
+- [#508](https://github.com/adobe/aio-commerce-sdk/pull/508) [`c36f825`](https://github.com/adobe/aio-commerce-sdk/commit/c36f825aff7329fc2831d8aaca032d17bbee373a) Thanks [@iivvaannxx](https://github.com/iivvaannxx)! - Add support for Admin UI menus in `commerce/backend-ui/2` via `adminUi.menu`.
+
+
+
+- [#577](https://github.com/adobe/aio-commerce-sdk/pull/577) [`b8368e9`](https://github.com/adobe/aio-commerce-sdk/commit/b8368e93137d84c914d1b3f10591a39038801a4f) Thanks [@iivvaannxx](https://github.com/iivvaannxx)! - Added `resolveIoEventCode` to compute an event's I/O Events event code from its app ID, name, and provider type, without needing to read it back from stored installation data.
+
+
+
+- [#551](https://github.com/adobe/aio-commerce-sdk/pull/551) [`a66f389`](https://github.com/adobe/aio-commerce-sdk/commit/a66f3892622584d27cd6b5d2fc633e15bf9942a8) Thanks [@asalloum5](https://github.com/asalloum5)! - The app installation flow now enables the Admin UI SDK in Commerce before registering the extension, so Admin UI extensions are served correctly after install.
+
+
+
+- [#510](https://github.com/adobe/aio-commerce-sdk/pull/510) [`ce7768e`](https://github.com/adobe/aio-commerce-sdk/commit/ce7768e0ddc6ca35ad6ccec60f584c8bb5a743f0) Thanks [@oshmyheliuk](https://github.com/oshmyheliuk)! - Webhooks and events now accept an optional `env` array (`"paas"` / `"saas"`) to scope them to specific Commerce environments. Items without `env` apply everywhere; scoped items are only installed on matching environments, and an event provider left with no applicable events is skipped entirely. The `app-config` action also accepts an optional `commerceEnv` query param that returns business-config fields, webhooks, and events already filtered to that environment. The installation and `scope-tree` actions now validate `commerceEnv` against the supported values (`"paas"` / `"saas"`) instead of accepting any string; this only rejects values that were never valid in practice.
+
+
+
+- [#486](https://github.com/adobe/aio-commerce-sdk/pull/486) [`413da36`](https://github.com/adobe/aio-commerce-sdk/commit/413da36dcd83e5a41c194f5af50611097659e725) Thanks [@obarcelonap](https://github.com/obarcelonap)! - Add support for Admin UI grid column extensions on `commerce/backend-ui/2`.
+
+
+
+- [#512](https://github.com/adobe/aio-commerce-sdk/pull/512) [`b259e61`](https://github.com/adobe/aio-commerce-sdk/commit/b259e61c05bcb7a025486d1515ce644fb6f4265b) Thanks [@jcuerdo](https://github.com/jcuerdo)! - Remove `commerce/backend-ui/1` support and the `adminUiSdk` config key. Migrate to `adminUi` and `commerce/backend-ui/2`.
+  
+  **Migration:** Replace `adminUiSdk` in your `app.commerce.config.*` with the `adminUi` config key. See the updated `usage.md` for the new shape. The generated `src/commerce-backend-ui-1/` directory and its `pre-app-build` hook can be removed from your project.
+
+
+- [#492](https://github.com/adobe/aio-commerce-sdk/pull/492) [`ce63b2b`](https://github.com/adobe/aio-commerce-sdk/commit/ce63b2b46f7ef1f2f68780b13e52d1c13fd5fe6e) Thanks [@jcuerdo](https://github.com/jcuerdo)! - Support Admin UI SDK v2 mass actions. Declare mass actions under `adminUi` with explicit `type: "view"` (iframe) or `type: "worker"` (runtime action), support for notifications, and a unified `selectionLimit` across Order, Product, and Customer entities.
+
+
+
+- [#534](https://github.com/adobe/aio-commerce-sdk/pull/534) [`b33ad74`](https://github.com/adobe/aio-commerce-sdk/commit/b33ad741c30262279180496ab28a82516569a17f) Thanks [@obarcelonap](https://github.com/obarcelonap)! - Uninstallation now removes exactly the resources that were created at install time, even when the app configuration has since changed. Installs created before this change fall back to the current request config. The installation/uninstallation status responses now include an optional `config` field recording what was applied.
+
+
+
+- [#548](https://github.com/adobe/aio-commerce-sdk/pull/548) [`7670e39`](https://github.com/adobe/aio-commerce-sdk/commit/7670e39ae3cdf1172d9d9f09f0f100c19966d5a0) Thanks [@iivvaannxx](https://github.com/iivvaannxx)! - Implement initial web source scaffolding for projects with Admin UI view operations
+
+
+
+- [#506](https://github.com/adobe/aio-commerce-sdk/pull/506) [`a18d900`](https://github.com/adobe/aio-commerce-sdk/commit/a18d900771df65a025dde2146da8422f08c5e4ae) Thanks [@obarcelonap](https://github.com/obarcelonap)! - Add `adminUi.order.viewButtons` support on `commerce/backend-ui/2`, with `type: "view"` (iframe) and `type: "worker"` (runtime action) variants.
+
+
+### Patch Changes
+
+
+
+- [#576](https://github.com/adobe/aio-commerce-sdk/pull/576) [`b0c86a5`](https://github.com/adobe/aio-commerce-sdk/commit/b0c86a512965a691b3497ff1c286249508297388) Thanks [@iivvaannxx](https://github.com/iivvaannxx)! - Commerce and external event names are now validated to be non-empty and unique within each provider in `app.commerce.config.ts`.
+
+
+
+- [#525](https://github.com/adobe/aio-commerce-sdk/pull/525) [`2e40262`](https://github.com/adobe/aio-commerce-sdk/commit/2e402628f1cd21a85dfb7c8dc3660a454f1053c0) Thanks [@oshmyheliuk](https://github.com/oshmyheliuk)! - Characters in `metadata.id` that are disallowed by the Commerce Eventing API, such as hyphens, are now normalized to underscores in the generated event code.
+
+
+
+- [#528](https://github.com/adobe/aio-commerce-sdk/pull/528) [`0bb7d15`](https://github.com/adobe/aio-commerce-sdk/commit/0bb7d150961f631116b1ac421124960b5b857896) Thanks [@oshmyheliuk](https://github.com/oshmyheliuk)! - Grid column entries in `adminUi` config now reject unknown keys (strict validation), so a mistyped field such as `aclprotected` surfaces a validation error instead of being silently dropped — matching the existing behavior of mass actions and view buttons.
+
+
+
+- [#548](https://github.com/adobe/aio-commerce-sdk/pull/548) [`7670e39`](https://github.com/adobe/aio-commerce-sdk/commit/7670e39ae3cdf1172d9d9f09f0f100c19966d5a0) Thanks [@iivvaannxx](https://github.com/iivvaannxx)! - For static business configs, the `#app.commerce.config` alias now resolves to a generated ESM module that re-exports the app manifest, so generated runtime actions can import it directly without needing a JSON import attribute.
+
+- Updated dependencies [[`0bb7d15`](https://github.com/adobe/aio-commerce-sdk/commit/0bb7d150961f631116b1ac421124960b5b857896), [`4396a64`](https://github.com/adobe/aio-commerce-sdk/commit/4396a647ad22dba063cdf03a16e04aef9387212f), [`c15b50f`](https://github.com/adobe/aio-commerce-sdk/commit/c15b50f667e6d1288270dbd4192c150db0ff0914), [`c36f825`](https://github.com/adobe/aio-commerce-sdk/commit/c36f825aff7329fc2831d8aaca032d17bbee373a), [`bdcced9`](https://github.com/adobe/aio-commerce-sdk/commit/bdcced9297ae5e1b87ce86490a2b6fad76b2e341), [`19400fb`](https://github.com/adobe/aio-commerce-sdk/commit/19400fbdfc03c5bbfc30f995a2acdd4272c5e032), [`e85bec4`](https://github.com/adobe/aio-commerce-sdk/commit/e85bec40f1eaa91dd6bb7bc6954b2ecfc3ea4029), [`a66f389`](https://github.com/adobe/aio-commerce-sdk/commit/a66f3892622584d27cd6b5d2fc633e15bf9942a8), [`ce7768e`](https://github.com/adobe/aio-commerce-sdk/commit/ce7768e0ddc6ca35ad6ccec60f584c8bb5a743f0), [`4396a64`](https://github.com/adobe/aio-commerce-sdk/commit/4396a647ad22dba063cdf03a16e04aef9387212f), [`e85bec4`](https://github.com/adobe/aio-commerce-sdk/commit/e85bec40f1eaa91dd6bb7bc6954b2ecfc3ea4029), [`413da36`](https://github.com/adobe/aio-commerce-sdk/commit/413da36dcd83e5a41c194f5af50611097659e725), [`a5b6d61`](https://github.com/adobe/aio-commerce-sdk/commit/a5b6d6138d5f048426ef655c4dc37f470aa74e2b), [`413da36`](https://github.com/adobe/aio-commerce-sdk/commit/413da36dcd83e5a41c194f5af50611097659e725), [`ca2c4fe`](https://github.com/adobe/aio-commerce-sdk/commit/ca2c4febcdfbe52b933775f08e9a53765fc306ab), [`ce63b2b`](https://github.com/adobe/aio-commerce-sdk/commit/ce63b2b46f7ef1f2f68780b13e52d1c13fd5fe6e), [`caed6d5`](https://github.com/adobe/aio-commerce-sdk/commit/caed6d5cbc526bc980221a06a59542427752a1ab), [`19400fb`](https://github.com/adobe/aio-commerce-sdk/commit/19400fbdfc03c5bbfc30f995a2acdd4272c5e032)]:
+  - @adobe/aio-commerce-lib-admin-ui@0.2.0-alpha-20260717142750
+  - @adobe/aio-commerce-lib-core@1.2.0-alpha-20260717142750
+  - @adobe/aio-commerce-lib-events@1.3.0-alpha-20260717142750
+  - @adobe/aio-commerce-lib-api@1.3.0-alpha-20260717142750
+  - @adobe/aio-commerce-lib-auth@1.1.2-alpha-20260717142750
+  - @adobe/aio-commerce-lib-config@1.6.0-alpha-20260717142750
+  - @adobe/aio-commerce-lib-webhooks@1.2.0-alpha-20260717142750
+
 ## 1.7.0
 
 ### Minor Changes

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

@@ -13,12 +13,14 @@
  */
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_chunk = require('../../chunk-Cozy-1ZF.cjs');
-const require_validate = require('../../validate-oAOpyFyb.cjs');
-const require_router = require('../../router-BOR7T6qR.cjs');
+const require_rolldown_runtime = require('../../rolldown-runtime-Cozy-1ZF.cjs');
+const require_environment = require('../../environment-B7EnozSg.cjs');
+const require_validate = require('../../validate-C_eCKp21.cjs');
+const require_router = require('../../router-hA_Y9gZ1.cjs');
 let _adobe_aio_commerce_lib_config = require("@adobe/aio-commerce-lib-config");
 let valibot = require("valibot");
-valibot = require_chunk.__toESM(valibot, 1);
+valibot = require_rolldown_runtime.__toESM(valibot, 1);
+let _adobe_aio_commerce_lib_core_commerce = require("@adobe/aio-commerce-lib-core/commerce");
 let _adobe_aio_commerce_lib_core_responses = require("@adobe/aio-commerce-lib-core/responses");
 let crypto = require("crypto");
 
@@ -27,7 +29,7 @@ let crypto = require("crypto");
 * Loads the committed OpenAPI spec via dynamic import so it
 * lands in its own chunk and is not parsed on every cold start.
 */
-const importOpenApi = () => Promise.resolve().then(() => require("../../openapi-Cux6K4ZD.cjs"));
+const importOpenApi = () => Promise.resolve().then(() => require("../../openapi-CwytYdWl.cjs"));
 /** Matches component schema `$ref` strings, capturing the schema name. */
 const SCHEMA_REF_PATTERN = /"#\/components\/schemas\/(\w+)"/g;
 /**
@@ -68,7 +70,7 @@ function pruneUnusedSchemas(spec) {
 function pruneUnusedTags(spec) {
 	const usedTags = /* @__PURE__ */ new Set();
 	for (const pathItem of Object.values(spec.paths)) for (const operation of Object.values(pathItem)) for (const tag of operation.tags ?? []) usedTags.add(tag);
-	for (let i = spec.tags.length - 1; i >= 0; i--) if (!usedTags.has(spec.tags[i].name)) spec.tags.splice(i, 1);
+	for (let i = spec.tags.length - 1; i >= 0; i -= 1) if (!usedTags.has(spec.tags[i].name)) spec.tags.splice(i, 1);
 }
 /**
 * Computes a short hash identifying the spec served for the given config domains.
@@ -78,7 +80,7 @@ function pruneUnusedTags(spec) {
 * @param domains - The active config domains.
 */
 function getOpenApiCacheKey(domains) {
-	const input = `1.7.0:${[...domains].sort().join(",")}:1.0.0`;
+	const input = `1.8.0-alpha-20260717142750:${[...domains].sort().join(",")}:2.0.0`;
 	return (0, crypto.createHash)("sha256").update(input).digest("hex").slice(0, 8);
 }
 /** Returns the server URL to be set in the OpenAPI spec, based on the current namespace. */
@@ -111,10 +113,6 @@ async function buildOpenApiSpec(domains, logger) {
 		stripPath("/scope-tree");
 		stripPath("/scope-tree/commerce");
 	}
-	if (!domains.has("adminUiSdk")) {
-		logger.debug("Application doesn't define Admin UI SDK registration, stripping references...");
-		stripPath("/registration");
-	}
 	if (!require_validate.requiresInstallationFromDomains(domains)) {
 		logger.debug("Application doesn't require installation, stripping references...");
 		stripPath("/installation");
@@ -138,37 +136,41 @@ async function buildOpenApiSpec(domains, logger) {
 */
 const router = new require_router.HttpActionRouter().use(require_router.logger({ name: () => "app-config" }));
 /** GET / - Get app config */
-router.get("/", { handler: async (_req, { logger, rawParams }) => {
-	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?");
-	let appConfig = rawAppConfig;
-	if (require_validate.hasBusinessConfigSchema(rawAppConfig)) {
-		logger.debug("Resolving business config schema...");
-		const schema = await (0, _adobe_aio_commerce_lib_config.resolveBusinessConfigSchema)(rawAppConfig.businessConfig.schema, rawParams);
-		appConfig = {
-			...rawAppConfig,
-			businessConfig: {
-				...rawAppConfig.businessConfig,
-				schema
-			}
-		};
-	}
-	logger.debug("Validating app config...");
-	const config = require_validate.validateCommerceAppConfig(appConfig);
-	logger.debug("Successfully validated the app config");
-	const domains = require_validate.getConfigDomains(rawParams.appConfig);
-	const openApiSpecUrl = `${getServerUrl()}/app-config/openapi.json?ck=${getOpenApiCacheKey(domains)}`;
-	return (0, _adobe_aio_commerce_lib_core_responses.ok)({ body: {
-		...config,
-		openApiSpecUrl
-	} });
-} });
+router.get("/", {
+	handler: async (req, { logger, rawParams }) => {
+		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?");
+		let appConfig = rawAppConfig;
+		if (require_validate.hasBusinessConfigSchema(rawAppConfig)) {
+			logger.debug("Resolving business config schema...");
+			const schema = await (0, _adobe_aio_commerce_lib_config.resolveBusinessConfigSchema)(rawAppConfig.businessConfig.schema, rawParams);
+			appConfig = {
+				...rawAppConfig,
+				businessConfig: {
+					...rawAppConfig.businessConfig,
+					schema
+				}
+			};
+		}
+		logger.debug("Validating app config...");
+		const validatedConfig = require_validate.validateCommerceAppConfig(appConfig);
+		logger.debug("Successfully validated the app config");
+		const { commerceEnv } = req.query;
+		const config = commerceEnv ? require_environment.filterAppConfigByEnv(validatedConfig, commerceEnv) : validatedConfig;
+		const domains = require_validate.getConfigDomains(rawParams.appConfig);
+		const openApiSpecUrl = `${getServerUrl()}/app-config/openapi.json?ck=${getOpenApiCacheKey(domains)}`;
+		return (0, _adobe_aio_commerce_lib_core_responses.ok)({ body: {
+			...config,
+			openApiSpecUrl
+		} });
+	},
+	query: valibot.object({ commerceEnv: valibot.optional(_adobe_aio_commerce_lib_core_commerce.CommerceEnvSchema) })
+});
 /**
 * GET /openapi.json - Returns the OpenAPI spec for all SDK actions
 * @internal - Do not add to OpenAPI Spec.
 */
 router.get("/openapi.json", {
-	query: valibot.object({ ck: valibot.optional(valibot.string()) }),
 	handler: async (req, { logger, rawParams }) => {
 		const { ck } = req.query;
 		const domains = require_validate.getConfigDomains(rawParams.appConfig);
@@ -180,7 +182,8 @@ router.get("/openapi.json", {
 			});
 		}
 		return (0, _adobe_aio_commerce_lib_core_responses.ok)({ body: await buildOpenApiSpec(domains, logger) });
-	}
+	},
+	query: valibot.object({ ck: valibot.optional(valibot.string()) })
 });
 
 //#endregion

package/dist/cjs/actions/app-config/index.d.cts

@@ -12,7 +12,7 @@
  * governing permissions and limitations under the License.
  */
 
-import { n as CommerceAppConfig } from "../../app-DrYHK-z1.cjs";
+import { n as CommerceAppConfig } from "../../app-BwehWeu1.cjs";
 import { RuntimeActionParams } from "@adobe/aio-commerce-lib-core/params";
 
 //#region source/actions/app-config/router.d.ts

package/dist/cjs/actions/association/index.cjs

@@ -0,0 +1,85 @@
+/**
+ * @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_rolldown_runtime = require('../../rolldown-runtime-Cozy-1ZF.cjs');
+const require_repository = require('../../repository-CbceYZqc.cjs');
+const require_router = require('../../router-hA_Y9gZ1.cjs');
+let valibot = require("valibot");
+valibot = require_rolldown_runtime.__toESM(valibot, 1);
+let _adobe_aio_commerce_lib_core_commerce = require("@adobe/aio-commerce-lib-core/commerce");
+let _adobe_aio_commerce_lib_core_responses = require("@adobe/aio-commerce-lib-core/responses");
+
+//#region source/actions/association/schema.ts
+/** Request body for POST / — store association data. */
+const AssociationRequestBodySchema = valibot.object({
+	commerceBaseUrl: valibot.pipe(valibot.string(), valibot.url("The 'commerceBaseUrl' field must be a valid absolute URL (e.g., 'https://my-store.example.com')")),
+	commerceEnv: _adobe_aio_commerce_lib_core_commerce.CommerceEnvSchema
+});
+
+//#endregion
+//#region source/actions/association/router.ts
+/**
+* Association action router.
+*
+* Routes:
+* - POST /   Store Commerce instance details (`baseUrl`, `env`)
+* - DELETE / Clear stored Commerce instance details
+*/
+const router = new require_router.HttpActionRouter().use(require_router.logger({ name: () => "association" }));
+/**
+* POST / - Store association data.
+*
+* Persists the Commerce instance the app is associated with so runtime actions
+* can later retrieve it via `getCommerceInstance` / `getCommerceClient`.
+*/
+router.post("/", {
+	body: AssociationRequestBodySchema,
+	handler: async (req, { logger }) => {
+		const { commerceBaseUrl, commerceEnv } = req.body;
+		logger.debug(`Storing association data (baseUrl: "${commerceBaseUrl}", env: "${commerceEnv}")`);
+		await require_repository.setAssociationData({ commerce: {
+			baseUrl: commerceBaseUrl,
+			env: commerceEnv
+		} });
+		return (0, _adobe_aio_commerce_lib_core_responses.noContent)();
+	}
+});
+/**
+* DELETE / - Clear association data.
+*
+* Called when the app is unassociated.
+*/
+router.delete("/", { handler: async (_req, { logger }) => {
+	logger.debug("Clearing association data");
+	await require_repository.clearAssociationData();
+	return (0, _adobe_aio_commerce_lib_core_responses.noContent)();
+} });
+
+//#endregion
+//#region source/actions/association/index.ts
+/**
+* Factory to create the route handler for the `association` action.
+*
+* The `association` action manages the lifecycle of the Commerce instance the
+* app is associated with — `POST /` stores the data when the app is associated,
+* and `DELETE /` clears it on unassociation. Runtime actions consume the data
+* via `getCommerceInstance` / `getCommerceClient` from the root entrypoint.
+*/
+const associationRuntimeAction = () => async (params) => {
+	return await router.handler()({ ...params });
+};
+
+//#endregion
+exports.associationRuntimeAction = associationRuntimeAction;

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

@@ -12,21 +12,17 @@
  * governing permissions and limitations under the License.
  */
 
-import { n as AdminUiSdkRegistration } from "../../admin-ui-sdk-EU915zlR.cjs";
 import { RuntimeActionParams } from "@adobe/aio-commerce-lib-core/params";
 
-//#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
+//#region source/actions/association/index.d.ts
 /**
- * Factory to create the route handler for the `registration` action.
- * @param args - The arguments required to create the runtime action.
- * @experimental
+ * Factory to create the route handler for the `association` action.
+ *
+ * The `association` action manages the lifecycle of the Commerce instance the
+ * app is associated with — `POST /` stores the data when the app is associated,
+ * and `DELETE /` clears it on unassociation. Runtime actions consume the data
+ * via `getCommerceInstance` / `getCommerceClient` from the root entrypoint.
  */
-declare const registrationRuntimeAction: (args: RuntimeActionFactoryArgs) => (params: RuntimeActionParams) => Promise<import("@adobe/aio-commerce-lib-core/responses").ActionResponse>;
+declare const associationRuntimeAction: () => (params: RuntimeActionParams) => Promise<import("@adobe/aio-commerce-lib-core/responses").ActionResponse>;
 //#endregion
-export { registrationRuntimeAction };
+export { associationRuntimeAction };

package/dist/cjs/actions/config/index.cjs

@@ -13,12 +13,14 @@
  */
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_chunk = require('../../chunk-Cozy-1ZF.cjs');
-const require_schemas = require('../../schemas-FngDuIeo.cjs');
-const require_router = require('../../router-BOR7T6qR.cjs');
+const require_rolldown_runtime = require('../../rolldown-runtime-Cozy-1ZF.cjs');
+const require_schemas = require('../../schemas-mLxMh_ko.cjs');
+const require_environment = require('../../environment-B7EnozSg.cjs');
+const require_router = require('../../router-hA_Y9gZ1.cjs');
 let _adobe_aio_commerce_lib_config = require("@adobe/aio-commerce-lib-config");
 let valibot = require("valibot");
-valibot = require_chunk.__toESM(valibot, 1);
+valibot = require_rolldown_runtime.__toESM(valibot, 1);
+let _adobe_aio_commerce_lib_core_commerce = require("@adobe/aio-commerce-lib-core/commerce");
 let _adobe_aio_commerce_lib_core_responses = require("@adobe/aio-commerce-lib-core/responses");
 
 //#region source/actions/config/schema.ts
@@ -27,45 +29,32 @@ const AcceptedConfigurationValuesSchema = valibot.union([
 	valibot.string(),
 	valibot.array(valibot.string())
 ]);
-/** The set of valid Commerce environments a configuration field can be scoped to. */
-const COMMERCE_ENVS = ["paas", "saas"];
 /** Query parameters for GET / */
 const GetConfigurationQuerySchema = valibot.object({
-	scopeId: require_schemas.nonEmptyStringValueSchema("scopeId"),
-	commerceEnv: valibot.optional(valibot.picklist(COMMERCE_ENVS))
+	commerceEnv: valibot.optional(_adobe_aio_commerce_lib_core_commerce.CommerceEnvSchema),
+	scopeId: require_schemas.nonEmptyStringValueSchema("scopeId")
 });
 /** Request body for PUT / */
 const PutConfigBodySchema = valibot.object({
-	scopeId: require_schemas.nonEmptyStringValueSchema("scopeId"),
 	config: valibot.array(valibot.object({
 		name: require_schemas.nonEmptyStringValueSchema("config[i].name"),
 		value: valibot.union([valibot.string(), valibot.array(valibot.string())])
-	}))
+	})),
+	scopeId: require_schemas.nonEmptyStringValueSchema("scopeId")
 });
 /** Request body for PATCH / */
 const PatchConfigBodySchema = valibot.object({
-	scopeId: require_schemas.nonEmptyStringValueSchema("scopeId"),
 	config: valibot.array(valibot.object({
 		name: require_schemas.nonEmptyStringValueSchema("config[i].name"),
 		value: valibot.nullable(AcceptedConfigurationValuesSchema)
-	}))
+	})),
+	scopeId: require_schemas.nonEmptyStringValueSchema("scopeId")
 });
 
 //#endregion
 //#region source/actions/config/router.ts
 const MASKED_PASSWORD_VALUE = "*****";
 /**
-* 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.
@@ -91,16 +80,15 @@ function filterPasswordFields(schema, values) {
 const router = new require_router.HttpActionRouter().use(require_router.logger({ name: () => "config" }));
 /** GET / - Retrieve configuration */
 router.get("/", {
-	query: GetConfigurationQuerySchema,
 	handler: async (req, ctx) => {
 		const { logger, rawParams } = ctx;
 		const { configSchema: rawConfigSchema } = rawParams;
 		const env = req.query.commerceEnv;
-		const envFilteredSchema = env ? filterSchemaByEnv(rawConfigSchema, env) : rawConfigSchema;
+		const envFilteredSchema = env ? require_environment.filterSchemaByEnv(rawConfigSchema, env) : rawConfigSchema;
 		logger.debug("Initializing configuration");
 		const { configSchema } = await (0, _adobe_aio_commerce_lib_config.initialize)({
-			schema: envFilteredSchema,
-			params: rawParams
+			params: rawParams,
+			schema: envFilteredSchema
 		});
 		const { scopeId } = req.query;
 		logger.debug(`Retrieving configuration with scope id: ${scopeId}`);
@@ -111,7 +99,8 @@ router.get("/", {
 			schema: configSchema,
 			values: appConfiguration
 		} });
-	}
+	},
+	query: GetConfigurationQuerySchema
 });
 /**
 * PUT / - Set configuration (deprecated)
@@ -126,8 +115,8 @@ router.put("/", {
 		logger.debug(`Setting configuration with scope id: ${req.body.scopeId}`);
 		const { scopeId, config } = req.body;
 		const { configSchema } = await (0, _adobe_aio_commerce_lib_config.initialize)({
-			schema: rawParams.configSchema,
-			params: rawParams
+			params: rawParams,
+			schema: rawParams.configSchema
 		});
 		const result = await (0, _adobe_aio_commerce_lib_config.setConfiguration)({ config: config.filter((item) => item.value !== MASKED_PASSWORD_VALUE) }, (0, _adobe_aio_commerce_lib_config.byScopeId)(scopeId), { encryptionKey: rawParams.AIO_COMMERCE_CONFIG_ENCRYPTION_KEY });
 		result.config = filterPasswordFields(configSchema, result.config);
@@ -148,8 +137,8 @@ router.patch("/", {
 		logger.debug(`Patching configuration with scope id: ${req.body.scopeId}`);
 		const { scopeId, config } = req.body;
 		const { configSchema } = await (0, _adobe_aio_commerce_lib_config.initialize)({
-			schema: rawParams.configSchema,
-			params: rawParams
+			params: rawParams,
+			schema: rawParams.configSchema
 		});
 		const result = await (0, _adobe_aio_commerce_lib_config.setConfiguration)({ config }, (0, _adobe_aio_commerce_lib_config.byScopeId)(scopeId), { encryptionKey: rawParams.AIO_COMMERCE_CONFIG_ENCRYPTION_KEY });
 		result.config = filterPasswordFields(configSchema, result.config);