teqo-backup/docs/changelog/2026-09-15-c164.md
Francisco Solla fc6846ebea fix(C164): registra canal de push normalizando expiration string na borda
O events.watch serializa o expiration (int64 epoch ms) como string JSON;
o client tipava number|null e o motor lancava RangeError: Invalid time
value no new Date(...).toISOString(), gravando pushChannelError sem
persistir o canal.

- parseGoogleWatchExpiration (borda do client) normaliza string|number
  para number|null com teto do range do Date; malformado cai no fallback
  de PUSH_CHANNEL_TTL_SECONDS, nunca lanca.
- pushChannelError ganha a causa do fetch (error.cause) preservada no
  teto de 500 chars.
- Unit: stub de transporte modela /watch (string real) + matriz do
  parser; int: caminho number->ISO, fallback null->now+TTL e causa.

Closes #1009
2026-09-15 06:52:50 -03:00

1.5 KiB

C164 — Agenda: canal de push do Google Calendar volta a registrar (expiration int64 em string) (2026-09-15): o events.watch serializa expiration (epoch ms, int64) como string no JSON, mas o client tipava number | null; new Date("1759…").toISOString() lançava RangeError: Invalid time value no catch do ensureGoogleCalendarPushChannel, que gravava pushChannelError e nunca persistia o canal (id/resource/expiresAt) — a direção Google→Teqo (C115) ficava degradada e a operação via "a agenda não atualiza". O parser puro parseGoogleWatchExpiration (src/utilities/googleCalendarClient.ts) normaliza na borda: string → Number; aceita number finito, > 0 e <= MAX_DATE_MS (8.64e15, range do Date); qualquer outro valor (ausente, vazio, NaN, epoch-0/negativo, além do range) vira null, que o motor mapeia para o fallback de PUSH_CHANNEL_TTL_SECONDS sem nunca lançar. O catch do canal passa a anexar (causa: …) de error.cause — o fetch failed intermitente fica diagnosticável — truncando a mensagem base antes do teto de 500 chars para a causa não se perder. Testes: unit do parser (matriz com a string real "1757900000000", number, ausente/malformado/fora-do-range e regressão via watchEvents com stub de transporte que agora modela /watch); int do caminho number → pushChannelExpiresAt ISO, do fallback null → now+30d com canal registrado e da causa no pushChannelError. Sem migration, sem Consent, sem UI; guardrail best-effort e espelho Teqo→Google intocados.