@fluidframework/container-loader 3.0.1 → 3.1.0

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # @fluidframework/container-loader
 
+## 3.1.0
+
+Dependency updates only.
+
 ## 3.0.0
 
 ### Minor Changes

package/README.md

@@ -40,8 +40,7 @@
 
 -   [Quorum and Proposals](../../../server/routerlicious/packages/protocol-base/README.md)
 
-<!-- AUTO-GENERATED-CONTENT:START (LIBRARY_README_HEADER) -->
-
+<!-- markdown-magic:begin {"transform":"library-readme-header","headingLevel":2} -->
 <!-- prettier-ignore-start -->
 <!-- NOTE: This section is automatically generated using @fluid-tools/markdown-magic. Do not update these generated contents directly. -->
 
@@ -75,8 +74,7 @@ Import the `legacy` APIs from `@fluidframework/container-loader/legacy`.
 Read the **@fluidframework/container-loader** API documentation at <https://fluidframework.com/docs/apis/container-loader>.
 
 <!-- prettier-ignore-end -->
-
-<!-- AUTO-GENERATED-CONTENT:END -->
+<!-- markdown-magic:end -->
 
 ## Fluid Loader
 
@@ -295,8 +293,7 @@ Note that when an active connection is in place, it's just a matter of time befo
 
 `Container.isDirty` can be used to get current state of container.
 
-<!-- AUTO-GENERATED-CONTENT:START (README_FOOTER) -->
-
+<!-- markdown-magic:begin {"transform":"readme-footer","headingLevel":2} -->
 <!-- prettier-ignore-start -->
 <!-- NOTE: This section is automatically generated using @fluid-tools/markdown-magic. Do not update these generated contents directly. -->
 
@@ -313,29 +310,29 @@ To request support for a configuration that is not listed, file an issue.
 The product team will evaluate your request.
 In the issue, specify the current status of the configuration:
 
--   The configuration works but needs official support.
--   The configuration does not work and requires changes.
+- The configuration works but needs official support.
+- The configuration does not work and requires changes.
 
 ### Supported Runtimes
 
--   Fluid Framework supports Node.js versions 22 and 24 while they receive [upstream support](https://nodejs.org/en/about/previous-releases).
-    -   Fluid Framework will stop support for version 22 [when upstream support ends on 2027-04-30](https://github.com/nodejs/release#release-schedule).
-    -   Fluid Framework does not support Node.js with the `--no-experimental-fetch` flag.
--   Fluid Framework supports modern browsers that support the ES2022 standard library.
+- Fluid Framework supports Node.js versions 22 and 24 while they receive [upstream support](https://nodejs.org/en/about/previous-releases).
+  - Fluid Framework will stop support for version 22 [when upstream support ends on 2027-04-30](https://github.com/nodejs/release#release-schedule).
+  - Fluid Framework does not support Node.js with the `--no-experimental-fetch` flag.
+- Fluid Framework supports modern browsers that support the ES2022 standard library.
 
 ### Supported Tools
 
--   [TypeScript 6.0](https://typescriptdocs.com/release-notes/TypeScript%206.0):
-    -   Fluid Framework supports all [`strict`](https://www.typescriptlang.org/tsconfig) options.
-    -   Set the build targets (`lib`, `target`) to `ES2022` or later.
-    -   Enable [`strictNullChecks`](https://www.typescriptlang.org/tsconfig).
-    -   Fluid Framework does not support [configuration options deprecated in TypeScript 6.0](https://typescriptdocs.com/release-notes/TypeScript%206.0#breaking-changes-and-deprecations-in-typescript-6-0).
-    -   Fluid Framework does not fully support `exactOptionalPropertyTypes`.
-        If you enable this option, do not use `in`, `Reflect.has`, `Object.hasOwn`, or `Object.prototype.hasOwnProperty` to narrow members of Fluid Framework types.
-        These methods can incorrectly exclude `undefined` from the possible values.
--   [webpack](https://webpack.js.org/) 5
-    -   We do not require a specific bundler.
-        Other bundlers that handle ES Modules can work, but we actively test only webpack.
+- [TypeScript 6.0](https://typescriptdocs.com/release-notes/TypeScript%206.0):
+  - Fluid Framework supports all [`strict`](https://www.typescriptlang.org/tsconfig) options.
+  - Set the build targets (`lib`, `target`) to `ES2022` or later.
+  - Enable [`strictNullChecks`](https://www.typescriptlang.org/tsconfig).
+  - Fluid Framework does not support [configuration options deprecated in TypeScript 6.0](https://typescriptdocs.com/release-notes/TypeScript%206.0#breaking-changes-and-deprecations-in-typescript-6-0).
+  - Fluid Framework does not fully support `exactOptionalPropertyTypes`.
+    If you enable this option, do not use `in`, `Reflect.has`, `Object.hasOwn`, or `Object.prototype.hasOwnProperty` to narrow members of Fluid Framework types.
+    These methods can incorrectly exclude `undefined` from the possible values.
+- [webpack](https://webpack.js.org/) 5
+  - We do not require a specific bundler.
+    Other bundlers that handle ES Modules can work, but we actively test only webpack.
 
 ### Module Resolution
 
@@ -346,25 +343,25 @@ Do not use `Node10` module resolution.
 
 ### Module Formats
 
--   ES Modules:
-    Use ES Modules to consume Fluid Framework client packages, including in Node.js.
--   CommonJS:
-    Fluid Framework does not officially support CommonJS in version 3.0 or later.
+- ES Modules:
+  Use ES Modules to consume Fluid Framework client packages, including in Node.js.
+- CommonJS:
+  Fluid Framework does not officially support CommonJS in version 3.0 or later.
 
 ## Contribution Guidelines
 
 You can [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid Framework in these ways:
 
--   Answer questions in [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).
--   [Submit bug reports](https://github.com/microsoft/FluidFramework/issues) and help verify fixes.
--   Review [source code changes](https://github.com/microsoft/FluidFramework/pulls).
--   [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).
+- Answer questions in [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).
+- [Submit bug reports](https://github.com/microsoft/FluidFramework/issues) and help verify fixes.
+- Review [source code changes](https://github.com/microsoft/FluidFramework/pulls).
+- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).
 
 For detailed instructions, read the [repo documentation](https://github.com/microsoft/FluidFramework/blob/main/docs/content/Home.md).
 
 This project follows the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
 For more information, read the [Code of Conduct frequently asked questions](https://opensource.microsoft.com/codeofconduct/faq/).
-For questions or comments, contact [opencode@microsoft.com](mailto:opencode@microsoft.com).
+For questions or comments, contact <opencode@microsoft.com>.
 
 This project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.
 Use of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).
@@ -385,5 +382,4 @@ Use of these trademarks or logos must follow Microsoft's [Trademark & Brand Guid
 Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.
 
 <!-- prettier-ignore-end -->
-
-<!-- AUTO-GENERATED-CONTENT:END -->
+<!-- markdown-magic:end -->

package/dist/loaderLayerCompatState.d.ts

@@ -13,11 +13,11 @@ export declare const loaderCoreCompatDetails: {
     /**
      * The package version of the Loader layer.
      */
-    readonly pkgVersion: "3.0.1";
+    readonly pkgVersion: "3.1.0";
     /**
      * The current generation of the Loader layer.
      */
-    readonly generation: 9;
+    readonly generation: 10;
 };
 /**
  * Loader's compatibility details that is exposed to the Runtime layer.

package/dist/packageVersion.d.ts

@@ -5,5 +5,5 @@
  * THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY
  */
 export declare const pkgName = "@fluidframework/container-loader";
-export declare const pkgVersion = "3.0.1";
+export declare const pkgVersion = "3.1.0";
 //# sourceMappingURL=packageVersion.d.ts.map

package/dist/packageVersion.js

@@ -8,5 +8,5 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.pkgVersion = exports.pkgName = void 0;
 exports.pkgName = "@fluidframework/container-loader";
-exports.pkgVersion = "3.0.1";
+exports.pkgVersion = "3.1.0";
 //# sourceMappingURL=packageVersion.js.map

package/dist/packageVersion.js.map

@@ -1 +1 @@
-{"version":3,"file":"packageVersion.js","sourceRoot":"","sources":["../src/packageVersion.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEU,QAAA,OAAO,GAAG,kCAAkC,CAAC;AAC7C,QAAA,UAAU,GAAG,OAAO,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n *\n * THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY\n */\n\nexport const pkgName = \"@fluidframework/container-loader\";\nexport const pkgVersion = \"3.0.1\";\n"]}
+{"version":3,"file":"packageVersion.js","sourceRoot":"","sources":["../src/packageVersion.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEU,QAAA,OAAO,GAAG,kCAAkC,CAAC;AAC7C,QAAA,UAAU,GAAG,OAAO,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n *\n * THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY\n */\n\nexport const pkgName = \"@fluidframework/container-loader\";\nexport const pkgVersion = \"3.1.0\";\n"]}

package/lib/loaderLayerCompatState.d.ts

@@ -13,11 +13,11 @@ export declare const loaderCoreCompatDetails: {
     /**
      * The package version of the Loader layer.
      */
-    readonly pkgVersion: "3.0.1";
+    readonly pkgVersion: "3.1.0";
     /**
      * The current generation of the Loader layer.
      */
-    readonly generation: 9;
+    readonly generation: 10;
 };
 /**
  * Loader's compatibility details that is exposed to the Runtime layer.

package/lib/packageVersion.d.ts

@@ -5,5 +5,5 @@
  * THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY
  */
 export declare const pkgName = "@fluidframework/container-loader";
-export declare const pkgVersion = "3.0.1";
+export declare const pkgVersion = "3.1.0";
 //# sourceMappingURL=packageVersion.d.ts.map

package/lib/packageVersion.js

@@ -5,5 +5,5 @@
  * THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY
  */
 export const pkgName = "@fluidframework/container-loader";
-export const pkgVersion = "3.0.1";
+export const pkgVersion = "3.1.0";
 //# sourceMappingURL=packageVersion.js.map

package/lib/packageVersion.js.map

@@ -1 +1 @@
-{"version":3,"file":"packageVersion.js","sourceRoot":"","sources":["../src/packageVersion.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,kCAAkC,CAAC;AAC1D,MAAM,CAAC,MAAM,UAAU,GAAG,OAAO,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n *\n * THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY\n */\n\nexport const pkgName = \"@fluidframework/container-loader\";\nexport const pkgVersion = \"3.0.1\";\n"]}
+{"version":3,"file":"packageVersion.js","sourceRoot":"","sources":["../src/packageVersion.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,kCAAkC,CAAC;AAC1D,MAAM,CAAC,MAAM,UAAU,GAAG,OAAO,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n *\n * THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY\n */\n\nexport const pkgName = \"@fluidframework/container-loader\";\nexport const pkgVersion = \"3.1.0\";\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fluidframework/container-loader",
-  "version": "3.0.1",
+  "version": "3.1.0",
   "description": "Fluid container loader",
   "homepage": "https://fluidframework.com",
   "repository": {
@@ -67,13 +67,13 @@
     "temp-directory": "nyc/.nyc_output"
   },
   "dependencies": {
-    "@fluid-internal/client-utils": "~3.0.1",
-    "@fluidframework/container-definitions": "~3.0.1",
-    "@fluidframework/core-interfaces": "~3.0.1",
-    "@fluidframework/core-utils": "~3.0.1",
-    "@fluidframework/driver-definitions": "~3.0.1",
-    "@fluidframework/driver-utils": "~3.0.1",
-    "@fluidframework/telemetry-utils": "~3.0.1",
+    "@fluid-internal/client-utils": "~3.1.0",
+    "@fluidframework/container-definitions": "~3.1.0",
+    "@fluidframework/core-interfaces": "~3.1.0",
+    "@fluidframework/core-utils": "~3.1.0",
+    "@fluidframework/driver-definitions": "~3.1.0",
+    "@fluidframework/driver-utils": "~3.1.0",
+    "@fluidframework/telemetry-utils": "~3.1.0",
     "debug": "^4.3.4",
     "double-ended-queue": "^2.1.0-0",
     "events_pkg": "npm:events@^3.1.0",
@@ -82,9 +82,9 @@
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",
     "@biomejs/biome": "~2.4.5",
-    "@fluid-internal/client-utils": "~3.0.1",
-    "@fluid-internal/mocha-test-setup": "~3.0.1",
-    "@fluid-private/test-loader-utils": "~3.0.1",
+    "@fluid-internal/client-utils": "~3.1.0",
+    "@fluid-internal/mocha-test-setup": "~3.1.0",
+    "@fluid-private/test-loader-utils": "~3.1.0",
     "@fluid-tools/build-cli": "^0.67.0",
     "@fluidframework/build-common": "^2.0.3",
     "@fluidframework/build-tools": "^0.67.0",

package/src/packageVersion.ts

@@ -6,4 +6,4 @@
  */
 
 export const pkgName = "@fluidframework/container-loader";
-export const pkgVersion = "3.0.1";
+export const pkgVersion = "3.1.0";

package/src/pointInTime/DEV.md

@@ -45,6 +45,8 @@ The result is a historical view with these invariants:
 3. `PointInTimeDocumentServiceFactory` adapts that capability to the normal `createDocumentService` call used by container loading, preserving the requested target sequence number.
 4. The driver creates a point-in-time document service:
    - storage serves a recoverable snapshot whose sequence number is at or before the target;
+   - the initial snapshot read bypasses persistent and in-memory prefetched snapshot caches so they
+     cannot replace the selected recoverable snapshot with a newer snapshot;
    - delta storage serves the live document's retained ops, bounded so replay cannot pass the target;
    - the service is storage-only, preventing a live delta-stream connection.
 5. `loadContainerPaused` loads the selected snapshot with automatic op processing disabled and forces the container into read-only mode.
@@ -237,7 +239,9 @@ ODSP unit coverage exercises base selection, no-base failures, version URL resol
 Real-service ODSP coverage lives under [`packages/test/test-end-to-end-tests/src/test/pointInTime/`](../../../../test/test-end-to-end-tests/src/test/pointInTime/):
 
 - `loadToSequenceNumber.spec.ts` covers exact version boundaries, replay to a mid-stream target, and distinct historical targets.
-- `loadSuccess.spec.ts` covers the earliest recoverable state, deterministic repeated loads, a frozen read-only result, and deep-history replay.
+- `loadSuccess.spec.ts` covers the earliest recoverable state, deterministic repeated loads, a
+  first historical load with a newer live snapshot already in persistent cache, a frozen read-only
+  result, and deep-history replay.
 - `epochMismatch.spec.ts` and `loadFailure.spec.ts` cover lineage changes, unavailable ops, malformed targets, and cancellation during replay.
 - `odspVersionApi.spec.ts` verifies the real-service version-history test setup.
 - `pointInTimeTestUtils.ts` supplies the shared counter runtime, summarizer, version-snapshot helpers, and point-in-time load wrapper.
@@ -251,7 +255,10 @@ The following loading behaviors are covered by unit or integration tests, inferr
 1. **Boundary targets:** Load sequence number `0` and the current live tip. Existing successful tests use a non-zero recoverable point and advance the document past the target before loading.
 2. **Complex runtime op representations:** Load across grouped, compressed, and chunked batches, including a large payload that genuinely uses the chunk-reassembly path. The current `SharedCounter` scenarios generate small operations. This is separate from delta-fetch page batching below.
 3. **Attachment and blob state:** Create an attachment or blob-backed handle after the base snapshot, load to a target after its attach op, and verify the historical container can read the expected content.
-4. **Cache and load isolation:** Run concurrent loads to different targets, then perform a normal live load with the same factory credentials. Verify each historical view remains pinned to its own target and no historical snapshot leaks through shared or persisted caches.
+4. **Cache and load isolation:** A first historical load with a newer live snapshot already in the
+   same persistent cache is covered. Still run concurrent loads to different targets, then perform a
+   normal live load with the same factory credentials. Verify each historical view remains pinned to
+   its own target and no historical snapshot leaks through shared or persisted caches.
 5. **Cancellation entry and propagation:** Pass an already-aborted signal and verify no storage work begins. During replay, propagate cancellation through the delta-storage fetch rather than only rejecting the loader's wait promise, and verify retries and network reads stop promptly. The existing cancellation test aborts only after replay has begun and observes that storage retries can continue racing teardown.
 6. **Read-only enforcement:** Attempt a DDS mutation and call `connect()` on the returned historical container, then verify no op is submitted, no live connection is established, and the view does not advance. Existing coverage checks the exposed read-only and disconnected state without attempting either action.
 7. **Mid-load lineage change:** Trigger a file restore after base-version discovery but before or during live-op replay and verify the shared `EpochTracker` rejects the mixed lineage. Existing epoch tests restore before the point-in-time load starts.