add browser storage provider and verification

Author: KSemenenko

.github/workflows/ci.yml

@@ -26,12 +26,18 @@ jobs:
     - name: Restore dependencies
       run: dotnet restore ManagedCode.Storage.slnx
 
+    - name: Restore .NET tools
+      run: dotnet tool restore
+
     - name: Verify formatting
       run: dotnet format ManagedCode.Storage.slnx --verify-no-changes --no-restore
 
     - name: Build
       run: dotnet build ManagedCode.Storage.slnx --configuration Release --no-restore
 
+    - name: Install Playwright browser
+      run: dotnet playwright -p Tests/ManagedCode.Storage.Tests/ManagedCode.Storage.Tests.csproj install chromium
+
     - name: Test
       run: dotnet test Tests/ManagedCode.Storage.Tests/ManagedCode.Storage.Tests.csproj --configuration Release --no-build --verbosity normal --collect:"XPlat Code Coverage"
 

.github/workflows/release.yml

@@ -35,9 +35,15 @@ jobs:
     - name: Restore dependencies
       run: dotnet restore ManagedCode.Storage.slnx
 
+    - name: Restore .NET tools
+      run: dotnet tool restore
+
     - name: Build
       run: dotnet build ManagedCode.Storage.slnx --configuration Release --no-restore
 
+    - name: Install Playwright browser
+      run: dotnet playwright -p Tests/ManagedCode.Storage.Tests/ManagedCode.Storage.Tests.csproj install chromium
+
     - name: Test
       run: dotnet test Tests/ManagedCode.Storage.Tests/ManagedCode.Storage.Tests.csproj --configuration Release --no-build --verbosity normal
 

AGENTS.md

@@ -25,6 +25,7 @@ This file defines how AI agents work in this solution.
   - `Integraions/ManagedCode.Storage.Orleans/`
   - `Integraions/ManagedCode.Storage.Server/`
   - `Storages/ManagedCode.Storage.Aws/`
+  - `Storages/ManagedCode.Storage.Browser/`
   - `Storages/ManagedCode.Storage.Azure/`
   - `Storages/ManagedCode.Storage.Azure.DataLake/`
   - `Storages/ManagedCode.Storage.CloudKit/`
@@ -35,6 +36,8 @@ This file defines how AI agents work in this solution.
   - `Storages/ManagedCode.Storage.OneDrive/`
   - `Storages/ManagedCode.Storage.Sftp/`
   - `Tests/ManagedCode.Storage.Tests/`
+  - `Tests/ManagedCode.Storage.BrowserServerHost/`
+  - `Tests/ManagedCode.Storage.BrowserWasmHost/`
 
 ## Rule Precedence
 
@@ -222,19 +225,21 @@ Toolchain notes:
 - Each public API endpoint has at least one test; complex endpoints need tests for different inputs and errors.
 - Integration tests must exercise real flows end-to-end, not just call endpoints in isolation.
 - Prefer integration or API tests over isolated unit tests.
-- Keep mocks to an absolute minimum; prefer real flows using fakes or containers where possible.
+- Do not use fakes in automated tests; validate behavior through real runtimes, browser sessions, or containerized dependencies.
+- For browser-storage scenarios, verify through handwritten Razor-based test apps in both Blazor WebAssembly and Interactive Server, driven by Playwright against real browser state.
+- When browser storage behavior could race across pages or tabs, add explicit concurrency coverage.
 - Never write tests that only validate mocked interactions; every test must assert concrete, observable behavior such as state, output, errors, or side effects.
-- When faking external APIs, match the official API docs for endpoints, status codes, payloads, and field naming, and prefer `HttpMessageHandler`-based fakes over ad-hoc mocks.
-- No mocks for internal systems such as databases, queues, or caches; use containers or fakes as appropriate.
-- Mocks are allowed only for external third-party systems.
+- When third-party systems must be simulated, prefer real protocol-compatible test infrastructure over in-process fakes.
+- No mocks for internal systems such as databases, queues, caches, or browser runtimes.
+- Mocks are allowed only as a last resort for external third-party systems when no real or containerized alternative exists, and that exception must be called out explicitly in the task summary.
 - Never delete or weaken a test to make it pass.
 - Each test must verify a real flow or scenario; tests without meaningful assertions are forbidden.
 - Check coverage to find gaps, not to chase a number.
 - Tests use `xUnit` + `Shouldly`; choose `[Fact]` for atomic cases and `[Theory]` for data-driven permutations.
 - Tests run on `VSTest`; do not mix in `Microsoft.Testing.Platform` assumptions.
 - Coverage uses the repo-defined `coverlet.msbuild` flow and must not regress without a written exception.
 - Place provider suites under `Tests/ManagedCode.Storage.Tests/Storages/` and reuse `Tests/ManagedCode.Storage.Tests/Common/` helpers for Testcontainers infrastructure such as Azurite, LocalStack, and FakeGcsServer.
-- Add fakes or harnesses in `ManagedCode.Storage.TestFakes/` when introducing new providers.
+- For browser providers, put end-to-end Playwright coverage in `Tests/ManagedCode.Storage.Tests/Storages/Browser/` and keep the executable test hosts under `Tests/ManagedCode.Storage.BrowserServerHost/` and `Tests/ManagedCode.Storage.BrowserWasmHost/`.
 
 ### Storage Platform
 
@@ -277,6 +282,7 @@ Toolchain notes:
 - Remove unused usings and let analyzers guide layout.
 - When a `foreach` loop starts by transforming the iteration variable, prefer mapping the sequence explicitly with `.Select(...)` so the intent is clearer.
 - Avoid buffering whole files into `MemoryStream` in product code; assume multi-GB files and stream directly to the destination while using incremental hashing or CRC when verification is needed.
+- Stream capability properties such as `CanSeek`, `CanWrite`, `Length`, and `Position` must reflect the real backing stream or selected strategy; do not hardcode capability flags in a way that changes stream semantics silently.
 - No magic literals; extract them to constants, enums, configuration, or dedicated value types when it improves clarity.
 
 ### Git And PRs
@@ -315,4 +321,9 @@ Ask first:
 
 ### Likes
 
+- Repository-facing docs, especially `README.md`, should stay in English and describe only the current supported behavior, not transitional legacy or fallback paths.
+
 ### Dislikes
+
+- Template-generated scaffolding in tests; keep test hosts and verification surfaces minimal, hand-written, and purpose-built.
+- Unnecessary product-code fallbacks; prefer one clear production path unless backward compatibility is an explicit requirement for the task.

Directory.Build.props

@@ -29,8 +29,8 @@
         <RepositoryUrl>https://github.com/managedcode/Storage</RepositoryUrl>
         <PackageProjectUrl>https://github.com/managedcode/Storage</PackageProjectUrl>
         <Product>Managed Code - Storage</Product>
-        <Version>10.0.3</Version>
-        <PackageVersion>10.0.3</PackageVersion>
+        <Version>10.0.4</Version>
+        <PackageVersion>10.0.4</PackageVersion>
 
     </PropertyGroup>
 

Directory.Packages.props

@@ -1,50 +1,53 @@
 <Project>
-    <PropertyGroup>
-        <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
-    </PropertyGroup>
-
-    <ItemGroup>
-        <PackageVersion Include="AWSSDK.S3" Version="4.0.19" />
-        <PackageVersion Include="Azure.Identity" Version="1.19.0" />
-        <PackageVersion Include="Azure.Storage.Blobs" Version="12.27.0" />
-        <PackageVersion Include="Azure.Storage.Files.DataLake" Version="12.25.0" />
-        <PackageVersion Include="coverlet.collector" Version="8.0.0" />
-        <PackageVersion Include="coverlet.msbuild" Version="8.0.0" />
-        <PackageVersion Include="CsvHelper" Version="33.1.0" />
-        <PackageVersion Include="DotNet.ReproducibleBuilds" Version="1.2.25" />
-        <PackageVersion Include="Dropbox.Api" Version="7.0.0" />
-        <PackageVersion Include="Google.Api.Gax" Version="4.13.1" />
-        <PackageVersion Include="Google.Api.Gax.Rest" Version="4.13.1" />
-        <PackageVersion Include="Google.Apis.Drive.v3" Version="1.73.0.4068" />
-        <PackageVersion Include="Google.Apis.Storage.v1" Version="1.73.0.4052" />
-        <PackageVersion Include="Google.Cloud.Storage.V1" Version="4.14.0" />
-        <PackageVersion Include="Humanizer.Core" Version="3.0.10" />
-        <PackageVersion Include="ManagedCode.Communication" Version="10.0.1" />
-        <PackageVersion Include="ManagedCode.MimeTypes" Version="10.0.1" />
-        <PackageVersion Include="Microsoft.AspNetCore.Http" Version="2.3.9" />
-        <PackageVersion Include="Microsoft.AspNetCore.Http.Connections.Client" Version="10.0.5" />
-        <PackageVersion Include="Microsoft.AspNetCore.Mvc.Testing" Version="10.0.5" />
-        <PackageVersion Include="Microsoft.AspNetCore.SignalR.Client" Version="10.0.5" />
-        <PackageVersion Include="Microsoft.AspNetCore.TestHost" Version="10.0.5" />
-        <PackageVersion Include="Microsoft.Extensions.Caching.Memory" Version="10.0.5" />
-        <PackageVersion Include="Microsoft.Extensions.DependencyInjection" Version="10.0.5" />
-        <PackageVersion Include="Microsoft.Extensions.DependencyInjection.Abstractions" Version="10.0.5" />
-        <PackageVersion Include="Microsoft.Extensions.Logging" Version="10.0.5" />
-        <PackageVersion Include="Microsoft.Extensions.Logging.Abstractions" Version="10.0.5" />
-        <PackageVersion Include="Microsoft.Extensions.Options" Version="10.0.5" />
-        <PackageVersion Include="Microsoft.Graph" Version="5.103.0" />
-        <PackageVersion Include="Microsoft.NET.Test.Sdk" Version="18.3.0" />
-        <PackageVersion Include="Microsoft.Orleans.Runtime" Version="10.0.1" />
-        <PackageVersion Include="Microsoft.Orleans.TestingHost" Version="10.0.1" />
-        <PackageVersion Include="NetArchTest.Rules" Version="1.3.2" />
-        <PackageVersion Include="Shouldly" Version="4.3.0" />
-        <PackageVersion Include="SSH.NET" Version="2025.1.0" />
-        <PackageVersion Include="Testcontainers" Version="4.11.0" />
-        <PackageVersion Include="Testcontainers.Azurite" Version="4.11.0" />
-        <PackageVersion Include="Testcontainers.FakeGcsServer" Version="4.11.0" />
-        <PackageVersion Include="Testcontainers.LocalStack" Version="4.11.0" />
-        <PackageVersion Include="Testcontainers.Sftp" Version="4.11.0" />
-        <PackageVersion Include="xunit" Version="2.9.3" />
-        <PackageVersion Include="xunit.runner.visualstudio" Version="3.1.5" />
-    </ItemGroup>
+  <PropertyGroup>
+    <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
+  </PropertyGroup>
+  <ItemGroup>
+    <PackageVersion Include="AWSSDK.S3" Version="4.0.19.4" />
+    <PackageVersion Include="Azure.Identity" Version="1.20.0" />
+    <PackageVersion Include="Azure.Storage.Blobs" Version="12.27.0" />
+    <PackageVersion Include="Azure.Storage.Files.DataLake" Version="12.25.0" />
+    <PackageVersion Include="coverlet.collector" Version="8.0.1" />
+    <PackageVersion Include="coverlet.msbuild" Version="8.0.1" />
+    <PackageVersion Include="CsvHelper" Version="33.1.0" />
+    <PackageVersion Include="DotNet.ReproducibleBuilds" Version="1.2.25" />
+    <PackageVersion Include="Dropbox.Api" Version="7.0.0" />
+    <PackageVersion Include="Google.Api.Gax" Version="4.13.1" />
+    <PackageVersion Include="Google.Api.Gax.Rest" Version="4.13.1" />
+    <PackageVersion Include="Google.Apis.Drive.v3" Version="1.73.0.4098" />
+    <PackageVersion Include="Google.Apis.Storage.v1" Version="1.73.0.4052" />
+    <PackageVersion Include="Google.Cloud.Storage.V1" Version="4.14.0" />
+    <PackageVersion Include="Humanizer.Core" Version="3.0.10" />
+    <PackageVersion Include="ManagedCode.Communication" Version="10.0.1" />
+    <PackageVersion Include="ManagedCode.MimeTypes" Version="10.0.1" />
+    <PackageVersion Include="Microsoft.AspNetCore.Http" Version="2.3.9" />
+    <PackageVersion Include="Microsoft.AspNetCore.Http.Connections.Client" Version="10.0.5" />
+    <PackageVersion Include="Microsoft.AspNetCore.Components.WebAssembly" Version="10.0.5" />
+    <PackageVersion Include="Microsoft.AspNetCore.Components.WebAssembly.DevServer" Version="10.0.5" />
+    <PackageVersion Include="Microsoft.AspNetCore.Mvc.Testing" Version="10.0.5" />
+    <PackageVersion Include="Microsoft.AspNetCore.SignalR.Client" Version="10.0.5" />
+    <PackageVersion Include="Microsoft.AspNetCore.TestHost" Version="10.0.5" />
+    <PackageVersion Include="Microsoft.Extensions.Caching.Memory" Version="10.0.5" />
+    <PackageVersion Include="Microsoft.Extensions.DependencyInjection" Version="10.0.5" />
+    <PackageVersion Include="Microsoft.Extensions.DependencyInjection.Abstractions" Version="10.0.5" />
+    <PackageVersion Include="Microsoft.Extensions.Logging" Version="10.0.5" />
+    <PackageVersion Include="Microsoft.Extensions.Logging.Abstractions" Version="10.0.5" />
+    <PackageVersion Include="Microsoft.Extensions.Options" Version="10.0.5" />
+    <PackageVersion Include="Microsoft.Graph" Version="5.103.0" />
+    <PackageVersion Include="Microsoft.JSInterop" Version="10.0.5" />
+    <PackageVersion Include="Microsoft.Playwright" Version="1.58.0" />
+    <PackageVersion Include="Microsoft.NET.Test.Sdk" Version="18.3.0" />
+    <PackageVersion Include="Microsoft.Orleans.Runtime" Version="10.0.1" />
+    <PackageVersion Include="Microsoft.Orleans.TestingHost" Version="10.0.1" />
+    <PackageVersion Include="NetArchTest.Rules" Version="1.3.2" />
+    <PackageVersion Include="Shouldly" Version="4.3.0" />
+    <PackageVersion Include="SSH.NET" Version="2025.1.0" />
+    <PackageVersion Include="Testcontainers" Version="4.11.0" />
+    <PackageVersion Include="Testcontainers.Azurite" Version="4.11.0" />
+    <PackageVersion Include="Testcontainers.FakeGcsServer" Version="4.11.0" />
+    <PackageVersion Include="Testcontainers.LocalStack" Version="4.11.0" />
+    <PackageVersion Include="Testcontainers.Sftp" Version="4.11.0" />
+    <PackageVersion Include="xunit" Version="2.9.3" />
+    <PackageVersion Include="xunit.runner.visualstudio" Version="3.1.5" />
+  </ItemGroup>
 </Project>

ManagedCode.Storage.slnx

@@ -12,6 +12,7 @@
   </Folder>
   <Folder Name="/Storages/">
     <Project Path="Storages/ManagedCode.Storage.Aws/ManagedCode.Storage.Aws.csproj" />
+    <Project Path="Storages/ManagedCode.Storage.Browser/ManagedCode.Storage.Browser.csproj" />
     <Project Path="Storages/ManagedCode.Storage.Azure.DataLake/ManagedCode.Storage.Azure.DataLake.csproj" />
     <Project Path="Storages/ManagedCode.Storage.Azure/ManagedCode.Storage.Azure.csproj" />
     <Project Path="Storages/ManagedCode.Storage.FileSystem/ManagedCode.Storage.FileSystem.csproj" />
@@ -23,6 +24,8 @@
     <Project Path="Storages/ManagedCode.Storage.CloudKit/ManagedCode.Storage.CloudKit.csproj" />
   </Folder>
   <Folder Name="/Tests/">
+    <Project Path="Tests/ManagedCode.Storage.BrowserServerHost/ManagedCode.Storage.BrowserServerHost.csproj" />
+    <Project Path="Tests/ManagedCode.Storage.BrowserWasmHost/ManagedCode.Storage.BrowserWasmHost.csproj" />
     <Project Path="Tests/ManagedCode.Storage.Tests/ManagedCode.Storage.Tests.csproj" />
   </Folder>
   <Project Path="ManagedCode.Storage.Core/ManagedCode.Storage.Core.csproj" />