@adobe/aio-commerce-lib-app 1.10.0 → 1.10.1

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @adobe/aio-commerce-lib-app
 
+## 1.10.1
+
+### Patch Changes
+
+- [#635](https://github.com/adobe/aio-commerce-sdk/pull/635) [`71bf666`](https://github.com/adobe/aio-commerce-sdk/commit/71bf66656ef1fc6dd272a0821e8b00aab5dc197e) Thanks [@iivvaannxx](https://github.com/iivvaannxx)! - The app build hooks now set `NODE_ENV` in the project `.env` so the web bundler builds for the correct environment (production on build, development on dev and run).
+
+- Updated dependencies [[`71bf666`](https://github.com/adobe/aio-commerce-sdk/commit/71bf66656ef1fc6dd272a0821e8b00aab5dc197e), [`71bf666`](https://github.com/adobe/aio-commerce-sdk/commit/71bf66656ef1fc6dd272a0821e8b00aab5dc197e)]:
+  - @adobe/aio-commerce-lib-admin-ui@1.0.1
+  - @adobe/aio-commerce-lib-auth@1.1.3
+  - @adobe/aio-commerce-lib-api@1.3.1
+  - @adobe/aio-commerce-lib-config@1.6.1
+  - @adobe/aio-commerce-lib-events@1.3.1
+  - @adobe/aio-commerce-lib-webhooks@1.2.1
+
 ## 1.10.0
 
 ### Minor Changes

package/dist/cjs/actions/app-config/index.cjs

@@ -29,7 +29,7 @@ let crypto = require("crypto");
 * Loads the committed OpenAPI spec via dynamic import so it
 * lands in its own chunk and is not parsed on every cold start.
 */
-const importOpenApi = () => Promise.resolve().then(() => require("../../openapi-C_y_Y5YX.cjs"));
+const importOpenApi = () => Promise.resolve().then(() => require("../../openapi-4EYZryTG.cjs"));
 /** Matches component schema `$ref` strings, capturing the schema name. */
 const SCHEMA_REF_PATTERN = /"#\/components\/schemas\/(\w+)"/g;
 /**
@@ -80,7 +80,7 @@ function pruneUnusedTags(spec) {
 * @param domains - The active config domains.
 */
 function getOpenApiCacheKey(domains) {
-	const input = `1.10.0:${[...domains].sort().join(",")}:2.0.0`;
+	const input = `1.10.1:${[...domains].sort().join(",")}:2.0.0`;
 	return (0, crypto.createHash)("sha256").update(input).digest("hex").slice(0, 8);
 }
 /** Returns the server URL to be set in the OpenAPI spec, based on the current namespace. */

package/dist/cjs/commands/index.cjs

@@ -357,7 +357,7 @@ const LEADING_DOT_SLASH_PATTERN$1 = /^\.\//u;
 const WEB_SOURCE_DEPENDENCIES = [
 	{
 		name: "@adobe/aio-commerce-lib-admin-ui",
-		version: "^1.0.0"
+		version: "^1.0.1"
 	},
 	{
 		name: "react",
@@ -683,7 +683,11 @@ function buildAdminUiV2ExtConfig(appConfig) {
 	const runtimeActions = collectUniqueRuntimeActions(adminUi);
 	const requiresWeb = requiresWebSource(adminUi);
 	return {
-		hooks: { "pre-app-build": "EXTENSION=backend-ui/2 $packageExec aio-commerce-lib-app hooks pre-app-build" },
+		hooks: {
+			"pre-app-build": "EXTENSION=backend-ui/2 $packageExec aio-commerce-lib-app hooks pre-app-build",
+			"pre-app-dev": "EXTENSION=backend-ui/2 $packageExec aio-commerce-lib-app hooks pre-app-dev",
+			"pre-app-run": "EXTENSION=backend-ui/2 $packageExec aio-commerce-lib-app hooks pre-app-run"
+		},
 		operations: {
 			...requiresWeb && { view: [{
 				impl: "index.html",
@@ -1152,7 +1156,7 @@ async function generateCustomScriptsTemplate(template, appManifest) {
 * @param appManifest - The app manifest, used to determine which actions to generate and their content.
 * @param templatesDir - The directory to load templates from, for testing purposes. Defaults to the generated actions template root.
 */
-async function run$5(appManifest, templatesDir = TEMPLATES_DIR) {
+async function run$7(appManifest, templatesDir = TEMPLATES_DIR) {
 	await prepareRuntimeAppConfigModule(appManifest);
 	const appManagementExtConfig = await updateExtConfig(appManifest, EXTENSIBILITY_EXTENSION_POINT_ID);
 	await generateActionFiles(appManifest, getRuntimeActions(appManagementExtConfig, "app-management"), EXTENSIBILITY_EXTENSION_POINT_ID, templatesDir);
@@ -1169,9 +1173,9 @@ async function run$5(appManifest, templatesDir = TEMPLATES_DIR) {
 	}
 }
 /** Run the generate actions command */
-async function exec$5() {
+async function exec$7() {
 	try {
-		await run$5(await loadAppManifest());
+		await run$7(await loadAppManifest());
 	} catch (error) {
 		if (error instanceof _adobe_aio_commerce_lib_core_error.CommerceSdkValidationError) consola.consola.error(error.display());
 		else consola.consola.error(error);
@@ -1181,7 +1185,7 @@ async function exec$5() {
 
 //#endregion
 //#region source/commands/generate/manifest/main.ts
-async function run$4(appConfig) {
+async function run$6(appConfig) {
 	if (await requiresJavaScriptAppConfig(appConfig)) {
 		const stalePath = (0, path.join)(await require_index_node.getProjectRootDirectory(), getManifestPath());
 		if (await (0, fs_promises.access)(stalePath).then(() => true, () => false)) {
@@ -1198,9 +1202,9 @@ async function run$4(appConfig) {
 	consola.consola.success(`Generated ${APP_MANIFEST_FILE}\n`);
 }
 /** Run the generate manifest command */
-async function exec$4() {
+async function exec$6() {
 	try {
-		await run$4(await loadAppManifest());
+		await run$6(await loadAppManifest());
 	} catch (error) {
 		if (error instanceof _adobe_aio_commerce_lib_core_error.CommerceSdkValidationError) consola.consola.error(error.display());
 		else consola.consola.error(error);
@@ -1222,7 +1226,7 @@ async function touch(filePath) {
 
 //#endregion
 //#region source/commands/generate/schema/main.ts
-async function run$3(appConfig) {
+async function run$5(appConfig) {
 	if (!require_validate.hasBusinessConfigSchema(appConfig)) {
 		consola.consola.debug("Business configuration schema not found in application configuration. Nothing to do.");
 		return;
@@ -1252,9 +1256,9 @@ async function run$3(appConfig) {
 	consola.consola.success(`Generated ${CONFIG_SCHEMA_FILE_NAME}\n`);
 }
 /** Run the generate schema command */
-async function exec$3() {
+async function exec$5() {
 	try {
-		await run$3(await loadAppManifest());
+		await run$5(await loadAppManifest());
 	} catch (error) {
 		if (error instanceof _adobe_aio_commerce_lib_core_error.CommerceSdkValidationError) consola.consola.error(error.display());
 		else consola.consola.error(error);
@@ -1264,16 +1268,16 @@ async function exec$3() {
 
 //#endregion
 //#region source/commands/hooks/postinstall.ts
-async function run$2(appManifest, templatesDir) {
-	await run$5(appManifest, templatesDir);
-	await run$4(appManifest);
-	await run$3(appManifest);
+async function run$4(appManifest, templatesDir) {
+	await run$7(appManifest, templatesDir);
+	await run$6(appManifest);
+	await run$5(appManifest);
 }
 /** Runs the postinstall hook */
-async function exec$2() {
+async function exec$4() {
 	consola.default.debug("Running lib-app postinstall hook");
 	try {
-		await run$2(await loadAppManifest());
+		await run$4(await loadAppManifest());
 	} catch (error) {
 		if (error instanceof _adobe_aio_commerce_lib_core_error.CommerceSdkValidationError) consola.default.error(error.display());
 		else consola.default.error(error);
@@ -1319,10 +1323,26 @@ function replaceEnvVar(filePath, key, value) {
 	if (!keyExists) updatedLines.push(`${key}=${formattedValue}`);
 	(0, fs.writeFileSync)(envPath, updatedLines.join("\n"), "utf8");
 }
-/** Returns the path to the .env file. */
-function resolveEnvPath() {
-	const envPath = process.env.INIT_CWD ? `${process.env.INIT_CWD}/.env` : ".env";
-	return path.default.resolve(envPath);
+/**
+* Returns the path to the project's `.env` file, resolved from the project root
+* (the nearest `package.json` walking up from `cwd`), so it is found regardless
+* of which subdirectory a command is invoked from.
+* @param cwd - A directory within the project. Defaults to the current working directory.
+*/
+async function resolveEnvPath(cwd = process.cwd()) {
+	const projectRoot = await require_index_node.getProjectRootDirectory(cwd);
+	return path.default.join(projectRoot, ".env");
+}
+/**
+* Sets the `NODE_ENV` environment variable in the app `.env` file, so the web
+* bundler (Parcel) ships the matching React build. Creates the `.env` if absent.
+* @param mode - The environment mode to write into `NODE_ENV`.
+* @param cwd - A directory within the project. Defaults to the current working directory.
+*/
+async function setNodeEnv(mode, cwd = process.cwd()) {
+	const envPath = await resolveEnvPath(cwd);
+	if (!(0, fs.existsSync)(envPath)) (0, fs.writeFileSync)(envPath, "", "utf8");
+	replaceEnvVar(envPath, "NODE_ENV", mode);
 }
 /** Resolves the IMS server to server context from the project workspace credentials. */
 function resolveImsS2SContext() {
@@ -1333,9 +1353,10 @@ function resolveImsS2SContext() {
 /**
 * Syncs the IMS credentials environment variables from the configured IMS context in
 * the .env file, in a way that is compatible with `@adobe/aio-commerce-lib-auth`.
+* @param cwd - A directory within the project. Defaults to the current working directory.
 */
-async function syncImsCredentials() {
-	const envPath = resolveEnvPath();
+async function syncImsCredentials(cwd = process.cwd()) {
+	const envPath = await resolveEnvPath(cwd);
 	if (!(0, fs.existsSync)(envPath)) return {
 		ok: false,
 		reason: "missing-env"
@@ -1360,22 +1381,23 @@ async function syncImsCredentials() {
 /**
 * Runs the pre-app-build hook for the given extension.
 * @param extension - The extension to run the hook for.
+* @param cwd - The project directory. Defaults to the current working directory.
 * @param templatesDir - The directory to load templates from, for testing purposes. Defaults to the generated actions template root.
 */
-async function run$1(extension, templatesDir = TEMPLATES_DIR) {
+async function run$3(extension, cwd = process.cwd(), templatesDir = TEMPLATES_DIR) {
 	const appManifest = await loadAppManifest();
 	await prepareRuntimeAppConfigModule(appManifest);
 	if (extension === "extensibility/1") {
 		const { doc: extensibilityExtConfig } = await readExtConfig(EXTENSIBILITY_EXTENSION_POINT_ID);
-		await run$4(appManifest);
+		await run$6(appManifest);
 		await generateActionFiles(appManifest, getRuntimeActions(extensibilityExtConfig.toJS(), "app-management"), EXTENSIBILITY_EXTENSION_POINT_ID, templatesDir);
 		consola.default.info("Syncing IMS credentials...");
-		await syncImsCredentials();
+		await syncImsCredentials(cwd);
 		return;
 	}
 	if (extension === "configuration/1") {
 		const { doc: businessConfigExtConfig } = await readExtConfig(CONFIGURATION_EXTENSION_POINT_ID);
-		await run$3(appManifest);
+		await run$5(appManifest);
 		await generateActionFiles(appManifest, getRuntimeActions(businessConfigExtConfig.toJS(), "business-configuration"), CONFIGURATION_EXTENSION_POINT_ID, templatesDir);
 		return;
 	}
@@ -1385,6 +1407,7 @@ async function run$1(extension, templatesDir = TEMPLATES_DIR) {
 			if (extConfig.operations?.view) {
 				await prepareWebSourceImportAlias(extConfig);
 				await generateWebSrc(extConfig, appManifest.metadata.displayName, templatesDir);
+				await setNodeEnv("production", cwd);
 			}
 		}
 		return;
@@ -1392,12 +1415,54 @@ async function run$1(extension, templatesDir = TEMPLATES_DIR) {
 	throw new Error(`Unsupported extension: ${extension}`);
 }
 /** Runs the pre-app-build hook */
-async function exec$1() {
+async function exec$3() {
 	consola.default.debug("Running lib-app pre-app-build hook");
 	const rawExtension = process.env.EXTENSION;
 	try {
 		if (!rawExtension) throw new Error("EXTENSION environment variable is not set");
-		await run$1(rawExtension);
+		await run$3(rawExtension);
+	} catch (error) {
+		if (error instanceof _adobe_aio_commerce_lib_core_error.CommerceSdkValidationError) consola.default.error(error.display());
+		else consola.default.error(error);
+		process.exit(1);
+	}
+}
+
+//#endregion
+//#region source/commands/hooks/pre-app-dev.ts
+/**
+* Resets the web build back to development by writing `NODE_ENV` to the project `.env`.
+* @param cwd - The project directory. Defaults to the current working directory.
+*/
+async function run$2(cwd = process.cwd()) {
+	await setNodeEnv("development", cwd);
+}
+/** Runs the pre-app-dev hook. */
+async function exec$2() {
+	consola.default.debug("Running lib-app pre-app-dev hook");
+	try {
+		await run$2();
+	} catch (error) {
+		if (error instanceof _adobe_aio_commerce_lib_core_error.CommerceSdkValidationError) consola.default.error(error.display());
+		else consola.default.error(error);
+		process.exit(1);
+	}
+}
+
+//#endregion
+//#region source/commands/hooks/pre-app-run.ts
+/**
+* Resets the web build back to development by writing `NODE_ENV` to the project `.env`.
+* @param cwd - The project directory. Defaults to the current working directory.
+*/
+async function run$1(cwd = process.cwd()) {
+	await setNodeEnv("development", cwd);
+}
+/** Runs the pre-app-run hook. */
+async function exec$1() {
+	consola.default.debug("Running lib-app pre-app-run hook");
+	try {
+		await run$1();
 	} catch (error) {
 		if (error instanceof _adobe_aio_commerce_lib_core_error.CommerceSdkValidationError) consola.default.error(error.display());
 		else consola.default.error(error);
@@ -1762,7 +1827,7 @@ async function ensureAppConfig(domains, cwd = process.cwd()) {
 */
 function installDependencies(packageManager, domains, cwd = process.cwd()) {
 	const packages = [];
-	if (domains.has("businessConfig.schema")) packages.push(`@adobe/aio-commerce-lib-config@^1.6.0`);
+	if (domains.has("businessConfig.schema")) packages.push(`@adobe/aio-commerce-lib-config@^1.6.1`);
 	if (packages.length === 0) {
 		consola.consola.info("No additional domain dependencies to install.");
 		return;
@@ -1772,9 +1837,9 @@ function installDependencies(packageManager, domains, cwd = process.cwd()) {
 /** Run the generation command */
 async function runGeneration(appConfig, execCommand) {
 	try {
+		await run$7(appConfig);
+		await run$6(appConfig);
 		await run$5(appConfig);
-		await run$4(appConfig);
-		await run$3(appConfig);
 	} catch (error) {
 		throw new Error(`Failed to run generation command. Please run manually: ${execCommand} aio-commerce-lib-app generate all`, { cause: error });
 	}
@@ -1789,7 +1854,7 @@ async function ensureInstallYaml(domains, cwd = process.cwd()) {
 
 //#endregion
 //#region source/commands/init/main.ts
-const REQUIRED_DEPENDENCIES = ["@adobe/aio-commerce-sdk", `@adobe/aio-commerce-lib-app@1.10.0`];
+const REQUIRED_DEPENDENCIES = ["@adobe/aio-commerce-sdk", `@adobe/aio-commerce-lib-app@1.10.1`];
 /** Initialize the project */
 async function run(flags, extraOptions) {
 	consola.consola.start("Initializing app...");
@@ -1857,21 +1922,23 @@ Examples:
 `;
 /** Run all generate targets in sequence */
 async function generateAll() {
+	await exec$7();
+	await exec$6();
 	await exec$5();
-	await exec$4();
-	await exec$3();
 }
 /** Command handlers registry mapping command names to their subcommand handlers */
 const COMMANDS = {
 	generate: {
-		actions: exec$5,
+		actions: exec$7,
 		all: generateAll,
-		manifest: exec$4,
-		schema: exec$3
+		manifest: exec$6,
+		schema: exec$5
 	},
 	hooks: {
-		postinstall: exec$2,
-		"pre-app-build": exec$1
+		postinstall: exec$4,
+		"pre-app-build": exec$3,
+		"pre-app-dev": exec$2,
+		"pre-app-run": exec$1
 	},
 	init: exec
 };

package/dist/cjs/{openapi-C_y_Y5YX.cjs → openapi-4EYZryTG.cjs}

@@ -23,7 +23,7 @@ var info = {
 		"identifier": "Apache-2.0",
 		"name": "Apache-2.0"
 	},
-	"x-meta": { "packageVersion": "1.10.0" }
+	"x-meta": { "packageVersion": "1.10.1" }
 };
 var servers = [{ "url": "/" }];
 var paths = {

package/dist/es/actions/app-config/index.mjs

@@ -26,7 +26,7 @@ import { createHash } from "crypto";
 * Loads the committed OpenAPI spec via dynamic import so it
 * lands in its own chunk and is not parsed on every cold start.
 */
-const importOpenApi = () => import("../../openapi-Brn9plmt.mjs");
+const importOpenApi = () => import("../../openapi-B_fZbtfP.mjs");
 /** Matches component schema `$ref` strings, capturing the schema name. */
 const SCHEMA_REF_PATTERN = /"#\/components\/schemas\/(\w+)"/g;
 /**
@@ -77,7 +77,7 @@ function pruneUnusedTags(spec) {
 * @param domains - The active config domains.
 */
 function getOpenApiCacheKey(domains) {
-	const input = `1.10.0:${[...domains].sort().join(",")}:2.0.0`;
+	const input = `1.10.1:${[...domains].sort().join(",")}:2.0.0`;
 	return createHash("sha256").update(input).digest("hex").slice(0, 8);
 }
 /** Returns the server URL to be set in the OpenAPI spec, based on the current namespace. */

package/dist/es/commands/index.mjs

@@ -350,7 +350,7 @@ const LEADING_DOT_SLASH_PATTERN$1 = /^\.\//u;
 const WEB_SOURCE_DEPENDENCIES = [
 	{
 		name: "@adobe/aio-commerce-lib-admin-ui",
-		version: "^1.0.0"
+		version: "^1.0.1"
 	},
 	{
 		name: "react",
@@ -676,7 +676,11 @@ function buildAdminUiV2ExtConfig(appConfig) {
 	const runtimeActions = collectUniqueRuntimeActions(adminUi);
 	const requiresWeb = requiresWebSource(adminUi);
 	return {
-		hooks: { "pre-app-build": "EXTENSION=backend-ui/2 $packageExec aio-commerce-lib-app hooks pre-app-build" },
+		hooks: {
+			"pre-app-build": "EXTENSION=backend-ui/2 $packageExec aio-commerce-lib-app hooks pre-app-build",
+			"pre-app-dev": "EXTENSION=backend-ui/2 $packageExec aio-commerce-lib-app hooks pre-app-dev",
+			"pre-app-run": "EXTENSION=backend-ui/2 $packageExec aio-commerce-lib-app hooks pre-app-run"
+		},
 		operations: {
 			...requiresWeb && { view: [{
 				impl: "index.html",
@@ -1145,7 +1149,7 @@ async function generateCustomScriptsTemplate(template, appManifest) {
 * @param appManifest - The app manifest, used to determine which actions to generate and their content.
 * @param templatesDir - The directory to load templates from, for testing purposes. Defaults to the generated actions template root.
 */
-async function run$5(appManifest, templatesDir = TEMPLATES_DIR) {
+async function run$7(appManifest, templatesDir = TEMPLATES_DIR) {
 	await prepareRuntimeAppConfigModule(appManifest);
 	const appManagementExtConfig = await updateExtConfig(appManifest, EXTENSIBILITY_EXTENSION_POINT_ID);
 	await generateActionFiles(appManifest, getRuntimeActions(appManagementExtConfig, "app-management"), EXTENSIBILITY_EXTENSION_POINT_ID, templatesDir);
@@ -1162,9 +1166,9 @@ async function run$5(appManifest, templatesDir = TEMPLATES_DIR) {
 	}
 }
 /** Run the generate actions command */
-async function exec$5() {
+async function exec$7() {
 	try {
-		await run$5(await loadAppManifest());
+		await run$7(await loadAppManifest());
 	} catch (error) {
 		if (error instanceof CommerceSdkValidationError) consola.error(error.display());
 		else consola.error(error);
@@ -1174,7 +1178,7 @@ async function exec$5() {
 
 //#endregion
 //#region source/commands/generate/manifest/main.ts
-async function run$4(appConfig) {
+async function run$6(appConfig) {
 	if (await requiresJavaScriptAppConfig(appConfig)) {
 		const stalePath = join(await getProjectRootDirectory(), getManifestPath());
 		if (await access(stalePath).then(() => true, () => false)) {
@@ -1191,9 +1195,9 @@ async function run$4(appConfig) {
 	consola.success(`Generated ${APP_MANIFEST_FILE}\n`);
 }
 /** Run the generate manifest command */
-async function exec$4() {
+async function exec$6() {
 	try {
-		await run$4(await loadAppManifest());
+		await run$6(await loadAppManifest());
 	} catch (error) {
 		if (error instanceof CommerceSdkValidationError) consola.error(error.display());
 		else consola.error(error);
@@ -1215,7 +1219,7 @@ async function touch(filePath) {
 
 //#endregion
 //#region source/commands/generate/schema/main.ts
-async function run$3(appConfig) {
+async function run$5(appConfig) {
 	if (!hasBusinessConfigSchema(appConfig)) {
 		consola.debug("Business configuration schema not found in application configuration. Nothing to do.");
 		return;
@@ -1245,9 +1249,9 @@ async function run$3(appConfig) {
 	consola.success(`Generated ${CONFIG_SCHEMA_FILE_NAME}\n`);
 }
 /** Run the generate schema command */
-async function exec$3() {
+async function exec$5() {
 	try {
-		await run$3(await loadAppManifest());
+		await run$5(await loadAppManifest());
 	} catch (error) {
 		if (error instanceof CommerceSdkValidationError) consola.error(error.display());
 		else consola.error(error);
@@ -1257,16 +1261,16 @@ async function exec$3() {
 
 //#endregion
 //#region source/commands/hooks/postinstall.ts
-async function run$2(appManifest, templatesDir) {
-	await run$5(appManifest, templatesDir);
-	await run$4(appManifest);
-	await run$3(appManifest);
+async function run$4(appManifest, templatesDir) {
+	await run$7(appManifest, templatesDir);
+	await run$6(appManifest);
+	await run$5(appManifest);
 }
 /** Runs the postinstall hook */
-async function exec$2() {
+async function exec$4() {
 	consola$1.debug("Running lib-app postinstall hook");
 	try {
-		await run$2(await loadAppManifest());
+		await run$4(await loadAppManifest());
 	} catch (error) {
 		if (error instanceof CommerceSdkValidationError) consola$1.error(error.display());
 		else consola$1.error(error);
@@ -1312,10 +1316,26 @@ function replaceEnvVar(filePath, key, value) {
 	if (!keyExists) updatedLines.push(`${key}=${formattedValue}`);
 	writeFileSync(envPath, updatedLines.join("\n"), "utf8");
 }
-/** Returns the path to the .env file. */
-function resolveEnvPath() {
-	const envPath = process.env.INIT_CWD ? `${process.env.INIT_CWD}/.env` : ".env";
-	return path.resolve(envPath);
+/**
+* Returns the path to the project's `.env` file, resolved from the project root
+* (the nearest `package.json` walking up from `cwd`), so it is found regardless
+* of which subdirectory a command is invoked from.
+* @param cwd - A directory within the project. Defaults to the current working directory.
+*/
+async function resolveEnvPath(cwd = process.cwd()) {
+	const projectRoot = await getProjectRootDirectory(cwd);
+	return path.join(projectRoot, ".env");
+}
+/**
+* Sets the `NODE_ENV` environment variable in the app `.env` file, so the web
+* bundler (Parcel) ships the matching React build. Creates the `.env` if absent.
+* @param mode - The environment mode to write into `NODE_ENV`.
+* @param cwd - A directory within the project. Defaults to the current working directory.
+*/
+async function setNodeEnv(mode, cwd = process.cwd()) {
+	const envPath = await resolveEnvPath(cwd);
+	if (!existsSync(envPath)) writeFileSync(envPath, "", "utf8");
+	replaceEnvVar(envPath, "NODE_ENV", mode);
 }
 /** Resolves the IMS server to server context from the project workspace credentials. */
 function resolveImsS2SContext() {
@@ -1326,9 +1346,10 @@ function resolveImsS2SContext() {
 /**
 * Syncs the IMS credentials environment variables from the configured IMS context in
 * the .env file, in a way that is compatible with `@adobe/aio-commerce-lib-auth`.
+* @param cwd - A directory within the project. Defaults to the current working directory.
 */
-async function syncImsCredentials() {
-	const envPath = resolveEnvPath();
+async function syncImsCredentials(cwd = process.cwd()) {
+	const envPath = await resolveEnvPath(cwd);
 	if (!existsSync(envPath)) return {
 		ok: false,
 		reason: "missing-env"
@@ -1353,22 +1374,23 @@ async function syncImsCredentials() {
 /**
 * Runs the pre-app-build hook for the given extension.
 * @param extension - The extension to run the hook for.
+* @param cwd - The project directory. Defaults to the current working directory.
 * @param templatesDir - The directory to load templates from, for testing purposes. Defaults to the generated actions template root.
 */
-async function run$1(extension, templatesDir = TEMPLATES_DIR) {
+async function run$3(extension, cwd = process.cwd(), templatesDir = TEMPLATES_DIR) {
 	const appManifest = await loadAppManifest();
 	await prepareRuntimeAppConfigModule(appManifest);
 	if (extension === "extensibility/1") {
 		const { doc: extensibilityExtConfig } = await readExtConfig(EXTENSIBILITY_EXTENSION_POINT_ID);
-		await run$4(appManifest);
+		await run$6(appManifest);
 		await generateActionFiles(appManifest, getRuntimeActions(extensibilityExtConfig.toJS(), "app-management"), EXTENSIBILITY_EXTENSION_POINT_ID, templatesDir);
 		consola$1.info("Syncing IMS credentials...");
-		await syncImsCredentials();
+		await syncImsCredentials(cwd);
 		return;
 	}
 	if (extension === "configuration/1") {
 		const { doc: businessConfigExtConfig } = await readExtConfig(CONFIGURATION_EXTENSION_POINT_ID);
-		await run$3(appManifest);
+		await run$5(appManifest);
 		await generateActionFiles(appManifest, getRuntimeActions(businessConfigExtConfig.toJS(), "business-configuration"), CONFIGURATION_EXTENSION_POINT_ID, templatesDir);
 		return;
 	}
@@ -1378,6 +1400,7 @@ async function run$1(extension, templatesDir = TEMPLATES_DIR) {
 			if (extConfig.operations?.view) {
 				await prepareWebSourceImportAlias(extConfig);
 				await generateWebSrc(extConfig, appManifest.metadata.displayName, templatesDir);
+				await setNodeEnv("production", cwd);
 			}
 		}
 		return;
@@ -1385,12 +1408,54 @@ async function run$1(extension, templatesDir = TEMPLATES_DIR) {
 	throw new Error(`Unsupported extension: ${extension}`);
 }
 /** Runs the pre-app-build hook */
-async function exec$1() {
+async function exec$3() {
 	consola$1.debug("Running lib-app pre-app-build hook");
 	const rawExtension = process.env.EXTENSION;
 	try {
 		if (!rawExtension) throw new Error("EXTENSION environment variable is not set");
-		await run$1(rawExtension);
+		await run$3(rawExtension);
+	} catch (error) {
+		if (error instanceof CommerceSdkValidationError) consola$1.error(error.display());
+		else consola$1.error(error);
+		process.exit(1);
+	}
+}
+
+//#endregion
+//#region source/commands/hooks/pre-app-dev.ts
+/**
+* Resets the web build back to development by writing `NODE_ENV` to the project `.env`.
+* @param cwd - The project directory. Defaults to the current working directory.
+*/
+async function run$2(cwd = process.cwd()) {
+	await setNodeEnv("development", cwd);
+}
+/** Runs the pre-app-dev hook. */
+async function exec$2() {
+	consola$1.debug("Running lib-app pre-app-dev hook");
+	try {
+		await run$2();
+	} catch (error) {
+		if (error instanceof CommerceSdkValidationError) consola$1.error(error.display());
+		else consola$1.error(error);
+		process.exit(1);
+	}
+}
+
+//#endregion
+//#region source/commands/hooks/pre-app-run.ts
+/**
+* Resets the web build back to development by writing `NODE_ENV` to the project `.env`.
+* @param cwd - The project directory. Defaults to the current working directory.
+*/
+async function run$1(cwd = process.cwd()) {
+	await setNodeEnv("development", cwd);
+}
+/** Runs the pre-app-run hook. */
+async function exec$1() {
+	consola$1.debug("Running lib-app pre-app-run hook");
+	try {
+		await run$1();
 	} catch (error) {
 		if (error instanceof CommerceSdkValidationError) consola$1.error(error.display());
 		else consola$1.error(error);
@@ -1755,7 +1820,7 @@ async function ensureAppConfig(domains, cwd = process.cwd()) {
 */
 function installDependencies(packageManager, domains, cwd = process.cwd()) {
 	const packages = [];
-	if (domains.has("businessConfig.schema")) packages.push(`@adobe/aio-commerce-lib-config@^1.6.0`);
+	if (domains.has("businessConfig.schema")) packages.push(`@adobe/aio-commerce-lib-config@^1.6.1`);
 	if (packages.length === 0) {
 		consola.info("No additional domain dependencies to install.");
 		return;
@@ -1765,9 +1830,9 @@ function installDependencies(packageManager, domains, cwd = process.cwd()) {
 /** Run the generation command */
 async function runGeneration(appConfig, execCommand) {
 	try {
+		await run$7(appConfig);
+		await run$6(appConfig);
 		await run$5(appConfig);
-		await run$4(appConfig);
-		await run$3(appConfig);
 	} catch (error) {
 		throw new Error(`Failed to run generation command. Please run manually: ${execCommand} aio-commerce-lib-app generate all`, { cause: error });
 	}
@@ -1782,7 +1847,7 @@ async function ensureInstallYaml(domains, cwd = process.cwd()) {
 
 //#endregion
 //#region source/commands/init/main.ts
-const REQUIRED_DEPENDENCIES = ["@adobe/aio-commerce-sdk", `@adobe/aio-commerce-lib-app@1.10.0`];
+const REQUIRED_DEPENDENCIES = ["@adobe/aio-commerce-sdk", `@adobe/aio-commerce-lib-app@1.10.1`];
 /** Initialize the project */
 async function run(flags, extraOptions) {
 	consola.start("Initializing app...");
@@ -1850,21 +1915,23 @@ Examples:
 `;
 /** Run all generate targets in sequence */
 async function generateAll() {
+	await exec$7();
+	await exec$6();
 	await exec$5();
-	await exec$4();
-	await exec$3();
 }
 /** Command handlers registry mapping command names to their subcommand handlers */
 const COMMANDS = {
 	generate: {
-		actions: exec$5,
+		actions: exec$7,
 		all: generateAll,
-		manifest: exec$4,
-		schema: exec$3
+		manifest: exec$6,
+		schema: exec$5
 	},
 	hooks: {
-		postinstall: exec$2,
-		"pre-app-build": exec$1
+		postinstall: exec$4,
+		"pre-app-build": exec$3,
+		"pre-app-dev": exec$2,
+		"pre-app-run": exec$1
 	},
 	init: exec
 };

package/dist/es/{openapi-Brn9plmt.mjs → openapi-B_fZbtfP.mjs}

@@ -23,7 +23,7 @@ var info = {
 		"identifier": "Apache-2.0",
 		"name": "Apache-2.0"
 	},
-	"x-meta": { "packageVersion": "1.10.0" }
+	"x-meta": { "packageVersion": "1.10.1" }
 };
 var servers = [{ "url": "/" }];
 var paths = {

package/package.json

@@ -2,7 +2,7 @@
   "name": "@adobe/aio-commerce-lib-app",
   "type": "module",
   "author": "Adobe Inc.",
-  "version": "1.10.0",
+  "version": "1.10.1",
   "private": false,
   "engines": {
     "node": ">=22 <=24"
@@ -120,13 +120,13 @@
     "type-fest": "^5.0.0",
     "valibot": "^1.1.0",
     "yaml": "^2.8.1",
-    "@adobe/aio-commerce-lib-admin-ui": "1.0.0",
-    "@adobe/aio-commerce-lib-api": "1.3.0",
-    "@adobe/aio-commerce-lib-config": "1.6.0",
-    "@adobe/aio-commerce-lib-auth": "1.1.2",
+    "@adobe/aio-commerce-lib-admin-ui": "1.0.1",
+    "@adobe/aio-commerce-lib-api": "1.3.1",
+    "@adobe/aio-commerce-lib-auth": "1.1.3",
+    "@adobe/aio-commerce-lib-config": "1.6.1",
     "@adobe/aio-commerce-lib-core": "1.2.0",
-    "@adobe/aio-commerce-lib-events": "1.3.0",
-    "@adobe/aio-commerce-lib-webhooks": "1.2.0"
+    "@adobe/aio-commerce-lib-events": "1.3.1",
+    "@adobe/aio-commerce-lib-webhooks": "1.2.1"
   },
   "peerDependencies": {
     "@tsconfig/bases": "^1.0.26",
@@ -156,9 +156,9 @@
     "@aio-commerce-sdk/common-utils": "0.2.6",
     "@aio-commerce-sdk/config-tsdown": "1.0.1",
     "@aio-commerce-sdk/config-typedoc": "1.0.0",
-    "@aio-commerce-sdk/config-vitest": "1.0.0",
-    "@aio-commerce-sdk/scripting-utils": "0.3.4",
     "@aio-commerce-sdk/config-typescript": "1.0.0",
+    "@aio-commerce-sdk/config-vitest": "1.0.0",
+    "@aio-commerce-sdk/scripting-utils": "0.3.5",
     "@aio-commerce-sdk/scripts": "0.1.1"
   },
   "sideEffects": false,