Topics

@fluidframework/runtime-definitions Package

Packages > @fluidframework/runtime-definitions

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; }