refactor(realtime): gedeelde SSE-opzet in lib/realtime/sse.ts #389

Merged
janpeter merged 1 commit from feat/story-dvqb9lbm into main 2026-10-18 20:28:42 +02:00
Owner

Waarom

De zeven SSE-routes onder app/api/realtime/* herhaalden dezelfde opzet:

  • de constanten HEARTBEAT_MS en HARD_CLOSE_MS;
  • de opening: shutdown-weigering en een 401 bij niet ingelogd;
  • de keuze DIRECT_URL ?? DATABASE_URL met een 500 als die ontbreekt;
  • de SSE-headers.

Die staan nu in één helper. Het gedrag blijft exact gelijk: dezelfde statuscodes, foutteksten en headers, en de controles in dezelfde volgorde.

Gebouwd door de agent-harness (qwen3.8-or via OpenRouter, venster 65k). Dit is run 3 van de modelvergelijking in PBI-207 (taak T-2163, story ST-1685, sprint S-2026-10-18-1).

Wat

  • Nieuw: lib/realtime/sse.ts
    • SSE_HEARTBEAT_MS en SSE_HARD_CLOSE_MS;
    • openSseSession(): 503 tijdens shutdown, anders 401 zonder login, anders de sessie;
    • resolveListenUrl(): de verbindings-URL, met een 500 als die ontbreekt;
    • sseResponse(stream): de vier headers, waaronder Connection: close uit ISS-13.
  • Nieuw: __tests__/lib/realtime-sse.test.ts. Dekt alle paden: shutdown, 401, sessie, beide URL-bronnen, de 500, de headers en de constanten.
  • Zeven routes (backlog, issues, jobs, notifications, solo, sprint, user-settings):
    • de vier blokken zijn vervangen door de helper, op dezelfde plek;
    • in backlog, solo en sprint blijven de 400- en 403-controles vóór de URL-controle staan;
    • issues houdt onShutdown.
  • Ongewijzigd: hub/events, de pair-stream, de debug-stream, session-stream-lifetime, notify-hub en de bestaande tests.

Verificatie

  • Harness-gate in de container: lint, typecheck en vitest groen.
  • Lokaal nagelopen op 6612104c:
    • npm run verify: exit 0. Vitest 443 bestanden en 4691 tests groen. Eslint gaf 0 fouten en 8 bestaande warnings, geen daarvan in de gewijzigde bestanden.
    • De zeven bestaande realtime-tests en de nieuwe test zijn ongewijzigd groen (53 tests).
    • Grep op HEARTBEAT_MS = |HARD_CLOSE_MS = |X-Accel-Buffering|Niet ingelogd|niet geconfigureerd in app/api/realtime/*/route.ts: leeg.
    • De branch staat niet achter main en de merge geeft geen conflict.
  • npm run build is in een worktree niet uitvoerbaar, omdat .env ontbreekt. CI bouwt.

🤖 Generated with Claude Code

## Waarom De zeven SSE-routes onder `app/api/realtime/*` herhaalden dezelfde opzet: - de constanten `HEARTBEAT_MS` en `HARD_CLOSE_MS`; - de opening: shutdown-weigering en een 401 bij niet ingelogd; - de keuze `DIRECT_URL ?? DATABASE_URL` met een 500 als die ontbreekt; - de SSE-headers. Die staan nu in één helper. Het gedrag blijft exact gelijk: dezelfde statuscodes, foutteksten en headers, en de controles in dezelfde volgorde. Gebouwd door de agent-harness (qwen3.8-or via OpenRouter, venster 65k). Dit is run 3 van de modelvergelijking in PBI-207 (taak T-2163, story ST-1685, sprint S-2026-10-18-1). ## Wat - **Nieuw: `lib/realtime/sse.ts`** - `SSE_HEARTBEAT_MS` en `SSE_HARD_CLOSE_MS`; - `openSseSession()`: 503 tijdens shutdown, anders 401 zonder login, anders de sessie; - `resolveListenUrl()`: de verbindings-URL, met een 500 als die ontbreekt; - `sseResponse(stream)`: de vier headers, waaronder `Connection: close` uit ISS-13. - **Nieuw: `__tests__/lib/realtime-sse.test.ts`**. Dekt alle paden: shutdown, 401, sessie, beide URL-bronnen, de 500, de headers en de constanten. - **Zeven routes** (backlog, issues, jobs, notifications, solo, sprint, user-settings): - de vier blokken zijn vervangen door de helper, op dezelfde plek; - in backlog, solo en sprint blijven de 400- en 403-controles vóór de URL-controle staan; - issues houdt `onShutdown`. - **Ongewijzigd:** `hub/events`, de pair-stream, de debug-stream, `session-stream-lifetime`, `notify-hub` en de bestaande tests. ## Verificatie - Harness-gate in de container: lint, typecheck en vitest groen. - Lokaal nagelopen op 6612104c: - `npm run verify`: exit 0. Vitest 443 bestanden en 4691 tests groen. Eslint gaf 0 fouten en 8 bestaande warnings, geen daarvan in de gewijzigde bestanden. - De zeven bestaande realtime-tests en de nieuwe test zijn ongewijzigd groen (53 tests). - Grep op `HEARTBEAT_MS = |HARD_CLOSE_MS = |X-Accel-Buffering|Niet ingelogd|niet geconfigureerd` in `app/api/realtime/*/route.ts`: leeg. - De branch staat niet achter main en de merge geeft geen conflict. - `npm run build` is in een worktree niet uitvoerbaar, omdat `.env` ontbreekt. CI bouwt. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
SSE-65k — SSE-opzet realtime-routes onderbrengen in lib/realtime/sse.ts
All checks were successful
CI / DB Access Policy Gate (pull_request) Successful in 1m47s
CI / Queue Dispatch Guard Gate (pull_request) Successful in 2m10s
CI / Lint, Typecheck, Test & Build (pull_request) Successful in 7m35s
CI / DB Access Production Sentinel (pull_request) Successful in 10s
6612104c56
janpeter scheduled this pull request to auto merge when all checks succeed 2026-10-18 20:24:45 +02:00
s4m-codex-reviewer left a comment

APPROVED

  • Geen findings.

plan gekoppeld via pr_refs: T-2163, ST-1685. De diff voldoet aan de geraakte acceptatiecriteria: de helper en unittests zijn aanwezig, alle zeven routes gebruiken de helper en statuscodes, foutteksten, headers en controlevolgorde blijven behouden. De uitgesloten routes, stream-levensloop, bestaande tests en vendor zijn ongewijzigd. Geen weggelaten planonderdelen.

De code sluit aan op het productpatroon ‘SSE-routes en graceful shutdown’: shutdown-weigering vóór authenticatie, behoud van cleanup en Connection: close. De helper documenteert zijn verantwoordelijkheid; aanvullende functionele documentatie is voor deze gedragsneutrale refactor niet nodig.

Verificatie op 6612104c5621135600e070e920eaa4bf5bcbc4b8: actuele Forgejo-diff identiek aan payload; 53 gerichte tests groen; grep-controle leeg; lint 0 fouten (8 waarschuwingen buiten de diff); typecheck groen met verhoogde Node-heaplimiet; volledige suite 443 bestanden en 4691 tests geslaagd, 38 tests overgeslagen (onder meer zonder testdatabase). Na ophalen van gitgeschiedenis en weglaten van aanwezige VAPID-variabelen is de volledige testrun groen. Forgejo-CI inclusief build en database-/dispatch-gates is eveneens groen.

# APPROVED - Geen findings. plan gekoppeld via pr_refs: T-2163, ST-1685. De diff voldoet aan de geraakte acceptatiecriteria: de helper en unittests zijn aanwezig, alle zeven routes gebruiken de helper en statuscodes, foutteksten, headers en controlevolgorde blijven behouden. De uitgesloten routes, stream-levensloop, bestaande tests en vendor zijn ongewijzigd. Geen weggelaten planonderdelen. De code sluit aan op het productpatroon ‘SSE-routes en graceful shutdown’: shutdown-weigering vóór authenticatie, behoud van cleanup en `Connection: close`. De helper documenteert zijn verantwoordelijkheid; aanvullende functionele documentatie is voor deze gedragsneutrale refactor niet nodig. Verificatie op `6612104c5621135600e070e920eaa4bf5bcbc4b8`: actuele Forgejo-diff identiek aan payload; 53 gerichte tests groen; grep-controle leeg; lint 0 fouten (8 waarschuwingen buiten de diff); typecheck groen met verhoogde Node-heaplimiet; volledige suite 443 bestanden en 4691 tests geslaagd, 38 tests overgeslagen (onder meer zonder testdatabase). Na ophalen van gitgeschiedenis en weglaten van aanwezige VAPID-variabelen is de volledige testrun groen. Forgejo-CI inclusief build en database-/dispatch-gates is eveneens groen.
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
janpeter/Scrum4Me!389
No description provided.