Remote / foldkit-remote-domain

Pre-read on the server for SSR

pageReader from foldkit-remote-domain/server reads the Domain model in-process during server rendering. Remote.resume(Data) sends the pre-read rows and their revisions to the browser so hydration skips duplicate reads (while live streams ignore frames at or before the hydrated revision, and live lists refresh once as their stream opens).

ts
import { Layer } from 'effect'
import { pageReader } from 'foldkit-remote-domain/server'

const reader = pageReader(NotesApi, {
  views: [NoteReads],
  resolvePrincipal: (request: Request) => Effect.succeed(sessionOf(request)),
  middleware: () => Layer.empty,
})
  • Provide reader(request, env) alongside your hosted model Layer to Data.satisfy inside foldkit-ssr's prepare.
  • Build middleware directly from the principal returned by resolvePrincipal, never from raw HTTP headers.
  • pageReader is read-only (writes fail RemoteMutationError; live streams fail RemoteLiveError) and marks all reads private (PageReads) so one user's render is never cached for another.