The state a DocumentSource reports for a particular document.
pending: the source is actively trying to obtain data (sync in
progress, storage lookup outstanding, etc.).
ready: the source has delivered everything it currently knows about.
For storage, this means the on-disk doc has been loaded; for the
automerge sync source, this means we've caught up to at least one
connected peer's advertised initial heads.
unavailable: the source has determined it cannot provide data.
Sources may transition between these states freely (e.g. sync can go
ready → pending again when a new peer arrives advertising heads
we don't have).
The state a DocumentSource reports for a particular document.
pending: the source is actively trying to obtain data (sync in progress, storage lookup outstanding, etc.).ready: the source has delivered everything it currently knows about. For storage, this means the on-disk doc has been loaded; for the automerge sync source, this means we've caught up to at least one connected peer's advertised initial heads.unavailable: the source has determined it cannot provide data.Sources may transition between these states freely (e.g. sync can go
ready→pendingagain when a new peer arrives advertising heads we don't have).