feat: Migrate API client generation from NSwag to Refitter, introducing granular endpoint interfaces, new DTOs, and updated client registration with Polly policies.

Author: aalmada

.refitter

@@ -0,0 +1,30 @@
+{
+  "openApiPath": "openapi.json",
+  "namespace": "BookStore.Client",
+  "naming": {
+    "useOpenApiTitle": false,
+    "interfaceName": "I{controller}Endpoint"
+  },
+  "multipleInterfaces": "ByEndpoint",
+  "generateContracts": true,
+  "generateXmlDocCodeComments": false,
+  "generateStatusCodeComments": true,
+  "typeAccessibility": "public",
+  "useCancellationTokens": true,
+  "useIsoDateFormat": false,
+  "outputFolder": "src/Client/BookStore.Client",
+  "outputFilename": "IBookStoreApiClient.g.cs",
+  "contractsOutputFolder": "src/Client/BookStore.Client",
+  "contractsOutputFilename": "Contracts.g.cs",
+  "additionalNamespaces": [
+    "BookStore.Shared.Models"
+  ],
+  "returnIApiResponse": false,
+  "generateOperationHeaders": true,
+  "typeAccessibilityForContracts": "public",
+  "codeGeneratorSettings": {
+    "excludedTypeNames": [
+      "PartialDate"
+    ]
+  }
+}

README.md

@@ -173,6 +173,8 @@ BookStore/
 - **TUnit** - Modern testing framework with built-in code coverage
 - **Roslyn Analyzers** - Custom analyzers for Event Sourcing/CQRS patterns
 - **Roslynator.Analyzers 4.15.0** - Enhanced code analysis
+- **Refit** - Type-safe REST library for .NET
+- **Refitter** - Tool to generate Refit interfaces from OpenAPI specifications
 - **NSwag** - OpenAPI client generation (optional development tool)
 
 ## 📊 API Endpoints

_tools/generate-client-nswag.sh

@@ -0,0 +1,40 @@
+#!/bin/bash
+# Generate API client using Refitter (Refit interfaces + DTOs)
+# Generates clean Refit interfaces from OpenAPI spec
+
+set -e
+
+echo "🔄 Generating API client with Refitter..."
+echo ""
+
+# Check if openapi.json exists
+if [ ! -f "openapi.json" ]; then
+    echo "❌ openapi.json not found"
+    echo ""
+    echo "Run ./_tools/update-openapi.sh first to download the spec"
+    exit 1
+fi
+
+# Generate Refit client with DTOs
+echo "📝 Generating Refit interfaces + DTOs..."
+refitter --settings-file .refitter --skip-validation
+
+if [ $? -eq 0 ]; then
+    echo ""
+    echo "✅ Client generated successfully!"
+    echo ""
+    echo "📝 Generated files:"
+    echo "  - 28 Refit interface files (I*Endpoint.cs)"
+    echo "  - 1 Contracts file (Contracts.cs with all DTOs)"
+    echo ""
+    echo "📝 Next steps:"
+    echo "  1. Review generated files: src/Client/BookStore.Client/"
+    echo "  2. Build project: dotnet build"
+    echo "  3. Commit changes: git add openapi.json src/Client/BookStore.Client/"
+    echo "  4. Commit message: git commit -m 'Update API client from OpenAPI spec'"
+    echo ""
+else
+    echo ""
+    echo "❌ Client generation failed"
+    exit 1
+fi