Server utilities

Server-side bootstrap prefetching and serialization for Next.js Server Components.

Prefetch sync data on the server and pass it to client components, eliminating the client-side bootstrap request.


import {
  decodeBootstrapSnapshot,
  deserializeBootstrapSnapshot,
  encodeBootstrapSnapshot,
  isBootstrapSnapshotStale,
  prefetchBootstrap,
  seedStorageFromBootstrap,
  serializeBootstrapSnapshot,
} from "@stratasync/next/server";

prefetchBootstrap

Fetches the full bootstrap dataset from the sync server.

Published with Edda

// app/dashboard/page.tsx (Server Component)
import {
  prefetchBootstrap,
  serializeBootstrapSnapshot,
} from "@stratasync/next/server";

export default async function DashboardPage() {
  const snapshot = await prefetchBootstrap({
    endpoint: process.env.SYNC_ENDPOINT!,
    authorization: `Bearer ${await getServerToken()}`,
    groups: ["workspace-abc"],
    timeout: 10000,
  });

  const serialized = await serializeBootstrapSnapshot(snapshot);

  return <DashboardClient bootstrapData={serialized} />;
}

Option	Type	Default	Description
`endpoint`	`string`	Required	Sync server endpoint URL.
`authorization`	`string`	-	Authorization header value (such as `"Bearer token"`).
`headers`	`Record<string, string>`	-	Additional request headers.
`models`	`string[]`	-	Specific models to fetch (all if omitted).
`groups`	`string[]`	-	Sync groups to include.
`schemaHash`	`string`	-	Expected schema hash for validation.
`timeout`	`number`	`10000`	Request timeout in milliseconds.

Server utilities

prefetchBootstrap

Server utilities

prefetchBootstrap

PrefetchBootstrapOptions

BootstrapSnapshot

serializeBootstrapSnapshot

SerializeBootstrapOptions

BootstrapSnapshotPayload

encodeBootstrapSnapshot

Complete SSR example