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/Extensions/ServiceCollectionExtensions.cs
+++ b/LittleShop.Client/Extensions/ServiceCollectionExtensions.cs
@@ -0,0 +1,91 @@
+using LittleShop.Client.Configuration;
+using LittleShop.Client.Http;
+using LittleShop.Client.Services;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Logging;
+using Microsoft.Extensions.Options;
+
+namespace LittleShop.Client.Extensions;
+
+public static class ServiceCollectionExtensions
+{
+    public static IServiceCollection AddLittleShopClient(
+        this IServiceCollection services,
+        Action<LittleShopClientOptions>? configureOptions = null)
+    {
+        // Configure options
+        if (configureOptions != null)
+        {
+            services.Configure(configureOptions);
+        }
+        else
+        {
+            services.Configure<LittleShopClientOptions>(options => { });
+        }
+        
+        // Register HTTP handlers
+        services.AddTransient<RetryPolicyHandler>();
+        services.AddTransient<ErrorHandlingMiddleware>();
+        
+        // Register main HTTP client
+        services.AddHttpClient<IAuthenticationService, AuthenticationService>((serviceProvider, client) =>
+        {
+            var options = serviceProvider.GetRequiredService<IOptions<LittleShopClientOptions>>().Value;
+            client.BaseAddress = new Uri(options.BaseUrl);
+            client.Timeout = TimeSpan.FromSeconds(options.TimeoutSeconds);
+            client.DefaultRequestHeaders.Add("Accept", "application/json");
+        })
+        .AddHttpMessageHandler<ErrorHandlingMiddleware>()
+        .AddHttpMessageHandler(serviceProvider =>
+        {
+            var logger = serviceProvider.GetRequiredService<ILogger<RetryPolicyHandler>>();
+            var options = serviceProvider.GetRequiredService<IOptions<LittleShopClientOptions>>().Value;
+            return new RetryPolicyHandler(logger, options.MaxRetryAttempts);
+        });
+        
+        services.AddHttpClient<ICatalogService, CatalogService>((serviceProvider, client) =>
+        {
+            var options = serviceProvider.GetRequiredService<IOptions<LittleShopClientOptions>>().Value;
+            client.BaseAddress = new Uri(options.BaseUrl);
+            client.Timeout = TimeSpan.FromSeconds(options.TimeoutSeconds);
+            client.DefaultRequestHeaders.Add("Accept", "application/json");
+        })
+        .AddHttpMessageHandler<ErrorHandlingMiddleware>()
+        .AddHttpMessageHandler(serviceProvider =>
+        {
+            var logger = serviceProvider.GetRequiredService<ILogger<RetryPolicyHandler>>();
+            var options = serviceProvider.GetRequiredService<IOptions<LittleShopClientOptions>>().Value;
+            return new RetryPolicyHandler(logger, options.MaxRetryAttempts);
+        });
+        
+        services.AddHttpClient<IOrderService, OrderService>((serviceProvider, client) =>
+        {
+            var options = serviceProvider.GetRequiredService<IOptions<LittleShopClientOptions>>().Value;
+            client.BaseAddress = new Uri(options.BaseUrl);
+            client.Timeout = TimeSpan.FromSeconds(options.TimeoutSeconds);
+            client.DefaultRequestHeaders.Add("Accept", "application/json");
+        })
+        .AddHttpMessageHandler<ErrorHandlingMiddleware>()
+        .AddHttpMessageHandler(serviceProvider =>
+        {
+            var logger = serviceProvider.GetRequiredService<ILogger<RetryPolicyHandler>>();
+            var options = serviceProvider.GetRequiredService<IOptions<LittleShopClientOptions>>().Value;
+            return new RetryPolicyHandler(logger, options.MaxRetryAttempts);
+        });
+        
+        // Register the main client
+        services.AddScoped<ILittleShopClient, LittleShopClient>();
+        
+        return services;
+    }
+    
+    public static IServiceCollection AddLittleShopClient(
+        this IServiceCollection services,
+        string baseUrl)
+    {
+        return services.AddLittleShopClient(options =>
+        {
+            options.BaseUrl = baseUrl;
+        });
+    }
+}