sa2kit 2.0.1 → 2.0.2

package/dist/UniversalFileService-BpvbZitV.d.mts

@@ -0,0 +1,139 @@
+import { EventEmitter } from 'events';
+import { a as UploadFileInfo, S as StorageType, c as UploadProgress, F as FileMetadata, d as FileQueryOptions, e as PaginatedResult, B as BatchOperationResult, f as FileEventListener } from './types-DyG3ZV9V.mjs';
+import { U as UniversalFileServiceConfig, I as IStorageProvider, a as ICDNProvider, b as IFileProcessor } from './types-BTiaMsBz.mjs';
+
+/**
+ * 通用文件服务核心实现
+ *
+ * 提供统一的文件上传、下载、管理接口
+ */
+
+/**
+ * 通用文件服务类
+ */
+declare class UniversalFileService extends EventEmitter {
+    private config;
+    private storageProviders;
+    private cdnProviders;
+    private fileProcessors;
+    private uploadProgressMap;
+    private metadataCache;
+    private urlCache;
+    private processingQueue;
+    private isProcessingQueueRunning;
+    constructor(config: UniversalFileServiceConfig);
+    /**
+     * 设置数据库持久化监听器
+     *
+     * 当文件上传完成或删除时，自动触发数据库操作
+     */
+    private setupPersistenceListeners;
+    /**
+     * 初始化文件服务
+     */
+    initialize(): Promise<void>;
+    /**
+     * 重新初始化存储提供者（支持配置热更新）
+     */
+    reinitializeStorageProviders(): Promise<void>;
+    /**
+     * 注册存储提供者
+     */
+    registerStorageProvider(provider: IStorageProvider): void;
+    /**
+     * 注册CDN提供者
+     */
+    registerCDNProvider(provider: ICDNProvider): void;
+    /**
+     * 注册文件处理器
+     */
+    registerFileProcessor(processor: IFileProcessor): void;
+    /**
+     * 上传文件
+     */
+    uploadFile(fileInfo: UploadFileInfo, storageType?: StorageType, onProgress?: (progress: UploadProgress) => void): Promise<FileMetadata>;
+    /**
+     * 下载文件
+     */
+    downloadFile(fileId: string, userId?: string): Promise<Buffer>;
+    /**
+     * 删除文件
+     */
+    deleteFile(fileId: string, userId?: string): Promise<void>;
+    /**
+     * 获取文件访问URL
+     */
+    getFileUrl(fileId: string, userId?: string, expiresIn?: number): Promise<string>;
+    /**
+     * 获取文件元数据
+     */
+    getFileMetadata(fileId: string): Promise<FileMetadata | null>;
+    /**
+     * 查询文件列表
+     */
+    queryFiles(options: FileQueryOptions): Promise<PaginatedResult<FileMetadata>>;
+    /**
+     * 批量删除文件
+     */
+    batchDeleteFiles(fileIds: string[], userId?: string): Promise<BatchOperationResult>;
+    /**
+     * 获取上传进度
+     */
+    getUploadProgress(fileId: string): UploadProgress | undefined;
+    /**
+     * 监听文件事件
+     */
+    onFileEvent(eventType: string, listener: FileEventListener): void;
+    /**
+     * 移除文件事件监听器
+     */
+    offFileEvent(eventType: string, listener: FileEventListener): void;
+    /**
+     * 验证配置是否完整
+     */
+    private validateConfiguration;
+    private initializeStorageProviders;
+    private registerDefaultStorageProviders;
+    private initializeCDNProviders;
+    private initializeFileProcessors;
+    private validateFile;
+    private generateFileMetadata;
+    private generateStoragePath;
+    private generateFileHash;
+    private queueFileProcessing;
+    private generateProcessedPath;
+    private processFileQueue;
+    private cacheMetadata;
+    private clearMetadataCache;
+    private emitFileEvent;
+    /**
+     * 保存文件元数据到数据库 (通过持久化仓储)
+     */
+    private saveFileMetadata;
+    /**
+     * 从数据库删除文件元数据 (通过持久化仓储)
+     */
+    private deleteFileMetadata;
+    /**
+     * 更新访问统计
+     */
+    private updateAccessStats;
+    /**
+     * 检查文件访问权限
+     */
+    private checkFileAccess;
+    /**
+     * 检查文件删除权限
+     */
+    private checkFileDeleteAccess;
+    /**
+     * 检查服务是否完全可用（包括存储提供者）
+     */
+    isFullyInitialized(): boolean;
+    /**
+     * 等待服务完全初始化（带超时）
+     */
+    waitForInitialization(timeoutMs?: number): Promise<void>;
+}
+
+export { UniversalFileService as U };

package/dist/UniversalFileService-GsP6D3Rc.d.ts

@@ -0,0 +1,139 @@
+import { EventEmitter } from 'events';
+import { a as UploadFileInfo, S as StorageType, c as UploadProgress, F as FileMetadata, d as FileQueryOptions, e as PaginatedResult, B as BatchOperationResult, f as FileEventListener } from './types-DyG3ZV9V.js';
+import { U as UniversalFileServiceConfig, I as IStorageProvider, a as ICDNProvider, b as IFileProcessor } from './types-ERmJyjx8.js';
+
+/**
+ * 通用文件服务核心实现
+ *
+ * 提供统一的文件上传、下载、管理接口
+ */
+
+/**
+ * 通用文件服务类
+ */
+declare class UniversalFileService extends EventEmitter {
+    private config;
+    private storageProviders;
+    private cdnProviders;
+    private fileProcessors;
+    private uploadProgressMap;
+    private metadataCache;
+    private urlCache;
+    private processingQueue;
+    private isProcessingQueueRunning;
+    constructor(config: UniversalFileServiceConfig);
+    /**
+     * 设置数据库持久化监听器
+     *
+     * 当文件上传完成或删除时，自动触发数据库操作
+     */
+    private setupPersistenceListeners;
+    /**
+     * 初始化文件服务
+     */
+    initialize(): Promise<void>;
+    /**
+     * 重新初始化存储提供者（支持配置热更新）
+     */
+    reinitializeStorageProviders(): Promise<void>;
+    /**
+     * 注册存储提供者
+     */
+    registerStorageProvider(provider: IStorageProvider): void;
+    /**
+     * 注册CDN提供者
+     */
+    registerCDNProvider(provider: ICDNProvider): void;
+    /**
+     * 注册文件处理器
+     */
+    registerFileProcessor(processor: IFileProcessor): void;
+    /**
+     * 上传文件
+     */
+    uploadFile(fileInfo: UploadFileInfo, storageType?: StorageType, onProgress?: (progress: UploadProgress) => void): Promise<FileMetadata>;
+    /**
+     * 下载文件
+     */
+    downloadFile(fileId: string, userId?: string): Promise<Buffer>;
+    /**
+     * 删除文件
+     */
+    deleteFile(fileId: string, userId?: string): Promise<void>;
+    /**
+     * 获取文件访问URL
+     */
+    getFileUrl(fileId: string, userId?: string, expiresIn?: number): Promise<string>;
+    /**
+     * 获取文件元数据
+     */
+    getFileMetadata(fileId: string): Promise<FileMetadata | null>;
+    /**
+     * 查询文件列表
+     */
+    queryFiles(options: FileQueryOptions): Promise<PaginatedResult<FileMetadata>>;
+    /**
+     * 批量删除文件
+     */
+    batchDeleteFiles(fileIds: string[], userId?: string): Promise<BatchOperationResult>;
+    /**
+     * 获取上传进度
+     */
+    getUploadProgress(fileId: string): UploadProgress | undefined;
+    /**
+     * 监听文件事件
+     */
+    onFileEvent(eventType: string, listener: FileEventListener): void;
+    /**
+     * 移除文件事件监听器
+     */
+    offFileEvent(eventType: string, listener: FileEventListener): void;
+    /**
+     * 验证配置是否完整
+     */
+    private validateConfiguration;
+    private initializeStorageProviders;
+    private registerDefaultStorageProviders;
+    private initializeCDNProviders;
+    private initializeFileProcessors;
+    private validateFile;
+    private generateFileMetadata;
+    private generateStoragePath;
+    private generateFileHash;
+    private queueFileProcessing;
+    private generateProcessedPath;
+    private processFileQueue;
+    private cacheMetadata;
+    private clearMetadataCache;
+    private emitFileEvent;
+    /**
+     * 保存文件元数据到数据库 (通过持久化仓储)
+     */
+    private saveFileMetadata;
+    /**
+     * 从数据库删除文件元数据 (通过持久化仓储)
+     */
+    private deleteFileMetadata;
+    /**
+     * 更新访问统计
+     */
+    private updateAccessStats;
+    /**
+     * 检查文件访问权限
+     */
+    private checkFileAccess;
+    /**
+     * 检查文件删除权限
+     */
+    private checkFileDeleteAccess;
+    /**
+     * 检查服务是否完全可用（包括存储提供者）
+     */
+    isFullyInitialized(): boolean;
+    /**
+     * 等待服务完全初始化（带超时）
+     */
+    waitForInitialization(timeoutMs?: number): Promise<void>;
+}
+
+export { UniversalFileService as U };