vite-plugin-mock-data 8.0.1 → 8.1.0

package/dist/configureServer.d.ts

@@ -1,7 +1,17 @@
-import { OutgoingHttpHeaders } from 'node:http';
-import { Config as SirvConfig, HTTPVersion } from 'find-my-way';
-import { Options as SirvOptions } from 'sirv';
+import { FastifyServerOptions } from 'fastify';
 import { ViteDevServer } from 'vite';
 import { RouteConfig } from './types';
-export declare function sirvOptions(headers?: OutgoingHttpHeaders): SirvOptions;
-export declare function configureServer(server: ViteDevServer, routerOpts: SirvConfig<HTTPVersion.V1> | SirvConfig<HTTPVersion.V2> | undefined, routes: RouteConfig[], cwd: string): void;
+/**
+ * Mounts mock routes on the Vite dev server via a fastify instance.
+ *
+ * fastify is embedded as a connect middleware using its internal
+ * `routing(req, res)` API, so the plugin keeps the exact middleware
+ * semantics of the previous find-my-way based implementation:
+ *   - matched mock routes are answered by fastify;
+ *   - unmatched requests fall through to the next middleware via
+ *     `setNotFoundHandler` + `reply.hijack()` + `next()`.
+ *
+ * Route config contract (unchanged from before):
+ *   key = "METHOD /path", supports `METHOD1/METHOD2 /path` and `:param`.
+ */
+export declare function configureServer(server: ViteDevServer, fastifyOptions: FastifyServerOptions | undefined, routes: RouteConfig[], cwd: string): Promise<void>;

package/dist/index.js

@@ -1,13 +1,15 @@
 import { isObject } from "is-what-type";
 import { banner, logFactory, toAbsolutePath } from "vp-runtime-helper";
-import { join, parse } from "node:path";
-import getRouter from "find-my-way";
-import sirv from "sirv";
-import { send, transformWithOxc } from "vite";
+import fastifyFormbody from "@fastify/formbody";
+import fastifyStatic from "@fastify/static";
+import fastify from "fastify";
+import { createHash } from "node:crypto";
 import { readFileSync } from "node:fs";
-import { unlink, writeFile } from "node:fs/promises";
+import { mkdir, unlink, writeFile } from "node:fs/promises";
 import { createRequire } from "node:module";
+import { join, parse } from "node:path";
 import { glob } from "tinyglobby";
+import { transformWithOxc } from "vite";
 //#region \0rolldown/runtime.js
 var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, { get: (a, b) => (typeof require !== "undefined" ? require : a)[b] }) : x)(function(x) {
 	if (typeof require !== "undefined") return require.apply(this, arguments);
@@ -18,7 +20,7 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
 var name = "vite-plugin-mock-data";
 var package_default = {
 	name,
-	version: "8.0.1",
+	version: "8.1.0",
 	description: "Provides a simple way to mock data.",
 	type: "module",
 	types: "./dist/index.d.ts",
@@ -49,9 +51,10 @@ var package_default = {
 	bugs: { "url": "https://github.com/fengxinming/vite-plugins/issues" },
 	homepage: "https://fengxinming.github.io/vite-plugins/plugins/vite-plugin-mock-data/quick-start",
 	dependencies: {
-		"find-my-way": "^9.2.0",
+		"@fastify/formbody": "^9.0.0",
+		"@fastify/static": "^10.1.3",
+		"fastify": "^5.12.1",
 		"is-what-type": "^1.1.4",
-		"sirv": "^3.0.1",
 		"tinyglobby": "^0.2.12",
 		"vp-runtime-helper": "workspace:^"
 	},
@@ -65,120 +68,89 @@ var package_default = {
 //#endregion
 //#region src/configureServer.ts
 /**
-* Simple request body parser for JSON / urlencoded payloads.
-* Populates `req.body` so that route handlers can read it directly,
-* matching the documented handler signature `(req) => req.body`.
+* 解析路由 key：`"METHOD /path"`，支持 `METHOD1/METHOD2 /path` 与 `:param`。
+* 缺省 METHOD 时默认 GET。
 */
-function readJsonBody(req) {
-	return new Promise((resolve, reject) => {
-		const chunks = [];
-		req.on("data", (c) => chunks.push(Buffer.isBuffer(c) ? c : Buffer.from(c)));
-		req.on("end", () => {
-			const raw = Buffer.concat(chunks).toString("utf8");
-			if (!raw) {
-				resolve(void 0);
-				return;
-			}
-			const type = (req.headers["content-type"] || "").toLowerCase();
-			try {
-				if (type.includes("application/json")) resolve(JSON.parse(raw));
-				else if (type.includes("application/x-www-form-urlencoded")) {
-					const out = {};
-					for (const [k, v] of new URLSearchParams(raw)) out[k] = v;
-					resolve(out);
-				} else resolve(raw);
-			} catch (e) {
-				reject(e);
-			}
-		});
-		req.on("error", reject);
-	});
-}
-function sendResult(req, res, ret, defaultHeaders) {
-	if (res.headersSent || ret === void 0) return;
-	send(req, res, typeof ret !== "string" ? JSON.stringify(ret) : ret, isObject(ret) ? "json" : "html", { headers: defaultHeaders });
-}
-function sirvOptions(headers) {
+function parseRouteKey(xpath) {
+	const [first, second] = xpath.split(" ");
+	const pathname = second ?? first;
 	return {
-		dev: true,
-		etag: true,
-		extensions: [],
-		setHeaders(res, pathname) {
-			res.setHeader("Access-Control-Allow-Origin", "*");
-			if (/\.[tj]sx?$/.test(pathname)) res.setHeader("Content-Type", "application/javascript");
-			if (headers) Object.entries(headers).forEach(([key, val]) => {
-				if (val) res.setHeader(key, val);
-			});
-		}
+		methods: (second ? first : "GET").toUpperCase().split("/"),
+		pathname
 	};
 }
-function configureServer(server, routerOpts, routes, cwd) {
-	const router = getRouter(routerOpts);
-	if (Array.isArray(routes)) routes.forEach((route) => {
-		Object.keys(route).forEach((xpath) => {
-			let [methods, pathname] = xpath.split(" ");
-			if (!pathname) {
-				pathname = methods;
-				methods = "GET";
-			}
-			methods = methods.toUpperCase();
-			let routeConfig = route[xpath];
-			if (!isObject(routeConfig)) routeConfig = { handler: routeConfig };
-			let handler;
-			if (typeof routeConfig.file === "string") handler = (req, res) => {
-				const parsedPath = parse(toAbsolutePath(routeConfig.file, cwd));
-				const serve = sirv(parsedPath.dir, sirvOptions(server.config.server.headers));
-				req.url = `/${parsedPath.base}`;
-				serve(req, res);
-			};
-			else if (typeof routeConfig.handler !== "function") {
-				const ret = routeConfig.handler;
-				const retType = typeof ret;
-				handler = (req, res) => {
-					send(req, res, retType !== "string" ? JSON.stringify(ret) : ret, isObject(ret) ? "json" : "html", { headers: server.config.server.headers });
-				};
-			} else {
-				const userHandler = routeConfig.handler;
-				const needsBody = methods.toUpperCase().split("/").some((m) => [
-					"POST",
-					"PUT",
-					"PATCH",
-					"DELETE"
-				].includes(m));
-				handler = async (req, res, params) => {
-					req.params = params ?? {};
-					try {
-						if (needsBody) req.body = await readJsonBody(req);
-					} catch (e) {
-						res.statusCode = 400;
-						res.setHeader("Content-Type", "application/json");
-						res.end(JSON.stringify({
-							error: "Invalid request body",
-							detail: String(e)
-						}));
-						return;
-					}
-					try {
-						sendResult(req, res, await userHandler(req, res), server.config.server.headers);
-					} catch (e) {
-						server.config.logger.error(`[mock-data] handler error on ${methods} ${pathname}: ${e}`);
-						if (!res.headersSent) {
-							res.statusCode = 500;
-							res.setHeader("Content-Type", "application/json");
-							res.end(JSON.stringify({
-								error: "Mock handler error",
-								detail: String(e)
-							}));
-						}
-					}
-				};
+/**
+* 静态数据发送 handler：
+*   - 对象 / 数组（isObject 为真，数组也是 object）→ `reply.send(data)`，fastify 序列化为 JSON；
+*   - 其他（string / number / boolean / null）→ `String()` 转成字符串按文本发送
+*     （fastify 对 string 默认 Content-Type: text/plain）。
+*/
+function createStaticHandler(data) {
+	return (_request, reply) => {
+		reply.send(isObject(data) ? data : String(data));
+	};
+}
+/**
+* 在 fastify 实例上注册单条 mock 路由。
+*
+* 路由值只分两种（与 types.ts 的 RouteValue 一一对应）：
+*   - 函数 → 原样透传，它就是 fastify 的 handler
+*     （fastify 原生处理两种响应方式：async 返回值自动发送 / 内部 reply.send()）；
+*   - 其他一切（对象 / 数组 / string / number / boolean / null）→ 静态数据，
+*     由 createStaticHandler 生成 handler 发送。
+*/
+function registerMockRoute(app, xpath, raw) {
+	const { methods, pathname } = parseRouteKey(xpath);
+	app.route({
+		method: methods,
+		url: pathname,
+		handler: typeof raw === "function" ? raw : createStaticHandler(raw)
+	});
+}
+/**
+* Mounts mock routes on the Vite dev server via a fastify instance.
+*
+* fastify is embedded as a connect middleware using its internal
+* `routing(req, res)` API, so the plugin keeps the exact middleware
+* semantics of the previous find-my-way based implementation:
+*   - matched mock routes are answered by fastify;
+*   - unmatched requests fall through to the next middleware via
+*     `setNotFoundHandler` + `reply.hijack()` + `next()`.
+*
+* Route config contract (unchanged from before):
+*   key = "METHOD /path", supports `METHOD1/METHOD2 /path` and `:param`.
+*/
+async function configureServer(server, fastifyOptions, routes, cwd) {
+	const app = fastify({
+		logger: false,
+		...fastifyOptions
+	});
+	app.register(fastifyFormbody);
+	app.register(fastifyStatic, {
+		root: cwd,
+		setHeaders(reply, pathname) {
+			reply.header("Access-Control-Allow-Origin", "*");
+			if (/\.[tj]sx?$/.test(pathname)) reply.header("Content-Type", "application/javascript");
+			const headers = server.config.server.headers;
+			if (headers) {
+				for (const [key, val] of Object.entries(headers)) if (val) reply.header(key, val);
 			}
-			if (handler) router.on(methods.split("/"), pathname, {}, handler, routeConfig.store);
-		});
+		}
 	});
+	app.setNotFoundHandler((request, reply) => {
+		reply.hijack();
+		const raw = request.raw;
+		const next = raw.__mockNext;
+		delete raw.__mockNext;
+		next?.();
+	});
+	routes.forEach((route) => {
+		for (const [key, val] of Object.entries(route)) registerMockRoute(app, key, val);
+	});
+	await app.ready();
 	server.middlewares.use((req, res, next) => {
-		router.defaultRoute = () => next();
-		router.lookup(req, res);
+		req.__mockNext = next;
+		app.routing(req, res);
 	});
 }
 //#endregion
@@ -188,32 +160,42 @@ var logger = logFactory.getLogger(PLUGIN_NAME);
 //#endregion
 //#region src/loadRoutes.ts
 var _require = typeof __require === "function" ? __require : createRequire(import.meta.url);
-async function getRoute(filename) {
+/**
+* Temp directory for transpiled mock files, shared by every mock dir of this project.
+* Kept under node_modules so `rm -rf node_modules` cleans it up along with everything
+* else, and git ignores it by default.
+*/
+function getTempDir(cwd) {
+	return join(cwd, "node_modules", ".vite-plugin-mock-data");
+}
+async function getRoute(filename, tmpDir) {
 	logger.debug("Load mock file:", filename);
-	let { ext, dir, name } = parse(filename);
-	const isTs = ext === ".ts" || ext === ".mts";
-	if (isTs) {
+	const { ext, name } = parse(filename);
+	if (ext === ".ts" || ext === ".mts") {
 		const { code } = await transformWithOxc(readFileSync(filename, "utf-8"), filename);
-		filename = join(dir, `${name}-${PLUGIN_NAME}.mjs`);
-		ext = ".mjs";
-		await writeFile(filename, code);
+		const hash = createHash("sha256").update(filename).digest("hex").slice(0, 12);
+		const tmpFile = join(tmpDir, `${hash}-${name}-${PLUGIN_NAME}.mjs`);
+		await mkdir(tmpDir, { recursive: true });
+		await writeFile(tmpFile, code);
+		try {
+			return (await import(tmpFile)).default;
+		} finally {
+			await unlink(tmpFile).catch(() => {});
+		}
 	}
-	let config;
 	switch (ext) {
-		case ".js":
-			config = _require(filename);
-			break;
-		case ".mjs":
-			config = (await import(filename)).default;
-			if (isTs) await unlink(filename);
-			break;
-		case ".json": config = JSON.parse(readFileSync(filename, "utf-8"));
+		case ".js": return _require(filename);
+		case ".mjs": return (await import(filename)).default;
+		case ".json": return JSON.parse(readFileSync(filename, "utf-8"));
 	}
-	return config;
 }
-async function loadRoutes(dir, routes) {
-	const paths = await glob(`${dir}/**/*.{js,mjs,json,ts,mts}`, { absolute: true });
-	const configs = await Promise.all(paths.map(getRoute));
+async function loadRoutes(dir, routes, cwd = process.cwd()) {
+	const tmpDir = getTempDir(cwd);
+	const paths = await glob(`${dir}/**/*.{js,mjs,json,ts,mts}`, {
+		absolute: true,
+		ignore: [`**/*-${PLUGIN_NAME}.mjs`]
+	});
+	const configs = await Promise.all(paths.map((p) => getRoute(p, tmpDir)));
 	for (const config of configs) if (config) routes.push(config);
 }
 //#endregion
@@ -240,25 +222,26 @@ async function loadRoutes(dir, routes) {
 */
 function pluginMockDate(opts) {
 	if (opts.enableBanner) banner(package_default.name);
-	const { isAfter, routerOptions, routes, logLevel, cwd = process.cwd() } = opts;
+	const { isAfter, fastifyOptions, routes, logLevel, cwd = process.cwd() } = opts;
 	if (logLevel) logger.level = logLevel;
 	const allRoutes = [];
 	return {
 		name: PLUGIN_NAME,
 		async configureServer(server) {
+			allRoutes.length = 0;
 			if (typeof routes === "string") {
 				logger.debug("Load routes from", routes);
-				await loadRoutes(toAbsolutePath(routes, cwd), allRoutes);
+				await loadRoutes(toAbsolutePath(routes, cwd), allRoutes, cwd);
 			} else if (Array.isArray(routes)) for (const route of routes) {
 				logger.debug("Load routes from", route);
-				if (typeof route === "string") await loadRoutes(toAbsolutePath(route, cwd), allRoutes);
+				if (typeof route === "string") await loadRoutes(toAbsolutePath(route, cwd), allRoutes, cwd);
 				else allRoutes.push(route);
 			}
 			else if (isObject(routes)) {
 				logger.debug("Load routes from", routes);
 				allRoutes.push(routes);
 			}
-			return isAfter ? () => configureServer(server, routerOptions, allRoutes, cwd) : configureServer(server, routerOptions, allRoutes, cwd);
+			return isAfter ? () => configureServer(server, fastifyOptions, allRoutes, cwd) : configureServer(server, fastifyOptions, allRoutes, cwd);
 		}
 	};
 }

package/dist/loadRoutes.d.ts

@@ -1,2 +1,2 @@
 import { RouteConfig } from './types';
-export default function loadRoutes(dir: string, routes: RouteConfig[]): Promise<void>;
+export default function loadRoutes(dir: string, routes: RouteConfig[], cwd?: string): Promise<void>;

package/dist/types.d.ts

@@ -1,13 +1,52 @@
-import { Config as SirvConfig, Handler, HTTPVersion, RouteOptions } from 'find-my-way';
+import { FastifyServerOptions, RouteHandlerMethod } from 'fastify';
 import { LogLevel } from 'vp-runtime-helper';
-export interface HandleRoute {
-    file?: string;
-    handler?: any | Handler<HTTPVersion.V1>;
-    options?: RouteOptions;
-    store?: any;
-}
+/**
+ * 函数形式的 handler：fastify 原生风格 `(request, reply)`。
+ * 原样透传给 fastify，两种响应方式都由 fastify 处理：
+ *   - async handler 的返回值自动发送（对象序列化为 JSON）；
+ *   - handler 内部自行调用 `reply.send()`。
+ * Function handler in fastify style. Passed through to fastify as-is.
+ */
+export type MockHandler = RouteHandlerMethod;
+/**
+ * 任意 JSON 可序列化的静态数据。
+ *
+ * 可直接写在路由 key 后面（顶层），对象 / 数组 / 原始值一律按数据发送：
+ *   - string → String() 后按文本发送（fastify 默认 text/plain）；
+ *   - 其他值（object / array / number / boolean / null）→ 对象按 JSON 发送，
+ *     非对象经 String() 转成字符串按文本发送（见 configureServer.ts 的 createStaticHandler）。
+ *
+ * 不再需要排除任何字段——运行时分流只判断「是不是函数」：
+ * 函数 → handler 透传；非函数 → 本类型（静态数据）。
+ *
+ * Any JSON-serializable static data, usable directly at the route top level.
+ * Runtime dispatch only checks `typeof value === 'function'` — functions are
+ * passed through as handlers, everything else is static data.
+ */
+export type MockData = string | number | boolean | null | MockData[] | {
+    [key: string]: MockData;
+};
+/**
+ * 路由配置值：函数 handler 或静态数据两种形态。
+ * 函数原样透传给 fastify；非函数按静态数据发送。
+ *
+ * Route config value: a function handler (passed through to fastify) or
+ * static data (sent by a plugin-generated handler).
+ */
+export type RouteValue = MockHandler | MockData;
 export interface RouteConfig {
-    [route: string]: string | Handler<HTTPVersion.V1> | HandleRoute;
+    [route: string]: RouteValue;
+}
+/**
+ * connect 中间件的 next 回调在 fastify 404 handler 之间的传递载体。
+ *
+ * fastify 以 `app.routing(req, res)` 嵌入 connect 中间件时，未匹配的请求会
+ * 走到 fastify 的 404 handler，但那里拿不到 connect 的 `next`。因此
+ * configureServer 在 middleware 里先把 `next` 挂到 `request.raw.__mockNext`，
+ * 404 handler 取出并调用，让请求落回 Vite 的中间件链（配合 reply.hijack()）。
+ */
+export interface MockRequest {
+    __mockNext?: () => void;
 }
 export interface Options {
     /**
@@ -35,9 +74,9 @@ export interface Options {
      */
     isAfter?: boolean;
     /**
-     * Initial options of `find-my-way`. see more at https://github.com/delvedor/find-my-way#findmywayoptions
+     * Initial options of `fastify`. see more at https://fastify.dev/docs/latest/Reference/Server/
      */
-    routerOptions?: SirvConfig<HTTPVersion.V1> | SirvConfig<HTTPVersion.V2>;
+    fastifyOptions?: FastifyServerOptions;
     /**
      * Initial list of mock routes that should be added to the dev server
      * or specify the directory to define mock routes that should be added to the dev server.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vite-plugin-mock-data",
-  "version": "8.0.1",
+  "version": "8.1.0",
   "description": "Provides a simple way to mock data.",
   "type": "module",
   "types": "./dist/index.d.ts",
@@ -30,16 +30,17 @@
   },
   "homepage": "https://fengxinming.github.io/vite-plugins/plugins/vite-plugin-mock-data/quick-start",
   "dependencies": {
-    "find-my-way": "^9.2.0",
+    "@fastify/formbody": "^9.0.0",
+    "@fastify/static": "^10.1.3",
+    "fastify": "^5.12.1",
     "is-what-type": "^1.1.4",
-    "sirv": "^3.0.1",
     "tinyglobby": "^0.2.12",
     "vp-runtime-helper": "^8.0.0"
   },
   "devDependencies": {
     "vite": "^8.0.0",
     "vite-plugin-dts": "^5.0.3",
-    "vite-plugin-external": "^8.0.2"
+    "vite-plugin-external": "^8.0.3"
   },
   "files": [
     "dist"