ClassHelper/packages/server/src/lib/schemas.ts

import { z } from 'zod';

/** 通用路径参数：:id */
export const idParamSchema = z.object({ id: z.string().min(1, '缺少 id') });

/** HH:mm 时间 */
export const timeSchema = z.string().regex(/^([01]\d|2[0-3]):[0-5]\d$/, '时间格式应为 HH:mm');

/** ISO 日期时间字符串（接受 2026-03-01 或完整 ISO） */
export const dateTimeSchema = z
  .string()
  .min(1)
  .refine((value) => !Number.isNaN(new Date(value).getTime()), '日期时间格式不正确');

/** 可选日期时间：允许 null / 空字符串，表示清空 */
export const optionalDateTimeSchema = z.union([dateTimeSchema, z.null(), z.literal('')]).optional();

/** 把可选日期时间统一转成 Date | null */
export function parseOptionalDate(value: string | null | undefined): Date | null {
  if (!value) return null;
  const date = new Date(value);
  return Number.isNaN(date.getTime()) ? null : date;
}

/** 查询参数里的布尔值（true/1） */
export const booleanFlagSchema = z
  .union([z.boolean(), z.string()])
  .optional()
  .transform((value) => value === true || value === 'true' || value === '1');

/** 关键字查询 */
export const keywordSchema = z.string().trim().max(64).optional();

/**
 * 附件链接。
 *
 * 只允许 http(s) 绝对地址或站内相对路径：这一层是为**渲染端**兜底 ——
 * 该字段最终会绑到前端的 `<a href>` / `el-link :href` 上，
 * 若放行 `javascript:` / `data:text/html` 就会变成一条存储型 XSS 的注入点。
 * 空串与 null 都表示"没有附件"。
 */
export const attachmentUrlSchema = z
  .string()
  .trim()
  .max(500)
  .refine(
    (value) =>
      value === '' || value.startsWith('/') || /^https?:\/\//i.test(value),
    { message: '附件链接需为 http(s):// 地址或站内相对路径' },
  )
  .nullish();

/** 周次：1..30 */
export const weekNumberSchema = z.coerce.number().int().min(1).max(30);