@fluidframework/azure-end-to-end-tests 2.53.1 → 2.61.0-355054

package/lib/test/multiprocess/presenceTest.spec.js

@@ -3,8 +3,38 @@
  * Licensed under the MIT License.
  */
 import { strict as assert } from "node:assert";
-import { fork } from "node:child_process";
+import inspector from "node:inspector";
 import { timeoutAwait, timeoutPromise } from "@fluidframework/test-utils/internal";
+import { connectAndListenForAttendees, connectAndWaitForAttendees, connectChildProcesses, forkChildProcesses, getLatestMapValueResponses, getLatestValueResponses, registerWorkspaceOnChildren, testConsole, waitForLatestMapValueUpdates, waitForLatestValueUpdates, } from "./orchestratorUtils.js";
+const useAzure = process.env.FLUID_CLIENT === "azure";
+/**
+ * Detects if the debugger is attached (when code loaded).
+ */
+const debuggerAttached = inspector.url() !== undefined;
+/**
+ * Set this to a high number when debugging to avoid timeouts from debugging time.
+ */
+const timeoutMultiplier = debuggerAttached ? 1000 : useAzure ? 3 : 1;
+/**
+ * Sets the timeout for the given test context.
+ *
+ * @remarks
+ * If a debugger is attached, the timeout is set to 0 to prevent timeouts during debugging.
+ * Otherwise, it sets the timeout to the maximum of the current timeout and the specified duration.
+ *
+ * @param context - The Mocha test context.
+ * @param duration - The duration in milliseconds to set the timeout to. Zero disables the timeout.
+ */
+function setTimeout(context, duration) {
+    const currentTimeout = context.timeout();
+    const newTimeout = debuggerAttached || currentTimeout === 0 || duration === 0
+        ? 0
+        : Math.max(currentTimeout, duration);
+    if (newTimeout !== currentTimeout) {
+        testConsole.log(`${context.test?.title}: setting timeout to ${newTimeout}ms (was ${currentTimeout}ms)`);
+        context.timeout(newTimeout);
+    }
+}
 /**
  * This test suite is a prototype for a multi-process end to end test for Fluid using the new Presence API on AzureClient.
  * In the future we hope to expand and generalize this pattern to broadly test more Fluid features.
@@ -22,7 +52,7 @@ import { timeoutAwait, timeoutPromise } from "@fluidframework/test-utils/interna
  * - Receive response messages from child clients to verify expected behavior.
  * - Clean up child processes after each test.
  *
- * The child processes are located in the `childClient.ts` file. Each child process simulates a Fluid client.
+ * The child processes are located in the `childClient.tool.ts` file. Each child process simulates a Fluid client.
  *
  * The child client's job includes:
  * - Create/Get + connect to Fluid container.
@@ -30,165 +60,6 @@ import { timeoutAwait, timeoutPromise } from "@fluidframework/test-utils/interna
  * - Perform the requested action.
  * - Send response messages including any relevant data back to the orchestrator to verify expected behavior.
  */
-/**
- * Fork child processes to simulate multiple Fluid clients.
- *
- * @remarks
- * Individual child processes may be scheduled concurrently on a multi-core CPU
- * and separate processes will never share a port when connected to a service.
- *
- * @param numProcesses - The number of child processes to fork.
- * @param cleanUpAccumulator - An array to accumulate cleanup functions for
- * each child process. This is build per instance to accommodate any errors
- * that might occur before completing all forking.
- *
- * @returns A promise that resolves with an object containing the child
- * processes and a promise that rejects on any child process errors.
- */
-async function forkChildProcesses(numProcesses, cleanUpAccumulator) {
-    const children = [];
-    const childReadyPromises = [];
-    // Collect all child process error promises into this array
-    const childErrorPromises = [];
-    // Fork child processes
-    for (let i = 0; i < numProcesses; i++) {
-        const child = fork("./lib/test/multiprocess/childClient.js", [
-            `child${i}` /* identifier passed to child process */,
-        ]);
-        // Register a cleanup function to kill the child process
-        cleanUpAccumulator.push(() => {
-            child.kill();
-            child.removeAllListeners();
-        });
-        const readyPromise = new Promise((resolve, reject) => {
-            child.once("message", (msg) => {
-                if (msg.event === "ack") {
-                    resolve();
-                }
-                else {
-                    reject(new Error(`Unexpected (non-"ack") message from child${i}: ${JSON.stringify(msg)}`));
-                }
-            });
-        });
-        childReadyPromises.push(readyPromise);
-        const errorPromise = new Promise((_, reject) => {
-            child.on("error", (error) => {
-                reject(new Error(`Child${i} process errored: ${error.message}`));
-            });
-        });
-        childErrorPromises.push(errorPromise);
-        child.send({ command: "ping" });
-        children.push(child);
-    }
-    // This race will be used to reject any of the following tests on any child process errors
-    const childErrorPromise = Promise.race(childErrorPromises);
-    // All children are always expected to connect successfully and acknowledge the ping.
-    await Promise.race([Promise.all(childReadyPromises), childErrorPromise]);
-    return {
-        children,
-        childErrorPromise,
-    };
-}
-function composeConnectMessage(id) {
-    return {
-        command: "connect",
-        user: {
-            id: `test-user-id-${id}`,
-            name: `test-user-name-${id}`,
-        },
-    };
-}
-async function connectChildProcesses(childProcesses, readyTimeoutMs) {
-    if (childProcesses.length === 0) {
-        throw new Error("No child processes provided for connection.");
-    }
-    const firstChild = childProcesses[0];
-    const containerReadyPromise = new Promise((resolve, reject) => {
-        firstChild.once("message", (msg) => {
-            if (msg.event === "connected" && msg.containerId) {
-                resolve({
-                    containerCreatorAttendeeId: msg.attendeeId,
-                    containerId: msg.containerId,
-                });
-            }
-            else {
-                reject(new Error(`Non-connected message from child0: ${JSON.stringify(msg)}`));
-            }
-        });
-    });
-    {
-        firstChild.send(composeConnectMessage(0));
-    }
-    const { containerCreatorAttendeeId, containerId } = await timeoutAwait(containerReadyPromise, {
-        durationMs: readyTimeoutMs,
-        errorMsg: "did not receive 'connected' from child process",
-    });
-    const attendeeIdPromises = [];
-    for (const [index, child] of childProcesses.entries()) {
-        if (index === 0) {
-            // The first child process is the container creator, it has already sent the 'connected' message.
-            attendeeIdPromises.push(Promise.resolve(containerCreatorAttendeeId));
-            continue;
-        }
-        const message = composeConnectMessage(index);
-        // For subsequent children, send containerId but do not wait for a response.
-        message.containerId = containerId;
-        attendeeIdPromises.push(new Promise((resolve, reject) => {
-            child.once("message", (msg) => {
-                if (msg.event === "connected") {
-                    resolve(msg.attendeeId);
-                }
-                else if (msg.event === "error") {
-                    reject(new Error(`Child process error: ${msg.error}`));
-                }
-            });
-        }));
-        child.send(message);
-    }
-    if (containerCreatorAttendeeId === undefined) {
-        throw new Error("No container creator session ID received from child processes.");
-    }
-    return { containerCreatorAttendeeId, attendeeIdPromises };
-}
-/**
- * Connects the child processes and waits for the specified number of attendees to connect.
- * @remarks
- * This function can be used directly as a test. Comments in the functionality describe the
- * breakdown of test blocks.
- *
- * @param children - Array of child processes to connect.
- * @param attendeeCountRequired - The number of attendees that must connect.
- * @param childConnectTimeoutMs - Timeout duration for child process connections.
- * @param attendeesJoinedTimeoutMs - Timeout duration for required attendees to join.
- * @param earlyExitPromise - Promise that resolves/rejects when the test should early exit.
- */
-async function connectAndWaitForAttendees(children, attendeeCountRequired, childConnectTimeoutMs, attendeesJoinedTimeoutMs, earlyExitPromise = Promise.resolve()) {
-    // Setup
-    const attendeeConnectedPromise = new Promise((resolve) => {
-        let attendeesJoinedEvents = 0;
-        children[0].on("message", (msg) => {
-            if (msg.event === "attendeeConnected") {
-                attendeesJoinedEvents++;
-                if (attendeesJoinedEvents >= attendeeCountRequired) {
-                    resolve();
-                }
-            }
-        });
-    });
-    // Act - connect all child processes
-    const connectResult = await connectChildProcesses(children, childConnectTimeoutMs);
-    Promise.all(connectResult.attendeeIdPromises)
-        .then(() => console.log("All attendees connected."))
-        .catch((error) => {
-        console.error("Error connecting children:", error);
-    });
-    // Verify - wait for all 'attendeeConnected' events
-    await timeoutAwait(Promise.race([attendeeConnectedPromise, earlyExitPromise]), {
-        durationMs: attendeesJoinedTimeoutMs,
-        errorMsg: "did not receive all 'attendeeConnected' events",
-    });
-    return connectResult;
-}
 /**
  * This particular test suite tests the following E2E functionality for Presence:
  * - Announce 'attendeeConnected' when remote client joins session.
@@ -208,38 +79,282 @@ describe(`Presence with AzureClient`, () => {
     // TODO: AB#45620: "Presence: perf: update Join pattern for scale" may help, then remove .slice.
     for (const numClients of numClientsForAttendeeTests.slice(0, 2)) {
         assert(numClients > 1, "Must have at least two clients");
-        // Timeout duration used when waiting for response messages from child processes.
-        const childConnectTimeoutMs = 1000 * numClients;
-        const allConnectedTimeoutMs = 2000;
-        it(`announces 'attendeeConnected' when remote client joins session [${numClients} clients]`, async () => {
-            // Setup
-            const { children, childErrorPromise } = await forkChildProcesses(numClients, afterCleanUp);
-            // Further Setup with Act and Verify
-            await connectAndWaitForAttendees(children, numClients - 1, childConnectTimeoutMs, allConnectedTimeoutMs, childErrorPromise);
+        /**
+         * Timeout for child processes to connect to container ({@link ConnectedEvent})
+         */
+        const childConnectTimeoutMs = 1000 * numClients * timeoutMultiplier;
+        /**
+         * Timeout for presence attendees to connect {@link AttendeeConnectedEvent}
+         */
+        const allAttendeesJoinedTimeoutMs = (1000 + 200 * numClients) * timeoutMultiplier;
+        for (const writeClients of [numClients, 1]) {
+            it(`announces 'attendeeConnected' when remote client joins session [${numClients} clients, ${writeClients} writers]`, async function () {
+                setTimeout(this, childConnectTimeoutMs + allAttendeesJoinedTimeoutMs + 1000);
+                // Setup
+                const { children, childErrorPromise } = await forkChildProcesses(numClients, afterCleanUp);
+                // Further Setup with Act and Verify
+                await connectAndWaitForAttendees(children, {
+                    writeClients,
+                    attendeeCountRequired: numClients - 1,
+                    childConnectTimeoutMs,
+                    allAttendeesJoinedTimeoutMs,
+                }, childErrorPromise);
+            });
+            it(`announces 'attendeeDisconnected' when remote client disconnects [${numClients} clients, ${writeClients} writers]`, async function () {
+                // TODO: AB#45620: "Presence: perf: update Join pattern for scale" can handle
+                // larger counts of read-only attendees. Without protocol changes tests with
+                // 20+ attendees exceed current limits.
+                if (numClients >= 20 && writeClients === 1) {
+                    this.skip();
+                }
+                const childDisconnectTimeoutMs = 10_000 * timeoutMultiplier;
+                setTimeout(this, childConnectTimeoutMs +
+                    allAttendeesJoinedTimeoutMs +
+                    childDisconnectTimeoutMs +
+                    1000);
+                // Setup
+                const { children, childErrorPromise } = await forkChildProcesses(numClients, afterCleanUp);
+                const connectResult = await connectAndListenForAttendees(children, {
+                    writeClients,
+                    attendeeCountRequired: numClients - 1,
+                    childConnectTimeoutMs,
+                });
+                // Wait for all attendees to be fully joined
+                // Keep a tally for debuggability
+                let childrenFullyJoined = 0;
+                const allAttendeesFullyJoined = Promise.all(
+                // eslint-disable-next-line @typescript-eslint/promise-function-async
+                connectResult.attendeeCountRequiredPromises.map((attendeeFullyJoinedPromise) => attendeeFullyJoinedPromise.then(() => childrenFullyJoined++)));
+                await timeoutAwait(allAttendeesFullyJoined, {
+                    durationMs: allAttendeesJoinedTimeoutMs,
+                    errorMsg: "Not all attendees fully joined",
+                }).catch((error) => {
+                    // Ideally this information would just be in the timeout error message, but that
+                    // must be a resolved string (not dynamic). So, just log it separately.
+                    testConsole.log(`${childrenFullyJoined} attendees fully joined before error...`);
+                    throw error;
+                });
+                const waitForDisconnected = children.map(async (child, index) => index === 0
+                    ? Promise.resolve()
+                    : timeoutPromise((resolve) => {
+                        child.on("message", (msg) => {
+                            if (msg.event === "attendeeDisconnected" &&
+                                msg.attendeeId === connectResult.containerCreatorAttendeeId) {
+                                console.log(`Child[${index}] saw creator disconnect`);
+                                resolve();
+                            }
+                        });
+                    }, {
+                        durationMs: childDisconnectTimeoutMs,
+                        errorMsg: `Attendee[${index}] Disconnected Timeout`,
+                    }));
+                // Act - disconnect first child process
+                children[0].send({ command: "disconnectSelf" });
+                // Verify - wait for all 'attendeeDisconnected' events
+                await Promise.race([Promise.all(waitForDisconnected), childErrorPromise]);
+            });
+        }
+    }
+    {
+        /**
+         * Timeout for workspace registration {@link WorkspaceRegisteredEvent}
+         */
+        const workspaceRegisterTimeoutMs = 5000;
+        /**
+         * Timeout for presence update events {@link LatestMapValueUpdatedEvent} and {@link LatestValueUpdatedEvent}
+         */
+        const stateUpdateTimeoutMs = 5000;
+        /**
+         * Timeout for {@link LatestMapValueGetResponseEvent} and {@link LatestValueGetResponseEvent}
+         */
+        const getStateTimeoutMs = 5000;
+        // This test suite focuses on the synchronization of Latest state between clients.
+        // NOTE: For testing purposes child clients will expect a Latest value of type string.
+        describe(`using Latest state object`, () => {
+            for (const numClients of [5, 20]) {
+                assert(numClients > 1, "Must have at least two clients");
+                /**
+                 * Timeout for child processes to connect to container ({@link ConnectedEvent})
+                 */
+                const childConnectTimeoutMs = 1000 * numClients * timeoutMultiplier;
+                let children;
+                let childErrorPromise;
+                let containerCreatorAttendeeId;
+                let attendeeIdPromises;
+                let remoteClients;
+                const testValue = "testValue";
+                const workspaceId = "presenceTestWorkspace";
+                beforeEach(async () => {
+                    ({ children, childErrorPromise } = await forkChildProcesses(numClients, afterCleanUp));
+                    ({ containerCreatorAttendeeId, attendeeIdPromises } = await connectChildProcesses(children, { writeClients: numClients, readyTimeoutMs: childConnectTimeoutMs }));
+                    await Promise.all(attendeeIdPromises);
+                    remoteClients = children.filter((_, index) => index !== 0);
+                    // NOTE: For testing purposes child clients will expect a Latest value of type string (StateFactory.latest<{ value: string }>).
+                    await registerWorkspaceOnChildren(children, workspaceId, {
+                        latest: true,
+                        timeoutMs: workspaceRegisterTimeoutMs,
+                    });
+                });
+                it(`allows clients to read Latest state from other clients [${numClients} clients]`, async () => {
+                    // Setup
+                    const updateEventsPromise = waitForLatestValueUpdates(remoteClients, workspaceId, childErrorPromise, stateUpdateTimeoutMs, { fromAttendeeId: containerCreatorAttendeeId, expectedValue: testValue });
+                    // Act - Trigger the update
+                    children[0].send({
+                        command: "setLatestValue",
+                        workspaceId,
+                        value: testValue,
+                    });
+                    const updateEvents = await updateEventsPromise;
+                    // Verify all events are from the expected attendee
+                    for (const updateEvent of updateEvents) {
+                        assert.strictEqual(updateEvent.attendeeId, containerCreatorAttendeeId);
+                        assert.deepStrictEqual(updateEvent.value, testValue);
+                    }
+                    // Act - Request each remote client to read latest state from container creator
+                    for (const child of remoteClients) {
+                        child.send({
+                            command: "getLatestValue",
+                            workspaceId,
+                            attendeeId: containerCreatorAttendeeId,
+                        });
+                    }
+                    const getResponses = await getLatestValueResponses(remoteClients, workspaceId, childErrorPromise, getStateTimeoutMs);
+                    // Verify - all responses should contain the expected value
+                    for (const getResponse of getResponses) {
+                        assert.deepStrictEqual(getResponse.value, testValue);
+                    }
+                });
+            }
         });
-        it(`announces 'attendeeDisconnected' when remote client disconnects [${numClients} clients]`, async () => {
-            // Setup
-            const { children, childErrorPromise } = await forkChildProcesses(numClients, afterCleanUp);
-            const connectResult = await connectAndWaitForAttendees(children, numClients - 1, childConnectTimeoutMs, allConnectedTimeoutMs, childErrorPromise);
-            const childDisconnectTimeoutMs = 10_000;
-            const waitForDisconnected = children.map(async (child, index) => index === 0
-                ? Promise.resolve()
-                : timeoutPromise((resolve) => {
-                    child.on("message", (msg) => {
-                        if (msg.event === "attendeeDisconnected" &&
-                            msg.attendeeId === connectResult.containerCreatorAttendeeId) {
-                            console.log(`Child[${index}] saw creator disconnect`);
-                            resolve();
-                        }
+        // This test suite focuses on the synchronization of LatestMap state between clients.
+        // NOTE: For testing purposes child clients will expect a LatestMap value of type Record<string, string | number>.
+        describe(`using LatestMap state object`, () => {
+            for (const numClients of [5, 20]) {
+                assert(numClients > 1, "Must have at least two clients");
+                /**
+                 * Timeout for child processes to connect to container ({@link ConnectedEvent})
+                 */
+                const childConnectTimeoutMs = 1000 * numClients * timeoutMultiplier;
+                let children;
+                let childErrorPromise;
+                let containerCreatorAttendeeId;
+                let attendeeIdPromises;
+                let remoteClients;
+                const workspaceId = "presenceTestWorkspace";
+                const key1 = "player1";
+                const key2 = "player2";
+                const value1 = { name: "Alice", score: 100 };
+                const value2 = { name: "Bob", score: 200 };
+                beforeEach(async () => {
+                    ({ children, childErrorPromise } = await forkChildProcesses(numClients, afterCleanUp));
+                    ({ containerCreatorAttendeeId, attendeeIdPromises } = await connectChildProcesses(children, { writeClients: numClients, readyTimeoutMs: childConnectTimeoutMs }));
+                    await Promise.all(attendeeIdPromises);
+                    remoteClients = children.filter((_, index) => index !== 0);
+                    // NOTE: For testing purposes child clients will expect a LatestMap value of type Record<string, string | number> (StateFactory.latestMap<{ value: Record<string, string | number> }, string>).
+                    await registerWorkspaceOnChildren(children, workspaceId, {
+                        latestMap: true,
+                        timeoutMs: workspaceRegisterTimeoutMs,
                     });
-                }, {
-                    durationMs: childDisconnectTimeoutMs,
-                    errorMsg: `Attendee[${index}] Disconnected Timeout`,
-                }));
-            // Act - disconnect first child process
-            children[0].send({ command: "disconnectSelf" });
-            // Verify - wait for all 'attendeeDisconnected' events
-            await Promise.race([Promise.all(waitForDisconnected), childErrorPromise]);
+                });
+                it(`allows clients to read LatestMap values from other clients [${numClients} clients]`, async () => {
+                    // Setup
+                    const testKey = "cursor";
+                    const testValue = { x: 150, y: 300 };
+                    const updateEventsPromise = waitForLatestMapValueUpdates(remoteClients, workspaceId, testKey, childErrorPromise, stateUpdateTimeoutMs, { fromAttendeeId: containerCreatorAttendeeId, expectedValue: testValue });
+                    // Act
+                    children[0].send({
+                        command: "setLatestMapValue",
+                        workspaceId,
+                        key: testKey,
+                        value: testValue,
+                    });
+                    const updateEvents = await updateEventsPromise;
+                    // Check all events are from the expected attendee
+                    for (const updateEvent of updateEvents) {
+                        assert.strictEqual(updateEvent.attendeeId, containerCreatorAttendeeId);
+                        assert.strictEqual(updateEvent.key, testKey);
+                        assert.deepStrictEqual(updateEvent.value, testValue);
+                    }
+                    for (const child of remoteClients) {
+                        child.send({
+                            command: "getLatestMapValue",
+                            workspaceId,
+                            key: testKey,
+                            attendeeId: containerCreatorAttendeeId,
+                        });
+                    }
+                    const getResponses = await getLatestMapValueResponses(remoteClients, workspaceId, testKey, childErrorPromise, getStateTimeoutMs);
+                    // Verify
+                    for (const getResponse of getResponses) {
+                        assert.deepStrictEqual(getResponse.value, testValue);
+                    }
+                });
+                it(`returns per-key values on read [${numClients} clients]`, async () => {
+                    // Setup
+                    const allAttendeeIds = await Promise.all(attendeeIdPromises);
+                    const attendee0Id = containerCreatorAttendeeId;
+                    const attendee1Id = allAttendeeIds[1];
+                    const key1Recipients = children.filter((_, index) => index !== 0);
+                    const key2Recipients = children.filter((_, index) => index !== 1);
+                    const key1UpdateEventsPromise = waitForLatestMapValueUpdates(key1Recipients, workspaceId, key1, childErrorPromise, stateUpdateTimeoutMs, { fromAttendeeId: attendee0Id, expectedValue: value1 });
+                    const key2UpdateEventsPromise = waitForLatestMapValueUpdates(key2Recipients, workspaceId, key2, childErrorPromise, stateUpdateTimeoutMs, { fromAttendeeId: attendee1Id, expectedValue: value2 });
+                    // Act
+                    children[0].send({
+                        command: "setLatestMapValue",
+                        workspaceId,
+                        key: key1,
+                        value: value1,
+                    });
+                    const key1UpdateEvents = await key1UpdateEventsPromise;
+                    children[1].send({
+                        command: "setLatestMapValue",
+                        workspaceId,
+                        key: key2,
+                        value: value2,
+                    });
+                    const key2UpdateEvents = await key2UpdateEventsPromise;
+                    // Verify all events are from the expected attendees
+                    for (const updateEvent of key1UpdateEvents) {
+                        assert.strictEqual(updateEvent.attendeeId, attendee0Id);
+                        assert.strictEqual(updateEvent.key, key1);
+                        assert.deepStrictEqual(updateEvent.value, value1);
+                    }
+                    for (const updateEvent of key2UpdateEvents) {
+                        assert.strictEqual(updateEvent.attendeeId, attendee1Id);
+                        assert.strictEqual(updateEvent.key, key2);
+                        assert.deepStrictEqual(updateEvent.value, value2);
+                    }
+                    // Read key1 of attendee0 from all children
+                    for (const child of children) {
+                        child.send({
+                            command: "getLatestMapValue",
+                            workspaceId,
+                            key: key1,
+                            attendeeId: attendee0Id,
+                        });
+                    }
+                    const key1Responses = await getLatestMapValueResponses(children, workspaceId, key1, childErrorPromise, getStateTimeoutMs);
+                    // Read key2 of attendee1 from all children
+                    for (const child of children) {
+                        child.send({
+                            command: "getLatestMapValue",
+                            workspaceId,
+                            key: key2,
+                            attendeeId: attendee1Id,
+                        });
+                    }
+                    const key2Responses = await getLatestMapValueResponses(children, workspaceId, key2, childErrorPromise, getStateTimeoutMs);
+                    // Verify
+                    assert.strictEqual(key1Responses.length, numClients, "Expected responses from all clients for key1");
+                    assert.strictEqual(key2Responses.length, numClients, "Expected responses from all clients for key2");
+                    for (const response of key1Responses) {
+                        assert.deepStrictEqual(response.value, value1, "Key1 value should match");
+                    }
+                    for (const response of key2Responses) {
+                        assert.deepStrictEqual(response.value, value2, "Key2 value should match");
+                    }
+                });
+            }
         });
     }
 });

package/lib/test/multiprocess/presenceTest.spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"presenceTest.spec.js","sourceRoot":"","sources":["../../../src/test/multiprocess/presenceTest.spec.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAqB,MAAM,oBAAoB,CAAC;AAI7D,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAInF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH;;;;;;;;;;;;;;GAcG;AACH,KAAK,UAAU,kBAAkB,CAChC,YAAoB,EACpB,kBAAkC;IAQlC,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,MAAM,kBAAkB,GAAoB,EAAE,CAAC;IAC/C,2DAA2D;IAC3D,MAAM,kBAAkB,GAAoB,EAAE,CAAC;IAC/C,uBAAuB;IACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,IAAI,CAAC,wCAAwC,EAAE;YAC5D,QAAQ,CAAC,EAAE,CAAC,wCAAwC;SACpD,CAAC,CAAC;QACH,wDAAwD;QACxD,kBAAkB,CAAC,IAAI,CAAC,GAAG,EAAE;YAC5B,KAAK,CAAC,IAAI,EAAE,CAAC;YACb,KAAK,CAAC,kBAAkB,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;QACH,MAAM,YAAY,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1D,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,GAAqB,EAAE,EAAE;gBAC/C,IAAI,GAAG,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;oBACzB,OAAO,EAAE,CAAC;gBACX,CAAC;qBAAM,CAAC;oBACP,MAAM,CACL,IAAI,KAAK,CAAC,4CAA4C,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAClF,CAAC;gBACH,CAAC;YACF,CAAC,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,kBAAkB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACtC,MAAM,YAAY,GAAG,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;YACpD,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;gBAC3B,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,qBAAqB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YAClE,CAAC,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,kBAAkB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAEtC,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QAEhC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IACD,0FAA0F;IAC1F,MAAM,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAE3D,qFAAqF;IACrF,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAEzE,OAAO;QACN,QAAQ;QACR,iBAAiB;KACjB,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAAC,EAAmB;IACjD,OAAO;QACN,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE;YACL,EAAE,EAAE,gBAAgB,EAAE,EAAE;YACxB,IAAI,EAAE,kBAAkB,EAAE,EAAE;SAC5B;KACD,CAAC;AACH,CAAC;AAED,KAAK,UAAU,qBAAqB,CACnC,cAA8B,EAC9B,cAAsB;IAKtB,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IAChE,CAAC;IACD,MAAM,UAAU,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IACrC,MAAM,qBAAqB,GAAG,IAAI,OAAO,CAGtC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACtB,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,GAAqB,EAAE,EAAE;YACpD,IAAI,GAAG,CAAC,KAAK,KAAK,WAAW,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;gBAClD,OAAO,CAAC;oBACP,0BAA0B,EAAE,GAAG,CAAC,UAAU;oBAC1C,WAAW,EAAE,GAAG,CAAC,WAAW;iBAC5B,CAAC,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACP,MAAM,CAAC,IAAI,KAAK,CAAC,sCAAsC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;YAChF,CAAC;QACF,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,CAAC;QACA,UAAU,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC;IACD,MAAM,EAAE,0BAA0B,EAAE,WAAW,EAAE,GAAG,MAAM,YAAY,CACrE,qBAAqB,EACrB;QACC,UAAU,EAAE,cAAc;QAC1B,QAAQ,EAAE,gDAAgD;KAC1D,CACD,CAAC;IAEF,MAAM,kBAAkB,GAA0B,EAAE,CAAC;IACrD,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,cAAc,CAAC,OAAO,EAAE,EAAE,CAAC;QACvD,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YACjB,iGAAiG;YACjG,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAC,CAAC;YACrE,SAAS;QACV,CAAC;QACD,MAAM,OAAO,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;QAE7C,4EAA4E;QAC5E,OAAO,CAAC,WAAW,GAAG,WAAW,CAAC;QAElC,kBAAkB,CAAC,IAAI,CACtB,IAAI,OAAO,CAAa,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC3C,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,GAAqB,EAAE,EAAE;gBAC/C,IAAI,GAAG,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;oBAC/B,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;gBACzB,CAAC;qBAAM,IAAI,GAAG,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;oBAClC,MAAM,CAAC,IAAI,KAAK,CAAC,wBAAwB,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;gBACxD,CAAC;YACF,CAAC,CAAC,CAAC;QACJ,CAAC,CAAC,CACF,CAAC;QAEF,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrB,CAAC;IAED,IAAI,0BAA0B,KAAK,SAAS,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;IACnF,CAAC;IAED,OAAO,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,CAAC;AAC3D,CAAC;AAED;;;;;;;;;;;GAWG;AACH,KAAK,UAAU,0BAA0B,CACxC,QAAwB,EACxB,qBAA6B,EAC7B,qBAA6B,EAC7B,wBAAgC,EAChC,mBAAkC,OAAO,CAAC,OAAO,EAAE;IAEnD,QAAQ;IACR,MAAM,wBAAwB,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAC9D,IAAI,qBAAqB,GAAG,CAAC,CAAC;QAC9B,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,GAAqB,EAAE,EAAE;YACnD,IAAI,GAAG,CAAC,KAAK,KAAK,mBAAmB,EAAE,CAAC;gBACvC,qBAAqB,EAAE,CAAC;gBACxB,IAAI,qBAAqB,IAAI,qBAAqB,EAAE,CAAC;oBACpD,OAAO,EAAE,CAAC;gBACX,CAAC;YACF,CAAC;QACF,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,oCAAoC;IACpC,MAAM,aAAa,GAAG,MAAM,qBAAqB,CAAC,QAAQ,EAAE,qBAAqB,CAAC,CAAC;IAEnF,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,kBAAkB,CAAC;SAC3C,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;SACnD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QAChB,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEJ,mDAAmD;IACnD,MAAM,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,wBAAwB,EAAE,gBAAgB,CAAC,CAAC,EAAE;QAC9E,UAAU,EAAE,wBAAwB;QACpC,QAAQ,EAAE,gDAAgD;KAC1D,CAAC,CAAC;IAEH,OAAO,aAAa,CAAC;AACtB,CAAC;AAED;;;;GAIG;AACH,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IAC1C,MAAM,YAAY,GAAmB,EAAE,CAAC;IAExC,6FAA6F;IAC7F,SAAS,CAAC,KAAK,IAAI,EAAE;QACpB,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;YACpC,OAAO,EAAE,CAAC;QACX,CAAC;QACD,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,qEAAqE;IACrE,MAAM,0BAA0B,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;IACpD,gGAAgG;IAChG,KAAK,MAAM,UAAU,IAAI,0BAA0B,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QACjE,MAAM,CAAC,UAAU,GAAG,CAAC,EAAE,gCAAgC,CAAC,CAAC;QAEzD,iFAAiF;QACjF,MAAM,qBAAqB,GAAG,IAAI,GAAG,UAAU,CAAC;QAChD,MAAM,qBAAqB,GAAG,IAAI,CAAC;QAEnC,EAAE,CAAC,mEAAmE,UAAU,WAAW,EAAE,KAAK,IAAI,EAAE;YACvG,QAAQ;YACR,MAAM,EAAE,QAAQ,EAAE,iBAAiB,EAAE,GAAG,MAAM,kBAAkB,CAC/D,UAAU,EACV,YAAY,CACZ,CAAC;YAEF,oCAAoC;YACpC,MAAM,0BAA0B,CAC/B,QAAQ,EACR,UAAU,GAAG,CAAC,EACd,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,CACjB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,oEAAoE,UAAU,WAAW,EAAE,KAAK,IAAI,EAAE;YACxG,QAAQ;YACR,MAAM,EAAE,QAAQ,EAAE,iBAAiB,EAAE,GAAG,MAAM,kBAAkB,CAC/D,UAAU,EACV,YAAY,CACZ,CAAC;YAEF,MAAM,aAAa,GAAG,MAAM,0BAA0B,CACrD,QAAQ,EACR,UAAU,GAAG,CAAC,EACd,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,CACjB,CAAC;YAEF,MAAM,wBAAwB,GAAG,MAAM,CAAC;YAExC,MAAM,mBAAmB,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAC/D,KAAK,KAAK,CAAC;gBACV,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE;gBACnB,CAAC,CAAC,cAAc,CACd,CAAC,OAAO,EAAE,EAAE;oBACX,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,GAAqB,EAAE,EAAE;wBAC7C,IACC,GAAG,CAAC,KAAK,KAAK,sBAAsB;4BACpC,GAAG,CAAC,UAAU,KAAK,aAAa,CAAC,0BAA0B,EAC1D,CAAC;4BACF,OAAO,CAAC,GAAG,CAAC,SAAS,KAAK,0BAA0B,CAAC,CAAC;4BACtD,OAAO,EAAE,CAAC;wBACX,CAAC;oBACF,CAAC,CAAC,CAAC;gBACJ,CAAC,EACD;oBACC,UAAU,EAAE,wBAAwB;oBACpC,QAAQ,EAAE,YAAY,KAAK,wBAAwB;iBACnD,CACD,CACH,CAAC;YAEF,uCAAuC;YACvC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC,CAAC;YAEhD,sDAAsD;YACtD,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC;QAC3E,CAAC,CAAC,CAAC;IACJ,CAAC;AACF,CAAC,CAAC,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { strict as assert } from \"node:assert\";\nimport { fork, type ChildProcess } from \"node:child_process\";\n\n// eslint-disable-next-line import/no-internal-modules\nimport type { AttendeeId } from \"@fluidframework/presence/beta\";\nimport { timeoutAwait, timeoutPromise } from \"@fluidframework/test-utils/internal\";\n\nimport type { ConnectCommand, MessageFromChild } from \"./messageTypes.js\";\n\n/**\n * This test suite is a prototype for a multi-process end to end test for Fluid using the new Presence API on AzureClient.\n * In the future we hope to expand and generalize this pattern to broadly test more Fluid features.\n * Other E2E tests are limited to running multiple clients on a single process which does not effectively\n * simulate real-world production scenarios where clients are usually running on different machines. Since\n * the Fluid Framework client is designed to carry most of the work burden, multi-process testing from a\n * single machine is also not representative but does at least work past some limitations of a single\n * Node.js process handling multiple clients.\n *\n * The pattern demonstrated in this test suite is as follows:\n *\n * This main test file acts as the 'Orchestrator'. The orchestrator's job includes:\n * - Fork child processes to simulate multiple Fluid clients\n * - Send command messages to child clients to perform specific Fluid actions.\n * - Receive response messages from child clients to verify expected behavior.\n * - Clean up child processes after each test.\n *\n * The child processes are located in the `childClient.ts` file. Each child process simulates a Fluid client.\n *\n * The child client's job includes:\n * - Create/Get + connect to Fluid container.\n * - Listen for command messages from the orchestrator.\n * - Perform the requested action.\n * - Send response messages including any relevant data back to the orchestrator to verify expected behavior.\n */\n\n/**\n * Fork child processes to simulate multiple Fluid clients.\n *\n * @remarks\n * Individual child processes may be scheduled concurrently on a multi-core CPU\n * and separate processes will never share a port when connected to a service.\n *\n * @param numProcesses - The number of child processes to fork.\n * @param cleanUpAccumulator - An array to accumulate cleanup functions for\n * each child process. This is build per instance to accommodate any errors\n * that might occur before completing all forking.\n *\n * @returns A promise that resolves with an object containing the child\n * processes and a promise that rejects on any child process errors.\n */\nasync function forkChildProcesses(\n\tnumProcesses: number,\n\tcleanUpAccumulator: (() => void)[],\n): Promise<{\n\tchildren: ChildProcess[];\n\t/**\n\t * Will never resolve successfully, it is only used to reject on child process error.\n\t */\n\tchildErrorPromise: Promise<void>;\n}> {\n\tconst children: ChildProcess[] = [];\n\tconst childReadyPromises: Promise<void>[] = [];\n\t// Collect all child process error promises into this array\n\tconst childErrorPromises: Promise<void>[] = [];\n\t// Fork child processes\n\tfor (let i = 0; i < numProcesses; i++) {\n\t\tconst child = fork(\"./lib/test/multiprocess/childClient.js\", [\n\t\t\t`child${i}` /* identifier passed to child process */,\n\t\t]);\n\t\t// Register a cleanup function to kill the child process\n\t\tcleanUpAccumulator.push(() => {\n\t\t\tchild.kill();\n\t\t\tchild.removeAllListeners();\n\t\t});\n\t\tconst readyPromise = new Promise<void>((resolve, reject) => {\n\t\t\tchild.once(\"message\", (msg: MessageFromChild) => {\n\t\t\t\tif (msg.event === \"ack\") {\n\t\t\t\t\tresolve();\n\t\t\t\t} else {\n\t\t\t\t\treject(\n\t\t\t\t\t\tnew Error(`Unexpected (non-\"ack\") message from child${i}: ${JSON.stringify(msg)}`),\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t});\n\t\t});\n\t\tchildReadyPromises.push(readyPromise);\n\t\tconst errorPromise = new Promise<void>((_, reject) => {\n\t\t\tchild.on(\"error\", (error) => {\n\t\t\t\treject(new Error(`Child${i} process errored: ${error.message}`));\n\t\t\t});\n\t\t});\n\t\tchildErrorPromises.push(errorPromise);\n\n\t\tchild.send({ command: \"ping\" });\n\n\t\tchildren.push(child);\n\t}\n\t// This race will be used to reject any of the following tests on any child process errors\n\tconst childErrorPromise = Promise.race(childErrorPromises);\n\n\t// All children are always expected to connect successfully and acknowledge the ping.\n\tawait Promise.race([Promise.all(childReadyPromises), childErrorPromise]);\n\n\treturn {\n\t\tchildren,\n\t\tchildErrorPromise,\n\t};\n}\n\nfunction composeConnectMessage(id: string | number): ConnectCommand {\n\treturn {\n\t\tcommand: \"connect\",\n\t\tuser: {\n\t\t\tid: `test-user-id-${id}`,\n\t\t\tname: `test-user-name-${id}`,\n\t\t},\n\t};\n}\n\nasync function connectChildProcesses(\n\tchildProcesses: ChildProcess[],\n\treadyTimeoutMs: number,\n): Promise<{\n\tcontainerCreatorAttendeeId: AttendeeId;\n\tattendeeIdPromises: Promise<AttendeeId>[];\n}> {\n\tif (childProcesses.length === 0) {\n\t\tthrow new Error(\"No child processes provided for connection.\");\n\t}\n\tconst firstChild = childProcesses[0];\n\tconst containerReadyPromise = new Promise<{\n\t\tcontainerCreatorAttendeeId: AttendeeId;\n\t\tcontainerId: string;\n\t}>((resolve, reject) => {\n\t\tfirstChild.once(\"message\", (msg: MessageFromChild) => {\n\t\t\tif (msg.event === \"connected\" && msg.containerId) {\n\t\t\t\tresolve({\n\t\t\t\t\tcontainerCreatorAttendeeId: msg.attendeeId,\n\t\t\t\t\tcontainerId: msg.containerId,\n\t\t\t\t});\n\t\t\t} else {\n\t\t\t\treject(new Error(`Non-connected message from child0: ${JSON.stringify(msg)}`));\n\t\t\t}\n\t\t});\n\t});\n\t{\n\t\tfirstChild.send(composeConnectMessage(0));\n\t}\n\tconst { containerCreatorAttendeeId, containerId } = await timeoutAwait(\n\t\tcontainerReadyPromise,\n\t\t{\n\t\t\tdurationMs: readyTimeoutMs,\n\t\t\terrorMsg: \"did not receive 'connected' from child process\",\n\t\t},\n\t);\n\n\tconst attendeeIdPromises: Promise<AttendeeId>[] = [];\n\tfor (const [index, child] of childProcesses.entries()) {\n\t\tif (index === 0) {\n\t\t\t// The first child process is the container creator, it has already sent the 'connected' message.\n\t\t\tattendeeIdPromises.push(Promise.resolve(containerCreatorAttendeeId));\n\t\t\tcontinue;\n\t\t}\n\t\tconst message = composeConnectMessage(index);\n\n\t\t// For subsequent children, send containerId but do not wait for a response.\n\t\tmessage.containerId = containerId;\n\n\t\tattendeeIdPromises.push(\n\t\t\tnew Promise<AttendeeId>((resolve, reject) => {\n\t\t\t\tchild.once(\"message\", (msg: MessageFromChild) => {\n\t\t\t\t\tif (msg.event === \"connected\") {\n\t\t\t\t\t\tresolve(msg.attendeeId);\n\t\t\t\t\t} else if (msg.event === \"error\") {\n\t\t\t\t\t\treject(new Error(`Child process error: ${msg.error}`));\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t}),\n\t\t);\n\n\t\tchild.send(message);\n\t}\n\n\tif (containerCreatorAttendeeId === undefined) {\n\t\tthrow new Error(\"No container creator session ID received from child processes.\");\n\t}\n\n\treturn { containerCreatorAttendeeId, attendeeIdPromises };\n}\n\n/**\n * Connects the child processes and waits for the specified number of attendees to connect.\n * @remarks\n * This function can be used directly as a test. Comments in the functionality describe the\n * breakdown of test blocks.\n *\n * @param children - Array of child processes to connect.\n * @param attendeeCountRequired - The number of attendees that must connect.\n * @param childConnectTimeoutMs - Timeout duration for child process connections.\n * @param attendeesJoinedTimeoutMs - Timeout duration for required attendees to join.\n * @param earlyExitPromise - Promise that resolves/rejects when the test should early exit.\n */\nasync function connectAndWaitForAttendees(\n\tchildren: ChildProcess[],\n\tattendeeCountRequired: number,\n\tchildConnectTimeoutMs: number,\n\tattendeesJoinedTimeoutMs: number,\n\tearlyExitPromise: Promise<void> = Promise.resolve(),\n): Promise<{ containerCreatorAttendeeId: AttendeeId }> {\n\t// Setup\n\tconst attendeeConnectedPromise = new Promise<void>((resolve) => {\n\t\tlet attendeesJoinedEvents = 0;\n\t\tchildren[0].on(\"message\", (msg: MessageFromChild) => {\n\t\t\tif (msg.event === \"attendeeConnected\") {\n\t\t\t\tattendeesJoinedEvents++;\n\t\t\t\tif (attendeesJoinedEvents >= attendeeCountRequired) {\n\t\t\t\t\tresolve();\n\t\t\t\t}\n\t\t\t}\n\t\t});\n\t});\n\n\t// Act - connect all child processes\n\tconst connectResult = await connectChildProcesses(children, childConnectTimeoutMs);\n\n\tPromise.all(connectResult.attendeeIdPromises)\n\t\t.then(() => console.log(\"All attendees connected.\"))\n\t\t.catch((error) => {\n\t\t\tconsole.error(\"Error connecting children:\", error);\n\t\t});\n\n\t// Verify - wait for all 'attendeeConnected' events\n\tawait timeoutAwait(Promise.race([attendeeConnectedPromise, earlyExitPromise]), {\n\t\tdurationMs: attendeesJoinedTimeoutMs,\n\t\terrorMsg: \"did not receive all 'attendeeConnected' events\",\n\t});\n\n\treturn connectResult;\n}\n\n/**\n * This particular test suite tests the following E2E functionality for Presence:\n * - Announce 'attendeeConnected' when remote client joins session.\n * - Announce 'attendeeDisconnected' when remote client disconnects.\n */\ndescribe(`Presence with AzureClient`, () => {\n\tconst afterCleanUp: (() => void)[] = [];\n\n\t// After each test, call any cleanup functions that were registered (kill each child process)\n\tafterEach(async () => {\n\t\tfor (const cleanUp of afterCleanUp) {\n\t\t\tcleanUp();\n\t\t}\n\t\tafterCleanUp.length = 0;\n\t});\n\n\t// Note that on slower systems 50+ clients may take too long to join.\n\tconst numClientsForAttendeeTests = [5, 20, 50, 100];\n\t// TODO: AB#45620: \"Presence: perf: update Join pattern for scale\" may help, then remove .slice.\n\tfor (const numClients of numClientsForAttendeeTests.slice(0, 2)) {\n\t\tassert(numClients > 1, \"Must have at least two clients\");\n\n\t\t// Timeout duration used when waiting for response messages from child processes.\n\t\tconst childConnectTimeoutMs = 1000 * numClients;\n\t\tconst allConnectedTimeoutMs = 2000;\n\n\t\tit(`announces 'attendeeConnected' when remote client joins session [${numClients} clients]`, async () => {\n\t\t\t// Setup\n\t\t\tconst { children, childErrorPromise } = await forkChildProcesses(\n\t\t\t\tnumClients,\n\t\t\t\tafterCleanUp,\n\t\t\t);\n\n\t\t\t// Further Setup with Act and Verify\n\t\t\tawait connectAndWaitForAttendees(\n\t\t\t\tchildren,\n\t\t\t\tnumClients - 1,\n\t\t\t\tchildConnectTimeoutMs,\n\t\t\t\tallConnectedTimeoutMs,\n\t\t\t\tchildErrorPromise,\n\t\t\t);\n\t\t});\n\n\t\tit(`announces 'attendeeDisconnected' when remote client disconnects [${numClients} clients]`, async () => {\n\t\t\t// Setup\n\t\t\tconst { children, childErrorPromise } = await forkChildProcesses(\n\t\t\t\tnumClients,\n\t\t\t\tafterCleanUp,\n\t\t\t);\n\n\t\t\tconst connectResult = await connectAndWaitForAttendees(\n\t\t\t\tchildren,\n\t\t\t\tnumClients - 1,\n\t\t\t\tchildConnectTimeoutMs,\n\t\t\t\tallConnectedTimeoutMs,\n\t\t\t\tchildErrorPromise,\n\t\t\t);\n\n\t\t\tconst childDisconnectTimeoutMs = 10_000;\n\n\t\t\tconst waitForDisconnected = children.map(async (child, index) =>\n\t\t\t\tindex === 0\n\t\t\t\t\t? Promise.resolve()\n\t\t\t\t\t: timeoutPromise(\n\t\t\t\t\t\t\t(resolve) => {\n\t\t\t\t\t\t\t\tchild.on(\"message\", (msg: MessageFromChild) => {\n\t\t\t\t\t\t\t\t\tif (\n\t\t\t\t\t\t\t\t\t\tmsg.event === \"attendeeDisconnected\" &&\n\t\t\t\t\t\t\t\t\t\tmsg.attendeeId === connectResult.containerCreatorAttendeeId\n\t\t\t\t\t\t\t\t\t) {\n\t\t\t\t\t\t\t\t\t\tconsole.log(`Child[${index}] saw creator disconnect`);\n\t\t\t\t\t\t\t\t\t\tresolve();\n\t\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\tdurationMs: childDisconnectTimeoutMs,\n\t\t\t\t\t\t\t\terrorMsg: `Attendee[${index}] Disconnected Timeout`,\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t),\n\t\t\t);\n\n\t\t\t// Act - disconnect first child process\n\t\t\tchildren[0].send({ command: \"disconnectSelf\" });\n\n\t\t\t// Verify - wait for all 'attendeeDisconnected' events\n\t\t\tawait Promise.race([Promise.all(waitForDisconnected), childErrorPromise]);\n\t\t});\n\t}\n});\n"]}
+{"version":3,"file":"presenceTest.spec.js","sourceRoot":"","sources":["../../../src/test/multiprocess/presenceTest.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 \"node:assert\";\nimport type { ChildProcess } from \"node:child_process\";\nimport inspector from \"node:inspector\";\n\nimport type { AttendeeId } from \"@fluidframework/presence/beta\";\nimport { timeoutAwait, timeoutPromise } from \"@fluidframework/test-utils/internal\";\n\nimport type { MessageFromChild } from \"./messageTypes.js\";\nimport {\n\tconnectAndListenForAttendees,\n\tconnectAndWaitForAttendees,\n\tconnectChildProcesses,\n\tforkChildProcesses,\n\tgetLatestMapValueResponses,\n\tgetLatestValueResponses,\n\tregisterWorkspaceOnChildren,\n\ttestConsole,\n\twaitForLatestMapValueUpdates,\n\twaitForLatestValueUpdates,\n} from \"./orchestratorUtils.js\";\n\nconst useAzure = process.env.FLUID_CLIENT === \"azure\";\n\n/**\n * Detects if the debugger is attached (when code loaded).\n */\nconst debuggerAttached = inspector.url() !== undefined;\n\n/**\n * Set this to a high number when debugging to avoid timeouts from debugging time.\n */\nconst timeoutMultiplier = debuggerAttached ? 1000 : useAzure ? 3 : 1;\n\n/**\n * Sets the timeout for the given test context.\n *\n * @remarks\n * If a debugger is attached, the timeout is set to 0 to prevent timeouts during debugging.\n * Otherwise, it sets the timeout to the maximum of the current timeout and the specified duration.\n *\n * @param context - The Mocha test context.\n * @param duration - The duration in milliseconds to set the timeout to. Zero disables the timeout.\n */\nfunction setTimeout(context: Mocha.Context, duration: number): void {\n\tconst currentTimeout = context.timeout();\n\tconst newTimeout =\n\t\tdebuggerAttached || currentTimeout === 0 || duration === 0\n\t\t\t? 0\n\t\t\t: Math.max(currentTimeout, duration);\n\tif (newTimeout !== currentTimeout) {\n\t\ttestConsole.log(\n\t\t\t`${context.test?.title}: setting timeout to ${newTimeout}ms (was ${currentTimeout}ms)`,\n\t\t);\n\t\tcontext.timeout(newTimeout);\n\t}\n}\n\n/**\n * This test suite is a prototype for a multi-process end to end test for Fluid using the new Presence API on AzureClient.\n * In the future we hope to expand and generalize this pattern to broadly test more Fluid features.\n * Other E2E tests are limited to running multiple clients on a single process which does not effectively\n * simulate real-world production scenarios where clients are usually running on different machines. Since\n * the Fluid Framework client is designed to carry most of the work burden, multi-process testing from a\n * single machine is also not representative but does at least work past some limitations of a single\n * Node.js process handling multiple clients.\n *\n * The pattern demonstrated in this test suite is as follows:\n *\n * This main test file acts as the 'Orchestrator'. The orchestrator's job includes:\n * - Fork child processes to simulate multiple Fluid clients\n * - Send command messages to child clients to perform specific Fluid actions.\n * - Receive response messages from child clients to verify expected behavior.\n * - Clean up child processes after each test.\n *\n * The child processes are located in the `childClient.tool.ts` file. Each child process simulates a Fluid client.\n *\n * The child client's job includes:\n * - Create/Get + connect to Fluid container.\n * - Listen for command messages from the orchestrator.\n * - Perform the requested action.\n * - Send response messages including any relevant data back to the orchestrator to verify expected behavior.\n */\n\n/**\n * This particular test suite tests the following E2E functionality for Presence:\n * - Announce 'attendeeConnected' when remote client joins session.\n * - Announce 'attendeeDisconnected' when remote client disconnects.\n */\ndescribe(`Presence with AzureClient`, () => {\n\tconst afterCleanUp: (() => void)[] = [];\n\n\t// After each test, call any cleanup functions that were registered (kill each child process)\n\tafterEach(async () => {\n\t\tfor (const cleanUp of afterCleanUp) {\n\t\t\tcleanUp();\n\t\t}\n\t\tafterCleanUp.length = 0;\n\t});\n\n\t// Note that on slower systems 50+ clients may take too long to join.\n\tconst numClientsForAttendeeTests = [5, 20, 50, 100];\n\t// TODO: AB#45620: \"Presence: perf: update Join pattern for scale\" may help, then remove .slice.\n\tfor (const numClients of numClientsForAttendeeTests.slice(0, 2)) {\n\t\tassert(numClients > 1, \"Must have at least two clients\");\n\t\t/**\n\t\t * Timeout for child processes to connect to container ({@link ConnectedEvent})\n\t\t */\n\t\tconst childConnectTimeoutMs = 1000 * numClients * timeoutMultiplier;\n\t\t/**\n\t\t * Timeout for presence attendees to connect {@link AttendeeConnectedEvent}\n\t\t */\n\t\tconst allAttendeesJoinedTimeoutMs = (1000 + 200 * numClients) * timeoutMultiplier;\n\n\t\tfor (const writeClients of [numClients, 1]) {\n\t\t\tit(`announces 'attendeeConnected' when remote client joins session [${numClients} clients, ${writeClients} writers]`, async function () {\n\t\t\t\tsetTimeout(this, childConnectTimeoutMs + allAttendeesJoinedTimeoutMs + 1000);\n\n\t\t\t\t// Setup\n\t\t\t\tconst { children, childErrorPromise } = await forkChildProcesses(\n\t\t\t\t\tnumClients,\n\t\t\t\t\tafterCleanUp,\n\t\t\t\t);\n\n\t\t\t\t// Further Setup with Act and Verify\n\t\t\t\tawait connectAndWaitForAttendees(\n\t\t\t\t\tchildren,\n\t\t\t\t\t{\n\t\t\t\t\t\twriteClients,\n\t\t\t\t\t\tattendeeCountRequired: numClients - 1,\n\t\t\t\t\t\tchildConnectTimeoutMs,\n\t\t\t\t\t\tallAttendeesJoinedTimeoutMs,\n\t\t\t\t\t},\n\t\t\t\t\tchildErrorPromise,\n\t\t\t\t);\n\t\t\t});\n\n\t\t\tit(`announces 'attendeeDisconnected' when remote client disconnects [${numClients} clients, ${writeClients} writers]`, async function () {\n\t\t\t\t// TODO: AB#45620: \"Presence: perf: update Join pattern for scale\" can handle\n\t\t\t\t// larger counts of read-only attendees. Without protocol changes tests with\n\t\t\t\t// 20+ attendees exceed current limits.\n\t\t\t\tif (numClients >= 20 && writeClients === 1) {\n\t\t\t\t\tthis.skip();\n\t\t\t\t}\n\n\t\t\t\tconst childDisconnectTimeoutMs = 10_000 * timeoutMultiplier;\n\n\t\t\t\tsetTimeout(\n\t\t\t\t\tthis,\n\t\t\t\t\tchildConnectTimeoutMs +\n\t\t\t\t\t\tallAttendeesJoinedTimeoutMs +\n\t\t\t\t\t\tchildDisconnectTimeoutMs +\n\t\t\t\t\t\t1000,\n\t\t\t\t);\n\n\t\t\t\t// Setup\n\t\t\t\tconst { children, childErrorPromise } = await forkChildProcesses(\n\t\t\t\t\tnumClients,\n\t\t\t\t\tafterCleanUp,\n\t\t\t\t);\n\n\t\t\t\tconst connectResult = await connectAndListenForAttendees(children, {\n\t\t\t\t\twriteClients,\n\t\t\t\t\tattendeeCountRequired: numClients - 1,\n\t\t\t\t\tchildConnectTimeoutMs,\n\t\t\t\t});\n\n\t\t\t\t// Wait for all attendees to be fully joined\n\t\t\t\t// Keep a tally for debuggability\n\t\t\t\tlet childrenFullyJoined = 0;\n\t\t\t\tconst allAttendeesFullyJoined = Promise.all(\n\t\t\t\t\t// eslint-disable-next-line @typescript-eslint/promise-function-async\n\t\t\t\t\tconnectResult.attendeeCountRequiredPromises.map((attendeeFullyJoinedPromise) =>\n\t\t\t\t\t\tattendeeFullyJoinedPromise.then(() => childrenFullyJoined++),\n\t\t\t\t\t),\n\t\t\t\t);\n\t\t\t\tawait timeoutAwait(allAttendeesFullyJoined, {\n\t\t\t\t\tdurationMs: allAttendeesJoinedTimeoutMs,\n\t\t\t\t\terrorMsg: \"Not all attendees fully joined\",\n\t\t\t\t}).catch((error) => {\n\t\t\t\t\t// Ideally this information would just be in the timeout error message, but that\n\t\t\t\t\t// must be a resolved string (not dynamic). So, just log it separately.\n\t\t\t\t\ttestConsole.log(`${childrenFullyJoined} attendees fully joined before error...`);\n\t\t\t\t\tthrow error;\n\t\t\t\t});\n\n\t\t\t\tconst waitForDisconnected = children.map(async (child, index) =>\n\t\t\t\t\tindex === 0\n\t\t\t\t\t\t? Promise.resolve()\n\t\t\t\t\t\t: timeoutPromise(\n\t\t\t\t\t\t\t\t(resolve) => {\n\t\t\t\t\t\t\t\t\tchild.on(\"message\", (msg: MessageFromChild) => {\n\t\t\t\t\t\t\t\t\t\tif (\n\t\t\t\t\t\t\t\t\t\t\tmsg.event === \"attendeeDisconnected\" &&\n\t\t\t\t\t\t\t\t\t\t\tmsg.attendeeId === connectResult.containerCreatorAttendeeId\n\t\t\t\t\t\t\t\t\t\t) {\n\t\t\t\t\t\t\t\t\t\t\tconsole.log(`Child[${index}] saw creator disconnect`);\n\t\t\t\t\t\t\t\t\t\t\tresolve();\n\t\t\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\tdurationMs: childDisconnectTimeoutMs,\n\t\t\t\t\t\t\t\t\terrorMsg: `Attendee[${index}] Disconnected Timeout`,\n\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t),\n\t\t\t\t);\n\n\t\t\t\t// Act - disconnect first child process\n\t\t\t\tchildren[0].send({ command: \"disconnectSelf\" });\n\n\t\t\t\t// Verify - wait for all 'attendeeDisconnected' events\n\t\t\t\tawait Promise.race([Promise.all(waitForDisconnected), childErrorPromise]);\n\t\t\t});\n\t\t}\n\t}\n\n\t{\n\t\t/**\n\t\t * Timeout for workspace registration {@link WorkspaceRegisteredEvent}\n\t\t */\n\t\tconst workspaceRegisterTimeoutMs = 5000;\n\t\t/**\n\t\t * Timeout for presence update events {@link LatestMapValueUpdatedEvent} and {@link LatestValueUpdatedEvent}\n\t\t */\n\t\tconst stateUpdateTimeoutMs = 5000;\n\t\t/**\n\t\t * Timeout for {@link LatestMapValueGetResponseEvent} and {@link LatestValueGetResponseEvent}\n\t\t */\n\t\tconst getStateTimeoutMs = 5000;\n\n\t\t// This test suite focuses on the synchronization of Latest state between clients.\n\t\t// NOTE: For testing purposes child clients will expect a Latest value of type string.\n\t\tdescribe(`using Latest state object`, () => {\n\t\t\tfor (const numClients of [5, 20]) {\n\t\t\t\tassert(numClients > 1, \"Must have at least two clients\");\n\t\t\t\t/**\n\t\t\t\t * Timeout for child processes to connect to container ({@link ConnectedEvent})\n\t\t\t\t */\n\t\t\t\tconst childConnectTimeoutMs = 1000 * numClients * timeoutMultiplier;\n\n\t\t\t\tlet children: ChildProcess[];\n\t\t\t\tlet childErrorPromise: Promise<never>;\n\t\t\t\tlet containerCreatorAttendeeId: AttendeeId;\n\t\t\t\tlet attendeeIdPromises: Promise<AttendeeId>[];\n\t\t\t\tlet remoteClients: ChildProcess[];\n\t\t\t\tconst testValue = \"testValue\";\n\t\t\t\tconst workspaceId = \"presenceTestWorkspace\";\n\n\t\t\t\tbeforeEach(async () => {\n\t\t\t\t\t({ children, childErrorPromise } = await forkChildProcesses(\n\t\t\t\t\t\tnumClients,\n\t\t\t\t\t\tafterCleanUp,\n\t\t\t\t\t));\n\t\t\t\t\t({ containerCreatorAttendeeId, attendeeIdPromises } = await connectChildProcesses(\n\t\t\t\t\t\tchildren,\n\t\t\t\t\t\t{ writeClients: numClients, readyTimeoutMs: childConnectTimeoutMs },\n\t\t\t\t\t));\n\t\t\t\t\tawait Promise.all(attendeeIdPromises);\n\t\t\t\t\tremoteClients = children.filter((_, index) => index !== 0);\n\t\t\t\t\t// NOTE: For testing purposes child clients will expect a Latest value of type string (StateFactory.latest<{ value: string }>).\n\t\t\t\t\tawait registerWorkspaceOnChildren(children, workspaceId, {\n\t\t\t\t\t\tlatest: true,\n\t\t\t\t\t\ttimeoutMs: workspaceRegisterTimeoutMs,\n\t\t\t\t\t});\n\t\t\t\t});\n\n\t\t\t\tit(`allows clients to read Latest state from other clients [${numClients} clients]`, async () => {\n\t\t\t\t\t// Setup\n\t\t\t\t\tconst updateEventsPromise = waitForLatestValueUpdates(\n\t\t\t\t\t\tremoteClients,\n\t\t\t\t\t\tworkspaceId,\n\t\t\t\t\t\tchildErrorPromise,\n\t\t\t\t\t\tstateUpdateTimeoutMs,\n\t\t\t\t\t\t{ fromAttendeeId: containerCreatorAttendeeId, expectedValue: testValue },\n\t\t\t\t\t);\n\n\t\t\t\t\t// Act - Trigger the update\n\t\t\t\t\tchildren[0].send({\n\t\t\t\t\t\tcommand: \"setLatestValue\",\n\t\t\t\t\t\tworkspaceId,\n\t\t\t\t\t\tvalue: testValue,\n\t\t\t\t\t});\n\t\t\t\t\tconst updateEvents = await updateEventsPromise;\n\n\t\t\t\t\t// Verify all events are from the expected attendee\n\t\t\t\t\tfor (const updateEvent of updateEvents) {\n\t\t\t\t\t\tassert.strictEqual(updateEvent.attendeeId, containerCreatorAttendeeId);\n\t\t\t\t\t\tassert.deepStrictEqual(updateEvent.value, testValue);\n\t\t\t\t\t}\n\n\t\t\t\t\t// Act - Request each remote client to read latest state from container creator\n\t\t\t\t\tfor (const child of remoteClients) {\n\t\t\t\t\t\tchild.send({\n\t\t\t\t\t\t\tcommand: \"getLatestValue\",\n\t\t\t\t\t\t\tworkspaceId,\n\t\t\t\t\t\t\tattendeeId: containerCreatorAttendeeId,\n\t\t\t\t\t\t});\n\t\t\t\t\t}\n\n\t\t\t\t\tconst getResponses = await getLatestValueResponses(\n\t\t\t\t\t\tremoteClients,\n\t\t\t\t\t\tworkspaceId,\n\t\t\t\t\t\tchildErrorPromise,\n\t\t\t\t\t\tgetStateTimeoutMs,\n\t\t\t\t\t);\n\n\t\t\t\t\t// Verify - all responses should contain the expected value\n\t\t\t\t\tfor (const getResponse of getResponses) {\n\t\t\t\t\t\tassert.deepStrictEqual(getResponse.value, testValue);\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t}\n\t\t});\n\n\t\t// This test suite focuses on the synchronization of LatestMap state between clients.\n\t\t// NOTE: For testing purposes child clients will expect a LatestMap value of type Record<string, string | number>.\n\t\tdescribe(`using LatestMap state object`, () => {\n\t\t\tfor (const numClients of [5, 20]) {\n\t\t\t\tassert(numClients > 1, \"Must have at least two clients\");\n\t\t\t\t/**\n\t\t\t\t * Timeout for child processes to connect to container ({@link ConnectedEvent})\n\t\t\t\t */\n\t\t\t\tconst childConnectTimeoutMs = 1000 * numClients * timeoutMultiplier;\n\n\t\t\t\tlet children: ChildProcess[];\n\t\t\t\tlet childErrorPromise: Promise<never>;\n\t\t\t\tlet containerCreatorAttendeeId: AttendeeId;\n\t\t\t\tlet attendeeIdPromises: Promise<AttendeeId>[];\n\t\t\t\tlet remoteClients: ChildProcess[];\n\t\t\t\tconst workspaceId = \"presenceTestWorkspace\";\n\t\t\t\tconst key1 = \"player1\";\n\t\t\t\tconst key2 = \"player2\";\n\t\t\t\tconst value1 = { name: \"Alice\", score: 100 };\n\t\t\t\tconst value2 = { name: \"Bob\", score: 200 };\n\n\t\t\t\tbeforeEach(async () => {\n\t\t\t\t\t({ children, childErrorPromise } = await forkChildProcesses(\n\t\t\t\t\t\tnumClients,\n\t\t\t\t\t\tafterCleanUp,\n\t\t\t\t\t));\n\t\t\t\t\t({ containerCreatorAttendeeId, attendeeIdPromises } = await connectChildProcesses(\n\t\t\t\t\t\tchildren,\n\t\t\t\t\t\t{ writeClients: numClients, readyTimeoutMs: childConnectTimeoutMs },\n\t\t\t\t\t));\n\t\t\t\t\tawait Promise.all(attendeeIdPromises);\n\t\t\t\t\tremoteClients = children.filter((_, index) => index !== 0);\n\t\t\t\t\t// NOTE: For testing purposes child clients will expect a LatestMap value of type Record<string, string | number> (StateFactory.latestMap<{ value: Record<string, string | number> }, string>).\n\t\t\t\t\tawait registerWorkspaceOnChildren(children, workspaceId, {\n\t\t\t\t\t\tlatestMap: true,\n\t\t\t\t\t\ttimeoutMs: workspaceRegisterTimeoutMs,\n\t\t\t\t\t});\n\t\t\t\t});\n\n\t\t\t\tit(`allows clients to read LatestMap values from other clients [${numClients} clients]`, async () => {\n\t\t\t\t\t// Setup\n\t\t\t\t\tconst testKey = \"cursor\";\n\t\t\t\t\tconst testValue = { x: 150, y: 300 };\n\t\t\t\t\tconst updateEventsPromise = waitForLatestMapValueUpdates(\n\t\t\t\t\t\tremoteClients,\n\t\t\t\t\t\tworkspaceId,\n\t\t\t\t\t\ttestKey,\n\t\t\t\t\t\tchildErrorPromise,\n\t\t\t\t\t\tstateUpdateTimeoutMs,\n\t\t\t\t\t\t{ fromAttendeeId: containerCreatorAttendeeId, expectedValue: testValue },\n\t\t\t\t\t);\n\n\t\t\t\t\t// Act\n\t\t\t\t\tchildren[0].send({\n\t\t\t\t\t\tcommand: \"setLatestMapValue\",\n\t\t\t\t\t\tworkspaceId,\n\t\t\t\t\t\tkey: testKey,\n\t\t\t\t\t\tvalue: testValue,\n\t\t\t\t\t});\n\t\t\t\t\tconst updateEvents = await updateEventsPromise;\n\n\t\t\t\t\t// Check all events are from the expected attendee\n\t\t\t\t\tfor (const updateEvent of updateEvents) {\n\t\t\t\t\t\tassert.strictEqual(updateEvent.attendeeId, containerCreatorAttendeeId);\n\t\t\t\t\t\tassert.strictEqual(updateEvent.key, testKey);\n\t\t\t\t\t\tassert.deepStrictEqual(updateEvent.value, testValue);\n\t\t\t\t\t}\n\n\t\t\t\t\tfor (const child of remoteClients) {\n\t\t\t\t\t\tchild.send({\n\t\t\t\t\t\t\tcommand: \"getLatestMapValue\",\n\t\t\t\t\t\t\tworkspaceId,\n\t\t\t\t\t\t\tkey: testKey,\n\t\t\t\t\t\t\tattendeeId: containerCreatorAttendeeId,\n\t\t\t\t\t\t});\n\t\t\t\t\t}\n\t\t\t\t\tconst getResponses = await getLatestMapValueResponses(\n\t\t\t\t\t\tremoteClients,\n\t\t\t\t\t\tworkspaceId,\n\t\t\t\t\t\ttestKey,\n\t\t\t\t\t\tchildErrorPromise,\n\t\t\t\t\t\tgetStateTimeoutMs,\n\t\t\t\t\t);\n\n\t\t\t\t\t// Verify\n\t\t\t\t\tfor (const getResponse of getResponses) {\n\t\t\t\t\t\tassert.deepStrictEqual(getResponse.value, testValue);\n\t\t\t\t\t}\n\t\t\t\t});\n\n\t\t\t\tit(`returns per-key values on read [${numClients} clients]`, async () => {\n\t\t\t\t\t// Setup\n\t\t\t\t\tconst allAttendeeIds = await Promise.all(attendeeIdPromises);\n\t\t\t\t\tconst attendee0Id = containerCreatorAttendeeId;\n\t\t\t\t\tconst attendee1Id = allAttendeeIds[1];\n\n\t\t\t\t\tconst key1Recipients = children.filter((_, index) => index !== 0);\n\t\t\t\t\tconst key2Recipients = children.filter((_, index) => index !== 1);\n\t\t\t\t\tconst key1UpdateEventsPromise = waitForLatestMapValueUpdates(\n\t\t\t\t\t\tkey1Recipients,\n\t\t\t\t\t\tworkspaceId,\n\t\t\t\t\t\tkey1,\n\t\t\t\t\t\tchildErrorPromise,\n\t\t\t\t\t\tstateUpdateTimeoutMs,\n\t\t\t\t\t\t{ fromAttendeeId: attendee0Id, expectedValue: value1 },\n\t\t\t\t\t);\n\t\t\t\t\tconst key2UpdateEventsPromise = waitForLatestMapValueUpdates(\n\t\t\t\t\t\tkey2Recipients,\n\t\t\t\t\t\tworkspaceId,\n\t\t\t\t\t\tkey2,\n\t\t\t\t\t\tchildErrorPromise,\n\t\t\t\t\t\tstateUpdateTimeoutMs,\n\t\t\t\t\t\t{ fromAttendeeId: attendee1Id, expectedValue: value2 },\n\t\t\t\t\t);\n\n\t\t\t\t\t// Act\n\t\t\t\t\tchildren[0].send({\n\t\t\t\t\t\tcommand: \"setLatestMapValue\",\n\t\t\t\t\t\tworkspaceId,\n\t\t\t\t\t\tkey: key1,\n\t\t\t\t\t\tvalue: value1,\n\t\t\t\t\t});\n\t\t\t\t\tconst key1UpdateEvents = await key1UpdateEventsPromise;\n\t\t\t\t\tchildren[1].send({\n\t\t\t\t\t\tcommand: \"setLatestMapValue\",\n\t\t\t\t\t\tworkspaceId,\n\t\t\t\t\t\tkey: key2,\n\t\t\t\t\t\tvalue: value2,\n\t\t\t\t\t});\n\t\t\t\t\tconst key2UpdateEvents = await key2UpdateEventsPromise;\n\n\t\t\t\t\t// Verify all events are from the expected attendees\n\t\t\t\t\tfor (const updateEvent of key1UpdateEvents) {\n\t\t\t\t\t\tassert.strictEqual(updateEvent.attendeeId, attendee0Id);\n\t\t\t\t\t\tassert.strictEqual(updateEvent.key, key1);\n\t\t\t\t\t\tassert.deepStrictEqual(updateEvent.value, value1);\n\t\t\t\t\t}\n\t\t\t\t\tfor (const updateEvent of key2UpdateEvents) {\n\t\t\t\t\t\tassert.strictEqual(updateEvent.attendeeId, attendee1Id);\n\t\t\t\t\t\tassert.strictEqual(updateEvent.key, key2);\n\t\t\t\t\t\tassert.deepStrictEqual(updateEvent.value, value2);\n\t\t\t\t\t}\n\n\t\t\t\t\t// Read key1 of attendee0 from all children\n\t\t\t\t\tfor (const child of children) {\n\t\t\t\t\t\tchild.send({\n\t\t\t\t\t\t\tcommand: \"getLatestMapValue\",\n\t\t\t\t\t\t\tworkspaceId,\n\t\t\t\t\t\t\tkey: key1,\n\t\t\t\t\t\t\tattendeeId: attendee0Id,\n\t\t\t\t\t\t});\n\t\t\t\t\t}\n\t\t\t\t\tconst key1Responses = await getLatestMapValueResponses(\n\t\t\t\t\t\tchildren,\n\t\t\t\t\t\tworkspaceId,\n\t\t\t\t\t\tkey1,\n\t\t\t\t\t\tchildErrorPromise,\n\t\t\t\t\t\tgetStateTimeoutMs,\n\t\t\t\t\t);\n\n\t\t\t\t\t// Read key2 of attendee1 from all children\n\t\t\t\t\tfor (const child of children) {\n\t\t\t\t\t\tchild.send({\n\t\t\t\t\t\t\tcommand: \"getLatestMapValue\",\n\t\t\t\t\t\t\tworkspaceId,\n\t\t\t\t\t\t\tkey: key2,\n\t\t\t\t\t\t\tattendeeId: attendee1Id,\n\t\t\t\t\t\t});\n\t\t\t\t\t}\n\t\t\t\t\tconst key2Responses = await getLatestMapValueResponses(\n\t\t\t\t\t\tchildren,\n\t\t\t\t\t\tworkspaceId,\n\t\t\t\t\t\tkey2,\n\t\t\t\t\t\tchildErrorPromise,\n\t\t\t\t\t\tgetStateTimeoutMs,\n\t\t\t\t\t);\n\n\t\t\t\t\t// Verify\n\t\t\t\t\tassert.strictEqual(\n\t\t\t\t\t\tkey1Responses.length,\n\t\t\t\t\t\tnumClients,\n\t\t\t\t\t\t\"Expected responses from all clients for key1\",\n\t\t\t\t\t);\n\t\t\t\t\tassert.strictEqual(\n\t\t\t\t\t\tkey2Responses.length,\n\t\t\t\t\t\tnumClients,\n\t\t\t\t\t\t\"Expected responses from all clients for key2\",\n\t\t\t\t\t);\n\n\t\t\t\t\tfor (const response of key1Responses) {\n\t\t\t\t\t\tassert.deepStrictEqual(response.value, value1, \"Key1 value should match\");\n\t\t\t\t\t}\n\t\t\t\t\tfor (const response of key2Responses) {\n\t\t\t\t\t\tassert.deepStrictEqual(response.value, value2, \"Key2 value should match\");\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t}\n\t\t});\n\t}\n});\n"]}