Add LittleShop.Client SDK library with complete API wrapper

Features: - Complete .NET client SDK for LittleShop API - JWT authentication with automatic token management - Catalog service for products and categories - Order service with payment creation - Retry policies using Polly for resilience - Error handling middleware - Dependency injection support - Comprehensive documentation and examples SDK Components: - Authentication service with token refresh - Strongly-typed models for all API responses - HTTP handlers for retry and error handling - Extension methods for easy DI registration - Example console application demonstrating usage Test Updates: - Fixed test compilation errors - Updated test data builders for new models - Corrected service constructor dependencies - Fixed enum value changes (PaymentStatus, OrderStatus) Documentation: - Complete project README with features and usage - Client SDK README with detailed examples - API endpoint documentation - Security considerations - Deployment guidelines Generated with Claude Code Co-Authored-By: Claude <noreply@anthropic.com>
2025-08-20 18:15:35 +01:00
parent a281bb2896
commit 1f7c0af497
28 changed files with 1810 additions and 33 deletions
--- a/LittleShop.Client/Services/OrderService.cs
+++ b/LittleShop.Client/Services/OrderService.cs
@@ -0,0 +1,143 @@
+using System.Net.Http.Json;
+using LittleShop.Client.Models;
+using Microsoft.Extensions.Logging;
+
+namespace LittleShop.Client.Services;
+
+public class OrderService : IOrderService
+{
+    private readonly HttpClient _httpClient;
+    private readonly ILogger<OrderService> _logger;
+    
+    public OrderService(HttpClient httpClient, ILogger<OrderService> logger)
+    {
+        _httpClient = httpClient;
+        _logger = logger;
+    }
+    
+    public async Task<ApiResponse<Order>> CreateOrderAsync(CreateOrderRequest request)
+    {
+        try
+        {
+            var response = await _httpClient.PostAsJsonAsync("api/orders", request);
+            
+            if (response.IsSuccessStatusCode)
+            {
+                var order = await response.Content.ReadFromJsonAsync<Order>();
+                if (order != null)
+                    return ApiResponse<Order>.Success(order, response.StatusCode);
+            }
+            
+            var error = await response.Content.ReadAsStringAsync();
+            return ApiResponse<Order>.Failure(error, response.StatusCode);
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Failed to create order");
+            return ApiResponse<Order>.Failure(
+                ex.Message, 
+                System.Net.HttpStatusCode.InternalServerError);
+        }
+    }
+    
+    public async Task<ApiResponse<List<Order>>> GetOrdersByIdentityAsync(string identityReference)
+    {
+        try
+        {
+            var response = await _httpClient.GetAsync(
+                $"api/orders/by-identity/{Uri.EscapeDataString(identityReference)}");
+            
+            if (response.IsSuccessStatusCode)
+            {
+                var orders = await response.Content.ReadFromJsonAsync<List<Order>>();
+                return ApiResponse<List<Order>>.Success(orders ?? new List<Order>());
+            }
+            
+            var error = await response.Content.ReadAsStringAsync();
+            return ApiResponse<List<Order>>.Failure(error, response.StatusCode);
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Failed to get orders for identity {Identity}", identityReference);
+            return ApiResponse<List<Order>>.Failure(
+                ex.Message, 
+                System.Net.HttpStatusCode.InternalServerError);
+        }
+    }
+    
+    public async Task<ApiResponse<Order>> GetOrderByIdAsync(Guid id)
+    {
+        try
+        {
+            var response = await _httpClient.GetAsync($"api/orders/{id}");
+            
+            if (response.IsSuccessStatusCode)
+            {
+                var order = await response.Content.ReadFromJsonAsync<Order>();
+                if (order != null)
+                    return ApiResponse<Order>.Success(order);
+            }
+            
+            var error = await response.Content.ReadAsStringAsync();
+            return ApiResponse<Order>.Failure(error, response.StatusCode);
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Failed to get order {OrderId}", id);
+            return ApiResponse<Order>.Failure(
+                ex.Message, 
+                System.Net.HttpStatusCode.InternalServerError);
+        }
+    }
+    
+    public async Task<ApiResponse<CryptoPayment>> CreatePaymentAsync(Guid orderId, string currency)
+    {
+        try
+        {
+            var request = new CreatePaymentRequest { Currency = currency };
+            var response = await _httpClient.PostAsJsonAsync(
+                $"api/orders/{orderId}/payments", request);
+            
+            if (response.IsSuccessStatusCode)
+            {
+                var payment = await response.Content.ReadFromJsonAsync<CryptoPayment>();
+                if (payment != null)
+                    return ApiResponse<CryptoPayment>.Success(payment, response.StatusCode);
+            }
+            
+            var error = await response.Content.ReadAsStringAsync();
+            return ApiResponse<CryptoPayment>.Failure(error, response.StatusCode);
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Failed to create payment for order {OrderId}", orderId);
+            return ApiResponse<CryptoPayment>.Failure(
+                ex.Message, 
+                System.Net.HttpStatusCode.InternalServerError);
+        }
+    }
+    
+    public async Task<ApiResponse<List<CryptoPayment>>> GetOrderPaymentsAsync(Guid orderId)
+    {
+        try
+        {
+            var response = await _httpClient.GetAsync($"api/orders/{orderId}/payments");
+            
+            if (response.IsSuccessStatusCode)
+            {
+                var payments = await response.Content.ReadFromJsonAsync<List<CryptoPayment>>();
+                return ApiResponse<List<CryptoPayment>>.Success(payments ?? new List<CryptoPayment>());
+            }
+            
+            var error = await response.Content.ReadAsStringAsync();
+            return ApiResponse<List<CryptoPayment>>.Failure(error, response.StatusCode);
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Failed to get payments for order {OrderId}", orderId);
+            return ApiResponse<List<CryptoPayment>>.Failure(
+                ex.Message, 
+                System.Net.HttpStatusCode.InternalServerError);
+        }
+    }
+}