fix: close sse stream on abort

[Divv1524]

Summary

Fixed the SSE stream lifecycle in /api/stream so server-side resources are cleaned up reliably when clients disconnect, streams are canceled, or connections become stale.

Closes #1608

---

Type of Change

• Bug fix
• New feature
• Documentation update
• Refactor / code cleanup

---

Changes Made

• Centralized SSE cleanup into one idempotent close path
• Safely closes the ReadableStream controller on client abort
• Added guarded controller.enqueue() handling to prevent writes to closed streams
• Added a 5-minute maximum SSE connection duration
• Added cleanup support for canceled stream readers and already-aborted requests
• Added regression tests for SSE cleanup behavior

---

How to Test

Steps for the reviewer to verify this works:

1. Run npm run lint
2. Run npm run type-check
3. Run npm run build
4. Run vitest run test/sse-stream-route.test.ts
5. Confirm SSE stream connections release their active connection slot after abort, cancel, or timeout

---

Screenshots (if UI change)

N/A

---

Checklist

• Linked issue in summary
• npm run lint passes locally
• No TypeScript errors (npm run type-check)
• Self-reviewed the diff
• Added/updated tests if applicable

---

Accessibility Checklist

• Proper keyboard navigation tested
• Responsive UI verified
• Accessibility labels added where needed

---

Additional Notes

Full npm test was also run. The focused SSE test suite passed, but the full suite currently has unrelated pre-existing failures outside this change.

[vercel]

@Divv1524 is attempting to deploy a commit to the PRIYANSHU DOSHI's projects Team on Vercel.

A member of the Team first needs to authorize it.

[github-actions]

GSSoC Label Checklist 🏷️

@Priyanshu-byte-coder — please apply the appropriate labels before merging:

Difficulty (pick one):

• level:beginner — 20 pts
• level:intermediate — 35 pts
• level:advanced — 55 pts
• level:critical — 80 pts

Quality (optional):

• quality:clean — ×1.2 multiplier
• quality:exceptional — ×1.5 multiplier

Validation (required to score):

• gssoc:approved — counts for points
• gssoc:invalid / gssoc:spam / gssoc:ai-slop — does not score

Type labels (type:*) are auto-detected from files and title. Review and adjust if needed.
Points formula: (difficulty × quality_multiplier) + type_bonus

[github-actions]

Thanks for your first PR on DevTrack! 🎉

A maintainer will review it within 48 hours. While you wait:

• Make sure CI is passing (type-check + lint)
• Double-check the PR description is filled out and the issue is linked
• Feel free to ask questions in Discussions if you need help

If you find DevTrack useful, a ⭐ star on the repo is always appreciated — it helps the project grow and attract more contributors!

[Priyanshu-byte-coder]

Please rebase on main to resolve conflicts. Run: git fetch origin && git rebase origin/main

[Priyanshu-byte-coder]

This PR has merge conflicts because the stream route was updated after you opened this PR. The abort-on-close logic from this PR was partially incorporated in main already. Please rebase on the latest main to bring in the remaining improvements (max-duration timeout, safeEnqueue helper, closeStream helper).

[github-actions]

🎉 Merged! Thanks for contributing to DevTrack.

If the project has been useful to you, a ⭐ star on the repo is the easiest way to support it — it helps DevTrack get discovered by more developers.

Keep an eye on open issues for your next contribution!