refactor(documentation): update

stratdev3 · stratdev3 · commit 2a3c3c9c640c · 2026-03-29T14:30:22.000+02:00
diff --git a/documentation/simplew/docs/addons/helper-hosting.md b/documentation/simplew/docs/addons/helper-hosting.md
@@ -35,7 +35,7 @@ It allows you to :
 Install the package from NuGet:
 
 ```sh
-$ dotnet add package SimpleW.Helper.Hosting --version 26.0.0-rc.20260326-1604
+$ dotnet add package SimpleW.Helper.Hosting --version 26.0.0-rc.20260329-1623
 ```
 
 
diff --git a/documentation/simplew/docs/addons/helper-jwt.md b/documentation/simplew/docs/addons/helper-jwt.md
@@ -25,11 +25,43 @@ It allows you to :
 Install the package from NuGet:
 
 ```sh
-$ dotnet add package SimpleW.Helper.Jwt --version 26.0.0-rc.20260326-1604
+$ dotnet add package SimpleW.Helper.Jwt --version 26.0.0-rc.20260329-1623
 ```
 
+## Configuration options
 
-### Creating a Token
+### JwtBearerOptions
+
+| Option           | Default    | Description                                                                              |
+| ---------------- | ---------- | ---------------------------------------------------------------------------------------- |
+| SecretKey*       | —          | Secret key used to sign and validate JWT tokens (HMAC). Must be strong and kept private. |
+| ExpectedIssuer   | `null`     | Expected `iss` claim. If set, the token must match this value.                           |
+| ExpectedAudience | `null`     | Expected `aud` claim. If set, the token must match this value.                           |
+| ClockSkew        | `1 minute` | Allowed clock drift when validating `exp` and `nbf`.                                     |
+| Algorithm        | `HS256`    | HMAC algorithm used to sign tokens (`HS256`, `HS384`, `HS512`).                          |
+
+### CreateToken options
+
+| Parameter             | Default                    | Description                                                                                  |
+| --------------------- | -------------------------- | -------------------------------------------------------------------------------------------- |
+| options*              | —                          | JWT configuration used for signing and default validation-related values.                    |
+| principal / identity* | —                          | Source object used to generate the JWT payload.                                              |
+| lifetime*             | —                          | Token validity duration. Used to compute `exp`.                                              |
+| issuer                | `options.ExpectedIssuer`   | Optional issuer written into the `iss` claim.                                                |
+| audience              | `options.ExpectedAudience` | Optional audience written into the `aud` claim.                                              |
+| nowUtc                | `DateTimeOffset.UtcNow`    | Optional UTC timestamp override used to compute `iat`, `nbf`, and `exp`. Useful for testing. |
+
+### TryValidateToken options
+
+| Parameter | Description                                                                                |
+| --------- | ------------------------------------------------------------------------------------------ |
+| options*  | JWT configuration used to validate signature, issuer, audience, clock skew, and algorithm. |
+| token*    | JWT string to validate. Must contain exactly 3 parts.                                      |
+| principal | Output principal rebuilt from the token when validation succeeds.                          |
+| error     | Output error message when validation fails.                                                |
+
+
+## Creating a Token
 
 A token is created from an identity.
 
diff --git a/documentation/simplew/docs/addons/helper-razor.md b/documentation/simplew/docs/addons/helper-razor.md
@@ -30,7 +30,7 @@ It allows you to :
 ## Installation
 
 ```sh
-$ dotnet add package SimpleW.Helper.Razor --version 26.0.0-rc.20260326-1604
+$ dotnet add package SimpleW.Helper.Razor --version 26.0.0-rc.20260329-1623
 ```
 
 
diff --git a/documentation/simplew/docs/addons/jsonengine-newtonsoft.md b/documentation/simplew/docs/addons/jsonengine-newtonsoft.md
@@ -20,7 +20,7 @@ For this reason, SimpleW provides an official alternative engine via the `Simple
 #### Installation
 
 ```sh
-$ dotnet add package SimpleW.JsonEngine.Newtonsoft --version 26.0.0-rc.20260326-1604
+$ dotnet add package SimpleW.JsonEngine.Newtonsoft --version 26.0.0-rc.20260329-1623
 ```
 
 
diff --git a/documentation/simplew/docs/addons/service-firewall.md b/documentation/simplew/docs/addons/service-firewall.md
@@ -30,7 +30,7 @@ Optional dependency if you enable GeoIP country filtering :
 ## Installation
 
 ```sh
-$ dotnet add package SimpleW.Service.Firewall --version 26.0.0-rc.20260326-1604
+$ dotnet add package SimpleW.Service.Firewall --version 26.0.0-rc.20260329-1623
 ```
 
 
diff --git a/documentation/simplew/docs/addons/service-latency.md b/documentation/simplew/docs/addons/service-latency.md
@@ -26,7 +26,7 @@ No external dependencies.
 ## Installation
 
 ```sh
-$ dotnet add package SimpleW.Service.Latency --version 26.0.0-rc.20260326-1604
+$ dotnet add package SimpleW.Service.Latency --version 26.0.0-rc.20260329-1623
 ```
 
 
diff --git a/documentation/simplew/docs/addons/service-letsencrypt.md b/documentation/simplew/docs/addons/service-letsencrypt.md
@@ -29,7 +29,7 @@ It allows you to :
 ## Installation
 
 ```sh
-$ dotnet add package SimpleW.Service.Letsencrypt --version 26.0.0-rc.20260326-1604
+$ dotnet add package SimpleW.Service.Letsencrypt --version 26.0.0-rc.20260329-1623
 ```
 
 
diff --git a/documentation/simplew/docs/addons/service-openid.md b/documentation/simplew/docs/addons/service-openid.md
@@ -32,7 +32,7 @@ It allows you to :
 ## Installation
 
 ```sh
-$ dotnet add package SimpleW.Service.OpenID --version 26.0.0-rc.20260326-1604
+$ dotnet add package SimpleW.Service.OpenID --version 26.0.0-rc.20260329-1623
 ```
 
 
diff --git a/documentation/simplew/docs/guide/getting-started.md b/documentation/simplew/docs/guide/getting-started.md
@@ -13,7 +13,7 @@ Stop talking, show me the code !
 Using the nuget package, always prefer the last version.
 
 ```sh
-$ dotnet add package SimpleW --version 26.0.0-rc.20260326-1604
+$ dotnet add package SimpleW --version 26.0.0-rc.20260329-1623
 ```
 
 ::: tip NOTE
diff --git a/documentation/simplew/docs/guide/principal.md b/documentation/simplew/docs/guide/principal.md
@@ -185,15 +185,15 @@ There are **two ways** to define the principal :
 ```csharp [ConfigurePrincipalResolver]
 server.ConfigurePrincipalResolver(session => {
 
-    string? token = session.Request.Headers.Authorization;
-
-    if (string.IsNullOrWhiteSpace(token)) {
-        return null;
-    }
-
-    if (!JwtBearerHelper.TryValidateToken(options, token, out HttpPrincipal? principal, out _)) {
-        return null;
-    }
+    var principal = new HttpPrincipal(new HttpIdentity(
+        isAuthenticated: true,
+        authenticationType: "Custom",
+        identifier: "user-123",
+        name: "John",
+        email: null,
+        roles: new[] { "admin" },
+        properties: null
+    ));
 
     return principal;
 });
diff --git a/documentation/simplew/docs/guide/response.md b/documentation/simplew/docs/guide/response.md
@@ -84,7 +84,7 @@ When you need more control, you can return an explicit `HttpResponse` instance.
 - Control headers
 - Set cookies
 - Choose content type
-- Send files
+- Send files (with Content-Range support)
 - Control compression
 
 `HttpResponse` is accessible from :
@@ -112,6 +112,21 @@ public object Plaintext() {
 }
 ```
 
+Another example :
+
+```csharp
+[Route("GET", "/mp4")]
+public object Plaintext() {
+    return Response.File("video.mp4");
+}
+```
+
+::: info
+`HttpResponse` supports HTTP Range requests out of the box when serving files.
+Range support is especially useful for video streaming (MP4, WebM...), audio streaming or large file downloads (resume support).
+:::
+
+
 ### Common Responses (Aliases)
 
 SimpleW provides helpers for frequent cases:
diff --git a/documentation/simplew/docs/guide/staticfiles.md b/documentation/simplew/docs/guide/staticfiles.md
@@ -122,6 +122,39 @@ It supports realtime file editing even when specific lock/write occurs.
 :::
 
 
+## Range Requests (Streaming Support)
+
+The `StaticFilesModule` automatically supports HTTP **Range requests** when serving files.
+This means that clients can request only a portion of a file instead of downloading it entirely.
+
+This feature is particularly important for video files such as `.mp4`.
+
+Modern browsers use Range requests to :
+- Start playback instantly
+- Jump (seek) to a specific timestamp
+- Avoid downloading the full file
+
+With SimpleW, this works out of the box :
+
+```csharp
+server.UseStaticFilesModule(options => {
+    options.Path = @"C:\videos\";
+    options.Prefix = "/videos/";
+});
+```
+
+Then :
+
+```
+http://localhost:2015/videos/movie.mp4
+```
+
+The video will :
+- Start immediately
+- Alow seeking
+- Use efficient partial downloads
+
+
 ## How to serve a Vue app
 
 This section shows how to server a vue.js application.
diff --git a/documentation/simplew/docs/guide/what-is-simplew.md b/documentation/simplew/docs/guide/what-is-simplew.md
@@ -21,6 +21,16 @@ SimpleW’s architecture and motivations behind its core design choices :
 - **NuGet package available**, **no dependency**, easy to integrate
 
 
+## Philosophy
+
+I want to keep the core simple and lightweight so that :
+- The code can be reviewed by a developer in a few hours
+- Or fully ingested (and reasoned about) by an AI in a few seconds
+
+Addons are the place for everything that does not belong in the core.
+Also, a product is much easier to adopt when there is a healthy ecosystem around it.
+
+
 ## Why this library ?
 
 Most .NET web stacks are powerful but complex. I wanted a **minimal, hackable server** that could be dropped into any app, or used as a base for custom frameworks, game servers, or embedded tools — while still delivering very good performances.
diff --git a/documentation/simplew/docs/version/changelog.md b/documentation/simplew/docs/version/changelog.md
@@ -59,6 +59,7 @@ There is a [complete migration guide](../guide/migrate-from-v16.md).
 | Auth                                 | ⚠️ custom IWebUser       | ✅ Principal / Identity                      |
 | Custom JSON engine                   | ✅                       | ✅                                           |
 | HTTP pipelining                      | ❌                       | ✅                                           |
+| Content Range                        | ❌                       | ✅                                           |
 | Idle Timeout                         | ❌                       | ✅                                           |
 | Request Protection                   | ❌                       | ✅(malformed)                                |
 | Observability                        | ✅ (traces) & global to all processes  | ✅  (traces, metrics, enrich)  per SimpleWServer instance   |
diff --git a/documentation/simplew/docs/version/faq.md b/documentation/simplew/docs/version/faq.md
@@ -17,6 +17,14 @@ Github is just a mirror. Ping me, if your code is interesting and still MIT lice
 
 I don't hate it, but I don't like it (see the paragraph about [Why this library exists](../guide/what-is-simplew.md#why-this-library)).
 
+> Why there is no DI in SimpleW like in ASP.NET Core ?
+
+I really deeply hating how Depending Injection is working on ASP.NET Core. I hate how the framework resolves the full dependency graph recursively and instantiates everything through a DI container :
+
+- I’m not a fan of the _magic_ instantiation model where objects are created implicitly by the framework (except the controller itself)
+- It tends to hide the actual object graph, which can make the execution flow harder to understand and debug
+- It usually introduces a fair amount of boilerplate and configuration for relatively simple use cases
+
 > Do you like Kestrel ?
 
 Kestrel is an awesome server. I just want a serious alternative to its hegemony.
@@ -46,6 +54,8 @@ I want to keep the core simple and lightweight so that :
 Addons are the place for everything that does not belong in the core.
 Also, a product is much easier to adopt when there is a healthy ecosystem around it.
 
+That's my [philosphy](../guide/what-is-simplew.md#philosophy)
+
 > How to use SimpleW ?
 
 I spent a **crazy** amount of time writing documentation. Please, [RTFM](https://en.wikipedia.org/wiki/RTFM)
diff --git a/src/SimpleW.Templates/templates/SimpleW.AspNetCore/ModuleName.csproj b/src/SimpleW.Templates/templates/SimpleW.AspNetCore/ModuleName.csproj
@@ -13,9 +13,9 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="SimpleW" Version="26.0.0-rc.20260326-1604" />
-    <PackageReference Include="SimpleW.Helper.Hosting" Version="26.0.0-rc.20260326-1604" />
-    <PackageReference Include="SimpleW.Helper.Razor" Version="26.0.0-rc.20260326-1604" />
+    <PackageReference Include="SimpleW" Version="26.0.0-rc.20260329-1623" />
+    <PackageReference Include="SimpleW.Helper.Hosting" Version="26.0.0-rc.20260329-1623" />
+    <PackageReference Include="SimpleW.Helper.Razor" Version="26.0.0-rc.20260329-1623" />
   </ItemGroup>
 
   <ItemGroup>
diff --git a/src/SimpleW.Templates/templates/SimpleW.Controller/ModuleName.csproj b/src/SimpleW.Templates/templates/SimpleW.Controller/ModuleName.csproj
@@ -13,7 +13,7 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="SimpleW" Version="26.0.0-rc.20260326-1604" />
+    <PackageReference Include="SimpleW" Version="26.0.0-rc.20260329-1623" />
   </ItemGroup>
 
 </Project>
diff --git a/src/SimpleW.Templates/templates/SimpleW.Minimal/ModuleName.csproj b/src/SimpleW.Templates/templates/SimpleW.Minimal/ModuleName.csproj
@@ -13,7 +13,7 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="SimpleW" Version="26.0.0-rc.20260326-1604" />
+    <PackageReference Include="SimpleW" Version="26.0.0-rc.20260329-1623" />
   </ItemGroup>
 
 </Project>
