Skip to content

fix: corrige tres quebras de contrato com a API - #5

Merged
micaelmrq merged 4 commits into
mainfrom
fix/contrato-com-a-api
Jul 27, 2026
Merged

micaelmrq merged 4 commits into
mainfrom
fix/contrato-com-a-api

Conversation

@micaelmrq

Copy link
Copy Markdown
Member

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 ./... e go 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 serializava scheduledAt, e como FAIL_ON_UNKNOWN_PROPERTIES vem 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.go e internal/api/campaigns.go.

Regressão provada: revertendo a tag json, TestSendMessageRequest_SerializesScheduledAtAsSnakeCase falha.

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 o GlobalExceptionHandler achatava todo BusinessException em code = "UNPROCESSABLE_ENTITY" e enterrava o código real em details.diagnostic.code. Nenhuma das entradas do mapa era alcançável — o usuário via sempre a string crua.

Agora lê details.diagnostic.code com fallback pro error.code. Regressão provada: revertendo o lookup, TestParseErrorResponse_ReadsDiagnosticCode falha.

O conflito de listener nunca era reconhecido

webhook_listener.go comparava apiError.Code == "capture_listener_active" em minúsculo; o backend emite CAPTURE_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 lint não roda nesta máquina: o golangci-lint instalado 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.

@micaelmrq
micaelmrq merged commit fa8eaa6 into main Jul 27, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant