Desenvolvimento de API & Integração de Interfaces

Por favor desenha e coloca em código um set integral de API RESTful pra gerenciamento de usuário.

Requisito de funcionalidade:
- Cadastro de usuário (email + senha, senha cifrada em armazenamento)
- Login de usuário (JWT token)
- Busca de info de usuário (precisa autenticação)
- Muda dados pessoais (precisa autenticação)
- Lista de usuário (página, procura, permissão admin)

Requisito técnico:
1. Estilo RESTful, http method e código de status correto
2. Validação de parâmetro de entrada (Joi/Zod/Pydantic, depende linguagem)
3. Formato único de resposta: { code, data, message }
4. Tratamento de erro integral e log de tudo
5. Gera docs Swagger/OpenAPI
6. Gera conjunto de teste Postman/Insomnia

Por favor usa o tech stack do projeto agora, mantém o estilo de código parecido.

Esse é doc API de serviço terceiro:

[Cola Swagger/OpenAPI JSON ou URL]

Por favor gera SDK client TypeScript:
1. Cada interface vira método (com tipo completo)
2. HTTP client único (baseado em axios/fetch)
3. Interceptor de request: coloca Authorization header automático
4. Interceptor de response: tratamento de erro igual, lógica de retry
5. Suporta timeout de request e cancelamento
6. Exporta todos tipo TypeScript
7. Escreve README e exemplo de uso

SDK precisa suportar tree-shaking, importa só o precisa, não carrega o que não usa.

Por favor coloca no serviço API do projeto middleware:

1. Middleware limitador de taxa (Rate Limiting):
   - Padrão: cada IP máximo 60 requisição/minuto
   - Interface de login: cada IP máximo 5/minuto
   - Retorna header X-RateLimit-*
   - Acima do limite volta 429 + mensagem amigável

2. Middleware autenticação (Authentication):
   - Validação JWT Token
   - Refresh automático de token (mecanismo Refresh Token)
   - Checagem de permissão por papel (admin / user / guest)

3. Middleware de log (Logging):
   - Registra método, caminho, tempo de execução, código de status de cada request
   - Request que errou registra corpo e stack automático
   - Formato de log combina com ELK ou CloudWatch

Garantir que ordem de middleware está certo, mostra código de registrar à rota.