@moostjs/vite 0.6.26 → 0.6.28

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();
@@ -415,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),
@@ -512,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
@@ -585,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);

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();
@@ -384,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),
@@ -481,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
@@ -554,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);

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
@@ -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
@@ -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.26",
+  "version": "0.6.28",
   "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.26",
-    "moost": "^0.6.26"
+    "@moostjs/event-http": "^0.6.28",
+    "moost": "^0.6.28"
   },
   "peerDependenciesMeta": {
     "sirv": {