docs: add server gateway SSE guide#5012
Closed
benpsnyder wants to merge 2 commits into
Closed
Conversation
Contributor
|
Hi @benpsnyder, thanks for your contribution to the docs. We don't accept draft PRs in our repo to keep our PRs relatively neat and manageable, so I'm going to close this for now, at least until you have a complete PR for us to review. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Last-Event-ID, browserEventSource, reducer calls through authorized server endpoints, shutdown handling, and CLI smoke testing.createServerFnsnapshot/mutation wrappers, server routes for SSE, and a route loader plus browserEventSourcecomponent.Why
This is a focused documentation slice from #5004. The issue asks for a first-class server-side realtime gateway pattern where a full-stack app server owns auth and the SpacetimeDB SDK connection, then relays live updates to browsers over SSE.
The guide keeps the core gateway example module-agnostic while also showing how the pattern maps into TanStack Start: loaders for initial snapshots, server functions for same-origin mutations, server routes for raw SSE streams, and
.server.tsfiles for SpacetimeDB connections and secrets.Validation
git diff --checkpnpm --dir docs typecheckpnpm --dir docs buildThe docs build passes. It still prints the existing
docusaurus-plugin-llms-txtwarning for/docs/ask-ai/ask-ai, which is unrelated to this change.Refs #5004