@whxcctv/create-tony-app 1.0.1

package/Readme.md

@@ -0,0 +1,142 @@
+# Tony Server 🚀
+
+**Tony** is an extremely lightweight, configuration‑driven Node.js Web
+API server scaffold. It is designed for developers who pursue maximal
+performance and code purity.
+
+Unlike traditional frameworks, Tony embraces a **No TypeScript**
+philosophy, offering type safety through **JSDoc**, and using **static
+code generation** to transform route configuration into a physical
+directory structure, completely eliminating runtime route‑lookup
+overhead.
+
+------------------------------------------------------------------------
+
+## Core Features
+
+-   **Zero Framework**: Built on native Node.js `http` module with no
+    heavy runtime framework dependencies.
+-   **Static Routing**: Generates nested `if-else` dispatch logic;
+    routing performance approaches $O(1)$.
+-   **ESM First**: Fully embraces modern ES6 module standards
+    (`import/export`).
+-   **JSDoc Powered**: Full IDE autocomplete and type checking, even in
+    pure JavaScript.
+-   **Object‑Driven Config**: Elegant object-based routing configuration
+    that makes API structure instantly understandable.
+
+------------------------------------------------------------------------
+
+## Project Architecture
+
+The generated project follows a highly decoupled physical directory
+structure:
+
+-   **`/tony`**: Core helper library. Injects utilities like
+    `res.json()` and `res.status()`.
+-   **`/middlewares`**: Stores business middlewares (auth, rate
+    limiting, logging, etc.).
+-   **`/routers`**: Core routing tree. Each folder represents an API
+    path:
+    -   `index.js`: Auto‑generated router dispatcher handling middleware
+        chains and child route matching.
+    -   `*.service.js`: Actual business logic processors.
+
+------------------------------------------------------------------------
+
+## Quick Start
+
+### 1. Prepare Environment
+
+Ensure your `package.json` is configured for ESM:
+
+``` json
+{
+  "type": "module",
+  "scripts": {
+    "build": "node generator.js",
+    "dev": "node dev-server.js"
+  }
+}
+```
+
+### 2. Define API (tony.config.js)
+
+Example Audiobooks API structure:
+
+``` js
+export default {
+  server: { port: 3000 },
+  routes: {
+    "/api/v1/books": {
+      services: ["list", "search"],
+      middlewares: [["./cache.js"]]
+    },
+    "/api/v1/me/library": {
+      middlewares: [["./jwtAuth.js"]],
+      services: ["getCollection", "addBook"]
+    }
+  }
+};
+```
+
+### 3. Generate & Run
+
+``` bash
+npm run build   # Generate static directories & code
+npm run dev     # Start dev server (with hot reload)
+```
+
+------------------------------------------------------------------------
+
+## Development Guide
+
+### Writing a Service
+
+Tony automatically generates JSDoc‑rich templates to give pure JS a
+strong typing experience:
+
+``` js
+/**
+ * @param {import('../../../tony/helpers').EnhancedRequest} req
+ * @param {import('../../../tony/helpers').EnhancedResponse} res
+ */
+export async function list(req, res) {
+  res.status(200).json({
+    success: true,
+    data: [{ id: 1, title: "The Great Gatsby" }]
+  });
+}
+```
+
+### Writing Middleware
+
+Middlewares return `false` to stop the request chain:
+
+``` js
+export default function auth(options) {
+  return async (req, res) => {
+    if (!req.headers.authorization) {
+      res.status(401).json({ error: "Unauthorized" });
+      return false; // Stop chain
+    }
+  };
+}
+```
+
+------------------------------------------------------------------------
+
+## Performance
+
+Traditional frameworks often rely on dynamic regex‑based routing. Tony
+transforms routing into static, precompiled branch code.
+
+This reduces CPU overhead and makes the execution path fully
+observable---you can directly inspect the generated `index.js` to
+understand the full request flow.
+
+------------------------------------------------------------------------
+
+## License
+
+MIT

package/bin/back.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+
+import { spawn } from 'child_process';
+import path from 'path';
+import { pathToFileURL } from 'url';
+import fs from 'fs';
+import { createApp } from '../src/generator.js'; // 将之前的逻辑移到这里
+import { log } from 'console';
+
+const args = process.argv.slice(2);
+const configPath = path.resolve(process.cwd(), 'tony.config.js');
+
+async function loadConfig() {
+  // 1. 获取绝对路径
+  const absolutePath = path.resolve(process.cwd(), 'tony.config.js');
+  
+  // 2. 将 C:\... 转换为 file:///C:/...
+  const fileUrl = pathToFileURL(absolutePath).href;
+  
+  try {
+    // 3. 加上时间戳缓存消除，动态导入
+    const configModule = await import(`${fileUrl}?update=${Date.now()}`);
+    return configModule.default;
+  } catch (err) {
+    console.error('❌ Failed to load config:', err);
+    throw err;
+  }
+}
+// 核心执行逻辑
+const runGeneration = async () => {
+  console.log('🏗️  Generating server structure...');
+  try {
+    // 动态加载配置（清除 ESM 缓存需要加 query）
+    const config = await loadConfig()
+    console.log(config);
+    
+    createApp(config);
+    console.log('✅ Structure updated.');
+  } catch (err) {
+    console.error('❌ Generation failed:', err.message);
+  }
+};
+
+// 监听模式
+// if (args.includes('--watch')) {
+//   console.log('👀 Watching for changes in tony.config.js...');
+//   fs.watchFile(configPath, { interval: 500 }, () => {
+//     runGeneration();
+//   });
+// }
+
+// 初始化模式
+// if (args.includes('init')) {
+//   const template = `export default {
+//   middlewares: [],
+//   routes: {
+//     "/": [[], ["home"]]
+//   }
+// };`;
+//   if (!fs.existsSync(configPath)) {
+//     fs.writeFileSync(configPath, template);
+//     console.log('🆕 Created tony.config.js');
+//   }
+// } else {
+//   runGeneration();
+// }

package/bin/dev-server.js

@@ -0,0 +1,42 @@
+import { spawn } from 'child_process';
+import path from 'path';
+import fs from 'fs';
+import { createApp } from '../src/generator.js';
+
+let serverProcess = null;
+
+// 启动/重启生成的 app.js
+function restartServer() {
+  if (serverProcess) {
+    serverProcess.kill('SIGTERM');
+  }
+
+  console.log('🚀 Starting Tony server...');
+  serverProcess = spawn('node', ['app.js'], { stdio: 'inherit' });
+
+  serverProcess.on('close', (code) => {
+    if (code && code !== 0) console.error(`Server exited with code ${code}`);
+  });
+}
+
+// 核心工作流
+async function workflow() {
+  // 1. 生成代码
+  const config = (await import(`./tony.config.js?t=${Date.now()}`)).default;
+  createApp(config);
+  
+  // 2. 重启服务器
+  restartServer();
+}
+
+// 监听配置变化
+fs.watchFile(path.resolve('tony.config.js'), { interval: 500 }, workflow);
+
+// 监听业务代码变化 (routers/middlewares)
+// 这里简单监听整个目录，实际可以更精细
+fs.watch(path.resolve('routers'), { recursive: true }, () => {
+  console.log('📄 Business code changed, restarting...');
+  restartServer();
+});
+
+workflow();

package/bin/index.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+import fs from "fs";
+import path from "path";
+import { createApp } from "../src/generator.js";
+
+const args = process.argv.slice(2);
+
+// 获取 --config 参数
+function getArgValue(name) {
+  const flag = args.find(a => a.startsWith(`--${name}`));
+  if (!flag) return null;
+  const [, value] = flag.split("=");
+  return value || null;
+}
+
+const projectName = args.find(a => !a.startsWith("--")) || "tony-app";
+const userConfigPath = getArgValue("config");
+
+if (!userConfigPath) {
+  console.error("❌ Missing --config parameter.");
+  console.error("Usage: npx create-tony-app <project> --config=./tony.config.js");
+  process.exit(1);
+}
+
+const targetDir = path.resolve(process.cwd(), projectName);
+fs.mkdirSync(targetDir, { recursive: true });
+
+// 把用户的 config 复制到新项目目录
+const destConfigPath = path.join(targetDir, "tony.config.js");
+fs.copyFileSync(userConfigPath, destConfigPath);
+console.log(`📄 Copied config to ${destConfigPath}`);
+
+// 进入目录执行生成器
+process.chdir(targetDir);
+const config = (await import(pathToFileURL(destConfigPath).href)).default;
+
+createApp(config);
+
+console.log("🎉 Project created successfully!");

package/helper.js

@@ -0,0 +1,18 @@
+// tony/helpers.js
+export function enhanceRequest(req) {
+  const url = new URL(req.url, `http://${req.headers.host}`);
+  req.path = url.pathname;
+  req.query = Object.fromEntries(url.searchParams);
+  // 可以在这里扩展更多，比如解析 cookie
+}
+
+export function enhanceResponse(res) {
+  res.json = (data) => {
+    res.setHeader('Content-Type', 'application/json');
+    res.end(JSON.stringify(data));
+  };
+  res.status = (code) => {
+    res.statusCode = code;
+    return res;
+  };
+}

package/jsconfig.json

@@ -0,0 +1,10 @@
+{
+  "compilerOptions": {
+    "checkJs": true,
+    "target": "ESNext",
+    "module": "ESNext"
+  },
+  "exclude": [
+    "node_modules"
+  ]
+}

package/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "@whxcctv/create-tony-app",
+  "version": "1.0.1",
+  "type": "module",
+  "main": "bin/index.js",
+  "bin": {
+    "create-tony-app": "bin/index.js"
+  },
+  "scripts": {
+    "dev": "node bin/tony.js --watch"
+  }
+}

package/src/generator.js

@@ -0,0 +1,221 @@
+import fs from "fs";
+import path from "path";
+import { fileURLToPath, pathToFileURL } from "url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+/**
+ * 核心工具集
+ */
+const utils = {
+  ensureDir: (dirPath) => fs.mkdirSync(dirPath, { recursive: true }),
+  
+  writeFile: (filePath, content) => {
+    utils.ensureDir(path.dirname(filePath));
+    fs.writeFileSync(filePath, content.trim() + "\n");
+  },
+
+  pascal: (str) => str.split(/[^a-zA-Z0-9]/).filter(Boolean)
+    .map(w => w[0].toUpperCase() + w.slice(1)).join(""),
+
+  toCamel: (str) => str.replace(/[^a-zA-Z0-9]/g, ' ').split(' ').filter(Boolean)
+    .map((w, i) => i === 0 ? w.toLowerCase() : w[0].toUpperCase() + w.slice(1))
+    .join('') || 'module',
+
+  // 关键：统一 ESM 导入路径，必须是 Posix 格式并带后缀
+  toImportPath: (p) => {
+    let posix = p.split(path.sep).join(path.posix.sep);
+    return posix.endsWith('.js') ? posix : `${posix}.js`;
+  },
+
+  jsDoc: `/**
+ * @param {import('http').IncomingMessage & { path: string, query: Object }} req
+ * @param {import('http').ServerResponse & { json: Function, status: Function }} res
+ */`
+};
+
+/**
+ * 递归生成路由
+ */
+function createRouter(route, routeConfig, fullConfig) {
+  const segments = route.split("/").filter(Boolean);
+  const routerDir = path.join("routers", ...segments);
+  const level = segments.length;
+  const isRoot = route === "/";
+
+  // 优雅的配置解构
+  const { 
+    middlewares = [], 
+    services = [] 
+  } = routeConfig;
+
+  const mName = isRoot ? "main" : segments[level - 1];
+  const defaultService = services[0] || (isRoot ? "home" : segments[level - 1]);
+  const allServices = Array.from(new Set([defaultService, ...services]));
+
+  let imports = "";
+  let calls = "";
+
+  // 1. 生成中间件代码
+  middlewares.forEach(([modPath, options], idx) => {
+    const name = path.basename(modPath, ".js");
+    const varPrefix = utils.toCamel(name);
+    const varName = `${varPrefix}_${idx}`;
+    
+    const relPath = modPath.startsWith(".") 
+      ? utils.toImportPath(path.join("../".repeat(level + 1), "middlewares", name))
+      : modPath;
+    
+    imports += `import ${varPrefix}Fn from "${relPath}";\n`;
+    imports += `const ${varName} = ${varPrefix}Fn(${options ? JSON.stringify(options) : ""});\n`;
+    calls += `  if (await ${varName}(req, res) === false) return;\n`;
+  });
+
+  // 2. 生成 Service 导入
+  allServices.forEach(srv => {
+    imports += `import { ${srv} } from "./${srv}.service.js";\n`;
+  });
+
+  // 3. 自动查找并生成子路由分发
+  const childrenPaths = Object.keys(fullConfig.routes).filter(k => {
+    const kSegs = k.split("/").filter(Boolean);
+    const baseMatch = k.startsWith(isRoot ? "/" : route + "/");
+    return baseMatch && kSegs.length === level + 1;
+  });
+
+  childrenPaths.forEach(childPath => {
+    const childName = childPath.split("/").filter(Boolean).pop();
+    const alias = utils.pascal(childName);
+    imports += `import ${alias} from "./${childName}/index.js";\n`;
+    calls += `  if (req.path.startsWith("${childPath}")) return await ${alias}(req, res);\n`;
+  });
+
+  const errorRelPath = utils.toImportPath(path.join("../".repeat(level), "error/index.js"));
+  imports += `import error from "${errorRelPath.startsWith('.') ? errorRelPath : './' + errorRelPath}";\n`;
+
+  // 4. 生成 Router index.js
+  const content = `
+${imports}
+
+${utils.jsDoc}
+export default async function ${mName}(req, res) {
+${calls}
+  try {
+    return await ${defaultService}(req, res);
+  } catch (err) {
+    console.error("[Router Error at ${route}]:", err);
+    return await error(req, res);
+  }
+}`;
+
+  utils.writeFile(path.join(routerDir, "index.js"), content);
+
+  // 5. 生成 Service 模板
+  allServices.forEach(srv => {
+    const srvFile = path.join(routerDir, `${srv}.service.js`);
+    if (!fs.existsSync(srvFile)) {
+      utils.writeFile(srvFile, `
+${utils.jsDoc}
+export async function ${srv}(req, res) {
+  res.end("Response from ${srv} at ${route}");
+}`);
+    }
+  });
+}
+
+/**
+ * 主构建函数
+ */
+export function createApp(config) {
+  const root = process.cwd();
+  ["middlewares", "routers", "tony"].forEach(d => utils.ensureDir(d));
+
+  // 1. 生成 app.js
+  let appImports = `import http from "http";\nimport { enhanceRequest, enhanceResponse } from "./tony/helpers.js";\nimport { handleError } from "./tony/error.js";\nimport main from "./routers/index.js";\n`;
+  let appCalls = "";
+
+  (config.middlewares || []).forEach(([modPath, options], idx) => {
+    const name = path.basename(modPath, ".js");
+    const varPrefix = utils.toCamel(name);
+    const varName = `_global_${varPrefix}_${idx}`;
+    const impPath = modPath.startsWith(".") ? `./middlewares/${name}.js` : modPath;
+    appImports += `import ${varPrefix}Fn from "${impPath}";\nconst ${varName} = ${varPrefix}Fn(${JSON.stringify(options)});\n`;
+    appCalls += `    if (await ${varName}(req, res) === false) return;\n`;
+  });
+
+  const appContent = `${appImports}
+http.createServer(async (req, res) => {
+  try {
+    enhanceRequest(req);
+    enhanceResponse(res);
+${appCalls}
+    await main(req, res);
+  } catch (err) {
+    handleError(err, res);
+  }
+}).listen(config.server?.port || 3000, () => {
+  console.log(\`🚀 Tony server running at http://localhost:\${config.server?.port || 3000}\`);
+});`;
+
+  utils.writeFile("app.js", appContent);
+
+  // 2. 递归生成所有路由
+  Object.entries(config.routes).forEach(([route, routeConfig]) => {
+    createRouter(route, routeConfig, config);
+  });
+
+  // 3. 生成固定辅助代码 (helpers, error, jsconfig)
+  generateHelpers();
+}
+
+function generateHelpers() {
+  utils.writeFile("tony/helpers.js", `
+export function enhanceRequest(req) {
+  const url = new URL(req.url, \`http://\${req.headers.host}\`);
+  req.path = url.pathname;
+  req.query = Object.fromEntries(url.searchParams);
+}
+export function enhanceResponse(res) {
+  res.json = (data) => {
+    res.setHeader("Content-Type", "application/json");
+    res.end(JSON.stringify(data));
+  };
+  res.status = (code) => { res.statusCode = code; return res; };
+}`);
+
+  utils.writeFile("tony/error.js", `
+export function handleError(err, res) {
+  console.error(err);
+  if (!res.writableEnded) {
+    res.writeHead(500);
+    res.end("Internal Server Error");
+  }
+}`);
+
+  utils.writeFile("routers/error/index.js", `
+export default async function _error(req, res) {
+  res.writeHead(404);
+  res.end("404 Not Found");
+}`);
+
+  utils.writeFile("jsconfig.json", JSON.stringify({
+    compilerOptions: { checkJs: true, target: "ESNext", module: "ESNext" },
+    exclude: ["node_modules"]
+  }, null, 2));
+}
+
+/**
+ * 启动器：修复 Windows 路径并加载配置
+ */
+export async function startGenerator() {
+  const configPath = path.resolve(process.cwd(), "tony.config.js");
+  const fileUrl = pathToFileURL(configPath).href;
+  
+  try {
+    const configModule = await import(`${fileUrl}?update=${Date.now()}`);
+    createApp(configModule.default);
+  } catch (err) {
+    console.error("❌ Generation failed:", err);
+  }
+}

package/tony/error.js

@@ -0,0 +1,7 @@
+export function handleError(err, res) {
+  console.error(err);
+  if (!res.writableEnded) {
+    res.writeHead(500);
+    res.end("Internal Server Error");
+  }
+}

package/tony/helpers.js

@@ -0,0 +1,12 @@
+export function enhanceRequest(req) {
+  const url = new URL(req.url, `http://${req.headers.host}`);
+  req.path = url.pathname;
+  req.query = Object.fromEntries(url.searchParams);
+}
+export function enhanceResponse(res) {
+  res.json = (data) => {
+    res.setHeader("Content-Type", "application/json");
+    res.end(JSON.stringify(data));
+  };
+  res.status = (code) => { res.statusCode = code; return res; };
+}

package/tony.config.example.js

@@ -0,0 +1,65 @@
+/** @type {import('./tony/types').TonyConfig} */
+export default {
+  server: {
+    port: 3000,
+    apiPrefix: "/api/v1" // 逻辑前缀
+  },
+
+  // API 专用全局中间件
+  middlewares: [
+    ["./tony/cors.js"],         // 跨域处理
+    ["./tony/bodyParser.js"],   // 解析 JSON Body
+    ["./tony/rateLimiter.js", { windowMs: 15 * 60 * 1000, max: 100 }] // 防刷限流
+  ],
+
+  routes: {
+    // --- 公共资源接口 ---
+    "/api/v1/books": {
+      services: ["list", "search"],
+      middlewares: [["./cache.js", { expire: "10m" }]]
+    },
+
+    // 资源详情：在 service 中通过 req.query.id 处理
+    "/api/v1/books/detail": {
+      services: ["getById", "getChapters", "getRecommendations"]
+    },
+
+    // --- 认证与令牌管理 ---
+    "/api/v1/auth": {
+      services: ["issueToken", "refreshToken", "revokeToken"]
+    },
+
+    // --- 需鉴权的用户私有接口 ---
+    "/api/v1/me": {
+      middlewares: [["./jwtAuth.js"]], // JWT 校验
+      services: ["getProfile", "updateProfile"]
+    },
+
+    // 播放记录（高频同步）
+    "/api/v1/me/progress": {
+      middlewares: [["./jwtAuth.js"]],
+      services: ["sync", "lastPlayed"]
+    },
+
+    // 收藏夹
+    "/api/v1/me/library": {
+      middlewares: [["./jwtAuth.js"]],
+      services: ["addBook", "removeBook", "getCollection"]
+    },
+
+    // --- 媒体分发接口 (通常指向 CDN 或云存储签名地址) ---
+    "/api/v1/stream": {
+      middlewares: [
+        ["./jwtAuth.js"],
+        ["./checkSubscription.js"] // 检查是否已购买或会员
+      ],
+      services: ["getSignedUrl", "getQualityOptions"]
+    },
+
+    // --- 支付与账单 ---
+    "/api/v1/billing": {
+      middlewares: [["./jwtAuth.js"]],
+      services: ["createOrder", "getInvoices", "verifyWebHook"]
+    }
+  }
+};