mini-starter/src/server/modules/files/file.schema.ts

import { z } from '@hono/zod-openapi';
import { UserSchema } from '../users/user.schema';

export const FileSchema = z.object({
  id: z.number().int().positive().openapi({
    description: '文件ID',
    example: 1
  }),
  name: z.string().max(255).openapi({
    description: '文件名称',
    example: '项目计划书.pdf'
  }),
  type: z.string().max(50).nullable().openapi({
    description: '文件类型',
    example: 'application/pdf'
  }),
  size: z.number().int().positive().nullable().openapi({
    description: '文件大小，单位字节',
    example: 102400
  }),
  path: z.string().max(512).openapi({
    description: '文件存储路径',
    example: '/uploads/documents/2023/project-plan.pdf'
  }),
  fullUrl: z.url().openapi({
    description: '完整文件访问URL',
    example: 'https://minio.example.com/d8dai/uploads/documents/2023/project-plan.pdf'
  }),
  description: z.string().nullable().openapi({
    description: '文件描述',
    example: '2023年度项目计划书'
  }),
  uploadUserId: z.number().int().positive().openapi({
    description: '上传用户ID',
    example: 1
  }),
  uploadUser: UserSchema,
  uploadTime: z.coerce.date().openapi({
    description: '上传时间',
    example: '2023-01-15T10:30:00Z'
  }),
  lastUpdated: z.date().nullable().openapi({
    description: '最后更新时间',
    example: '2023-01-16T14:20:00Z'
  }),
  createdAt: z.coerce.date().openapi({
    description: '创建时间',
    example: '2023-01-15T10:30:00Z'
  }),
  updatedAt: z.coerce.date().openapi({
    description: '更新时间',
    example: '2023-01-16T14:20:00Z'
  })
});

export const CreateFileDto = z.object({
  name: z.string().max(255).openapi({
    description: '文件名称',
    example: '项目计划书.pdf'
  }),
  type: z.string().max(50).nullable().optional().openapi({
    description: '文件类型',
    example: 'application/pdf'
  }),
  size: z.coerce.number().int().positive().nullable().optional().openapi({
    description: '文件大小，单位字节',
    example: 102400
  }),
  path: z.string().max(512).openapi({
    description: '文件存储路径',
    example: '/uploads/documents/2023/project-plan.pdf'
  }),
  description: z.string().nullable().optional().openapi({
    description: '文件描述',
    example: '2023年度项目计划书'
  }),
  lastUpdated: z.coerce.date().nullable().optional().openapi({
    description: '最后更新时间',
    example: '2023-01-16T14:20:00Z'
  })
});

export const UpdateFileDto = z.object({
  name: z.string().max(255).optional().openapi({
    description: '文件名称',
    example: '项目计划书_v2.pdf'
  }),
  description: z.string().nullable().optional().openapi({
    description: '文件描述',
    example: '2023年度项目计划书（修订版）'
  })
});