sa2kit 3.0.0 → 3.2.0

package/dist/types-B6B210gX.d.ts

@@ -1,270 +0,0 @@
-/**
- * 通用文件服务类型定义
- *
- * 定义了文件存储、上传、下载等核心接口和类型
- */
-/** 文件存储类型 */
-type StorageType = 'local' | 'aliyun-oss' | 'aws-s3' | 'qcloud-cos';
-/** CDN提供者类型 */
-type CDNType = 'none' | 'aliyun-cdn' | 'aws-cloudfront' | 'qcloud-cdn';
-/** 文件处理类型 */
-type ProcessorType = 'image' | 'audio' | 'video' | 'document';
-/** 文件上传状态 */
-type UploadStatus = 'pending' | 'uploading' | 'processing' | 'completed' | 'failed';
-/** 访问权限类型 */
-type AccessPermission = 'public' | 'private' | 'authenticated' | 'owner-only';
-/** 文件元数据基础接口 */
-interface FileMetadata {
-    /** 文件ID */
-    id: string;
-    /** 原始文件名 */
-    originalName: string;
-    /** 存储文件名 */
-    storageName: string;
-    /** 文件大小(字节) */
-    size: number;
-    /** MIME类型 */
-    mimeType: string;
-    /** 文件扩展名 */
-    extension: string;
-    /** 文件哈希值 */
-    hash?: string;
-    /** 上传时间 */
-    uploadTime: Date;
-    /** 访问权限 */
-    permission: AccessPermission;
-    /** 上传者ID */
-    uploaderId: string;
-    /** 模块标识 */
-    moduleId: string;
-    /** 业务标识 */
-    businessId?: string;
-    /** 存储提供者 */
-    storageProvider: StorageType;
-    /** 存储路径 */
-    storagePath: string;
-    /** CDN URL */
-    cdnUrl?: string;
-    /** 访问次数 */
-    accessCount: number;
-    /** 最后访问时间 */
-    lastAccessTime?: Date;
-    /** 过期时间 */
-    expiresAt?: Date;
-    /** 自定义元数据 */
-    metadata?: Record<string, any>;
-}
-/** 上传文件信息（客户端使用） */
-interface UploadFileInfo {
-    /** 文件对象 */
-    file: File;
-    /** 模块标识 */
-    moduleId: string;
-    /** 业务标识 */
-    businessId?: string;
-    /** 访问权限 */
-    permission?: AccessPermission;
-    /** 自定义存储路径 */
-    customPath?: string;
-    /** 自定义元数据 */
-    metadata?: Record<string, any>;
-    /** 是否需要处理 */
-    needsProcessing?: boolean;
-    /** 处理选项 */
-    processingOptions?: ProcessingOptions;
-}
-/** 文件处理选项基础接口 */
-interface ProcessingOptions {
-    /** 处理器类型 */
-    type: ProcessorType;
-    /** 处理参数 */
-    params?: Record<string, any>;
-}
-/** 图片处理选项 */
-interface ImageProcessingOptions extends ProcessingOptions {
-    type: 'image';
-    /** 压缩质量 0-100 */
-    quality?: number;
-    /** 目标宽度 */
-    width?: number;
-    /** 目标高度 */
-    height?: number;
-    /** 格式转换 */
-    format?: 'jpeg' | 'png' | 'webp' | 'avif';
-    /** 是否添加水印 */
-    watermark?: boolean;
-    /** 水印配置 */
-    watermarkOptions?: {
-        text?: string;
-        image?: string;
-        position?: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'center';
-        opacity?: number;
-    };
-}
-/** 音频处理选项 */
-interface AudioProcessingOptions extends ProcessingOptions {
-    type: 'audio';
-    /** 比特率 */
-    bitrate?: number;
-    /** 格式转换 */
-    format?: 'mp3' | 'wav' | 'ogg' | 'aac';
-    /** 采样率 */
-    sampleRate?: number;
-    /** 声道数 */
-    channels?: number;
-}
-/** 视频处理选项 */
-interface VideoProcessingOptions extends ProcessingOptions {
-    type: 'video';
-    /** 视频质量 */
-    quality?: number;
-    /** 格式转换 */
-    format?: 'mp4' | 'avi' | 'mov' | 'webm';
-    /** 生成缩略图 */
-    generateThumbnail?: boolean;
-    /** 缩略图时间点(秒) */
-    thumbnailTime?: number;
-}
-/** 上传进度 */
-interface UploadProgress {
-    /** 文件ID */
-    fileId: string;
-    /** 上传状态 */
-    status: UploadStatus;
-    /** 进度百分比(0-100) */
-    progress: number;
-    /** 已上传字节数 */
-    uploadedBytes: number;
-    /** 总字节数 */
-    totalBytes: number;
-    /** 上传速度(字节/秒) */
-    speed: number;
-    /** 剩余时间(秒) */
-    remainingTime: number;
-    /** 错误信息 */
-    error?: string;
-}
-/** 上传结果 */
-interface UploadResult {
-    /** 是否成功 */
-    success: boolean;
-    /** 文件元数据 */
-    file?: FileMetadata;
-    /** 文件访问URL */
-    url?: string;
-    /** 错误信息 */
-    error?: string;
-}
-/** 文件查询选项 */
-interface FileQueryOptions {
-    /** 模块标识 */
-    moduleId?: string;
-    /** 业务标识 */
-    businessId?: string;
-    /** 上传者ID */
-    uploaderId?: string;
-    /** MIME类型过滤 */
-    mimeType?: string;
-    /** 最小文件大小 */
-    minSize?: number;
-    /** 最大文件大小 */
-    maxSize?: number;
-    /** 开始时间 */
-    startTime?: Date;
-    /** 结束时间 */
-    endTime?: Date;
-    /** 搜索关键词 */
-    keyword?: string;
-    /** 标签 */
-    tags?: string[];
-    /** 排序字段 */
-    sortBy?: string;
-    /** 排序方向 */
-    sortOrder?: 'asc' | 'desc';
-    /** 页码 */
-    page?: number;
-    /** 每页数量 */
-    pageSize?: number;
-}
-/** 分页结果 */
-interface PaginatedResult<T> {
-    /** 数据项 */
-    items: T[];
-    /** 总数 */
-    total: number;
-    /** 当前页码 */
-    page: number;
-    /** 每页数量 */
-    pageSize: number;
-    /** 总页数 */
-    totalPages: number;
-    /** 是否有下一页 */
-    hasNext: boolean;
-    /** 是否有上一页 */
-    hasPrev: boolean;
-}
-/** 批量操作结果 */
-interface BatchOperationResult {
-    /** 成功数量 */
-    successCount: number;
-    /** 失败数量 */
-    failureCount: number;
-    /** 失败详情 */
-    failures: Array<{
-        fileId: string;
-        error: string;
-    }>;
-}
-/** 批量操作结果 */
-interface BatchOperationResult {
-    /** 成功数量 */
-    successCount: number;
-    /** 失败数量 */
-    failureCount: number;
-    /** 失败详情 */
-    failures: Array<{
-        fileId: string;
-        error: string;
-    }>;
-}
-/** 文件事件类型 */
-type FileEventType = 'upload:start' | 'upload:progress' | 'upload:complete' | 'upload:error' | 'download:start' | 'download:complete' | 'download:error' | 'delete:complete' | 'processing:start' | 'processing:complete' | 'processing:error';
-/** 文件事件 */
-interface FileEvent {
-    /** 事件类型 */
-    type: FileEventType;
-    /** 文件ID */
-    fileId: string;
-    /** 事件时间 */
-    timestamp: Date;
-    /** 事件数据 */
-    data?: Record<string, any>;
-    /** 错误信息 */
-    error?: string;
-}
-/** 文件事件监听器 */
-type FileEventListener = (event: FileEvent) => void | Promise<void>;
-/** 文件服务基础异常 */
-declare class FileServiceError extends Error {
-    readonly code: string;
-    readonly details?: Record<string, any> | undefined;
-    constructor(message: string, code: string, details?: Record<string, any> | undefined);
-}
-/** 文件上传错误 */
-declare class FileUploadError extends FileServiceError {
-    constructor(message: string, details?: Record<string, any>);
-}
-/** 文件处理错误 */
-declare class FileProcessingError extends FileServiceError {
-    constructor(message: string, details?: Record<string, any>);
-}
-/** 存储提供者错误 */
-declare class StorageProviderError extends FileServiceError {
-    constructor(message: string, details?: Record<string, any>);
-}
-/** CDN提供者错误 */
-declare class CDNProviderError extends FileServiceError {
-    constructor(message: string, details?: Record<string, any>);
-}
-
-export { type AccessPermission as A, type BatchOperationResult as B, type CDNType as C, type FileMetadata as F, type ImageProcessingOptions as I, type PaginatedResult as P, type StorageType as S, type UploadFileInfo as U, type VideoProcessingOptions as V, type UploadProgress as a, type FileQueryOptions as b, type FileEventListener as c, type UploadStatus as d, type ProcessorType as e, type ProcessingOptions as f, type AudioProcessingOptions as g, CDNProviderError as h, type FileEvent as i, type FileEventType as j, FileProcessingError as k, FileServiceError as l, FileUploadError as m, StorageProviderError as n, type UploadResult as o };

package/dist/types-Bdnte5EN.d.mts

@@ -1,292 +0,0 @@
-import { S as StorageType$1, C as CDNType$1, F as FileMetadata, A as AccessPermission, d as UploadStatus, e as ProcessorType$1, U as UploadFileInfo$1, f as ProcessingOptions$1 } from './types-B6B210gX.mjs';
-
-/**
- * UniversalFile Server 端类型定义
- */
-
-type StorageType = StorageType$1;
-type CDNType = CDNType$1;
-type ProcessorType = ProcessorType$1;
-type UploadFileInfo = UploadFileInfo$1;
-type ProcessingOptions = ProcessingOptions$1;
-/** 存储提供者接口 */
-interface IStorageProvider {
-    /** 提供者类型 */
-    readonly type: StorageType;
-    /** 初始化 */
-    initialize(config: StorageConfig): Promise<void>;
-    /** 上传文件 */
-    upload(fileInfo: UploadFileInfo, path: 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[]>;
-}
-/** CDN 提供者接口 */
-interface ICDNProvider {
-    /** 提供者类型 */
-    readonly type: CDNType;
-    /** 初始化 */
-    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>;
-}
-/** 文件处理器接口 */
-interface IFileProcessor {
-    /** 处理器类型 */
-    readonly type: ProcessorType;
-    /** 初始化 */
-    initialize(): Promise<void>;
-    /** 处理文件 */
-    process(inputPath: string, outputPath: string, options: ProcessingOptions): Promise<ProcessingResult>;
-    /** 检查文件是否支持处理 */
-    supports(mimeType: string): boolean;
-    /** 获取文件信息 */
-    getFileInfo(filePath: string): Promise<Record<string, any>>;
-}
-/** 存储配置基础接口 */
-interface StorageConfig {
-    /** 存储类型 */
-    type: StorageType;
-    /** 是否启用 */
-    enabled: boolean;
-}
-/** 阿里云 OSS 配置 */
-interface AliyunOSSConfig extends StorageConfig {
-    type: 'aliyun-oss';
-    /** 地域 */
-    region: string;
-    /** 存储桶名称 */
-    bucket: string;
-    /** 访问密钥ID */
-    accessKeyId: string;
-    /** 访问密钥密码 */
-    accessKeySecret: string;
-    /** 自定义域名 */
-    customDomain?: string;
-    /** 是否使用HTTPS */
-    secure?: boolean;
-    /** 是否使用内网访问 */
-    internal?: boolean;
-}
-/** CDN配置基础接口 */
-interface CDNConfig {
-    /** CDN类型 */
-    type: CDNType;
-    /** 是否启用 */
-    enabled: boolean;
-}
-/** 缓存配置 */
-interface CacheConfig {
-    /** 是否启用缓存 */
-    enabled: boolean;
-    /** 最大缓存大小 */
-    maxSize?: number;
-    /** 缓存 TTL（秒） */
-    ttl?: number;
-    /** 是否使用 Redis */
-    useRedis?: boolean;
-    /** Redis 配置 */
-    redisConfig?: {
-        host: string;
-        port: number;
-        password?: string;
-        db?: number;
-    };
-}
-/** 文件服务配置 */
-/** 缓存配置扩展 */
-interface CacheConfig {
-    /** 是否启用缓存 */
-    enabled: boolean;
-    /** 元数据缓存TTL（秒） */
-    metadataTTL?: number;
-    /** URL缓存TTL（秒） */
-    urlTTL?: number;
-    /** 最大缓存条目数 */
-    maxSize?: number;
-}
-interface UniversalFileServiceConfig {
-    /** 存储配置 */
-    storage: StorageConfig;
-    /** CDN 配置（可选） */
-    cdn?: CDNConfig;
-    /** 缓存配置（可选） */
-    cache?: CacheConfig;
-    /** 数据库持久化配置（可选） */
-    persistence?: FileServicePersistenceConfig;
-    /** 启用的处理器 */
-    processors?: ProcessorType[];
-    /** 数据库连接（可选） @deprecated 使用 persistence.repository 代替 */
-    db?: any;
-    /** 最大文件大小（字节） */
-    maxFileSize?: number;
-    /** 允许的文件类型 */
-    allowedMimeTypes?: string[];
-    /** 是否启用监控 */
-    enableMonitoring?: boolean;
-    /** 存储提供者映射（内部使用） */
-    storageProviders?: Map<StorageType, IStorageProvider>;
-    /** 默认存储类型 */
-    defaultStorage?: StorageType;
-    /** 默认CDN类型 */
-    defaultCDN?: CDNType;
-}
-/** 存储结果 */
-/** 存储操作结果 */
-interface StorageResult {
-    /** 是否成功 */
-    success: boolean;
-    /** 存储路径 */
-    path?: string;
-    /** 访问URL */
-    url?: string;
-    /** 文件大小 */
-    size?: number;
-    /** 错误信息 */
-    error?: string;
-    /** 额外数据 */
-    data?: Record<string, any>;
-}
-/** CDN 结果 */
-/** CDN操作结果 */
-interface CDNResult {
-    /** 是否成功 */
-    success: boolean;
-    /** CDN URL */
-    url?: string;
-    /** 错误信息 */
-    error?: string;
-    /** 额外数据 */
-    data?: Record<string, any>;
-}
-/** 处理结果 */
-interface ProcessingResult {
-    /** 是否成功 */
-    success: boolean;
-    /** 处理后的文件路径 */
-    processedPath?: string;
-    /** 处理后的文件大小 */
-    processedSize?: number;
-    /** 缩略图路径 */
-    thumbnailPath?: string;
-    /** 错误信息 */
-    error?: string;
-    /** 处理耗时(毫秒) */
-    processingTime?: number;
-    /** 额外数据 */
-    data?: Record<string, any>;
-}
-/** 文件查询选项 */
-interface FileQueryOptions {
-    /** 模块 ID */
-    moduleId?: string;
-    /** 业务 ID */
-    businessId?: string;
-    /** 上传者 ID */
-    uploaderId?: string;
-    /** 文件类型 */
-    mimeType?: string;
-    /** 访问权限 */
-    permission?: AccessPermission;
-    /** 状态 */
-    status?: UploadStatus;
-    /** 分页 */
-    page?: number;
-    pageSize?: number;
-    /** 排序 */
-    orderBy?: string;
-    orderDirection?: 'asc' | 'desc';
-}
-/** 分页结果 */
-interface PaginatedResult<T> {
-    /** 数据列表 */
-    items: T[];
-    /** 总数 */
-    total: number;
-    /** 当前页 */
-    page: number;
-    /** 每页大小 */
-    pageSize: number;
-    /** 总页数 */
-    totalPages: number;
-}
-/**
- * 文件元数据数据库持久化接口
- *
- * 实现此接口以提供自定义的数据库持久化支持
- *
- * @example
- * ```typescript
- * // Drizzle ORM 实现
- * class DrizzleFileRepository implements IFileMetadataRepository {
- *   async save(metadata: FileMetadata): Promise<void> {
- *     await db.insert(fileMetadata).values(metadata);
- *   }
- *   // ... 其他方法
- * }
- * ```
- */
-interface IFileMetadataRepository {
-    /**
-     * 保存文件元数据到数据库
-     */
-    save(metadata: FileMetadata): Promise<void>;
-    /**
-     * 从数据库获取文件元数据
-     */
-    get(fileId: string): Promise<FileMetadata | null>;
-    /**
-     * 查询文件列表
-     */
-    query(options: FileQueryOptions): Promise<PaginatedResult<FileMetadata>>;
-    /**
-     * 从数据库删除文件元数据
-     */
-    delete(fileId: string): Promise<void>;
-    /**
-     * 批量删除文件元数据
-     */
-    batchDelete(fileIds: string[]): Promise<void>;
-}
-/**
- * 数据库持久化配置
- */
-interface FileServicePersistenceConfig {
-    /**
-     * 是否启用持久化
-     */
-    enabled: boolean;
-    /**
-     * 持久化仓储实现
-     */
-    repository: IFileMetadataRepository;
-    /**
-     * 是否自动持久化（默认 true）
-     * 如果为 true，文件上传完成后自动保存到数据库
-     */
-    autoPersist?: boolean;
-    /**
-     * 是否优先使用缓存（默认 false）
-     * 如果为 true，查询时优先从缓存获取
-     */
-    cacheFirst?: boolean;
-}
-
-export type { AliyunOSSConfig as A, IStorageProvider as I, UniversalFileServiceConfig as U, ICDNProvider as a, IFileProcessor as b };

package/dist/types-C_W_CoUD.d.ts

@@ -1,99 +0,0 @@
-import { U as UserRole } from './enums-Dume-V5Y.js';
-
-/**
- * Auth 模块类型定义
- * Auth Module Types
- */
-
-/**
- * 用户基础信息（核心字段）
- * Base User Information
- */
-interface BaseUser {
-    id: string;
-    email: string;
-    username: string;
-    role: UserRole;
-}
-/**
- * 扩展用户信息（可选字段）
- * Extended User Information
- */
-interface User extends BaseUser {
-    nickname?: string;
-    avatar?: string;
-    createdAt?: string;
-    updatedAt?: string;
-    [key: string]: any;
-}
-/**
- * 登录表单数据
- * Login Form Data
- */
-interface LoginForm {
-    email: string;
-    password: string;
-    rememberMe?: boolean;
-}
-/**
- * 注册表单数据
- * Register Form Data
- */
-interface RegisterForm {
-    email: string;
-    username: string;
-    password: string;
-    confirmPassword?: string;
-    nickname?: string;
-}
-/**
- * API 响应类型
- */
-interface ApiResponse<T = any> {
-    success: boolean;
-    data?: T;
-    error?: string;
-    message?: string;
-}
-/**
- * 认证响应类型
- */
-interface AuthResponse {
-    user: User;
-    token: string;
-}
-/**
- * API 客户端基础接口
- */
-interface IAuthClient {
-    isAuthenticated(): Promise<boolean>;
-    getCurrentUser(): Promise<ApiResponse<User>>;
-    login(email: string, password: string): Promise<ApiResponse<AuthResponse>>;
-    register(email: string, password: string, username: string): Promise<ApiResponse<AuthResponse>>;
-    logout(): Promise<void>;
-    clearUserData(): Promise<void>;
-}
-/**
- * 认证操作结果接口
- */
-interface AuthResult {
-    success: boolean;
-    error?: string;
-}
-/**
- * useAuth Hook 返回值接口
- */
-interface UseAuthReturn {
-    user: User | null;
-    isLoggedIn: boolean;
-    loading: boolean;
-    checkingAuth: boolean;
-    error: string | null;
-    login: (email: string, password: string) => Promise<AuthResult>;
-    register: (email: string, password: string, username: string) => Promise<AuthResult>;
-    logout: () => Promise<void>;
-    refresh: () => Promise<void>;
-    clearError: () => void;
-}
-
-export type { AuthResult as A, BaseUser as B, IAuthClient as I, LoginForm as L, RegisterForm as R, User as U, UseAuthReturn as a, ApiResponse as b, AuthResponse as c };