Skip to main content
Version: v1

@fluidframework/protocol-definitions Package

Interfaces

InterfaceAlertsDescription
IActorClient
IAttachment
IBlobRaw blob stored within the tree
IBranchOriginBranch origin information
ICapabilities
IClient
IClientConfigurationKey value store of service configuration properties provided to the client as part of connection
IClientDetails
IClientJoinContents sent with a ClientJoin message
IConnectMessage sent to connect to the given document
IConnectedMessage sent to indicate a client has connected to the server
ICreateBlobResponse
IDocumentAttributes
IDocumentMessageDocument specific message
IDocumentSystemMessageDocument Message with optional system level data field.
IHelpMessageRepresents a message containing tasks.
INack
INackContentInterface for nack content.
IProcessMessageResult
IProposal

Proposal to set the given key/value pair.

Consensus on the proposal is achieved if the MSN is >= the sequence number at which the proposal is made and no client within the collaboration window rejects the proposal.

IProtocolState
IQueueMessageRepresents a message in task queue to be processed.
IQuorumInterface combining tracking of clients as well as proposals in the Quorum.
IQuorumClientsInterface for tracking clients in the Quorum.
IQuorumClientsEventsEvents fired by a Quorum in response to client tracking.
IQuorumProposalsInterface for tracking proposals in the Quorum.
IQuorumProposalsEventsEvents fired by a Quorum in response to proposal tracking.
ISequencedClient
ISequencedDocumentAugmentedMessage
ISequencedDocumentMessageSequenced message for a distributed document
ISequencedDocumentSystemMessage
IServerErrorGeneral errors returned from the server. May want to add error code or something similar in the future.
ISignalClient
ISignalMessage
ISnapshotTree
ISnapshotTreeEx
ISummaryAckContents of summary ack expected from the server.
ISummaryAttachmentUnique identifier for blobs uploaded outside of the summary. Attachment Blobs are uploaded and downloaded separately and do not take part of the snapshot payload. The id gets returned from the backend after the attachment has been uploaded. Additional information can be found here: https://github.com/microsoft/FluidFramework/issues/6374 Ex. "id": "bQAQKARDdMdTgqICmBa_ZB86YXwGP"
ISummaryAuthorDeprecated
ISummaryBlobString or Binary data to be uploaded to the server as part of the container's Summary. Note: Already uploaded blobs would be referenced by a ISummaryAttachment. Additional information can be found here: https://github.com/microsoft/FluidFramework/issues/6568 Ex. "content": "{ "pkg":"[\"OfficeRootComponent\",\"LastEditedComponent\"]", "summaryFormatVersion":2,"isRootDataStore":false }"
ISummaryCommitterDeprecated
ISummaryConfiguration
ISummaryContent
ISummaryHandlePath to a summary tree object from the last successful summary indicating the summary object hasn't changed since it was uploaded. To illustrate, if a DataStore did not change since last summary, the framework runtime will use a handle for the entire DataStore instead of re-sending the entire subtree. The same concept applies for a DDS. An example of handle would be: '//'.
ISummaryNackContents of summary nack expected from the server.
ISummaryProposalData about the original proposed summary op.
ISummaryTokenClaims
ISummaryTreeTree Node data structure with children that are nodes of SummaryObject type: Blob, Handle, Attachment or another Tree.
ITokenClaims

JSON Web Token (JWT) Claims

See https://datatracker.ietf.org/doc/html/rfc7519\#section\-4

ITokenProvider
ITokenServiceThe ITokenService abstracts the discovery of claims contained within a token
ITraceMessages to track latency trace
ITree
IUploadedSummaryDetails
IUserBase user definition. It is valid to extend this interface when adding new details to the user object.
IVersionRepresents a version of the snapshot of a data store

Enumerations

EnumDescription
FileMode
MessageType
NackErrorTypeType of the Nack. InvalidScopeError: Client's token is not valid for the intended op. ThrottlingError: Retryable after retryAfter number. BadRequestError: Clients op is invalid and should retry immediately with a valid op. LimitExceededError: Service is having issues. Client should not retry.
ScopeTypeDefines scope access for a Container/Document
TreeEntryType of entries that can be stored in a tree

Types

TypeAliasDescription
ConnectionMode
IApprovedProposalAdds the sequence number at which the message was approved to an ISequencedProposal
ICommittedProposalAdds the sequence number at which the message was committed to an IApprovedProposal
IQuorumEventsAll events fired by an IQuorum, both client tracking and proposal tracking.
ISequencedProposalSimilar to IProposal except includes the sequence number when it was made in addition to the fields on IProposal
ITreeEntryA tree entry wraps a path with a type of node
SummaryObject
SummaryTree
SummaryType
SummaryTypeNoHandle

Namespaces

NamespaceDescription
SummaryTypeType tag used to distinguish different types of nodes in a ISummaryTree.