feat: add AdminAPI and deleteUser method

Author: grdsdev

Sources/Auth/AuthAdmin.swift

@@ -0,0 +1,40 @@
+//
+//  AuthAdmin.swift
+//
+//
+//  Created by Guilherme Souza on 25/01/24.
+//
+
+import Foundation
+@_spi(Internal) import _Helpers
+
+public actor AuthAdmin {
+  private var configuration: AuthClient.Configuration {
+    Dependencies.current.value!.configuration
+  }
+
+  private var api: APIClient {
+    Dependencies.current.value!.api
+  }
+
+  public init() {}
+
+  /// Delete a user. Requires `service_role` key.
+  /// - Parameter id: The id of the user you want to delete.
+  /// - Parameter shouldSoftDelete: If true, then the user will be soft-deleted (setting
+  /// `deleted_at` to the current timestamp and disabling their account while preserving their data)
+  /// from the auth schema.
+  ///
+  /// - Warning: Never expose your `service_role` key on the client.
+  @discardableResult
+  public func deleteUser(id: String, shouldSoftDelete: Bool = true) async throws -> User {
+    try await api.execute(
+      Request(
+        path: "/admin/users/\(id)",
+        method: .delete,
+        body: configuration.encoder.encode(DeleteUserRequest(shouldSoftDelete: shouldSoftDelete))
+      )
+    )
+    .decoded(decoder: configuration.decoder)
+  }
+}

Sources/Auth/AuthClient.swift

@@ -95,6 +95,11 @@ public actor AuthClient {
   /// Namespace for accessing multi-factor authentication API.
   public let mfa: AuthMFA
 
+  /// Namespace for the GoTrue admin methods.
+  /// - Warning: This methods requires `service_role` key, be careful to never expose `service_role`
+  /// key in the client.
+  public let admin: AuthAdmin
+
   /// Initializes a AuthClient with optional parameters.
   ///
   /// - Parameters:
@@ -162,6 +167,7 @@ public actor AuthClient {
     logger: SupabaseLogger?
   ) {
     mfa = AuthMFA()
+    admin = AuthAdmin()
 
     Dependencies.current.setValue(
       Dependencies(

Sources/Auth/Types.swift

@@ -646,3 +646,7 @@ public struct WeakPassword: Codable, Hashable, Sendable {
   /// `pwned`.
   public let reasons: [String]
 }
+
+struct DeleteUserRequest: Encodable {
+  let shouldSoftDelete: Bool
+}