@fluidframework/runtime-definitions Package

Interfaces

Interface	Alerts	Modifiers	Description
AttributionInfo	Legacy, Alpha		Attribution information associated with a change.
DetachedAttributionKey	Legacy, Alpha		AttributionKey associated with content that was inserted while the container was in a detached state.
IAttachMessage	Legacy, Alpha		Message send by client attaching local data structure. Contains snapshot of data structure which is the current state of this data structure.
IContainerRuntimeBase	Legacy, Alpha	sealed	A reduced set of functionality of IContainerRuntime that a data store context/data store runtime will need TODO: this should be merged into IFluidDataStoreContext
IContainerRuntimeBaseEvents	Legacy, Alpha	sealed
IDataStore	Legacy, Alpha		Exposes some functionality/features of a data store: - Handle to the data store's entryPoint - Fluid router for the data store - Can be assigned an alias
IEnvelope	Legacy, Alpha		An envelope wraps the contents with the intended target
IExperimentalIncrementalSummaryContext	Legacy, Alpha		- Can be deleted/changed at any time Contains the necessary information to allow DDSes to do incremental summaries
IFluidDataStoreChannel	Legacy, Alpha		Minimal interface a data store runtime needs to provide for IFluidDataStoreContext to bind to control. Functionality include attach, snapshot, op/signal processing, request routes, expose an entryPoint, and connection state notifications
IFluidDataStoreContext	Legacy, Alpha		Represents the context for the data store. It is used by the data store runtime to get information and call functionality to the container.
IFluidDataStoreContextDetached	Legacy, Alpha
IFluidDataStoreFactory	Legacy, Alpha		IFluidDataStoreFactory create data stores. It is associated with an identifier (its type member) and usually provided to consumers using this mapping through a data store registry.
IFluidDataStoreRegistry	Legacy, Alpha		An association of identifiers to data store registry entries, where the entries can be used to create data stores.
IFluidParentContext	Legacy, Alpha		Represents the context for the data store like objects. It is used by the data store runtime to get information and call functionality to its parent. This layout is temporary, as IFluidParentContext and IFluidDataStoreContext will converge.
IGarbageCollectionData	Legacy, Alpha		Garbage collection data returned by nodes in a Container. Used for running GC in the Container.
IGarbageCollectionDetailsBase	Legacy, Alpha		GC details provided to each node during creation.
IInboundSignalMessage	Legacy, Alpha		Represents ISignalMessage with its type.
IProvideFluidDataStoreFactory	Legacy, Alpha
IProvideFluidDataStoreRegistry	Legacy, Alpha
IRuntimeMessageCollection	Legacy, Alpha	sealed	A collection of messages that are processed by the runtime.
IRuntimeMessagesContent	Legacy, Alpha	sealed	These are the contents of a runtime message as it is processed throughout the stack.
ISummarizeInternalResult	Legacy, Alpha		Contains the same data as ISummaryResult but in order to avoid naming collisions, the data store summaries are wrapped around an array of labels identified by pathPartsForChildren.
ISummarizeResult	Legacy, Alpha		Represents a summary at a current sequence number.
ISummarizerNode	Legacy, Alpha
ISummarizerNodeConfig	Legacy, Alpha
ISummarizerNodeConfigWithGC	Legacy, Alpha
ISummarizerNodeWithGC	Legacy, Alpha		Extends the functionality of ISummarizerNode to support garbage collection. It adds / updates the following APIs: usedRoutes: The routes in this node that are currently in use. getGCData: A new API that can be used to get the garbage collection data for this node. summarize: Added a trackState flag which indicates whether the summarizer node should track the state of the summary or not. createChild: Added the following params: - getGCDataFn: This gets the GC data from the caller. This must be provided in order for getGCData to work. - getInitialGCDetailsFn: This gets the initial GC details from the caller. deleteChild: Deletes a child node. isReferenced: This tells whether this node is referenced in the document or not. updateUsedRoutes: Used to notify this node of routes that are currently in use in it.
ISummaryStats	Legacy, Alpha		Contains the aggregation data from a Tree/Subtree.
ISummaryTreeWithStats	Legacy, Alpha		Represents the summary tree for a node along with the statistics for that tree. For example, for a given data store, it contains the data for data store along with a subtree for each of its DDS. Any component that implements IChannelContext, IFluidDataStoreChannel or extends SharedObject will be taking part of the summarization process.
ITelemetryContext	Legacy, Alpha		Contains telemetry data relevant to summarization workflows. This object is expected to be modified directly by various summarize methods.
LocalAttributionKey	Legacy, Alpha		AttributionKey associated with content that has been made locally but not yet acked by the server.
OpAttributionKey	Legacy, Alpha		AttributionKey representing a reference to some op in the op stream. Content associated with this key aligns with content modified by that op.

Enumerations

Enum	Alerts	Description
CreateSummarizerNodeSource	Legacy, Alpha
FlushMode	Legacy, Alpha	Runtime flush mode handling

Types

TypeAlias	Alerts	Description
AliasResult	Legacy, Alpha	Encapsulates the return codes of the aliasing API. 'Success' - the datastore has been successfully aliased. It can now be used. 'Conflict' - there is already a datastore bound to the provided alias. To acquire it's entry point, use the IContainerRuntime.getAliasedDataStoreEntryPoint function. The current datastore should be discarded and will be garbage collected. The current datastore cannot be aliased to a different value. 'AlreadyAliased' - the datastore has already been previously bound to another alias name.
AttributionKey	Legacy, Alpha	Can be indexed into the ContainerRuntime in order to retrieve AttributionInfo.
CreateChildSummarizerNodeFn	Legacy, Alpha
CreateChildSummarizerNodeParam	Legacy, Alpha
FluidDataStoreRegistryEntry	Legacy, Alpha	A single registry entry that may be used to create data stores It has to have either factory or registry, or both.
InboundAttachMessage	Legacy, Alpha	This type should be used when reading an incoming attach op, but it should not be used when creating a new attach op. Older versions of attach messages could have null snapshots, so this gives correct typings for writing backward compatible code.
ISequencedMessageEnvelope	Legacy, Alpha	This is the message type that is used within the runtime when processing a sequenced message. It is the same as ISequencedDocumentMessage, but without the contents and clientSequenceNumbers which are sent separately. The contents are modified at multiple layers in the stack so having it separate doesn't require packing and unpacking the entire message.
NamedFluidDataStoreRegistryEntries	Legacy, Alpha	An iterable identifier/registry entry pair list
NamedFluidDataStoreRegistryEntry	Legacy, Alpha	An associated pair of an identifier and registry entry. Registry entries may be dynamically loaded.
SummarizeInternalFn	Legacy, Alpha
VisibilityState	Legacy, Alpha

Variables

Variable	Alerts	Modifiers	Type	Description
IFluidDataStoreFactory	Legacy, Alpha	readonly	keyof IProvideFluidDataStoreFactory
IFluidDataStoreRegistry	Legacy, Alpha	readonly	keyof IProvideFluidDataStoreRegistry
VisibilityState	Legacy, Alpha	readonly	{ NotVisible: string; LocallyVisible: string; GloballyVisible: string; }	This tells the visibility state of a Fluid object. It basically tracks whether the object is not visible, visible locally within the container only or visible globally to all clients.

Variable Details

IFluidDataStoreFactory

This API is provided for existing users, but is not recommended for new users.

To use, import via @fluidframework/runtime-definitions/legacy.

For more information about our API support guarantees, see here.

Signature

IFluidDataStoreFactory: keyof IProvideFluidDataStoreFactory

Type: keyof IProvideFluidDataStoreFactory

IFluidDataStoreRegistry

This API is provided for existing users, but is not recommended for new users.

To use, import via @fluidframework/runtime-definitions/legacy.

For more information about our API support guarantees, see here.

Signature

IFluidDataStoreRegistry: keyof IProvideFluidDataStoreRegistry

Type: keyof IProvideFluidDataStoreRegistry

VisibilityState

This tells the visibility state of a Fluid object. It basically tracks whether the object is not visible, visible locally within the container only or visible globally to all clients.

This API is provided for existing users, but is not recommended for new users.

To use, import via @fluidframework/runtime-definitions/legacy.

For more information about our API support guarantees, see here.

Signature

VisibilityState: {
    NotVisible: string;
    LocallyVisible: string;
    GloballyVisible: string;
}

Type: { NotVisible: string; LocallyVisible: string; GloballyVisible: string; }