@nest-omni/core 4.1.3-2 → 4.1.3-22

package/file-upload/interfaces/storage-provider.interface.d.ts

@@ -0,0 +1,239 @@
+import { FileBuffer } from './file-buffer.interface';
+import { UploadOptions } from './upload-options.interface';
+import { FileMetadata } from './file-metadata.interface';
+/** 存储提供者接口 */
+export interface IStorageProvider {
+    /** 提供者名称 */
+    name: string;
+    /** 上传文件 */
+    upload(file: FileBuffer, options: UploadOptions): Promise<UploadResult>;
+    /** 下载文件 */
+    download(path: string): Promise<FileBuffer>;
+    /** 删除文件 */
+    delete(path: string): Promise<void>;
+    /** 批量删除 */
+    deleteBatch(paths: string[]): Promise<BatchDeleteResult>;
+    /** 检查文件是否存在 */
+    exists(path: string): Promise<boolean>;
+    /** 获取文件元数据 */
+    getMetadata(path: string): Promise<FileMetadata>;
+    /** 获取预签名URL */
+    getSignedUrl(path: string, expiresIn?: number): Promise<string>;
+    /** 获取预签名上传URL（用于客户端直传） */
+    getSignedUploadUrl(path: string, expiresIn?: number, contentType?: string): Promise<PreSignedUploadInfo>;
+    /** 复制文件 */
+    copy(sourcePath: string, destinationPath: string): Promise<CopyResult>;
+    /** 移动文件 */
+    move(sourcePath: string, destinationPath: string): Promise<MoveResult>;
+    /** 列出文件 */
+    list(prefix?: string, limit?: number): Promise<ListResult>;
+    /** 初始化存储配置 */
+    initialize(): Promise<void>;
+    /** 健康检查 */
+    healthCheck(): Promise<HealthStatus>;
+}
+/** 上传结果 */
+export interface UploadResult {
+    /** 文件路径/键 */
+    key: string;
+    /** 访问URL */
+    url?: string;
+    /** ETag */
+    etag?: string;
+    /** 版本ID（如果支持） */
+    versionId?: string;
+    /** 文件大小 */
+    size: number;
+    /** 上传时间 */
+    uploadedAt: Date;
+    /** 额外元数据 */
+    metadata?: Record<string, any>;
+}
+/** 批量删除结果 */
+export interface BatchDeleteResult {
+    /** 成功删除的文件列表 */
+    deleted: string[];
+    /** 删除失败的文件列表 */
+    failed: Array<{
+        path: string;
+        error: string;
+    }>;
+    /** 总数 */
+    total: number;
+}
+/** 复制结果 */
+export interface CopyResult {
+    /** 目标路径 */
+    destinationPath: string;
+    /** 文件大小 */
+    size: number;
+    /** 复制时间 */
+    copiedAt: Date;
+    /** ETag */
+    etag?: string;
+}
+/** 移动结果 */
+export interface MoveResult {
+    /** 目标路径 */
+    destinationPath: string;
+    /** 文件大小 */
+    size: number;
+    /** 移动时间 */
+    movedAt: Date;
+    /** ETag */
+    etag?: string;
+}
+/** 列表结果 */
+export interface ListResult {
+    /** 文件列表 */
+    files: Array<{
+        key: string;
+        size: number;
+        lastModified: Date;
+        etag?: string;
+    }>;
+    /** 是否还有更多文件 */
+    hasMore: boolean;
+    /** 下一个标记 */
+    nextMarker?: string;
+    /** 总数（如果支持） */
+    totalCount?: number;
+}
+/** 预签名上传信息 */
+export interface PreSignedUploadInfo {
+    /** 上传URL */
+    url: string;
+    /** HTTP方法 */
+    method: 'PUT' | 'POST';
+    /** 需要的头部 */
+    headers: Record<string, string>;
+    /** 表单字段（如果使用POST） */
+    fields?: Record<string, string>;
+    /** 过期时间 */
+    expiresAt: Date;
+}
+/** 健康状态 */
+export interface HealthStatus {
+    /** 是否健康 */
+    healthy: boolean;
+    /** 响应时间（毫秒） */
+    responseTime: number;
+    /** 错误信息 */
+    error?: string;
+    /** 额外信息 */
+    details?: Record<string, any>;
+}
+/** 本地存储选项 */
+export interface LocalStorageOptions {
+    /** 上传根目录 */
+    uploadPath: string;
+    /** 基础URL */
+    baseUrl?: string;
+    /** 是否创建子目录 */
+    createSubdirectories?: boolean;
+    /** 子目录格式（date: YYYY/MM/DD, hash: AB/CD/EF） */
+    subdirectoryFormat?: 'none' | 'date' | 'hash';
+    /** 最大文件大小 */
+    maxSize?: number;
+    /** 文件权限 */
+    fileMode?: string;
+    /** 目录权限 */
+    dirMode?: string;
+}
+/** S3存储选项 */
+export interface S3StorageOptions {
+    /** AWS访问密钥ID */
+    accessKeyId: string;
+    /** AWS秘密访问密钥 */
+    secretAccessKey: string;
+    /** AWS区域 */
+    region: string;
+    /** S3存储桶名称 */
+    bucket: string;
+    /** 自定义端点 */
+    endpoint?: string;
+    /** ACL（访问控制列表） */
+    acl?: string;
+    /** 服务器端加密 */
+    serverSideEncryption?: string;
+    /** 存储类别 */
+    storageClass?: string;
+    /** 是否启用CDN */
+    cdnEnabled?: boolean;
+    /** CDN域名 */
+    cdnDomain?: string;
+    /** 是否使用路径样式访问 */
+    forcePathStyle?: boolean;
+    /** 签名版本 */
+    signatureVersion?: string;
+}
+/** OSS存储选项 */
+export interface OSSStorageOptions {
+    /** Access Key ID */
+    accessKeyId: string;
+    /** Access Key Secret */
+    accessKeySecret: string;
+    /** OSS区域 */
+    region: string;
+    /** OSS Bucket名称 */
+    bucket: string;
+    /** 内网域名 */
+    internalEndpoint?: string;
+    /** 外网域名 */
+    externalEndpoint?: string;
+    /** 安全令牌（STS） */
+    securityToken?: string;
+    /** 访问权限 */
+    acl?: string;
+    /** 服务器端加密 */
+    serverSideEncryption?: string;
+    /** 是否启用CDN */
+    cdnEnabled?: boolean;
+    /** CDN加速域名 */
+    cdnDomain?: string;
+}
+/** MinIO存储选项 */
+export interface MinIOStorageOptions {
+    /** 端点URL */
+    endPoint: string;
+    /** 端口 */
+    port: number;
+    /** 是否使用SSL */
+    useSSL: boolean;
+    /** Access Key */
+    accessKey: string;
+    /** Secret Key */
+    secretKey: string;
+    /** Bucket名称 */
+    bucket: string;
+    /** Region */
+    region?: string;
+    /** 是否启用CDN */
+    cdnEnabled?: boolean;
+    /** CDN域名 */
+    cdnDomain?: string;
+}
+/** 存储配置 */
+export interface StorageConfig {
+    /** 存储提供者类型 */
+    provider: 'local' | 's3' | 'oss' | 'minio';
+    /** 提供者特定配置 */
+    options: LocalStorageOptions | S3StorageOptions | OSSStorageOptions | MinIOStorageOptions;
+    /** 是否启用备份 */
+    backup?: {
+        enabled: boolean;
+        provider: StorageConfig['provider'];
+        options: StorageConfig['options'];
+    };
+    /** 是否启用镜像 */
+    mirror?: {
+        enabled: boolean;
+        providers: Array<StorageConfig>;
+    };
+    /** 缓存配置 */
+    cache?: {
+        enabled: boolean;
+        ttl: number;
+        maxSize: number;
+    };
+}

package/file-upload/interfaces/storage-provider.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/file-upload/interfaces/upload-options.interface.d.ts

@@ -0,0 +1,19 @@
+/** 上传选项 */
+export interface UploadOptions {
+    /** 文件存储路径前缀 */
+    path?: string;
+    /** 自定义文件名 */
+    filename?: string;
+    /** 文件访问权限 */
+    acl?: 'public-read' | 'private' | 'public-read-write' | 'authenticated-read';
+    /** 文件标签 */
+    tags?: string[];
+    /** 元数据 */
+    metadata?: Record<string, string>;
+    /** 是否覆盖已存在的文件 */
+    overwrite?: boolean;
+    /** 用户ID */
+    userId?: string;
+    /** 自定义选项 */
+    custom?: Record<string, any>;
+}

package/file-upload/interfaces/upload-options.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/file-upload/processors/csv.processor.d.ts

@@ -0,0 +1,98 @@
+import { FileEntity } from '../interfaces';
+import { IFileProcessor, ProcessorInfo } from '../interfaces/file-processor.interface';
+import { ProcessOptions, ProcessResult } from '../interfaces/processor-options.interface';
+/**
+ * CSV 处理器配置
+ */
+export interface CsvProcessorOptions extends ProcessOptions {
+    /** 字段分隔符 */
+    delimiter?: string;
+    /** 引号字符 */
+    quote?: string;
+    /** 转义字符 */
+    escape?: string;
+    /** 是否有标题行 */
+    headers?: boolean;
+    /** 跳过空行数 */
+    skipLines?: number;
+    /** 跳过空字段 */
+    skipEmpty?: boolean;
+    /** 严格模式（字段数必须一致） */
+    strict?: boolean;
+    /** 修剪字段值 */
+    trim?: boolean;
+    /** 最大行数 */
+    maxRows?: number;
+    /** 编码 */
+    encoding?: string;
+    /** DTO类（用于装饰器映射） */
+    dto?: new () => any;
+    /** 是否使用装饰器映射 */
+    useDecorators?: boolean;
+    /** 是否将解析结果存入 file_metadata */
+    saveToMetadata?: boolean;
+    /** 元数据存储键名 */
+    metadataKey?: string;
+}
+/**
+ * CSV 处理结果
+ */
+export interface CsvProcessResult extends ProcessResult {
+    /** CSV 数据 */
+    data: any[];
+    /** 表头（如果有） */
+    headers?: string[];
+    /** 行数 */
+    rowCount: number;
+    /** 列数 */
+    columnCount: number;
+    /** 错误信息 */
+    errors?: {
+        row: number;
+        errors: string[];
+        data: any;
+    }[];
+    /** 成功的行数 */
+    successCount?: number;
+    /** 失败的行数 */
+    errorCount?: number;
+    /** 原始数据（用于调试） */
+    rawRecords?: any[];
+    /** 是否已保存到元数据 */
+    savedToMetadata?: boolean;
+    /** 元数据存储键名 */
+    metadataKey?: string;
+}
+/**
+ * CSV 文件处理器
+ * 解析 CSV 文件并转换为 JSON 格式，支持装饰器映射
+ */
+export declare class CsvProcessor implements IFileProcessor {
+    readonly name = "csv";
+    readonly supportedTypes: string[];
+    private readonly logger;
+    /**
+     * 验证是否为 CSV 文件
+     */
+    validate(buffer: Buffer): Promise<boolean>;
+    /**
+     * 处理CSV文件（流式处理优化版）
+     */
+    process(file: FileEntity, options?: CsvProcessorOptions): Promise<CsvProcessResult>;
+    /**
+     * 使用装饰器处理单行数据
+     */
+    private processRowWithDecorators;
+    /**
+     * 获取处理器信息
+     */
+    getInfo(): ProcessorInfo;
+    /**
+     * 健康检查
+     */
+    healthCheck(): Promise<boolean>;
+    /**
+     * 清理资源
+     */
+    cleanup(): Promise<void>;
+}