Communitygithub.com

YepAPI/skills

Padrões para Express.js e Fastify: middleware, organização de rotas, validação com Zod, tratamento de erros, sistema de plugins, ciclo de vida da requisição e configuração TypeScript.

O que é skills?

Esta habilidade fornece um conjunto abrangente de regras e padrões para desenvolvimento com Express.js e Fastify, dois dos frameworks web mais populares para Node.js. Ela cobre desde a organização modular de rotas por domínio até a validação rigorosa de entrada com Zod, garantindo que todos os dados do cliente sejam verificados antes do processamento. Além disso, a habilidade orienta a implementação de um tratamento centralizado de erros, tanto no Express quanto no Fastify, promovendo uma resposta consistente e facilitando a depuração. Para equipes que utilizam TypeScript, ela demonstra como usar genéricos para tipar requisições e respostas de forma segura. A habilidade também aborda práticas essenciais como ordem correta de middlewares, uso do sistema de plugins do Fastify para encapsulamento, definição de schemas com `@fastify/type-provider-zod`, endpoints de health check e desligamento gracioso. O objetivo é ajudar desenvolvedores a construir APIs robustas, modulares e de fácil manutenção, evitando armadilhas comuns como lógica de negócio em handlers de rota e validação insuficiente do lado do servidor.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YepAPI/skills/tree/HEAD/skills/express-fastify

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Express & Fastify

Regras

  • Organize rotas por domínio: routes/users.ts, routes/orders.ts — um roteador por recurso
  • Valide toda entrada com Zod: analise req.body, req.params, req.query antes de processar
  • Manipulador de erro centralizado: middleware "catch-all" (Express) ou setErrorHandler (Fastify)
  • Retorne formato de erro consistente: { error: { code: string, message: string, details?: unknown } }
  • TypeScript: tipar requisição/resposta com genéricos — Request<Params, ResBody, ReqBody, Query>
  • Ordem dos middlewares: CORS, body parser, autenticação, rate limiting, rotas, manipulador de erro
  • Use handlers de rota assíncronos — envolva com captura de erros ou use express-async-errors
  • Fastify: use o sistema de plugins para encapsular rotas e decoradores — fastify.register()
  • Fastify schemas: defina JSON Schema ou use @fastify/type-provider-zod para validação + serialização
  • Health check: GET /health — retorne 200 com status de conectividade do banco/Redis
  • Desligamento gracioso: ouça SIGTERM, pare de aceitar conexões, finalize requisições em andamento

Padrões

// Express + validação Zod
import { Router } from "express";
import { z } from "zod";

const router = Router();
const CreateUserSchema = z.object({ email: z.string().email(), name: z.string().min(1) });

router.post("/users", async (req, res, next) => {
  try {
    const body = CreateUserSchema.parse(req.body);
    const user = await createUser(body);
    res.status(201).json(user);
  } catch (err) { next(err); }
});
// Fastify + provedor de tipo Zod
import Fastify from "fastify";
import { serializerCompiler, validatorCompiler, ZodTypeProvider } from "fastify-type-provider-zod";

const app = Fastify().withTypeProvider<ZodTypeProvider>();
app.setValidatorCompiler(validatorCompiler);
app.setSerializerCompiler(serializerCompiler);

app.post("/users", { schema: { body: CreateUserSchema } }, async (req) => {
  return createUser(req.body); // totalmente tipado
});

Evite

  • Colocar lógica de negócio em handlers de rota — extraia para camada de serviço/domínio
  • Esquecer o tratamento de erro assíncrono no Express — rejeições não tratadas quebram o processo
  • Importar todas as rotas em um único arquivo — use router.use() ou plugins do Fastify para modularidade
  • Pular validação de entrada porque "o frontend valida" — sempre valide no lado do servidor

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

YepAPI/skills

WCAG 2.1 AA — semantic HTML, keyboard navigation, screen readers.

YepAPI/skills

Experiment setup, variant splitting, statistical significance, and feature flag integration.

YepAPI/skills

CRUD generators, data tables, user management, role-based access, and bulk operations.

YepAPI/skills

Monitor what ChatGPT and Gemini say about your brand using YepAPI.

YepAPI/skills

Queue workers with BullMQ/Inngest/Trigger.dev, job retries, dead letter queues, concurrency.

YepAPI/skills

Commander.js, interactive prompts with Clack, spinners, colors, config files, exit codes, and npm publishing.

YepAPI/skills

cmdk integration, Cmd+K trigger, fuzzy search, grouped actions, keyboard navigation, and dynamic action registration.

YepAPI/skills

Content planning with trend and sentiment data from YepAPI.

YepAPI/skills

Content calendar, keyword-driven planning, and content briefs.

YepAPI/skills

Theme switching with CSS variables, system preference detection, next-themes, and persistence.

YepAPI/skills

Threaded comments, @mentions, reactions, moderation queue, optimistic UI, and cursor pagination.

YepAPI/skills

Competitive analysis between domains using YepAPI.

YepAPI/skills

Layout grids, KPI cards, data tables with sorting/filtering, sidebar navigation, and responsive breakpoints.

YepAPI/skills

Data encryption — TLS everywhere, AES-256-GCM for PII, bcrypt passwords, encrypted backups.

YepAPI/skills

Chart patterns with Recharts/Nivo/D3, responsive containers, color scales, and accessibility.

YepAPI/skills

Drizzle schema definition, push vs migrate, type-safe queries, relations, transactions, and prepared statements.

YepAPI/skills

Upload handling, resize/compress, CDN delivery, blur placeholders, and next/image patterns.

YepAPI/skills

Local business and Google Maps research using YepAPI.

YepAPI/skills

Cursor-based pagination, IntersectionObserver, virtualized lists with @tanstack/react-virtual, and scroll position restoration.

YepAPI/skills

Chat UI components, streaming responses with AI SDK, context window management, and RAG patterns.

Habilidades Relacionadas