@seaverse/utils-sdk 0.1.0

package/dist/client.js

@@ -0,0 +1,255 @@
+/**
+ * SeaVerse Utils SDK Client
+ */
+import axios from 'axios';
+import { UtilsAPIError, ErrorCode, } from './models.js';
+import { compressImage, shouldCompress } from './compress.js';
+import { validateFile, isImageFile, handleAxiosError, createUploadError, ProgressTracker, } from './utils.js';
+/**
+ * SeaVerse Utils API Client
+ *
+ * 提供文件上传、图片压缩等功能，支持多租户隔离。
+ * 自动处理预签名 URL 上传流程：
+ * 1. 获取预签名 URL
+ * 2. 直接上传到 GCS
+ *
+ * @example
+ * ```typescript
+ * const client = new UtilsClient({
+ *   token: 'your-bearer-token'
+ * });
+ *
+ * const file = document.querySelector('input[type="file"]').files[0];
+ * const result = await client.uploadFile(file, {
+ *   onProgress: (progress) => {
+ *     console.log(`${progress.percent}% - ${progress.stage}`);
+ *   }
+ * });
+ *
+ * console.log('CDN URL:', result.cdnUrl);
+ * ```
+ */
+export class UtilsClient {
+    constructor(options) {
+        // 初始化 axios 实例
+        this.axios = axios.create({
+            baseURL: options.baseURL || 'https://resource.seaverse.ai',
+            timeout: options.timeout || 60000,
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${options.token}`,
+            },
+        });
+        // 初始化压缩配置
+        this.compressionConfig = {
+            enabled: options.compress?.enabled ?? true,
+            maxWidth: options.compress?.maxWidth ?? 1080,
+            maxHeight: options.compress?.maxHeight ?? 1080,
+            quality: options.compress?.quality ?? 0.8,
+        };
+        // 响应拦截器：统一错误处理
+        this.axios.interceptors.response.use((response) => response, (error) => {
+            throw handleAxiosError(error);
+        });
+    }
+    /**
+     * 上传文件
+     *
+     * 自动处理完整的上传流程：
+     * 1. 文件验证
+     * 2. 图片压缩（如果启用）
+     * 3. 获取预签名 URL
+     * 4. 上传到 GCS
+     *
+     * @param file - 要上传的文件
+     * @param options - 上传选项
+     * @returns 上传结果
+     * @throws {UtilsAPIError} 上传失败时抛出错误
+     *
+     * @example
+     * ```typescript
+     * const result = await client.uploadFile(file, {
+     *   onProgress: (progress) => {
+     *     console.log(`上传进度: ${progress.percent}%`);
+     *   },
+     *   compress: true
+     * });
+     * ```
+     */
+    async uploadFile(file, options) {
+        const startTime = Date.now();
+        const originalSize = file.size;
+        let processedFile = file;
+        let compressed = false;
+        try {
+            // 步骤 1: 准备阶段
+            options?.onProgress?.({
+                loaded: 0,
+                total: file.size,
+                percent: 0,
+                stage: 'preparing',
+            });
+            // 步骤 2: 文件验证
+            const validationResult = validateFile(file);
+            if (!validationResult.valid) {
+                throw createUploadError(ErrorCode.VALIDATION_FAILED, validationResult.errors.join('; '));
+            }
+            // 步骤 3: 图片压缩（如果需要）
+            const shouldCompressFile = options?.compress !== false &&
+                shouldCompress(file, this.compressionConfig);
+            if (shouldCompressFile && isImageFile(file)) {
+                options?.onProgress?.({
+                    loaded: 0,
+                    total: file.size,
+                    percent: 5,
+                    stage: 'compressing',
+                });
+                const compressionResult = await compressImage(file, this.compressionConfig);
+                processedFile = compressionResult.compressedFile;
+                compressed = true;
+            }
+            // 步骤 4: 获取预签名 URL
+            const presignedData = await this.getPresignedUrl(processedFile.type);
+            // 步骤 5: 上传到 GCS
+            options?.onProgress?.({
+                loaded: 0,
+                total: processedFile.size,
+                percent: 10,
+                stage: 'uploading',
+            });
+            await this.uploadToPresignedUrl(presignedData.data.upload_url, processedFile, options?.onProgress);
+            // 步骤 6: 返回结果
+            const duration = Date.now() - startTime;
+            const result = {
+                fileName: file.name,
+                originalFileName: file.name,
+                cdnUrl: presignedData.data.cdn_url,
+                objectPath: presignedData.data.object_path,
+                fileSize: processedFile.size,
+                originalSize,
+                compressed,
+                contentType: processedFile.type,
+                duration,
+                expiresAt: presignedData.data.expires_at,
+            };
+            options?.onProgress?.({
+                loaded: processedFile.size,
+                total: processedFile.size,
+                percent: 100,
+                stage: 'complete',
+            });
+            return result;
+        }
+        catch (error) {
+            if (error instanceof UtilsAPIError) {
+                throw error;
+            }
+            throw createUploadError(ErrorCode.UPLOAD_FAILED, `上传失败: ${error instanceof Error ? error.message : '未知错误'}`);
+        }
+    }
+    /**
+     * 获取预签名 URL
+     *
+     * @param contentType - 文件 MIME 类型
+     * @returns 预签名 URL 响应
+     * @throws {UtilsAPIError} 请求失败时抛出错误
+     */
+    async getPresignedUrl(contentType) {
+        try {
+            const request = {
+                content_type: contentType,
+            };
+            const response = await this.axios.post('/api/v1/resources/presign-upload', request);
+            if (response.data.code !== 0) {
+                throw createUploadError(ErrorCode.PRESIGNED_URL_FAILED, response.data.message || '获取预签名 URL 失败', response.status, response.data);
+            }
+            return response.data;
+        }
+        catch (error) {
+            if (error instanceof UtilsAPIError) {
+                throw error;
+            }
+            throw createUploadError(ErrorCode.PRESIGNED_URL_FAILED, `获取预签名 URL 失败: ${error instanceof Error ? error.message : '未知错误'}`);
+        }
+    }
+    /**
+     * 上传文件到预签名 URL
+     *
+     * 使用 XMLHttpRequest 实现，以支持上传进度回调
+     *
+     * @param uploadUrl - 预签名 URL
+     * @param file - 要上传的文件
+     * @param onProgress - 进度回调函数
+     * @throws {UtilsAPIError} 上传失败时抛出错误
+     */
+    async uploadToPresignedUrl(uploadUrl, file, onProgress) {
+        return new Promise((resolve, reject) => {
+            const xhr = new XMLHttpRequest();
+            const tracker = new ProgressTracker();
+            // 进度事件
+            xhr.upload.addEventListener('progress', (e) => {
+                if (e.lengthComputable && onProgress) {
+                    const { speed, remainingTime } = tracker.calculate(e.loaded, e.total);
+                    onProgress({
+                        loaded: e.loaded,
+                        total: e.total,
+                        percent: Math.round((e.loaded / e.total) * 100),
+                        stage: 'uploading',
+                        speed,
+                        remainingTime,
+                    });
+                }
+            });
+            // 成功
+            xhr.addEventListener('load', () => {
+                if (xhr.status >= 200 && xhr.status < 300) {
+                    resolve();
+                }
+                else {
+                    reject(createUploadError(ErrorCode.UPLOAD_FAILED, `上传失败，HTTP 状态码: ${xhr.status}`, xhr.status));
+                }
+            });
+            // 错误
+            xhr.addEventListener('error', () => {
+                reject(createUploadError(ErrorCode.NETWORK_ERROR, '网络错误，上传失败'));
+            });
+            // 超时
+            xhr.addEventListener('timeout', () => {
+                reject(createUploadError(ErrorCode.TIMEOUT, '上传超时'));
+            });
+            // 发送请求
+            xhr.open('PUT', uploadUrl);
+            xhr.setRequestHeader('Content-Type', file.type);
+            xhr.timeout = this.axios.defaults.timeout;
+            xhr.send(file);
+        });
+    }
+    /**
+     * 更新 Bearer Token
+     *
+     * @param token - 新的 Bearer Token
+     */
+    setToken(token) {
+        this.axios.defaults.headers.common['Authorization'] = `Bearer ${token}`;
+    }
+    /**
+     * 更新基础 URL
+     *
+     * @param baseURL - 新的基础 URL
+     */
+    setBaseURL(baseURL) {
+        this.axios.defaults.baseURL = baseURL;
+    }
+    /**
+     * 更新压缩配置
+     *
+     * @param config - 新的压缩配置
+     */
+    updateCompressionConfig(config) {
+        this.compressionConfig = {
+            ...this.compressionConfig,
+            ...config,
+        };
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAoC,MAAM,OAAO,CAAC;AACzD,OAAO,EAQL,aAAa,EACb,SAAS,GACV,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EACL,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,OAAO,WAAW;IAItB,YAAY,OAA2B;QACrC,eAAe;QACf,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC;YACxB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,8BAA8B;YAC1D,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,KAAK;YACjC,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,UAAU,OAAO,CAAC,KAAK,EAAE;aACzC;SACF,CAAC,CAAC;QAEH,UAAU;QACV,IAAI,CAAC,iBAAiB,GAAG;YACvB,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,IAAI,IAAI;YAC1C,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,QAAQ,IAAI,IAAI;YAC5C,SAAS,EAAE,OAAO,CAAC,QAAQ,EAAE,SAAS,IAAI,IAAI;YAC9C,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,IAAI,GAAG;SAC1C,CAAC;QAEF,eAAe;QACf,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CAClC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,EACtB,CAAC,KAAiB,EAAE,EAAE;YACpB,MAAM,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC,CACF,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,KAAK,CAAC,UAAU,CAAC,IAAU,EAAE,OAAuB;QAClD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC;QAC/B,IAAI,aAAa,GAAG,IAAI,CAAC;QACzB,IAAI,UAAU,GAAG,KAAK,CAAC;QAEvB,IAAI,CAAC;YACH,aAAa;YACb,OAAO,EAAE,UAAU,EAAE,CAAC;gBACpB,MAAM,EAAE,CAAC;gBACT,KAAK,EAAE,IAAI,CAAC,IAAI;gBAChB,OAAO,EAAE,CAAC;gBACV,KAAK,EAAE,WAAW;aACnB,CAAC,CAAC;YAEH,aAAa;YACb,MAAM,gBAAgB,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YAC5C,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;gBAC5B,MAAM,iBAAiB,CACrB,SAAS,CAAC,iBAAiB,EAC3B,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CACnC,CAAC;YACJ,CAAC;YAED,mBAAmB;YACnB,MAAM,kBAAkB,GACtB,OAAO,EAAE,QAAQ,KAAK,KAAK;gBAC3B,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;YAE/C,IAAI,kBAAkB,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5C,OAAO,EAAE,UAAU,EAAE,CAAC;oBACpB,MAAM,EAAE,CAAC;oBACT,KAAK,EAAE,IAAI,CAAC,IAAI;oBAChB,OAAO,EAAE,CAAC;oBACV,KAAK,EAAE,aAAa;iBACrB,CAAC,CAAC;gBAEH,MAAM,iBAAiB,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;gBAC5E,aAAa,GAAG,iBAAiB,CAAC,cAAc,CAAC;gBACjD,UAAU,GAAG,IAAI,CAAC;YACpB,CAAC;YAED,kBAAkB;YAClB,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;YAErE,gBAAgB;YAChB,OAAO,EAAE,UAAU,EAAE,CAAC;gBACpB,MAAM,EAAE,CAAC;gBACT,KAAK,EAAE,aAAa,CAAC,IAAI;gBACzB,OAAO,EAAE,EAAE;gBACX,KAAK,EAAE,WAAW;aACnB,CAAC,CAAC;YAEH,MAAM,IAAI,CAAC,oBAAoB,CAC7B,aAAa,CAAC,IAAI,CAAC,UAAU,EAC7B,aAAa,EACb,OAAO,EAAE,UAAU,CACpB,CAAC;YAEF,aAAa;YACb,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YAExC,MAAM,MAAM,GAAiB;gBAC3B,QAAQ,EAAE,IAAI,CAAC,IAAI;gBACnB,gBAAgB,EAAE,IAAI,CAAC,IAAI;gBAC3B,MAAM,EAAE,aAAa,CAAC,IAAI,CAAC,OAAO;gBAClC,UAAU,EAAE,aAAa,CAAC,IAAI,CAAC,WAAW;gBAC1C,QAAQ,EAAE,aAAa,CAAC,IAAI;gBAC5B,YAAY;gBACZ,UAAU;gBACV,WAAW,EAAE,aAAa,CAAC,IAAI;gBAC/B,QAAQ;gBACR,SAAS,EAAE,aAAa,CAAC,IAAI,CAAC,UAAU;aACzC,CAAC;YAEF,OAAO,EAAE,UAAU,EAAE,CAAC;gBACpB,MAAM,EAAE,aAAa,CAAC,IAAI;gBAC1B,KAAK,EAAE,aAAa,CAAC,IAAI;gBACzB,OAAO,EAAE,GAAG;gBACZ,KAAK,EAAE,UAAU;aAClB,CAAC,CAAC;YAEH,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;gBACnC,MAAM,KAAK,CAAC;YACd,CAAC;YACD,MAAM,iBAAiB,CACrB,SAAS,CAAC,aAAa,EACvB,SAAS,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,CAC3D,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,eAAe,CAAC,WAAmB;QACvC,IAAI,CAAC;YACH,MAAM,OAAO,GAAyB;gBACpC,YAAY,EAAE,WAAW;aAC1B,CAAC;YAEF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CACpC,kCAAkC,EAClC,OAAO,CACR,CAAC;YAEF,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;gBAC7B,MAAM,iBAAiB,CACrB,SAAS,CAAC,oBAAoB,EAC9B,QAAQ,CAAC,IAAI,CAAC,OAAO,IAAI,cAAc,EACvC,QAAQ,CAAC,MAAM,EACf,QAAQ,CAAC,IAAI,CACd,CAAC;YACJ,CAAC;YAED,OAAO,QAAQ,CAAC,IAAI,CAAC;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;gBACnC,MAAM,KAAK,CAAC;YACd,CAAC;YACD,MAAM,iBAAiB,CACrB,SAAS,CAAC,oBAAoB,EAC9B,iBAAiB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,CACnE,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,oBAAoB,CACxB,SAAiB,EACjB,IAAU,EACV,UAA+C;QAE/C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,GAAG,GAAG,IAAI,cAAc,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,IAAI,eAAe,EAAE,CAAC;YAEtC,OAAO;YACP,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE;gBAC5C,IAAI,CAAC,CAAC,gBAAgB,IAAI,UAAU,EAAE,CAAC;oBACrC,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;oBAEtE,UAAU,CAAC;wBACT,MAAM,EAAE,CAAC,CAAC,MAAM;wBAChB,KAAK,EAAE,CAAC,CAAC,KAAK;wBACd,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC;wBAC/C,KAAK,EAAE,WAAW;wBAClB,KAAK;wBACL,aAAa;qBACd,CAAC,CAAC;gBACL,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,KAAK;YACL,GAAG,CAAC,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE;gBAChC,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;oBAC1C,OAAO,EAAE,CAAC;gBACZ,CAAC;qBAAM,CAAC;oBACN,MAAM,CACJ,iBAAiB,CACf,SAAS,CAAC,aAAa,EACvB,kBAAkB,GAAG,CAAC,MAAM,EAAE,EAC9B,GAAG,CAAC,MAAM,CACX,CACF,CAAC;gBACJ,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,KAAK;YACL,GAAG,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;gBACjC,MAAM,CACJ,iBAAiB,CACf,SAAS,CAAC,aAAa,EACvB,WAAW,CACZ,CACF,CAAC;YACJ,CAAC,CAAC,CAAC;YAEH,KAAK;YACL,GAAG,CAAC,gBAAgB,CAAC,SAAS,EAAE,GAAG,EAAE;gBACnC,MAAM,CACJ,iBAAiB,CACf,SAAS,CAAC,OAAO,EACjB,MAAM,CACP,CACF,CAAC;YACJ,CAAC,CAAC,CAAC;YAEH,OAAO;YACP,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;YAC3B,GAAG,CAAC,gBAAgB,CAAC,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAChD,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAiB,CAAC;YACpD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,QAAQ,CAAC,KAAa;QACpB,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,GAAG,UAAU,KAAK,EAAE,CAAC;IAC1E,CAAC;IAED;;;;OAIG;IACH,UAAU,CAAC,OAAe;QACxB,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,GAAG,OAAO,CAAC;IACxC,CAAC;IAED;;;;OAIG;IACH,uBAAuB,CAAC,MAAkC;QACxD,IAAI,CAAC,iBAAiB,GAAG;YACvB,GAAG,IAAI,CAAC,iBAAiB;YACzB,GAAG,MAAM;SACV,CAAC;IACJ,CAAC;CACF"}

package/dist/compress.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Image compression utilities for SeaVerse Utils SDK
+ */
+import { CompressionConfig, CompressionResult } from './models.js';
+/**
+ * 压缩图片文件
+ * @param file - 要压缩的图片文件
+ * @param config - 压缩配置
+ * @returns 压缩结果
+ */
+export declare function compressImage(file: File, config?: CompressionConfig): Promise<CompressionResult>;
+/**
+ * 检查是否需要压缩
+ * @param file - 文件对象
+ * @param config - 压缩配置
+ * @returns 是否需要压缩
+ */
+export declare function shouldCompress(file: File, config?: CompressionConfig): boolean;
+//# sourceMappingURL=compress.d.ts.map

package/dist/compress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compress.d.ts","sourceRoot":"","sources":["../src/compress.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAa,MAAM,aAAa,CAAC;AAG9E;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,IAAI,EACV,MAAM,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,iBAAiB,CAAC,CAwC5B;AA+HD;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,IAAI,EACV,MAAM,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAoBT"}

package/dist/compress.js

@@ -0,0 +1,156 @@
+/**
+ * Image compression utilities for SeaVerse Utils SDK
+ */
+import { ErrorCode } from './models.js';
+import { createUploadError, isImageFile } from './utils.js';
+/**
+ * 压缩图片文件
+ * @param file - 要压缩的图片文件
+ * @param config - 压缩配置
+ * @returns 压缩结果
+ */
+export async function compressImage(file, config) {
+    // 验证是否为图片
+    if (!isImageFile(file)) {
+        throw createUploadError(ErrorCode.COMPRESSION_FAILED, `无法压缩非图片文件: ${file.type}`);
+    }
+    // 默认配置
+    const defaultConfig = {
+        enabled: true,
+        maxWidth: 1080,
+        maxHeight: 1080,
+        quality: 0.8,
+    };
+    const finalConfig = { ...defaultConfig, ...config };
+    // 如果禁用压缩，直接返回原文件
+    if (!finalConfig.enabled) {
+        return {
+            originalFile: file,
+            compressedFile: file,
+            originalSize: file.size,
+            compressedSize: file.size,
+            compressionRatio: 1,
+            width: 0,
+            height: 0,
+        };
+    }
+    try {
+        return await performCompression(file, finalConfig);
+    }
+    catch (error) {
+        throw createUploadError(ErrorCode.COMPRESSION_FAILED, `图片压缩失败: ${error instanceof Error ? error.message : '未知错误'}`);
+    }
+}
+/**
+ * 执行图片压缩
+ * @param file - 原始文件
+ * @param config - 压缩配置
+ * @returns 压缩结果
+ */
+async function performCompression(file, config) {
+    return new Promise((resolve, reject) => {
+        const reader = new FileReader();
+        reader.onload = (e) => {
+            const img = new Image();
+            img.onload = () => {
+                try {
+                    // 检查浏览器是否支持 Canvas
+                    if (typeof document === 'undefined' || !document.createElement) {
+                        reject(new Error('当前环境不支持图片压缩功能（需要浏览器环境）'));
+                        return;
+                    }
+                    const { width, height } = calculateDimensions(img.width, img.height, config.maxWidth, config.maxHeight);
+                    // 创建 Canvas
+                    const canvas = document.createElement('canvas');
+                    const ctx = canvas.getContext('2d');
+                    if (!ctx) {
+                        reject(new Error('无法创建 Canvas 2D 上下文，您的浏览器可能不支持此功能'));
+                        return;
+                    }
+                    canvas.width = width;
+                    canvas.height = height;
+                    // 绘制缩放后的图片
+                    ctx.drawImage(img, 0, 0, width, height);
+                    // 转换为 Blob
+                    canvas.toBlob((blob) => {
+                        if (!blob) {
+                            reject(new Error('图片转换为 Blob 失败'));
+                            return;
+                        }
+                        const compressedFile = new File([blob], file.name, {
+                            type: file.type,
+                            lastModified: Date.now(),
+                        });
+                        resolve({
+                            originalFile: file,
+                            compressedFile,
+                            originalSize: file.size,
+                            compressedSize: compressedFile.size,
+                            compressionRatio: compressedFile.size / file.size,
+                            width,
+                            height,
+                        });
+                    }, file.type, config.quality);
+                }
+                catch (error) {
+                    reject(error);
+                }
+            };
+            img.onerror = () => {
+                reject(new Error('图片加载失败'));
+            };
+            img.src = e.target?.result;
+        };
+        reader.onerror = () => {
+            reject(new Error('文件读取失败'));
+        };
+        reader.readAsDataURL(file);
+    });
+}
+/**
+ * 计算缩放后的尺寸（保持宽高比）
+ * @param originalWidth - 原始宽度
+ * @param originalHeight - 原始高度
+ * @param maxWidth - 最大宽度
+ * @param maxHeight - 最大高度
+ * @returns 缩放后的尺寸
+ */
+function calculateDimensions(originalWidth, originalHeight, maxWidth, maxHeight) {
+    let width = originalWidth;
+    let height = originalHeight;
+    // 如果尺寸在限制内，不需要缩放
+    if (width <= maxWidth && height <= maxHeight) {
+        return { width, height };
+    }
+    // 计算缩放比例
+    const widthRatio = maxWidth / width;
+    const heightRatio = maxHeight / height;
+    const ratio = Math.min(widthRatio, heightRatio);
+    width = Math.round(width * ratio);
+    height = Math.round(height * ratio);
+    return { width, height };
+}
+/**
+ * 检查是否需要压缩
+ * @param file - 文件对象
+ * @param config - 压缩配置
+ * @returns 是否需要压缩
+ */
+export function shouldCompress(file, config) {
+    const defaultConfig = {
+        enabled: true,
+        maxWidth: 1080,
+        maxHeight: 1080,
+    };
+    const finalConfig = { ...defaultConfig, ...config };
+    // 如果禁用压缩或不是图片，不压缩
+    if (!finalConfig.enabled || !isImageFile(file)) {
+        return false;
+    }
+    // 可以添加更多判断逻辑，例如：
+    // - 文件大小超过阈值
+    // - 文件尺寸超过最大值
+    // 目前简单返回 true，让 compressImage 内部判断
+    return true;
+}
+//# sourceMappingURL=compress.js.map

package/dist/compress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compress.js","sourceRoot":"","sources":["../src/compress.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * SeaVerse Utils SDK
+ *
+ * 通用工具集合，包含文件上传、图片压缩等功能
+ *
+ * @packageDocumentation
+ */
+export { UtilsClient } from './client.js';
+export type { UtilsClientOptions, CompressionConfig, UploadOptions, UploadProgress, UploadResult, PresignUploadRequest, PresignUploadData, PresignUploadResponse, ValidationResult, ValidationRules, CompressionResult, ErrorCodeType, } from './models.js';
+export { UtilsAPIError, ErrorCode } from './models.js';
+export { validateFile, formatBytes, isImageFile, getFileExtension, } from './utils.js';
+export { compressImage, shouldCompress } from './compress.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,aAAa,GACd,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGvD,OAAO,EACL,YAAY,EACZ,WAAW,EACX,WAAW,EACX,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+/**
+ * SeaVerse Utils SDK
+ *
+ * 通用工具集合，包含文件上传、图片压缩等功能
+ *
+ * @packageDocumentation
+ */
+// 导出核心客户端
+export { UtilsClient } from './client.js';
+// 导出错误类和错误码
+export { UtilsAPIError, ErrorCode } from './models.js';
+// 导出工具函数
+export { validateFile, formatBytes, isImageFile, getFileExtension, } from './utils.js';
+// 导出压缩函数
+export { compressImage, shouldCompress } from './compress.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,UAAU;AACV,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAkB1C,YAAY;AACZ,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEvD,SAAS;AACT,OAAO,EACL,YAAY,EACZ,WAAW,EACX,WAAW,EACX,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAEpB,SAAS;AACT,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}