@adobe/aio-commerce-lib-app 2.0.0-beta-20260820174436 → 2.0.0

package/dist/cjs/config/index.node.d.cts

@@ -12,8 +12,9 @@
  * governing permissions and limitations under the License.
  */
 
-import { a as CommerceAppConfigSchemas, i as CommerceAppConfigDomain, n as CommerceAppConfig, o as getConfigDomains, r as CommerceAppConfigOutputModel, s as hasConfigDomain, t as AnyCommerceAppConfig } from "../app-Cf3EmtUh.cjs";
-import { t as defineConfig } from "../define-B-_oKmCe.cjs";
+import { a as CommerceAppConfigSchemas, i as CommerceAppConfigDomain, n as CommerceAppConfig, o as getConfigDomains, r as CommerceAppConfigOutputModel, s as hasConfigDomain, t as AnyCommerceAppConfig } from "../app-DwSqUkJA.cjs";
+import { n as hasCustomInstallationSteps, t as hasCustomInstallation } from "../installation-D72LoQ_1.cjs";
+import { t as defineConfig } from "../define-Cc3AaVmY.cjs";
 import { Get } from "type-fest";
 import * as v from "valibot";
 import "@adobe/aio-commerce-lib-config";
@@ -22,7 +23,7 @@ import "@adobe/aio-commerce-lib-config";
  * Check whether a commerce app config path uses a supported TypeScript format.
  * @param configFilePath The path to the config file.
  */
-declare function isTypeScriptConfig(configFilePath: string): boolean;
+export declare function isTypeScriptConfig(configFilePath: string): boolean;
 /**
  * Try to find (up to the nearest package.json file) the app config file.
  *
@@ -37,7 +38,7 @@ declare function isTypeScriptConfig(configFilePath: string): boolean;
  * @param cwd The current working directory
  * @returns The path to the config file, or null if not found
  */
-declare function resolveCommerceAppConfig(cwd?: string): Promise<string | null>;
+export declare function resolveCommerceAppConfig(cwd?: string): Promise<string | null>;
 /**
  * Read the commerce app config file as-is, without validating it.
  *
@@ -48,7 +49,7 @@ declare function resolveCommerceAppConfig(cwd?: string): Promise<string | null>;
  * @returns The raw config object from the file
  * @throws {Error} If no config file is found or if the file doesn't export a default export
  */
-declare function readCommerceAppConfig(cwd?: string): Promise<unknown>;
+export declare function readCommerceAppConfig(cwd?: string): Promise<unknown>;
 /**
  * Read the commerce app config file and parse its contents into its schema.
  *
@@ -59,8 +60,16 @@ declare function readCommerceAppConfig(cwd?: string): Promise<unknown>;
  * @returns The validated and parsed config object
  * @throws {Error} If no config file is found, if the file doesn't export a default export, or if validation fails
  */
-declare function parseCommerceAppConfig(cwd?: string): Promise<{
+export declare function parseCommerceAppConfig(cwd?: string): Promise<{
   adminUi?: {
+    acl?: {
+      children?: {
+        id: string;
+        label: string;
+      }[] | undefined;
+      id: string;
+      label: string;
+    }[] | undefined;
     customer?: {
       gridColumns?: {
         columns: {
@@ -528,7 +537,7 @@ declare function parseCommerceAppConfig(cwd?: string): Promise<{
  * }
  * ```
  */
-declare function validateCommerceAppConfig(config: unknown): CommerceAppConfigOutputModel;
+export declare function validateCommerceAppConfig(config: unknown): CommerceAppConfigOutputModel;
 /**
  * Validates a specific domain configuration within the commerce app config.
  *
@@ -571,7 +580,7 @@ declare function validateCommerceAppConfig(config: unknown): CommerceAppConfigOu
  * }
  * ```
  */
-declare function validateCommerceAppConfigDomain<T extends CommerceAppConfigDomain>(config: unknown, domain: T): NonNullable<Get<CommerceAppConfigOutputModel, T>>;
+export declare function validateCommerceAppConfigDomain<T extends CommerceAppConfigDomain>(config: unknown, domain: T): NonNullable<Get<CommerceAppConfigOutputModel, T>>;
 //#endregion
 //#region source/config/schema/admin-ui.d.ts
 declare const NotificationsSchema: v.ObjectSchema<{
@@ -598,7 +607,13 @@ declare const GridColumnsSchema: v.ObjectSchema<{
     id: string;
     label: string;
     type: "string" | "boolean" | "date" | "datetime" | "float" | "integer";
-  }[], 1, "At least one grid column is required">]>;
+  }[], 1, "At least one grid column is required">, v.CheckAction<{
+    aclProtected?: boolean | undefined;
+    align: "left" | "right" | "center";
+    id: string;
+    label: string;
+    type: "string" | "boolean" | "date" | "datetime" | "float" | "integer";
+  }[], "Grid column ids must be unique after Commerce id sanitization.">]>;
   readonly description: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
   readonly label: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
   readonly runtimeAction: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
@@ -737,9 +752,44 @@ declare const MenuSchema: v.ObjectSchema<{
 }, undefined>;
 /**
  * Schema for the `adminUi` config section.
- * Supports grid column extensions, mass actions, order view buttons, and menu on `commerce/backend-ui/2`.
+ * Supports grid column extensions, mass actions, order view buttons, menu, and custom ACL resources on `commerce/backend-ui/2`.
  */
 declare const AdminUiSchema: v.ObjectSchema<{
+  readonly acl: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.StrictObjectSchema<{
+    readonly children: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.StrictObjectSchema<{
+      readonly id: 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.RegexAction<string, "ACL resource ID may contain only lowercase letters, digits, and \"_\"">]>;
+      readonly label: 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.MinLengthAction<string, 3, "acl resource label must be at least 3 characters">, v.MaxLengthAction<string, 50, "acl resource label must be at most 50 characters">]>;
+    }, undefined>, undefined>, v.MinLengthAction<{
+      id: string;
+      label: string;
+    }[], 1, "An ACL resource group must contain at least one child">, v.CheckAction<{
+      id: string;
+      label: string;
+    }[], "Child ACL resource ids must be unique within a group.">]>, undefined>;
+    readonly id: 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.RegexAction<string, "ACL resource ID may contain only lowercase letters, digits, and \"_\"">]>;
+    readonly label: 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.MinLengthAction<string, 3, "acl resource label must be at least 3 characters">, v.MaxLengthAction<string, 50, "acl resource label must be at most 50 characters">]>;
+  }, undefined>, undefined>, v.MinLengthAction<{
+    children?: {
+      id: string;
+      label: string;
+    }[] | undefined;
+    id: string;
+    label: string;
+  }[], 1, "At least one ACL resource is required when acl is defined">, v.CheckAction<{
+    children?: {
+      id: string;
+      label: string;
+    }[] | undefined;
+    id: string;
+    label: string;
+  }[], "Top-level ACL resource ids must be unique.">, v.CheckAction<{
+    children?: {
+      id: string;
+      label: string;
+    }[] | undefined;
+    id: string;
+    label: string;
+  }[], "Custom ACL resource ids must stay unique after Commerce derivation: a top-level resource id must not equal a group's \"<group>_<child>\" combination.">]>, undefined>;
   readonly customer: v.OptionalSchema<v.ObjectSchema<{
     readonly gridColumns: v.OptionalSchema<v.ObjectSchema<{
       readonly columns: v.SchemaWithPipe<readonly [v.ArraySchema<v.StrictObjectSchema<{
@@ -754,7 +804,13 @@ declare const AdminUiSchema: v.ObjectSchema<{
         id: string;
         label: string;
         type: "string" | "boolean" | "date" | "datetime" | "float" | "integer";
-      }[], 1, "At least one grid column is required">]>;
+      }[], 1, "At least one grid column is required">, v.CheckAction<{
+        aclProtected?: boolean | undefined;
+        align: "left" | "right" | "center";
+        id: string;
+        label: string;
+        type: "string" | "boolean" | "date" | "datetime" | "float" | "integer";
+      }[], "Grid column ids must be unique after Commerce id sanitization.">]>;
       readonly description: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
       readonly label: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
       readonly runtimeAction: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
@@ -831,7 +887,7 @@ declare const AdminUiSchema: v.ObjectSchema<{
       } | undefined;
       selectionLimit?: number | undefined;
       title?: string | undefined;
-    })[], "Mass action ids must be unique.">]>, undefined>;
+    })[], "Mass action ids must be unique after Commerce id sanitization.">]>, undefined>;
   }, undefined>, undefined>;
   readonly menu: v.OptionalSchema<v.ObjectSchema<{
     /**
@@ -861,7 +917,13 @@ declare const AdminUiSchema: v.ObjectSchema<{
         id: string;
         label: string;
         type: "string" | "boolean" | "date" | "datetime" | "float" | "integer";
-      }[], 1, "At least one grid column is required">]>;
+      }[], 1, "At least one grid column is required">, v.CheckAction<{
+        aclProtected?: boolean | undefined;
+        align: "left" | "right" | "center";
+        id: string;
+        label: string;
+        type: "string" | "boolean" | "date" | "datetime" | "float" | "integer";
+      }[], "Grid column ids must be unique after Commerce id sanitization.">]>;
       readonly description: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
       readonly label: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
       readonly runtimeAction: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
@@ -938,7 +1000,7 @@ declare const AdminUiSchema: v.ObjectSchema<{
       } | undefined;
       selectionLimit?: number | undefined;
       title?: string | undefined;
-    })[], "Mass action ids must be unique.">]>, undefined>;
+    })[], "Mass action ids must be unique after Commerce id sanitization.">]>, undefined>;
     readonly viewButtons: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.VariantSchema<"type", [v.StrictObjectSchema<{
       readonly aclProtected: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
       readonly confirm: v.OptionalSchema<v.ObjectSchema<{
@@ -1011,7 +1073,7 @@ declare const AdminUiSchema: v.ObjectSchema<{
       sortOrder?: number | undefined;
       timeout?: number | undefined;
       type: "worker";
-    })[], "Order view button ids must be unique.">]>, undefined>;
+    })[], "Order view button ids must be unique after Commerce id sanitization.">]>, undefined>;
   }, undefined>, undefined>;
   readonly product: v.OptionalSchema<v.ObjectSchema<{
     readonly gridColumns: v.OptionalSchema<v.ObjectSchema<{
@@ -1027,7 +1089,13 @@ declare const AdminUiSchema: v.ObjectSchema<{
         id: string;
         label: string;
         type: "string" | "boolean" | "date" | "datetime" | "float" | "integer";
-      }[], 1, "At least one grid column is required">]>;
+      }[], 1, "At least one grid column is required">, v.CheckAction<{
+        aclProtected?: boolean | undefined;
+        align: "left" | "right" | "center";
+        id: string;
+        label: string;
+        type: "string" | "boolean" | "date" | "datetime" | "float" | "integer";
+      }[], "Grid column ids must be unique after Commerce id sanitization.">]>;
       readonly description: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
       readonly label: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
       readonly runtimeAction: v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>;
@@ -1104,7 +1172,7 @@ declare const AdminUiSchema: v.ObjectSchema<{
       } | undefined;
       selectionLimit?: number | undefined;
       title?: string | undefined;
-    })[], "Mass action ids must be unique.">]>, undefined>;
+    })[], "Mass action ids must be unique after Commerce id sanitization.">]>, undefined>;
   }, undefined>, undefined>;
 }, undefined>;
 /**
@@ -1149,12 +1217,20 @@ type Menu = v.InferInput<typeof MenuSchema>;
 type AdminUiConfig<T extends AnyCommerceAppConfig = CommerceAppConfigOutputModel> = T & {
   adminUi: NonNullable<T["adminUi"]>;
 };
+/**
+ * Check whether the config declares an Admin UI component that requires the
+ * `commerce/backend-ui/2` extension point — a menu, grid columns, mass actions,
+ * or view buttons. Custom ACL resources are deliberately excluded: they reach
+ * Commerce through the `extensibility/1` app-config payload, not backend-ui/2,
+ * so an acl-only config needs no backend-ui/2 registration.
+ */
+export declare function hasBackendUiV2Components<T extends AnyCommerceAppConfig>(config: T): config is AdminUiConfig<T>;
 /**
  * Check whether the config declares at least one Admin UI component (menu, grid
- * columns, mass actions, or view buttons). A component-less `adminUi` block is
+ * columns, mass actions, view buttons, or custom ACL resources). A component-less `adminUi` block is
  * treated as absent — it registers nothing.
  */
-declare function hasAdminUi<T extends AnyCommerceAppConfig>(config: T): config is AdminUiConfig<T>;
+export declare function hasAdminUi<T extends AnyCommerceAppConfig>(config: T): config is AdminUiConfig<T>;
 //#endregion
 //#region source/config/schema/business-configuration.d.ts
 /** Config type when business config is present. */
@@ -1171,12 +1247,12 @@ type AppConfigWithBusinessConfigSchema<T extends AnyCommerceAppConfig> = T & {
  * Check if config has business config.
  * @param config - The configuration to check.
  */
-declare function hasBusinessConfig<T extends AnyCommerceAppConfig>(config: T): config is T & AppConfigWithBusinessConfig<T>;
+export declare function hasBusinessConfig<T extends AnyCommerceAppConfig>(config: T): config is T & AppConfigWithBusinessConfig<T>;
 /**
  * Check if config has business config schema.
  * @param config - The configuration to check.
  */
-declare function hasBusinessConfigSchema<T extends AnyCommerceAppConfig>(config: T): config is T & AppConfigWithBusinessConfigSchema<T>;
+export declare function hasBusinessConfigSchema<T extends AnyCommerceAppConfig>(config: T): config is T & AppConfigWithBusinessConfigSchema<T>;
 //#endregion
 //#region source/config/schema/eventing.d.ts
 /** Schema for event provider configuration */
@@ -1491,39 +1567,17 @@ type ExternalEventsConfig<T extends AnyCommerceAppConfig = CommerceAppConfigOutp
  * Check if config has commerce event sources.
  * @param config - The configuration to check.
  */
-declare function hasCommerceEvents<T extends AnyCommerceAppConfig>(config: T): config is T & CommerceEventsConfig<T>;
+export declare function hasCommerceEvents<T extends AnyCommerceAppConfig>(config: T): config is T & CommerceEventsConfig<T>;
 /**
  * Check if config has external event sources.
  * @param config - The configuration to check.
  */
-declare function hasExternalEvents<T extends AnyCommerceAppConfig>(config: T): config is T & ExternalEventsConfig<T>;
+export declare function hasExternalEvents<T extends AnyCommerceAppConfig>(config: T): config is T & ExternalEventsConfig<T>;
 /**
  * Check if config has any eventing configuration.
  * @param config - The configuration to check.
  */
-declare function hasEventing<T extends AnyCommerceAppConfig>(config: T): config is T & EventsConfig<T>;
-//#endregion
-//#region source/config/schema/installation.d.ts
-/** Config type when installation settings are present. */
-type InstallationConfig<T extends AnyCommerceAppConfig = CommerceAppConfigOutputModel> = T & {
-  installation: NonNullable<T["installation"]>;
-};
-/** Config type when custom installation steps are present. */
-type ConfigWithInstallationSteps<T extends AnyCommerceAppConfig = CommerceAppConfigOutputModel> = InstallationConfig<T> & {
-  installation: InstallationConfig<T>["installation"] & {
-    customInstallationSteps: NonNullable<InstallationConfig<T>["installation"]["customInstallationSteps"]>;
-  };
-};
-/**
- * Check if config has custom installation settings.
- * @param config - The configuration to check.
- */
-declare function hasCustomInstallation<T extends AnyCommerceAppConfig>(config: T): config is T & InstallationConfig<T>;
-/**
- * Check if config has custom installation steps.
- * @param config - The configuration to check.
- */
-declare function hasCustomInstallationSteps<T extends AnyCommerceAppConfig>(config: T): config is T & ConfigWithInstallationSteps<T>;
+export declare function hasEventing<T extends AnyCommerceAppConfig>(config: T): config is T & EventsConfig<T>;
 //#endregion
 //#region source/config/schema/metadata.d.ts
 /** The schema for the metadata of the application. */
@@ -1531,7 +1585,7 @@ declare const MetadataSchema: v.ObjectSchema<{
   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 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 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 upgradeMode: v.OptionalSchema<v.PicklistSchema<["auto", "manual"], undefined>, "auto">;
+  readonly upgradeMode: v.OptionalSchema<v.PicklistSchema<["auto", "manual"], undefined>, "manual">;
   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')">]>;
 }, undefined>;
 /** The metadata associated to an Adobe Commerce application. */
@@ -1544,7 +1598,7 @@ type AppConfigWithMetadata<T extends AnyCommerceAppConfig> = T & {
  * Check if config has metadata.
  * @param config - The configuration to check.
  */
-declare function hasMetadata<T extends AnyCommerceAppConfig>(config: T): config is T & AppConfigWithMetadata<T>;
+export declare function hasMetadata<T extends AnyCommerceAppConfig>(config: T): config is T & AppConfigWithMetadata<T>;
 //#endregion
 //#region source/config/schema/webhooks.d.ts
 /** Schema for webhook field configuration (name and optional source). */
@@ -1845,6 +1899,6 @@ type WebhooksConfig<T extends AnyCommerceAppConfig = CommerceAppConfigOutputMode
  * Check if config has webhooks (non-empty array).
  * @param config - The configuration to check.
  */
-declare function hasWebhooks<T extends AnyCommerceAppConfig>(config: T): config is T & WebhooksConfig<T>;
+export declare function hasWebhooks<T extends AnyCommerceAppConfig>(config: T): config is T & WebhooksConfig<T>;
 //#endregion
-export { type AdminUiConfig, type AdminUiConfiguration, type AppConfigWithBusinessConfig, type AppConfigWithBusinessConfigSchema, type AppEvent, type ApplicationMetadata, type CommerceAppConfig, type CommerceAppConfigDomain, CommerceAppConfigSchemas, type CommerceEvent, type CommerceEventSource, type CommerceEventSourceSchema, type CommerceEventsConfig, type EventProvider, type EventingConfiguration, type EventingSchema, type EventsConfig, type ExternalEvent, type ExternalEventSource, type ExternalEventSourceSchema, type ExternalEventsConfig, type GridColumn, type GridColumns, type MassAction, type Menu, type Notifications, type OrderViewButton, type ViewMassAction, type WebhookDefinition, type WebhookEntry, type WebhookField, type WebhookHeader, type WebhookRule, type WebhooksConfig, type WebhooksConfiguration, type WebhooksSchema, type WorkerMassAction, defineConfig, getConfigDomains, hasAdminUi, hasBusinessConfig, hasBusinessConfigSchema, hasCommerceEvents, hasConfigDomain, hasCustomInstallation, hasCustomInstallationSteps, hasEventing, hasExternalEvents, hasMetadata, hasWebhooks, isTypeScriptConfig, parseCommerceAppConfig, readCommerceAppConfig, resolveCommerceAppConfig, validateCommerceAppConfig, validateCommerceAppConfigDomain };
+export { type AdminUiConfig, type AdminUiConfiguration, type AppConfigWithBusinessConfig, type AppConfigWithBusinessConfigSchema, type AppEvent, type ApplicationMetadata, type CommerceAppConfig, type CommerceAppConfigDomain, CommerceAppConfigSchemas, type CommerceEvent, type CommerceEventSource, type CommerceEventSourceSchema, type CommerceEventsConfig, type EventProvider, type EventingConfiguration, type EventingSchema, type EventsConfig, type ExternalEvent, type ExternalEventSource, type ExternalEventSourceSchema, type ExternalEventsConfig, type GridColumn, type GridColumns, type MassAction, type Menu, type Notifications, type OrderViewButton, type ViewMassAction, type WebhookDefinition, type WebhookEntry, type WebhookField, type WebhookHeader, type WebhookRule, type WebhooksConfig, type WebhooksConfiguration, type WebhooksSchema, type WorkerMassAction, defineConfig, getConfigDomains, hasConfigDomain, hasCustomInstallation, hasCustomInstallationSteps };

package/dist/{es/define-DSU8Kgu0.d.mts → cjs/define-Cc3AaVmY.d.cts}

@@ -12,7 +12,7 @@
  * governing permissions and limitations under the License.
  */
 
-import { n as CommerceAppConfig } from "./app-Cf3EmtUh.mjs";
+import { n as CommerceAppConfig } from "./app-DwSqUkJA.cjs";
 //#region source/config/lib/define.d.ts
 /**
  * Helper to type-safely define the app config.

package/dist/{es/index-COLnI6Ok.d.mts → cjs/index-C7dqTDHu.d.cts}

@@ -12,10 +12,11 @@
  * governing permissions and limitations under the License.
  */
 
-import { r as CommerceAppConfigOutputModel } from "./app-Cf3EmtUh.mjs";
-import * as v from "valibot";
-import AioLogger from "@adobe/aio-lib-core-logging";
+import { r as CommerceAppConfigOutputModel } from "./app-DwSqUkJA.cjs";
+import "./installation-D72LoQ_1.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/common/schema.d.ts
 /** Schema for validating the Adobe I/O app credentials used across lifecycle workflows. */
 declare const AppDataSchema: v.ObjectSchema<{
@@ -625,6 +626,19 @@ type ValidateStepTreeOptions = {
  */
 declare function validateStepTree(options: ValidateStepTreeOptions): Promise<ValidationResult>;
 //#endregion
+//#region source/management/domains/custom-installation/types.d.ts
+/**
+ * Identity of a custom installation step that has run at least once, as persisted across
+ * upgrades. `name` is the step's stable identity; `script` records the path that ran, so a step
+ * removed from the config can still be resolved and uninstalled later.
+ */
+type CustomInstallationStepIdentity = {
+  /** Matches `installation.customInstallationSteps[].name`. */
+  name: string;
+  /** The script path this step pointed to when it last (successfully) ran. */
+  script: string;
+};
+//#endregion
 //#region source/management/domains/custom-installation/define.d.ts
 /**
  * Handler function type for custom installation steps.
@@ -723,6 +737,12 @@ declare function runInstallation(options: RunInstallationOptions): Promise<Succe
 type CreateInitialUninstallationStateOptions = {
   /** The app configuration used to determine applicable steps. */
   config: CommerceAppConfigOutputModel;
+  /**
+   * Persisted history of every custom installation step that ever ran, from the lifecycle
+   * baseline snapshot. Lets a full unassociate reach steps removed from `config` in a previous
+   * upgrade. Defaults to `[]` when there is no recorded history (e.g. legacy installs).
+   */
+  executedCustomInstallationSteps?: readonly CustomInstallationStepIdentity[];
 };
 /** Options for running an uninstallation. */
 type RunUninstallationOptions = {
@@ -734,6 +754,8 @@ type RunUninstallationOptions = {
   initialState: InProgressWorkflowState;
   /** Lifecycle hooks for status change notifications. */
   hooks?: InstallationHooks;
+  /** Same as {@link CreateInitialUninstallationStateOptions.executedCustomInstallationSteps}. */
+  executedCustomInstallationSteps?: readonly CustomInstallationStepIdentity[];
 };
 /**
  * Creates an initial uninstallation state from the config and step definitions.

package/dist/cjs/index.d.cts

@@ -46,7 +46,7 @@ type AssociatedCommerceData = {
  * }
  * ```
  */
-declare function getCommerceInstance(): Promise<AssociatedCommerceData>;
+export declare function getCommerceInstance(): Promise<AssociatedCommerceData>;
 /**
  * Returns an initialised `AdobeCommerceHttpClient` for the Commerce instance
  * this app is currently associated with.
@@ -72,7 +72,7 @@ declare function getCommerceInstance(): Promise<AssociatedCommerceData>;
  * }
  * ```
  */
-declare function getCommerceClient(auth: ImsAuthParams | ImsAuthProvider, fetchOptions?: CommerceHttpClientParams["fetchOptions"]): Promise<AdobeCommerceHttpClient>;
+export declare function getCommerceClient(auth: ImsAuthParams | ImsAuthProvider, fetchOptions?: CommerceHttpClientParams["fetchOptions"]): Promise<AdobeCommerceHttpClient>;
 //#endregion
 //#region source/lib/errors.d.ts
 /**
@@ -99,14 +99,14 @@ declare function getCommerceClient(auth: ImsAuthParams | ImsAuthProvider, fetchO
  * }
  * ```
  */
-declare class AssociationRecordNotFoundError extends CommerceSdkErrorBase {
+export declare class AssociationRecordNotFoundError extends CommerceSdkErrorBase {
   constructor(message?: string, options?: CommerceSdkErrorBaseOptions);
 }
 /**
  * Base error thrown by {@link publishEvent} when event resolution or publishing fails.
  * Catch this to handle all publish-event failures in a single clause.
  */
-declare class PublishEventError extends CommerceSdkErrorBase {}
+export declare class PublishEventError extends CommerceSdkErrorBase {}
 /**
  * Thrown when {@link publishEvent} cannot find the eventing installation data in system storage.
  *
@@ -124,7 +124,7 @@ declare class PublishEventError extends CommerceSdkErrorBase {}
  * }
  * ```
  */
-declare class EventsDataNotInitializedError extends PublishEventError {
+export declare class EventsDataNotInitializedError extends PublishEventError {
   constructor(options?: CommerceSdkErrorBaseOptions);
 }
 /**
@@ -142,7 +142,7 @@ declare class EventsDataNotInitializedError extends PublishEventError {
  * }
  * ```
  */
-declare class ProviderNotFoundError extends PublishEventError {
+export declare class ProviderNotFoundError extends PublishEventError {
   constructor(providerKey: string, options?: CommerceSdkErrorBaseOptions);
 }
 /**
@@ -160,7 +160,7 @@ declare class ProviderNotFoundError extends PublishEventError {
  * }
  * ```
  */
-declare class EventNotFoundError extends PublishEventError {
+export declare class EventNotFoundError extends PublishEventError {
   constructor(eventName: string, providerKey: string, options?: CommerceSdkErrorBaseOptions);
 }
 //#endregion
@@ -202,7 +202,7 @@ declare class EventNotFoundError extends PublishEventError {
  * }
  * ```
  */
-declare function publishEvent<TPayload extends Record<string, unknown> = Record<string, unknown>>(params: {
+export declare function publishEvent<TPayload extends Record<string, unknown> = Record<string, unknown>>(params: {
   client: AdobeIoEventsApiClient;
   provider: string;
   event: string;
@@ -226,6 +226,6 @@ declare function publishEvent<TPayload extends Record<string, unknown> = Record<
  * // => "my_app.webhook.received"
  * ```
  */
-declare function resolveIoEventCode(appId: string, eventName: string, providerType: "commerce" | "external"): string;
+export declare function resolveIoEventCode(appId: string, eventName: string, providerType: "commerce" | "external"): string;
 //#endregion
-export { type AssociatedCommerceData, AssociationRecordNotFoundError, EventNotFoundError, EventsDataNotInitializedError, ProviderNotFoundError, PublishEventError, getCommerceClient, getCommerceInstance, publishEvent, resolveIoEventCode };
+export type { AssociatedCommerceData };

package/dist/cjs/{index.node-CXeIG8SS.cjs → index.node-vcOo1rt0.cjs}

@@ -14,7 +14,7 @@
 
 const require_rolldown_runtime = require('./rolldown-runtime-CDQd2xEI.cjs');
 const require_error = require('./error-D-N0PKSl.cjs');
-const require_validate = require('./validate-Dff0nrqM.cjs');
+const require_validate = require('./validate-CwWYtRsS.cjs');
 let fs = require("fs");
 let fs_promises = require("fs/promises");
 let path = require("path");

package/dist/cjs/installation-D72LoQ_1.d.cts

@@ -0,0 +1,39 @@
+/**
+ * @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 { r as CommerceAppConfigOutputModel, t as AnyCommerceAppConfig } from "./app-DwSqUkJA.cjs";
+import "valibot";
+//#region source/config/schema/installation.d.ts
+/** Config type when installation settings are present. */
+type InstallationConfig<T extends AnyCommerceAppConfig = CommerceAppConfigOutputModel> = T & {
+  installation: NonNullable<T["installation"]>;
+};
+/** Config type when custom installation steps are present. */
+type ConfigWithInstallationSteps<T extends AnyCommerceAppConfig = CommerceAppConfigOutputModel> = InstallationConfig<T> & {
+  installation: InstallationConfig<T>["installation"] & {
+    customInstallationSteps: NonNullable<InstallationConfig<T>["installation"]["customInstallationSteps"]>;
+  };
+};
+/**
+ * Check if config has custom installation settings.
+ * @param config - The configuration to check.
+ */
+declare function hasCustomInstallation<T extends AnyCommerceAppConfig>(config: T): config is T & InstallationConfig<T>;
+/**
+ * Check if config has custom installation steps.
+ * @param config - The configuration to check.
+ */
+declare function hasCustomInstallationSteps<T extends AnyCommerceAppConfig>(config: T): config is T & ConfigWithInstallationSteps<T>;
+//#endregion
+export { hasCustomInstallationSteps as n, hasCustomInstallation as t };

package/dist/cjs/management/index.cjs

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

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

@@ -12,5 +12,5 @@
  * governing permissions and limitations under the License.
  */
 
-import { $ as ValidationContext, A as createRetryState, B as WorkflowHooks, C as defineCustomInstallationStep, D as ValidationSummary, E as ValidationResult, F as executePlannedWorkflow, G as InferStepOutput, H as BranchStep, I as StepEvent, J as LifecycleContext, K as LeafStep, L as StepFailedEvent, M as executeWorkflow, N as planWorkflow, O as validateStepTree, P as createInitialPlanExecutionState, Q as StepMetaInfo, R as StepStartedEvent, S as CustomInstallationStepHandler, T as ValidateStepTreeOptions, U as BranchStepOptions, V as AnyStep, W as ExecutionContext, X as StepContextFactory, Y as Step, Z as StepMeta, _ as createInitialUninstallationState, _t as isFailedState, a as InstallationError, at as isBranchStep, b as runValidation, c as InstallationStatus, ct as FailedWorkflowState, d as CreateInitialUninstallationStateOptions, dt as SucceededWorkflowState, et as ValidationExecutionContext, f as InstallationHooks, ft as WorkflowData, g as createInitialInstallationState, gt as isCompletedState, h as RunValidationOptions, ht as WorkflowStateMetadata, i as InstallationData, it as defineLeafStep, j as executeUninstallWorkflow, k as createInitialState, l as SucceededInstallationState, lt as InProgressWorkflowState, m as RunUninstallationOptions, mt as WorkflowRunState, n as InProgressInstallationState, nt as ValidationIssueSeverity, o as InstallationRetryMetadata, ot as isLeafStep, p as RunInstallationOptions, pt as WorkflowError, q as LeafStepOptions, r as InstallationContext, rt as defineBranchStep, s as InstallationState, st as ExecutionStatus, t as FailedInstallationState, tt as ValidationIssue, u as CreateInitialInstallationStateOptions, ut as StepStatus, v as runInstallation, vt as isInProgressState, w as StepValidationResult, x as CustomInstallationStepDefinition, y as runUninstallation, yt as isSucceededState, z as StepSucceededEvent } from "../index-CkwCGvut.cjs";
+import { $ as ValidationContext, A as createRetryState, B as WorkflowHooks, C as defineCustomInstallationStep, D as ValidationSummary, E as ValidationResult, F as executePlannedWorkflow, G as InferStepOutput, H as BranchStep, I as StepEvent, J as LifecycleContext, K as LeafStep, L as StepFailedEvent, M as executeWorkflow, N as planWorkflow, O as validateStepTree, P as createInitialPlanExecutionState, Q as StepMetaInfo, R as StepStartedEvent, S as CustomInstallationStepHandler, T as ValidateStepTreeOptions, U as BranchStepOptions, V as AnyStep, W as ExecutionContext, X as StepContextFactory, Y as Step, Z as StepMeta, _ as createInitialUninstallationState, _t as isFailedState, a as InstallationError, at as isBranchStep, b as runValidation, c as InstallationStatus, ct as FailedWorkflowState, d as CreateInitialUninstallationStateOptions, dt as SucceededWorkflowState, et as ValidationExecutionContext, f as InstallationHooks, ft as WorkflowData, g as createInitialInstallationState, gt as isCompletedState, h as RunValidationOptions, ht as WorkflowStateMetadata, i as InstallationData, it as defineLeafStep, j as executeUninstallWorkflow, k as createInitialState, l as SucceededInstallationState, lt as InProgressWorkflowState, m as RunUninstallationOptions, mt as WorkflowRunState, n as InProgressInstallationState, nt as ValidationIssueSeverity, o as InstallationRetryMetadata, ot as isLeafStep, p as RunInstallationOptions, pt as WorkflowError, q as LeafStepOptions, r as InstallationContext, rt as defineBranchStep, s as InstallationState, st as ExecutionStatus, t as FailedInstallationState, tt as ValidationIssue, u as CreateInitialInstallationStateOptions, ut as StepStatus, v as runInstallation, vt as isInProgressState, w as StepValidationResult, x as CustomInstallationStepDefinition, y as runUninstallation, yt as isSucceededState, z as StepSucceededEvent } from "../index-C7dqTDHu.cjs";
 export { type AnyStep, type BranchStep, type BranchStepOptions, type CreateInitialInstallationStateOptions, type CreateInitialUninstallationStateOptions, type CustomInstallationStepDefinition, type CustomInstallationStepHandler, type ExecutionContext, type ExecutionStatus, type FailedInstallationState, type FailedWorkflowState, type InProgressInstallationState, type InProgressWorkflowState, type InferStepOutput, type InstallationContext, type InstallationData, type InstallationError, type InstallationHooks, type InstallationRetryMetadata, type InstallationState, type InstallationStatus, type LeafStep, type LeafStepOptions, type LifecycleContext, 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 SucceededWorkflowState, type ValidateStepTreeOptions, type ValidationContext, type ValidationExecutionContext, type ValidationIssue, type ValidationIssueSeverity, type ValidationResult, type ValidationSummary, type WorkflowData, type WorkflowError, type WorkflowHooks, type WorkflowRunState, type WorkflowStateMetadata, createInitialInstallationState, type createInitialPlanExecutionState, type createInitialState, createInitialUninstallationState, type createRetryState, type defineBranchStep, defineCustomInstallationStep, type defineLeafStep, type executePlannedWorkflow, type executeUninstallWorkflow, type executeWorkflow, type isBranchStep, isCompletedState, isFailedState, isInProgressState, type isLeafStep, isSucceededState, type planWorkflow, runInstallation, runUninstallation, runValidation, type validateStepTree };