Add .streamedOptions and .liveOptions for SSE / async-generator routes

[NeilTheFisher]

Adds two helpers for Elysia routes that return an async generator (or use sse()):

• .streamedOptions() — built on TanStack's experimental_streamedQuery. Chunks accumulate as TChunk[]. Supports refetchMode ("append" | "reset" | "replace").
• .liveOptions() — writes each chunk to cache via setQueryData; resolves to the latest chunk.

Both are also exposed on createEdenTQUtils. TChunk inferred via AsyncIterableElement<ExtractData<Res>>.

Continues from #2 (closed due to branch recreation).

---

Note

Medium Risk
Adds new query helpers built on TanStack Query’s experimental streaming API and introduces cache-writing behavior for live streams, which could affect client query lifecycle/refetch semantics. Also renames/repackages the library as a scoped fork, which may impact consumers’ import paths and publishing.

Overview
Adds SSE/async-generator route support via new .streamedOptions() and .liveOptions() helpers on both the Eden method decorators and createEdenTQUtils, enabling TanStack Query queries to consume AsyncIterable responses (including Elysia sse() payloads).

Implements streamed accumulation using experimental_streamedQuery with a configurable refetchMode, and implements live streaming by writing each chunk to cache with setQueryData and resolving to the final chunk (erroring if nothing is yielded).

Updates types/exports and documentation accordingly, adds coverage for streamed/live behavior, and adjusts package metadata (scoped rename, version bump) plus dependency/lockfile updates (including removal of bun.lock).

^{Reviewed by Cursor Bugbot for commit 6c350d8. Bugbot is set up for automated code reviews on this repo. Configure here.}

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 6c350d8. Configure here.}

[cursor]

Peer dependency too loose for new API requirements

High Severity

The peerDependencies for @tanstack/query-core is ">=5.0.0", but the new code has a top-level import { experimental_streamedQuery } which was only added in v5.86.0, and liveQuery uses context.client on QueryFunctionContext which was added around v5.62.0. Any user with a @tanstack/query-core version between 5.0.0 and 5.85.x will hit a runtime import failure when loading the library, even if they never use the streaming features.

Additional Locations (2)

• src/index.ts#L6-L7
• src/index.ts#L140-L141

 

^{Reviewed by Cursor Bugbot for commit 6c350d8. Configure here.}

[cursor]

You have used all of your free Bugbot PR reviews.

To receive reviews on all of your PRs, visit the Cursor dashboard to activate Pro and start your 14-day free trial.