kibinrpc 0.1.0 → 0.2.0

package/dist/index.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/index.mjs

@@ -0,0 +1,194 @@
+#!/usr/bin/env node
+import { cancel, intro, isCancel, multiselect, outro, spinner, text } from "@clack/prompts";
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+//#region src/scaffold.ts
+function write(root, path, content) {
+	const full = join(root, path);
+	mkdirSync(dirname(full), { recursive: true });
+	writeFileSync(full, content, "utf-8");
+}
+function scaffold({ name, templates }) {
+	const hasBackend = templates.includes("backend");
+	const hasFrontend = templates.includes("frontend");
+	const root = join(process.cwd(), name);
+	const deps = {};
+	const devDeps = { typescript: "latest" };
+	if (hasBackend) deps["@kibinrpc/server"] = "latest";
+	if (hasFrontend) {
+		deps["@kibinrpc/client"] = "latest";
+		deps.react = "^19";
+		deps["react-dom"] = "^19";
+		devDeps.vite = "latest";
+		devDeps["@vitejs/plugin-react"] = "latest";
+	}
+	if (hasBackend && hasFrontend) deps.hono = "latest";
+	const scripts = {};
+	if (hasBackend) scripts["dev:server"] = "tsx --watch src/server/index.ts";
+	if (hasFrontend) scripts["dev:client"] = "vite";
+	scripts.dev = hasBackend && hasFrontend ? "pnpm dev:server & pnpm dev:client" : hasBackend ? "pnpm dev:server" : "pnpm dev:client";
+	write(root, "package.json", JSON.stringify({
+		name,
+		version: "0.1.0",
+		private: true,
+		type: "module",
+		scripts,
+		dependencies: deps,
+		devDependencies: devDeps
+	}, null, 2));
+	write(root, "tsconfig.json", JSON.stringify({
+		compilerOptions: {
+			target: "ESNext",
+			module: "ESNext",
+			moduleResolution: "bundler",
+			strict: true,
+			skipLibCheck: true,
+			...hasFrontend ? { jsx: "react-jsx" } : {}
+		},
+		include: ["src"]
+	}, null, 2));
+	if (hasBackend) {
+		write(root, "src/server/router.ts", `import { createRouter, defineActions, KibinError } from '@kibinrpc/server'
+
+const userActions = defineActions({
+  async getUser(id: string) {
+    // TODO: fetch from database
+    throw new KibinError('NOT_FOUND', 'User not found')
+  },
+})
+
+export const router = createRouter({ user: userActions })
+export type AppRouter = typeof router
+`);
+		const port = hasFrontend ? 3001 : 3e3;
+		write(root, "src/server/index.ts", `import { router } from './router.js'
+${hasFrontend ? "import { Hono } from 'hono'\nimport { serve } from '@hono/node-server'" : ""}
+
+${hasFrontend ? `const app = new Hono()
+
+app.post('/api/rpc', (c) => router.handler(c.req.raw))
+
+serve({ fetch: app.fetch, port: ${port} }, () => {
+  console.log('Server running on http://localhost:${port}')
+})` : `import { createServer } from 'node:http'
+
+const server = createServer(async (req, res) => {
+  const url = new URL(req.url ?? '/', \`http://\${req.headers.host}\`)
+  if (url.pathname === '/api/rpc' && req.method === 'POST') {
+    const chunks: Buffer[] = []
+    for await (const chunk of req) chunks.push(chunk)
+    const body = Buffer.concat(chunks).toString()
+    const request = new Request(\`http://localhost:${port}\${url.pathname}\`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body,
+    })
+    const response = await router.handler(request)
+    res.writeHead(response.status, { 'Content-Type': 'application/json' })
+    res.end(await response.text())
+  } else {
+    res.writeHead(404)
+    res.end()
+  }
+})
+
+server.listen(${port}, () => console.log('Server running on http://localhost:${port}'))`}
+`);
+	}
+	if (hasFrontend) {
+		write(root, "src/client/main.tsx", `import { createRoot } from 'react-dom/client'
+import { createKibinClient } from '@kibinrpc/client'
+${hasBackend ? "import type { AppRouter } from '../server/router.js'" : ""}
+
+const client = createKibinClient${hasBackend ? "<AppRouter>" : ""}({ baseUrl: ${hasBackend ? "'http://localhost:3001/api/rpc'" : "'/api/rpc'"} })
+
+function App() {
+  return <h1>Hello from kibinrpc!</h1>
+}
+
+createRoot(document.getElementById('root')!).render(<App />)
+`);
+		write(root, "index.html", `<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>${name}</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/client/main.tsx"><\/script>
+  </body>
+</html>
+`);
+		write(root, "vite.config.ts", `import { defineConfig } from 'vite'
+import react from '@vitejs/plugin-react'
+
+export default defineConfig({
+  plugins: [react()],${hasBackend ? `\n  server: { proxy: { '/api': 'http://localhost:3001' } },` : ""}
+})
+`);
+	}
+	write(root, "README.md", `# ${name}
+
+A kibinrpc project with ${[hasBackend && "backend", hasFrontend && "frontend"].filter(Boolean).join(" + ")}.
+
+## Getting started
+
+\`\`\`sh
+pnpm install
+pnpm dev
+\`\`\`
+`);
+}
+//#endregion
+//#region src/index.ts
+async function main() {
+	intro(" create kibinrpc ");
+	const name = await text({
+		message: "Project name",
+		placeholder: "my-app",
+		validate: (v) => {
+			if (!v.trim()) return "Please enter a project name";
+			if (!/^[a-z0-9-]+$/.test(v.trim())) return "Only lowercase letters, numbers and hyphens allowed";
+		}
+	});
+	if (isCancel(name)) {
+		cancel("Cancelled");
+		process.exit(0);
+	}
+	const templates = await multiselect({
+		message: "What would you like to include?",
+		options: [{
+			value: "backend",
+			label: "Backend",
+			hint: "server router + actions"
+		}, {
+			value: "frontend",
+			label: "Frontend",
+			hint: "React + Vite client"
+		}],
+		initialValues: ["backend", "frontend"],
+		required: true
+	});
+	if (isCancel(templates)) {
+		cancel("Cancelled");
+		process.exit(0);
+	}
+	const s = spinner();
+	s.start(`Creating ${name}`);
+	scaffold({
+		name: name.trim(),
+		templates
+	});
+	s.stop(`Created ${name}`);
+	outro(`Next steps:\n  cd ${name}\n  pnpm install\n  pnpm dev`);
+}
+main().catch((err) => {
+	console.error(err);
+	process.exit(1);
+});
+//#endregion
+export {};
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/scaffold.ts","../src/index.ts"],"sourcesContent":["import { mkdirSync, writeFileSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\n\nexport type TemplateId = 'backend' | 'frontend';\n\nexport interface ScaffoldOptions {\n\tname: string;\n\ttemplates: TemplateId[];\n}\n\nfunction write(root: string, path: string, content: string): void {\n\tconst full = join(root, path);\n\tmkdirSync(dirname(full), { recursive: true });\n\twriteFileSync(full, content, 'utf-8');\n}\n\nexport function scaffold({ name, templates }: ScaffoldOptions): void {\n\tconst hasBackend = templates.includes('backend');\n\tconst hasFrontend = templates.includes('frontend');\n\tconst root = join(process.cwd(), name);\n\n\t// package.json\n\tconst deps: Record<string, string> = {};\n\tconst devDeps: Record<string, string> = {\n\t\ttypescript: 'latest',\n\t};\n\n\tif (hasBackend) deps['@kibinrpc/server'] = 'latest';\n\tif (hasFrontend) {\n\t\tdeps['@kibinrpc/client'] = 'latest';\n\t\tdeps.react = '^19';\n\t\tdeps['react-dom'] = '^19';\n\t\tdevDeps.vite = 'latest';\n\t\tdevDeps['@vitejs/plugin-react'] = 'latest';\n\t}\n\tif (hasBackend && hasFrontend) {\n\t\tdeps.hono = 'latest';\n\t}\n\n\tconst scripts: Record<string, string> = {};\n\tif (hasBackend) scripts['dev:server'] = 'tsx --watch src/server/index.ts';\n\tif (hasFrontend) scripts['dev:client'] = 'vite';\n\tscripts.dev =\n\t\thasBackend && hasFrontend\n\t\t\t? 'pnpm dev:server & pnpm dev:client'\n\t\t\t: hasBackend\n\t\t\t\t? 'pnpm dev:server'\n\t\t\t\t: 'pnpm dev:client';\n\n\twrite(\n\t\troot,\n\t\t'package.json',\n\t\tJSON.stringify(\n\t\t\t{\n\t\t\t\tname,\n\t\t\t\tversion: '0.1.0',\n\t\t\t\tprivate: true,\n\t\t\t\ttype: 'module',\n\t\t\t\tscripts,\n\t\t\t\tdependencies: deps,\n\t\t\t\tdevDependencies: devDeps,\n\t\t\t},\n\t\t\tnull,\n\t\t\t2,\n\t\t),\n\t);\n\n\t// tsconfig.json\n\twrite(\n\t\troot,\n\t\t'tsconfig.json',\n\t\tJSON.stringify(\n\t\t\t{\n\t\t\t\tcompilerOptions: {\n\t\t\t\t\ttarget: 'ESNext',\n\t\t\t\t\tmodule: 'ESNext',\n\t\t\t\t\tmoduleResolution: 'bundler',\n\t\t\t\t\tstrict: true,\n\t\t\t\t\tskipLibCheck: true,\n\t\t\t\t\t...(hasFrontend ? { jsx: 'react-jsx' } : {}),\n\t\t\t\t},\n\t\t\t\tinclude: ['src'],\n\t\t\t},\n\t\t\tnull,\n\t\t\t2,\n\t\t),\n\t);\n\n\t// Backend\n\tif (hasBackend) {\n\t\twrite(\n\t\t\troot,\n\t\t\t'src/server/router.ts',\n\t\t\t`import { createRouter, defineActions, KibinError } from '@kibinrpc/server'\n\nconst userActions = defineActions({\n  async getUser(id: string) {\n    // TODO: fetch from database\n    throw new KibinError('NOT_FOUND', 'User not found')\n  },\n})\n\nexport const router = createRouter({ user: userActions })\nexport type AppRouter = typeof router\n`,\n\t\t);\n\n\t\tconst port = hasFrontend ? 3001 : 3000;\n\t\twrite(\n\t\t\troot,\n\t\t\t'src/server/index.ts',\n\t\t\t`import { router } from './router.js'\n${hasFrontend ? \"import { Hono } from 'hono'\\nimport { serve } from '@hono/node-server'\" : ''}\n\n${\n\thasFrontend\n\t\t? `const app = new Hono()\n\napp.post('/api/rpc', (c) => router.handler(c.req.raw))\n\nserve({ fetch: app.fetch, port: ${port} }, () => {\n  console.log('Server running on http://localhost:${port}')\n})`\n\t\t: `import { createServer } from 'node:http'\n\nconst server = createServer(async (req, res) => {\n  const url = new URL(req.url ?? '/', \\`http://\\${req.headers.host}\\`)\n  if (url.pathname === '/api/rpc' && req.method === 'POST') {\n    const chunks: Buffer[] = []\n    for await (const chunk of req) chunks.push(chunk)\n    const body = Buffer.concat(chunks).toString()\n    const request = new Request(\\`http://localhost:${port}\\${url.pathname}\\`, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body,\n    })\n    const response = await router.handler(request)\n    res.writeHead(response.status, { 'Content-Type': 'application/json' })\n    res.end(await response.text())\n  } else {\n    res.writeHead(404)\n    res.end()\n  }\n})\n\nserver.listen(${port}, () => console.log('Server running on http://localhost:${port}'))`\n}\n`,\n\t\t);\n\t}\n\n\t// Frontend\n\tif (hasFrontend) {\n\t\tconst rpcUrl = hasBackend ? \"'http://localhost:3001/api/rpc'\" : \"'/api/rpc'\";\n\n\t\twrite(\n\t\t\troot,\n\t\t\t'src/client/main.tsx',\n\t\t\t`import { createRoot } from 'react-dom/client'\nimport { createKibinClient } from '@kibinrpc/client'\n${hasBackend ? \"import type { AppRouter } from '../server/router.js'\" : ''}\n\nconst client = createKibinClient${hasBackend ? '<AppRouter>' : ''}({ baseUrl: ${rpcUrl} })\n\nfunction App() {\n  return <h1>Hello from kibinrpc!</h1>\n}\n\ncreateRoot(document.getElementById('root')!).render(<App />)\n`,\n\t\t);\n\n\t\twrite(\n\t\t\troot,\n\t\t\t'index.html',\n\t\t\t`<!DOCTYPE html>\n<html lang=\"en\">\n  <head>\n    <meta charset=\"UTF-8\" />\n    <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" />\n    <title>${name}</title>\n  </head>\n  <body>\n    <div id=\"root\"></div>\n    <script type=\"module\" src=\"/src/client/main.tsx\"></script>\n  </body>\n</html>\n`,\n\t\t);\n\n\t\twrite(\n\t\t\troot,\n\t\t\t'vite.config.ts',\n\t\t\t`import { defineConfig } from 'vite'\nimport react from '@vitejs/plugin-react'\n\nexport default defineConfig({\n  plugins: [react()],${hasBackend ? `\\n  server: { proxy: { '/api': 'http://localhost:3001' } },` : ''}\n})\n`,\n\t\t);\n\t}\n\n\t// README\n\tconst parts = [hasBackend && 'backend', hasFrontend && 'frontend'].filter(Boolean);\n\twrite(\n\t\troot,\n\t\t'README.md',\n\t\t`# ${name}\n\nA kibinrpc project with ${parts.join(' + ')}.\n\n## Getting started\n\n\\`\\`\\`sh\npnpm install\npnpm dev\n\\`\\`\\`\n`,\n\t);\n}\n","#!/usr/bin/env node\nimport { cancel, intro, isCancel, multiselect, outro, spinner, text } from '@clack/prompts';\nimport { scaffold, type TemplateId } from './scaffold.js';\n\nasync function main() {\n\tintro(' create kibinrpc ');\n\n\tconst name = await text({\n\t\tmessage: 'Project name',\n\t\tplaceholder: 'my-app',\n\t\tvalidate: (v) => {\n\t\t\tif (!v.trim()) return 'Please enter a project name';\n\t\t\tif (!/^[a-z0-9-]+$/.test(v.trim()))\n\t\t\t\treturn 'Only lowercase letters, numbers and hyphens allowed';\n\t\t},\n\t});\n\tif (isCancel(name)) {\n\t\tcancel('Cancelled');\n\t\tprocess.exit(0);\n\t}\n\n\tconst templates = await multiselect<\n\t\t{ value: TemplateId; label: string; hint: string }[],\n\t\tTemplateId\n\t>({\n\t\tmessage: 'What would you like to include?',\n\t\toptions: [\n\t\t\t{ value: 'backend', label: 'Backend', hint: 'server router + actions' },\n\t\t\t{ value: 'frontend', label: 'Frontend', hint: 'React + Vite client' },\n\t\t],\n\t\tinitialValues: ['backend', 'frontend'],\n\t\trequired: true,\n\t});\n\tif (isCancel(templates)) {\n\t\tcancel('Cancelled');\n\t\tprocess.exit(0);\n\t}\n\n\tconst s = spinner();\n\ts.start(`Creating ${name}`);\n\tscaffold({ name: name.trim(), templates });\n\ts.stop(`Created ${name}`);\n\n\toutro(`Next steps:\\n  cd ${name}\\n  pnpm install\\n  pnpm dev`);\n}\n\nmain().catch((err) => {\n\tconsole.error(err);\n\tprocess.exit(1);\n});\n"],"mappings":"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"}

package/package.json

@@ -1,16 +1,26 @@
 {
   "name": "kibinrpc",
-  "version": "0.1.0",
-  "description": "CLI for kibinrpc",
+  "version": "0.2.0",
+  "description": "Create a new kibinrpc project",
   "license": "MIT",
   "type": "module",
   "bin": {
-    "kibinrpc": "./bin/kibinrpc.js"
+    "kibinrpc": "./dist/index.mjs"
   },
   "files": [
-    "bin"
+    "dist"
   ],
+  "dependencies": {
+    "@clack/prompts": "^0.10.1"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.1"
+  },
   "engines": {
-    "node": ">=18"
+    "node": ">=22"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch"
   }
 }

package/bin/kibinrpc.js

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-console.log('kibinrpc');