RECEIVING_CHANGES

The document is busy syncing — currently receiving changes from the server.

If the communication with the server fails, the document will fall back into the DIRTY or CLEAN state — depending on whether or not there are unsynced changes. If all goes well, this state will transition to either the CLEAN or the SENDING_CHANGES state — depending on whether new local changes have accumulated during the transmission. This will also notify all registered InstantDocumentListener.

Note: This repeated back and forth between the SENDING_CHANGES and #RECEIVING_CHANGES state is what we call the sync cycle. It starts when a sync request is made, and — if all goes well — ends when there are no local changes left.