@fluidframework/container-loader 1.4.0-121020 → 2.0.0-dev-rc.1.0.0.225277

package/dist/{connectionManager.js → connectionManager.cjs}

@@ -3,21 +3,21 @@
  * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
  * Licensed under the MIT License.
  */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConnectionManager = void 0;
-const abort_controller_1 = __importDefault(require("abort-controller"));
-const common_utils_1 = require("@fluidframework/common-utils");
-const container_utils_1 = require("@fluidframework/container-utils");
+const core_interfaces_1 = require("@fluidframework/core-interfaces");
+const core_utils_1 = require("@fluidframework/core-utils");
+const client_utils_1 = require("@fluid-internal/client-utils");
+const driver_definitions_1 = require("@fluidframework/driver-definitions");
 const driver_utils_1 = require("@fluidframework/driver-utils");
 const protocol_definitions_1 = require("@fluidframework/protocol-definitions");
 const telemetry_utils_1 = require("@fluidframework/telemetry-utils");
-const contracts_1 = require("./contracts");
-const deltaQueue_1 = require("./deltaQueue");
-const MaxReconnectDelayInMs = 8000;
-const InitialReconnectDelayInMs = 1000;
+const contracts_1 = require("./contracts.cjs");
+const deltaQueue_1 = require("./deltaQueue.cjs");
+const protocol_1 = require("./protocol.cjs");
+const utils_1 = require("./utils.cjs");
+// We double this value in first try in when we calculate time to wait for in "calculateMaxWaitTime" function.
+const InitialReconnectDelayInMs = 500;
 const DefaultChunkSize = 16 * 1024;
 const fatalConnectErrorProp = { fatalConnectError: true };
 function getNackReconnectInfo(nackContent) {
@@ -30,10 +30,25 @@ function getNackReconnectInfo(nackContent) {
  * Implementation of IDocumentDeltaConnection that does not support submitting
  * or receiving ops. Used in storage-only mode.
  */
-class NoDeltaStream extends common_utils_1.TypedEventEmitter {
-    constructor() {
-        super(...arguments);
-        this.clientId = "storage-only client";
+const clientNoDeltaStream = {
+    mode: "read",
+    details: { capabilities: { interactive: true } },
+    permission: [],
+    user: { id: "storage-only client" },
+    scopes: [],
+};
+const clientIdNoDeltaStream = "storage-only client";
+class NoDeltaStream extends client_utils_1.TypedEventEmitter {
+    /**
+     * Connection which is not connected to socket.
+     * @param storageOnlyReason - Reason on why the connection to delta stream is not allowed.
+     * @param readonlyConnectionReason - reason/error if any which lead to using NoDeltaStream.
+     */
+    constructor(storageOnlyReason, readonlyConnectionReason) {
+        super();
+        this.storageOnlyReason = storageOnlyReason;
+        this.readonlyConnectionReason = readonlyConnectionReason;
+        this.clientId = clientIdNoDeltaStream;
         this.claims = {
             scopes: [protocol_definitions_1.ScopeType.DocRead],
         };
@@ -43,11 +58,12 @@ class NoDeltaStream extends common_utils_1.TypedEventEmitter {
         this.version = "";
         this.initialMessages = [];
         this.initialSignals = [];
-        this.initialClients = [];
+        this.initialClients = [
+            { client: clientNoDeltaStream, clientId: clientIdNoDeltaStream },
+        ];
         this.serviceConfiguration = {
             maxMessageSize: 0,
             blockSize: 0,
-            summary: undefined,
         };
         this.checkpointSequenceNumber = undefined;
         this._disposed = false;
@@ -66,85 +82,49 @@ class NoDeltaStream extends common_utils_1.TypedEventEmitter {
             content: { message: "Cannot submit signal with storage-only connection", code: 403 },
         });
     }
-    get disposed() { return this._disposed; }
-    dispose() { this._disposed = true; }
+    get disposed() {
+        return this._disposed;
+    }
+    dispose() {
+        this._disposed = true;
+    }
 }
+function isNoDeltaStreamConnection(connection) {
+    return connection instanceof NoDeltaStream;
+}
+const waitForOnline = async () => {
+    // Only wait if we have a strong signal that we're offline - otherwise assume we're online.
+    if (globalThis.navigator?.onLine === false && globalThis.addEventListener !== undefined) {
+        return new Promise((resolve) => {
+            const resolveAndRemoveListener = () => {
+                resolve();
+                globalThis.removeEventListener("online", resolveAndRemoveListener);
+            };
+            globalThis.addEventListener("online", resolveAndRemoveListener);
+        });
+    }
+};
 /**
  * Implementation of IConnectionManager, used by Container class
- * Implements constant connectivity to relay service, by reconnecting in case of loast connection or error.
- * Exposes various controls to influecen this process, including manual reconnects, forced read-only mode, etc.
+ * Implements constant connectivity to relay service, by reconnecting in case of lost connection or error.
+ * Exposes various controls to influence this process, including manual reconnects, forced read-only mode, etc.
  */
 class ConnectionManager {
-    constructor(serviceProvider, client, reconnectAllowed, logger, props) {
-        this.serviceProvider = serviceProvider;
-        this.client = client;
-        this.logger = logger;
-        this.props = props;
-        /** tracks host requiring read-only mode. */
-        this._forceReadonly = false;
-        /** True if there is pending (async) reconnection from "read" to "write" */
-        this.pendingReconnect = false;
-        this.clientSequenceNumber = 0;
-        this.clientSequenceNumberObserved = 0;
-        /** Counts the number of noops sent by the client which may not be acked. */
-        this.trailingNoopCount = 0;
-        this.connectFirstConnection = true;
-        this._connectionVerboseProps = {};
-        this._connectionProps = {};
-        this.closed = false;
-        this.opHandler = (documentId, messagesArg) => {
-            const messages = Array.isArray(messagesArg) ? messagesArg : [messagesArg];
-            this.props.incomingOpHandler(messages, "opHandler");
-        };
-        // Always connect in write mode after getting nacked.
-        this.nackHandler = (documentId, messages) => {
-            const message = messages[0];
-            if (this._readonlyPermissions === true) {
-                this.props.closeHandler((0, driver_utils_1.createWriteError)("writeOnReadOnlyDocument", { driverVersion: undefined }));
-                return;
-            }
-            const reconnectInfo = getNackReconnectInfo(message.content);
-            // If the nack indicates we cannot retry, then close the container outright
-            if (!reconnectInfo.canRetry) {
-                this.props.closeHandler(reconnectInfo);
-                return;
-            }
-            this.reconnectOnError("write", reconnectInfo);
-        };
-        // Connection mode is always read on disconnect/error unless the system mode was write.
-        this.disconnectHandlerInternal = (disconnectReason) => {
-            // Note: we might get multiple disconnect calls on same socket, as early disconnect notification
-            // ("server_disconnect", ODSP-specific) is mapped to "disconnect"
-            this.reconnectOnError(this.defaultReconnectionMode, disconnectReason);
-        };
-        this.errorHandler = (error) => {
-            this.reconnectOnError(this.defaultReconnectionMode, error);
-        };
-        this.clientDetails = this.client.details;
-        this.defaultReconnectionMode = this.client.mode;
-        this._reconnectMode = reconnectAllowed ? contracts_1.ReconnectMode.Enabled : contracts_1.ReconnectMode.Never;
-        // Outbound message queue. The outbound queue is represented as a queue of an array of ops. Ops contained
-        // within an array *must* fit within the maxMessageSize and are guaranteed to be ordered sequentially.
-        this._outbound = new deltaQueue_1.DeltaQueue((messages) => {
-            if (this.connection === undefined) {
-                throw new Error("Attempted to submit an outbound message without connection");
-            }
-            this.connection.submit(messages);
-        });
-        this._outbound.on("error", (error) => {
-            this.props.closeHandler((0, telemetry_utils_1.normalizeError)(error));
-        });
+    get connectionVerboseProps() {
+        return this._connectionVerboseProps;
     }
-    get connectionVerboseProps() { return this._connectionVerboseProps; }
     /**
      * The current connection mode, initially read.
      */
     get connectionMode() {
-        var _a, _b;
-        return (_b = (_a = this.connection) === null || _a === void 0 ? void 0 : _a.mode) !== null && _b !== void 0 ? _b : "read";
+        return this.connection?.mode ?? "read";
+    }
+    get connected() {
+        return this.connection !== undefined;
+    }
+    get clientId() {
+        return this.connection?.clientId;
     }
-    get connected() { return this.connection !== undefined; }
-    get clientId() { var _a; return (_a = this.connection) === null || _a === void 0 ? void 0 : _a.clientId; }
     /**
      * Automatic reconnecting enabled or disabled.
      * If set to Never, then reconnecting will never be allowed.
@@ -153,8 +133,7 @@ class ConnectionManager {
         return this._reconnectMode;
     }
     get maxMessageSize() {
-        var _a, _b, _c;
-        return (_c = (_b = (_a = this.connection) === null || _a === void 0 ? void 0 : _a.serviceConfiguration) === null || _b === void 0 ? void 0 : _b.maxMessageSize) !== null && _c !== void 0 ? _c : DefaultChunkSize;
+        return this.connection?.serviceConfiguration?.maxMessageSize ?? DefaultChunkSize;
     }
     get version() {
         if (this.connection === undefined) {
@@ -163,12 +142,10 @@ class ConnectionManager {
         return this.connection.version;
     }
     get serviceConfiguration() {
-        var _a;
-        return (_a = this.connection) === null || _a === void 0 ? void 0 : _a.serviceConfiguration;
+        return this.connection?.serviceConfiguration;
     }
     get scopes() {
-        var _a;
-        return (_a = this.connection) === null || _a === void 0 ? void 0 : _a.claims.scopes;
+        return this.connection?.claims.scopes;
     }
     get outbound() {
         return this._outbound;
@@ -176,20 +153,31 @@ class ConnectionManager {
     /**
      * Returns set of props that can be logged in telemetry that provide some insights / statistics
      * about current or last connection (if there is no connection at the moment)
-    */
+     */
     get connectionProps() {
-        if (this.connection !== undefined) {
-            return this._connectionProps;
-        }
-        else {
-            return Object.assign(Object.assign({}, this._connectionProps), { 
+        return this.connection !== undefined
+            ? this._connectionProps
+            : {
+                ...this._connectionProps,
                 // Report how many ops this client sent in last disconnected session
-                sentOps: this.clientSequenceNumber });
-        }
+                sentOps: this.clientSequenceNumber,
+            };
     }
     shouldJoinWrite() {
         // We don't have to wait for ack for topmost NoOps. So subtract those.
-        return this.clientSequenceNumberObserved < (this.clientSequenceNumber - this.trailingNoopCount);
+        const outstandingOps = this.clientSequenceNumberObserved < this.clientSequenceNumber - this.localOpsToIgnore;
+        // Previous behavior was to force write mode here only when there are outstanding ops (besides
+        // no-ops). The dirty signal from runtime should provide the same behavior, but also support
+        // stashed ops that weren't submitted to container layer yet. For safety, we want to retain the
+        // same behavior whenever dirty is false.
+        const isDirty = this.containerDirty();
+        if (outstandingOps !== isDirty) {
+            this.logger.sendTelemetryEvent({
+                eventName: "DesiredConnectionModeMismatch",
+                details: JSON.stringify({ outstandingOps, isDirty }),
+            });
+        }
+        return outstandingOps || isDirty;
     }
     /**
      * Tells if container is in read-only mode.
@@ -201,82 +189,141 @@ class ConnectionManager {
      * and do not know if user has write access to a file.
      */
     get readonly() {
-        if (this._forceReadonly) {
-            return true;
-        }
-        return this._readonlyPermissions;
+        return this.readOnlyInfo.readonly;
     }
     get readOnlyInfo() {
-        const storageOnly = this.connection !== undefined && this.connection instanceof NoDeltaStream;
+        let storageOnly = false;
+        let storageOnlyReason;
+        if (isNoDeltaStreamConnection(this.connection)) {
+            storageOnly = true;
+            storageOnlyReason = this.connection.storageOnlyReason;
+        }
         if (storageOnly || this._forceReadonly || this._readonlyPermissions === true) {
             return {
                 readonly: true,
                 forced: this._forceReadonly,
                 permissions: this._readonlyPermissions,
                 storageOnly,
+                storageOnlyReason,
             };
         }
         return { readonly: this._readonlyPermissions };
     }
-    static detailsFromConnection(connection) {
+    static detailsFromConnection(connection, reason) {
         return {
             claims: connection.claims,
             clientId: connection.clientId,
-            existing: connection.existing,
             checkpointSequenceNumber: connection.checkpointSequenceNumber,
-            get initialClients() { return connection.initialClients; },
+            get initialClients() {
+                return connection.initialClients;
+            },
             mode: connection.mode,
             serviceConfiguration: connection.serviceConfiguration,
             version: connection.version,
+            reason,
+        };
+    }
+    constructor(serviceProvider, containerDirty, client, reconnectAllowed, logger, props) {
+        this.serviceProvider = serviceProvider;
+        this.containerDirty = containerDirty;
+        this.client = client;
+        this.logger = logger;
+        this.props = props;
+        /** tracks host requiring read-only mode. */
+        this._forceReadonly = false;
+        /** True if there is pending (async) reconnection from "read" to "write" */
+        this.pendingReconnect = false;
+        this.clientSequenceNumber = 0;
+        this.clientSequenceNumberObserved = 0;
+        /** Counts the number of non-runtime ops sent by the client which may not be acked. */
+        this.localOpsToIgnore = 0;
+        this.connectFirstConnection = true;
+        this._connectionVerboseProps = {};
+        this._connectionProps = {};
+        this._disposed = false;
+        this.opHandler = (documentId, messagesArg) => {
+            const messages = Array.isArray(messagesArg) ? messagesArg : [messagesArg];
+            this.props.incomingOpHandler(messages, "opHandler");
+        };
+        this.signalHandler = (signalsArg) => {
+            const signals = Array.isArray(signalsArg) ? signalsArg : [signalsArg];
+            this.props.signalHandler(signals);
+        };
+        // Always connect in write mode after getting nacked.
+        this.nackHandler = (documentId, messages) => {
+            const message = messages[0];
+            if (this._readonlyPermissions === true) {
+                this.props.closeHandler((0, driver_utils_1.createWriteError)("writeOnReadOnlyDocument", { driverVersion: undefined }));
+                return;
+            }
+            const reconnectInfo = getNackReconnectInfo(message.content);
+            // If the nack indicates we cannot retry, then close the container outright
+            if (!reconnectInfo.canRetry) {
+                this.props.closeHandler(reconnectInfo);
+                return;
+            }
+            this.reconnectOnError("write", reconnectInfo);
         };
+        // Connection mode is always read on disconnect/error unless the system mode was write.
+        this.disconnectHandlerInternal = (disconnectReason) => {
+            // Note: we might get multiple disconnect calls on same socket, as early disconnect notification
+            // ("server_disconnect", ODSP-specific) is mapped to "disconnect"
+            this.reconnectOnError(this.defaultReconnectionMode, disconnectReason);
+        };
+        this.errorHandler = (error) => {
+            this.reconnectOnError(this.defaultReconnectionMode, error);
+        };
+        this.clientDetails = this.client.details;
+        this.defaultReconnectionMode = this.client.mode;
+        this._reconnectMode = reconnectAllowed ? contracts_1.ReconnectMode.Enabled : contracts_1.ReconnectMode.Never;
+        // Outbound message queue. The outbound queue is represented as a queue of an array of ops. Ops contained
+        // within an array *must* fit within the maxMessageSize and are guaranteed to be ordered sequentially.
+        this._outbound = new deltaQueue_1.DeltaQueue((messages) => {
+            if (this.connection === undefined) {
+                throw new Error("Attempted to submit an outbound message without connection");
+            }
+            this.connection.submit(messages);
+        });
+        this._outbound.on("error", (error) => {
+            this.props.closeHandler((0, telemetry_utils_1.normalizeError)(error));
+        });
     }
-    dispose(error) {
-        if (this.closed) {
+    dispose(error, switchToReadonly = true) {
+        if (this._disposed) {
             return;
         }
-        this.closed = true;
-        this.pendingConnection = undefined;
+        this._disposed = true;
         // Ensure that things like triggerConnect() will short circuit
         this._reconnectMode = contracts_1.ReconnectMode.Never;
         this._outbound.clear();
-        const disconnectReason = error !== undefined
-            ? `Closing DeltaManager (${error.message})`
-            : "Closing DeltaManager";
+        const disconnectReason = {
+            text: "Closing DeltaManager",
+            error,
+        };
+        const oldReadonlyValue = this.readonly;
         // This raises "disconnect" event if we have active connection.
         this.disconnectFromDeltaStream(disconnectReason);
-        // Notify everyone we are in read-only state.
-        // Useful for data stores in case we hit some critical error,
-        // to switch to a mode where user edits are not accepted
-        this.set_readonlyPermissions(true);
+        if (switchToReadonly) {
+            // Notify everyone we are in read-only state.
+            // Useful for data stores in case we hit some critical error,
+            // to switch to a mode where user edits are not accepted
+            this.set_readonlyPermissions(true, oldReadonlyValue, disconnectReason);
+        }
     }
     /**
      * Enables or disables automatic reconnecting.
      * Will throw an error if reconnectMode set to Never.
-    */
-    setAutoReconnect(mode) {
-        (0, common_utils_1.assert)(mode !== contracts_1.ReconnectMode.Never && this._reconnectMode !== contracts_1.ReconnectMode.Never, 0x278 /* "API is not supported for non-connecting or closed container" */);
+     */
+    setAutoReconnect(mode, reason) {
+        (0, core_utils_1.assert)(mode !== contracts_1.ReconnectMode.Never && this._reconnectMode !== contracts_1.ReconnectMode.Never, 0x278 /* "API is not supported for non-connecting or closed container" */);
         this._reconnectMode = mode;
         if (mode !== contracts_1.ReconnectMode.Enabled) {
             // immediately disconnect - do not rely on service eventually dropping connection.
-            this.disconnectFromDeltaStream("setAutoReconnect");
+            this.disconnectFromDeltaStream(reason);
         }
     }
     /**
-     * Sends signal to runtime (and data stores) to be read-only.
-     * Hosts may have read only views, indicating to data stores that no edits are allowed.
-     * This is independent from this._readonlyPermissions (permissions) and this.connectionMode
-     * (server can return "write" mode even when asked for "read")
-     * Leveraging same "readonly" event as runtime & data stores should behave the same in such case
-     * as in read-only permissions.
-     * But this.active can be used by some DDSes to figure out if ops can be sent
-     * (for example, read-only view still participates in code proposals / upgrades decisions)
-     *
-     * Forcing Readonly does not prevent DDS from generating ops. It is up to user code to honour
-     * the readonly flag. If ops are generated, they will accumulate locally and not be sent. If
-     * there are pending in the outbound queue, it will stop sending until force readonly is
-     * cleared.
-     *
-     * @param readonly - set or clear force readonly.
+     * {@inheritDoc Container.forceReadonly}
      */
     forceReadonly(readonly) {
         if (readonly !== this._forceReadonly) {
@@ -289,7 +336,7 @@ class ConnectionManager {
         this._forceReadonly = readonly;
         if (oldValue !== this.readonly) {
             if (this._reconnectMode === contracts_1.ReconnectMode.Never) {
-                throw new container_utils_1.UsageError("API is not supported for non-connecting or closed container");
+                throw new telemetry_utils_1.UsageError("API is not supported for non-connecting or closed container");
             }
             let reconnect = false;
             if (this.readonly === true) {
@@ -301,42 +348,40 @@ class ConnectionManager {
                     // host logic error.
                     this.logger.sendErrorEvent({ eventName: "ForceReadonlyPendingChanged" });
                 }
-                reconnect = this.disconnectFromDeltaStream("Force readonly");
+                reconnect = this.disconnectFromDeltaStream({ text: "Force readonly" });
             }
             this.props.readonlyChangeHandler(this.readonly);
             if (reconnect) {
                 // reconnect if we disconnected from before.
-                this.triggerConnect("read");
+                this.triggerConnect({ text: "Force Readonly" }, "read");
             }
         }
     }
-    set_readonlyPermissions(readonly) {
-        const oldValue = this.readonly;
-        this._readonlyPermissions = readonly;
-        if (oldValue !== this.readonly) {
-            this.props.readonlyChangeHandler(this.readonly);
+    set_readonlyPermissions(newReadonlyValue, oldReadonlyValue, readonlyConnectionReason) {
+        this._readonlyPermissions = newReadonlyValue;
+        if (oldReadonlyValue !== this.readonly) {
+            this.props.readonlyChangeHandler(this.readonly, readonlyConnectionReason);
         }
     }
-    connect(connectionMode) {
-        this.connectCore(connectionMode).catch((error) => {
-            const normalizedError = (0, telemetry_utils_1.normalizeError)(error, { props: fatalConnectErrorProp });
+    connect(reason, connectionMode) {
+        this.connectCore(reason, connectionMode).catch((e) => {
+            const normalizedError = (0, telemetry_utils_1.normalizeError)(e, { props: fatalConnectErrorProp });
             this.props.closeHandler(normalizedError);
         });
     }
-    async connectCore(connectionMode) {
-        var _a, _b;
-        (0, common_utils_1.assert)(!this.closed, 0x26a /* "not closed" */);
+    async connectCore(reason, connectionMode) {
+        (0, core_utils_1.assert)(!this._disposed, 0x26a /* "not closed" */);
         if (this.connection !== undefined) {
             return; // Connection attempt already completed successfully
         }
         let pendingConnectionMode;
         if (this.pendingConnection !== undefined) {
             pendingConnectionMode = this.pendingConnection.connectionMode;
-            this.cancelConnection(); // Throw out in-progress connection attempt in favor of new attempt
-            (0, common_utils_1.assert)(this.pendingConnection === undefined, 0x344 /* this.pendingConnection should be undefined */);
+            this.cancelConnection(reason); // Throw out in-progress connection attempt in favor of new attempt
+            (0, core_utils_1.assert)(this.pendingConnection === undefined, 0x344 /* this.pendingConnection should be undefined */);
         }
         // If there is no specified ConnectionMode, try the previous mode, if there is no previous mode use default
-        let requestedMode = (_a = connectionMode !== null && connectionMode !== void 0 ? connectionMode : pendingConnectionMode) !== null && _a !== void 0 ? _a : this.defaultReconnectionMode;
+        let requestedMode = connectionMode ?? pendingConnectionMode ?? this.defaultReconnectionMode;
         // if we have any non-acked ops from last connection, reconnect as "write".
         // without that we would connect in view-only mode, which will result in immediate
         // firing of "connected" event from Container and switch of current clientId (as tracked
@@ -346,31 +391,37 @@ class ConnectionManager {
             requestedMode = "write";
         }
         const docService = this.serviceProvider();
-        (0, common_utils_1.assert)(docService !== undefined, 0x2a7 /* "Container is not attached" */);
+        (0, core_utils_1.assert)(docService !== undefined, 0x2a7 /* "Container is not attached" */);
         let connection;
-        if (((_b = docService.policies) === null || _b === void 0 ? void 0 : _b.storageOnly) === true) {
+        if (docService.policies?.storageOnly === true) {
             connection = new NoDeltaStream();
-            this.setupNewSuccessfulConnection(connection, "read");
-            (0, common_utils_1.assert)(this.pendingConnection === undefined, 0x2b3 /* "logic error" */);
+            this.setupNewSuccessfulConnection(connection, "read", reason);
+            (0, core_utils_1.assert)(this.pendingConnection === undefined, 0x2b3 /* "logic error" */);
             return;
         }
         let delayMs = InitialReconnectDelayInMs;
         let connectRepeatCount = 0;
-        const connectStartTime = common_utils_1.performance.now();
+        const connectStartTime = client_utils_1.performance.now();
         let lastError;
-        const abortController = new abort_controller_1.default();
+        const abortController = new AbortController();
         const abortSignal = abortController.signal;
-        this.pendingConnection = { abort: () => { abortController.abort(); }, connectionMode: requestedMode };
+        this.pendingConnection = {
+            abort: () => {
+                abortController.abort();
+            },
+            connectionMode: requestedMode,
+        };
+        this.props.establishConnectionHandler(reason);
         // This loop will keep trying to connect until successful, with a delay between each iteration.
         while (connection === undefined) {
-            if (this.closed) {
+            if (this._disposed) {
                 throw new Error("Attempting to connect a closed DeltaManager");
             }
             if (abortSignal.aborted === true) {
                 this.logger.sendTelemetryEvent({
                     eventName: "ConnectionAttemptCancelled",
                     attempts: connectRepeatCount,
-                    duration: telemetry_utils_1.TelemetryLogger.formatTick(common_utils_1.performance.now() - connectStartTime),
+                    duration: (0, telemetry_utils_1.formatTick)(client_utils_1.performance.now() - connectStartTime),
                     connectionEstablished: false,
                 });
                 return;
@@ -378,17 +429,42 @@ class ConnectionManager {
             connectRepeatCount++;
             try {
                 this.client.mode = requestedMode;
-                connection = await docService.connectToDeltaStream(Object.assign(Object.assign({}, this.client), { mode: requestedMode }));
+                connection = await docService.connectToDeltaStream({
+                    ...this.client,
+                    mode: requestedMode,
+                });
                 if (connection.disposed) {
                     // Nobody observed this connection, so drop it on the floor and retry.
                     this.logger.sendTelemetryEvent({ eventName: "ReceivedClosedConnection" });
                     connection = undefined;
                 }
+                this.logger.sendTelemetryEvent({
+                    eventName: "ConnectionReceived",
+                    connected: connection !== undefined && connection.disposed === false,
+                }, undefined, core_interfaces_1.LogLevel.verbose);
             }
             catch (origError) {
-                if (typeof origError === "object" && origError !== null &&
-                    (origError === null || origError === void 0 ? void 0 : origError.errorType) === driver_utils_1.DeltaStreamConnectionForbiddenError.errorType) {
-                    connection = new NoDeltaStream();
+                this.logger.sendTelemetryEvent({
+                    eventName: "ConnectToDeltaStreamException",
+                    connected: connection !== undefined && connection.disposed === false,
+                }, undefined, core_interfaces_1.LogLevel.verbose);
+                if ((0, utils_1.isDeltaStreamConnectionForbiddenError)(origError)) {
+                    connection = new NoDeltaStream(origError.storageOnlyReason, {
+                        text: origError.message,
+                        error: origError,
+                    });
+                    requestedMode = "read";
+                    break;
+                }
+                else if ((0, telemetry_utils_1.isFluidError)(origError) &&
+                    // eslint-disable-next-line import/no-deprecated
+                    origError.errorType === driver_definitions_1.DriverErrorType.outOfStorageError) {
+                    // If we get out of storage error from calling joinsession, then use the NoDeltaStream object so
+                    // that user can at least load the container.
+                    connection = new NoDeltaStream(undefined, {
+                        text: origError.message,
+                        error: origError,
+                    });
                     requestedMode = "read";
                     break;
                 }
@@ -403,15 +479,36 @@ class ConnectionManager {
                     attempts: connectRepeatCount,
                     delay: delayMs,
                     eventName: "DeltaConnectionFailureToConnect",
-                    duration: telemetry_utils_1.TelemetryLogger.formatTick(common_utils_1.performance.now() - connectStartTime),
+                    duration: (0, telemetry_utils_1.formatTick)(client_utils_1.performance.now() - connectStartTime),
                 }, origError);
                 lastError = origError;
+                const waitStartTime = client_utils_1.performance.now();
                 const retryDelayFromError = (0, driver_utils_1.getRetryDelayFromError)(origError);
-                delayMs = retryDelayFromError !== null && retryDelayFromError !== void 0 ? retryDelayFromError : Math.min(delayMs * 2, MaxReconnectDelayInMs);
-                if (retryDelayFromError !== undefined) {
-                    this.props.reconnectionDelayHandler(retryDelayFromError, origError);
+                // If the error told us to wait or browser signals us that we are offline, then calculate the time we
+                // want to wait for before retrying. then we wait for that time. If the error didn't tell us to wait,
+                // let's still wait a little bit before retrying. We can skip this delay if we're confident we're offline,
+                // because we probably just need to wait to come back online. But we never have strong signal of being
+                // offline, so we at least wait for sometime.
+                if (retryDelayFromError !== undefined || globalThis.navigator?.onLine !== false) {
+                    delayMs = (0, driver_utils_1.calculateMaxWaitTime)(delayMs, origError);
                 }
-                await (0, driver_utils_1.waitForConnectedState)(delayMs);
+                // Raise event in case the delay was there.
+                this.props.reconnectionDelayHandler(delayMs, origError);
+                await new Promise((resolve) => {
+                    setTimeout(resolve, delayMs);
+                });
+                // If we believe we're offline, we assume there's no point in trying until we at least think we're online.
+                // NOTE: This isn't strictly true for drivers that don't require network (e.g. local driver).  Really this logic
+                // should probably live in the driver.
+                await waitForOnline();
+                this.logger.sendPerformanceEvent({
+                    eventName: "WaitBetweenConnectionAttempts",
+                    duration: client_utils_1.performance.now() - waitStartTime,
+                    details: JSON.stringify({
+                        retryDelayFromError,
+                        delayMs,
+                    }),
+                });
             }
         }
         // If we retried more than once, log an event about how long it took (this will not log to error table)
@@ -419,55 +516,61 @@ class ConnectionManager {
             (0, driver_utils_1.logNetworkFailure)(this.logger, {
                 eventName: "MultipleDeltaConnectionFailures",
                 attempts: connectRepeatCount,
-                duration: telemetry_utils_1.TelemetryLogger.formatTick(common_utils_1.performance.now() - connectStartTime),
+                duration: (0, telemetry_utils_1.formatTick)(client_utils_1.performance.now() - connectStartTime),
             }, lastError);
         }
-        // Check for abort signal after while loop as well
-        if (abortSignal.aborted === true) {
+        // Check for abort signal after while loop as well or we've been disposed
+        if (abortSignal.aborted === true || this._disposed) {
             connection.dispose();
             this.logger.sendTelemetryEvent({
                 eventName: "ConnectionAttemptCancelled",
                 attempts: connectRepeatCount,
-                duration: telemetry_utils_1.TelemetryLogger.formatTick(common_utils_1.performance.now() - connectStartTime),
+                duration: (0, telemetry_utils_1.formatTick)(client_utils_1.performance.now() - connectStartTime),
                 connectionEstablished: true,
             });
             return;
         }
-        this.setupNewSuccessfulConnection(connection, requestedMode);
+        this.setupNewSuccessfulConnection(connection, requestedMode, reason);
     }
     /**
-     * Start the connection. Any error should result in container being close.
-     * And report the error if it excape for any reason.
+     * Start the connection. Any error should result in container being closed.
+     * And report the error if it escapes for any reason.
      * @param args - The connection arguments
      */
-    triggerConnect(connectionMode) {
-        (0, common_utils_1.assert)(this.connection === undefined, 0x239 /* "called only in disconnected state" */);
+    triggerConnect(reason, connectionMode) {
+        // reconnect() includes async awaits, and that causes potential race conditions
+        // where we might already have a connection. If it were to happen, it's possible that we will connect
+        // with different mode to `connectionMode`. Glancing through the caller chains, it looks like code should be
+        // fine (if needed, reconnect flow will get triggered again). Places where new mode matters should encode it
+        // directly in connectCore - see this.shouldJoinWrite() test as an example.
+        // assert(this.connection === undefined, 0x239 /* "called only in disconnected state" */);
         if (this.reconnectMode !== contracts_1.ReconnectMode.Enabled) {
             return;
         }
-        this.connect(connectionMode);
+        this.connect(reason, connectionMode);
     }
     /**
      * Disconnect the current connection.
      * @param reason - Text description of disconnect reason to emit with disconnect event
+     * @param error - Error causing the disconnect if any.
      * @returns A boolean that indicates if there was an existing connection (or pending connection) to disconnect
      */
     disconnectFromDeltaStream(reason) {
         this.pendingReconnect = false;
         if (this.connection === undefined) {
             if (this.pendingConnection !== undefined) {
-                this.cancelConnection();
+                this.cancelConnection(reason);
                 return true;
             }
             return false;
         }
-        (0, common_utils_1.assert)(this.pendingConnection === undefined, 0x27b /* "reentrancy may result in incorrect behavior" */);
+        (0, core_utils_1.assert)(this.pendingConnection === undefined, 0x27b /* "reentrancy may result in incorrect behavior" */);
         const connection = this.connection;
         // Avoid any re-entrancy - clear object reference
         this.connection = undefined;
         // Remove listeners first so we don't try to retrigger this flow accidentally through reconnectOnError
         connection.off("op", this.opHandler);
-        connection.off("signal", this.props.signalHandler);
+        connection.off("signal", this.signalHandler);
         connection.off("nack", this.nackHandler);
         connection.off("disconnect", this.disconnectHandlerInternal);
         connection.off("error", this.errorHandler);
@@ -475,48 +578,60 @@ class ConnectionManager {
         // eslint-disable-next-line @typescript-eslint/no-floating-promises
         this._outbound.pause();
         this._outbound.clear();
-        this.props.disconnectHandler(reason);
         connection.dispose();
+        this.props.disconnectHandler(reason);
         this._connectionVerboseProps = {};
         return true;
     }
     /**
      * Cancel in-progress connection attempt.
      */
-    cancelConnection() {
-        (0, common_utils_1.assert)(this.pendingConnection !== undefined, 0x345 /* this.pendingConnection is undefined when trying to cancel */);
+    cancelConnection(reason) {
+        (0, core_utils_1.assert)(this.pendingConnection !== undefined, 0x345 /* this.pendingConnection is undefined when trying to cancel */);
         this.pendingConnection.abort();
         this.pendingConnection = undefined;
         this.logger.sendTelemetryEvent({ eventName: "ConnectionCancelReceived" });
+        this.props.cancelConnectionHandler({
+            text: `Cancel Pending Connection due to ${reason.text}`,
+            error: reason.error,
+        });
     }
     /**
      * Once we've successfully gotten a connection, we need to set up state, attach event listeners, and process
      * initial messages.
      * @param connection - The newly established connection
      */
-    setupNewSuccessfulConnection(connection, requestedMode) {
+    setupNewSuccessfulConnection(connection, requestedMode, reason) {
         // Old connection should have been cleaned up before establishing a new one
-        (0, common_utils_1.assert)(this.connection === undefined, 0x0e6 /* "old connection exists on new connection setup" */);
-        (0, common_utils_1.assert)(!connection.disposed, 0x28a /* "can't be disposed - Callers need to ensure that!" */);
+        (0, core_utils_1.assert)(this.connection === undefined, 0x0e6 /* "old connection exists on new connection setup" */);
+        (0, core_utils_1.assert)(!connection.disposed, 0x28a /* "can't be disposed - Callers need to ensure that!" */);
         this.pendingConnection = undefined;
+        const oldReadonlyValue = this.readonly;
         this.connection = connection;
         // Does information in scopes & mode matches?
         // If we asked for "write" and got "read", then file is read-only
         // But if we ask read, server can still give us write.
         const readonly = !connection.claims.scopes.includes(protocol_definitions_1.ScopeType.DocWrite);
+        if (connection.mode !== requestedMode) {
+            this.logger.sendTelemetryEvent({
+                eventName: "ConnectionModeMismatch",
+                requestedMode,
+                mode: connection.mode,
+            });
+        }
         // This connection mode validation logic is moving to the driver layer in 0.44.  These two asserts can be
         // removed after those packages have released and become ubiquitous.
-        (0, common_utils_1.assert)(requestedMode === "read" || readonly === (this.connectionMode === "read"), 0x0e7 /* "claims/connectionMode mismatch" */);
-        (0, common_utils_1.assert)(!readonly || this.connectionMode === "read", 0x0e8 /* "readonly perf with write connection" */);
-        this.set_readonlyPermissions(readonly);
-        if (this.closed) {
+        (0, core_utils_1.assert)(requestedMode === "read" || readonly === (this.connectionMode === "read"), 0x0e7 /* "claims/connectionMode mismatch" */);
+        (0, core_utils_1.assert)(!readonly || this.connectionMode === "read", 0x0e8 /* "readonly perf with write connection" */);
+        this.set_readonlyPermissions(readonly, oldReadonlyValue, isNoDeltaStreamConnection(connection) ? connection.readonlyConnectionReason : undefined);
+        if (this._disposed) {
             // Raise proper events, Log telemetry event and close connection.
-            this.disconnectFromDeltaStream("ConnectionManager already closed");
+            this.disconnectFromDeltaStream({ text: "ConnectionManager already closed" });
             return;
         }
         this._outbound.resume();
         connection.on("op", this.opHandler);
-        connection.on("signal", this.props.signalHandler);
+        connection.on("signal", this.signalHandler);
         connection.on("nack", this.nackHandler);
         connection.on("disconnect", this.disconnectHandlerInternal);
         connection.on("error", this.errorHandler);
@@ -542,7 +657,8 @@ class ConnectionManager {
         this._connectionProps.connectionMode = connection.mode;
         let last = -1;
         if (initialMessages.length !== 0) {
-            this._connectionVerboseProps.connectionInitialOpsFrom = initialMessages[0].sequenceNumber;
+            this._connectionVerboseProps.connectionInitialOpsFrom =
+                initialMessages[0].sequenceNumber;
             last = initialMessages[initialMessages.length - 1].sequenceNumber;
             this._connectionVerboseProps.connectionInitialOpsTo = last + 1;
             // Update knowledge of how far we are behind, before raising "connect" event
@@ -553,15 +669,39 @@ class ConnectionManager {
             }
         }
         this.props.incomingOpHandler(initialMessages, this.connectFirstConnection ? "InitialOps" : "ReconnectOps");
-        if (connection.initialSignals !== undefined) {
-            for (const signal of connection.initialSignals) {
-                this.props.signalHandler(signal);
-            }
-        }
-        const details = ConnectionManager.detailsFromConnection(connection);
+        const details = ConnectionManager.detailsFromConnection(connection, reason);
         details.checkpointSequenceNumber = checkpointSequenceNumber;
         this.props.connectHandler(details);
         this.connectFirstConnection = false;
+        // Synthesize clear & join signals out of initialClients state.
+        // This allows us to have single way to process signals, and makes it simpler to initialize
+        // protocol in Container.
+        const clearSignal = {
+            clientId: null,
+            content: JSON.stringify({
+                type: protocol_1.SignalType.Clear,
+            }),
+        };
+        // list of signals to process due to this new connection
+        let signalsToProcess = [clearSignal];
+        const clientJoinSignals = (connection.initialClients ?? []).map((priorClient) => ({
+            clientId: null,
+            content: JSON.stringify({
+                type: protocol_1.SignalType.ClientJoin,
+                content: priorClient, // ISignalClient
+            }),
+        }));
+        if (clientJoinSignals.length > 0) {
+            signalsToProcess = signalsToProcess.concat(clientJoinSignals);
+        }
+        // Unfortunately, there is no defined order between initialSignals (including join & leave signals)
+        // and connection.initialClients. In practice, connection.initialSignals quite often contains join signal
+        // for "self" and connection.initialClients does not contain "self", so we have to process them after
+        // "clear" signal above.
+        if (connection.initialSignals !== undefined && connection.initialSignals.length > 0) {
+            signalsToProcess = signalsToProcess.concat(connection.initialSignals);
+        }
+        this.props.signalHandler(signalsToProcess);
     }
     /**
      * Disconnect the current connection and reconnect. Closes the container if it fails.
@@ -571,8 +711,7 @@ class ConnectionManager {
      * @returns A promise that resolves when the connection is reestablished or we stop trying
      */
     reconnectOnError(requestedMode, error) {
-        this.reconnect(requestedMode, error.message, error)
-            .catch(this.props.closeHandler);
+        this.reconnect(requestedMode, { text: error.message, error }).catch(this.props.closeHandler);
     }
     /**
      * Disconnect the current connection and reconnect.
@@ -581,20 +720,20 @@ class ConnectionManager {
      * @param error - Error reconnect information including whether or not to reconnect
      * @returns A promise that resolves when the connection is reestablished or we stop trying
      */
-    async reconnect(requestedMode, disconnectMessage, error) {
+    async reconnect(requestedMode, reason) {
         // We quite often get protocol errors before / after observing nack/disconnect
         // we do not want to run through same sequence twice.
         // If we're already disconnected/disconnecting it's not appropriate to call this again.
-        (0, common_utils_1.assert)(this.connection !== undefined, 0x0eb /* "Missing connection for reconnect" */);
-        this.disconnectFromDeltaStream(disconnectMessage);
+        (0, core_utils_1.assert)(this.connection !== undefined, 0x0eb /* "Missing connection for reconnect" */);
+        this.disconnectFromDeltaStream(reason);
         // We will always trigger reconnect, even if canRetry is false.
         // Any truly fatal error state will result in container close upon attempted reconnect,
         // which is a preferable to closing abruptly when a live connection fails.
-        if (error !== undefined && !error.canRetry) {
+        if (reason.error?.canRetry === false) {
             this.logger.sendTelemetryEvent({
                 eventName: "reconnectingDespiteFatalError",
                 reconnectMode: this.reconnectMode,
-            }, error);
+            }, reason.error);
         }
         if (this.reconnectMode === contracts_1.ReconnectMode.Never) {
             // Do not raise container error if we are closing just because we lost connection.
@@ -603,25 +742,37 @@ class ConnectionManager {
             this.props.closeHandler();
         }
         // If closed then we can't reconnect
-        if (this.closed || this.reconnectMode !== contracts_1.ReconnectMode.Enabled) {
+        if (this._disposed || this.reconnectMode !== contracts_1.ReconnectMode.Enabled) {
             return;
         }
-        const delayMs = (0, driver_utils_1.getRetryDelayFromError)(error);
-        if (error !== undefined && delayMs !== undefined) {
-            this.props.reconnectionDelayHandler(delayMs, error);
-            await (0, driver_utils_1.waitForConnectedState)(delayMs);
+        // If the error tells us to wait before retrying, then do so.
+        const delayMs = (0, driver_utils_1.getRetryDelayFromError)(reason.error);
+        if (reason.error !== undefined && delayMs !== undefined) {
+            this.props.reconnectionDelayHandler(delayMs, reason.error);
+            await new Promise((resolve) => {
+                setTimeout(resolve, delayMs);
+            });
         }
-        this.triggerConnect(requestedMode);
+        // If we believe we're offline, we assume there's no point in trying again until we at least think we're online.
+        // NOTE: This isn't strictly true for drivers that don't require network (e.g. local driver).  Really this logic
+        // should probably live in the driver.
+        await waitForOnline();
+        this.triggerConnect({
+            text: reason.error !== undefined
+                ? "Reconnecting due to Error"
+                : `Reconnecting due to: ${reason.text}`,
+            error: reason.error,
+        }, requestedMode);
     }
     prepareMessageToSend(message) {
-        var _a, _b;
         if (this.readonly === true) {
-            (0, common_utils_1.assert)(this.readOnlyInfo.readonly === true, 0x1f0 /* "Unexpected mismatch in readonly" */);
-            const error = new container_utils_1.GenericError("deltaManagerReadonlySubmit", undefined /* error */, {
+            (0, core_utils_1.assert)(this.readOnlyInfo.readonly === true, 0x1f0 /* "Unexpected mismatch in readonly" */);
+            const error = new telemetry_utils_1.GenericError("deltaManagerReadonlySubmit", undefined /* error */, {
                 readonly: this.readOnlyInfo.readonly,
                 forcedReadonly: this.readOnlyInfo.forced,
                 readonlyPermissions: this.readOnlyInfo.permissions,
                 storageOnly: this.readOnlyInfo.storageOnly,
+                storageOnlyReason: this.readOnlyInfo.storageOnlyReason,
             });
             this.props.closeHandler(error);
             return undefined;
@@ -629,30 +780,33 @@ class ConnectionManager {
         // reset clientSequenceNumber if we are using new clientId.
         // we keep info about old connection as long as possible to be able to account for all non-acked ops
         // that we pick up on next connection.
-        (0, common_utils_1.assert)(!!this.connection, 0x0e4 /* "Lost old connection!" */);
-        if (this.lastSubmittedClientId !== ((_a = this.connection) === null || _a === void 0 ? void 0 : _a.clientId)) {
-            this.lastSubmittedClientId = (_b = this.connection) === null || _b === void 0 ? void 0 : _b.clientId;
+        (0, core_utils_1.assert)(!!this.connection, 0x0e4 /* "Lost old connection!" */);
+        if (this.lastSubmittedClientId !== this.connection?.clientId) {
+            this.lastSubmittedClientId = this.connection?.clientId;
             this.clientSequenceNumber = 0;
             this.clientSequenceNumberObserved = 0;
         }
-        if (message.type === protocol_definitions_1.MessageType.NoOp) {
-            this.trailingNoopCount++;
+        if (!(0, driver_utils_1.isRuntimeMessage)(message)) {
+            this.localOpsToIgnore++;
         }
         else {
-            this.trailingNoopCount = 0;
+            this.localOpsToIgnore = 0;
         }
-        return Object.assign(Object.assign({}, message), { clientSequenceNumber: ++this.clientSequenceNumber });
+        return {
+            ...message,
+            clientSequenceNumber: ++this.clientSequenceNumber,
+        };
     }
-    submitSignal(content) {
+    submitSignal(content, targetClientId) {
         if (this.connection !== undefined) {
-            this.connection.submitSignal(content);
+            this.connection.submitSignal(content, targetClientId);
         }
         else {
             this.logger.sendErrorEvent({ eventName: "submitSignalDisconnected" });
         }
     }
     sendMessages(messages) {
-        (0, common_utils_1.assert)(this.connected, 0x2b4 /* "not connected on sending ops!" */);
+        (0, core_utils_1.assert)(this.connected, 0x2b4 /* "not connected on sending ops!" */);
         // If connection is "read" or implicit "read" (got leave op for "write" connection),
         // then op can't make it through - we will get a nack if op is sent.
         // We can short-circuit this process.
@@ -662,26 +816,29 @@ class ConnectionManager {
         if (this.connectionMode === "read") {
             if (!this.pendingReconnect) {
                 this.pendingReconnect = true;
-                Promise.resolve().then(async () => {
-                    if (this.pendingReconnect) { // still valid?
+                Promise.resolve()
+                    .then(async () => {
+                    if (this.pendingReconnect) {
+                        // still valid?
                         await this.reconnect("write", // connectionMode
-                        "Switch to write");
+                        { text: "Switch to write" });
                     }
                 })
                     .catch(() => { });
             }
             return;
         }
-        (0, common_utils_1.assert)(!this.pendingReconnect, 0x2b5 /* "logic error" */);
+        (0, core_utils_1.assert)(!this.pendingReconnect, 0x2b5 /* "logic error" */);
         this._outbound.push(messages);
     }
     beforeProcessingIncomingOp(message) {
         // if we have connection, and message is local, then we better treat is as local!
-        (0, common_utils_1.assert)(this.clientId !== message.clientId || this.lastSubmittedClientId === message.clientId, 0x0ee /* "Not accounting local messages correctly" */);
-        if (this.lastSubmittedClientId !== undefined && this.lastSubmittedClientId === message.clientId) {
+        (0, core_utils_1.assert)(this.clientId !== message.clientId || this.lastSubmittedClientId === message.clientId, 0x0ee /* "Not accounting local messages correctly" */);
+        if (this.lastSubmittedClientId !== undefined &&
+            this.lastSubmittedClientId === message.clientId) {
             const clientSequenceNumber = message.clientSequenceNumber;
-            (0, common_utils_1.assert)(this.clientSequenceNumberObserved < clientSequenceNumber, 0x0ef /* "client seq# not growing" */);
-            (0, common_utils_1.assert)(clientSequenceNumber <= this.clientSequenceNumber, 0x0f0 /* "Incoming local client seq# > generated by this client" */);
+            (0, core_utils_1.assert)(this.clientSequenceNumberObserved < clientSequenceNumber, 0x0ef /* "client seq# not growing" */);
+            (0, core_utils_1.assert)(clientSequenceNumber <= this.clientSequenceNumber, 0x0f0 /* "Incoming local client seq# > generated by this client" */);
             this.clientSequenceNumberObserved = clientSequenceNumber;
         }
         if (message.type === protocol_definitions_1.MessageType.ClientLeave) {
@@ -697,7 +854,7 @@ class ConnectionManager {
                 // Clients need to be able to transition to "read" state after some time of inactivity!
                 // Note - this may close container!
                 this.reconnect("read", // connectionMode
-                "Switch to read").catch((error) => {
+                { text: "Switch to read" }).catch((error) => {
                     this.logger.sendErrorEvent({ eventName: "SwitchToReadConnection" }, error);
                 });
             }
@@ -705,4 +862,4 @@ class ConnectionManager {
     }
 }
 exports.ConnectionManager = ConnectionManager;
-//# sourceMappingURL=connectionManager.js.map
+//# sourceMappingURL=connectionManager.cjs.map