SyncStatus

SyncStatus = object

Defined in: packages/@livestore/livestore/src/store/store-types.ts:395

Represents the current synchronization status of the store.

This provides visibility into the sync state between the client session and the leader thread, allowing applications to show sync indicators or determine backend health.

Example

const status = store.syncStatus()
if (status.isSynced) {
  console.log('All changes synced')
} else {
  console.log(`${status.pendingCount} events pending sync`)
}

Properties

isSynced

isSynced: boolean

Defined in: packages/@livestore/livestore/src/store/store-types.ts:414

Whether the client session is fully synced with the leader thread. True when there are no pending events (pendingCount === 0).

---

localHead

localHead: string

Defined in: packages/@livestore/livestore/src/store/store-types.ts:400

The local head sequence number (most recent event in the client session). Represented as a string in the format “e{global}.{client}” (e.g., “e5.2”).

---

pendingCount

pendingCount: number

Defined in: packages/@livestore/livestore/src/store/store-types.ts:409

Number of events pending synchronization to the leader thread.

---

upstreamHead

upstreamHead: string

Defined in: packages/@livestore/livestore/src/store/store-types.ts:405

The upstream head sequence number (what the leader thread has confirmed). Represented as a string in the format “e{global}” (e.g., “e3”).