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

package/templates/scaffold-default/packages/api/src/controller/mq.controller.ts

@@ -1,35 +0,0 @@
-import 'reflect-metadata';
-import { RestController, PostMapping, RequestBody } from '@ai-partner-x/aiko-boot-starter-web';
-import { Autowired } from '@ai-partner-x/aiko-boot';
-import { MqTemplate } from '@ai-partner-x/aiko-boot-starter-mq';
-import type { SendUserEventDto, UserEventDto } from '../dto/mq.dto.js';
-
-@RestController({ path: '/mq' })
-export class MqController {
-  @Autowired(MqTemplate)
-  private mqTemplate!: MqTemplate;
-
-  /**
-   * 发送用户相关消息到 MQ
-   * POST /api/mq/send
-   */
-  @PostMapping('/send')
-  async send(@RequestBody() dto: SendUserEventDto): Promise<{ ok: boolean; topic: string }> {
-    if (dto.tag) {
-      await this.mqTemplate.send(dto.topic, dto.tag, dto.body);
-    } else {
-      await this.mqTemplate.send(dto.topic, dto.body);
-    }
-    return { ok: true, topic: dto.topic };
-  }
-
-  /**
-   * 快捷发送 user.created 事件（复用 User 实体字段）
-   * POST /api/mq/send-user-created
-   */
-  @PostMapping('/send-user-created')
-  async sendUserCreated(@RequestBody() body: UserEventDto): Promise<{ ok: boolean }> {
-    await this.mqTemplate.send('user.created', 'add', body);
-    return { ok: true };
-  }
-}

package/templates/scaffold-default/packages/api/src/controller/upload.controller.ts

@@ -1,83 +0,0 @@
-import 'reflect-metadata';
-import { RestController, PostMapping, DeleteMapping, GetMapping, RequestParam, RequestPart, MultipartFile } from '@ai-partner-x/aiko-boot-starter-web';
-import { Autowired } from '@ai-partner-x/aiko-boot';
-import { StorageService, type UploadResult } from '@ai-partner-x/aiko-boot-starter-storage';
-
-/**
- * 文件上传控制器
- *
- * 提供文件上传、删除、获取 URL 等接口
- */
-@RestController({ path: '/upload' })
-export class UploadController {
-  @Autowired(StorageService)
-  private storageService!: StorageService;
-
-  /**
-   * 上传单个文件
-   *
-   * @example
-   * curl -X POST http://localhost:3001/api/upload \
-   *   -F "file=@/path/to/image.png" \
-   *   -F "folder=images"
-   */
-  @PostMapping('/')
-  async upload(
-    @RequestPart('file') file: MultipartFile | undefined,
-    @RequestPart('folder') folder?: string,
-  ): Promise<UploadResult> {
-    if (!file || file.isEmpty()) {
-      throw new Error('上传的文件为空或未提供');
-    }
-    return this.storageService.upload(file.getBytes(), file.getOriginalFilename(), {
-      folder: folder || 'uploads',
-      maxSize: 10 * 1024 * 1024, // 10MB
-      allowedTypes: ['image/jpeg', 'image/png', 'image/gif', 'image/webp'],
-    });
-  }
-
-  /**
-   * 删除文件
-   *
-   * @example
-   * curl -X DELETE "http://localhost:3001/api/upload?key=images/xxx.png"
-   */
-  @DeleteMapping('/')
-  async delete(@RequestParam('key') key: string): Promise<{ success: boolean }> {
-    await this.storageService.delete(key);
-    return { success: true };
-  }
-
-  /**
-   * 获取文件 URL
-   *
-   * @example
-   * curl "http://localhost:3001/api/upload/url?key=images/xxx.png"
-   */
-  @GetMapping('/url')
-  async getUrl(@RequestParam('key') key: string): Promise<{ url: string }> {
-    const url = await this.storageService.getUrl(key);
-    return { url };
-  }
-
-  /**
-   * 获取图片预览 URL（支持 OSS/COS 的图片处理参数）
-   *
-   * @example
-   * curl "http://localhost:3001/api/upload/preview?key=images/xxx.png&width=200&height=200"
-   */
-  @GetMapping('/preview')
-  async getPreviewUrl(
-    @RequestParam('key') key: string,
-    @RequestParam('width') width?: string,
-    @RequestParam('height') height?: string,
-    @RequestParam('quality') quality?: string,
-  ): Promise<{ url: string }> {
-    const url = await this.storageService.getPreviewUrl(key, {
-      width: width ? parseInt(width, 10) : undefined,
-      height: height ? parseInt(height, 10) : undefined,
-      quality: quality ? parseInt(quality, 10) : undefined,
-    });
-    return { url };
-  }
-}

package/templates/scaffold-default/packages/api/src/dto/cache.dto.ts

@@ -1,24 +0,0 @@
-/**
- * Cache 操作 DTO
- */
-export interface CacheGetDto {
-  name: string;
-  key: string;
-}
-
-export interface CachePutDto {
-  name: string;
-  key: string;
-  value: unknown;
-  ttlSeconds?: number;
-}
-
-export interface CacheEvictDto {
-  name: string;
-  key?: string;
-  allEntries?: boolean;
-}
-
-export interface CacheClearDto {
-  name: string;
-}

package/templates/scaffold-default/packages/api/src/dto/mq.dto.ts

@@ -1,16 +0,0 @@
-/**
- * MQ 消息 DTO（复用 User 实体字段，不包含敏感信息）
- */
-export interface UserEventDto {
-  id: number;
-  username: string;
-  email: string;
-  createdAt?: string;
-  updatedAt?: string;
-}
-
-export interface SendUserEventDto {
-  topic: string;
-  tag?: string;
-  body: UserEventDto;
-}

package/templates/scaffold-default/packages/api/src/service/cache.service.ts

@@ -1,80 +0,0 @@
-import 'reflect-metadata';
-import { Service } from '@ai-partner-x/aiko-boot';
-import type { CacheManager } from '@ai-partner-x/aiko-boot-starter-cache';
-import { getCacheManager, isCacheManagerInitialized } from '@ai-partner-x/aiko-boot-starter-cache';
-import type { CacheGetDto, CachePutDto, CacheEvictDto, CacheClearDto } from '../dto/cache.dto.js';
-
-@Service()
-export class CacheService {
-  private getCacheManagerInstance(): CacheManager {
-    if (!isCacheManagerInitialized()) {
-      throw new Error('Cache is not initialized. Enable cache in app.config.ts and ensure Redis is running.');
-    }
-    return getCacheManager();
-  }
-
-  /**
-   * 获取缓存值
-   * @param name 缓存命名空间
-   * @param key 缓存键
-   * @returns 缓存值（JSON 字符串），未命中返回 null
-   */
-  async get(dto: CacheGetDto): Promise<string | null> {
-    const cache = this.getCacheManagerInstance().getCache(dto.name);
-    const value = await cache.get(dto.key);
-    return value;
-  }
-
-  /**
-   * 设置缓存值
-   * @param name 缓存命名空间
-   * @param key 缓存键
-   * @param value 缓存值（任意类型，会自动序列化为 JSON 字符串存储）
-   * @param ttlSeconds 可选过期时间（秒）
-   */
-  async put(dto: CachePutDto): Promise<void> {
-    if (dto.value === undefined) {
-      throw new Error('Cache value is required and must be JSON-serializable.');
-    }
-
-    let value: string;
-    try {
-      value = JSON.stringify(dto.value);
-    } catch (err) {
-      throw new Error('Cache value is not JSON-serializable.');
-    }
-    const cache = this.getCacheManagerInstance().getCache(dto.name);
-    await cache.put(dto.key, value, dto.ttlSeconds);
-  }
-
-  /**
-   * 删除缓存条目
-   * @param name 缓存命名空间
-   * @param key 缓存键
-   * @param allEntries 是否清除所有条目
-   */
-  async evict(dto: CacheEvictDto): Promise<void> {
-    const cache = this.getCacheManagerInstance().getCache(dto.name);
-    if (dto.allEntries) {
-      await cache.clear();
-    } else {
-      await cache.evict(dto.key);
-    }
-  }
-
-  /**
-   * 清空缓存命名空间
-   * @param name 缓存命名空间
-   */
-  async clear(dto: CacheClearDto): Promise<void> {
-    const cache = this.getCacheManagerInstance().getCache(dto.name);
-    await cache.clear();
-  }
-
-  /**
-   * 检查缓存是否已初始化
-   */
-  isInitialized(): boolean {
-    return isCacheManagerInitialized();
-  }
-}

package/templates/scaffold-default/packages/api/src/service/log.request.service.ts

@@ -1,158 +0,0 @@
-import { Request, Response, NextFunction } from 'express';
-import { getLogger } from '@ai-partner-x/aiko-boot-starter-log';
-
-const logger = getLogger('http');
-
-/**
- * HTTP请求日志服务
- * 提供HTTP请求日志记录功能
- */
-export class RequestLogService {
-  /**
-   * 完整的HTTP请求日志中间件
-   * 记录所有HTTP请求的详细信息
-   */
-  static requestLogMiddleware(req: Request, res: Response, next: NextFunction) {
-    const startTime = Date.now();
-    
-    // 获取请求信息
-    const requestInfo = {
-      method: req.method,
-      url: req.url,
-      path: req.path,
-      query: req.query,
-      ip: req.ip || req.connection.remoteAddress,
-      userAgent: req.get('user-agent') || 'unknown',
-      contentType: req.get('content-type'),
-      contentLength: req.get('content-length'),
-      referer: req.get('referer'),
-    };
-    
-    // 记录请求开始
-    logger.http('Request started', requestInfo);
-    
-    // 监听响应完成事件
-    res.on('finish', () => {
-      const duration = Date.now() - startTime;
-      
-      const responseInfo = {
-        ...requestInfo,
-        status: res.statusCode,
-        statusMessage: res.statusMessage,
-        duration: `${duration}ms`,
-        responseTime: duration,
-        timestamp: new Date().toISOString(),
-      };
-      
-      // 根据状态码选择日志级别
-      if (res.statusCode >= 500) {
-        logger.error('Request completed with server error', responseInfo);
-      } else if (res.statusCode >= 400) {
-        logger.warn('Request completed with client error', responseInfo);
-      } else {
-        logger.http('Request completed successfully', responseInfo);
-      }
-    });
-    
-    // 监听响应关闭事件（客户端提前断开连接）
-    res.on('close', () => {
-      if (!res.writableFinished) {
-        const duration = Date.now() - startTime;
-        logger.warn('Request closed by client before completion', {
-          ...requestInfo,
-          duration: `${duration}ms`,
-          timestamp: new Date().toISOString(),
-        });
-      }
-    });
-    
-    next();
-  }
-
-  /**
-   * 简化的请求日志中间件（仅记录基本信息）
-   */
-  static simpleRequestLogMiddleware(req: Request, res: Response, next: NextFunction) {
-    const startTime = Date.now();
-    
-    res.on('finish', () => {
-      const duration = Date.now() - startTime;
-      
-      logger.info(`${req.method} ${req.url} ${res.statusCode} ${duration}ms`, {
-        method: req.method,
-        url: req.url,
-        status: res.statusCode,
-        duration: `${duration}ms`,
-        ip: req.ip,
-      });
-    });
-    
-    next();
-  }
-
-  /**
-   * 错误请求日志中间件（专门记录错误请求）
-   */
-  static errorRequestLogMiddleware(req: Request, res: Response, next: NextFunction) {
-    const startTime = Date.now();
-    
-    res.on('finish', () => {
-      if (res.statusCode >= 400) {
-        const duration = Date.now() - startTime;
-        
-        logger.warn('Error request detected', {
-          method: req.method,
-          url: req.url,
-          status: res.statusCode,
-          duration: `${duration}ms`,
-          ip: req.ip,
-          userAgent: req.get('user-agent'),
-          timestamp: new Date().toISOString(),
-        });
-      }
-    });
-    
-    next();
-  }
-
-  /**
-   * 记录HTTP请求信息（直接调用，非中间件）
-   */
-  static logRequest(req: Request, res: Response, duration: number) {
-    const requestInfo = {
-      method: req.method,
-      url: req.url,
-      path: req.path,
-      query: req.query,
-      ip: req.ip || req.connection.remoteAddress,
-      userAgent: req.get('user-agent') || 'unknown',
-      status: res.statusCode,
-      statusMessage: res.statusMessage,
-      duration: `${duration}ms`,
-      responseTime: duration,
-      timestamp: new Date().toISOString(),
-    };
-
-    if (res.statusCode >= 500) {
-      logger.error('Request completed with server error', requestInfo);
-    } else if (res.statusCode >= 400) {
-      logger.warn('Request completed with client error', requestInfo);
-    } else {
-      logger.http('Request completed successfully', requestInfo);
-    }
-  }
-
-  /**
-   * 记录客户端提前断开连接
-   */
-  static logClientDisconnect(req: Request, duration: number) {
-    logger.warn('Request closed by client before completion', {
-      method: req.method,
-      url: req.url,
-      path: req.path,
-      ip: req.ip || req.connection.remoteAddress,
-      duration: `${duration}ms`,
-      timestamp: new Date().toISOString(),
-    });
-  }
-}

package/templates/scaffold-default/packages/api/src/service/log.service.ts

@@ -1,123 +0,0 @@
-import { getLogger, defaultLogger, ILogger } from '@ai-partner-x/aiko-boot-starter-log';
-
-/**
- * 日志服务适配器
- * 提供统一的日志接口，封装 aiko-boot-starter-log 的功能
- */
-export class LogService {
-  private static instance: LogService;
-  private logger: ILogger;
-  
-  private constructor() {
-    // 使用命名logger，便于区分不同模块
-    this.logger = getLogger('scaffold-api');
-  }
-  
-  /**
-   * 获取日志服务单例
-   */
-  static getInstance(): LogService {
-    if (!LogService.instance) {
-      LogService.instance = new LogService();
-    }
-    return LogService.instance;
-  }
-  
-  /**
-   * 记录错误日志
-   * @param message 错误消息
-   * @param error 错误对象（可选）
-   * @param meta 附加元数据（可选）
-   */
-  error(message: string, error?: Error, meta?: Record<string, any>) {
-    this.logger.error(message, error, meta);
-  }
-  
-  /**
-   * 记录警告日志
-   * @param message 警告消息
-   * @param meta 附加元数据（可选）
-   */
-  warn(message: string, meta?: Record<string, any>) {
-    this.logger.warn(message, meta);
-  }
-  
-  /**
-   * 记录信息日志
-   * @param message 信息消息
-   * @param meta 附加元数据（可选）
-   */
-  info(message: string, meta?: Record<string, any>) {
-    this.logger.info(message, meta);
-  }
-  
-  /**
-   * 记录调试日志
-   * @param message 调试消息
-   * @param meta 附加元数据（可选）
-   */
-  debug(message: string, meta?: Record<string, any>) {
-    this.logger.debug(message, meta);
-  }
-  
-  /**
-   * 记录HTTP请求日志
-   * @param message HTTP消息
-   * @param meta 附加元数据（可选）
-   */
-  http(message: string, meta?: Record<string, any>) {
-    this.logger.http(message, meta);
-  }
-  
-  /**
-   * 记录详细日志
-   * @param message 详细消息
-   * @param meta 附加元数据（可选）
-   */
-  verbose(message: string, meta?: Record<string, any>) {
-    this.logger.verbose(message, meta);
-  }
-  
-  /**
-   * 记录最详细日志
-   * @param message 最详细消息
-   * @param meta 附加元数据（可选）
-   */
-  silly(message: string, meta?: Record<string, any>) {
-    this.logger.silly(message, meta);
-  }
-  
-  /**
-   * 检查是否启用指定级别的日志
-   * @param level 日志级别
-   */
-  isLevelEnabled(level: string): boolean {
-    return this.logger.isLevelEnabled(level);
-  }
-  
-  /**
-   * 获取原始logger实例
-   */
-  getLogger(): ILogger {
-    return this.logger;
-  }
-  
-  /**
-   * 创建子logger（用于模块划分）
-   * @param name 子logger名称
-   */
-  createChildLogger(name: string): ILogger {
-    return this.logger.child(name);
-  }
-  
-  /**
-   * 添加上下文信息
-   * @param context 上下文对象
-   */
-  withContext(context: Record<string, any>): ILogger {
-    return this.logger.withContext(context);
-  }
-}
-
-// 导出单例实例
-export const logService = LogService.getInstance();

package/templates/scaffold-default/packages/api/src/service/mq.consumer.service.ts

@@ -1,26 +0,0 @@
-import 'reflect-metadata';
-import { Service } from '@ai-partner-x/aiko-boot';
-import { MqListener, type MqListenerMeta } from '@ai-partner-x/aiko-boot-starter-mq';
-import type { UserEventDto } from '../dto/mq.dto.js';
-
-/**
- * MQ 消费者服务 - 订阅 user 相关消息
- * 复用 User 实体字段结构（id, username, email, createdAt, updatedAt）
- */
-@Service()
-export class MqConsumerService {
-  static readonly MQ_LISTENERS: MqListenerMeta[] = [
-    { topic: 'user.created', tag: 'add', group: 'scaffold-user-group', method: 'onUserCreated' },
-    { topic: 'user.updated', tag: 'update', group: 'scaffold-user-group', method: 'onUserUpdated' },
-  ];
-
-  @MqListener({ topic: 'user.created', tag: 'add', group: 'scaffold-user-group' })
-  async onUserCreated(event: UserEventDto): Promise<void> {
-    console.log('[MqConsumer] user.created:', JSON.stringify(event));
-  }
-
-  @MqListener({ topic: 'user.updated', tag: 'update', group: 'scaffold-user-group' })
-  async onUserUpdated(event: UserEventDto): Promise<void> {
-    console.log('[MqConsumer] user.updated:', JSON.stringify(event));
-  }
-}

package/templates/scaffold-default/pnpm-workspace.yaml

@@ -1,2 +0,0 @@
-packages:
-  - 'packages/*'

package/templates/scaffold-default/scripts/postinstall.cjs

@@ -1,42 +0,0 @@
-#!/usr/bin/env node
-
-const { spawnSync } = require('node:child_process');
-
-function shouldSkip() {
-  if (process.env.SKIP_SQLITE_REBUILD === 'true') {
-    console.log('[postinstall] SKIP_SQLITE_REBUILD=true, skipping better-sqlite3 rebuild.');
-    return true;
-  }
-  if (process.env.CI === 'true') {
-    console.log('[postinstall] CI environment detected, skipping better-sqlite3 rebuild.');
-    return true;
-  }
-  return false;
-}
-
-function main() {
-  if (shouldSkip()) {
-    return;
-  }
-
-  const pkgManager = process.env.npm_execpath || 'pnpm';
-  console.log('[postinstall] Rebuilding better-sqlite3 via', pkgManager);
-
-  const result = spawnSync(
-    pkgManager,
-    ['rebuild', 'better-sqlite3'],
-    { stdio: 'inherit', shell: false }
-  );
-
-  if (result.error) {
-    console.warn('[postinstall] better-sqlite3 rebuild errored but is non-fatal:', result.error);
-    return;
-  }
-
-  if (result.status !== 0) {
-    console.warn('[postinstall] better-sqlite3 rebuild exited with code', result.status, '(treated as non-fatal).');
-  }
-}
-
-main();
-

package/templates/scaffold-default/scripts/rebuild-sqlite.cjs

@@ -1,23 +0,0 @@
-#!/usr/bin/env node
-
-const { spawnSync } = require('node:child_process');
-
-function main() {
-  const pkgManager = process.env.npm_execpath || 'pnpm';
-
-  const result = spawnSync(
-    pkgManager,
-    ['rebuild', 'better-sqlite3'],
-    { stdio: 'inherit', shell: false }
-  );
-
-  if (result.error) {
-    console.error('[rebuild-sqlite] Failed to start rebuild:', result.error);
-    process.exit(1);
-  }
-
-  process.exit(result.status ?? 0);
-}
-
-main();
-