@fluidframework/runtime-utils 2.74.0-370705 → 2.80.0

package/src/compatibilityBase.ts

@@ -143,12 +143,35 @@ export function getConfigForMinVersionForCollab<T>(
 	minVersionForCollab: MinimumVersionForCollab,
 	config: ConfigMapEntry<T>,
 ): T {
-	const entries: [string, unknown][] = Object.entries(config); // Assigning this to a typed variable to convert the "any" into unknown.
+	return getConfigForMinVersionForCollabIterable(
+		minVersionForCollab,
+		Object.entries(config) as [MinimumMinorSemanticVersion, T][],
+	);
+}
+
+/**
+ * Returns a default configuration given minVersionForCollab and the contents of a {@link ConfigMapEntry} in an Iterable.
+ * @remarks
+ * See also {@link getConfigForMinVersionForCollab} for consuming a ConfigMapEntry directly.
+ *
+ * `ConfigMapEntry` is a nice type safe format for developers to directly author this data,
+ * but it is messy and less type safe to work with it in this format programmatically.
+ * Thus this function exists to help meet the needs of programmatic use cases,
+ * like cases which transform a ConfigMapEntry before selecting a value from it.
+ * @internal
+ */
+export function getConfigForMinVersionForCollabIterable<T>(
+	minVersionForCollab: MinimumVersionForCollab,
+	entries: Iterable<readonly [MinimumMinorSemanticVersion | MinimumVersionForCollab, T]>, // [[typeof lowestMinVersionForCollab, T], ...[MinimumVersionForCollab, T][]],
+): T {
 	// Validate and strongly type the versions from the configMap.
-	const versions: [MinimumVersionForCollab, unknown][] = entries.map(([version, value]) => {
-		validateMinimumVersionForCollab(version);
-		return [version, value];
-	});
+	const versions: [MinimumVersionForCollab, unknown][] = Array.from(
+		entries,
+		([version, value]) => {
+			validateMinimumVersionForCollab(version);
+			return [version, value];
+		},
+	);
 	// Sort the versions in descending order to find the largest compatible entry.
 	// TODO: Enforcing a sorted order might be a good idea. For now tolerates any order.
 	versions.sort((a, b) => compare(b[0], a[0]));
@@ -225,6 +248,7 @@ const parsedPackageVersion = parse(pkgVersion) ?? fail("Invalid package version"
  * Since this is used by validateMinimumVersionForCollab, the type case to MinimumVersionForCollab can not use it directly.
  * Thus this is just `as` cast here, and a test confirms it is valid according to validateMinimumVersionForCollab.
  *
+ * @internal
  */
 export const cleanedPackageVersion =
 	`${parsedPackageVersion.major}.${parsedPackageVersion.minor}.${parsedPackageVersion.patch}` as MinimumVersionForCollab;

package/src/index.ts

@@ -70,6 +70,8 @@ export {
 	isValidMinVersionForCollab,
 	validateMinimumVersionForCollab,
 	lowestMinVersionForCollab,
+	getConfigForMinVersionForCollabIterable,
+	cleanedPackageVersion,
 } from "./compatibilityBase.js";
 export type {
 	ConfigMap,

package/src/packageVersion.ts

@@ -6,4 +6,4 @@
  */
 
 export const pkgName = "@fluidframework/runtime-utils";
-export const pkgVersion = "2.74.0-370705";
+export const pkgVersion = "2.80.0";

package/src/summaryUtils.ts

@@ -32,7 +32,11 @@ import type {
 	ISummarizeResult,
 	ITelemetryContextExt,
 } from "@fluidframework/runtime-definitions/internal";
-import { gcDataBlobKey } from "@fluidframework/runtime-definitions/internal";
+import {
+	currentSummarizeStepPrefix,
+	currentSummarizeStepPropertyName,
+	gcDataBlobKey,
+} from "@fluidframework/runtime-definitions/internal";
 import type { TelemetryEventPropertyTypeExt } from "@fluidframework/telemetry-utils/internal";
 
 /**
@@ -520,14 +524,18 @@ export class TelemetryContext implements ITelemetryContext, ITelemetryContextExt
 	}
 
 	/**
-	 * {@inheritDoc @fluidframework/runtime-definitions#ITelemetryContext.get}
+	 * Get the telemetry data being tracked
+	 * @param prefix - unique prefix to tag this data with (ex: "fluid:map:")
+	 * @param property - property name of the telemetry data being tracked (ex: "DirectoryCount")
+	 * @returns undefined if item not found
 	 */
 	public get(prefix: string, property: string): TelemetryEventPropertyTypeExt {
 		return this.telemetry.get(`${prefix}${property}`);
 	}
 
 	/**
-	 * {@inheritDoc @fluidframework/runtime-definitions#ITelemetryContext.serialize}
+	 * Returns a serialized version of all the telemetry data.
+	 * Should be used when logging in telemetry events.
 	 */
 	public serialize(): string {
 		const jsonObject = {};
@@ -536,6 +544,14 @@ export class TelemetryContext implements ITelemetryContext, ITelemetryContextExt
 		}
 		return JSON.stringify(jsonObject);
 	}
+
+	public getCurrentSummarizeStep(): TelemetryEventPropertyTypeExt {
+		return this.get(currentSummarizeStepPrefix, currentSummarizeStepPropertyName);
+	}
+
+	public setCurrentSummarizeStep(value: TelemetryEventPropertyTypeExt): void {
+		this.set(currentSummarizeStepPrefix, currentSummarizeStepPropertyName, value);
+	}
 }
 
 /**