sa2kit 1.6.7 → 1.6.9

package/dist/universalFile/server/index.d.ts

@@ -1,4516 +0,0 @@
-import { a as UniversalFileServiceConfig, S as StorageConfig, I as IStorageProvider, b as StorageType, c as UploadFileInfo, d as StorageResult, e as ICDNProvider, C as CDNType, f as CDNConfig, g as CDNResult, h as IFileProcessor, P as ProcessorType, i as ProcessingOptions, j as ProcessingResult, k as IFileMetadataRepository, A as AliyunOSSConfig, l as AliyunCDNConfig, L as LocalStorageConfig, U as UniversalFileService } from '../../UniversalFileService-BuHN-jrR.js';
-export { B as CDNProviderError, o as CDNStats, m as CacheConfig, t as FileEvent, u as FileEventListener, v as FileEventType, y as FileProcessingError, r as FileQueryOptions, q as FileRecord, w as FileServiceError, F as FileServicePersistenceConfig, x as FileUploadError, s as PaginatedResult, p as ProcessorInfo, n as StorageMetadata, z as StorageProviderError } from '../../UniversalFileService-BuHN-jrR.js';
-import { I as ImageProcessingOptions, l as AudioProcessingOptions, V as VideoProcessingOptions } from '../../types-CK4We_aI.js';
-import { EventEmitter } from 'events';
-import { NextResponse } from 'next/server';
-import * as drizzle_orm from 'drizzle-orm';
-import * as drizzle_orm_pg_core from 'drizzle-orm/pg-core';
-
-/**
- * UniversalFile Service 工厂函数
- * 提供简化的服务初始化方式
- */
-
-/**
- * 创建文件服务配置（带智能默认值）
- */
-declare function createFileServiceConfig(options: Partial<UniversalFileServiceConfig> & {
-    storage: StorageConfig | 'local';
-}): UniversalFileServiceConfig;
-/**
- * 创建文件服务实例（简化版）
- *
- * @example
- * ```typescript
- * // 最简配置 - 使用本地存储
- * const service = createUniversalFileService({ storage: 'local' });
- *
- * // 标准配置 - 使用阿里云 OSS
- * const service = createUniversalFileService({
- *   storage: {
- *     type: 'aliyun-oss',
- *     config: {
- *       accessKeyId: process.env.OSS_KEY!,
- *       accessKeySecret: process.env.OSS_SECRET!,
- *       bucket: process.env.OSS_BUCKET!,
- *       region: process.env.OSS_REGION!,
- *     },
- *   },
- *   db: drizzleDb,
- * });
- * ```
- */
-declare function createUniversalFileService(options: Partial<UniversalFileServiceConfig> & {
-    storage: StorageConfig | 'local';
-}): {
-    config: UniversalFileServiceConfig;
-    upload(): Promise<never>;
-    download(): Promise<never>;
-};
-/**
- * 从环境变量创建配置（便利函数）
- *
- * @example
- * ```typescript
- * // .env
- * // STORAGE_TYPE=aliyun-oss
- * // OSS_ACCESS_KEY_ID=xxx
- * // OSS_ACCESS_KEY_SECRET=xxx
- * // OSS_BUCKET=my-bucket
- * // OSS_REGION=oss-cn-hangzhou
- *
- * const service = createFileServiceFromEnv();
- * ```
- */
-declare function createFileServiceFromEnv(db?: any): {
-    config: UniversalFileServiceConfig;
-    upload(): Promise<never>;
-    download(): Promise<never>;
-};
-
-/**
- * UniversalFile 预设配置
- * 提供常见场景的开箱即用配置
- */
-
-/**
- * 本地开发环境预设
- */
-declare function createLocalDevPreset(baseUrl?: string): StorageConfig;
-/**
- * 生产环境 OSS 预设
- */
-declare function createAliyunOSSPreset(config: {
-    accessKeyId: string;
-    accessKeySecret: string;
-    bucket: string;
-    region?: string;
-}): StorageConfig;
-/**
- * 智能预设：根据环境自动选择
- */
-declare function createSmartPreset(): StorageConfig;
-/**
- * 图片服务预设（针对图片处理优化）
- */
-declare function createImageServicePreset(storage: StorageConfig): {
-    storage: StorageConfig;
-    maxFileSize: number;
-    allowedMimeTypes: string[];
-};
-/**
- * 视频服务预设（针对大文件优化）
- */
-declare function createVideoServicePreset(storage: StorageConfig): {
-    storage: StorageConfig;
-    maxFileSize: number;
-    allowedMimeTypes: string[];
-    enableStreaming: boolean;
-};
-/**
- * 文档服务预设
- */
-declare function createDocumentServicePreset(storage: StorageConfig): {
-    storage: StorageConfig;
-    maxFileSize: number;
-    allowedMimeTypes: string[];
-};
-
-/**
- * UniversalFile 配置验证
- */
-
-declare class ConfigValidationError extends Error {
-    field: string;
-    constructor(message: string, field: string);
-}
-/**
- * 验证存储配置
- */
-declare function validateStorageConfig(storage: StorageConfig): void;
-/**
- * 验证完整的服务配置
- */
-declare function validateServiceConfig(config: UniversalFileServiceConfig): void;
-/**
- * 验证环境变量
- */
-declare function validateEnvironment(requiredVars: string[]): void;
-/**
- * 获取环境变量所需的变量列表（根据存储类型）
- */
-declare function getRequiredEnvVars(storageType: string): string[];
-
-/**
- * 本地存储提供者实现
- */
-
-/**
- * 本地文件系统存储提供者
- */
-declare class LocalStorageProvider implements IStorageProvider {
-    readonly type: StorageType;
-    private config;
-    private isInitialized;
-    /**
-     * 初始化存储提供者
-     */
-    initialize(config: StorageConfig): Promise<void>;
-    /**
-     * 上传文件
-     */
-    upload(fileInfo: UploadFileInfo, filePath: string): Promise<StorageResult>;
-    /**
-     * 下载文件
-     */
-    download(path: string): Promise<Buffer>;
-    /**
-     * 删除文件
-     */
-    delete(path: string): Promise<StorageResult>;
-    /**
-     * 获取文件信息
-     */
-    getFileInfo(path: string): Promise<StorageResult>;
-    /**
-     * 生成访问URL
-     */
-    getAccessUrl(path: string, _expiresIn?: number): Promise<string>;
-    /**
-     * 生成预签名上传URL
-     */
-    getUploadUrl(path: string, _expiresIn?: number): Promise<string>;
-    /**
-     * 检查文件是否存在
-     */
-    exists(path: string): Promise<boolean>;
-    /**
-     * 列出文件
-     */
-    list(prefix: string, maxKeys?: number): Promise<string[]>;
-    /**
-     * 确保已初始化
-     */
-    private ensureInitialized;
-    /**
-     * 获取完整文件路径
-     */
-    private getFullPath;
-    /**
-     * 生成访问URL
-     */
-    private generateAccessUrl;
-    /**
-     * 确保目录存在
-     */
-    private ensureDirectoryExists;
-    /**
-     * 验证目录访问权限
-     */
-    private validateDirectoryAccess;
-    /**
-     * 流式上传大文件（可选实现）
-     */
-    uploadStream(readableStream: NodeJS.ReadableStream, filePath: string): Promise<StorageResult>;
-    /**
-     * 流式下载大文件（可选实现）
-     */
-    createDownloadStream(path: string): NodeJS.ReadableStream;
-}
-
-/**
- * 阿里云OSS存储提供者实现
- */
-
-/**
- * 阿里云OSS存储提供者
- */
-declare class AliyunOSSProvider implements IStorageProvider {
-    readonly type: StorageType;
-    private config;
-    private client;
-    private isInitialized;
-    /**
-     * 初始化存储提供者
-     */
-    initialize(config: StorageConfig): Promise<void>;
-    /**
-     * 重新初始化存储提供者（支持配置热更新）
-     */
-    reinitialize(config: StorageConfig): Promise<void>;
-    /**
-     * 上传文件
-     */
-    upload(fileInfo: UploadFileInfo, filePath: string): Promise<StorageResult>;
-    /**
-     * 下载文件
-     */
-    download(filePath: string): Promise<Buffer>;
-    /**
-     * 删除文件
-     */
-    delete(filePath: string): Promise<StorageResult>;
-    /**
-     * 获取文件信息
-     */
-    getFileInfo(filePath: string): Promise<StorageResult>;
-    /**
-     * 生成访问URL
-     */
-    getAccessUrl(filePath: string, expiresIn?: number): Promise<string>;
-    /**
-     * 生成预签名上传URL
-     */
-    getUploadUrl(filePath: string, expiresIn?: number): Promise<string>;
-    /**
-     * 检查文件是否存在
-     */
-    exists(filePath: string): Promise<boolean>;
-    /**
-     * 列出文件（详细信息）
-     */
-    listFiles(prefix: string, delimiter?: string, maxKeys?: number): Promise<{
-        files: Array<{
-            name: string;
-            url: string;
-            size: number;
-            lastModified: string;
-            etag: string;
-            type: string;
-        }>;
-        folders: string[];
-        nextMarker?: string;
-    }>;
-    /**
-     * 列出文件
-     */
-    list(prefix: string, maxKeys?: number): Promise<string[]>;
-    /**
-     * 确保已初始化
-     */
-    private ensureInitialized;
-    /**
-     * 验证配置
-     */
-    private validateConfig;
-    /**
-     * 测试连接
-     */
-    private testConnection;
-    /**
-     * 分片上传大文件
-     */
-    private multipartUpload;
-    /**
-     * 生成公开访问URL
-     */
-    private generateAccessUrl;
-    /**
-     * 判断是否为OSS错误
-     */
-    private isOSSError;
-    /**
-     * 格式化OSS错误信息
-     */
-    private formatOSSError;
-    /**
-     * 流式上传（可选实现）
-     */
-    uploadStream(readableStream: NodeJS.ReadableStream, filePath: string, contentType?: string, contentLength?: number): Promise<StorageResult>;
-    /**
-     * 批量删除文件
-     */
-    batchDelete(filePaths: string[]): Promise<StorageResult>;
-    /**
-     * 复制文件
-     */
-    copy(sourcePath: string, targetPath: string): Promise<StorageResult>;
-    /**
-     * 编码元数据，避免中文字符在HTTP头部中的问题
-     */
-    private encodeMetadata;
-}
-
-/**
- * 阿里云CDN提供者实现
- */
-
-/**
- * 阿里云CDN提供者
- */
-declare class AliyunCDNProvider implements ICDNProvider {
-    readonly type: CDNType;
-    private config;
-    private client;
-    private isInitialized;
-    /**
-     * 初始化CDN提供者
-     */
-    initialize(config: CDNConfig): Promise<void>;
-    /**
-     * 生成CDN URL
-     */
-    generateUrl(originalUrl: string): Promise<string>;
-    /**
-     * 刷新缓存
-     */
-    refreshCache(urls: string[]): Promise<CDNResult>;
-    /**
-     * 预热缓存
-     */
-    preheatCache(urls: string[]): Promise<CDNResult>;
-    /**
-     * 获取访问统计
-     */
-    getAccessStats(startTime: Date, endTime: Date): Promise<CDNResult>;
-    /**
-     * 生成防盗链签名URL
-     */
-    generateSignedUrl(originalUrl: string, expiresIn?: number, authKey?: string): Promise<string>;
-    /**
-     * 查询刷新任务状态
-     */
-    getRefreshTaskStatus(taskId: string): Promise<CDNResult>;
-    /**
-     * 查询预热任务状态
-     */
-    getPreheatTaskStatus(taskId: string): Promise<CDNResult>;
-    /**
-     * 获取域名配置
-     */
-    getDomainConfig(): Promise<CDNResult>;
-    /**
-     * 优化URL (添加图像处理参数等)
-     */
-    optimizeUrl(originalUrl: string, options?: {
-        imageQuality?: number;
-        imageFormat?: 'webp' | 'jpg' | 'png';
-        imageResize?: {
-            width?: number;
-            height?: number;
-        };
-        enableGzip?: boolean;
-    }): Promise<string>;
-    /**
-     * 确保已初始化
-     */
-    private ensureInitialized;
-    /**
-     * 验证配置
-     */
-    private validateConfig;
-    /**
-     * 验证域名格式
-     */
-    private isValidDomain;
-    /**
-     * 测试连接
-     */
-    private testConnection;
-    /**
-     * 创建模拟客户端（用于开发测试）
-     */
-    private createMockClient;
-    /**
-     * 批量刷新缓存（带进度回调）
-     */
-    batchRefreshCache(urls: string[], batchSize?: number, onProgress?: (completed: number, total: number) => void): Promise<CDNResult>;
-}
-
-/**
- * CDN缓存策略管理
- * 优化静态资源缓存策略和预热机制
- */
-/**
- * 缓存策略类型
- */
-declare enum CacheStrategyType$1 {
-    /** 图片资源 */
-    IMAGE = "image",
-    /** 视频资源 */
-    VIDEO = "video",
-    /** 音频资源 */
-    AUDIO = "audio",
-    /** 文档资源 */
-    DOCUMENT = "document",
-    /** 压缩包 */
-    ARCHIVE = "archive",
-    /** 静态资源 */
-    STATIC = "static",
-    /** 其他 */
-    OTHER = "other"
-}
-/**
- * 缓存策略配置
- */
-interface CacheStrategyConfig$1 {
-    /** 缓存策略类型 */
-    type: CacheStrategyType$1;
-    /** 缓存时间（秒） */
-    ttl: number;
-    /** 是否启用浏览器缓存 */
-    browserCache: boolean;
-    /** 浏览器缓存时间（秒） */
-    browserCacheTtl: number;
-    /** 是否启用CDN缓存 */
-    cdnCache: boolean;
-    /** CDN缓存时间（秒） */
-    cdnCacheTtl: number;
-    /** 是否启用预热 */
-    enableWarmup: boolean;
-    /** 缓存控制头 */
-    cacheControl: string;
-    /** 允许的文件类型 */
-    allowedMimeTypes: string[];
-    /** 文件大小限制（字节） */
-    maxFileSize?: number;
-}
-/**
- * 缓存统计信息
- */
-interface CacheStats$2 {
-    /** 命中次数 */
-    hits: number;
-    /** 未命中次数 */
-    misses: number;
-    /** 命中率 */
-    hitRate: number;
-    /** 总请求数 */
-    totalRequests: number;
-    /** 缓存大小估算 */
-    estimatedSize: number;
-    /** 节省的带宽（字节） */
-    bandwidthSaved: number;
-}
-/**
- * CDN缓存策略管理器
- */
-declare class CdnCacheStrategy$1 {
-    private strategies;
-    private stats;
-    constructor();
-    /**
-     * 初始化默认缓存策略
-     */
-    private initializeDefaultStrategies;
-    /**
-     * 根据MIME类型获取缓存策略
-     */
-    getStrategyByMimeType(mimeType: string): CacheStrategyConfig$1;
-    /**
-     * 生成缓存控制头
-     */
-    generateCacheHeaders(mimeType: string, fileSize?: number): Record<string, string>;
-    /**
-     * 检查是否需要缓存预热
-     */
-    shouldWarmupCache(mimeType: string): boolean;
-    /**
-     * 记录缓存命中
-     */
-    recordCacheHit(mimeType: string, fileSize?: number): void;
-    /**
-     * 记录缓存未命中
-     */
-    recordCacheMiss(mimeType: string, fileSize?: number): void;
-    /**
-     * 获取缓存统计信息
-     */
-    getCacheStats(): Map<CacheStrategyType$1, CacheStats$2>;
-    /**
-     * 获取总体缓存统计
-     */
-    getOverallStats(): CacheStats$2;
-    /**
-     * 生成缓存优化建议
-     */
-    generateOptimizationSuggestions(): Array<{
-        type: CacheStrategyType$1;
-        issue: string;
-        suggestion: string;
-        severity: 'low' | 'medium' | 'high';
-    }>;
-    /**
-     * 更新缓存策略
-     */
-    updateStrategy(type: CacheStrategyType$1, config: Partial<CacheStrategyConfig$1>): void;
-    /**
-     * 重置统计信息
-     */
-    resetStats(): void;
-}
-/**
- * 单例CDN缓存策略管理器
- */
-declare const cdnCacheStrategy: CdnCacheStrategy$1;
-
-/**
- * 图片处理器实现
- * 支持压缩、裁剪、水印、格式转换等功能
- */
-
-/**
- * 图片处理器
- * 使用Sharp库进行高性能图片处理
- */
-declare class ImageProcessor implements IFileProcessor {
-    readonly type: ProcessorType;
-    private sharp;
-    private isInitialized;
-    /**
-     * 初始化图片处理器
-     */
-    initialize(): Promise<void>;
-    /**
-     * 处理图片文件
-     */
-    process(inputPath: string, outputPath: string, options: ProcessingOptions): Promise<ProcessingResult>;
-    /**
-     * 检查文件是否支持处理
-     */
-    supports(mimeType: string): boolean;
-    /**
-     * 获取图片文件信息
-     */
-    getFileInfo(filePath: string): Promise<Record<string, any>>;
-    /**
-     * 确保处理器已初始化
-     */
-    private ensureInitialized;
-    /**
-     * 获取图片元数据
-     */
-    private getImageMetadata;
-    /**
-     * 应用图片处理操作
-     */
-    private applyImageOperations;
-    /**
-     * 应用水印
-     */
-    private applyWatermark;
-    /**
-     * 创建文字水印SVG
-     */
-    private createTextWatermarkSvg;
-    /**
-     * 获取水印位置对应的gravity值
-     */
-    private getWatermarkGravity;
-    /**
-     * 确定输出格式
-     */
-    private determineOutputFormat;
-    /**
-     * 应用输出设置
-     */
-    private applyOutputSettings;
-    /**
-     * 是否需要生成缩略图
-     */
-    private shouldGenerateThumbnail;
-    /**
-     * 生成缩略图
-     */
-    private generateThumbnail;
-    /**
-     * 获取缩略图路径
-     */
-    private getThumbnailPath;
-    /**
-     * 创建模拟Sharp对象（开发测试用）
-     */
-    private createMockSharp;
-    /**
-     * 批量图片处理
-     */
-    batchProcess(inputPaths: string[], outputDir: string, options: ImageProcessingOptions, onProgress?: (completed: number, total: number) => void): Promise<ProcessingResult[]>;
-}
-
-/**
- * 音频处理器实现
- * 支持格式转换、压缩、音质调整等功能
- */
-
-/**
- * 音频处理器
- * 使用FFmpeg进行音频处理
- */
-declare class AudioProcessor implements IFileProcessor {
-    readonly type: ProcessorType;
-    private ffmpeg;
-    private isInitialized;
-    /**
-     * 初始化音频处理器
-     */
-    initialize(): Promise<void>;
-    /**
-     * 处理音频文件
-     */
-    process(inputPath: string, outputPath: string, options: ProcessingOptions): Promise<ProcessingResult>;
-    /**
-     * 检查文件是否支持处理
-     */
-    supports(mimeType: string): boolean;
-    /**
-     * 获取音频文件信息
-     */
-    getFileInfo(filePath: string): Promise<Record<string, any>>;
-    /**
-     * 确保处理器已初始化
-     */
-    private ensureInitialized;
-    /**
-     * 获取音频元数据
-     */
-    private getAudioMetadata;
-    /**
-     * 执行音频处理
-     */
-    private processAudio;
-    /**
-     * 设置音频编解码器
-     */
-    private setAudioCodec;
-    /**
-     * 确定输出格式
-     */
-    private determineOutputFormat;
-    /**
-     * 格式化时长显示
-     */
-    private formatDuration;
-    /**
-     * 获取声道描述
-     */
-    private getChannelsDescription;
-    /**
-     * 获取音质描述
-     */
-    private getQualityDescription;
-    /**
-     * 创建模拟FFmpeg对象（开发测试用）
-     */
-    private createMockFFmpeg;
-    /**
-     * 批量音频处理
-     */
-    batchProcess(inputPaths: string[], outputDir: string, options: AudioProcessingOptions, onProgress?: (completed: number, total: number) => void): Promise<ProcessingResult[]>;
-    /**
-     * 提取音频封面
-     */
-    extractCover(inputPath: string, outputPath: string): Promise<boolean>;
-    /**
-     * 音频降噪处理
-     */
-    denoise(inputPath: string, outputPath: string): Promise<ProcessingResult>;
-}
-
-/**
- * 视频处理器实现
- * 支持缩略图生成、格式转换、压缩等功能
- */
-
-/**
- * 视频处理器
- * 使用FFmpeg进行视频处理
- */
-declare class VideoProcessor implements IFileProcessor {
-    readonly type: ProcessorType;
-    private ffmpeg;
-    private isInitialized;
-    /**
-     * 初始化视频处理器
-     */
-    initialize(): Promise<void>;
-    /**
-     * 处理视频文件
-     */
-    process(inputPath: string, outputPath: string, options: ProcessingOptions): Promise<ProcessingResult>;
-    /**
-     * 检查文件是否支持处理
-     */
-    supports(mimeType: string): boolean;
-    /**
-     * 获取视频文件信息
-     */
-    getFileInfo(filePath: string): Promise<Record<string, any>>;
-    /**
-     * 确保处理器已初始化
-     */
-    private ensureInitialized;
-    /**
-     * 获取视频元数据
-     */
-    private getVideoMetadata;
-    /**
-     * 解析帧率
-     */
-    private parseFPS;
-    /**
-     * 执行视频处理
-     */
-    private processVideo;
-    /**
-     * 设置视频编解码器
-     */
-    private setVideoCodec;
-    /**
-     * 设置视频质量
-     */
-    private setVideoQuality;
-    /**
-     * 确定输出格式
-     */
-    private determineOutputFormat;
-    /**
-     * 生成缩略图
-     */
-    private generateThumbnail;
-    /**
-     * 获取缩略图路径
-     */
-    private getThumbnailPath;
-    /**
-     * 格式化时长显示
-     */
-    private formatDuration;
-    /**
-     * 获取分辨率描述
-     */
-    private getResolutionDescription;
-    /**
-     * 获取视频质量描述
-     */
-    private getQualityDescription;
-    /**
-     * 创建模拟FFmpeg对象（开发测试用）
-     */
-    private createMockFFmpeg;
-    /**
-     * 批量视频处理
-     */
-    batchProcess(inputPaths: string[], outputDir: string, options: VideoProcessingOptions, onProgress?: (completed: number, total: number) => void): Promise<ProcessingResult[]>;
-    /**
-     * 提取视频帧
-     */
-    extractFrames(inputPath: string, outputDir: string, options?: {
-        count?: number;
-        interval?: number;
-        format?: 'jpg' | 'png';
-    }): Promise<string[]>;
-    /**
-     * 视频压缩
-     */
-    compress(inputPath: string, outputPath: string, compressionLevel?: 'low' | 'medium' | 'high'): Promise<ProcessingResult>;
-    /**
-     * 获取压缩质量
-     */
-    private getCompressionQuality;
-}
-
-/**
- * 文件处理队列管理系统
- * 支持异步任务调度、优先级排序、并发控制等功能
- */
-
-interface QueueTask {
-    id: string;
-    inputPath: string;
-    outputPath: string;
-    options: ProcessingOptions;
-    priority: TaskPriority;
-    status: TaskStatus;
-    processor?: IFileProcessor;
-    startTime?: number;
-    endTime?: number;
-    result?: ProcessingResult;
-    error?: string;
-    retries: number;
-    maxRetries: number;
-    onProgress?: (task: QueueTask, progress: number) => void;
-    onComplete?: (task: QueueTask, result: ProcessingResult) => void;
-    onError?: (task: QueueTask, error: string) => void;
-}
-type TaskPriority = 'low' | 'normal' | 'high' | 'urgent';
-type TaskStatus = 'pending' | 'running' | 'completed' | 'failed' | 'cancelled';
-interface QueueOptions {
-    maxConcurrentTasks?: number;
-    maxRetries?: number;
-    retryDelay?: number;
-    taskTimeout?: number;
-    autoStart?: boolean;
-}
-interface QueueStats {
-    totalTasks: number;
-    pendingTasks: number;
-    runningTasks: number;
-    completedTasks: number;
-    failedTasks: number;
-    cancelledTasks: number;
-    averageProcessingTime: number;
-    successRate: number;
-}
-/**
- * 文件处理队列管理器
- */
-declare class ProcessingQueue extends EventEmitter {
-    private tasks;
-    private runningTasks;
-    private processors;
-    private options;
-    private isStarted;
-    private processInterval;
-    constructor(options?: QueueOptions);
-    /**
-     * 注册文件处理器
-     */
-    registerProcessor(processor: IFileProcessor): void;
-    /**
-     * 添加任务到队列
-     */
-    addTask(inputPath: string, outputPath: string, options: ProcessingOptions, taskOptions?: Partial<Pick<QueueTask, 'priority' | 'maxRetries' | 'onProgress' | 'onComplete' | 'onError'>>): string;
-    /**
-     * 启动队列处理
-     */
-    start(): void;
-    /**
-     * 停止队列处理
-     */
-    stop(): void;
-    /**
-     * 暂停任务
-     */
-    pauseTask(taskId: string): boolean;
-    /**
-     * 取消任务
-     */
-    cancelTask(taskId: string): boolean;
-    /**
-     * 获取任务状态
-     */
-    getTask(taskId: string): QueueTask | undefined;
-    /**
-     * 获取所有任务
-     */
-    getAllTasks(): QueueTask[];
-    /**
-     * 获取待处理任务
-     */
-    getPendingTasks(): QueueTask[];
-    /**
-     * 获取正在运行的任务
-     */
-    getRunningTasks(): QueueTask[];
-    /**
-     * 获取队列统计信息
-     */
-    getStats(): QueueStats;
-    /**
-     * 清理已完成的任务
-     */
-    cleanup(): void;
-    /**
-     * 处理下一个任务
-     */
-    private processNext;
-    /**
-     * 获取下一个待处理任务（按优先级排序）
-     */
-    private getNextTask;
-    /**
-     * 处理单个任务
-     */
-    private processTask;
-    /**
-     * 完成任务
-     */
-    private completeTask;
-    /**
-     * 重试或失败任务
-     */
-    private retryOrFailTask;
-    /**
-     * 失败任务
-     */
-    private failTask;
-    /**
-     * 生成唯一任务ID
-     */
-    private generateTaskId;
-    /**
-     * 批量添加任务
-     */
-    addBatchTasks(tasks: Array<{
-        inputPath: string;
-        outputPath: string;
-        options: ProcessingOptions;
-        priority?: TaskPriority;
-    }>, onBatchProgress?: (completed: number, total: number) => void, onBatchComplete?: (results: Map<string, ProcessingResult>) => void): string[];
-    /**
-     * 获取队列健康状态
-     */
-    getHealthStatus(): {
-        isHealthy: boolean;
-        issues: string[];
-        recommendations: string[];
-    };
-}
-
-/**
- * MIME 类型工具函数
- */
-/**
- * 根据文件名获取 MIME 类型
- *
- * @param filename 文件名
- * @returns MIME 类型
- *
- * @example
- * ```typescript
- * getMimeType('photo.jpg')    // 'image/jpeg'
- * getMimeType('video.mp4')    // 'video/mp4'
- * getMimeType('unknown.xyz')  // 'application/octet-stream'
- * ```
- */
-declare function getMimeType(filename: string): string;
-
-/**
- * 通用文件服务缓存管理器
- * 支持多层缓存策略：内存缓存 + Redis缓存
- */
-/**
- * 缓存项接口
- */
-interface CacheItem<T = any> {
-    /** 缓存数据 */
-    data: T;
-    /** 创建时间 */
-    createdAt: number;
-    /** 过期时间 */
-    expiresAt: number;
-    /** 访问次数 */
-    accessCount: number;
-    /** 最后访问时间 */
-    lastAccessAt: number;
-}
-/**
- * 缓存统计信息
- */
-interface CacheStats$1 {
-    /** 总请求次数 */
-    totalRequests: number;
-    /** 命中次数 */
-    hits: number;
-    /** 未命中次数 */
-    misses: number;
-    /** 命中率 */
-    hitRate: number;
-    /** 内存缓存大小 */
-    memorySize: number;
-    /** Redis缓存状态 */
-    redisConnected: boolean;
-}
-/**
- * 缓存配置选项
- */
-interface CacheOptions {
-    /** 默认过期时间（秒） */
-    defaultTTL?: number;
-    /** 内存缓存最大条目数 */
-    maxMemoryItems?: number;
-    /** 是否启用Redis缓存 */
-    enableRedis?: boolean;
-    /** Redis连接配置 */
-    redisConfig?: {
-        host: string;
-        port: number;
-        password?: string;
-        db?: number;
-    };
-    /** 缓存键前缀 */
-    keyPrefix?: string;
-}
-/**
- * 缓存管理器
- */
-declare class CacheManager {
-    private memoryCache;
-    private redisClient;
-    private stats;
-    private options;
-    constructor(options?: CacheOptions);
-    /**
-     * 初始化Redis连接
-     */
-    private initRedis;
-    /**
-     * 生成缓存键
-     */
-    private generateKey;
-    /**
-     * 获取缓存数据
-     */
-    get<T = any>(key: string): Promise<T | null>;
-    /**
-     * 设置缓存数据
-     */
-    set<T = any>(key: string, data: T, ttl?: number): Promise<void>;
-    /**
-     * 删除缓存数据
-     */
-    delete(key: string): Promise<void>;
-    /**
-     * 批量删除缓存（支持模式匹配）
-     */
-    deletePattern(pattern: string): Promise<void>;
-    /**
-     * 清空所有缓存
-     */
-    clear(): Promise<void>;
-    /**
-     * 获取缓存统计信息
-     */
-    getStats(): CacheStats$1;
-    /**
-     * 获取缓存项详情（用于调试）
-     */
-    getCacheItem(key: string): CacheItem | null;
-    /**
-     * 预热缓存
-     */
-    warmup<T>(items: Array<{
-        key: string;
-        data: T;
-        ttl?: number;
-    }>): Promise<void>;
-    /**
-     * 更新命中率
-     */
-    private updateHitRate;
-    /**
-     * 更新内存使用量
-     */
-    private updateMemorySize;
-    /**
-     * 模式匹配函数
-     */
-    private matchPattern;
-    /**
-     * 获取或设置缓存（如果不存在则调用生成函数）
-     */
-    getOrSet<T>(key: string, generator: () => Promise<T>, ttl?: number): Promise<T>;
-    /**
-     * 关闭缓存管理器
-     */
-    close(): Promise<void>;
-}
-
-/**
- * 通用文件服务性能监控器
- * 监控API响应时间、数据库查询性能、缓存命中率等指标
- */
-/**
- * 性能指标类型
- */
-interface PerformanceMetric {
-    /** 指标名称 */
-    name: string;
-    /** 指标值 */
-    value: number;
-    /** 单位 */
-    unit: string;
-    /** 时间戳 */
-    timestamp: number;
-    /** 标签 */
-    labels?: Record<string, string>;
-}
-/**
- * 性能统计信息
- */
-interface PerformanceStats {
-    /** API响应时间统计 */
-    apiResponseTimes: {
-        /** 平均响应时间（毫秒） */
-        average: number;
-        /** 最小响应时间 */
-        min: number;
-        /** 最大响应时间 */
-        max: number;
-        /** P95响应时间 */
-        p95: number;
-        /** P99响应时间 */
-        p99: number;
-        /** 总请求数 */
-        totalRequests: number;
-    };
-    /** 数据库查询性能 */
-    databasePerformance: {
-        /** 平均查询时间（毫秒） */
-        averageQueryTime: number;
-        /** 慢查询数量 */
-        slowQueries: number;
-        /** 总查询数 */
-        totalQueries: number;
-        /** 查询错误数 */
-        queryErrors: number;
-    };
-    /** 文件操作性能 */
-    fileOperations: {
-        /** 文件上传统计 */
-        uploads: {
-            /** 总上传数 */
-            total: number;
-            /** 成功上传数 */
-            successful: number;
-            /** 失败上传数 */
-            failed: number;
-            /** 平均上传时间 */
-            averageTime: number;
-            /** 平均文件大小 */
-            averageSize: number;
-        };
-        /** 文件下载统计 */
-        downloads: {
-            /** 总下载数 */
-            total: number;
-            /** 成功下载数 */
-            successful: number;
-            /** 失败下载数 */
-            failed: number;
-            /** 平均下载时间 */
-            averageTime: number;
-        };
-    };
-    /** 系统资源使用 */
-    systemResources: {
-        /** 内存使用量（MB） */
-        memoryUsage: number;
-        /** CPU使用率（%） */
-        cpuUsage: number;
-        /** 磁盘使用量（MB） */
-        diskUsage: number;
-    };
-}
-/**
- * 请求跟踪信息
- */
-interface RequestTrace {
-    /** 请求ID */
-    requestId: string;
-    /** 请求路径 */
-    path: string;
-    /** HTTP方法 */
-    method: string;
-    /** 开始时间 */
-    startTime: number;
-    /** 结束时间 */
-    endTime?: number;
-    /** 响应时间（毫秒） */
-    duration?: number;
-    /** 状态码 */
-    statusCode?: number;
-    /** 错误信息 */
-    error?: string;
-    /** 用户ID */
-    userId?: string;
-    /** 文件大小（字节） */
-    fileSize?: number;
-}
-/**
- * 性能监控器
- */
-declare class PerformanceMonitor {
-    private metrics;
-    private requestTraces;
-    private stats;
-    private readonly maxMetrics;
-    private readonly maxTraces;
-    constructor();
-    /**
-     * 初始化统计信息
-     */
-    private initializeStats;
-    /**
-     * 开始请求跟踪
-     */
-    startRequest(requestId: string, path: string, method: string, userId?: string): void;
-    /**
-     * 结束请求跟踪
-     */
-    endRequest(requestId: string, statusCode: number, error?: string, fileSize?: number): void;
-    /**
-     * 记录数据库查询性能
-     */
-    recordDatabaseQuery(queryTime: number, isError?: boolean): void;
-    /**
-     * 记录系统资源使用情况
-     */
-    recordSystemResources(): void;
-    /**
-     * 记录自定义指标
-     */
-    recordMetric(name: string, value: number, unit: string, labels?: Record<string, string>): void;
-    /**
-     * 获取性能统计信息
-     */
-    getStats(): PerformanceStats;
-    /**
-     * 获取指定时间范围内的指标
-     */
-    getMetrics(name?: string, startTime?: number, endTime?: number): PerformanceMetric[];
-    /**
-     * 获取请求跟踪信息
-     */
-    getRequestTraces(limit?: number): RequestTrace[];
-    /**
-     * 获取慢请求列表
-     */
-    getSlowRequests(threshold?: number): RequestTrace[];
-    /**
-     * 获取错误请求列表
-     */
-    getErrorRequests(): RequestTrace[];
-    /**
-     * 生成性能报告
-     */
-    generateReport(): {
-        summary: any;
-        topSlowRequests: RequestTrace[];
-        recentErrors: RequestTrace[];
-        systemHealth: any;
-    };
-    /**
-     * 更新API统计信息
-     */
-    private updateApiStats;
-    /**
-     * 更新上传统计信息
-     */
-    private updateUploadStats;
-    /**
-     * 更新下载统计信息
-     */
-    private updateDownloadStats;
-    /**
-     * 清理过期数据
-     */
-    private cleanupOldData;
-    /**
-     * 重置统计信息
-     */
-    reset(): void;
-}
-
-/**
- * CDN缓存策略管理
- * 优化静态资源缓存策略和预热机制
- */
-/**
- * 缓存策略类型
- */
-declare enum CacheStrategyType {
-    /** 图片资源 */
-    IMAGE = "image",
-    /** 视频资源 */
-    VIDEO = "video",
-    /** 音频资源 */
-    AUDIO = "audio",
-    /** 文档资源 */
-    DOCUMENT = "document",
-    /** 压缩包 */
-    ARCHIVE = "archive",
-    /** 静态资源 */
-    STATIC = "static",
-    /** 其他 */
-    OTHER = "other"
-}
-/**
- * 缓存策略配置
- */
-interface CacheStrategyConfig {
-    /** 缓存策略类型 */
-    type: CacheStrategyType;
-    /** 缓存时间（秒） */
-    ttl: number;
-    /** 是否启用浏览器缓存 */
-    browserCache: boolean;
-    /** 浏览器缓存时间（秒） */
-    browserCacheTtl: number;
-    /** 是否启用CDN缓存 */
-    cdnCache: boolean;
-    /** CDN缓存时间（秒） */
-    cdnCacheTtl: number;
-    /** 是否启用预热 */
-    enableWarmup: boolean;
-    /** 缓存控制头 */
-    cacheControl: string;
-    /** 允许的文件类型 */
-    allowedMimeTypes: string[];
-    /** 文件大小限制（字节） */
-    maxFileSize?: number;
-}
-/**
- * 缓存统计信息
- */
-interface CacheStats {
-    /** 命中次数 */
-    hits: number;
-    /** 未命中次数 */
-    misses: number;
-    /** 命中率 */
-    hitRate: number;
-    /** 总请求数 */
-    totalRequests: number;
-    /** 缓存大小估算 */
-    estimatedSize: number;
-    /** 节省的带宽（字节） */
-    bandwidthSaved: number;
-}
-/**
- * CDN缓存策略管理器
- */
-declare class CdnCacheStrategy {
-    private strategies;
-    private stats;
-    constructor();
-    /**
-     * 初始化默认缓存策略
-     */
-    private initializeDefaultStrategies;
-    /**
-     * 根据MIME类型获取缓存策略
-     */
-    getStrategyByMimeType(mimeType: string): CacheStrategyConfig;
-    /**
-     * 生成缓存控制头
-     */
-    generateCacheHeaders(mimeType: string, fileSize?: number): Record<string, string>;
-    /**
-     * 检查是否需要缓存预热
-     */
-    shouldWarmupCache(mimeType: string): boolean;
-    /**
-     * 记录缓存命中
-     */
-    recordCacheHit(mimeType: string, fileSize?: number): void;
-    /**
-     * 记录缓存未命中
-     */
-    recordCacheMiss(mimeType: string, fileSize?: number): void;
-    /**
-     * 获取缓存统计信息
-     */
-    getCacheStats(): Map<CacheStrategyType, CacheStats>;
-    /**
-     * 获取总体缓存统计
-     */
-    getOverallStats(): CacheStats;
-    /**
-     * 生成缓存优化建议
-     */
-    generateOptimizationSuggestions(): Array<{
-        type: CacheStrategyType;
-        issue: string;
-        suggestion: string;
-        severity: 'low' | 'medium' | 'high';
-    }>;
-    /**
-     * 更新缓存策略
-     */
-    updateStrategy(type: CacheStrategyType, config: Partial<CacheStrategyConfig>): void;
-    /**
-     * 重置统计信息
-     */
-    resetStats(): void;
-}
-
-/**
- * 通用文件服务 API 类型定义
- * 定义所有API接口的请求和响应格式
- */
-/**
- * API响应的基础接口
- */
-interface ApiResponse<T = any> {
-    /** 是否成功 */
-    success: boolean;
-    /** 响应数据 */
-    data?: T;
-    /** 错误信息 */
-    error?: {
-        /** 错误代码 */
-        code: string;
-        /** 错误消息 */
-        message: string;
-        /** 详细错误信息 */
-        details?: any;
-    };
-    /** 元数据 */
-    meta?: {
-        /** 总记录数 */
-        total?: number;
-        /** 当前页码 */
-        page?: number;
-        /** 每页大小 */
-        pageSize?: number;
-        /** 总页数 */
-        totalPages?: number;
-        /** 请求ID */
-        requestId?: string;
-        /** 时间戳 */
-        timestamp?: string;
-    };
-}
-/**
- * 分页查询参数
- */
-interface PaginationParams {
-    /** 页码，从1开始 */
-    page?: number;
-    /** 每页大小 */
-    pageSize?: number;
-    /** 排序字段 */
-    orderBy?: string;
-    /** 排序方向 */
-    orderDirection?: 'asc' | 'desc';
-}
-/**
- * 文件上传响应
- */
-interface UploadResponse {
-    /** 文件ID */
-    fileId: string;
-    /** 原始文件名 */
-    originalName: string;
-    /** 文件大小 */
-    size: number;
-    /** MIME类型 */
-    mimeType: string;
-    /** 访问URL */
-    url: string;
-    /** CDN URL */
-    cdnUrl?: string;
-    /** MD5哈希 */
-    md5Hash: string;
-    /** 上传时间 */
-    uploadTime: string;
-}
-/**
- * 文件上传请求参数
- */
-interface FileUploadParams {
-    /** 目标文件夹ID */
-    folderId?: string;
-    /** 模块ID */
-    moduleId?: string;
-    /** 业务ID */
-    businessId?: string;
-    /** 文件标签 */
-    tags?: string[];
-    /** 是否为临时文件 */
-    isTemporary?: boolean;
-    /** 过期时间 */
-    expiresAt?: string;
-    /** 自定义元数据 */
-    metadata?: Record<string, any>;
-}
-/**
- * 文件查询参数
- */
-interface FileQueryParams extends PaginationParams {
-    /** 模块ID */
-    moduleId?: string;
-    /** 业务ID */
-    businessId?: string;
-    /** 文件夹ID */
-    folderId?: string;
-    /** MIME类型过滤 */
-    mimeType?: string;
-    /** 文件名搜索 */
-    search?: string;
-    /** 标签过滤 */
-    tags?: string[];
-    /** 文件大小范围 */
-    sizeMin?: number;
-    sizeMax?: number;
-    /** 上传时间范围 */
-    uploadTimeStart?: string;
-    uploadTimeEnd?: string;
-    /** 是否已删除 */
-    isDeleted?: boolean;
-    /** 是否临时文件 */
-    isTemporary?: boolean;
-    /** 上传者ID */
-    uploaderId?: string;
-}
-/**
- * 文件信息响应
- */
-interface FileInfo {
-    /** 文件ID */
-    id: string;
-    /** 原始文件名 */
-    originalName: string;
-    /** 存储文件名 */
-    storedName: string;
-    /** 文件扩展名 */
-    extension?: string;
-    /** MIME类型 */
-    mimeType: string;
-    /** 文件大小 */
-    size: number;
-    /** MD5哈希 */
-    md5Hash: string;
-    /** SHA256哈希 */
-    sha256Hash?: string;
-    /** 存储路径 */
-    storagePath: string;
-    /** CDN访问URL */
-    cdnUrl?: string;
-    /** 所属文件夹ID */
-    folderId?: string;
-    /** 模块ID */
-    moduleId?: string;
-    /** 业务ID */
-    businessId?: string;
-    /** 文件标签 */
-    tags?: string[];
-    /** 文件元信息 */
-    metadata?: Record<string, any>;
-    /** 是否为临时文件 */
-    isTemporary: boolean;
-    /** 是否已删除 */
-    isDeleted: boolean;
-    /** 访问次数 */
-    accessCount: number;
-    /** 下载次数 */
-    downloadCount: number;
-    /** 上传者ID */
-    uploaderId: string;
-    /** 上传时间 */
-    uploadTime: string;
-    /** 最后访问时间 */
-    lastAccessTime?: string;
-    /** 过期时间 */
-    expiresAt?: string;
-    /** 创建时间 */
-    createdAt: string;
-    /** 更新时间 */
-    updatedAt: string;
-}
-/**
- * 文件列表响应
- */
-interface FileListResponse {
-    /** 文件列表 */
-    files: FileInfo[];
-    /** 分页信息 */
-    pagination: {
-        /** 总记录数 */
-        total: number;
-        /** 当前页码 */
-        page: number;
-        /** 每页大小 */
-        pageSize: number;
-        /** 总页数 */
-        totalPages: number;
-    };
-}
-/**
- * 文件更新参数
- */
-interface FileUpdateParams {
-    /** 新的文件名 */
-    originalName?: string;
-    /** 文件夹ID */
-    folderId?: string;
-    /** 文件标签 */
-    tags?: string[];
-    /** 自定义元数据 */
-    metadata?: Record<string, any>;
-    /** 过期时间 */
-    expiresAt?: string;
-}
-/**
- * 文件夹创建参数
- */
-interface FolderCreateParams {
-    /** 文件夹名称 */
-    name: string;
-    /** 父文件夹ID */
-    parentId?: string;
-    /** 模块ID */
-    moduleId?: string;
-    /** 业务ID */
-    businessId?: string;
-    /** 文件夹描述 */
-    description?: string;
-    /** 显示顺序 */
-    sortOrder?: number;
-}
-/**
- * 文件夹信息响应
- */
-interface FolderInfo {
-    /** 文件夹ID */
-    id: string;
-    /** 文件夹名称 */
-    name: string;
-    /** 父文件夹ID */
-    parentId?: string;
-    /** 模块ID */
-    moduleId?: string;
-    /** 业务ID */
-    businessId?: string;
-    /** 文件夹路径 */
-    path: string;
-    /** 层级深度 */
-    depth: number;
-    /** 显示顺序 */
-    sortOrder: number;
-    /** 文件夹描述 */
-    description?: string;
-    /** 是否为系统文件夹 */
-    isSystem: boolean;
-    /** 创建者ID */
-    createdBy: string;
-    /** 创建时间 */
-    createdAt: string;
-    /** 更新时间 */
-    updatedAt: string;
-    /** 子文件夹列表 */
-    children?: FolderInfo[];
-    /** 文件数量 */
-    fileCount?: number;
-}
-/**
- * 文件夹更新参数
- */
-interface FolderUpdateParams {
-    /** 文件夹名称 */
-    name?: string;
-    /** 父文件夹ID */
-    parentId?: string;
-    /** 文件夹描述 */
-    description?: string;
-    /** 显示顺序 */
-    sortOrder?: number;
-}
-/**
- * 文件处理请求参数
- */
-interface FileProcessParams {
-    /** 处理类型 */
-    type: 'compress' | 'resize' | 'convert' | 'thumbnail' | 'watermark';
-    /** 处理参数 */
-    parameters: Record<string, any>;
-    /** 优先级 */
-    priority?: number;
-}
-/**
- * 文件处理状态响应
- */
-interface ProcessingStatus {
-    /** 处理记录ID */
-    id: string;
-    /** 文件ID */
-    fileId: string;
-    /** 处理类型 */
-    type: string;
-    /** 处理状态 */
-    status: 'pending' | 'processing' | 'completed' | 'failed';
-    /** 处理进度 */
-    progress?: number;
-    /** 处理参数 */
-    parameters?: Record<string, any>;
-    /** 处理结果 */
-    result?: Record<string, any>;
-    /** 输出文件路径 */
-    outputPath?: string;
-    /** 错误信息 */
-    errorMessage?: string;
-    /** 开始时间 */
-    startedAt?: string;
-    /** 完成时间 */
-    completedAt?: string;
-    /** 创建时间 */
-    createdAt: string;
-}
-/**
- * 文件分享创建参数
- */
-interface ShareCreateParams {
-    /** 分享的文件ID列表 */
-    fileIds: string[];
-    /** 分享标题 */
-    title?: string;
-    /** 分享描述 */
-    description?: string;
-    /** 访问密码 */
-    password?: string;
-    /** 访问权限 */
-    permission?: 'view' | 'download';
-    /** 最大下载次数 */
-    maxDownloads?: number;
-    /** 最大访问次数 */
-    maxAccess?: number;
-    /** 过期时间 */
-    expiresAt?: string;
-}
-/**
- * 文件分享信息响应
- */
-interface ShareInfo {
-    /** 分享ID */
-    id: string;
-    /** 分享代码 */
-    shareCode: string;
-    /** 分享的文件ID列表 */
-    fileIds: string[];
-    /** 分享标题 */
-    title?: string;
-    /** 分享描述 */
-    description?: string;
-    /** 是否有密码保护 */
-    hasPassword: boolean;
-    /** 访问权限 */
-    permission: 'view' | 'download';
-    /** 最大下载次数 */
-    maxDownloads?: number;
-    /** 当前下载次数 */
-    downloadCount: number;
-    /** 最大访问次数 */
-    maxAccess?: number;
-    /** 当前访问次数 */
-    accessCount: number;
-    /** 是否启用 */
-    isActive: boolean;
-    /** 过期时间 */
-    expiresAt?: string;
-    /** 创建者ID */
-    createdBy: string;
-    /** 创建时间 */
-    createdAt: string;
-    /** 分享链接 */
-    shareUrl: string;
-}
-/**
- * 分享访问验证参数
- */
-interface ShareAccessParams {
-    /** 分享代码 */
-    shareCode: string;
-    /** 访问密码 */
-    password?: string;
-}
-/**
- * 文件统计信息响应
- */
-interface FileStats {
-    /** 总文件数 */
-    totalFiles: number;
-    /** 总文件大小 */
-    totalSize: number;
-    /** 按类型统计 */
-    byType: Array<{
-        /** MIME类型 */
-        mimeType: string;
-        /** 文件数量 */
-        count: number;
-        /** 总大小 */
-        totalSize: number;
-    }>;
-    /** 按日期统计（最近30天） */
-    byDate: Array<{
-        /** 日期 */
-        date: string;
-        /** 上传数量 */
-        count: number;
-        /** 总大小 */
-        totalSize: number;
-    }>;
-    /** 按模块统计 */
-    byModule: Array<{
-        /** 模块ID */
-        moduleId: string;
-        /** 文件数量 */
-        count: number;
-        /** 总大小 */
-        totalSize: number;
-    }>;
-}
-/**
- * API错误代码枚举
- */
-declare enum ApiErrorCode {
-    UNKNOWN_ERROR = "UNKNOWN_ERROR",
-    VALIDATION_ERROR = "VALIDATION_ERROR",
-    AUTHENTICATION_ERROR = "AUTHENTICATION_ERROR",
-    AUTHORIZATION_ERROR = "AUTHORIZATION_ERROR",
-    NOT_FOUND = "NOT_FOUND",
-    CONFLICT = "CONFLICT",
-    RATE_LIMIT_EXCEEDED = "RATE_LIMIT_EXCEEDED",
-    FILE_NOT_FOUND = "FILE_NOT_FOUND",
-    FILE_TOO_LARGE = "FILE_TOO_LARGE",
-    FILE_TYPE_NOT_SUPPORTED = "FILE_TYPE_NOT_SUPPORTED",
-    FILE_UPLOAD_FAILED = "FILE_UPLOAD_FAILED",
-    FILE_PROCESSING_FAILED = "FILE_PROCESSING_FAILED",
-    FILE_ALREADY_EXISTS = "FILE_ALREADY_EXISTS",
-    FILE_CORRUPTED = "FILE_CORRUPTED",
-    FOLDER_NOT_FOUND = "FOLDER_NOT_FOUND",
-    FOLDER_NOT_EMPTY = "FOLDER_NOT_EMPTY",
-    FOLDER_NAME_CONFLICT = "FOLDER_NAME_CONFLICT",
-    FOLDER_DEPTH_EXCEEDED = "FOLDER_DEPTH_EXCEEDED",
-    STORAGE_PROVIDER_ERROR = "STORAGE_PROVIDER_ERROR",
-    STORAGE_QUOTA_EXCEEDED = "STORAGE_QUOTA_EXCEEDED",
-    STORAGE_UNAVAILABLE = "STORAGE_UNAVAILABLE",
-    SHARE_NOT_FOUND = "SHARE_NOT_FOUND",
-    SHARE_EXPIRED = "SHARE_EXPIRED",
-    SHARE_PASSWORD_INCORRECT = "SHARE_PASSWORD_INCORRECT",
-    SHARE_ACCESS_DENIED = "SHARE_ACCESS_DENIED",
-    SHARE_DOWNLOAD_LIMIT_EXCEEDED = "SHARE_DOWNLOAD_LIMIT_EXCEEDED"
-}
-/**
- * 错误消息映射
- */
-declare const ErrorMessages: Record<ApiErrorCode, string>;
-/**
- * 错误代码到HTTP状态码的映射
- */
-declare const ErrorHttpStatusMap: Record<ApiErrorCode, number>;
-
-/**
- * API错误处理工具类
- * 提供标准化的错误处理和响应格式
- */
-
-/**
- * API错误类
- * 继承自Error，添加错误代码和详细信息
- */
-declare class ApiError extends Error {
-    readonly code: ApiErrorCode;
-    readonly statusCode: number;
-    readonly details?: any;
-    constructor(code: ApiErrorCode, message?: string, details?: any, statusCode?: number);
-    /**
-     * 转换为API响应格式
-     */
-    toApiResponse(): ApiResponse;
-    /**
-     * 转换为NextResponse
-     */
-    toNextResponse(): NextResponse;
-}
-
-/**
- * Drizzle ORM 文件元数据持久化适配器
- *
- * 提供基于 Drizzle ORM 的数据库持久化实现
- */
-
-/**
- * Drizzle 表定义类型（兼容多种 Drizzle 表结构）
- */
-type DrizzleTable = any;
-/**
- * Drizzle 数据库连接类型
- */
-type DrizzleDb = any;
-/**
- * 字段映射配置
- *
- * 将 FileMetadata 的字段映射到数据库表的列名
- */
-interface FieldMapping {
-    id?: string;
-    filename?: string;
-    originalName?: string;
-    mimeType?: string;
-    size?: string;
-    hash?: string;
-    storageType?: string;
-    storagePath?: string;
-    url?: string;
-    cdnUrl?: string;
-    moduleId?: string;
-    businessId?: string;
-    userId?: string;
-    uploadedAt?: string;
-    expiresAt?: string;
-    metadata?: string;
-    status?: string;
-    processingStatus?: string;
-    versions?: string;
-    tags?: string;
-}
-/**
- * Drizzle 仓储配置
- */
-interface DrizzleRepositoryConfig {
-    /** Drizzle 数据库实例 */
-    db: DrizzleDb;
-    /** 文件元数据表 */
-    table: DrizzleTable;
-    /** 字段映射（如果数据库列名与 FileMetadata 字段不同） */
-    fieldMapping?: FieldMapping;
-}
-/**
- * 创建 Drizzle ORM 文件仓储
- *
- * @example
- * ```typescript
- * import { createDrizzleRepository } from '@qhr123/sa2kit/universalFile/server';
- * import { db } from './db';
- * import { fileMetadata } from './schema';
- *
- * const repository = createDrizzleRepository({
- *   db,
- *   table: fileMetadata,
- *   fieldMapping: {
- *     // 如果列名与 FileMetadata 字段不同，可以在这里映射
- *     originalName: 'original_filename',
- *   }
- * });
- * ```
- */
-declare function createDrizzleRepository(config: DrizzleRepositoryConfig): IFileMetadataRepository;
-
-/**
- * 文件服务配置加载辅助工具
- *
- * 提供从环境变量加载配置、默认配置常量等通用功能
- */
-
-/**
- * 默认文件大小限制（字节）
- */
-declare const DEFAULT_MAX_FILE_SIZE = 104857600;
-/**
- * 默认允许的 MIME 类型
- */
-declare const DEFAULT_ALLOWED_MIME_TYPES: string[];
-/**
- * 默认缓存配置
- */
-declare const DEFAULT_CACHE_CONFIG: {
-    enabled: boolean;
-    metadataTTL: number;
-    urlTTL: number;
-};
-/**
- * 默认文件服务配置
- */
-declare const DEFAULT_FILE_SERVICE_CONFIG: {
-    readonly maxFileSize: 104857600;
-    readonly allowedMimeTypes: string[];
-    readonly cache: {
-        enabled: boolean;
-        metadataTTL: number;
-        urlTTL: number;
-    };
-    readonly enableMonitoring: false;
-};
-/**
- * 从环境变量加载阿里云 OSS 配置
- *
- * 支持的环境变量：
- * - ALIYUN_OSS_REGION
- * - ALIYUN_OSS_BUCKET
- * - ALIYUN_OSS_ACCESS_KEY_ID
- * - ALIYUN_OSS_ACCESS_KEY_SECRET
- * - ALIYUN_OSS_CUSTOM_DOMAIN (可选)
- * - ALIYUN_OSS_SECURE (可选，默认 false)
- * - ALIYUN_OSS_INTERNAL (可选，默认 false)
- */
-declare function loadOSSConfigFromEnv(): AliyunOSSConfig | null;
-/**
- * 从环境变量加载阿里云 CDN 配置
- *
- * 支持的环境变量：
- * - ALIYUN_CDN_DOMAIN
- * - ALIYUN_CDN_ACCESS_KEY_ID
- * - ALIYUN_CDN_ACCESS_KEY_SECRET
- * - ALIYUN_CDN_REGION (可选)
- */
-declare function loadCDNConfigFromEnv(): AliyunCDNConfig | null;
-/**
- * 获取默认本地存储配置
- *
- * 支持的环境变量：
- * - FILE_STORAGE_PATH (可选，默认 'uploads')
- * - FILE_BASE_URL (可选，默认 '/uploads')
- */
-declare function getDefaultLocalStorage(): LocalStorageConfig;
-/**
- * 从环境变量加载完整的文件服务配置
- *
- * 配置优先级：
- * 1. 阿里云 OSS（如果配置完整）
- * 2. 本地存储（备用方案）
- *
- * 支持的环境变量：
- * - MAX_FILE_SIZE (可选，默认 100MB)
- * - ENABLE_CACHE (可选，默认 false)
- * - METADATA_CACHE_TTL (可选，默认 3600秒)
- * - URL_CACHE_TTL (可选，默认 1800秒)
- * - ENABLE_FILE_MONITORING (可选，默认 false)
- */
-declare function loadConfigFromEnv(): Partial<UniversalFileServiceConfig>;
-/**
- * 配置服务接口
- *
- * 用于从配置管理系统加载配置
- */
-interface IConfigService {
-    /**
-     * 获取配置值
-     */
-    getConfig(key: string, defaultValue?: any): Promise<any>;
-}
-/**
- * 配置键映射
- */
-interface OSSConfigKeyMapping {
-    region: string;
-    bucket: string;
-    accessKeyId: string;
-    accessKeySecret: string;
-    customDomain?: string;
-    secure?: string;
-    internal?: string;
-}
-/**
- * 默认的 OSS 配置键映射（阿里云标准）
- */
-declare const DEFAULT_OSS_CONFIG_KEYS: OSSConfigKeyMapping;
-/**
- * 从配置服务加载 OSS 配置
- *
- * 通用函数，可用于任何实现了 IConfigService 接口的配置系统
- *
- * @param configService - 配置服务实例
- * @param keyMapping - 配置键映射（可选，默认使用标准键名）
- *
- * @example
- * ```typescript
- * import { loadOSSConfigFromService } from 'sa2kit/universalFile/server';
- *
- * const config = await loadOSSConfigFromService(myConfigService, {
- *   region: 'oss_region',
- *   bucket: 'oss_bucket',
- *   // ...
- * });
- * ```
- */
-declare function loadOSSConfigFromService(configService: IConfigService, keyMapping?: Partial<OSSConfigKeyMapping>): Promise<AliyunOSSConfig | null>;
-/**
- * 组合多个配置源
- *
- * 按优先级顺序尝试加载配置，返回第一个成功的配置
- *
- * @param loaders - 配置加载器数组（按优先级排序）
- *
- * @example
- * ```typescript
- * const config = await loadConfigWithFallback([
- *   async () => loadOSSConfigFromService(configService),
- *   () => loadOSSConfigFromEnv(),
- * ]);
- * ```
- */
-declare function loadConfigWithFallback<T>(loaders: Array<() => Promise<T | null>>): Promise<T | null>;
-/**
- * 文件服务工厂选项
- */
-interface FileServiceFactoryOptions {
-    /**
-     * 配置加载器（按优先级排序）
-     */
-    configLoaders?: Array<() => Promise<Partial<UniversalFileServiceConfig> | null>>;
-    /**
-     * 持久化仓储（可选）
-     */
-    repository?: any;
-    /**
-     * 自定义配置（会覆盖加载的配置）
-     */
-    customConfig?: Partial<UniversalFileServiceConfig>;
-    /**
-     * 是否自动初始化服务
-     */
-    autoInitialize?: boolean;
-}
-/**
- * 创建文件服务（工厂函数）
- *
- * 通用的服务创建函数，支持多种配置源和可选的持久化
- *
- * @param options - 工厂选项
- *
- * @example
- * ```typescript
- * import {
- *   createFileServiceWithFactory,
- *   loadOSSConfigFromService,
- *   loadConfigFromEnv
- * } from 'sa2kit/universalFile/server';
- *
- * const service = await createFileServiceWithFactory({
- *   configLoaders: [
- *     async () => {
- *       const ossConfig = await loadOSSConfigFromService(configService);
- *       return ossConfig ? { storage: ossConfig, defaultStorage: 'aliyun-oss' } : null;
- *     },
- *     () => Promise.resolve(loadConfigFromEnv()),
- *   ],
- *   repository: myRepository,
- *   autoInitialize: true,
- * });
- * ```
- */
-declare function createFileServiceWithFactory(options?: FileServiceFactoryOptions): Promise<UniversalFileService>;
-/**
- * 单例工厂返回值
- */
-interface SingletonFactory<T> {
-    /**
-     * 获取单例实例
-     */
-    get(): Promise<T>;
-    /**
-     * 重置单例（主要用于测试）
-     */
-    reset(): void;
-    /**
-     * 检查单例是否已创建
-     */
-    isCreated(): boolean;
-}
-/**
- * 创建单例工厂
- *
- * 提供单例模式的通用实现，适用于需要单例的服务
- *
- * @param factory - 创建实例的工厂函数
- * @param options - 单例选项
- *
- * @example
- * ```typescript
- * const fileServiceSingleton = createSingleton(
- *   async () => {
- *     const service = new UniversalFileService(config);
- *     await service.initialize();
- *     return service;
- *   },
- *   { autoInitialize: true }
- * );
- *
- * // 获取单例
- * const service = await fileServiceSingleton.get();
- *
- * // 重置（测试用）
- * fileServiceSingleton.reset();
- * ```
- */
-declare function createSingleton<T>(factory: () => Promise<T>, options?: {
-    /** 是否在第一次获取时自动初始化（默认 true） */
-    autoInitialize?: boolean;
-    /** 单例名称（用于日志） */
-    name?: string;
-}): SingletonFactory<T>;
-
-/**
- * 通用文件服务 - PostgreSQL 数据库表结构定义
- *
- * 这个文件定义了通用文件服务的完整数据库表结构，使用Drizzle ORM框架。
- * 支持多模块文件管理、版本控制、分享功能、处理记录等。
- *
- * 表结构概览：
- * - file_storage_providers: 存储提供者配置表
- * - file_folders: 文件夹表（支持层级结构）
- * - file_metadata: 文件元数据主表
- * - file_versions: 文件版本表
- * - file_processing_records: 文件处理记录表
- * - file_shares: 文件分享表
- * - file_access_logs: 文件访问日志表
- * - file_thumbnails: 文件缩略图表
- *
- * 设计特点：
- * - 支持多存储提供者（本地、OSS、CDN等）
- * - 完整的文件版本管理
- * - 灵活的文件夹层级结构
- * - 详细的访问日志和统计
- * - 文件处理流水线记录
- * - 安全的分享机制
- *
- * @fileoverview 数据库表结构 - 通用文件服务 (PostgreSQL)
- * @package sa2kit/universalFile/server
- */
-/**
- * 存储提供者配置表 (file_storage_providers)
- *
- * 管理不同的文件存储提供者配置，支持本地存储、云存储等多种方式。
- * 每个提供者有独立的配置和优先级设置。
- */
-declare const fileStorageProviders: drizzle_orm_pg_core.PgTableWithColumns<{
-    name: "file_storage_providers";
-    schema: undefined;
-    columns: {
-        id: drizzle_orm_pg_core.PgColumn<{
-            name: "id";
-            tableName: "file_storage_providers";
-            dataType: "number";
-            columnType: "PgSerial";
-            data: number;
-            driverParam: number;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: true;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        name: drizzle_orm_pg_core.PgColumn<{
-            name: "name";
-            tableName: "file_storage_providers";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 100;
-        }>;
-        type: drizzle_orm_pg_core.PgColumn<{
-            name: "type";
-            tableName: "file_storage_providers";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 50;
-        }>;
-        config: drizzle_orm_pg_core.PgColumn<{
-            name: "config";
-            tableName: "file_storage_providers";
-            dataType: "json";
-            columnType: "PgJson";
-            data: unknown;
-            driverParam: unknown;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        isActive: drizzle_orm_pg_core.PgColumn<{
-            name: "is_active";
-            tableName: "file_storage_providers";
-            dataType: "boolean";
-            columnType: "PgBoolean";
-            data: boolean;
-            driverParam: boolean;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        isDefault: drizzle_orm_pg_core.PgColumn<{
-            name: "is_default";
-            tableName: "file_storage_providers";
-            dataType: "boolean";
-            columnType: "PgBoolean";
-            data: boolean;
-            driverParam: boolean;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        priority: drizzle_orm_pg_core.PgColumn<{
-            name: "priority";
-            tableName: "file_storage_providers";
-            dataType: "number";
-            columnType: "PgInteger";
-            data: number;
-            driverParam: string | number;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        maxFileSize: drizzle_orm_pg_core.PgColumn<{
-            name: "max_file_size";
-            tableName: "file_storage_providers";
-            dataType: "number";
-            columnType: "PgBigInt53";
-            data: number;
-            driverParam: string | number;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        supportedMimeTypes: drizzle_orm_pg_core.PgColumn<{
-            name: "supported_mime_types";
-            tableName: "file_storage_providers";
-            dataType: "json";
-            columnType: "PgJson";
-            data: unknown;
-            driverParam: unknown;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        createdAt: drizzle_orm_pg_core.PgColumn<{
-            name: "created_at";
-            tableName: "file_storage_providers";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        updatedAt: drizzle_orm_pg_core.PgColumn<{
-            name: "updated_at";
-            tableName: "file_storage_providers";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-    };
-    dialect: "pg";
-}>;
-/**
- * 文件夹表 (file_folders)
- *
- * 支持层级结构的文件夹管理，每个模块可以有独立的文件夹结构。
- */
-declare const fileFolders: drizzle_orm_pg_core.PgTableWithColumns<{
-    name: "file_folders";
-    schema: undefined;
-    columns: {
-        id: drizzle_orm_pg_core.PgColumn<{
-            name: "id";
-            tableName: "file_folders";
-            dataType: "string";
-            columnType: "PgUUID";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: true;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        name: drizzle_orm_pg_core.PgColumn<{
-            name: "name";
-            tableName: "file_folders";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 255;
-        }>;
-        parentId: drizzle_orm_pg_core.PgColumn<{
-            name: "parent_id";
-            tableName: "file_folders";
-            dataType: "string";
-            columnType: "PgUUID";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        moduleId: drizzle_orm_pg_core.PgColumn<{
-            name: "module_id";
-            tableName: "file_folders";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 100;
-        }>;
-        businessId: drizzle_orm_pg_core.PgColumn<{
-            name: "business_id";
-            tableName: "file_folders";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 255;
-        }>;
-        path: drizzle_orm_pg_core.PgColumn<{
-            name: "path";
-            tableName: "file_folders";
-            dataType: "string";
-            columnType: "PgText";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        depth: drizzle_orm_pg_core.PgColumn<{
-            name: "depth";
-            tableName: "file_folders";
-            dataType: "number";
-            columnType: "PgInteger";
-            data: number;
-            driverParam: string | number;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        sortOrder: drizzle_orm_pg_core.PgColumn<{
-            name: "sort_order";
-            tableName: "file_folders";
-            dataType: "number";
-            columnType: "PgInteger";
-            data: number;
-            driverParam: string | number;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        description: drizzle_orm_pg_core.PgColumn<{
-            name: "description";
-            tableName: "file_folders";
-            dataType: "string";
-            columnType: "PgText";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        isSystem: drizzle_orm_pg_core.PgColumn<{
-            name: "is_system";
-            tableName: "file_folders";
-            dataType: "boolean";
-            columnType: "PgBoolean";
-            data: boolean;
-            driverParam: boolean;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        createdBy: drizzle_orm_pg_core.PgColumn<{
-            name: "created_by";
-            tableName: "file_folders";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 255;
-        }>;
-        createdAt: drizzle_orm_pg_core.PgColumn<{
-            name: "created_at";
-            tableName: "file_folders";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        updatedAt: drizzle_orm_pg_core.PgColumn<{
-            name: "updated_at";
-            tableName: "file_folders";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-    };
-    dialect: "pg";
-}>;
-/**
- * 文件元数据主表 (file_metadata)
- *
- * 存储文件的完整元数据信息，是文件服务的核心表。
- */
-declare const fileMetadata: drizzle_orm_pg_core.PgTableWithColumns<{
-    name: "file_metadata";
-    schema: undefined;
-    columns: {
-        id: drizzle_orm_pg_core.PgColumn<{
-            name: "id";
-            tableName: "file_metadata";
-            dataType: "string";
-            columnType: "PgUUID";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: true;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        originalName: drizzle_orm_pg_core.PgColumn<{
-            name: "original_name";
-            tableName: "file_metadata";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 500;
-        }>;
-        storedName: drizzle_orm_pg_core.PgColumn<{
-            name: "stored_name";
-            tableName: "file_metadata";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 500;
-        }>;
-        extension: drizzle_orm_pg_core.PgColumn<{
-            name: "extension";
-            tableName: "file_metadata";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 20;
-        }>;
-        mimeType: drizzle_orm_pg_core.PgColumn<{
-            name: "mime_type";
-            tableName: "file_metadata";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 100;
-        }>;
-        size: drizzle_orm_pg_core.PgColumn<{
-            name: "size";
-            tableName: "file_metadata";
-            dataType: "number";
-            columnType: "PgBigInt53";
-            data: number;
-            driverParam: string | number;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        md5Hash: drizzle_orm_pg_core.PgColumn<{
-            name: "md5_hash";
-            tableName: "file_metadata";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 32;
-        }>;
-        sha256Hash: drizzle_orm_pg_core.PgColumn<{
-            name: "sha256_hash";
-            tableName: "file_metadata";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 64;
-        }>;
-        storageProviderId: drizzle_orm_pg_core.PgColumn<{
-            name: "storage_provider_id";
-            tableName: "file_metadata";
-            dataType: "number";
-            columnType: "PgInteger";
-            data: number;
-            driverParam: string | number;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        storagePath: drizzle_orm_pg_core.PgColumn<{
-            name: "storage_path";
-            tableName: "file_metadata";
-            dataType: "string";
-            columnType: "PgText";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        cdnUrl: drizzle_orm_pg_core.PgColumn<{
-            name: "cdn_url";
-            tableName: "file_metadata";
-            dataType: "string";
-            columnType: "PgText";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        folderId: drizzle_orm_pg_core.PgColumn<{
-            name: "folder_id";
-            tableName: "file_metadata";
-            dataType: "string";
-            columnType: "PgUUID";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        moduleId: drizzle_orm_pg_core.PgColumn<{
-            name: "module_id";
-            tableName: "file_metadata";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 100;
-        }>;
-        businessId: drizzle_orm_pg_core.PgColumn<{
-            name: "business_id";
-            tableName: "file_metadata";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 255;
-        }>;
-        tags: drizzle_orm_pg_core.PgColumn<{
-            name: "tags";
-            tableName: "file_metadata";
-            dataType: "json";
-            columnType: "PgJson";
-            data: unknown;
-            driverParam: unknown;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        metadata: drizzle_orm_pg_core.PgColumn<{
-            name: "metadata";
-            tableName: "file_metadata";
-            dataType: "json";
-            columnType: "PgJson";
-            data: unknown;
-            driverParam: unknown;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        isTemporary: drizzle_orm_pg_core.PgColumn<{
-            name: "is_temporary";
-            tableName: "file_metadata";
-            dataType: "boolean";
-            columnType: "PgBoolean";
-            data: boolean;
-            driverParam: boolean;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        isDeleted: drizzle_orm_pg_core.PgColumn<{
-            name: "is_deleted";
-            tableName: "file_metadata";
-            dataType: "boolean";
-            columnType: "PgBoolean";
-            data: boolean;
-            driverParam: boolean;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        accessCount: drizzle_orm_pg_core.PgColumn<{
-            name: "access_count";
-            tableName: "file_metadata";
-            dataType: "number";
-            columnType: "PgInteger";
-            data: number;
-            driverParam: string | number;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        downloadCount: drizzle_orm_pg_core.PgColumn<{
-            name: "download_count";
-            tableName: "file_metadata";
-            dataType: "number";
-            columnType: "PgInteger";
-            data: number;
-            driverParam: string | number;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        uploaderId: drizzle_orm_pg_core.PgColumn<{
-            name: "uploader_id";
-            tableName: "file_metadata";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 255;
-        }>;
-        uploadTime: drizzle_orm_pg_core.PgColumn<{
-            name: "upload_time";
-            tableName: "file_metadata";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        lastAccessTime: drizzle_orm_pg_core.PgColumn<{
-            name: "last_access_time";
-            tableName: "file_metadata";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        expiresAt: drizzle_orm_pg_core.PgColumn<{
-            name: "expires_at";
-            tableName: "file_metadata";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        createdAt: drizzle_orm_pg_core.PgColumn<{
-            name: "created_at";
-            tableName: "file_metadata";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        updatedAt: drizzle_orm_pg_core.PgColumn<{
-            name: "updated_at";
-            tableName: "file_metadata";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        deletedAt: drizzle_orm_pg_core.PgColumn<{
-            name: "deleted_at";
-            tableName: "file_metadata";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-    };
-    dialect: "pg";
-}>;
-/**
- * 文件版本表 (file_versions)
- *
- * 支持文件的版本管理，记录文件的历史版本信息。
- */
-declare const fileVersions: drizzle_orm_pg_core.PgTableWithColumns<{
-    name: "file_versions";
-    schema: undefined;
-    columns: {
-        id: drizzle_orm_pg_core.PgColumn<{
-            name: "id";
-            tableName: "file_versions";
-            dataType: "string";
-            columnType: "PgUUID";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: true;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        fileId: drizzle_orm_pg_core.PgColumn<{
-            name: "file_id";
-            tableName: "file_versions";
-            dataType: "string";
-            columnType: "PgUUID";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        version: drizzle_orm_pg_core.PgColumn<{
-            name: "version";
-            tableName: "file_versions";
-            dataType: "number";
-            columnType: "PgInteger";
-            data: number;
-            driverParam: string | number;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        description: drizzle_orm_pg_core.PgColumn<{
-            name: "description";
-            tableName: "file_versions";
-            dataType: "string";
-            columnType: "PgText";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        size: drizzle_orm_pg_core.PgColumn<{
-            name: "size";
-            tableName: "file_versions";
-            dataType: "number";
-            columnType: "PgBigInt53";
-            data: number;
-            driverParam: string | number;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        md5Hash: drizzle_orm_pg_core.PgColumn<{
-            name: "md5_hash";
-            tableName: "file_versions";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 32;
-        }>;
-        storagePath: drizzle_orm_pg_core.PgColumn<{
-            name: "storage_path";
-            tableName: "file_versions";
-            dataType: "string";
-            columnType: "PgText";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        cdnUrl: drizzle_orm_pg_core.PgColumn<{
-            name: "cdn_url";
-            tableName: "file_versions";
-            dataType: "string";
-            columnType: "PgText";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        isCurrent: drizzle_orm_pg_core.PgColumn<{
-            name: "is_current";
-            tableName: "file_versions";
-            dataType: "boolean";
-            columnType: "PgBoolean";
-            data: boolean;
-            driverParam: boolean;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        createdBy: drizzle_orm_pg_core.PgColumn<{
-            name: "created_by";
-            tableName: "file_versions";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 255;
-        }>;
-        createdAt: drizzle_orm_pg_core.PgColumn<{
-            name: "created_at";
-            tableName: "file_versions";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-    };
-    dialect: "pg";
-}>;
-/**
- * 文件处理记录表 (file_processing_records)
- *
- * 记录文件的处理历史，包括压缩、格式转换、缩略图生成等操作。
- */
-declare const fileProcessingRecords: drizzle_orm_pg_core.PgTableWithColumns<{
-    name: "file_processing_records";
-    schema: undefined;
-    columns: {
-        id: drizzle_orm_pg_core.PgColumn<{
-            name: "id";
-            tableName: "file_processing_records";
-            dataType: "string";
-            columnType: "PgUUID";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: true;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        fileId: drizzle_orm_pg_core.PgColumn<{
-            name: "file_id";
-            tableName: "file_processing_records";
-            dataType: "string";
-            columnType: "PgUUID";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        processingType: drizzle_orm_pg_core.PgColumn<{
-            name: "processing_type";
-            tableName: "file_processing_records";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 50;
-        }>;
-        processorName: drizzle_orm_pg_core.PgColumn<{
-            name: "processor_name";
-            tableName: "file_processing_records";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 100;
-        }>;
-        status: drizzle_orm_pg_core.PgColumn<{
-            name: "status";
-            tableName: "file_processing_records";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 20;
-        }>;
-        parameters: drizzle_orm_pg_core.PgColumn<{
-            name: "parameters";
-            tableName: "file_processing_records";
-            dataType: "json";
-            columnType: "PgJson";
-            data: unknown;
-            driverParam: unknown;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        result: drizzle_orm_pg_core.PgColumn<{
-            name: "result";
-            tableName: "file_processing_records";
-            dataType: "json";
-            columnType: "PgJson";
-            data: unknown;
-            driverParam: unknown;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        outputPath: drizzle_orm_pg_core.PgColumn<{
-            name: "output_path";
-            tableName: "file_processing_records";
-            dataType: "string";
-            columnType: "PgText";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        outputSize: drizzle_orm_pg_core.PgColumn<{
-            name: "output_size";
-            tableName: "file_processing_records";
-            dataType: "number";
-            columnType: "PgBigInt53";
-            data: number;
-            driverParam: string | number;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        processingTimeMs: drizzle_orm_pg_core.PgColumn<{
-            name: "processing_time_ms";
-            tableName: "file_processing_records";
-            dataType: "number";
-            columnType: "PgInteger";
-            data: number;
-            driverParam: string | number;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        errorMessage: drizzle_orm_pg_core.PgColumn<{
-            name: "error_message";
-            tableName: "file_processing_records";
-            dataType: "string";
-            columnType: "PgText";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        retryCount: drizzle_orm_pg_core.PgColumn<{
-            name: "retry_count";
-            tableName: "file_processing_records";
-            dataType: "number";
-            columnType: "PgInteger";
-            data: number;
-            driverParam: string | number;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        priority: drizzle_orm_pg_core.PgColumn<{
-            name: "priority";
-            tableName: "file_processing_records";
-            dataType: "number";
-            columnType: "PgInteger";
-            data: number;
-            driverParam: string | number;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        startedAt: drizzle_orm_pg_core.PgColumn<{
-            name: "started_at";
-            tableName: "file_processing_records";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        completedAt: drizzle_orm_pg_core.PgColumn<{
-            name: "completed_at";
-            tableName: "file_processing_records";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        createdAt: drizzle_orm_pg_core.PgColumn<{
-            name: "created_at";
-            tableName: "file_processing_records";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        updatedAt: drizzle_orm_pg_core.PgColumn<{
-            name: "updated_at";
-            tableName: "file_processing_records";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-    };
-    dialect: "pg";
-}>;
-/**
- * 文件分享表 (file_shares)
- *
- * 管理文件的分享功能，支持密码保护、过期时间、访问限制等。
- */
-declare const fileShares: drizzle_orm_pg_core.PgTableWithColumns<{
-    name: "file_shares";
-    schema: undefined;
-    columns: {
-        id: drizzle_orm_pg_core.PgColumn<{
-            name: "id";
-            tableName: "file_shares";
-            dataType: "string";
-            columnType: "PgUUID";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: true;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        shareCode: drizzle_orm_pg_core.PgColumn<{
-            name: "share_code";
-            tableName: "file_shares";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 20;
-        }>;
-        fileIds: drizzle_orm_pg_core.PgColumn<{
-            name: "file_ids";
-            tableName: "file_shares";
-            dataType: "json";
-            columnType: "PgJson";
-            data: unknown;
-            driverParam: unknown;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        title: drizzle_orm_pg_core.PgColumn<{
-            name: "title";
-            tableName: "file_shares";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 255;
-        }>;
-        description: drizzle_orm_pg_core.PgColumn<{
-            name: "description";
-            tableName: "file_shares";
-            dataType: "string";
-            columnType: "PgText";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        password: drizzle_orm_pg_core.PgColumn<{
-            name: "password";
-            tableName: "file_shares";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 100;
-        }>;
-        permission: drizzle_orm_pg_core.PgColumn<{
-            name: "permission";
-            tableName: "file_shares";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 20;
-        }>;
-        maxDownloads: drizzle_orm_pg_core.PgColumn<{
-            name: "max_downloads";
-            tableName: "file_shares";
-            dataType: "number";
-            columnType: "PgInteger";
-            data: number;
-            driverParam: string | number;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        downloadCount: drizzle_orm_pg_core.PgColumn<{
-            name: "download_count";
-            tableName: "file_shares";
-            dataType: "number";
-            columnType: "PgInteger";
-            data: number;
-            driverParam: string | number;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        maxAccess: drizzle_orm_pg_core.PgColumn<{
-            name: "max_access";
-            tableName: "file_shares";
-            dataType: "number";
-            columnType: "PgInteger";
-            data: number;
-            driverParam: string | number;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        accessCount: drizzle_orm_pg_core.PgColumn<{
-            name: "access_count";
-            tableName: "file_shares";
-            dataType: "number";
-            columnType: "PgInteger";
-            data: number;
-            driverParam: string | number;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        isActive: drizzle_orm_pg_core.PgColumn<{
-            name: "is_active";
-            tableName: "file_shares";
-            dataType: "boolean";
-            columnType: "PgBoolean";
-            data: boolean;
-            driverParam: boolean;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        expiresAt: drizzle_orm_pg_core.PgColumn<{
-            name: "expires_at";
-            tableName: "file_shares";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        createdBy: drizzle_orm_pg_core.PgColumn<{
-            name: "created_by";
-            tableName: "file_shares";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 255;
-        }>;
-        createdAt: drizzle_orm_pg_core.PgColumn<{
-            name: "created_at";
-            tableName: "file_shares";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        updatedAt: drizzle_orm_pg_core.PgColumn<{
-            name: "updated_at";
-            tableName: "file_shares";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-    };
-    dialect: "pg";
-}>;
-/**
- * 文件访问日志表 (file_access_logs)
- *
- * 记录文件的访问历史，用于统计分析和安全审计。
- */
-declare const fileAccessLogs: drizzle_orm_pg_core.PgTableWithColumns<{
-    name: "file_access_logs";
-    schema: undefined;
-    columns: {
-        id: drizzle_orm_pg_core.PgColumn<{
-            name: "id";
-            tableName: "file_access_logs";
-            dataType: "string";
-            columnType: "PgUUID";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: true;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        fileId: drizzle_orm_pg_core.PgColumn<{
-            name: "file_id";
-            tableName: "file_access_logs";
-            dataType: "string";
-            columnType: "PgUUID";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        shareId: drizzle_orm_pg_core.PgColumn<{
-            name: "share_id";
-            tableName: "file_access_logs";
-            dataType: "string";
-            columnType: "PgUUID";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        accessType: drizzle_orm_pg_core.PgColumn<{
-            name: "access_type";
-            tableName: "file_access_logs";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 20;
-        }>;
-        userId: drizzle_orm_pg_core.PgColumn<{
-            name: "user_id";
-            tableName: "file_access_logs";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 255;
-        }>;
-        ipAddress: drizzle_orm_pg_core.PgColumn<{
-            name: "ip_address";
-            tableName: "file_access_logs";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 45;
-        }>;
-        userAgent: drizzle_orm_pg_core.PgColumn<{
-            name: "user_agent";
-            tableName: "file_access_logs";
-            dataType: "string";
-            columnType: "PgText";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        referer: drizzle_orm_pg_core.PgColumn<{
-            name: "referer";
-            tableName: "file_access_logs";
-            dataType: "string";
-            columnType: "PgText";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        statusCode: drizzle_orm_pg_core.PgColumn<{
-            name: "status_code";
-            tableName: "file_access_logs";
-            dataType: "number";
-            columnType: "PgInteger";
-            data: number;
-            driverParam: string | number;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        bytesTransferred: drizzle_orm_pg_core.PgColumn<{
-            name: "bytes_transferred";
-            tableName: "file_access_logs";
-            dataType: "number";
-            columnType: "PgBigInt53";
-            data: number;
-            driverParam: string | number;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        responseTimeMs: drizzle_orm_pg_core.PgColumn<{
-            name: "response_time_ms";
-            tableName: "file_access_logs";
-            dataType: "number";
-            columnType: "PgInteger";
-            data: number;
-            driverParam: string | number;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        accessedAt: drizzle_orm_pg_core.PgColumn<{
-            name: "accessed_at";
-            tableName: "file_access_logs";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-    };
-    dialect: "pg";
-}>;
-/**
- * 文件缩略图表 (file_thumbnails)
- *
- * 存储文件的缩略图信息，支持多种尺寸和格式。
- */
-declare const fileThumbnails: drizzle_orm_pg_core.PgTableWithColumns<{
-    name: "file_thumbnails";
-    schema: undefined;
-    columns: {
-        id: drizzle_orm_pg_core.PgColumn<{
-            name: "id";
-            tableName: "file_thumbnails";
-            dataType: "string";
-            columnType: "PgUUID";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: true;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        fileId: drizzle_orm_pg_core.PgColumn<{
-            name: "file_id";
-            tableName: "file_thumbnails";
-            dataType: "string";
-            columnType: "PgUUID";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        type: drizzle_orm_pg_core.PgColumn<{
-            name: "type";
-            tableName: "file_thumbnails";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 50;
-        }>;
-        size: drizzle_orm_pg_core.PgColumn<{
-            name: "size";
-            tableName: "file_thumbnails";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 20;
-        }>;
-        width: drizzle_orm_pg_core.PgColumn<{
-            name: "width";
-            tableName: "file_thumbnails";
-            dataType: "number";
-            columnType: "PgInteger";
-            data: number;
-            driverParam: string | number;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        height: drizzle_orm_pg_core.PgColumn<{
-            name: "height";
-            tableName: "file_thumbnails";
-            dataType: "number";
-            columnType: "PgInteger";
-            data: number;
-            driverParam: string | number;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        format: drizzle_orm_pg_core.PgColumn<{
-            name: "format";
-            tableName: "file_thumbnails";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 10;
-        }>;
-        fileSize: drizzle_orm_pg_core.PgColumn<{
-            name: "file_size";
-            tableName: "file_thumbnails";
-            dataType: "number";
-            columnType: "PgInteger";
-            data: number;
-            driverParam: string | number;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        storagePath: drizzle_orm_pg_core.PgColumn<{
-            name: "storage_path";
-            tableName: "file_thumbnails";
-            dataType: "string";
-            columnType: "PgText";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        cdnUrl: drizzle_orm_pg_core.PgColumn<{
-            name: "cdn_url";
-            tableName: "file_thumbnails";
-            dataType: "string";
-            columnType: "PgText";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        quality: drizzle_orm_pg_core.PgColumn<{
-            name: "quality";
-            tableName: "file_thumbnails";
-            dataType: "number";
-            columnType: "PgInteger";
-            data: number;
-            driverParam: string | number;
-            notNull: false;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        isGenerated: drizzle_orm_pg_core.PgColumn<{
-            name: "is_generated";
-            tableName: "file_thumbnails";
-            dataType: "boolean";
-            columnType: "PgBoolean";
-            data: boolean;
-            driverParam: boolean;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        generatedAt: drizzle_orm_pg_core.PgColumn<{
-            name: "generated_at";
-            tableName: "file_thumbnails";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        createdAt: drizzle_orm_pg_core.PgColumn<{
-            name: "created_at";
-            tableName: "file_thumbnails";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-    };
-    dialect: "pg";
-}>;
-declare const fileStorageProvidersRelations: drizzle_orm.Relations<"file_storage_providers", {
-    files: drizzle_orm.Many<"file_metadata">;
-}>;
-declare const fileFoldersRelations: drizzle_orm.Relations<"file_folders", {
-    parent: drizzle_orm.One<"file_folders", false>;
-    children: drizzle_orm.Many<"file_folders">;
-    files: drizzle_orm.Many<"file_metadata">;
-}>;
-declare const fileMetadataRelations: drizzle_orm.Relations<"file_metadata", {
-    storageProvider: drizzle_orm.One<"file_storage_providers", true>;
-    folder: drizzle_orm.One<"file_folders", false>;
-    versions: drizzle_orm.Many<"file_versions">;
-    processingRecords: drizzle_orm.Many<"file_processing_records">;
-    accessLogs: drizzle_orm.Many<"file_access_logs">;
-    thumbnails: drizzle_orm.Many<"file_thumbnails">;
-}>;
-declare const fileVersionsRelations: drizzle_orm.Relations<"file_versions", {
-    file: drizzle_orm.One<"file_metadata", true>;
-}>;
-declare const fileProcessingRecordsRelations: drizzle_orm.Relations<"file_processing_records", {
-    file: drizzle_orm.One<"file_metadata", true>;
-}>;
-declare const fileSharesRelations: drizzle_orm.Relations<"file_shares", {
-    accessLogs: drizzle_orm.Many<"file_access_logs">;
-}>;
-declare const fileAccessLogsRelations: drizzle_orm.Relations<"file_access_logs", {
-    file: drizzle_orm.One<"file_metadata", false>;
-    share: drizzle_orm.One<"file_shares", false>;
-}>;
-declare const fileThumbnailsRelations: drizzle_orm.Relations<"file_thumbnails", {
-    file: drizzle_orm.One<"file_metadata", true>;
-}>;
-type FileStorageProvider = typeof fileStorageProviders.$inferSelect;
-type NewFileStorageProvider = typeof fileStorageProviders.$inferInsert;
-type FileFolder = typeof fileFolders.$inferSelect;
-type NewFileFolder = typeof fileFolders.$inferInsert;
-type FileMetadata = typeof fileMetadata.$inferSelect;
-type NewFileMetadata = typeof fileMetadata.$inferInsert;
-type FileVersion = typeof fileVersions.$inferSelect;
-type NewFileVersion = typeof fileVersions.$inferInsert;
-type FileProcessingRecord = typeof fileProcessingRecords.$inferSelect;
-type NewFileProcessingRecord = typeof fileProcessingRecords.$inferInsert;
-type FileShare = typeof fileShares.$inferSelect;
-type NewFileShare = typeof fileShares.$inferInsert;
-type FileAccessLog = typeof fileAccessLogs.$inferSelect;
-type NewFileAccessLog = typeof fileAccessLogs.$inferInsert;
-type FileThumbnail = typeof fileThumbnails.$inferSelect;
-type NewFileThumbnail = typeof fileThumbnails.$inferInsert;
-
-export { AliyunCDNConfig, AliyunCDNProvider, AliyunOSSConfig, AliyunOSSProvider, ApiError, ApiErrorCode, type ApiResponse, AudioProcessor, CDNConfig, CDNResult, CDNType, CacheManager, CacheStrategyType$1 as CacheStrategyType, CdnCacheStrategy, ConfigValidationError, DEFAULT_ALLOWED_MIME_TYPES, DEFAULT_CACHE_CONFIG, DEFAULT_FILE_SERVICE_CONFIG, DEFAULT_MAX_FILE_SIZE, DEFAULT_OSS_CONFIG_KEYS, type DrizzleDb, type DrizzleRepositoryConfig, type DrizzleTable, ErrorHttpStatusMap, ErrorMessages, type FieldMapping, type FileAccessLog, type FileFolder, type FileInfo, type FileListResponse, type FileMetadata, type FileProcessParams, type FileProcessingRecord, type FileQueryParams, type FileServiceFactoryOptions, type FileShare, type FileStats, type FileStorageProvider, type FileThumbnail, type FileUpdateParams, type FileUploadParams, type FileVersion, type FolderCreateParams, type FolderInfo, type FolderUpdateParams, ICDNProvider, type IConfigService, IFileMetadataRepository, IFileProcessor, IStorageProvider, ImageProcessor, LocalStorageConfig, LocalStorageProvider, type NewFileAccessLog, type NewFileFolder, type NewFileMetadata, type NewFileProcessingRecord, type NewFileShare, type NewFileStorageProvider, type NewFileThumbnail, type NewFileVersion, type OSSConfigKeyMapping, type PaginationParams, PerformanceMonitor, ProcessingOptions, ProcessingQueue, ProcessingResult, type ProcessingStatus, ProcessorType, type ShareAccessParams, type ShareCreateParams, type ShareInfo, type SingletonFactory, StorageConfig, StorageResult, StorageType, UniversalFileService, UniversalFileServiceConfig, UploadFileInfo, type UploadResponse, VideoProcessor, cdnCacheStrategy, createAliyunOSSPreset, createDocumentServicePreset, createDrizzleRepository, createFileServiceConfig, createFileServiceFromEnv, createFileServiceWithFactory, createImageServicePreset, createLocalDevPreset, createSingleton, createSmartPreset, createUniversalFileService, createVideoServicePreset, fileAccessLogs, fileAccessLogsRelations, fileFolders, fileFoldersRelations, fileMetadata, fileMetadataRelations, fileProcessingRecords, fileProcessingRecordsRelations, fileShares, fileSharesRelations, fileStorageProviders, fileStorageProvidersRelations, fileThumbnails, fileThumbnailsRelations, fileVersions, fileVersionsRelations, getDefaultLocalStorage, getMimeType, getRequiredEnvVars, loadCDNConfigFromEnv, loadConfigFromEnv, loadConfigWithFallback, loadOSSConfigFromEnv, loadOSSConfigFromService, validateEnvironment, validateServiceConfig, validateStorageConfig };