Repository navigation
fix: corrige tres quebras de contrato com a API - #5
Merged
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Três bugs de contrato confirmados lendo os dois lados — CLI e
ararahq-api. Saíram do candidato 4 do architecture review de 25/07.go build ./...,go vet ./...ego test ./...verdes. Cada fix tem teste que falha sem a mudança.O agendamento caía no chão, em silêncio
scheduled_até o único campo snake_case da API inteira — todo o resto é camelCase. O CLI serializavascheduledAt, e comoFAIL_ON_UNKNOWN_PROPERTIESvem desligado no Boot, o campo era descartado sem erro nenhum: o usuário pedia agendamento, recebia 200, e a mensagem saía na hora.Mesma armadilha em
internal/mcp/tools.goeinternal/api/campaigns.go.Regressão provada: revertendo a tag json,
TestSendMessageRequest_SerializesScheduledAtAsSnakeCasefalha.O backend passou a aceitar as duas formas (
@JsonAlias) em https://github.com/ararahq/ararahq-api/pull/196, então o problema não volta pelo próximo cliente. Este fix continua valendo pra quem usa a versão atual da API.O mapa de mensagens amigáveis era 100% inalcançável
friendlyMessagesé indexado pelo código de negócio (ararahq-63016), mas oGlobalExceptionHandlerachatava todoBusinessExceptionemcode = "UNPROCESSABLE_ENTITY"e enterrava o código real emdetails.diagnostic.code. Nenhuma das entradas do mapa era alcançável — o usuário via sempre a string crua.Agora lê
details.diagnostic.codecom fallback proerror.code. Regressão provada: revertendo o lookup,TestParseErrorResponse_ReadsDiagnosticCodefalha.O conflito de listener nunca era reconhecido
webhook_listener.gocomparavaapiError.Code == "capture_listener_active"em minúsculo; o backend emiteCAPTURE_LISTENER_ACTIVE. O branch nunca disparava, então quem tentava escutar com o listener tomado via um conflito genérico em vez de saber quem está com ele e até quando.Os testes usavam a string minúscula, ou seja, codificavam o bug. Corrigi os dois lados e a comparação passou a ser
strings.EqualFold.Falha de ambiente, pré-existente
make lintnão roda nesta máquina: ogolangci-lintinstalado foi compilado com go1.24 e o módulo tem target go1.26.3. Não alterei nada por causa disso — o Makefile já tem o alvo de instalação.