@fluidframework/container-definitions 2.0.0-dev.7.4.0.215747 → 2.0.0-dev.7.4.0.216897

package/dist/container-definitions-untrimmed.d.ts

@@ -39,7 +39,7 @@ import { MessageType } from '@fluidframework/protocol-definitions';
 /**
  * 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.
- * @public
+ * @internal
  */
 export declare enum AttachState {
     /**
@@ -61,33 +61,37 @@ export declare enum AttachState {
 /**
  * Namespace for the different connection states a container can be in.
  * PLEASE NOTE: The sequence of the numerical values does no correspond to the typical connection state progression.
- * @public
+ * @internal
  */
 export declare namespace ConnectionState {
     /**
      * The container is not connected to the delta server.
      * Note - When in this state the container may be about to reconnect,
      * or may remain disconnected until explicitly told to connect.
+     * @internal
      */
     export type Disconnected = 0;
     /**
      * The container is disconnected but actively trying to establish a new connection.
      * PLEASE NOTE that this numerical value falls out of the order you may expect for this state.
+     * @internal
      */
     export type EstablishingConnection = 3;
     /**
      * The container has an inbound connection only, and is catching up to the latest known state from the service.
+     * @internal
      */
     export type CatchingUp = 1;
     /**
      * The container is fully connected and syncing.
+     * @internal
      */
     export type Connected = 2;
 }
 
 /**
  * Type defining the different states of connectivity a Container can be in.
- * @public
+ * @internal
  */
 export declare type ConnectionState = ConnectionState.Disconnected | ConnectionState.EstablishingConnection | ConnectionState.CatchingUp | ConnectionState.Connected;
 
@@ -95,7 +99,7 @@ export declare type ConnectionState = ConnectionState.Disconnected | ConnectionS
  * Different error types the Container may report out to the Host.
  *
  * @deprecated ContainerErrorType is being deprecated as a public export. Please use {@link ContainerErrorTypes#clientSessionExpiredError} instead.
- * @public
+ * @internal
  */
 export declare enum ContainerErrorType {
     /**
@@ -127,7 +131,7 @@ export declare enum ContainerErrorType {
 
 /**
  * Different error types the ClientSession may report out to the Host.
- * @public
+ * @internal
  */
 export declare const ContainerErrorTypes: {
     /**
@@ -143,13 +147,13 @@ export declare const ContainerErrorTypes: {
 };
 
 /**
- * @public
+ * @internal
  */
 export declare type ContainerErrorTypes = (typeof ContainerErrorTypes)[keyof typeof ContainerErrorTypes];
 
 /**
  * Represents warnings raised on container.
- * @public
+ * @internal
  */
 export declare interface ContainerWarning extends IErrorBase {
     /**
@@ -165,7 +169,7 @@ export declare interface ContainerWarning extends IErrorBase {
  *
  * See {@link https://nodejs.org/api/events.html#class-eventemitter | here} for an overview of the `EventEmitter`
  * class.
- * @public
+ * @internal
  */
 export declare interface IAudience extends EventEmitter {
     /**
@@ -185,7 +189,7 @@ export declare interface IAudience extends EventEmitter {
 
 /**
  * Manages the state and the members for {@link IAudience}
- * @public
+ * @internal
  */
 export declare interface IAudienceOwner extends IAudience {
     /**
@@ -201,7 +205,7 @@ export declare interface IAudienceOwner extends IAudience {
 
 /**
  * Payload type for IContainerContext.submitBatchFn()
- * @public
+ * @internal
  */
 export declare interface IBatchMessage {
     contents?: string;
@@ -213,7 +217,7 @@ export declare interface IBatchMessage {
 /**
  * Fluid code loader resolves a code module matching the document schema, i.e. code details, such as
  * a package name and package version range.
- * @public
+ * @internal
  */
 export declare interface ICodeDetailsLoader extends Partial<IProvideFluidCodeDetailsComparer> {
     /**
@@ -227,7 +231,7 @@ export declare interface ICodeDetailsLoader extends Partial<IProvideFluidCodeDet
 
 /**
  * Contract representing the result of a newly established connection to the server for syncing deltas.
- * @public
+ * @internal
  */
 export declare interface IConnectionDetails {
     clientId: string;
@@ -248,7 +252,7 @@ export declare interface IConnectionDetails {
 
 /**
  * The Host's view of a Container and its connection to storage
- * @public
+ * @internal
  */
 export declare interface IContainer extends IEventProvider<IContainerEvents>, IFluidRouter {
     /**
@@ -423,7 +427,6 @@ export declare interface IContainer extends IEventProvider<IContainerEvents>, IF
     /**
      * Allows the host to have the container force to be in read-only mode
      * @param readonly - Boolean that toggles if read-only policies will be enforced
-     * @alpha
      */
     forceReadonly?(readonly: boolean): any;
     /**
@@ -437,7 +440,7 @@ export declare interface IContainer extends IEventProvider<IContainerEvents>, IF
  * IContainerContext is fundamentally just the set of things that an IRuntimeFactory (and IRuntime) will consume from the
  * loader layer.  It gets passed into the IRuntimeFactory.instantiateRuntime call.  Only include members on this interface
  * if you intend them to be consumed/called from the runtime layer.
- * @public
+ * @internal
  */
 export declare interface IContainerContext {
     readonly options: ILoaderOptions;
@@ -505,7 +508,7 @@ export declare interface IContainerContext {
 
 /**
  * Events emitted by the {@link IContainer} "upwards" to the Loader and Host.
- * @public
+ * @internal
  */
 export declare interface IContainerEvents extends IEvent {
     /**
@@ -649,7 +652,7 @@ export declare interface IContainerEvents extends IEvent {
 }
 
 /**
- * @public
+ * @internal
  */
 export declare interface IContainerLoadMode {
     opsBeforeReturn?: undefined | "sequenceNumber" | "cached" | "all";
@@ -674,14 +677,13 @@ export declare interface IContainerLoadMode {
  * - {@link @fluidframework/odsp-driver-definitions#OdspErrorType}
  *
  * - {@link @fluidframework/routerlicious-driver#RouterliciousErrorType}
- *
- * @public
+ * @internal
  */
 export declare type ICriticalContainerError = IErrorBase;
 
 /**
  * Manages the transmission of ops between the runtime and storage.
- * @public
+ * @internal
  */
 export declare interface IDeltaManager<T, U> extends IEventProvider<IDeltaManagerEvents>, IDeltaSender {
     /**
@@ -750,7 +752,7 @@ export declare interface IDeltaManager<T, U> extends IEventProvider<IDeltaManage
 
 /**
  * Events emitted by {@link IDeltaManager}.
- * @public
+ * @internal
  */
 export declare interface IDeltaManagerEvents extends IEvent {
     /**
@@ -820,7 +822,7 @@ export declare interface IDeltaManagerEvents extends IEvent {
 
 /**
  * Queue of ops to be sent to or processed from storage
- * @public
+ * @internal
  */
 export declare interface IDeltaQueue<T> extends IEventProvider<IDeltaQueueEvents<T>>, IDisposable {
     /**
@@ -866,7 +868,7 @@ export declare interface IDeltaQueue<T> extends IEventProvider<IDeltaQueueEvents
 
 /**
  * Events emitted by {@link IDeltaQueue}.
- * @public
+ * @internal
  */
 export declare interface IDeltaQueueEvents<T> extends IErrorEvent {
     /**
@@ -907,7 +909,7 @@ export declare interface IDeltaQueueEvents<T> extends IErrorEvent {
 
 /**
  * Contract supporting delivery of outbound messages to the server
- * @public
+ * @internal
  */
 export declare interface IDeltaSender {
     /**
@@ -920,7 +922,7 @@ export { IErrorBase }
 
 /**
  * A Fluid package for specification for browser environments
- * @public
+ * @internal
  */
 export declare interface IFluidBrowserPackage extends IFluidPackage {
     /**
@@ -940,7 +942,7 @@ export declare interface IFluidBrowserPackage extends IFluidPackage {
 
 /**
  * A specific Fluid package environment for browsers
- * @public
+ * @internal
  */
 export declare interface IFluidBrowserPackageEnvironment extends IFluidPackageEnvironment {
     /**
@@ -963,7 +965,7 @@ export declare interface IFluidBrowserPackageEnvironment extends IFluidPackageEn
 
 /**
  * Data structure used to describe the code to load on the Fluid document
- * @public
+ * @internal
  */
 export declare interface IFluidCodeDetails {
     /**
@@ -981,13 +983,13 @@ export declare interface IFluidCodeDetails {
 }
 
 /**
- * @public
+ * @internal
  */
 export declare const IFluidCodeDetailsComparer: keyof IProvideFluidCodeDetailsComparer;
 
 /**
  * Provides capability to compare Fluid code details.
- * @public
+ * @internal
  */
 export declare interface IFluidCodeDetailsComparer extends IProvideFluidCodeDetailsComparer {
     /**
@@ -1016,7 +1018,7 @@ export declare interface IFluidCodeDetailsComparer extends IProvideFluidCodeDeta
 
 /**
  * Package manager configuration. Provides a key value mapping of config values
- * @public
+ * @internal
  */
 export declare interface IFluidCodeDetailsConfig {
     readonly [key: string]: string;
@@ -1028,7 +1030,7 @@ export declare interface IFluidCodeDetailsConfig {
  * 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.
- * @public
+ * @internal
  */
 export declare interface IFluidCodeResolver {
     /**
@@ -1041,7 +1043,7 @@ export declare interface IFluidCodeResolver {
 }
 
 /**
- * @public
+ * @internal
  */
 export declare interface IFluidModule {
     fluidExport: FluidObject<IRuntimeFactory & IProvideFluidCodeDetailsComparer>;
@@ -1049,7 +1051,7 @@ export declare interface IFluidModule {
 
 /**
  * Encapsulates a module entry point with corresponding code details.
- * @public
+ * @internal
  */
 export declare interface IFluidModuleWithDetails {
     /**
@@ -1070,7 +1072,7 @@ export declare interface IFluidModuleWithDetails {
  * While compatible with the npm package format it is not necessary that that package is an
  * npm package:
  * {@link https://stackoverflow.com/questions/10065564/add-custom-metadata-or-config-to-package-json-is-it-valid}
- * @public
+ * @internal
  */
 export declare interface IFluidPackage {
     /**
@@ -1097,7 +1099,7 @@ export declare interface IFluidPackage {
 
 /**
  * Specifies an environment on Fluid property of a IFluidPackage.
- * @public
+ * @internal
  */
 export declare interface IFluidPackageEnvironment {
     /**
@@ -1124,7 +1126,7 @@ export { IGenericError }
 
 /**
  * Defines list of properties expected for getPendingLocalState
- * @alpha
+ * @internal
  */
 export declare interface IGetPendingLocalStateProps {
     /**
@@ -1144,7 +1146,7 @@ export declare interface IGetPendingLocalStateProps {
 
 /**
  * The Host's view of the Loader, used for loading Containers
- * @public
+ * @internal
  */
 export declare interface IHostLoader extends ILoader {
     /**
@@ -1167,7 +1169,7 @@ export declare interface IHostLoader extends ILoader {
 
 /**
  * The Runtime's view of the Loader, used for loading Containers
- * @public
+ * @internal
  */
 export declare interface ILoader extends Partial<IProvideLoader> {
     /**
@@ -1192,7 +1194,7 @@ export declare interface ILoader extends Partial<IProvideLoader> {
 
 /**
  * Set of Request Headers that the Loader understands and may inspect or modify
- * @public
+ * @internal
  */
 export declare interface ILoaderHeader {
     /**
@@ -1211,7 +1213,7 @@ export declare interface ILoaderHeader {
 }
 
 /**
- * @public
+ * @internal
  */
 export declare type ILoaderOptions = {
     [key in string | number]: any;
@@ -1244,7 +1246,7 @@ export declare type ILoaderOptions = {
  * @deprecated 0.48, This API will be removed in 0.50
  * No replacement since it is not expected anyone will depend on this outside container-loader
  * See {@link https://github.com/microsoft/FluidFramework/issues/9711} for context.
- * @public
+ * @internal
  */
 export declare interface IPendingLocalState {
     url: string;
@@ -1252,21 +1254,21 @@ export declare interface IPendingLocalState {
 }
 
 /**
- * @public
+ * @internal
  */
 export declare interface IProvideFluidCodeDetailsComparer {
     readonly IFluidCodeDetailsComparer: IFluidCodeDetailsComparer;
 }
 
 /**
- * @public
+ * @internal
  */
 export declare interface IProvideLoader {
     readonly ILoader: ILoader;
 }
 
 /**
- * @public
+ * @internal
  */
 export declare interface IProvideRuntimeFactory {
     readonly IRuntimeFactory: IRuntimeFactory;
@@ -1275,7 +1277,7 @@ export declare interface IProvideRuntimeFactory {
 /**
  * The interface returned from a IFluidCodeResolver which represents IFluidCodeDetails
  * that have been resolved and are ready to load
- * @public
+ * @internal
  */
 export declare interface IResolvedFluidCodeDetails extends IFluidCodeDetails {
     /**
@@ -1291,7 +1293,7 @@ export declare interface IResolvedFluidCodeDetails extends IFluidCodeDetails {
 /**
  * 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.
- * @public
+ * @internal
  */
 export declare interface IRuntime extends IDisposable {
     /**
@@ -1326,8 +1328,6 @@ export declare interface IRuntime extends IDisposable {
     setAttachState(attachState: AttachState.Attaching | AttachState.Attached): void;
     /**
      * Get pending local state in a serializable format to be given back to a newly loaded container
-     * @alpha
-     * {@link https://github.com/microsoft/FluidFramework/packages/tree/main/loader/container-loader/closeAndGetPendingLocalState.md}
      */
     getPendingLocalState(props?: IGetPendingLocalStateProps): unknown;
     /**
@@ -1351,7 +1351,7 @@ export declare interface IRuntime extends IDisposable {
 }
 
 /**
- * @public
+ * @internal
  */
 export declare const IRuntimeFactory: keyof IProvideRuntimeFactory;
 
@@ -1360,7 +1360,7 @@ export declare const IRuntimeFactory: keyof IProvideRuntimeFactory;
  *
  * Provides the entry point for the ContainerContext to load the proper IRuntime
  * to start up the running instance of the Container.
- * @public
+ * @internal
  */
 export declare interface IRuntimeFactory extends IProvideRuntimeFactory {
     /**
@@ -1376,20 +1376,20 @@ export declare interface IRuntimeFactory extends IProvideRuntimeFactory {
 /**
  * Determines if any object is an IFluidBrowserPackage
  * @param maybePkg - The object to check for compatibility with IFluidBrowserPackage
- * @public
+ * @internal
  */
 export declare const isFluidBrowserPackage: (maybePkg: unknown) => maybePkg is Readonly<IFluidBrowserPackage>;
 
 /**
  * Determines if any object is an IFluidCodeDetails
- * @public
+ * @internal
  */
 export declare const isFluidCodeDetails: (details: unknown) => details is Readonly<IFluidCodeDetails>;
 
 /**
  * Check if the package.json defines a Fluid package
  * @param pkg - the package json data to check if it is a Fluid package.
- * @public
+ * @internal
  */
 export declare const isFluidPackage: (pkg: unknown) => pkg is Readonly<IFluidPackage>;
 
@@ -1398,7 +1398,7 @@ export declare const isFluidPackage: (pkg: unknown) => pkg is Readonly<IFluidPac
  * in separate property: {@link ISnapshotTreeWithBlobContents.blobsContents}.
  *
  * @remarks This is used as the `ContainerContext`'s base snapshot when attaching.
- * @public
+ * @internal
  */
 export declare interface ISnapshotTreeWithBlobContents extends ISnapshotTree {
     blobsContents: {
@@ -1415,7 +1415,7 @@ export { IUsageError }
 
 /**
  * Accepted header keys for requests coming to the Loader
- * @public
+ * @internal
  */
 export declare enum LoaderHeader {
     /**
@@ -1444,7 +1444,7 @@ export declare enum LoaderHeader {
 }
 
 /**
- * @public
+ * @internal
  */
 export declare type ReadOnlyInfo = {
     readonly readonly: false | undefined;

package/dist/deltas.d.ts

@@ -7,7 +7,7 @@ import { IAnyDriverError } from "@fluidframework/driver-definitions";
 import { IClientConfiguration, IClientDetails, IDocumentMessage, ISequencedDocumentMessage, ISignalMessage, ITokenClaims } from "@fluidframework/protocol-definitions";
 /**
  * Contract representing the result of a newly established connection to the server for syncing deltas.
- * @public
+ * @internal
  */
 export interface IConnectionDetails {
     clientId: string;
@@ -27,7 +27,7 @@ export interface IConnectionDetails {
 }
 /**
  * Contract supporting delivery of outbound messages to the server
- * @public
+ * @internal
  */
 export interface IDeltaSender {
     /**
@@ -37,7 +37,7 @@ export interface IDeltaSender {
 }
 /**
  * Events emitted by {@link IDeltaManager}.
- * @public
+ * @internal
  */
 export interface IDeltaManagerEvents extends IEvent {
     /**
@@ -106,7 +106,7 @@ export interface IDeltaManagerEvents extends IEvent {
 }
 /**
  * Manages the transmission of ops between the runtime and storage.
- * @public
+ * @internal
  */
 export interface IDeltaManager<T, U> extends IEventProvider<IDeltaManagerEvents>, IDeltaSender {
     /**
@@ -174,7 +174,7 @@ export interface IDeltaManager<T, U> extends IEventProvider<IDeltaManagerEvents>
 }
 /**
  * Events emitted by {@link IDeltaQueue}.
- * @public
+ * @internal
  */
 export interface IDeltaQueueEvents<T> extends IErrorEvent {
     /**
@@ -214,7 +214,7 @@ export interface IDeltaQueueEvents<T> extends IErrorEvent {
 }
 /**
  * Queue of ops to be sent to or processed from storage
- * @public
+ * @internal
  */
 export interface IDeltaQueue<T> extends IEventProvider<IDeltaQueueEvents<T>>, IDisposable {
     /**
@@ -258,7 +258,7 @@ export interface IDeltaQueue<T> extends IEventProvider<IDeltaQueueEvents<T>>, ID
     }>;
 }
 /**
- * @public
+ * @internal
  */
 export type ReadOnlyInfo = {
     readonly readonly: false | undefined;

package/dist/deltas.js.map

@@ -1 +1 @@
-{"version":3,"file":"deltas.js","sourceRoot":"","sources":["../src/deltas.ts"],"names":[],"mappings":";AAAA;;;GAGG","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport {\n\tIDisposable,\n\tIEventProvider,\n\tIEvent,\n\tIErrorEvent,\n\tIErrorBase,\n} from \"@fluidframework/core-interfaces\";\nimport { IAnyDriverError } from \"@fluidframework/driver-definitions\";\nimport {\n\tIClientConfiguration,\n\tIClientDetails,\n\tIDocumentMessage,\n\tISequencedDocumentMessage,\n\tISignalMessage,\n\tITokenClaims,\n} from \"@fluidframework/protocol-definitions\";\n\n/**\n * Contract representing the result of a newly established connection to the server for syncing deltas.\n * @public\n */\nexport interface IConnectionDetails {\n\tclientId: string;\n\tclaims: ITokenClaims;\n\tserviceConfiguration: IClientConfiguration;\n\n\t/**\n\t * Last known sequence number to ordering service at the time of connection.\n\t *\n\t * @remarks\n\t *\n\t * It may lap actual last sequence number (quite a bit, if container is very active).\n\t * But it's the best information for client to figure out how far it is behind, at least\n\t * for \"read\" connections. \"write\" connections may use own \"join\" op to similar information,\n\t * that is likely to be more up-to-date.\n\t */\n\tcheckpointSequenceNumber: number | undefined;\n}\n\n/**\n * Contract supporting delivery of outbound messages to the server\n * @public\n */\nexport interface IDeltaSender {\n\t/**\n\t * Flush all pending messages through the outbound queue\n\t */\n\tflush(): void;\n}\n\n/**\n * Events emitted by {@link IDeltaManager}.\n * @public\n */\nexport interface IDeltaManagerEvents extends IEvent {\n\t/**\n\t * @deprecated No replacement API recommended.\n\t */\n\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\t(event: \"prepareSend\", listener: (messageBuffer: any[]) => void);\n\n\t/**\n\t * @deprecated No replacement API recommended.\n\t */\n\t(event: \"submitOp\", listener: (message: IDocumentMessage) => void);\n\n\t/**\n\t * Emitted immediately after processing an incoming operation (op).\n\t *\n\t * @remarks\n\t *\n\t * Note: this event is not intended for general use.\n\t * Prefer to listen to events on the appropriate ultimate recipients of the ops, rather than listening to the\n\t * ops directly on the {@link IDeltaManager}.\n\t *\n\t * Listener parameters:\n\t *\n\t * - `message`: The op that was processed.\n\t *\n\t * - `processingTime`: The amount of time it took to process the inbound operation (op), expressed in milliseconds.\n\t */\n\t(event: \"op\", listener: (message: ISequencedDocumentMessage, processingTime: number) => void);\n\n\t/**\n\t * Emitted periodically with latest information on network roundtrip latency\n\t */\n\t(event: \"pong\", listener: (latency: number) => void);\n\n\t/**\n\t * Emitted when the {@link IDeltaManager} completes connecting to the Fluid service.\n\t *\n\t * @remarks\n\t * This occurs once we've received the connect_document_success message from the server,\n\t * and happens prior to the client's join message (if there is a join message).\n\t *\n\t * Listener parameters:\n\t *\n\t * - `details`: Connection metadata.\n\t *\n\t * - `opsBehind`: An estimate of far behind the client is relative to the service in terms of ops.\n\t * Will not be specified if an estimate cannot be determined.\n\t */\n\t(event: \"connect\", listener: (details: IConnectionDetails, opsBehind?: number) => void);\n\n\t/**\n\t * Emitted when the {@link IDeltaManager} becomes disconnected from the Fluid service.\n\t *\n\t * @remarks Listener parameters:\n\t *\n\t * - `reason`: Describes the reason for which the delta manager was disconnected.\n\t * - `error` : error if any for the disconnect.\n\t */\n\t(event: \"disconnect\", listener: (reason: string, error?: IAnyDriverError) => void);\n\n\t/**\n\t * Emitted when read/write permissions change.\n\t *\n\t * @remarks Listener parameters:\n\t *\n\t * - `readonly`: Whether or not the delta manager is now read-only.\n\t */\n\t(\n\t\tevent: \"readonly\",\n\t\tlistener: (\n\t\t\treadonly: boolean,\n\t\t\treadonlyConnectionReason?: { reason: string; error?: IErrorBase },\n\t\t) => void,\n\t);\n}\n\n/**\n * Manages the transmission of ops between the runtime and storage.\n * @public\n */\nexport interface IDeltaManager<T, U> extends IEventProvider<IDeltaManagerEvents>, IDeltaSender {\n\t/**\n\t * The queue of inbound delta messages\n\t */\n\treadonly inbound: IDeltaQueue<T>;\n\n\t/**\n\t * The queue of outbound delta messages\n\t */\n\treadonly outbound: IDeltaQueue<U[]>;\n\n\t/**\n\t * The queue of inbound delta signals\n\t */\n\treadonly inboundSignal: IDeltaQueue<ISignalMessage>;\n\n\t/**\n\t * The current minimum sequence number\n\t */\n\treadonly minimumSequenceNumber: number;\n\n\t/**\n\t * The last sequence number processed by the delta manager\n\t */\n\treadonly lastSequenceNumber: number;\n\n\t/**\n\t * The last message processed by the delta manager\n\t */\n\treadonly lastMessage: ISequencedDocumentMessage | undefined;\n\n\t/**\n\t * The latest sequence number the delta manager is aware of\n\t */\n\treadonly lastKnownSeqNumber: number;\n\n\t/**\n\t * The initial sequence number set when attaching the op handler\n\t */\n\treadonly initialSequenceNumber: number;\n\n\t/**\n\t * Tells if current connection has checkpoint information.\n\t * I.e. we know how far behind the client was at the time of establishing connection\n\t */\n\treadonly hasCheckpointSequenceNumber: boolean;\n\n\t/**\n\t * Details of client\n\t */\n\treadonly clientDetails: IClientDetails;\n\n\t/**\n\t * Protocol version being used to communicate with the service\n\t */\n\treadonly version: string;\n\n\t/**\n\t * Max message size allowed to the delta manager\n\t */\n\treadonly maxMessageSize: number;\n\n\t/**\n\t * Service configuration provided by the service.\n\t */\n\treadonly serviceConfiguration: IClientConfiguration | undefined;\n\n\t/**\n\t * Flag to indicate whether the client can write or not.\n\t */\n\treadonly active: boolean;\n\n\treadonly readOnlyInfo: ReadOnlyInfo;\n\n\t/**\n\t * Submit a signal to the service to be broadcast to other connected clients, but not persisted\n\t */\n\t// TODO: use `unknown` instead (API breaking)\n\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\tsubmitSignal(content: any, targetClientId?: string): void;\n}\n\n/**\n * Events emitted by {@link IDeltaQueue}.\n * @public\n */\nexport interface IDeltaQueueEvents<T> extends IErrorEvent {\n\t/**\n\t * Emitted when a task is enqueued.\n\t *\n\t * @remarks Listener parameters:\n\t *\n\t * - `task`: The task being enqueued.\n\t */\n\t(event: \"push\", listener: (task: T) => void);\n\n\t/**\n\t * Emitted immediately after processing an enqueued task and removing it from the queue.\n\t *\n\t * @remarks\n\t *\n\t * Note: this event is not intended for general use.\n\t * Prefer to listen to events on the appropriate ultimate recipients of the ops, rather than listening to the\n\t * ops directly on the {@link IDeltaQueue}.\n\t *\n\t * Listener parameters:\n\t *\n\t * - `task`: The task that was processed.\n\t */\n\t(event: \"op\", listener: (task: T) => void);\n\n\t/**\n\t * Emitted when the queue of tasks to process is emptied.\n\t *\n\t * @remarks Listener parameters:\n\t *\n\t * - `count`: The number of events (`T`) processed before becoming idle.\n\t *\n\t * - `duration`: The amount of time it took to process elements (in milliseconds).\n\t *\n\t * @see {@link IDeltaQueue.idle}\n\t */\n\t(event: \"idle\", listener: (count: number, duration: number) => void);\n}\n\n/**\n * Queue of ops to be sent to or processed from storage\n * @public\n */\nexport interface IDeltaQueue<T> extends IEventProvider<IDeltaQueueEvents<T>>, IDisposable {\n\t/**\n\t * Flag indicating whether or not the queue was paused\n\t */\n\tpaused: boolean;\n\n\t/**\n\t * The number of messages remaining in the queue\n\t */\n\tlength: number;\n\n\t/**\n\t * Flag indicating whether or not the queue is idle.\n\t * I.e. there are no remaining messages to processes.\n\t */\n\tidle: boolean;\n\n\t/**\n\t * Pauses processing on the queue.\n\t *\n\t * @returns A promise which resolves when processing has been paused.\n\t */\n\tpause(): Promise<void>;\n\n\t/**\n\t * Resumes processing on the queue\n\t */\n\tresume(): void;\n\n\t/**\n\t * Peeks at the next message in the queue\n\t */\n\tpeek(): T | undefined;\n\n\t/**\n\t * Returns all the items in the queue as an array. Does not remove them from the queue.\n\t */\n\ttoArray(): T[];\n\n\t/**\n\t * returns number of ops processed and time it took to process these ops.\n\t * Zeros if queue did not process anything (had no messages, was paused or had hit an error before)\n\t */\n\twaitTillProcessingDone(): Promise<{ count: number; duration: number }>;\n}\n\n/**\n * @public\n */\nexport type ReadOnlyInfo =\n\t| {\n\t\t\treadonly readonly: false | undefined;\n\t  }\n\t| {\n\t\t\treadonly readonly: true;\n\n\t\t\t/**\n\t\t\t * Read-only because `forceReadOnly()` was called.\n\t\t\t */\n\t\t\treadonly forced: boolean;\n\n\t\t\t/**\n\t\t\t * Read-only because client does not have write permissions for document.\n\t\t\t */\n\t\t\treadonly permissions: boolean | undefined;\n\n\t\t\t/**\n\t\t\t * Read-only with no delta stream connection.\n\t\t\t */\n\t\t\treadonly storageOnly: boolean;\n\n\t\t\t/**\n\t\t\t * Extra info on why connection to delta stream is not possible.\n\t\t\t *\n\t\t\t * @remarks This info might be provided if {@link ReadOnlyInfo.storageOnly} is set to `true`.\n\t\t\t */\n\t\t\treadonly storageOnlyReason?: string;\n\t  };\n"]}
+{"version":3,"file":"deltas.js","sourceRoot":"","sources":["../src/deltas.ts"],"names":[],"mappings":";AAAA;;;GAGG","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport {\n\tIDisposable,\n\tIEventProvider,\n\tIEvent,\n\tIErrorEvent,\n\tIErrorBase,\n} from \"@fluidframework/core-interfaces\";\nimport { IAnyDriverError } from \"@fluidframework/driver-definitions\";\nimport {\n\tIClientConfiguration,\n\tIClientDetails,\n\tIDocumentMessage,\n\tISequencedDocumentMessage,\n\tISignalMessage,\n\tITokenClaims,\n} from \"@fluidframework/protocol-definitions\";\n\n/**\n * Contract representing the result of a newly established connection to the server for syncing deltas.\n * @internal\n */\nexport interface IConnectionDetails {\n\tclientId: string;\n\tclaims: ITokenClaims;\n\tserviceConfiguration: IClientConfiguration;\n\n\t/**\n\t * Last known sequence number to ordering service at the time of connection.\n\t *\n\t * @remarks\n\t *\n\t * It may lap actual last sequence number (quite a bit, if container is very active).\n\t * But it's the best information for client to figure out how far it is behind, at least\n\t * for \"read\" connections. \"write\" connections may use own \"join\" op to similar information,\n\t * that is likely to be more up-to-date.\n\t */\n\tcheckpointSequenceNumber: number | undefined;\n}\n\n/**\n * Contract supporting delivery of outbound messages to the server\n * @internal\n */\nexport interface IDeltaSender {\n\t/**\n\t * Flush all pending messages through the outbound queue\n\t */\n\tflush(): void;\n}\n\n/**\n * Events emitted by {@link IDeltaManager}.\n * @internal\n */\nexport interface IDeltaManagerEvents extends IEvent {\n\t/**\n\t * @deprecated No replacement API recommended.\n\t */\n\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\t(event: \"prepareSend\", listener: (messageBuffer: any[]) => void);\n\n\t/**\n\t * @deprecated No replacement API recommended.\n\t */\n\t(event: \"submitOp\", listener: (message: IDocumentMessage) => void);\n\n\t/**\n\t * Emitted immediately after processing an incoming operation (op).\n\t *\n\t * @remarks\n\t *\n\t * Note: this event is not intended for general use.\n\t * Prefer to listen to events on the appropriate ultimate recipients of the ops, rather than listening to the\n\t * ops directly on the {@link IDeltaManager}.\n\t *\n\t * Listener parameters:\n\t *\n\t * - `message`: The op that was processed.\n\t *\n\t * - `processingTime`: The amount of time it took to process the inbound operation (op), expressed in milliseconds.\n\t */\n\t(event: \"op\", listener: (message: ISequencedDocumentMessage, processingTime: number) => void);\n\n\t/**\n\t * Emitted periodically with latest information on network roundtrip latency\n\t */\n\t(event: \"pong\", listener: (latency: number) => void);\n\n\t/**\n\t * Emitted when the {@link IDeltaManager} completes connecting to the Fluid service.\n\t *\n\t * @remarks\n\t * This occurs once we've received the connect_document_success message from the server,\n\t * and happens prior to the client's join message (if there is a join message).\n\t *\n\t * Listener parameters:\n\t *\n\t * - `details`: Connection metadata.\n\t *\n\t * - `opsBehind`: An estimate of far behind the client is relative to the service in terms of ops.\n\t * Will not be specified if an estimate cannot be determined.\n\t */\n\t(event: \"connect\", listener: (details: IConnectionDetails, opsBehind?: number) => void);\n\n\t/**\n\t * Emitted when the {@link IDeltaManager} becomes disconnected from the Fluid service.\n\t *\n\t * @remarks Listener parameters:\n\t *\n\t * - `reason`: Describes the reason for which the delta manager was disconnected.\n\t * - `error` : error if any for the disconnect.\n\t */\n\t(event: \"disconnect\", listener: (reason: string, error?: IAnyDriverError) => void);\n\n\t/**\n\t * Emitted when read/write permissions change.\n\t *\n\t * @remarks Listener parameters:\n\t *\n\t * - `readonly`: Whether or not the delta manager is now read-only.\n\t */\n\t(\n\t\tevent: \"readonly\",\n\t\tlistener: (\n\t\t\treadonly: boolean,\n\t\t\treadonlyConnectionReason?: { reason: string; error?: IErrorBase },\n\t\t) => void,\n\t);\n}\n\n/**\n * Manages the transmission of ops between the runtime and storage.\n * @internal\n */\nexport interface IDeltaManager<T, U> extends IEventProvider<IDeltaManagerEvents>, IDeltaSender {\n\t/**\n\t * The queue of inbound delta messages\n\t */\n\treadonly inbound: IDeltaQueue<T>;\n\n\t/**\n\t * The queue of outbound delta messages\n\t */\n\treadonly outbound: IDeltaQueue<U[]>;\n\n\t/**\n\t * The queue of inbound delta signals\n\t */\n\treadonly inboundSignal: IDeltaQueue<ISignalMessage>;\n\n\t/**\n\t * The current minimum sequence number\n\t */\n\treadonly minimumSequenceNumber: number;\n\n\t/**\n\t * The last sequence number processed by the delta manager\n\t */\n\treadonly lastSequenceNumber: number;\n\n\t/**\n\t * The last message processed by the delta manager\n\t */\n\treadonly lastMessage: ISequencedDocumentMessage | undefined;\n\n\t/**\n\t * The latest sequence number the delta manager is aware of\n\t */\n\treadonly lastKnownSeqNumber: number;\n\n\t/**\n\t * The initial sequence number set when attaching the op handler\n\t */\n\treadonly initialSequenceNumber: number;\n\n\t/**\n\t * Tells if current connection has checkpoint information.\n\t * I.e. we know how far behind the client was at the time of establishing connection\n\t */\n\treadonly hasCheckpointSequenceNumber: boolean;\n\n\t/**\n\t * Details of client\n\t */\n\treadonly clientDetails: IClientDetails;\n\n\t/**\n\t * Protocol version being used to communicate with the service\n\t */\n\treadonly version: string;\n\n\t/**\n\t * Max message size allowed to the delta manager\n\t */\n\treadonly maxMessageSize: number;\n\n\t/**\n\t * Service configuration provided by the service.\n\t */\n\treadonly serviceConfiguration: IClientConfiguration | undefined;\n\n\t/**\n\t * Flag to indicate whether the client can write or not.\n\t */\n\treadonly active: boolean;\n\n\treadonly readOnlyInfo: ReadOnlyInfo;\n\n\t/**\n\t * Submit a signal to the service to be broadcast to other connected clients, but not persisted\n\t */\n\t// TODO: use `unknown` instead (API breaking)\n\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\tsubmitSignal(content: any, targetClientId?: string): void;\n}\n\n/**\n * Events emitted by {@link IDeltaQueue}.\n * @internal\n */\nexport interface IDeltaQueueEvents<T> extends IErrorEvent {\n\t/**\n\t * Emitted when a task is enqueued.\n\t *\n\t * @remarks Listener parameters:\n\t *\n\t * - `task`: The task being enqueued.\n\t */\n\t(event: \"push\", listener: (task: T) => void);\n\n\t/**\n\t * Emitted immediately after processing an enqueued task and removing it from the queue.\n\t *\n\t * @remarks\n\t *\n\t * Note: this event is not intended for general use.\n\t * Prefer to listen to events on the appropriate ultimate recipients of the ops, rather than listening to the\n\t * ops directly on the {@link IDeltaQueue}.\n\t *\n\t * Listener parameters:\n\t *\n\t * - `task`: The task that was processed.\n\t */\n\t(event: \"op\", listener: (task: T) => void);\n\n\t/**\n\t * Emitted when the queue of tasks to process is emptied.\n\t *\n\t * @remarks Listener parameters:\n\t *\n\t * - `count`: The number of events (`T`) processed before becoming idle.\n\t *\n\t * - `duration`: The amount of time it took to process elements (in milliseconds).\n\t *\n\t * @see {@link IDeltaQueue.idle}\n\t */\n\t(event: \"idle\", listener: (count: number, duration: number) => void);\n}\n\n/**\n * Queue of ops to be sent to or processed from storage\n * @internal\n */\nexport interface IDeltaQueue<T> extends IEventProvider<IDeltaQueueEvents<T>>, IDisposable {\n\t/**\n\t * Flag indicating whether or not the queue was paused\n\t */\n\tpaused: boolean;\n\n\t/**\n\t * The number of messages remaining in the queue\n\t */\n\tlength: number;\n\n\t/**\n\t * Flag indicating whether or not the queue is idle.\n\t * I.e. there are no remaining messages to processes.\n\t */\n\tidle: boolean;\n\n\t/**\n\t * Pauses processing on the queue.\n\t *\n\t * @returns A promise which resolves when processing has been paused.\n\t */\n\tpause(): Promise<void>;\n\n\t/**\n\t * Resumes processing on the queue\n\t */\n\tresume(): void;\n\n\t/**\n\t * Peeks at the next message in the queue\n\t */\n\tpeek(): T | undefined;\n\n\t/**\n\t * Returns all the items in the queue as an array. Does not remove them from the queue.\n\t */\n\ttoArray(): T[];\n\n\t/**\n\t * returns number of ops processed and time it took to process these ops.\n\t * Zeros if queue did not process anything (had no messages, was paused or had hit an error before)\n\t */\n\twaitTillProcessingDone(): Promise<{ count: number; duration: number }>;\n}\n\n/**\n * @internal\n */\nexport type ReadOnlyInfo =\n\t| {\n\t\t\treadonly readonly: false | undefined;\n\t  }\n\t| {\n\t\t\treadonly readonly: true;\n\n\t\t\t/**\n\t\t\t * Read-only because `forceReadOnly()` was called.\n\t\t\t */\n\t\t\treadonly forced: boolean;\n\n\t\t\t/**\n\t\t\t * Read-only because client does not have write permissions for document.\n\t\t\t */\n\t\t\treadonly permissions: boolean | undefined;\n\n\t\t\t/**\n\t\t\t * Read-only with no delta stream connection.\n\t\t\t */\n\t\t\treadonly storageOnly: boolean;\n\n\t\t\t/**\n\t\t\t * Extra info on why connection to delta stream is not possible.\n\t\t\t *\n\t\t\t * @remarks This info might be provided if {@link ReadOnlyInfo.storageOnly} is set to `true`.\n\t\t\t */\n\t\t\treadonly storageOnlyReason?: string;\n\t  };\n"]}

package/dist/error.d.ts

@@ -5,7 +5,7 @@
 import { IErrorBase } from "@fluidframework/core-interfaces";
 /**
  * Different error types the ClientSession may report out to the Host.
- * @public
+ * @internal
  */
 export declare const ContainerErrorTypes: {
     /**
@@ -20,14 +20,14 @@ export declare const ContainerErrorTypes: {
     readonly usageError: "usageError";
 };
 /**
- * @public
+ * @internal
  */
 export type ContainerErrorTypes = (typeof ContainerErrorTypes)[keyof typeof ContainerErrorTypes];
 /**
  * Different error types the Container may report out to the Host.
  *
  * @deprecated ContainerErrorType is being deprecated as a public export. Please use {@link ContainerErrorTypes#clientSessionExpiredError} instead.
- * @public
+ * @internal
  */
 export declare enum ContainerErrorType {
     /**
@@ -58,7 +58,7 @@ export declare enum ContainerErrorType {
 }
 /**
  * Represents warnings raised on container.
- * @public
+ * @internal
  */
 export interface ContainerWarning extends IErrorBase {
     /**
@@ -82,8 +82,7 @@ export interface ContainerWarning extends IErrorBase {
  * - {@link @fluidframework/odsp-driver-definitions#OdspErrorType}
  *
  * - {@link @fluidframework/routerlicious-driver#RouterliciousErrorType}
- *
- * @public
+ * @internal
  */
 export type ICriticalContainerError = IErrorBase;
 //# sourceMappingURL=error.d.ts.map

package/dist/error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAmB,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAE9E;;;GAGG;AACH,eAAO,MAAM,mBAAmB;IAE/B;;;OAGG;;;;;;;CAEM,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAC;AAEjG;;;;;GAKG;AACH,oBAAY,kBAAkB;IAC7B;;OAEG;IACH,YAAY,iBAAiB;IAE7B;;OAEG;IACH,eAAe,oBAAoB;IAEnC;;OAEG;IACH,mBAAmB,wBAAwB;IAE3C;;OAEG;IACH,mBAAmB,wBAAwB;IAE3C;;OAEG;IACH,UAAU,eAAe;IAEzB;;;OAGG;IACH,yBAAyB,8BAA8B;CACvD;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IACnD;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,uBAAuB,GAAG,UAAU,CAAC"}
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAmB,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAE9E;;;GAGG;AACH,eAAO,MAAM,mBAAmB;IAE/B;;;OAGG;;;;;;;CAEM,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAC;AAEjG;;;;;GAKG;AACH,oBAAY,kBAAkB;IAC7B;;OAEG;IACH,YAAY,iBAAiB;IAE7B;;OAEG;IACH,eAAe,oBAAoB;IAEnC;;OAEG;IACH,mBAAmB,wBAAwB;IAE3C;;OAEG;IACH,mBAAmB,wBAAwB;IAE3C;;OAEG;IACH,UAAU,eAAe;IAEzB;;;OAGG;IACH,yBAAyB,8BAA8B;CACvD;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IACnD;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,uBAAuB,GAAG,UAAU,CAAC"}

package/dist/error.js

@@ -8,7 +8,7 @@ exports.ContainerErrorType = exports.ContainerErrorTypes = void 0;
 const core_interfaces_1 = require("@fluidframework/core-interfaces");
 /**
  * Different error types the ClientSession may report out to the Host.
- * @public
+ * @internal
  */
 exports.ContainerErrorTypes = {
     ...core_interfaces_1.FluidErrorTypes,
@@ -22,7 +22,7 @@ exports.ContainerErrorTypes = {
  * Different error types the Container may report out to the Host.
  *
  * @deprecated ContainerErrorType is being deprecated as a public export. Please use {@link ContainerErrorTypes#clientSessionExpiredError} instead.
- * @public
+ * @internal
  */
 var ContainerErrorType;
 (function (ContainerErrorType) {