Add a default client for simple usage

Author: SwiftyJoeyy

README.md

@@ -57,8 +57,7 @@ This creates a simple GET request to `https://www.google.com/test/cats/images`.
 You can also compose and override requests:
 
 ```swift
-@Request
-struct TestRequest {
+@Request struct TestRequest {
     @Header var test: String {
         return "Computed"
     }

Sources/NetworkingClient/ClientMacro.swift

@@ -13,16 +13,19 @@ import Foundation
 /// adding the necessary ``NetworkClient`` conformance.
 ///
 /// ```
-/// @Client
-/// struct MyClient {
-///     var command: Session {
-///         Session()
-///             .onRequest { request, session in
-///                 // handle request creation
-///                 return request
-///             }.enableLogs()
-///             .validate(for: [.accepted, .ok])
-///             .retryPolicy(.doNotRetry)
+/// @Client struct MyClient {
+///     var session: Session {
+///         Session {
+///             URLSessionConfiguration.default
+///                 .timeoutIntervalForRequest(60)
+///                 .timeoutIntervalForResource(120)
+///                 .requestCachePolicy(.useProtocolCachePolicy)
+///         }.onRequest { request, task, session, configurations in
+///             // handle request creation
+///             return request
+///         }.enableLogs()
+///         .validate(for: [.accepted, .ok])
+///         .doNotRetry()
 ///     }
 /// }
 /// ```

Sources/NetworkingClient/Configurations/Configurable+Extension.swift

@@ -19,7 +19,7 @@ extension Configurable {
     /// Use this method to attach a custom ``StatusValidator``.
     ///
     /// - Parameter validator: The validator to apply.
-    public func validate(_ validator: some StatusValidator) -> Self {
+    public func validate(using validator: some StatusValidator) -> Self {
         return configuration(\.statusValidator, validator)
     }
 
@@ -43,7 +43,7 @@ extension Configurable {
             validStatuses: statuses,
             handler
         )
-        return validate(validator)
+        return validate(using: validator)
     }
 
     /// Sets the handler used to control how responses are cached.
@@ -119,7 +119,7 @@ extension Configurable {
     ///
     /// Use this method to apply a custom retry strategy using a type
     /// that conforms to ``RetryInterceptor``.
-    public func retry(_ interceptor: some RetryInterceptor) -> Self {
+    public func retry(using interceptor: some RetryInterceptor) -> Self {
         return configuration(\.retryPolicy, interceptor)
     }
 
@@ -152,7 +152,7 @@ extension Configurable {
             strategy: strategy,
             handler: handler
         )
-        return retry(interceptor)
+        return retry(using: interceptor)
     }
 
     /// Sets the retry policy with a fixed delay between attempts.

Sources/NetworkingClient/DefaultClient.swift

@@ -0,0 +1,34 @@
+//
+//  DefaultClient.swift
+//  Networking
+//
+//  Created by Joe Maghzal on 25/07/2025.
+//
+
+import Foundation
+
+/// The default networking client provided by the framework.
+///
+/// `DefaultClient` offers a preconfigured session with sensible settings for most apps,
+/// including standard timeouts, automatic retry for transient errors, and HTTP status validation.
+///
+/// Use this client when you don’t need advanced customization or want a quick start.
+///
+/// You can override any part of the session configuration if needed.
+@Client public struct DefaultClient {
+    /// The default session used by the client.
+    public var session: Session {
+        Session {
+            URLSessionConfiguration.default
+                .timeoutIntervalForRequest(60)
+                .timeoutIntervalForResource(120)
+                .requestCachePolicy(.useProtocolCachePolicy)
+        }.retry(using: DefaultRetryInterceptor())
+        .validate(using: DefaultStatusValidator())
+    }
+}
+
+public enum Networking {
+    /// The default networking client for simple bootstrapping.
+    public static let client = DefaultClient()
+}

Sources/NetworkingClient/Session/NetworkClient.swift

@@ -12,7 +12,7 @@ import NetworkingCore
 /// Requirements for defining network clients that handle session management
 /// and perform network requests, such as data tasks and download tasks.
 /// It provides an abstraction for the session and commands network requests based on that session.
-public protocol NetworkClient: Configurable {
+public protocol NetworkClient: Configurable, Sendable {
     /// The internal session command that is used to execute network requests.
     var _session: Session! {get set}
 

Sources/NetworkingClient/Utilities/URLSessionConfiguration+Extension.swift

@@ -66,12 +66,12 @@ extension URLSessionConfiguration {
 
     /// Sets additional HTTP headers for the session configuration.
     ///
-    /// - Parameter headers: The headers to be added.
+    /// - Parameter header: The headers to be added.
     /// - Returns: The modified ``URLSessionConfiguration``.
     public func headers(
-        @HeadersBuilder headers: () -> some RequestHeader
+        @HeadersBuilder header: () -> some RequestHeader
     ) -> Self {
-        httpAdditionalHeaders = headers().headers
+        httpAdditionalHeaders = header().headers
         return self
     }
 }

Tests/NetworkingClientTests/Configurations/ClientConfigurationsTests.swift

@@ -41,7 +41,7 @@ struct ClientConfigurableTests {
 
         do {
             let interceptor = DummyRetryInterceptor()
-            let configured = TestConfigurable().retry(interceptor)
+            let configured = TestConfigurable().retry(using: interceptor)
             #expect(configured.configurationValues.retryPolicy is DummyRetryInterceptor)
         }
 
@@ -81,7 +81,7 @@ struct ClientConfigurableTests {
     @Test func statusValidatorConfiguration() {
         do {
             let validator = DummyStatusValidator()
-            let configured = TestConfigurable().validate(validator)
+            let configured = TestConfigurable().validate(using: validator)
             #expect(configured.configurationValues.statusValidator is DummyStatusValidator)
         }