nuget package upgrades

Author: HaikAsatryan

.github/workflows/main.yml

@@ -1,33 +1,73 @@
-name: Deploy NuGet Package
+name: Publish NuGet Package
 
 env:
-  PROJECT_PATH: './src/SharedKernel.Postgres/SharedKernel.Postgres.csproj'
-  OUTPUT_DIR: 'nupkgs'
-  NUGET_SOURCE: 'https://api.nuget.org/v3/index.json'
-  NUGET_API_KEY: ${{ secrets.NUGET_API_KEY }}
+  PROJECT_PATH: src/SharedKernel.Postgres/SharedKernel.Postgres.csproj
+  OUTPUT_DIR: nupkgs
+  NUGET_SOURCE: https://api.nuget.org/v3/index.json
 
 on:
   push:
-    branches:
-      - main
+    branches: [main]
+
+permissions:
+  contents: read
+
 jobs:
-  deploy:
+  publish:
     runs-on: ubuntu-latest
 
     steps:
       - name: Checkout
         uses: actions/checkout@v6
 
-      - name: Setup .NET Core
+      - name: Setup .NET
         uses: actions/setup-dotnet@v5
         with:
           global-json-file: global.json
 
+      - name: Restore
+        run: dotnet restore ${{ env.PROJECT_PATH }}
+
       - name: Build
-        run: dotnet build ${{ env.PROJECT_PATH }}
+        run: dotnet build ${{ env.PROJECT_PATH }} --no-restore --configuration Release
+
+#      - name: Test
+#        run: dotnet test --no-build --configuration Release --verbosity normal
 
       - name: Pack
-        run: dotnet pack ${{ env.PROJECT_PATH }} --output ${{ env.OUTPUT_DIR }}
+        run: dotnet pack ${{ env.PROJECT_PATH }} --no-build --configuration Release --output ${{ env.OUTPUT_DIR }}
 
       - name: Publish
-        run: dotnet nuget push ${{ env.OUTPUT_DIR }}/*.nupkg -k ${{ env.NUGET_API_KEY }} -s ${{ env.NUGET_SOURCE }}
+        env:
+          NUGET_API_KEY: ${{ secrets.NUGET_API_KEY }}
+        shell: bash
+        run: |
+          set -euo pipefail
+
+          if [ -z "${NUGET_API_KEY:-}" ]; then
+            echo "NUGET_API_KEY secret is not set."
+            exit 1
+          fi
+
+          shopt -s nullglob
+
+          nupkgs=( "${{ env.OUTPUT_DIR }}"/*.nupkg )
+          snupkgs=( "${{ env.OUTPUT_DIR }}"/*.snupkg )
+
+          if [ ${#nupkgs[@]} -eq 0 ]; then
+            echo "No .nupkg files found in ${{ env.OUTPUT_DIR }}"
+            ls -la "${{ env.OUTPUT_DIR }}" || true
+            exit 1
+          fi
+
+          dotnet nuget push "${nupkgs[@]}" \
+            --api-key "$NUGET_API_KEY" \
+            --source "${{ env.NUGET_SOURCE }}" \
+            --skip-duplicate
+
+          if [ ${#snupkgs[@]} -gt 0 ]; then
+            dotnet nuget push "${snupkgs[@]}" \
+              --api-key "$NUGET_API_KEY" \
+              --source "${{ env.NUGET_SOURCE }}" \
+              --skip-duplicate
+          fi

README.md

@@ -0,0 +1,180 @@
+# Pandatech.SharedKernel.Postgres
+
+PostgreSQL integration helpers for ASP.NET Core 10. Wraps Npgsql, Entity Framework Core, health checks, exception
+mapping, query locks, snake_case naming, and audit trail wiring into a small set of extension methods so every service
+starts from the same consistent baseline.
+
+Requires **.NET 10.0**. Uses C# 14 extension members and cannot be downgraded.
+
+---
+
+## Table of Contents
+
+1. [Installation](#installation)
+2. [What is included](#what-is-included)
+3. [Registering a DbContext](#registering-a-dbcontext)
+4. [Migrations](#migrations)
+5. [Model configuration helpers](#model-configuration-helpers)
+6. [Health checks](#health-checks)
+
+---
+
+## Installation
+
+```bash
+dotnet add package Pandatech.SharedKernel.Postgres
+```
+
+---
+
+## What is included
+
+Every `AddPostgresContext*` overload automatically applies the following to your DbContext:
+
+| Feature                           | Source package                              |
+|-----------------------------------|---------------------------------------------|
+| Npgsql provider                   | `Npgsql.EntityFrameworkCore.PostgreSQL`     |
+| Snake_case naming convention      | `EFCore.NamingConventions`                  |
+| Query locks (`FOR UPDATE` etc.)   | `Pandatech.EFCore.PostgresExtensions`       |
+| Friendly exception mapping        | `EntityFrameworkCore.Exceptions.PostgreSQL` |
+| `AuditBase` property validation   | `Pandatech.EFCore.AuditBase`                |
+| Audit trail interceptors (opt-in) | `Pandatech.EFCore.Audit`                    |
+| Postgres health check             | `AspNetCore.HealthChecks.NpgSql`            |
+| Bulk extensions                   | `EFCore.BulkExtensions.PostgreSql`          |
+| Gridify query extensions          | `Pandatech.GridifyExtensions`               |
+
+---
+
+## Registering a DbContext
+
+All overloads are on `WebApplicationBuilder` and return `WebApplicationBuilder` for chaining. Every variant
+automatically registers a Postgres health check named `postgres_{DatabaseName}`.
+
+### Basic registration (no pooling, no audit trail)
+
+```csharp
+// Minimal — connection string only
+builder.AddPostgresContext<AppDbContext>(connectionString);
+
+// With migrations assembly by name
+builder.AddPostgresContext<AppDbContext>(connectionString, "MyApp.Migrations");
+
+// With migrations assembly by Assembly reference
+builder.AddPostgresContext<AppDbContext>(connectionString, typeof(Program).Assembly);
+
+// With migrations assembly by marker type
+builder.AddPostgresContext<AppDbContext, Program>(connectionString);
+
+// Full control via NpgsqlDbContextOptionsBuilder callback
+builder.AddPostgresContext<AppDbContext>(connectionString, npgsql =>
+{
+    npgsql.MigrationsAssembly("MyApp.Migrations");
+    npgsql.CommandTimeout(60);
+});
+```
+
+### With connection pooling
+
+Same set of overloads, prefixed with `Pool`:
+
+```csharp
+builder.AddPostgresContextPool<AppDbContext>(connectionString);
+builder.AddPostgresContextPool<AppDbContext>(connectionString, "MyApp.Migrations");
+builder.AddPostgresContextPool<AppDbContext, Program>(connectionString);
+builder.AddPostgresContextPool<AppDbContext>(connectionString, npgsql => { ... });
+```
+
+Use pooling for high-throughput services. Note that DbContext pooling requires that your context has no scoped
+dependencies injected via the constructor; use service provider overloads (`(sp, options) => ...`) for those cases.
+
+### With audit trail (no pooling)
+
+Registers the `Pandatech.EFCore.Audit` interceptors alongside the standard options:
+
+```csharp
+builder.AddPostgresContextWithAuditTrail<AppDbContext>(connectionString);
+builder.AddPostgresContextWithAuditTrail<AppDbContext>(connectionString, "MyApp.Migrations");
+builder.AddPostgresContextWithAuditTrail<AppDbContext, Program>(connectionString);
+builder.AddPostgresContextWithAuditTrail<AppDbContext>(connectionString, npgsql => { ... });
+```
+
+### With pooling and audit trail
+
+```csharp
+builder.AddPostgresContextPoolWithAuditTrail<AppDbContext>(connectionString);
+builder.AddPostgresContextPoolWithAuditTrail<AppDbContext>(connectionString, "MyApp.Migrations");
+builder.AddPostgresContextPoolWithAuditTrail<AppDbContext, Program>(connectionString);
+builder.AddPostgresContextPoolWithAuditTrail<AppDbContext>(connectionString, npgsql => { ... });
+```
+
+---
+
+## Migrations
+
+Apply pending migrations at startup:
+
+```csharp
+// Synchronous
+app.MigrateDatabase<AppDbContext>();
+
+// Asynchronous
+await app.MigrateDatabaseAsync<AppDbContext>(ct);
+```
+
+Both create a scoped service provider, resolve the context, and call `Database.Migrate` / `Database.MigrateAsync`.
+Place these calls after `app.Build()` and before `app.Run()`.
+
+---
+
+## Model configuration helpers
+
+Add to `ConfigureConventions` and `OnModelCreating` in your DbContext:
+
+```csharp
+protected override void ConfigureConventions(ModelConfigurationBuilder builder)
+{
+    // Map all decimal properties to NUMERIC(40, 20) — prevents precision loss
+    builder.ConfigureDecimalType();
+}
+
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    // Set all foreign key delete behavior to Restrict (no accidental cascades)
+    modelBuilder.RestrictFkDeleteBehaviorByDefault();
+}
+```
+
+`ConfigureDecimalType` sets precision `(40, 20)` globally. Override individual properties via `[Precision]` or fluent
+API if you need a narrower type for a specific column.
+
+`RestrictFkDeleteBehaviorByDefault` iterates all foreign keys at model build time and sets `DeleteBehavior.Restrict`.
+Override individual relationships fluently after this call if cascade delete is intentionally needed.
+
+---
+
+## Health checks
+
+The health check is registered automatically by every `AddPostgresContext*` overload. It uses
+`AspNetCore.HealthChecks.NpgSql` with a 5-second timeout and is named `postgres_{DatabaseName}` where the database
+name is parsed from the connection string.
+
+To expose the health check endpoint, use `MapHealthCheckEndpoints()` from `Pandatech.SharedKernel`:
+
+```csharp
+app.MapHealthCheckEndpoints(); // /above-board/health
+```
+
+Or register your own endpoint:
+
+```csharp
+app.MapHealthChecks("/health");
+```
+
+If the database name cannot be parsed from the connection string, registration throws `ArgumentException` at startup
+rather than silently registering a misnamed check.
+
+---
+
+## License
+
+MIT