@coze-arch/cli 0.0.1-alpha.fc5c04 → 0.0.1-alpha.ff3d06

package/lib/__templates__/vite/scripts/build.sh

@@ -8,7 +8,10 @@ cd "${COZE_WORKSPACE_PATH}"
 echo "Installing dependencies..."
 pnpm install --prefer-frozen-lockfile --prefer-offline --loglevel debug --reporter=append-only
 
-echo "Building the project..."
+echo "Building frontend with Vite..."
 npx vite build
 
+echo "Bundling server with tsup..."
+npx tsup server/server.ts --format cjs --platform node --target node20 --outDir dist-server --no-splitting --no-minify --external vite
+
 echo "Build completed successfully!"

package/lib/__templates__/vite/scripts/dev.sh

@@ -1,9 +1,16 @@
 #!/bin/bash
 set -Eeuo pipefail
 
+<% if (process.env.NODE_ENV === 'test') { %>
+# 测试环境：支持环境变量覆盖端口
+PORT="${PORT:-<%= port %>}"
+COZE_WORKSPACE_PATH="${COZE_WORKSPACE_PATH:-$(pwd)}"
+DEPLOY_RUN_PORT="${DEPLOY_RUN_PORT:-${PORT}}"
+<% } else { %>
 PORT=<%= port %>
 COZE_WORKSPACE_PATH="${COZE_WORKSPACE_PATH:-$(pwd)}"
 DEPLOY_RUN_PORT=<%= port %>
+<% } %>
 
 cd "${COZE_WORKSPACE_PATH}"
 
@@ -27,6 +34,6 @@ kill_port_if_listening() {
 
 echo "Clearing port ${PORT} before start."
 kill_port_if_listening
-echo "Starting HTTP service on port ${PORT} for dev..."
+echo "Starting express + Vite dev server on port ${PORT}..."
 
-npx vite --port $PORT
+PORT=$PORT npx tsx watch server/server.ts

package/lib/__templates__/vite/scripts/start.sh

@@ -2,14 +2,20 @@
 set -Eeuo pipefail
 
 COZE_WORKSPACE_PATH="${COZE_WORKSPACE_PATH:-$(pwd)}"
+<% if (process.env.NODE_ENV === 'test') { %>
+# 测试环境：支持环境变量覆盖端口
+PORT="${PORT:-<%= port %>}"
+DEPLOY_RUN_PORT="${DEPLOY_RUN_PORT:-${PORT}}"
+<% } else { %>
 PORT=<%= port %>
 DEPLOY_RUN_PORT="${DEPLOY_RUN_PORT:-$PORT}"
+<% } %>
 
 start_service() {
     cd "${COZE_WORKSPACE_PATH}"
-    echo "Starting HTTP service on port ${DEPLOY_RUN_PORT} for deploy..."
-    npx vite preview --port $DEPLOY_RUN_PORT
+    echo "Starting express production server on port ${DEPLOY_RUN_PORT}..."
+    PORT=$DEPLOY_RUN_PORT node dist-server/server.js
 }
 
-echo "Starting HTTP service on port ${DEPLOY_RUN_PORT} for deploy..."
+echo "Starting express production server on port ${DEPLOY_RUN_PORT}..."
 start_service

package/lib/__templates__/vite/server/routes/index.ts

@@ -0,0 +1,31 @@
+import { Router } from 'express';
+
+const router = Router();
+
+// API 路由示例
+router.get('/api/hello', (req, res) => {
+  res.json({
+    message: 'Hello from Express + Vite!',
+    timestamp: new Date().toISOString(),
+  });
+});
+
+router.post('/api/data', (req, res) => {
+  const requestData = req.body;
+  res.json({
+    success: true,
+    data: requestData,
+    receivedAt: new Date().toISOString(),
+  });
+});
+
+// 健康检查接口
+router.get('/api/health', (req, res) => {
+  res.json({
+    status: 'ok',
+    env: process.env.COZE_PROJECT_ENV,
+    timestamp: new Date().toISOString(),
+  });
+});
+
+export default router;

package/lib/__templates__/vite/server/server.ts

@@ -0,0 +1,65 @@
+// ABOUTME: Express server with Vite integration
+// ABOUTME: Handles API routes and serves frontend in dev/prod modes
+
+import { createServer, type Server } from 'http';
+import express from 'express';
+import router from './routes/index';
+import { setupVite } from './vite';
+
+const isDev = process.env.COZE_PROJECT_ENV !== 'PROD';
+const port = parseInt(process.env.PORT || '<%= port %>', 10);
+const hostname = process.env.HOSTNAME || 'localhost';
+const app = express();
+// 使用 http.createServer 包装 Express app，以便支持 WebSocket 等协议升级
+const server = createServer(app);
+
+async function startServer(): Promise<Server> {
+  // 请求日志（仅开发环境）
+  if (isDev) {
+    app.use((req, res, next) => {
+      const start = Date.now();
+      res.on('finish', () => {
+        const ms = Date.now() - start;
+        console.log(`${req.method} ${req.url} - ${ms}ms`);
+      });
+      next();
+    });
+  }
+
+  // 添加请求体解析
+  app.use(express.json());
+  app.use(express.urlencoded({ extended: true }));
+
+  // 注册 API 路由
+  app.use(router);
+
+  // 集成 Vite（开发模式）或静态文件服务（生产模式）
+  await setupVite(app);
+
+  // 全局错误处理
+  app.use((err: Error, req: express.Request, res: express.Response) => {
+    console.error('Server error:', err);
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const status = 'status' in err ? (err as any).status || 500 : 500;
+    res.status(status).json({
+      error: err.message || 'Internal server error',
+    });
+  });
+
+  server.once('error', err => {
+    console.error('Server error:', err);
+    process.exit(1);
+  });
+
+  server.listen(port, () => {
+    console.log(`\n✨ Server running at http://${hostname}:${port}`);
+    console.log(`📝 Environment: ${isDev ? 'development' : 'production'}\n`);
+  });
+
+  return server;
+}
+
+startServer().catch(err => {
+  console.error('Failed to start server:', err);
+  process.exit(1);
+});

package/lib/__templates__/vite/server/vite.ts

@@ -0,0 +1,67 @@
+// ABOUTME: Vite integration for Express server
+// ABOUTME: Handles dev middleware and production static file serving
+
+import type { Application, Request, Response } from 'express';
+import express from 'express';
+import path from 'path';
+import fs from 'fs';
+import { createServer as createViteServer } from 'vite';
+import viteConfig from '../vite.config';
+
+const isDev = process.env.COZE_PROJECT_ENV !== 'PROD';
+
+/**
+ * 集成 Vite 开发服务器（中间件模式）
+ */
+export async function setupViteMiddleware(app: Application) {
+  const vite = await createViteServer({
+    ...viteConfig,
+    server: {
+      ...viteConfig.server,
+      middlewareMode: true,
+    },
+    appType: 'spa',
+  });
+
+  // 使用 Vite middleware
+  app.use(vite.middlewares);
+
+  console.log('🚀 Vite dev server initialized');
+}
+
+/**
+ * 设置生产环境静态文件服务
+ */
+export function setupStaticServer(app: Application) {
+  const distPath = path.resolve(process.cwd(), 'dist');
+
+  if (!fs.existsSync(distPath)) {
+    console.error('❌ dist folder not found. Please run "pnpm build" first.');
+    process.exit(1);
+  }
+
+  // 1. 服务静态文件（如果存在对应文件则直接返回）
+  app.use(express.static(distPath));
+
+  // 2. SPA fallback - 所有未处理的请求返回 index.html
+  // 到达这里的请求说明：
+  //   - 不是 API 请求（已被前面注册的路由处理）
+  //   - 不是静态文件（express.static 未找到对应文件）
+  //   - 需要返回 index.html 让前端路由处理
+  app.use((_req: Request, res: Response) => {
+    res.sendFile(path.join(distPath, 'index.html'));
+  });
+
+  console.log('📦 Serving static files from dist/');
+}
+
+/**
+ * 根据环境设置 Vite
+ */
+export async function setupVite(app: Application) {
+  if (isDev) {
+    await setupViteMiddleware(app);
+  } else {
+    setupStaticServer(app);
+  }
+}

package/lib/__templates__/vite/tsconfig.json

@@ -3,14 +3,15 @@
     "target": "ES2020",
     "lib": ["ES2020", "DOM", "DOM.Iterable"],
     "module": "ESNext",
-    "moduleResolution": "bundler",
+    "moduleResolution": "node",
     "strict": true,
     "esModuleInterop": true,
     "skipLibCheck": true,
     "forceConsistentCasingInFileNames": true,
     "resolveJsonModule": true,
     "isolatedModules": true,
-    "noEmit": true
+    "noEmit": true,
+    "types": ["node"]
   },
-  "include": ["src"]
+  "include": ["src", "server"]
 }

package/lib/__templates__/vite/vite.config.ts

@@ -12,5 +12,9 @@ export default defineConfig({
       clientPort: 443,
       timeout: 30000,
     },
+    watch: {
+      usePolling: true,
+      interval: 100,
+    }
   },
 });