Move Sandbox

Author: pblazej

Sources/LiveKit/Auth/Sandbox.swift

@@ -0,0 +1,35 @@
+/*
+ * Copyright 2025 LiveKit
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import Foundation
+
+/// `Sandbox` queries LiveKit Sandbox token server for credentials,
+/// which supports quick prototyping/getting started types of use cases.
+/// - Warning: This token endpoint is **INSECURE** and should **NOT** be used in production.
+public struct Sandbox: TokenEndpoint {
+    public let url = URL(string: "https://cloud-api.livekit.io/api/sandbox/connection-details")!
+    public var headers: [String: String] {
+        ["X-Sandbox-ID": id]
+    }
+
+    /// The sandbox ID provided by LiveKit Cloud.
+    public let id: String
+
+    /// Initialize with a sandbox ID from LiveKit Cloud.
+    public init(id: String) {
+        self.id = id.trimmingCharacters(in: CharacterSet(charactersIn: "\""))
+    }
+}

Sources/LiveKit/Auth/TokenSource.swift

@@ -18,6 +18,8 @@ import Foundation
 
 #warning("Fix camel case after deploying backend")
 
+// MARK: - Token
+
 /// `Token` represent the credentials needed for connecting to a new Room.
 /// - SeeAlso: [LiveKit's Authentication Documentation](https://docs.livekit.io/home/get-started/authentication/) for more information.
 public enum Token {
@@ -85,7 +87,7 @@ public enum Token {
     public typealias Literal = Response
 }
 
-// MARK: - Provider
+// MARK: - Source
 
 /// Protocol for types that can provide connection credentials.
 /// Implement this protocol to create custom credential providers (e.g., fetching from your backend API).
@@ -94,14 +96,13 @@ public protocol TokenSource: Sendable {
 }
 
 /// `Token.Literal` contains a single set of credentials, hard-coded or acquired from a static source.
-/// - Note: It does not support refreshing credentials.
 extension Token.Literal: TokenSource {
     public func fetch(_: Token.Request) async throws -> Token.Response {
         self
     }
 }
 
-// MARK: - Token Server
+// MARK: - Endpoint
 
 /// Protocol for token servers that fetch credentials via HTTP requests.
 /// Provides a default implementation of `fetch` that can be used to integrate with custom backend token generation endpoints.
@@ -142,24 +143,6 @@ public extension TokenEndpoint {
     }
 }
 
-/// `Sandbox` queries LiveKit Sandbox token server for credentials,
-/// which supports quick prototyping/getting started types of use cases.
-/// - Warning: This token endpoint is **INSECURE** and should **NOT** be used in production.
-public struct Sandbox: TokenEndpoint {
-    public let url = URL(string: "https://cloud-api.livekit.io/api/sandbox/connection-details")!
-    public var headers: [String: String] {
-        ["X-Sandbox-ID": id]
-    }
-
-    /// The sandbox ID provided by LiveKit Cloud.
-    public let id: String
-
-    /// Initialize with a sandbox ID from LiveKit Cloud.
-    public init(id: String) {
-        self.id = id.trimmingCharacters(in: CharacterSet(charactersIn: "\""))
-    }
-}
-
 // MARK: - Cache
 
 /// `CachingTokenSource` handles caching of credentials from any other `TokenSource` using configurable store.