Add BLite.Client NuGet README and release publish job

Author: mrdevrobot

.github/workflows/release.yml

@@ -5,6 +5,7 @@
 # Produces:
 #   • Docker image pushed to ghcr.io/entgldb/blite-server
 #   • Docker image pushed to docker.io/mrdevrobotentgldb/blite-server
+#   • NuGet package BLite.Client published to nuget.org
 #   • Windows installer (.exe) built with Inno Setup 6
 #   • Linux tarball (.tar.gz) with self-contained binary + install.sh
 #   • GitHub Release with all artifacts attached
@@ -21,6 +22,41 @@ permissions:
   packages: write   # push to ghcr.io
 
 jobs:
+  # ── NuGet package ───────────────────────────────────────────────────────────
+  nuget-client:
+    name: Pack & Publish BLite.Client
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout BLite.Server
+        uses: actions/checkout@v4
+        with:
+          path: BLite.Server
+
+      - name: Extract version
+        id: version
+        run: echo "version=${GITHUB_REF_NAME#v}" >> "$GITHUB_OUTPUT"
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: "10.0.x"
+
+      - name: Pack BLite.Client
+        run: >
+          dotnet pack BLite.Server/src/BLite.Client/BLite.Client.csproj
+          --configuration Release
+          --output artifacts/nuget
+          -p:Version=${{ steps.version.outputs.version }}
+          --nologo
+
+      - name: Publish BLite.Client to NuGet.org
+        run: >
+          dotnet nuget push "artifacts/nuget/BLite.Client.${{ steps.version.outputs.version }}.nupkg"
+          --source https://api.nuget.org/v3/index.json
+          --api-key ${{ secrets.NUGET_API_KEY }}
+          --skip-duplicate
+
   # ── Docker image ─────────────────────────────────────────────────────────────
   docker:
     name: Build & Push Docker Image
@@ -193,7 +229,7 @@ jobs:
   release:
     name: Create GitHub Release
     runs-on: ubuntu-latest
-    needs: [docker, windows-installer, linux-installer]
+    needs: [nuget-client, docker, windows-installer, linux-installer]
 
     steps:
       - name: Download Windows installer

src/BLite.Client/README.md

@@ -1,2 +1,154 @@
-# BLite.Client.Net
+# BLite.Client
+
+Official .NET SDK for BLite Server over gRPC.
+
+## What You Get
+
+- Typed collections (`IDocumentCollection<TId, T>`)
+- Dynamic BSON collections
+- LINQ query push-down
+- Transactions
+- Key-value API
+- Admin API (users and tenants)
+
+## Install
+
+```bash
+dotnet add package BLite.Client
+```
+
+## 1. Connect To BLite Server
+
+```csharp
+using BLite.Client;
+
+await using var client = new BLiteClient(new BLiteClientOptions
+{
+    Host = "localhost",
+    Port = 2626,
+    ApiKey = "your-api-key",
+    UseTls = false
+});
+```
+
+`Port` must point to the gRPC endpoint (`2626` by default).
+
+## 2. Typed Collections (Recommended)
+
+```csharp
+using BLite.Bson;
+
+[DocumentMapper("users")]
+public class User
+{
+    [BsonId]
+    public ObjectId Id { get; set; }
+
+    public string Name { get; set; } = string.Empty;
+    public int Age { get; set; }
+}
+```
+
+Use the generated mapper (for example `UserMapper`) to get a typed collection:
+
+```csharp
+var users = client.GetDocumentCollection<ObjectId, User>(new UserMapper());
+
+await users.InsertAsync(new User
+{
+    Id = ObjectId.NewObjectId(),
+    Name = "Alice",
+    Age = 30
+});
+
+var adults = await users.AsQueryable()
+    .Where(x => x.Age >= 18)
+    .OrderBy(x => x.Name)
+    .ToListAsync();
+```
+
+## 3. Dynamic BSON Collections
+
+```csharp
+using BLite.Bson;
+using BLite.Proto;
+
+var sensors = client.GetDynamicCollection("sensors");
+
+var doc = await sensors.NewDocumentAsync(["name", "temp"], b => b
+    .AddString("name", "room-1")
+    .AddDouble("temp", 21.5));
+
+_ = await sensors.InsertAsync(doc);
+
+var q = new QueryDescriptor
+{
+    Collection = "sensors",
+    Where = new BinaryFilter
+    {
+        Field = "temp",
+        Op = FilterOp.Gt,
+        Value = ScalarValue.From(20)
+    }
+};
+
+await foreach (var item in sensors.QueryAsync(q))
+{
+    // process item
+}
+```
+
+## 4. Transactions
+
+```csharp
+await using var tx = await client.BeginTransactionAsync();
+
+await users.InsertAsync(new User
+{
+    Id = ObjectId.NewObjectId(),
+    Name = "Bob",
+    Age = 41
+}, tx);
+
+await tx.CommitAsync();
+```
+
+## 5. Key-Value API
+
+```csharp
+using System.Text;
+
+await client.Kv.SetAsync("session:abc", Encoding.UTF8.GetBytes("payload"));
+var value = await client.Kv.GetAsync("session:abc");
+```
+
+## 6. Admin API
+
+```csharp
+using BLite.Core.Query;
+
+var createdKey = await client.Admin.CreateUserAsync(
+    username: "reporting",
+    namespaceName: null,
+    databaseId: null,
+    permissions:
+    [
+        new UserPermission
+        {
+            Collection = "reports",
+            Ops = BLiteOperation.Query
+        }
+    ]);
+```
+
+## Notes
+
+- BLite Server must be reachable on gRPC endpoint.
+- In production prefer `UseTls = true` and secure secret handling for API keys.
+- Unsupported LINQ operators are applied client-side after streaming.
+
+## Links
+
+- BLite Server: https://github.com/EntglDb/BLite.Server
+- BLite engine: https://github.com/EntglDb/BLite