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

package/dist/es/config/index.mjs

@@ -12,8 +12,8 @@
  * governing permissions and limitations under the License.
  */
 
-import { a as hasCustomInstallationSteps, c as hasEventing, d as hasAdminUiSdk, i as hasCustomInstallation, l as hasExternalEvents, n as hasWebhooks, s as hasCommerceEvents } from "../webhooks-Dhrkkip7.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-Dn3lLTGj.mjs";
-import { d as defineConfig, n as readCommerceAppConfig, r as resolveCommerceAppConfig, t as parseCommerceAppConfig } from "../config-DGPFTk6w.mjs";
+import { d as defineConfig, n as readCommerceAppConfig, r as resolveCommerceAppConfig, t as parseCommerceAppConfig } from "../config-3I4eLyyR.mjs";
+import { a as hasCustomInstallationSteps, c as hasEventing, d as hasAdminUiSdk, i as hasCustomInstallation, l as hasExternalEvents, n as hasWebhooks, s as hasCommerceEvents } from "../webhooks-B5oq9ULL.mjs";
+import { a as CommerceAppConfigSchemas, c as hasMetadata, l as hasBusinessConfig, n as validateCommerceAppConfigDomain, o as getConfigDomains, s as hasConfigDomain, t as validateCommerceAppConfig, u as hasBusinessConfigSchema } from "../validate-Dfajrp99.mjs";
 
 export { CommerceAppConfigSchemas, defineConfig, getConfigDomains, hasAdminUiSdk, hasBusinessConfig, hasBusinessConfigSchema, hasCommerceEvents, hasConfigDomain, hasCustomInstallation, hasCustomInstallationSteps, hasEventing, hasExternalEvents, hasMetadata, hasWebhooks, parseCommerceAppConfig, readCommerceAppConfig, resolveCommerceAppConfig, validateCommerceAppConfig, validateCommerceAppConfigDomain };

package/dist/es/{config-DGPFTk6w.mjs → config-3I4eLyyR.mjs}

@@ -12,14 +12,13 @@
  * governing permissions and limitations under the License.
  */
 
-import { t as validateCommerceAppConfig } from "./validate-Dn3lLTGj.mjs";
-import { t as stringifyError } from "./error-DHlYzkbb.mjs";
+import { t as stringifyError } from "./error-_RMwtrUA.mjs";
+import { t as validateCommerceAppConfig } from "./validate-Dfajrp99.mjs";
 import { dirname, join, parse } from "path";
 import { existsSync } from "fs";
 import { access, mkdir, readFile } from "fs/promises";
 import { resolveCommand } from "package-manager-detector";
 import { detect, getUserAgent } from "package-manager-detector/detect";
-import { createJiti } from "jiti";
 
 //#region source/config/lib/define.ts
 /**
@@ -169,7 +168,6 @@ function getInstallCommand(packageManager, packages) {
 
 //#endregion
 //#region source/config/lib/parser.ts
-const jiti = createJiti(import.meta.url);
 const configPaths = Object.freeze([
 	"app.commerce.config.js",
 	"app.commerce.config.ts",
@@ -220,7 +218,8 @@ async function readCommerceAppConfig(cwd = process.cwd()) {
 	if (!configFilePath) throw new Error("Could not find a commerce app config file in the current working directory or its parents.");
 	let config = null;
 	try {
-		config = await jiti.import(configFilePath);
+		const { createJiti } = await import("jiti");
+		config = await createJiti(import.meta.url).import(configFilePath);
 	} catch (error) {
 		const message = stringifyError(error);
 		throw new Error(`Failed to read commerce app config file at ${configFilePath}: ${message}`, { cause: error });

package/dist/es/index-B0XqHwY5.d.mts

@@ -0,0 +1,16 @@
+/**
+ * @license
+ *
+ * Copyright 2026 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+import AioLogger from "@adobe/aio-lib-core-logging";
+import { RuntimeActionParams } from "@adobe/aio-commerce-lib-core/params";

package/dist/es/{index-CCov0odd.d.mts → index-DLMbTtKS.d.mts}

@@ -12,9 +12,178 @@
  * governing permissions and limitations under the License.
  */
 
-import { n as CommerceAppConfigOutputModel } from "./app-DcY6dJiQ.mjs";
-import { f as StepMetaInfo, h as ValidationIssue, i as ExecutionContext, n as BranchStep, o as InstallationContext, p as ValidationContext } from "./step-0eI2x4C9.mjs";
+import { r as CommerceAppConfigOutputModel } from "./app-DrYHK-z1.mjs";
+import * as v from "valibot";
+import AioLogger from "@adobe/aio-lib-core-logging";
+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. */
+declare const AppDataSchema: v.ObjectSchema<{
+  readonly consumerOrgId: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
+  readonly orgName: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
+  readonly projectId: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
+  readonly projectName: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
+  readonly projectTitle: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
+  readonly workspaceId: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
+  readonly workspaceName: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
+  readonly workspaceTitle: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
+}, undefined>;
+/** Type for Adobe I/O app credentials. */
+type AppData = v.InferOutput<typeof AppDataSchema>;
+//#endregion
+//#region source/management/installation/workflow/step.d.ts
+/** Severity level of a validation issue. */
+type ValidationIssueSeverity = "error" | "warning" | "info";
+/** A single validation issue reported by a step's validate handler. */
+type ValidationIssue = {
+  /** Machine-readable code identifying the issue type. */code: string; /** Human-readable description of the issue. */
+  message: string; /** Severity of the issue. Only "error" severity blocks installation. */
+  severity: ValidationIssueSeverity; /** Optional additional context about the issue. */
+  details?: Record<string, unknown>;
+};
+/** Shared context available to all steps during installation. */
+type InstallationContext = {
+  /** The credentials of the app being installed */appData: AppData; /** The raw action parameters from the App Builder runtime action. */
+  params: RuntimeActionParams & {
+    AIO_COMMERCE_AUTH_IMS_CLIENT_ID: string;
+    AIO_COMMERCE_AUTH_IMS_CLIENT_SECRETS: string | string[];
+    AIO_COMMERCE_AUTH_IMS_TECHNICAL_ACCOUNT_ID: string;
+    AIO_COMMERCE_AUTH_IMS_TECHNICAL_ACCOUNT_EMAIL: string;
+    AIO_COMMERCE_AUTH_IMS_ORG_ID: string;
+    AIO_COMMERCE_AUTH_IMS_SCOPES: string | string[];
+  }; /** Logger instance for installation logging. */
+  logger: ReturnType<typeof AioLogger>; /** Custom scripts defined in the configuration (if any). */
+  customScripts?: Record<string, unknown>;
+};
+/** Factory function type for creating step-specific context. */
+type StepContextFactory<TStepCtx extends Record<string, unknown> = Record<string, unknown>> = (context: InstallationContext) => TStepCtx | Promise<TStepCtx>;
+/** The execution context passed to leaf step run handlers. */
+type ExecutionContext<TStepCtx extends Record<string, unknown> = Record<string, unknown>> = InstallationContext & TStepCtx;
+/**
+ * A narrowed context available to step `validate` handlers.
+ * Excludes `customScripts` — those only apply during installation, not pre-flight validation.
+ */
+type ValidationContext = Omit<InstallationContext, "customScripts">;
+/** The context passed to step `validate` handlers (base validation context merged with step-level context). */
+type ValidationExecutionContext<TStepCtx extends Record<string, unknown> = Record<string, unknown>> = ValidationContext & TStepCtx;
+/** Metadata info for a step (used for UI display). */
+type StepMetaInfo = {
+  label: string;
+  description?: string;
+};
+/** Step metadata keyed by execution mode. */
+type StepMeta = {
+  install: StepMetaInfo;
+  uninstall?: StepMetaInfo;
+};
+/** Defines the base properties of a step. */
+type StepBase<TName extends string = string, TConfig extends CommerceAppConfigOutputModel = CommerceAppConfigOutputModel> = {
+  /** The name of this step. */name: TName; /** Metadata associated with the step, keyed by execution mode. */
+  meta: StepMeta; /** Whether the step should be taken into consideration. */
+  when?: (config: CommerceAppConfigOutputModel) => config is TConfig;
+};
+/** A leaf step that executes work (no children). */
+type LeafStep<TName extends string = string, TConfig extends CommerceAppConfigOutputModel = CommerceAppConfigOutputModel, TStepCtx extends Record<string, unknown> = Record<string, unknown>, TOutput = unknown> = StepBase<TName, TConfig> & {
+  type: "leaf"; /** The execution handler for the step. */
+  install: (config: TConfig, context: ExecutionContext<TStepCtx>) => TOutput | Promise<TOutput>;
+  /**
+   * Optional pre-installation validation handler.
+   * Called before installation begins to surface issues (errors or warnings).
+   * Returning an empty array means the step has no issues.
+   */
+  validate?: (config: TConfig, context: ValidationExecutionContext<TStepCtx>) => ValidationIssue[] | Promise<ValidationIssue[]>;
+  /**
+   * Optional uninstall handler for the step.
+   * Called during uninstallation to reverse the work done by `install`.
+   * If absent, the step is silently skipped during uninstallation.
+   */
+  uninstall?: (config: TConfig, context: ExecutionContext<TStepCtx>) => void | Promise<void>;
+};
+/** 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>, 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: TChildren;
+  /**
+   * Optional pre-installation validation handler for the branch itself.
+   * Called before children are validated. Returning an empty array means
+   * the branch has no issues at this level.
+   */
+  validate?: (config: TConfig, context: ValidationExecutionContext<TStepCtx>) => ValidationIssue[] | Promise<ValidationIssue[]>;
+};
+/** A step in the installation tree (discriminated union by `type`). */
+type Step<TName extends string = string, TConfig extends CommerceAppConfigOutputModel = CommerceAppConfigOutputModel, TStepCtx extends Record<string, unknown> = Record<string, unknown>, TOutput = unknown> = LeafStep<TName, TConfig, TStepCtx, TOutput> | BranchStep<TName, TConfig, TStepCtx>;
+/** Loosely-typed step for use in non type-safe contexts. */
+interface AnyStep {
+  children?: AnyStep[];
+  context?: (context: InstallationContext) => any;
+  install?: (config: any, context: any) => unknown | Promise<unknown>;
+  meta: StepMeta;
+  name: string;
+  type: "leaf" | "branch";
+  uninstall?: (config: any, context: any) => void | Promise<void>;
+  validate?: (config: any, context: any) => ValidationIssue[] | Promise<ValidationIssue[]>;
+  when?: (config: CommerceAppConfigOutputModel) => boolean;
+}
+/** Check if a step is a leaf step. */
+declare function isLeafStep(step: AnyStep): step is LeafStep;
+/** Check if a step is a branch step. */
+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>, TChildren extends AnyStep[] = AnyStep[]> = Omit<BranchStep<TName, TConfig, TStepCtx, TChildren>, "type">;
+/**
+ * Define a leaf step (executable, no children).
+ *
+ * @example
+ * ```typescript
+ * const createProviders = defineLeafStep({
+ *   name: "providers",
+ *   meta: { install: { label: "Create Providers", description: "Creates I/O Events providers" } },
+ *   install: async ({ config, stepContext }) => {
+ *     const { eventsClient } = stepContext;
+ *     return eventsClient.createProvider(config.eventing);
+ *   },
+ * });
+ * ```
+ */
+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;
+  install: (config: TConfig, context: ExecutionContext<TStepCtx>) => TOutput | Promise<TOutput>;
+  uninstall: ((config: TConfig, context: ExecutionContext<TStepCtx>) => void | Promise<void>) | undefined;
+  validate: ((config: TConfig, context: ValidationExecutionContext<TStepCtx>) => ValidationIssue[] | Promise<ValidationIssue[]>) | undefined;
+};
+/**
+ * Define a branch step (container with children, no runner).
+ *
+ * @example
+ * ```typescript
+ * const eventing = defineBranchStep({
+ *   name: "eventing",
+ *   meta: { install: { label: "Eventing", description: "Sets up I/O Events" } },
+ *   when: hasEventing,
+ *   context: async (ctx) => ({ eventsClient: await createEventsClient(ctx) }),
+ *   children: [commerceEventsStep, externalEventsStep],
+ * });
+ * ```
+ */
+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
 //#region source/management/installation/workflow/types.d.ts
 /** Status of a step execution. */
 type ExecutionStatus = "pending" | "in-progress" | "succeeded" | "failed";
@@ -309,4 +478,4 @@ type RunValidationOptions = {
  */
 declare function runValidation(options: RunValidationOptions): Promise<ValidationResult>;
 //#endregion
-export { ExecutionStatus as A, isCompletedState as B, executeUninstallWorkflow as C, StepFailedEvent as D, StepEvent as E, InstallationRetryMetadata as F, isInProgressState as H, InstallationState as I, InstallationStatus as L, InProgressInstallationState as M, InstallationData as N, StepStartedEvent as O, InstallationError as P, StepStatus as R, createRetryState as S, InstallationHooks as T, isSucceededState as U, isFailedState as V, ValidationSummary as _, RunValidationOptions as a, ExecuteWorkflowOptions as b, runInstallation as c, CustomInstallationStepDefinition as d, CustomInstallationStepHandler as f, ValidationResult as g, ValidateStepTreeOptions as h, RunUninstallationOptions as i, FailedInstallationState as j, StepSucceededEvent as k, runUninstallation as l, StepValidationResult as m, CreateInitialUninstallationStateOptions as n, createInitialInstallationState as o, defineCustomInstallationStep as p, RunInstallationOptions as r, createInitialUninstallationState as s, CreateInitialInstallationStateOptions as t, runValidation as u, validateStepTree as v, executeWorkflow as w, createInitialState as x, CreateInitialStateOptions as y, SucceededInstallationState as z };
+export { StepContextFactory as $, ExecutionStatus as A, isCompletedState as B, executeUninstallWorkflow as C, StepFailedEvent as D, StepEvent as E, InstallationRetryMetadata as F, BranchStep as G, isInProgressState as H, InstallationState as I, InferStepOutput as J, BranchStepOptions as K, InstallationStatus as L, InProgressInstallationState as M, InstallationData as N, StepStartedEvent as O, InstallationError as P, Step as Q, StepStatus as R, createRetryState as S, InstallationHooks as T, isSucceededState as U, isFailedState as V, AnyStep as W, LeafStep as X, InstallationContext as Y, LeafStepOptions as Z, ValidationSummary as _, RunValidationOptions as a, ValidationIssueSeverity as at, ExecuteWorkflowOptions as b, runInstallation as c, isBranchStep as ct, CustomInstallationStepDefinition as d, StepMeta as et, CustomInstallationStepHandler as f, ValidationResult as g, ValidateStepTreeOptions as h, RunUninstallationOptions as i, ValidationIssue as it, FailedInstallationState as j, StepSucceededEvent as k, runUninstallation as l, isLeafStep as lt, StepValidationResult as m, CreateInitialUninstallationStateOptions as n, ValidationContext as nt, createInitialInstallationState as o, defineBranchStep as ot, defineCustomInstallationStep as p, ExecutionContext as q, RunInstallationOptions as r, ValidationExecutionContext as rt, createInitialUninstallationState as s, defineLeafStep as st, CreateInitialInstallationStateOptions as t, StepMetaInfo as tt, runValidation as u, validateStepTree as v, executeWorkflow as w, createInitialState as x, CreateInitialStateOptions as y, SucceededInstallationState as z };

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

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

package/dist/es/management/index.mjs

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

package/dist/es/{management-CCsOfniv.mjs → management-BUX-w2Ji.mjs}

@@ -12,17 +12,34 @@
  * governing permissions and limitations under the License.
  */
 
-import { a as hasCustomInstallationSteps, c as hasEventing, d as hasAdminUiSdk, l as hasExternalEvents, n as hasWebhooks, s as hasCommerceEvents } from "./webhooks-Dhrkkip7.mjs";
-import { t as stringifyError } from "./error-DHlYzkbb.mjs";
-import { t as inspect } from "./logging-XIUXDK5T.mjs";
+import { t as stringifyError } from "./error-_RMwtrUA.mjs";
+import { a as hasCustomInstallationSteps, c as hasEventing, d as hasAdminUiSdk, l as hasExternalEvents, n as hasWebhooks, s as hasCommerceEvents } from "./webhooks-B5oq9ULL.mjs";
+import { t as inspect } from "./logging-DbJHXSKh.mjs";
+import { CommerceSdkValidationError } from "@adobe/aio-commerce-lib-core/error";
+import * as v from "valibot";
 import { unwrapHttpError } from "@adobe/aio-commerce-lib-api/utils";
-import camelcase from "camelcase";
-import { AdobeCommerceHttpClient, resolveCommerceHttpClientParams, resolveIoEventsHttpClientParams } from "@adobe/aio-commerce-lib-api";
+import * as camelcaseModule from "camelcase";
+import { createAdminUiApiClient } from "@adobe/aio-commerce-lib-admin-ui/api";
+import { resolveCommerceHttpClientParams, resolveIoEventsHttpClientParams } from "@adobe/aio-commerce-lib-api";
 import { resolveAuthParams, resolveImsAuthParams } from "@adobe/aio-commerce-lib-auth";
 import { createCustomCommerceEventsApiClient, createEventProvider, createEventSubscription, deleteEventProvider, deleteEventSubscription, getAllEventProviders, getAllEventSubscriptions, updateEventingConfiguration } from "@adobe/aio-commerce-lib-events/commerce";
 import { createCustomAdobeIoEventsApiClient, createEventMetadataForProvider, createEventProvider as createEventProvider$1, createRegistration, deleteEventMetadataForProvider, deleteEventProvider as deleteEventProvider$1, deleteRegistration, getAllEventProviders as getAllEventProviders$1, getAllRegistrations } from "@adobe/aio-commerce-lib-events/io-events";
 import { createCustomCommerceWebhooksApiClient, getWebhookList, subscribeWebhook, unsubscribeWebhook } from "@adobe/aio-commerce-lib-webhooks/api";
 
+//#region ../../packages-private/common-utils/source/valibot/utils.ts
+/**
+* Parses the input using the provided schema and throws a {@link CommerceSdkValidationError} error if the input is invalid.
+* @param schema - The schema to use for parsing.
+* @param input - The input to parse.
+* @param message - Optional custom error message for the validation error.
+*/
+function parseOrThrow(schema, input, message) {
+	const result = v.safeParse(schema, input);
+	if (!result.success) throw new CommerceSdkValidationError(message ?? "Invalid input", { issues: result.issues });
+	return result.output;
+}
+
+//#endregion
 //#region source/management/installation/workflow/hooks.ts
 /** Helper to call a hook if it exists. */
 async function callHook(hooks, hookName, ...args) {
@@ -453,11 +470,38 @@ function aggregateSummary(result) {
 
 //#endregion
 //#region source/management/installation/custom-installation/custom-scripts.ts
-function isCustomInstallationStepDefinition(obj) {
-	return typeof obj === "object" && obj !== null && "install" in obj && typeof obj.install === "function";
+const camelcase = camelcaseModule.default.default ?? camelcaseModule.default;
+const ScriptModuleSchema = v.union([v.function(), v.object({
+	install: v.function(),
+	uninstall: v.optional(v.function())
+})]);
+/**
+* Validates that a loaded script export can be executed as a custom installation step.
+*
+* @param module - The loaded script export to validate.
+* @throws If the export is not a function or an object with an `install` function.
+*/
+function assertScriptModule(module) {
+	parseOrThrow(ScriptModuleSchema, module, "Invalid script module format. Expected a function or an object with an `install` method.");
 }
-function isCustomInstallationStepHandler(obj) {
-	return typeof obj === "function";
+/**
+* Parses and validates a custom script module from the provided customScripts context.
+* It supports both direct function exports and default exports.
+*
+* @param customScripts - The customScripts context containing the loaded modules
+* @param script - The script path to resolve the module for
+*/
+function getScriptModule(customScripts, script) {
+	let scriptModule = customScripts[script];
+	if (!scriptModule) throw new Error(`Script ${script} not found in customScripts context. Make sure the script is defined in the configuration and the action was generated with custom scripts support.`);
+	if (typeof scriptModule === "object" && "default" in scriptModule) scriptModule = scriptModule.default;
+	assertScriptModule(scriptModule);
+	return scriptModule;
+}
+function resolveCustomScriptHandler(scriptModule, handler) {
+	if (typeof scriptModule === "function") return handler === "install" ? scriptModule : null;
+	if (handler in scriptModule && typeof scriptModule[handler] === "function") return scriptModule[handler];
+	return null;
 }
 /**
 * Creates a leaf step for executing a single custom installation script.
@@ -475,15 +519,7 @@ function createCustomScriptStep(scriptConfig) {
 			const customScripts = context.customScripts || {};
 			logger.info(`Executing custom installation script: ${name}`);
 			logger.debug(`Script path: ${script}`);
-			const scriptModule = customScripts[script];
-			if (!scriptModule) throw new Error(`Script ${script} not found in customScripts context. Make sure the script is defined in the configuration and the action was generated with custom scripts support.`);
-			if (typeof scriptModule !== "object" || !("default" in scriptModule)) throw new Error(`Script ${script} must export a default function or object. Use defineCustomInstallationStep helper.`);
-			const defaultExport = scriptModule.default;
-			let runFunction = null;
-			if (isCustomInstallationStepHandler(defaultExport)) runFunction = defaultExport;
-			else if (isCustomInstallationStepDefinition(defaultExport)) runFunction = defaultExport.install;
-			if (runFunction === null) throw new Error(`Script ${script} default export must be a function or an object with an install method. Use defineCustomInstallationStep helper.`);
-			const scriptResult = await runFunction(config, context);
+			const scriptResult = await resolveCustomScriptHandler(getScriptModule(customScripts, script), "install")(config, context);
 			logger.info(`Successfully executed script: ${name}`);
 			return {
 				script,
@@ -494,14 +530,7 @@ function createCustomScriptStep(scriptConfig) {
 			const { logger } = context;
 			const customScripts = context.customScripts || {};
 			logger.debug(`Uninstalling custom script: ${name}`);
-			const scriptModule = customScripts[script];
-			if (!scriptModule) throw new Error(`Script ${script} not found in customScripts context. Make sure the script is defined in the configuration and the action was generated with custom scripts support.`);
-			const defaultExport = scriptModule.default;
-			if (!isCustomInstallationStepDefinition(defaultExport)) {
-				logger.debug(`Script ${script} does not export an uninstall function, skipping uninstall.`);
-				return;
-			}
-			const { uninstall } = defaultExport;
+			const uninstall = resolveCustomScriptHandler(getScriptModule(customScripts, script), "uninstall");
 			if (!uninstall) {
 				logger.debug(`Script ${script} does not export an uninstall function, skipping uninstall.`);
 				return;
@@ -608,34 +637,40 @@ async function throwHttpError(logger, error, prefix) {
 /**
 * 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.
+* @param context - The execution context providing the Admin UI SDK client and logger.
 */
 async function registerExtension(context) {
-	const { commerceClient, appData, logger } = context;
+	const { adminUiClient, appData, logger } = context;
+	const extensionName = process.env.__OW_NAMESPACE;
+	if (!extensionName) throw new Error("__OW_NAMESPACE environment variable is not set");
 	logger.info(`Registering Admin UI SDK extension: ${appData.projectName}`);
-	const response = await commerceClient.post("adminuisdk/extension", { json: { extension: {
-		extensionName: process.env.__OW_NAMESPACE,
+	const { extensionId } = await adminUiClient.registerExtension({
+		extensionName,
 		extensionTitle: appData.projectTitle,
-		extensionUrl: `https://${process.env.__OW_NAMESPACE}.adobeio-static.net/index.html`,
+		extensionUrl: `https://${extensionName}.adobeio-static.net/index.html`,
 		extensionWorkspace: appData.workspaceName
-	} } }).json().catch((error) => throwHttpError(logger, error, "Failed to register Admin UI SDK extension"));
-	logger.info(`Admin UI SDK extension registered successfully: ${response.extensionId}`);
-	return response;
+	}).catch((error) => throwHttpError(logger, error, "Failed to register Admin UI SDK extension"));
+	logger.info(`Admin UI SDK extension registered successfully: ${extensionId}`);
 }
 /**
 * Unregisters the extension from Commerce via DELETE /V1/adminuisdk/extension/:workspace_name/:extension_name.
 * Best-effort: errors are logged as warnings and do not stop the uninstall workflow.
 *
-* @param context - The execution context providing the Commerce HTTP client and logger.
+* @param context - The execution context providing the Admin UI SDK client and logger.
 */
-async function uninstallExtension(context) {
-	const { commerceClient, appData, logger } = context;
+async function unregisterExtension(context) {
+	const { adminUiClient, appData, logger } = context;
 	const extensionName = process.env.__OW_NAMESPACE;
-	const endpoint = `adminuisdk/extension/${appData.workspaceName}/${extensionName}`;
+	if (!extensionName) {
+		logger.warn("__OW_NAMESPACE environment variable is not set; skipping Admin UI SDK extension unregistration. Continuing uninstall.");
+		return;
+	}
 	logger.info(`Unregistering Admin UI SDK extension "${extensionName}" from workspace "${appData.workspaceName}"...`);
 	try {
-		await commerceClient.delete(endpoint);
+		await adminUiClient.unregisterExtension({
+			workspaceName: appData.workspaceName,
+			extensionName
+		});
 		logger.info(`Admin UI SDK extension "${extensionName}" unregistered successfully.`);
 	} catch (error) {
 		const msg = await unwrapHttpError(error);
@@ -645,19 +680,22 @@ async function uninstallExtension(context) {
 
 //#endregion
 //#region source/management/installation/admin-ui-sdk/utils.ts
-/** Creates the Admin UI SDK step context with a lazy-initialized Commerce HTTP client. */
+function createAdminUiClient(params) {
+	return createAdminUiApiClient(resolveCommerceHttpClientParams(params, { tryForwardAuthProvider: true }));
+}
+/** Creates the Admin UI SDK step context with a lazy-initialized API 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;
+	let adminUiClient = null;
+	return { get adminUiClient() {
+		if (adminUiClient === null) adminUiClient = createAdminUiClient(params);
+		return adminUiClient;
 	} };
 };
 
 //#endregion
 //#region source/management/installation/admin-ui-sdk/branch.ts
-/** Leaf step that calls POST /V1/adminuisdk/extension to register the extension. */
+/** Leaf step that registers the extension (POST) on install and unregisters it (DELETE) on uninstall. */
 const registerExtensionStep = defineLeafStep({
 	name: "register-extension",
 	meta: {
@@ -671,7 +709,7 @@ const registerExtensionStep = defineLeafStep({
 		}
 	},
 	install: (_, context) => registerExtension(context),
-	uninstall: (_, context) => uninstallExtension(context)
+	uninstall: (_, context) => unregisterExtension(context)
 });
 /** Branch step for setting up the Admin UI SDK extension registration. */
 const adminUiSdkStep = defineBranchStep({
@@ -766,15 +804,37 @@ function getNamespacedEvent(metadata, name) {
 function getIoEventCode(name, providerType) {
 	return providerType === "dx_commerce_events" ? `com.adobe.commerce.${name}` : name;
 }
+/** Maps a provider's metadata type to its human-readable label ("Commerce" or "External"). */
+function getProviderTypeLabel(provider) {
+	return PROVIDER_TYPE_TO_LABEL[provider.provider_metadata];
+}
 /**
-* Generates a registration name and description based on the provider, events, and runtime action.
+* Generates a registration name based on the provider type, provider label, and runtime action.
+*
+* Prefixes with the provider type label ("Commerce" or "External") for readability, then the
+* provider's own label to ensure uniqueness when multiple providers of the same type route
+* events to the same runtime action.
+*
 * @param provider - The provider this registration is associated to.
 * @param runtimeAction - The runtime action this registration points to.
 */
 function getRegistrationName(provider, runtimeAction) {
-	const providerLabel = PROVIDER_TYPE_TO_LABEL[provider.provider_metadata];
 	const [packageName, actionName] = runtimeAction.split("/").map(kebabToTitleCase);
-	return `${providerLabel} Event Registration: ${actionName} (${packageName})`;
+	return `${getProviderTypeLabel(provider)} Event Registration: ${provider.label} - ${actionName} (${packageName})`;
+}
+/**
+* Returns the registration name in the legacy format used by SDK versions that built
+* the name from the generic provider type label ("Commerce" / "External") rather than
+* the provider's own label. Used during uninstall to match registrations that were
+* created before the naming change.
+*
+* @param provider - The provider this registration is associated to.
+* @param runtimeAction - The runtime action this registration points to.
+* @deprecated Use {@link getRegistrationName} for all new registrations.
+*/
+function getLegacyRegistrationName(provider, runtimeAction) {
+	const [packageName, actionName] = runtimeAction.split("/").map(kebabToTitleCase);
+	return `${getProviderTypeLabel(provider)} Event Registration: ${actionName} (${packageName})`;
 }
 /**
 * Generates a registration name and description based on the provider, events, and runtime action.
@@ -1149,6 +1209,7 @@ async function createCommerceEventSubscription(params) {
 		name: eventName,
 		parent: event.config.name,
 		fields: event.config.fields,
+		rules: event.config.rules,
 		provider_id: provider.id,
 		destination: event.config.destination,
 		hipaa_audit_required: event.config.hipaa_audit_required,
@@ -1273,7 +1334,8 @@ async function deleteIoEventRegistrations(providerData, provider, events, regist
 		workspaceId: appData.workspaceId
 	};
 	const actionEventsMap = groupEventsByRuntimeActions(events);
-	const registrationNames = new Set(Array.from(actionEventsMap.keys()).map((runtimeAction) => getRegistrationName(providerData, runtimeAction)));
+	const runtimeActions = Array.from(actionEventsMap.keys());
+	const registrationNames = new Set([...runtimeActions.map((runtimeAction) => getRegistrationName(providerData, runtimeAction)), ...runtimeActions.map((runtimeAction) => getLegacyRegistrationName(providerData, runtimeAction))]);
 	const providerRegistrations = registrations.filter((reg) => reg.client_id === runtimeParams.AIO_COMMERCE_AUTH_IMS_CLIENT_ID && registrationNames.has(reg.name));
 	if (providerRegistrations.length === 0) {
 		logger.info(`No I/O Events registrations found for provider "${provider.label}" (instance ID: "${providerData.instance_id}").`);