feat: PAV-33: api error contract handler (code / message / details)

[Benevanio]

No description provided.

[Copilot]

Pull request overview

Padroniza o contrato de erro da API no formato { code, message, details? } e ajusta backend e frontend para produzir/consumir esse envelope de forma consistente, centralizando validação e serialização de erros.

Changes:

• Backend: introduz AppError, validate middleware e atualiza controllers/services + errorHandler para retornarem { code, message, details? }.
• Backend: atualiza rotas para validar payload/params com Zod e propagar erros via next() (async controllers).
• Frontend: adiciona ApiError/parseApiError e integra no apiClient (axios) e authApi, com novos/ajustados testes.

Reviewed changes

Copilot reviewed 36 out of 36 changed files in this pull request and generated 7 comments.

Show a summary per file

File	Description
frontend/tests/unit/utils/apiError.test.ts	Novos testes unitários para parsing do envelope {code/message/details} e formatos legados.
frontend/tests/unit/services/auth.service.test.tsx	Ajusta/expande testes para verificar ApiError e code vindo do envelope.
frontend/src/shared/lib/apiError.ts	Implementa ApiError e parseApiError para normalizar erros do backend.
frontend/src/shared/lib/apiClient.ts	Integra parseApiError no interceptor de resposta do axios.
frontend/src/domains/auth/infrastructure/authApi.ts	Substitui criação de Error genérico por parseApiError em respostas não-OK.
backend/tests/unit/modules/users/users.service.test.ts	Atualiza expectativas para erros tipados (ex.: NOT_FOUND).
backend/tests/unit/modules/users/user.controller.test.ts	Atualiza testes para controllers async lançarem AppError ao invés de escreverem diretamente no res.
backend/tests/unit/modules/savedJobs/savedJobs.service.test.ts	Atualiza expectativas para erros tipados (CONFLICT, NOT_FOUND).
backend/tests/unit/modules/savedJobs/savedJobs.controller.test.ts	Atualiza testes para controllers async lançarem AppError e propagarem erros inesperados.
backend/tests/unit/modules/auth/credentials.service.test.ts	Atualiza expectativas para erros tipados (CONFLICT, UNAUTHORIZED, NOT_FOUND).
backend/tests/unit/modules/auth/credentials.controller.test.ts	Ajusta testes para controllers propagarem AppError ao invés de mapear status manualmente.
backend/tests/unit/modules/auth/auth.controller.test.ts	Remove testes de validação local (agora delegada a middleware/rotas) e simplifica mocks.
backend/tests/unit/middleware/validate.test.ts	Novos testes para middleware validate (body/query/params e conversão de ZodError).
backend/tests/unit/middleware/requireAuth.test.ts	Novos testes para requireAuth retornando envelope padronizado.
backend/tests/unit/middleware/errorHandler.test.ts	Expande testes para serialização de AppError, conversão de ZodError e comportamento por ambiente.
backend/tests/unit/lib/errors.test.ts	Novos testes para factories do AppError e fromZodError.
backend/tests/unit/app.test.ts	Atualiza asserts para respostas de CORS no envelope {code,message}.
backend/tests/integration/routes/user.routes.test.ts	Ajusta teste de validação para verificar code/message/details.
backend/tests/integration/routes/savedJobs.routes.test.ts	Ajusta integração para envelope de erro e uso de AppError em mocks.
backend/tests/integration/routes/auth.routes.test.ts	Ajusta integração para envelope de erro em validações e falhas internas.
backend/src/routes/users.routes.ts	Adiciona validate e .catch(next) para controllers async; valida schemas do domínio.
backend/src/routes/savedJobs.routes.ts	Adiciona validate e .catch(next); valida schemas de saved jobs.
backend/src/routes/auth.routes.ts	Adiciona validate em params/body e .catch(next) para controllers async.
backend/src/modules/users/users.service.ts	Troca Error genérico por AppError.notFound(...).
backend/src/modules/users/users.controller.ts	Remove try/catch local e lança AppError (delegando serialização ao errorHandler).
backend/src/modules/users/schemas/user.schemas.ts	Expõe createPreferencesSchema alinhado ao update.
backend/src/modules/savedJobs/schemas/savedJobs.schemas.ts	Novo schema Zod para create/update de saved jobs.
backend/src/modules/savedJobs/savedJobs.service.ts	Troca Error genérico por AppError.conflict/notFound.
backend/src/modules/savedJobs/savedJobs.controller.ts	Remove validação/handler local e lança AppError (delegando ao errorHandler).
backend/src/modules/auth/credentials.service.ts	Migra para AppError e ajusta fluxo de register/login (com mudanças estruturais).
backend/src/modules/auth/credentials.controller.ts	Remove parsing/try-catch local e passa a propagar erros (tratados pelo errorHandler).
backend/src/modules/auth/auth.controller.ts	Remove validação local em getUrl (agora validada na rota) e tipa oauth_state.
backend/src/middleware/validate.ts	Novo middleware para validar body/query/params e converter ZodError em AppError.
backend/src/middleware/requireAuth.ts	Padroniza resposta 401 no envelope {code,message} via AppError.
backend/src/middleware/errorHandler.ts	Centraliza serialização do envelope e trata CORS/ZodError/AppError.
backend/src/lib/errors.ts	Implementa AppError + factories + fromZodError + toJSON.