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 {
  prefetchBootstrap,
  prefetchModels,
  serializeBootstrapSnapshot,
  encodeBootstrapSnapshot,
} from "@stratasync/next/server";

prefetchBootstrap

Fetches the full bootstrap dataset from the sync server.

Server utilities: Server-side bootstrap... · Strata Sync

// 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.

Option	Type	Default	Description
`compress`	`boolean`	`true` (if `CompressionStream` available)	Whether to gzip-compress the data.


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

export default async function DashboardPage() {
  const result = await prefetchModels({
    endpoint: process.env.API_URL + "/sync/prefetch",
    authorization: `Bearer ${await getServerToken()}`,
    models: [
      { name: "Project", limit: 10 },
      { name: "Task", filter: { status: "active" }, limit: 50 },
    ],
    timeout: 5000,
  });

  return <DashboardClient prefetchedData={result} />;
}

Option	Type	Default	Description
`endpoint`	`string`	Required	Prefetch API endpoint.
`authorization`	`string`	-	Authorization header.
`models`	`Array<{ name, filter?, limit? }>`	Required	Models to prefetch with optional filters.
`timeout`	`number`	`5000`	Request timeout in milliseconds.

Server utilities

prefetchBootstrap

Server utilities

prefetchBootstrap

PrefetchBootstrapOptions

BootstrapSnapshot

serializeBootstrapSnapshot

SerializeBootstrapOptions

BootstrapSnapshotPayload

encodeBootstrapSnapshot

prefetchModels

PrefetchOptions

PrefetchResult

Complete SSR example