Add security configuration and validation features

- Introduced SecurityConfigurationException to handle invalid security configurations.
- Added SecurityProfile enum to define predefined security profiles for different deployment scenarios.
- Implemented state validator registration methods in SecurityServiceExtensions, including support for function-based validators and composite validators.
- Enhanced TabSync middleware to fail fast on insecure configurations.
- Added FailFastOnInsecureConfiguration option to TabSyncOptions to throw exceptions on misconfigurations.
- Created comprehensive unit tests for secure store features, including security profile detection, state validator registration, and exception handling.

Author: mashrulhaque

README.md

@@ -335,7 +335,29 @@ <h2 id="registration">Registration Methods</h2>
               <p>Methods to register stores in your dependency injection container.</p>
 
               <div class="api-section">
-                <h4><code>AddStoreWithUtilities</code> (Recommended)</h4>
+                <h4><code>AddSecureStore</code> (Recommended for Production)</h4>
+                <p>Automatic security configuration based on environment with all features enabled:</p>
+                <div class="code-block">
+                  <pre><code class="language-csharp">builder.Services.AddSecureStore(
+    new AppState(),
+    "App",
+    opts =>
+    {
+        opts.PersistenceKey = "app-state";   // LocalStorage
+        opts.EnableTabSync = true;            // Cross-tab sync
+        opts.EnableHistory = true;            // Undo/redo
+    });</code></pre>
+                </div>
+                <p>Security profiles applied automatically:</p>
+                <ul>
+                  <li><code>Development</code>: DevTools enabled, permissive validation</li>
+                  <li><code>Production</code>: No DevTools, message signing enabled, validation warnings</li>
+                  <li><code>Strict</code>: All Production features + throws on any security warning</li>
+                </ul>
+              </div>
+
+              <div class="api-section">
+                <h4><code>AddStoreWithUtilities</code></h4>
                 <p>Registers a store with all utility services (debounce, throttle, cache, async executor) in one call.</p>
                 <div class="code-block">
                   <pre><code class="language-csharp">builder.Services.AddStoreWithUtilities(
@@ -376,6 +398,37 @@ <h4><code>AddTransientStore</code> / <code>AddTransientStoreWithUtilities</code>
     (store, sp) => store.WithDefaults(sp, "Temp"));</code></pre>
                 </div>
               </div>
+
+              <h3>Security Registration Methods</h3>
+
+              <div class="api-section">
+                <h4><code>AddStateValidator&lt;TState, TValidator&gt;</code></h4>
+                <p>Registers a state validator class for validation during persistence and sync operations.</p>
+                <div class="code-block">
+                  <pre><code class="language-csharp">builder.Services.AddStateValidator&lt;AppState, AppStateValidator&gt;();</code></pre>
+                </div>
+              </div>
+
+              <div class="api-section">
+                <h4><code>AddStateValidator&lt;TState&gt;</code> (Functional)</h4>
+                <p>Registers a state validator using an inline function.</p>
+                <div class="code-block">
+                  <pre><code class="language-csharp">builder.Services.AddStateValidator&lt;AppState&gt;(state =>
+{
+    var errors = new List&lt;string&gt;();
+    if (state.Count &lt; 0) errors.Add("Count cannot be negative");
+    return errors;
+});</code></pre>
+                </div>
+              </div>
+
+              <div class="api-section">
+                <h4><code>AddStateValidatorsFromAssembly</code></h4>
+                <p>Auto-discovers and registers all <code>IStateValidator&lt;T&gt;</code> implementations from an assembly.</p>
+                <div class="code-block">
+                  <pre><code class="language-csharp">builder.Services.AddStateValidatorsFromAssembly(typeof(Program).Assembly);</code></pre>
+                </div>
+              </div>
             </section>
 
             <!-- StoreBuilder Configuration -->
@@ -804,6 +857,10 @@ <h2 id="quick-reference">Quick Reference</h2>
                   </tr>
                 </thead>
                 <tbody>
+                  <tr>
+                    <td><code>AddSecureStore()</code></td>
+                    <td>Secure store registration with auto-config</td>
+                  </tr>
                   <tr>
                     <td><code>StoreComponent&lt;T&gt;</code></td>
                     <td>Base component with auto-subscription</td>

docs-site/api-reference.html

@@ -134,10 +134,32 @@ <h2>Installation</h2>
             <!-- Requirements -->
             <section class="section">
               <h2>Requirements</h2>
+              <h3>Supported Platforms</h3>
+              <table class="table">
+                <thead>
+                  <tr>
+                    <th>.NET Version</th>
+                    <th>Status</th>
+                  </tr>
+                </thead>
+                <tbody>
+                  <tr>
+                    <td>.NET 8.0</td>
+                    <td>Fully Supported</td>
+                  </tr>
+                  <tr>
+                    <td>.NET 9.0</td>
+                    <td>Fully Supported</td>
+                  </tr>
+                  <tr>
+                    <td>.NET 10.0</td>
+                    <td>Fully Supported</td>
+                  </tr>
+                </tbody>
+              </table>
               <div class="alert alert-info">
                 <div class="alert-title">Prerequisites</div>
                 <ul style="margin: 0.5rem 0 0 1.5rem;">
-                  <li>.NET 8.0 or higher</li>
                   <li>Blazor Server, WebAssembly, or Blazor Web App</li>
                   <li>Package size: Only 38 KB gzipped (less than 0.1% of your app)</li>
                 </ul>