Menu
Use when building Express routes with validated body and query DTOs plus standardized error responses.
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
Use when scanning NestJS providers with DiscoveryService-backed utilities.
Use when working with the @wisemen/nestjs-custom-fields package — developer-defined custom fields in NestJS with TypeORM persistence and runtime validation. Covers registering the CustomFieldDefinition entity, authoring definitions with customFieldDefinition(), storing resolved values via @CustomFieldValueColumn(), exposing them through CustomFieldValueDto / @IsCustomFields(), and validating submissions with CustomFieldDefinitionsRepository + validateCustomFieldValues(). Use this whenever a task involves custom field definitions, CustomFieldValue columns, custom-field DTOs, or tenant-scoped field definitions, even if the package is not named explicitly.
Use when defining Typesense collections, collectors, and search queries in NestJS APIs.
Generate PDFs through API2PDF in NestJS. Use when converting HTML or URLs to PDFs in apis.
Use when storing and validating multilingual text in NestJS apis with TypeORM and class-validator.
Use when configuring NATS messaging, subscribers, or the simple NatsClient in NestJS applications.
| name | getting-started |
| description | Use when building Express routes with validated body and query DTOs plus standardized error responses. |
Use DtoRouter when an Express route should validate request DTOs before it reaches the controller. Extend Dto for request models, register them in dtos, and throw CustomError for client-facing failures.
import { IsOptional, IsString } from 'class-validator'
import express from 'express'
import {
ControllerOptions,
CustomError,
Dto,
DtoRouter,
} from '@appwise/express-dto-router'
class CreateUserBodyDto extends Dto {
@IsString()
name: string
@IsOptional()
@IsString()
role?: string
}
class ListUsersQueryDto extends Dto {
@IsOptional()
@IsString()
search?: string
}
class UsersController {
async createUser (
{ body, query }: ControllerOptions<{ body: CreateUserBodyDto, query: ListUsersQueryDto }>
) {
if (body.name === 'blocked') {
throw new CustomError('validation_error')
}
return {
name: body.name,
search: query?.search ?? null
}
}
}
const controller = new UsersController()
const router = new DtoRouter()
router.post({
path: '/users',
dtos: {
body: CreateUserBodyDto,
query: ListUsersQueryDto
},
controller: controller.createUser.bind(controller)
})
router.uuidParam('userUuid')
const app = express()
app.use(express.json())
app.use(router.router)
app.use((err, req, res, _next) => {
DtoRouter.handleError(err, req, res).catch(console.error)
})
Use groups inside dtos when the same DTO class needs different validation rules per route. Return ApiResponse instead of plain JSON when the route must control headers or status handling explicitly.