@adobe/aio-commerce-lib-app 0.3.2 → 1.0.1

package/dist/es/config/index.mjs

@@ -1,4 +1,5 @@
-import { a as hasExternalEvents, c as hasCustomInstallationSteps, i as hasEventing, r as hasCommerceEvents, s as hasCustomInstallation } from "../error-P7JgUTds.mjs";
-import { a as validateCommerceAppConfigDomain, c as hasConfigDomain, d as hasBusinessConfigSchema, i as validateCommerceAppConfig, l as hasMetadata, n as readCommerceAppConfig, o as CommerceAppConfigSchemas, r as resolveCommerceAppConfig, s as getConfigDomains, t as parseCommerceAppConfig, u as hasBusinessConfig, v as defineConfig } from "../config-BSGerqCG.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-DKnju9-R.mjs";
+import { a as hasCommerceEvents, n as hasCustomInstallation, o as hasEventing, r as hasCustomInstallationSteps, s as hasExternalEvents } from "../installation-BTL9X7iv.mjs";
+import { d as defineConfig, n as readCommerceAppConfig, r as resolveCommerceAppConfig, t as parseCommerceAppConfig } from "../parser-CQZTVG6i.mjs";
 
 export { CommerceAppConfigSchemas, defineConfig, getConfigDomains, hasBusinessConfig, hasBusinessConfigSchema, hasCommerceEvents, hasConfigDomain, hasCustomInstallation, hasCustomInstallationSteps, hasEventing, hasExternalEvents, hasMetadata, parseCommerceAppConfig, readCommerceAppConfig, resolveCommerceAppConfig, validateCommerceAppConfig, validateCommerceAppConfigDomain };

package/dist/es/error-CMV3IjBz.mjs

@@ -0,0 +1,18 @@
+import { CommerceSdkValidationError } from "@adobe/aio-commerce-lib-core/error";
+
+//#region ../../packages-private/scripting-utils/source/error.ts
+/**
+* This module exports shared error utilities for the AIO Commerce SDK.
+* @packageDocumentation
+*/
+/**
+* Stringify an error to a human-friendly string.
+* @param error - The error to stringify.
+*/
+function stringifyError(error) {
+	if (error instanceof CommerceSdkValidationError) return error.display();
+	return error instanceof Error ? error.message : String(error);
+}
+
+//#endregion
+export { stringifyError as t };

package/dist/es/{error-P7JgUTds.mjs → installation-BTL9X7iv.mjs}

@@ -1,122 +1,24 @@
+import { i as stringValueSchema, n as booleanValueSchema, r as nonEmptyStringValueSchema, t as alphaNumericOrHyphenSchema } from "./schemas-B8yIv0_b.mjs";
 import * as v from "valibot";
-import { CommerceSdkValidationError } from "@adobe/aio-commerce-lib-core/error";
 
-//#region ../../packages-private/common-utils/source/valibot/schemas.ts
-const ALPHANUMERIC_OR_UNDERSCORE_REGEX = {
-	any: /^[a-zA-Z0-9_]+$/,
-	lowercase: /^[a-z0-9_]+$/,
-	uppercase: /^[A-Z0-9_]+$/
-};
-const ALPHANUMERIC_OR_HYPHEN_REGEX = {
-	any: /^[a-zA-Z0-9-]+$/,
-	lowercase: /^[a-z0-9-]+$/,
-	uppercase: /^[A-Z0-9-]+$/
-};
-/**
-* A schema for a string value.
-* @param name The name of the field this schema refers to.
-*/
-function stringValueSchema(name) {
-	return v.string(`Expected a string value for '${name}'`);
-}
-/**
-* A schema for a non-empty string value.
-* @param name The name of the field this schema refers to.
-*/
-function nonEmptyStringValueSchema(name) {
-	return v.pipe(stringValueSchema(name), v.nonEmpty(`The value of "${name}" must not be empty`));
-}
-/**
-* A schema for a boolean value.
-* @param name The name of the field this schema refers to.
-*/
-function booleanValueSchema(name) {
-	return v.boolean(`Expected a boolean value for '${name}'`);
-}
-/**
-* A schema for a string that only contains alphanumeric characters and underscores.
-* @param name The name of the field this schema refers to.
-* @param casing The allowed casing for the string (default: "any").
-*/
-function alphaNumericOrUnderscoreSchema(name, casing = "any") {
-	const casingLabel = casing === "any" ? "" : ` (${casing} only)`;
-	return v.pipe(stringValueSchema(name), v.regex(ALPHANUMERIC_OR_UNDERSCORE_REGEX[casing], `Only alphanumeric characters and underscores are allowed in string value of "${name}"${casingLabel}`));
-}
-/**
-* A schema for a string that only contains alphanumeric characters and hyphens.
-* @param name The name of the field this schema refers to.
-* @param casing The allowed casing for the string (default: "any").
-*/
-function alphaNumericOrHyphenSchema(name, casing = "any") {
-	const casingLabel = casing === "any" ? "" : ` (${casing} only)`;
-	return v.pipe(stringValueSchema(name), v.regex(ALPHANUMERIC_OR_HYPHEN_REGEX[casing], `Only alphanumeric characters and hyphens are allowed in string value of "${name}"${casingLabel}`));
-}
-
-//#endregion
-//#region source/config/schema/installation.ts
-const MAX_DESCRIPTION_LENGTH$1 = 255;
-const MAX_NAME_LENGTH = 255;
-const MAX_MESSAGE_LENGTH = 1e3;
-/**
-* Regex for script paths that can be relative or absolute.
-* Must end with .js extension
-* Examples:
-*   - "./scripts/setup.js"
-*   - "./setup.js"
-*   - "../../scripts/setup.js"
-*/
-const SCRIPT_PATH_REGEX = /^(?:\.{0,2}\/)*[\w-/]*[\w-]+\.js$/;
-/**
-* Schema for custom installation step configuration
-*/
-const CustomInstallationStepSchema = v.object({
-	script: v.pipe(nonEmptyStringValueSchema("script path"), v.regex(SCRIPT_PATH_REGEX, "Script path must end with .js (e.g., \"./setup.js\", \"./scripts/setup.js\", or \"../../scripts/setup.js\")")),
-	name: v.pipe(nonEmptyStringValueSchema("step name"), v.maxLength(MAX_NAME_LENGTH, `The step name must not be longer than ${MAX_NAME_LENGTH} characters`)),
-	description: v.pipe(nonEmptyStringValueSchema("step description"), v.maxLength(MAX_DESCRIPTION_LENGTH$1, `The step description must not be longer than ${MAX_DESCRIPTION_LENGTH$1} characters`))
-});
-/**
-* Schema for installation messages configuration
-*/
-const MessagesSchema = v.object({
-	preInstallation: v.optional(v.pipe(nonEmptyStringValueSchema("preInstallation message"), v.maxLength(MAX_MESSAGE_LENGTH, `The preInstallation message must not be longer than ${MAX_MESSAGE_LENGTH} characters`))),
-	postInstallation: v.optional(v.pipe(nonEmptyStringValueSchema("postInstallation message"), v.maxLength(MAX_MESSAGE_LENGTH, `The postInstallation message must not be longer than ${MAX_MESSAGE_LENGTH} characters`)))
-});
-/**
-* Schema for installation configuration
-*/
-const InstallationSchema = v.object({
-	messages: v.optional(MessagesSchema),
-	customInstallationSteps: v.pipe(v.optional(v.array(CustomInstallationStepSchema, "Expected an array of custom installation steps")), v.check((input) => {
-		const steps = input || [];
-		return new Set(steps.map((step) => step.name)).size === steps.length;
-	}, "Duplicate step names detected in custom installation steps. Each step must have a unique name."))
-});
-/**
-* Check if config has custom installation settings.
-* @param config - The configuration to check.
-*/
-function hasCustomInstallation(config) {
-	return config.installation !== void 0;
-}
-/**
-* Check if config has custom installation steps.
-* @param config - The configuration to check.
-*/
-function hasCustomInstallationSteps(config) {
-	return Array.isArray(config?.installation?.customInstallationSteps) && config.installation.customInstallationSteps.length > 0;
-}
-
-//#endregion
 //#region source/config/schema/eventing.ts
-const MAX_DESCRIPTION_LENGTH = 255;
+const MAX_DESCRIPTION_LENGTH$1 = 255;
 const MAX_LABEL_LENGTH = 100;
 const MAX_KEY_LENGTH = 50;
+const MAX_EVENT_NAME_LENGTH = 180;
 /**
 * Regex for Commerce event names that must start with "plugin." or "observer."
-* followed by lowercase letters and underscores only.
-* Examples: "plugin.order_placed", "observer.catalog_update"
+* followed by one or more dot-separated lowercase segments containing letters
+* and underscores only.
+* Examples: "observer.order_placed", "plugin.sales.api.order_management.place"
+*/
+const COMMERCE_EVENT_NAME_REGEX = /^(?:plugin|observer)\.[a-z_]+(?:\.[a-z_]+)*$/;
+/**
+* Regex for external event names.
+* Allows word characters (letters, digits, underscore), hyphens, underscores, and dots.
+* Examples: "external_event", "webhook.received", "my-event_123"
 */
-const COMMERCE_EVENT_NAME_REGEX = /^(?:plugin|observer)\.[a-z_]+$/;
+const EXTERNAL_EVENT_NAME_REGEX = /^[\w\-_.]+$/;
 /**
 * Regex for field names according to XSD fieldName pattern.
 * Field name can either contain only [a-zA-Z0-9_\-\.\[\]] or be set to *.
@@ -125,10 +27,19 @@ const FIELD_NAME_REGEX = /^([a-zA-Z0-9_\-.[\]]+|\*)$/;
 /**
 * Schema for Commerce event names.
 * Validates that the event name starts with "plugin." or "observer."
-* followed by lowercase letters and underscores only.
+* followed by one or more dot-separated lowercase segments containing letters
+* and underscores only.
 */
 function commerceEventNameSchema() {
-	return v.pipe(nonEmptyStringValueSchema("event name"), v.regex(COMMERCE_EVENT_NAME_REGEX, "Event name must start with \"plugin.\" or \"observer.\" followed by lowercase letters and underscores only (e.g., \"plugin.order_placed\")"));
+	return v.pipe(nonEmptyStringValueSchema("event name"), v.regex(COMMERCE_EVENT_NAME_REGEX, "Event name must start with \"plugin.\" or \"observer.\" followed by one or more dot-separated lowercase segments containing letters and underscores only (e.g., \"observer.order_placed\", \"plugin.sales.api.order_management.place\")"), v.maxLength(MAX_EVENT_NAME_LENGTH, `The event name must not be longer than ${MAX_EVENT_NAME_LENGTH} characters`));
+}
+/**
+* Schema for external event names.
+* Validates that the event name contains only word characters (letters, digits, underscore),
+* hyphens, underscores, and dots.
+*/
+function externalEventNameSchema() {
+	return v.pipe(nonEmptyStringValueSchema("event name"), v.regex(EXTERNAL_EVENT_NAME_REGEX, "Event name must contain only letters, digits, underscores, hyphens, and dots (e.g., \"external_event\", \"webhook.received\", \"my-event_123\")"), v.maxLength(MAX_EVENT_NAME_LENGTH, `The event name must not be longer than ${MAX_EVENT_NAME_LENGTH} characters`));
 }
 /**
 * Schema for field names.
@@ -151,14 +62,14 @@ function commerceEventFieldSchema() {
 /** Schema for event provider configuration */
 const ProviderSchema = v.object({
 	label: v.pipe(nonEmptyStringValueSchema("provider label"), v.maxLength(MAX_LABEL_LENGTH, `The provider label must not be longer than ${MAX_LABEL_LENGTH} characters`)),
-	description: v.pipe(nonEmptyStringValueSchema("provider description"), v.maxLength(MAX_DESCRIPTION_LENGTH, `The provider description must not be longer than ${MAX_DESCRIPTION_LENGTH} characters`)),
+	description: v.pipe(nonEmptyStringValueSchema("provider description"), v.maxLength(MAX_DESCRIPTION_LENGTH$1, `The provider description must not be longer than ${MAX_DESCRIPTION_LENGTH$1} characters`)),
 	key: v.optional(v.pipe(alphaNumericOrHyphenSchema("provider key"), v.maxLength(MAX_KEY_LENGTH, `The provider key must not be longer than ${MAX_KEY_LENGTH} characters`)))
 });
 /** Schema for base shared properties between event types. */
 const BaseEventSchema = v.object({
 	label: v.pipe(nonEmptyStringValueSchema("event label"), v.maxLength(MAX_LABEL_LENGTH, `The event label must not be longer than ${MAX_LABEL_LENGTH} characters`)),
-	description: v.pipe(nonEmptyStringValueSchema("event description"), v.maxLength(MAX_DESCRIPTION_LENGTH, `The event description must not be longer than ${MAX_DESCRIPTION_LENGTH} characters`)),
-	runtimeActions: v.array(v.pipe(nonEmptyStringValueSchema("runtime action"), v.regex(/^[a-z0-9-]+\/[a-z0-9-]+$/, "Runtime action must be in the format \"<package>/<action>\" (e.g., \"my-package/my-action\")")), "Expected an array of runtime actions in the format <package>/<action>")
+	description: v.pipe(nonEmptyStringValueSchema("event description"), v.maxLength(MAX_DESCRIPTION_LENGTH$1, `The event description must not be longer than ${MAX_DESCRIPTION_LENGTH$1} characters`)),
+	runtimeActions: v.array(v.pipe(nonEmptyStringValueSchema("runtime action"), v.regex(/^[a-z0-9-]+\/[a-z0-9-]+$/i, "Runtime action must be in the format \"<package>/<action>\" (e.g., \"my-package/my-action\")")), "Expected an array of runtime actions in the format <package>/<action>")
 });
 /**
 * Schema for rule operator values.
@@ -186,14 +97,14 @@ const CommerceEventSchema = v.object({
 	fields: v.array(commerceEventFieldSchema(), "Expected an array of event field objects with a 'name' property"),
 	rules: v.optional(v.array(CommerceEventRuleSchema, "Expected an array of event rules with field, operator, and value")),
 	destination: v.optional(nonEmptyStringValueSchema("destination")),
-	hipaaAuditRequired: v.optional(booleanValueSchema("hipaaAuditRequired")),
-	prioritary: v.optional(booleanValueSchema("prioritary")),
+	hipaa_audit_required: v.optional(booleanValueSchema("hipaa_audit_required")),
+	priority: v.optional(booleanValueSchema("priority")),
 	force: v.optional(booleanValueSchema("force"))
 });
 /** Schema for external event configuration */
 const ExternalEventSchema = v.object({
 	...BaseEventSchema.entries,
-	name: alphaNumericOrUnderscoreSchema("event name", "lowercase")
+	name: externalEventNameSchema()
 });
 /** Schema for Commerce event source configuration */
 const CommerceEventSourceSchema = v.object({
@@ -233,19 +144,58 @@ function hasEventing(config) {
 }
 
 //#endregion
-//#region ../../packages-private/scripting-utils/source/error.ts
+//#region source/config/schema/installation.ts
+const MAX_DESCRIPTION_LENGTH = 255;
+const MAX_NAME_LENGTH = 255;
+const MAX_MESSAGE_LENGTH = 1e3;
+/**
+* Regex for script paths that can be relative or absolute.
+* Must end with .js extension
+* Examples:
+*   - "./scripts/setup.js"
+*   - "./setup.js"
+*   - "../../scripts/setup.js"
+*/
+const SCRIPT_PATH_REGEX = /^(?:\.{0,2}\/)*[\w-/]*[\w-]+\.js$/;
+/**
+* Schema for custom installation step configuration
+*/
+const CustomInstallationStepSchema = v.object({
+	script: v.pipe(nonEmptyStringValueSchema("script path"), v.regex(SCRIPT_PATH_REGEX, "Script path must end with .js (e.g., \"./setup.js\", \"./scripts/setup.js\", or \"../../scripts/setup.js\")")),
+	name: v.pipe(nonEmptyStringValueSchema("step name"), v.maxLength(MAX_NAME_LENGTH, `The step name must not be longer than ${MAX_NAME_LENGTH} characters`)),
+	description: v.pipe(nonEmptyStringValueSchema("step description"), v.maxLength(MAX_DESCRIPTION_LENGTH, `The step description must not be longer than ${MAX_DESCRIPTION_LENGTH} characters`))
+});
+/**
+* Schema for installation messages configuration
+*/
+const MessagesSchema = v.object({
+	preInstallation: v.optional(v.pipe(nonEmptyStringValueSchema("preInstallation message"), v.maxLength(MAX_MESSAGE_LENGTH, `The preInstallation message must not be longer than ${MAX_MESSAGE_LENGTH} characters`))),
+	postInstallation: v.optional(v.pipe(nonEmptyStringValueSchema("postInstallation message"), v.maxLength(MAX_MESSAGE_LENGTH, `The postInstallation message must not be longer than ${MAX_MESSAGE_LENGTH} characters`)))
+});
+/**
+* Schema for installation configuration
+*/
+const InstallationSchema = v.object({
+	messages: v.optional(MessagesSchema),
+	customInstallationSteps: v.pipe(v.optional(v.array(CustomInstallationStepSchema, "Expected an array of custom installation steps")), v.check((input) => {
+		const steps = input || [];
+		return new Set(steps.map((step) => step.name)).size === steps.length;
+	}, "Duplicate step names detected in custom installation steps. Each step must have a unique name."))
+});
 /**
-* This module exports shared error utilities for the AIO Commerce SDK.
-* @packageDocumentation
+* Check if config has custom installation settings.
+* @param config - The configuration to check.
 */
+function hasCustomInstallation(config) {
+	return config.installation !== void 0;
+}
 /**
-* Stringify an error to a human-friendly string.
-* @param error - The error to stringify.
+* Check if config has custom installation steps.
+* @param config - The configuration to check.
 */
-function stringifyError(error) {
-	if (error instanceof CommerceSdkValidationError) return error.display();
-	return error instanceof Error ? error.message : String(error);
+function hasCustomInstallationSteps(config) {
+	return Array.isArray(config?.installation?.customInstallationSteps) && config.installation.customInstallationSteps.length > 0;
 }
 
 //#endregion
-export { hasExternalEvents as a, hasCustomInstallationSteps as c, hasEventing as i, alphaNumericOrHyphenSchema as l, EventingSchema as n, InstallationSchema as o, hasCommerceEvents as r, hasCustomInstallation as s, stringifyError as t, nonEmptyStringValueSchema as u };
+export { hasCommerceEvents as a, EventingSchema as i, hasCustomInstallation as n, hasEventing as o, hasCustomInstallationSteps as r, hasExternalEvents as s, InstallationSchema as t };

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

@@ -1,3 +1,2 @@
-import "../app-Cx1-6dn0.mjs";
-import { A as BranchStep, B as defineBranchStep, C as StepStatus, D as isInProgressState, E as isFailedState, F as LeafStep, H as isBranchStep, I as LeafStepOptions, L as Step, M as ExecutionContext, N as InferStepOutput, O as isSucceededState, P as InstallationContext, R as StepContextFactory, S as InstallationStatus, T as isCompletedState, U as isLeafStep, V as defineLeafStep, _ as FailedInstallationState, a as CustomInstallationStepHandler, b as InstallationError, c as ExecuteWorkflowOptions, d as InstallationHooks, f as StepEvent, g as ExecutionStatus, h as StepSucceededEvent, i as runInstallation, j as BranchStepOptions, k as AnyStep, l as createInitialState, m as StepStartedEvent, n as RunInstallationOptions, o as defineCustomInstallationStep, p as StepFailedEvent, r as createInitialInstallationState, s as CreateInitialStateOptions, t as CreateInitialInstallationStateOptions, u as executeWorkflow, v as InProgressInstallationState, w as SucceededInstallationState, x as InstallationState, y as InstallationData, z as StepMeta } from "../index-Bxr3zvCT.mjs";
-export { AnyStep, BranchStep, BranchStepOptions, CreateInitialInstallationStateOptions, CreateInitialStateOptions, CustomInstallationStepHandler, ExecuteWorkflowOptions, ExecutionContext, ExecutionStatus, FailedInstallationState, InProgressInstallationState, InferStepOutput, InstallationContext, InstallationData, InstallationError, InstallationHooks, InstallationState, InstallationStatus, LeafStep, LeafStepOptions, RunInstallationOptions, Step, StepContextFactory, StepEvent, StepFailedEvent, StepMeta, StepStartedEvent, StepStatus, StepSucceededEvent, SucceededInstallationState, createInitialInstallationState, createInitialState, defineBranchStep, defineCustomInstallationStep, defineLeafStep, executeWorkflow, isBranchStep, isCompletedState, isFailedState, isInProgressState, isLeafStep, isSucceededState, runInstallation };
+import { A as BranchStep, B as defineBranchStep, C as StepStatus, D as isInProgressState, E as isFailedState, F as LeafStep, H as isBranchStep, I as LeafStepOptions, L as Step, M as ExecutionContext, N as InferStepOutput, O as isSucceededState, P as InstallationContext, R as StepContextFactory, S as InstallationStatus, T as isCompletedState, U as isLeafStep, V as defineLeafStep, _ as FailedInstallationState, a as CustomInstallationStepHandler, b as InstallationError, c as ExecuteWorkflowOptions, d as InstallationHooks, f as StepEvent, g as ExecutionStatus, h as StepSucceededEvent, i as runInstallation, j as BranchStepOptions, k as AnyStep, l as createInitialState, m as StepStartedEvent, n as RunInstallationOptions, o as defineCustomInstallationStep, p as StepFailedEvent, r as createInitialInstallationState, s as CreateInitialStateOptions, t as CreateInitialInstallationStateOptions, u as executeWorkflow, v as InProgressInstallationState, w as SucceededInstallationState, x as InstallationState, y as InstallationData, z as StepMeta } from "../runner-BD-lItnK.mjs";
+export { AnyStep, BranchStep, BranchStepOptions, type CreateInitialInstallationStateOptions, CreateInitialStateOptions, type CustomInstallationStepHandler, ExecuteWorkflowOptions, ExecutionContext, ExecutionStatus, FailedInstallationState, InProgressInstallationState, InferStepOutput, InstallationContext, InstallationData, InstallationError, InstallationHooks, InstallationState, InstallationStatus, LeafStep, LeafStepOptions, type RunInstallationOptions, Step, StepContextFactory, StepEvent, StepFailedEvent, StepMeta, StepStartedEvent, StepStatus, StepSucceededEvent, SucceededInstallationState, createInitialInstallationState, createInitialState, defineBranchStep, defineCustomInstallationStep, defineLeafStep, executeWorkflow, isBranchStep, isCompletedState, isFailedState, isInProgressState, isLeafStep, isSucceededState, runInstallation };

package/dist/es/management/index.mjs

@@ -1,3 +1,3 @@
-import { a as isFailedState, i as isCompletedState, n as runInstallation, o as isInProgressState, r as defineCustomInstallationStep, s as isSucceededState, t as createInitialInstallationState } from "../management-Y7pwEbNI.mjs";
+import { a as isFailedState, i as isCompletedState, n as runInstallation, o as isInProgressState, r as defineCustomInstallationStep, s as isSucceededState, t as createInitialInstallationState } from "../runner-vwAhjD5r.mjs";
 
 export { createInitialInstallationState, defineCustomInstallationStep, isCompletedState, isFailedState, isInProgressState, isSucceededState, runInstallation };

package/dist/es/parser-CQZTVG6i.mjs

@@ -0,0 +1,201 @@
+import { t as validateCommerceAppConfig } from "./validate-DKnju9-R.mjs";
+import { t as stringifyError } from "./error-CMV3IjBz.mjs";
+import { dirname, join, parse } from "path";
+import { existsSync } from "fs";
+import { access, mkdir, readFile } from "fs/promises";
+import { createJiti } from "jiti";
+
+//#region source/config/lib/define.ts
+/**
+* Helper to type-safely define the app config.
+* @param config - The app config to define.
+*
+* @example
+* ```typescript
+* import { defineConfig } from "@adobe/aio-commerce-lib-app";
+*
+* // In app.commerce.config.js
+* export default defineConfig({
+*   // You get autocompletion and type-safety for the config object.
+*   businessConfig: { ... }
+* });
+*/
+function defineConfig(config) {
+	return config;
+}
+
+//#endregion
+//#region ../../packages-private/scripting-utils/source/project.ts
+/**
+* This module exports shared project utilities for the AIO Commerce SDK.
+* @packageDocumentation
+*/
+/**
+* Find a file by walking up parent directories
+* @param name - The file name to search for (or array of file names)
+* @param options - Search options
+* @returns The path to the file, or undefined if not found
+*/
+async function findUp(name, options = {}) {
+	const names = Array.isArray(name) ? name : [name];
+	const cwd = options.cwd || process.cwd();
+	const { root } = parse(cwd);
+	const stopAt = options.stopAt || root;
+	let currentDir = cwd;
+	while (true) {
+		for (const fileName of names) {
+			const filePath = join(currentDir, fileName);
+			try {
+				await access(filePath);
+				return filePath;
+			} catch {}
+		}
+		if (currentDir === stopAt || currentDir === root) return;
+		currentDir = dirname(currentDir);
+	}
+}
+/**
+* Find the nearest package.json file in the current working directory or its parents
+* @param cwd The current working directory
+*/
+async function findNearestPackageJson(cwd = process.cwd()) {
+	const packageJsonPath = await findUp("package.json", { cwd });
+	if (!packageJsonPath) return null;
+	return packageJsonPath;
+}
+/**
+* Read the package.json file
+* @param cwd The current working directory
+*/
+async function readPackageJson(cwd = process.cwd()) {
+	const packageJsonPath = await findNearestPackageJson(cwd);
+	if (!packageJsonPath) return null;
+	return JSON.parse(await readFile(packageJsonPath, "utf-8"));
+}
+/**
+* Check if the current working directory is an ESM project.
+* @param cwd The current working directory
+*/
+async function isESM(cwd = process.cwd()) {
+	const packageJson = await readPackageJson(cwd);
+	if (!packageJson) throw new Error("Could not find a `package.json` file in the current working directory or its parents.");
+	return packageJson.type === "module";
+}
+/**
+* Get the root directory of the project
+* @param cwd The current working directory
+*/
+async function getProjectRootDirectory(cwd = process.cwd()) {
+	const packageJsonPath = await findNearestPackageJson(cwd);
+	if (!packageJsonPath) throw new Error("Could not find a the root directory of the project. `package.json` file not found.");
+	return dirname(packageJsonPath);
+}
+/**
+* Create the output directory for the given file or folder (relative to the project root)
+* @param fileOrFolder - The file or folder to create
+*/
+async function makeOutputDirFor(fileOrFolder) {
+	const outputDir = join(await getProjectRootDirectory(), fileOrFolder);
+	if (!existsSync(outputDir)) await mkdir(outputDir, { recursive: true });
+	return outputDir;
+}
+/** Detect the package manager by checking for lock files */
+async function detectPackageManager(cwd = process.cwd()) {
+	const rootDirectory = await getProjectRootDirectory(cwd);
+	const lockFileMap = {
+		"bun.lockb": "bun",
+		"pnpm-lock.yaml": "pnpm",
+		"yarn.lock": "yarn",
+		"package-lock.json": "npm"
+	};
+	const lockFileName = Object.keys(lockFileMap).find((name) => existsSync(join(rootDirectory, name)));
+	if (!lockFileName) return "npm";
+	return lockFileMap[lockFileName];
+}
+/** Get the appropriate exec command based on package manager */
+function getExecCommand(packageManager) {
+	return {
+		pnpm: "pnpx",
+		yarn: "yarn dlx",
+		bun: "bunx",
+		npm: "npx"
+	}[packageManager];
+}
+
+//#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",
+	"app.commerce.config.cjs",
+	"app.commerce.config.mjs",
+	"app.commerce.config.mts",
+	"app.commerce.config.cts"
+]);
+/**
+* Try to find (up to the nearest package.json file) the app config file.
+*
+* Searches for config files in the following order of priority:
+* 1. `app.commerce.config.js` - JavaScript (CommonJS or ESM)
+* 2. `app.commerce.config.ts` - TypeScript
+* 3. `app.commerce.config.cjs` - CommonJS
+* 4. `app.commerce.config.mjs` - ES Module
+* 5. `app.commerce.config.mts` - ES Module TypeScript
+* 6. `app.commerce.config.cts` - CommonJS TypeScript
+*
+* @param cwd The current working directory
+* @returns The path to the config file, or null if not found
+*/
+async function resolveCommerceAppConfig(cwd = process.cwd()) {
+	const packageJsonPath = await findNearestPackageJson(cwd);
+	if (!packageJsonPath) return null;
+	const rootDirectory = dirname(packageJsonPath);
+	for (const configPath of configPaths) {
+		const configFilePath = await findUp(configPath, {
+			cwd,
+			stopAt: rootDirectory
+		});
+		if (configFilePath) return configFilePath;
+	}
+	return null;
+}
+/**
+* Read the commerce app config file as-is, without validating it.
+*
+* Supports multiple config file formats (see {@link resolveCommerceAppConfig} for the list).
+* The config file must export a default export with the configuration object.
+*
+* @param cwd The current working directory
+* @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
+*/
+async function readCommerceAppConfig(cwd = process.cwd()) {
+	const configFilePath = await resolveCommerceAppConfig(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);
+	} catch (error) {
+		const message = stringifyError(error);
+		throw new Error(`Failed to read commerce app config file at ${configFilePath}: ${message}`, { cause: error });
+	}
+	if (!(config && "default" in config) || config.default === void 0 || config.default === null || typeof config.default === "object" && Object.keys(config.default).length === 0) throw new Error("Commerce app config file does not export a default export. Make sure you use `export default` or `module.exports = { /* your config */ }`");
+	return config.default;
+}
+/**
+* Read the commerce app config file and parse its contents into its schema.
+*
+* Supports multiple config file formats (see {@link resolveCommerceAppConfig} for the list).
+* The config file must export a default export with the configuration object.
+*
+* @param cwd The current working directory
+* @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
+*/
+async function parseCommerceAppConfig(cwd = process.cwd()) {
+	return validateCommerceAppConfig(await readCommerceAppConfig(cwd));
+}
+
+//#endregion
+export { findNearestPackageJson as a, isESM as c, defineConfig as d, detectPackageManager as i, makeOutputDirFor as l, readCommerceAppConfig as n, getExecCommand as o, resolveCommerceAppConfig as r, getProjectRootDirectory as s, parseCommerceAppConfig as t, readPackageJson as u };