chore: import upstream snapshot with attribution

2026-07-13 12:22:33 +08:00
commit fc4fcbab58
1848 changed files with 472303 additions and 0 deletions
@@ -0,0 +1,52 @@
+import Foundation
+
+/// Reads CrossModel settings from environment variables.
+public enum CrossModelSettingsReader {
+    /// Environment variable key for the CrossModel API token.
+    public static let envKey = "CROSSMODEL_API_KEY"
+    /// Environment variable key for an optional API base URL override.
+    public static let urlEnvKey = "CROSSMODEL_API_URL"
+
+    /// Returns the API token from environment if present and non-empty.
+    public static func apiToken(environment: [String: String] = ProcessInfo.processInfo.environment) -> String? {
+        self.cleaned(environment[self.envKey])
+    }
+
+    /// Returns the API base URL, defaulting to the production endpoint.
+    public static func apiURL(environment: [String: String] = ProcessInfo.processInfo.environment) -> URL {
+        if let override = self.validAPIURL(environment: environment) {
+            return override
+        }
+        return URL(string: "https://api.crossmodel.ai/v1")!
+    }
+
+    public static func validateEndpointOverrides(
+        environment: [String: String] = ProcessInfo.processInfo.environment) throws
+    {
+        guard let raw = self.cleaned(environment[self.urlEnvKey]) else { return }
+        // Loopback HTTP is allowed so the provider can be exercised end-to-end
+        // against a locally running gateway during development.
+        guard ProviderEndpointOverrideValidator().validatedURLAllowingLoopbackHTTP(raw) == nil else { return }
+        throw CrossModelSettingsError.invalidEndpointOverride(self.urlEnvKey)
+    }
+
+    static func cleaned(_ raw: String?) -> String? {
+        guard var value = raw?.trimmingCharacters(in: .whitespacesAndNewlines), !value.isEmpty else {
+            return nil
+        }
+
+        if (value.hasPrefix("\"") && value.hasSuffix("\"")) ||
+            (value.hasPrefix("'") && value.hasSuffix("'"))
+        {
+            value = String(value.dropFirst().dropLast())
+        }
+
+        value = value.trimmingCharacters(in: .whitespacesAndNewlines)
+        return value.isEmpty ? nil : value
+    }
+
+    private static func validAPIURL(environment: [String: String]) -> URL? {
+        guard let raw = self.cleaned(environment[self.urlEnvKey]) else { return nil }
+        return ProviderEndpointOverrideValidator().validatedURLAllowingLoopbackHTTP(raw)
+    }
+}