Skip to content

Releases: microsoft/FluidFramework

Fluid Framework v2.0.0-internal.4.0.0 (major)

24 Mar 22:50
b550faf
Compare
Choose a tag to compare

This is a major release that includes breaking changes in addition to deprecations that will take effect in a future major release.

💥 Breaking changes

This release contains the following breaking changes:

Container and RelativeLoader no longer exported

Container and RelativeLoader are no longer exported. All Container usages should have previously moved to IContainer. RelativeLoader is an internal implementation which should not be exposed or used directly.

Remove ensureContainerConnected() in @fluidframework/test-utils

This function was deprecated in a previous release and has now been removed.
Use waitForContainerConnection() from the same package instead.
See the note about breaking
changes in that function in this release.

New default parameter values for waitForContainerConnection() in @fluidframework/test-utils

The default value for the failOnContainerClose parameter has changed from false to true for function
waitForContainerConnection() exported by @fluidframework/test-utils.

This is overall a safer default because it ensures that unexpected errors which cause the Container to close are surfaced
immediately, instead of potentially being hidden by a timeout.

Most use cases should prefer true; explicit passing of false should only be necessary when the caller expects the
Container to connect or close for some reason.

Some test packages no longer published

These packages were previously published under the @fluidframework scope:

  • @fluidframework/test-drivers
  • @fluidframework/test-pairwise-generator
  • @fluidframework/test-version-utils
  • @fluidframework/test-loader-utils

These have been moved to the @fluid-internal scope and are no longer published.

IFluidHTMLView, ReactViewAdapter, and HTMLViewAdapter removed

IFluidHTMLView, ReactViewAdapter, and HTMLViewAdapter were deprecated in 2.0.0-internal.3.2.0, and are now removed.

IFluidTokenProvider removed

The IFluidTokenProvider interface was deprecated in 2.0.0-internal.3.2.0, and is now removed.

Summarizer node and related items removed

The following functions, interfaces, and types currently available in @fluidframework/runtime-utils were deprecated in 2.0.0-internal.3.0.0 and are now removed.

  • createRootSummarizerNode
  • createRootSummarizerNodeWithGC
  • IFetchSnapshotResult
  • IRootSummarizerNode
  • IRootSummarizerNodeWithGC
  • ISummarizerNodeRootContract
  • RefreshSummaryResult

web-code-loader and ICodeAllowList removed

The @fluidframework/web-code-loader and the ICodeAllowList were deprecated in 2.0.0-internal.3.2.0, and are now removed.

Container and IContainer no longer raise events when a new listener is registered

Container and IContainer had previously raised the connected, disconnected, dirty, and saved events when a new listener was registered and the corresponding state was true. This behavior has been removed. To avoid issues, add checks to the state of the container before registering listeners.

	// Ensure client is connected
+	if (container.connectionState !== ConnectionState.Connected) {
		await new Promise<void>((resolve) => {
			container.once("connected", resolve);
		});
+   }

Remove deprecated PendingStateManager interfaces

The following interfaces used by the PendingStateManager are no longer exported:

  • IPendingMessage
  • IPendingFlush
  • IPendingState
  • IPendingLocalState

Aqueduct members removed

ContainerServices in @fluidframework/aqueduct and waitForAttach() was deprecated in 2.0.0-internal.3.0.0 and has now been removed.

driver-utils members removed

The following members of the @fluidframework/driver-utils package were deprecated in 2.0.0-internal.3.0.0 or earlier, and are now removed:

  • waitForConnectedState
  • MapWithExpiration
  • configurableUrlResolver
  • MultiUrlResolver
  • MultiDocumentServiceFactory
  • BlobCacheStorageService
  • EmptyDocumentDeltaStorageService
  • convertSnapshotAndBlobsToSummaryTree
  • ISummaryTreeAssemblerProps
  • SummaryTreeAssembler
  • BlobAggregationStorage
  • SnapshotExtractor
  • isUnpackedRuntimeMessage
  • IAnyDriverError

Remove IConnectableRuntime.deltaManager

Note: IConnectableRuntime is only to be implemented internally, so removing this should not be impactful.

IDocumentServiceFactory.protocolName removed

IDocumentServiceFactory.protocolName was deprecated in 2.0.0-internal.3.0.0 and has now been removed.

Changes to Summarizer's public API

The following interfaces and exports in @fluidframework/container-runtime deprecated since 0.14.0
have been removed and have no replacement:

  • IProvideSummarizer interface
  • ISummarizer const (note: the ISummarizer interface still exists and is used)

Additionally, the ISummarizer interface no longer extends IFluidLoadable nor Partial<IProvideSummarizer>.
This means it no longer has readonly properties IFluidLoadable and handle.

Deprecations

bindToContext deprecated in IFluidDataStoreContext

bindToContext in IFluidDataStoreContext was deprecated in 2.0.0-internal.2.0.0. This is a heads up that it will be removed in 2.0.0-internal.5.0.0. Its usage in FluidDataStoreRuntime was removed in this release.

getBaseGCDetails deprecated in IFluidDataStoreContext and CreateChildSummarizerNodeFn

getBaseGCDetails() has been deprecated in IFluidDataStoreContext and CreateChildSummarizerNodeFn. The functionality to update the base GC details of nodes has been moved to summarizer nodes. These will be removed in 2.0.0-internal.5.0.0.

Fluid Framework v2.0.0-internal.3.4.2 (patch)

30 Mar 18:51
de3b823
Compare
Choose a tag to compare

This is a patch release that fixes a failure when trying to access localStorage (PR #14760)

SweepReadyUsageDetectionHandler accesses localStorage which can fail if access to localStorage is not allowed. We are seeing this happening in production. This removes the usage of SweepReadyUsageDetectionHandler in garbage collector - It was added by #12004 but the sweep ready detection feature was never enabled.

Fluid Framework v2.0.0-internal.3.4.1 (patch)

24 Mar 22:09
859c1b5
Compare
Choose a tag to compare

This is a patch release that fixes the dependency ranges of the published packages (PR #14727)

In the previous release (v2.0.0-internal.3.4.1), dependencies on other Fluid Framework packages were specified using a caret (^). However, they should have been using >= < range dependencies. This release contains corrected >= < dependencies.

Fluid Framework v2.0.0-internal.3.0.5 (patch)

27 Mar 16:32
d52ee3c
Compare
Choose a tag to compare

This is a patch release that fixes a failure when trying to access localStorage (PR #14760)

SweepReadyUsageDetectionHandler accesses localStorage which can fail if access to localStorage is not allowed. We are seeing this happening in production. This removes the usage of SweepReadyUsageDetectionHandler in garbage collector - It was added by #12004 but the sweep ready detection feature was never enabled.

server v0.1038.4000

23 Mar 00:15
713cbc1
Compare
Choose a tag to compare

This is a minor release.

build-tools v0.13.0

22 Mar 20:12
3f87129
Compare
Choose a tag to compare

The 0.13 build-tools release includes a new command, flub exec, and various bug fixes. These release notes
cover the major changes in this release.

✨ Features

flub exec runs shell commands in the context of repo projects

PR #14635

The flub exec command can be used to execute shell commands in the context of packages or release groups in the repo.

The following example runs pnpm -r remove @rushstack/eslint-config on all independent packages and all release group root packages:

flub exec --all --releaseGroupRoots "pnpm -r remove @rushstack/eslint-config"

check policy has a setting to ignore single-package pnpm workspaces

PR #14656

pnpm does not support nesting packages under a workspace that is not managed by the workspace. That is, if there's a pnpm-workspace.yaml file anywhere in the parent hierarchy, pnpm doesn't install the package individually like one might expect.

Because we have the client release group at the root of the repo, there's a pnpm-workspace.yaml file in the hierarchy for our independent packages as well. We put a workspace file in each independent package so pnpm treats the project as a one-package workspace.

However, for check policy, we need to be able to treat these single-package workspaces differently. In particular we
don't want to enforce the preinstall script that we use in release group roots. There is now a setting that contains a list of packages that are single-package workspaces.

🐛 Bug fixes

This list only includes notable bug fixes. See the changelog for a full list of fixes in this release.

check policy now uses the correct indentation when editing package.json files

PR #14481

Previously the indentation was changed to spaces when check policy was run. This has been corrected.

Fluid Framework v2.0.0-internal.3.4.0

22 Mar 22:24
9cdbe82
Compare
Choose a tag to compare
Pre-release

This is a minor release that includes several deprecations that will take effect in a future major release.

Deprecations

This list includes deprecations new to v2.0.0-internal.3.4.0 and those made in the previous minor release, 2.0.0-internal.3.3.0.

IResolvedUrl will be equivalent to IFluidResolvedUrl

In @fluidframework/driver-definitions IResolvedUrlBase and IWebResolvedUrl are deprecated as they are not used.
This will make IResolvedUrl and IFluidResolvedUrl equivalent. Since all ResolvedUrls will now be FluidResolvedUrls we no longer need to differentiate them. In @fluidframework/driver-utils isFluidResolvedUrl and
ensureFluidResolvedUrl will be deprecated and removed due to this.

LoaderHeader.cache deprecated

In @fluidframework/container-definitions, the cache value from the LoaderHeader enum has been deprecated.
Therefore, the [LoaderHeader.cache] property from ILoaderHeader is also deprecated. They will both be removed in the next major release, as well as all caching functionality of containers. Cache support will be removed soon, please try not to rely on caching, and inform us if you cannot do so.

deltaManager property in IConnectableRuntime moved

The deltaManager property in IConnectableRuntime has been moved to ISummarizerRuntime directly. ISummarizerRuntime extends IConnectableRuntime so it hasn't been changed.

attachGraph and bind methods in IFluidHandle deprecated

attachGraph and bind methods in IFluidHandle have been deprecated. These are internal methods used by the Fluid Framework and should not be used. They will be removed in a future release.

Some APIs meant only for internal usage are deprecated

IGarbageCollectionRuntime in the @fluidframework/container-runtime package should not be used outside the FF codebase. It has been deprecated and is expected to be removed in the next major release.

IConnectableRuntime.deltaManager in the same package is no longer used and deprecated as well.

Fluid Framework v2.0.0-internal.3.3.2 - deprecated

11 Apr 21:36
4813ed5
Compare
Choose a tag to compare

This version is deprecated. Please use the latest minor for 2.0.0.internal.3.x

Fluid Framework v2.0.0-internal.3.3.1 - deprecated

11 Apr 21:36
b303f4f
Compare
Choose a tag to compare

This version is deprecated. Please use the latest minor for 2.0.0.internal.3.x

Fluid Framework v2.0.0-internal.3.3.0 - Deprecated

11 Apr 21:35
94646cb
Compare
Choose a tag to compare

This version is deprecated. Please use the latest minor for 2.0.0.internal.3.x