压缩历史至 95081aff

frontend/lib/services/upload/index.ts

@@ -0,0 +1,2 @@
+export { UploadService } from './upload.service';
+export type { UploadImageResponse } from './types';

frontend/lib/services/upload/types.ts

@@ -0,0 +1,7 @@
+/**
+ * 上传图片响应
+ */
+export interface UploadImageResponse {
+  /** 上传记录 ID */
+  id: string;
+}

frontend/lib/services/upload/upload.service.ts

@@ -0,0 +1,88 @@
+import { BaseService } from '../core/base.service';
+import type { UploadImageResponse } from './types';
+import type { InternalAxiosRequestConfig } from 'axios';
+
+/**
+ * 根据上传ID构造文件访问URL
+ * @param id - 上传记录ID
+ * @returns 文件访问URL
+ */
+export function getFileUrl(id: string | number | null | undefined): string | null {
+  if (!id) return null;
+  return `/f/${id}`;
+}
+
+/**
+ * 上传服务
+ * 处理文件上传相关的 API 请求
+ */
+export class UploadService extends BaseService {
+  protected static readonly basePath = '/api/v1/upload';
+
+  /**
+   * 上传红包封面图片
+   * @param file - 图片文件
+   * @param type - 封面类型 (cover: 背景封面, heterotypic: 异形装饰)
+   * @returns 上传后的图片URL
+   * @throws {ValidationError} 当文件格式或大小不符合要求时
+   * @throws {UnauthorizedError} 当未登录时
+   *
+   * @example
+   * ```typescript
+   * const file = e.target.files[0];
+   * const result = await UploadService.uploadRedEnvelopeCover(file, 'cover');
+   * console.log('图片URL:', result.url);
+   * ```
+   */
+  static async uploadRedEnvelopeCover(
+    file: File,
+    type: 'cover' | 'heterotypic'
+  ): Promise<UploadImageResponse> {
+    // 验证文件类型
+    const allowedTypes = ['image/jpeg', 'image/png', 'image/jpg', 'image/webp'];
+    if (!allowedTypes.includes(file.type)) {
+      throw new Error('只支持 JPG、PNG、WEBP 格式的图片');
+    }
+
+    // 验证文件大小 (最大 2MB)
+    const maxSize = 2 * 1024 * 1024;
+    if (file.size > maxSize) {
+      throw new Error('图片大小不能超过 2MB');
+    }
+
+    // 创建 FormData
+    const formData = new FormData();
+    formData.append('file', file);
+    formData.append('type', type);
+
+    return this.post<UploadImageResponse>('/redenvelope/cover', formData, {
+      headers: {
+        'Content-Type': 'multipart/form-data',
+      },
+    } as InternalAxiosRequestConfig);
+  }
+
+  /**
+   * 将 base64 图片转换为 Blob 并上传
+   * @param base64 - base64 编码的图片
+   * @param type - 封面类型
+   * @param filename - 文件名
+   * @returns 上传后的图片URL
+   */
+  static async uploadBase64Image(
+    base64: string,
+    type: 'cover' | 'heterotypic',
+    filename: string = 'image.png'
+  ): Promise<UploadImageResponse> {
+    // 将 base64 转换为 Blob
+    const response = await fetch(base64);
+    const blob = await response.blob();
+
+    // 创建 File 对象，确保正确的 MIME 类型
+    const mimeType = base64.match(/data:([^;]+);/)?.[1] || 'image/png';
+    const file = new File([blob], filename, { type: mimeType });
+
+    // 上传文件
+    return this.uploadRedEnvelopeCover(file, type);
+  }
+}