@fluidframework/container-loader 2.0.0-rc.2.0.2 → 2.0.0-rc.3.0.1

package/lib/test/connectionManager.spec.js

@@ -1,201 +0,0 @@
-/*!
- * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
- * Licensed under the MIT License.
- */
-import { strict as assert } from "assert";
-import { MockDocumentDeltaConnection, MockDocumentService } from "@fluid-private/test-loader-utils";
-import { Deferred } from "@fluidframework/core-utils";
-import { DriverErrorTypes, } from "@fluidframework/driver-definitions";
-import { NonRetryableError, RetryableError } from "@fluidframework/driver-utils";
-import { NackErrorType } from "@fluidframework/protocol-definitions";
-import { MockLogger } from "@fluidframework/telemetry-utils";
-import { ConnectionManager } from "../connectionManager.js";
-import { pkgVersion } from "../packageVersion.js";
-describe("connectionManager", () => {
-    let nextClientId = 0;
-    let _mockDeltaConnection;
-    let mockDocumentService;
-    const client = {
-        details: { capabilities: { interactive: true } },
-        mode: "write",
-    };
-    let closed = false;
-    let connectionCount = 0;
-    let connectionDeferred = new Deferred();
-    let disconnectCount = 0;
-    const props = {
-        closeHandler: (_error) => {
-            closed = true;
-        },
-        connectHandler: () => {
-            ++connectionCount;
-            assert(_mockDeltaConnection !== undefined, "When connectHandler is invoked, _mockDeltaConnection should have been set");
-            connectionDeferred.resolve(_mockDeltaConnection);
-            connectionDeferred = new Deferred();
-        },
-        disconnectHandler: () => {
-            ++disconnectCount;
-        },
-        incomingOpHandler: () => { },
-        pongHandler: () => { },
-        readonlyChangeHandler: () => { },
-        reconnectionDelayHandler: () => { },
-        signalHandler: () => { },
-        establishConnectionHandler: () => { },
-        cancelConnectionHandler: () => { },
-    };
-    const mockLogger = new MockLogger();
-    async function waitForConnection() {
-        return connectionDeferred.promise;
-    }
-    beforeEach(() => {
-        nextClientId = 0;
-        _mockDeltaConnection = undefined;
-        closed = false;
-        connectionCount = 0;
-        connectionDeferred = new Deferred();
-        disconnectCount = 0;
-        mockDocumentService = new MockDocumentService(undefined /* deltaStorageFactory */, () => {
-            _mockDeltaConnection = new MockDocumentDeltaConnection(`mock_client_${nextClientId++}`);
-            return _mockDeltaConnection;
-        });
-    });
-    function createConnectionManager() {
-        return new ConnectionManager(() => mockDocumentService, () => false, client, true /* reconnectAllowed */, mockLogger.toTelemetryLogger(), props);
-    }
-    it("reconnectOnError - exceptions invoke closeHandler", async () => {
-        // Arrange
-        const connectionManager = createConnectionManager();
-        connectionManager.connect({ text: "test:reconnectOnError" });
-        const connection = await waitForConnection();
-        // Monkey patch connection to be undefined to trigger assert in reconnectOnError
-        connectionManager.connection = undefined;
-        // Act
-        connection.emitError({
-            errorType: DriverErrorTypes.genericError,
-            message: "whatever",
-            canRetry: true,
-        });
-        await Promise.resolve(); // So we get the promise rejection that calls closeHandler
-        // Assert
-        assert(closed, "ConnectionManager should close if reconnect throws an error, e.g. hits an assert");
-    });
-    it("reconnectOnError - error, disconnect, and nack handling", async () => {
-        // Arrange
-        const connectionManager = createConnectionManager();
-        connectionManager.connect({ text: "test:reconnectOnError" });
-        let connection = await waitForConnection();
-        // Act I - retryableError
-        const error = new RetryableError("Retryable error", DriverErrorTypes.genericError, { driverVersion: pkgVersion });
-        let oldConnection = connection;
-        connection.emitError(error);
-        connection = await waitForConnection();
-        // Assert I
-        assert(oldConnection.disposed, "Old connection should be disposed after emitting an error");
-        assert.equal(connection.clientId, "mock_client_1", "New connection should have expected id");
-        assert(!closed, "Don't expect closeHandler to be called when connection emits an error");
-        assert.equal(disconnectCount, 1, "Expected 1 disconnect from emitting an error");
-        assert.equal(connectionCount, 2, "Expected 2 connections after the first emitted an error");
-        // Act II - nonretryable disconnect
-        const disconnectReason = new NonRetryableError("Fatal disconnect reason", DriverErrorTypes.genericError, { driverVersion: pkgVersion });
-        oldConnection = connection;
-        connection.emitDisconnect(disconnectReason);
-        connection = await waitForConnection();
-        // Assert II
-        assert(oldConnection.disposed, "Old connection should be disposed after emitting disconnect");
-        assert.equal(connection.clientId, "mock_client_2", "New connection should have expected id");
-        mockLogger.assertMatchAny([
-            {
-                eventName: "reconnectingDespiteFatalError",
-                reconnectMode: "Enabled",
-                error: "Fatal disconnect reason",
-                canRetry: false,
-            },
-        ]);
-        assert(!closed, "Don't expect closeHandler to be called even when connection emits a non-retryable disconnect");
-        assert.equal(disconnectCount, 2, "Expected 2 disconnects from emitting an error and disconnect");
-        assert.equal(connectionCount, 3, "Expected 3 connections after the two disconnects");
-        // Act III - nonretryable nack
-        const nack = {
-            content: { code: 403, type: NackErrorType.BadRequestError, message: "fatalNack" },
-        };
-        oldConnection = connection;
-        connection.emitNack("docId", [nack]);
-        // Assert III
-        assert(closed, "closeHandler should be called in response to 403 nack");
-        assert(!oldConnection.disposed, "connection shouldn't be disposed since mock closeHandler doesn't do it - don't expect it here after fatal nack");
-        assert(!mockLogger.matchEvents([{ eventName: "reconnectingDespiteFatalError" }]), "Should not see reconnectingDespiteFatalError event after fatal nack");
-    });
-    it("reconnectOnError - nack retryAfter", async () => {
-        const connectionManager = createConnectionManager();
-        connectionManager.connect({ text: "test:reconnectOnError" });
-        let connection = await waitForConnection();
-        const nack = {
-            content: {
-                code: 429,
-                type: NackErrorType.ThrottlingError,
-                message: "throttled",
-                retryAfter: 0.5, // 500 ms
-            },
-        };
-        connection.emitNack("docId", [nack]);
-        assert(!closed, "Don't expect closeHandler to be called with retryable Nack");
-        assert(connection.disposed, "Expect connection to be disconnected");
-        assert.strictEqual(disconnectCount, 1, "Expect 1 disconnect from emitting a Nack");
-        // Async test we aren't connected within 300 ms
-        let checkedTimeout = false;
-        setTimeout(() => {
-            assert.strictEqual(connectionCount, 1, "Expect there to still not be a connection yet");
-            checkedTimeout = true;
-        }, 300);
-        connection = await waitForConnection();
-        assert.strictEqual(connectionCount, 2, "Expect there to be a connection after waiting");
-        assert(checkedTimeout, "Expected to have checked 300ms timeout");
-    });
-    describe("readonly", () => {
-        it("default is undefined", () => {
-            const connectionManager = createConnectionManager();
-            assert.deepStrictEqual(connectionManager.readOnlyInfo, { readonly: undefined });
-        });
-        it("force readonly", () => {
-            const connectionManager = createConnectionManager();
-            connectionManager.forceReadonly(false);
-            assert.deepStrictEqual(connectionManager.readOnlyInfo, { readonly: undefined });
-            connectionManager.forceReadonly(true);
-            assert.deepStrictEqual(connectionManager.readOnlyInfo, {
-                readonly: true,
-                forced: true,
-                permissions: undefined,
-                storageOnly: false,
-                storageOnlyReason: undefined,
-            });
-        });
-        it("readonly permissions", () => {
-            const connectionManager = createConnectionManager();
-            connectionManager.set_readonlyPermissions(false);
-            assert.deepStrictEqual(connectionManager.readOnlyInfo, { readonly: false });
-            connectionManager.set_readonlyPermissions(true);
-            assert.deepStrictEqual(connectionManager.readOnlyInfo, {
-                readonly: true,
-                forced: false,
-                permissions: true,
-                storageOnly: false,
-                storageOnlyReason: undefined,
-            });
-        });
-        it("storage only", () => {
-            const connectionManager = createConnectionManager();
-            mockDocumentService.policies = { storageOnly: true };
-            assert.deepStrictEqual(connectionManager.readOnlyInfo, { readonly: undefined });
-            connectionManager.connect({ text: "test" });
-            assert.deepStrictEqual(connectionManager.readOnlyInfo, {
-                readonly: true,
-                forced: false,
-                permissions: true,
-                storageOnly: true,
-                storageOnlyReason: undefined,
-            });
-        });
-    });
-});
-//# sourceMappingURL=connectionManager.spec.js.map

package/lib/test/connectionManager.spec.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"connectionManager.spec.js","sourceRoot":"","sources":["../../src/test/connectionManager.spec.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 { strict as assert } from \"assert\";\nimport { MockDocumentDeltaConnection, MockDocumentService } from \"@fluid-private/test-loader-utils\";\nimport { Deferred } from \"@fluidframework/core-utils\";\nimport {\n\tDriverErrorTypes,\n\tIAnyDriverError,\n\tIDocumentService,\n} from \"@fluidframework/driver-definitions\";\nimport { NonRetryableError, RetryableError } from \"@fluidframework/driver-utils\";\nimport { IClient, INack, NackErrorType } from \"@fluidframework/protocol-definitions\";\nimport { MockLogger } from \"@fluidframework/telemetry-utils\";\nimport { ConnectionManager } from \"../connectionManager.js\";\nimport { IConnectionManagerFactoryArgs } from \"../contracts.js\";\nimport { pkgVersion } from \"../packageVersion.js\";\n\ndescribe(\"connectionManager\", () => {\n\tlet nextClientId = 0;\n\tlet _mockDeltaConnection: MockDocumentDeltaConnection | undefined;\n\tlet mockDocumentService: IDocumentService;\n\tconst client: Partial<IClient> = {\n\t\tdetails: { capabilities: { interactive: true } },\n\t\tmode: \"write\",\n\t};\n\tlet closed = false;\n\tlet connectionCount = 0;\n\tlet connectionDeferred = new Deferred<MockDocumentDeltaConnection>();\n\tlet disconnectCount = 0;\n\tconst props: IConnectionManagerFactoryArgs = {\n\t\tcloseHandler: (_error) => {\n\t\t\tclosed = true;\n\t\t},\n\t\tconnectHandler: () => {\n\t\t\t++connectionCount;\n\t\t\tassert(\n\t\t\t\t_mockDeltaConnection !== undefined,\n\t\t\t\t\"When connectHandler is invoked, _mockDeltaConnection should have been set\",\n\t\t\t);\n\t\t\tconnectionDeferred.resolve(_mockDeltaConnection);\n\t\t\tconnectionDeferred = new Deferred();\n\t\t},\n\t\tdisconnectHandler: () => {\n\t\t\t++disconnectCount;\n\t\t},\n\t\tincomingOpHandler: () => {},\n\t\tpongHandler: () => {},\n\t\treadonlyChangeHandler: () => {},\n\t\treconnectionDelayHandler: () => {},\n\t\tsignalHandler: () => {},\n\t\testablishConnectionHandler: () => {},\n\t\tcancelConnectionHandler: () => {},\n\t};\n\n\tconst mockLogger = new MockLogger();\n\tasync function waitForConnection() {\n\t\treturn connectionDeferred.promise;\n\t}\n\tbeforeEach(() => {\n\t\tnextClientId = 0;\n\t\t_mockDeltaConnection = undefined;\n\t\tclosed = false;\n\t\tconnectionCount = 0;\n\t\tconnectionDeferred = new Deferred<MockDocumentDeltaConnection>();\n\t\tdisconnectCount = 0;\n\t\tmockDocumentService = new MockDocumentService(undefined /* deltaStorageFactory */, () => {\n\t\t\t_mockDeltaConnection = new MockDocumentDeltaConnection(`mock_client_${nextClientId++}`);\n\t\t\treturn _mockDeltaConnection;\n\t\t});\n\t});\n\n\tfunction createConnectionManager(): ConnectionManager {\n\t\treturn new ConnectionManager(\n\t\t\t() => mockDocumentService,\n\t\t\t() => false,\n\t\t\tclient as IClient,\n\t\t\ttrue /* reconnectAllowed */,\n\t\t\tmockLogger.toTelemetryLogger(),\n\t\t\tprops,\n\t\t);\n\t}\n\n\tit(\"reconnectOnError - exceptions invoke closeHandler\", async () => {\n\t\t// Arrange\n\t\tconst connectionManager = createConnectionManager();\n\t\tconnectionManager.connect({ text: \"test:reconnectOnError\" });\n\t\tconst connection = await waitForConnection();\n\n\t\t// Monkey patch connection to be undefined to trigger assert in reconnectOnError\n\t\t(connectionManager as any).connection = undefined;\n\n\t\t// Act\n\t\tconnection.emitError({\n\t\t\terrorType: DriverErrorTypes.genericError,\n\t\t\tmessage: \"whatever\",\n\t\t\tcanRetry: true,\n\t\t});\n\t\tawait Promise.resolve(); // So we get the promise rejection that calls closeHandler\n\n\t\t// Assert\n\t\tassert(\n\t\t\tclosed,\n\t\t\t\"ConnectionManager should close if reconnect throws an error, e.g. hits an assert\",\n\t\t);\n\t});\n\n\tit(\"reconnectOnError - error, disconnect, and nack handling\", async () => {\n\t\t// Arrange\n\t\tconst connectionManager = createConnectionManager();\n\t\tconnectionManager.connect({ text: \"test:reconnectOnError\" });\n\t\tlet connection = await waitForConnection();\n\n\t\t// Act I - retryableError\n\t\tconst error: IAnyDriverError = new RetryableError(\n\t\t\t\"Retryable error\",\n\t\t\tDriverErrorTypes.genericError,\n\t\t\t{ driverVersion: pkgVersion },\n\t\t);\n\t\tlet oldConnection = connection;\n\t\tconnection.emitError(error);\n\t\tconnection = await waitForConnection();\n\n\t\t// Assert I\n\t\tassert(oldConnection.disposed, \"Old connection should be disposed after emitting an error\");\n\t\tassert.equal(\n\t\t\tconnection.clientId,\n\t\t\t\"mock_client_1\",\n\t\t\t\"New connection should have expected id\",\n\t\t);\n\t\tassert(!closed, \"Don't expect closeHandler to be called when connection emits an error\");\n\t\tassert.equal(disconnectCount, 1, \"Expected 1 disconnect from emitting an error\");\n\t\tassert.equal(connectionCount, 2, \"Expected 2 connections after the first emitted an error\");\n\n\t\t// Act II - nonretryable disconnect\n\t\tconst disconnectReason: IAnyDriverError = new NonRetryableError(\n\t\t\t\"Fatal disconnect reason\",\n\t\t\tDriverErrorTypes.genericError,\n\t\t\t{ driverVersion: pkgVersion },\n\t\t);\n\t\toldConnection = connection;\n\t\tconnection.emitDisconnect(disconnectReason);\n\t\tconnection = await waitForConnection();\n\n\t\t// Assert II\n\t\tassert(\n\t\t\toldConnection.disposed,\n\t\t\t\"Old connection should be disposed after emitting disconnect\",\n\t\t);\n\t\tassert.equal(\n\t\t\tconnection.clientId,\n\t\t\t\"mock_client_2\",\n\t\t\t\"New connection should have expected id\",\n\t\t);\n\t\tmockLogger.assertMatchAny([\n\t\t\t{\n\t\t\t\teventName: \"reconnectingDespiteFatalError\",\n\t\t\t\treconnectMode: \"Enabled\",\n\t\t\t\terror: \"Fatal disconnect reason\",\n\t\t\t\tcanRetry: false,\n\t\t\t},\n\t\t]);\n\t\tassert(\n\t\t\t!closed,\n\t\t\t\"Don't expect closeHandler to be called even when connection emits a non-retryable disconnect\",\n\t\t);\n\t\tassert.equal(\n\t\t\tdisconnectCount,\n\t\t\t2,\n\t\t\t\"Expected 2 disconnects from emitting an error and disconnect\",\n\t\t);\n\t\tassert.equal(connectionCount, 3, \"Expected 3 connections after the two disconnects\");\n\n\t\t// Act III - nonretryable nack\n\t\tconst nack: Partial<INack> = {\n\t\t\tcontent: { code: 403, type: NackErrorType.BadRequestError, message: \"fatalNack\" },\n\t\t};\n\t\toldConnection = connection;\n\t\tconnection.emitNack(\"docId\", [nack]);\n\n\t\t// Assert III\n\t\tassert(closed, \"closeHandler should be called in response to 403 nack\");\n\t\tassert(\n\t\t\t!oldConnection.disposed,\n\t\t\t\"connection shouldn't be disposed since mock closeHandler doesn't do it - don't expect it here after fatal nack\",\n\t\t);\n\t\tassert(\n\t\t\t!mockLogger.matchEvents([{ eventName: \"reconnectingDespiteFatalError\" }]),\n\t\t\t\"Should not see reconnectingDespiteFatalError event after fatal nack\",\n\t\t);\n\t});\n\n\tit(\"reconnectOnError - nack retryAfter\", async () => {\n\t\tconst connectionManager = createConnectionManager();\n\t\tconnectionManager.connect({ text: \"test:reconnectOnError\" });\n\t\tlet connection = await waitForConnection();\n\n\t\tconst nack: Partial<INack> = {\n\t\t\tcontent: {\n\t\t\t\tcode: 429,\n\t\t\t\ttype: NackErrorType.ThrottlingError,\n\t\t\t\tmessage: \"throttled\",\n\t\t\t\tretryAfter: 0.5, // 500 ms\n\t\t\t},\n\t\t};\n\t\tconnection.emitNack(\"docId\", [nack]);\n\n\t\tassert(!closed, \"Don't expect closeHandler to be called with retryable Nack\");\n\t\tassert(connection.disposed, \"Expect connection to be disconnected\");\n\t\tassert.strictEqual(disconnectCount, 1, \"Expect 1 disconnect from emitting a Nack\");\n\n\t\t// Async test we aren't connected within 300 ms\n\t\tlet checkedTimeout = false;\n\t\tsetTimeout(() => {\n\t\t\tassert.strictEqual(connectionCount, 1, \"Expect there to still not be a connection yet\");\n\t\t\tcheckedTimeout = true;\n\t\t}, 300);\n\n\t\tconnection = await waitForConnection();\n\t\tassert.strictEqual(connectionCount, 2, \"Expect there to be a connection after waiting\");\n\t\tassert(checkedTimeout, \"Expected to have checked 300ms timeout\");\n\t});\n\n\tdescribe(\"readonly\", () => {\n\t\tit(\"default is undefined\", () => {\n\t\t\tconst connectionManager = createConnectionManager();\n\t\t\tassert.deepStrictEqual(connectionManager.readOnlyInfo, { readonly: undefined });\n\t\t});\n\n\t\tit(\"force readonly\", () => {\n\t\t\tconst connectionManager = createConnectionManager();\n\n\t\t\tconnectionManager.forceReadonly(false);\n\t\t\tassert.deepStrictEqual(connectionManager.readOnlyInfo, { readonly: undefined });\n\n\t\t\tconnectionManager.forceReadonly(true);\n\t\t\tassert.deepStrictEqual(connectionManager.readOnlyInfo, {\n\t\t\t\treadonly: true,\n\t\t\t\tforced: true,\n\t\t\t\tpermissions: undefined,\n\t\t\t\tstorageOnly: false,\n\t\t\t\tstorageOnlyReason: undefined,\n\t\t\t});\n\t\t});\n\n\t\tit(\"readonly permissions\", () => {\n\t\t\tconst connectionManager = createConnectionManager();\n\n\t\t\t(connectionManager as any).set_readonlyPermissions(false);\n\t\t\tassert.deepStrictEqual(connectionManager.readOnlyInfo, { readonly: false });\n\n\t\t\t(connectionManager as any).set_readonlyPermissions(true);\n\t\t\tassert.deepStrictEqual(connectionManager.readOnlyInfo, {\n\t\t\t\treadonly: true,\n\t\t\t\tforced: false,\n\t\t\t\tpermissions: true,\n\t\t\t\tstorageOnly: false,\n\t\t\t\tstorageOnlyReason: undefined,\n\t\t\t});\n\t\t});\n\n\t\tit(\"storage only\", () => {\n\t\t\tconst connectionManager = createConnectionManager();\n\t\t\tmockDocumentService.policies = { storageOnly: true };\n\n\t\t\tassert.deepStrictEqual(connectionManager.readOnlyInfo, { readonly: undefined });\n\n\t\t\tconnectionManager.connect({ text: \"test\" });\n\t\t\tassert.deepStrictEqual(connectionManager.readOnlyInfo, {\n\t\t\t\treadonly: true,\n\t\t\t\tforced: false,\n\t\t\t\tpermissions: true, // storageOnly also implies client does not have write permissions\n\t\t\t\tstorageOnly: true,\n\t\t\t\tstorageOnlyReason: undefined,\n\t\t\t});\n\t\t});\n\t});\n});\n"]}