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

package/dist/cjs/error-DJ2UAPH2.cjs

@@ -0,0 +1,24 @@
+const require_schemas = require('./schemas-CZ6c8Id9.cjs');
+let _adobe_aio_commerce_lib_core_error = require("@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 _adobe_aio_commerce_lib_core_error.CommerceSdkValidationError) return error.display();
+	return error instanceof Error ? error.message : String(error);
+}
+
+//#endregion
+Object.defineProperty(exports, 'stringifyError', {
+  enumerable: true,
+  get: function () {
+    return stringifyError;
+  }
+});

package/dist/cjs/installation-CLbceU9F.cjs

@@ -0,0 +1,243 @@
+const require_schemas = require('./schemas-CZ6c8Id9.cjs');
+let valibot = require("valibot");
+valibot = require_schemas.__toESM(valibot);
+
+//#region source/config/schema/eventing.ts
+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 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 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 *.
+*/
+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 one or more dot-separated lowercase segments containing letters
+* and underscores only.
+*/
+function commerceEventNameSchema() {
+	return valibot.pipe(require_schemas.nonEmptyStringValueSchema("event name"), valibot.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\")"), valibot.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 valibot.pipe(require_schemas.nonEmptyStringValueSchema("event name"), valibot.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\")"), valibot.maxLength(MAX_EVENT_NAME_LENGTH, `The event name must not be longer than ${MAX_EVENT_NAME_LENGTH} characters`));
+}
+/**
+* Schema for field names.
+* Validates that the field name matches the XSD fieldName pattern:
+* can either contain only [a-zA-Z0-9_\-\.\[\]] or be set to *.
+*/
+function fieldNameSchema() {
+	return valibot.pipe(require_schemas.nonEmptyStringValueSchema("field name"), valibot.regex(FIELD_NAME_REGEX, "Field name must contain only letters (a-z, A-Z), numbers (0-9), underscores (_), dashes (-), dots (.), and square brackets ([, ]), or be exactly \"*\""));
+}
+/**
+* Schema for field objects in Commerce events.
+* Each field has a required name and an optional source.
+*/
+function commerceEventFieldSchema() {
+	return valibot.object({
+		name: fieldNameSchema(),
+		source: valibot.optional(require_schemas.stringValueSchema("field source"))
+	});
+}
+/** Schema for event provider configuration */
+const ProviderSchema = valibot.object({
+	label: valibot.pipe(require_schemas.nonEmptyStringValueSchema("provider label"), valibot.maxLength(MAX_LABEL_LENGTH, `The provider label must not be longer than ${MAX_LABEL_LENGTH} characters`)),
+	description: valibot.pipe(require_schemas.nonEmptyStringValueSchema("provider description"), valibot.maxLength(MAX_DESCRIPTION_LENGTH$1, `The provider description must not be longer than ${MAX_DESCRIPTION_LENGTH$1} characters`)),
+	key: valibot.optional(valibot.pipe(require_schemas.alphaNumericOrHyphenSchema("provider key"), valibot.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 = valibot.object({
+	label: valibot.pipe(require_schemas.nonEmptyStringValueSchema("event label"), valibot.maxLength(MAX_LABEL_LENGTH, `The event label must not be longer than ${MAX_LABEL_LENGTH} characters`)),
+	description: valibot.pipe(require_schemas.nonEmptyStringValueSchema("event description"), valibot.maxLength(MAX_DESCRIPTION_LENGTH$1, `The event description must not be longer than ${MAX_DESCRIPTION_LENGTH$1} characters`)),
+	runtimeActions: valibot.array(valibot.pipe(require_schemas.nonEmptyStringValueSchema("runtime action"), valibot.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.
+* Valid operators for Commerce event filtering rules.
+*/
+const OPERATORS = [
+	"greaterThan",
+	"lessThan",
+	"equal",
+	"regex",
+	"in",
+	"onChange"
+];
+const ruleOperatorSchema = valibot.union(OPERATORS.map((op) => valibot.literal(op)), `Operator must be one of: ${OPERATORS.join(", ")}`);
+/** Schema for Commerce event rule configuration */
+const CommerceEventRuleSchema = valibot.object({
+	field: require_schemas.nonEmptyStringValueSchema("rule field"),
+	operator: ruleOperatorSchema,
+	value: require_schemas.nonEmptyStringValueSchema("rule value")
+});
+/** Schema for Commerce event configuration */
+const CommerceEventSchema = valibot.object({
+	...BaseEventSchema.entries,
+	name: commerceEventNameSchema(),
+	fields: valibot.array(commerceEventFieldSchema(), "Expected an array of event field objects with a 'name' property"),
+	rules: valibot.optional(valibot.array(CommerceEventRuleSchema, "Expected an array of event rules with field, operator, and value")),
+	destination: valibot.optional(require_schemas.nonEmptyStringValueSchema("destination")),
+	hipaa_audit_required: valibot.optional(require_schemas.booleanValueSchema("hipaa_audit_required")),
+	priority: valibot.optional(require_schemas.booleanValueSchema("priority")),
+	force: valibot.optional(require_schemas.booleanValueSchema("force"))
+});
+/** Schema for external event configuration */
+const ExternalEventSchema = valibot.object({
+	...BaseEventSchema.entries,
+	name: externalEventNameSchema()
+});
+/** Schema for Commerce event source configuration */
+const CommerceEventSourceSchema = valibot.object({
+	provider: ProviderSchema,
+	events: valibot.array(CommerceEventSchema, "Expected an array of Commerce events")
+});
+/** Schema for external event source configuration */
+const ExternalEventSourceSchema = valibot.object({
+	provider: ProviderSchema,
+	events: valibot.array(ExternalEventSchema, "Expected an array of external events")
+});
+/** Schema for eventing configuration with separate commerce and external arrays */
+const EventingSchema = valibot.object({
+	commerce: valibot.optional(valibot.array(CommerceEventSourceSchema, "Expected an array of Commerce event sources")),
+	external: valibot.optional(valibot.array(ExternalEventSourceSchema, "Expected an array of external event sources"))
+});
+/**
+* Check if config has commerce event sources.
+* @param config - The configuration to check.
+*/
+function hasCommerceEvents(config) {
+	return Array.isArray(config?.eventing?.commerce) && config.eventing.commerce.length > 0;
+}
+/**
+* Check if config has external event sources.
+* @param config - The configuration to check.
+*/
+function hasExternalEvents(config) {
+	return Array.isArray(config?.eventing?.external) && config.eventing.external.length > 0;
+}
+/**
+* Check if config has any eventing configuration.
+* @param config - The configuration to check.
+*/
+function hasEventing(config) {
+	return config.eventing !== void 0;
+}
+
+//#endregion
+//#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 = valibot.object({
+	script: valibot.pipe(require_schemas.nonEmptyStringValueSchema("script path"), valibot.regex(SCRIPT_PATH_REGEX, "Script path must end with .js (e.g., \"./setup.js\", \"./scripts/setup.js\", or \"../../scripts/setup.js\")")),
+	name: valibot.pipe(require_schemas.nonEmptyStringValueSchema("step name"), valibot.maxLength(MAX_NAME_LENGTH, `The step name must not be longer than ${MAX_NAME_LENGTH} characters`)),
+	description: valibot.pipe(require_schemas.nonEmptyStringValueSchema("step description"), valibot.maxLength(MAX_DESCRIPTION_LENGTH, `The step description must not be longer than ${MAX_DESCRIPTION_LENGTH} characters`))
+});
+/**
+* Schema for installation messages configuration
+*/
+const MessagesSchema = valibot.object({
+	preInstallation: valibot.optional(valibot.pipe(require_schemas.nonEmptyStringValueSchema("preInstallation message"), valibot.maxLength(MAX_MESSAGE_LENGTH, `The preInstallation message must not be longer than ${MAX_MESSAGE_LENGTH} characters`))),
+	postInstallation: valibot.optional(valibot.pipe(require_schemas.nonEmptyStringValueSchema("postInstallation message"), valibot.maxLength(MAX_MESSAGE_LENGTH, `The postInstallation message must not be longer than ${MAX_MESSAGE_LENGTH} characters`)))
+});
+/**
+* Schema for installation configuration
+*/
+const InstallationSchema = valibot.object({
+	messages: valibot.optional(MessagesSchema),
+	customInstallationSteps: valibot.pipe(valibot.optional(valibot.array(CustomInstallationStepSchema, "Expected an array of custom installation steps")), valibot.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
+Object.defineProperty(exports, 'EventingSchema', {
+  enumerable: true,
+  get: function () {
+    return EventingSchema;
+  }
+});
+Object.defineProperty(exports, 'InstallationSchema', {
+  enumerable: true,
+  get: function () {
+    return InstallationSchema;
+  }
+});
+Object.defineProperty(exports, 'hasCommerceEvents', {
+  enumerable: true,
+  get: function () {
+    return hasCommerceEvents;
+  }
+});
+Object.defineProperty(exports, 'hasCustomInstallation', {
+  enumerable: true,
+  get: function () {
+    return hasCustomInstallation;
+  }
+});
+Object.defineProperty(exports, 'hasCustomInstallationSteps', {
+  enumerable: true,
+  get: function () {
+    return hasCustomInstallationSteps;
+  }
+});
+Object.defineProperty(exports, 'hasEventing', {
+  enumerable: true,
+  get: function () {
+    return hasEventing;
+  }
+});
+Object.defineProperty(exports, 'hasExternalEvents', {
+  enumerable: true,
+  get: function () {
+    return hasExternalEvents;
+  }
+});

package/dist/cjs/{logging-DYwr5WQk.cjs → logging-IDRQG0as.cjs}

@@ -1,6 +1,6 @@
-const require_error = require('./error-Byj1DVHZ.cjs');
+const require_schemas = require('./schemas-CZ6c8Id9.cjs');
 let util = require("util");
-util = require_error.__toESM(util);
+util = require_schemas.__toESM(util);
 
 //#region ../../packages-private/common-utils/source/logging.ts
 /**

package/dist/cjs/management/index.cjs

@@ -1,9 +1,10 @@
-const require_management = require('../management-Dm5h0E6l.cjs');
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runner = require('../runner-NHMvoMO2.cjs');
 
-exports.createInitialInstallationState = require_management.createInitialInstallationState;
-exports.defineCustomInstallationStep = require_management.defineCustomInstallationStep;
-exports.isCompletedState = require_management.isCompletedState;
-exports.isFailedState = require_management.isFailedState;
-exports.isInProgressState = require_management.isInProgressState;
-exports.isSucceededState = require_management.isSucceededState;
-exports.runInstallation = require_management.runInstallation;
+exports.createInitialInstallationState = require_runner.createInitialInstallationState;
+exports.defineCustomInstallationStep = require_runner.defineCustomInstallationStep;
+exports.isCompletedState = require_runner.isCompletedState;
+exports.isFailedState = require_runner.isFailedState;
+exports.isInProgressState = require_runner.isInProgressState;
+exports.isSucceededState = require_runner.isSucceededState;
+exports.runInstallation = require_runner.runInstallation;

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

@@ -1,2 +1,2 @@
-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-C5SutkJQ.cjs";
-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-DemKouFJ.cjs";
+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/cjs/parser-BPpg_9QB.cjs

@@ -0,0 +1,267 @@
+const require_schemas = require('./schemas-CZ6c8Id9.cjs');
+const require_validate = require('./validate-Btzn9ilZ.cjs');
+const require_error = require('./error-DJ2UAPH2.cjs');
+let path = require("path");
+let fs = require("fs");
+let fs_promises = require("fs/promises");
+let jiti = require("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 } = (0, path.parse)(cwd);
+	const stopAt = options.stopAt || root;
+	let currentDir = cwd;
+	while (true) {
+		for (const fileName of names) {
+			const filePath = (0, path.join)(currentDir, fileName);
+			try {
+				await (0, fs_promises.access)(filePath);
+				return filePath;
+			} catch {}
+		}
+		if (currentDir === stopAt || currentDir === root) return;
+		currentDir = (0, path.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 (0, fs_promises.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 (0, path.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 = (0, path.join)(await getProjectRootDirectory(), fileOrFolder);
+	if (!(0, fs.existsSync)(outputDir)) await (0, fs_promises.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) => (0, fs.existsSync)((0, path.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$1 = (0, jiti.createJiti)(require("url").pathToFileURL(__filename).href);
+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 = (0, path.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$1.import(configFilePath);
+	} catch (error) {
+		const message = require_error.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 require_validate.validateCommerceAppConfig(await readCommerceAppConfig(cwd));
+}
+
+//#endregion
+Object.defineProperty(exports, 'defineConfig', {
+  enumerable: true,
+  get: function () {
+    return defineConfig;
+  }
+});
+Object.defineProperty(exports, 'detectPackageManager', {
+  enumerable: true,
+  get: function () {
+    return detectPackageManager;
+  }
+});
+Object.defineProperty(exports, 'findNearestPackageJson', {
+  enumerable: true,
+  get: function () {
+    return findNearestPackageJson;
+  }
+});
+Object.defineProperty(exports, 'getExecCommand', {
+  enumerable: true,
+  get: function () {
+    return getExecCommand;
+  }
+});
+Object.defineProperty(exports, 'getProjectRootDirectory', {
+  enumerable: true,
+  get: function () {
+    return getProjectRootDirectory;
+  }
+});
+Object.defineProperty(exports, 'isESM', {
+  enumerable: true,
+  get: function () {
+    return isESM;
+  }
+});
+Object.defineProperty(exports, 'makeOutputDirFor', {
+  enumerable: true,
+  get: function () {
+    return makeOutputDirFor;
+  }
+});
+Object.defineProperty(exports, 'parseCommerceAppConfig', {
+  enumerable: true,
+  get: function () {
+    return parseCommerceAppConfig;
+  }
+});
+Object.defineProperty(exports, 'readCommerceAppConfig', {
+  enumerable: true,
+  get: function () {
+    return readCommerceAppConfig;
+  }
+});
+Object.defineProperty(exports, 'readPackageJson', {
+  enumerable: true,
+  get: function () {
+    return readPackageJson;
+  }
+});
+Object.defineProperty(exports, 'resolveCommerceAppConfig', {
+  enumerable: true,
+  get: function () {
+    return resolveCommerceAppConfig;
+  }
+});