@adobe/aio-commerce-lib-admin-ui 0.2.0 → 1.0.1-alpha-20260819113253

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @adobe/aio-commerce-lib-admin-ui
 
+## 1.0.1-alpha-20260819113253
+### Patch Changes
+
+
+
+- [#635](https://github.com/adobe/aio-commerce-sdk/pull/635) [`8a51d9b`](https://github.com/adobe/aio-commerce-sdk/commit/8a51d9b9269c4af5e8ebb400ff975b86ec1b75f2) Thanks [@iivvaannxx](https://github.com/iivvaannxx)! - StrictMode is now applied only in development builds.
+
+- Updated dependencies []:
+  - @adobe/aio-commerce-lib-api@1.3.1-alpha-20260819113253
+
+## 1.0.0
+
+### Major Changes
+
+- [#599](https://github.com/adobe/aio-commerce-sdk/pull/599) [`ac6c13b`](https://github.com/adobe/aio-commerce-sdk/commit/ac6c13b4124677820f8946c92e4cd63ab228eeae) Thanks [@obarcelonap](https://github.com/obarcelonap)! - Release the first stable version.
+
 ## 0.2.0
 
 ### Minor Changes

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

@@ -12,7 +12,6 @@
  * governing permissions and limitations under the License.
  */
 
-
 //#region source/api/lib/acl-resource-id.ts
 /**
 * Fixed, constant prefix that every Admin UI SDK ACL resource id starts with.

package/dist/cjs/api/index.cjs

@@ -13,9 +13,9 @@
  */
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_rolldown_runtime = require('../rolldown-runtime-Cx6hovH8.cjs');
-const require_acl_resource_id = require('../acl-resource-id-D_hCU1Qg.cjs');
-const require_utils = require('../utils-B59fjd_w.cjs');
+const require_rolldown_runtime = require('../rolldown-runtime-Bf2WWRga.cjs');
+const require_acl_resource_id = require('../acl-resource-id-R52pR3gG.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");
 let valibot = require("valibot");
@@ -139,7 +139,8 @@ const permissionCheckResponseSchema = valibot.object({ allowed: valibot.boolean(
 * @throws {@link HTTPError} if the response status is not in the 2xx range.
 */
 async function checkPermission(httpClient, params) {
-	return require_utils.parseOrThrow(permissionCheckResponseSchema, await httpClient.post("adminuisdk/permission/check", { json: { resource: params.resource } }).json());
+	const raw = await httpClient.post("adminuisdk/permission/check", { json: { resource: params.resource } }).json();
+	return require_utils.parseOrThrow(permissionCheckResponseSchema, raw);
 }
 
 //#endregion

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

@@ -16,7 +16,6 @@ import { n as getAclResourceId, t as AdminUiEntity } from "../acl-resource-id-DB
 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 {}
@@ -48,14 +47,17 @@ type AdminUiApiClient = ReturnType<typeof createAdminUiApiClient>;
 //#region source/api/lib/permission-client.d.ts
 /** Options used to create an Admin UI SDK permission client. */
 type AdminUiPermissionClientOptions = {
-  /** The application's `metadata.id` value. When provided, `check()` and `require()` can be called with no resource argument. */appId?: string;
+  /** The application's `metadata.id` value. When provided, `check()` and `require()` can be called with no resource argument. */
+  appId?: string;
   /**
    * Milliseconds to cache a permission result. Default: 300_000 (5 minutes).
    * Set to 0 to disable result caching. Note: in-flight deduplication of concurrent identical
    * requests is independent of this setting and remains active even when caching is disabled.
    */
-  cacheTtlMs?: number; /** Return false instead of throwing when a network or parse error occurs. Default: true. */
-  denyOnError?: boolean; /** Commerce HTTP client used to call the Admin UI SDK permission endpoint. */
+  cacheTtlMs?: number;
+  /** Return false instead of throwing when a network or parse error occurs. Default: true. */
+  denyOnError?: boolean;
+  /** Commerce HTTP client used to call the Admin UI SDK permission endpoint. */
   httpClient: AdobeCommerceHttpClient;
 };
 /** Client for checking the current user's Admin UI SDK resource permissions. */

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

@@ -13,10 +13,10 @@
  */
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_rolldown_runtime = require('../rolldown-runtime-Cx6hovH8.cjs');
-const require_acl_resource_id = require('../acl-resource-id-D_hCU1Qg.cjs');
-const require_schemas = require('../schemas-Ce10uBzN.cjs');
-const require_utils = require('../utils-B59fjd_w.cjs');
+const require_rolldown_runtime = require('../rolldown-runtime-Bf2WWRga.cjs');
+const require_acl_resource_id = require('../acl-resource-id-R52pR3gG.cjs');
+const require_schemas = require('../schemas-DRhCF0TF.cjs');
+const require_utils = require('../utils-CiBhSMw4.cjs');
 let valibot = require("valibot");
 valibot = require_rolldown_runtime.__toESM(valibot, 1);
 let _adobe_aio_commerce_lib_core_responses = require("@adobe/aio-commerce-lib-core/responses");

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

@@ -15,7 +15,6 @@
 import { t as AdminUiEntity } from "../acl-resource-id-DBlYU0DE.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
 /**
  * Derives the deterministic Commerce ACL resource id for a grid column.

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

@@ -13,10 +13,10 @@
  */
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_rolldown_runtime = require('../rolldown-runtime-Cx6hovH8.cjs');
-const require_acl_resource_id = require('../acl-resource-id-D_hCU1Qg.cjs');
-const require_schemas = require('../schemas-Ce10uBzN.cjs');
-const require_utils = require('../utils-B59fjd_w.cjs');
+const require_rolldown_runtime = require('../rolldown-runtime-Bf2WWRga.cjs');
+const require_acl_resource_id = require('../acl-resource-id-R52pR3gG.cjs');
+const require_schemas = require('../schemas-DRhCF0TF.cjs');
+const require_utils = require('../utils-CiBhSMw4.cjs');
 let valibot = require("valibot");
 valibot = require_rolldown_runtime.__toESM(valibot, 1);
 let _adobe_aio_commerce_lib_core_responses = require("@adobe/aio-commerce-lib-core/responses");

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

@@ -15,7 +15,6 @@
 import { t as AdminUiEntity } from "../acl-resource-id-DBlYU0DE.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
 /**
  * Derives the deterministic Commerce ACL resource id for a mass action.

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-D_hCU1Qg.cjs');
+const require_acl_resource_id = require('../acl-resource-id-R52pR3gG.cjs');
 
 //#region source/menu/acl-resource-id.ts
 /**

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

@@ -13,10 +13,10 @@
  */
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_rolldown_runtime = require('../rolldown-runtime-Cx6hovH8.cjs');
-const require_acl_resource_id = require('../acl-resource-id-D_hCU1Qg.cjs');
-const require_schemas = require('../schemas-Ce10uBzN.cjs');
-const require_utils = require('../utils-B59fjd_w.cjs');
+const require_rolldown_runtime = require('../rolldown-runtime-Bf2WWRga.cjs');
+const require_acl_resource_id = require('../acl-resource-id-R52pR3gG.cjs');
+const require_schemas = require('../schemas-DRhCF0TF.cjs');
+const require_utils = require('../utils-CiBhSMw4.cjs');
 let valibot = require("valibot");
 valibot = require_rolldown_runtime.__toESM(valibot, 1);
 let _adobe_aio_commerce_lib_core_responses = require("@adobe/aio-commerce-lib-core/responses");

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

@@ -14,7 +14,6 @@
 
 import * as v from "valibot";
 import { ErrorResponse, SuccessResponse } from "@adobe/aio-commerce-lib-core/responses";
-
 //#region source/order-view-buttons/acl-resource-id.d.ts
 /**
  * Derives the deterministic Commerce ACL resource id for an order view button.

package/dist/cjs/{rolldown-runtime-Cx6hovH8.cjs → rolldown-runtime-Bf2WWRga.cjs}

@@ -46,13 +46,12 @@ var __copyProps = (to, from, except, desc) => {
 	}
 	return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
 	value: mod,
 	enumerable: true
 }) : target, mod));
 
 //#endregion
-
 Object.defineProperty(exports, '__exportAll', {
   enumerable: true,
   get: function () {

package/dist/cjs/{schemas-Ce10uBzN.cjs → schemas-DRhCF0TF.cjs}

@@ -12,7 +12,7 @@
  * governing permissions and limitations under the License.
  */
 
-const require_rolldown_runtime = require('./rolldown-runtime-Cx6hovH8.cjs');
+const require_rolldown_runtime = require('./rolldown-runtime-Bf2WWRga.cjs');
 let valibot = require("valibot");
 valibot = require_rolldown_runtime.__toESM(valibot, 1);
 

package/dist/cjs/{utils-B59fjd_w.cjs → utils-CiBhSMw4.cjs}

@@ -12,7 +12,7 @@
  * governing permissions and limitations under the License.
  */
 
-const require_rolldown_runtime = require('./rolldown-runtime-Cx6hovH8.cjs');
+const require_rolldown_runtime = require('./rolldown-runtime-Bf2WWRga.cjs');
 let _adobe_aio_commerce_lib_core_error = require("@adobe/aio-commerce-lib-core/error");
 let valibot = require("valibot");
 valibot = require_rolldown_runtime.__toESM(valibot, 1);

package/dist/cjs/web/index.cjs

@@ -13,7 +13,7 @@
  */
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_rolldown_runtime = require('../rolldown-runtime-Cx6hovH8.cjs');
+const require_rolldown_runtime = require('../rolldown-runtime-Bf2WWRga.cjs');
 let react = require("react");
 let react_jsx_runtime = require("react/jsx-runtime");
 let _adobe_exc_app = require("@adobe/exc-app");
@@ -163,10 +163,11 @@ function useSharedContext() {
 * @param guestConnection - The established guest connection.
 */
 function useLiveSharedContext(guestConnection) {
-	return (0, react.useSyncExternalStore)((0, react.useCallback)((onContextChange) => {
+	const subscribe = (0, react.useCallback)((onContextChange) => {
 		if (!guestConnection) return () => void 0;
 		return guestConnection.addEventListener("contextchange", onContextChange);
-	}, [guestConnection]), () => guestConnection?.sharedContext ?? null);
+	}, [guestConnection]);
+	return (0, react.useSyncExternalStore)(subscribe, () => guestConnection?.sharedContext ?? null);
 }
 /**
 * Provides the Commerce shared context for a mounted Admin UI iframe app.
@@ -237,7 +238,8 @@ function getCommerceHostPromise(extensionId, connection) {
 		const { integration } = connection.host;
 		if (!integration) return error("The host does not provide the integration API needed to resolve the Commerce host.");
 		try {
-			return ok({ commerceHost: await integration.getCommerceHost() });
+			const commerceHost = await integration.getCommerceHost();
+			return ok({ commerceHost });
 		} catch (cause) {
 			return error("Failed to resolve the Commerce host.", { cause });
 		}
@@ -656,9 +658,10 @@ function ControlFrameRegistration(props) {
 */
 function CommerceGuestConnection(props) {
 	const { extensionId } = props;
+	const guestConnection = useGuestConnection(extensionId);
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SharedContextProvider, {
 		extensionId,
-		guestConnection: useGuestConnection(extensionId),
+		guestConnection,
 		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CommerceExtensionContent, {})
 	});
 }
@@ -666,8 +669,9 @@ function CommerceGuestConnection(props) {
 function CommerceExtensionContent() {
 	const { data, error } = useSharedContext();
 	if (error) throw error;
+	const credentials = resolveCommerceImsCredentials(data.sharedContext);
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ImsContextProvider, {
-		credentials: resolveCommerceImsCredentials(data.sharedContext),
+		credentials,
 		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_tanstack_react_router.Outlet, {})
 	});
 }
@@ -756,13 +760,16 @@ function ExperienceShellExtensionApp(props) {
 */
 function ShellExtensionContent(props) {
 	const { initialConfigurationPromise, runtime } = props;
-	const shellConfiguration = useShellConfiguration(runtime, (0, react.use)(initialConfigurationPromise));
+	const initialConfiguration = (0, react.use)(initialConfigurationPromise);
+	const shellConfiguration = useShellConfiguration(runtime, initialConfiguration);
 	const spectrumRouter = useSpectrumRouter();
+	const colorScheme = useExtensionColorScheme(shellConfiguration);
+	const credentials = resolveShellImsCredentials(shellConfiguration);
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_react_spectrum_s2_Provider.Provider, {
-		colorScheme: useExtensionColorScheme(shellConfiguration),
+		colorScheme,
 		router: spectrumRouter,
 		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ExtensionErrorBoundary, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ImsContextProvider, {
-			credentials: resolveShellImsCredentials(shellConfiguration),
+			credentials,
 			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_tanstack_react_router.Outlet, {})
 		}) })
 	});
@@ -810,9 +817,11 @@ function Entrypoint(props) {
 * Mounts a Commerce Admin UI iframe app and handles Experience Cloud Shell, UIX
 * registration, shared-context attachment, routing, and Spectrum setup.
 *
-* The app is wrapped in React's `<StrictMode>`, so in development builds (e.g. when
-* served via `aio app dev` or `aio app run`) components render twice and effects run
-* an extra setup + cleanup cycle on mount. Production builds are unaffected.
+* The app is wrapped in React's `<StrictMode>` only in development builds
+* (`process.env.NODE_ENV !== "production"`), so components render twice and effects
+* run an extra setup + cleanup cycle on mount. Production builds
+* (`process.env.NODE_ENV === "production"`) render without `<StrictMode>`, so it is
+* stripped from the production bundle.
 *
 * @param options - App bootstrap options.
 *
@@ -833,15 +842,18 @@ function createExtensionApp({ menu, metadata, routes = [], root: customRoot }) {
 	if (!rootElement) throw new Error("Could not find an element with id \"root\".");
 	const root = (0, react_dom_client.createRoot)(rootElement);
 	const render = (runtime, initialConfigurationPromise) => {
-		const router = createExtensionRouter(/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Entrypoint, {
+		const entrypointProps = {
 			extensionId: metadata.extensionId,
 			initialConfigurationPromise,
 			runtime
-		}), menu === void 0 ? routes : [{
+		};
+		const entrypoint = /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Entrypoint, { ...entrypointProps });
+		const router = createExtensionRouter(entrypoint, menu === void 0 ? routes : [{
 			element: menu,
 			path: "/"
 		}, ...routes]);
-		root.render(/* @__PURE__ */ (0, react_jsx_runtime.jsx)(react.StrictMode, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_tanstack_react_router.RouterProvider, { router }) }));
+		const tree = /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_tanstack_react_router.RouterProvider, { router });
+		root.render(process.env.NODE_ENV === "production" ? tree : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react.StrictMode, { children: tree }));
 	};
 	try {
 		loadExperienceCloudRuntime();

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

@@ -15,7 +15,6 @@
 import { ReactNode } from "react";
 import { attach } from "@adobe/uix-guest";
 import { NavigateOptions, ToOptions } from "@tanstack/react-router";
-
 //#region source/web/react/auth/types.d.ts
 /** The IMS credentials provided by the host (Commerce Admin or Experience Cloud shell). */
 type ImsContext = {
@@ -64,13 +63,18 @@ type GuestConnection = Awaited<ReturnType<typeof attach>>;
  * which are also available in the Experience Cloud shell.
  */
 type SharedContext = {
-  /** The extension ID of the app. */extensionId: string; /** The live `sharedContext` object provided by the host. */
-  sharedContext: NonNullable<GuestConnection["sharedContext"]>; /** The host proxy, used by `useHostConnection` to invoke host-frame actions (close/onError). */
+  /** The extension ID of the app. */
+  extensionId: string;
+  /** The live `sharedContext` object provided by the host. */
+  sharedContext: NonNullable<GuestConnection["sharedContext"]>;
+  /** The host proxy, used by `useHostConnection` to invoke host-frame actions (close/onError). */
   host: NonNullable<GuestConnection["host"]>;
 };
 /** Actions for closing the extension iframe and returning control to the Commerce Admin. */
 type HostConnection = {
-  /** Closes the iframe and navigates back to the originating grid or order. */close: () => Promise<void>; /** Closes the iframe and navigates back, flagging the originating page that an error occurred. */
+  /** Closes the iframe and navigates back to the originating grid or order. */
+  close: () => Promise<void>;
+  /** Closes the iframe and navigates back, flagging the originating page that an error occurred. */
   closeWithError: () => Promise<void>;
 };
 /** The context shared with mass-action extension points. */
@@ -108,7 +112,6 @@ declare function useSharedContext(): Result<SharedContext>;
 type CommerceData = {
   commerceHost: string;
 };
-/** Drops a failed Commerce host resolution for `extensionId`, so a later render retries it. */
 /**
  * Returns the host (domain) of the Commerce Admin the extension is embedded in, resolving it over
  * the guest connection.
@@ -161,27 +164,36 @@ declare module "@react-spectrum/s2/Provider" {
 }
 /** Defines a route that exists at a given path. */
 type ExtensionRoute = {
-  /** The path for the route. */path: string; /** The React element to render for the route. */
+  /** The path for the route. */
+  path: string;
+  /** The React element to render for the route. */
   element: ReactNode;
 };
 //#endregion
 //#region source/web/react/extension/create-app.d.ts
 /** Configuration options when instantiating an extension app. */
 type CreateExtensionAppOptions = {
-  /** General metadata about the extension app. */metadata: {
-    /** The unique identifier for the extension app. */extensionId: string;
-  }; /** The optional app page opened from the Commerce Admin menu and by default in Experience Cloud Shell. */
-  menu?: ReactNode; /** Optional root element where the app will be mounted. */
-  root?: HTMLElement; /** Additional path-based routes for the extension app. */
+  /** General metadata about the extension app. */
+  metadata: {
+    /** The unique identifier for the extension app. */
+    extensionId: string;
+  };
+  /** The optional app page opened from the Commerce Admin menu and by default in Experience Cloud Shell. */
+  menu?: ReactNode;
+  /** Optional root element where the app will be mounted. */
+  root?: HTMLElement;
+  /** Additional path-based routes for the extension app. */
   routes?: ExtensionRoute[];
 };
 /**
  * Mounts a Commerce Admin UI iframe app and handles Experience Cloud Shell, UIX
  * registration, shared-context attachment, routing, and Spectrum setup.
  *
- * The app is wrapped in React's `<StrictMode>`, so in development builds (e.g. when
- * served via `aio app dev` or `aio app run`) components render twice and effects run
- * an extra setup + cleanup cycle on mount. Production builds are unaffected.
+ * The app is wrapped in React's `<StrictMode>` only in development builds
+ * (`process.env.NODE_ENV !== "production"`), so components render twice and effects
+ * run an extra setup + cleanup cycle on mount. Production builds
+ * (`process.env.NODE_ENV === "production"`) render without `<StrictMode>`, so it is
+ * stripped from the production bundle.
  *
  * @param options - App bootstrap options.
  *
@@ -196,11 +208,6 @@ type CreateExtensionAppOptions = {
  * });
  * ```
  */
-declare function createExtensionApp({
-  menu,
-  metadata,
-  routes,
-  root: customRoot
-}: CreateExtensionAppOptions): void;
+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 };

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

@@ -16,7 +16,6 @@ import { n as getAclResourceId, t as AdminUiEntity } from "../acl-resource-id-DB
 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 {}
@@ -48,14 +47,17 @@ type AdminUiApiClient = ReturnType<typeof createAdminUiApiClient>;
 //#region source/api/lib/permission-client.d.ts
 /** Options used to create an Admin UI SDK permission client. */
 type AdminUiPermissionClientOptions = {
-  /** The application's `metadata.id` value. When provided, `check()` and `require()` can be called with no resource argument. */appId?: string;
+  /** The application's `metadata.id` value. When provided, `check()` and `require()` can be called with no resource argument. */
+  appId?: string;
   /**
    * Milliseconds to cache a permission result. Default: 300_000 (5 minutes).
    * Set to 0 to disable result caching. Note: in-flight deduplication of concurrent identical
    * requests is independent of this setting and remains active even when caching is disabled.
    */
-  cacheTtlMs?: number; /** Return false instead of throwing when a network or parse error occurs. Default: true. */
-  denyOnError?: boolean; /** Commerce HTTP client used to call the Admin UI SDK permission endpoint. */
+  cacheTtlMs?: number;
+  /** Return false instead of throwing when a network or parse error occurs. Default: true. */
+  denyOnError?: boolean;
+  /** Commerce HTTP client used to call the Admin UI SDK permission endpoint. */
   httpClient: AdobeCommerceHttpClient;
 };
 /** Client for checking the current user's Admin UI SDK resource permissions. */

package/dist/es/api/index.mjs

@@ -153,7 +153,8 @@ const permissionCheckResponseSchema = v.object({ allowed: v.boolean() });
 * @throws {@link HTTPError} if the response status is not in the 2xx range.
 */
 async function checkPermission(httpClient, params) {
-	return parseOrThrow(permissionCheckResponseSchema, await httpClient.post("adminuisdk/permission/check", { json: { resource: params.resource } }).json());
+	const raw = await httpClient.post("adminuisdk/permission/check", { json: { resource: params.resource } }).json();
+	return parseOrThrow(permissionCheckResponseSchema, raw);
 }
 
 //#endregion

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

@@ -15,7 +15,6 @@
 import { t as AdminUiEntity } from "../acl-resource-id-DBlYU0DE.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
 /**
  * Derives the deterministic Commerce ACL resource id for a grid column.

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

@@ -15,7 +15,6 @@
 import { t as AdminUiEntity } from "../acl-resource-id-DBlYU0DE.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
 /**
  * Derives the deterministic Commerce ACL resource id for a mass action.

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

@@ -14,7 +14,6 @@
 
 import * as v from "valibot";
 import { ErrorResponse, SuccessResponse } from "@adobe/aio-commerce-lib-core/responses";
-
 //#region source/order-view-buttons/acl-resource-id.d.ts
 /**
  * Derives the deterministic Commerce ACL resource id for an order view button.

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

@@ -15,7 +15,6 @@
 import { ReactNode } from "react";
 import { NavigateOptions, ToOptions } from "@tanstack/react-router";
 import { attach } from "@adobe/uix-guest";
-
 //#region source/web/react/auth/types.d.ts
 /** The IMS credentials provided by the host (Commerce Admin or Experience Cloud shell). */
 type ImsContext = {
@@ -64,13 +63,18 @@ type GuestConnection = Awaited<ReturnType<typeof attach>>;
  * which are also available in the Experience Cloud shell.
  */
 type SharedContext = {
-  /** The extension ID of the app. */extensionId: string; /** The live `sharedContext` object provided by the host. */
-  sharedContext: NonNullable<GuestConnection["sharedContext"]>; /** The host proxy, used by `useHostConnection` to invoke host-frame actions (close/onError). */
+  /** The extension ID of the app. */
+  extensionId: string;
+  /** The live `sharedContext` object provided by the host. */
+  sharedContext: NonNullable<GuestConnection["sharedContext"]>;
+  /** The host proxy, used by `useHostConnection` to invoke host-frame actions (close/onError). */
   host: NonNullable<GuestConnection["host"]>;
 };
 /** Actions for closing the extension iframe and returning control to the Commerce Admin. */
 type HostConnection = {
-  /** Closes the iframe and navigates back to the originating grid or order. */close: () => Promise<void>; /** Closes the iframe and navigates back, flagging the originating page that an error occurred. */
+  /** Closes the iframe and navigates back to the originating grid or order. */
+  close: () => Promise<void>;
+  /** Closes the iframe and navigates back, flagging the originating page that an error occurred. */
   closeWithError: () => Promise<void>;
 };
 /** The context shared with mass-action extension points. */
@@ -108,7 +112,6 @@ declare function useSharedContext(): Result<SharedContext>;
 type CommerceData = {
   commerceHost: string;
 };
-/** Drops a failed Commerce host resolution for `extensionId`, so a later render retries it. */
 /**
  * Returns the host (domain) of the Commerce Admin the extension is embedded in, resolving it over
  * the guest connection.
@@ -161,27 +164,36 @@ declare module "@react-spectrum/s2/Provider" {
 }
 /** Defines a route that exists at a given path. */
 type ExtensionRoute = {
-  /** The path for the route. */path: string; /** The React element to render for the route. */
+  /** The path for the route. */
+  path: string;
+  /** The React element to render for the route. */
   element: ReactNode;
 };
 //#endregion
 //#region source/web/react/extension/create-app.d.ts
 /** Configuration options when instantiating an extension app. */
 type CreateExtensionAppOptions = {
-  /** General metadata about the extension app. */metadata: {
-    /** The unique identifier for the extension app. */extensionId: string;
-  }; /** The optional app page opened from the Commerce Admin menu and by default in Experience Cloud Shell. */
-  menu?: ReactNode; /** Optional root element where the app will be mounted. */
-  root?: HTMLElement; /** Additional path-based routes for the extension app. */
+  /** General metadata about the extension app. */
+  metadata: {
+    /** The unique identifier for the extension app. */
+    extensionId: string;
+  };
+  /** The optional app page opened from the Commerce Admin menu and by default in Experience Cloud Shell. */
+  menu?: ReactNode;
+  /** Optional root element where the app will be mounted. */
+  root?: HTMLElement;
+  /** Additional path-based routes for the extension app. */
   routes?: ExtensionRoute[];
 };
 /**
  * Mounts a Commerce Admin UI iframe app and handles Experience Cloud Shell, UIX
  * registration, shared-context attachment, routing, and Spectrum setup.
  *
- * The app is wrapped in React's `<StrictMode>`, so in development builds (e.g. when
- * served via `aio app dev` or `aio app run`) components render twice and effects run
- * an extra setup + cleanup cycle on mount. Production builds are unaffected.
+ * The app is wrapped in React's `<StrictMode>` only in development builds
+ * (`process.env.NODE_ENV !== "production"`), so components render twice and effects
+ * run an extra setup + cleanup cycle on mount. Production builds
+ * (`process.env.NODE_ENV === "production"`) render without `<StrictMode>`, so it is
+ * stripped from the production bundle.
  *
  * @param options - App bootstrap options.
  *
@@ -196,11 +208,6 @@ type CreateExtensionAppOptions = {
  * });
  * ```
  */
-declare function createExtensionApp({
-  menu,
-  metadata,
-  routes,
-  root: customRoot
-}: CreateExtensionAppOptions): void;
+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 };

package/dist/es/web/index.mjs

@@ -158,10 +158,11 @@ function useSharedContext() {
 * @param guestConnection - The established guest connection.
 */
 function useLiveSharedContext(guestConnection) {
-	return useSyncExternalStore(useCallback((onContextChange) => {
+	const subscribe = useCallback((onContextChange) => {
 		if (!guestConnection) return () => void 0;
 		return guestConnection.addEventListener("contextchange", onContextChange);
-	}, [guestConnection]), () => guestConnection?.sharedContext ?? null);
+	}, [guestConnection]);
+	return useSyncExternalStore(subscribe, () => guestConnection?.sharedContext ?? null);
 }
 /**
 * Provides the Commerce shared context for a mounted Admin UI iframe app.
@@ -232,7 +233,8 @@ function getCommerceHostPromise(extensionId, connection) {
 		const { integration } = connection.host;
 		if (!integration) return error("The host does not provide the integration API needed to resolve the Commerce host.");
 		try {
-			return ok({ commerceHost: await integration.getCommerceHost() });
+			const commerceHost = await integration.getCommerceHost();
+			return ok({ commerceHost });
 		} catch (cause) {
 			return error("Failed to resolve the Commerce host.", { cause });
 		}
@@ -651,9 +653,10 @@ function ControlFrameRegistration(props) {
 */
 function CommerceGuestConnection(props) {
 	const { extensionId } = props;
+	const guestConnection = useGuestConnection(extensionId);
 	return /* @__PURE__ */ jsx(SharedContextProvider, {
 		extensionId,
-		guestConnection: useGuestConnection(extensionId),
+		guestConnection,
 		children: /* @__PURE__ */ jsx(CommerceExtensionContent, {})
 	});
 }
@@ -661,8 +664,9 @@ function CommerceGuestConnection(props) {
 function CommerceExtensionContent() {
 	const { data, error } = useSharedContext();
 	if (error) throw error;
+	const credentials = resolveCommerceImsCredentials(data.sharedContext);
 	return /* @__PURE__ */ jsx(ImsContextProvider, {
-		credentials: resolveCommerceImsCredentials(data.sharedContext),
+		credentials,
 		children: /* @__PURE__ */ jsx(Outlet, {})
 	});
 }
@@ -751,13 +755,16 @@ function ExperienceShellExtensionApp(props) {
 */
 function ShellExtensionContent(props) {
 	const { initialConfigurationPromise, runtime } = props;
-	const shellConfiguration = useShellConfiguration(runtime, use(initialConfigurationPromise));
+	const initialConfiguration = use(initialConfigurationPromise);
+	const shellConfiguration = useShellConfiguration(runtime, initialConfiguration);
 	const spectrumRouter = useSpectrumRouter();
+	const colorScheme = useExtensionColorScheme(shellConfiguration);
+	const credentials = resolveShellImsCredentials(shellConfiguration);
 	return /* @__PURE__ */ jsx(Provider, {
-		colorScheme: useExtensionColorScheme(shellConfiguration),
+		colorScheme,
 		router: spectrumRouter,
 		children: /* @__PURE__ */ jsx(ExtensionErrorBoundary, { children: /* @__PURE__ */ jsx(ImsContextProvider, {
-			credentials: resolveShellImsCredentials(shellConfiguration),
+			credentials,
 			children: /* @__PURE__ */ jsx(Outlet, {})
 		}) })
 	});
@@ -805,9 +812,11 @@ function Entrypoint(props) {
 * Mounts a Commerce Admin UI iframe app and handles Experience Cloud Shell, UIX
 * registration, shared-context attachment, routing, and Spectrum setup.
 *
-* The app is wrapped in React's `<StrictMode>`, so in development builds (e.g. when
-* served via `aio app dev` or `aio app run`) components render twice and effects run
-* an extra setup + cleanup cycle on mount. Production builds are unaffected.
+* The app is wrapped in React's `<StrictMode>` only in development builds
+* (`process.env.NODE_ENV !== "production"`), so components render twice and effects
+* run an extra setup + cleanup cycle on mount. Production builds
+* (`process.env.NODE_ENV === "production"`) render without `<StrictMode>`, so it is
+* stripped from the production bundle.
 *
 * @param options - App bootstrap options.
 *
@@ -828,15 +837,18 @@ function createExtensionApp({ menu, metadata, routes = [], root: customRoot }) {
 	if (!rootElement) throw new Error("Could not find an element with id \"root\".");
 	const root = createRoot(rootElement);
 	const render = (runtime, initialConfigurationPromise) => {
-		const router = createExtensionRouter(/* @__PURE__ */ jsx(Entrypoint, {
+		const entrypointProps = {
 			extensionId: metadata.extensionId,
 			initialConfigurationPromise,
 			runtime
-		}), menu === void 0 ? routes : [{
+		};
+		const entrypoint = /* @__PURE__ */ jsx(Entrypoint, { ...entrypointProps });
+		const router = createExtensionRouter(entrypoint, menu === void 0 ? routes : [{
 			element: menu,
 			path: "/"
 		}, ...routes]);
-		root.render(/* @__PURE__ */ jsx(StrictMode, { children: /* @__PURE__ */ jsx(RouterProvider, { router }) }));
+		const tree = /* @__PURE__ */ jsx(RouterProvider, { router });
+		root.render(process.env.NODE_ENV === "production" ? tree : /* @__PURE__ */ jsx(StrictMode, { children: tree }));
 	};
 	try {
 		loadExperienceCloudRuntime();

package/package.json

@@ -2,7 +2,7 @@
   "name": "@adobe/aio-commerce-lib-admin-ui",
   "type": "module",
   "author": "Adobe Inc.",
-  "version": "0.2.0",
+  "version": "1.0.1-alpha-20260819113253",
   "private": false,
   "engines": {
     "node": ">=22 <=24"
@@ -113,7 +113,7 @@
     "ky": "^1.9.0",
     "react-error-boundary": "^6.1.2",
     "valibot": "^1.1.0",
-    "@adobe/aio-commerce-lib-api": "1.3.0",
+    "@adobe/aio-commerce-lib-api": "1.3.1-alpha-20260819113253",
     "@adobe/aio-commerce-lib-core": "1.2.0"
   },
   "peerDependencies": {
@@ -144,8 +144,8 @@
     "@aio-commerce-sdk/config-typedoc": "1.0.0",
     "@aio-commerce-sdk/config-typescript": "1.0.0",
     "@aio-commerce-sdk/config-vitest": "1.0.0",
-    "@aio-commerce-sdk/scripting-utils": "0.3.4",
-    "@aio-commerce-sdk/scripts": "0.1.0"
+    "@aio-commerce-sdk/scripting-utils": "0.3.5-alpha-20260819113253",
+    "@aio-commerce-sdk/scripts": "0.1.1"
   },
   "sideEffects": false,
   "scripts": {