@fluidframework/container-runtime 2.51.0-347100 → 2.52.0

package/src/dataStoreContext.ts

@@ -3,7 +3,11 @@
  * Licensed under the MIT License.
  */
 
-import { TypedEventEmitter, type ILayerCompatDetails } from "@fluid-internal/client-utils";
+import {
+	TypedEventEmitter,
+	type ILayerCompatDetails,
+	type IProvideLayerCompatDetails,
+} from "@fluid-internal/client-utils";
 import { AttachState, IAudience } from "@fluidframework/container-definitions";
 import {
 	IDeltaManager,
@@ -25,7 +29,6 @@ import {
 import { assert, LazyPromise, unreachableCase } from "@fluidframework/core-utils/internal";
 import { IClientDetails, IQuorumClients } from "@fluidframework/driver-definitions";
 import {
-	IDocumentStorageService,
 	type ISnapshot,
 	IDocumentMessage,
 	ISnapshotTree,
@@ -63,6 +66,7 @@ import {
 	type IRuntimeMessageCollection,
 	type IFluidDataStoreFactory,
 	type PackagePath,
+	type IRuntimeStorageService,
 } from "@fluidframework/runtime-definitions/internal";
 import {
 	addBlobToSummary,
@@ -146,7 +150,7 @@ export interface IFluidDataStoreContextInternal extends IFluidDataStoreContext {
 export interface IFluidDataStoreContextProps {
 	readonly id: string;
 	readonly parentContext: IFluidParentContextPrivate;
-	readonly storage: IDocumentStorageService;
+	readonly storage: IRuntimeStorageService;
 	readonly scope: FluidObject;
 	readonly createSummarizerNodeFn: CreateChildSummarizerNodeFn;
 	/**
@@ -243,7 +247,11 @@ class ContextDeltaManagerProxy extends BaseDeltaManagerProxy {
  */
 export abstract class FluidDataStoreContext
 	extends TypedEventEmitter<IFluidDataStoreContextEvents>
-	implements IFluidDataStoreContextInternal, IFluidDataStoreContext, IDisposable
+	implements
+		IFluidDataStoreContextInternal,
+		IFluidDataStoreContext,
+		IDisposable,
+		IProvideLayerCompatDetails
 {
 	public get packagePath(): PackagePath {
 		assert(this.pkg !== undefined, 0x139 /* "Undefined package path" */);
@@ -424,7 +432,7 @@ export abstract class FluidDataStoreContext
 	 * The parent which provided this information currently can be the container runtime or a datastore (if the datastore this context is for is nested under another one).
 	 */
 	private readonly parentContext: IFluidParentContextPrivate;
-	public readonly storage: IDocumentStorageService;
+	public readonly storage: IRuntimeStorageService;
 	public readonly scope: FluidObject;
 	/**
 	 * The loading group to which the data store belongs to.

package/src/index.ts

@@ -20,6 +20,12 @@ export {
 } from "./containerRuntime.js";
 export type { ICompressionRuntimeOptions } from "./compressionDefinitions.js";
 export { CompressionAlgorithms, disabledCompressionConfig } from "./compressionDefinitions.js";
+export {
+	/**
+	 * @deprecated Import from `@fluidframework/runtime-definitions/legacy` instead.
+	 */
+	MinimumVersionForCollab,
+} from "@fluidframework/runtime-definitions/internal";
 export {
 	ContainerMessageType,
 	UnknownContainerRuntimeMessage,
@@ -31,7 +37,6 @@ export {
 	ChannelCollectionFactory,
 	AllowTombstoneRequestHeaderKey,
 } from "./channelCollection.js";
-export type { MinimumVersionForCollab, SemanticVersion } from "./compatUtils.js";
 export {
 	GCNodeType,
 	IGCMetadata,

package/src/metadata.ts

@@ -46,10 +46,18 @@ export interface IBatchMetadata {
  * Blob handling makes assumptions about what might be on the metadata. This interface codifies those assumptions, but does not validate them.
  */
 export interface IBlobMetadata {
-	blobId?: string;
-	localId?: string;
+	blobId: string;
+	localId: string;
 }
 
+export const isBlobMetadata = (metadata: unknown): metadata is IBlobMetadata => {
+	return (
+		!!metadata &&
+		typeof (metadata as IBlobMetadata).blobId === "string" &&
+		typeof (metadata as IBlobMetadata).localId === "string"
+	);
+};
+
 /**
  * ContainerRuntime needs to know if this is a replayed savedOp as those need to be skipped in stashed ops scenarios.
  */

package/src/packageVersion.ts

@@ -6,4 +6,4 @@
  */
 
 export const pkgName = "@fluidframework/container-runtime";
-export const pkgVersion = "2.51.0-347100";
+export const pkgVersion = "2.52.0";

package/src/storageServiceWithAttachBlobs.ts

@@ -4,23 +4,34 @@
  */
 
 import {
-	IDocumentStorageService,
-	IDocumentStorageServicePolicies,
+	type FetchSource,
+	type ICreateBlobResponse,
+	type IDocumentStorageServicePolicies,
+	type ISnapshot,
+	type ISnapshotFetchOptions,
+	type ISnapshotTree,
+	type ISummaryContext,
+	type ISummaryHandle,
+	type ISummaryTree,
+	type IVersion,
 } from "@fluidframework/driver-definitions/internal";
-import { DocumentStorageServiceProxy } from "@fluidframework/driver-utils/internal";
+import type { IRuntimeStorageService } from "@fluidframework/runtime-definitions/internal";
+import { UsageError } from "@fluidframework/telemetry-utils/internal";
 
 /**
- * IDocumentStorageService proxy which intercepts requests if they can be satisfied by the blobs received in the
+ * IRuntimeStorageService proxy which intercepts requests if they can be satisfied by the blobs received in the
  * attach message. We use this to avoid an unnecessary request to the storage service.
  */
-export class StorageServiceWithAttachBlobs extends DocumentStorageServiceProxy {
+export class StorageServiceWithAttachBlobs implements IRuntimeStorageService {
 	constructor(
-		internalStorageService: IDocumentStorageService,
+		private readonly internalStorageService: IRuntimeStorageService,
 		private readonly attachBlobs: Map<string, ArrayBufferLike>,
-	) {
-		super(internalStorageService);
-	}
+	) {}
 
+	/**
+	 * {@link IRuntimeStorageService.policies}.
+	 * @deprecated - This will be removed in a future release. The DataStore layer does not need this.
+	 */
 	public get policies(): IDocumentStorageServicePolicies | undefined {
 		return this.internalStorageService.policies;
 	}
@@ -32,7 +43,78 @@ export class StorageServiceWithAttachBlobs extends DocumentStorageServiceProxy {
 		}
 
 		// Note that it is intentional not to cache the result of this readBlob - we'll trust the real
-		// IDocumentStorageService to cache appropriately, no need to double-cache.
+		// IRuntimeStorageService to cache appropriately, no need to double-cache.
 		return this.internalStorageService.readBlob(id);
 	}
+
+	/**
+	 * {@link IRuntimeStorageService.getSnapshotTree}.
+	 * @deprecated - This will be removed in a future release. The DataStore layer does not need this.
+	 */
+	public async getSnapshotTree(
+		version?: IVersion,
+		scenarioName?: string,
+		// eslint-disable-next-line @rushstack/no-new-null
+	): Promise<ISnapshotTree | null> {
+		return this.internalStorageService.getSnapshotTree(version, scenarioName);
+	}
+
+	/**
+	 * {@link IRuntimeStorageService.getSnapshot}.
+	 * @deprecated - This will be removed in a future release. The DataStore layer does not need this.
+	 */
+	public async getSnapshot(snapshotFetchOptions?: ISnapshotFetchOptions): Promise<ISnapshot> {
+		if (this.internalStorageService.getSnapshot !== undefined) {
+			return this.internalStorageService.getSnapshot(snapshotFetchOptions);
+		}
+		throw new UsageError(
+			"getSnapshot api should exist on internal storage in documentStorageServiceProxy class",
+		);
+	}
+
+	/**
+	 * {@link IRuntimeStorageService.getVersions}.
+	 * @deprecated - This will be removed in a future release. The DataStore layer does not need this.
+	 */
+	public async getVersions(
+		// eslint-disable-next-line @rushstack/no-new-null
+		versionId: string | null,
+		count: number,
+		scenarioName?: string,
+		fetchSource?: FetchSource,
+	): Promise<IVersion[]> {
+		return this.internalStorageService.getVersions(
+			versionId,
+			count,
+			scenarioName,
+			fetchSource,
+		);
+	}
+
+	/**
+	 * {@link IRuntimeStorageService.uploadSummaryWithContext}.
+	 * @deprecated - This will be removed in a future release. The DataStore layer does not need this.
+	 */
+	public async uploadSummaryWithContext(
+		summary: ISummaryTree,
+		context: ISummaryContext,
+	): Promise<string> {
+		return this.internalStorageService.uploadSummaryWithContext(summary, context);
+	}
+
+	/**
+	 * {@link IRuntimeStorageService.createBlob}.
+	 * @deprecated - This will be removed in a future release. The DataStore layer does not need this.
+	 */
+	public async createBlob(file: ArrayBufferLike): Promise<ICreateBlobResponse> {
+		return this.internalStorageService.createBlob(file);
+	}
+
+	/**
+	 * {@link IRuntimeStorageService.downloadSummary}.
+	 * @deprecated - This will be removed in a future release. The DataStore layer does not need this.
+	 */
+	public async downloadSummary(handle: ISummaryHandle): Promise<ISummaryTree> {
+		return this.internalStorageService.downloadSummary(handle);
+	}
 }

package/src/summary/documentSchema.ts

@@ -4,11 +4,11 @@
  */
 
 import { assert } from "@fluidframework/core-utils/internal";
+import type { SemanticVersion } from "@fluidframework/runtime-utils/internal";
 import type { ITelemetryLoggerExt } from "@fluidframework/telemetry-utils/internal";
 import { DataProcessingError } from "@fluidframework/telemetry-utils/internal";
 import { gt, lt, parse } from "semver-ts";
 
-import type { SemanticVersion } from "../compatUtils.js";
 import { pkgVersion } from "../packageVersion.js";
 
 /**

package/src/summary/summaryFormat.ts

@@ -6,7 +6,6 @@
 import { assert } from "@fluidframework/core-utils/internal";
 import { SummaryType } from "@fluidframework/driver-definitions";
 import {
-	IDocumentStorageService,
 	ISnapshotTree,
 	ISequencedDocumentMessage,
 } from "@fluidframework/driver-definitions/internal";
@@ -15,6 +14,7 @@ import {
 	ISummaryTreeWithStats,
 	channelsTreeName,
 	gcTreeKey,
+	type IRuntimeStorageService,
 } from "@fluidframework/runtime-definitions/internal";
 
 import { blobsTreeName } from "../blobManager/index.js";
@@ -287,7 +287,7 @@ export function wrapSummaryInChannelsTree(summarizeResult: ISummaryTreeWithStats
 }
 
 export async function getFluidDataStoreAttributes(
-	storage: IDocumentStorageService,
+	storage: IRuntimeStorageService,
 	snapshot: ISnapshotTree,
 ): Promise<ReadFluidDataStoreAttributes> {
 	const attributes = await readAndParse<ReadFluidDataStoreAttributes>(

package/dist/compatUtils.d.ts

@@ -1,106 +0,0 @@
-/*!
- * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
- * Licensed under the MIT License.
- */
-import type { ContainerRuntimeOptionsInternal } from "./containerRuntime.js";
-/**
- * Our policy is to support N/N-1 compatibility by default, where N is the most
- * recent public major release of the runtime.
- * Therefore, if the customer does not provide a minVersionForCollab, we will
- * default to use N-1.
- *
- * However, this is not consistent with today's behavior. Some options (i.e.
- * batching, compression) are enabled by default despite not being compatible
- * with 1.x clients. Since the policy was introduced during 2.x's lifespan,
- * N/N-1 compatibility by **default** will be in effect starting with 3.0.
- * Importantly though, N/N-2 compatibility is still guaranteed with the proper
- * configurations set.
- *
- * Further to distinguish unspecified `minVersionForCollab` from a specified
- * version and allow `enableExplicitSchemaControl` to default to `true` for
- * any 2.0.0+ version, we will use a special value of `2.0.0-defaults`, which
- * is semantically less than 2.0.0.
- */
-export declare const defaultMinVersionForCollab: "2.0.0-defaults";
-/**
- * String in a valid semver format specifying bottom of a minor version
- * or special "defaults" prerelease of a major.
- * @remarks Only 2.0.0-defaults is expected, but index signatures cannot be a
- * literal; so, just allow any major -defaults prerelease.
- */
-export type MinimumMinorSemanticVersion = `${bigint}.${bigint}.0` | `${bigint}.0.0-defaults`;
-/**
- * String in a valid semver format of a specific version at least specifying minor.
- *
- * @legacy
- * @alpha
- */
-export type MinimumVersionForCollab = `${1 | 2}.${bigint}.${bigint}` | `${1 | 2}.${bigint}.${bigint}-${string}`;
-/**
- * String in a valid semver format of a specific version at least specifying minor.
- * Unlike {@link MinimumVersionForCollab}, this type allows any bigint for the major version.
- * Used as a more generic type that allows major versions other than 1 or 2.
- *
- * @internal
- */
-export type SemanticVersion = `${bigint}.${bigint}.${bigint}` | `${bigint}.${bigint}.${bigint}-${string}`;
-/**
- * Generic type for runtimeOptionsAffectingDocSchemaConfigMap
- */
-export type ConfigMap<T extends Record<string, unknown>> = {
-    [K in keyof T]-?: {
-        [version: MinimumMinorSemanticVersion]: T[K];
-    };
-};
-/**
- * Generic type for runtimeOptionsAffectingDocSchemaConfigValidationMap
- */
-export type ConfigValidationMap<T extends Record<string, unknown>> = {
-    [K in keyof T]-?: (configValue: T[K]) => SemanticVersion | undefined;
-};
-/**
- * Subset of the {@link ContainerRuntimeOptionsInternal} properties which
- * affect {@link IDocumentSchemaFeatures}.
- *
- * @remarks
- * When a new option is added to {@link ContainerRuntimeOptionsInternal}, we
- * must consider if it changes the DocumentSchema. If so, then a corresponding
- * entry must be added to {@link runtimeOptionsAffectingDocSchemaConfigMap}
- * below. If not, then it must be omitted from this type.
- *
- * Note: `Omit` is used instead of `Pick` to ensure that all new options are
- * included in this type by default. If any new properties are added to
- * {@link ContainerRuntimeOptionsInternal}, they will be included in this
- * type unless explicitly omitted. This will prevent us from forgetting to
- * account for any new properties in the future.
- */
-export type RuntimeOptionsAffectingDocSchema = Omit<ContainerRuntimeOptionsInternal, "chunkSizeInBytes" | "maxBatchSizeInBytes" | "loadSequenceNumberVerification" | "summaryOptions">;
-/**
- * Returns the default RuntimeOptionsAffectingDocSchema configuration for a given minVersionForCollab.
- */
-export declare function getMinVersionForCollabDefaults(minVersionForCollab: MinimumVersionForCollab): RuntimeOptionsAffectingDocSchema;
-/**
- * Returns a default configuration given minVersionForCollab and configuration version map.
- */
-export declare function getConfigsForMinVersionForCollab<T extends Record<SemanticVersion, unknown>>(minVersionForCollab: SemanticVersion, configMap: ConfigMap<T>): Partial<T>;
-/**
- * Checks if the minVersionForCollab is valid.
- * A valid minVersionForCollab is a MinimumVersionForCollab that is at least `lowestMinVersionForCollab` and less than or equal to the current package version.
- */
-export declare function isValidMinVersionForCollab(minVersionForCollab: MinimumVersionForCollab): boolean;
-/**
- * Validates if the runtime options passed in from the user are compatible with the minVersionForCollab.
- * For example, if a user sets the `enableGroupedBatching` option to true, but the minVersionForCollab
- * is set to "1.0.0", then we should throw a UsageError since 1.x clients do not support batching.
- * */
-export declare function validateRuntimeOptions(minVersionForCollab: MinimumVersionForCollab, runtimeOptions: Partial<ContainerRuntimeOptionsInternal>): void;
-/**
- * Generic function to validate runtime options against the minVersionForCollab.
- */
-export declare function getValidationForRuntimeOptions<T extends Record<string, unknown>>(minVersionForCollab: SemanticVersion, runtimeOptions: Partial<T>, validationMap: ConfigValidationMap<T>): void;
-/**
- * Helper function to map ContainerRuntimeOptionsInternal config values to
- * minVersionForCollab in {@link runtimeOptionsAffectingDocSchemaConfigValidationMap}.
- */
-export declare function configValueToMinVersionForCollab<T extends string | number | boolean | undefined | object, Arr extends readonly [T, SemanticVersion][]>(configToMinVer: Arr): (configValue: T) => SemanticVersion | undefined;
-//# sourceMappingURL=compatUtils.d.ts.map

package/dist/compatUtils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"compatUtils.d.ts","sourceRoot":"","sources":["../src/compatUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,uBAAuB,CAAC;AAG7E;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,0BAA0B,kBACqB,CAAC;AAU7D;;;;;GAKG;AACH,MAAM,MAAM,2BAA2B,GAAG,GAAG,MAAM,IAAI,MAAM,IAAI,GAAG,GAAG,MAAM,eAAe,CAAC;AAE7F;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAChC,GAAG,CAAC,GAAG,CAAC,IAAI,MAAM,IAAI,MAAM,EAAE,GAC9B,GAAG,CAAC,GAAG,CAAC,IAAI,MAAM,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;AAE5C;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GACxB,GAAG,MAAM,IAAI,MAAM,IAAI,MAAM,EAAE,GAC/B,GAAG,MAAM,IAAI,MAAM,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;AAE7C;;GAEG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;KACzD,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG;QACjB,CAAC,OAAO,EAAE,2BAA2B,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;KAC7C;CACD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;KACnE,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,eAAe,GAAG,SAAS;CACpE,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,gCAAgC,GAAG,IAAI,CAClD,+BAA+B,EAC7B,kBAAkB,GAClB,qBAAqB,GACrB,gCAAgC,GAChC,gBAAgB,CAClB,CAAC;AAsGF;;GAEG;AACH,wBAAgB,8BAA8B,CAC7C,mBAAmB,EAAE,uBAAuB,GAC1C,gCAAgC,CAOlC;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,CAAC,SAAS,MAAM,CAAC,eAAe,EAAE,OAAO,CAAC,EAC1F,mBAAmB,EAAE,eAAe,EACpC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,GACrB,OAAO,CAAC,CAAC,CAAC,CAqBZ;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACzC,mBAAmB,EAAE,uBAAuB,GAC1C,OAAO,CAMT;AAED;;;;KAIK;AACL,wBAAgB,sBAAsB,CACrC,mBAAmB,EAAE,uBAAuB,EAC5C,cAAc,EAAE,OAAO,CAAC,+BAA+B,CAAC,GACtD,IAAI,CAMN;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/E,mBAAmB,EAAE,eAAe,EACpC,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC,EAC1B,aAAa,EAAE,mBAAmB,CAAC,CAAC,CAAC,GACnC,IAAI,CAwBN;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,CAC/C,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,EACxD,GAAG,SAAS,SAAS,CAAC,CAAC,EAAE,eAAe,CAAC,EAAE,EAC1C,cAAc,EAAE,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,KAAK,eAAe,GAAG,SAAS,CAoCtE"}

package/dist/compatUtils.js

@@ -1,251 +0,0 @@
-"use strict";
-/*!
- * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
- * Licensed under the MIT License.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.configValueToMinVersionForCollab = exports.getValidationForRuntimeOptions = exports.validateRuntimeOptions = exports.isValidMinVersionForCollab = exports.getConfigsForMinVersionForCollab = exports.getMinVersionForCollabDefaults = exports.defaultMinVersionForCollab = void 0;
-const internal_1 = require("@fluidframework/core-utils/internal");
-const internal_2 = require("@fluidframework/runtime-definitions/internal");
-const internal_3 = require("@fluidframework/telemetry-utils/internal");
-const semver_ts_1 = require("semver-ts");
-const compressionDefinitions_js_1 = require("./compressionDefinitions.js");
-const packageVersion_js_1 = require("./packageVersion.js");
-/**
- * Our policy is to support N/N-1 compatibility by default, where N is the most
- * recent public major release of the runtime.
- * Therefore, if the customer does not provide a minVersionForCollab, we will
- * default to use N-1.
- *
- * However, this is not consistent with today's behavior. Some options (i.e.
- * batching, compression) are enabled by default despite not being compatible
- * with 1.x clients. Since the policy was introduced during 2.x's lifespan,
- * N/N-1 compatibility by **default** will be in effect starting with 3.0.
- * Importantly though, N/N-2 compatibility is still guaranteed with the proper
- * configurations set.
- *
- * Further to distinguish unspecified `minVersionForCollab` from a specified
- * version and allow `enableExplicitSchemaControl` to default to `true` for
- * any 2.0.0+ version, we will use a special value of `2.0.0-defaults`, which
- * is semantically less than 2.0.0.
- */
-exports.defaultMinVersionForCollab = "2.0.0-defaults";
-/**
- * We don't want allow a version before the major public release of the LTS version.
- * Today we use "1.0.0", because our policy supports N/N-1 & N/N-2, which includes
- * all minor versions of N. Though LTS starts at 1.4.0, we should stay consistent
- * with our policy and allow all 1.x versions to be compatible with 2.x.
- */
-const lowestMinVersionForCollab = "1.0.0";
-/**
- * Mapping of RuntimeOptionsAffectingDocSchema to their compatibility related configs.
- *
- * Each key in this map corresponds to a property in RuntimeOptionsAffectingDocSchema. The value is an object that maps MinimumVersionForCollab
- * to the appropriate default value for that property to supporting that MinimumVersionForCollab. If clients running MinimumVersionForCollab X are able to understand
- * the format changes introduced by the property, then the default value for that MinimumVersionForCollab will enable the feature associated with the property.
- * Otherwise, the feature will be disabled.
- *
- * For example if the minVersionForCollab is a 1.x version (i.e. "1.5.0"), then the default value for `enableGroupedBatching` will be false since 1.x
- * clients do not understand the document format when batching is enabled. If the minVersionForCollab is a 2.x client (i.e. "2.0.0" or later), then the
- * default value for `enableGroupedBatching` will be true because clients running 2.0 or later will be able to understand the format changes associated
- * with the batching feature.
- */
-const runtimeOptionsAffectingDocSchemaConfigMap = {
-    enableGroupedBatching: {
-        "1.0.0": false,
-        "2.0.0-defaults": true,
-    },
-    compressionOptions: {
-        "1.0.0": compressionDefinitions_js_1.disabledCompressionConfig,
-        "2.0.0-defaults": compressionDefinitions_js_1.enabledCompressionConfig,
-    },
-    enableRuntimeIdCompressor: {
-        // For IdCompressorMode, `undefined` represents a logical state (off).
-        // However, to satisfy the Required<> constraint while
-        // `exactOptionalPropertyTypes` is `false` (TODO: AB#8215), we need
-        // to have it defined, so we trick the type checker here.
-        "1.0.0": undefined,
-        // We do not yet want to enable idCompressor by default since it will
-        // increase bundle sizes, and not all customers will benefit from it.
-        // Therefore, we will require customers to explicitly enable it. We
-        // are keeping it as a DocSchema affecting option for now as this may
-        // change in the future.
-    },
-    explicitSchemaControl: {
-        "1.0.0": false,
-        // This option's intention is to prevent 1.x clients from joining sessions
-        // when enabled. This is set to true when the minVersionForCollab is set
-        // to >=2.0.0 (explicitly). This is different than other 2.0 defaults
-        // because it was not enabled by default prior to the implementation of
-        // `minVersionForCollab`.
-        // `defaultMinVersionForCollab` is set to "2.0.0-defaults" which "2.0.0"
-        // does not satisfy to avoiding enabling this option by default as of
-        // `minVersionForCollab` introduction, which could be unexpected.
-        // Only enable as a default when `minVersionForCollab` is specified at
-        // 2.0.0+.
-        "2.0.0": true,
-    },
-    flushMode: {
-        // Note: 1.x clients are compatible with TurnBased flushing, but here we elect to remain on Immediate flush mode
-        // as a work-around for inability to send batches larger than 1Mb. Immediate flushing keeps batches smaller as
-        // fewer messages will be included per flush.
-        "1.0.0": internal_2.FlushMode.Immediate,
-        "2.0.0-defaults": internal_2.FlushMode.TurnBased,
-    },
-    gcOptions: {
-        "1.0.0": {},
-        // Although sweep is supported in 2.x, it is disabled by default until minVersionForCollab>=3.0.0 to be extra safe.
-        "3.0.0": { enableGCSweep: true },
-    },
-    createBlobPayloadPending: {
-        // This feature is new and disabled by default. In the future we will enable it by default, but we have not
-        // closed on the version where that will happen yet.  Probably a .10 release since blob functionality is not
-        // exposed on the `@public` API surface.
-        "1.0.0": undefined,
-    },
-};
-const runtimeOptionsAffectingDocSchemaConfigValidationMap = {
-    enableGroupedBatching: configValueToMinVersionForCollab([
-        [false, "1.0.0"],
-        [true, "2.0.0-defaults"],
-    ]),
-    compressionOptions: configValueToMinVersionForCollab([
-        [{ ...compressionDefinitions_js_1.disabledCompressionConfig }, "1.0.0"],
-        [{ ...compressionDefinitions_js_1.enabledCompressionConfig }, "2.0.0-defaults"],
-    ]),
-    enableRuntimeIdCompressor: configValueToMinVersionForCollab([
-        [undefined, "1.0.0"],
-        ["on", "2.0.0-defaults"],
-        ["delayed", "2.0.0-defaults"],
-    ]),
-    explicitSchemaControl: configValueToMinVersionForCollab([
-        [false, "1.0.0"],
-        [true, "2.0.0-defaults"],
-    ]),
-    flushMode: configValueToMinVersionForCollab([
-        [internal_2.FlushMode.Immediate, "1.0.0"],
-        [internal_2.FlushMode.TurnBased, "2.0.0-defaults"],
-    ]),
-    gcOptions: configValueToMinVersionForCollab([
-        [{ enableGCSweep: undefined }, "1.0.0"],
-        [{ enableGCSweep: true }, "2.0.0-defaults"],
-    ]),
-    createBlobPayloadPending: configValueToMinVersionForCollab([
-        [undefined, "1.0.0"],
-        [true, "2.40.0"],
-    ]),
-};
-/**
- * Returns the default RuntimeOptionsAffectingDocSchema configuration for a given minVersionForCollab.
- */
-function getMinVersionForCollabDefaults(minVersionForCollab) {
-    return getConfigsForMinVersionForCollab(minVersionForCollab, runtimeOptionsAffectingDocSchemaConfigMap);
-}
-exports.getMinVersionForCollabDefaults = getMinVersionForCollabDefaults;
-/**
- * Returns a default configuration given minVersionForCollab and configuration version map.
- */
-function getConfigsForMinVersionForCollab(minVersionForCollab, configMap) {
-    const defaultConfigs = {};
-    // Iterate over configMap to get default values for each option.
-    for (const key of Object.keys(configMap)) {
-        const config = configMap[key];
-        // Sort the versions in ascending order so we can short circuit the loop.
-        const versions = Object.keys(config).sort(semver_ts_1.compare);
-        // For each config, we iterate over the keys and check if minVersionForCollab is greater than or equal to the version.
-        // If so, we set it as the default value for the option. At the end of the loop we should have the most recent default
-        // value that is compatible with the version specified as the minVersionForCollab.
-        for (const version of versions) {
-            if ((0, semver_ts_1.gte)(minVersionForCollab, version)) {
-                defaultConfigs[key] = config[version];
-            }
-            else {
-                // If the minVersionForCollab is less than the version, we break out of the loop since we don't need to check
-                // any later versions.
-                break;
-            }
-        }
-    }
-    return defaultConfigs;
-}
-exports.getConfigsForMinVersionForCollab = getConfigsForMinVersionForCollab;
-/**
- * Checks if the minVersionForCollab is valid.
- * A valid minVersionForCollab is a MinimumVersionForCollab that is at least `lowestMinVersionForCollab` and less than or equal to the current package version.
- */
-function isValidMinVersionForCollab(minVersionForCollab) {
-    return ((0, semver_ts_1.valid)(minVersionForCollab) !== null &&
-        (0, semver_ts_1.gte)(minVersionForCollab, lowestMinVersionForCollab) &&
-        (0, semver_ts_1.lte)(minVersionForCollab, packageVersion_js_1.pkgVersion));
-}
-exports.isValidMinVersionForCollab = isValidMinVersionForCollab;
-/**
- * Validates if the runtime options passed in from the user are compatible with the minVersionForCollab.
- * For example, if a user sets the `enableGroupedBatching` option to true, but the minVersionForCollab
- * is set to "1.0.0", then we should throw a UsageError since 1.x clients do not support batching.
- * */
-function validateRuntimeOptions(minVersionForCollab, runtimeOptions) {
-    getValidationForRuntimeOptions(minVersionForCollab, runtimeOptions, runtimeOptionsAffectingDocSchemaConfigValidationMap);
-}
-exports.validateRuntimeOptions = validateRuntimeOptions;
-/**
- * Generic function to validate runtime options against the minVersionForCollab.
- */
-function getValidationForRuntimeOptions(minVersionForCollab, runtimeOptions, validationMap) {
-    if (minVersionForCollab === exports.defaultMinVersionForCollab) {
-        // If the minVersionForCollab is set to the default value, then we will not validate the runtime options
-        // This is to avoid disruption to users who have not yet set the minVersionForCollab value explicitly.
-        return;
-    }
-    // Iterate through each runtime option passed in by the user
-    for (const [passedRuntimeOption, passedRuntimeOptionValue] of Object.entries(runtimeOptions)) {
-        // Skip if passedRuntimeOption is not in validation map
-        if (!(passedRuntimeOption in validationMap)) {
-            continue;
-        }
-        const requiredVersion = validationMap[passedRuntimeOption](passedRuntimeOptionValue);
-        if (requiredVersion !== undefined && (0, semver_ts_1.gt)(requiredVersion, minVersionForCollab)) {
-            throw new internal_3.UsageError(`Runtime option ${passedRuntimeOption}:${JSON.stringify(passedRuntimeOptionValue)} requires ` +
-                `runtime version ${requiredVersion}. Please update minVersionForCollab ` +
-                `(currently ${minVersionForCollab}) to ${requiredVersion} or later to proceed.`);
-        }
-    }
-}
-exports.getValidationForRuntimeOptions = getValidationForRuntimeOptions;
-/**
- * Helper function to map ContainerRuntimeOptionsInternal config values to
- * minVersionForCollab in {@link runtimeOptionsAffectingDocSchemaConfigValidationMap}.
- */
-function configValueToMinVersionForCollab(configToMinVer) {
-    const configValueToRequiredVersionMap = new Map(configToMinVer);
-    return (configValue) => {
-        // If the configValue is not an object then we can get the version required directly from the map.
-        if (typeof configValue !== "object") {
-            return configValueToRequiredVersionMap.get(configValue);
-        }
-        // When the input `configValue` is an object, this logic determines the minimum runtime version it requires.
-        // It iterates through each entry in `configValueToRequiredVersionMap`. If `possibleConfigValue` shares at
-        // least one key-value pair with the input `configValue`, its associated `versionRequired` is collected into
-        // `matchingVersions`. After checking all entries, the highest among the collected versions is returned.
-        // This represents the overall minimum version required to support the features implied by the input `configValue`.
-        const matchingVersions = [];
-        for (const [possibleConfigValue, versionRequired,] of configValueToRequiredVersionMap.entries()) {
-            (0, internal_1.assert)(typeof possibleConfigValue == "object", 0xbb9 /* possibleConfigValue should be an object */);
-            // Check if `possibleConfigValue` and the input `configValue` share at least one
-            // common key-value pair. If they do, the `versionRequired` for this `possibleConfigValue`
-            // is added to `matchingVersions`.
-            if (Object.entries(possibleConfigValue).some(([k, v]) => configValue[k] === v)) {
-                matchingVersions.push(versionRequired);
-            }
-        }
-        if (matchingVersions.length > 0) {
-            // Return the latest minVersionForCollab among all matches.
-            return matchingVersions.sort((a, b) => (0, semver_ts_1.compare)(b, a))[0];
-        }
-        // If no matches then we return undefined. This means that the config value passed in
-        // does not require a specific minVersionForCollab to be valid.
-        return undefined;
-    };
-}
-exports.configValueToMinVersionForCollab = configValueToMinVersionForCollab;
-//# sourceMappingURL=compatUtils.js.map