@fluid-internal/presence-runtime 2.102.0 → 2.103.0

package/dist/states/test/schemaValidation/valueManagers.spec.js

@@ -1,784 +0,0 @@
-"use strict";
-/*!
- * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
- * Licensed under the MIT License.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-const node_assert_1 = require("node:assert");
-const internal_1 = require("@fluidframework/test-utils/internal");
-const mocha_1 = require("mocha");
-const sinon_1 = require("sinon");
-const states_1 = require("@fluid-internal/presence-runtime/states");
-const utils_1 = require("@fluid-internal/presence-runtime/utils");
-const mockEphemeralRuntime_js_1 = require("../mockEphemeralRuntime.js");
-const testUtils_js_1 = require("../testUtils.js");
-const attendeeUpdate = {
-    "clientToSessionId": {
-        [testUtils_js_1.connectionId1]: {
-            "rev": 0,
-            "timestamp": 0,
-            "value": testUtils_js_1.attendeeId1,
-        },
-    },
-};
-const latestUpdate = {
-    "latest": {
-        [testUtils_js_1.attendeeId1]: {
-            "rev": 1,
-            "timestamp": 0,
-            "value": (0, utils_1.toOpaqueJson)({ x: 1, y: 1, z: 1 }),
-        },
-    },
-};
-const latestMapUpdate = {
-    "latestMap": {
-        [testUtils_js_1.attendeeId1]: {
-            "rev": 1,
-            "items": {
-                "key1": {
-                    "rev": 1,
-                    "timestamp": 0,
-                    "value": (0, utils_1.toOpaqueJson)({ x: 1, y: 1, z: 1 }),
-                },
-                "key2": {
-                    "rev": 1,
-                    "timestamp": 0,
-                    "value": (0, utils_1.toOpaqueJson)({ x: 2, y: 2, z: 2 }),
-                },
-                "invalidKey": {
-                    "rev": 1,
-                    "timestamp": 0,
-                    "value": (0, utils_1.toOpaqueJson)({ x: -1, y: -1, z: -1 }),
-                },
-            },
-        },
-    },
-};
-function datastoreUpdateSignal(sendTimestamp, valueObjectName, metadata) {
-    return {
-        type: "Pres:DatastoreUpdate",
-        content: {
-            sendTimestamp,
-            avgLatency: 20,
-            data: {
-                "system:presence": attendeeUpdate,
-                "s:name:testWorkspace": {
-                    [valueObjectName]: {
-                        [testUtils_js_1.attendeeId1]: metadata,
-                    },
-                },
-            },
-        },
-        clientId: testUtils_js_1.connectionId1,
-    };
-}
-/**
- * Runs a test against a validator by getting the value and matching the resulting data and validator call counts
- * against expectations.
- */
-function runValidatorTest(params) {
-    const initialValue = params.getRemoteValue();
-    node_assert_1.strict.equal(params.validatorFunction.callCount, params.expectedCallCount);
-    node_assert_1.strict.deepEqual(initialValue, params.expectedValue);
-}
-/**
- * Runs a test against a validator by getting the value multiple times and verifying that the validator is not called
- * multiple times.
- */
-function runMultipleCallsTest(params) {
-    // First call should invoke validator
-    const firstValue = params.getRemoteValue();
-    node_assert_1.strict.equal(params.validatorFunction.callCount, 1);
-    node_assert_1.strict.deepEqual(firstValue, params.expectedValue);
-    // Subsequent calls should not invoke validator when data is unchanged
-    const secondValue = params.getRemoteValue();
-    node_assert_1.strict.equal(params.validatorFunction.callCount, 1);
-    const thirdValue = params.getRemoteValue();
-    node_assert_1.strict.equal(params.validatorFunction.callCount, 1);
-    node_assert_1.strict.deepEqual(secondValue, params.expectedValue);
-    node_assert_1.strict.deepEqual(thirdValue, params.expectedValue);
-}
-(0, mocha_1.describe)("Presence/States", () => {
-    (0, mocha_1.describe)("Runtime schema validation", () => {
-        const afterCleanUp = [];
-        const initialTime = 1000;
-        function processUpdates(valueManagerUpdates) {
-            const updates = { "system:presence": attendeeUpdate, ...valueManagerUpdates };
-            processSignal([], {
-                type: "Pres:DatastoreUpdate",
-                content: {
-                    sendTimestamp: clock.now - 10,
-                    avgLatency: 20,
-                    data: updates,
-                },
-                clientId: "client1",
-            }, false);
-        }
-        let clock;
-        let logger;
-        let presence;
-        let processSignal;
-        let runtime;
-        let remoteAttendee;
-        let validatorCallExpected;
-        let point3DValidatorFunction;
-        (0, mocha_1.before)(async () => {
-            clock = (0, sinon_1.useFakeTimers)();
-        });
-        /**
-         * This beforeEach sets up the runtime and presence objects. The `presence` object is owned by attendee2, while
-         * attendee1 acts as a remote attendee for the purposes of the tests.
-         */
-        (0, mocha_1.beforeEach)(() => {
-            logger = new internal_1.EventAndErrorTrackingLogger();
-            runtime = new mockEphemeralRuntime_js_1.MockEphemeralRuntime(logger);
-            clock.setSystemTime(initialTime);
-            validatorCallExpected = true;
-            point3DValidatorFunction = (0, testUtils_js_1.createSpiedValidator)((d) => {
-                if (validatorCallExpected === "once") {
-                    validatorCallExpected = false;
-                }
-                else {
-                    (0, node_assert_1.strict)(validatorCallExpected, "point3DValidatorFunction should not be called at this time");
-                }
-                return typeof d === "object" ? d : undefined;
-            });
-            // Create Presence joining session as attendeeId-2. Tests will act as attendee2
-            ({ presence, processSignal } = (0, testUtils_js_1.prepareConnectedPresence)(runtime, testUtils_js_1.localAttendeeId, testUtils_js_1.initialLocalClientConnectionId, clock, logger));
-            // Pass a little time (to mimic reality)
-            clock.tick(10);
-            // Process remote client update signal (attendeeId-1 is then part of local client's known session).
-            processUpdates({
-                "s:name:testWorkspace": { ...latestUpdate, ...latestMapUpdate },
-            });
-            // Pass a little time (to mimic reality)
-            clock.tick(10);
-            // Get attendee references
-            remoteAttendee = presence.attendees.getAttendee(testUtils_js_1.attendeeId1);
-        });
-        (0, mocha_1.afterEach)(function (done) {
-            clock.reset();
-            point3DValidatorFunction.resetHistory();
-            // If the test passed so far, check final expectations.
-            if (this.currentTest?.state === "passed") {
-                (0, testUtils_js_1.assertFinalExpectations)(runtime, logger);
-            }
-            for (const cleanUp of afterCleanUp) {
-                cleanUp();
-            }
-            afterCleanUp.length = 0;
-            done();
-        });
-        (0, mocha_1.after)(() => {
-            clock.restore();
-        });
-        (0, mocha_1.describe)("Latest validator", () => {
-            let latest;
-            /**
-             * This beforeEach sets up the presence workspace itself and gets a reference to it. It then sets some new data as
-             * attendee1 by processing a datastore update signal.
-             */
-            (0, mocha_1.beforeEach)(() => {
-                // Setup workspace initialization signal
-                runtime.signalsExpected.push([
-                    {
-                        type: "Pres:DatastoreUpdate",
-                        content: {
-                            sendTimestamp: clock.now,
-                            avgLatency: 10,
-                            data: {
-                                "system:presence": {
-                                    "clientToSessionId": {
-                                        [testUtils_js_1.initialLocalClientConnectionId]: {
-                                            "rev": 0,
-                                            "timestamp": initialTime,
-                                            "value": testUtils_js_1.localAttendeeId,
-                                        },
-                                    },
-                                },
-                                "s:name:testWorkspace": {
-                                    "latest": {
-                                        [testUtils_js_1.localAttendeeId]: {
-                                            "rev": 0,
-                                            "timestamp": clock.now,
-                                            "value": (0, utils_1.toOpaqueJson)({ x: 0, y: 0, z: 0 }),
-                                        },
-                                    },
-                                },
-                            },
-                        },
-                    },
-                ]);
-                const stateWorkspace = presence.states.getWorkspace("name:testWorkspace", {
-                    latest: states_1.StateFactory.latest({
-                        local: { x: 0, y: 0, z: 0 },
-                        validator: point3DValidatorFunction,
-                        settings: { allowableUpdateLatencyMs: 0 },
-                    }),
-                });
-                latest = stateWorkspace.states.latest;
-                // Process a valid update signal with Point3D data
-                processSignal([], {
-                    type: "Pres:DatastoreUpdate",
-                    content: {
-                        sendTimestamp: clock.now - 10,
-                        avgLatency: 20,
-                        data: {
-                            "system:presence": attendeeUpdate,
-                            "s:name:testWorkspace": {
-                                "latest": {
-                                    [testUtils_js_1.attendeeId1]: {
-                                        "rev": 2,
-                                        "timestamp": clock.now - 10,
-                                        "value": (0, utils_1.toOpaqueJson)({ x: 10, y: 20, z: 30 }),
-                                    },
-                                },
-                            },
-                        },
-                    },
-                    clientId: "client1",
-                }, false);
-            });
-            (0, mocha_1.describe)("is not called", () => {
-                (0, mocha_1.it)("by .getRemote()", () => {
-                    // Calling getRemote should not invoke the validator (only a value read will).
-                    latest.getRemote(remoteAttendee);
-                    node_assert_1.strict.equal(point3DValidatorFunction.callCount, 0);
-                });
-                (0, mocha_1.it)("by .getRemotes()", () => {
-                    for (const _ of latest.getRemotes()) {
-                        node_assert_1.strict.equal(point3DValidatorFunction.callCount, 0);
-                    }
-                });
-                (0, mocha_1.it)("when accessing .local", () => {
-                    node_assert_1.strict.equal(point3DValidatorFunction.callCount, 0, "initial call count is wrong");
-                    node_assert_1.strict.deepEqual(latest.local, { x: 0, y: 0, z: 0 });
-                    node_assert_1.strict.equal(point3DValidatorFunction.callCount, 0, "validator was called on local data");
-                });
-                (0, mocha_1.it)("when remote data is updated", () => {
-                    const remoteData = latest.getRemote(remoteAttendee);
-                    // Should call validator
-                    runValidatorTest({
-                        getRemoteValue: () => remoteData.value(),
-                        expectedCallCount: 1,
-                        expectedValue: { x: 10, y: 20, z: 30 },
-                        validatorFunction: point3DValidatorFunction,
-                    });
-                    // Send updated data from remote client
-                    const timestamp = clock.now - 15;
-                    processSignal([], datastoreUpdateSignal(timestamp, "latest", {
-                        "rev": 3,
-                        timestamp,
-                        "value": (0, utils_1.toOpaqueJson)({ x: 50, y: 60, z: 70 }),
-                    }), false);
-                    // Validator is not called by remote update
-                    node_assert_1.strict.equal(point3DValidatorFunction.callCount, 1);
-                });
-            });
-            (0, mocha_1.describe)("is called", () => {
-                (0, mocha_1.it)("on first .value() call", () => {
-                    const remoteData = latest.getRemote(remoteAttendee);
-                    runValidatorTest({
-                        getRemoteValue: () => remoteData.value(),
-                        expectedCallCount: 1,
-                        expectedValue: { x: 10, y: 20, z: 30 },
-                        validatorFunction: point3DValidatorFunction,
-                    });
-                });
-                (0, mocha_1.it)("only once for multiple .value() calls in series and .value() always returns same value", () => {
-                    const remoteData = latest.getRemote(remoteAttendee);
-                    runMultipleCallsTest({
-                        getRemoteValue: () => remoteData.value(),
-                        expectedValue: { x: 10, y: 20, z: 30 },
-                        validatorFunction: point3DValidatorFunction,
-                    });
-                });
-                (0, mocha_1.it)("on .value() call after remote data has changed", () => {
-                    // Get the remote data and read it, verify that the validator is called once.
-                    const remoteData = latest.getRemote(remoteAttendee);
-                    node_assert_1.strict.deepEqual(remoteData.value(), { x: 10, y: 20, z: 30 });
-                    node_assert_1.strict.equal(point3DValidatorFunction.callCount, 1, "first call count is wrong");
-                    // Send updated data from remote client
-                    const timestamp = clock.now - 15;
-                    processSignal([], datastoreUpdateSignal(timestamp, "latest", {
-                        "rev": 3,
-                        timestamp,
-                        "value": (0, utils_1.toOpaqueJson)({ x: 50, y: 60, z: 70 }),
-                    }), false);
-                    // Reading the remote value should cause the validator to be called a second time since the data has been changed.
-                    const data2 = latest.getRemote(remoteAttendee);
-                    node_assert_1.strict.deepEqual(data2.value(), { x: 50, y: 60, z: 70 }, "updated remote value is wrong");
-                    node_assert_1.strict.equal(point3DValidatorFunction.callCount, 2, "validator should be called twice");
-                });
-                (0, mocha_1.it)("on .value() call when remote data changes from valid to invalid", () => {
-                    // Get the remote data and read it, verify that the validator is called once.
-                    const remoteData = latest.getRemote(remoteAttendee);
-                    node_assert_1.strict.deepEqual(remoteData.value(), { x: 10, y: 20, z: 30 });
-                    node_assert_1.strict.equal(point3DValidatorFunction.callCount, 1, "first call count is wrong");
-                    // Send invalid data from remote client
-                    const timestamp = clock.now - 15;
-                    processSignal([], datastoreUpdateSignal(timestamp, "latest", {
-                        "rev": 3,
-                        timestamp,
-                        "value": (0, utils_1.toOpaqueJson)("invalid"),
-                    }), false);
-                    // Reading the remote value should cause the validator to be called a second time and return undefined
-                    const data2 = latest.getRemote(remoteAttendee);
-                    node_assert_1.strict.equal(data2.value(), undefined, "invalid data should return undefined");
-                    node_assert_1.strict.equal(point3DValidatorFunction.callCount, 2, "validator should be called twice");
-                });
-                (0, mocha_1.it)("on .value() call when remote data changes from invalid to valid", () => {
-                    // First send invalid data
-                    let timestamp = clock.now - 15;
-                    processSignal([], datastoreUpdateSignal(timestamp, "latest", {
-                        "rev": 3,
-                        timestamp,
-                        "value": (0, utils_1.toOpaqueJson)("invalid"),
-                    }), false);
-                    // Get the remote data and read it, verify that the validator is called once and returns undefined
-                    const remoteData = latest.getRemote(remoteAttendee);
-                    node_assert_1.strict.equal(remoteData.value(), undefined);
-                    node_assert_1.strict.equal(point3DValidatorFunction.callCount, 1, "first call count is wrong");
-                    // Send valid data from remote client
-                    timestamp += 10;
-                    processSignal([], datastoreUpdateSignal(timestamp, "latest", {
-                        "rev": 4,
-                        timestamp,
-                        "value": (0, utils_1.toOpaqueJson)({ x: 100, y: 200, z: 300 }),
-                    }), false);
-                    // Reading the remote value should cause the validator to be called a second time and return valid data
-                    const data2 = latest.getRemote(remoteAttendee);
-                    node_assert_1.strict.deepEqual(data2.value(), { x: 100, y: 200, z: 300 }, "valid data should be returned");
-                    node_assert_1.strict.equal(point3DValidatorFunction.callCount, 2, "validator should be called twice");
-                });
-                (0, mocha_1.it)("on .value() call when remote data changes from invalid to invalid", () => {
-                    // First send invalid data
-                    let timestamp = clock.now - 15;
-                    processSignal([], datastoreUpdateSignal(timestamp, "latest", {
-                        "rev": 3,
-                        timestamp,
-                        "value": (0, utils_1.toOpaqueJson)("invalid"),
-                    }), false);
-                    // Get the remote data and read it, verify that the validator is called once and returns undefined
-                    const remoteData = latest.getRemote(remoteAttendee);
-                    node_assert_1.strict.equal(remoteData.value(), undefined);
-                    node_assert_1.strict.equal(point3DValidatorFunction.callCount, 1, "first call count is wrong");
-                    // Send different invalid data from remote client
-                    timestamp += 10;
-                    processSignal([], datastoreUpdateSignal(timestamp, "latest", {
-                        "rev": 4,
-                        timestamp,
-                        "value": (0, utils_1.toOpaqueJson)("also-invalid"),
-                    }), false);
-                    // Reading the remote value should cause the validator to be called a second time and still return undefined
-                    const data2 = latest.getRemote(remoteAttendee);
-                    node_assert_1.strict.equal(data2.value(), undefined, "invalid data should return undefined");
-                    node_assert_1.strict.equal(point3DValidatorFunction.callCount, 2, "validator should be called twice");
-                });
-            });
-        });
-        (0, mocha_1.describe)("LatestMap with validation", () => {
-            let latestMap;
-            let keyValidatorCallExpectedCount;
-            function keyValidatorFunction(key) {
-                (0, node_assert_1.strict)(keyValidatorCallExpectedCount > 0, "keyValidatorFunction should not be called at this time");
-                keyValidatorCallExpectedCount--;
-                return key.startsWith("key");
-            }
-            /**
-             * This beforeEach sets up the presence workspace itself and gets a
-             * reference to it.
-             */
-            (0, mocha_1.beforeEach)(() => {
-                keyValidatorCallExpectedCount = 0;
-                // workspace setup's initialization signal
-                runtime.signalsExpected.push([
-                    {
-                        "type": "Pres:DatastoreUpdate",
-                        "content": {
-                            "sendTimestamp": clock.now,
-                            "avgLatency": 10,
-                            "data": {
-                                "system:presence": {
-                                    "clientToSessionId": {
-                                        [testUtils_js_1.initialLocalClientConnectionId]: {
-                                            "rev": 0,
-                                            "timestamp": initialTime,
-                                            "value": testUtils_js_1.localAttendeeId,
-                                        },
-                                    },
-                                },
-                                "s:name:testWorkspace": {
-                                    "latestMap": {
-                                        [testUtils_js_1.localAttendeeId]: {
-                                            "rev": 0,
-                                            "items": {
-                                                "key1": {
-                                                    "rev": 0,
-                                                    "timestamp": clock.now,
-                                                    "value": (0, utils_1.toOpaqueJson)({ "x": 0, "y": 0, "z": 0 }),
-                                                },
-                                                "key2": {
-                                                    "rev": 0,
-                                                    "timestamp": clock.now,
-                                                    "value": (0, utils_1.toOpaqueJson)({ "x": 0, "y": 0, "z": 0 }),
-                                                },
-                                            },
-                                        },
-                                    },
-                                },
-                            },
-                        },
-                    },
-                ]);
-                const stateWorkspace = presence.states.getWorkspace("name:testWorkspace", {
-                    latestMap: states_1.StateFactory.latestMap({
-                        local: { "key1": { x: 0, y: 0, z: 0 }, "key2": { x: 0, y: 0, z: 0 } },
-                        validator: point3DValidatorFunction,
-                        keyValidator: keyValidatorFunction,
-                        settings: { allowableUpdateLatencyMs: 0 },
-                    }),
-                });
-                latestMap = stateWorkspace.states.latestMap;
-            });
-            function sendInvalidData(key = "key1") {
-                keyValidatorCallExpectedCount = 1;
-                const timestamp = clock.now - 15;
-                processSignal([], datastoreUpdateSignal(timestamp, "latestMap", {
-                    "rev": 2,
-                    "items": {
-                        [key]: {
-                            "rev": 2,
-                            timestamp,
-                            "value": (0, utils_1.toOpaqueJson)("invalid"),
-                        },
-                    },
-                }), false);
-                node_assert_1.strict.equal(keyValidatorCallExpectedCount, 0);
-            }
-            (0, mocha_1.describe)("no validator is called", () => {
-                (0, mocha_1.beforeEach)(() => {
-                    validatorCallExpected = false;
-                });
-                (0, mocha_1.it)("when reading local key value", () => {
-                    // Act
-                    const localData = latestMap.local.get("key1");
-                    // Verify
-                    node_assert_1.strict.equal(point3DValidatorFunction.callCount, 0);
-                    // double check local data
-                    node_assert_1.strict.deepEqual(localData, { x: 0, y: 0, z: 0 });
-                });
-                (0, mocha_1.it)("when writing local key value", () => {
-                    // Setup
-                    runtime.signalsExpected.push([
-                        {
-                            "type": "Pres:DatastoreUpdate",
-                            "content": {
-                                "sendTimestamp": clock.now,
-                                "avgLatency": 10,
-                                "data": {
-                                    "system:presence": {
-                                        "clientToSessionId": {
-                                            [testUtils_js_1.initialLocalClientConnectionId]: {
-                                                "rev": 0,
-                                                "timestamp": initialTime,
-                                                "value": testUtils_js_1.localAttendeeId,
-                                            },
-                                        },
-                                    },
-                                    "s:name:testWorkspace": {
-                                        "latestMap": {
-                                            [testUtils_js_1.localAttendeeId]: {
-                                                "rev": 1,
-                                                "items": {
-                                                    "key1": {
-                                                        "rev": 1,
-                                                        "timestamp": clock.now,
-                                                        "value": (0, utils_1.toOpaqueJson)({ "x": 0, "y": 1, "z": 2 }),
-                                                    },
-                                                },
-                                            },
-                                        },
-                                    },
-                                },
-                            },
-                        },
-                    ]);
-                    // Act
-                    latestMap.local.set("key1", { x: 0, y: 1, z: 2 });
-                    // Verify
-                    node_assert_1.strict.equal(point3DValidatorFunction.callCount, 0);
-                });
-            });
-            (0, mocha_1.it)("update with invalid key invokes key validator per key and does not raise events", () => {
-                // Setup
-                for (const event of [
-                    "remoteUpdated",
-                    "remoteItemUpdated",
-                    "remoteItemRemoved",
-                ]) {
-                    afterCleanUp.push(latestMap.events.on(event, () => {
-                        node_assert_1.strict.fail(`${event} event should not be raised for invalid key`);
-                    }));
-                }
-                keyValidatorCallExpectedCount = 1;
-                // Act
-                sendInvalidData("invalidKey");
-                // Verify
-                node_assert_1.strict.equal(keyValidatorCallExpectedCount, 0); // all expected calls were made
-                node_assert_1.strict.equal(point3DValidatorFunction.callCount, 0);
-            });
-            /**
-             * Sets validator call expectations and gets remote value data.
-             * @returns `latestMap.getRemote(remoteAttendee)`
-             * @remarks
-             * `validatorCallExpected` will be `false` and `keyValidatorCallExpectedCount`
-             * will be `0` after the call.
-             */
-            function getRemoteValue() {
-                validatorCallExpected = false;
-                keyValidatorCallExpectedCount = 3;
-                const remoteData = latestMap.getRemote(remoteAttendee);
-                node_assert_1.strict.equal(keyValidatorCallExpectedCount, 0);
-                return remoteData;
-            }
-            (0, mocha_1.it)(".getRemote call invokes key validator per key but not value validator", () => {
-                // Setup and Act
-                getRemoteValue();
-                // Verify
-                node_assert_1.strict.equal(keyValidatorCallExpectedCount, 0); // all expected calls were made
-                node_assert_1.strict.equal(point3DValidatorFunction.callCount, 0);
-            });
-            (0, mocha_1.describe)("remote value map", () => {
-                (0, mocha_1.it)(".get() does not call any validator", () => {
-                    // Setup
-                    const remoteData = getRemoteValue();
-                    // Act
-                    remoteData.get("key1");
-                    // Verify
-                    node_assert_1.strict.equal(point3DValidatorFunction.callCount, 0);
-                });
-                (0, mocha_1.it)(".forEach() iteration does not call any validator", () => {
-                    // Setup
-                    const remoteData = getRemoteValue();
-                    let counter = 0;
-                    const expectedValues = [
-                        ["key1", { x: 1, y: 1, z: 1 }],
-                        ["key2", { x: 2, y: 2, z: 2 }],
-                    ];
-                    // Act
-                    // eslint-disable-next-line unicorn/no-array-for-each -- forEach is being tested here
-                    remoteData.forEach((_value, key) => {
-                        // Verify
-                        node_assert_1.strict.equal(point3DValidatorFunction.callCount, 0, "call count is wrong");
-                        node_assert_1.strict.equal(key, expectedValues[counter][0]);
-                        counter++;
-                    });
-                    // Make sure forEach iterated through all keys
-                    node_assert_1.strict.equal(counter, expectedValues.length, "counter should match expected values length");
-                });
-                (0, mocha_1.describe)("value validator is called", () => {
-                    for (const { desc, setup, expectedValue } of [
-                        {
-                            desc: "for valid value",
-                            setup: () => { },
-                            expectedValue: { x: 1, y: 1, z: 1 },
-                        },
-                        {
-                            desc: "for invalid value",
-                            setup: sendInvalidData,
-                            expectedValue: undefined,
-                        },
-                    ]) {
-                        (0, mocha_1.it)(`once when key.value() is called ${desc}`, () => {
-                            // Setup
-                            setup();
-                            const remoteData = getRemoteValue();
-                            validatorCallExpected = "once";
-                            // Act
-                            runValidatorTest({
-                                getRemoteValue: () => remoteData.get("key1")?.value(),
-                                expectedCallCount: 1,
-                                expectedValue,
-                                validatorFunction: point3DValidatorFunction,
-                            });
-                        });
-                        (0, mocha_1.it)(`only once for multiple key.value() calls in series and .value() always returned same result ${desc}`, () => {
-                            // Setup
-                            setup();
-                            const remoteData = getRemoteValue();
-                            validatorCallExpected = "once";
-                            // Act
-                            runMultipleCallsTest({
-                                getRemoteValue: () => remoteData.get("key1")?.value(),
-                                expectedValue,
-                                validatorFunction: point3DValidatorFunction,
-                            });
-                        });
-                        (0, mocha_1.it)(`exactly once for each value's .value() calls in .forEach() and .value() always returns same result ${desc}`, () => {
-                            // Setup
-                            setup();
-                            const remoteData = getRemoteValue();
-                            let counter = 0;
-                            const expectedValues = [
-                                // only key1 value might be altered by the setup function
-                                ["key1", expectedValue],
-                                // key2 value will always be the valid
-                                ["key2", { x: 2, y: 2, z: 2 }],
-                            ];
-                            // Act
-                            // eslint-disable-next-line unicorn/no-array-for-each -- forEach is being tested here
-                            remoteData.forEach((value, key) => {
-                                node_assert_1.strict.equal(key, expectedValues[counter][0]);
-                                // reset call expectations/count for each iteration
-                                validatorCallExpected = "once";
-                                point3DValidatorFunction.callCount = 0;
-                                // Act - first call
-                                const valueData = value?.value();
-                                // Verify
-                                node_assert_1.strict.equal(point3DValidatorFunction.callCount, 1, "validator was not called");
-                                // double check value
-                                node_assert_1.strict.deepEqual(valueData, expectedValues[counter][1], `value at key "${key}" is wrong`);
-                                // Act - second call
-                                // Access value a second time; should not affect validator call count
-                                const valueDataRedux = value?.value();
-                                // Verify
-                                node_assert_1.strict.equal(point3DValidatorFunction.callCount, 1, "validator was called a second time");
-                                node_assert_1.strict.strictEqual(valueDataRedux, valueData, `value at key "${key}" is wrong`);
-                                counter++;
-                            });
-                            // Make sure forEach iterated through all keys
-                            node_assert_1.strict.equal(counter, expectedValues.length, "counter should match expected values length");
-                        });
-                    }
-                    for (const { desc, setup, expectedInitialValue, newData, expectedValue } of [
-                        {
-                            desc: "from valid to different valid value",
-                            setup: () => { },
-                            expectedInitialValue: { x: 1, y: 1, z: 1 },
-                            newData: { x: 4, y: 4, z: 4 },
-                            expectedValue: { x: 4, y: 4, z: 4 },
-                        },
-                        {
-                            desc: "from valid to same valid value",
-                            setup: () => { },
-                            expectedInitialValue: { x: 1, y: 1, z: 1 },
-                            newData: { x: 1, y: 1, z: 1 },
-                            expectedValue: { x: 1, y: 1, z: 1 },
-                        },
-                        {
-                            desc: "from valid to invalid value",
-                            setup: () => { },
-                            expectedInitialValue: { x: 1, y: 1, z: 1 },
-                            newData: "invalid",
-                            expectedValue: undefined,
-                        },
-                        {
-                            desc: "from invalid to valid value",
-                            setup: sendInvalidData,
-                            expectedInitialValue: undefined,
-                            newData: { x: 4, y: 4, z: 4 },
-                            expectedValue: { x: 4, y: 4, z: 4 },
-                        },
-                        {
-                            desc: "from invalid to invalid value",
-                            setup: sendInvalidData,
-                            expectedInitialValue: undefined,
-                            newData: "invalid",
-                            expectedValue: undefined,
-                        },
-                    ]) {
-                        (0, mocha_1.it)(`during .value() call after remote key data has changed ${desc}`, () => {
-                            // Setup
-                            setup();
-                            const originalMap = getRemoteValue();
-                            validatorCallExpected = "once";
-                            // Get the remote data and read it, expect that the validator is called once.
-                            const key1Value = originalMap.get("key1")?.value();
-                            node_assert_1.strict.equal(point3DValidatorFunction.callCount, 1, "first call count is wrong");
-                            node_assert_1.strict.deepEqual(key1Value, expectedInitialValue);
-                            // Reset call count for next verification
-                            point3DValidatorFunction.callCount = 0;
-                            // Process updated key data from remote client
-                            keyValidatorCallExpectedCount = 1;
-                            const timestamp = clock.now - 15;
-                            processSignal([], datastoreUpdateSignal(timestamp, "latestMap", {
-                                "rev": 3,
-                                "items": {
-                                    "key1": {
-                                        "rev": 3,
-                                        timestamp,
-                                        "value": (0, utils_1.toOpaqueJson)(newData),
-                                    },
-                                },
-                            }), false);
-                            node_assert_1.strict.equal(keyValidatorCallExpectedCount, 0);
-                            // Verify no call yet
-                            node_assert_1.strict.equal(point3DValidatorFunction.callCount, 0, "call count after update is wrong");
-                            // Reading the remote value should cause the validator to be
-                            // called since the data has been changed.
-                            const updatedMap = getRemoteValue();
-                            validatorCallExpected = "once";
-                            // Act - read updated key value
-                            const updatedKey1Value = updatedMap.get("key1")?.value();
-                            // Verify
-                            node_assert_1.strict.equal(point3DValidatorFunction.callCount, 1, "validator should be called twice");
-                            node_assert_1.strict.deepEqual(updatedKey1Value, expectedValue, "updated remote key value is wrong");
-                        });
-                    }
-                });
-            });
-            // Note this block is after "value validator is called" as it is only valid when those tests are passing.
-            (0, mocha_1.describe)("no validator is called", () => {
-                (0, mocha_1.it)("during .value() call for unchanged keys", () => {
-                    // Setup
-                    keyValidatorCallExpectedCount = 3;
-                    const originalMap = latestMap.getRemote(remoteAttendee);
-                    node_assert_1.strict.equal(keyValidatorCallExpectedCount, 0);
-                    validatorCallExpected = "once";
-                    // Read key1 value - should call validator once
-                    const key1Value = originalMap.get("key1")?.value();
-                    node_assert_1.strict.equal(point3DValidatorFunction.callCount, 1, "validator should be called once for key1");
-                    node_assert_1.strict.deepEqual(key1Value, { x: 1, y: 1, z: 1 });
-                    // Update key2 (different key) with new data, keeping key1 unchanged
-                    keyValidatorCallExpectedCount = 1;
-                    const timestamp = clock.now - 15;
-                    processSignal([], datastoreUpdateSignal(timestamp, "latestMap", {
-                        "rev": 2,
-                        "items": {
-                            "key2": {
-                                "rev": 2,
-                                timestamp,
-                                "value": (0, utils_1.toOpaqueJson)({ "x": 4, "y": 4, "z": 4 }),
-                            },
-                        },
-                    }), false);
-                    node_assert_1.strict.equal(keyValidatorCallExpectedCount, 0);
-                    const updatedMap = getRemoteValue();
-                    const key1Redux = updatedMap.get("key1");
-                    node_assert_1.strict.ok(key1Redux);
-                    node_assert_1.strict.equal(keyValidatorCallExpectedCount, 0);
-                    node_assert_1.strict.equal(point3DValidatorFunction.callCount, 1);
-                    // Act & Verify
-                    // Read key1 value (again) but from updated map - should NOT call validator again since key1 data hasn't changed
-                    const key1ValueRedux = key1Redux.value();
-                    node_assert_1.strict.equal(point3DValidatorFunction.callCount, 1, "validator should still be called only once for key1");
-                    node_assert_1.strict.strictEqual(key1ValueRedux, key1Value, "key1 value should remain unchanged");
-                    // Test verification
-                    validatorCallExpected = true;
-                    point3DValidatorFunction.callCount = 0;
-                    // key2 should have been updated; so, reading key2 value from
-                    // original map and updated map should both result in call
-                    // count increases. Also check for updated value.
-                    let key2Value = originalMap.get("key2")?.value();
-                    node_assert_1.strict.equal(point3DValidatorFunction.callCount, 1, "validator should be called once for original key2 value read");
-                    node_assert_1.strict.deepEqual(key2Value, { "x": 2, "y": 2, "z": 2 }, "key2 value from original map should be unchanged");
-                    key2Value = updatedMap.get("key2")?.value();
-                    node_assert_1.strict.equal(point3DValidatorFunction.callCount, 2, "validator should be called second time for updated key2 value read");
-                    node_assert_1.strict.deepEqual(key2Value, { "x": 4, "y": 4, "z": 4 }, "key2 should have updated value");
-                });
-            });
-        });
-    });
-});
-//# sourceMappingURL=valueManagers.spec.js.map