Merge pull request #36 from GoodRequest/feature/transient-session

feat: Transient session struct

Author: plajdo

Package.resolved

@@ -397,12 +397,6 @@ public extension Updatable where UpdateResponse == Resource {
 
 }
 
-// MARK: - Deletable.swift
-//  GoodNetworking
-//
-//  Created by Andrej Jasso on 15/10/2024.
-//
-
 // MARK: - Deletable
 
 /// Represents a resource that can be deleted from a remote server.

Sources/GoodNetworking/Protocols/ResourceOperations.swift

@@ -15,10 +15,7 @@ public actor FutureSession {
     /// The type alias for a supplier function that provides a `NetworkSession` asynchronously.
     public typealias FutureSessionSupplier = (@Sendable () async -> NetworkSession)
 
-    /// The supplier function responsible for providing the network session when needed.
     private var supplier: FutureSessionSupplier
-
-    /// The cached instance of the network session, used for subsequent requests after it is first resolved.
     private var sessionCache: NetworkSession?
 
     /// Provides access to the cached network session.

Sources/GoodNetworking/Session/FutureSession.swift

@@ -0,0 +1,42 @@
+//
+//  TransientSession.swift
+//  GoodNetworking
+//
+//  Created by Filip Šašala on 23/10/2024.
+//
+
+/// A network session that is resolved asynchronously when required, without caching.
+///
+/// This is useful when you need to resolve a session asynchronously depending on
+/// external circumstances, such as whether an authentication token is available.
+///
+/// `TransientSession` acts as a wrapper around `NetworkSession`, providing
+/// a mechanism for deferring the resolution of a session.
+///
+/// The session is supplied asynchronously via a `TransientSessionSupplier`.
+public struct TransientSession {
+
+    /// Function that will resolve a `NetworkSession` asynchronously when required.
+    public typealias TransientSessionSupplier = (@Sendable () async -> NetworkSession)
+
+    private let supplier: TransientSessionSupplier
+
+    /// Creates `TransientSession` with a supplier for network session resolution.
+    ///
+    /// - Parameter supplier: A function that will provide a `NetworkSession`.
+    public init(_ supplier: @escaping TransientSessionSupplier) {
+        self.supplier = supplier
+    }
+
+    /// Resolves an appropriate session by calling the supplier.
+    /// - Returns: Network session resolved and returned from the supplier.
+    public func resolve() async -> NetworkSession {
+        return await supplier()
+    }
+    
+    /// Sugared resolution function. See ``resolve``.
+    public func callAsFunction() async -> NetworkSession {
+        return await resolve()
+    }
+
+}