Changelog

Todas as mudanças relevantes deste projeto são documentadas aqui. O formato segue Keep a Changelog e o projeto adota SemVer.

Histórico completo

Esta página lista os destaques recentes. O histórico versão a versão (0.2.0–0.11.0) vive no CHANGELOG.md do repositório.

[0.20.1] — 2026-07-09

Alterado

• deps: tempest-db-js para >=0.4.0 (peer), ^0.4.0 (dev) e no template do CLI. Sem mudança de API; build e suíte completa verdes no 0.4.0.

Corrigido

• api: o Swagger UI agora carrega os assets ao ser acessado em /docs (sem barra final), não só em /docs/. O HTML referenciava os assets por caminho relativo (./assets/…), que o navegador resolvia contra /docs para /assets/… — um 404 que deixava a página em branco/sem estilo. As URLs dos assets agora são absolutas (/docs/assets/…) e resolvem nos dois caminhos.

Docs

• Nova receita Schemas (base, resposta e paginação) — toDict, baseResponseSchema, o padrão Create/Update/Response e paginação por offset vs. cursor.
• Nova receita API: createApp, OpenAPI, Swagger e Redoc — referência completa das opções do createApp, o hook configure e a cablagem de OpenAPI em 3 passos.

[0.20.0] — 2026-07-06

Adicionado

• db: wrapWithSlowQueryLog (log de queries lentas via wrap de driver) e backupDatabase (backup por dialeto: pg_dump/cópia SQLite). auth: renderAuthResultPage / renderPasswordResetFormPage (páginas HTML opcionais).

[0.19.0] — 2026-07-06

Adicionado

• storage: S3UploadStorage (mesma interface UploadStorage sobre MinIO/S3, peer minio opcional). cli: lint, config e user.

[0.18.0] — 2026-07-06

Adicionado

• utils: sendFileDownload (Range/206), sendBytesDownload, resolveDownloadPath (anti-traversal) e configureFileLogging (arquivos por nível + 500.log); core addLogSink; api makeLogsRouter.

[0.17.0] — 2026-07-06

Adicionado

• schemas: tipos de campo validados (centsField, priceField, slugField, hexColorField, percentField, latitudeField, …), paginação delta-sync (syncFilterSchema / syncPaginationSchema), buildPaginationLinkHeader (RFC-5988) e logEntrySchema.

[0.16.0] — 2026-07-06

Adicionado

• api: clientes OAuth2/OIDC (GoogleOAuthClient, GitHubOAuthClient, OIDCProvider) + generateOAuthState, WebhookSignatureVerifier (HMAC em tempo constante sobre o corpo cru) e makeToolSpecRouter (manifesto em /tool-spec).

[0.15.0] — 2026-07-06

Adicionado

• db: camada avançada — TenantScopedRepository (isolamento multi-tenant), BaseOutboxModel + OutboxRelay (outbox transacional), BaseAuditLogModel + snapshot/diffSnapshots (trilha de auditoria) e modelos base opt-in BaseUserModel / BaseUserTokenModel / BaseUserRefreshTokenModel.

[0.14.0] — 2026-07-06

Adicionado

• testing: helpers de banco em memória agnósticos de framework — createTestDatabase(models) sobe um engine tempest-db-js sobre SQLite em memória com as tabelas refletidas dos models; withTestDatabase(models, fn) escopa a um bloco e sempre fecha.

[0.13.0] — 2026-07-06

Adicionado

• api/middlewares: middlewares de endurecimento HTTP — rateLimitMiddleware (janela deslizante; store memória + Redis; chaves por IP/header/JWT), bodySizeLimitMiddleware (413), csrfMiddleware + generateCsrfToken, idempotencyMiddleware (store memória + Redis), GracefulShutdown, requestTracingMiddleware e prometheusMiddleware / HttpMetrics.

Alterado

• api: requestIdMiddleware valida o X-Request-ID de entrada contra uma whitelist ASCII antes de reusá-lo (evita CRLF/log injection).

[0.12.0] — 2026-07-06

Adicionado

• settings: fragmentos de settings por domínio, espelhando os mixins do tempest-fastapi-sdk — authSettingsShape, jwtSettingsShape, emailSettingsShape, redisSettingsShape, rabbitmqSettingsShape, sessionSettingsShape, uploadSettingsShape, minioSettingsShape, webPushSettingsShape, webSocketSettingsShape, logSettingsShape, tokenSettingsShape (mesmos nomes de env + defaults). Mais os helpers envBoolean (parseia "false" como false) e envList (CSV → string[]).

Documentação

• recipes/settings: novo guia bilíngue de settings tipados.
• recipes/database: novo guia bilíngue (models + repositories).

[0.1.0] — 2026-06-29

Adicionado

• Fundação: tooling TypeScript rígido, alias @ (sem .js), build dual ESM + CJS + .d.ts (tsup), Biome e Vitest.
• core: JSONLogger, contexto de request-id (AsyncLocalStorage), defineEnum.
• exceptions: AppException + subclasses HTTP (Conflict, NotFound, Unauthorized, Forbidden, Validation, TooManyRequests, InvalidToken, ExpiredToken), MessageCatalog (i18n) e registerExceptionHandlers.
• schemas: z com OpenAPI, baseResponseSchema, paginação offset e cursor.
• settings: loadSettings, baseAppSettingsShape.
• db: re-export do tempest-db-js, BaseModel e helpers de coluna.
• services / controllers: BaseService, BaseController.
• utils: CPF/CNPJ/CEP/telefone/UF + cidades, datetime, dict, tokens opacos, AttemptThrottle, PasswordUtils (bcrypt), JWTUtils.
• auth: schemas, UserAuthService, middleware JWT, guardas de role, makeAuthRouter.
• api: createApp, runServer, Swagger UI + Redoc nativos, health.
• CLI: new, generate, secret, docker-compose, db.

Pendente

Ainda não portado do tempest-fastapi-sdk: sessions, cache (Redis), queue (RabbitMQ), tasks, webpush, websockets, feature flags, storage, metrics, admin, SSE, e os fluxos de MFA / email / reset de senha.