@ai-partner-x/aiko-boot-cli 0.1.4

package/dist/usecases/init-scaffold.usecase.js

@@ -0,0 +1,131 @@
+import path from 'path';
+import { fileURLToPath } from 'url';
+import fs from 'fs-extra';
+import { saveProjectConfig, } from '../core/project-config.js';
+import { syncRootPackageJson } from '../core/workspace.js';
+import { createAddApiUseCase } from './add-api.usecase.js';
+import { createAddAppUseCase } from './add-app.usecase.js';
+// 在 ESM 环境中模拟 __dirname，兼容打包到 dist 后的运行时
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+export function createInitUseCase(deps) {
+    const { logger, prompter } = deps;
+    async function resolveInput(input) {
+        const cwd = process.cwd();
+        let name = input.name;
+        let targetDir = input.targetDir;
+        // 如果没有显式指定 name，则优先根据 targetDir 推断（取目录名），再退回到交互输入
+        if (!name && targetDir) {
+            name = path.basename(targetDir);
+        }
+        if (!name) {
+            name = await prompter.input('项目名称（例如 my-app）', 'my-app');
+        }
+        if (!targetDir) {
+            const defaultDir = path.join(cwd, name);
+            const answer = await prompter.input('目标目录', path.relative(cwd, defaultDir) || defaultDir);
+            targetDir = path.resolve(cwd, answer || defaultDir);
+        }
+        const resolvedName = name;
+        const resolvedTargetDir = targetDir;
+        // 默认使用包内置模板：templates/scaffold-default
+        // 这样发布到 npm 后也可以直接使用，而无需依赖仓库根目录的 ./scaffold。
+        const defaultTemplateDir = path.resolve(__dirname, '../../templates/scaffold-default');
+        const templateDir = input.templateDir ?? defaultTemplateDir;
+        return {
+            targetDir: resolvedTargetDir,
+            name: resolvedName,
+            templateDir,
+            options: {
+                empty: input.empty,
+                withAdmin: input.withAdmin,
+                withMobile: input.withMobile,
+                withApi: input.withApi,
+                dryRun: input.dryRun,
+            },
+        };
+    }
+    async function execute(input) {
+        const { targetDir, name, templateDir, options } = await resolveInput(input);
+        if (options.dryRun) {
+            logger.info('[dry-run] 将会创建脚手架：');
+            logger.info(`  name: ${name}`);
+            logger.info(`  targetDir: ${targetDir}`);
+            logger.info(`  templateDir: ${templateDir}`);
+            logger.info(`  empty: ${options.empty}, withAdmin: ${options.withAdmin}, withMobile: ${options.withMobile}, withApi: ${options.withApi}`);
+            return;
+        }
+        logger.info(`创建 aiko-boot 脚手架到：${targetDir}`);
+        await fs.ensureDir(path.dirname(targetDir));
+        // 步骤 1: 总是先创建空骨架和基础配置文件
+        await fs.ensureDir(targetDir);
+        await fs.ensureDir(path.join(targetDir, 'packages'));
+        const rootPkgPath = path.join(targetDir, 'package.json');
+        if (!(await fs.pathExists(rootPkgPath))) {
+            await fs.writeJson(rootPkgPath, {
+                name: `${name}-monorepo`,
+                private: true,
+                version: '0.1.0',
+                scripts: {
+                    dev: 'echo "Add dev scripts in each package (api/admin/mobile) after created."',
+                },
+            }, { spaces: 2 });
+        }
+        const workspacePath = path.join(targetDir, 'pnpm-workspace.yaml');
+        if (!(await fs.pathExists(workspacePath))) {
+            await fs.writeFile(workspacePath, `packages:
+  - 'packages/*'
+`, 'utf-8');
+        }
+        // 步骤 2: 创建 .aiko-boot.json 配置文件
+        const config = {
+            version: 1,
+            scope: name,
+            packageManager: 'pnpm',
+            apps: [],
+            apis: [],
+        };
+        await saveProjectConfig(targetDir, config);
+        // 步骤 3: 如果指定了 --with-api/--with-admin/--with-mobile，复用 add-api/add-app 的逻辑
+        if (!options.empty) {
+            const addApiUseCase = createAddApiUseCase({ logger, prompter });
+            const addAppUseCase = createAddAppUseCase({ logger, prompter });
+            // 默认模板目录：使用内置的 scaffold-default（如果用户没指定）
+            const defaultTemplateRoot = templateDir;
+            if (options.withApi) {
+                logger.info('正在添加 API 服务端...');
+                await addApiUseCase.execute({
+                    name: 'api',
+                    db: 'sqlite',
+                    rootDir: targetDir,
+                    templateDir: undefined, // 使用 add-api 的默认内置模板 api-base
+                    dryRun: false,
+                });
+            }
+            if (options.withAdmin) {
+                logger.info('正在添加 Admin 应用...');
+                await addAppUseCase.execute({
+                    name: 'admin',
+                    type: 'admin',
+                    rootDir: targetDir,
+                    templateDir: defaultTemplateRoot, // 从 scaffold-default/packages/admin 复制
+                    dryRun: false,
+                });
+            }
+            if (options.withMobile) {
+                logger.info('正在添加 Mobile 应用...');
+                await addAppUseCase.execute({
+                    name: 'mobile',
+                    type: 'mobile',
+                    rootDir: targetDir,
+                    templateDir: defaultTemplateRoot, // 从 scaffold-default/packages/mobile 复制
+                    dryRun: false,
+                });
+            }
+        }
+        // 最后统一同步根 package.json（scripts / pnpm.onlyBuiltDependencies 等）
+        await syncRootPackageJson(targetDir);
+        logger.info('脚手架创建完成。');
+    }
+    return { execute };
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@ai-partner-x/aiko-boot-cli",
+  "version": "0.1.4",
+  "description": "CLI to create aiko-boot scaffold project (monorepo with api, admin, mobile, shared)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "aiko-boot": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "dependencies": {
+    "commander": "^12.1.0",
+    "fs-extra": "^11.2.0"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^20.11.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "sync:templates:scaffold-default": "node ./scripts/sync-scaffold-default.mjs",
+    "sync:templates:scaffold-default:dry": "node ./scripts/sync-scaffold-default.mjs --dry-run"
+  }
+}

package/templates/api-base/app.config.ts

@@ -0,0 +1,155 @@
+import type { AppConfig } from '@ai-partner-x/aiko-boot';
+
+export default {
+  server: {
+    port: Number(process.env.PORT) || 3001,
+    servlet: {
+      contextPath: '/api',
+    },
+    shutdown: 'graceful',
+  },
+  logging: {
+    // 日志级别：error, warn, info, http, verbose, debug, silly
+    level: process.env.NODE_ENV === 'production' ? 'info' : 'debug',
+
+    // 输出格式：json, cli, pretty, simple
+    format: process.env.NODE_ENV === 'production' ? 'json' : 'cli',
+
+    // 是否启用颜色
+    colorize: process.env.NODE_ENV !== 'production',
+
+    // 是否显示时间戳
+    timestamp: true,
+
+    // 默认元数据
+    defaultMeta: {
+      service: 'scaffold-api',
+      version: '0.1.0',
+      env: process.env.NODE_ENV || 'development',
+    },
+
+    // 传输配置
+    transports: [
+      {
+        type: 'console',
+        enabled: true,
+        level: process.env.NODE_ENV === 'production' ? 'info' : 'debug',
+        format: process.env.NODE_ENV === 'production' ? 'json' : 'cli',
+        colorize: process.env.NODE_ENV !== 'production',
+      },
+      {
+        type: 'file',
+        enabled: true,
+        filename: './logs/log-{date}.log',
+        level: 'info',
+        maxSize: '10m',
+        maxFiles: 7,
+        format: 'json',
+        rotateByDate: true,
+        retentionDays: 30,
+        maxFileSize: 100,
+      },
+      {
+        type: 'file',
+        enabled: true,
+        filename: './logs/error-{date}.log',
+        level: 'error',
+        maxSize: '10m',
+        maxFiles: 30,
+        format: 'json',
+        rotateByDate: true,
+        retentionDays: 30,
+        maxFileSize: 100,
+      },
+    ],
+  },
+
+  database: {
+    type: 'sqlite',
+    filename: './data/app.db',
+  },
+  validation: {
+    enabled: true,
+    failFast: false,
+  },
+  security: {
+    enabled: true,
+    jwt: {
+      secret:
+        process.env.JWT_SECRET ||
+        (() => {
+          console.warn('⚠️ Using default JWT secret in development!');
+          return 'dev-only-secret';
+        })(),
+      expiresIn: '1h',
+    },
+    session: {
+      secret:
+        process.env.SESSION_SECRET ||
+        (() => {
+          console.warn('⚠️ Using default session secret in development!');
+          return 'dev-only-session-secret';
+        })(),
+      maxAge: 86400000,
+      resave: false,
+      saveUninitialized: false,
+      cookie: {
+        secure: process.env.NODE_ENV === 'production',
+        httpOnly: true,
+        sameSite: 'strict',
+        maxAge: 86400000,
+      },
+    },
+    oauth2: {
+      github: {
+        clientID:
+          process.env.GITHUB_CLIENT_ID ||
+          (() => {
+            console.warn('⚠️ Using default GitHub client ID in development!');
+            return 'your-github-client-id';
+          })(),
+        clientSecret:
+          process.env.GITHUB_CLIENT_SECRET ||
+          (() => {
+            console.warn('⚠️ Using default GitHub client secret in development!');
+            return 'your-github-client-secret';
+          })(),
+        callbackURL:
+          process.env.GITHUB_CALLBACK_URL ||
+          'http://localhost:3001/api/auth/github/callback',
+      },
+      google: {
+        clientID:
+          process.env.GOOGLE_CLIENT_ID ||
+          (() => {
+            console.warn('⚠️ Using default Google client ID in development!');
+            return 'your-google-client-id';
+          })(),
+        clientSecret:
+          process.env.GOOGLE_CLIENT_SECRET ||
+          (() => {
+            console.warn('⚠️ Using default Google client secret in development!');
+            return 'your-google-client-secret';
+          })(),
+        callbackURL:
+          process.env.GOOGLE_CALLBACK_URL ||
+          'http://localhost:3001/api/auth/google/callback',
+      },
+    },
+    publicPaths: [
+      '/api/auth/login',
+      '/api/auth/register',
+      '/api/auth/github',
+      '/api/auth/google',
+      '/api/auth/github/callback',
+      '/api/auth/google/callback',
+      '/api/public',
+    ],
+    cors: {
+      enabled: true,
+      origin: process.env.CORS_ORIGIN || '*',
+      credentials: true,
+    },
+  },
+} satisfies AppConfig;
+

package/templates/api-base/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@scaffold/api",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "exports": {
+    "./client": {
+      "import": "./dist/client/index.ts",
+      "types": "./dist/client/index.ts"
+    }
+  },
+  "scripts": {
+    "dev": "concurrently -n codegen,server -c blue,green \"pnpm codegen:watch\" \"node --import @swc-node/register/esm-register --watch src/server.ts\"",
+    "dev:server": "node --import @swc-node/register/esm-register --watch src/server.ts",
+    "codegen:watch": "node scripts/codegen.cjs --watch",
+    "init-db": "node --import @swc-node/register/esm-register src/scripts/init-db.ts",
+    "codegen": "node scripts/codegen.cjs",
+    "build": "pnpm codegen && tsup",
+    "start": "node dist/server.js",
+    "lint": "eslint src"
+  },
+  "dependencies": {
+    "@ai-partner-x/aiko-boot": "workspace:*",
+    "@ai-partner-x/aiko-boot-codegen": "workspace:*",
+    "@ai-partner-x/aiko-boot-starter-orm": "workspace:*",
+    "@ai-partner-x/aiko-boot-starter-validation": "workspace:*",
+    "@ai-partner-x/aiko-boot-starter-web": "workspace:*",
+    "@ai-partner-x/aiko-boot-starter-security": "workspace:*",
+    "@ai-partner-x/aiko-boot-starter-log": "workspace:*",
+    "bcryptjs": "^2.4.3",
+    "jsonwebtoken": "^9.0.2",
+    "better-sqlite3": "^12.6.2",
+    "cors": "^2.8.5",
+    "date-fns": "^4.1.0",
+    "express": "^4.18.0",
+    "axios": "^1.6.0",
+    "reflect-metadata": "^0.2.1"
+  },
+  "devDependencies": {
+    "concurrently": "^9.2.1",
+    "sql.js": "^1.11.0",
+    "@swc-node/register": "^1.11.1",
+    "@swc/core": "^1.15.18",
+    "@types/bcryptjs": "^2.4.6",
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/cors": "^2.8.17",
+    "@types/express": "^4.17.21",
+    "@types/jsonwebtoken": "^9.0.5",
+    "@types/node": "^20.11.0",
+    "tsup": "^8.0.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.0"
+  }
+}
+

package/templates/api-base/scripts/codegen.cjs

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+const { generateApiClient, watchApiClient } = require('@ai-partner-x/aiko-boot-codegen');
+
+const isWatch = process.argv.includes('--watch') || process.argv.includes('-w');
+const isForce = process.argv.includes('--force') || process.argv.includes('-f');
+
+function handleError(error) {
+  console.error('\n❌ 代码生成失败:', error.message);
+  console.error('\n请检查以下问题：');
+  console.error('1. 源文件路径是否正确');
+  console.error('2. TypeScript 代码是否有语法错误');
+  console.error('3. 依赖是否正确安装');
+  console.error('\n详细错误信息:', error.stack);
+  process.exit(1);
+}
+
+if (isWatch) {
+  try {
+    watchApiClient();
+  } catch (error) {
+    handleError(error);
+  }
+} else {
+  try {
+    generateApiClient({ force: isForce });
+  } catch (error) {
+    handleError(error);
+  }
+}
+

package/templates/api-base/scripts/codegen.ts

@@ -0,0 +1,10 @@
+import { generateApiClient, watchApiClient } from '@ai-partner-x/aiko-boot-codegen';
+
+const isWatch = process.argv.includes('--watch') || process.argv.includes('-w');
+
+if (isWatch) {
+  watchApiClient();
+} else {
+  generateApiClient();
+}
+

package/templates/api-base/src/controller/auth.controller.ts

@@ -0,0 +1,160 @@
+import 'reflect-metadata';
+import {
+  RestController,
+  PostMapping,
+  GetMapping,
+  RequestBody,
+  RequestParam,
+  QueryParam,
+} from '@ai-partner-x/aiko-boot-starter-web';
+import { Autowired } from '@ai-partner-x/aiko-boot';
+import { Public } from '@ai-partner-x/aiko-boot-starter-security';
+import { AuthService } from '../service/auth.service.js';
+import type {
+  LoginDto,
+  LoginResultDto,
+  RefreshTokenDto,
+} from '../dto/auth.dto.js';
+import axios from 'axios';
+
+@RestController({ path: '/auth' })
+export class AuthController {
+  @Autowired()
+  private authService!: AuthService;
+
+  @PostMapping('/login')
+  @Public()
+  async login(@RequestBody() dto: LoginDto): Promise<LoginResultDto> {
+    return this.authService.login(dto);
+  }
+
+  @PostMapping('/refresh')
+  @Public()
+  async refresh(
+    @RequestBody() dto: RefreshTokenDto,
+  ): Promise<{ accessToken: string }> {
+    return this.authService.refreshToken(dto.refreshToken);
+  }
+
+  @GetMapping('/info')
+  async getUserInfo(
+    @RequestParam('_uid') userId: string,
+  ): Promise<LoginResultDto['userInfo']> {
+    return this.authService.getUserInfo(Number(userId));
+  }
+
+  @PostMapping('/logout')
+  async logout(@RequestBody() body: { token: string }): Promise<any> {
+    return this.authService.logout(body.token);
+  }
+
+  @GetMapping('/github')
+  @Public()
+  async githubAuth(@QueryParam('redirect') redirect?: string): Promise<any> {
+    const clientId = process.env.GITHUB_CLIENT_ID;
+    const redirectUri = process.env.GITHUB_CALLBACK_URL;
+    const scope = 'user:email';
+
+    const authUrl = `https://github.com/login/oauth/authorize?client_id=${clientId}&redirect_uri=${encodeURIComponent(
+      redirectUri!,
+    )}&scope=${scope}${
+      redirect ? `&redirect_uri=${encodeURIComponent(redirect)}` : ''
+    }`;
+
+    return { authUrl };
+  }
+
+  @GetMapping('/github/callback')
+  @Public()
+  async githubCallback(@QueryParam('code') code: string): Promise<any> {
+    try {
+      const clientId = process.env.GITHUB_CLIENT_ID;
+      const clientSecret = process.env.GITHUB_CLIENT_SECRET;
+      const redirectUri = process.env.GITHUB_CALLBACK_URL;
+
+      const tokenResponse = await axios.post(
+        'https://github.com/login/oauth/access_token',
+        {
+          client_id: clientId,
+          client_secret: clientSecret,
+          code: code,
+          redirect_uri: redirectUri,
+        },
+        {
+          headers: { Accept: 'application/json' },
+        },
+      );
+
+      const tokens = tokenResponse.data;
+
+      const userResponse = await axios.get('https://api.github.com/user', {
+        headers: { Authorization: `Bearer ${tokens.access_token}` },
+      });
+
+      const profile = {
+        ...userResponse.data,
+        provider: 'github',
+      };
+
+      return this.authService.handleOAuthCallback(profile, tokens);
+    } catch (error) {
+      throw new Error('GitHub OAuth token exchange failed');
+    }
+  }
+
+  @GetMapping('/google')
+  @Public()
+  async googleAuth(@QueryParam('redirect') redirect?: string): Promise<any> {
+    const clientId = process.env.GOOGLE_CLIENT_ID;
+    const redirectUri = process.env.GOOGLE_CALLBACK_URL;
+    const scope = 'profile email';
+
+    const authUrl = `https://accounts.google.com/o/oauth2/v2/auth?client_id=${clientId}&redirect_uri=${encodeURIComponent(
+      redirectUri!,
+    )}&scope=${encodeURIComponent(scope)}&response_type=code${
+      redirect ? `&redirect_uri=${encodeURIComponent(redirect)}` : ''
+    }`;
+
+    return { authUrl };
+  }
+
+  @GetMapping('/google/callback')
+  @Public()
+  async googleCallback(@QueryParam('code') code: string): Promise<any> {
+    try {
+      const clientId = process.env.GOOGLE_CLIENT_ID;
+      const clientSecret = process.env.GOOGLE_CLIENT_SECRET;
+      const redirectUri = process.env.GOOGLE_CALLBACK_URL;
+
+      const tokenResponse = await axios.post(
+        'https://oauth2.googleapis.com/token',
+        {
+          client_id: clientId,
+          client_secret: clientSecret,
+          code: code,
+          redirect_uri: redirectUri,
+          grant_type: 'authorization_code',
+        },
+      );
+
+      const tokens = tokenResponse.data;
+
+      const userResponse = await axios.get(
+        'https://www.googleapis.com/oauth2/v2/userinfo',
+        {
+          headers: { Authorization: `Bearer ${tokens.access_token}` },
+        },
+      );
+
+      const profile = {
+        ...userResponse.data,
+        provider: 'google',
+      };
+
+      return this.authService.handleOAuthCallback(profile, tokens);
+    } catch (error) {
+      throw new Error('Google OAuth token exchange failed');
+    }
+  }
+}
+

package/templates/api-base/src/controller/menu.controller.ts

@@ -0,0 +1,56 @@
+import 'reflect-metadata';
+import {
+  RestController,
+  GetMapping,
+  PostMapping,
+  PutMapping,
+  DeleteMapping,
+  PathVariable,
+  RequestBody,
+  RequestParam,
+} from '@ai-partner-x/aiko-boot-starter-web';
+import { Autowired } from '@ai-partner-x/aiko-boot/di/server';
+import { MenuService } from '../service/menu.service.js';
+import type { CreateMenuDto, UpdateMenuDto } from '../dto/menu.dto.js';
+
+@RestController({ path: '/sys/menu' })
+export class MenuController {
+  @Autowired()
+  private menuService!: MenuService;
+
+  @GetMapping('/tree')
+  async getFullTree() {
+    return this.menuService.getFullTree();
+  }
+
+  @GetMapping('/user-tree')
+  async getUserTree(@RequestParam('_perms') perms: string) {
+    const permissions = perms ? perms.split(',').filter(Boolean) : [];
+    return this.menuService.getUserMenuTree(permissions);
+  }
+
+  @GetMapping('/:id')
+  async getById(@PathVariable('id') id: string) {
+    return this.menuService.getById(Number(id));
+  }
+
+  @PostMapping()
+  async create(@RequestBody() dto: CreateMenuDto) {
+    return this.menuService.createMenu(dto);
+  }
+
+  @PutMapping('/:id')
+  async update(
+    @PathVariable('id') id: string,
+    @RequestBody() dto: UpdateMenuDto,
+  ) {
+    return this.menuService.updateMenu(Number(id), dto);
+  }
+
+  @DeleteMapping('/:id')
+  async delete(@PathVariable('id') id: string) {
+    await this.menuService.deleteMenu(Number(id));
+    return { message: '删除成功' };
+  }
+}
+