@svton/cli 1.2.2 → 1.2.3

package/templates/examples/storage/README.md

@@ -1,224 +0,0 @@
-# 对象存储示例
-
-本示例展示如何使用 `@svton/nestjs-object-storage` 模块实现文件上传。
-
-## 文件说明
-
-- `upload.service.ts` - 上传服务，封装存储操作
-- `upload.controller.ts` - 上传控制器，提供上传接口
-
-## 核心功能
-
-### 服务端上传
-
-```typescript
-const result = await this.uploadService.uploadFile(file);
-```
-
-### 客户端直传
-
-```typescript
-// 1. 获取上传凭证
-const token = await this.uploadService.getUploadToken();
-
-// 2. 客户端使用凭证直接上传到七牛云
-```
-
-### 删除文件
-
-```typescript
-await this.uploadService.deleteFile(key);
-```
-
-### 获取私有文件 URL
-
-```typescript
-const url = await this.uploadService.getPrivateUrl(key, 3600);
-```
-
-## 测试接口
-
-### 获取上传凭证
-
-```bash
-curl http://localhost:3000/examples/upload/token
-```
-
-### 服务端上传文件
-
-```bash
-curl -X POST http://localhost:3000/examples/upload/file \
-  -F "file=@/path/to/file.jpg"
-```
-
-### 上传图片
-
-```bash
-curl -X POST http://localhost:3000/examples/upload/image \
-  -F "file=@/path/to/image.jpg"
-```
-
-### 删除文件
-
-```bash
-curl -X DELETE http://localhost:3000/examples/upload/uploads/1234567890-abc.jpg
-```
-
-### 获取文件信息
-
-```bash
-curl http://localhost:3000/examples/upload/info/uploads/1234567890-abc.jpg
-```
-
-### 获取私有文件 URL
-
-```bash
-curl "http://localhost:3000/examples/upload/private-url?key=uploads/1234567890-abc.jpg&expires=3600"
-```
-
-## 环境变量配置
-
-在 `.env` 文件中配置：
-
-```env
-STORAGE_PROVIDER=qiniu
-QINIU_ACCESS_KEY=your_access_key
-QINIU_SECRET_KEY=your_secret_key
-QINIU_BUCKET=your_bucket_name
-QINIU_DOMAIN=https://cdn.example.com
-```
-
-## 客户端直传示例
-
-### Web 端（使用 qiniu-js）
-
-```javascript
-// 1. 获取上传凭证
-const { token, uploadUrl, domain } = await fetch('/examples/upload/token').then(r => r.json());
-
-// 2. 使用 qiniu-js 上传
-import * as qiniu from 'qiniu-js';
-
-const observable = qiniu.upload(file, key, token, {}, {
-  useCdnDomain: true,
-});
-
-observable.subscribe({
-  next: (result) => {
-    console.log('Progress:', result.total.percent);
-  },
-  error: (err) => {
-    console.error('Upload failed:', err);
-  },
-  complete: (result) => {
-    console.log('Upload complete:', result);
-    const fileUrl = `${domain}/${result.key}`;
-  },
-});
-```
-
-### 小程序端
-
-```javascript
-// 1. 获取上传凭证
-const { token, uploadUrl } = await wx.request({
-  url: 'https://api.example.com/examples/upload/token',
-});
-
-// 2. 使用 wx.uploadFile 上传
-wx.chooseImage({
-  success: (res) => {
-    wx.uploadFile({
-      url: uploadUrl,
-      filePath: res.tempFilePaths[0],
-      name: 'file',
-      formData: {
-        token: token,
-        key: `uploads/${Date.now()}.jpg`,
-      },
-      success: (uploadRes) => {
-        console.log('Upload success:', uploadRes);
-      },
-    });
-  },
-});
-```
-
-## 图片处理
-
-七牛云支持强大的图片处理功能：
-
-### 缩略图
-
-```
-https://cdn.example.com/image.jpg?imageView2/1/w/200/h/200
-```
-
-### 裁剪
-
-```
-https://cdn.example.com/image.jpg?imageMogr2/crop/!300x300a0a0
-```
-
-### 水印
-
-```
-https://cdn.example.com/image.jpg?watermark/2/text/SGVsbG8gV29ybGQ=
-```
-
-### 格式转换
-
-```
-https://cdn.example.com/image.jpg?imageMogr2/format/webp
-```
-
-## 最佳实践
-
-1. **文件命名**：使用时间戳 + 随机字符串，避免重名
-2. **目录结构**：按类型或日期分目录存储
-3. **客户端直传**：大文件使用客户端直传，减轻服务器压力
-4. **CDN 加速**：配置 CDN 域名，加速文件访问
-5. **安全性**：私有文件使用签名 URL，设置合理的过期时间
-6. **文件验证**：上传前验证文件类型和大小
-7. **错误处理**：妥善处理上传失败、网络异常等情况
-
-## 常见场景
-
-### 用户头像上传
-
-```typescript
-// 1. 上传图片
-const result = await this.uploadService.uploadImage(file);
-
-// 2. 更新用户头像
-await this.userService.updateAvatar(userId, result.url);
-
-// 3. 删除旧头像
-if (oldAvatarKey) {
-  await this.uploadService.deleteFile(oldAvatarKey);
-}
-```
-
-### 文章图片上传
-
-```typescript
-// 富文本编辑器上传图片
-const result = await this.uploadService.uploadImage(file);
-
-// 返回图片 URL 给编辑器
-return { url: result.url };
-```
-
-### 文件下载
-
-```typescript
-// 生成临时下载链接
-const url = await this.uploadService.getPrivateUrl(key, 3600);
-
-// 重定向到下载链接
-return { url };
-```
-
-## 更多信息
-
-查看官方文档：https://751848178.github.io/svton/packages/nestjs-object-storage

package/templates/examples/storage/upload.controller.ts

@@ -1,117 +0,0 @@
-import {
-  Controller,
-  Post,
-  Get,
-  Delete,
-  UseInterceptors,
-  UploadedFile,
-  Body,
-  Query,
-  Param,
-} from '@nestjs/common';
-import { FileInterceptor } from '@nestjs/platform-express';
-import { UploadService } from './upload.service';
-
-@Controller('examples/upload')
-export class UploadController {
-  constructor(private readonly uploadService: UploadService) {}
-
-  /**
-   * 获取上传凭证（客户端直传）
-   */
-  @Get('token')
-  async getUploadToken(@Query('key') key?: string) {
-    const token = await this.uploadService.getUploadToken(key);
-
-    return {
-      token,
-      uploadUrl: 'https://upload.qiniup.com', // 七牛云上传地址
-      domain: process.env.QINIU_DOMAIN,
-    };
-  }
-
-  /**
-   * 服务端上传文件
-   */
-  @Post('file')
-  @UseInterceptors(FileInterceptor('file'))
-  async uploadFile(@UploadedFile() file: Express.Multer.File) {
-    const result = await this.uploadService.uploadFile(file);
-
-    return {
-      message: 'File uploaded successfully',
-      ...result,
-    };
-  }
-
-  /**
-   * 上传图片（带压缩）
-   */
-  @Post('image')
-  @UseInterceptors(FileInterceptor('file'))
-  async uploadImage(@UploadedFile() file: Express.Multer.File) {
-    const result = await this.uploadService.uploadImage(file);
-
-    return {
-      message: 'Image uploaded successfully',
-      ...result,
-    };
-  }
-
-  /**
-   * 批量上传
-   */
-  @Post('batch')
-  @UseInterceptors(FileInterceptor('files'))
-  async uploadBatch(@UploadedFile() files: Express.Multer.File[]) {
-    const results = await this.uploadService.uploadBatch(files);
-
-    return {
-      message: 'Files uploaded successfully',
-      files: results,
-    };
-  }
-
-  /**
-   * 删除文件
-   */
-  @Delete(':key')
-  async deleteFile(@Param('key') key: string) {
-    await this.uploadService.deleteFile(key);
-
-    return {
-      message: 'File deleted successfully',
-    };
-  }
-
-  /**
-   * 获取文件信息
-   */
-  @Get('info/:key')
-  async getFileInfo(@Param('key') key: string) {
-    const info = await this.uploadService.getFileInfo(key);
-
-    return {
-      ...info,
-    };
-  }
-
-  /**
-   * 获取私有文件访问 URL
-   */
-  @Get('private-url')
-  async getPrivateUrl(
-    @Query('key') key: string,
-    @Query('expires') expires?: string,
-  ) {
-    const url = await this.uploadService.getPrivateUrl(
-      key,
-      expires ? parseInt(expires) : 3600,
-    );
-
-    return {
-      url,
-      expiresIn: expires || 3600,
-    };
-  }
-}

package/templates/examples/storage/upload.service.ts

@@ -1,123 +0,0 @@
-import { Injectable } from '@nestjs/common';
-import { ObjectStorageService } from '@svton/nestjs-object-storage';
-import * as path from 'path';
-import * as crypto from 'crypto';
-
-@Injectable()
-export class UploadService {
-  constructor(private readonly storageService: ObjectStorageService) {}
-
-  /**
-   * 获取上传凭证（用于客户端直传）
-   */
-  async getUploadToken(key?: string): Promise<string> {
-    return this.storageService.getUploadToken(key);
-  }
-
-  /**
-   * 上传文件
-   */
-  async uploadFile(file: Express.Multer.File) {
-    // 生成唯一文件名
-    const ext = path.extname(file.originalname);
-    const filename = `${Date.now()}-${crypto.randomBytes(8).toString('hex')}${ext}`;
-    const key = `uploads/${filename}`;
-
-    // 上传文件
-    const result = await this.storageService.upload(file.buffer, key);
-
-    return {
-      key,
-      url: result.url,
-      size: file.size,
-      mimeType: file.mimetype,
-    };
-  }
-
-  /**
-   * 上传图片（带压缩）
-   */
-  async uploadImage(file: Express.Multer.File) {
-    // 验证是否为图片
-    if (!file.mimetype.startsWith('image/')) {
-      throw new Error('File must be an image');
-    }
-
-    const ext = path.extname(file.originalname);
-    const filename = `${Date.now()}-${crypto.randomBytes(8).toString('hex')}${ext}`;
-    const key = `images/${filename}`;
-
-    // 上传原图
-    const result = await this.storageService.upload(file.buffer, key);
-
-    // 生成缩略图 URL（七牛云图片处理）
-    const thumbnailUrl = `${result.url}?imageView2/1/w/200/h/200`;
-
-    return {
-      key,
-      url: result.url,
-      thumbnailUrl,
-      size: file.size,
-      mimeType: file.mimetype,
-    };
-  }
-
-  /**
-   * 批量上传
-   */
-  async uploadBatch(files: Express.Multer.File[]) {
-    const results = await Promise.all(
-      files.map((file) => this.uploadFile(file)),
-    );
-
-    return results;
-  }
-
-  /**
-   * 删除文件
-   */
-  async deleteFile(key: string): Promise<void> {
-    await this.storageService.delete(key);
-  }
-
-  /**
-   * 获取文件信息
-   */
-  async getFileInfo(key: string) {
-    const info = await this.storageService.getFileInfo(key);
-
-    // 兼容不同存储提供商的返回格式
-    return {
-      key,
-      size: info.fsize || info.size || 0,
-      mimeType: info.mimeType || info.type || 'application/octet-stream',
-      hash: info.hash || info.etag || '',
-      putTime: info.putTime 
-        ? new Date(info.putTime / 10000)  // 七牛云格式
-        : info.lastModified 
-        ? new Date(info.lastModified)  // 其他格式
-        : new Date(),
-    };
-  }
-
-  /**
-   * 获取私有文件访问 URL
-   */
-  async getPrivateUrl(key: string, expires: number = 3600): Promise<string> {
-    return this.storageService.getPrivateUrl(key, expires);
-  }
-
-  /**
-   * 移动文件
-   */
-  async moveFile(sourceKey: string, destKey: string): Promise<void> {
-    await this.storageService.move(sourceKey, destKey);
-  }
-
-  /**
-   * 复制文件
-   */
-  async copyFile(sourceKey: string, destKey: string): Promise<void> {
-    await this.storageService.copy(sourceKey, destKey);
-  }
-}

package/templates/packages/types/package.json.tpl

@@ -1,16 +0,0 @@
-{
-  "name": "{{ORG_NAME}}/types",
-  "version": "1.0.0",
-  "description": "{{PROJECT_NAME}} 共享类型定义",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "clean": "rm -rf dist",
-    "type-check": "tsc --noEmit"
-  },
-  "devDependencies": {
-    "typescript": "^5.3.0"
-  }
-}

package/templates/packages/types/src/api.ts

@@ -1,88 +0,0 @@
-// ============================================================
-// API 请求/响应类型定义
-// ============================================================
-
-import type { UserVo, UserRole, PaginationParams, ContentStatus } from './common';
-
-// ============================================================
-// 认证相关
-// ============================================================
-
-// 登录请求
-export interface LoginDto {
-  phone: string;
-  password: string;
-}
-
-// 登录响应
-export interface LoginVo {
-  accessToken: string;
-  refreshToken: string;
-  user: UserVo;
-}
-
-// 注册请求
-export interface RegisterDto {
-  phone: string;
-  password: string;
-  nickname: string;
-  code?: string; // 验证码
-}
-
-// 刷新 Token
-export interface RefreshTokenDto {
-  refreshToken: string;
-}
-
-// ============================================================
-// 用户管理
-// ============================================================
-
-// 用户列表查询
-export interface UserListParams extends PaginationParams {
-  keyword?: string;
-  role?: UserRole;
-  status?: number;
-}
-
-// 创建用户
-export interface CreateUserDto {
-  phone: string;
-  password: string;
-  nickname: string;
-  role?: UserRole;
-}
-
-// 更新用户
-export interface UpdateUserDto {
-  nickname?: string;
-  avatar?: string;
-  role?: UserRole;
-  status?: number;
-}
-
-// ============================================================
-// 内容管理
-// ============================================================
-
-// 内容列表查询
-export interface ContentListParams extends PaginationParams {
-  keyword?: string;
-  status?: ContentStatus;
-  authorId?: number;
-}
-
-// 创建内容
-export interface CreateContentDto {
-  title: string;
-  content: string;
-  images?: string[];
-}
-
-// 更新内容
-export interface UpdateContentDto {
-  title?: string;
-  content?: string;
-  images?: string[];
-  status?: ContentStatus;
-}

package/templates/packages/types/src/common.ts

@@ -1,89 +0,0 @@
-// ============================================================
-// 通用类型定义
-// ============================================================
-
-// 分页请求参数
-export interface PaginationParams {
-  page?: number;
-  pageSize?: number;
-}
-
-// 分页响应
-export interface PaginatedResponse<T> {
-  list: T[];
-  total: number;
-  page: number;
-  pageSize: number;
-  totalPages: number;
-}
-
-// 通用 API 响应
-export interface ApiResponse<T = unknown> {
-  code: number;
-  message: string;
-  data: T;
-}
-
-// ============================================================
-// 用户相关类型
-// ============================================================
-
-// 用户角色
-export type UserRole = 'user' | 'admin' | 'super_admin';
-
-// 用户状态
-export type UserStatus = 0 | 1; // 0: 禁用, 1: 启用
-
-// 用户基础信息
-export interface UserVo {
-  id: number;
-  phone: string;
-  nickname: string;
-  avatar?: string;
-  role: UserRole;
-  status: UserStatus;
-  createdAt: string;
-  updatedAt: string;
-}
-
-// 用户详情（包含更多字段）
-export interface UserDetailVo extends UserVo {
-  email?: string;
-  bio?: string;
-  lastLoginAt?: string;
-}
-
-// ============================================================
-// 内容相关类型
-// ============================================================
-
-// 内容状态
-export type ContentStatus = 'draft' | 'pending' | 'published' | 'rejected';
-
-// 内容基础信息
-export interface ContentVo {
-  id: number;
-  title: string;
-  content: string;
-  images: string[];
-  status: ContentStatus;
-  viewCount: number;
-  likeCount: number;
-  commentCount: number;
-  author: UserVo;
-  createdAt: string;
-  updatedAt: string;
-}
-
-// ============================================================
-// 通用工具类型
-// ============================================================
-
-// 可选的 ID
-export type WithOptionalId<T> = Omit<T, 'id'> & { id?: number };
-
-// 创建 DTO（移除系统字段）
-export type CreateDto<T> = Omit<T, 'id' | 'createdAt' | 'updatedAt'>;
-
-// 更新 DTO
-export type UpdateDto<T> = Partial<CreateDto<T>> & { id: number };

package/templates/packages/types/src/index.ts

@@ -1,3 +0,0 @@
-// 通用类型定义
-export * from './common';
-export * from './api';

package/templates/packages/types/tsconfig.json

@@ -1,16 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2020",
-    "module": "commonjs",
-    "declaration": true,
-    "declarationMap": true,
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "outDir": "./dist",
-    "rootDir": "./src"
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist"]
-}