sa2kit 1.2.0 → 1.3.0

package/dist/universalFile/server/index.mjs

@@ -2,7 +2,7 @@ export { LocalStorageProvider } from '../../chunk-GSTLV3MB.mjs';
 export { AliyunOSSProvider } from '../../chunk-YVBU7QDJ.mjs';
 import { CDNProviderError } from '../../chunk-ZGVB35L2.mjs';
 import { createLogger } from '../../chunk-KQGP6BTS.mjs';
-import { StorageProviderError, FileUploadError, FileProcessingError } from '../../chunk-3XG5OHFD.mjs';
+import { StorageProviderError, FileUploadError, FileProcessingError } from '../../chunk-CIVO4R6N.mjs';
 import { __require } from '../../chunk-BJTO5JO5.mjs';
 import { createHash } from 'crypto';
 import * as path3 from 'path';
@@ -3126,6 +3126,174 @@ var UniversalFileService = class extends 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 FileUploadError(`\u6587\u4EF6\u4E0D\u5B58\u5728: ${fileId}`);
+      }
+      await this.checkFileAccess(metadata, userId);
+      const storageProvider = this.storageProviders.get(metadata.storageProvider);
+      if (!storageProvider) {
+        throw new 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 FileUploadError(`\u6587\u4EF6\u4E0D\u5B58\u5728: ${fileId}`);
+      }
+      await this.checkFileDeleteAccess(metadata, userId);
+      const storageProvider = this.storageProviders.get(metadata.storageProvider);
+      if (!storageProvider) {
+        throw new 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 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 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;
+  }
   /**
    * 获取上传进度
    */
@@ -3314,7 +3482,7 @@ var UniversalFileService = class extends 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) {
@@ -3328,6 +3496,70 @@ var UniversalFileService = class extends 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 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 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 FileUploadError("\u65E0\u6743\u9650\u8BBF\u95EE\u6B64\u6587\u4EF6");
+    }
+    if (metadata.permission === "authenticated" && !userId) {
+      throw new FileUploadError("\u9700\u8981\u767B\u5F55\u624D\u80FD\u8BBF\u95EE\u6B64\u6587\u4EF6");
+    }
+  }
+  /**
+   * 检查文件删除权限
+   */
+  async checkFileDeleteAccess(metadata, userId) {
+    if (metadata.uploaderId !== userId) {
+      throw new FileUploadError("\u65E0\u6743\u9650\u5220\u9664\u6B64\u6587\u4EF6");
+    }
+  }
 };
 var logger7 = createLogger("CacheManager");
 var CacheManager = class {