@moostjs/vite 0.6.25 → 0.6.27

package/README.md

@@ -101,6 +101,8 @@ moostVite({
 })
 ```
 
+Note that the production server generated by `vite build` defaults the prefix to `'/api'` when the option is omitted — set `prefix` explicitly so dev (where all requests pass through Moost without it) and prod route the same way.
+
 ## SSR Mode
 
 Add `ssrEntry` to enable server-side rendering. The plugin handles everything automatically — SSR rendering in dev, multi-environment builds for production:
@@ -180,7 +182,7 @@ export default defineConfig({
 
 **Don't externalize:** workspace packages (`workspace:*`), anything that uses `Symbol()` as a public slot key (Moost, wooks, atscript), anything not reliably hoisted by pnpm.
 
-You can also opt out of bundle-everything by setting `ssr.noExternal` to an explicit list — the plugin honors it literally (appending only `/^@moostjs\/vite($|\/)/` so its own `define:` substitutions still land):
+You can also opt out of bundle-everything by setting `ssr.noExternal` to an explicit list — the plugin honors it, appending `/^@moostjs\/vite($|\/)/` (so its own `define:` substitutions still land) plus, unless you externalize the runtime yourself, the moost/wooks runtime patterns described below:
 
 ```ts
 ssr: {
@@ -225,12 +227,12 @@ The plugin injects a `__VITE_ID` decorator on `@Injectable` and `@Controller` cl
 | `host` | `string` | `'localhost'` | Dev server host (backend mode only) |
 | `outDir` | `string` | `'dist'` | Build output directory (backend mode only) |
 | `format` | `'cjs' \| 'esm'` | `'esm'` | Output module format (backend mode only) |
-| `sourcemap` | `boolean` | `true` | Generate source maps (backend mode only) |
+| `sourcemap` | `boolean` | `true` | Generate source maps (both modes; in middleware mode applies to the `dist/server` SSR build) |
 | `externals` | `boolean \| object` | `true` | Configure external dependencies (backend mode only) |
 | `onEject` | `function` | — | Hook to control DI instance ejection during HMR |
 | `ssrFetch` | `boolean` | `true` | Enable local fetch interception for SSR |
 | `middleware` | `boolean` | `false` | Run Moost as Connect middleware (Vite serves frontend) |
-| `prefix` | `string` | — | URL prefix filter for middleware mode (e.g. `'/api'`) |
+| `prefix` | `string` | `'/api'` (prod server) | URL prefix filter for middleware mode (e.g. `'/api'`); the production server defaults to `'/api'` when omitted |
 | `ssrEntry` | `string` | — | Vue/React SSR entry module (e.g. `'/src/entry-server.ts'`) |
 | `ssrOutlet` | `string` | `'<!--ssr-outlet-->'` | HTML placeholder for SSR-rendered content |
 | `ssrState` | `string` | `'<!--ssr-state-->'` | HTML placeholder for SSR state transfer script |

package/dist/index.cjs

@@ -42,6 +42,31 @@ function entryBasename(entry) {
 	return entry.split("/").pop().replace(/\.ts$/, ".js");
 }
 /**
+* Normalizes the `prefix` option (single mount or list of mounts) into a list of
+* normalized entries: leading slash ensured, trailing slash stripped.
+* Returns `undefined` when no prefix is configured (empty input included) —
+* the "route everything through Moost first" mode.
+*/ function normalizePrefixes(prefix) {
+	if (!prefix) return;
+	const normalized = (Array.isArray(prefix) ? prefix : [prefix]).filter(Boolean).map((entry) => {
+		let value = entry;
+		if (!value.startsWith("/")) value = `/${value}`;
+		if (value.endsWith("/")) value = value.slice(0, -1);
+		return value;
+	});
+	return normalized.length > 0 ? normalized : void 0;
+}
+/**
+* Checks whether a request url falls under any of the normalized prefix mounts:
+* exact match, a path segment below it, or the mount itself with a query string.
+*/ function matchesPrefix(url, prefixes) {
+	return prefixes.some((prefix) => {
+		if (!url.startsWith(prefix)) return false;
+		const next = url[prefix.length];
+		return next === void 0 || next === "/" || next === "?";
+	});
+}
+/**
 * Recursively gathers all importer modules upstream from a given module.
 *
 * @param {EnvironmentModuleNode | undefined} moduleNode - The starting module node.
@@ -340,13 +365,7 @@ function moostVite(options) {
 	const isTest = process.env.NODE_ENV === "test";
 	const isProd = process.env.NODE_ENV === "production";
 	const externals = options.externals ?? true;
-	let prefix = options.prefix;
-	if (prefix) {
-		if (!prefix.startsWith("/")) prefix = `/${prefix}`;
-		if (prefix.endsWith("/")) prefix = prefix.slice(0, -1);
-	}
-	const prefixSlash = prefix ? `${prefix}/` : void 0;
-	const prefixQuery = prefix ? `${prefix}?` : void 0;
+	const prefixes = normalizePrefixes(options.prefix);
 	let moostMiddleware = null;
 	let localFetchTeardown = null;
 	/** In middleware mode: maps req → next() for the onNoMatch callback */ const pendingNextMap = /* @__PURE__ */ new WeakMap();
@@ -379,6 +398,31 @@ function moostVite(options) {
 	* Drains any pending Moost app reload before a request is served. Assigned once
 	* the SSR module runner exists (see configureServer); a no-op until then.
 	*/ let drainReload = () => Promise.resolve();
+	/**
+	* Last Moost entry import failure. While set, the dev middleware answers matching
+	* requests with 502 instead of letting them fall through to the SPA/SSR fallback
+	* (which would serve index.html for API routes). Cleared on a successful reload;
+	* the next hot update schedules the retry.
+	*/ let bootError = null;
+	/**
+	* Looks up the Moost entry node with the verbatim `options.entry` string — the
+	* module graph keys (and memoizes) unresolved urls as-is, so the same spelling
+	* that was passed to `runner.import()` is guaranteed to return the very node
+	* that import created.
+	*/ const getEntryModule = (moduleGraph) => moduleGraph.getModuleByUrl(options.entry);
+	/**
+	* Drops the captured Moost app so the next request triggers a full reload:
+	* releases the middleware + local fetch and ejects DI instances affected by
+	* the changed modules.
+	*/ const ejectApp = (cleanupInstances) => {
+		moostMiddleware = null;
+		if (localFetchTeardown) {
+			localFetchTeardown();
+			localFetchTeardown = null;
+		}
+		moostRestartCleanup(adapters, options.onEject, cleanupInstances);
+		reloadRequired = true;
+	};
 	patchMoostHandlerLogging();
 	const pluginConfig = {
 		name: PLUGIN_NAME,
@@ -390,7 +434,7 @@ function moostVite(options) {
 				const serverDefines = {
 					"process.env.MOOST_DEFERRED_ENV": "\"production\"",
 					__MOOST_ENTRY__: JSON.stringify(`./${entryKey}.js`),
-					__MOOST_PREFIX__: JSON.stringify(prefix || "/api")
+					__MOOST_PREFIX__: JSON.stringify(prefixes ?? null)
 				};
 				const ssrInput = {
 					server: options.serverEntry || generatedServerEntry(cfg.root),
@@ -487,7 +531,7 @@ function moostVite(options) {
 				entry: options.entry,
 				ssrEntry: options.ssrEntry,
 				serverEntry: options.serverEntry,
-				prefix,
+				prefix: prefixes,
 				port: options.port,
 				ssrOutlet: options.ssrOutlet,
 				ssrState: options.ssrState
@@ -523,16 +567,27 @@ function moostVite(options) {
 			};
 		},
 		async configureServer(server) {
-			const runner = (0, vite.createServerModuleRunner)(server.environments.ssr);
+			const runner = (0, vite.createServerModuleRunner)(server.environments.ssr, { hmr: false });
 			const ssrImport = (id) => runner.import(id);
+			bootError = null;
+			reloadRequired = false;
+			reloadPromise = null;
 			const runReload = () => {
 				reloadRequired = false;
 				console.log();
 				logger.debug("🚀 Reloading Moost App...");
 				console.log();
 				return (async () => {
-					for (const adapter of adapters) if (adapter.detected) await adapter.init();
-					await ssrImport(options.entry);
+					try {
+						for (const adapter of adapters) if (adapter.detected) await adapter.init();
+						const entryModule = await getEntryModule(server.environments.ssr.moduleGraph);
+						if (entryModule?.transformResult) server.environments.ssr.moduleGraph.invalidateModule(entryModule);
+						await ssrImport(options.entry);
+						bootError = null;
+					} catch (error) {
+						bootError = error;
+						logger.error(`✖️  Failed to reload Moost App: ${error.message}`);
+					}
 					await new Promise((resolve) => setTimeout(resolve, 1));
 				})().finally(() => {
 					reloadPromise = null;
@@ -549,10 +604,7 @@ function moostVite(options) {
 			await ssrImport(options.entry);
 			server.middlewares.use(async (req, res, next) => {
 				await drainReload();
-				if (options.middleware && prefix) {
-					const url = req.url || "";
-					if (url !== prefix && !url.startsWith(prefixSlash) && !url.startsWith(prefixQuery)) return next();
-				}
+				if (options.middleware && prefixes && !matchesPrefix(req.url || "", prefixes)) return next();
 				if (moostMiddleware) {
 					if (options.middleware) {
 						pendingNextMap.set(req, next);
@@ -561,30 +613,29 @@ function moostVite(options) {
 					}
 					return moostMiddleware(req, res);
 				}
+				if (bootError) {
+					res.statusCode = 502;
+					res.setHeader("Content-Type", "text/plain");
+					res.end(`Moost app failed to load: ${bootError.message}`);
+					return;
+				}
 				next();
 			});
 		},
-		hotUpdate({ file }) {
-			if (file.endsWith(".ts")) {
-				const modules = this.environment.moduleGraph.getModulesByFile(file);
-				if (modules) {
-					logger.debug(`🔃 Hot update: ${file}`);
-					const cleanupInstances = /* @__PURE__ */ new Set();
-					for (const mod of modules) {
-						const allImporters = gatherAllImporters(mod);
-						for (const impModule of allImporters) if (impModule.id) cleanupInstances.add(impModule.id);
-						this.environment.moduleGraph.invalidateModule(mod);
-					}
-					moostMiddleware = null;
-					if (localFetchTeardown) {
-						localFetchTeardown();
-						localFetchTeardown = null;
-					}
-					moostRestartCleanup(adapters, options.onEject, cleanupInstances);
-					reloadRequired = true;
-				}
-				return [];
-			}
+		async hotUpdate({ file, modules }) {
+			if (this.environment.name !== "ssr" || modules.length === 0) return;
+			const { moduleGraph } = this.environment;
+			const entryModule = await getEntryModule(moduleGraph);
+			const importerSets = modules.map((mod) => gatherAllImporters(mod));
+			if (entryModule && !importerSets.some((importers) => importers.has(entryModule))) return;
+			logger.debug(`🔃 Hot update: ${file}`);
+			const cleanupInstances = /* @__PURE__ */ new Set();
+			for (const importers of importerSets) for (const impModule of importers) if (impModule.id) cleanupInstances.add(impModule.id);
+			for (const mod of modules) moduleGraph.invalidateModule(mod);
+			if (entryModule) moduleGraph.invalidateModule(entryModule);
+			else moduleGraph.invalidateAll();
+			ejectApp(cleanupInstances);
+			return [];
 		}
 	};
 	if (isProd || isTest) {
@@ -606,7 +657,7 @@ function moostVite(options) {
 					const url = req.originalUrl || req.url || "/";
 					try {
 						await drainReload();
-						let template = await fs.readFile((0, node_path.resolve)(process.cwd(), "index.html"), "utf8");
+						let template = await fs.readFile((0, node_path.resolve)(server.config.root, "index.html"), "utf8");
 						template = await server.transformIndexHtml(url, template);
 						const { render } = await server.ssrLoadModule(options.ssrEntry);
 						const { html: appHtml, state } = await render(url);

package/dist/index.d.ts

@@ -78,9 +78,10 @@ interface TMoostViteDevOptions {
     ssrFetch?: boolean;
     /**
      * Run Moost as Connect middleware instead of taking over the server.
-     * When enabled, Moost handles only matching routes (guarded by `prefix`),
-     * and unmatched requests fall through to Vite's default handler
-     * (static assets, Vue/React pages, HMR client).
+     * When enabled, Moost runs first and unmatched requests fall through to
+     * Vite's default handler (static assets, Vue/React pages, HMR client).
+     * With `prefix` configured, requests outside the mount(s) skip the Moost
+     * router entirely (fast path).
      *
      * Use this for fullstack apps where Vite serves the frontend (Vue, React, etc.)
      * and Moost handles API routes.
@@ -89,13 +90,16 @@ interface TMoostViteDevOptions {
      */
     middleware?: boolean;
     /**
-     * URL prefix for Moost API routes in middleware mode.
-     * Only requests starting with this prefix are dispatched to Moost.
+     * URL mount(s) for Moost routes in middleware mode — a single prefix or a
+     * list of prefixes. Requests outside every mount skip the Moost router and
+     * go straight to the frontend handler (an optimization/guard, in both dev
+     * and the generated prod server). When omitted, every request enters Moost
+     * first and unmatched routes fall through to the frontend.
      * Ignored when `middleware` is `false`.
      *
-     * Example: `'/api'`
+     * Example: `'/api'` or `['/api', '/.well-known']`
      */
-    prefix?: string;
+    prefix?: string | string[];
     /**
      * Vue/React SSR entry module path. Used by the SSR server helper
      * (`@moostjs/vite/server`) for server-side rendering.

package/dist/index.mjs

@@ -13,6 +13,31 @@ function entryBasename(entry) {
 	return entry.split("/").pop().replace(/\.ts$/, ".js");
 }
 /**
+* Normalizes the `prefix` option (single mount or list of mounts) into a list of
+* normalized entries: leading slash ensured, trailing slash stripped.
+* Returns `undefined` when no prefix is configured (empty input included) —
+* the "route everything through Moost first" mode.
+*/ function normalizePrefixes(prefix) {
+	if (!prefix) return;
+	const normalized = (Array.isArray(prefix) ? prefix : [prefix]).filter(Boolean).map((entry) => {
+		let value = entry;
+		if (!value.startsWith("/")) value = `/${value}`;
+		if (value.endsWith("/")) value = value.slice(0, -1);
+		return value;
+	});
+	return normalized.length > 0 ? normalized : void 0;
+}
+/**
+* Checks whether a request url falls under any of the normalized prefix mounts:
+* exact match, a path segment below it, or the mount itself with a query string.
+*/ function matchesPrefix(url, prefixes) {
+	return prefixes.some((prefix) => {
+		if (!url.startsWith(prefix)) return false;
+		const next = url[prefix.length];
+		return next === void 0 || next === "/" || next === "?";
+	});
+}
+/**
 * Recursively gathers all importer modules upstream from a given module.
 *
 * @param {EnvironmentModuleNode | undefined} moduleNode - The starting module node.
@@ -309,13 +334,7 @@ function generatedServerEntry(root) {
 }
 function moostVite(options) {
 	const externals = options.externals ?? true;
-	let prefix = options.prefix;
-	if (prefix) {
-		if (!prefix.startsWith("/")) prefix = `/${prefix}`;
-		if (prefix.endsWith("/")) prefix = prefix.slice(0, -1);
-	}
-	const prefixSlash = prefix ? `${prefix}/` : void 0;
-	const prefixQuery = prefix ? `${prefix}?` : void 0;
+	const prefixes = normalizePrefixes(options.prefix);
 	let moostMiddleware = null;
 	let localFetchTeardown = null;
 	/** In middleware mode: maps req → next() for the onNoMatch callback */ const pendingNextMap = /* @__PURE__ */ new WeakMap();
@@ -348,6 +367,31 @@ function moostVite(options) {
 	* Drains any pending Moost app reload before a request is served. Assigned once
 	* the SSR module runner exists (see configureServer); a no-op until then.
 	*/ let drainReload = () => Promise.resolve();
+	/**
+	* Last Moost entry import failure. While set, the dev middleware answers matching
+	* requests with 502 instead of letting them fall through to the SPA/SSR fallback
+	* (which would serve index.html for API routes). Cleared on a successful reload;
+	* the next hot update schedules the retry.
+	*/ let bootError = null;
+	/**
+	* Looks up the Moost entry node with the verbatim `options.entry` string — the
+	* module graph keys (and memoizes) unresolved urls as-is, so the same spelling
+	* that was passed to `runner.import()` is guaranteed to return the very node
+	* that import created.
+	*/ const getEntryModule = (moduleGraph) => moduleGraph.getModuleByUrl(options.entry);
+	/**
+	* Drops the captured Moost app so the next request triggers a full reload:
+	* releases the middleware + local fetch and ejects DI instances affected by
+	* the changed modules.
+	*/ const ejectApp = (cleanupInstances) => {
+		moostMiddleware = null;
+		if (localFetchTeardown) {
+			localFetchTeardown();
+			localFetchTeardown = null;
+		}
+		moostRestartCleanup(adapters, options.onEject, cleanupInstances);
+		reloadRequired = true;
+	};
 	patchMoostHandlerLogging();
 	return [{
 		name: PLUGIN_NAME,
@@ -359,7 +403,7 @@ function moostVite(options) {
 				const serverDefines = {
 					"process.env.MOOST_DEFERRED_ENV": "\"production\"",
 					__MOOST_ENTRY__: JSON.stringify(`./${entryKey}.js`),
-					__MOOST_PREFIX__: JSON.stringify(prefix || "/api")
+					__MOOST_PREFIX__: JSON.stringify(prefixes ?? null)
 				};
 				const ssrInput = {
 					server: options.serverEntry || generatedServerEntry(cfg.root),
@@ -456,7 +500,7 @@ function moostVite(options) {
 				entry: options.entry,
 				ssrEntry: options.ssrEntry,
 				serverEntry: options.serverEntry,
-				prefix,
+				prefix: prefixes,
 				port: options.port,
 				ssrOutlet: options.ssrOutlet,
 				ssrState: options.ssrState
@@ -492,16 +536,27 @@ function moostVite(options) {
 			};
 		},
 		async configureServer(server) {
-			const runner = createServerModuleRunner(server.environments.ssr);
+			const runner = createServerModuleRunner(server.environments.ssr, { hmr: false });
 			const ssrImport = (id) => runner.import(id);
+			bootError = null;
+			reloadRequired = false;
+			reloadPromise = null;
 			const runReload = () => {
 				reloadRequired = false;
 				console.log();
 				logger.debug("🚀 Reloading Moost App...");
 				console.log();
 				return (async () => {
-					for (const adapter of adapters) if (adapter.detected) await adapter.init();
-					await ssrImport(options.entry);
+					try {
+						for (const adapter of adapters) if (adapter.detected) await adapter.init();
+						const entryModule = await getEntryModule(server.environments.ssr.moduleGraph);
+						if (entryModule?.transformResult) server.environments.ssr.moduleGraph.invalidateModule(entryModule);
+						await ssrImport(options.entry);
+						bootError = null;
+					} catch (error) {
+						bootError = error;
+						logger.error(`✖️  Failed to reload Moost App: ${error.message}`);
+					}
 					await new Promise((resolve) => setTimeout(resolve, 1));
 				})().finally(() => {
 					reloadPromise = null;
@@ -518,10 +573,7 @@ function moostVite(options) {
 			await ssrImport(options.entry);
 			server.middlewares.use(async (req, res, next) => {
 				await drainReload();
-				if (options.middleware && prefix) {
-					const url = req.url || "";
-					if (url !== prefix && !url.startsWith(prefixSlash) && !url.startsWith(prefixQuery)) return next();
-				}
+				if (options.middleware && prefixes && !matchesPrefix(req.url || "", prefixes)) return next();
 				if (moostMiddleware) {
 					if (options.middleware) {
 						pendingNextMap.set(req, next);
@@ -530,30 +582,29 @@ function moostVite(options) {
 					}
 					return moostMiddleware(req, res);
 				}
+				if (bootError) {
+					res.statusCode = 502;
+					res.setHeader("Content-Type", "text/plain");
+					res.end(`Moost app failed to load: ${bootError.message}`);
+					return;
+				}
 				next();
 			});
 		},
-		hotUpdate({ file }) {
-			if (file.endsWith(".ts")) {
-				const modules = this.environment.moduleGraph.getModulesByFile(file);
-				if (modules) {
-					logger.debug(`🔃 Hot update: ${file}`);
-					const cleanupInstances = /* @__PURE__ */ new Set();
-					for (const mod of modules) {
-						const allImporters = gatherAllImporters(mod);
-						for (const impModule of allImporters) if (impModule.id) cleanupInstances.add(impModule.id);
-						this.environment.moduleGraph.invalidateModule(mod);
-					}
-					moostMiddleware = null;
-					if (localFetchTeardown) {
-						localFetchTeardown();
-						localFetchTeardown = null;
-					}
-					moostRestartCleanup(adapters, options.onEject, cleanupInstances);
-					reloadRequired = true;
-				}
-				return [];
-			}
+		async hotUpdate({ file, modules }) {
+			if (this.environment.name !== "ssr" || modules.length === 0) return;
+			const { moduleGraph } = this.environment;
+			const entryModule = await getEntryModule(moduleGraph);
+			const importerSets = modules.map((mod) => gatherAllImporters(mod));
+			if (entryModule && !importerSets.some((importers) => importers.has(entryModule))) return;
+			logger.debug(`🔃 Hot update: ${file}`);
+			const cleanupInstances = /* @__PURE__ */ new Set();
+			for (const importers of importerSets) for (const impModule of importers) if (impModule.id) cleanupInstances.add(impModule.id);
+			for (const mod of modules) moduleGraph.invalidateModule(mod);
+			if (entryModule) moduleGraph.invalidateModule(entryModule);
+			else moduleGraph.invalidateAll();
+			ejectApp(cleanupInstances);
+			return [];
 		}
 	}, options.middleware && options.ssrEntry ? {
 		name: `${PLUGIN_NAME}:ssr-fallback`,
@@ -567,7 +618,7 @@ function moostVite(options) {
 					const url = req.originalUrl || req.url || "/";
 					try {
 						await drainReload();
-						let template = await fs.readFile(resolve(process.cwd(), "index.html"), "utf8");
+						let template = await fs.readFile(resolve(server.config.root, "index.html"), "utf8");
 						template = await server.transformIndexHtml(url, template);
 						const { render } = await server.ssrLoadModule(options.ssrEntry);
 						const { html: appHtml, state } = await render(url);

package/dist/prod-server.cjs

@@ -5,6 +5,31 @@ let moost = require("moost");
 const PLUGIN_NAME = "moost-vite";
 const DEFAULT_SSR_OUTLET = "<!--ssr-outlet-->";
 const DEFAULT_SSR_STATE = "<!--ssr-state-->";
+/**
+* Normalizes the `prefix` option (single mount or list of mounts) into a list of
+* normalized entries: leading slash ensured, trailing slash stripped.
+* Returns `undefined` when no prefix is configured (empty input included) —
+* the "route everything through Moost first" mode.
+*/ function normalizePrefixes(prefix) {
+	if (!prefix) return;
+	const normalized = (Array.isArray(prefix) ? prefix : [prefix]).filter(Boolean).map((entry) => {
+		let value = entry;
+		if (!value.startsWith("/")) value = `/${value}`;
+		if (value.endsWith("/")) value = value.slice(0, -1);
+		return value;
+	});
+	return normalized.length > 0 ? normalized : void 0;
+}
+/**
+* Checks whether a request url falls under any of the normalized prefix mounts:
+* exact match, a path segment below it, or the mount itself with a query string.
+*/ function matchesPrefix(url, prefixes) {
+	return prefixes.some((prefix) => {
+		if (!url.startsWith(prefix)) return false;
+		const next = url[prefix.length];
+		return next === void 0 || next === "/" || next === "?";
+	});
+}
 const logger = (0, moost.createLogger)({ level: 99 }).createTopic("\x1B[2m\x1B[36m" + PLUGIN_NAME);
 
 //#endregion
@@ -33,7 +58,7 @@ async function createSSRServer(options) {
 				if (req.method !== "GET") return next();
 				const url = req.originalUrl || req.url || "/";
 				try {
-					let template = await fs.readFile(path.resolve(process.cwd(), "index.html"), "utf8");
+					let template = await fs.readFile(path.resolve(vite.config.root, "index.html"), "utf8");
 					template = await vite.transformIndexHtml(url, template);
 					const { render } = await vite.ssrLoadModule(ssrEntry);
 					const { html: appHtml, state } = await render(url);
@@ -66,10 +91,7 @@ async function createSSRServer(options) {
 	const clientDir = opts.clientDir || path.resolve(__dirname, "../client");
 	const ssrOutlet = opts.ssrOutlet || (__MOOST_SSR_OUTLET__ !== void 0 ? __MOOST_SSR_OUTLET__ : "<!--ssr-outlet-->");
 	const ssrState = opts.ssrState || (__MOOST_SSR_STATE__ !== void 0 ? __MOOST_SSR_STATE__ : "<!--ssr-state-->");
-	let prefix = opts.prefix || __MOOST_PREFIX__;
-	if (!prefix.startsWith("/")) prefix = `/${prefix}`;
-	if (prefix.endsWith("/")) prefix = prefix.slice(0, -1);
-	const prefixSlash = `${prefix}/`;
+	const prefixes = normalizePrefixes(opts.prefix ?? __MOOST_PREFIX__);
 	const defaultPort = opts.port || Number(process.env.PORT) || 3e3;
 	const template = await fs.readFile(path.resolve(clientDir, "index.html"), "utf8");
 	let render = null;
@@ -83,7 +105,7 @@ async function createSSRServer(options) {
 	let captured = false;
 	const origListen = MoostHttp.prototype.listen;
 	MoostHttp.prototype.listen = function(...args) {
-		moostHandler = this.getServerCb();
+		moostHandler = this.getServerCb((req, res) => serveStatic(req, res));
 		moostHttpRef.instance = this;
 		captured = true;
 		setTimeout(() => args.filter((a) => typeof a === "function").forEach((a) => a()), 1);
@@ -108,6 +130,32 @@ async function createSSRServer(options) {
 	if (enableLocalFetch && moostHttpRef.instance) enableLocalFetch(moostHttpRef.instance);
 	const sirv = (await import("sirv")).default;
 	const serve = sirv(path.resolve(clientDir), { extensions: [] });
+	const serveStatic = (req, res) => {
+		const url = req.url || "/";
+		serve(req, res, async () => {
+			if (req.method !== "GET") {
+				res.statusCode = 404;
+				res.end();
+				return;
+			}
+			try {
+				if (render) {
+					const { html: appHtml, state } = await render(url);
+					res.statusCode = 200;
+					res.setHeader("Content-Type", "text/html");
+					res.end(template.replace(ssrOutlet, appHtml).replace(ssrState, state ? `<script>window.__SSR_STATE__=${state}<\/script>` : ""));
+				} else {
+					res.statusCode = 200;
+					res.setHeader("Content-Type", "text/html");
+					res.end(template);
+				}
+			} catch (error) {
+				console.error(error);
+				res.statusCode = 500;
+				res.end(error.message);
+			}
+		});
+	};
 	return {
 		use(mw) {
 			userMiddlewares.push(mw);
@@ -122,33 +170,11 @@ async function createSSRServer(options) {
 						userMiddlewares[i++](req, res, runNext);
 						return;
 					}
-					if (moostHandler && (url.startsWith(prefixSlash) || url === prefix || url.startsWith(`${prefix}?`))) {
+					if (moostHandler && (!prefixes || matchesPrefix(url, prefixes))) {
 						moostHandler(req, res);
 						return;
 					}
-					serve(req, res, async () => {
-						if (req.method !== "GET") {
-							res.statusCode = 404;
-							res.end();
-							return;
-						}
-						try {
-							if (render) {
-								const { html: appHtml, state } = await render(url);
-								res.statusCode = 200;
-								res.setHeader("Content-Type", "text/html");
-								res.end(template.replace(ssrOutlet, appHtml).replace(ssrState, state ? `<script>window.__SSR_STATE__=${state}<\/script>` : ""));
-							} else {
-								res.statusCode = 200;
-								res.setHeader("Content-Type", "text/html");
-								res.end(template);
-							}
-						} catch (error) {
-							console.error(error);
-							res.statusCode = 500;
-							res.end(error.message);
-						}
-					});
+					serveStatic(req, res);
 				};
 				runNext();
 			}).listen(p, () => {

package/dist/prod-server.d.ts

@@ -6,8 +6,13 @@ interface TSSRServerOptions {
     entry?: (() => Promise<unknown>) | string;
     /** Override: SSR entry module path (e.g., '/src/entry-server.ts') */
     ssrEntry?: string;
-    /** Override: URL prefix for API routes (e.g., '/api') */
-    prefix?: string;
+    /**
+     * Override: URL mount(s) for Moost routes (e.g., '/api' or ['/api', '/.well-known']).
+     * Requests outside every mount skip the Moost router (optimization/guard).
+     * When omitted (and not baked by the plugin), every request enters Moost first
+     * and unmatched routes fall through to static/SSR — same as dev.
+     */
+    prefix?: string | string[];
     /** Override: port number (default: process.env.PORT || 3000) */
     port?: number;
     /** Override: client build directory (default: 'dist/client') */

package/dist/prod-server.mjs

@@ -6,6 +6,31 @@ import { createLogger } from "moost";
 const PLUGIN_NAME = "moost-vite";
 const DEFAULT_SSR_OUTLET = "<!--ssr-outlet-->";
 const DEFAULT_SSR_STATE = "<!--ssr-state-->";
+/**
+* Normalizes the `prefix` option (single mount or list of mounts) into a list of
+* normalized entries: leading slash ensured, trailing slash stripped.
+* Returns `undefined` when no prefix is configured (empty input included) —
+* the "route everything through Moost first" mode.
+*/ function normalizePrefixes(prefix) {
+	if (!prefix) return;
+	const normalized = (Array.isArray(prefix) ? prefix : [prefix]).filter(Boolean).map((entry) => {
+		let value = entry;
+		if (!value.startsWith("/")) value = `/${value}`;
+		if (value.endsWith("/")) value = value.slice(0, -1);
+		return value;
+	});
+	return normalized.length > 0 ? normalized : void 0;
+}
+/**
+* Checks whether a request url falls under any of the normalized prefix mounts:
+* exact match, a path segment below it, or the mount itself with a query string.
+*/ function matchesPrefix(url, prefixes) {
+	return prefixes.some((prefix) => {
+		if (!url.startsWith(prefix)) return false;
+		const next = url[prefix.length];
+		return next === void 0 || next === "/" || next === "?";
+	});
+}
 const logger = createLogger({ level: 99 }).createTopic("\x1B[2m\x1B[36m" + PLUGIN_NAME);
 
 //#endregion
@@ -34,7 +59,7 @@ async function createSSRServer(options) {
 				if (req.method !== "GET") return next();
 				const url = req.originalUrl || req.url || "/";
 				try {
-					let template = await fs.readFile(path.resolve(process.cwd(), "index.html"), "utf8");
+					let template = await fs.readFile(path.resolve(vite.config.root, "index.html"), "utf8");
 					template = await vite.transformIndexHtml(url, template);
 					const { render } = await vite.ssrLoadModule(ssrEntry);
 					const { html: appHtml, state } = await render(url);
@@ -67,10 +92,7 @@ async function createSSRServer(options) {
 	const clientDir = opts.clientDir || path.resolve(import.meta.dirname, "../client");
 	const ssrOutlet = opts.ssrOutlet || (__MOOST_SSR_OUTLET__ !== void 0 ? __MOOST_SSR_OUTLET__ : "<!--ssr-outlet-->");
 	const ssrState = opts.ssrState || (__MOOST_SSR_STATE__ !== void 0 ? __MOOST_SSR_STATE__ : "<!--ssr-state-->");
-	let prefix = opts.prefix || __MOOST_PREFIX__;
-	if (!prefix.startsWith("/")) prefix = `/${prefix}`;
-	if (prefix.endsWith("/")) prefix = prefix.slice(0, -1);
-	const prefixSlash = `${prefix}/`;
+	const prefixes = normalizePrefixes(opts.prefix ?? __MOOST_PREFIX__);
 	const defaultPort = opts.port || Number(process.env.PORT) || 3e3;
 	const template = await fs.readFile(path.resolve(clientDir, "index.html"), "utf8");
 	let render = null;
@@ -84,7 +106,7 @@ async function createSSRServer(options) {
 	let captured = false;
 	const origListen = MoostHttp.prototype.listen;
 	MoostHttp.prototype.listen = function(...args) {
-		moostHandler = this.getServerCb();
+		moostHandler = this.getServerCb((req, res) => serveStatic(req, res));
 		moostHttpRef.instance = this;
 		captured = true;
 		setTimeout(() => args.filter((a) => typeof a === "function").forEach((a) => a()), 1);
@@ -109,6 +131,32 @@ async function createSSRServer(options) {
 	if (enableLocalFetch && moostHttpRef.instance) enableLocalFetch(moostHttpRef.instance);
 	const sirv = (await import("sirv")).default;
 	const serve = sirv(path.resolve(clientDir), { extensions: [] });
+	const serveStatic = (req, res) => {
+		const url = req.url || "/";
+		serve(req, res, async () => {
+			if (req.method !== "GET") {
+				res.statusCode = 404;
+				res.end();
+				return;
+			}
+			try {
+				if (render) {
+					const { html: appHtml, state } = await render(url);
+					res.statusCode = 200;
+					res.setHeader("Content-Type", "text/html");
+					res.end(template.replace(ssrOutlet, appHtml).replace(ssrState, state ? `<script>window.__SSR_STATE__=${state}<\/script>` : ""));
+				} else {
+					res.statusCode = 200;
+					res.setHeader("Content-Type", "text/html");
+					res.end(template);
+				}
+			} catch (error) {
+				console.error(error);
+				res.statusCode = 500;
+				res.end(error.message);
+			}
+		});
+	};
 	return {
 		use(mw) {
 			userMiddlewares.push(mw);
@@ -123,33 +171,11 @@ async function createSSRServer(options) {
 						userMiddlewares[i++](req, res, runNext);
 						return;
 					}
-					if (moostHandler && (url.startsWith(prefixSlash) || url === prefix || url.startsWith(`${prefix}?`))) {
+					if (moostHandler && (!prefixes || matchesPrefix(url, prefixes))) {
 						moostHandler(req, res);
 						return;
 					}
-					serve(req, res, async () => {
-						if (req.method !== "GET") {
-							res.statusCode = 404;
-							res.end();
-							return;
-						}
-						try {
-							if (render) {
-								const { html: appHtml, state } = await render(url);
-								res.statusCode = 200;
-								res.setHeader("Content-Type", "text/html");
-								res.end(template.replace(ssrOutlet, appHtml).replace(ssrState, state ? `<script>window.__SSR_STATE__=${state}<\/script>` : ""));
-							} else {
-								res.statusCode = 200;
-								res.setHeader("Content-Type", "text/html");
-								res.end(template);
-							}
-						} catch (error) {
-							console.error(error);
-							res.statusCode = 500;
-							res.end(error.message);
-						}
-					});
+					serveStatic(req, res);
 				};
 				runNext();
 			}).listen(p, () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moostjs/vite",
-  "version": "0.6.25",
+  "version": "0.6.27",
   "description": "Vite Dev plugin for moostjs",
   "keywords": [
     "composables",
@@ -58,8 +58,8 @@
   "peerDependencies": {
     "sirv": "^3.0.0",
     "vite": "^8.0.0",
-    "@moostjs/event-http": "^0.6.25",
-    "moost": "^0.6.25"
+    "@moostjs/event-http": "^0.6.27",
+    "moost": "^0.6.27"
   },
   "peerDependenciesMeta": {
     "sirv": {