@fluidframework/container-loader 2.0.0-internal.7.2.2 → 2.0.0-internal.7.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +8 -0
- package/README.md +1 -2
- package/api-extractor-lint.json +13 -0
- package/api-extractor.json +3 -3
- package/api-report/container-loader.api.md +18 -18
- package/dist/{audience.js → audience.cjs} +1 -1
- package/dist/audience.cjs.map +1 -0
- package/dist/audience.d.ts +1 -0
- package/dist/audience.d.ts.map +1 -1
- package/dist/{catchUpMonitor.js → catchUpMonitor.cjs} +1 -1
- package/dist/catchUpMonitor.cjs.map +1 -0
- package/dist/{connectionManager.js → connectionManager.cjs} +23 -20
- package/dist/connectionManager.cjs.map +1 -0
- package/dist/connectionManager.d.ts.map +1 -1
- package/dist/{connectionState.js → connectionState.cjs} +4 -1
- package/dist/connectionState.cjs.map +1 -0
- package/dist/connectionState.d.ts +3 -0
- package/dist/connectionState.d.ts.map +1 -1
- package/dist/{connectionStateHandler.js → connectionStateHandler.cjs} +6 -6
- package/dist/connectionStateHandler.cjs.map +1 -0
- package/dist/connectionStateHandler.d.ts +10 -0
- package/dist/connectionStateHandler.d.ts.map +1 -1
- package/dist/container-loader-alpha.d.ts +240 -0
- package/dist/container-loader-beta.d.ts +96 -0
- package/dist/container-loader-public.d.ts +96 -0
- package/dist/container-loader-untrimmed.d.ts +351 -0
- package/dist/{container.js → container.cjs} +36 -29
- package/dist/container.cjs.map +1 -0
- package/dist/container.d.ts +4 -6
- package/dist/container.d.ts.map +1 -1
- package/dist/{containerContext.js → containerContext.cjs} +1 -1
- package/dist/containerContext.cjs.map +1 -0
- package/dist/{containerStorageAdapter.js → containerStorageAdapter.cjs} +6 -6
- package/dist/containerStorageAdapter.cjs.map +1 -0
- package/dist/{contracts.js → contracts.cjs} +1 -1
- package/dist/contracts.cjs.map +1 -0
- package/dist/{debugLogger.js → debugLogger.cjs} +10 -5
- package/dist/debugLogger.cjs.map +1 -0
- package/dist/debugLogger.d.ts.map +1 -1
- package/dist/{deltaManager.js → deltaManager.cjs} +21 -4
- package/dist/deltaManager.cjs.map +1 -0
- package/dist/deltaManager.d.ts.map +1 -1
- package/dist/{deltaQueue.js → deltaQueue.cjs} +1 -1
- package/dist/deltaQueue.cjs.map +1 -0
- package/dist/{disposal.js → disposal.cjs} +1 -1
- package/dist/disposal.cjs.map +1 -0
- package/dist/{error.js → error.cjs} +1 -1
- package/dist/error.cjs.map +1 -0
- package/dist/{index.js → index.cjs} +6 -6
- package/dist/index.cjs.map +1 -0
- package/dist/{loader.js → loader.cjs} +7 -5
- package/dist/loader.cjs.map +1 -0
- package/dist/loader.d.ts +12 -2
- package/dist/loader.d.ts.map +1 -1
- package/dist/location-redirection-utilities/{index.js → index.cjs} +2 -2
- package/dist/location-redirection-utilities/index.cjs.map +1 -0
- package/dist/location-redirection-utilities/{resolveWithLocationRedirection.js → resolveWithLocationRedirection.cjs} +3 -1
- package/dist/location-redirection-utilities/resolveWithLocationRedirection.cjs.map +1 -0
- package/dist/location-redirection-utilities/resolveWithLocationRedirection.d.ts +2 -0
- package/dist/location-redirection-utilities/resolveWithLocationRedirection.d.ts.map +1 -1
- package/dist/{noopHeuristic.js → noopHeuristic.cjs} +1 -1
- package/dist/noopHeuristic.cjs.map +1 -0
- package/dist/{packageVersion.js → packageVersion.cjs} +2 -2
- package/dist/packageVersion.cjs.map +1 -0
- package/dist/packageVersion.d.ts +1 -1
- package/dist/{protocol.js → protocol.cjs} +1 -1
- package/dist/protocol.cjs.map +1 -0
- package/dist/protocol.d.ts +4 -0
- package/dist/protocol.d.ts.map +1 -1
- package/dist/{protocolTreeDocumentStorageService.js → protocolTreeDocumentStorageService.cjs} +1 -1
- package/dist/protocolTreeDocumentStorageService.cjs.map +1 -0
- package/dist/{quorum.js → quorum.cjs} +1 -1
- package/dist/quorum.cjs.map +1 -0
- package/dist/{retriableDocumentStorageService.js → retriableDocumentStorageService.cjs} +1 -1
- package/dist/retriableDocumentStorageService.cjs.map +1 -0
- package/dist/tsdoc-metadata.json +1 -1
- package/dist/{utils.js → utils.cjs} +2 -1
- package/dist/utils.cjs.map +1 -0
- package/dist/utils.d.ts +2 -0
- package/dist/utils.d.ts.map +1 -1
- package/lib/audience.d.ts +1 -4
- package/lib/audience.d.ts.map +1 -1
- package/lib/{audience.js → audience.mjs} +1 -5
- package/lib/audience.mjs.map +1 -0
- package/lib/catchUpMonitor.d.ts.map +1 -1
- package/lib/{catchUpMonitor.js → catchUpMonitor.mjs} +1 -1
- package/lib/catchUpMonitor.mjs.map +1 -0
- package/lib/connectionManager.d.ts +1 -1
- package/lib/connectionManager.d.ts.map +1 -1
- package/lib/{connectionManager.js → connectionManager.mjs} +23 -20
- package/lib/connectionManager.mjs.map +1 -0
- package/lib/connectionState.d.ts +3 -0
- package/lib/connectionState.d.ts.map +1 -1
- package/lib/{connectionState.js → connectionState.mjs} +4 -1
- package/lib/connectionState.mjs.map +1 -0
- package/lib/connectionStateHandler.d.ts +13 -3
- package/lib/connectionStateHandler.d.ts.map +1 -1
- package/lib/{connectionStateHandler.js → connectionStateHandler.mjs} +6 -6
- package/lib/connectionStateHandler.mjs.map +1 -0
- package/lib/container-loader-alpha.d.ts +240 -0
- package/lib/container-loader-beta.d.ts +96 -0
- package/lib/container-loader-public.d.ts +96 -0
- package/lib/container-loader-untrimmed.d.ts +351 -0
- package/lib/container.d.ts +8 -10
- package/lib/container.d.ts.map +1 -1
- package/lib/{container.js → container.mjs} +36 -26
- package/lib/container.mjs.map +1 -0
- package/lib/containerContext.d.ts.map +1 -1
- package/lib/{containerContext.js → containerContext.mjs} +1 -1
- package/lib/containerContext.mjs.map +1 -0
- package/lib/containerStorageAdapter.d.ts +1 -1
- package/lib/containerStorageAdapter.d.ts.map +1 -1
- package/lib/{containerStorageAdapter.js → containerStorageAdapter.mjs} +6 -6
- package/lib/containerStorageAdapter.mjs.map +1 -0
- package/lib/contracts.d.ts.map +1 -1
- package/lib/{contracts.js → contracts.mjs} +1 -1
- package/lib/contracts.mjs.map +1 -0
- package/lib/debugLogger.d.ts.map +1 -1
- package/lib/{debugLogger.js → debugLogger.mjs} +3 -2
- package/lib/debugLogger.mjs.map +1 -0
- package/lib/deltaManager.d.ts +1 -1
- package/lib/deltaManager.d.ts.map +1 -1
- package/lib/{deltaManager.js → deltaManager.mjs} +21 -4
- package/lib/deltaManager.mjs.map +1 -0
- package/lib/deltaQueue.d.ts.map +1 -1
- package/lib/{deltaQueue.js → deltaQueue.mjs} +1 -1
- package/lib/deltaQueue.mjs.map +1 -0
- package/lib/disposal.d.ts.map +1 -1
- package/lib/{disposal.js → disposal.mjs} +1 -1
- package/lib/disposal.mjs.map +1 -0
- package/lib/error.d.ts.map +1 -1
- package/lib/{error.js → error.mjs} +1 -1
- package/lib/error.mjs.map +1 -0
- package/lib/index.d.ts +6 -6
- package/lib/index.d.ts.map +1 -1
- package/lib/index.mjs +10 -0
- package/lib/index.mjs.map +1 -0
- package/lib/loader.d.ts +14 -4
- package/lib/loader.d.ts.map +1 -1
- package/lib/{loader.js → loader.mjs} +7 -5
- package/lib/loader.mjs.map +1 -0
- package/lib/location-redirection-utilities/index.d.ts +1 -1
- package/lib/location-redirection-utilities/index.d.ts.map +1 -1
- package/lib/location-redirection-utilities/{index.js → index.mjs} +2 -2
- package/lib/location-redirection-utilities/index.mjs.map +1 -0
- package/lib/location-redirection-utilities/resolveWithLocationRedirection.d.ts +2 -0
- package/lib/location-redirection-utilities/resolveWithLocationRedirection.d.ts.map +1 -1
- package/lib/location-redirection-utilities/{resolveWithLocationRedirection.js → resolveWithLocationRedirection.mjs} +3 -1
- package/lib/location-redirection-utilities/resolveWithLocationRedirection.mjs.map +1 -0
- package/lib/noopHeuristic.d.ts.map +1 -1
- package/lib/{noopHeuristic.js → noopHeuristic.mjs} +1 -1
- package/lib/noopHeuristic.mjs.map +1 -0
- package/lib/packageVersion.d.ts +1 -1
- package/lib/{packageVersion.js → packageVersion.mjs} +2 -2
- package/lib/packageVersion.mjs.map +1 -0
- package/lib/protocol.d.ts +4 -0
- package/lib/protocol.d.ts.map +1 -1
- package/lib/{protocol.js → protocol.mjs} +1 -1
- package/lib/protocol.mjs.map +1 -0
- package/lib/protocolTreeDocumentStorageService.d.ts.map +1 -1
- package/lib/{protocolTreeDocumentStorageService.js → protocolTreeDocumentStorageService.mjs} +1 -1
- package/lib/protocolTreeDocumentStorageService.mjs.map +1 -0
- package/lib/quorum.d.ts +0 -4
- package/lib/quorum.d.ts.map +1 -1
- package/lib/{quorum.js → quorum.mjs} +1 -1
- package/lib/quorum.mjs.map +1 -0
- package/lib/retriableDocumentStorageService.d.ts.map +1 -1
- package/lib/{retriableDocumentStorageService.js → retriableDocumentStorageService.mjs} +1 -1
- package/lib/retriableDocumentStorageService.mjs.map +1 -0
- package/lib/utils.d.ts +2 -0
- package/lib/utils.d.ts.map +1 -1
- package/lib/{utils.js → utils.mjs} +2 -1
- package/lib/utils.mjs.map +1 -0
- package/package.json +48 -29
- package/src/connectionManager.ts +22 -14
- package/src/connectionState.ts +3 -0
- package/src/connectionStateHandler.ts +16 -3
- package/src/container.ts +34 -17
- package/src/containerStorageAdapter.ts +3 -3
- package/src/debugLogger.ts +7 -1
- package/src/deltaManager.ts +25 -1
- package/src/loader.ts +11 -1
- package/src/location-redirection-utilities/resolveWithLocationRedirection.ts +2 -0
- package/src/packageVersion.ts +1 -1
- package/src/protocol.ts +4 -0
- package/src/utils.ts +2 -0
- package/tsc-multi.test.json +4 -0
- package/tsconfig.json +5 -3
- package/dist/audience.js.map +0 -1
- package/dist/catchUpMonitor.js.map +0 -1
- package/dist/connectionManager.js.map +0 -1
- package/dist/connectionState.js.map +0 -1
- package/dist/connectionStateHandler.js.map +0 -1
- package/dist/container.js.map +0 -1
- package/dist/containerContext.js.map +0 -1
- package/dist/containerStorageAdapter.js.map +0 -1
- package/dist/contracts.js.map +0 -1
- package/dist/debugLogger.js.map +0 -1
- package/dist/deltaManager.js.map +0 -1
- package/dist/deltaQueue.js.map +0 -1
- package/dist/disposal.js.map +0 -1
- package/dist/error.js.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/loader.js.map +0 -1
- package/dist/location-redirection-utilities/index.js.map +0 -1
- package/dist/location-redirection-utilities/resolveWithLocationRedirection.js.map +0 -1
- package/dist/noopHeuristic.js.map +0 -1
- package/dist/packageVersion.js.map +0 -1
- package/dist/protocol.js.map +0 -1
- package/dist/protocolTreeDocumentStorageService.js.map +0 -1
- package/dist/quorum.js.map +0 -1
- package/dist/retriableDocumentStorageService.js.map +0 -1
- package/dist/utils.js.map +0 -1
- package/lib/audience.js.map +0 -1
- package/lib/catchUpMonitor.js.map +0 -1
- package/lib/connectionManager.js.map +0 -1
- package/lib/connectionState.js.map +0 -1
- package/lib/connectionStateHandler.js.map +0 -1
- package/lib/container.js.map +0 -1
- package/lib/containerContext.js.map +0 -1
- package/lib/containerStorageAdapter.js.map +0 -1
- package/lib/contracts.js.map +0 -1
- package/lib/debugLogger.js.map +0 -1
- package/lib/deltaManager.js.map +0 -1
- package/lib/deltaQueue.js.map +0 -1
- package/lib/disposal.js.map +0 -1
- package/lib/error.js.map +0 -1
- package/lib/index.js +0 -10
- package/lib/index.js.map +0 -1
- package/lib/loader.js.map +0 -1
- package/lib/location-redirection-utilities/index.js.map +0 -1
- package/lib/location-redirection-utilities/resolveWithLocationRedirection.js.map +0 -1
- package/lib/noopHeuristic.js.map +0 -1
- package/lib/packageVersion.js.map +0 -1
- package/lib/protocol.js.map +0 -1
- package/lib/protocolTreeDocumentStorageService.js.map +0 -1
- package/lib/quorum.js.map +0 -1
- package/lib/retriableDocumentStorageService.js.map +0 -1
- package/lib/utils.js.map +0 -1
- package/tsconfig.esnext.json +0 -7
package/src/container.ts
CHANGED
|
@@ -3,9 +3,6 @@
|
|
|
3
3
|
* Licensed under the MIT License.
|
|
4
4
|
*/
|
|
5
5
|
|
|
6
|
-
// eslint-disable-next-line import/no-internal-modules
|
|
7
|
-
import merge from "lodash/merge";
|
|
8
|
-
|
|
9
6
|
import { v4 as uuid } from "uuid";
|
|
10
7
|
import { assert, unreachableCase } from "@fluidframework/core-utils";
|
|
11
8
|
import { TypedEventEmitter, performance } from "@fluid-internal/client-utils";
|
|
@@ -240,6 +237,7 @@ export interface IContainerCreateProps {
|
|
|
240
237
|
* but it maybe still behind.
|
|
241
238
|
*
|
|
242
239
|
* @throws an error beginning with `"Container closed"` if the container is closed before it catches up.
|
|
240
|
+
* @internal
|
|
243
241
|
*/
|
|
244
242
|
export async function waitContainerToCatchUp(container: IContainer) {
|
|
245
243
|
// Make sure we stop waiting if container is closed.
|
|
@@ -500,6 +498,7 @@ export class Container
|
|
|
500
498
|
private readonly subLogger: ITelemetryLoggerExt;
|
|
501
499
|
private readonly detachedBlobStorage: IDetachedBlobStorage | undefined;
|
|
502
500
|
private readonly protocolHandlerBuilder: ProtocolHandlerBuilder;
|
|
501
|
+
private readonly client: IClient;
|
|
503
502
|
|
|
504
503
|
private readonly mc: MonitoringContext;
|
|
505
504
|
|
|
@@ -817,6 +816,14 @@ export class Container
|
|
|
817
816
|
});
|
|
818
817
|
};
|
|
819
818
|
|
|
819
|
+
this._containerId = uuid();
|
|
820
|
+
|
|
821
|
+
this.client = Container.setupClient(
|
|
822
|
+
this._containerId,
|
|
823
|
+
this.options,
|
|
824
|
+
this.clientDetailsOverride,
|
|
825
|
+
);
|
|
826
|
+
|
|
820
827
|
// Create logger for data stores to use
|
|
821
828
|
const type = this.client.details.type;
|
|
822
829
|
const interactive = this.client.details.capabilities.interactive;
|
|
@@ -824,7 +831,6 @@ export class Container
|
|
|
824
831
|
type !== undefined && type !== "" ? `/${type}` : ""
|
|
825
832
|
}`;
|
|
826
833
|
|
|
827
|
-
this._containerId = uuid();
|
|
828
834
|
// Need to use the property getter for docId because for detached flow we don't have the docId initially.
|
|
829
835
|
// We assign the id later so property getter is used.
|
|
830
836
|
this.subLogger = createChildLogger({
|
|
@@ -1119,7 +1125,6 @@ export class Container
|
|
|
1119
1125
|
// runtime matches pending ops to successful ones by clientId and client seq num, so we need to close the
|
|
1120
1126
|
// container at the same time we get pending state, otherwise this container could reconnect and resubmit with
|
|
1121
1127
|
// a new clientId and a future container using stale pending state without the new clientId would resubmit them
|
|
1122
|
-
this.disconnectInternal({ text: "closeAndGetPendingLocalState" }); // TODO https://dev.azure.com/fluidframework/internal/_workitems/edit/5127
|
|
1123
1128
|
const pendingState = await this.getPendingLocalStateCore({
|
|
1124
1129
|
notifyImminentClosure: true,
|
|
1125
1130
|
stopBlobAttachingSignal,
|
|
@@ -1718,7 +1723,10 @@ export class Container
|
|
|
1718
1723
|
// replay saved ops
|
|
1719
1724
|
if (pendingLocalState) {
|
|
1720
1725
|
for (const message of pendingLocalState.savedOps) {
|
|
1721
|
-
this.processRemoteMessage(
|
|
1726
|
+
this.processRemoteMessage({
|
|
1727
|
+
...message,
|
|
1728
|
+
metadata: { ...(message.metadata as Record<string, unknown>), savedOp: true },
|
|
1729
|
+
});
|
|
1722
1730
|
|
|
1723
1731
|
// allow runtime to apply stashed ops at this op's sequence number
|
|
1724
1732
|
await this.runtime.notifyOpReplay?.(message);
|
|
@@ -1996,10 +2004,15 @@ export class Container
|
|
|
1996
2004
|
return pkg as IFluidCodeDetails;
|
|
1997
2005
|
}
|
|
1998
2006
|
|
|
1999
|
-
private
|
|
2007
|
+
private static setupClient(
|
|
2008
|
+
containerId: string,
|
|
2009
|
+
options?: ILoaderOptions,
|
|
2010
|
+
clientDetailsOverride?: IClientDetails,
|
|
2011
|
+
): IClient {
|
|
2012
|
+
const loaderOptionsClient = structuredClone(options?.client);
|
|
2000
2013
|
const client: IClient =
|
|
2001
|
-
|
|
2002
|
-
? (
|
|
2014
|
+
loaderOptionsClient !== undefined
|
|
2015
|
+
? (loaderOptionsClient as IClient)
|
|
2003
2016
|
: {
|
|
2004
2017
|
details: {
|
|
2005
2018
|
capabilities: { interactive: true },
|
|
@@ -2010,14 +2023,22 @@ export class Container
|
|
|
2010
2023
|
user: { id: "" },
|
|
2011
2024
|
};
|
|
2012
2025
|
|
|
2013
|
-
if (
|
|
2014
|
-
|
|
2026
|
+
if (clientDetailsOverride !== undefined) {
|
|
2027
|
+
client.details = {
|
|
2028
|
+
...client.details,
|
|
2029
|
+
...clientDetailsOverride,
|
|
2030
|
+
capabilities: {
|
|
2031
|
+
...client.details.capabilities,
|
|
2032
|
+
...clientDetailsOverride?.capabilities,
|
|
2033
|
+
},
|
|
2034
|
+
};
|
|
2015
2035
|
}
|
|
2016
2036
|
client.details.environment = [
|
|
2017
2037
|
client.details.environment,
|
|
2018
2038
|
` loaderVersion:${pkgVersion}`,
|
|
2019
|
-
` containerId:${
|
|
2039
|
+
` containerId:${containerId}`,
|
|
2020
2040
|
].join(";");
|
|
2041
|
+
|
|
2021
2042
|
return client;
|
|
2022
2043
|
}
|
|
2023
2044
|
|
|
@@ -2523,7 +2544,7 @@ export class Container
|
|
|
2523
2544
|
|
|
2524
2545
|
/**
|
|
2525
2546
|
* IContainer interface that includes experimental features still under development.
|
|
2526
|
-
* @
|
|
2547
|
+
* @internal
|
|
2527
2548
|
*/
|
|
2528
2549
|
export interface IContainerExperimental extends IContainer {
|
|
2529
2550
|
/**
|
|
@@ -2531,16 +2552,12 @@ export interface IContainerExperimental extends IContainer {
|
|
|
2531
2552
|
* submission and potential document corruption. The blob returned MUST be deleted if and when this
|
|
2532
2553
|
* container emits a "connected" event.
|
|
2533
2554
|
* @returns serialized blob that can be passed to Loader.resolve()
|
|
2534
|
-
* @alpha misuse of this API can result in duplicate op submission and potential document corruption
|
|
2535
|
-
* {@link https://github.com/microsoft/FluidFramework/blob/main/packages/loader/container-loader/closeAndGetPendingLocalState.md}
|
|
2536
2555
|
*/
|
|
2537
2556
|
getPendingLocalState?(): Promise<string>;
|
|
2538
2557
|
|
|
2539
2558
|
/**
|
|
2540
2559
|
* Closes the container and returns serialized local state intended to be
|
|
2541
2560
|
* given to a newly loaded container.
|
|
2542
|
-
* @alpha
|
|
2543
|
-
* {@link https://github.com/microsoft/FluidFramework/blob/main/packages/loader/container-loader/closeAndGetPendingLocalState.md}
|
|
2544
2561
|
*/
|
|
2545
2562
|
closeAndGetPendingLocalState?(stopBlobAttachingSignal?: AbortSignal): Promise<string>;
|
|
2546
2563
|
}
|
|
@@ -106,7 +106,7 @@ export class ContainerStorageAdapter implements IDocumentStorageService, IDispos
|
|
|
106
106
|
}
|
|
107
107
|
|
|
108
108
|
private getBlobContents(snapshotTree: ISnapshotTreeWithBlobContents) {
|
|
109
|
-
for (const [id, value] of Object.entries(snapshotTree.blobsContents)) {
|
|
109
|
+
for (const [id, value] of Object.entries(snapshotTree.blobsContents ?? {})) {
|
|
110
110
|
this.blobContents[id] = value;
|
|
111
111
|
}
|
|
112
112
|
for (const [_, tree] of Object.entries(snapshotTree.trees)) {
|
|
@@ -302,7 +302,7 @@ function getBlobContentsFromTreeWithBlobContentsCore(
|
|
|
302
302
|
}
|
|
303
303
|
}
|
|
304
304
|
for (const id of Object.values(tree.blobs)) {
|
|
305
|
-
const blob = tree.blobsContents[id];
|
|
305
|
+
const blob = tree.blobsContents?.[id];
|
|
306
306
|
assert(blob !== undefined, 0x2ec /* "Blob must be present in blobsContents" */);
|
|
307
307
|
// ArrayBufferLike will not survive JSON.stringify()
|
|
308
308
|
blobs[id] = bufferToString(blob, "utf8");
|
|
@@ -315,7 +315,7 @@ function getBlobManagerTreeFromTreeWithBlobContents(
|
|
|
315
315
|
blobs: ISerializableBlobContents,
|
|
316
316
|
) {
|
|
317
317
|
const id = tree.blobs[redirectTableBlobName];
|
|
318
|
-
const blob = tree.blobsContents[id];
|
|
318
|
+
const blob = tree.blobsContents?.[id];
|
|
319
319
|
assert(blob !== undefined, 0x70f /* Blob must be present in blobsContents */);
|
|
320
320
|
// ArrayBufferLike will not survive JSON.stringify()
|
|
321
321
|
blobs[id] = bufferToString(blob, "utf8");
|
package/src/debugLogger.ts
CHANGED
|
@@ -9,7 +9,7 @@ import {
|
|
|
9
9
|
ITelemetryProperties,
|
|
10
10
|
} from "@fluidframework/core-interfaces";
|
|
11
11
|
import { performance } from "@fluid-internal/client-utils";
|
|
12
|
-
|
|
12
|
+
|
|
13
13
|
import {
|
|
14
14
|
ITelemetryLoggerExt,
|
|
15
15
|
ITelemetryLoggerPropertyBags,
|
|
@@ -18,6 +18,12 @@ import {
|
|
|
18
18
|
formatTick,
|
|
19
19
|
} from "@fluidframework/telemetry-utils";
|
|
20
20
|
|
|
21
|
+
// This import style is necessary to ensure the emitted JS code works in both CJS and ESM.
|
|
22
|
+
import debugPkg from "debug";
|
|
23
|
+
const { debug: registerDebug } = debugPkg;
|
|
24
|
+
|
|
25
|
+
import type { IDebugger } from "debug";
|
|
26
|
+
|
|
21
27
|
/**
|
|
22
28
|
* Implementation of debug logger
|
|
23
29
|
*/
|
package/src/deltaManager.ts
CHANGED
|
@@ -9,6 +9,7 @@ import {
|
|
|
9
9
|
IEventProvider,
|
|
10
10
|
ITelemetryProperties,
|
|
11
11
|
ITelemetryErrorEvent,
|
|
12
|
+
type ITelemetryBaseEvent,
|
|
12
13
|
} from "@fluidframework/core-interfaces";
|
|
13
14
|
import {
|
|
14
15
|
ICriticalContainerError,
|
|
@@ -22,12 +23,12 @@ import {
|
|
|
22
23
|
DataProcessingError,
|
|
23
24
|
extractSafePropertiesFromMessage,
|
|
24
25
|
normalizeError,
|
|
25
|
-
logIfFalse,
|
|
26
26
|
safeRaiseEvent,
|
|
27
27
|
isFluidError,
|
|
28
28
|
ITelemetryLoggerExt,
|
|
29
29
|
DataCorruptionError,
|
|
30
30
|
UsageError,
|
|
31
|
+
type ITelemetryGenericEventExt,
|
|
31
32
|
} from "@fluidframework/telemetry-utils";
|
|
32
33
|
import {
|
|
33
34
|
IDocumentDeltaStorageService,
|
|
@@ -114,6 +115,29 @@ function isClientMessage(message: ISequencedDocumentMessage | IDocumentMessage):
|
|
|
114
115
|
}
|
|
115
116
|
}
|
|
116
117
|
|
|
118
|
+
/**
|
|
119
|
+
* Like assert, but logs only if the condition is false, rather than throwing
|
|
120
|
+
* @param condition - The condition to attest too
|
|
121
|
+
* @param logger - The logger to log with
|
|
122
|
+
* @param event - The string or event to log
|
|
123
|
+
* @returns The outcome of the condition
|
|
124
|
+
*/
|
|
125
|
+
function logIfFalse(
|
|
126
|
+
condition: boolean,
|
|
127
|
+
logger: ITelemetryLoggerExt,
|
|
128
|
+
event: string | ITelemetryGenericEventExt,
|
|
129
|
+
): condition is true {
|
|
130
|
+
if (condition) {
|
|
131
|
+
return true;
|
|
132
|
+
}
|
|
133
|
+
const newEvent: ITelemetryBaseEvent =
|
|
134
|
+
typeof event === "string"
|
|
135
|
+
? { eventName: event, category: "error" }
|
|
136
|
+
: { category: "error", ...event };
|
|
137
|
+
logger.send(newEvent);
|
|
138
|
+
return false;
|
|
139
|
+
}
|
|
140
|
+
|
|
117
141
|
/**
|
|
118
142
|
* Manages the flow of both inbound and outbound messages. This class ensures that shared objects receive delta
|
|
119
143
|
* messages in order regardless of possible network conditions or timings causing out of order delivery.
|
package/src/loader.ts
CHANGED
|
@@ -6,7 +6,6 @@
|
|
|
6
6
|
import { v4 as uuid } from "uuid";
|
|
7
7
|
import {
|
|
8
8
|
ITelemetryLoggerExt,
|
|
9
|
-
IConfigProviderBase,
|
|
10
9
|
mixinMonitoringContext,
|
|
11
10
|
MonitoringContext,
|
|
12
11
|
PerformanceEvent,
|
|
@@ -22,6 +21,7 @@ import {
|
|
|
22
21
|
IRequest,
|
|
23
22
|
IRequestHeader,
|
|
24
23
|
IResponse,
|
|
24
|
+
IConfigProviderBase,
|
|
25
25
|
} from "@fluidframework/core-interfaces";
|
|
26
26
|
import {
|
|
27
27
|
IContainer,
|
|
@@ -113,6 +113,9 @@ export class RelativeLoader implements ILoader {
|
|
|
113
113
|
}
|
|
114
114
|
}
|
|
115
115
|
|
|
116
|
+
/**
|
|
117
|
+
* @alpha
|
|
118
|
+
*/
|
|
116
119
|
export interface ILoaderOptions extends ILoaderOptions1 {
|
|
117
120
|
summarizeProtocolTree?: boolean;
|
|
118
121
|
}
|
|
@@ -122,6 +125,7 @@ export interface ILoaderOptions extends ILoaderOptions1 {
|
|
|
122
125
|
* {@link @fluidframework/container-definitions#IFluidModuleWithDetails}
|
|
123
126
|
* to have all the code loading modules in one package. #8193
|
|
124
127
|
* Encapsulates a module entry point with corresponding code details.
|
|
128
|
+
* @alpha
|
|
125
129
|
*/
|
|
126
130
|
export interface IFluidModuleWithDetails {
|
|
127
131
|
/** Fluid code module that implements the runtime factory needed to instantiate the container runtime. */
|
|
@@ -139,6 +143,7 @@ export interface IFluidModuleWithDetails {
|
|
|
139
143
|
* to have code loading modules in one package. #8193
|
|
140
144
|
* Fluid code loader resolves a code module matching the document schema, i.e. code details, such as
|
|
141
145
|
* a package name and package version range.
|
|
146
|
+
* @alpha
|
|
142
147
|
*/
|
|
143
148
|
export interface ICodeDetailsLoader extends Partial<IProvideFluidCodeDetailsComparer> {
|
|
144
149
|
/**
|
|
@@ -152,6 +157,7 @@ export interface ICodeDetailsLoader extends Partial<IProvideFluidCodeDetailsComp
|
|
|
152
157
|
|
|
153
158
|
/**
|
|
154
159
|
* Services and properties necessary for creating a loader
|
|
160
|
+
* @alpha
|
|
155
161
|
*/
|
|
156
162
|
export interface ILoaderProps {
|
|
157
163
|
/**
|
|
@@ -208,6 +214,7 @@ export interface ILoaderProps {
|
|
|
208
214
|
|
|
209
215
|
/**
|
|
210
216
|
* Services and properties used by and exposed by the loader
|
|
217
|
+
* @alpha
|
|
211
218
|
*/
|
|
212
219
|
export interface ILoaderServices {
|
|
213
220
|
/**
|
|
@@ -260,6 +267,7 @@ export interface ILoaderServices {
|
|
|
260
267
|
/**
|
|
261
268
|
* Subset of IDocumentStorageService which only supports createBlob() and readBlob(). This is used to support
|
|
262
269
|
* blobs in detached containers.
|
|
270
|
+
* @alpha
|
|
263
271
|
*/
|
|
264
272
|
export type IDetachedBlobStorage = Pick<IDocumentStorageService, "createBlob" | "readBlob"> & {
|
|
265
273
|
size: number;
|
|
@@ -274,6 +282,7 @@ export type IDetachedBlobStorage = Pick<IDocumentStorageService, "createBlob" |
|
|
|
274
282
|
* @param container - a resolved container
|
|
275
283
|
* @returns component on the container
|
|
276
284
|
* @deprecated Will be removed in future major release. Migrate all usage of IFluidRouter to the "entryPoint" pattern. Refer to Removing-IFluidRouter.md
|
|
285
|
+
* @internal
|
|
277
286
|
*/
|
|
278
287
|
export async function requestResolvedObjectFromContainer(
|
|
279
288
|
container: IContainer,
|
|
@@ -298,6 +307,7 @@ export async function requestResolvedObjectFromContainer(
|
|
|
298
307
|
|
|
299
308
|
/**
|
|
300
309
|
* Manages Fluid resource loading
|
|
310
|
+
* @alpha
|
|
301
311
|
*/
|
|
302
312
|
export class Loader implements IHostLoader {
|
|
303
313
|
public readonly services: ILoaderServices;
|
|
@@ -15,6 +15,7 @@ import { createChildLogger } from "@fluidframework/telemetry-utils";
|
|
|
15
15
|
* Checks if the error is location redirection error.
|
|
16
16
|
* @param error - error whose type is to be determined.
|
|
17
17
|
* @returns `true` is the error is location redirection error, otherwise `false`.
|
|
18
|
+
* @internal
|
|
18
19
|
*/
|
|
19
20
|
export function isLocationRedirectionError(error: any): error is ILocationRedirectionError {
|
|
20
21
|
return (
|
|
@@ -31,6 +32,7 @@ export function isLocationRedirectionError(error: any): error is ILocationRedire
|
|
|
31
32
|
* @param urlResolver - resolver used to resolve the url.
|
|
32
33
|
* @param logger - logger to send events.
|
|
33
34
|
* @returns Response from the API call.
|
|
35
|
+
* @internal
|
|
34
36
|
*/
|
|
35
37
|
export async function resolveWithLocationRedirectionHandling<T>(
|
|
36
38
|
api: (request: IRequest) => Promise<T>,
|
package/src/packageVersion.ts
CHANGED
package/src/protocol.ts
CHANGED
|
@@ -28,6 +28,7 @@ export enum SignalType {
|
|
|
28
28
|
|
|
29
29
|
/**
|
|
30
30
|
* Function to be used for creating a protocol handler.
|
|
31
|
+
* @alpha
|
|
31
32
|
*/
|
|
32
33
|
export type ProtocolHandlerBuilder = (
|
|
33
34
|
attributes: IDocumentAttributes,
|
|
@@ -35,6 +36,9 @@ export type ProtocolHandlerBuilder = (
|
|
|
35
36
|
sendProposal: (key: string, value: any) => number,
|
|
36
37
|
) => IProtocolHandler;
|
|
37
38
|
|
|
39
|
+
/**
|
|
40
|
+
* @alpha
|
|
41
|
+
*/
|
|
38
42
|
export interface IProtocolHandler extends IBaseProtocolHandler {
|
|
39
43
|
readonly audience: IAudienceOwner;
|
|
40
44
|
processSignal(message: ISignalMessage);
|
package/src/utils.ts
CHANGED
|
@@ -27,6 +27,7 @@ export interface ISnapshotTreeWithBlobContents extends ISnapshotTree {
|
|
|
27
27
|
* Interface to represent the parsed parts of IResolvedUrl.url to help
|
|
28
28
|
* in getting info about different parts of the url.
|
|
29
29
|
* May not be compatible or relevant for any Url Resolver
|
|
30
|
+
* @internal
|
|
30
31
|
*/
|
|
31
32
|
export interface IParsedUrl {
|
|
32
33
|
/**
|
|
@@ -56,6 +57,7 @@ export interface IParsedUrl {
|
|
|
56
57
|
* with urls of type: protocol://<string>/.../..?<querystring>
|
|
57
58
|
* @param url - This is the IResolvedUrl.url part of the resolved url.
|
|
58
59
|
* @returns The IParsedUrl representing the input URL, or undefined if the format was not supported
|
|
60
|
+
* @internal
|
|
59
61
|
*/
|
|
60
62
|
export function tryParseCompatibleResolvedUrl(url: string): IParsedUrl | undefined {
|
|
61
63
|
const parsed = parse(url, true);
|
package/tsconfig.json
CHANGED
|
@@ -1,10 +1,12 @@
|
|
|
1
1
|
{
|
|
2
|
-
"extends":
|
|
2
|
+
"extends": [
|
|
3
|
+
"../../../common/build/build-common/tsconfig.base.json",
|
|
4
|
+
"../../../common/build/build-common/tsconfig.cjs.json",
|
|
5
|
+
],
|
|
6
|
+
"include": ["src/**/*"],
|
|
3
7
|
"exclude": ["src/test/**/*"],
|
|
4
8
|
"compilerOptions": {
|
|
5
9
|
"rootDir": "./src",
|
|
6
10
|
"outDir": "./dist",
|
|
7
|
-
"composite": true,
|
|
8
11
|
},
|
|
9
|
-
"include": ["src/**/*"],
|
|
10
12
|
}
|
package/dist/audience.js.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"audience.js","sourceRoot":"","sources":["../src/audience.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,mCAAsC;AACtC,2DAAoD;AAIpD;;GAEG;AACH,MAAa,QAAS,SAAQ,qBAAY;IAGzC;QACC,KAAK,EAAE,CAAC;QAHQ,YAAO,GAAG,IAAI,GAAG,EAAmB,CAAC;QAIrD,kHAAkH;QAClH,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC;IAMM,EAAE,CAAC,KAAa,EAAE,QAAkC;QAC1D,OAAO,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACI,SAAS,CAAC,QAAgB,EAAE,OAAgB;QAClD,mGAAmG;QACnG,+FAA+F;QAC/F,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE;YAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC1C,IAAA,mBAAM,EACL,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAClD,KAAK,CAAC,wDAAwD,CAC9D,CAAC;SACF;aAAM;YACN,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACpC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;SAC1C;IACF,CAAC;IAED;;;OAGG;IACI,YAAY,CAAC,QAAgB;QACnC,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACjD,IAAI,aAAa,KAAK,SAAS,EAAE;YAChC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC9B,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;YACnD,OAAO,IAAI,CAAC;SACZ;aAAM;YACN,OAAO,KAAK,CAAC;SACb;IACF,CAAC;IAED;;OAEG;IACI,UAAU;QAChB,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACI,SAAS,CAAC,QAAgB;QAChC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;CACD;AA/DD,4BA+DC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\nimport { EventEmitter } from \"events\";\nimport { assert } from \"@fluidframework/core-utils\";\nimport { IAudienceOwner } from \"@fluidframework/container-definitions\";\nimport { IClient } from \"@fluidframework/protocol-definitions\";\n\n/**\n * Audience represents all clients connected to the op stream.\n */\nexport class Audience extends EventEmitter implements IAudienceOwner {\n\tprivate readonly members = new Map<string, IClient>();\n\n\tconstructor() {\n\t\tsuper();\n\t\t// We are expecting this class to have many listeners, so we suppress noisy \"MaxListenersExceededWarning\" logging.\n\t\tsuper.setMaxListeners(0);\n\t}\n\n\tpublic on(\n\t\tevent: \"addMember\" | \"removeMember\",\n\t\tlistener: (clientId: string, client: IClient) => void,\n\t): this;\n\tpublic on(event: string, listener: (...args: any[]) => void): this {\n\t\treturn super.on(event, listener);\n\t}\n\n\t/**\n\t * Adds a new client to the audience\n\t */\n\tpublic addMember(clientId: string, details: IClient) {\n\t\t// Given that signal delivery is unreliable process, we might observe same client being added twice\n\t\t// In such case we should see exactly same payload (IClient), and should not raise event twice!\n\t\tif (this.members.has(clientId)) {\n\t\t\tconst client = this.members.get(clientId);\n\t\t\tassert(\n\t\t\t\tJSON.stringify(client) === JSON.stringify(details),\n\t\t\t\t0x4b2 /* new client has different payload from existing one */,\n\t\t\t);\n\t\t} else {\n\t\t\tthis.members.set(clientId, details);\n\t\t\tthis.emit(\"addMember\", clientId, details);\n\t\t}\n\t}\n\n\t/**\n\t * Removes a client from the audience. Only emits an event if a client is actually removed\n\t * @returns if a client was removed from the audience\n\t */\n\tpublic removeMember(clientId: string): boolean {\n\t\tconst removedClient = this.members.get(clientId);\n\t\tif (removedClient !== undefined) {\n\t\t\tthis.members.delete(clientId);\n\t\t\tthis.emit(\"removeMember\", clientId, removedClient);\n\t\t\treturn true;\n\t\t} else {\n\t\t\treturn false;\n\t\t}\n\t}\n\n\t/**\n\t * Retrieves all the members in the audience\n\t */\n\tpublic getMembers(): Map<string, IClient> {\n\t\treturn new Map(this.members);\n\t}\n\n\t/**\n\t * Retrieves a specific member of the audience\n\t */\n\tpublic getMember(clientId: string): IClient | undefined {\n\t\treturn this.members.get(clientId);\n\t}\n}\n"]}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"catchUpMonitor.js","sourceRoot":"","sources":["../src/catchUpMonitor.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAGH,2DAAoD;AAUpD;;;GAGG;AACH,MAAa,cAAc;IAW1B;;OAEG;IACH,YACkB,YAAqC,EACrC,QAA0B;QAD1B,iBAAY,GAAZ,YAAY,CAAyB;QACrC,aAAQ,GAAR,QAAQ,CAAkB;QAdpC,aAAQ,GAAY,KAAK,CAAC;QAEjB,cAAS,GAAG,CAAC,OAA0D,EAAE,EAAE;YAC3F,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,cAAc,IAAI,IAAI,CAAC,eAAe,EAAE;gBACrE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;gBACrB,IAAI,CAAC,QAAQ,EAAE,CAAC;aAChB;QACF,CAAC,CAAC;QAsBK,aAAQ,GAAY,KAAK,CAAC;QAbhC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,YAAY,CAAC,kBAAkB,CAAC;QAE5D,IAAA,mBAAM,EACL,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,YAAY,CAAC,kBAAkB,EAC5D,KAAK,CAAC,oEAAoE,CAC1E,CAAC;QAEF,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAE3C,wEAAwE;QACxE,IAAI,CAAC,SAAS,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,YAAY,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAC1E,CAAC;IAGM,OAAO;QACb,IAAI,IAAI,CAAC,QAAQ,EAAE;YAClB,OAAO;SACP;QACD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QAErB,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7C,CAAC;CACD;AAxCD,wCAwCC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { IDisposable } from \"@fluidframework/core-interfaces\";\nimport { assert } from \"@fluidframework/core-utils\";\nimport { IDeltaManager } from \"@fluidframework/container-definitions\";\nimport { ISequencedDocumentMessage } from \"@fluidframework/protocol-definitions\";\n\n/** @see CatchUpMonitor for usage */\ntype CaughtUpListener = () => void;\n\n/** Monitor that emits an event when a Container has caught up to a given point in the op stream */\nexport type ICatchUpMonitor = IDisposable;\n\n/**\n * Monitors a Container's DeltaManager, notifying listeners when all ops have been processed\n * that were known at the time the monitor was created.\n */\nexport class CatchUpMonitor implements ICatchUpMonitor {\n\tprivate readonly targetSeqNumber: number;\n\tprivate caughtUp: boolean = false;\n\n\tprivate readonly opHandler = (message: Pick<ISequencedDocumentMessage, \"sequenceNumber\">) => {\n\t\tif (!this.caughtUp && message.sequenceNumber >= this.targetSeqNumber) {\n\t\t\tthis.caughtUp = true;\n\t\t\tthis.listener();\n\t\t}\n\t};\n\n\t/**\n\t * Create the CatchUpMonitor, setting the target sequence number to wait for based on DeltaManager's current state.\n\t */\n\tconstructor(\n\t\tprivate readonly deltaManager: IDeltaManager<any, any>,\n\t\tprivate readonly listener: CaughtUpListener,\n\t) {\n\t\tthis.targetSeqNumber = this.deltaManager.lastKnownSeqNumber;\n\n\t\tassert(\n\t\t\tthis.targetSeqNumber >= this.deltaManager.lastSequenceNumber,\n\t\t\t0x37c /* Cannot wait for seqNumber below last processed sequence number */,\n\t\t);\n\n\t\tthis.deltaManager.on(\"op\", this.opHandler);\n\n\t\t// Simulate the last processed op to set caughtUp in case we already are\n\t\tthis.opHandler({ sequenceNumber: this.deltaManager.lastSequenceNumber });\n\t}\n\n\tpublic disposed: boolean = false;\n\tpublic dispose() {\n\t\tif (this.disposed) {\n\t\t\treturn;\n\t\t}\n\t\tthis.disposed = true;\n\n\t\tthis.deltaManager.off(\"op\", this.opHandler);\n\t}\n}\n"]}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"connectionManager.js","sourceRoot":"","sources":["../src/connectionManager.ts"],"names":[],"mappings":"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","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { IDisposable, ITelemetryProperties, LogLevel } from \"@fluidframework/core-interfaces\";\nimport { assert } from \"@fluidframework/core-utils\";\nimport { performance, TypedEventEmitter } from \"@fluid-internal/client-utils\";\nimport {\n\tICriticalContainerError,\n\tIDeltaQueue,\n\tReadOnlyInfo,\n} from \"@fluidframework/container-definitions\";\nimport {\n\tIAnyDriverError,\n\tIDocumentService,\n\tIDocumentDeltaConnection,\n\tIDocumentDeltaConnectionEvents,\n\t// eslint-disable-next-line import/no-deprecated\n\tDriverErrorType,\n} from \"@fluidframework/driver-definitions\";\nimport {\n\tcanRetryOnError,\n\tcreateWriteError,\n\tcreateGenericNetworkError,\n\tgetRetryDelayFromError,\n\tlogNetworkFailure,\n\tisRuntimeMessage,\n\tcalculateMaxWaitTime,\n} from \"@fluidframework/driver-utils\";\nimport {\n\tConnectionMode,\n\tIClient,\n\tIClientConfiguration,\n\tIClientDetails,\n\tIDocumentMessage,\n\tINack,\n\tINackContent,\n\tISequencedDocumentMessage,\n\tISignalClient,\n\tISignalMessage,\n\tITokenClaims,\n\tMessageType,\n\tScopeType,\n\tISequencedDocumentSystemMessage,\n} from \"@fluidframework/protocol-definitions\";\nimport {\n\tformatTick,\n\tGenericError,\n\tisFluidError,\n\tITelemetryLoggerExt,\n\tnormalizeError,\n\tUsageError,\n} from \"@fluidframework/telemetry-utils\";\nimport {\n\tReconnectMode,\n\tIConnectionManager,\n\tIConnectionManagerFactoryArgs,\n\tIConnectionDetailsInternal,\n\tIConnectionStateChangeReason,\n} from \"./contracts\";\nimport { DeltaQueue } from \"./deltaQueue\";\nimport { SignalType } from \"./protocol\";\nimport { isDeltaStreamConnectionForbiddenError } from \"./utils\";\n\nconst InitialReconnectDelayInMs = 1000;\nconst DefaultChunkSize = 16 * 1024;\n\nconst fatalConnectErrorProp = { fatalConnectError: true };\n\nfunction getNackReconnectInfo(nackContent: INackContent) {\n\tconst message = `Nack (${nackContent.type}): ${nackContent.message}`;\n\tconst canRetry = nackContent.code !== 403;\n\tconst retryAfterMs =\n\t\tnackContent.retryAfter !== undefined ? nackContent.retryAfter * 1000 : undefined;\n\treturn createGenericNetworkError(\n\t\tmessage,\n\t\t{ canRetry, retryAfterMs },\n\t\t{ statusCode: nackContent.code, driverVersion: undefined },\n\t);\n}\n\n/**\n * Implementation of IDocumentDeltaConnection that does not support submitting\n * or receiving ops. Used in storage-only mode.\n */\nconst clientNoDeltaStream: IClient = {\n\tmode: \"read\",\n\tdetails: { capabilities: { interactive: true } },\n\tpermission: [],\n\tuser: { id: \"storage-only client\" }, // we need some \"fake\" ID here.\n\tscopes: [],\n};\nconst clientIdNoDeltaStream: string = \"storage-only client\";\n\nclass NoDeltaStream\n\textends TypedEventEmitter<IDocumentDeltaConnectionEvents>\n\timplements IDocumentDeltaConnection, IDisposable\n{\n\tclientId = clientIdNoDeltaStream;\n\tclaims: ITokenClaims = {\n\t\tscopes: [ScopeType.DocRead],\n\t} as any;\n\tmode: ConnectionMode = \"read\";\n\texisting: boolean = true;\n\tmaxMessageSize: number = 0;\n\tversion: string = \"\";\n\tinitialMessages: ISequencedDocumentMessage[] = [];\n\tinitialSignals: ISignalMessage[] = [];\n\tinitialClients: ISignalClient[] = [\n\t\t{ client: clientNoDeltaStream, clientId: clientIdNoDeltaStream },\n\t];\n\tserviceConfiguration: IClientConfiguration = {\n\t\tmaxMessageSize: 0,\n\t\tblockSize: 0,\n\t};\n\tcheckpointSequenceNumber?: number | undefined = undefined;\n\t/**\n\t * Connection which is not connected to socket.\n\t * @param storageOnlyReason - Reason on why the connection to delta stream is not allowed.\n\t * @param readonlyConnectionReason - reason/error if any which lead to using NoDeltaStream.\n\t */\n\tconstructor(\n\t\tpublic readonly storageOnlyReason?: string,\n\t\tpublic readonly readonlyConnectionReason?: IConnectionStateChangeReason,\n\t) {\n\t\tsuper();\n\t}\n\tsubmit(messages: IDocumentMessage[]): void {\n\t\tthis.emit(\n\t\t\t\"nack\",\n\t\t\tthis.clientId,\n\t\t\tmessages.map((operation) => {\n\t\t\t\treturn {\n\t\t\t\t\toperation,\n\t\t\t\t\tcontent: { message: \"Cannot submit with storage-only connection\", code: 403 },\n\t\t\t\t};\n\t\t\t}),\n\t\t);\n\t}\n\tsubmitSignal(message: any): void {\n\t\tthis.emit(\"nack\", this.clientId, {\n\t\t\toperation: message,\n\t\t\tcontent: { message: \"Cannot submit signal with storage-only connection\", code: 403 },\n\t\t});\n\t}\n\n\tprivate _disposed = false;\n\tpublic get disposed() {\n\t\treturn this._disposed;\n\t}\n\tpublic dispose() {\n\t\tthis._disposed = true;\n\t}\n}\n\nfunction isNoDeltaStreamConnection(connection: any): connection is NoDeltaStream {\n\treturn connection instanceof NoDeltaStream;\n}\n\nconst waitForOnline = async (): Promise<void> => {\n\t// Only wait if we have a strong signal that we're offline - otherwise assume we're online.\n\tif (globalThis.navigator?.onLine === false && globalThis.addEventListener !== undefined) {\n\t\treturn new Promise<void>((resolve) => {\n\t\t\tconst resolveAndRemoveListener = () => {\n\t\t\t\tresolve();\n\t\t\t\tglobalThis.removeEventListener(\"online\", resolveAndRemoveListener);\n\t\t\t};\n\t\t\tglobalThis.addEventListener(\"online\", resolveAndRemoveListener);\n\t\t});\n\t}\n};\n\n/**\n * Interface to track the current in-progress connection attempt.\n */\ninterface IPendingConnection {\n\t/**\n\t * Used to cancel an in-progress connection attempt.\n\t */\n\tabort(): void;\n\n\t/**\n\t * Desired ConnectionMode of this in-progress connection attempt.\n\t */\n\tconnectionMode: ConnectionMode;\n}\n\n/**\n * Implementation of IConnectionManager, used by Container class\n * Implements constant connectivity to relay service, by reconnecting in case of lost connection or error.\n * Exposes various controls to influence this process, including manual reconnects, forced read-only mode, etc.\n */\nexport class ConnectionManager implements IConnectionManager {\n\t/** Connection mode used when reconnecting on error or disconnect. */\n\tprivate readonly defaultReconnectionMode: ConnectionMode;\n\n\t/**\n\t * Tracks the current in-progress connection attempt. Undefined if there is none.\n\t * Note: Once the connection attempt fires and the code becomes asynchronous, its possible that a new connection\n\t * attempt was fired and this.pendingConnection was overwritten to reflect the new attempt.\n\t */\n\tprivate pendingConnection: IPendingConnection | undefined;\n\tprivate connection: IDocumentDeltaConnection | undefined;\n\n\t/** file ACL - whether user has only read-only access to a file */\n\tprivate _readonlyPermissions: boolean | undefined;\n\n\t/** tracks host requiring read-only mode. */\n\tprivate _forceReadonly = false;\n\n\t/**\n\t * Controls whether the DeltaManager will automatically reconnect to the delta stream after receiving a disconnect.\n\t */\n\tprivate _reconnectMode: ReconnectMode;\n\n\t/** True if there is pending (async) reconnection from \"read\" to \"write\" */\n\tprivate pendingReconnect = false;\n\n\tprivate clientSequenceNumber = 0;\n\tprivate clientSequenceNumberObserved = 0;\n\t/** Counts the number of non-runtime ops sent by the client which may not be acked. */\n\tprivate localOpsToIgnore = 0;\n\n\t/** track clientId used last time when we sent any ops */\n\tprivate lastSubmittedClientId: string | undefined;\n\n\tprivate connectFirstConnection = true;\n\n\tprivate _connectionVerboseProps: Record<string, string | number> = {};\n\n\tprivate _connectionProps: ITelemetryProperties = {};\n\n\tprivate _disposed = false;\n\n\tprivate readonly _outbound: DeltaQueue<IDocumentMessage[]>;\n\n\tpublic get connectionVerboseProps() {\n\t\treturn this._connectionVerboseProps;\n\t}\n\n\tpublic readonly clientDetails: IClientDetails;\n\n\t/**\n\t * The current connection mode, initially read.\n\t */\n\tpublic get connectionMode(): ConnectionMode {\n\t\treturn this.connection?.mode ?? \"read\";\n\t}\n\n\tpublic get connected() {\n\t\treturn this.connection !== undefined;\n\t}\n\n\tpublic get clientId() {\n\t\treturn this.connection?.clientId;\n\t}\n\t/**\n\t * Automatic reconnecting enabled or disabled.\n\t * If set to Never, then reconnecting will never be allowed.\n\t */\n\tpublic get reconnectMode(): ReconnectMode {\n\t\treturn this._reconnectMode;\n\t}\n\n\tpublic get maxMessageSize(): number {\n\t\treturn this.connection?.serviceConfiguration?.maxMessageSize ?? DefaultChunkSize;\n\t}\n\n\tpublic get version(): string {\n\t\tif (this.connection === undefined) {\n\t\t\tthrow new Error(\"Cannot check version without a connection\");\n\t\t}\n\t\treturn this.connection.version;\n\t}\n\n\tpublic get serviceConfiguration(): IClientConfiguration | undefined {\n\t\treturn this.connection?.serviceConfiguration;\n\t}\n\n\tpublic get scopes(): string[] | undefined {\n\t\treturn this.connection?.claims.scopes;\n\t}\n\n\tpublic get outbound(): IDeltaQueue<IDocumentMessage[]> {\n\t\treturn this._outbound;\n\t}\n\n\t/**\n\t * Returns set of props that can be logged in telemetry that provide some insights / statistics\n\t * about current or last connection (if there is no connection at the moment)\n\t */\n\tpublic get connectionProps(): ITelemetryProperties {\n\t\treturn this.connection !== undefined\n\t\t\t? this._connectionProps\n\t\t\t: {\n\t\t\t\t\t...this._connectionProps,\n\t\t\t\t\t// Report how many ops this client sent in last disconnected session\n\t\t\t\t\tsentOps: this.clientSequenceNumber,\n\t\t\t };\n\t}\n\n\tpublic shouldJoinWrite(): boolean {\n\t\t// We don't have to wait for ack for topmost NoOps. So subtract those.\n\t\tconst outstandingOps =\n\t\t\tthis.clientSequenceNumberObserved < this.clientSequenceNumber - this.localOpsToIgnore;\n\n\t\t// Previous behavior was to force write mode here only when there are outstanding ops (besides\n\t\t// no-ops). The dirty signal from runtime should provide the same behavior, but also support\n\t\t// stashed ops that weren't submitted to container layer yet. For safety, we want to retain the\n\t\t// same behavior whenever dirty is false.\n\t\tconst isDirty = this.containerDirty();\n\t\tif (outstandingOps !== isDirty) {\n\t\t\tthis.logger.sendTelemetryEvent({\n\t\t\t\teventName: \"DesiredConnectionModeMismatch\",\n\t\t\t\tdetails: JSON.stringify({ outstandingOps, isDirty }),\n\t\t\t});\n\t\t}\n\t\treturn outstandingOps || isDirty;\n\t}\n\n\t/**\n\t * Tells if container is in read-only mode.\n\t * Data stores should listen for \"readonly\" notifications and disallow user\n\t * making changes to data stores.\n\t * Readonly state can be because of no storage write permission,\n\t * or due to host forcing readonly mode for container.\n\t * It is undefined if we have not yet established websocket connection\n\t * and do not know if user has write access to a file.\n\t */\n\tprivate get readonly(): boolean | undefined {\n\t\treturn this.readOnlyInfo.readonly;\n\t}\n\n\tpublic get readOnlyInfo(): ReadOnlyInfo {\n\t\tlet storageOnly: boolean = false;\n\t\tlet storageOnlyReason: string | undefined;\n\t\tif (isNoDeltaStreamConnection(this.connection)) {\n\t\t\tstorageOnly = true;\n\t\t\tstorageOnlyReason = this.connection.storageOnlyReason;\n\t\t}\n\t\tif (storageOnly || this._forceReadonly || this._readonlyPermissions === true) {\n\t\t\treturn {\n\t\t\t\treadonly: true,\n\t\t\t\tforced: this._forceReadonly,\n\t\t\t\tpermissions: this._readonlyPermissions,\n\t\t\t\tstorageOnly,\n\t\t\t\tstorageOnlyReason,\n\t\t\t};\n\t\t}\n\n\t\treturn { readonly: this._readonlyPermissions };\n\t}\n\n\tprivate static detailsFromConnection(\n\t\tconnection: IDocumentDeltaConnection,\n\t\treason: IConnectionStateChangeReason,\n\t): IConnectionDetailsInternal {\n\t\treturn {\n\t\t\tclaims: connection.claims,\n\t\t\tclientId: connection.clientId,\n\t\t\tcheckpointSequenceNumber: connection.checkpointSequenceNumber,\n\t\t\tget initialClients() {\n\t\t\t\treturn connection.initialClients;\n\t\t\t},\n\t\t\tmode: connection.mode,\n\t\t\tserviceConfiguration: connection.serviceConfiguration,\n\t\t\tversion: connection.version,\n\t\t\treason,\n\t\t};\n\t}\n\n\tconstructor(\n\t\tprivate readonly serviceProvider: () => IDocumentService | undefined,\n\t\tpublic readonly containerDirty: () => boolean,\n\t\tprivate readonly client: IClient,\n\t\treconnectAllowed: boolean,\n\t\tprivate readonly logger: ITelemetryLoggerExt,\n\t\tprivate readonly props: IConnectionManagerFactoryArgs,\n\t) {\n\t\tthis.clientDetails = this.client.details;\n\t\tthis.defaultReconnectionMode = this.client.mode;\n\t\tthis._reconnectMode = reconnectAllowed ? ReconnectMode.Enabled : ReconnectMode.Never;\n\n\t\t// Outbound message queue. The outbound queue is represented as a queue of an array of ops. Ops contained\n\t\t// within an array *must* fit within the maxMessageSize and are guaranteed to be ordered sequentially.\n\t\tthis._outbound = new DeltaQueue<IDocumentMessage[]>((messages) => {\n\t\t\tif (this.connection === undefined) {\n\t\t\t\tthrow new Error(\"Attempted to submit an outbound message without connection\");\n\t\t\t}\n\t\t\tthis.connection.submit(messages);\n\t\t});\n\n\t\tthis._outbound.on(\"error\", (error) => {\n\t\t\tthis.props.closeHandler(normalizeError(error));\n\t\t});\n\t}\n\n\tpublic dispose(error?: ICriticalContainerError, switchToReadonly: boolean = true) {\n\t\tif (this._disposed) {\n\t\t\treturn;\n\t\t}\n\t\tthis._disposed = true;\n\n\t\t// Ensure that things like triggerConnect() will short circuit\n\t\tthis._reconnectMode = ReconnectMode.Never;\n\n\t\tthis._outbound.clear();\n\n\t\tconst disconnectReason: IConnectionStateChangeReason = {\n\t\t\ttext: \"Closing DeltaManager\",\n\t\t\terror,\n\t\t};\n\n\t\tconst oldReadonlyValue = this.readonly;\n\t\t// This raises \"disconnect\" event if we have active connection.\n\t\tthis.disconnectFromDeltaStream(disconnectReason);\n\n\t\tif (switchToReadonly) {\n\t\t\t// Notify everyone we are in read-only state.\n\t\t\t// Useful for data stores in case we hit some critical error,\n\t\t\t// to switch to a mode where user edits are not accepted\n\t\t\tthis.set_readonlyPermissions(true, oldReadonlyValue, disconnectReason);\n\t\t}\n\t}\n\n\t/**\n\t * Enables or disables automatic reconnecting.\n\t * Will throw an error if reconnectMode set to Never.\n\t */\n\tpublic setAutoReconnect(mode: ReconnectMode, reason: IConnectionStateChangeReason): void {\n\t\tassert(\n\t\t\tmode !== ReconnectMode.Never && this._reconnectMode !== ReconnectMode.Never,\n\t\t\t0x278 /* \"API is not supported for non-connecting or closed container\" */,\n\t\t);\n\n\t\tthis._reconnectMode = mode;\n\n\t\tif (mode !== ReconnectMode.Enabled) {\n\t\t\t// immediately disconnect - do not rely on service eventually dropping connection.\n\t\t\tthis.disconnectFromDeltaStream(reason);\n\t\t}\n\t}\n\n\t/**\n\t * {@inheritDoc Container.forceReadonly}\n\t */\n\tpublic forceReadonly(readonly: boolean) {\n\t\tif (readonly !== this._forceReadonly) {\n\t\t\tthis.logger.sendTelemetryEvent({\n\t\t\t\teventName: \"ForceReadOnly\",\n\t\t\t\tvalue: readonly,\n\t\t\t});\n\t\t}\n\t\tconst oldValue = this.readonly;\n\t\tthis._forceReadonly = readonly;\n\n\t\tif (oldValue !== this.readonly) {\n\t\t\tif (this._reconnectMode === ReconnectMode.Never) {\n\t\t\t\tthrow new UsageError(\"API is not supported for non-connecting or closed container\");\n\t\t\t}\n\t\t\tlet reconnect = false;\n\t\t\tif (this.readonly === true) {\n\t\t\t\t// If we switch to readonly while connected, we should disconnect first\n\t\t\t\t// See comment in the \"readonly\" event handler to deltaManager set up by\n\t\t\t\t// the ContainerRuntime constructor\n\n\t\t\t\tif (this.shouldJoinWrite()) {\n\t\t\t\t\t// If we have pending changes, then we will never send them - it smells like\n\t\t\t\t\t// host logic error.\n\t\t\t\t\tthis.logger.sendErrorEvent({ eventName: \"ForceReadonlyPendingChanged\" });\n\t\t\t\t}\n\n\t\t\t\treconnect = this.disconnectFromDeltaStream({ text: \"Force readonly\" });\n\t\t\t}\n\t\t\tthis.props.readonlyChangeHandler(this.readonly);\n\t\t\tif (reconnect) {\n\t\t\t\t// reconnect if we disconnected from before.\n\t\t\t\tthis.triggerConnect({ text: \"Force Readonly\" }, \"read\");\n\t\t\t}\n\t\t}\n\t}\n\n\tprivate set_readonlyPermissions(\n\t\tnewReadonlyValue: boolean,\n\t\toldReadonlyValue: boolean | undefined,\n\t\treadonlyConnectionReason?: IConnectionStateChangeReason,\n\t) {\n\t\tthis._readonlyPermissions = newReadonlyValue;\n\t\tif (oldReadonlyValue !== this.readonly) {\n\t\t\tthis.props.readonlyChangeHandler(this.readonly, readonlyConnectionReason);\n\t\t}\n\t}\n\n\tpublic connect(reason: IConnectionStateChangeReason, connectionMode?: ConnectionMode) {\n\t\tthis.connectCore(reason, connectionMode).catch((e) => {\n\t\t\tconst normalizedError = normalizeError(e, { props: fatalConnectErrorProp });\n\t\t\tthis.props.closeHandler(normalizedError);\n\t\t});\n\t}\n\n\tprivate async connectCore(\n\t\treason: IConnectionStateChangeReason,\n\t\tconnectionMode?: ConnectionMode,\n\t): Promise<void> {\n\t\tassert(!this._disposed, 0x26a /* \"not closed\" */);\n\n\t\tif (this.connection !== undefined) {\n\t\t\treturn; // Connection attempt already completed successfully\n\t\t}\n\n\t\tlet pendingConnectionMode;\n\t\tif (this.pendingConnection !== undefined) {\n\t\t\tpendingConnectionMode = this.pendingConnection.connectionMode;\n\t\t\tthis.cancelConnection(reason); // Throw out in-progress connection attempt in favor of new attempt\n\t\t\tassert(\n\t\t\t\tthis.pendingConnection === undefined,\n\t\t\t\t0x344 /* this.pendingConnection should be undefined */,\n\t\t\t);\n\t\t}\n\t\t// If there is no specified ConnectionMode, try the previous mode, if there is no previous mode use default\n\t\tlet requestedMode = connectionMode ?? pendingConnectionMode ?? this.defaultReconnectionMode;\n\n\t\t// if we have any non-acked ops from last connection, reconnect as \"write\".\n\t\t// without that we would connect in view-only mode, which will result in immediate\n\t\t// firing of \"connected\" event from Container and switch of current clientId (as tracked\n\t\t// by all DDSes). This will make it impossible to figure out if ops actually made it through,\n\t\t// so DDSes will immediately resubmit all pending ops, and some of them will be duplicates, corrupting document\n\t\tif (this.shouldJoinWrite()) {\n\t\t\trequestedMode = \"write\";\n\t\t}\n\n\t\tconst docService = this.serviceProvider();\n\t\tassert(docService !== undefined, 0x2a7 /* \"Container is not attached\" */);\n\n\t\tlet connection: IDocumentDeltaConnection | undefined;\n\n\t\tif (docService.policies?.storageOnly === true) {\n\t\t\tconnection = new NoDeltaStream();\n\t\t\tthis.setupNewSuccessfulConnection(connection, \"read\", reason);\n\t\t\tassert(this.pendingConnection === undefined, 0x2b3 /* \"logic error\" */);\n\t\t\treturn;\n\t\t}\n\n\t\tlet delayMs = InitialReconnectDelayInMs;\n\t\tlet connectRepeatCount = 0;\n\t\tconst connectStartTime = performance.now();\n\t\tlet lastError: any;\n\n\t\tconst abortController = new AbortController();\n\t\tconst abortSignal = abortController.signal;\n\t\tthis.pendingConnection = {\n\t\t\tabort: () => {\n\t\t\t\tabortController.abort();\n\t\t\t},\n\t\t\tconnectionMode: requestedMode,\n\t\t};\n\n\t\tthis.props.establishConnectionHandler(reason);\n\t\t// This loop will keep trying to connect until successful, with a delay between each iteration.\n\t\twhile (connection === undefined) {\n\t\t\tif (this._disposed) {\n\t\t\t\tthrow new Error(\"Attempting to connect a closed DeltaManager\");\n\t\t\t}\n\t\t\tif (abortSignal.aborted === true) {\n\t\t\t\tthis.logger.sendTelemetryEvent({\n\t\t\t\t\teventName: \"ConnectionAttemptCancelled\",\n\t\t\t\t\tattempts: connectRepeatCount,\n\t\t\t\t\tduration: formatTick(performance.now() - connectStartTime),\n\t\t\t\t\tconnectionEstablished: false,\n\t\t\t\t});\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconnectRepeatCount++;\n\n\t\t\ttry {\n\t\t\t\tthis.client.mode = requestedMode;\n\t\t\t\tconnection = await docService.connectToDeltaStream({\n\t\t\t\t\t...this.client,\n\t\t\t\t\tmode: requestedMode,\n\t\t\t\t});\n\n\t\t\t\tif (connection.disposed) {\n\t\t\t\t\t// Nobody observed this connection, so drop it on the floor and retry.\n\t\t\t\t\tthis.logger.sendTelemetryEvent({ eventName: \"ReceivedClosedConnection\" });\n\t\t\t\t\tconnection = undefined;\n\t\t\t\t}\n\t\t\t\tthis.logger.sendTelemetryEvent(\n\t\t\t\t\t{\n\t\t\t\t\t\teventName: \"ConnectionReceived\",\n\t\t\t\t\t\tconnected: connection !== undefined && connection.disposed === false,\n\t\t\t\t\t},\n\t\t\t\t\tundefined,\n\t\t\t\t\tLogLevel.verbose,\n\t\t\t\t);\n\t\t\t} catch (origError: any) {\n\t\t\t\tif (isDeltaStreamConnectionForbiddenError(origError)) {\n\t\t\t\t\tconnection = new NoDeltaStream(origError.storageOnlyReason, {\n\t\t\t\t\t\ttext: origError.message,\n\t\t\t\t\t\terror: origError,\n\t\t\t\t\t});\n\t\t\t\t\trequestedMode = \"read\";\n\t\t\t\t\tbreak;\n\t\t\t\t} else if (\n\t\t\t\t\tisFluidError(origError) &&\n\t\t\t\t\t// eslint-disable-next-line import/no-deprecated\n\t\t\t\t\torigError.errorType === DriverErrorType.outOfStorageError\n\t\t\t\t) {\n\t\t\t\t\t// If we get out of storage error from calling joinsession, then use the NoDeltaStream object so\n\t\t\t\t\t// that user can at least load the container.\n\t\t\t\t\tconnection = new NoDeltaStream(undefined, {\n\t\t\t\t\t\ttext: origError.message,\n\t\t\t\t\t\terror: origError,\n\t\t\t\t\t});\n\t\t\t\t\trequestedMode = \"read\";\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\n\t\t\t\t// Socket.io error when we connect to wrong socket, or hit some multiplexing bug\n\t\t\t\tif (!canRetryOnError(origError)) {\n\t\t\t\t\tconst error = normalizeError(origError, { props: fatalConnectErrorProp });\n\t\t\t\t\tthis.props.closeHandler(error);\n\t\t\t\t\tthrow error;\n\t\t\t\t}\n\n\t\t\t\t// Since the error is retryable this will not log to the error table\n\t\t\t\tlogNetworkFailure(\n\t\t\t\t\tthis.logger,\n\t\t\t\t\t{\n\t\t\t\t\t\tattempts: connectRepeatCount,\n\t\t\t\t\t\tdelay: delayMs, // milliseconds\n\t\t\t\t\t\teventName: \"DeltaConnectionFailureToConnect\",\n\t\t\t\t\t\tduration: formatTick(performance.now() - connectStartTime),\n\t\t\t\t\t},\n\t\t\t\t\torigError,\n\t\t\t\t);\n\n\t\t\t\tlastError = origError;\n\n\t\t\t\tconst waitStartTime = performance.now();\n\t\t\t\tconst retryDelayFromError = getRetryDelayFromError(origError);\n\t\t\t\tif (retryDelayFromError !== undefined) {\n\t\t\t\t\t// If the error told us to wait, then we wait.\n\t\t\t\t\tthis.props.reconnectionDelayHandler(retryDelayFromError, origError);\n\t\t\t\t\tawait new Promise<void>((resolve) => {\n\t\t\t\t\t\tsetTimeout(resolve, retryDelayFromError);\n\t\t\t\t\t});\n\t\t\t\t} else if (globalThis.navigator?.onLine !== false) {\n\t\t\t\t\t// If the error didn't tell us to wait, let's still wait a little bit before retrying.\n\t\t\t\t\t// We skip this delay if we're confident we're offline, because we probably just need to wait to come back online.\n\t\t\t\t\tawait new Promise<void>((resolve) => {\n\t\t\t\t\t\tsetTimeout(resolve, delayMs);\n\t\t\t\t\t\tdelayMs = Math.min(delayMs * 2, calculateMaxWaitTime(origError));\n\t\t\t\t\t});\n\t\t\t\t}\n\n\t\t\t\t// If we believe we're offline, we assume there's no point in trying until we at least think we're online.\n\t\t\t\t// NOTE: This isn't strictly true for drivers that don't require network (e.g. local driver). Really this logic\n\t\t\t\t// should probably live in the driver.\n\t\t\t\tawait waitForOnline();\n\t\t\t\tthis.logger.sendPerformanceEvent({\n\t\t\t\t\teventName: \"WaitBetweenConnectionAttempts\",\n\t\t\t\t\tduration: performance.now() - waitStartTime,\n\t\t\t\t\tdetails: JSON.stringify({\n\t\t\t\t\t\tretryDelayFromError,\n\t\t\t\t\t\tdelayMs,\n\t\t\t\t\t}),\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\n\t\t// If we retried more than once, log an event about how long it took (this will not log to error table)\n\t\tif (connectRepeatCount > 1) {\n\t\t\tlogNetworkFailure(\n\t\t\t\tthis.logger,\n\t\t\t\t{\n\t\t\t\t\teventName: \"MultipleDeltaConnectionFailures\",\n\t\t\t\t\tattempts: connectRepeatCount,\n\t\t\t\t\tduration: formatTick(performance.now() - connectStartTime),\n\t\t\t\t},\n\t\t\t\tlastError,\n\t\t\t);\n\t\t}\n\n\t\t// Check for abort signal after while loop as well or we've been disposed\n\t\tif (abortSignal.aborted === true || this._disposed) {\n\t\t\tconnection.dispose();\n\t\t\tthis.logger.sendTelemetryEvent({\n\t\t\t\teventName: \"ConnectionAttemptCancelled\",\n\t\t\t\tattempts: connectRepeatCount,\n\t\t\t\tduration: formatTick(performance.now() - connectStartTime),\n\t\t\t\tconnectionEstablished: true,\n\t\t\t});\n\t\t\treturn;\n\t\t}\n\n\t\tthis.setupNewSuccessfulConnection(connection, requestedMode, reason);\n\t}\n\n\t/**\n\t * Start the connection. Any error should result in container being closed.\n\t * And report the error if it escapes for any reason.\n\t * @param args - The connection arguments\n\t */\n\tprivate triggerConnect(reason: IConnectionStateChangeReason, connectionMode: ConnectionMode) {\n\t\t// reconnect() includes async awaits, and that causes potential race conditions\n\t\t// where we might already have a connection. If it were to happen, it's possible that we will connect\n\t\t// with different mode to `connectionMode`. Glancing through the caller chains, it looks like code should be\n\t\t// fine (if needed, reconnect flow will get triggered again). Places where new mode matters should encode it\n\t\t// directly in connectCore - see this.shouldJoinWrite() test as an example.\n\t\t// assert(this.connection === undefined, 0x239 /* \"called only in disconnected state\" */);\n\n\t\tif (this.reconnectMode !== ReconnectMode.Enabled) {\n\t\t\treturn;\n\t\t}\n\t\tthis.connect(reason, connectionMode);\n\t}\n\n\t/**\n\t * Disconnect the current connection.\n\t * @param reason - Text description of disconnect reason to emit with disconnect event\n\t * @param error - Error causing the disconnect if any.\n\t * @returns A boolean that indicates if there was an existing connection (or pending connection) to disconnect\n\t */\n\tprivate disconnectFromDeltaStream(reason: IConnectionStateChangeReason): boolean {\n\t\tthis.pendingReconnect = false;\n\n\t\tif (this.connection === undefined) {\n\t\t\tif (this.pendingConnection !== undefined) {\n\t\t\t\tthis.cancelConnection(reason);\n\t\t\t\treturn true;\n\t\t\t}\n\t\t\treturn false;\n\t\t}\n\n\t\tassert(\n\t\t\tthis.pendingConnection === undefined,\n\t\t\t0x27b /* \"reentrancy may result in incorrect behavior\" */,\n\t\t);\n\n\t\tconst connection = this.connection;\n\t\t// Avoid any re-entrancy - clear object reference\n\t\tthis.connection = undefined;\n\n\t\t// Remove listeners first so we don't try to retrigger this flow accidentally through reconnectOnError\n\t\tconnection.off(\"op\", this.opHandler);\n\t\tconnection.off(\"signal\", this.signalHandler);\n\t\tconnection.off(\"nack\", this.nackHandler);\n\t\tconnection.off(\"disconnect\", this.disconnectHandlerInternal);\n\t\tconnection.off(\"error\", this.errorHandler);\n\t\tconnection.off(\"pong\", this.props.pongHandler);\n\n\t\t// eslint-disable-next-line @typescript-eslint/no-floating-promises\n\t\tthis._outbound.pause();\n\t\tthis._outbound.clear();\n\t\tconnection.dispose();\n\n\t\tthis.props.disconnectHandler(reason);\n\n\t\tthis._connectionVerboseProps = {};\n\n\t\treturn true;\n\t}\n\n\t/**\n\t * Cancel in-progress connection attempt.\n\t */\n\tprivate cancelConnection(reason: IConnectionStateChangeReason) {\n\t\tassert(\n\t\t\tthis.pendingConnection !== undefined,\n\t\t\t0x345 /* this.pendingConnection is undefined when trying to cancel */,\n\t\t);\n\t\tthis.pendingConnection.abort();\n\t\tthis.pendingConnection = undefined;\n\t\tthis.logger.sendTelemetryEvent({ eventName: \"ConnectionCancelReceived\" });\n\t\tthis.props.cancelConnectionHandler({\n\t\t\ttext: `Cancel Pending Connection due to ${reason.text}`,\n\t\t\terror: reason.error,\n\t\t});\n\t}\n\n\t/**\n\t * Once we've successfully gotten a connection, we need to set up state, attach event listeners, and process\n\t * initial messages.\n\t * @param connection - The newly established connection\n\t */\n\tprivate setupNewSuccessfulConnection(\n\t\tconnection: IDocumentDeltaConnection,\n\t\trequestedMode: ConnectionMode,\n\t\treason: IConnectionStateChangeReason,\n\t) {\n\t\t// Old connection should have been cleaned up before establishing a new one\n\t\tassert(\n\t\t\tthis.connection === undefined,\n\t\t\t0x0e6 /* \"old connection exists on new connection setup\" */,\n\t\t);\n\t\tassert(\n\t\t\t!connection.disposed,\n\t\t\t0x28a /* \"can't be disposed - Callers need to ensure that!\" */,\n\t\t);\n\n\t\tthis.pendingConnection = undefined;\n\n\t\tconst oldReadonlyValue = this.readonly;\n\t\tthis.connection = connection;\n\n\t\t// Does information in scopes & mode matches?\n\t\t// If we asked for \"write\" and got \"read\", then file is read-only\n\t\t// But if we ask read, server can still give us write.\n\t\tconst readonly = !connection.claims.scopes.includes(ScopeType.DocWrite);\n\n\t\tif (connection.mode !== requestedMode) {\n\t\t\tthis.logger.sendTelemetryEvent({\n\t\t\t\teventName: \"ConnectionModeMismatch\",\n\t\t\t\trequestedMode,\n\t\t\t\tmode: connection.mode,\n\t\t\t});\n\t\t}\n\t\t// This connection mode validation logic is moving to the driver layer in 0.44. These two asserts can be\n\t\t// removed after those packages have released and become ubiquitous.\n\t\tassert(\n\t\t\trequestedMode === \"read\" || readonly === (this.connectionMode === \"read\"),\n\t\t\t0x0e7 /* \"claims/connectionMode mismatch\" */,\n\t\t);\n\t\tassert(\n\t\t\t!readonly || this.connectionMode === \"read\",\n\t\t\t0x0e8 /* \"readonly perf with write connection\" */,\n\t\t);\n\n\t\tthis.set_readonlyPermissions(\n\t\t\treadonly,\n\t\t\toldReadonlyValue,\n\t\t\tisNoDeltaStreamConnection(connection) ? connection.readonlyConnectionReason : undefined,\n\t\t);\n\n\t\tif (this._disposed) {\n\t\t\t// Raise proper events, Log telemetry event and close connection.\n\t\t\tthis.disconnectFromDeltaStream({ text: \"ConnectionManager already closed\" });\n\t\t\treturn;\n\t\t}\n\n\t\tthis._outbound.resume();\n\n\t\tconnection.on(\"op\", this.opHandler);\n\t\tconnection.on(\"signal\", this.signalHandler);\n\t\tconnection.on(\"nack\", this.nackHandler);\n\t\tconnection.on(\"disconnect\", this.disconnectHandlerInternal);\n\t\tconnection.on(\"error\", this.errorHandler);\n\t\tconnection.on(\"pong\", this.props.pongHandler);\n\n\t\t// Initial messages are always sorted. However, due to early op handler installed by drivers and appending those\n\t\t// ops to initialMessages, resulting set is no longer sorted, which would result in client hitting storage to\n\t\t// fill in gap. We will recover by cancelling this request once we process remaining ops, but it's a waste that\n\t\t// we could avoid\n\t\tconst initialMessages = connection.initialMessages.sort(\n\t\t\t(a, b) => a.sequenceNumber - b.sequenceNumber,\n\t\t);\n\n\t\t// Some storages may provide checkpointSequenceNumber to identify how far client is behind.\n\t\tlet checkpointSequenceNumber = connection.checkpointSequenceNumber;\n\n\t\tthis._connectionVerboseProps = {\n\t\t\tclientId: connection.clientId,\n\t\t\tmode: connection.mode,\n\t\t};\n\n\t\t// reset connection props\n\t\tthis._connectionProps = {};\n\n\t\tif (connection.relayServiceAgent !== undefined) {\n\t\t\tthis._connectionVerboseProps.relayServiceAgent = connection.relayServiceAgent;\n\t\t\tthis._connectionProps.relayServiceAgent = connection.relayServiceAgent;\n\t\t}\n\t\tthis._connectionProps.socketDocumentId = connection.claims.documentId;\n\t\tthis._connectionProps.connectionMode = connection.mode;\n\n\t\tlet last = -1;\n\t\tif (initialMessages.length !== 0) {\n\t\t\tthis._connectionVerboseProps.connectionInitialOpsFrom =\n\t\t\t\tinitialMessages[0].sequenceNumber;\n\t\t\tlast = initialMessages[initialMessages.length - 1].sequenceNumber;\n\t\t\tthis._connectionVerboseProps.connectionInitialOpsTo = last + 1;\n\t\t\t// Update knowledge of how far we are behind, before raising \"connect\" event\n\t\t\t// This is duplication of what incomingOpHandler() does, but we have to raise event before we get there,\n\t\t\t// so duplicating update logic here as well.\n\t\t\tif (checkpointSequenceNumber === undefined || checkpointSequenceNumber < last) {\n\t\t\t\tcheckpointSequenceNumber = last;\n\t\t\t}\n\t\t}\n\n\t\tthis.props.incomingOpHandler(\n\t\t\tinitialMessages,\n\t\t\tthis.connectFirstConnection ? \"InitialOps\" : \"ReconnectOps\",\n\t\t);\n\n\t\tconst details = ConnectionManager.detailsFromConnection(connection, reason);\n\t\tdetails.checkpointSequenceNumber = checkpointSequenceNumber;\n\t\tthis.props.connectHandler(details);\n\n\t\tthis.connectFirstConnection = false;\n\n\t\t// Synthesize clear & join signals out of initialClients state.\n\t\t// This allows us to have single way to process signals, and makes it simpler to initialize\n\t\t// protocol in Container.\n\t\tconst clearSignal: ISignalMessage = {\n\t\t\tclientId: null, // system message\n\t\t\tcontent: JSON.stringify({\n\t\t\t\ttype: SignalType.Clear,\n\t\t\t}),\n\t\t};\n\n\t\t// list of signals to process due to this new connection\n\t\tlet signalsToProcess: ISignalMessage[] = [clearSignal];\n\n\t\tconst clientJoinSignals: ISignalMessage[] = (connection.initialClients ?? []).map(\n\t\t\t(priorClient) => ({\n\t\t\t\tclientId: null, // system signal\n\t\t\t\tcontent: JSON.stringify({\n\t\t\t\t\ttype: SignalType.ClientJoin,\n\t\t\t\t\tcontent: priorClient, // ISignalClient\n\t\t\t\t}),\n\t\t\t}),\n\t\t);\n\t\tif (clientJoinSignals.length > 0) {\n\t\t\tsignalsToProcess = signalsToProcess.concat(clientJoinSignals);\n\t\t}\n\n\t\t// Unfortunately, there is no defined order between initialSignals (including join & leave signals)\n\t\t// and connection.initialClients. In practice, connection.initialSignals quite often contains join signal\n\t\t// for \"self\" and connection.initialClients does not contain \"self\", so we have to process them after\n\t\t// \"clear\" signal above.\n\t\tif (connection.initialSignals !== undefined && connection.initialSignals.length > 0) {\n\t\t\tsignalsToProcess = signalsToProcess.concat(connection.initialSignals);\n\t\t}\n\n\t\tthis.props.signalHandler(signalsToProcess);\n\t}\n\n\t/**\n\t * Disconnect the current connection and reconnect. Closes the container if it fails.\n\t * @param connection - The connection that wants to reconnect - no-op if it's different from this.connection\n\t * @param requestedMode - Read or write\n\t * @param error - Error reconnect information including whether or not to reconnect\n\t * @returns A promise that resolves when the connection is reestablished or we stop trying\n\t */\n\tprivate reconnectOnError(requestedMode: ConnectionMode, error: IAnyDriverError) {\n\t\tthis.reconnect(requestedMode, { text: error.message, error }).catch(\n\t\t\tthis.props.closeHandler,\n\t\t);\n\t}\n\n\t/**\n\t * Disconnect the current connection and reconnect.\n\t * @param connection - The connection that wants to reconnect - no-op if it's different from this.connection\n\t * @param requestedMode - Read or write\n\t * @param error - Error reconnect information including whether or not to reconnect\n\t * @returns A promise that resolves when the connection is reestablished or we stop trying\n\t */\n\tprivate async reconnect(\n\t\trequestedMode: ConnectionMode,\n\t\treason: IConnectionStateChangeReason<IAnyDriverError>,\n\t) {\n\t\t// We quite often get protocol errors before / after observing nack/disconnect\n\t\t// we do not want to run through same sequence twice.\n\t\t// If we're already disconnected/disconnecting it's not appropriate to call this again.\n\t\tassert(this.connection !== undefined, 0x0eb /* \"Missing connection for reconnect\" */);\n\n\t\tthis.disconnectFromDeltaStream(reason);\n\n\t\t// We will always trigger reconnect, even if canRetry is false.\n\t\t// Any truly fatal error state will result in container close upon attempted reconnect,\n\t\t// which is a preferable to closing abruptly when a live connection fails.\n\t\tif (reason.error?.canRetry === false) {\n\t\t\tthis.logger.sendTelemetryEvent(\n\t\t\t\t{\n\t\t\t\t\teventName: \"reconnectingDespiteFatalError\",\n\t\t\t\t\treconnectMode: this.reconnectMode,\n\t\t\t\t},\n\t\t\t\treason.error,\n\t\t\t);\n\t\t}\n\n\t\tif (this.reconnectMode === ReconnectMode.Never) {\n\t\t\t// Do not raise container error if we are closing just because we lost connection.\n\t\t\t// Those errors (like IdleDisconnect) would show up in telemetry dashboards and\n\t\t\t// are very misleading, as first initial reaction - some logic is broken.\n\t\t\tthis.props.closeHandler();\n\t\t}\n\n\t\t// If closed then we can't reconnect\n\t\tif (this._disposed || this.reconnectMode !== ReconnectMode.Enabled) {\n\t\t\treturn;\n\t\t}\n\n\t\t// If the error tells us to wait before retrying, then do so.\n\t\tconst delayMs = getRetryDelayFromError(reason.error);\n\t\tif (reason.error !== undefined && delayMs !== undefined) {\n\t\t\tthis.props.reconnectionDelayHandler(delayMs, reason.error);\n\t\t\tawait new Promise<void>((resolve) => {\n\t\t\t\tsetTimeout(resolve, delayMs);\n\t\t\t});\n\t\t}\n\n\t\t// If we believe we're offline, we assume there's no point in trying again until we at least think we're online.\n\t\t// NOTE: This isn't strictly true for drivers that don't require network (e.g. local driver). Really this logic\n\t\t// should probably live in the driver.\n\t\tawait waitForOnline();\n\n\t\tthis.triggerConnect(\n\t\t\t{\n\t\t\t\ttext:\n\t\t\t\t\treason.error !== undefined\n\t\t\t\t\t\t? \"Reconnecting due to Error\"\n\t\t\t\t\t\t: `Reconnecting due to: ${reason.text}`,\n\t\t\t\terror: reason.error,\n\t\t\t},\n\t\t\trequestedMode,\n\t\t);\n\t}\n\n\tpublic prepareMessageToSend(\n\t\tmessage: Omit<IDocumentMessage, \"clientSequenceNumber\">,\n\t): IDocumentMessage | undefined {\n\t\tif (this.readonly === true) {\n\t\t\tassert(\n\t\t\t\tthis.readOnlyInfo.readonly === true,\n\t\t\t\t0x1f0 /* \"Unexpected mismatch in readonly\" */,\n\t\t\t);\n\t\t\tconst error = new GenericError(\"deltaManagerReadonlySubmit\", undefined /* error */, {\n\t\t\t\treadonly: this.readOnlyInfo.readonly,\n\t\t\t\tforcedReadonly: this.readOnlyInfo.forced,\n\t\t\t\treadonlyPermissions: this.readOnlyInfo.permissions,\n\t\t\t\tstorageOnly: this.readOnlyInfo.storageOnly,\n\t\t\t\tstorageOnlyReason: this.readOnlyInfo.storageOnlyReason,\n\t\t\t});\n\t\t\tthis.props.closeHandler(error);\n\t\t\treturn undefined;\n\t\t}\n\n\t\t// reset clientSequenceNumber if we are using new clientId.\n\t\t// we keep info about old connection as long as possible to be able to account for all non-acked ops\n\t\t// that we pick up on next connection.\n\t\tassert(!!this.connection, 0x0e4 /* \"Lost old connection!\" */);\n\t\tif (this.lastSubmittedClientId !== this.connection?.clientId) {\n\t\t\tthis.lastSubmittedClientId = this.connection?.clientId;\n\t\t\tthis.clientSequenceNumber = 0;\n\t\t\tthis.clientSequenceNumberObserved = 0;\n\t\t}\n\n\t\tif (!isRuntimeMessage(message)) {\n\t\t\tthis.localOpsToIgnore++;\n\t\t} else {\n\t\t\tthis.localOpsToIgnore = 0;\n\t\t}\n\n\t\treturn {\n\t\t\t...message,\n\t\t\tclientSequenceNumber: ++this.clientSequenceNumber,\n\t\t};\n\t}\n\n\tpublic submitSignal(content: any, targetClientId?: string) {\n\t\tif (this.connection !== undefined) {\n\t\t\tthis.connection.submitSignal(content, targetClientId);\n\t\t} else {\n\t\t\tthis.logger.sendErrorEvent({ eventName: \"submitSignalDisconnected\" });\n\t\t}\n\t}\n\n\tpublic sendMessages(messages: IDocumentMessage[]) {\n\t\tassert(this.connected, 0x2b4 /* \"not connected on sending ops!\" */);\n\t\t// If connection is \"read\" or implicit \"read\" (got leave op for \"write\" connection),\n\t\t// then op can't make it through - we will get a nack if op is sent.\n\t\t// We can short-circuit this process.\n\t\t// Note that we also want nacks to be rare and be treated as catastrophic failures.\n\t\t// Be careful with reentrancy though - disconnected event should not be be raised in the\n\t\t// middle of the current workflow, but rather on clean stack!\n\t\tif (this.connectionMode === \"read\") {\n\t\t\tif (!this.pendingReconnect) {\n\t\t\t\tthis.pendingReconnect = true;\n\t\t\t\tPromise.resolve()\n\t\t\t\t\t.then(async () => {\n\t\t\t\t\t\tif (this.pendingReconnect) {\n\t\t\t\t\t\t\t// still valid?\n\t\t\t\t\t\t\tawait this.reconnect(\n\t\t\t\t\t\t\t\t\"write\", // connectionMode\n\t\t\t\t\t\t\t\t{ text: \"Switch to write\" }, // message\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t}\n\t\t\t\t\t})\n\t\t\t\t\t.catch(() => {});\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\n\t\tassert(!this.pendingReconnect, 0x2b5 /* \"logic error\" */);\n\n\t\tthis._outbound.push(messages);\n\t}\n\n\tpublic beforeProcessingIncomingOp(message: ISequencedDocumentMessage) {\n\t\t// if we have connection, and message is local, then we better treat is as local!\n\t\tassert(\n\t\t\tthis.clientId !== message.clientId || this.lastSubmittedClientId === message.clientId,\n\t\t\t0x0ee /* \"Not accounting local messages correctly\" */,\n\t\t);\n\n\t\tif (\n\t\t\tthis.lastSubmittedClientId !== undefined &&\n\t\t\tthis.lastSubmittedClientId === message.clientId\n\t\t) {\n\t\t\tconst clientSequenceNumber = message.clientSequenceNumber;\n\n\t\t\tassert(\n\t\t\t\tthis.clientSequenceNumberObserved < clientSequenceNumber,\n\t\t\t\t0x0ef /* \"client seq# not growing\" */,\n\t\t\t);\n\t\t\tassert(\n\t\t\t\tclientSequenceNumber <= this.clientSequenceNumber,\n\t\t\t\t0x0f0 /* \"Incoming local client seq# > generated by this client\" */,\n\t\t\t);\n\n\t\t\tthis.clientSequenceNumberObserved = clientSequenceNumber;\n\t\t}\n\n\t\tif (message.type === MessageType.ClientLeave) {\n\t\t\tconst systemLeaveMessage = message as ISequencedDocumentSystemMessage;\n\t\t\tconst clientId = JSON.parse(systemLeaveMessage.data) as string;\n\t\t\tif (clientId === this.clientId) {\n\t\t\t\t// We have been kicked out from quorum\n\t\t\t\tthis.logger.sendPerformanceEvent({ eventName: \"ReadConnectionTransition\" });\n\n\t\t\t\t// Please see #8483 for more details on why maintaining connection further as is would not work.\n\t\t\t\t// Short story - connection properties are immutable, and many processes (consensus DDSes, summarizer)\n\t\t\t\t// assume that connection stays \"write\" connection until disconnect, and act accordingly, which may\n\t\t\t\t// not work well with de-facto \"read\" connection we are in after receiving own leave op on timeout.\n\t\t\t\t// Clients need to be able to transition to \"read\" state after some time of inactivity!\n\t\t\t\t// Note - this may close container!\n\t\t\t\tthis.reconnect(\n\t\t\t\t\t\"read\", // connectionMode\n\t\t\t\t\t{ text: \"Switch to read\" }, // message\n\t\t\t\t).catch((error) => {\n\t\t\t\t\tthis.logger.sendErrorEvent({ eventName: \"SwitchToReadConnection\" }, error);\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\t}\n\n\tprivate readonly opHandler = (documentId: string, messagesArg: ISequencedDocumentMessage[]) => {\n\t\tconst messages = Array.isArray(messagesArg) ? messagesArg : [messagesArg];\n\t\tthis.props.incomingOpHandler(messages, \"opHandler\");\n\t};\n\n\tprivate readonly signalHandler = (signalsArg: ISignalMessage | ISignalMessage[]) => {\n\t\tconst signals = Array.isArray(signalsArg) ? signalsArg : [signalsArg];\n\t\tthis.props.signalHandler(signals);\n\t};\n\n\t// Always connect in write mode after getting nacked.\n\tprivate readonly nackHandler = (documentId: string, messages: INack[]) => {\n\t\tconst message = messages[0];\n\t\tif (this._readonlyPermissions === true) {\n\t\t\tthis.props.closeHandler(\n\t\t\t\tcreateWriteError(\"writeOnReadOnlyDocument\", { driverVersion: undefined }),\n\t\t\t);\n\t\t\treturn;\n\t\t}\n\n\t\tconst reconnectInfo = getNackReconnectInfo(message.content);\n\n\t\t// If the nack indicates we cannot retry, then close the container outright\n\t\tif (!reconnectInfo.canRetry) {\n\t\t\tthis.props.closeHandler(reconnectInfo);\n\t\t\treturn;\n\t\t}\n\n\t\tthis.reconnectOnError(\"write\", reconnectInfo);\n\t};\n\n\t// Connection mode is always read on disconnect/error unless the system mode was write.\n\tprivate readonly disconnectHandlerInternal = (disconnectReason: IAnyDriverError) => {\n\t\t// Note: we might get multiple disconnect calls on same socket, as early disconnect notification\n\t\t// (\"server_disconnect\", ODSP-specific) is mapped to \"disconnect\"\n\t\tthis.reconnectOnError(this.defaultReconnectionMode, disconnectReason);\n\t};\n\n\tprivate readonly errorHandler = (error: IAnyDriverError) => {\n\t\tthis.reconnectOnError(this.defaultReconnectionMode, error);\n\t};\n}\n"]}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"connectionState.js","sourceRoot":"","sources":["../src/connectionState.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,IAAY,eAuBX;AAvBD,WAAY,eAAe;IAC1B;;;;OAIG;IACH,qEAAgB,CAAA;IAEhB;;;OAGG;IACH,yFAA0B,CAAA;IAE1B;;OAEG;IACH,iEAAc,CAAA;IAEd;;OAEG;IACH,+DAAa,CAAA;AACd,CAAC,EAvBW,eAAe,+BAAf,eAAe,QAuB1B","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nexport enum ConnectionState {\n\t/**\n\t * The container is not connected to the ordering service\n\t * Note - When in this state the container may be about to reconnect,\n\t * or may remain disconnected until explicitly told to connect.\n\t */\n\tDisconnected = 0,\n\n\t/**\n\t * The container is disconnected but actively trying to establish a new connection\n\t * PLEASE NOTE that this numerical value falls out of the order you may expect for this state\n\t */\n\tEstablishingConnection = 3,\n\n\t/**\n\t * The container has an inbound connection only, and is catching up to the latest known state from the service.\n\t */\n\tCatchingUp = 1,\n\n\t/**\n\t * The container is fully connected and syncing\n\t */\n\tConnected = 2,\n}\n"]}
|