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

package/dist/cjs/{config-FNMclIFO.cjs → config-D-s0GSep.cjs}

@@ -12,8 +12,8 @@
  * governing permissions and limitations under the License.
  */
 
-const require_validate = require('./validate-DydOAZha.cjs');
 const require_error = require('./error-D-N0PKSl.cjs');
+const require_validate = require('./validate-oAOpyFyb.cjs');
 let path = require("path");
 let fs = require("fs");
 let fs_promises = require("fs/promises");

package/dist/cjs/{index-Dw2NvVOY.d.cts → index-B5gJ-q4U.d.cts}

@@ -12,9 +12,178 @@
  * governing permissions and limitations under the License.
  */
 
-import { n as CommerceAppConfigOutputModel } from "./app-CakwxQvs.cjs";
-import { f as StepMetaInfo, h as ValidationIssue, i as ExecutionContext, n as BranchStep, o as InstallationContext, p as ValidationContext } from "./step-CKVE0aJi.cjs";
+import { r as CommerceAppConfigOutputModel } from "./app-DrYHK-z1.cjs";
+import { RuntimeActionParams } from "@adobe/aio-commerce-lib-core/params";
+import AioLogger from "@adobe/aio-lib-core-logging";
+import * as v from "valibot";
 
+//#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/actions/app-config.d.mts → cjs/index-BXm8UbK7.d.cts}

@@ -12,17 +12,5 @@
  * governing permissions and limitations under the License.
  */
 
-import { t as CommerceAppConfig } from "../app-CakwxQvs.mjs";
 import { RuntimeActionParams } from "@adobe/aio-commerce-lib-core/params";
-
-//#region source/actions/app-config.d.ts
-/** Arguments for the runtime action factory. */
-type RuntimeActionFactoryArgs = {
-  appConfig: CommerceAppConfig;
-};
-/** Factory to create the route handler for the `app-config` action. */
-declare const appConfigRuntimeAction: ({
-  appConfig
-}: RuntimeActionFactoryArgs) => (params: RuntimeActionParams) => Promise<import("@adobe/aio-commerce-lib-core/responses").ActionResponse>;
-//#endregion
-export { appConfigRuntimeAction };
+import AioLogger from "@adobe/aio-lib-core-logging";

package/dist/cjs/management/index.cjs

@@ -13,7 +13,7 @@
  */
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_management = require('../management-Cvsz4VMf.cjs');
+const require_management = require('../management-Dehz9qSJ.cjs');
 
 exports.createInitialInstallationState = require_management.createInitialInstallationState;
 exports.createInitialUninstallationState = require_management.createInitialUninstallationState;

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

@@ -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-CKVE0aJi.cjs";
-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-Dw2NvVOY.cjs";
+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-B5gJ-q4U.cjs";
 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/cjs/{management-Cvsz4VMf.cjs → management-Dehz9qSJ.cjs}

@@ -13,18 +13,36 @@
  */
 
 const require_chunk = require('./chunk-Cozy-1ZF.cjs');
+const require_error = require('./error-D-N0PKSl.cjs');
 const require_webhooks = require('./webhooks-tbZy9G3p.cjs');
 const require_logging = require('./logging-BVz3weoC.cjs');
-const require_error = require('./error-D-N0PKSl.cjs');
+let _adobe_aio_commerce_lib_core_error = require("@adobe/aio-commerce-lib-core/error");
+let valibot = require("valibot");
+valibot = require_chunk.__toESM(valibot, 1);
 let _adobe_aio_commerce_lib_api_utils = require("@adobe/aio-commerce-lib-api/utils");
 let camelcase = require("camelcase");
 camelcase = require_chunk.__toESM(camelcase, 1);
+let _adobe_aio_commerce_lib_admin_ui_api = require("@adobe/aio-commerce-lib-admin-ui/api");
 let _adobe_aio_commerce_lib_api = require("@adobe/aio-commerce-lib-api");
 let _adobe_aio_commerce_lib_auth = require("@adobe/aio-commerce-lib-auth");
 let _adobe_aio_commerce_lib_events_commerce = require("@adobe/aio-commerce-lib-events/commerce");
 let _adobe_aio_commerce_lib_events_io_events = require("@adobe/aio-commerce-lib-events/io-events");
 let _adobe_aio_commerce_lib_webhooks_api = require("@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 = valibot.safeParse(schema, input);
+	if (!result.success) throw new _adobe_aio_commerce_lib_core_error.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) {
@@ -456,11 +474,37 @@ function aggregateSummary(result) {
 //#endregion
 //#region source/management/installation/custom-installation/custom-scripts.ts
 const camelcase$1 = camelcase.default.default ?? camelcase.default;
-function isCustomInstallationStepDefinition(obj) {
-	return typeof obj === "object" && obj !== null && "install" in obj && typeof obj.install === "function";
+const ScriptModuleSchema = valibot.union([valibot.function(), valibot.object({
+	install: valibot.function(),
+	uninstall: valibot.optional(valibot.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.");
+}
+/**
+* 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 isCustomInstallationStepHandler(obj) {
-	return typeof obj === "function";
+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.
@@ -478,15 +522,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,
@@ -497,14 +533,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;
@@ -611,34 +640,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 (0, _adobe_aio_commerce_lib_api_utils.unwrapHttpError)(error);
@@ -648,19 +683,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 (0, _adobe_aio_commerce_lib_admin_ui_api.createAdminUiApiClient)((0, _adobe_aio_commerce_lib_api.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 _adobe_aio_commerce_lib_api.AdobeCommerceHttpClient((0, _adobe_aio_commerce_lib_api.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: {
@@ -674,7 +712,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({