@fluidframework/id-compressor 3.2.0 → 3.3.0

package/src/index.ts

@@ -13,6 +13,7 @@ export {
 	serializeIdCompressor,
 	toIdCompressorWithCore,
 } from "./idCompressor.js";
+export { SerializationVersion } from "./types/index.js";
 export { type FinalCompressedId, isFinalId } from "./identifiers.js";
 export {
 	createSessionId,
@@ -31,4 +32,6 @@ export type {
 	SessionId,
 	StableId,
 	IdCreationRange,
+	ShardToken,
+	ShardSynchronizationToken,
 } from "./types/index.js";

package/src/packageVersion.ts

@@ -6,4 +6,4 @@
  */
 
 export const pkgName = "@fluidframework/id-compressor";
-export const pkgVersion = "3.2.0";
+export const pkgVersion = "3.3.0";

package/src/test/idCompressorTestUtilities.ts

@@ -33,6 +33,7 @@ import {
 	toIdCompressorWithCore,
 } from "../index.js";
 import { SessionSpaceNormalizer } from "../sessionSpaceNormalizer.js";
+import { SerializationVersion } from "../types/index.js";
 import { assertIsSessionId, createSessionId, localIdFromGenCount } from "../utilities.js";
 
 import {
@@ -113,7 +114,11 @@ export class CompressorFactory {
 		clusterCapacity = 5,
 		logger?: ITelemetryBaseLogger,
 	): IdCompressor {
-		const compressor = createIdCompressor(sessionId, logger) as IdCompressor;
+		const compressor = createIdCompressor(
+			sessionId,
+			SerializationVersion.V3,
+			logger,
+		) as IdCompressor;
 		modifyClusterSize(compressor, clusterCapacity);
 		return compressor;
 	}
@@ -732,7 +737,10 @@ export function roundtrip(
 	const capacity: number = getClusterSize(compressor);
 	if (withSession) {
 		const serialized = compressor.serialize(withSession);
-		const roundtripped = IdCompressor.deserialize({ serialized });
+		const roundtripped = IdCompressor.deserialize({
+			serialized,
+			requestedWriteVersion: SerializationVersion.V3,
+		});
 		modifyClusterSize(roundtripped, capacity);
 		return [serialized, roundtripped];
 	} else {
@@ -740,6 +748,7 @@ export function roundtrip(
 		const roundtripped = IdCompressor.deserialize({
 			serialized: nonLocalSerialized,
 			newSessionId: createSessionId(),
+			requestedWriteVersion: SerializationVersion.V3,
 		});
 		modifyClusterSize(roundtripped, capacity);
 		return [nonLocalSerialized, roundtripped];
@@ -1085,7 +1094,11 @@ export function createAlwaysFinalizedIdCompressor(
 	// This local session is unused, but it needs to not collide with the GhostSession, so allocate a random one.
 	// This causes the compressor to serialize non-deterministically even when provided an explicit SessionId.
 	// This can be fixed in the future if needed.
-	const compressor = createIdCompressor(random.uuid4() as SessionId, logger);
+	const compressor = createIdCompressor(
+		random.uuid4() as SessionId,
+		SerializationVersion.V3,
+		logger,
+	);
 	// Permanently put the compressor in a ghost session
 	(compressor as IdCompressor).startGhostSession(sessionId);
 	return toIdCompressorWithCore(compressor);

package/src/test/snapshots/v2/compressor-with-finalized-range-from-one-client

@@ -0,0 +1 @@
+AAAAAAAAAEAAAAAAAAAAAAAAAAAAAPA/AAAAAAAA8D/pXqCZfUEHBR2USVl4/AABAAAAAAAAAAAAAAAAAFCAQAAAAAAAACRA

package/src/test/snapshots/v2/compressor-with-finalized-range-from-one-client-client2

@@ -0,0 +1 @@
+AAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=

package/src/test/snapshots/v2/compressors-with-finalized-ranges-from-two-clients

@@ -0,0 +1 @@
+AAAAAAAAAEAAAAAAAAAAAAAAAAAAAABAAAAAAAAAAEDpXqCZfUEHBR2USVl4/AAB3r8WOsPYt3ejBGppnQksAQAAAAAAAAAAAAAAAABQgEAAAAAAAAAkQAAAAAAAAPA/AAAAAABQgEAAAAAAAAAkQA==

package/src/test/snapshots/v2/compressors-with-finalized-ranges-from-two-clients-client2

@@ -0,0 +1 @@
+AAAAAAAAAEAAAAAAAAAAAAAAAAAAAABAAAAAAAAAAEDevxY6w9i3d6MEammdCSwB6V6gmX1BBwUdlElZePwAAQAAAAAAAPA/AAAAAABQgEAAAAAAAAAkQAAAAAAAAAAAAAAAAABQgEAAAAAAAAAkQA==

package/src/test/snapshots/v2/empty-compressor-summary

@@ -0,0 +1 @@
+AAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=

package/src/test/snapshots/v2/expansion-semantics

@@ -0,0 +1 @@
+AAAAAAAAAEAAAAAAAAAAAAAAAAAAAPA/AAAAAAAA8D/pXqCZfUEHBR2USVl4/AABAAAAAAAAAAAAAAAAAAAYQAAAAAAAABBA

package/src/test/snapshots/v2/expansion-semantics-client2

@@ -0,0 +1 @@
+AAAAAAAAAEAAAAAAAAAAAAAAAAAAAPA/AAAAAAAA8D/pXqCZfUEHBR2USVl4/AABAAAAAAAAAAAAAAAAAAAYQAAAAAAAABBA

package/src/test/snapshots/v3/compressor-with-finalized-range-from-one-client

@@ -0,0 +1 @@
+AAAAAAAACEAAAAAAAAAAAAAAAAAAAPA/AAAAAAAA8D/pXqCZfUEHBR2USVl4/AABAAAAAAAAAAAAAAAAAFCAQAAAAAAAACRA

package/src/test/snapshots/v3/compressor-with-finalized-range-from-one-client-client2

@@ -0,0 +1 @@
+AAAAAAAACEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=

package/src/test/snapshots/v3/compressors-with-finalized-ranges-from-two-clients

@@ -0,0 +1 @@
+AAAAAAAACEAAAAAAAAAAAAAAAAAAAABAAAAAAAAAAEDpXqCZfUEHBR2USVl4/AAB3r8WOsPYt3ejBGppnQksAQAAAAAAAAAAAAAAAABQgEAAAAAAAAAkQAAAAAAAAPA/AAAAAABQgEAAAAAAAAAkQA==

package/src/test/snapshots/v3/compressors-with-finalized-ranges-from-two-clients-client2

@@ -0,0 +1 @@
+AAAAAAAACEAAAAAAAAAAAAAAAAAAAABAAAAAAAAAAEDevxY6w9i3d6MEammdCSwB6V6gmX1BBwUdlElZePwAAQAAAAAAAPA/AAAAAABQgEAAAAAAAAAkQAAAAAAAAAAAAAAAAABQgEAAAAAAAAAkQA==

package/src/test/snapshots/v3/empty-compressor-summary

@@ -0,0 +1 @@
+AAAAAAAACEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=

package/src/test/snapshots/v3/expansion-semantics

@@ -0,0 +1 @@
+AAAAAAAACEAAAAAAAAAAAAAAAAAAAPA/AAAAAAAA8D/pXqCZfUEHBR2USVl4/AABAAAAAAAAAAAAAAAAAAAYQAAAAAAAABBA

package/src/test/snapshots/v3/expansion-semantics-client2

@@ -0,0 +1 @@
+AAAAAAAACEAAAAAAAAAAAAAAAAAAAPA/AAAAAAAA8D/pXqCZfUEHBR2USVl4/AABAAAAAAAAAAAAAAAAAAAYQAAAAAAAABBA

package/src/test/types/validateIdCompressorPrevious.generated.ts

@@ -7,7 +7,7 @@
  * THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY.
  * Generated by "flub generate typetests" from @fluid-tools/build-cli.
  *
- * Baseline (previous) version: 3.1.0
+ * Baseline (previous) version: 3.2.0
  */
 
 import type { TypeOnly, MinimalType, FullType, requireAssignableTo } from "@fluidframework/build-tools";
@@ -24,6 +24,7 @@ declare type MakeUnusedImportErrorsGoAway<T> = TypeOnly<T> | MinimalType<T> | Fu
  * typeValidation.broken:
  * "Function_createIdCompressor": {"backCompat": false}
  */
+// @ts-expect-error compatibility expected to be broken
 declare type current_as_old_for_Function_createIdCompressor = requireAssignableTo<TypeOnly<typeof current.createIdCompressor>, TypeOnly<typeof old.createIdCompressor>>
 
 /*
@@ -33,6 +34,7 @@ declare type current_as_old_for_Function_createIdCompressor = requireAssignableT
  * typeValidation.broken:
  * "Function_createSessionId": {"backCompat": false}
  */
+// @ts-expect-error compatibility expected to be broken
 declare type current_as_old_for_Function_createSessionId = requireAssignableTo<TypeOnly<typeof current.createSessionId>, TypeOnly<typeof old.createSessionId>>
 
 /*
@@ -42,6 +44,7 @@ declare type current_as_old_for_Function_createSessionId = requireAssignableTo<T
  * typeValidation.broken:
  * "Function_deserializeIdCompressor": {"backCompat": false}
  */
+// @ts-expect-error compatibility expected to be broken
 declare type current_as_old_for_Function_deserializeIdCompressor = requireAssignableTo<TypeOnly<typeof current.deserializeIdCompressor>, TypeOnly<typeof old.deserializeIdCompressor>>
 
 /*
@@ -51,6 +54,7 @@ declare type current_as_old_for_Function_deserializeIdCompressor = requireAssign
  * typeValidation.broken:
  * "Function_serializeIdCompressor": {"backCompat": false}
  */
+// @ts-expect-error compatibility expected to be broken
 declare type current_as_old_for_Function_serializeIdCompressor = requireAssignableTo<TypeOnly<typeof current.serializeIdCompressor>, TypeOnly<typeof old.serializeIdCompressor>>
 
 /*
@@ -60,6 +64,7 @@ declare type current_as_old_for_Function_serializeIdCompressor = requireAssignab
  * typeValidation.broken:
  * "Interface_IdCreationRange": {"forwardCompat": false}
  */
+// @ts-expect-error compatibility expected to be broken
 declare type old_as_current_for_Interface_IdCreationRange = requireAssignableTo<TypeOnly<old.IdCreationRange>, TypeOnly<current.IdCreationRange>>
 
 /*
@@ -69,6 +74,7 @@ declare type old_as_current_for_Interface_IdCreationRange = requireAssignableTo<
  * typeValidation.broken:
  * "Interface_IdCreationRange": {"backCompat": false}
  */
+// @ts-expect-error compatibility expected to be broken
 declare type current_as_old_for_Interface_IdCreationRange = requireAssignableTo<TypeOnly<current.IdCreationRange>, TypeOnly<old.IdCreationRange>>
 
 /*
@@ -105,6 +111,7 @@ declare type current_as_old_for_TypeAlias_OpSpaceCompressedId = requireAssignabl
  * typeValidation.broken:
  * "TypeAlias_SerializedIdCompressor": {"forwardCompat": false}
  */
+// @ts-expect-error compatibility expected to be broken
 declare type old_as_current_for_TypeAlias_SerializedIdCompressor = requireAssignableTo<TypeOnly<old.SerializedIdCompressor>, TypeOnly<current.SerializedIdCompressor>>
 
 /*
@@ -114,6 +121,7 @@ declare type old_as_current_for_TypeAlias_SerializedIdCompressor = requireAssign
  * typeValidation.broken:
  * "TypeAlias_SerializedIdCompressor": {"backCompat": false}
  */
+// @ts-expect-error compatibility expected to be broken
 declare type current_as_old_for_TypeAlias_SerializedIdCompressor = requireAssignableTo<TypeOnly<current.SerializedIdCompressor>, TypeOnly<old.SerializedIdCompressor>>
 
 /*
@@ -123,6 +131,7 @@ declare type current_as_old_for_TypeAlias_SerializedIdCompressor = requireAssign
  * typeValidation.broken:
  * "TypeAlias_SerializedIdCompressorWithNoSession": {"forwardCompat": false}
  */
+// @ts-expect-error compatibility expected to be broken
 declare type old_as_current_for_TypeAlias_SerializedIdCompressorWithNoSession = requireAssignableTo<TypeOnly<old.SerializedIdCompressorWithNoSession>, TypeOnly<current.SerializedIdCompressorWithNoSession>>
 
 /*
@@ -132,6 +141,7 @@ declare type old_as_current_for_TypeAlias_SerializedIdCompressorWithNoSession =
  * typeValidation.broken:
  * "TypeAlias_SerializedIdCompressorWithNoSession": {"backCompat": false}
  */
+// @ts-expect-error compatibility expected to be broken
 declare type current_as_old_for_TypeAlias_SerializedIdCompressorWithNoSession = requireAssignableTo<TypeOnly<current.SerializedIdCompressorWithNoSession>, TypeOnly<old.SerializedIdCompressorWithNoSession>>
 
 /*
@@ -141,6 +151,7 @@ declare type current_as_old_for_TypeAlias_SerializedIdCompressorWithNoSession =
  * typeValidation.broken:
  * "TypeAlias_SerializedIdCompressorWithOngoingSession": {"forwardCompat": false}
  */
+// @ts-expect-error compatibility expected to be broken
 declare type old_as_current_for_TypeAlias_SerializedIdCompressorWithOngoingSession = requireAssignableTo<TypeOnly<old.SerializedIdCompressorWithOngoingSession>, TypeOnly<current.SerializedIdCompressorWithOngoingSession>>
 
 /*
@@ -150,6 +161,7 @@ declare type old_as_current_for_TypeAlias_SerializedIdCompressorWithOngoingSessi
  * typeValidation.broken:
  * "TypeAlias_SerializedIdCompressorWithOngoingSession": {"backCompat": false}
  */
+// @ts-expect-error compatibility expected to be broken
 declare type current_as_old_for_TypeAlias_SerializedIdCompressorWithOngoingSession = requireAssignableTo<TypeOnly<current.SerializedIdCompressorWithOngoingSession>, TypeOnly<old.SerializedIdCompressorWithOngoingSession>>
 
 /*

package/src/types/idCompressor.ts

@@ -15,6 +15,28 @@ import type {
 	SerializedIdCompressorWithOngoingSession,
 } from "./persisted-types/index.js";
 
+/**
+ * Serialization format versions for IdCompressor.
+ * @internal
+ */
+export const SerializationVersion = {
+	/**
+	 * Base format without sharding support
+	 */
+	V2: 2,
+	/**
+	 * Adds optional sharding state
+	 */
+	V3: 3,
+} as const;
+
+/**
+ * Type representing valid serialization version values.
+ * @internal
+ */
+export type SerializationVersion =
+	(typeof SerializationVersion)[keyof typeof SerializationVersion];
+
 /**
  * A distributed UUID generator and compressor.
  *
@@ -85,6 +107,9 @@ export interface IIdCompressorCore {
 	 * range was taken (via this method or `takeUnfinalizedCreationRange`).
 	 * @returns the range of IDs, which may be empty. This range must be sent to the server for ordering before
 	 * it is finalized. Ranges must be sent to the server in the order that they are taken via calls to this method.
+	 * @throws if called on a child (non-root) shard. All shards in a shard tree share a single session, and only
+	 * the root shard may finalize that session's IDs with the server; a child's IDs are instead reconciled with the
+	 * root via {@link IIdCompressorCore.synchronizeWithShard} / {@link IIdCompressorCore.disposeShard}.
 	 */
 	takeNextCreationRange(): IdCreationRange;
 
@@ -143,18 +168,110 @@ export interface IIdCompressorCore {
 	beginGhostSession(ghostSessionId: SessionId, ghostSessionCallback: () => void): void;
 
 	/**
-	 * Returns a persistable form of the current state of this `IdCompressor` which can be rehydrated via `IdCompressor.deserialize()`.
+	 * Shards the ID space of this compressor such that multiple local compressors can safely share it without colliding.
+	 * This can allow multiple local instantiations of the same compressor to safely share an ID space in scenarios where
+	 * different threads do not have access to a central ID compressor.
+	 * @param newShardCount - The number of additional different shards to split this compressor into.
+	 * Must be a positive safe integer.
+	 * @throws If `newShardCount` is not a positive safe integer or the resulting stride exceeds the sharding limit.
+	 * @returns An array of serialized compressors of size `newShardCount`.
+	 * These can be passed across a marshalling boundary and rehydrated on the other side, and will safely share the ID space of `this`.
+	 * Note that this method should only be needed when multiple JS runtimes are in play, as sharded compressors essentially
+	 * attempt to emulate a single static compressor and any code running in the same JS runtime can simply use statics.
+	 */
+	shard(newShardCount: number): SerializedIdCompressorWithOngoingSession[];
+
+	/**
+	 * Synchronizes `this` compressor with a child shard. Synchronization will occur for the state of the child at the time `syncToken`
+	 * was generated, meaning that `this` compressor can use/ingest IDs generated up to that point. Attempts to use IDs from a child shard
+	 * without first synchronizing will result in an exception.
+	 *
+	 * If `syncToken` is a disposal token (its {@link ShardToken.disposed} flag is `true`, as produced by
+	 * {@link IIdCompressorCore.disposeShard}), this additionally deregisters the child shard and reclaims its subset of the ID space
+	 * into `this`. Once a shard has been disposed it is no longer safe to use the compressor the token came from, and a shard tree must
+	 * be disposed from the leaves upwards.
+	 * @param syncToken - The token for the shard, obtained by calling {@link IIdCompressorCore.getShardSyncToken} (non-destructive
+	 * synchronization) or {@link IIdCompressorCore.disposeShard} (synchronization plus reclamation of the disposed shard's ID space).
+	 */
+	synchronizeWithShard(syncToken: ShardSynchronizationToken): void;
+
+	/**
+	 * Returns undefined if this compressor is not part of a shard group, and otherwise returns a synchronization token for this shard
+	 * that can be used when calling {@link IIdCompressorCore.synchronizeWithShard}. This does NOT dispose the shard.
+	 *
+	 * @returns The sync token if this compressor is part of a sharded group, otherwise undefined.
+	 * The returned token is serializable and can be passed across marshaling boundaries. This token can be used to synchronize a
+	 * parent with this compressor by calling {@link IIdCompressorCore.synchronizeWithShard}.
+	 * Unlike {@link IIdCompressorCore.disposeShard}, this is non-destructive and may be called on a shard that still has active
+	 * child shards, which allows an intermediate shard to propagate its progress upward to its own parent.
+	 * @throws If this compressor is the root of the shard tree (only non-root shards can produce a token).
+	 */
+	getShardSyncToken(): ShardSynchronizationToken | undefined;
+
+	/**
+	 * Returns undefined if this compressor is not part of a shard group, and otherwise disposes this shard and returns
+	 * the disposal token for this compressor. If this compressor was part of a shard group, the compressor will no longer be usable.
+	 *
+	 * @returns The disposal token if this compressor is part of a sharded group, otherwise undefined.
+	 * The returned token is serializable and can be passed across marshaling boundaries. Passing it to
+	 * {@link IIdCompressorCore.synchronizeWithShard} on the parent reclaims this shard's subset of the ID space.
+	 * @throws If this shard has active child shards.
+	 * This means that a shard tree must be disposed from the leaves upwards.
+	 */
+	disposeShard(): ShardSynchronizationToken | undefined;
+
+	/**
+	 * Returns a persistable form of the current state of this `IdCompressor` which can be rehydrated via `deserializeIdCompressor()`.
 	 * This includes finalized state as well as un-finalized state and is therefore suitable for use in offline scenarios.
 	 */
 	serialize(withSession: true): SerializedIdCompressorWithOngoingSession;
 
 	/**
-	 * Returns a persistable form of the current state of this `IdCompressor` which can be rehydrated via `IdCompressor.deserialize()`.
+	 * Returns a persistable form of the current state of this `IdCompressor` which can be rehydrated via `deserializeIdCompressor()`.
 	 * This only includes finalized state and is therefore suitable for use in summaries.
 	 */
 	serialize(withSession: false): SerializedIdCompressorWithNoSession;
 }
 
+/**
+ * The state shared by all shard tokens: enough information to identify a shard and its progress
+ * through its stride pattern. This is used to track which shard generated which IDs and to manage
+ * reclamation of a disposed shard's ID space. The {@link ShardToken.disposed} flag distinguishes a
+ * plain synchronization token from a disposal token. The branded {@link ShardSynchronizationToken}
+ * is the concrete type handed to consumers.
+ * @internal
+ */
+export interface ShardToken {
+	/**
+	 * The number of positions filled in this shard's stride pattern.
+	 * This tracks progress through the stride cycle, not the count of IDs actually generated.
+	 * For example, when a shard is created, it backfills entries for positions in its stride,
+	 * so this value may be non-zero even if the shard hasn't generated any IDs yet.
+	 */
+	localGenCount: number;
+
+	/**
+	 * Unique identifier for this shard within its parent.
+	 */
+	shardId: SessionId;
+
+	/**
+	 * Whether this token also signals disposal of the originating shard. When `true`, passing the token to
+	 * {@link IIdCompressorCore.synchronizeWithShard} reclaims the shard's ID space in addition to synchronizing.
+	 * Produced as `false` by {@link IIdCompressorCore.getShardSyncToken} and `true` by {@link IIdCompressorCore.disposeShard}.
+	 */
+	disposed: boolean;
+}
+
+/**
+ * A {@link ShardToken} that identifies a shard for synchronization (and, when {@link ShardToken.disposed} is `true`,
+ * reclamation) via {@link IIdCompressorCore.synchronizeWithShard}.
+ * @internal
+ */
+export type ShardSynchronizationToken = ShardToken & {
+	readonly ShardSynchronizationToken: "c79724e1-9103-4415-95b5-bebb932be404";
+};
+
 /**
  * A distributed UUID generator and compressor.
  * `IdCompressor` offers the ability to generate arbitrary non-colliding v4 UUIDs, called stable IDs, while compressing them into small integers

package/src/types/index.ts

@@ -10,7 +10,16 @@ export type {
 	SerializedIdCompressorWithOngoingSession,
 } from "./persisted-types/index.js";
 
-export type { IIdCompressorCore, IIdCompressor } from "./idCompressor.js";
+export type {
+	IIdCompressorCore,
+	IIdCompressor,
+	ShardToken,
+	ShardSynchronizationToken,
+} from "./idCompressor.js";
+export {
+	SerializationVersion,
+	type SerializationVersion as SerializationVersionType,
+} from "./idCompressor.js";
 
 export type {
 	SessionSpaceCompressedId,

package/src/types/persisted-types/0.0.1.ts

@@ -7,7 +7,7 @@ import type { SessionId } from "../identifiers.js";
 
 /**
  * The serialized contents of an IdCompressor, suitable for persistence in a summary.
- * @legacy @beta
+ * @internal
  */
 export type SerializedIdCompressor = string & {
 	readonly _serializedIdCompressor: "8c73c57c-1cf4-4278-8915-6444cb4f6af5";
@@ -15,7 +15,7 @@ export type SerializedIdCompressor = string & {
 
 /**
  * The serialized contents of an IdCompressor, suitable for persistence in a summary.
- * @legacy @beta
+ * @internal
  */
 export type SerializedIdCompressorWithNoSession = SerializedIdCompressor & {
 	readonly _noLocalState: "3aa2e1e8-cc28-4ea7-bc1a-a11dc3f26dfb";
@@ -23,7 +23,7 @@ export type SerializedIdCompressorWithNoSession = SerializedIdCompressor & {
 
 /**
  * The serialized contents of an IdCompressor, suitable for persistence in a summary.
- * @legacy @beta
+ * @internal
  */
 export type SerializedIdCompressorWithOngoingSession = SerializedIdCompressor & {
 	readonly _hasLocalState: "1281acae-6d14-47e7-bc92-71c8ee0819cb";
@@ -33,7 +33,7 @@ export type SerializedIdCompressorWithOngoingSession = SerializedIdCompressor &
  * Data describing a range of session-local IDs (from a remote or local session).
  *
  * A range is composed of local IDs that were generated.
- * @legacy @beta
+ * @internal
  */
 export interface IdCreationRange {
 	readonly sessionId: SessionId;

package/src/utilities.ts

@@ -29,7 +29,7 @@ function isHexadecimalCharacter(charCode: number): boolean {
 
 /**
  * Generate a random session ID
- * @legacy @beta
+ * @internal
  */
 export function createSessionId(): SessionId {
 	return assertIsStableId(v4()) as SessionId;