sa2kit 1.2.0 → 1.3.0

package/dist/universalFile/server/index.js

@@ -4,7 +4,7 @@ var chunkTKCYPDWU_js = require('../../chunk-TKCYPDWU.js');
 var chunk3RFBUDRA_js = require('../../chunk-3RFBUDRA.js');
 var chunkKH6RQ4J5_js = require('../../chunk-KH6RQ4J5.js');
 var chunk6PRFP5EG_js = require('../../chunk-6PRFP5EG.js');
-var chunkHWJ34NL6_js = require('../../chunk-HWJ34NL6.js');
+var chunkZRAW3HXA_js = require('../../chunk-ZRAW3HXA.js');
 var chunkDGUM43GV_js = require('../../chunk-DGUM43GV.js');
 var crypto = require('crypto');
 var path3 = require('path');
@@ -3083,7 +3083,7 @@ var UniversalFileService = class extends events.EventEmitter {
         }
       }
       if (!storageProvider) {
-        throw new chunkHWJ34NL6_js.StorageProviderError(`\u6CA1\u6709\u53EF\u7528\u7684\u5B58\u50A8\u63D0\u4F9B\u8005`);
+        throw new chunkZRAW3HXA_js.StorageProviderError(`\u6CA1\u6709\u53EF\u7528\u7684\u5B58\u50A8\u63D0\u4F9B\u8005`);
       }
       const storagePath = this.generateStoragePath(metadata);
       progress.status = "uploading";
@@ -3093,7 +3093,7 @@ var UniversalFileService = class extends events.EventEmitter {
       this.emitFileEvent("upload:progress", fileId, { progress: progress.progress });
       const uploadResult = await storageProvider.upload(fileInfo, storagePath);
       if (!uploadResult.success) {
-        throw new chunkHWJ34NL6_js.FileUploadError(`\u4E0A\u4F20\u5931\u8D25: ${uploadResult.error}`);
+        throw new chunkZRAW3HXA_js.FileUploadError(`\u4E0A\u4F20\u5931\u8D25: ${uploadResult.error}`);
       }
       metadata.storagePath = uploadResult.path || storagePath;
       metadata.storageProvider = selectedStorageType;
@@ -3148,6 +3148,174 @@ var UniversalFileService = class extends events.EventEmitter {
       );
     }
   }
+  /**
+   * 下载文件
+   */
+  async downloadFile(fileId, userId) {
+    logger6.info(`\u{1F4E5} [UniversalFileService] \u5F00\u59CB\u4E0B\u8F7D\u6587\u4EF6: ${fileId}`);
+    try {
+      this.emitFileEvent("download:start", fileId);
+      const metadata = await this.getFileMetadata(fileId);
+      if (!metadata) {
+        throw new chunkZRAW3HXA_js.FileUploadError(`\u6587\u4EF6\u4E0D\u5B58\u5728: ${fileId}`);
+      }
+      await this.checkFileAccess(metadata, userId);
+      const storageProvider = this.storageProviders.get(metadata.storageProvider);
+      if (!storageProvider) {
+        throw new chunkZRAW3HXA_js.StorageProviderError(`\u5B58\u50A8\u63D0\u4F9B\u8005\u4E0D\u5B58\u5728: ${metadata.storageProvider}`);
+      }
+      const fileBuffer = await storageProvider.download(metadata.storagePath);
+      if (this.config.persistence?.enabled) {
+        await this.updateAccessStats(fileId);
+      }
+      logger6.info(`\u2705 [UniversalFileService] \u6587\u4EF6\u4E0B\u8F7D\u5B8C\u6210: ${fileId}`);
+      this.emitFileEvent("download:complete", fileId, { size: fileBuffer.length });
+      return fileBuffer;
+    } catch (error) {
+      console.error(`\u274C [UniversalFileService] \u6587\u4EF6\u4E0B\u8F7D\u5931\u8D25: ${fileId}:`, error);
+      this.emitFileEvent("download:error", fileId, void 0, error instanceof Error ? error.message : "\u4E0B\u8F7D\u5931\u8D25");
+      throw error;
+    }
+  }
+  /**
+   * 删除文件
+   */
+  async deleteFile(fileId, userId) {
+    logger6.info(`\u{1F5D1}\uFE0F [UniversalFileService] \u5F00\u59CB\u5220\u9664\u6587\u4EF6: ${fileId}`);
+    try {
+      const metadata = await this.getFileMetadata(fileId);
+      if (!metadata) {
+        throw new chunkZRAW3HXA_js.FileUploadError(`\u6587\u4EF6\u4E0D\u5B58\u5728: ${fileId}`);
+      }
+      await this.checkFileDeleteAccess(metadata, userId);
+      const storageProvider = this.storageProviders.get(metadata.storageProvider);
+      if (!storageProvider) {
+        throw new chunkZRAW3HXA_js.StorageProviderError(`\u5B58\u50A8\u63D0\u4F9B\u8005\u4E0D\u5B58\u5728: ${metadata.storageProvider}`);
+      }
+      const deleteResult = await storageProvider.delete(metadata.storagePath);
+      if (!deleteResult.success) {
+        console.warn(`\u26A0\uFE0F [UniversalFileService] \u5B58\u50A8\u6587\u4EF6\u5220\u9664\u5931\u8D25: ${deleteResult.error}`);
+      }
+      if (this.config.persistence?.enabled) {
+        await this.deleteFileMetadata(fileId);
+      }
+      this.clearMetadataCache(fileId);
+      logger6.info(`\u2705 [UniversalFileService] \u6587\u4EF6\u5220\u9664\u5B8C\u6210: ${fileId}`);
+      this.emitFileEvent("delete:complete", fileId);
+      this.emit("file:deleted", fileId);
+    } catch (error) {
+      console.error(`\u274C [UniversalFileService] \u6587\u4EF6\u5220\u9664\u5931\u8D25: ${fileId}:`, error);
+      this.emitFileEvent("delete:error", fileId, void 0, error instanceof Error ? error.message : "\u5220\u9664\u5931\u8D25");
+      throw error;
+    }
+  }
+  /**
+   * 获取文件访问URL
+   */
+  async getFileUrl(fileId, userId, expiresIn) {
+    const cacheKey = `${fileId}_${userId || "public"}_${expiresIn || 0}`;
+    const cached = this.urlCache.get(cacheKey);
+    if (cached && cached.expires > Date.now()) {
+      return cached.url;
+    }
+    const metadata = await this.getFileMetadata(fileId);
+    if (!metadata) {
+      throw new chunkZRAW3HXA_js.FileUploadError(`\u6587\u4EF6\u4E0D\u5B58\u5728: ${fileId}`);
+    }
+    await this.checkFileAccess(metadata, userId);
+    let url;
+    if (metadata.cdnUrl) {
+      url = metadata.cdnUrl;
+    } else {
+      const storageProvider = this.storageProviders.get(metadata.storageProvider);
+      if (!storageProvider) {
+        throw new chunkZRAW3HXA_js.StorageProviderError(`\u5B58\u50A8\u63D0\u4F9B\u8005\u4E0D\u5B58\u5728: ${metadata.storageProvider}`);
+      }
+      url = await storageProvider.getAccessUrl(metadata.storagePath, expiresIn);
+    }
+    const cacheExpires = Date.now() + (this.config.cache?.urlTTL || 1800) * 1e3;
+    this.urlCache.set(cacheKey, { url, expires: cacheExpires });
+    return url;
+  }
+  /**
+   * 获取文件元数据
+   */
+  async getFileMetadata(fileId) {
+    const cached = this.metadataCache.get(fileId);
+    if (cached && cached.expires > Date.now()) {
+      return cached.data;
+    }
+    if (this.config.persistence?.enabled && this.config.persistence.repository) {
+      try {
+        const metadata = await this.config.persistence.repository.get(fileId);
+        if (metadata) {
+          this.cacheMetadata(metadata);
+        }
+        return metadata;
+      } catch (error) {
+        console.error("\u274C [UniversalFileService] \u67E5\u8BE2\u6587\u4EF6\u5143\u6570\u636E\u5931\u8D25:", error);
+        return null;
+      }
+    }
+    logger6.warn(`\u26A0\uFE0F [UniversalFileService] \u6301\u4E45\u5316\u672A\u542F\u7528,\u65E0\u6CD5\u67E5\u8BE2\u6587\u4EF6\u5143\u6570\u636E: ${fileId}`);
+    return null;
+  }
+  /**
+   * 查询文件列表
+   */
+  async queryFiles(options) {
+    if (!this.config.persistence?.enabled || !this.config.persistence.repository) {
+      logger6.warn("\u26A0\uFE0F [UniversalFileService] \u6301\u4E45\u5316\u672A\u542F\u7528,\u65E0\u6CD5\u67E5\u8BE2\u6587\u4EF6\u5217\u8868");
+      return {
+        items: [],
+        total: 0,
+        page: options.page || 1,
+        pageSize: options.pageSize || 20,
+        totalPages: 0,
+        hasNext: false,
+        hasPrev: false
+      };
+    }
+    try {
+      const result = await this.config.persistence.repository.query(options);
+      const hasNext = result.page < result.totalPages;
+      const hasPrev = result.page > 1;
+      return {
+        ...result,
+        hasNext,
+        hasPrev
+      };
+    } catch (error) {
+      console.error("\u274C [UniversalFileService] \u67E5\u8BE2\u6587\u4EF6\u5217\u8868\u5931\u8D25:", error);
+      throw error;
+    }
+  }
+  /**
+   * 批量删除文件
+   */
+  async batchDeleteFiles(fileIds, userId) {
+    const result = {
+      successCount: 0,
+      failureCount: 0,
+      failures: []
+    };
+    for (const fileId of fileIds) {
+      try {
+        await this.deleteFile(fileId, userId);
+        result.successCount++;
+      } catch (error) {
+        result.failureCount++;
+        result.failures.push({
+          fileId,
+          error: error instanceof Error ? error.message : "\u5220\u9664\u5931\u8D25"
+        });
+      }
+    }
+    if (result.successCount > 0) {
+      this.emit("files:batch-deleted", fileIds.filter((_, i) => i < result.successCount));
+    }
+    return result;
+  }
   /**
    * 获取上传进度
    */
@@ -3231,11 +3399,11 @@ var UniversalFileService = class extends events.EventEmitter {
   }
   async validateFile(file) {
     if (this.config.maxFileSize && file.size > this.config.maxFileSize) {
-      throw new chunkHWJ34NL6_js.FileUploadError(`\u6587\u4EF6\u5927\u5C0F\u8D85\u8FC7\u9650\u5236: ${file.size} > ${this.config.maxFileSize}`);
+      throw new chunkZRAW3HXA_js.FileUploadError(`\u6587\u4EF6\u5927\u5C0F\u8D85\u8FC7\u9650\u5236: ${file.size} > ${this.config.maxFileSize}`);
     }
     const mimeType = file.type || getMimeType(file.name);
     if (this.config.allowedMimeTypes && this.config.allowedMimeTypes.length > 0 && !this.config.allowedMimeTypes.includes(mimeType)) {
-      throw new chunkHWJ34NL6_js.FileUploadError(`\u4E0D\u652F\u6301\u7684\u6587\u4EF6\u7C7B\u578B: ${mimeType}`);
+      throw new chunkZRAW3HXA_js.FileUploadError(`\u4E0D\u652F\u6301\u7684\u6587\u4EF6\u7C7B\u578B: ${mimeType}`);
     }
   }
   async generateFileMetadata(fileId, fileInfo) {
@@ -3285,7 +3453,7 @@ var UniversalFileService = class extends events.EventEmitter {
       return;
     }
     if (this.processingQueue.length >= 1e3) {
-      throw new chunkHWJ34NL6_js.FileProcessingError("\u5904\u7406\u961F\u5217\u5DF2\u6EE1");
+      throw new chunkZRAW3HXA_js.FileProcessingError("\u5904\u7406\u961F\u5217\u5DF2\u6EE1");
     }
     this.processingQueue.push({
       fileId: metadata.id,
@@ -3336,7 +3504,7 @@ var UniversalFileService = class extends events.EventEmitter {
     const expires = Date.now() + (this.config.cache?.metadataTTL || 3600) * 1e3;
     this.metadataCache.set(metadata.id, { data: metadata, expires });
   }
-  _clearMetadataCache2(fileId) {
+  clearMetadataCache(fileId) {
     this.metadataCache.delete(fileId);
   }
   emitFileEvent(type, fileId, data, error) {
@@ -3350,6 +3518,70 @@ var UniversalFileService = class extends events.EventEmitter {
     this.emit(type, event);
     this.emit("*", event);
   }
+  // ============= 数据库操作私有方法 =============
+  /**
+   * 保存文件元数据到数据库 (通过持久化仓储)
+   */
+  async saveFileMetadata(metadata) {
+    if (!this.config.persistence?.enabled || !this.config.persistence.repository) {
+      logger6.warn("\u26A0\uFE0F [UniversalFileService] \u6301\u4E45\u5316\u672A\u542F\u7528,\u8DF3\u8FC7\u4FDD\u5B58\u5143\u6570\u636E");
+      return;
+    }
+    try {
+      await this.config.persistence.repository.save(metadata);
+      logger6.info("\u{1F4BE} [UniversalFileService] \u6587\u4EF6\u5143\u6570\u636E\u4FDD\u5B58\u6210\u529F:", metadata.id);
+    } catch (error) {
+      console.error("\u274C [UniversalFileService] \u4FDD\u5B58\u6587\u4EF6\u5143\u6570\u636E\u5931\u8D25:", error);
+      throw new chunkZRAW3HXA_js.FileUploadError(
+        `\u4FDD\u5B58\u6587\u4EF6\u5143\u6570\u636E\u5931\u8D25: ${error instanceof Error ? error.message : "\u672A\u77E5\u9519\u8BEF"}`
+      );
+    }
+  }
+  /**
+   * 从数据库删除文件元数据 (通过持久化仓储)
+   */
+  async deleteFileMetadata(fileId) {
+    if (!this.config.persistence?.enabled || !this.config.persistence.repository) {
+      return;
+    }
+    try {
+      await this.config.persistence.repository.delete(fileId);
+      logger6.info("\u{1F5D1}\uFE0F [UniversalFileService] \u6587\u4EF6\u5143\u6570\u636E\u5220\u9664\u6210\u529F:", fileId);
+    } catch (error) {
+      console.error("\u274C [UniversalFileService] \u5220\u9664\u6587\u4EF6\u5143\u6570\u636E\u5931\u8D25:", error);
+      throw new chunkZRAW3HXA_js.FileUploadError(
+        `\u5220\u9664\u6587\u4EF6\u5143\u6570\u636E\u5931\u8D25: ${error instanceof Error ? error.message : "\u672A\u77E5\u9519\u8BEF"}`
+      );
+    }
+  }
+  /**
+   * 更新访问统计
+   */
+  async updateAccessStats(fileId) {
+    logger6.info("\u{1F4CA} [UniversalFileService] \u9700\u8981\u66F4\u65B0\u8BBF\u95EE\u7EDF\u8BA1:", fileId);
+  }
+  /**
+   * 检查文件访问权限
+   */
+  async checkFileAccess(metadata, userId) {
+    if (metadata.permission === "public") {
+      return;
+    }
+    if (metadata.permission === "private" && metadata.uploaderId !== userId) {
+      throw new chunkZRAW3HXA_js.FileUploadError("\u65E0\u6743\u9650\u8BBF\u95EE\u6B64\u6587\u4EF6");
+    }
+    if (metadata.permission === "authenticated" && !userId) {
+      throw new chunkZRAW3HXA_js.FileUploadError("\u9700\u8981\u767B\u5F55\u624D\u80FD\u8BBF\u95EE\u6B64\u6587\u4EF6");
+    }
+  }
+  /**
+   * 检查文件删除权限
+   */
+  async checkFileDeleteAccess(metadata, userId) {
+    if (metadata.uploaderId !== userId) {
+      throw new chunkZRAW3HXA_js.FileUploadError("\u65E0\u6743\u9650\u5220\u9664\u6B64\u6587\u4EF6");
+    }
+  }
 };
 var logger7 = chunk6PRFP5EG_js.createLogger("CacheManager");
 var CacheManager = class {