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 line
1.5 KiB
Markdown

**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.