feat: migrate from SupabaseLogger to swift-log

BREAKING CHANGE: Drop SupabaseLogger in favor of swift-log dependency

- Add swift-log dependency to Package.swift
- Replace SupabaseLogger protocol with Logger typealias from swift-log
- Update all modules to use swift-log Logger interface
- Remove old SupabaseLogMessage and SupabaseLogLevel types
- Update configuration types to use Logger instead of SupabaseLogger
- Remove SupabaseLoggerTaskLocal usage from SessionManager
- Simplify OSLogSupabaseLogger (placeholder for future OSLog integration)
- Remove AuthClientLoggerDecorator (will be reimplemented later)

This migration standardizes logging across the Swift ecosystem and provides
better integration with Swift logging tools and frameworks.

Migration Guide:
- Replace any SupabaseLogger usage with Logger from swift-log
- Update logging calls to use swift-log's standard interface
- Configure swift-log handlers as needed for your application

Author: grdsdev

Package.resolved

@@ -26,6 +26,7 @@ let package = Package(
   dependencies: [
     .package(url: "https://github.com/Alamofire/Alamofire.git", from: "5.9.0"),
     .package(url: "https://github.com/apple/swift-crypto.git", "1.0.0"..<"4.0.0"),
+    .package(url: "https://github.com/apple/swift-log.git", from: "1.0.0"),
     .package(url: "https://github.com/pointfreeco/swift-clocks", from: "1.0.0"),
     .package(url: "https://github.com/pointfreeco/swift-concurrency-extras", from: "1.1.0"),
     .package(url: "https://github.com/pointfreeco/swift-custom-dump", from: "1.3.2"),
@@ -40,6 +41,7 @@ let package = Package(
         .product(name: "Alamofire", package: "Alamofire"),
         .product(name: "ConcurrencyExtras", package: "swift-concurrency-extras"),
         .product(name: "Clocks", package: "swift-clocks"),
+        .product(name: "Logging", package: "swift-log"),
         .product(name: "XCTestDynamicOverlay", package: "xctest-dynamic-overlay"),
       ]
     ),
@@ -55,6 +57,7 @@ let package = Package(
       dependencies: [
         .product(name: "ConcurrencyExtras", package: "swift-concurrency-extras"),
         .product(name: "Crypto", package: "swift-crypto"),
+        .product(name: "Logging", package: "swift-log"),
         "Helpers",
       ]
     ),

Package.swift

@@ -1,6 +1,7 @@
 import Alamofire
 import ConcurrencyExtras
 import Foundation
+import Logging
 
 #if canImport(AuthenticationServices)
   import AuthenticationServices
@@ -20,16 +21,7 @@ import Foundation
 
 typealias AuthClientID = Int
 
-struct AuthClientLoggerDecorator: SupabaseLogger {
-  let clientID: AuthClientID
-  let decoratee: any SupabaseLogger
-
-  func log(message: SupabaseLogMessage) {
-    var message = message
-    message.additionalContext["client_id"] = .integer(clientID)
-    decoratee.log(message: message)
-  }
-}
+// Note: AuthClientLoggerDecorator removed for now - will be reimplemented in a future update
 
 public actor AuthClient {
   private static let globalClientID = LockIsolated(0)
@@ -48,7 +40,7 @@ public actor AuthClient {
   nonisolated private var eventEmitter: AuthStateChangeEventEmitter {
     Dependencies[clientID].eventEmitter
   }
-  nonisolated private var logger: (any SupabaseLogger)? {
+  nonisolated private var logger: SupabaseLogger? {
     Dependencies[clientID].configuration.logger
   }
   nonisolated private var sessionStorage: SessionStorage { Dependencies[clientID].sessionStorage }
@@ -119,9 +111,7 @@ public actor AuthClient {
       codeVerifierStorage: .live(clientID: clientID),
       sessionStorage: .live(clientID: clientID),
       sessionManager: .live(clientID: clientID),
-      logger: configuration.logger.map {
-        AuthClientLoggerDecorator(clientID: clientID, decoratee: $0)
-      }
+      logger: configuration.logger
     )
 
     Task { @MainActor in observeAppLifecycleChanges() }

Sources/Auth/AuthClient.swift

@@ -37,7 +37,7 @@ extension AuthClient {
     public let localStorage: any AuthLocalStorage
 
     /// Custom SupabaseLogger implementation used to inspecting log messages from the Auth library.
-    public let logger: (any SupabaseLogger)?
+    public let logger: SupabaseLogger?
     public let encoder: JSONEncoder
     public let decoder: JSONDecoder
 
@@ -68,7 +68,7 @@ extension AuthClient {
       redirectToURL: URL? = nil,
       storageKey: String? = nil,
       localStorage: any AuthLocalStorage,
-      logger: (any SupabaseLogger)? = nil,
+      logger: SupabaseLogger? = nil,
       encoder: JSONEncoder = AuthClient.Configuration.jsonEncoder,
       decoder: JSONDecoder = AuthClient.Configuration.jsonDecoder,
       session: Alamofire.Session = .default,
@@ -111,7 +111,7 @@ extension AuthClient {
     redirectToURL: URL? = nil,
     storageKey: String? = nil,
     localStorage: any AuthLocalStorage,
-    logger: (any SupabaseLogger)? = nil,
+      logger: SupabaseLogger? = nil,
     encoder: JSONEncoder = AuthClient.Configuration.jsonEncoder,
     decoder: JSONDecoder = AuthClient.Configuration.jsonDecoder,
     session: Alamofire.Session = .default,

Sources/Auth/AuthClientConfiguration.swift

@@ -15,7 +15,7 @@ struct Dependencies: Sendable {
 
   var urlOpener: URLOpener = .live
   var pkce: PKCE = .live
-  var logger: (any SupabaseLogger)?
+  var logger: SupabaseLogger?
 
   var encoder: JSONEncoder { configuration.encoder }
   var decoder: JSONDecoder { configuration.decoder }

Sources/Auth/Internal/Dependencies.swift

@@ -3,7 +3,7 @@ import Foundation
 
 struct AuthStateChangeEventEmitter {
   var emitter = EventEmitter<(AuthChangeEvent, Session?)?>(initialEvent: nil, emitsLastEventWhenAttaching: false)
-  var logger: (any SupabaseLogger)?
+  var logger: SupabaseLogger?
 
   func attach(_ listener: @escaping AuthStateChangeListener) -> ObservationToken {
     emitter.attach { event in

Sources/Auth/Internal/EventEmitter.swift

@@ -28,7 +28,7 @@ private actor LiveSessionManager {
   private var configuration: AuthClient.Configuration { Dependencies[clientID].configuration }
   private var sessionStorage: SessionStorage { Dependencies[clientID].sessionStorage }
   private var eventEmitter: AuthStateChangeEventEmitter { Dependencies[clientID].eventEmitter }
-  private var logger: (any SupabaseLogger)? { Dependencies[clientID].logger }
+  private var logger: SupabaseLogger? { Dependencies[clientID].logger }
   private var api: APIClient { Dependencies[clientID].api }
 
   private var inFlightRefreshTask: Task<Session, any Error>?
@@ -57,43 +57,36 @@ private actor LiveSessionManager {
   }
 
   func refreshSession(_ refreshToken: String) async throws -> Session {
-    try await SupabaseLoggerTaskLocal.$additionalContext.withValue(
-      merging: [
-        "refresh_id": .string(UUID().uuidString),
-        "refresh_token": .string(refreshToken),
-      ]
-    ) {
-      try await trace(using: logger) {
-        if let inFlightRefreshTask {
-          logger?.debug("Refresh already in flight")
-          return try await inFlightRefreshTask.value
-        }
-
-        inFlightRefreshTask = Task {
-          logger?.debug("Refresh task started")
+    try await trace(using: logger) {
+      if let inFlightRefreshTask {
+        logger?.debug("Refresh already in flight")
+        return try await inFlightRefreshTask.value
+      }
 
-          defer {
-            inFlightRefreshTask = nil
-            logger?.debug("Refresh task ended")
-          }
+      inFlightRefreshTask = Task {
+        logger?.debug("Refresh task started")
 
-          let session = try await api.execute(
-            configuration.url.appendingPathComponent("token"),
-            method: .post,
-            query: ["grant_type": "refresh_token"],
-            body: UserCredentials(refreshToken: refreshToken)
-          )
-          .serializingDecodable(Session.self, decoder: configuration.decoder)
-          .value
+        defer {
+          inFlightRefreshTask = nil
+          logger?.debug("Refresh task ended")
+        }
 
-          update(session)
-          eventEmitter.emit(.tokenRefreshed, session: session)
+        let session = try await api.execute(
+          configuration.url.appendingPathComponent("token"),
+          method: .post,
+          query: ["grant_type": "refresh_token"],
+          body: UserCredentials(refreshToken: refreshToken)
+        )
+        .serializingDecodable(Session.self, decoder: configuration.decoder)
+        .value
 
-          return session
-        }
+        update(session)
+        eventEmitter.emit(.tokenRefreshed, session: session)
 
-        return try await inFlightRefreshTask!.value
+        return session
       }
+
+      return try await inFlightRefreshTask!.value
     }
   }
 

Sources/Auth/Internal/SessionManager.swift

@@ -26,7 +26,7 @@ extension SessionStorage {
       Dependencies[clientID].configuration.localStorage
     }
 
-    var logger: (any SupabaseLogger)? {
+    var logger: SupabaseLogger? {
       Dependencies[clientID].configuration.logger
     }
 

Sources/Auth/Internal/SessionStorage.swift

@@ -48,7 +48,7 @@ public final class FunctionsClient: Sendable {
     url: URL,
     headers: [String: String] = [:],
     region: String? = nil,
-    logger: (any SupabaseLogger)? = nil,
+    logger: SupabaseLogger? = nil,
     session: Alamofire.Session = .default
   ) {
     self.init(
@@ -89,7 +89,7 @@ public final class FunctionsClient: Sendable {
     url: URL,
     headers: [String: String] = [:],
     region: FunctionRegion? = nil,
-    logger: (any SupabaseLogger)? = nil,
+    logger: SupabaseLogger? = nil,
     session: Alamofire.Session = .default
   ) {
     self.init(url: url, headers: headers, region: region?.rawValue, session: session)

Sources/Functions/FunctionsClient.swift

@@ -1,54 +1,5 @@
 import Foundation
+import Logging
 
-#if canImport(OSLog)
-  import OSLog
-
-  /// A SupabaseLogger implementation that logs to OSLog.
-  ///
-  /// This logger maps Supabase log levels to appropriate OSLog levels:
-  /// - `.verbose` → `.info`
-  /// - `.debug` → `.debug`
-  /// - `.warning` → `.notice`
-  /// - `.error` → `.error`
-  ///
-  /// ## Usage
-  ///
-  /// ```swift
-  /// let supabaseLogger = OSLogSupabaseLogger()
-  ///
-  /// // Use with Supabase client
-  /// let supabase = SupabaseClient(
-  ///   supabaseURL: url,
-  ///   supabaseKey: key,
-  ///   options: .init(global: .init(logger: supabaseLogger))
-  /// )
-  /// ```
-  @available(macOS 11.0, iOS 14.0, tvOS 14.0, watchOS 7.0, *)
-  public struct OSLogSupabaseLogger: SupabaseLogger {
-    private let logger: Logger
-
-    /// Creates a new OSLog-based logger with a provided Logger instance.
-    ///
-    /// - Parameter logger: The OSLog Logger instance to use for logging.
-    public init(
-      _ logger: Logger = Logger(subsystem: Bundle.main.bundleIdentifier ?? "", category: "Supabase")
-    ) {
-      self.logger = logger
-    }
-
-    public func log(message: SupabaseLogMessage) {
-      let logMessage = message.description
-
-      switch message.level {
-      case .verbose:
-        logger.info("\(logMessage, privacy: .public)")
-      case .debug:
-        logger.debug("\(logMessage, privacy: .public)")
-      case .warning:
-        logger.notice("\(logMessage, privacy: .public)")
-      case .error:
-        logger.error("\(logMessage, privacy: .public)")
-      }
-    }
-  }
-#endif
+// Note: OSLogHandler implementation will be added in a future update
+// For now, users can use swift-log's built-in handlers or create their own