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

package/file-upload/dto/create-file.dto.js

@@ -0,0 +1,112 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreateFileDto = void 0;
+const class_validator_1 = require("class-validator");
+/**
+ * 创建文件DTO
+ */
+class CreateFileDto {
+}
+exports.CreateFileDto = CreateFileDto;
+__decorate([
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateFileDto.prototype, "originalName", void 0);
+__decorate([
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateFileDto.prototype, "filename", void 0);
+__decorate([
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateFileDto.prototype, "mimeType", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateFileDto.prototype, "fileType", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateFileDto.prototype, "extension", void 0);
+__decorate([
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.IsNumber)(),
+    __metadata("design:type", Number)
+], CreateFileDto.prototype, "size", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateFileDto.prototype, "checksum", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateFileDto.prototype, "path", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateFileDto.prototype, "url", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateFileDto.prototype, "storageProvider", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateFileDto.prototype, "userId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateFileDto.prototype, "uploadId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateFileDto.prototype, "bucket", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateFileDto.prototype, "key", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateFileDto.prototype, "etag", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateFileDto.prototype, "tempPath", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(['processing', 'completed', 'failed', 'deleted']),
+    __metadata("design:type", String)
+], CreateFileDto.prototype, "status", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", Object)
+], CreateFileDto.prototype, "validationData", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", Object)
+], CreateFileDto.prototype, "metadata", void 0);

package/file-upload/dto/find-files.dto.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 查找文件DTO
+ */
+export declare class FindFilesDto {
+    userId?: string;
+    mimeType?: string[];
+    uploadId?: string;
+    status?: string;
+    storageProvider?: string;
+    dateFrom?: string;
+    dateTo?: string;
+    search?: string;
+    orderBy?: string;
+    orderDirection?: 'ASC' | 'DESC';
+}

package/file-upload/dto/find-files.dto.js

@@ -0,0 +1,76 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FindFilesDto = void 0;
+const class_validator_1 = require("class-validator");
+const class_transformer_1 = require("class-transformer");
+/**
+ * 查找文件DTO
+ */
+class FindFilesDto {
+    constructor() {
+        this.orderBy = 'createdAt';
+        this.orderDirection = 'DESC';
+    }
+}
+exports.FindFilesDto = FindFilesDto;
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], FindFilesDto.prototype, "userId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Transform)(({ value }) => value ? (Array.isArray(value) ? value : [value]) : undefined),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], FindFilesDto.prototype, "mimeType", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], FindFilesDto.prototype, "uploadId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(['processing', 'completed', 'failed', 'deleted']),
+    __metadata("design:type", String)
+], FindFilesDto.prototype, "status", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], FindFilesDto.prototype, "storageProvider", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsDateString)(),
+    __metadata("design:type", String)
+], FindFilesDto.prototype, "dateFrom", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsDateString)(),
+    __metadata("design:type", String)
+], FindFilesDto.prototype, "dateTo", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], FindFilesDto.prototype, "search", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(['createdAt', 'updatedAt', 'originalName', 'size']),
+    __metadata("design:type", String)
+], FindFilesDto.prototype, "orderBy", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(['ASC', 'DESC']),
+    __metadata("design:type", String)
+], FindFilesDto.prototype, "orderDirection", void 0);

package/file-upload/dto/index.d.ts

@@ -0,0 +1,4 @@
+export * from './create-file.dto';
+export * from './update-file.dto';
+export * from './find-files.dto';
+export * from './pagination.dto';

package/file-upload/dto/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./create-file.dto"), exports);
+__exportStar(require("./update-file.dto"), exports);
+__exportStar(require("./find-files.dto"), exports);
+__exportStar(require("./pagination.dto"), exports);

package/file-upload/dto/pagination.dto.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 分页DTO
+ */
+export declare class PaginationDto {
+    page?: number;
+    limit?: number;
+}

package/file-upload/dto/pagination.dto.js

@@ -0,0 +1,39 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PaginationDto = void 0;
+const class_validator_1 = require("class-validator");
+const class_transformer_1 = require("class-transformer");
+/**
+ * 分页DTO
+ */
+class PaginationDto {
+    constructor() {
+        this.page = 1;
+        this.limit = 20;
+    }
+}
+exports.PaginationDto = PaginationDto;
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Transform)(({ value }) => parseInt(value, 10) || 1),
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], PaginationDto.prototype, "page", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Transform)(({ value }) => Math.min(parseInt(value, 10) || 20, 100)),
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(100),
+    __metadata("design:type", Number)
+], PaginationDto.prototype, "limit", void 0);

package/file-upload/dto/update-file.dto.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 更新文件DTO
+ */
+export declare class UpdateFileDto {
+    originalName?: string;
+    filename?: string;
+    metadata?: Record<string, unknown>;
+    path?: string;
+    checksum?: string;
+    status?: 'processing' | 'completed' | 'failed' | 'deleted';
+    errorMessage?: string;
+    fileType?: string;
+    extension?: string;
+    validationData?: Record<string, unknown>;
+}

package/file-upload/dto/update-file.dto.js

@@ -0,0 +1,67 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateFileDto = void 0;
+const class_validator_1 = require("class-validator");
+/**
+ * 更新文件DTO
+ */
+class UpdateFileDto {
+}
+exports.UpdateFileDto = UpdateFileDto;
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpdateFileDto.prototype, "originalName", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpdateFileDto.prototype, "filename", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", Object)
+], UpdateFileDto.prototype, "metadata", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpdateFileDto.prototype, "path", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpdateFileDto.prototype, "checksum", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpdateFileDto.prototype, "status", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpdateFileDto.prototype, "errorMessage", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpdateFileDto.prototype, "fileType", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpdateFileDto.prototype, "extension", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", Object)
+], UpdateFileDto.prototype, "validationData", void 0);

package/file-upload/entities/file-metadata.entity.d.ts

@@ -0,0 +1,25 @@
+import { FileEntity } from './file.entity';
+/**
+ * 文件元数据实体
+ */
+export declare class FileMetadataEntity {
+    id: string;
+    fileId: string;
+    key: string;
+    /**
+     * 元数据值（JSON 字符串）
+     * 支持存储任何 JSON 可序列化的数据
+     */
+    value: string;
+    isPublic: boolean;
+    createdAt: Date;
+    file: FileEntity;
+    /**
+     * 获取值（自动解析 JSON）
+     */
+    getValue<T = any>(): T;
+    /**
+     * 设置值（自动序列化为 JSON 字符串）
+     */
+    setValue(value: any): void;
+}

package/file-upload/entities/file-metadata.entity.js

@@ -0,0 +1,76 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileMetadataEntity = void 0;
+const typeorm_1 = require("typeorm");
+const file_entity_1 = require("./file.entity");
+/**
+ * 文件元数据实体
+ */
+let FileMetadataEntity = class FileMetadataEntity {
+    // ========== 便捷方法 ==========
+    /**
+     * 获取值（自动解析 JSON）
+     */
+    getValue() {
+        if (this.value) {
+            try {
+                return JSON.parse(this.value);
+            }
+            catch (_a) {
+                return this.value;
+            }
+        }
+        return null;
+    }
+    /**
+     * 设置值（自动序列化为 JSON 字符串）
+     */
+    setValue(value) {
+        this.value = typeof value === 'string' ? value : JSON.stringify(value);
+    }
+};
+exports.FileMetadataEntity = FileMetadataEntity;
+__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)('uuid'),
+    __metadata("design:type", String)
+], FileMetadataEntity.prototype, "id", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ length: 36 }),
+    __metadata("design:type", String)
+], FileMetadataEntity.prototype, "fileId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ length: 100 }),
+    __metadata("design:type", String)
+], FileMetadataEntity.prototype, "key", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'text', nullable: true }),
+    __metadata("design:type", String)
+], FileMetadataEntity.prototype, "value", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ default: false }),
+    __metadata("design:type", Boolean)
+], FileMetadataEntity.prototype, "isPublic", void 0);
+__decorate([
+    (0, typeorm_1.CreateDateColumn)(),
+    __metadata("design:type", Date)
+], FileMetadataEntity.prototype, "createdAt", void 0);
+__decorate([
+    (0, typeorm_1.ManyToOne)(() => file_entity_1.FileEntity, { onDelete: 'CASCADE' }),
+    (0, typeorm_1.JoinColumn)({ name: 'fileId' }),
+    __metadata("design:type", file_entity_1.FileEntity)
+], FileMetadataEntity.prototype, "file", void 0);
+exports.FileMetadataEntity = FileMetadataEntity = __decorate([
+    (0, typeorm_1.Entity)('file_metadata'),
+    (0, typeorm_1.Index)(['fileId']),
+    (0, typeorm_1.Index)(['key']),
+    (0, typeorm_1.Index)(['fileId', 'key'], { unique: true })
+], FileMetadataEntity);

package/file-upload/entities/file.entity.d.ts

@@ -0,0 +1,114 @@
+/**
+ * 文件实体
+ */
+export declare class FileEntity {
+    id: string;
+    originalName: string;
+    filename: string;
+    mimeType: string;
+    fileType: string;
+    extension: string;
+    size: number;
+    checksum: string;
+    path: string;
+    storageProvider: string;
+    metadata: Record<string, any>;
+    bucket: string;
+    key: string;
+    etag: string;
+    userId: string;
+    uploadId: string;
+    tempPath: string;
+    status: 'processing' | 'completed' | 'failed' | 'deleted';
+    errorMessage: string;
+    /**
+     * 验证数据（文件签名检测、类型检测等）
+     */
+    validationData: {
+        detectedTypes: Array<{
+            type: string;
+            confidence: number;
+            isCustom: boolean;
+        }>;
+        signatures: Array<{
+            type: string;
+            bytes: number[];
+            offset: number;
+        }>;
+        integrityChecks: string[];
+    };
+    createdAt: Date;
+    updatedAt: Date;
+    deletedAt: Date;
+    /**
+     * 是否为图片
+     */
+    get isImage(): boolean;
+    /**
+     * 是否为文档
+     */
+    get isDocument(): boolean;
+    /**
+     * 是否为视频
+     */
+    get isVideo(): boolean;
+    /**
+     * 是否为音频
+     */
+    get isAudio(): boolean;
+    /**
+     * 是否为CAD文件
+     */
+    get isCAD(): boolean;
+    /**
+     * 是否为压缩文件
+     */
+    get isArchive(): boolean;
+    /**
+     * 获取人类可读的文件大小
+     */
+    get humanSize(): string;
+    /**
+     * 静态方法: 从文件名提取扩展名（使用统一工具类）
+     */
+    static extractExtension(filename: string): string;
+    /**
+     * 静态方法: 根据 MIME 类型和扩展名识别文件类型
+     */
+    static detectFileType(mimeType: string, extension: string): string;
+    /**
+     * 生成访问 URL
+     * 注意：不再使用 getter，改为方法以接收 baseUrl 参数
+     * 建议使用 FileService.getFileUrl() 代替
+     *
+     * @param baseUrl 基础 URL（可选）
+     * @returns 文件访问 URL
+     * @deprecated 请使用 FileService.getFileUrl()
+     */
+    generateUrl(baseUrl?: string): string;
+    /**
+     * 获取完整的物理路径（服务器端使用）
+     * 仅用于服务器端访问文件系统
+     */
+    getPhysicalPath(): string;
+    /**
+     * 自动识别并设置文件类型和扩展名
+     */
+    detectAndSetFileType(): void;
+    /**
+     * 标记为已完成
+     */
+    markAsCompleted(metadata?: any): void;
+    /**
+     * 标记为失败
+     */
+    markAsFailed(error: string): void;
+    /**
+     * 标记为已删除
+     */
+    markAsDeleted(): void;
+    /**
+     * 添加验证数据
+     */
+    addValidationData(data: Partial<FileEntity['validationData']>): void;
+}