@fluidframework/datastore-definitions

@fluidframework/datastore-definitions

Interface IFluidDataStoreRuntime specifies the data store developer API.

Capabilities exposed on IFluidDataStoreRuntime

TODO: The full set of functionality is under review

• DDS creation and management APIs
• Container info and states (connection state, documentId, quorum, audience, etc.)
• Loader
• Op/Signal submission
• Snapshotting
• DeltaManager
• Blob Management API.

Signals

Signals provide a transient data channel for data (any serializable payload) that doesn't need to be persisted in the op stream. Use signals where possible to avoid storing unnecessary ops, e.g. to transmit presence status during a collaborative session.

Signals are not persisted, ordered, or guaranteed. If a client is behind, the op state can be behind the signal state. For this reason people usually stick the currentSeq on the signal, so other clients can wait to process if they are behind.

You can send a signal via the container or data store runtime. The container will emit the signal event on all signals, but a data store will emit the signal event only on signals emitted on that data store runtime.