@fluidframework/fluid-static 2.0.0-internal.7.1.0 → 2.0.0-internal.7.2.0

package/dist/fluid-static.d.ts

@@ -1,557 +0,0 @@
-/**
- * Provides a simple and powerful way to consume collaborative Fluid data.
- *
- * @packageDocumentation
- */
-
-import { AttachState } from '@fluidframework/container-definitions';
-import { BaseContainerRuntimeFactory } from '@fluidframework/aqueduct';
-import { ConnectionState } from '@fluidframework/container-definitions';
-import { IAudience } from '@fluidframework/container-definitions';
-import { IChannelFactory } from '@fluidframework/datastore-definitions';
-import { IClient } from '@fluidframework/protocol-definitions';
-import { IContainer } from '@fluidframework/container-definitions';
-import { IContainerRuntime } from '@fluidframework/container-runtime-definitions';
-import { ICriticalContainerError } from '@fluidframework/container-definitions';
-import { IEvent } from '@fluidframework/core-interfaces';
-import { IEventProvider } from '@fluidframework/core-interfaces';
-import { IFluidDataStoreFactory } from '@fluidframework/runtime-definitions';
-import { IFluidLoadable } from '@fluidframework/core-interfaces';
-import { TypedEventEmitter } from '@fluid-internal/client-utils';
-
-/**
- * Declares the Fluid objects that will be available in the {@link IFluidContainer | Container}.
- *
- * @remarks
- *
- * It includes both the instances of objects that are initially available upon `Container` creation, as well
- * as the types of objects that may be dynamically created throughout the lifetime of the `Container`.
- */
-export declare interface ContainerSchema {
-    /**
-     * Defines loadable objects that will be created when the {@link IFluidContainer | Container} is first created.
-     *
-     * @remarks It uses the key as the id and the value as the loadable object to create.
-     *
-     * @example
-     *
-     * In the example below two objects will be created when the `Container` is first
-     * created. One with id "map1" that will return a `SharedMap` and the other with
-     * id "pair1" that will return a `KeyValueDataObject`.
-     *
-     * ```typescript
-     * {
-     *   map1: SharedMap,
-     *   pair1: KeyValueDataObject,
-     * }
-     * ```
-     */
-    initialObjects: LoadableObjectClassRecord;
-    /**
-     * Loadable objects that can be created after the initial {@link IFluidContainer | Container} creation.
-     *
-     * @remarks
-     *
-     * Types defined in `initialObjects` will always be available and are not required to be provided here.
-     *
-     * For best practice it's recommended to define all the dynamic types you create even if they are
-     * included via initialObjects.
-     */
-    dynamicObjectTypes?: LoadableObjectClass<any>[];
-}
-
-/**
- * A class that has a factory that can create a `DataObject` and a
- * constructor that will return the type of the `DataObject`.
- *
- * @typeParam T - The class of the `DataObject`.
- */
-export declare type DataObjectClass<T extends IFluidLoadable> = {
-    readonly factory: IFluidDataStoreFactory;
-} & LoadableObjectCtor<T>;
-
-/**
- * Container code that provides a single {@link IRootDataObject}.
- *
- * @remarks
- *
- * This data object is dynamically customized (registry and initial objects) based on the schema provided.
- * to the container runtime factory.
- */
-export declare class DOProviderContainerRuntimeFactory extends BaseContainerRuntimeFactory {
-    private readonly rootDataObjectFactory;
-    private readonly initialObjects;
-    constructor(schema: ContainerSchema);
-    /**
-     * {@inheritDoc @fluidframework/aqueduct#BaseContainerRuntimeFactory.containerInitializingFirstTime}
-     */
-    protected containerInitializingFirstTime(runtime: IContainerRuntime): Promise<void>;
-}
-
-/**
- * Base {@link IFluidContainer} implementation.
- *
- * @remarks
- *
- * Note: this implementation is not complete. Consumers who rely on {@link IFluidContainer.attach}
- * will need to utilize or provide a service-specific implementation of this type that implements that method.
- */
-export declare class FluidContainer extends TypedEventEmitter<IFluidContainerEvents> implements IFluidContainer {
-    private readonly container;
-    private readonly rootDataObject;
-    private readonly connectedHandler;
-    private readonly disconnectedHandler;
-    private readonly disposedHandler;
-    private readonly savedHandler;
-    private readonly dirtyHandler;
-    constructor(container: IContainer, rootDataObject: IRootDataObject);
-    /**
-     * {@inheritDoc IFluidContainer.isDirty}
-     */
-    get isDirty(): boolean;
-    /**
-     * {@inheritDoc IFluidContainer.attachState}
-     */
-    get attachState(): AttachState;
-    /**
-     * {@inheritDoc IFluidContainer.disposed}
-     */
-    get disposed(): boolean;
-    /**
-     * {@inheritDoc IFluidContainer.connectionState}
-     */
-    get connectionState(): ConnectionState;
-    /**
-     * {@inheritDoc IFluidContainer.initialObjects}
-     */
-    get initialObjects(): LoadableObjectRecord;
-    /**
-     * Incomplete base implementation of {@link IFluidContainer.attach}.
-     *
-     * @remarks
-     *
-     * Note: this implementation will unconditionally throw.
-     * Consumers who rely on this will need to utilize or provide a service specific implementation of this base type
-     * that provides an implementation of this method.
-     *
-     * The reason is because externally we are presenting a separation between the service and the `FluidContainer`,
-     * but internally this separation is not there.
-     */
-    attach(): Promise<string>;
-    /**
-     * {@inheritDoc IFluidContainer.connect}
-     */
-    connect(): Promise<void>;
-    /**
-     * {@inheritDoc IFluidContainer.connect}
-     */
-    disconnect(): Promise<void>;
-    /**
-     * {@inheritDoc IFluidContainer.create}
-     */
-    create<T extends IFluidLoadable>(objectClass: LoadableObjectClass<T>): Promise<T>;
-    /**
-     * {@inheritDoc IFluidContainer.dispose}
-     */
-    dispose(): void;
-    /**
-     * FOR INTERNAL USE ONLY. NOT FOR EXTERNAL USE.
-     * We make no stability guarantees here whatsoever.
-     *
-     * Gets the underlying {@link @fluidframework/container-definitions#IContainer}.
-     *
-     * @remarks Used to power debug tooling.
-     *
-     * @internal
-     */
-    readonly INTERNAL_CONTAINER_DO_NOT_USE?: () => IContainer;
-}
-
-/**
- * Base interface for information for each connection made to the Fluid session.
- *
- * @remarks This interface can be extended to provide additional information specific to each service.
- */
-export declare interface IConnection {
-    /**
-     * A unique ID for the connection.  A single user may have multiple connections, each with a different ID.
-     */
-    id: string;
-    /**
-     * Whether the connection is in read or read/write mode.
-     */
-    mode: "write" | "read";
-}
-
-/**
- * Provides an entrypoint into the client side of collaborative Fluid data.
- * Provides access to the data as well as status on the collaboration session.
- *
- * @remarks Note: external implementations of this interface are not supported.
- */
-export declare interface IFluidContainer extends IEventProvider<IFluidContainerEvents> {
-    /**
-     * Provides the current connected state of the container
-     */
-    readonly connectionState: ConnectionState;
-    /**
-     * A container is considered **dirty** if it has local changes that have not yet been acknowledged by the service.
-     *
-     * @remarks
-     *
-     * You should always check the `isDirty` flag before closing the container or navigating away from the page.
-     * Closing the container while `isDirty === true` may result in the loss of operations that have not yet been
-     * acknowledged by the service.
-     *
-     * A container is considered dirty in the following cases:
-     *
-     * 1. The container has been created in the detached state, and either it has not been attached yet or it is
-     * in the process of being attached (container is in `attaching` state). If container is closed prior to being
-     * attached, host may never know if the file was created or not.
-     *
-     * 2. The container was attached, but it has local changes that have not yet been saved to service endpoint.
-     * This occurs as part of normal op flow where pending operation (changes) are awaiting acknowledgement from the
-     * service. In some cases this can be due to lack of network connection. If the network connection is down,
-     * it needs to be restored for the pending changes to be acknowledged.
-     */
-    readonly isDirty: boolean;
-    /**
-     * Whether or not the container is disposed, which permanently disables it.
-     */
-    readonly disposed: boolean;
-    /**
-     * The collection of data objects and Distributed Data Stores (DDSes) that were specified by the schema.
-     *
-     * @remarks These data objects and DDSes exist for the lifetime of the container.
-     */
-    readonly initialObjects: LoadableObjectRecord;
-    /**
-     * The current attachment state of the container.
-     *
-     * @remarks
-     *
-     * Once a container has been attached, it remains attached.
-     * When loading an existing container, it will already be attached.
-     */
-    readonly attachState: AttachState;
-    /**
-     * A newly created container starts detached from the collaborative service.
-     * Calling `attach()` uploads the new container to the service and connects to the collaborative service.
-     *
-     * @remarks
-     *
-     * This should only be called when the container is in the
-     * {@link @fluidframework/container-definitions#AttachState.Detatched} state.
-     *
-     * This can be determined by observing {@link IFluidContainer.attachState}.
-     *
-     * @returns A promise which resolves when the attach is complete, with the string identifier of the container.
-     */
-    attach(): Promise<string>;
-    /**
-     * Attempts to connect the container to the delta stream and process operations.
-     *
-     * @throws Will throw an error if connection is unsuccessful.
-     *
-     * @remarks
-     *
-     * This should only be called when the container is in the
-     * {@link @fluidframework/container-definitions#ConnectionState.Disconnected} state.
-     *
-     * This can be determined by observing {@link IFluidContainer.connectionState}.
-     */
-    connect(): void;
-    /**
-     * Disconnects the container from the delta stream and stops processing operations.
-     *
-     * @remarks
-     *
-     * This should only be called when the container is in the
-     * {@link @fluidframework/container-definitions#ConnectionState.Connected} state.
-     *
-     * This can be determined by observing {@link IFluidContainer.connectionState}.
-     */
-    disconnect(): void;
-    /**
-     * Create a new data object or Distributed Data Store (DDS) of the specified type.
-     *
-     * @remarks
-     *
-     * In order to share the data object or DDS with other
-     * collaborators and retrieve it later, store its handle in a collection like a SharedDirectory from your
-     * initialObjects.
-     *
-     * @param objectClass - The class of the `DataObject` or `SharedObject` to create.
-     *
-     * @typeParam T - The class of the `DataObject` or `SharedObject`.
-     */
-    create<T extends IFluidLoadable>(objectClass: LoadableObjectClass<T>): Promise<T>;
-    /**
-     * Dispose of the container instance, permanently disabling it.
-     */
-    dispose(): void;
-}
-
-/**
- * Events emitted from {@link IFluidContainer}.
- */
-export declare interface IFluidContainerEvents extends IEvent {
-    /**
-     * Emitted when the {@link IFluidContainer} completes connecting to the Fluid service.
-     *
-     * @remarks Reflects connection state changes against the (delta) service acknowledging ops/edits.
-     *
-     * @see
-     *
-     * - {@link IFluidContainer.connectionState}
-     *
-     * - {@link IFluidContainer.connect}
-     */
-    (event: "connected", listener: () => void): void;
-    /**
-     * Emitted when the {@link IFluidContainer} becomes disconnected from the Fluid service.
-     *
-     * @remarks Reflects connection state changes against the (delta) service acknowledging ops/edits.
-     *
-     * @see
-     *
-     * - {@link IFluidContainer.connectionState}
-     *
-     * - {@link IFluidContainer.disconnect}
-     */
-    (event: "disconnected", listener: () => void): void;
-    /**
-     * Emitted when all local changes/edits have been acknowledged by the service.
-     *
-     * @remarks "dirty" event will be emitted when the next local change has been made.
-     *
-     * @see {@link IFluidContainer.isDirty}
-     */
-    (event: "saved", listener: () => void): void;
-    /**
-     * Emitted when the first local change has been made, following a "saved" event.
-     *
-     * @remarks "saved" event will be emitted once all local changes have been acknowledged by the service.
-     *
-     * @see {@link IFluidContainer.isDirty}
-     */
-    (event: "dirty", listener: () => void): void;
-    /**
-     * Emitted when the {@link IFluidContainer} is closed, which permanently disables it.
-     *
-     * @remarks Listener parameters:
-     *
-     * - `error`: If the container was closed due to error (as opposed to an explicit call to
-     * {@link IFluidContainer.dispose}), this will contain details about the error that caused it.
-     */
-    (event: "disposed", listener: (error?: ICriticalContainerError) => void): any;
-}
-
-/**
- * Base interface to be implemented to fetch each service's member.
- *
- * @remarks This interface can be extended by each service to provide additional service-specific user metadata.
- */
-export declare interface IMember {
-    /**
-     * An ID for the user, unique among each individual user connecting to the session.
-     */
-    userId: string;
-    /**
-     * The set of connections the user has made, e.g. from multiple tabs or devices.
-     */
-    connections: IConnection[];
-}
-
-/**
- * Holds the collection of objects that the container was initially created with, as well as provides the ability
- * to dynamically create further objects during usage.
- */
-export declare interface IRootDataObject {
-    /**
-     * Provides a record of the initial objects defined on creation.
-     */
-    readonly initialObjects: LoadableObjectRecord;
-    /**
-     * Dynamically creates a new detached collaborative object (DDS/DataObject).
-     *
-     * @param objectClass - Type of the collaborative object to be created.
-     *
-     * @typeParam T - The class of the `DataObject` or `SharedObject`.
-     */
-    create<T extends IFluidLoadable>(objectClass: LoadableObjectClass<T>): Promise<T>;
-}
-
-/**
- * Base interface to be implemented to fetch each service's audience.
- *
- * @remarks
- *
- * The type parameter `M` allows consumers to further extend the client object with service-specific
- * details about the connecting client, such as device information, environment, or a username.
- *
- * @typeParam M - A service-specific {@link IMember} type.
- */
-export declare interface IServiceAudience<M extends IMember> extends IEventProvider<IServiceAudienceEvents<M>> {
-    /**
-     * Returns an map of all users currently in the Fluid session where key is the userId and the value is the
-     * member object.  The implementation may choose to exclude certain connections from the returned map.
-     * E.g. ServiceAudience excludes non-interactive connections to represent only the roster of live users.
-     */
-    getMembers(): Map<string, M>;
-    /**
-     * Returns the current active user on this client once they are connected. Otherwise, returns undefined.
-     */
-    getMyself(): Myself<M> | undefined;
-}
-
-/**
- * Events that trigger when the roster of members in the Fluid session change.
- *
- * @remarks
- *
- * Only changes that would be reflected in the returned map of {@link IServiceAudience}'s
- * {@link IServiceAudience.getMembers} method will emit events.
- *
- * @typeParam M - A service-specific {@link IMember} implementation.
- */
-export declare interface IServiceAudienceEvents<M extends IMember> extends IEvent {
-    /**
-     * Emitted when a {@link IMember | member}(s) are either added or removed.
-     *
-     * @eventProperty
-     */
-    (event: "membersChanged", listener: () => void): void;
-    /**
-     * Emitted when a {@link IMember | member} joins the audience.
-     *
-     * @eventProperty
-     */
-    (event: "memberAdded", listener: MemberChangedListener<M>): void;
-    /**
-     * Emitted when a {@link IMember | member} leaves the audience.
-     *
-     * @eventProperty
-     */
-    (event: "memberRemoved", listener: MemberChangedListener<M>): void;
-}
-
-/**
- * A class object of `DataObject` or `SharedObject`.
- *
- * @typeParam T - The class of the `DataObject` or `SharedObject`.
- */
-export declare type LoadableObjectClass<T extends IFluidLoadable> = DataObjectClass<T> | SharedObjectClass<T>;
-
-/**
- * A mapping of string identifiers to classes that will later be used to instantiate a corresponding `DataObject`
- * or `SharedObject` in a {@link LoadableObjectRecord}.
- */
-export declare type LoadableObjectClassRecord = Record<string, LoadableObjectClass<any>>;
-
-/**
- * An object with a constructor that will return an {@link @fluidframework/core-interfaces#IFluidLoadable}.
- *
- * @typeParam T - The class of the loadable object.
- */
-export declare type LoadableObjectCtor<T extends IFluidLoadable> = new (...args: any[]) => T;
-
-/**
- * A mapping of string identifiers to instantiated `DataObject`s or `SharedObject`s.
- */
-export declare type LoadableObjectRecord = Record<string, IFluidLoadable>;
-
-/**
- * Signature for {@link IMember} change events.
- *
- * @param clientId - A unique identifier for the client.
- * @param member - The service-specific member object for the client.
- *
- * @see See {@link IServiceAudienceEvents} for usage details.
- */
-export declare type MemberChangedListener<M extends IMember> = (clientId: string, member: M) => void;
-
-/**
- * An extended member object that includes currentConnection
- */
-export declare type Myself<M extends IMember = IMember> = M & {
-    currentConnection: string;
-};
-
-/**
- * Base class for providing audience information for sessions interacting with {@link IFluidContainer}
- *
- * @remarks
- *
- * This can be extended by different service-specific client packages to additional parameters to
- * the user and client details returned in {@link IMember}.
- *
- * @typeParam M - A service-specific {@link IMember} implementation.
- */
-export declare abstract class ServiceAudience<M extends IMember = IMember> extends TypedEventEmitter<IServiceAudienceEvents<M>> implements IServiceAudience<M> {
-    /**
-     * Fluid Container to read the audience from.
-     */
-    protected readonly container: IContainer;
-    /**
-     * Audience object which includes all the existing members of the {@link IFluidContainer | container}.
-     */
-    protected readonly audience: IAudience;
-    /**
-     * Retain the most recent member list.
-     *
-     * @remarks
-     *
-     * This is so we have more information about a member leaving the audience in the `removeMember` event.
-     *
-     * It allows us to match the behavior of the `addMember` event where it only fires on a change to the members this
-     * class exposes (and would actually produce a change in what `getMembers` returns).
-     *
-     * It also allows us to provide the client details in the event which makes it easier to find that client connection
-     * in a map keyed on the `userId` and not `clientId`.
-     *
-     * This map will always be up-to-date in a `removeMember` event because it is set once at construction and in
-     * every `addMember` event. It is mapped `clientId` to `M` to be better work with what the {@link IServiceAudience}
-     * events provide.
-     */
-    protected lastMembers: Map<string, M>;
-    constructor(
-    /**
-     * Fluid Container to read the audience from.
-     */
-    container: IContainer);
-    /**
-     * Provides ability for inheriting class to modify/extend the audience object.
-     *
-     * @param audienceMember - Record of a specific audience member.
-     */
-    protected abstract createServiceMember(audienceMember: IClient): M;
-    /**
-     * {@inheritDoc IServiceAudience.getMembers}
-     */
-    getMembers(): Map<string, M>;
-    /**
-     * {@inheritDoc IServiceAudience.getMyself}
-     */
-    getMyself(): Myself<M> | undefined;
-    private getMember;
-    /**
-     * Provides ability for the inheriting class to include/omit specific members.
-     * An example use case is omitting the summarizer client.
-     *
-     * @param member - Member to be included/omitted.
-     */
-    protected shouldIncludeAsMember(member: IClient): boolean;
-}
-
-/**
- * A class that has a factory that can create a DDSes (`SharedObject`s) and a
- * constructor that will return the type of the `DataObject`.
- *
- * @typeParam T - The class of the `SharedObject`.
- */
-export declare type SharedObjectClass<T extends IFluidLoadable> = {
-    readonly getFactory: () => IChannelFactory;
-} & LoadableObjectCtor<T>;
-
-export { }