feat: add readme and prepare for initial release

Author: ChristianHaase

ByteGuard.FileValidator.Extensions.DependencyInjection.slnx

@@ -4,7 +4,6 @@
     <File Path="Directory.Build.props" />
     <File Path="Directory.Version.props" />
     <File Path="LICENSE" />
-    <File Path="README.md" />
   </Folder>
   <Folder Name="/tests/">
     <Project Path="tests/FileValidator.Extensions.DependencyInjection.Tests.Unit/FileValidator.Extensions.DependencyInjection.Tests.Unit.csproj" />

README.md

@@ -1,2 +1,83 @@
 # ByteGuard.FileValidator.Extensions.DependencyInjection ![NuGet Version](https://img.shields.io/nuget/v/ByteGuard.FileValidator.Extensions.DependencyInjection)
 
+`ByteGuard.FileValidator.Extensions.DependencyInjection` provides first-class integration of `ByteGuard.FileValidator` with `Microsoft.Extensions.DependencyInjection`.
+
+It gives you: 
+- Extension methods to register the file validator in the DI container
+- Easy configuration via appsettings.json or fluent configuration in code
+
+> This package is the `Microsoft.Extensions.DependencyInjection` integration layer.
+> The core validation logic lives in [`ByteGuard.FileValidator`](https://github.com/ByteGuard-HQ/byteguard-file-validator-net).
+
+## Getting Started
+
+### Installation
+This package is published and installed via NuGet.
+
+Reference the package in your project:
+```bash
+dotnet add package ByteGuard.FileValidator.Extensions.DependencyInjection
+```
+
+## Usage
+
+### Add to DI container
+In your `Program.cs` (or `Startup.cs` in older projects), register the validator:
+
+```csharp
+using ByteGuard.FileValidator;
+using ByteGuard.FileValidator.Extensions.DependencyInjection;
+
+// Using inline configuration
+builder.Services.AddFileValidator(options => 
+{
+    options.AllowFileTypes(FileExtensions.Pdf, FileExtensions.Jpg, FileExtensions.Png);
+    options.FileSizeLimit = ByteSize.MegaBytes(25);
+    options.ThrowOnInvalidFiles(false);
+});
+
+// Using configuration from appsettings.json
+builder.Services.AddFileValidator(options => configuration.GetSection("FileValidatorConfiguration").Bind(options));
+```
+
+### Injection & Usage
+You can then inject `FileValidator` into your services and other classes.
+
+```csharp
+public class MyService
+{
+    private readonly FileValidator _fileValidator;
+
+    public MyService(FileValidator fileValidator)
+    {
+        _fileValidator = fileValidator;
+    }
+
+    public bool SaveFile(Stream fileStream, string fileName)
+    {
+        var isValid = _fileValidator.IsValidFile(fileName, fileStream);
+        
+        // ...
+    }
+}
+```
+
+### Configuration via appsettings
+It's possible to configure the `FileValidator` through `appsettings.json`.
+
+> _ℹ️ As you'll notice below, you can either define the `FileSizeLimit` in raw byte size, or use the `UnitFileSizeLimit` to define
+> the file size in a more human readable format. When both are defined, `FileSizeLimit` always wins over `UnitFileSizeLimit`._
+
+```json
+{
+  "FileValidatorConfiguration": {
+    "SupportedFileTypes": [ ".pdf", ".jpg", ".png" ],
+    "FileSizeLimit": 26214400,
+    "UnitFileSizeLimit": "25MB",
+    "ThrowExceptionOnInvalidFile": true
+  }
+}
+```
+
+## License
+_ByteGuard.FileValidator.Extensions.DpendencyInjection is Copyright © ByteGuard Contributors - Provided under the MIT license._

src/ByteGuard.FileValidator.Extensions.DependencyInjection/ByteGuard.FileValidator.Extensions.DependencyInjection.csproj

@@ -2,7 +2,7 @@
 
   <PropertyGroup>
     <TargetFrameworks>net8.0;net9.0;net10.0</TargetFrameworks>
-    <Authors>ByteGuard Contributors, detilium</Authors>
+    <Authors>ByteGuard Contributors</Authors>
     <Description>ByteGuard File Validator support for Microsoft.Extensions.DependencyInjection.</Description>
     <PackageProjectUrl>https://github.com/ByteGuard-HQ/byteguard-file-validator-extensions-dependency-injection</PackageProjectUrl>
     <RepositoryUrl>https://github.com/ByteGuard-HQ/byteguard-file-validator-extensions-dependency-injection</RepositoryUrl>