Overall update and improvements (#4)

This PR contains all the work done to update the App Store Connect OpenAPI specification document to its latest version, plus the implementation of the `BearerAuthMiddleware` middleware, and several other improvements to the setup of the library, the `Makefile` file, and the documentation.

Reviewed-on: #4
Co-authored-by: Javier Cicchelli <javier@rock-n-code.com>
Co-committed-by: Javier Cicchelli <javier@rock-n-code.com>

Sources/ASConnectService/Catalogs/ASConnectService.docc/Extensions/Client.md

@@ -0,0 +1,38 @@
+# ``Client``
+
+The API client for performing HTTP operations against the App Store Connect API.
+
+## Overview
+
+The ``Client`` struct is the main entry point for interacting with the App Store Connect API. It conforms to ``APIProtocol`` and provides concrete implementations for all available API operations.
+
+### Creating a Client
+
+Create a ``Client`` by providing a server URL, a transport, and optionally a list of middlewares for authentication or request customization.
+
+```swift
+import ASConnectService
+import OpenAPIURLSession
+
+let client = Client(
+    serverURL: try Servers.server1(),
+    transport: URLSessionTransport(),
+    middlewares: [
+        BearerAuthMiddleware(token: yourJWTToken)
+    ]
+)
+```
+
+### Making API Calls
+
+Each method on the ``Client`` corresponds to an HTTP endpoint defined in the App Store Connect API OpenAPI specification. Methods accept an `Input` value and return an `Output` value representing the response.
+
+```swift
+let response = try await client.appsGetCollection(.init())
+```
+
+## Topics
+
+### Creating a Client
+
+- ``init(serverURL:configuration:transport:middlewares:)``

Sources/ASConnectService/Catalogs/ASConnectService.docc/Extensions/Servers.md

@@ -0,0 +1,24 @@
+# ``Servers``
+
+Server URLs defined in the OpenAPI document.
+
+## Overview
+
+The ``Servers`` namespace provides access to the base URLs defined in the App Store Connect API OpenAPI specification. Use these URLs when creating a ``Client`` instance.
+
+```swift
+let client = Client(
+    serverURL: try Servers.Server1.url(),
+    transport: URLSessionTransport(),
+    middlewares: [
+        BearerAuthMiddleware(token: yourJWTToken)
+    ]
+)
+```
+
+## Topics
+
+### Server URLs
+
+- ``Servers/Server1``
+- ``Servers/server1()``

Sources/ASConnectService/Catalogs/ASConnectService.docc/Library.md

@@ -1,13 +1,51 @@
 # ``ASConnectService``
 
-<!--@START_MENU_TOKEN@-->Summary<!--@END_MENU_TOKEN@-->
+A Swift client library for the App Store Connect API, generated from the official OpenAPI specification.
 
 ## Overview
 
-<!--@START_MENU_TOKEN@-->Text<!--@END_MENU_TOKEN@-->
+``ASConnectService`` provides a type-safe, Swift-native interface to Apple's App Store Connect API. This package enables developers to programmatically interact with App Store Connect services for managing apps, builds, reviews, sales reports, and more.
+
+The library is automatically generated from the official App Store Connect API OpenAPI specification using Apple's [swift-openapi-generator](https://github.com/apple/swift-openapi-generator), ensuring complete API coverage and type safety.
+
+### Creating a Client
+
+Create a ``Client`` instance by providing a server URL and transport. Use ``BearerAuthMiddleware`` to authenticate requests with a JSON Web Token (JWT).
+
+```swift
+import ASConnectService
+import OpenAPIURLSession
+
+let client = Client(
+    serverURL: try Servers.server1(),
+    transport: URLSessionTransport(),
+    middlewares: [
+        BearerAuthMiddleware(token: yourJWTToken)
+    ]
+)
+```
+
+### Making API Calls
+
+The ``Client`` conforms to ``APIProtocol``, which defines a method for every endpoint in the App Store Connect API. Each method accepts an `Input` value and returns an `Output` value with the response.
+
+```swift
+let response = try await client.appsGetCollection(.init())
+```
 
 ## Topics
 
-### <!--@START_MENU_TOKEN@-->Group<!--@END_MENU_TOKEN@-->
+### API Client
 
-- <!--@START_MENU_TOKEN@-->``Symbol``<!--@END_MENU_TOKEN@-->
+- ``Client``
+- ``APIProtocol``
+
+### Authentication
+
+- ``BearerAuthMiddleware``
+
+### Generated Types
+
+- ``Components``
+- ``Operations``
+- ``Servers``

Sources/ASConnectService/Sources/Public/Middlewares/BearerAuthMiddleware.swift

@@ -0,0 +1,80 @@
+// ===----------------------------------------------------------------------===
+//
+// This source file is part of the ASConnectService open source project
+//
+// Copyright (c) 2026 Röck+Cöde VoF. and the ASConnectService project authors
+// Licensed under Apache license v2.0
+//
+// See LICENSE for license information
+// See CONTRIBUTORS for the list of ASConnectService project authors
+//
+// SPDX-License-Identifier: Apache-2.0
+//
+// ===----------------------------------------------------------------------===
+
+import struct Foundation.URL
+import struct Foundation.URLComponents
+import struct Foundation.URLQueryItem
+import struct HTTPTypes.HTTPField
+import struct HTTPTypes.HTTPFields
+import struct HTTPTypes.HTTPRequest
+import struct HTTPTypes.HTTPResponse
+import protocol OpenAPIRuntime.ClientMiddleware
+import class OpenAPIRuntime.HTTPBody
+
+/// A client middleware that injects a Bearer authentication token into outgoing HTTP requests.
+///
+/// This middleware appends an `Authorization` header with a Bearer token to every request
+/// before forwarding it to the next handler in the middleware chain. It is intended for use
+/// with the App Store Connect API, which requires JSON Web Token (JWT) authentication.
+///
+/// ## Usage
+///
+/// ```swift
+/// let middleware = BearerAuthMiddleware(token: "your-jwt-token")
+/// ```
+public struct BearerAuthMiddleware {
+    // MARK: Properties
+
+    /// The Bearer token to include in the `Authorization` header of each request.
+    private let token: String
+
+    // MARK: Initializers
+
+    /// Creates a new middleware instance with the given Bearer token.
+    /// - Parameter token: A JSON Web Token (JWT) string used to authenticate requests to the App Store Connect API.
+    init(token: String) {
+        self.token = token
+    }
+}
+
+// MARK: - ClientMiddleware
+
+extension BearerAuthMiddleware: ClientMiddleware {
+    // MARK: Methods
+
+    /// Intercepts an outgoing HTTP request and adds a Bearer authentication token to its headers.
+    /// - Parameters:
+    ///   - request: The original HTTP request.
+    ///   - body: The optional body of the request.
+    ///   - baseURL: The base URL for the request.
+    ///   - operationID: The identifier of the API operation being performed.
+    ///   - next: The next handler in the middleware chain.
+    /// - Returns: The HTTP response and optional body returned by the next handler.
+    public func intercept(
+        _ request: HTTPRequest,
+        body: HTTPBody?,
+        baseURL: URL,
+        operationID: String,
+        next: @Sendable (HTTPRequest, HTTPBody?, URL) async throws -> (HTTPResponse, HTTPBody?)
+    ) async throws -> (HTTPResponse, HTTPBody?) {
+        var request = request
+        request.headerFields[.authorization] = "Bearer \(token)"
+
+        return try await next(
+            request,
+            body,
+            baseURL
+        )
+    }
+}

Sources/ASConnectService/asconnect_service.swift

@@ -1,2 +0,0 @@
-// The Swift Programming Language
-// https://docs.swift.org/swift-book

Sources/ASConnectService/openapi-generator-config.yaml

@@ -2,7 +2,7 @@
 ## 
 ## This source file is part of the App Store Connect Service open source project
 ## 
-## Copyright (c) 2025 Röck+Cöde VoF. and the App Store Connect Service project authors
+## Copyright (c) 2026 Röck+Cöde VoF. and the App Store Connect Service project authors
 ## Licensed under Apache license v2.0
 ## 
 ## See LICENSE for license information
@@ -15,5 +15,5 @@
 generate:
     - types
     - client
-namingStrategy: defensive
+namingStrategy: idiomatic
 accessModifier: public