@adobe/aio-commerce-lib-app 1.1.0 → 1.2.0

package/dist/cjs/{webhooks-CbZpv9y_.cjs → webhooks-CLtDxwMa.cjs}

@@ -16,6 +16,27 @@ const require_schemas = require('./schemas-nkIxa8sL.cjs');
 let valibot = require("valibot");
 valibot = require_schemas.__toESM(valibot);
 
+//#region source/config/schema/admin-ui-sdk.ts
+/**
+* Schema for the Admin UI SDK registration parameters (for the `adminUiSdk.registration` config section).
+* @see https://developer.adobe.com/commerce/extensibility/admin-ui-sdk/extension-points/ for more details.
+*/
+const AdminUiSdkRegistrationSchema = valibot.object({ menuItems: valibot.array(valibot.object({
+	id: valibot.string(),
+	title: valibot.optional(valibot.string()),
+	parent: valibot.optional(valibot.string()),
+	sortOrder: valibot.optional(valibot.number()),
+	sandbox: valibot.optional(valibot.string()),
+	isSection: valibot.optional(valibot.boolean())
+})) });
+/** Schema for Admin UI SDK configuration. */
+const AdminUiSdkSchema = valibot.object({ registration: AdminUiSdkRegistrationSchema });
+/** Check if config has Admin UI SDK registration configuration. */
+function hasAdminUiSdk(config) {
+	return config.adminUiSdk !== void 0 && config.adminUiSdk.registration !== void 0;
+}
+
+//#endregion
 //#region source/config/schema/eventing.ts
 const MAX_DESCRIPTION_LENGTH$1 = 255;
 const MAX_LABEL_LENGTH = 100;
@@ -291,6 +312,12 @@ function hasWebhooks(config) {
 }
 
 //#endregion
+Object.defineProperty(exports, 'AdminUiSdkSchema', {
+  enumerable: true,
+  get: function () {
+    return AdminUiSdkSchema;
+  }
+});
 Object.defineProperty(exports, 'EventingSchema', {
   enumerable: true,
   get: function () {
@@ -309,6 +336,12 @@ Object.defineProperty(exports, 'WebhooksSchema', {
     return WebhooksSchema;
   }
 });
+Object.defineProperty(exports, 'hasAdminUiSdk', {
+  enumerable: true,
+  get: function () {
+    return hasAdminUiSdk;
+  }
+});
 Object.defineProperty(exports, 'hasCommerceEvents', {
   enumerable: true,
   get: function () {

package/dist/es/actions/app-config.d.mts

@@ -12,8 +12,8 @@
  * governing permissions and limitations under the License.
  */
 
-import { n as CommerceAppConfigOutputModel } from "../app-Ct7Y0NP8.mjs";
-import * as _adobe_aio_commerce_lib_core_responses0 from "@adobe/aio-commerce-lib-core/responses";
+import { n as CommerceAppConfigOutputModel } from "../app-DJr-mN9d.mjs";
+import * as _$_adobe_aio_commerce_lib_core_responses0 from "@adobe/aio-commerce-lib-core/responses";
 import { RuntimeActionParams } from "@adobe/aio-commerce-lib-core/params";
 
 //#region source/actions/app-config.d.ts
@@ -24,6 +24,6 @@ type RuntimeActionFactoryArgs = {
 /** Factory to create the route handler for the `app-config` action. */
 declare const appConfigRuntimeAction: ({
   appConfig
-}: RuntimeActionFactoryArgs) => (params: RuntimeActionParams) => Promise<_adobe_aio_commerce_lib_core_responses0.ActionResponse>;
+}: RuntimeActionFactoryArgs) => (params: RuntimeActionParams) => Promise<_$_adobe_aio_commerce_lib_core_responses0.ActionResponse>;
 //#endregion
 export { appConfigRuntimeAction };

package/dist/es/actions/app-config.mjs

@@ -13,7 +13,7 @@
  */
 
 import { n as logger, t as HttpActionRouter } from "../router-BxaxEEu3.mjs";
-import { t as validateCommerceAppConfig } from "../validate-qRpfubPo.mjs";
+import { t as validateCommerceAppConfig } from "../validate-CqJdGzyZ.mjs";
 import { ok } from "@adobe/aio-commerce-lib-core/responses";
 
 //#region source/actions/app-config.ts

package/dist/es/actions/config.d.mts

@@ -12,7 +12,7 @@
  * governing permissions and limitations under the License.
  */
 
-import * as _adobe_aio_commerce_lib_core_responses0 from "@adobe/aio-commerce-lib-core/responses";
+import * as _$_adobe_aio_commerce_lib_core_responses0 from "@adobe/aio-commerce-lib-core/responses";
 import { BusinessConfigSchema } from "@adobe/aio-commerce-lib-config";
 import { RuntimeActionParams } from "@adobe/aio-commerce-lib-core/params";
 
@@ -24,6 +24,6 @@ type ConfigActionFactoryArgs = {
 /** Factory to create the route handler for the `config` action. */
 declare const configRuntimeAction: ({
   configSchema
-}: ConfigActionFactoryArgs) => (params: RuntimeActionParams) => Promise<_adobe_aio_commerce_lib_core_responses0.ActionResponse>;
+}: ConfigActionFactoryArgs) => (params: RuntimeActionParams) => Promise<_$_adobe_aio_commerce_lib_core_responses0.ActionResponse>;
 //#endregion
 export { configRuntimeAction };

package/dist/es/actions/config.mjs

@@ -13,8 +13,8 @@
  */
 
 import { n as logger, t as HttpActionRouter } from "../router-BxaxEEu3.mjs";
-import { n as validateCommerceAppConfigDomain } from "../validate-qRpfubPo.mjs";
-import { r as nonEmptyStringValueSchema } from "../schemas-BvPxQwgQ.mjs";
+import { n as validateCommerceAppConfigDomain } from "../validate-CqJdGzyZ.mjs";
+import { r as nonEmptyStringValueSchema } from "../schemas-CVXHgUhv.mjs";
 import { ok } from "@adobe/aio-commerce-lib-core/responses";
 import * as v from "valibot";
 import { byScopeId, getConfiguration, initialize, setConfiguration } from "@adobe/aio-commerce-lib-config";

package/dist/es/actions/installation.d.mts

@@ -12,9 +12,9 @@
  * governing permissions and limitations under the License.
  */
 
-import { n as CommerceAppConfigOutputModel } from "../app-Ct7Y0NP8.mjs";
-import { V as InstallationContext } from "../index-D33OCH0D.mjs";
-import * as _adobe_aio_commerce_lib_core_responses0 from "@adobe/aio-commerce-lib-core/responses";
+import { n as CommerceAppConfigOutputModel } from "../app-DJr-mN9d.mjs";
+import { V as InstallationContext } from "../index-BmYXe7kp.mjs";
+import * as _$_adobe_aio_commerce_lib_core_responses0 from "@adobe/aio-commerce-lib-core/responses";
 import { RuntimeActionParams } from "@adobe/aio-commerce-lib-core/params";
 
 //#region source/actions/installation.d.ts
@@ -28,6 +28,6 @@ type RuntimeActionFactoryArgs = {
 declare const installationRuntimeAction: ({
   appConfig,
   customScriptsLoader
-}: RuntimeActionFactoryArgs) => (params: RuntimeActionParams) => Promise<_adobe_aio_commerce_lib_core_responses0.ActionResponse>;
+}: RuntimeActionFactoryArgs) => (params: RuntimeActionParams) => Promise<_$_adobe_aio_commerce_lib_core_responses0.ActionResponse>;
 //#endregion
 export { installationRuntimeAction };

package/dist/es/actions/installation.mjs

@@ -13,8 +13,8 @@
  */
 
 import { n as logger, t as HttpActionRouter } from "../router-BxaxEEu3.mjs";
-import { r as nonEmptyStringValueSchema } from "../schemas-BvPxQwgQ.mjs";
-import { a as isCompletedState, c as isSucceededState, n as runInstallation, o as isFailedState, r as runValidation, s as isInProgressState, t as createInitialInstallationState } from "../management-CIoVWirU.mjs";
+import { r as nonEmptyStringValueSchema } from "../schemas-CVXHgUhv.mjs";
+import { a as isCompletedState, c as isSucceededState, n as runInstallation, o as isFailedState, r as runValidation, s as isInProgressState, t as createInitialInstallationState } from "../management-DSexEPTW.mjs";
 import { accepted, badRequest, conflict, internalServerError, noContent, ok } from "@adobe/aio-commerce-lib-core/responses";
 import * as v from "valibot";
 import { object, string } from "valibot";

package/dist/es/actions/scope-tree.d.mts

@@ -12,11 +12,11 @@
  * governing permissions and limitations under the License.
  */
 
-import * as _adobe_aio_commerce_lib_core_responses0 from "@adobe/aio-commerce-lib-core/responses";
-import * as _adobe_aio_commerce_lib_core_params0 from "@adobe/aio-commerce-lib-core/params";
+import * as _$_adobe_aio_commerce_lib_core_responses0 from "@adobe/aio-commerce-lib-core/responses";
+import * as _$_adobe_aio_commerce_lib_core_params0 from "@adobe/aio-commerce-lib-core/params";
 
 //#region source/actions/scope-tree.d.ts
 /** The handler method for the `scope-tree` action. */
-declare const scopeTreeRuntimeAction: (args: _adobe_aio_commerce_lib_core_params0.RuntimeActionParams) => Promise<_adobe_aio_commerce_lib_core_responses0.ActionResponse>;
+declare const scopeTreeRuntimeAction: (args: _$_adobe_aio_commerce_lib_core_params0.RuntimeActionParams) => Promise<_$_adobe_aio_commerce_lib_core_responses0.ActionResponse>;
 //#endregion
 export { scopeTreeRuntimeAction };

package/dist/es/actions/scope-tree.mjs

@@ -13,7 +13,7 @@
  */
 
 import { n as logger, t as HttpActionRouter } from "../router-BxaxEEu3.mjs";
-import { r as nonEmptyStringValueSchema } from "../schemas-BvPxQwgQ.mjs";
+import { r as nonEmptyStringValueSchema } from "../schemas-CVXHgUhv.mjs";
 import { t as inspect } from "../logging-XIUXDK5T.mjs";
 import { internalServerError, nonAuthoritativeInformation, ok } from "@adobe/aio-commerce-lib-core/responses";
 import * as v from "valibot";

package/dist/es/{app-Ct7Y0NP8.d.mts → app-DJr-mN9d.d.mts}

@@ -18,7 +18,7 @@ import * as v from "valibot";
 /** The schema used to validate the commerce app config file. */
 declare const CommerceAppConfigSchema: v.LooseObjectSchema<{
   readonly metadata: v.ObjectSchema<{
-    readonly id: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.RegexAction<string, `Only alphanumeric characters and hyphens are allowed in string value of "${string}"${string}`>]>;
+    readonly id: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.RegexAction<string, `Only alphanumeric characters and hyphens are allowed in string value of "${string}"${string}`>]>, v.MaxLengthAction<string, 100, "The application id must not be longer than 100 characters">]>;
     readonly displayName: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string for the ${string}`>, v.NonEmptyAction<string, `The ${string} must not be empty`>]>, v.MaxLengthAction<string, 50, "The application display name must not be longer than 50 characters">]>;
     readonly description: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string for the ${string}`>, v.NonEmptyAction<string, `The ${string} must not be empty`>]>, v.MaxLengthAction<string, 255, "The metadata description must not be longer than 255 characters">]>;
     readonly version: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string for the ${string}`>, v.NonEmptyAction<string, `The ${string} must not be empty`>]>, v.RegexAction<string, "The version must follow semantic versioning (semver) format: Major.Minor.Patch (e.g., '1.0.0', '2.3.1')">]>;
@@ -171,6 +171,18 @@ declare const CommerceAppConfigSchema: v.LooseObjectSchema<{
       }, undefined>, "Expected an array of external events">;
     }, undefined>, "Expected an array of external event sources">, undefined>;
   }, undefined>, undefined>;
+  readonly adminUiSdk: v.OptionalSchema<v.ObjectSchema<{
+    readonly registration: v.ObjectSchema<{
+      readonly menuItems: v.ArraySchema<v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly title: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly parent: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly sortOrder: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly sandbox: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly isSection: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+      }, undefined>, undefined>;
+    }, undefined>;
+  }, undefined>, undefined>;
   readonly installation: v.OptionalSchema<v.ObjectSchema<{
     readonly messages: v.OptionalSchema<v.ObjectSchema<{
       readonly preInstallation: v.OptionalSchema<v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>, v.MaxLengthAction<string, 1000, "The preInstallation message must not be longer than 1000 characters">]>, undefined>;

package/dist/es/commands/index.mjs

@@ -13,9 +13,9 @@
  * governing permissions and limitations under the License.
  */
 
-import { c as hasBusinessConfigSchema, i as getConfigDomains, t as validateCommerceAppConfig } from "../validate-qRpfubPo.mjs";
-import { a as hasCustomInstallationSteps } from "../webhooks-NgM6k3_r.mjs";
-import { a as findNearestPackageJson, c as isESM, i as detectPackageManager, l as makeOutputDirFor, n as readCommerceAppConfig, o as getExecCommand, s as getProjectRootDirectory, t as parseCommerceAppConfig, u as readPackageJson } from "../config-BbrkH0Xt.mjs";
+import { a as hasCustomInstallationSteps } from "../webhooks-CYo-pqbR.mjs";
+import { c as hasBusinessConfigSchema, i as getConfigDomains, t as validateCommerceAppConfig } from "../validate-CqJdGzyZ.mjs";
+import { a as findNearestPackageJson, c as isESM, i as detectPackageManager, l as makeOutputDirFor, n as readCommerceAppConfig, o as getExecCommand, s as getProjectRootDirectory, t as parseCommerceAppConfig, u as readPackageJson } from "../config-BohwKkQS.mjs";
 import { t as stringifyError } from "../error-DHlYzkbb.mjs";
 import { t as inspect } from "../logging-XIUXDK5T.mjs";
 import { CommerceSdkValidationError } from "@adobe/aio-commerce-lib-core/error";

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

@@ -12,7 +12,7 @@
  * governing permissions and limitations under the License.
  */
 
-import { n as CommerceAppConfigOutputModel, t as CommerceAppConfig } from "../app-Ct7Y0NP8.mjs";
+import { n as CommerceAppConfigOutputModel, t as CommerceAppConfig } from "../app-DJr-mN9d.mjs";
 import * as v from "valibot";
 import { Get, SetRequiredDeep } from "type-fest";
 
@@ -134,6 +134,18 @@ declare function defineConfig(config: CommerceAppConfig): {
       }[];
     }[] | undefined;
   } | undefined;
+  adminUiSdk?: {
+    registration: {
+      menuItems: {
+        id: string;
+        title?: string | undefined;
+        parent?: string | undefined;
+        sortOrder?: number | undefined;
+        sandbox?: string | undefined;
+        isSection?: boolean | undefined;
+      }[];
+    };
+  } | undefined;
   installation?: {
     messages?: {
       preInstallation?: string | undefined;
@@ -355,6 +367,18 @@ declare function parseCommerceAppConfig(cwd?: string): Promise<{
       }[];
     }[] | undefined;
   } | undefined;
+  adminUiSdk?: {
+    registration: {
+      menuItems: {
+        id: string;
+        title?: string | undefined;
+        parent?: string | undefined;
+        sortOrder?: number | undefined;
+        sandbox?: string | undefined;
+        isSection?: boolean | undefined;
+      }[];
+    };
+  } | undefined;
   installation?: {
     messages?: {
       preInstallation?: string | undefined;
@@ -440,7 +464,7 @@ declare function parseCommerceAppConfig(cwd?: string): Promise<{
 /** The individual validatable domains of the app config. */
 declare const CommerceAppConfigSchemas: {
   readonly metadata: v.ObjectSchema<{
-    readonly id: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.RegexAction<string, `Only alphanumeric characters and hyphens are allowed in string value of "${string}"${string}`>]>;
+    readonly id: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.RegexAction<string, `Only alphanumeric characters and hyphens are allowed in string value of "${string}"${string}`>]>, v.MaxLengthAction<string, 100, "The application id must not be longer than 100 characters">]>;
     readonly displayName: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string for the ${string}`>, v.NonEmptyAction<string, `The ${string} must not be empty`>]>, v.MaxLengthAction<string, 50, "The application display name must not be longer than 50 characters">]>;
     readonly description: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string for the ${string}`>, v.NonEmptyAction<string, `The ${string} must not be empty`>]>, v.MaxLengthAction<string, 255, "The metadata description must not be longer than 255 characters">]>;
     readonly version: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string for the ${string}`>, v.NonEmptyAction<string, `The ${string} must not be empty`>]>, v.RegexAction<string, "The version must follow semantic versioning (semver) format: Major.Minor.Patch (e.g., '1.0.0', '2.3.1')">]>;
@@ -888,6 +912,18 @@ declare const CommerceAppConfigSchemas: {
     readonly name: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>, v.MaxLengthAction<string, 255, "The step name must not be longer than 255 characters">]>;
     readonly description: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>, v.MaxLengthAction<string, 255, "The step description must not be longer than 255 characters">]>;
   }, undefined>, "Expected an array of custom installation steps">;
+  readonly adminUiSdk: v.ObjectSchema<{
+    readonly registration: v.ObjectSchema<{
+      readonly menuItems: v.ArraySchema<v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly title: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly parent: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly sortOrder: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly sandbox: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly isSection: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+      }, undefined>, undefined>;
+    }, undefined>;
+  }, undefined>;
 };
 /** Individual validatable domains of the commerce app config. */
 type CommerceAppConfigDomain = keyof typeof CommerceAppConfigSchemas;
@@ -1169,7 +1205,7 @@ declare function hasCustomInstallationSteps(config: CommerceAppConfigOutputModel
 //#region source/config/schema/metadata.d.ts
 /** The schema for the metadata of the application. */
 declare const MetadataSchema: v.ObjectSchema<{
-  readonly id: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.RegexAction<string, `Only alphanumeric characters and hyphens are allowed in string value of "${string}"${string}`>]>;
+  readonly id: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.RegexAction<string, `Only alphanumeric characters and hyphens are allowed in string value of "${string}"${string}`>]>, v.MaxLengthAction<string, 100, "The application id must not be longer than 100 characters">]>;
   readonly displayName: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string for the ${string}`>, v.NonEmptyAction<string, `The ${string} must not be empty`>]>, v.MaxLengthAction<string, 50, "The application display name must not be longer than 50 characters">]>;
   readonly description: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string for the ${string}`>, v.NonEmptyAction<string, `The ${string} must not be empty`>]>, v.MaxLengthAction<string, 255, "The metadata description must not be longer than 255 characters">]>;
   readonly version: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string for the ${string}`>, v.NonEmptyAction<string, `The ${string} must not be empty`>]>, v.RegexAction<string, "The version must follow semantic versioning (semver) format: Major.Minor.Patch (e.g., '1.0.0', '2.3.1')">]>;

package/dist/es/config/index.mjs

@@ -12,8 +12,8 @@
  * governing permissions and limitations under the License.
  */
 
-import { a as hasConfigDomain, c as hasBusinessConfigSchema, i as getConfigDomains, n as validateCommerceAppConfigDomain, o as hasMetadata, r as CommerceAppConfigSchemas, s as hasBusinessConfig, t as validateCommerceAppConfig } from "../validate-qRpfubPo.mjs";
-import { a as hasCustomInstallationSteps, c as hasEventing, i as hasCustomInstallation, l as hasExternalEvents, n as hasWebhooks, s as hasCommerceEvents } from "../webhooks-NgM6k3_r.mjs";
-import { d as defineConfig, n as readCommerceAppConfig, r as resolveCommerceAppConfig, t as parseCommerceAppConfig } from "../config-BbrkH0Xt.mjs";
+import { a as hasCustomInstallationSteps, c as hasEventing, i as hasCustomInstallation, l as hasExternalEvents, n as hasWebhooks, s as hasCommerceEvents } from "../webhooks-CYo-pqbR.mjs";
+import { a as hasConfigDomain, c as hasBusinessConfigSchema, i as getConfigDomains, n as validateCommerceAppConfigDomain, o as hasMetadata, r as CommerceAppConfigSchemas, s as hasBusinessConfig, t as validateCommerceAppConfig } from "../validate-CqJdGzyZ.mjs";
+import { d as defineConfig, n as readCommerceAppConfig, r as resolveCommerceAppConfig, t as parseCommerceAppConfig } from "../config-BohwKkQS.mjs";
 
 export { CommerceAppConfigSchemas, defineConfig, getConfigDomains, hasBusinessConfig, hasBusinessConfigSchema, hasCommerceEvents, hasConfigDomain, hasCustomInstallation, hasCustomInstallationSteps, hasEventing, hasExternalEvents, hasMetadata, hasWebhooks, parseCommerceAppConfig, readCommerceAppConfig, resolveCommerceAppConfig, validateCommerceAppConfig, validateCommerceAppConfigDomain };

package/dist/es/{config-BbrkH0Xt.mjs → config-BohwKkQS.mjs}

@@ -12,7 +12,7 @@
  * governing permissions and limitations under the License.
  */
 
-import { t as validateCommerceAppConfig } from "./validate-qRpfubPo.mjs";
+import { t as validateCommerceAppConfig } from "./validate-CqJdGzyZ.mjs";
 import { t as stringifyError } from "./error-DHlYzkbb.mjs";
 import { dirname, join, parse } from "path";
 import { existsSync } from "fs";

package/dist/{cjs/index-DRhLtRrX.d.cts → es/index-BmYXe7kp.d.mts}

@@ -12,10 +12,10 @@
  * governing permissions and limitations under the License.
  */
 
-import { n as CommerceAppConfigOutputModel } from "./app-lymFcs59.cjs";
-import { RuntimeActionParams } from "@adobe/aio-commerce-lib-core/params";
-import * as v from "valibot";
+import { n as CommerceAppConfigOutputModel } from "./app-DJr-mN9d.mjs";
 import AioLogger from "@adobe/aio-lib-core-logging";
+import * as v from "valibot";
+import { RuntimeActionParams } from "@adobe/aio-commerce-lib-core/params";
 
 //#region source/management/installation/schema.d.ts
 /** Schema for validating Adobe I/O app credentials required for installation. */
@@ -90,10 +90,10 @@ type LeafStep<TName extends string = string, TConfig extends CommerceAppConfigOu
   validate?: (config: TConfig, context: ValidationExecutionContext<TStepCtx>) => ValidationIssue[] | Promise<ValidationIssue[]>;
 };
 /** A branch step that contains children (no execution). */
-type BranchStep<TName extends string = string, TConfig extends CommerceAppConfigOutputModel = CommerceAppConfigOutputModel, TStepCtx extends Record<string, unknown> = Record<string, unknown>> = StepBase<TName, TConfig> & {
+type BranchStep<TName extends string = string, TConfig extends CommerceAppConfigOutputModel = CommerceAppConfigOutputModel, TStepCtx extends Record<string, unknown> = Record<string, unknown>, TChildren extends AnyStep[] = AnyStep[]> = StepBase<TName, TConfig> & {
   type: "branch"; /** An optional factory function to setup shared context for the children steps. */
   context?: StepContextFactory<TStepCtx>; /** The children steps of this branch. */
-  children: AnyStep[];
+  children: TChildren;
   /**
    * Optional pre-installation validation handler for the branch itself.
    * Called before children are validated. Returning an empty array means
@@ -121,7 +121,7 @@ declare function isBranchStep(step: AnyStep): step is BranchStep;
 /** Options for defining a leaf step. */
 type LeafStepOptions<TName extends string, TConfig extends CommerceAppConfigOutputModel, TStepCtx extends Record<string, unknown> = Record<string, unknown>, TOutput = unknown> = Omit<LeafStep<TName, TConfig, TStepCtx, TOutput>, "type">;
 /** Options for defining a branch step. */
-type BranchStepOptions<TName extends string, TConfig extends CommerceAppConfigOutputModel, TStepCtx extends Record<string, unknown> = Record<string, unknown>> = Omit<BranchStep<TName, TConfig, TStepCtx>, "type">;
+type BranchStepOptions<TName extends string, TConfig extends CommerceAppConfigOutputModel, TStepCtx extends Record<string, unknown> = Record<string, unknown>, TChildren extends AnyStep[] = AnyStep[]> = Omit<BranchStep<TName, TConfig, TStepCtx, TChildren>, "type">;
 /**
  * Define a leaf step (executable, no children).
  *
@@ -137,7 +137,14 @@ type BranchStepOptions<TName extends string, TConfig extends CommerceAppConfigOu
  * });
  * ```
  */
-declare function defineLeafStep<TName extends string, TConfig extends CommerceAppConfigOutputModel, TStepCtx extends Record<string, unknown> = Record<string, unknown>, TOutput = unknown>(options: LeafStepOptions<TName, TConfig, TStepCtx, TOutput>): LeafStep<TName, TConfig, TStepCtx, TOutput>;
+declare function defineLeafStep<TName extends string, TConfig extends CommerceAppConfigOutputModel, TStepCtx extends Record<string, unknown> = Record<string, unknown>, TOutput = unknown>(options: LeafStepOptions<TName, TConfig, TStepCtx, TOutput>): {
+  type: "leaf";
+  name: TName;
+  meta: StepMeta;
+  when: ((config: CommerceAppConfigOutputModel) => config is TConfig) | undefined;
+  run: (config: TConfig, context: ExecutionContext<TStepCtx>) => TOutput | Promise<TOutput>;
+  validate: ((config: TConfig, context: ValidationExecutionContext<TStepCtx>) => ValidationIssue[] | Promise<ValidationIssue[]>) | undefined;
+};
 /**
  * Define a branch step (container with children, no runner).
  *
@@ -152,7 +159,15 @@ declare function defineLeafStep<TName extends string, TConfig extends CommerceAp
  * });
  * ```
  */
-declare function defineBranchStep<TName extends string, TConfig extends CommerceAppConfigOutputModel, TStepCtx extends Record<string, unknown> = Record<string, unknown>>(options: BranchStepOptions<TName, TConfig, TStepCtx>): BranchStep<TName, TConfig, TStepCtx>;
+declare function defineBranchStep<TName extends string, TConfig extends CommerceAppConfigOutputModel, TStepCtx extends Record<string, unknown> = Record<string, unknown>, const TChildren extends AnyStep[] = AnyStep[]>(options: BranchStepOptions<TName, TConfig, TStepCtx, TChildren>): {
+  type: "branch";
+  name: TName;
+  meta: StepMeta;
+  when: ((config: CommerceAppConfigOutputModel) => config is TConfig) | undefined;
+  context: StepContextFactory<TStepCtx> | undefined;
+  children: TChildren;
+  validate: ((config: TConfig, context: ValidationExecutionContext<TStepCtx>) => ValidationIssue[] | Promise<ValidationIssue[]>) | undefined;
+};
 /** Infer the output type from a leaf step. */
 type InferStepOutput<TStep> = TStep extends LeafStep<infer _TName, infer _TConfig, infer _TStepCtx, infer TOutput> ? Awaited<TOutput> : never;
 //#endregion

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

@@ -12,5 +12,5 @@
  * governing permissions and limitations under the License.
  */
 
-import { $ as isBranchStep, A as StepStatus, B as InferStepOutput, C as ExecutionStatus, D as InstallationError, E as InstallationData, F as isSucceededState, G as StepContextFactory, H as LeafStep, I as AnyStep, J as ValidationExecutionContext, K as StepMeta, L as BranchStep, M as isCompletedState, N as isFailedState, O as InstallationState, P as isInProgressState, Q as defineLeafStep, R as BranchStepOptions, S as StepSucceededEvent, T as InProgressInstallationState, U as LeafStepOptions, V as InstallationContext, W as Step, X as ValidationIssueSeverity, Y as ValidationIssue, Z as defineBranchStep, _ as executeWorkflow, a as runInstallation, b as StepFailedEvent, c as defineCustomInstallationStep, d as ValidationResult, et as isLeafStep, f as ValidationSummary, g as createInitialState, h as ExecuteWorkflowOptions, i as createInitialInstallationState, j as SucceededInstallationState, k as InstallationStatus, l as StepValidationResult, m as CreateInitialStateOptions, n as RunInstallationOptions, o as runValidation, p as validateStepTree, q as ValidationContext, r as RunValidationOptions, s as CustomInstallationStepHandler, t as CreateInitialInstallationStateOptions, u as ValidateStepTreeOptions, v as InstallationHooks, w as FailedInstallationState, x as StepStartedEvent, y as StepEvent, z as ExecutionContext } from "../index-D33OCH0D.mjs";
+import { $ as isBranchStep, A as StepStatus, B as InferStepOutput, C as ExecutionStatus, D as InstallationError, E as InstallationData, F as isSucceededState, G as StepContextFactory, H as LeafStep, I as AnyStep, J as ValidationExecutionContext, K as StepMeta, L as BranchStep, M as isCompletedState, N as isFailedState, O as InstallationState, P as isInProgressState, Q as defineLeafStep, R as BranchStepOptions, S as StepSucceededEvent, T as InProgressInstallationState, U as LeafStepOptions, V as InstallationContext, W as Step, X as ValidationIssueSeverity, Y as ValidationIssue, Z as defineBranchStep, _ as executeWorkflow, a as runInstallation, b as StepFailedEvent, c as defineCustomInstallationStep, d as ValidationResult, et as isLeafStep, f as ValidationSummary, g as createInitialState, h as ExecuteWorkflowOptions, i as createInitialInstallationState, j as SucceededInstallationState, k as InstallationStatus, l as StepValidationResult, m as CreateInitialStateOptions, n as RunInstallationOptions, o as runValidation, p as validateStepTree, q as ValidationContext, r as RunValidationOptions, s as CustomInstallationStepHandler, t as CreateInitialInstallationStateOptions, u as ValidateStepTreeOptions, v as InstallationHooks, w as FailedInstallationState, x as StepStartedEvent, y as StepEvent, z as ExecutionContext } from "../index-BmYXe7kp.mjs";
 export { AnyStep, BranchStep, BranchStepOptions, CreateInitialInstallationStateOptions, CreateInitialStateOptions, CustomInstallationStepHandler, ExecuteWorkflowOptions, ExecutionContext, ExecutionStatus, FailedInstallationState, InProgressInstallationState, InferStepOutput, InstallationContext, InstallationData, InstallationError, InstallationHooks, InstallationState, InstallationStatus, LeafStep, LeafStepOptions, RunInstallationOptions, RunValidationOptions, Step, StepContextFactory, StepEvent, StepFailedEvent, StepMeta, StepStartedEvent, StepStatus, StepSucceededEvent, StepValidationResult, SucceededInstallationState, ValidateStepTreeOptions, ValidationContext, ValidationExecutionContext, ValidationIssue, ValidationIssueSeverity, ValidationResult, ValidationSummary, createInitialInstallationState, createInitialState, defineBranchStep, defineCustomInstallationStep, defineLeafStep, executeWorkflow, isBranchStep, isCompletedState, isFailedState, isInProgressState, isLeafStep, isSucceededState, runInstallation, runValidation, validateStepTree };

package/dist/es/management/index.mjs

@@ -12,6 +12,6 @@
  * governing permissions and limitations under the License.
  */
 
-import { a as isCompletedState, c as isSucceededState, i as defineCustomInstallationStep, n as runInstallation, o as isFailedState, r as runValidation, s as isInProgressState, t as createInitialInstallationState } from "../management-CIoVWirU.mjs";
+import { a as isCompletedState, c as isSucceededState, i as defineCustomInstallationStep, n as runInstallation, o as isFailedState, r as runValidation, s as isInProgressState, t as createInitialInstallationState } from "../management-DSexEPTW.mjs";
 
 export { createInitialInstallationState, defineCustomInstallationStep, isCompletedState, isFailedState, isInProgressState, isSucceededState, runInstallation, runValidation };

package/dist/es/{management-CIoVWirU.mjs → management-DSexEPTW.mjs}

@@ -12,12 +12,12 @@
  * governing permissions and limitations under the License.
  */
 
-import { a as hasCustomInstallationSteps, c as hasEventing, l as hasExternalEvents, n as hasWebhooks, s as hasCommerceEvents } from "./webhooks-NgM6k3_r.mjs";
+import { a as hasCustomInstallationSteps, c as hasEventing, d as hasAdminUiSdk, l as hasExternalEvents, n as hasWebhooks, s as hasCommerceEvents } from "./webhooks-CYo-pqbR.mjs";
 import { t as stringifyError } from "./error-DHlYzkbb.mjs";
 import { t as inspect } from "./logging-XIUXDK5T.mjs";
 import camelcase from "camelcase";
+import { AdobeCommerceHttpClient, resolveCommerceHttpClientParams, resolveIoEventsHttpClientParams } from "@adobe/aio-commerce-lib-api";
 import { resolveAuthParams, resolveImsAuthParams } from "@adobe/aio-commerce-lib-auth";
-import { resolveCommerceHttpClientParams, resolveIoEventsHttpClientParams } from "@adobe/aio-commerce-lib-api";
 import { createCustomCommerceEventsApiClient, createEventProvider, createEventSubscription, getAllEventProviders, getAllEventSubscriptions, updateEventingConfiguration } from "@adobe/aio-commerce-lib-events/commerce";
 import { createCustomAdobeIoEventsApiClient, createEventMetadataForProvider, createEventProvider as createEventProvider$1, createRegistration, getAllEventProviders as getAllEventProviders$1, getAllRegistrations } from "@adobe/aio-commerce-lib-events/io-events";
 import { createCustomCommerceWebhooksApiClient, getWebhookList, subscribeWebhook } from "@adobe/aio-commerce-lib-webhooks/api";
@@ -509,6 +509,62 @@ function defineCustomInstallationStep(handler) {
 	return handler;
 }
 
+//#endregion
+//#region source/management/installation/admin-ui-sdk/helpers.ts
+/**
+* Registers the extension with Commerce via POST /V1/adminuisdk/extension.
+*
+* @param context - The execution context providing the Commerce HTTP client and logger.
+* @returns The response from the Commerce API.
+*/
+async function registerExtension(context) {
+	const { commerceClient, appData, logger } = context;
+	logger.info(`Registering Admin UI SDK extension: ${appData.projectName}`);
+	const response = await commerceClient.post("adminuisdk/extension", { json: { extension: {
+		extensionName: process.env.__OW_NAMESPACE,
+		extensionTitle: appData.projectTitle,
+		extensionUrl: `https://${process.env.__OW_NAMESPACE}.adobeio-static.net/index.html`,
+		extensionWorkspace: appData.workspaceName
+	} } }).json();
+	logger.info(`Admin UI SDK extension registered successfully: ${response.extensionId}`);
+	return response;
+}
+
+//#endregion
+//#region source/management/installation/admin-ui-sdk/utils.ts
+/** Creates the Admin UI SDK step context with a lazy-initialized Commerce HTTP client. */
+const createAdminUiSdkStepContext = (installation) => {
+	const { params } = installation;
+	let commerceClient = null;
+	return { get commerceClient() {
+		if (commerceClient === null) commerceClient = new AdobeCommerceHttpClient(resolveCommerceHttpClientParams(params, { tryForwardAuthProvider: true }));
+		return commerceClient;
+	} };
+};
+
+//#endregion
+//#region source/management/installation/admin-ui-sdk/branch.ts
+/** Leaf step that calls POST /V1/adminuisdk/extension to register the extension. */
+const registerExtensionStep = defineLeafStep({
+	name: "register-extension",
+	meta: {
+		label: "Register Extension",
+		description: "Registers the Admin UI SDK extension in Adobe Commerce"
+	},
+	run: (_, context) => registerExtension(context)
+});
+/** Branch step for setting up the Admin UI SDK extension registration. */
+const adminUiSdkStep = defineBranchStep({
+	name: "admin-ui-sdk",
+	meta: {
+		label: "Admin UI SDK",
+		description: "Registers the extension with Adobe Commerce Admin UI SDK"
+	},
+	when: hasAdminUiSdk,
+	context: createAdminUiSdkStepContext,
+	children: [registerExtensionStep]
+});
+
 //#endregion
 //#region source/management/installation/events/utils.ts
 const COMMERCE_PROVIDER_TYPE = "dx_commerce_events";
@@ -517,14 +573,20 @@ const PROVIDER_TYPE_TO_LABEL = {
 	[COMMERCE_PROVIDER_TYPE]: "Commerce",
 	[EXTERNAL_PROVIDER_TYPE]: "External"
 };
+/** Max characters taken from `metadata.id` in the I/O Events provider `instance_id`. */
+const METADATA_ID_MAX_LENGTH_FOR_INSTANCE_ID = 100;
 /**
-* Generates a unique instance ID for the given event provider within the context of the provided config.
+* Generates a unique instance ID for I/O Events for this app deployment.
+* Uses `{metadata.id (first 100 chars)}-{providerKeyOrSlug}-{workspaceId}` (lowercased).
+*
 * @param metadata - The metadata of the application
-* @param provider - The event provider for which to generate the instance ID
+* @param provider - The event provider (optional `key`, else label is slugified)
+* @param workspaceId - Adobe I/O Developer Console workspace ID for this deployment
 */
-function generateInstanceId(metadata, provider) {
+function generateInstanceId(metadata, provider, workspaceId) {
+	const appId = metadata.id.slice(0, METADATA_ID_MAX_LENGTH_FOR_INSTANCE_ID);
 	const slugLabel = provider.label.toLowerCase().replace(/\s+/g, "-");
-	return `${metadata.id}-${provider.key ?? slugLabel}`.toLowerCase();
+	return `${appId}-${provider.key ?? slugLabel}-${workspaceId}`.toLowerCase();
 }
 /**
 * Find an existing event provider by its instance ID.
@@ -543,7 +605,6 @@ function findExistingProviderMetadata(allMetadata, eventName) {
 	return allMetadata.find((meta) => meta.event_code === eventName) ?? null;
 }
 /**
-<<<<<<< HEAD
 * Find existing event registrations by client ID and name.
 * @param allRegistrations - The list of all existing event registrations.
 * @param clientId - The client ID of the workspace where the registration was created.
@@ -574,7 +635,7 @@ function getIoEventCode(name, providerType) {
 * @param runtimeAction - The runtime action this registration points to.
 */
 function getRegistrationName(provider, runtimeAction) {
-	const providerLabel = PROVIDER_TYPE_TO_LABEL[provider.provider_metadata] ?? "Unknown";
+	const providerLabel = PROVIDER_TYPE_TO_LABEL[provider.provider_metadata];
 	const [packageName, actionName] = runtimeAction.split("/").map(kebabToTitleCase);
 	return `${providerLabel} Event Registration: ${actionName} (${packageName})`;
 }
@@ -698,8 +759,11 @@ async function getCommerceEventingExistingData(context) {
 	const { commerceEventsClient } = context;
 	const existingProviders = await commerceEventsClient.getAllEventProviders();
 	const existingSubscriptions = await commerceEventsClient.getAllEventSubscriptions();
+	const defaultProvider = existingProviders.find((provider) => !("id" in provider)) ?? null;
+	const isDefaultProviderConfigured = defaultProvider !== null;
 	return {
-		isDefaultWorkspaceConfigurationEmpty: existingProviders.some((provider) => !("id" in provider) && !provider.workspace_configuration?.trim()),
+		isDefaultProviderConfigured,
+		isDefaultWorkspaceConfigurationEmpty: isDefaultProviderConfigured ? !defaultProvider.workspace_configuration?.trim() : true,
 		providers: existingProviders,
 		subscriptions: new Map(existingSubscriptions.map((subscription) => [subscription.name, subscription]))
 	};
@@ -860,22 +924,30 @@ async function createOrGetIoEventRegistration(params, registrations) {
 async function configureCommerceEventing(params, existingData) {
 	const { context, config } = params;
 	const { commerceEventsClient, logger } = context;
+	const { isDefaultProviderConfigured, isDefaultWorkspaceConfigurationEmpty } = existingData;
 	logger.info("Starting configuration of the Commerce Eventing Module");
-	let updateParams = {
-		...config,
-		enabled: true
-	};
-	if (existingData.isDefaultWorkspaceConfigurationEmpty) {
-		if (!config.workspace_configuration) {
+	if (isDefaultProviderConfigured && !isDefaultWorkspaceConfigurationEmpty) {
+		logger.info("Commerce Eventing Module is already configured, skipping configuration step.");
+		return;
+	}
+	const { workspace_configuration, ...configWithoutWorkspace } = config;
+	let updateParams = { enabled: true };
+	if (isDefaultWorkspaceConfigurationEmpty) {
+		if (!workspace_configuration) {
 			const message = "Workspace configuration is required to enable Commerce Eventing when there is not an existing one.";
 			logger.error(message);
 			throw new Error(message);
 		}
-		logger.info("Default provider workspace configuration already present, it will not be overriden");
-		const { workspace_configuration, ...rest } = updateParams;
-		updateParams = rest;
+		updateParams.workspace_configuration = workspace_configuration;
+		logger.info("Adding workspace configuration to Commerce Eventing configuration as it has not been set up yet.");
+	}
+	if (!isDefaultProviderConfigured) {
+		logger.info("Default provider not configured, it will be created with the provided configuration.");
+		updateParams = {
+			...updateParams,
+			...configWithoutWorkspace
+		};
 	}
-	logger.info("Updating Commerce Eventing configuration with provided workspace configuration.");
 	return commerceEventsClient.updateEventingConfiguration(updateParams).then((success) => {
 		if (success) {
 			logger.info("Commerce Eventing Module configured successfully.");
@@ -974,7 +1046,7 @@ async function createOrGetCommerceEventSubscription(params, existingData) {
 async function onboardIoEvents(params, existingData) {
 	const { providersWithMetadata, registrations } = existingData;
 	const { context, metadata, provider, providerType, events } = params;
-	const instanceId = generateInstanceId(metadata, provider);
+	const instanceId = generateInstanceId(metadata, provider, context.appData.workspaceId);
 	const providerData = await createOrGetIoEventProvider({
 		context,
 		provider: {
@@ -1467,6 +1539,7 @@ function createDefaultChildSteps(config) {
 	return [
 		eventingStep,
 		webhooksStep,
+		adminUiSdkStep,
 		createCustomInstallationStep(config)
 	];
 }