@adobe/aio-commerce-lib-admin-ui 1.1.0-beta-20260820174436 → 1.1.0

package/CHANGELOG.md

@@ -1,11 +1,20 @@
 # @adobe/aio-commerce-lib-admin-ui
 
-## 1.1.0-beta-20260820174436
+## 1.1.0
 
 ### Minor Changes
 
 - [#626](https://github.com/adobe/aio-commerce-sdk/pull/626) [`f012ae0`](https://github.com/adobe/aio-commerce-sdk/commit/f012ae0d8eaac5cac314a62de3902fca842bd936) Thanks [@vinayrao2000](https://github.com/vinayrao2000)! - Add a `refreshExtension` client operation that re-syncs an Admin UI extension's registrations via the dedicated refresh endpoint, with its `RefreshExtensionParams` type and schema.
 
+- [#653](https://github.com/adobe/aio-commerce-sdk/pull/653) [`c04983d`](https://github.com/adobe/aio-commerce-sdk/commit/c04983dfe04926094ab810c070598d5609004a61) Thanks [@oshmyheliuk](https://github.com/oshmyheliuk)! - Export `sanitizeSegment`, which normalizes an id the same way Commerce does when generating ACL resource ids.
+
+- [#653](https://github.com/adobe/aio-commerce-sdk/pull/653) [`c04983d`](https://github.com/adobe/aio-commerce-sdk/commit/c04983dfe04926094ab810c070598d5609004a61) Thanks [@oshmyheliuk](https://github.com/oshmyheliuk)! - Add `getCustomAclResourceId` to derive the deterministic Commerce ACL resource id for a custom `adminUi.acl` resource, checkable at runtime with the permission client.
+
+### Patch Changes
+
+- Updated dependencies [[`1837df1`](https://github.com/adobe/aio-commerce-sdk/commit/1837df107bd2b8d2211f77438a07b6e7ee0af03e)]:
+  - @adobe/aio-commerce-lib-api@1.4.0
+
 ## 1.0.1
 
 ### Patch Changes

package/dist/cjs/{acl-resource-id-DBlYU0DE.d.cts → acl-resource-id-B1UPaYNV.d.cts}

@@ -13,6 +13,13 @@
  */
 
 //#region source/api/lib/acl-resource-id.d.ts
+/**
+ * Sanitizes a single ACL id segment: trims whitespace, lowercases, and replaces every
+ * character outside [a-z0-9_] with an underscore. This mirrors the Commerce module's own
+ * per-segment normalization — the same step applied when building any ACL resource id from a
+ * config id.
+ */
+declare function sanitizeSegment(segment: string): string;
 /**
  * Derives the deterministic Commerce ACL resource id for an app from its metadata id.
  *
@@ -33,7 +40,29 @@
  * @returns The full Commerce ACL resource id, or an empty string when `metadataId` is blank.
  */
 declare function getAclResourceId(metadataId: string): string;
+/**
+ * Derives the deterministic Commerce ACL resource id for a custom (standalone) ACL resource
+ * declared under `adminUi.acl`. Mirrors the Commerce `AclResourceIdGenerator` `acl` token exactly.
+ *
+ * With only `resourceId`, returns the id of a top-level resource or a group node; with `childId`,
+ * returns the id of a leaf inside that group. Each segment is sanitized independently (trim,
+ * lowercase, non-`[a-z0-9_]` → `_`).
+ *
+ * @example
+ * ```
+ * getCustomAclResourceId("my-app", "approve_refunds")
+ * // → "Magento_CommerceBackendUix::adminuisdk_app_my_app_acl_approve_refunds"
+ * getCustomAclResourceId("my-app", "reports", "export")
+ * // → "Magento_CommerceBackendUix::adminuisdk_app_my_app_acl_reports_export"
+ * ```
+ *
+ * @param metadataId - The application's `metadata.id` value.
+ * @param resourceId - The top-level resource or group `id` from `adminUi.acl`.
+ * @param childId - Optional child leaf `id` when addressing a resource inside a group.
+ * @returns The full Commerce ACL resource id, or an empty string when `metadataId` is blank.
+ */
+declare function getCustomAclResourceId(metadataId: string, resourceId: string, childId?: string): string;
 /** Commerce entity an Admin UI component is attached to. */
 type AdminUiEntity = "order" | "product" | "customer";
 //#endregion
-export { getAclResourceId as n, AdminUiEntity as t };
+export { sanitizeSegment as i, getAclResourceId as n, getCustomAclResourceId as r, AdminUiEntity as t };

package/dist/cjs/{acl-resource-id-R52pR3gG.cjs → acl-resource-id-BHCq3fxA.cjs}

@@ -22,9 +22,9 @@
 const PREFIX = "Magento_CommerceBackendUix::adminuisdk_app_";
 /**
 * Sanitizes a single ACL id segment: trims whitespace, lowercases, and replaces every
-* character outside [a-z0-9_] with an underscore.
-*
-* @internal Exported for use by domain ACL helpers only — not part of the public API.
+* character outside [a-z0-9_] with an underscore. This mirrors the Commerce module's own
+* per-segment normalization — the same step applied when building any ACL resource id from a
+* config id.
 */
 function sanitizeSegment(segment) {
 	return segment.trim().toLowerCase().replace(/[^a-z0-9_]/g, "_");
@@ -52,6 +52,33 @@ function getAclResourceId(metadataId) {
 	if (metadataId.trim() === "") return "";
 	return `${PREFIX}${sanitizeSegment(metadataId)}`;
 }
+/**
+* Derives the deterministic Commerce ACL resource id for a custom (standalone) ACL resource
+* declared under `adminUi.acl`. Mirrors the Commerce `AclResourceIdGenerator` `acl` token exactly.
+*
+* With only `resourceId`, returns the id of a top-level resource or a group node; with `childId`,
+* returns the id of a leaf inside that group. Each segment is sanitized independently (trim,
+* lowercase, non-`[a-z0-9_]` → `_`).
+*
+* @example
+* ```
+* getCustomAclResourceId("my-app", "approve_refunds")
+* // → "Magento_CommerceBackendUix::adminuisdk_app_my_app_acl_approve_refunds"
+* getCustomAclResourceId("my-app", "reports", "export")
+* // → "Magento_CommerceBackendUix::adminuisdk_app_my_app_acl_reports_export"
+* ```
+*
+* @param metadataId - The application's `metadata.id` value.
+* @param resourceId - The top-level resource or group `id` from `adminUi.acl`.
+* @param childId - Optional child leaf `id` when addressing a resource inside a group.
+* @returns The full Commerce ACL resource id, or an empty string when `metadataId` is blank.
+*/
+function getCustomAclResourceId(metadataId, resourceId, childId) {
+	const appRoot = getAclResourceId(metadataId);
+	if (appRoot === "") return "";
+	const base = `${appRoot}_acl_${sanitizeSegment(resourceId)}`;
+	return childId === void 0 ? base : `${base}_${sanitizeSegment(childId)}`;
+}
 
 //#endregion
 Object.defineProperty(exports, 'getAclResourceId', {
@@ -60,6 +87,12 @@ Object.defineProperty(exports, 'getAclResourceId', {
     return getAclResourceId;
   }
 });
+Object.defineProperty(exports, 'getCustomAclResourceId', {
+  enumerable: true,
+  get: function () {
+    return getCustomAclResourceId;
+  }
+});
 Object.defineProperty(exports, 'sanitizeSegment', {
   enumerable: true,
   get: function () {

package/dist/cjs/api/index.cjs

@@ -14,7 +14,7 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_rolldown_runtime = require('../rolldown-runtime-Bf2WWRga.cjs');
-const require_acl_resource_id = require('../acl-resource-id-R52pR3gG.cjs');
+const require_acl_resource_id = require('../acl-resource-id-BHCq3fxA.cjs');
 const require_utils = require('../utils-CiBhSMw4.cjs');
 let _adobe_aio_commerce_lib_core_error = require("@adobe/aio-commerce-lib-core/error");
 let _adobe_aio_commerce_lib_api = require("@adobe/aio-commerce-lib-api");
@@ -274,4 +274,6 @@ exports.AdminUiPermissionDeniedError = AdminUiPermissionDeniedError;
 exports.AdminUiPermissionError = AdminUiPermissionError;
 exports.createAdminUiApiClient = createAdminUiApiClient;
 exports.getAclResourceId = require_acl_resource_id.getAclResourceId;
-exports.getAdminUiPermissionClient = getAdminUiPermissionClient;
+exports.getAdminUiPermissionClient = getAdminUiPermissionClient;
+exports.getCustomAclResourceId = require_acl_resource_id.getCustomAclResourceId;
+exports.sanitizeSegment = require_acl_resource_id.sanitizeSegment;

package/dist/cjs/api/index.d.cts

@@ -12,17 +12,17 @@
  * governing permissions and limitations under the License.
  */
 
-import { n as getAclResourceId, t as AdminUiEntity } from "../acl-resource-id-DBlYU0DE.cjs";
+import { i as sanitizeSegment, n as getAclResourceId, r as getCustomAclResourceId, t as AdminUiEntity } from "../acl-resource-id-B1UPaYNV.cjs";
 import { CommerceSdkErrorBase, CommerceSdkErrorOptions } from "@adobe/aio-commerce-lib-core/error";
 import { AdobeCommerceHttpClient, CommerceHttpClientParams } from "@adobe/aio-commerce-lib-api";
 import * as v from "valibot";
 //#region source/errors.d.ts
 /** Base error for Admin UI SDK permission helper failures. */
-declare class AdminUiPermissionError extends CommerceSdkErrorBase {}
+export declare class AdminUiPermissionError extends CommerceSdkErrorBase {}
 /** Options for {@link AdminUiPermissionDeniedError}. */
-type AdminUiPermissionDeniedErrorOptions = CommerceSdkErrorOptions;
+export type AdminUiPermissionDeniedErrorOptions = CommerceSdkErrorOptions;
 /** Error thrown when the current user is denied access to an Admin UI SDK ACL resource. */
-declare class AdminUiPermissionDeniedError extends AdminUiPermissionError {
+export declare class AdminUiPermissionDeniedError extends AdminUiPermissionError {
   readonly resource: string;
   constructor(resource: string, options?: AdminUiPermissionDeniedErrorOptions);
 }
@@ -33,7 +33,7 @@ declare class AdminUiPermissionDeniedError extends AdminUiPermissionError {
  *
  * @param params - The parameters to build the Commerce HTTP client.
  */
-declare function createAdminUiApiClient(params: CommerceHttpClientParams): import("@adobe/aio-commerce-lib-api").ApiClientRecord<AdobeCommerceHttpClient, {
+export declare function createAdminUiApiClient(params: CommerceHttpClientParams): import("@adobe/aio-commerce-lib-api").ApiClientRecord<AdobeCommerceHttpClient, {
   registerExtension(httpClient: AdobeCommerceHttpClient, params: ExtensionRegistrationParams, fetchOptions?: import("ky").Options): Promise<RegisterExtensionResponse>;
   unregisterExtension(httpClient: AdobeCommerceHttpClient, params: UnregisterExtensionParams, fetchOptions?: import("ky").Options): Promise<void>;
   refreshExtension(httpClient: AdobeCommerceHttpClient, params: RefreshExtensionParams, fetchOptions?: import("ky").Options): Promise<void>;
@@ -43,11 +43,11 @@ declare function createAdminUiApiClient(params: CommerceHttpClientParams): impor
  * An API client for the Admin UI API with all operations.
  * @see {@link createAdminUiApiClient}
  */
-type AdminUiApiClient = ReturnType<typeof createAdminUiApiClient>;
+export type AdminUiApiClient = ReturnType<typeof createAdminUiApiClient>;
 //#endregion
 //#region source/api/lib/permission-client.d.ts
 /** Options used to create an Admin UI SDK permission client. */
-type AdminUiPermissionClientOptions = {
+export type AdminUiPermissionClientOptions = {
   /** The application's `metadata.id` value. When provided, `check()` and `require()` can be called with no resource argument. */
   appId?: string;
   /**
@@ -62,7 +62,7 @@ type AdminUiPermissionClientOptions = {
   httpClient: AdobeCommerceHttpClient;
 };
 /** Client for checking the current user's Admin UI SDK resource permissions. */
-type AdminUiPermissionClient = {
+export type AdminUiPermissionClient = {
   /**
    * Checks whether the current user has the given ACL resource granted.
    *
@@ -95,7 +95,7 @@ type AdminUiPermissionClient = {
  * @param options - Client configuration; see {@link AdminUiPermissionClientOptions}.
  * @returns An {@link AdminUiPermissionClient} for checking and requiring ACL resources.
  */
-declare function getAdminUiPermissionClient(options: AdminUiPermissionClientOptions): AdminUiPermissionClient;
+export declare function getAdminUiPermissionClient(options: AdminUiPermissionClientOptions): AdminUiPermissionClient;
 //#endregion
 //#region source/api/extensions/schema.d.ts
 /** Parameters for POST /V1/adminuisdk/extension. */
@@ -133,4 +133,4 @@ declare const permissionCheckResponseSchema: v.ObjectSchema<{
 /** Parsed Admin UI SDK permission check response. */
 type PermissionCheckResponse = v.InferOutput<typeof permissionCheckResponseSchema>;
 //#endregion
-export { AdminUiApiClient, type AdminUiEntity, AdminUiPermissionClient, AdminUiPermissionClientOptions, AdminUiPermissionDeniedError, AdminUiPermissionDeniedErrorOptions, AdminUiPermissionError, type ExtensionRegistrationParams, type ExtensionRegistrationParamsSchema, type PermissionCheckResponse, type RefreshExtensionParams, type RefreshExtensionParamsSchema, type RegisterExtensionResponse, type UnregisterExtensionParams, type UnregisterExtensionParamsSchema, createAdminUiApiClient, getAclResourceId, getAdminUiPermissionClient, type permissionCheckResponseSchema };
+export { type AdminUiEntity, type ExtensionRegistrationParams, type ExtensionRegistrationParamsSchema, type PermissionCheckResponse, type RefreshExtensionParams, type RefreshExtensionParamsSchema, type RegisterExtensionResponse, type UnregisterExtensionParams, type UnregisterExtensionParamsSchema, getAclResourceId, getCustomAclResourceId, type permissionCheckResponseSchema, sanitizeSegment };

package/dist/cjs/grid-columns/index.cjs

@@ -14,7 +14,7 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_rolldown_runtime = require('../rolldown-runtime-Bf2WWRga.cjs');
-const require_acl_resource_id = require('../acl-resource-id-R52pR3gG.cjs');
+const require_acl_resource_id = require('../acl-resource-id-BHCq3fxA.cjs');
 const require_schemas = require('../schemas-DRhCF0TF.cjs');
 const require_utils = require('../utils-CiBhSMw4.cjs');
 let valibot = require("valibot");

package/dist/cjs/grid-columns/index.d.cts

@@ -12,7 +12,7 @@
  * governing permissions and limitations under the License.
  */
 
-import { t as AdminUiEntity } from "../acl-resource-id-DBlYU0DE.cjs";
+import { t as AdminUiEntity } from "../acl-resource-id-B1UPaYNV.cjs";
 import * as v from "valibot";
 import { ErrorResponse, SuccessResponse } from "@adobe/aio-commerce-lib-core/responses";
 //#region source/grid-columns/acl-resource-id.d.ts
@@ -39,7 +39,7 @@ import { ErrorResponse, SuccessResponse } from "@adobe/aio-commerce-lib-core/res
  * @returns The full Commerce ACL resource id for the grid-column leaf node, or an empty string
  *   when `metadataId` is blank.
  */
-declare function getGridColumnAclResourceId(metadataId: string, entity: AdminUiEntity, columnId: string): string;
+export declare function getGridColumnAclResourceId(metadataId: string, entity: AdminUiEntity, columnId: string): string;
 //#endregion
 //#region source/grid-columns/requests/schema.d.ts
 /**
@@ -47,7 +47,7 @@ declare function getGridColumnAclResourceId(metadataId: string, entity: AdminUiE
  *
  * @see {@link https://github.com/magento-commerce/adobe-commerce-backend-uix Magento module reference}
  */
-declare const GridTypeSchema: v.PicklistSchema<["order", "product", "customer"], undefined>;
+export declare const GridTypeSchema: v.PicklistSchema<["order", "product", "customer"], undefined>;
 /**
  * Schema for the JSON body Commerce POSTs to a grid column handler.
  *
@@ -55,7 +55,7 @@ declare const GridTypeSchema: v.PicklistSchema<["order", "product", "customer"],
  * per request). The upper bound is the Commerce side's contract and is not
  * enforced here.
  */
-declare const GridRequestSchema: v.ObjectSchema<{
+export declare const GridRequestSchema: v.ObjectSchema<{
   readonly gridType: v.PicklistSchema<["order", "product", "customer"], undefined>;
   readonly ids: v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>, undefined>, v.MinLengthAction<string[], 1, "The value of \"ids\" must contain at least one entry">]>;
   readonly requestId: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
@@ -83,7 +83,7 @@ type GridRequest = v.InferOutput<typeof GridRequestSchema>;
  * }
  * ```
  */
-declare function parseGridRequest(input: unknown): GridRequest;
+export declare function parseGridRequest(input: unknown): GridRequest;
 //#endregion
 //#region source/grid-columns/responses/types.d.ts
 /** Cell values returned for a single row, keyed by `id`. */
@@ -126,7 +126,7 @@ type GridErrorBody = {
  * );
  * ```
  */
-declare function okGridResponse(data: Record<string, GridRow>, defaults?: GridRow): SuccessResponse<GridSuccessBody>;
+export declare function okGridResponse(data: Record<string, GridRow>, defaults?: GridRow): SuccessResponse<GridSuccessBody>;
 /**
  * Builds an error response for a grid column handler with the given HTTP status code.
  *
@@ -140,6 +140,6 @@ declare function okGridResponse(data: Record<string, GridRow>, defaults?: GridRo
  * return errorGridResponse(500, "Could not reach inventory service");
  * ```
  */
-declare function errorGridResponse(statusCode: number, errorMessage: string): ErrorResponse<GridErrorBody>;
+export declare function errorGridResponse(statusCode: number, errorMessage: string): ErrorResponse<GridErrorBody>;
 //#endregion
-export { type AdminUiEntity, type GridErrorBody, type GridRequest, GridRequestSchema, type GridRow, type GridSuccessBody, type GridType, GridTypeSchema, errorGridResponse, getGridColumnAclResourceId, okGridResponse, parseGridRequest };
+export type { AdminUiEntity, GridErrorBody, GridRequest, GridRow, GridSuccessBody, GridType };

package/dist/cjs/mass-actions/index.cjs

@@ -14,7 +14,7 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_rolldown_runtime = require('../rolldown-runtime-Bf2WWRga.cjs');
-const require_acl_resource_id = require('../acl-resource-id-R52pR3gG.cjs');
+const require_acl_resource_id = require('../acl-resource-id-BHCq3fxA.cjs');
 const require_schemas = require('../schemas-DRhCF0TF.cjs');
 const require_utils = require('../utils-CiBhSMw4.cjs');
 let valibot = require("valibot");

package/dist/cjs/mass-actions/index.d.cts

@@ -12,7 +12,7 @@
  * governing permissions and limitations under the License.
  */
 
-import { t as AdminUiEntity } from "../acl-resource-id-DBlYU0DE.cjs";
+import { t as AdminUiEntity } from "../acl-resource-id-B1UPaYNV.cjs";
 import * as v from "valibot";
 import { ErrorResponse, SuccessResponse } from "@adobe/aio-commerce-lib-core/responses";
 //#region source/mass-actions/acl-resource-id.d.ts
@@ -39,14 +39,14 @@ import { ErrorResponse, SuccessResponse } from "@adobe/aio-commerce-lib-core/res
  * @returns The full Commerce ACL resource id for the mass-action leaf node, or an empty string
  *   when `metadataId` is blank.
  */
-declare function getMassActionAclResourceId(metadataId: string, entity: AdminUiEntity, actionId: string): string;
+export declare function getMassActionAclResourceId(metadataId: string, entity: AdminUiEntity, actionId: string): string;
 //#endregion
 //#region source/mass-actions/worker/schema.d.ts
 /**
  * Grid identifier sent by Commerce on the `commerce/backend-ui/2` wire contract
  * for worker mass actions.
  */
-declare const MassActionGridTypeSchema: v.PicklistSchema<["order", "product", "customer"], undefined>;
+export declare const MassActionGridTypeSchema: v.PicklistSchema<["order", "product", "customer"], undefined>;
 /**
  * Schema for the JSON body Commerce POSTs to a worker mass action handler.
  *
@@ -54,7 +54,7 @@ declare const MassActionGridTypeSchema: v.PicklistSchema<["order", "product", "c
  * IDs per request). The upper bound is the Commerce side's contract and is not
  * enforced here.
  */
-declare const MassActionRequestSchema: v.ObjectSchema<{
+export declare const MassActionRequestSchema: v.ObjectSchema<{
   readonly gridType: v.PicklistSchema<["order", "product", "customer"], undefined>;
   readonly requestId: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
   readonly selectedIds: v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>, undefined>, v.MinLengthAction<string[], 1, "The value of \"selectedIds\" must contain at least one entry">]>;
@@ -88,7 +88,7 @@ type MassActionErrorBody = {
  * }
  * ```
  */
-declare function parseMassActionRequest(input: unknown): MassActionRequest;
+export declare function parseMassActionRequest(input: unknown): MassActionRequest;
 /**
  * Builds an HTTP 200 success response for a worker mass action.
  *
@@ -101,7 +101,7 @@ declare function parseMassActionRequest(input: unknown): MassActionRequest;
  * return okMassActionResponse({ exported: selectedIds.length });
  * ```
  */
-declare function okMassActionResponse(body?: MassActionResponseBody): SuccessResponse<MassActionResponseBody>;
+export declare function okMassActionResponse(body?: MassActionResponseBody): SuccessResponse<MassActionResponseBody>;
 /**
  * Builds an error response for a worker mass action with the given HTTP status code.
  *
@@ -113,6 +113,6 @@ declare function okMassActionResponse(body?: MassActionResponseBody): SuccessRes
  * return massActionErrorResponse(422, "Request entity is unprocessable");
  * ```
  */
-declare function massActionErrorResponse(statusCode: number, errorMessage: string): ErrorResponse<MassActionErrorBody>;
+export declare function massActionErrorResponse(statusCode: number, errorMessage: string): ErrorResponse<MassActionErrorBody>;
 //#endregion
-export { type AdminUiEntity, type MassActionErrorBody, type MassActionGridType, MassActionGridTypeSchema, type MassActionRequest, MassActionRequestSchema, type MassActionResponseBody, getMassActionAclResourceId, massActionErrorResponse, okMassActionResponse, parseMassActionRequest };
+export type { AdminUiEntity, MassActionErrorBody, MassActionGridType, MassActionRequest, MassActionResponseBody };

package/dist/cjs/menu/index.cjs

@@ -13,7 +13,7 @@
  */
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_acl_resource_id = require('../acl-resource-id-R52pR3gG.cjs');
+const require_acl_resource_id = require('../acl-resource-id-BHCq3fxA.cjs');
 
 //#region source/menu/acl-resource-id.ts
 /**

package/dist/cjs/menu/index.d.cts

@@ -34,30 +34,29 @@
  * @returns The full Commerce ACL resource id for the menu leaf node, or an empty string
  *   when `metadataId` is blank.
  */
-declare function getMenuAclResourceId(metadataId: string, menuId: string): string;
+export declare function getMenuAclResourceId(metadataId: string, menuId: string): string;
 //#endregion
 //#region source/menu/paths.d.ts
 /** Menu ID for "Catalog" in the Adobe Commerce admin */
-declare const MENU_CATALOG = "catalog";
+export declare const MENU_CATALOG = "catalog";
 /** Menu ID for "Customers" in the Adobe Commerce admin */
-declare const MENU_CUSTOMERS = "customers";
+export declare const MENU_CUSTOMERS = "customers";
 /** Menu ID for "Marketing" in the Adobe Commerce admin */
-declare const MENU_MARKETING = "marketing";
+export declare const MENU_MARKETING = "marketing";
 /** Menu ID for "Content" in the Adobe Commerce admin */
-declare const MENU_CONTENT = "content";
+export declare const MENU_CONTENT = "content";
 /** Menu ID for "Reports" in the Adobe Commerce admin */
-declare const MENU_REPORTS = "reports";
+export declare const MENU_REPORTS = "reports";
 /** Menu ID for "Sales" in the Adobe Commerce admin */
-declare const MENU_SALES = "sales";
+export declare const MENU_SALES = "sales";
 /** Menu ID for "Stores" in the Adobe Commerce admin */
-declare const MENU_STORES = "stores";
+export declare const MENU_STORES = "stores";
 /** Menu ID for "System" in the Adobe Commerce admin */
-declare const MENU_SYSTEM = "system";
+export declare const MENU_SYSTEM = "system";
 /** All Commerce Admin menus available for app attachment. */
-declare const COMMERCE_MENUS: readonly ["sales", "catalog", "customers", "marketing", "content", "reports", "stores", "system"];
+export declare const COMMERCE_MENUS: readonly ["sales", "catalog", "customers", "marketing", "content", "reports", "stores", "system"];
 /** A union type of all known supported Commerce Admin menu IDs. */
-type CommerceMenu = (typeof COMMERCE_MENUS)[number];
+export type CommerceMenu = (typeof COMMERCE_MENUS)[number];
 /** Returns true if the given string is a known Commerce Admin menu ID. */
-declare function isCommerceMenu(menu: string): menu is CommerceMenu;
-//#endregion
-export { COMMERCE_MENUS, CommerceMenu, MENU_CATALOG, MENU_CONTENT, MENU_CUSTOMERS, MENU_MARKETING, MENU_REPORTS, MENU_SALES, MENU_STORES, MENU_SYSTEM, getMenuAclResourceId, isCommerceMenu };
+export declare function isCommerceMenu(menu: string): menu is CommerceMenu;
+//#endregion

package/dist/cjs/order-view-buttons/index.cjs

@@ -14,7 +14,7 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_rolldown_runtime = require('../rolldown-runtime-Bf2WWRga.cjs');
-const require_acl_resource_id = require('../acl-resource-id-R52pR3gG.cjs');
+const require_acl_resource_id = require('../acl-resource-id-BHCq3fxA.cjs');
 const require_schemas = require('../schemas-DRhCF0TF.cjs');
 const require_utils = require('../utils-CiBhSMw4.cjs');
 let valibot = require("valibot");

package/dist/cjs/order-view-buttons/index.d.cts

@@ -37,7 +37,7 @@ import { ErrorResponse, SuccessResponse } from "@adobe/aio-commerce-lib-core/res
  * @returns The full Commerce ACL resource id for the view-button leaf node, or an empty string
  *   when `metadataId` is blank.
  */
-declare function getOrderViewButtonAclResourceId(metadataId: string, buttonId: string): string;
+export declare function getOrderViewButtonAclResourceId(metadataId: string, buttonId: string): string;
 //#endregion
 //#region source/order-view-buttons/schema.d.ts
 /**
@@ -47,7 +47,7 @@ declare function getOrderViewButtonAclResourceId(metadataId: string, buttonId: s
  * handler serve multiple buttons by branching on it. `orderId` is the
  * single order currently being viewed.
  */
-declare const OrderViewButtonRequestSchema: v.ObjectSchema<{
+export declare const OrderViewButtonRequestSchema: v.ObjectSchema<{
   readonly id: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
   readonly orderId: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
   readonly requestId: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
@@ -81,7 +81,7 @@ type OrderViewButtonErrorBody = {
  * }
  * ```
  */
-declare function parseOrderViewButtonRequest(input: unknown): OrderViewButtonRequest;
+export declare function parseOrderViewButtonRequest(input: unknown): OrderViewButtonRequest;
 /**
  * Builds an HTTP 200 success response for an order view button handler.
  *
@@ -93,7 +93,7 @@ declare function parseOrderViewButtonRequest(input: unknown): OrderViewButtonReq
  * return okOrderViewButtonResponse();
  * ```
  */
-declare function okOrderViewButtonResponse(): SuccessResponse<OrderViewButtonSuccessBody>;
+export declare function okOrderViewButtonResponse(): SuccessResponse<OrderViewButtonSuccessBody>;
 /**
  * Builds an error response for a worker order view button handler with the given HTTP status code.
  *
@@ -107,6 +107,6 @@ declare function okOrderViewButtonResponse(): SuccessResponse<OrderViewButtonSuc
  * return orderViewButtonErrorResponse(500, "Could not reach inventory service");
  * ```
  */
-declare function orderViewButtonErrorResponse(statusCode: number, errorMessage: string): ErrorResponse<OrderViewButtonErrorBody>;
+export declare function orderViewButtonErrorResponse(statusCode: number, errorMessage: string): ErrorResponse<OrderViewButtonErrorBody>;
 //#endregion
-export { type OrderViewButtonErrorBody, type OrderViewButtonRequest, OrderViewButtonRequestSchema, type OrderViewButtonSuccessBody, getOrderViewButtonAclResourceId, okOrderViewButtonResponse, orderViewButtonErrorResponse, parseOrderViewButtonRequest };
+export type { OrderViewButtonErrorBody, OrderViewButtonRequest, OrderViewButtonSuccessBody };

package/dist/cjs/web/index.cjs

@@ -18,8 +18,8 @@ let react = require("react");
 let react_jsx_runtime = require("react/jsx-runtime");
 let _adobe_exc_app = require("@adobe/exc-app");
 _adobe_exc_app = require_rolldown_runtime.__toESM(_adobe_exc_app, 1);
-let _adobe_exc_app_page_js = require("@adobe/exc-app/page.js");
-_adobe_exc_app_page_js = require_rolldown_runtime.__toESM(_adobe_exc_app_page_js, 1);
+let _adobe_exc_app_page = require("@adobe/exc-app/page");
+_adobe_exc_app_page = require_rolldown_runtime.__toESM(_adobe_exc_app_page, 1);
 let _tanstack_react_router = require("@tanstack/react-router");
 let react_dom_client = require("react-dom/client");
 let _adobe_uix_guest = require("@adobe/uix-guest");
@@ -860,10 +860,10 @@ function createExtensionApp({ menu, metadata, routes = [], root: customRoot }) {
 		(0, _adobe_exc_app.init)(() => {
 			const runtime = (0, _adobe_exc_app.default)();
 			const { promise, resolve } = Promise.withResolvers();
-			_adobe_exc_app_page_js.default.title = document.title;
+			_adobe_exc_app_page.default.title = document.title;
 			runtime.on("ready", (configuration) => {
 				resolve(configuration ?? runtime.lastConfigurationPayload);
-				_adobe_exc_app_page_js.default.done().catch(() => {
+				_adobe_exc_app_page.default.done().catch(() => {
 					console.warn("Failed to mark page as done in Experience Cloud Shell.");
 				});
 			});

package/dist/cjs/web/index.d.cts

@@ -50,7 +50,7 @@ type ActionsResult<T extends ActionMap, E = Error> = {
  *
  * Returns an error when no host provides credentials.
  */
-declare function useIms(): Result<ImsContext>;
+export declare function useIms(): Result<ImsContext>;
 //#endregion
 //#region source/web/react/commerce/types.d.ts
 /** The guest connection that shares the context between the extension and the Admin UI host. */
@@ -106,7 +106,7 @@ type OrderViewButtonContext = {
  * }
  * ```
  */
-declare function useSharedContext(): Result<SharedContext>;
+export declare function useSharedContext(): Result<SharedContext>;
 //#endregion
 //#region source/web/react/commerce/hooks/use-commerce.d.ts
 type CommerceData = {
@@ -119,7 +119,7 @@ type CommerceData = {
  * Returns an error when used outside a Commerce Admin UI frame, when the host does not expose the
  * Commerce integration API, or when resolving the host fails.
  */
-declare function useCommerce(): Result<CommerceData>;
+export declare function useCommerce(): Result<CommerceData>;
 //#endregion
 //#region source/web/react/commerce/hooks/use-extension-context.d.ts
 /**
@@ -129,14 +129,14 @@ declare function useCommerce(): Result<CommerceData>;
  * Returns an error outside the Commerce shared context, or when the mass-action selection is
  * missing, empty, or contains a non-string row ID.
  */
-declare function useMassActionContext(): Result<MassActionContext>;
+export declare function useMassActionContext(): Result<MassActionContext>;
 /**
  * Returns the context for an order view-button extension point: the order ID the button was
  * triggered from.
  *
  * Returns an error when no order ID is present in the page URL.
  */
-declare function useOrderViewButtonContext(): Result<OrderViewButtonContext>;
+export declare function useOrderViewButtonContext(): Result<OrderViewButtonContext>;
 //#endregion
 //#region source/web/react/commerce/hooks/use-host-connection.d.ts
 /**
@@ -153,7 +153,7 @@ declare function useOrderViewButtonContext(): Result<OrderViewButtonContext>;
  * }
  * ```
  */
-declare function useHostConnection(): ActionsResult<HostConnection>;
+export declare function useHostConnection(): ActionsResult<HostConnection>;
 //#endregion
 //#region source/web/react/routing/types.d.ts
 declare module "@react-spectrum/s2/Provider" {
@@ -208,6 +208,6 @@ type CreateExtensionAppOptions = {
  * });
  * ```
  */
-declare function createExtensionApp({ menu, metadata, routes, root: customRoot }: CreateExtensionAppOptions): void;
+export declare function createExtensionApp({ menu, metadata, routes, root: customRoot }: CreateExtensionAppOptions): void;
 //#endregion
-export { type CreateExtensionAppOptions, type ExtensionRoute, type HostConnection, type ImsContext, type MassActionContext, type OrderViewButtonContext, type SharedContext, createExtensionApp, useCommerce, useHostConnection, useIms, useMassActionContext, useOrderViewButtonContext, useSharedContext };
+export type { CreateExtensionAppOptions, ExtensionRoute, HostConnection, ImsContext, MassActionContext, OrderViewButtonContext, SharedContext };

package/dist/es/{acl-resource-id-DBlYU0DE.d.mts → acl-resource-id-B1UPaYNV.d.mts}

@@ -13,6 +13,13 @@
  */
 
 //#region source/api/lib/acl-resource-id.d.ts
+/**
+ * Sanitizes a single ACL id segment: trims whitespace, lowercases, and replaces every
+ * character outside [a-z0-9_] with an underscore. This mirrors the Commerce module's own
+ * per-segment normalization — the same step applied when building any ACL resource id from a
+ * config id.
+ */
+declare function sanitizeSegment(segment: string): string;
 /**
  * Derives the deterministic Commerce ACL resource id for an app from its metadata id.
  *
@@ -33,7 +40,29 @@
  * @returns The full Commerce ACL resource id, or an empty string when `metadataId` is blank.
  */
 declare function getAclResourceId(metadataId: string): string;
+/**
+ * Derives the deterministic Commerce ACL resource id for a custom (standalone) ACL resource
+ * declared under `adminUi.acl`. Mirrors the Commerce `AclResourceIdGenerator` `acl` token exactly.
+ *
+ * With only `resourceId`, returns the id of a top-level resource or a group node; with `childId`,
+ * returns the id of a leaf inside that group. Each segment is sanitized independently (trim,
+ * lowercase, non-`[a-z0-9_]` → `_`).
+ *
+ * @example
+ * ```
+ * getCustomAclResourceId("my-app", "approve_refunds")
+ * // → "Magento_CommerceBackendUix::adminuisdk_app_my_app_acl_approve_refunds"
+ * getCustomAclResourceId("my-app", "reports", "export")
+ * // → "Magento_CommerceBackendUix::adminuisdk_app_my_app_acl_reports_export"
+ * ```
+ *
+ * @param metadataId - The application's `metadata.id` value.
+ * @param resourceId - The top-level resource or group `id` from `adminUi.acl`.
+ * @param childId - Optional child leaf `id` when addressing a resource inside a group.
+ * @returns The full Commerce ACL resource id, or an empty string when `metadataId` is blank.
+ */
+declare function getCustomAclResourceId(metadataId: string, resourceId: string, childId?: string): string;
 /** Commerce entity an Admin UI component is attached to. */
 type AdminUiEntity = "order" | "product" | "customer";
 //#endregion
-export { getAclResourceId as n, AdminUiEntity as t };
+export { sanitizeSegment as i, getAclResourceId as n, getCustomAclResourceId as r, AdminUiEntity as t };

package/dist/es/{acl-resource-id-pryVxI_c.mjs → acl-resource-id-CIxfW36q.mjs}

@@ -22,9 +22,9 @@
 const PREFIX = "Magento_CommerceBackendUix::adminuisdk_app_";
 /**
 * Sanitizes a single ACL id segment: trims whitespace, lowercases, and replaces every
-* character outside [a-z0-9_] with an underscore.
-*
-* @internal Exported for use by domain ACL helpers only — not part of the public API.
+* character outside [a-z0-9_] with an underscore. This mirrors the Commerce module's own
+* per-segment normalization — the same step applied when building any ACL resource id from a
+* config id.
 */
 function sanitizeSegment(segment) {
 	return segment.trim().toLowerCase().replace(/[^a-z0-9_]/g, "_");
@@ -52,6 +52,33 @@ function getAclResourceId(metadataId) {
 	if (metadataId.trim() === "") return "";
 	return `${PREFIX}${sanitizeSegment(metadataId)}`;
 }
+/**
+* Derives the deterministic Commerce ACL resource id for a custom (standalone) ACL resource
+* declared under `adminUi.acl`. Mirrors the Commerce `AclResourceIdGenerator` `acl` token exactly.
+*
+* With only `resourceId`, returns the id of a top-level resource or a group node; with `childId`,
+* returns the id of a leaf inside that group. Each segment is sanitized independently (trim,
+* lowercase, non-`[a-z0-9_]` → `_`).
+*
+* @example
+* ```
+* getCustomAclResourceId("my-app", "approve_refunds")
+* // → "Magento_CommerceBackendUix::adminuisdk_app_my_app_acl_approve_refunds"
+* getCustomAclResourceId("my-app", "reports", "export")
+* // → "Magento_CommerceBackendUix::adminuisdk_app_my_app_acl_reports_export"
+* ```
+*
+* @param metadataId - The application's `metadata.id` value.
+* @param resourceId - The top-level resource or group `id` from `adminUi.acl`.
+* @param childId - Optional child leaf `id` when addressing a resource inside a group.
+* @returns The full Commerce ACL resource id, or an empty string when `metadataId` is blank.
+*/
+function getCustomAclResourceId(metadataId, resourceId, childId) {
+	const appRoot = getAclResourceId(metadataId);
+	if (appRoot === "") return "";
+	const base = `${appRoot}_acl_${sanitizeSegment(resourceId)}`;
+	return childId === void 0 ? base : `${base}_${sanitizeSegment(childId)}`;
+}
 
 //#endregion
-export { sanitizeSegment as n, getAclResourceId as t };
+export { getCustomAclResourceId as n, sanitizeSegment as r, getAclResourceId as t };

package/dist/es/api/index.d.mts

@@ -12,17 +12,17 @@
  * governing permissions and limitations under the License.
  */
 
-import { n as getAclResourceId, t as AdminUiEntity } from "../acl-resource-id-DBlYU0DE.mjs";
+import { i as sanitizeSegment, n as getAclResourceId, r as getCustomAclResourceId, t as AdminUiEntity } from "../acl-resource-id-B1UPaYNV.mjs";
 import { CommerceSdkErrorBase, CommerceSdkErrorOptions } from "@adobe/aio-commerce-lib-core/error";
 import { AdobeCommerceHttpClient, CommerceHttpClientParams } from "@adobe/aio-commerce-lib-api";
 import * as v from "valibot";
 //#region source/errors.d.ts
 /** Base error for Admin UI SDK permission helper failures. */
-declare class AdminUiPermissionError extends CommerceSdkErrorBase {}
+export declare class AdminUiPermissionError extends CommerceSdkErrorBase {}
 /** Options for {@link AdminUiPermissionDeniedError}. */
-type AdminUiPermissionDeniedErrorOptions = CommerceSdkErrorOptions;
+export type AdminUiPermissionDeniedErrorOptions = CommerceSdkErrorOptions;
 /** Error thrown when the current user is denied access to an Admin UI SDK ACL resource. */
-declare class AdminUiPermissionDeniedError extends AdminUiPermissionError {
+export declare class AdminUiPermissionDeniedError extends AdminUiPermissionError {
   readonly resource: string;
   constructor(resource: string, options?: AdminUiPermissionDeniedErrorOptions);
 }
@@ -33,7 +33,7 @@ declare class AdminUiPermissionDeniedError extends AdminUiPermissionError {
  *
  * @param params - The parameters to build the Commerce HTTP client.
  */
-declare function createAdminUiApiClient(params: CommerceHttpClientParams): import("@adobe/aio-commerce-lib-api").ApiClientRecord<AdobeCommerceHttpClient, {
+export declare function createAdminUiApiClient(params: CommerceHttpClientParams): import("@adobe/aio-commerce-lib-api").ApiClientRecord<AdobeCommerceHttpClient, {
   registerExtension(httpClient: AdobeCommerceHttpClient, params: ExtensionRegistrationParams, fetchOptions?: import("ky").Options): Promise<RegisterExtensionResponse>;
   unregisterExtension(httpClient: AdobeCommerceHttpClient, params: UnregisterExtensionParams, fetchOptions?: import("ky").Options): Promise<void>;
   refreshExtension(httpClient: AdobeCommerceHttpClient, params: RefreshExtensionParams, fetchOptions?: import("ky").Options): Promise<void>;
@@ -43,11 +43,11 @@ declare function createAdminUiApiClient(params: CommerceHttpClientParams): impor
  * An API client for the Admin UI API with all operations.
  * @see {@link createAdminUiApiClient}
  */
-type AdminUiApiClient = ReturnType<typeof createAdminUiApiClient>;
+export type AdminUiApiClient = ReturnType<typeof createAdminUiApiClient>;
 //#endregion
 //#region source/api/lib/permission-client.d.ts
 /** Options used to create an Admin UI SDK permission client. */
-type AdminUiPermissionClientOptions = {
+export type AdminUiPermissionClientOptions = {
   /** The application's `metadata.id` value. When provided, `check()` and `require()` can be called with no resource argument. */
   appId?: string;
   /**
@@ -62,7 +62,7 @@ type AdminUiPermissionClientOptions = {
   httpClient: AdobeCommerceHttpClient;
 };
 /** Client for checking the current user's Admin UI SDK resource permissions. */
-type AdminUiPermissionClient = {
+export type AdminUiPermissionClient = {
   /**
    * Checks whether the current user has the given ACL resource granted.
    *
@@ -95,7 +95,7 @@ type AdminUiPermissionClient = {
  * @param options - Client configuration; see {@link AdminUiPermissionClientOptions}.
  * @returns An {@link AdminUiPermissionClient} for checking and requiring ACL resources.
  */
-declare function getAdminUiPermissionClient(options: AdminUiPermissionClientOptions): AdminUiPermissionClient;
+export declare function getAdminUiPermissionClient(options: AdminUiPermissionClientOptions): AdminUiPermissionClient;
 //#endregion
 //#region source/api/extensions/schema.d.ts
 /** Parameters for POST /V1/adminuisdk/extension. */
@@ -133,4 +133,4 @@ declare const permissionCheckResponseSchema: v.ObjectSchema<{
 /** Parsed Admin UI SDK permission check response. */
 type PermissionCheckResponse = v.InferOutput<typeof permissionCheckResponseSchema>;
 //#endregion
-export { AdminUiApiClient, type AdminUiEntity, AdminUiPermissionClient, AdminUiPermissionClientOptions, AdminUiPermissionDeniedError, AdminUiPermissionDeniedErrorOptions, AdminUiPermissionError, type ExtensionRegistrationParams, type ExtensionRegistrationParamsSchema, type PermissionCheckResponse, type RefreshExtensionParams, type RefreshExtensionParamsSchema, type RegisterExtensionResponse, type UnregisterExtensionParams, type UnregisterExtensionParamsSchema, createAdminUiApiClient, getAclResourceId, getAdminUiPermissionClient, type permissionCheckResponseSchema };
+export { type AdminUiEntity, type ExtensionRegistrationParams, type ExtensionRegistrationParamsSchema, type PermissionCheckResponse, type RefreshExtensionParams, type RefreshExtensionParamsSchema, type RegisterExtensionResponse, type UnregisterExtensionParams, type UnregisterExtensionParamsSchema, getAclResourceId, getCustomAclResourceId, type permissionCheckResponseSchema, sanitizeSegment };

package/dist/es/api/index.mjs

@@ -12,7 +12,7 @@
  * governing permissions and limitations under the License.
  */
 
-import { t as getAclResourceId } from "../acl-resource-id-pryVxI_c.mjs";
+import { n as getCustomAclResourceId, r as sanitizeSegment, t as getAclResourceId } from "../acl-resource-id-CIxfW36q.mjs";
 import { t as parseOrThrow } from "../utils-COPGW1HO.mjs";
 import { CommerceSdkErrorBase } from "@adobe/aio-commerce-lib-core/error";
 import { AdobeCommerceHttpClient, ApiClient } from "@adobe/aio-commerce-lib-api";
@@ -284,4 +284,4 @@ function getAdminUiPermissionClient(options) {
 }
 
 //#endregion
-export { AdminUiPermissionDeniedError, AdminUiPermissionError, createAdminUiApiClient, getAclResourceId, getAdminUiPermissionClient };
+export { AdminUiPermissionDeniedError, AdminUiPermissionError, createAdminUiApiClient, getAclResourceId, getAdminUiPermissionClient, getCustomAclResourceId, sanitizeSegment };

package/dist/es/grid-columns/index.d.mts

@@ -12,7 +12,7 @@
  * governing permissions and limitations under the License.
  */
 
-import { t as AdminUiEntity } from "../acl-resource-id-DBlYU0DE.mjs";
+import { t as AdminUiEntity } from "../acl-resource-id-B1UPaYNV.mjs";
 import * as v from "valibot";
 import { ErrorResponse, SuccessResponse } from "@adobe/aio-commerce-lib-core/responses";
 //#region source/grid-columns/acl-resource-id.d.ts
@@ -39,7 +39,7 @@ import { ErrorResponse, SuccessResponse } from "@adobe/aio-commerce-lib-core/res
  * @returns The full Commerce ACL resource id for the grid-column leaf node, or an empty string
  *   when `metadataId` is blank.
  */
-declare function getGridColumnAclResourceId(metadataId: string, entity: AdminUiEntity, columnId: string): string;
+export declare function getGridColumnAclResourceId(metadataId: string, entity: AdminUiEntity, columnId: string): string;
 //#endregion
 //#region source/grid-columns/requests/schema.d.ts
 /**
@@ -47,7 +47,7 @@ declare function getGridColumnAclResourceId(metadataId: string, entity: AdminUiE
  *
  * @see {@link https://github.com/magento-commerce/adobe-commerce-backend-uix Magento module reference}
  */
-declare const GridTypeSchema: v.PicklistSchema<["order", "product", "customer"], undefined>;
+export declare const GridTypeSchema: v.PicklistSchema<["order", "product", "customer"], undefined>;
 /**
  * Schema for the JSON body Commerce POSTs to a grid column handler.
  *
@@ -55,7 +55,7 @@ declare const GridTypeSchema: v.PicklistSchema<["order", "product", "customer"],
  * per request). The upper bound is the Commerce side's contract and is not
  * enforced here.
  */
-declare const GridRequestSchema: v.ObjectSchema<{
+export declare const GridRequestSchema: v.ObjectSchema<{
   readonly gridType: v.PicklistSchema<["order", "product", "customer"], undefined>;
   readonly ids: v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>, undefined>, v.MinLengthAction<string[], 1, "The value of \"ids\" must contain at least one entry">]>;
   readonly requestId: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
@@ -83,7 +83,7 @@ type GridRequest = v.InferOutput<typeof GridRequestSchema>;
  * }
  * ```
  */
-declare function parseGridRequest(input: unknown): GridRequest;
+export declare function parseGridRequest(input: unknown): GridRequest;
 //#endregion
 //#region source/grid-columns/responses/types.d.ts
 /** Cell values returned for a single row, keyed by `id`. */
@@ -126,7 +126,7 @@ type GridErrorBody = {
  * );
  * ```
  */
-declare function okGridResponse(data: Record<string, GridRow>, defaults?: GridRow): SuccessResponse<GridSuccessBody>;
+export declare function okGridResponse(data: Record<string, GridRow>, defaults?: GridRow): SuccessResponse<GridSuccessBody>;
 /**
  * Builds an error response for a grid column handler with the given HTTP status code.
  *
@@ -140,6 +140,6 @@ declare function okGridResponse(data: Record<string, GridRow>, defaults?: GridRo
  * return errorGridResponse(500, "Could not reach inventory service");
  * ```
  */
-declare function errorGridResponse(statusCode: number, errorMessage: string): ErrorResponse<GridErrorBody>;
+export declare function errorGridResponse(statusCode: number, errorMessage: string): ErrorResponse<GridErrorBody>;
 //#endregion
-export { type AdminUiEntity, type GridErrorBody, type GridRequest, GridRequestSchema, type GridRow, type GridSuccessBody, type GridType, GridTypeSchema, errorGridResponse, getGridColumnAclResourceId, okGridResponse, parseGridRequest };
+export type { AdminUiEntity, GridErrorBody, GridRequest, GridRow, GridSuccessBody, GridType };

package/dist/es/grid-columns/index.mjs

@@ -12,7 +12,7 @@
  * governing permissions and limitations under the License.
  */
 
-import { n as sanitizeSegment, t as getAclResourceId } from "../acl-resource-id-pryVxI_c.mjs";
+import { r as sanitizeSegment, t as getAclResourceId } from "../acl-resource-id-CIxfW36q.mjs";
 import { t as nonEmptyStringValueSchema } from "../schemas-BFT8ys8P.mjs";
 import { t as parseOrThrow } from "../utils-COPGW1HO.mjs";
 import * as v from "valibot";

package/dist/es/mass-actions/index.d.mts

@@ -12,7 +12,7 @@
  * governing permissions and limitations under the License.
  */
 
-import { t as AdminUiEntity } from "../acl-resource-id-DBlYU0DE.mjs";
+import { t as AdminUiEntity } from "../acl-resource-id-B1UPaYNV.mjs";
 import * as v from "valibot";
 import { ErrorResponse, SuccessResponse } from "@adobe/aio-commerce-lib-core/responses";
 //#region source/mass-actions/acl-resource-id.d.ts
@@ -39,14 +39,14 @@ import { ErrorResponse, SuccessResponse } from "@adobe/aio-commerce-lib-core/res
  * @returns The full Commerce ACL resource id for the mass-action leaf node, or an empty string
  *   when `metadataId` is blank.
  */
-declare function getMassActionAclResourceId(metadataId: string, entity: AdminUiEntity, actionId: string): string;
+export declare function getMassActionAclResourceId(metadataId: string, entity: AdminUiEntity, actionId: string): string;
 //#endregion
 //#region source/mass-actions/worker/schema.d.ts
 /**
  * Grid identifier sent by Commerce on the `commerce/backend-ui/2` wire contract
  * for worker mass actions.
  */
-declare const MassActionGridTypeSchema: v.PicklistSchema<["order", "product", "customer"], undefined>;
+export declare const MassActionGridTypeSchema: v.PicklistSchema<["order", "product", "customer"], undefined>;
 /**
  * Schema for the JSON body Commerce POSTs to a worker mass action handler.
  *
@@ -54,7 +54,7 @@ declare const MassActionGridTypeSchema: v.PicklistSchema<["order", "product", "c
  * IDs per request). The upper bound is the Commerce side's contract and is not
  * enforced here.
  */
-declare const MassActionRequestSchema: v.ObjectSchema<{
+export declare const MassActionRequestSchema: v.ObjectSchema<{
   readonly gridType: v.PicklistSchema<["order", "product", "customer"], undefined>;
   readonly requestId: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
   readonly selectedIds: v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>, undefined>, v.MinLengthAction<string[], 1, "The value of \"selectedIds\" must contain at least one entry">]>;
@@ -88,7 +88,7 @@ type MassActionErrorBody = {
  * }
  * ```
  */
-declare function parseMassActionRequest(input: unknown): MassActionRequest;
+export declare function parseMassActionRequest(input: unknown): MassActionRequest;
 /**
  * Builds an HTTP 200 success response for a worker mass action.
  *
@@ -101,7 +101,7 @@ declare function parseMassActionRequest(input: unknown): MassActionRequest;
  * return okMassActionResponse({ exported: selectedIds.length });
  * ```
  */
-declare function okMassActionResponse(body?: MassActionResponseBody): SuccessResponse<MassActionResponseBody>;
+export declare function okMassActionResponse(body?: MassActionResponseBody): SuccessResponse<MassActionResponseBody>;
 /**
  * Builds an error response for a worker mass action with the given HTTP status code.
  *
@@ -113,6 +113,6 @@ declare function okMassActionResponse(body?: MassActionResponseBody): SuccessRes
  * return massActionErrorResponse(422, "Request entity is unprocessable");
  * ```
  */
-declare function massActionErrorResponse(statusCode: number, errorMessage: string): ErrorResponse<MassActionErrorBody>;
+export declare function massActionErrorResponse(statusCode: number, errorMessage: string): ErrorResponse<MassActionErrorBody>;
 //#endregion
-export { type AdminUiEntity, type MassActionErrorBody, type MassActionGridType, MassActionGridTypeSchema, type MassActionRequest, MassActionRequestSchema, type MassActionResponseBody, getMassActionAclResourceId, massActionErrorResponse, okMassActionResponse, parseMassActionRequest };
+export type { AdminUiEntity, MassActionErrorBody, MassActionGridType, MassActionRequest, MassActionResponseBody };

package/dist/es/mass-actions/index.mjs

@@ -12,7 +12,7 @@
  * governing permissions and limitations under the License.
  */
 
-import { n as sanitizeSegment, t as getAclResourceId } from "../acl-resource-id-pryVxI_c.mjs";
+import { r as sanitizeSegment, t as getAclResourceId } from "../acl-resource-id-CIxfW36q.mjs";
 import { t as nonEmptyStringValueSchema } from "../schemas-BFT8ys8P.mjs";
 import { t as parseOrThrow } from "../utils-COPGW1HO.mjs";
 import * as v from "valibot";

package/dist/es/menu/index.d.mts

@@ -34,30 +34,29 @@
  * @returns The full Commerce ACL resource id for the menu leaf node, or an empty string
  *   when `metadataId` is blank.
  */
-declare function getMenuAclResourceId(metadataId: string, menuId: string): string;
+export declare function getMenuAclResourceId(metadataId: string, menuId: string): string;
 //#endregion
 //#region source/menu/paths.d.ts
 /** Menu ID for "Catalog" in the Adobe Commerce admin */
-declare const MENU_CATALOG = "catalog";
+export declare const MENU_CATALOG = "catalog";
 /** Menu ID for "Customers" in the Adobe Commerce admin */
-declare const MENU_CUSTOMERS = "customers";
+export declare const MENU_CUSTOMERS = "customers";
 /** Menu ID for "Marketing" in the Adobe Commerce admin */
-declare const MENU_MARKETING = "marketing";
+export declare const MENU_MARKETING = "marketing";
 /** Menu ID for "Content" in the Adobe Commerce admin */
-declare const MENU_CONTENT = "content";
+export declare const MENU_CONTENT = "content";
 /** Menu ID for "Reports" in the Adobe Commerce admin */
-declare const MENU_REPORTS = "reports";
+export declare const MENU_REPORTS = "reports";
 /** Menu ID for "Sales" in the Adobe Commerce admin */
-declare const MENU_SALES = "sales";
+export declare const MENU_SALES = "sales";
 /** Menu ID for "Stores" in the Adobe Commerce admin */
-declare const MENU_STORES = "stores";
+export declare const MENU_STORES = "stores";
 /** Menu ID for "System" in the Adobe Commerce admin */
-declare const MENU_SYSTEM = "system";
+export declare const MENU_SYSTEM = "system";
 /** All Commerce Admin menus available for app attachment. */
-declare const COMMERCE_MENUS: readonly ["sales", "catalog", "customers", "marketing", "content", "reports", "stores", "system"];
+export declare const COMMERCE_MENUS: readonly ["sales", "catalog", "customers", "marketing", "content", "reports", "stores", "system"];
 /** A union type of all known supported Commerce Admin menu IDs. */
-type CommerceMenu = (typeof COMMERCE_MENUS)[number];
+export type CommerceMenu = (typeof COMMERCE_MENUS)[number];
 /** Returns true if the given string is a known Commerce Admin menu ID. */
-declare function isCommerceMenu(menu: string): menu is CommerceMenu;
-//#endregion
-export { COMMERCE_MENUS, CommerceMenu, MENU_CATALOG, MENU_CONTENT, MENU_CUSTOMERS, MENU_MARKETING, MENU_REPORTS, MENU_SALES, MENU_STORES, MENU_SYSTEM, getMenuAclResourceId, isCommerceMenu };
+export declare function isCommerceMenu(menu: string): menu is CommerceMenu;
+//#endregion

package/dist/es/menu/index.mjs

@@ -12,7 +12,7 @@
  * governing permissions and limitations under the License.
  */
 
-import { n as sanitizeSegment, t as getAclResourceId } from "../acl-resource-id-pryVxI_c.mjs";
+import { r as sanitizeSegment, t as getAclResourceId } from "../acl-resource-id-CIxfW36q.mjs";
 
 //#region source/menu/acl-resource-id.ts
 /**

package/dist/es/order-view-buttons/index.d.mts

@@ -37,7 +37,7 @@ import { ErrorResponse, SuccessResponse } from "@adobe/aio-commerce-lib-core/res
  * @returns The full Commerce ACL resource id for the view-button leaf node, or an empty string
  *   when `metadataId` is blank.
  */
-declare function getOrderViewButtonAclResourceId(metadataId: string, buttonId: string): string;
+export declare function getOrderViewButtonAclResourceId(metadataId: string, buttonId: string): string;
 //#endregion
 //#region source/order-view-buttons/schema.d.ts
 /**
@@ -47,7 +47,7 @@ declare function getOrderViewButtonAclResourceId(metadataId: string, buttonId: s
  * handler serve multiple buttons by branching on it. `orderId` is the
  * single order currently being viewed.
  */
-declare const OrderViewButtonRequestSchema: v.ObjectSchema<{
+export declare const OrderViewButtonRequestSchema: v.ObjectSchema<{
   readonly id: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
   readonly orderId: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
   readonly requestId: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
@@ -81,7 +81,7 @@ type OrderViewButtonErrorBody = {
  * }
  * ```
  */
-declare function parseOrderViewButtonRequest(input: unknown): OrderViewButtonRequest;
+export declare function parseOrderViewButtonRequest(input: unknown): OrderViewButtonRequest;
 /**
  * Builds an HTTP 200 success response for an order view button handler.
  *
@@ -93,7 +93,7 @@ declare function parseOrderViewButtonRequest(input: unknown): OrderViewButtonReq
  * return okOrderViewButtonResponse();
  * ```
  */
-declare function okOrderViewButtonResponse(): SuccessResponse<OrderViewButtonSuccessBody>;
+export declare function okOrderViewButtonResponse(): SuccessResponse<OrderViewButtonSuccessBody>;
 /**
  * Builds an error response for a worker order view button handler with the given HTTP status code.
  *
@@ -107,6 +107,6 @@ declare function okOrderViewButtonResponse(): SuccessResponse<OrderViewButtonSuc
  * return orderViewButtonErrorResponse(500, "Could not reach inventory service");
  * ```
  */
-declare function orderViewButtonErrorResponse(statusCode: number, errorMessage: string): ErrorResponse<OrderViewButtonErrorBody>;
+export declare function orderViewButtonErrorResponse(statusCode: number, errorMessage: string): ErrorResponse<OrderViewButtonErrorBody>;
 //#endregion
-export { type OrderViewButtonErrorBody, type OrderViewButtonRequest, OrderViewButtonRequestSchema, type OrderViewButtonSuccessBody, getOrderViewButtonAclResourceId, okOrderViewButtonResponse, orderViewButtonErrorResponse, parseOrderViewButtonRequest };
+export type { OrderViewButtonErrorBody, OrderViewButtonRequest, OrderViewButtonSuccessBody };

package/dist/es/order-view-buttons/index.mjs

@@ -12,7 +12,7 @@
  * governing permissions and limitations under the License.
  */
 
-import { n as sanitizeSegment, t as getAclResourceId } from "../acl-resource-id-pryVxI_c.mjs";
+import { r as sanitizeSegment, t as getAclResourceId } from "../acl-resource-id-CIxfW36q.mjs";
 import { t as nonEmptyStringValueSchema } from "../schemas-BFT8ys8P.mjs";
 import { t as parseOrThrow } from "../utils-COPGW1HO.mjs";
 import * as v from "valibot";

package/dist/es/web/index.d.mts

@@ -50,7 +50,7 @@ type ActionsResult<T extends ActionMap, E = Error> = {
  *
  * Returns an error when no host provides credentials.
  */
-declare function useIms(): Result<ImsContext>;
+export declare function useIms(): Result<ImsContext>;
 //#endregion
 //#region source/web/react/commerce/types.d.ts
 /** The guest connection that shares the context between the extension and the Admin UI host. */
@@ -106,7 +106,7 @@ type OrderViewButtonContext = {
  * }
  * ```
  */
-declare function useSharedContext(): Result<SharedContext>;
+export declare function useSharedContext(): Result<SharedContext>;
 //#endregion
 //#region source/web/react/commerce/hooks/use-commerce.d.ts
 type CommerceData = {
@@ -119,7 +119,7 @@ type CommerceData = {
  * Returns an error when used outside a Commerce Admin UI frame, when the host does not expose the
  * Commerce integration API, or when resolving the host fails.
  */
-declare function useCommerce(): Result<CommerceData>;
+export declare function useCommerce(): Result<CommerceData>;
 //#endregion
 //#region source/web/react/commerce/hooks/use-extension-context.d.ts
 /**
@@ -129,14 +129,14 @@ declare function useCommerce(): Result<CommerceData>;
  * Returns an error outside the Commerce shared context, or when the mass-action selection is
  * missing, empty, or contains a non-string row ID.
  */
-declare function useMassActionContext(): Result<MassActionContext>;
+export declare function useMassActionContext(): Result<MassActionContext>;
 /**
  * Returns the context for an order view-button extension point: the order ID the button was
  * triggered from.
  *
  * Returns an error when no order ID is present in the page URL.
  */
-declare function useOrderViewButtonContext(): Result<OrderViewButtonContext>;
+export declare function useOrderViewButtonContext(): Result<OrderViewButtonContext>;
 //#endregion
 //#region source/web/react/commerce/hooks/use-host-connection.d.ts
 /**
@@ -153,7 +153,7 @@ declare function useOrderViewButtonContext(): Result<OrderViewButtonContext>;
  * }
  * ```
  */
-declare function useHostConnection(): ActionsResult<HostConnection>;
+export declare function useHostConnection(): ActionsResult<HostConnection>;
 //#endregion
 //#region source/web/react/routing/types.d.ts
 declare module "@react-spectrum/s2/Provider" {
@@ -208,6 +208,6 @@ type CreateExtensionAppOptions = {
  * });
  * ```
  */
-declare function createExtensionApp({ menu, metadata, routes, root: customRoot }: CreateExtensionAppOptions): void;
+export declare function createExtensionApp({ menu, metadata, routes, root: customRoot }: CreateExtensionAppOptions): void;
 //#endregion
-export { type CreateExtensionAppOptions, type ExtensionRoute, type HostConnection, type ImsContext, type MassActionContext, type OrderViewButtonContext, type SharedContext, createExtensionApp, useCommerce, useHostConnection, useIms, useMassActionContext, useOrderViewButtonContext, useSharedContext };
+export type { CreateExtensionAppOptions, ExtensionRoute, HostConnection, ImsContext, MassActionContext, OrderViewButtonContext, SharedContext };

package/dist/es/web/index.mjs

@@ -15,7 +15,7 @@
 import { StrictMode, Suspense, createContext, use, useCallback, useEffect, useMemo, useState, useSyncExternalStore } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 import Runtime, { init } from "@adobe/exc-app";
-import page from "@adobe/exc-app/page.js";
+import page from "@adobe/exc-app/page";
 import { Outlet, RouterProvider, createHashHistory, createRootRoute, createRoute, createRouter, useCanGoBack, useRouter, useRouterState } from "@tanstack/react-router";
 import { createRoot } from "react-dom/client";
 import { attach, register } from "@adobe/uix-guest";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/aio-commerce-lib-admin-ui",
-  "version": "1.1.0-beta-20260820174436",
+  "version": "1.1.0",
   "private": false,
   "description": "A library to interact with the Adobe Commerce Admin UI SDK API",
   "keywords": [
@@ -101,29 +101,29 @@
     "README.md"
   ],
   "dependencies": {
+    "@adobe/aio-commerce-lib-api": "1.4.0",
+    "@adobe/aio-commerce-lib-core": "1.2.0",
     "@adobe/exc-app": "^1.4.20",
     "@adobe/uix-guest": "^1.0.3",
     "@tanstack/react-router": "^1.170.15",
     "ky": "^1.9.0",
     "react-error-boundary": "^6.1.2",
-    "valibot": "^1.1.0",
-    "@adobe/aio-commerce-lib-api": "1.3.1",
-    "@adobe/aio-commerce-lib-core": "1.2.0"
+    "valibot": "^1.1.0"
   },
   "devDependencies": {
-    "@react-spectrum/s2": "^1.5.1",
-    "@types/react": "^19.2.17",
-    "@types/react-dom": "^19.2.3",
-    "react": "^19.2.7",
-    "react-dom": "^19.2.7",
-    "typescript": "^6.0.0",
+    "@aio-commerce-sdk/common-utils": "0.2.6",
     "@aio-commerce-sdk/config-tsdown": "1.0.1",
     "@aio-commerce-sdk/config-typedoc": "1.0.0",
-    "@aio-commerce-sdk/common-utils": "0.2.6",
     "@aio-commerce-sdk/config-typescript": "1.0.0",
     "@aio-commerce-sdk/config-vitest": "1.0.0",
     "@aio-commerce-sdk/scripting-utils": "0.3.5",
-    "@aio-commerce-sdk/scripts": "0.1.1"
+    "@aio-commerce-sdk/scripts": "0.1.1",
+    "@react-spectrum/s2": "^1.5.1",
+    "@types/react": "^19.2.17",
+    "@types/react-dom": "^19.2.3",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
+    "typescript": "^6.0.0"
   },
   "peerDependencies": {
     "@react-spectrum/s2": "^1.5.1",