orbit-rpc 0.0.1 → 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,19 @@
+import { Plugin } from "vite";
+
+//#region src/plugin.d.ts
+interface OrbitRpcConfig {
+  /** routes ディレクトリのパス（デフォルト: "src/routes"） */
+  routesDir?: string;
+  /** RPC エンドポイントのプレフィックス（デフォルト: "/rpc"） */
+  rpcBase?: string;
+}
+/**
+ * Orbit RPC Vite プラグイン。
+ *
+ * 2つの仕事をする:
+ * 1. クライアント側: server.ts の import を HTTP fetch スタブに差し替え
+ * 2. dev サーバー: /rpc/* リクエストを受けて server.ts の関数を実行
+ */
+declare function orbitRpc(config?: OrbitRpcConfig): Plugin[];
+//#endregion
+export { type OrbitRpcConfig, orbitRpc };

package/dist/index.mjs

@@ -0,0 +1,200 @@
+import path from "node:path";
+import fs from "node:fs";
+//#region src/scanner.ts
+/**
+* routes ディレクトリから server.ts ファイルをスキャンし、
+* エクスポートされた関数名を抽出する。
+*/
+async function scanServerModules(root, routesDir) {
+	const absoluteRoutesDir = path.resolve(root, routesDir);
+	if (!fs.existsSync(absoluteRoutesDir)) return [];
+	const modules = [];
+	await walk(absoluteRoutesDir, absoluteRoutesDir, modules);
+	return modules;
+}
+async function walk(dir, routesRoot, modules) {
+	const entries = await fs.promises.readdir(dir, { withFileTypes: true });
+	const serverFile = entries.find((e) => e.isFile() && /^server\.ts$/.test(e.name));
+	if (serverFile) {
+		const filePath = path.join(dir, serverFile.name);
+		const routePrefix = dirToRoutePrefix(path.relative(routesRoot, dir));
+		const functions = extractExportedFunctions(filePath);
+		if (functions.length > 0) modules.push({
+			filePath,
+			routePrefix,
+			functions
+		});
+	}
+	for (const entry of entries) if (entry.isDirectory() && !entry.name.startsWith("_")) await walk(path.join(dir, entry.name), routesRoot, modules);
+}
+/**
+* server.ts から export された関数名を抽出する。
+* 簡易パース（正規表現ベース）。
+*/
+function extractExportedFunctions(filePath) {
+	const content = fs.readFileSync(filePath, "utf-8");
+	const functions = [];
+	for (const match of content.matchAll(/export\s+(?:async\s+)?function\s+(\w+)/g)) functions.push({ name: match[1] });
+	for (const match of content.matchAll(/export\s+const\s+(\w+)\s*=\s*(?:async\s+)?(?:\([^)]*\)\s*=>|function\b)/g)) if (!functions.some((f) => f.name === match[1])) functions.push({ name: match[1] });
+	return functions;
+}
+/**
+* ディレクトリの相対パスをルートプレフィックスに変換する。
+*  ""           → ""
+*  "tasks"      → "/tasks"
+*  "users/[id]" ��� "/users/:id"
+*/
+function dirToRoutePrefix(relativePath) {
+	if (relativePath === "") return "";
+	const segments = relativePath.split(path.sep).filter((seg) => !/^\(.+\)$/.test(seg)).map((seg) => {
+		const match = seg.match(/^\[(.+)]$/);
+		return match ? `:${match[1]}` : seg;
+	});
+	return segments.length === 0 ? "" : `/${segments.join("/")}`;
+}
+//#endregion
+//#region src/plugin.ts
+/**
+* Orbit RPC Vite プラグイン。
+*
+* 2つの仕事をする:
+* 1. クライアント側: server.ts の import を HTTP fetch スタブに差し替え
+* 2. dev サーバー: /rpc/* リクエストを受けて server.ts の関数を実行
+*/
+function orbitRpc(config = {}) {
+	const routesDir = config.routesDir ?? "src/routes";
+	const rpcBase = config.rpcBase ?? "/rpc";
+	let root;
+	let serverModules = [];
+	return [{
+		name: "orbit-rpc:transform",
+		configResolved(resolvedConfig) {
+			root = resolvedConfig.root;
+		},
+		async buildStart() {
+			serverModules = await scanServerModules(root, routesDir);
+		},
+		async transform(code, id) {
+			if (!id.endsWith("/server.ts")) return null;
+			const routesPath = path.resolve(root, routesDir);
+			if (!id.startsWith(routesPath)) return null;
+			if (this.environment?.name === "ssr") return null;
+			const mod = serverModules.find((m) => m.filePath === id);
+			if (!mod) {
+				serverModules = await scanServerModules(root, routesDir);
+				const freshMod = serverModules.find((m) => m.filePath === id);
+				if (!freshMod) return null;
+				return generateClientStub(freshMod, rpcBase);
+			}
+			return generateClientStub(mod, rpcBase);
+		}
+	}, {
+		name: "orbit-rpc:dev-server",
+		configureServer(server) {
+			const routesPath = path.resolve(root, routesDir);
+			const onFileChange = async (file) => {
+				if (!file.startsWith(routesPath)) return;
+				if (!file.endsWith("/server.ts")) return;
+				serverModules = await scanServerModules(root, routesDir);
+			};
+			server.watcher.on("add", onFileChange);
+			server.watcher.on("unlink", onFileChange);
+			server.middlewares.use(async (req, res, next) => {
+				if (!req.url?.startsWith(rpcBase)) return next();
+				try {
+					const result = await handleRpcRequest(server, req, rpcBase, serverModules);
+					res.setHeader("Content-Type", "application/json");
+					res.end(JSON.stringify(result ?? null));
+				} catch (err) {
+					const message = err instanceof Error ? err.message : "Internal Server Error";
+					res.statusCode = err instanceof RpcError ? err.status : 500;
+					res.setHeader("Content-Type", "application/json");
+					res.end(JSON.stringify({ error: message }));
+				}
+			});
+		}
+	}];
+}
+/**
+* server.ts の中身を RPC スタブに差し替える。
+*
+* 例: routePrefix="/tasks", rpcBase="/rpc"
+*   export async function getTasks(signal) { ... }
+* → export async function getTasks(signal) {
+*     const res = await fetch("/rpc/tasks/getTasks", { method: "POST", signal });
+*     ...
+*   }
+*/
+function generateClientStub(mod, rpcBase) {
+	const lines = [];
+	for (const fn of mod.functions) {
+		const endpoint = `${rpcBase}${mod.routePrefix}/${fn.name}`;
+		lines.push(`export async function ${fn.name}(...args) {`);
+		lines.push(`  const signal = args[args.length - 1] instanceof AbortSignal ? args.pop() : undefined;`);
+		lines.push(`  const hasArgs = args.length > 0;`);
+		lines.push(`  const res = await fetch("${endpoint}", {`);
+		lines.push(`    method: "POST",`);
+		lines.push(`    signal,`);
+		lines.push(`    ...(hasArgs ? {`);
+		lines.push(`      headers: { "Content-Type": "application/json" },`);
+		lines.push(`      body: JSON.stringify(args),`);
+		lines.push(`    } : {}),`);
+		lines.push(`  });`);
+		lines.push(`  if (!res.ok) {`);
+		lines.push(`    const body = await res.json().catch(() => ({}));`);
+		lines.push(`    throw new Error(body.error || \`RPC error: \${res.status}\`);`);
+		lines.push(`  }`);
+		lines.push(`  const text = await res.text();`);
+		lines.push(`  return text ? JSON.parse(text) : undefined;`);
+		lines.push(`}`);
+		lines.push(``);
+	}
+	return lines.join("\n");
+}
+var RpcError = class extends Error {
+	constructor(message, status) {
+		super(message);
+		this.status = status;
+	}
+};
+/**
+* dev サーバーで RPC リクエストを処理する。
+*
+* URL: POST /rpc/{routePrefix}/{functionName}
+* Body: JSON（関数の引数）
+*/
+async function handleRpcRequest(server, req, rpcBase, modules) {
+	if (req.method !== "POST") throw new RpcError("Method not allowed", 405);
+	const rpcPath = req.url.slice(rpcBase.length);
+	const lastSlash = rpcPath.lastIndexOf("/");
+	if (lastSlash === -1) throw new RpcError("Invalid RPC path", 400);
+	const routePrefix = rpcPath.slice(0, lastSlash) || "";
+	const functionName = decodeURIComponent(rpcPath.slice(lastSlash + 1));
+	const mod = modules.find((m) => m.routePrefix === routePrefix);
+	if (!mod) throw new RpcError(`Module not found: ${routePrefix}`, 404);
+	if (!mod.functions.find((f) => f.name === functionName)) throw new RpcError(`Function not found: ${functionName}`, 404);
+	const fn = (await server.ssrLoadModule(mod.filePath))[functionName];
+	if (typeof fn !== "function") throw new RpcError(`${functionName} is not a function`, 500);
+	const body = await readBody(req);
+	return fn(...body ? JSON.parse(body) : []);
+}
+const MAX_BODY_SIZE = 1024 * 1024;
+function readBody(req) {
+	return new Promise((resolve, reject) => {
+		let data = "";
+		let size = 0;
+		req.on("data", (chunk) => {
+			size += chunk.length;
+			if (size > MAX_BODY_SIZE) {
+				req.destroy();
+				reject(new RpcError("Request body too large", 413));
+				return;
+			}
+			data += chunk.toString();
+		});
+		req.on("end", () => resolve(data));
+		req.on("error", reject);
+	});
+}
+//#endregion
+export { orbitRpc };

package/package.json

@@ -1,11 +1,51 @@
 {
   "name": "orbit-rpc",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "description": "RPC layer for Orbit — auto-converts server.ts functions to Hono routes",
+  "keywords": [
+    "rpc",
+    "hono",
+    "vite",
+    "react",
+    "fullstack"
+  ],
   "license": "MIT",
-  "type": "module",
-  "main": "index.js",
+  "author": "ashunar0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ashunar0/orbit-router",
+    "directory": "packages/orbit-rpc"
+  },
   "files": [
-    "index.js"
-  ]
+    "dist"
+  ],
+  "type": "module",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "hono": "^4.7.11"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "bumpp": "^11.0.1",
+    "typescript": "^5.9.3",
+    "vite": "npm:@voidzero-dev/vite-plus-core@0.1.12",
+    "vite-plus": "0.1.12"
+  },
+  "peerDependencies": {
+    "vite": ">=6.0.0"
+  },
+  "scripts": {
+    "build": "vp pack",
+    "dev": "vp pack --watch",
+    "test": "vp test",
+    "typecheck": "tsc --noEmit",
+    "release": "bumpp"
+  }
 }

package/index.js

@@ -1 +0,0 @@
-