test(notificacoes): a cópia à mão do snapshot do servidor ganha vigia

Acabamento do #695. `getServerSnapshot` precisa de um valor determinístico, e
derivá-lo chamando `prefsPadrao()` no escopo do módulo leria o `localStorage` de
verdade no navegador — justamente o que ele existe para não fazer. Então
`PREFS_DO_SERVIDOR` é uma duplicata deliberada, e estava certa.

O que faltava era o vigia. Quem acrescentar uma categoria a
`NOTIFY_UI_CATEGORIES` muda `prefsPadrao()` e não muda o objeto congelado; aí
`getServerSnapshot` devolve um objeto SEM aquela chave, o componente lê
`prefs[cat][canal]` e estoura — ou, pior, o React vê valores diferentes dos dois
lados e o defeito de hidratação da #690 volta calado, que é a forma exata em que
ele viveu até agora.

A comparação roda com `window` apagado de propósito: é a única condição em que
`prefsPadrao()` é determinístico, e é a condição em que o servidor roda.

Tem controle de vacuidade — sem ele, o caso das categorias passaria com a lista
vazia.

Trabalho original de @dajiaohuang no PR #695.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

Author: Pessoa

lib/notifications/prefs.ts

@@ -101,7 +101,20 @@ const PREFS_DO_SERVIDOR: NotifyPrefs = {
   mention: { in_app: true, push: true },
 };
 
-/** Sem `window`, `prefsPadrao()` devolve exatamente este valor — congelado aqui. */
+/**
+ * Sem `window`, `prefsPadrao()` devolve exatamente este valor — congelado aqui.
+ *
+ * É uma DUPLICATA deliberada, e ela não pode ser derivada: chamar
+ * `prefsPadrao()` no escopo do módulo leria o `localStorage` de verdade no
+ * navegador, que é justamente o que este valor existe para não fazer.
+ *
+ * Duplicata sem vigia diverge. Quem acrescentar uma categoria a
+ * `NOTIFY_UI_CATEGORIES`, ou mudar um padrão, muda `prefsPadrao()` e não muda
+ * este objeto — e o desfecho é a volta silenciosa do defeito que o PR #695
+ * consertou, ou pior: `getServerSnapshot` devolvendo um objeto sem a chave que
+ * o componente vai ler. O vigia é
+ * `tests/unit/prefs-do-servidor-nao-diverge-do-padrao.test.ts`.
+ */
 export function getPrefsSnapshotDoServidor(): NotifyPrefs {
   return PREFS_DO_SERVIDOR;
 }

tests/unit/prefs-do-servidor-nao-diverge-do-padrao.test.ts

@@ -0,0 +1,61 @@
+/**
+ * O SNAPSHOT DO SERVIDOR É UMA CÓPIA À MÃO — ESTE ARQUIVO É O QUE A IMPEDE DE DIVERGIR.
+ *
+ * `lib/notifications/prefs.ts` guarda `PREFS_DO_SERVIDOR` escrito à mão, e a
+ * duplicata é deliberada: derivar o valor chamando `prefsPadrao()` no escopo do
+ * módulo leria o `localStorage` de verdade no navegador, que é exatamente o que
+ * `getServerSnapshot` existe para não fazer.
+ *
+ * Mas duplicata sem vigia diverge. Acrescentar uma categoria a
+ * `NOTIFY_UI_CATEGORIES` muda `prefsPadrao()` e não muda o objeto congelado — e
+ * aí `getServerSnapshot` devolve um objeto SEM aquela chave. O componente lê
+ * `prefs[cat][canal]` e estoura, ou (pior) o React vê valores diferentes dos
+ * dois lados e o defeito de hidratação do #690 volta calado.
+ *
+ * A comparação tem de ser feita SEM `window` — é a única condição em que
+ * `prefsPadrao()` é determinístico, e é a condição em que o servidor roda.
+ */
+import { afterEach, describe, expect, it } from "vitest";
+
+import { NOTIFY_UI_CATEGORIES, getPrefsSnapshotDoServidor, prefsPadrao } from "@/lib/notifications/prefs";
+
+const janelaReal = globalThis.window;
+
+afterEach(() => {
+  globalThis.window = janelaReal;
+});
+
+/** O que `prefsPadrao()` produz num Node sem DOM — o que o servidor de verdade vê. */
+function padraoSemJanela() {
+  // @ts-expect-error — apagar de propósito, para `typeof window === "undefined"` ser verdade.
+  delete globalThis.window;
+  try {
+    return prefsPadrao();
+  } finally {
+    globalThis.window = janelaReal;
+  }
+}
+
+describe("o snapshot do servidor é idêntico ao padrão que o servidor produz", () => {
+  it("CONTROLE: sem este caso, os de baixo passariam com a lista vazia", () => {
+    expect(NOTIFY_UI_CATEGORIES.length).toBeGreaterThanOrEqual(5);
+  });
+
+  it("os dois objetos são iguais em profundidade", () => {
+    expect(
+      getPrefsSnapshotDoServidor(),
+      "`PREFS_DO_SERVIDOR` divergiu de `prefsPadrao()`. Quem mudar um tem de " +
+        "mudar o outro — senão o servidor e a primeira renderização do cliente " +
+        "voltam a discordar, que é o defeito da issue #690.",
+    ).toEqual(padraoSemJanela());
+  });
+
+  it("toda categoria declarada existe no snapshot do servidor, nos dois canais", () => {
+    const doServidor = getPrefsSnapshotDoServidor();
+    for (const categoria of NOTIFY_UI_CATEGORIES) {
+      expect(doServidor[categoria], `categoria \`${categoria}\` ausente`).toBeDefined();
+      expect(typeof doServidor[categoria].in_app).toBe("boolean");
+      expect(typeof doServidor[categoria].push).toBe("boolean");
+    }
+  });
+});