Packages > @fluidframework/container-definitions

@fluidframework/container-definitions Package

Interfaces

Interface Alerts Description
ContainerWarning Represents warnings raised on container.
IAudience Audience represents all clients connected to the op stream, both read-only and read/write.
ICodeAllowList Code AllowListing Interface
ICodeDetailsLoader Fluid code loader resolves a code module matching the document schema, i.e. code details, such as a package name and package version range.
ICodeLoader DEPRECATED Code loading interface
IConnectionDetails Contract representing the result of a newly established connection to the server for syncing deltas
IContainer The Host's view of the Container and its connection to storage
IContainerContext

The ContainerContext is a proxy standing between the Container and the Container's IRuntime. This allows the Container to terminate the connection to the IRuntime.

Specifically, there is an event on Container, onContextChanged, which mean a new code proposal has been loaded, so the old IRuntime is no longer valid, as its ContainerContext has been revoked, and the Container has created a new ContainerContext.

IContainerEvents Events emitted by the Container "upwards" to the Loader and Host
IContainerLoadMode
IDeltaHandlerStrategy Interface used to define a strategy for handling incoming delta messages
IDeltaManager Manages the transmission of ops between the runtime and storage.
IDeltaManagerEvents Events emitted by the Delta Manager
IDeltaQueue Queue of ops to be sent to or processed from storage
IDeltaQueueEvents Events emitted by a Delta Queue
IDeltaSender Contract supporting delivery of outbound messages to the server
IErrorBase Base interface for all errors and warnings at container level
IFluidBrowserPackage A Fluid package for specification for browser environments
IFluidBrowserPackageEnvironment A specific Fluid package environment for browsers
IFluidCodeDetails Data structure used to describe the code to load on the Fluid document
IFluidCodeDetailsComparer Provides capability to compare Fluid code details.
IFluidCodeDetailsConfig Package manager configuration. Provides a key value mapping of config values
IFluidCodeResolver Fluid code resolvers take a Fluid code details, and resolve the full Fluid package including absolute urls for the browser file entries. The Fluid code resolver is coupled to a specific cdn and knows how to resolve the code detail for loading from that cdn. This include resolving to the most recent version of package that supports the provided code details.
IFluidModule
IFluidModuleWithDetails Encapsulates a module entry point with corresponding code details.
IFluidPackage Fluid-specific properties expected on a package to be loaded by the code loader. While compatible with the npm package format it is not necessary that that package is an npm package: https://stackoverflow.com/questions/10065564/add-custom-metadata-or-config-to-package-json-is-it-valid
IFluidPackageEnvironment Specifies an environment on Fluid property of a IFluidPackage
IFluidTokenProvider DEPRECATED
IGenericError Generic wrapper for an unrecognized/uncategorized error object
IHostLoader The Host's view of the Loader, used for loading Containers
ILoader The Runtime's view of the Loader, used for loading Containers
ILoaderHeader Set of Request Headers that the Loader understands and may inspect or modify
IPendingLocalState
IProvideDeltaSender DEPRECATED
IProvideFluidCodeDetailsComparer
IProvideFluidTokenProvider DEPRECATED
IProvideLoader
IProvideRuntimeFactory
IProxyLoaderFactory DEPRECATED Abstraction layer to support different Loaders in different Node execution contexts
IResolvedFluidCodeDetails The interface returned from a IFluidCodeResolver which represents IFluidCodeDetails that have been resolved and are ready to load
IRuntime The IRuntime represents an instantiation of a code package within a Container. Primarily held by the ContainerContext to be able to interact with the running instance of the Container.
IRuntimeFactory

Exported module definition

Provides the entry point for the ContainerContext to load the proper IRuntime to start up the running instance of the Container.

IThrottlingWarning Warning emitted when requests to storage are being throttled
IUsageError Error indicating an API is being used improperly resulting in an invalid operation.

Enumerations

Enum Description
AttachState The attachment state of some Fluid data (e.g. a container or data store), denoting whether it is uploaded to the service. The transition from detached to attached state is a one-way transition.
BindState
ContainerErrorType Different error types the Container may report out to the Host
LoaderHeader Accepted header keys for requests coming to the Loader

Types

TypeAlias Description
ConnectionState Type defining the different states of connectivity a container can be in
ICriticalContainerError Represents errors raised on container.
ILoaderOptions
ReadOnlyInfo

Variables

Variable Alerts Description
IDeltaSender DEPRECATED
IFluidCodeDetailsComparer
IFluidTokenProvider DEPRECATED
IRuntimeFactory
isFluidBrowserPackage Determines if any object is an IFluidBrowserPackage
isFluidCodeDetails
isFluidPackage Check if the package.json defines a Fluid package

Namespaces

Namespace Description
ConnectionState Namespace for the different connection states a container can be in

Type Details

ConnectionState

Type defining the different states of connectivity a container can be in

Signature

export declare type ConnectionState = ConnectionState.Disconnected | ConnectionState.Connecting | ConnectionState.Connected;

ICriticalContainerError

Represents errors raised on container.

Signature

export declare type ICriticalContainerError = IErrorBase;

ILoaderOptions

Signature

export declare type ILoaderOptions = {
    [key in string | number]: any;
} & {
    cache?: boolean;
    provideScopeLoader?: boolean;
    noopTimeFrequency?: number;
    noopCountFrequency?: number;
    maxClientLeaveWaitTime?: number;
};

ReadOnlyInfo

Signature

export declare type ReadOnlyInfo = {
    readonly readonly: false | undefined;
} | {
    readonly readonly: true;
    readonly forced: boolean;
    readonly permissions: boolean | undefined;
    readonly storageOnly: boolean;
};

Variable Details

IDeltaSender

API This

  • This will be removed in a later release.

Signature

IDeltaSender: keyof IProvideDeltaSender

IFluidCodeDetailsComparer

Signature

IFluidCodeDetailsComparer: keyof IProvideFluidCodeDetailsComparer

IFluidTokenProvider

API This

  • This will be removed in a later release.

Signature

IFluidTokenProvider: keyof IProvideFluidTokenProvider

IRuntimeFactory

Signature

IRuntimeFactory: keyof IProvideRuntimeFactory

isFluidBrowserPackage

Determines if any object is an IFluidBrowserPackage

Signature

isFluidBrowserPackage: (maybePkg: any) => maybePkg is Readonly<IFluidBrowserPackage>

isFluidCodeDetails

Signature

isFluidCodeDetails: (details: unknown) => details is Readonly<IFluidCodeDetails>

isFluidPackage

Check if the package.json defines a Fluid package

Signature

isFluidPackage: (pkg: any) => pkg is Readonly<IFluidPackage>