fix: Generic API service clients was missing

Author: karlspace

.gitignore

@@ -229,7 +229,6 @@ npm-debug.log*
 # =============================================================================
 # DocFX
 _site/
-api/
 docfx.log
 
 # =============================================================================

README.md

@@ -20,7 +20,7 @@ The BAUER GROUP Shared Platform is a modular, multi-project solution designed to
 - **Modular Architecture**: Pick only the packages you need
 - **Enterprise-Ready Logging**: NLog-based logging with Sentry integration for error tracking
 - **Data Layer**: Support for SQLite (encrypted), LiteDB, and in-memory databases
-- **API Integrations**: Pre-built connectors for e-commerce platforms and shipping providers
+- **API Integrations**: Pre-built API integrations for generic use
 - **Cloud Services**: Cloudinary integration for media management
 - **Desktop Components**: WPF/WinForms utilities with embedded Chromium browser support
 - **Reporting**: Stimulsoft Reports integration for professional reporting
@@ -33,7 +33,7 @@ The BAUER GROUP Shared Platform is a modular, multi-project solution designed to
 |---------|-------------------|-------------|
 | `BAUERGROUP.Shared.Core` | net10.0, net8.0, netstandard2.0 | Core utilities, extensions, logging (NLog + Sentry), error tracking |
 | `BAUERGROUP.Shared.Data` | net10.0, net8.0, netstandard2.0 | Data persistence: SQLite, LiteDB, in-memory database, caching |
-| `BAUERGROUP.Shared.API` | net10.0, net8.0, netstandard2.0 | E-commerce integrations: Shopify, Shopware 5/6, WooCommerce |
+| `BAUERGROUP.Shared.API` | net10.0, net8.0, netstandard2.0 | Generic API integrations |
 | `BAUERGROUP.Shared.API.Shipping` | net10.0, net8.0, netstandard2.0 | Shipping providers: DHL, DPD, GLS, Deutsche Post, UPS |
 | `BAUERGROUP.Shared.Cloud` | net10.0, net8.0 | Cloud services: Cloudinary media management |
 | `BAUERGROUP.Shared.Desktop` | net10.0-windows, net8.0-windows | WPF/WinForms utilities, behaviors, converters |
@@ -155,14 +155,13 @@ WPFToolboxBrowser.ChromeEmbeddedWebbrowserWindow(
 ```
 BAUERGROUP.Shared.Plattform/
 ├── src/
-│   ├── BAUERGROUP.Shared.Core/           # Core utilities & logging
-│   ├── BAUERGROUP.Shared.Data/           # Data persistence layer
-│   ├── BAUERGROUP.Shared.API/            # E-commerce integrations
-│   ├── BAUERGROUP.Shared.API.Shipping/   # Shipping provider APIs
-│   ├── BAUERGROUP.Shared.Cloud/          # Cloud service integrations
-│   ├── BAUERGROUP.Shared.Desktop/        # WPF/WinForms utilities
-│   ├── BAUERGROUP.Shared.Desktop.Browser/     # Embedded browser
-│   └── BAUERGROUP.Shared.Desktop.Reporting/   # Reporting components
+│   ├── BAUERGROUP.Shared.Core/                 # Core utilities & logging
+│   ├── BAUERGROUP.Shared.Data/                 # Data persistence layer
+│   ├── BAUERGROUP.Shared.API/                  # Generic API integrations
+│   ├── BAUERGROUP.Shared.Cloud/                # Cloud service integrations
+│   ├── BAUERGROUP.Shared.Desktop/              # WPF/WinForms utilities
+│   ├── BAUERGROUP.Shared.Desktop.Browser/      # Embedded browser
+│   └── BAUERGROUP.Shared.Desktop.Reporting/    # Reporting components
 ├── tests/
 │   └── BAUERGROUP.Shared.Tests/          # Unit tests
 ├── assets/

src/BAUERGROUP.Shared.API/API/GenericAPIClient.cs

@@ -0,0 +1,42 @@
+using System;
+using System.Collections.Generic;
+using System.Text;
+
+namespace BAUERGROUP.Shared.API.API
+{
+    /// <summary>
+    /// Represents errors that occur during API client operations.
+    /// </summary>
+    public class GenericAPIClientException : Exception
+    {
+        /// <summary>
+        /// Initializes a new instance of the <see cref="GenericAPIClientException"/> class.
+        /// </summary>
+        public GenericAPIClientException()
+            : base()
+        {
+
+        }
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="GenericAPIClientException"/> class with a specified error message.
+        /// </summary>
+        /// <param name="message">The message that describes the error.</param>
+        public GenericAPIClientException(String message)
+            : base(message)
+        {
+
+        }
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="GenericAPIClientException"/> class with a specified error message and a reference to the inner exception.
+        /// </summary>
+        /// <param name="message">The message that describes the error.</param>
+        /// <param name="innerException">The exception that is the cause of the current exception.</param>
+        public GenericAPIClientException(String message, Exception innerException)
+            : base(message, innerException)
+        {
+
+        }
+    }
+}

src/BAUERGROUP.Shared.API/API/GenericAPIClientException.cs

@@ -0,0 +1,32 @@
+using System;
+using System.Collections.Generic;
+using System.Text;
+
+namespace BAUERGROUP.Shared.API.API
+{
+    /// <summary>
+    /// Specifies the HTTP method to use for API requests.
+    /// </summary>
+    public enum GenericAPIClientMethod
+    {
+        /// <summary>
+        /// HTTP GET method for retrieving resources.
+        /// </summary>
+        GET,
+
+        /// <summary>
+        /// HTTP POST method for creating resources.
+        /// </summary>
+        POST,
+
+        /// <summary>
+        /// HTTP PUT method for updating resources.
+        /// </summary>
+        PUT,
+
+        /// <summary>
+        /// HTTP DELETE method for removing resources.
+        /// </summary>
+        DELETE
+    }
+}

src/BAUERGROUP.Shared.API/API/GenericAPIClientMethod.cs

@@ -0,0 +1,72 @@
+using BAUERGROUP.Shared.API.API;
+
+namespace BAUERGROUP.Shared.Plattform.Test.API;
+
+public class GenericAPIClientExceptionTests
+{
+    [Fact]
+    public void Constructor_Default_CreatesException()
+    {
+        var exception = new GenericAPIClientException();
+
+        exception.Should().NotBeNull();
+        exception.Message.Should().NotBeNullOrEmpty();
+    }
+
+    [Fact]
+    public void Constructor_WithMessage_SetsMessage()
+    {
+        var message = "Test error message";
+
+        var exception = new GenericAPIClientException(message);
+
+        exception.Message.Should().Be(message);
+    }
+
+    [Fact]
+    public void Constructor_WithMessageAndInnerException_SetsBoth()
+    {
+        var message = "Outer error";
+        var innerException = new InvalidOperationException("Inner error");
+
+        var exception = new GenericAPIClientException(message, innerException);
+
+        exception.Message.Should().Be(message);
+        exception.InnerException.Should().Be(innerException);
+    }
+
+    [Fact]
+    public void InnerException_CanBeAccessed()
+    {
+        var inner = new ArgumentException("Inner");
+        var exception = new GenericAPIClientException("Outer", inner);
+
+        exception.InnerException.Should().BeOfType<ArgumentException>();
+        exception.InnerException!.Message.Should().Be("Inner");
+    }
+
+    [Fact]
+    public void IsException_DerivesFromException()
+    {
+        var exception = new GenericAPIClientException();
+
+        exception.Should().BeAssignableTo<Exception>();
+    }
+
+    [Fact]
+    public void CanBeThrown_AndCaught()
+    {
+        Action action = () => throw new GenericAPIClientException("Test throw");
+
+        action.Should().Throw<GenericAPIClientException>()
+            .WithMessage("Test throw");
+    }
+
+    [Fact]
+    public void CanBeCaughtAsException()
+    {
+        Action action = () => throw new GenericAPIClientException("Generic catch");
+
+        action.Should().Throw<Exception>();
+    }
+}

tests/BAUERGROUP.Shared.Plattform.Test/API/GenericAPIClientExceptionTests.cs

@@ -0,0 +1,63 @@
+using BAUERGROUP.Shared.API.API;
+
+namespace BAUERGROUP.Shared.Plattform.Test.API;
+
+public class GenericAPIClientMethodTests
+{
+    [Fact]
+    public void Enum_HasGetValue()
+    {
+        Enum.IsDefined(typeof(GenericAPIClientMethod), GenericAPIClientMethod.GET).Should().BeTrue();
+    }
+
+    [Fact]
+    public void Enum_HasPostValue()
+    {
+        Enum.IsDefined(typeof(GenericAPIClientMethod), GenericAPIClientMethod.POST).Should().BeTrue();
+    }
+
+    [Fact]
+    public void Enum_HasPutValue()
+    {
+        Enum.IsDefined(typeof(GenericAPIClientMethod), GenericAPIClientMethod.PUT).Should().BeTrue();
+    }
+
+    [Fact]
+    public void Enum_HasDeleteValue()
+    {
+        Enum.IsDefined(typeof(GenericAPIClientMethod), GenericAPIClientMethod.DELETE).Should().BeTrue();
+    }
+
+    [Fact]
+    public void Enum_HasFourValues()
+    {
+        var values = Enum.GetValues(typeof(GenericAPIClientMethod));
+        values.Length.Should().Be(4);
+    }
+
+    [Fact]
+    public void Enum_CanBeConvertedToString()
+    {
+        GenericAPIClientMethod.GET.ToString().Should().Be("GET");
+        GenericAPIClientMethod.POST.ToString().Should().Be("POST");
+        GenericAPIClientMethod.PUT.ToString().Should().Be("PUT");
+        GenericAPIClientMethod.DELETE.ToString().Should().Be("DELETE");
+    }
+
+    [Fact]
+    public void Enum_CanBeParsedFromString()
+    {
+        var parsed = Enum.Parse<GenericAPIClientMethod>("GET");
+        parsed.Should().Be(GenericAPIClientMethod.GET);
+    }
+
+    [Theory]
+    [InlineData(GenericAPIClientMethod.GET, 0)]
+    [InlineData(GenericAPIClientMethod.POST, 1)]
+    [InlineData(GenericAPIClientMethod.PUT, 2)]
+    [InlineData(GenericAPIClientMethod.DELETE, 3)]
+    public void Enum_HasExpectedIntValues(GenericAPIClientMethod method, int expectedValue)
+    {
+        ((int)method).Should().Be(expectedValue);
+    }
+}