佐德图案

其他 社区

技能解读

当前原文的自动摘译,尚未人工审校。

项目自定义验证器

地点:apps/core/src/common/zod/

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
通用
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
94 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@mx-space · NOASSERTION
上下文用量评级
低消耗
接入复杂程度
即装即用
是否需要外部接口密钥
不需要
兼容的系统
未声明(默认跨平台)
运行环境要求
未检出明确要求
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

作者说明文件(原文) SKILL.md

# Zod Schema Patterns

## Basic Pattern

```typescript
import { z } from 'zod'
import { createZodDto } from 'nestjs-zod'

// Define Schema
export const MySchema = z.object({
  name: z.string().min(1),
  email: z.string().email(),
  age: z.number().int().positive().optional(),
})

// Create DTO class
export class MyDto extends createZodDto(MySchema) {}

// Partial DTO for updates
export class PartialMyDto extends createZodDto(MySchema.partial()) {}
```

## Project Custom Validators

Location: `apps/core/src/common/zod/`

```typescript
import {
  // From primitives.ts:
  zNonEmptyString,       // Non-empty string (z.string().min(1))
  zCoerceInt,            // Coerced integer
  zCoercePositiveInt,    // Coerced positive integer
  zCoerceBoolean,        // Coerced boolean (handles 'true'/'1'/1/etc.)
  zCoerceDate,           // Coerced date
  zOptionalDate,         // Optional date (null/empty → undefined)
  zOptionalBoolean,      // Optional coerced boolean
  zEmptyStringToNull,    // Empty string → null, else string
  zNilOrString,          // string | null | undefined
  zHexColor,             // Hex color (#fff or #ffffff)
  zAllowedUrl,           // HTTP or HTTPS URL
  zStrictUrl,            // Strict URL validation
  zHttpsUrl,             // HTTPS-only URL
  zPaginationPage,       // Coerced int, min 1, default 1
  zPaginationSize,       // Coerced int, min 1, max 50, default 20
  zSortOrder,            // 1 | -1 | undefined (accepts 'asc'/'desc')
  zArrayUnique,          // Unique array elements (generic)
  zUniqueStringArray,    // Unique non-empty string array

  // From custom.ts:
  zBooleanOrString,      // boolean | string union
  zTransformEmptyNull,   // Empty string → null (generic wrapper)
  zTransformBoolean,     // Transform to optional boolean
  zPinDate,              // Pin date (Date | null | undefined, true=now, false=null)
  zSlug,                 // Slug string (trimmed)
  zEmail,                // Email with custom message
  zUrl,                  // URL with custom message
  zMaxLengthString,      // Max length string factory
  zRefTypeTransform,     // Content ref type ('post'→'Post', etc.)
  zPrefer,               // 'lexical' enum optional
  zLang,                 // 2-char language code

  // From shared/id/entity-id.ts:
  zEntityId,             // Snowflake entity ID string validation
  zEntityIdOrInt,        // Entity ID or positive integer union
} from '~/common/zod'
```

## Entity ID Validation

```typescript
import { zEntityId } from '~/common/zod'

const Schema = z.object({
  id: zEntityId,                    // Snowflake ID string
  categoryId: zEntityId,            // Foreign key reference
  relatedIds: z.array(zEntityId),   // Array of entity IDs
})

// For DTOs used in path params:
import { EntityIdDto } from '~/shared/dto/id.dto'
// EntityIdDto = { id: zEntityId }
```

## Extending Base Schemas

```typescript
// Compose schemas using .extend()
const PostSchema = z.object({
  title: zNonEmptyString,
  slug: zSlug,
  categoryId: zEntityId,
  tags: z.array(z.string()).optional(),
  contentFormat: z.enum(['markdown', 'lexical']),
})
```

## Common Patterns

### Optional Fields with Defaults

```typescript
z.boolean().default(true).optional()
z.number().default(0).optional()
z.array(z.string()).default([]).optional()
```

### Preprocessing

```typescript
// Empty string to null
z.preprocess(
  (val) => (val === '' ? null : val),
  z.string().nullable()
).optional()

// String to number
z.preprocess(
  (val) => (typeof val === 'string' ? parseInt(val, 10) : val),
  z.number()
)
```

### Union Types

```typescript
z.union([z.string(), z.number()])
z.enum(['draft', 'published', 'archived'])
```

### Array Validation

```typescript
// Basic array
z.array(z.string())

// Length constraints
z.array(z.string()).min(1).max(10)

// Unique elements
zArrayUnique(z.string())
```

### Nested Objects

```typescript
const AddressSchema = z.object({
  street: z.string(),
  city: z.string(),
})

const UserSchema = z.object({
  name: z.string(),
  address: AddressSchema.optional(),
  addresses: z.array(AddressSchema).optional(),
})
```

### Conditional Validation

```typescript
// refine for custom validation
z.object({
  password: z.string(),
  confirmPassword: z.string(),
}).refine(
  (data) => data.password === data.confirmPassword,
  { message: 'Passwords must match' }
)
```

## Type Inference

```typescript
// Infer type from Schema
type MyType = z.infer<typeof MySchema>

// Use in Service
async create(data: z.infer<typeof MySchema>) {
  return this.repository.create(data)
}
```

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。