@fluid-internal/presence-runtime 2.93.0

package/dist/test/testUtils.js

@@ -0,0 +1,262 @@
+"use strict";
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSpiedValidator = exports.assertFinalExpectations = exports.prepareDisconnectedPresence = exports.prepareConnectedPresence = exports.generateBasicClientJoin = exports.localAttendeeId = exports.connectionId1 = exports.attendeeId1 = exports.createSpecificAttendeeId = exports.createInstanceOf = exports.assertIdenticalTypes = void 0;
+const internal_1 = require("@fluidframework/test-utils/internal");
+const sinon_1 = require("sinon");
+const test_1 = require("@fluid-internal/presence-runtime/internal/test");
+const mockEphemeralRuntime_js_1 = require("./mockEphemeralRuntime.js");
+/**
+ * Use to compile-time assert types of two variables are identical.
+ */
+function assertIdenticalTypes(_actual, _expected) {
+    return undefined;
+}
+exports.assertIdenticalTypes = assertIdenticalTypes;
+/**
+ * Creates a non-viable (`undefined`) instance of type T to be used for type checking.
+ */
+function createInstanceOf() {
+    return undefined;
+}
+exports.createInstanceOf = createInstanceOf;
+/**
+ * Forms {@link AttendeeId} for a specific attendee
+ */
+function createSpecificAttendeeId(id) {
+    return id;
+}
+exports.createSpecificAttendeeId = createSpecificAttendeeId;
+/**
+ * Mock {@link AttendeeId}.
+ */
+exports.attendeeId1 = createSpecificAttendeeId("attendeeId-1");
+/**
+ * Mock {@link ClientConnectionId}.
+ */
+exports.connectionId1 = "client1";
+/**
+ * Mock {@link AttendeeId} for the local client in tests.
+ */
+exports.localAttendeeId = createSpecificAttendeeId("localAttendeeId");
+/**
+ * Generates expected inbound join signal for a client that was initialized while connected.
+ */
+function generateBasicClientJoin(fixedTime, { attendeeId = exports.localAttendeeId, clientConnectionId = mockEphemeralRuntime_js_1.initialLocalClientConnectionId, updateProviders = ["client0", "client1", "client3"], connectionOrder = 0, averageLatency = 0, priorClientToSessionId = {}, }) {
+    return {
+        type: "Pres:ClientJoin",
+        content: {
+            "avgLatency": averageLatency,
+            "data": {
+                "system:presence": {
+                    "clientToSessionId": {
+                        ...priorClientToSessionId,
+                        [clientConnectionId]: {
+                            "rev": connectionOrder,
+                            "timestamp": fixedTime,
+                            "value": attendeeId,
+                        },
+                    },
+                },
+            },
+            "sendTimestamp": fixedTime,
+            updateProviders,
+        },
+        clientId: clientConnectionId,
+    };
+}
+exports.generateBasicClientJoin = generateBasicClientJoin;
+/**
+ * Creates a processSignal wrapper function for a presence manager.
+ */
+function createProcessSignal(presence) {
+    return (addressChain, signalMessage, local) => {
+        // Pass on to presence manager, but first clone the message to avoid
+        // possibility of Presence mutating the original message which often
+        // contains reference to general (shared) test data.
+        // Additionally JSON.parse(JSON.stringify(signalMessage)) is used to
+        // ensure only regular JSON-serializable data is passed to Presence.
+        // In production environment, the message is always extracted from
+        // the network and Presence can safely mutate it.
+        presence.processSignal(addressChain, 
+        // eslint-disable-next-line unicorn/prefer-structured-clone -- not structural clone, but filters to JSON-serializable data
+        JSON.parse(JSON.stringify(signalMessage)), local);
+    };
+}
+/**
+ * Calculates update providers based on current audience members.
+ */
+function calculateUpdateProviders(runtime, clientConnectionId) {
+    // This logic needs to be kept in sync with datastore manager.
+    // From PresenceDatastoreManager.getAudienceInformation:
+    const members = runtime.audience.getMembers();
+    members.delete(clientConnectionId);
+    const all = new Set();
+    const writers = new Set();
+    for (const [id, client] of members) {
+        if (client.details.capabilities.interactive) {
+            all.add(id);
+            if (client.mode === "write") {
+                writers.add(id);
+            }
+        }
+    }
+    // From PresenceDatastoreManager.joinSession:
+    const updateProviders = [...(writers.size > 0 ? writers : all)];
+    if (updateProviders.length > 3) {
+        updateProviders.length = 3;
+    }
+    return updateProviders;
+}
+/**
+ * Prepares the expected client join signal and calculates update providers.
+ */
+function prepareExpectedClientJoin(runtime, attendeeId, clientConnectionId, clock) {
+    const updateProviders = calculateUpdateProviders(runtime, clientConnectionId);
+    const expectedClientJoin = generateBasicClientJoin(clock.now, {
+        attendeeId,
+        clientConnectionId,
+        updateProviders,
+    });
+    delete expectedClientJoin.clientId;
+    runtime.signalsExpected.push([expectedClientJoin]);
+    return { expectedClientJoin, updateProviders };
+}
+/**
+ * Processes the local join signal and sends a fake join response.
+ */
+function processJoinSignalAndResponse(processSignal, expectedClientJoin, clientConnectionId, updateProviders, clock, latency) {
+    // Pass a little time (to mimic reality)
+    clock.tick(latency);
+    // Return the [local] join signal
+    processSignal([], { ...expectedClientJoin, clientId: clientConnectionId }, true);
+    if (updateProviders.length > 0) {
+        // Pass time (to mimic likely response)
+        clock.tick(test_1.broadcastJoinResponseDelaysMs.namedResponder + 20);
+        // Send a fake join response
+        // There are no other attendees in the session (not realistic) but this
+        // convinces the presence manager that it now has full knowledge, which
+        // enables it to respond to other's join requests accurately.
+        processSignal([], {
+            type: "Pres:DatastoreUpdate",
+            content: {
+                ...expectedClientJoin.content,
+                isComplete: true,
+                joinResponseFor: [clientConnectionId],
+            },
+            clientId: updateProviders[0],
+        }, false);
+    }
+}
+/**
+ * The simulated local average latency used in test helpers.
+ */
+const localAvgLatency = 10;
+/**
+ * Creates presence manager for testing.
+ */
+function createPresence(runtime, attendeeId, logger) {
+    logger.registerExpectedEvent({ eventName: "Presence:PresenceInstantiated" });
+    const presence = (0, test_1.createPresenceManager)(runtime, attendeeId);
+    const processSignal = createProcessSignal(presence);
+    // Validate expectations post initialization to make sure logger
+    // and runtime are left in a clean expectation state.
+    const logErrors = (0, internal_1.getUnexpectedLogErrorException)(logger);
+    if (logErrors) {
+        throw logErrors;
+    }
+    return { presence, processSignal };
+}
+/**
+ * Prepares an instance of presence as it would be if initialized while connected.
+ *
+ * @param runtime - the mock runtime
+ * @param attendeeId - the client session id given to presence
+ * @param clientConnectionId - the client connection id
+ * @param clock - the fake timer.
+ * @param logger - logger to track telemetry events
+ */
+function prepareConnectedPresence(runtime, attendeeId, clientConnectionId, clock, logger) {
+    // Set runtime to connected state
+    runtime.clientId = clientConnectionId;
+    runtime.joined = true;
+    const { expectedClientJoin, updateProviders } = prepareExpectedClientJoin(runtime, attendeeId, clientConnectionId, clock);
+    const { presence, processSignal } = createPresence(runtime, attendeeId, logger);
+    runtime.assertAllSignalsSubmitted();
+    processJoinSignalAndResponse(processSignal, expectedClientJoin, clientConnectionId, updateProviders, clock, localAvgLatency);
+    return {
+        presence,
+        processSignal,
+        localAvgLatency,
+    };
+}
+exports.prepareConnectedPresence = prepareConnectedPresence;
+/**
+ * Prepares an instance of presence in a disconnected state.
+ *
+ * @remarks
+ * Use this helper when you need to test events that occur during the initial
+ * connection, such as `attendeeConnected` for the local client.
+ *
+ * @param runtime - the mock runtime
+ * @param attendeeId - the client session id given to presence
+ * @param clientConnectionId - the client connection id to use when connecting
+ * @param clock - the fake timer
+ * @param logger - logger to track telemetry events
+ */
+function prepareDisconnectedPresence(runtime, attendeeId, clientConnectionId, clock, logger) {
+    // Ensure runtime is in disconnected state
+    runtime.clientId = undefined;
+    runtime.joined = false;
+    // Remove client connection id from audience if present
+    if (runtime.audience.getMember(clientConnectionId) !== undefined) {
+        runtime.removeMember(clientConnectionId);
+    }
+    const { presence, processSignal } = createPresence(runtime, attendeeId, logger);
+    const connect = () => {
+        const { expectedClientJoin, updateProviders } = prepareExpectedClientJoin(runtime, attendeeId, clientConnectionId, clock);
+        // Simulate connection
+        runtime.connect(clientConnectionId, undefined);
+        // Validate signal was submitted
+        runtime.assertAllSignalsSubmitted();
+        processJoinSignalAndResponse(processSignal, expectedClientJoin, clientConnectionId, updateProviders, clock, localAvgLatency);
+    };
+    return {
+        presence,
+        processSignal,
+        connect,
+        localAvgLatency,
+    };
+}
+exports.prepareDisconnectedPresence = prepareDisconnectedPresence;
+/**
+ * Asserts that all expected telemetry and signals were sent.
+ */
+function assertFinalExpectations(runtime, logger) {
+    // Make sure all expected events were logged and there are no unexpected errors.
+    const logErrors = (0, internal_1.getUnexpectedLogErrorException)(logger);
+    if (logErrors) {
+        throw logErrors;
+    }
+    // Make sure all expected signals were sent.
+    runtime.assertAllSignalsSubmitted();
+}
+exports.assertFinalExpectations = assertFinalExpectations;
+/**
+ * A null validator (one that does nothing) for a given type T. It simply casts the value to
+ * `JsonDeserialized<T>`.
+ */
+const nullValidator = (data) => {
+    return data;
+};
+/**
+ * Creates a spied validator for test purposes.
+ *
+ * @param validatorFunction - A {@link StateSchemaValidator} to wrap in a spy.
+ */
+const createSpiedValidator = (validatorFunction = (nullValidator)) => (0, sinon_1.spy)(validatorFunction);
+exports.createSpiedValidator = createSpiedValidator;
+//# sourceMappingURL=testUtils.js.map

package/dist/test/testUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testUtils.js","sourceRoot":"","sources":["../../src/test/testUtils.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 type {\n\tAttendeeId,\n\tClientConnectionId,\n\tPresenceWithNotifications,\n\tStateSchemaValidator,\n} from \"@fluid-internal/presence-definitions\";\nimport type { InboundExtensionMessage } from \"@fluidframework/container-runtime-definitions/internal\";\nimport type {\n\tInternalCoreInterfacesUtilityTypes,\n\tJsonDeserialized,\n} from \"@fluidframework/core-interfaces/internal\";\nimport type { EventAndErrorTrackingLogger } from \"@fluidframework/test-utils/internal\";\nimport { getUnexpectedLogErrorException } from \"@fluidframework/test-utils/internal\";\nimport { spy } from \"sinon\";\nimport type { SinonFakeTimers } from \"sinon\";\n\nimport type {\n\tInboundClientJoinMessage,\n\tInboundDatastoreUpdateMessage,\n\tOutboundClientJoinMessage,\n\tSignalMessages,\n\tSystemWorkspaceDatastore,\n} from \"@fluid-internal/presence-runtime/internal/protocol\";\nimport {\n\tbroadcastJoinResponseDelaysMs,\n\tcreatePresenceManager,\n} from \"@fluid-internal/presence-runtime/internal/test\";\n\nimport type { MockEphemeralRuntime } from \"./mockEphemeralRuntime.js\";\nimport { initialLocalClientConnectionId } from \"./mockEphemeralRuntime.js\";\n\n/**\n * Use to compile-time assert types of two variables are identical.\n */\nexport function assertIdenticalTypes<T, U>(\n\t_actual: T & InternalCoreInterfacesUtilityTypes.IfSameType<T, U>,\n\t_expected: U & InternalCoreInterfacesUtilityTypes.IfSameType<T, U>,\n): InternalCoreInterfacesUtilityTypes.IfSameType<T, U> {\n\treturn undefined as InternalCoreInterfacesUtilityTypes.IfSameType<T, U>;\n}\n\n/**\n * Creates a non-viable (`undefined`) instance of type T to be used for type checking.\n */\nexport function createInstanceOf<T>(): T {\n\treturn undefined as T;\n}\n\ntype SpecificAttendeeId<T extends string> = string extends T\n\t? never\n\t: Exclude<T & AttendeeId, never>;\n\n/**\n * Forms {@link AttendeeId} for a specific attendee\n */\nexport function createSpecificAttendeeId<const T extends string>(\n\tid: T,\n): SpecificAttendeeId<T> {\n\treturn id as SpecificAttendeeId<T>;\n}\n\n/**\n * Mock {@link AttendeeId}.\n */\nexport const attendeeId1 = createSpecificAttendeeId(\"attendeeId-1\");\n/**\n * Mock {@link ClientConnectionId}.\n */\nexport const connectionId1 = \"client1\" as const satisfies ClientConnectionId;\n/**\n * Mock {@link AttendeeId} for the local client in tests.\n */\nexport const localAttendeeId = createSpecificAttendeeId(\"localAttendeeId\");\n\n/**\n * Generates expected inbound join signal for a client that was initialized while connected.\n */\nexport function generateBasicClientJoin(\n\tfixedTime: number,\n\t{\n\t\tattendeeId = localAttendeeId,\n\t\tclientConnectionId = initialLocalClientConnectionId,\n\t\tupdateProviders = [\"client0\", \"client1\", \"client3\"],\n\t\tconnectionOrder = 0,\n\t\taverageLatency = 0,\n\t\tpriorClientToSessionId = {},\n\t}: {\n\t\tattendeeId?: string;\n\t\tclientConnectionId?: ClientConnectionId;\n\t\tupdateProviders?: string[];\n\t\tconnectionOrder?: number;\n\t\taverageLatency?: number;\n\t\tpriorClientToSessionId?: SystemWorkspaceDatastore[\"clientToSessionId\"];\n\t},\n): InboundClientJoinMessage {\n\treturn {\n\t\ttype: \"Pres:ClientJoin\",\n\t\tcontent: {\n\t\t\t\"avgLatency\": averageLatency,\n\t\t\t\"data\": {\n\t\t\t\t\"system:presence\": {\n\t\t\t\t\t\"clientToSessionId\": {\n\t\t\t\t\t\t...priorClientToSessionId,\n\t\t\t\t\t\t[clientConnectionId]: {\n\t\t\t\t\t\t\t\"rev\": connectionOrder,\n\t\t\t\t\t\t\t\"timestamp\": fixedTime,\n\t\t\t\t\t\t\t\"value\": attendeeId as AttendeeId,\n\t\t\t\t\t\t},\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t},\n\t\t\t\"sendTimestamp\": fixedTime,\n\t\t\tupdateProviders,\n\t\t},\n\t\tclientId: clientConnectionId,\n\t};\n}\n\n/**\n * Function signature for sending a signal to the presence manager.\n */\nexport type ProcessSignalFunction = ReturnType<typeof createPresenceManager>[\"processSignal\"];\n\n/**\n * Expected shape of Presence signals\n */\nexport type InboundPresenceSignalMessage = InboundExtensionMessage<SignalMessages>;\n\n/**\n * Creates a processSignal wrapper function for a presence manager.\n */\nfunction createProcessSignal(\n\tpresence: ReturnType<typeof createPresenceManager>,\n): ProcessSignalFunction {\n\treturn (\n\t\taddressChain: string[],\n\t\tsignalMessage: InboundPresenceSignalMessage,\n\t\tlocal: boolean,\n\t): void => {\n\t\t// Pass on to presence manager, but first clone the message to avoid\n\t\t// possibility of Presence mutating the original message which often\n\t\t// contains reference to general (shared) test data.\n\t\t// Additionally JSON.parse(JSON.stringify(signalMessage)) is used to\n\t\t// ensure only regular JSON-serializable data is passed to Presence.\n\t\t// In production environment, the message is always extracted from\n\t\t// the network and Presence can safely mutate it.\n\t\tpresence.processSignal(\n\t\t\taddressChain,\n\t\t\t// eslint-disable-next-line unicorn/prefer-structured-clone -- not structural clone, but filters to JSON-serializable data\n\t\t\tJSON.parse(JSON.stringify(signalMessage)) as InboundPresenceSignalMessage,\n\t\t\tlocal,\n\t\t);\n\t};\n}\n\n/**\n * Calculates update providers based on current audience members.\n */\nfunction calculateUpdateProviders(\n\truntime: MockEphemeralRuntime,\n\tclientConnectionId: ClientConnectionId,\n): ClientConnectionId[] {\n\t// This logic needs to be kept in sync with datastore manager.\n\t// From PresenceDatastoreManager.getAudienceInformation:\n\tconst members = runtime.audience.getMembers();\n\tmembers.delete(clientConnectionId);\n\tconst all = new Set<ClientConnectionId>();\n\tconst writers = new Set<ClientConnectionId>();\n\tfor (const [id, client] of members) {\n\t\tif (client.details.capabilities.interactive) {\n\t\t\tall.add(id);\n\t\t\tif (client.mode === \"write\") {\n\t\t\t\twriters.add(id);\n\t\t\t}\n\t\t}\n\t}\n\t// From PresenceDatastoreManager.joinSession:\n\tconst updateProviders = [...(writers.size > 0 ? writers : all)];\n\tif (updateProviders.length > 3) {\n\t\tupdateProviders.length = 3;\n\t}\n\treturn updateProviders;\n}\n\n/**\n * Prepares the expected client join signal and calculates update providers.\n */\nfunction prepareExpectedClientJoin(\n\truntime: MockEphemeralRuntime,\n\tattendeeId: string,\n\tclientConnectionId: ClientConnectionId,\n\tclock: Omit<SinonFakeTimers, \"restore\">,\n): {\n\texpectedClientJoin: OutboundClientJoinMessage &\n\t\tPartial<Pick<InboundClientJoinMessage, \"clientId\">>;\n\tupdateProviders: ClientConnectionId[];\n} {\n\tconst updateProviders = calculateUpdateProviders(runtime, clientConnectionId);\n\n\tconst expectedClientJoin: OutboundClientJoinMessage &\n\t\tPartial<Pick<InboundClientJoinMessage, \"clientId\">> = generateBasicClientJoin(clock.now, {\n\t\tattendeeId,\n\t\tclientConnectionId,\n\t\tupdateProviders,\n\t});\n\tdelete expectedClientJoin.clientId;\n\truntime.signalsExpected.push([expectedClientJoin]);\n\n\treturn { expectedClientJoin, updateProviders };\n}\n\n/**\n * Processes the local join signal and sends a fake join response.\n */\nfunction processJoinSignalAndResponse(\n\tprocessSignal: ProcessSignalFunction,\n\texpectedClientJoin: OutboundClientJoinMessage &\n\t\tPartial<Pick<InboundClientJoinMessage, \"clientId\">>,\n\tclientConnectionId: ClientConnectionId,\n\tupdateProviders: ClientConnectionId[],\n\tclock: Omit<SinonFakeTimers, \"restore\">,\n\tlatency: number,\n): void {\n\t// Pass a little time (to mimic reality)\n\tclock.tick(latency);\n\n\t// Return the [local] join signal\n\tprocessSignal([], { ...expectedClientJoin, clientId: clientConnectionId }, true);\n\n\tif (updateProviders.length > 0) {\n\t\t// Pass time (to mimic likely response)\n\t\tclock.tick(broadcastJoinResponseDelaysMs.namedResponder + 20);\n\n\t\t// Send a fake join response\n\t\t// There are no other attendees in the session (not realistic) but this\n\t\t// convinces the presence manager that it now has full knowledge, which\n\t\t// enables it to respond to other's join requests accurately.\n\t\tprocessSignal(\n\t\t\t[],\n\t\t\t{\n\t\t\t\ttype: \"Pres:DatastoreUpdate\",\n\t\t\t\tcontent: {\n\t\t\t\t\t...expectedClientJoin.content,\n\t\t\t\t\tisComplete: true,\n\t\t\t\t\tjoinResponseFor: [clientConnectionId],\n\t\t\t\t},\n\t\t\t\tclientId: updateProviders[0],\n\t\t\t} satisfies InboundDatastoreUpdateMessage,\n\t\t\tfalse,\n\t\t);\n\t}\n}\n\n/**\n * The simulated local average latency used in test helpers.\n */\nconst localAvgLatency = 10;\n\n/**\n * Creates presence manager for testing.\n */\nfunction createPresence(\n\truntime: MockEphemeralRuntime,\n\tattendeeId: string,\n\tlogger: EventAndErrorTrackingLogger,\n): {\n\tpresence: ReturnType<typeof createPresenceManager>;\n\tprocessSignal: ProcessSignalFunction;\n} {\n\tlogger.registerExpectedEvent({ eventName: \"Presence:PresenceInstantiated\" });\n\n\tconst presence = createPresenceManager(runtime, attendeeId as AttendeeId);\n\tconst processSignal = createProcessSignal(presence);\n\n\t// Validate expectations post initialization to make sure logger\n\t// and runtime are left in a clean expectation state.\n\tconst logErrors = getUnexpectedLogErrorException(logger);\n\tif (logErrors) {\n\t\tthrow logErrors;\n\t}\n\n\treturn { presence, processSignal };\n}\n\n/**\n * Prepares an instance of presence as it would be if initialized while connected.\n *\n * @param runtime - the mock runtime\n * @param attendeeId - the client session id given to presence\n * @param clientConnectionId - the client connection id\n * @param clock - the fake timer.\n * @param logger - logger to track telemetry events\n */\nexport function prepareConnectedPresence(\n\truntime: MockEphemeralRuntime,\n\tattendeeId: string,\n\tclientConnectionId: ClientConnectionId,\n\tclock: Omit<SinonFakeTimers, \"restore\">,\n\tlogger: EventAndErrorTrackingLogger,\n): {\n\tpresence: PresenceWithNotifications;\n\tprocessSignal: ProcessSignalFunction;\n\tlocalAvgLatency: number;\n} {\n\t// Set runtime to connected state\n\truntime.clientId = clientConnectionId;\n\truntime.joined = true;\n\n\tconst { expectedClientJoin, updateProviders } = prepareExpectedClientJoin(\n\t\truntime,\n\t\tattendeeId,\n\t\tclientConnectionId,\n\t\tclock,\n\t);\n\n\tconst { presence, processSignal } = createPresence(runtime, attendeeId, logger);\n\truntime.assertAllSignalsSubmitted();\n\n\tprocessJoinSignalAndResponse(\n\t\tprocessSignal,\n\t\texpectedClientJoin,\n\t\tclientConnectionId,\n\t\tupdateProviders,\n\t\tclock,\n\t\tlocalAvgLatency,\n\t);\n\n\treturn {\n\t\tpresence,\n\t\tprocessSignal,\n\t\tlocalAvgLatency,\n\t};\n}\n\n/**\n * Prepares an instance of presence in a disconnected state.\n *\n * @remarks\n * Use this helper when you need to test events that occur during the initial\n * connection, such as `attendeeConnected` for the local client.\n *\n * @param runtime - the mock runtime\n * @param attendeeId - the client session id given to presence\n * @param clientConnectionId - the client connection id to use when connecting\n * @param clock - the fake timer\n * @param logger - logger to track telemetry events\n */\nexport function prepareDisconnectedPresence(\n\truntime: MockEphemeralRuntime,\n\tattendeeId: string,\n\tclientConnectionId: ClientConnectionId,\n\tclock: Omit<SinonFakeTimers, \"restore\">,\n\tlogger: EventAndErrorTrackingLogger,\n): {\n\tpresence: PresenceWithNotifications;\n\tprocessSignal: ProcessSignalFunction;\n\t/**\n\t * Connects presence using the client connection id provided to prepareDisconnectedPresence.\n\t */\n\tconnect: () => void;\n\t/**\n\t * The simulated local average latency used by connect.\n\t */\n\tlocalAvgLatency: number;\n} {\n\t// Ensure runtime is in disconnected state\n\truntime.clientId = undefined;\n\truntime.joined = false;\n\n\t// Remove client connection id from audience if present\n\tif (runtime.audience.getMember(clientConnectionId) !== undefined) {\n\t\truntime.removeMember(clientConnectionId);\n\t}\n\n\tconst { presence, processSignal } = createPresence(runtime, attendeeId, logger);\n\n\tconst connect = (): void => {\n\t\tconst { expectedClientJoin, updateProviders } = prepareExpectedClientJoin(\n\t\t\truntime,\n\t\t\tattendeeId,\n\t\t\tclientConnectionId,\n\t\t\tclock,\n\t\t);\n\n\t\t// Simulate connection\n\t\truntime.connect(clientConnectionId, undefined);\n\n\t\t// Validate signal was submitted\n\t\truntime.assertAllSignalsSubmitted();\n\n\t\tprocessJoinSignalAndResponse(\n\t\t\tprocessSignal,\n\t\t\texpectedClientJoin,\n\t\t\tclientConnectionId,\n\t\t\tupdateProviders,\n\t\t\tclock,\n\t\t\tlocalAvgLatency,\n\t\t);\n\t};\n\n\treturn {\n\t\tpresence,\n\t\tprocessSignal,\n\t\tconnect,\n\t\tlocalAvgLatency,\n\t};\n}\n\n/**\n * Asserts that all expected telemetry and signals were sent.\n */\nexport function assertFinalExpectations(\n\truntime: MockEphemeralRuntime,\n\tlogger: EventAndErrorTrackingLogger,\n): void {\n\t// Make sure all expected events were logged and there are no unexpected errors.\n\tconst logErrors = getUnexpectedLogErrorException(logger);\n\tif (logErrors) {\n\t\tthrow logErrors;\n\t}\n\t// Make sure all expected signals were sent.\n\truntime.assertAllSignalsSubmitted();\n}\n\n/**\n * A null validator (one that does nothing) for a given type T. It simply casts the value to\n * `JsonDeserialized<T>`.\n */\nconst nullValidator = <T extends object>(data: unknown): JsonDeserialized<T> => {\n\treturn data as JsonDeserialized<T>;\n};\n\n/**\n * Creates a spied validator for test purposes.\n *\n * @param validatorFunction - A {@link StateSchemaValidator} to wrap in a spy.\n */\nexport const createSpiedValidator = <T extends object>(\n\tvalidatorFunction: StateSchemaValidator<T> = nullValidator<T>,\n\t// eslint-disable-next-line @typescript-eslint/explicit-module-boundary-types, @typescript-eslint/explicit-function-return-type\n) => spy(validatorFunction) satisfies StateSchemaValidator<T>;\n"]}

package/dist/test/utils/index.js

@@ -0,0 +1,27 @@
+"use strict";
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MockEphemeralRuntime = exports.initialLocalClientConnectionId = void 0;
+var mockEphemeralRuntime_js_1 = require("../mockEphemeralRuntime.js");
+Object.defineProperty(exports, "initialLocalClientConnectionId", { enumerable: true, get: function () { return mockEphemeralRuntime_js_1.initialLocalClientConnectionId; } });
+Object.defineProperty(exports, "MockEphemeralRuntime", { enumerable: true, get: function () { return mockEphemeralRuntime_js_1.MockEphemeralRuntime; } });
+// eslint-disable-next-line no-restricted-syntax -- internally export all testUtils exports
+__exportStar(require("../testUtils.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/test/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/test/utils/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;AAEH,sEAGoC;AAFnC,yIAAA,8BAA8B,OAAA;AAC9B,+HAAA,oBAAoB,OAAA;AAGrB,2FAA2F;AAC3F,kDAAgC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nexport {\n\tinitialLocalClientConnectionId,\n\tMockEphemeralRuntime,\n} from \"../mockEphemeralRuntime.js\";\n\n// eslint-disable-next-line no-restricted-syntax -- internally export all testUtils exports\nexport * from \"../testUtils.js\";\n"]}

package/dist/utils/broadcastControls.d.ts

@@ -0,0 +1,37 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import type { BroadcastControls, BroadcastControlSettings } from "@fluid-internal/presence-definitions";
+declare class ForcedRefreshControl implements Pick<BroadcastControls & {
+    forcedRefreshIntervalMs: number | undefined;
+}, "forcedRefreshIntervalMs"> {
+    private _forcedRefreshInterval;
+    constructor(settings?: BroadcastControlSettings);
+    get forcedRefreshIntervalMs(): number | undefined;
+    set forcedRefreshIntervalMs(value: number | undefined);
+}
+/**
+ * Implements {@link BroadcastControls} for States Managers
+ * where returning `undefined` settings are allowed.
+ */
+export declare class OptionalBroadcastControl extends ForcedRefreshControl implements BroadcastControls {
+    allowableUpdateLatencyMs: number | undefined;
+    constructor(settings?: BroadcastControlSettings);
+}
+/**
+ * Implements {@link BroadcastControls} but always provides defined value for
+ * {@link BroadcastControls.allowableUpdateLatencyMs | allowableUpdateLatencyMs}.
+ *
+ * If {@link BroadcastControls.allowableUpdateLatencyMs | allowableUpdateLatencyMs}
+ * is set to `undefined`, the default will be restored.
+ */
+export declare class RequiredBroadcastControl extends ForcedRefreshControl implements BroadcastControls {
+    private readonly defaultAllowableUpdateLatencyMs;
+    private _allowableUpdateLatencyMs;
+    constructor(defaultAllowableUpdateLatencyMs: number);
+    get allowableUpdateLatencyMs(): number;
+    set allowableUpdateLatencyMs(value: number | undefined);
+}
+export {};
+//# sourceMappingURL=broadcastControls.d.ts.map

package/dist/utils/broadcastControls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcastControls.d.ts","sourceRoot":"","sources":["../../src/utils/broadcastControls.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACX,iBAAiB,EACjB,wBAAwB,EACxB,MAAM,sCAAsC,CAAC;AAE9C,cAAM,oBACL,YACC,IAAI,CACH,iBAAiB,GAAG;IAAE,uBAAuB,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,EACnE,yBAAyB,CACzB;IAEF,OAAO,CAAC,sBAAsB,CAAqB;gBAEhC,QAAQ,CAAC,EAAE,wBAAwB;IAItD,IAAW,uBAAuB,IAAI,MAAM,GAAG,SAAS,CAEvD;IACD,IAAW,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAU3D;CACD;AAED;;;GAGG;AACH,qBAAa,wBACZ,SAAQ,oBACR,YAAW,iBAAiB;IAErB,wBAAwB,EAAE,MAAM,GAAG,SAAS,CAAC;gBAEjC,QAAQ,CAAC,EAAE,wBAAwB;CAItD;AAED;;;;;;GAMG;AACH,qBAAa,wBACZ,SAAQ,oBACR,YAAW,iBAAiB;IAIT,OAAO,CAAC,QAAQ,CAAC,+BAA+B;IAFnE,OAAO,CAAC,yBAAyB,CAAS;gBAEN,+BAA+B,EAAE,MAAM;IAK3E,IAAW,wBAAwB,IAAI,MAAM,CAE5C;IACD,IAAW,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAE5D;CACD"}

package/dist/utils/broadcastControls.js

@@ -0,0 +1,60 @@
+"use strict";
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequiredBroadcastControl = exports.OptionalBroadcastControl = void 0;
+class ForcedRefreshControl {
+    constructor(settings) {
+        // this._forcedRefreshInterval = settings?.forcedRefreshIntervalMs;
+    }
+    get forcedRefreshIntervalMs() {
+        return this._forcedRefreshInterval;
+    }
+    set forcedRefreshIntervalMs(value) {
+        if (value === undefined) {
+            this._forcedRefreshInterval = undefined;
+        }
+        else {
+            this._forcedRefreshInterval = value >= 10 ? value : undefined;
+            if (value >= 10) {
+                // TODO: enable periodic forced refresh
+                throw new Error("Forced Refresh feature is not implemented");
+            }
+        }
+    }
+}
+/**
+ * Implements {@link BroadcastControls} for States Managers
+ * where returning `undefined` settings are allowed.
+ */
+class OptionalBroadcastControl extends ForcedRefreshControl {
+    constructor(settings) {
+        super(settings);
+        this.allowableUpdateLatencyMs = settings?.allowableUpdateLatencyMs;
+    }
+}
+exports.OptionalBroadcastControl = OptionalBroadcastControl;
+/**
+ * Implements {@link BroadcastControls} but always provides defined value for
+ * {@link BroadcastControls.allowableUpdateLatencyMs | allowableUpdateLatencyMs}.
+ *
+ * If {@link BroadcastControls.allowableUpdateLatencyMs | allowableUpdateLatencyMs}
+ * is set to `undefined`, the default will be restored.
+ */
+class RequiredBroadcastControl extends ForcedRefreshControl {
+    constructor(defaultAllowableUpdateLatencyMs) {
+        super();
+        this.defaultAllowableUpdateLatencyMs = defaultAllowableUpdateLatencyMs;
+        this._allowableUpdateLatencyMs = defaultAllowableUpdateLatencyMs;
+    }
+    get allowableUpdateLatencyMs() {
+        return this._allowableUpdateLatencyMs;
+    }
+    set allowableUpdateLatencyMs(value) {
+        this._allowableUpdateLatencyMs = value ?? this.defaultAllowableUpdateLatencyMs;
+    }
+}
+exports.RequiredBroadcastControl = RequiredBroadcastControl;
+//# sourceMappingURL=broadcastControls.js.map

package/dist/utils/broadcastControls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcastControls.js","sourceRoot":"","sources":["../../src/utils/broadcastControls.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAOH,MAAM,oBAAoB;IASzB,YAAmB,QAAmC;QACrD,mEAAmE;IACpE,CAAC;IAED,IAAW,uBAAuB;QACjC,OAAO,IAAI,CAAC,sBAAsB,CAAC;IACpC,CAAC;IACD,IAAW,uBAAuB,CAAC,KAAyB;QAC3D,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACzB,IAAI,CAAC,sBAAsB,GAAG,SAAS,CAAC;QACzC,CAAC;aAAM,CAAC;YACP,IAAI,CAAC,sBAAsB,GAAG,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;YAC9D,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;gBACjB,uCAAuC;gBACvC,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;YAC9D,CAAC;QACF,CAAC;IACF,CAAC;CACD;AAED;;;GAGG;AACH,MAAa,wBACZ,SAAQ,oBAAoB;IAK5B,YAAmB,QAAmC;QACrD,KAAK,CAAC,QAAQ,CAAC,CAAC;QAChB,IAAI,CAAC,wBAAwB,GAAG,QAAQ,EAAE,wBAAwB,CAAC;IACpE,CAAC;CACD;AAVD,4DAUC;AAED;;;;;;GAMG;AACH,MAAa,wBACZ,SAAQ,oBAAoB;IAK5B,YAAoC,+BAAuC;QAC1E,KAAK,EAAE,CAAC;QAD2B,oCAA+B,GAA/B,+BAA+B,CAAQ;QAE1E,IAAI,CAAC,yBAAyB,GAAG,+BAA+B,CAAC;IAClE,CAAC;IAED,IAAW,wBAAwB;QAClC,OAAO,IAAI,CAAC,yBAAyB,CAAC;IACvC,CAAC;IACD,IAAW,wBAAwB,CAAC,KAAyB;QAC5D,IAAI,CAAC,yBAAyB,GAAG,KAAK,IAAI,IAAI,CAAC,+BAA+B,CAAC;IAChF,CAAC;CACD;AAjBD,4DAiBC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport type {\n\tBroadcastControls,\n\tBroadcastControlSettings,\n} from \"@fluid-internal/presence-definitions\";\n\nclass ForcedRefreshControl\n\timplements\n\t\tPick<\n\t\t\tBroadcastControls & { forcedRefreshIntervalMs: number | undefined },\n\t\t\t\"forcedRefreshIntervalMs\"\n\t\t>\n{\n\tprivate _forcedRefreshInterval: number | undefined;\n\n\tpublic constructor(settings?: BroadcastControlSettings) {\n\t\t// this._forcedRefreshInterval = settings?.forcedRefreshIntervalMs;\n\t}\n\n\tpublic get forcedRefreshIntervalMs(): number | undefined {\n\t\treturn this._forcedRefreshInterval;\n\t}\n\tpublic set forcedRefreshIntervalMs(value: number | undefined) {\n\t\tif (value === undefined) {\n\t\t\tthis._forcedRefreshInterval = undefined;\n\t\t} else {\n\t\t\tthis._forcedRefreshInterval = value >= 10 ? value : undefined;\n\t\t\tif (value >= 10) {\n\t\t\t\t// TODO: enable periodic forced refresh\n\t\t\t\tthrow new Error(\"Forced Refresh feature is not implemented\");\n\t\t\t}\n\t\t}\n\t}\n}\n\n/**\n * Implements {@link BroadcastControls} for States Managers\n * where returning `undefined` settings are allowed.\n */\nexport class OptionalBroadcastControl\n\textends ForcedRefreshControl\n\timplements BroadcastControls\n{\n\tpublic allowableUpdateLatencyMs: number | undefined;\n\n\tpublic constructor(settings?: BroadcastControlSettings) {\n\t\tsuper(settings);\n\t\tthis.allowableUpdateLatencyMs = settings?.allowableUpdateLatencyMs;\n\t}\n}\n\n/**\n * Implements {@link BroadcastControls} but always provides defined value for\n * {@link BroadcastControls.allowableUpdateLatencyMs | allowableUpdateLatencyMs}.\n *\n * If {@link BroadcastControls.allowableUpdateLatencyMs | allowableUpdateLatencyMs}\n * is set to `undefined`, the default will be restored.\n */\nexport class RequiredBroadcastControl\n\textends ForcedRefreshControl\n\timplements BroadcastControls\n{\n\tprivate _allowableUpdateLatencyMs: number;\n\n\tpublic constructor(private readonly defaultAllowableUpdateLatencyMs: number) {\n\t\tsuper();\n\t\tthis._allowableUpdateLatencyMs = defaultAllowableUpdateLatencyMs;\n\t}\n\n\tpublic get allowableUpdateLatencyMs(): number {\n\t\treturn this._allowableUpdateLatencyMs;\n\t}\n\tpublic set allowableUpdateLatencyMs(value: number | undefined) {\n\t\tthis._allowableUpdateLatencyMs = value ?? this.defaultAllowableUpdateLatencyMs;\n\t}\n}\n"]}

package/dist/utils/index.d.ts

@@ -0,0 +1,9 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+export { OptionalBroadcastControl, RequiredBroadcastControl } from "./broadcastControls.js";
+export { asDeeplyReadonly, asDeeplyReadonlyDeserializedJson, type FlattenUnionWithOptionals, getOrCreateRecord, isValueRequiredState, objectEntries, objectEntriesWithoutUndefined, objectKeys, type RecordEntryTypes, revealOpaqueJson, toOpaqueJson, } from "./internalUtils.js";
+export { TimerManager } from "./timerManager.js";
+export { brandIVM, unbrandIVM } from "./valueManager.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAE5F,OAAO,EACN,gBAAgB,EAChB,gCAAgC,EAChC,KAAK,yBAAyB,EAC9B,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,EACb,6BAA6B,EAC7B,UAAU,EACV,KAAK,gBAAgB,EACrB,gBAAgB,EAChB,YAAY,GACZ,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,26 @@
+"use strict";
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unbrandIVM = exports.brandIVM = exports.TimerManager = exports.toOpaqueJson = exports.revealOpaqueJson = exports.objectKeys = exports.objectEntriesWithoutUndefined = exports.objectEntries = exports.isValueRequiredState = exports.getOrCreateRecord = exports.asDeeplyReadonlyDeserializedJson = exports.asDeeplyReadonly = exports.RequiredBroadcastControl = exports.OptionalBroadcastControl = void 0;
+var broadcastControls_js_1 = require("./broadcastControls.js");
+Object.defineProperty(exports, "OptionalBroadcastControl", { enumerable: true, get: function () { return broadcastControls_js_1.OptionalBroadcastControl; } });
+Object.defineProperty(exports, "RequiredBroadcastControl", { enumerable: true, get: function () { return broadcastControls_js_1.RequiredBroadcastControl; } });
+var internalUtils_js_1 = require("./internalUtils.js");
+Object.defineProperty(exports, "asDeeplyReadonly", { enumerable: true, get: function () { return internalUtils_js_1.asDeeplyReadonly; } });
+Object.defineProperty(exports, "asDeeplyReadonlyDeserializedJson", { enumerable: true, get: function () { return internalUtils_js_1.asDeeplyReadonlyDeserializedJson; } });
+Object.defineProperty(exports, "getOrCreateRecord", { enumerable: true, get: function () { return internalUtils_js_1.getOrCreateRecord; } });
+Object.defineProperty(exports, "isValueRequiredState", { enumerable: true, get: function () { return internalUtils_js_1.isValueRequiredState; } });
+Object.defineProperty(exports, "objectEntries", { enumerable: true, get: function () { return internalUtils_js_1.objectEntries; } });
+Object.defineProperty(exports, "objectEntriesWithoutUndefined", { enumerable: true, get: function () { return internalUtils_js_1.objectEntriesWithoutUndefined; } });
+Object.defineProperty(exports, "objectKeys", { enumerable: true, get: function () { return internalUtils_js_1.objectKeys; } });
+Object.defineProperty(exports, "revealOpaqueJson", { enumerable: true, get: function () { return internalUtils_js_1.revealOpaqueJson; } });
+Object.defineProperty(exports, "toOpaqueJson", { enumerable: true, get: function () { return internalUtils_js_1.toOpaqueJson; } });
+var timerManager_js_1 = require("./timerManager.js");
+Object.defineProperty(exports, "TimerManager", { enumerable: true, get: function () { return timerManager_js_1.TimerManager; } });
+var valueManager_js_1 = require("./valueManager.js");
+Object.defineProperty(exports, "brandIVM", { enumerable: true, get: function () { return valueManager_js_1.brandIVM; } });
+Object.defineProperty(exports, "unbrandIVM", { enumerable: true, get: function () { return valueManager_js_1.unbrandIVM; } });
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,+DAA4F;AAAnF,gIAAA,wBAAwB,OAAA;AAAE,gIAAA,wBAAwB,OAAA;AAE3D,uDAY4B;AAX3B,oHAAA,gBAAgB,OAAA;AAChB,oIAAA,gCAAgC,OAAA;AAEhC,qHAAA,iBAAiB,OAAA;AACjB,wHAAA,oBAAoB,OAAA;AACpB,iHAAA,aAAa,OAAA;AACb,iIAAA,6BAA6B,OAAA;AAC7B,8GAAA,UAAU,OAAA;AAEV,oHAAA,gBAAgB,OAAA;AAChB,gHAAA,YAAY,OAAA;AAGb,qDAAiD;AAAxC,+GAAA,YAAY,OAAA;AAErB,qDAAyD;AAAhD,2GAAA,QAAQ,OAAA;AAAE,6GAAA,UAAU,OAAA","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nexport { OptionalBroadcastControl, RequiredBroadcastControl } from \"./broadcastControls.js\";\n\nexport {\n\tasDeeplyReadonly,\n\tasDeeplyReadonlyDeserializedJson,\n\ttype FlattenUnionWithOptionals,\n\tgetOrCreateRecord,\n\tisValueRequiredState,\n\tobjectEntries,\n\tobjectEntriesWithoutUndefined,\n\tobjectKeys,\n\ttype RecordEntryTypes,\n\trevealOpaqueJson,\n\ttoOpaqueJson,\n} from \"./internalUtils.js\";\n\nexport { TimerManager } from \"./timerManager.js\";\n\nexport { brandIVM, unbrandIVM } from \"./valueManager.js\";\n"]}

package/dist/utils/internalUtils.d.ts

@@ -0,0 +1,125 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import type { ValidatableOptionalState, ValidatableRequiredState } from "@fluid-internal/presence-definitions/internal";
+import type { DeepReadonly, InternalCoreInterfacesUtilityTypes, JsonDeserialized, JsonSerializable, OpaqueJsonDeserialized, OpaqueJsonSerializable } from "@fluidframework/core-interfaces/internal";
+/**
+ * Returns union of types of values in a record.
+ */
+export type RecordEntryTypes<T> = T[keyof T];
+type MapNumberIndicesToStrings<T> = {
+    [K in keyof T as K extends number ? `${K}` : K]: T[K];
+};
+type KeyValuePairs<T> = {
+    [K in keyof MapNumberIndicesToStrings<Required<T>>]: [K, Required<T>[K]];
+}[keyof MapNumberIndicesToStrings<Required<T>>][];
+type RequiredAndNotUndefined<T> = {
+    [K in keyof T]-?: Exclude<T[K], undefined>;
+};
+/**
+ * Object.entries retyped to preserve known keys and their types.
+ *
+ * @privateRemarks
+ * The is a defect in this utility when a string index appears in the object.
+ * In such a case, the only result is `[string, T]`, where `T` is the type
+ * of the string index entry.
+ */
+export declare const objectEntries: <const T>(o: T) => KeyValuePairs<T>;
+/**
+ * Object.entries retyped to preserve known keys and their types.
+ *
+ * @remarks
+ * Given `T` should not contain `undefined` values. If it does, use
+ * {@link objectEntries} instead. Without `undefined` values, this
+ * typing provides best handling of objects with optional properties.
+ */
+export declare const objectEntriesWithoutUndefined: <const T>(o: T) => KeyValuePairs<RequiredAndNotUndefined<T>>;
+/**
+ * Object.keys retyped to preserve known keys and their types.
+ */
+export declare const objectKeys: <const T>(o: T) => (keyof MapNumberIndicesToStrings<T>)[];
+/**
+ * Retrieve a value from a record with the given key, or create a new entry if
+ * the key is not in the record.
+ *
+ * @param record - The record to index/update
+ * @param key - The key to lookup in the record
+ * @param defaultValue - a function which returns a default value. This is
+ * called and used to set an initial value for the given key in the record if
+ * none exists.
+ * @returns either the existing value for the given key, or the newly-created
+ * value (the result of `defaultValue`)
+ */
+export declare function getOrCreateRecord<const K extends string | number | symbol, const V>(record: Record<K, V>, key: K, defaultValue: (key: K) => V): V;
+/**
+ * No-runtime-effect helper to apply deep immutability to a value's type.
+ */
+export declare function asDeeplyReadonly<T>(value: T): DeepReadonly<T>;
+export declare function asDeeplyReadonlyDeserializedJson<T>(value: OpaqueJsonDeserialized<T>): DeepReadonly<JsonDeserialized<T>>;
+export declare function asDeeplyReadonlyDeserializedJson<T>(value: OpaqueJsonDeserialized<T> | undefined): DeepReadonly<JsonDeserialized<T>> | undefined;
+/**
+ * Conditional type that reveals the underlying JSON type of an opaque JSON value. If `T` is an object, the key values
+ * will be revealed.
+ */
+type RevealOpaqueJsonDeserialized<T> = T extends OpaqueJsonDeserialized<infer U> ? JsonDeserialized<U> : {
+    [Key in keyof T]: RevealOpaqueJsonDeserialized<T[Key]>;
+};
+/**
+ * No-runtime-effect helper to reveal the JSON type from a value's opaque JSON
+ * types throughout a structure.
+ *
+ * @remarks
+ * {@link OpaqueJsonDeserialized} instances will be replaced shallowly such
+ * that nested instances are retained.
+ */
+export declare function revealOpaqueJson<T>(value: T): RevealOpaqueJsonDeserialized<T>;
+/**
+ * No-runtime-effect helper to automatically cast JSON type to Opaque JSON type
+ * at outermost scope.
+ *
+ * @remarks
+ * Types that satisfy {@link JsonSerializable} may also be deserialized. Thus,
+ * the return type is both {@link OpaqueJsonSerializable} and
+ * {@link OpaqueJsonDeserialized}.
+ */
+export declare function toOpaqueJson<const T>(value: JsonSerializable<T>): OpaqueJsonSerializable<T> & OpaqueJsonDeserialized<T>;
+/**
+ * Convert a union of types to an intersection of those types.
+ *
+ * @privateRemarks
+ * First an always true extends clause is used (T extends T) to distribute T
+ * into to a union of types contravariant over each member of the T union.
+ * Then the constraint on the type parameter in this new context is inferred,
+ * giving the intersection.
+ *
+ * Future: This definition is identical to one in `packages/dds/tree/src/util/typeUtils.ts`
+ * and should be consolidated.
+ */
+type UnionToIntersection<T> = (T extends T ? (k: T) => unknown : never) extends (k: infer U) => unknown ? U : never;
+/**
+ * Generates a union of types that are the remainder from a simple
+ * Pick combination (that is the set of common properties).
+ */
+type PickRemainder<T> = Pick<T, keyof T> extends infer Common ? T extends unknown ? Omit<T, keyof Common> : never : never;
+/**
+ * Combines union of structure into a single structure where common properties
+ * are unions of their respective types and optional properties are defined for
+ * properties that are not common to each union member.
+ *
+ * @remarks
+ * If a property is common to multiple, but not all union member and the
+ * types are incompatible, the resulting type will be `never` for that
+ * property. (This can be fixed, but might be best addressed by changing
+ * T to be a tuple of types to be combined.)
+ */
+export type FlattenUnionWithOptionals<T> = InternalCoreInterfacesUtilityTypes.FlattenIntersection<Pick<T, keyof T> & UnionToIntersection<Partial<PickRemainder<T>>>>;
+/**
+ * Type guard to check if a state is a required state (has a value).
+ *
+ * @param state - The state to check
+ * @returns True if the state has a value and is therefore a {@link ValidatableRequiredState}
+ */
+export declare function isValueRequiredState<T>(state: ValidatableRequiredState<T> | ValidatableOptionalState<T>): state is ValidatableRequiredState<T>;
+export {};
+//# sourceMappingURL=internalUtils.d.ts.map

package/dist/utils/internalUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internalUtils.d.ts","sourceRoot":"","sources":["../../src/utils/internalUtils.ts"],"names":[],"mappings":"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"}