@fluidframework/test-utils 2.0.0-dev-rc.2.0.0.246488 → 2.0.0-dev-rc.3.0.0.250606

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fluidframework/test-utils",
-  "version": "2.0.0-dev-rc.2.0.0.246488",
+  "version": "2.0.0-dev-rc.3.0.0.250606",
   "description": "Utilities for Fluid tests",
   "homepage": "https://fluidframework.com",
   "repository": {
@@ -77,26 +77,26 @@
     "temp-directory": "nyc/.nyc_output"
   },
   "dependencies": {
-    "@fluidframework/aqueduct": "2.0.0-dev-rc.2.0.0.246488",
-    "@fluidframework/container-definitions": "2.0.0-dev-rc.2.0.0.246488",
-    "@fluidframework/container-loader": "2.0.0-dev-rc.2.0.0.246488",
-    "@fluidframework/container-runtime": "2.0.0-dev-rc.2.0.0.246488",
-    "@fluidframework/container-runtime-definitions": "2.0.0-dev-rc.2.0.0.246488",
-    "@fluidframework/core-interfaces": "2.0.0-dev-rc.2.0.0.246488",
-    "@fluidframework/core-utils": "2.0.0-dev-rc.2.0.0.246488",
-    "@fluidframework/datastore": "2.0.0-dev-rc.2.0.0.246488",
-    "@fluidframework/datastore-definitions": "2.0.0-dev-rc.2.0.0.246488",
-    "@fluidframework/driver-definitions": "2.0.0-dev-rc.2.0.0.246488",
-    "@fluidframework/driver-utils": "2.0.0-dev-rc.2.0.0.246488",
-    "@fluidframework/local-driver": "2.0.0-dev-rc.2.0.0.246488",
-    "@fluidframework/map": "2.0.0-dev-rc.2.0.0.246488",
+    "@fluidframework/aqueduct": "2.0.0-dev-rc.3.0.0.250606",
+    "@fluidframework/container-definitions": "2.0.0-dev-rc.3.0.0.250606",
+    "@fluidframework/container-loader": "2.0.0-dev-rc.3.0.0.250606",
+    "@fluidframework/container-runtime": "2.0.0-dev-rc.3.0.0.250606",
+    "@fluidframework/container-runtime-definitions": "2.0.0-dev-rc.3.0.0.250606",
+    "@fluidframework/core-interfaces": "2.0.0-dev-rc.3.0.0.250606",
+    "@fluidframework/core-utils": "2.0.0-dev-rc.3.0.0.250606",
+    "@fluidframework/datastore": "2.0.0-dev-rc.3.0.0.250606",
+    "@fluidframework/datastore-definitions": "2.0.0-dev-rc.3.0.0.250606",
+    "@fluidframework/driver-definitions": "2.0.0-dev-rc.3.0.0.250606",
+    "@fluidframework/driver-utils": "2.0.0-dev-rc.3.0.0.250606",
+    "@fluidframework/local-driver": "2.0.0-dev-rc.3.0.0.250606",
+    "@fluidframework/map": "2.0.0-dev-rc.3.0.0.250606",
     "@fluidframework/protocol-definitions": "^3.2.0",
-    "@fluidframework/request-handler": "2.0.0-dev-rc.2.0.0.246488",
-    "@fluidframework/routerlicious-driver": "2.0.0-dev-rc.2.0.0.246488",
-    "@fluidframework/runtime-definitions": "2.0.0-dev-rc.2.0.0.246488",
-    "@fluidframework/runtime-utils": "2.0.0-dev-rc.2.0.0.246488",
-    "@fluidframework/telemetry-utils": "2.0.0-dev-rc.2.0.0.246488",
-    "@fluidframework/test-driver-definitions": "2.0.0-dev-rc.2.0.0.246488",
+    "@fluidframework/request-handler": "2.0.0-dev-rc.3.0.0.250606",
+    "@fluidframework/routerlicious-driver": "2.0.0-dev-rc.3.0.0.250606",
+    "@fluidframework/runtime-definitions": "2.0.0-dev-rc.3.0.0.250606",
+    "@fluidframework/runtime-utils": "2.0.0-dev-rc.3.0.0.250606",
+    "@fluidframework/telemetry-utils": "2.0.0-dev-rc.3.0.0.250606",
+    "@fluidframework/test-driver-definitions": "2.0.0-dev-rc.3.0.0.250606",
     "best-random": "^1.0.0",
     "debug": "^4.3.4",
     "mocha": "^10.2.0",
@@ -104,7 +104,8 @@
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.13.3",
-    "@fluid-internal/mocha-test-setup": "2.0.0-dev-rc.2.0.0.246488",
+    "@biomejs/biome": "^1.6.2",
+    "@fluid-internal/mocha-test-setup": "2.0.0-dev-rc.3.0.0.250606",
     "@fluid-tools/build-cli": "^0.34.0",
     "@fluidframework/build-common": "^2.0.3",
     "@fluidframework/build-tools": "^0.34.0",
@@ -175,16 +176,18 @@
     "build:test:cjs": "fluid-tsc commonjs --project ./src/test/tsconfig.cjs.json",
     "build:test:esm": "tsc --project ./src/test/tsconfig.json",
     "check:are-the-types-wrong": "attw --pack . --entrypoints .",
+    "check:biome": "biome check .",
+    "check:prettier": "prettier --check . --cache --ignore-path ../../../.prettierignore",
     "check:release-tags": "api-extractor run --local --config ./api-extractor-lint.json",
     "ci:build:docs": "api-extractor run",
     "clean": "rimraf --glob dist lib \"**/*.tsbuildinfo\" \"**/*.build.log\" _api-extractor-temp nyc",
     "eslint": "eslint --format stylish src",
     "eslint:fix": "eslint --format stylish src --fix --fix-type problem,suggestion,layout",
-    "format": "npm run prettier:fix",
-    "lint": "npm run prettier && npm run check:release-tags && npm run eslint",
-    "lint:fix": "npm run prettier:fix && npm run eslint:fix",
-    "prettier": "prettier --check . --cache --ignore-path ../../../.prettierignore",
-    "prettier:fix": "prettier --write . --cache --ignore-path ../../../.prettierignore",
+    "format": "fluid-build --task format .",
+    "format:biome": "biome check --apply .",
+    "format:prettier": "prettier --write . --cache --ignore-path ../../../.prettierignore",
+    "lint": "fluid-build . --task lint",
+    "lint:fix": "fluid-build . --task eslint:fix --task format",
     "test": "npm run test:mocha",
     "test:mocha": "npm run test:mocha:esm && echo skipping cjs to avoid overhead - npm run test:mocha:cjs",
     "test:mocha:cjs": "mocha --recursive \"dist/test/**/*.spec.*js\" --exit",

package/src/TestSummaryUtils.ts

@@ -4,7 +4,6 @@
  */
 
 import { ContainerRuntimeFactoryWithDefaultDataStore } from "@fluidframework/aqueduct";
-import { assert } from "@fluidframework/core-utils";
 import { IContainer, IHostLoader, LoaderHeader } from "@fluidframework/container-definitions";
 import {
 	IOnDemandSummarizeOptions,
@@ -12,22 +11,23 @@ import {
 	ISummaryRuntimeOptions,
 } from "@fluidframework/container-runtime";
 import {
-	ITelemetryBaseLogger,
-	IRequest,
 	IConfigProviderBase,
+	IRequest,
 	IResponse,
+	ITelemetryBaseLogger,
 } from "@fluidframework/core-interfaces";
+import { assert } from "@fluidframework/core-utils";
 import { DriverHeader } from "@fluidframework/driver-definitions";
+import { ISummaryTree } from "@fluidframework/protocol-definitions";
 import {
 	IFluidDataStoreFactory,
 	NamedFluidDataStoreRegistryEntries,
 } from "@fluidframework/runtime-definitions";
-import { ISummaryTree } from "@fluidframework/protocol-definitions";
-import { ITestContainerConfig, ITestObjectProvider } from "./testObjectProvider.js";
 import { createTestConfigProvider } from "./TestConfigs.js";
 import { waitForContainerConnection } from "./containerUtils.js";
-import { timeoutAwait } from "./timeoutUtils.js";
 import { createContainerRuntimeFactoryWithDefaultDataStore } from "./testContainerRuntimeFactoryWithDefaultDataStore.js";
+import { ITestContainerConfig, ITestObjectProvider } from "./testObjectProvider.js";
+import { timeoutAwait } from "./timeoutUtils.js";
 
 const summarizerClientType = "summarizer";
 

package/src/containerUtils.ts

@@ -8,7 +8,7 @@ import { ConnectionState } from "@fluidframework/container-loader";
 import { IResponse } from "@fluidframework/core-interfaces";
 import { assert } from "@fluidframework/core-utils";
 import { IDataStore } from "@fluidframework/runtime-definitions";
-import { PromiseExecutor, timeoutPromise, TimeoutWithError } from "./timeoutUtils.js";
+import { PromiseExecutor, TimeoutWithError, timeoutPromise } from "./timeoutUtils.js";
 
 /**
  * Utility function to wait for the specified Container to be in Connected state.

package/src/interfaces.ts

@@ -3,13 +3,13 @@
  * Licensed under the MIT License.
  */
 
+import { IFluidLoadable } from "@fluidframework/core-interfaces";
 import { IFluidDataStoreRuntime } from "@fluidframework/datastore-definitions";
 import { ISharedMap } from "@fluidframework/map";
 import {
-	IFluidDataStoreContext,
 	IFluidDataStoreChannel,
+	IFluidDataStoreContext,
 } from "@fluidframework/runtime-definitions";
-import { IFluidLoadable } from "@fluidframework/core-interfaces";
 
 /**
  * @alpha

package/src/loaderContainerTracker.ts

@@ -3,20 +3,20 @@
  * Licensed under the MIT License.
  */
 
-import { assert } from "@fluidframework/core-utils";
 import { IContainer, IDeltaQueue, IHostLoader } from "@fluidframework/container-definitions";
 import { ConnectionState } from "@fluidframework/container-loader";
+import {
+	IContainerCreateProps,
+	IContainerLoadProps,
+	// eslint-disable-next-line import/no-internal-modules
+} from "@fluidframework/container-loader/test/container";
+import { assert } from "@fluidframework/core-utils";
 import { canBeCoalescedByService } from "@fluidframework/driver-utils";
 import {
 	IDocumentMessage,
 	ISequencedDocumentMessage,
 	MessageType,
 } from "@fluidframework/protocol-definitions";
-import {
-	IContainerCreateProps,
-	IContainerLoadProps,
-	// eslint-disable-next-line import/no-internal-modules
-} from "@fluidframework/container-loader/test/container";
 import { waitForContainerConnection } from "./containerUtils.js";
 import { debug } from "./debug.js";
 import { IOpProcessingController } from "./testObjectProvider.js";

package/src/localCodeLoader.ts

@@ -6,19 +6,19 @@
 import assert from "assert";
 import { ContainerRuntimeFactoryWithDefaultDataStore } from "@fluidframework/aqueduct";
 import {
-	IProvideRuntimeFactory,
-	IFluidModule,
-	IProvideFluidCodeDetailsComparer,
-	IFluidCodeDetails,
 	ICodeDetailsLoader,
+	IFluidCodeDetails,
+	IFluidModule,
 	IFluidModuleWithDetails,
+	IProvideFluidCodeDetailsComparer,
+	IProvideRuntimeFactory,
 } from "@fluidframework/container-definitions";
+import { IContainerRuntimeOptions } from "@fluidframework/container-runtime";
 import {
 	IProvideFluidDataStoreFactory,
 	IProvideFluidDataStoreRegistry,
 } from "@fluidframework/runtime-definitions";
 import { createDataStoreFactory } from "@fluidframework/runtime-utils";
-import { IContainerRuntimeOptions } from "@fluidframework/container-runtime";
 
 /**
  * @internal

package/src/localLoader.ts

@@ -6,14 +6,14 @@
 import {
 	ICodeDetailsLoader,
 	IContainer,
+	IFluidCodeDetails,
 	IHostLoader,
 	ILoaderOptions,
-	IFluidCodeDetails,
 } from "@fluidframework/container-definitions";
 import { Loader } from "@fluidframework/container-loader";
-import { ITelemetryBaseLogger, IRequest } from "@fluidframework/core-interfaces";
+import { IRequest, ITelemetryBaseLogger } from "@fluidframework/core-interfaces";
 import { IDocumentServiceFactory, IUrlResolver } from "@fluidframework/driver-definitions";
-import { fluidEntryPoint, LocalCodeLoader } from "./localCodeLoader.js";
+import { LocalCodeLoader, fluidEntryPoint } from "./localCodeLoader.js";
 
 /**
  * Creates a loader with the given package entries and driver.

package/src/packageVersion.ts

@@ -6,4 +6,4 @@
  */
 
 export const pkgName = "@fluidframework/test-utils";
-export const pkgVersion = "2.0.0-dev-rc.2.0.0.246488";
+export const pkgVersion = "2.0.0-dev-rc.3.0.0.250606";

package/src/testContainerRuntimeFactory.ts

@@ -3,12 +3,11 @@
  * Licensed under the MIT License.
  */
 
-import { assert } from "@fluidframework/core-utils";
 import { IContainerContext, IRuntime } from "@fluidframework/container-definitions";
 import {
 	ContainerRuntime,
-	IContainerRuntimeOptions,
 	DefaultSummaryConfiguration,
+	IContainerRuntimeOptions,
 } from "@fluidframework/container-runtime";
 import { IContainerRuntime } from "@fluidframework/container-runtime-definitions";
 import {
@@ -17,8 +16,9 @@ import {
 	IRequest,
 	IResponse,
 } from "@fluidframework/core-interfaces";
+import { assert } from "@fluidframework/core-utils";
 // eslint-disable-next-line import/no-deprecated
-import { buildRuntimeRequestHandler, RuntimeRequestHandler } from "@fluidframework/request-handler";
+import { RuntimeRequestHandler, buildRuntimeRequestHandler } from "@fluidframework/request-handler";
 import {
 	IFluidDataStoreFactory,
 	NamedFluidDataStoreRegistryEntries,

package/src/testFluidObject.ts

@@ -3,20 +3,20 @@
  * Licensed under the MIT License.
  */
 
-import { IRequest, IResponse, IFluidHandle } from "@fluidframework/core-interfaces";
+import { IFluidHandle, IRequest, IResponse } from "@fluidframework/core-interfaces";
+import { assert } from "@fluidframework/core-utils";
 import {
-	FluidObjectHandle,
 	FluidDataStoreRuntime,
+	FluidObjectHandle,
 	mixinRequestHandler,
 } from "@fluidframework/datastore";
-import { SharedMap, ISharedMap } from "@fluidframework/map";
+import { IChannelFactory, IFluidDataStoreRuntime } from "@fluidframework/datastore-definitions";
+import { ISharedMap, SharedMap } from "@fluidframework/map";
 import {
+	IFluidDataStoreChannel,
 	IFluidDataStoreContext,
 	IFluidDataStoreFactory,
-	IFluidDataStoreChannel,
 } from "@fluidframework/runtime-definitions";
-import { IFluidDataStoreRuntime, IChannelFactory } from "@fluidframework/datastore-definitions";
-import { assert } from "@fluidframework/core-utils";
 import { create404Response } from "@fluidframework/runtime-utils";
 import { ITestFluidObject } from "./interfaces.js";
 

package/src/testObjectProvider.ts

@@ -5,8 +5,8 @@
 
 import {
 	IContainer,
-	IHostLoader,
 	IFluidCodeDetails,
+	IHostLoader,
 	ILoader,
 } from "@fluidframework/container-definitions";
 import {
@@ -16,24 +16,24 @@ import {
 } from "@fluidframework/container-loader";
 import { IContainerRuntimeOptions } from "@fluidframework/container-runtime";
 import {
-	ITelemetryBaseLogger,
-	ITelemetryBaseEvent,
 	IRequestHeader,
+	ITelemetryBaseEvent,
+	ITelemetryBaseLogger,
 } from "@fluidframework/core-interfaces";
 import {
 	IDocumentServiceFactory,
 	IResolvedUrl,
 	IUrlResolver,
 } from "@fluidframework/driver-definitions";
-import { ITestDriver, TestDriverTypes } from "@fluidframework/test-driver-definitions";
-import { v4 as uuid } from "uuid";
 import {
+	type ITelemetryGenericEventExt,
 	createChildLogger,
 	createMultiSinkLogger,
-	type ITelemetryGenericEventExt,
 } from "@fluidframework/telemetry-utils";
+import { ITestDriver, TestDriverTypes } from "@fluidframework/test-driver-definitions";
+import { v4 as uuid } from "uuid";
 import { LoaderContainerTracker } from "./loaderContainerTracker.js";
-import { fluidEntryPoint, LocalCodeLoader } from "./localCodeLoader.js";
+import { LocalCodeLoader, fluidEntryPoint } from "./localCodeLoader.js";
 import { createAndAttachContainer } from "./localLoader.js";
 import { ChannelFactoryRegistry } from "./testFluidObject.js";
 
@@ -108,10 +108,13 @@ export interface ITestObjectProvider {
 	 * containerRuntime/dataRuntime used in fluidEntryPoint will be used as is from what is passed in.
 	 *
 	 * @param packageEntries - list of code details and fluidEntryPoint pairs.
+	 * @param loaderProps - Optional loader properties
+	 * @param forceUseCreateVersion - For Cross-Version compat testing, create a loader based on the create version
 	 */
 	createLoader(
 		packageEntries: Iterable<[IFluidCodeDetails, fluidEntryPoint]>,
 		loaderProps?: Partial<ILoaderProps>,
+		forceUseCreateVersion?: boolean,
 	): IHostLoader;
 
 	/**
@@ -221,6 +224,9 @@ export interface ITestContainerConfig {
 	/** Whether this runtime should be instantiated using a mixed-in attributor class */
 	enableAttribution?: boolean;
 
+	/** For Cross-Version compat testing, load using the create version (e.g. use this to get a Summarizer on the create version) */
+	forceUseCreateVersion?: true;
+
 	/** Loader options for the loader used to create containers */
 	loaderProps?: Partial<ILoaderProps>;
 }
@@ -832,10 +838,14 @@ export class TestObjectProviderWithVersionedLoad implements ITestObjectProvider
 	public createLoader(
 		packageEntries: Iterable<[IFluidCodeDetails, fluidEntryPoint]>,
 		loaderProps?: Partial<ILoaderProps>,
+		forceUseCreateVersion = false,
 	) {
+		const useCreateVersion = forceUseCreateVersion === true || this.useCreateApi;
 		if (this.useCreateApi) {
 			// After we create the first loader, we can set this.useCreateApi to false.
 			this.useCreateApi = false;
+		}
+		if (useCreateVersion) {
 			return this.createLoaderForCreating(packageEntries, loaderProps);
 		}
 		return this.createLoaderForLoading(packageEntries, loaderProps);
@@ -925,6 +935,7 @@ export class TestObjectProviderWithVersionedLoad implements ITestObjectProvider
 		return this.createLoader(
 			[[defaultCodeDetails, this.createFluidEntryPoint(testContainerConfig)]],
 			testContainerConfig?.loaderProps,
+			testContainerConfig?.forceUseCreateVersion,
 		);
 	}