Compile-time dependencies between packages:
flowchart TD
SN["@stratasync/next"]
SR["@stratasync/react"]
SC["@stratasync/client"]
SCO["@stratasync/core"]
SY["@stratasync/y-doc"]
SN --> SR
SN --> SC
SN --> SCO
SR --> SC
SR --> SCO
SC --> SCO
SC --> SYDependencies flow downward. @stratasync/core has zero runtime dependencies on any framework, storage engine, or transport: you can test sync logic in pure Node.js without a browser.
Storage, transport, and reactivity adapters implement interfaces from @stratasync/core and are injected at runtime via SyncClientOptions. Swap adapters without changing the dependency graph.
Each layer builds on the one below. See the individual package docs for API details.
The ModelRegistry stores field metadata, relation metadata, load strategies, and a deterministic schema hash for cache-busting and migrations.
An in-memory identity map keyed by model name and primary key, guaranteeing one object per record. A pluggable ReactivityAdapter notifies the UI when fields change.
A durable local replica in IndexedDB storing model rows, sync metadata, the persistent outbox, and partial-index coverage. The StorageAdapter interface is transport-agnostic.
Handles bootstrapping, delta streaming over WebSockets (with HTTP fallback), outbox management with retry and idempotency keys, and field-level LWW rebase on conflicts.
Moves data between client and server using NDJSON streaming for bootstrap, GraphQL mutations with batch support, and WebSocket subscriptions for real-time deltas.
Turns model instances into MobX observables. Delta application wraps in a MobX transaction for atomic UI updates.
React hooks and providers connect the sync client to the component tree. The Next.js package adds server-side bootstrap prefetching for fast first paint. See React and Next.js for the full hook API.
flowchart LR
subgraph Client
MF["App (Next.js)"]
SN["@stratasync/next"]
SR["@stratasync/react"]
SC["@stratasync/client"]
SCO["@stratasync/core"]
SM["@stratasync/mobx"]
SS["@stratasync/storage-idb"]
ST["@stratasync/transport-graphql"]
IDB[(IndexedDB)]
end
subgraph Server
API["API Server (Fastify)"]
PG[(PostgreSQL)]
REDIS[(Redis pub/sub)]
end
MF --> SN
MF --> SR
SN --> SC
SR --> SC
SC --> SCO
SC -.->|"runtime injection"| SM
SC -.->|"runtime injection"| SS
SS --> IDB
SC -.->|"runtime injection"| ST
ST -->|"HTTP: bootstrap, batch, deltas, mutate"| API
ST -->|"WebSocket: delta stream"| API
API -->|Prisma| PG
API -->|Delta pub/sub| REDISDeterministic core, adapters at the edges: The delta applier, rebase algorithm, and transaction serializer produce the same output for the same input. Swap storage, transport, or reactivity without touching the core.
Offline is the default: Every read comes from the local store; every write goes to the outbox. Network is an optimization, not a requirement.
Server is the authority: The server assigns global ordering. Clients apply mutations optimistically, but confirmed state only advances through server-issued deltas.