@salesforce/storefront-next-dev 0.1.0 → 0.1.1

package/dist/cli.js

@@ -17,6 +17,7 @@ import express from "express";
 import { createRequestHandler } from "@react-router/express";
 import { existsSync, readFileSync, unlinkSync } from "node:fs";
 import { basename, extname as extname$1, join, resolve } from "node:path";
+import { pathToFileURL as pathToFileURL$1 } from "node:url";
 import { createProxyMiddleware } from "http-proxy-middleware";
 import compression from "compression";
 import zlib$1 from "node:zlib";
@@ -33,7 +34,7 @@ import prompts from "prompts";
 import { z } from "zod";
 
 //#region package.json
-var version = "0.1.0";
+var version = "0.1.1";
 
 //#endregion
 //#region src/utils/logger.ts
@@ -976,6 +977,16 @@ const ServerModeFeatureMap = {
 
 //#endregion
 //#region src/server/index.ts
+/** Relative path to the middleware registry TypeScript source (development). Must match appDirectory + server dir + filename used by buildMiddlewareRegistry plugin. */
+const RELATIVE_MIDDLEWARE_REGISTRY_SOURCE = "src/server/middleware-registry.ts";
+/** Extensions to try for the built middlewares module (ESM first, then CJS for backwards compatibility). */
+const MIDDLEWARE_REGISTRY_BUILT_EXTENSIONS = [
+	".mjs",
+	".js",
+	".cjs"
+];
+/** All paths to try when loading the built middlewares (base + extension). */
+const RELATIVE_MIDDLEWARE_REGISTRY_BUILT_PATHS = ["bld/server/middleware-registry", "build/server/middleware-registry"].flatMap((base) => MIDDLEWARE_REGISTRY_BUILT_EXTENSIONS.map((ext) => `${base}${ext}`));
 /**
 * Create a unified Express server for development, preview, or production mode
 */
@@ -993,13 +1004,22 @@ async function createServer$1(options) {
 		const bundlePath = getBundlePath(bundleId);
 		app.use(bundlePath, createStaticMiddleware(bundleId, projectDirectory));
 	}
-	const middlewareRegistryPath = resolve(projectDirectory, "src/server/middleware-registry.ts");
-	if (existsSync(middlewareRegistryPath)) {
-		const registry = await importTypescript(middlewareRegistryPath, { projectDirectory });
-		if (registry.customMiddlewares && Array.isArray(registry.customMiddlewares)) registry.customMiddlewares.forEach((middleware) => {
-			app.use(middleware);
-		});
+	let registry = null;
+	if (mode === "development") {
+		const middlewareRegistryPath = resolve(projectDirectory, RELATIVE_MIDDLEWARE_REGISTRY_SOURCE);
+		if (existsSync(middlewareRegistryPath)) registry = await importTypescript(middlewareRegistryPath, { projectDirectory });
+	} else {
+		const possiblePaths = RELATIVE_MIDDLEWARE_REGISTRY_BUILT_PATHS.map((p) => resolve(projectDirectory, p));
+		let builtRegistryPath = null;
+		for (const path$1 of possiblePaths) if (existsSync(path$1)) {
+			builtRegistryPath = path$1;
+			break;
+		}
+		if (builtRegistryPath) registry = await import(pathToFileURL$1(builtRegistryPath).href);
 	}
+	if (registry?.customMiddlewares && Array.isArray(registry.customMiddlewares)) registry.customMiddlewares.forEach((entry) => {
+		app.use(entry.handler);
+	});
 	if (mode === "development" && vite) app.use(vite.middlewares);
 	if (enableProxy) app.use(config.commerce.api.proxy, createCommerceProxyMiddleware(config));
 	app.use(createHostHeaderMiddleware());

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":["ExtensionMeta","ExtensionConfig","Record","default"],"sources":["../src/plugins/staticRegistry.ts","../src/plugins/eventInstrumentationValidator.ts","../src/plugin.ts","../src/plugins/transformPlugins.ts","../src/types.ts","../src/commands/push.ts","../src/server/config.ts","../src/server/modes.ts","../src/server/index.ts","../src/extensibility/extension-config.d.ts","../src/extensibility/trim-extensions.ts","../src/cartridge-services/generate-cartridge.ts"],"sourcesContent":["/**\n * Copyright 2026 Salesforce, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nexport type ExtensionMeta = {\n    name: string;\n    description: string;\n    installationInstructions: string;\n    uninstallationInstructions: string;\n    folder: string;\n    dependencies: string[];\n    defaultOn?: boolean;\n};\n\ndeclare const ExtensionConfig: {\n    extensions: Record<string, ExtensionMeta>;\n};\n\nexport default ExtensionConfig;\n"],"mappings":";;;;;;;;;;AOeY,UPsCK,0BAAA,COtCK;EAKL;;;;ECYA,aAAA,CAAA,EAAc,MAAA;EAAgB;;;;;;EAAD,YAAA,CAAA,EAAA,MAAA;EA0BxB;;;;EAA6C,kBAAA,CAAA,EAAA,MAAA;;;;AC3CnE;EAUcC,WAAAA,CAAAA,EAAAA,OAEb;;;;ACJqD;EAW9B,OAAA,CAAA,EAAA,OAAc;;;;;;;;APRtB,UFFC,mCAAA,CEWc;;;;ACc/B;;;;AChBA;;;;ACXA;AAoBA;AAuDA;;;;AClFA;AAKA;;;;;;;AJMA;;UDKiB,2BAAA;;AEkBjB;;;;AChBA;;;;ACXA;AAoBA;AAuDA;;;;AClFA;AAKA;;;;ACYA;;;EAQa,kBAAA,CAAA,EAAA,OAAA;EAMF;;;;AAYX;;;;EAAmE,cAAA,CAAA,ENO9C,0BMP8C;;;;AC3CnE;AAQE;;;;ECGG,6BAAmB,CAAA,ERiDY,mCQjDH,GAAA,KAAA;AAAA;;;;;;;;AC8pBjC;AAwBA;AA8CA;;;;;;;;;;iBT7pBgB,qBAAA,UAA8B,8BAAmC;;;iBCvEjE,gCAAA,CAAA;;;yBASe;;EHkBd,SAAA,CAAA,IAAA,EAAA,MAAA,EAAA,EAAA,EAAA,MAA0B,CAAA,EAAA;;;;AC7B3C,CAAA;;;;UGyBiB,WAAA;;EIjBA,cAAA,CAAA,EAAc,MAAA;EAAgB,OAAA,CAAA,EAAA,MAAA;EAErC,WAAA,CAAA,EAAA,MAAA;EAMG,MAAA,CAAA,EAAA,MAAA;EAMF,WAAA,CAAA,EAAA,MAAA;EAGC,eAAA,CAAA,EAAA,MAAA;EAjB2B,IAAA,CAAA,EAAA,MAAA;EAAO,GAAA,CAAA,EAAA,MAAA;EA0BxB,IAAA,CAAA,EAAA,OAAA;;;;;;;iBHzBA,IAAA,UAAc,cAAc;;;;;;UCXjC,YAAA;;;MN+BA,SAAA,EAAA,MAAA;;;;MC7BA,KAAA,EAAA,MAAA;;;;ACOjB;AAkEA;;;;ACvEA;;;iBGgBgB,iBAAA,CAAA,GAAqB;AFOrC;;;;AChBA;;;iBCgEsB,iBAAA,4BAA6C,QAAQ;;;;;;;;;AN5C3E;;;;AC7BA;;;;ACOA;AAkEgB,KKlFJ,UAAA,GLkFI,aAAqB,GAAS,SAAA,GAAA,YAAA;;;;ACvE9B,UINC,kBAAA,CJMD;;;;ECuBC,mBAAW,EAAA,OAAA;;;;EChBN,aAAI,EAAA,OAAU;;;;;;UGDnB,aAAA,SAAsB,QAAQ;;QAErC;EJeO;;;WITJ;EHPS;;;SGaX;EFxBM;EAoBD,KAAA,CAAA,EEOJ,WFPI;EAuDM;;;;AClFtB;AAKA;iBCsCsB,YAAA,UAAsB,gBAAgB,QAAQ;;;;;;;;;ARLpE;;;;AC7BA;;;;ACOA;AAkEgB,KOlFJD,aAAAA,GPkFyB;;;;ECvErB,0BAAA,EAAA,MAAA;;;;ACuBhB,CAAA;cKxBcC;cACEC,eAAeF;AJO/B,CAAA;;;KKPK,mBAAA,GAAsB;iBAQH,cAAA,yCAEC,QAAQ,+CACJ;;;;;;AVgBZ,UWmoBA,uBAAA,CXnoB0B;;;;AC7B3C;;;;ACOA;AAkEA;;;;ACvEA;;;;ACuBA;;;;AChBsB,UM+qBL,sBAAA,CN/qBiC;;;;ECXjC,UAAA,EAAA,MAAY;AAoB7B;AAuDsB,iBK6pBA,gBAAA,CL7pBqD,gBAAR,EAAO,MAAA,EAAA,iBAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EKgqB5D,uBLhqB4D,CAAA,EKiqBvE,OLjqBuE,CKiqB/D,sBLjqB+D,CAAA"}
+{"version":3,"file":"index.d.ts","names":["ExtensionMeta","ExtensionConfig","Record","default"],"sources":["../src/plugins/staticRegistry.ts","../src/plugins/eventInstrumentationValidator.ts","../src/plugin.ts","../src/plugins/transformPlugins.ts","../src/types.ts","../src/commands/push.ts","../src/server/config.ts","../src/server/modes.ts","../src/server/index.ts","../src/extensibility/extension-config.d.ts","../src/extensibility/trim-extensions.ts","../src/cartridge-services/generate-cartridge.ts"],"sourcesContent":["/**\n * Copyright 2026 Salesforce, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nexport type ExtensionMeta = {\n    name: string;\n    description: string;\n    installationInstructions: string;\n    uninstallationInstructions: string;\n    folder: string;\n    dependencies: string[];\n    defaultOn?: boolean;\n};\n\ndeclare const ExtensionConfig: {\n    extensions: Record<string, ExtensionMeta>;\n};\n\nexport default ExtensionConfig;\n"],"mappings":";;;;;;;;;;AOeY,UPsCK,0BAAA,COtCK;EAKL;;;;EC8BA,aAAA,CAAA,EAAc,MAAA;EAAgB;;;;;;EAAD,YAAA,CAAA,EAAA,MAAA;EA0BxB;;;;EAA6C,kBAAA,CAAA,EAAA,MAAA;;;;AC7DnE;EAUcC,WAAAA,CAAAA,EAAAA,OAEb;;;;ACJqD;EAW9B,OAAA,CAAA,EAAA,OAAc;;;;;;;;APRtB,UFFC,mCAAA,CEWc;;;;ACc/B;;;;AChBA;;;;ACXA;AAoBA;AAuDA;;;;AClFA;AAKA;;;;;;;AJMA;;UDMiB,2BAAA;;AEiBjB;;;;AChBA;;;;ACXA;AAoBA;AAuDA;;;;AClFA;AAKA;;;;AC8BA;;;EAQa,kBAAA,CAAA,EAAA,OAAA;EAMF;;;;AAYX;;;;EAAmE,cAAA,CAAA,ENV9C,0BMU8C;;;;AC7DnE;AAQE;;;;ECGG,6BAAmB,CAAA,ERkDY,mCQlDH,GAAA,KAAA;AAAA;;;;;;;;AC8pBjC;AAwBA;AA8CA;;;;;;;;;;iBT5pBgB,qBAAA,UAA8B,8BAAmC;;;iBCxEjE,gCAAA,CAAA;;;yBASe;;EHkBd,SAAA,CAAA,IAAA,EAAA,MAAA,EAAA,EAAA,EAAA,MAA0B,CAAA,EAAA;;;;AC7B3C,CAAA;;;;UGyBiB,WAAA;;EICA,cAAA,CAAA,EAAc,MAAA;EAAgB,OAAA,CAAA,EAAA,MAAA;EAErC,WAAA,CAAA,EAAA,MAAA;EAMG,MAAA,CAAA,EAAA,MAAA;EAMF,WAAA,CAAA,EAAA,MAAA;EAGC,eAAA,CAAA,EAAA,MAAA;EAjB2B,IAAA,CAAA,EAAA,MAAA;EAAO,GAAA,CAAA,EAAA,MAAA;EA0BxB,IAAA,CAAA,EAAA,OAAA;;;;;;;iBH3CA,IAAA,UAAc,cAAc;;;;;;UCXjC,YAAA;;;MN+BA,SAAA,EAAA,MAAA;;;;MC7BA,KAAA,EAAA,MAAA;;;;ACQjB;AAkEA;;;;ACxEA;;;iBGgBgB,iBAAA,CAAA,GAAqB;AFOrC;;;;AChBA;;;iBCgEsB,iBAAA,4BAA6C,QAAQ;;;;;;;;;AN5C3E;;;;AC7BA;;;;ACQA;AAkEgB,KKnFJ,UAAA,GLmFI,aAAqB,GAAS,SAAA,GAAA,YAAA;;;;ACxE9B,UINC,kBAAA,CJMD;;;;ECuBC,mBAAW,EAAA,OAAA;;;;EChBN,aAAI,EAAA,OAAU;;;;;;UGiBnB,aAAA,SAAsB,QAAQ;;QAErC;EJHO;;;WISJ;EHzBS;;;SG+BX;EF1CM;EAoBD,KAAA,CAAA,EEyBJ,WFzBI;EAuDM;;;;AClFtB;AAKA;iBCwDsB,YAAA,UAAsB,gBAAgB,QAAQ;;;;;;;;;ARvBpE;;;;AC7BA;;;;ACQA;AAkEgB,KOnFJD,aAAAA,GPmFyB;;;;ECxErB,0BAAA,EAAA,MAAA;;;;ACuBhB,CAAA;cKxBcC;cACEC,eAAeF;AJO/B,CAAA;;;KKPK,mBAAA,GAAsB;iBAQH,cAAA,yCAEC,QAAQ,+CACJ;;;;;;AVgBZ,UWmoBA,uBAAA,CXnoB0B;;;;AC7B3C;;;;ACQA;AAkEA;;;;ACxEA;;;;ACuBA;;;;AChBsB,UM+qBL,sBAAA,CN/qBiC;;;;ECXjC,UAAA,EAAA,MAAY;AAoB7B;AAuDsB,iBK6pBA,gBAAA,CL7pBqD,gBAAR,EAAO,MAAA,EAAA,iBAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EKgqB5D,uBLhqB4D,CAAA,EKiqBvE,OLjqBuE,CKiqB/D,sBLjqB+D,CAAA"}

package/dist/index.js

@@ -18,6 +18,7 @@ import chalk from "chalk";
 import express from "express";
 import { createRequestHandler } from "@react-router/express";
 import { existsSync as existsSync$1, readFileSync as readFileSync$1, unlinkSync } from "node:fs";
+import { pathToFileURL as pathToFileURL$1 } from "node:url";
 import { createProxyMiddleware } from "http-proxy-middleware";
 import compression from "compression";
 import zlib from "node:zlib";
@@ -245,18 +246,21 @@ const MODULE_TO_PATCH = "react-router";
 */
 const patchReactRouterPlugin = () => {
 	let isTestMode = false;
+	let isDevMode = false;
 	return {
 		name: "odyssey:patch-react-router",
 		enforce: "pre",
 		config(_config, { mode }) {
 			isTestMode = mode === "test";
+			isDevMode = mode === "development";
 		},
 		configEnvironment(name) {
 			if (isTestMode) return;
+			if (isDevMode) return;
 			if (name === "ssr") return { resolve: { noExternal: ["react-router"] } };
 		},
 		resolveId(id, importer) {
-			if (isTestMode) return null;
+			if (isTestMode || isDevMode) return null;
 			if (id === MODULE_TO_PATCH) {
 				if (importer === VIRTUAL_MODULE_ID || importer?.includes("storefront-next-dev")) return null;
 				return VIRTUAL_MODULE_ID;
@@ -264,7 +268,7 @@ const patchReactRouterPlugin = () => {
 			return null;
 		},
 		load(id) {
-			if (isTestMode) return null;
+			if (isTestMode || isDevMode) return null;
 			if (id === VIRTUAL_MODULE_ID) return `
                     export * from 'react-router';
                     export { Scripts } from '@salesforce/storefront-next-dev/react-router/Scripts';
@@ -942,6 +946,79 @@ const eventInstrumentationValidatorPlugin = (config = {}) => {
 	};
 };
 
+//#endregion
+//#region src/plugins/buildMiddlewareRegistry.ts
+/** Source filename for the middleware registry (project source). */
+const MIDDLEWARE_REGISTRY_SOURCE_FILE = "middleware-registry.ts";
+/** Subdirectory under build output where the compiled registry is written (must match server/index.ts expectations). */
+const SERVER_OUT_SUBDIR = "server";
+/**
+* Vite plugin that builds the middleware registry file for production.
+*
+* This plugin reads the template's middleware registry from the app's server directory
+* (e.g. `src/server/middleware-registry.ts` when appDirectory is `./src`) and compiles it
+* into the build output's server directory so the production server (Managed Runtime)
+* can load the custom Express middlewares.
+*
+* Compilation uses tsdown (single TypeScript file → ESM) instead of a full Vite build.
+* Paths are derived from the React Router plugin context (appDirectory, buildDirectory)
+* when available; there are no env vars for these paths in this package.
+*
+* If the middleware registry file does not exist, the plugin silently skips the build step.
+*
+* @returns {Plugin} A Vite plugin that compiles the middleware registry for production
+*
+* @example
+* // In vite.config.ts
+* export default defineConfig({
+*   plugins: [
+*     buildMiddlewareRegistryPlugin()
+*   ]
+* })
+*/
+const buildMiddlewareRegistryPlugin = () => {
+	let resolvedConfig;
+	let buildDirectory;
+	/** App source directory (e.g. 'src' or './src') from React Router config. */
+	let appDirectory;
+	return {
+		name: "odyssey:build-middleware-registry",
+		apply: "build",
+		configResolved(config) {
+			resolvedConfig = config;
+			const rr = config.__reactRouterPluginContext?.reactRouterConfig ?? {};
+			buildDirectory = rr.buildDirectory ?? resolve$1(config.root, "build");
+			appDirectory = rr.appDirectory ?? "src";
+		},
+		buildApp: {
+			order: "post",
+			handler: async () => {
+				const projectRoot = resolvedConfig.root;
+				const middlewareRegistryPath = resolve$1(projectRoot, appDirectory, SERVER_OUT_SUBDIR, MIDDLEWARE_REGISTRY_SOURCE_FILE);
+				if (!existsSync(middlewareRegistryPath)) return;
+				const { build } = await import("tsdown");
+				const serverOutDir = resolve$1(projectRoot, buildDirectory, SERVER_OUT_SUBDIR);
+				await build({
+					cwd: projectRoot,
+					entry: { [MIDDLEWARE_REGISTRY_SOURCE_FILE.replace(/\.ts$/, "")]: middlewareRegistryPath },
+					outDir: serverOutDir,
+					format: ["esm"],
+					platform: "node",
+					outExtensions: () => ({
+						js: ".mjs",
+						dts: ".d.ts"
+					}),
+					dts: false,
+					clean: false,
+					hash: false,
+					noExternal: [/.*/],
+					external: [/^node:/]
+				});
+			}
+		}
+	};
+};
+
 //#endregion
 //#region src/plugin.ts
 /**
@@ -979,7 +1056,8 @@ function storefrontNextPlugins(config = {}) {
 		fixReactRouterManifestUrlsPlugin(),
 		patchReactRouterPlugin(),
 		transformPluginPlaceholderPlugin(),
-		watchConfigFilesPlugin()
+		watchConfigFilesPlugin(),
+		buildMiddlewareRegistryPlugin()
 	];
 	if (staticRegistry?.componentPath && staticRegistry?.registryPath) plugins.push(staticRegistryPlugin(staticRegistry));
 	if (eventInstrumentationValidator !== false) plugins.push(eventInstrumentationValidatorPlugin(eventInstrumentationValidator));
@@ -989,7 +1067,7 @@ function storefrontNextPlugins(config = {}) {
 
 //#endregion
 //#region package.json
-var version = "0.1.0";
+var version = "0.1.1";
 
 //#endregion
 //#region src/utils/logger.ts
@@ -1763,6 +1841,16 @@ const ServerModeFeatureMap = {
 
 //#endregion
 //#region src/server/index.ts
+/** Relative path to the middleware registry TypeScript source (development). Must match appDirectory + server dir + filename used by buildMiddlewareRegistry plugin. */
+const RELATIVE_MIDDLEWARE_REGISTRY_SOURCE = "src/server/middleware-registry.ts";
+/** Extensions to try for the built middlewares module (ESM first, then CJS for backwards compatibility). */
+const MIDDLEWARE_REGISTRY_BUILT_EXTENSIONS = [
+	".mjs",
+	".js",
+	".cjs"
+];
+/** All paths to try when loading the built middlewares (base + extension). */
+const RELATIVE_MIDDLEWARE_REGISTRY_BUILT_PATHS = ["bld/server/middleware-registry", "build/server/middleware-registry"].flatMap((base) => MIDDLEWARE_REGISTRY_BUILT_EXTENSIONS.map((ext) => `${base}${ext}`));
 /**
 * Create a unified Express server for development, preview, or production mode
 */
@@ -1780,13 +1868,22 @@ async function createServer(options) {
 		const bundlePath = getBundlePath(bundleId);
 		app.use(bundlePath, createStaticMiddleware(bundleId, projectDirectory));
 	}
-	const middlewareRegistryPath = resolve(projectDirectory, "src/server/middleware-registry.ts");
-	if (existsSync$1(middlewareRegistryPath)) {
-		const registry = await importTypescript(middlewareRegistryPath, { projectDirectory });
-		if (registry.customMiddlewares && Array.isArray(registry.customMiddlewares)) registry.customMiddlewares.forEach((middleware) => {
-			app.use(middleware);
-		});
+	let registry = null;
+	if (mode === "development") {
+		const middlewareRegistryPath = resolve(projectDirectory, RELATIVE_MIDDLEWARE_REGISTRY_SOURCE);
+		if (existsSync$1(middlewareRegistryPath)) registry = await importTypescript(middlewareRegistryPath, { projectDirectory });
+	} else {
+		const possiblePaths = RELATIVE_MIDDLEWARE_REGISTRY_BUILT_PATHS.map((p) => resolve(projectDirectory, p));
+		let builtRegistryPath = null;
+		for (const path$2 of possiblePaths) if (existsSync$1(path$2)) {
+			builtRegistryPath = path$2;
+			break;
+		}
+		if (builtRegistryPath) registry = await import(pathToFileURL$1(builtRegistryPath).href);
 	}
+	if (registry?.customMiddlewares && Array.isArray(registry.customMiddlewares)) registry.customMiddlewares.forEach((entry) => {
+		app.use(entry.handler);
+	});
 	if (mode === "development" && vite) app.use(vite.middlewares);
 	if (enableProxy) app.use(config.commerce.api.proxy, createCommerceProxyMiddleware(config));
 	app.use(createHostHeaderMiddleware());