SPB Git

Repository Public

ProvidersSettings.swift 16.0 KB 296 lines swift

1// Author: Simon-Pierre Boucher — contact@spboucher.ai2// File: SPChat/Features/Settings/ProvidersSettings.swift3// Description: Settings → Fournisseurs: state, health and model counts of each provider, key test, and set / rotate / revoke of the manageable keys (OpenRouter, Tavily). A key is typed once, sent once, never stored, shown or logged by the app.4import SwiftUI5import SPChatCore67/// State of the Providers pane. A provider key only ever transits through `setKey(_:key:)`, as an argument.8@Observable final class ProvidersModel {9    private(set) var overview: ProvidersOverview?10    private(set) var loadError: String?11    private(set) var loading = false12    /// Providers with a request in flight (test, key change).13    private(set) var busy: Set<String> = []14    /// Result of the last « Tester » of each provider, kept for this window only.15    private(set) var tests: [String: TestOutcome] = [:]16    /// Message of the provider when it refused a key (`422`), shown in the key sheet.17    private(set) var keyError: String?18    @ObservationIgnored private let api: APIClient19    @ObservationIgnored private let catalog: CatalogStore20    @ObservationIgnored private let toasts: ToastCenter2122    /// Answer of `POST /api/providers/{id}/test`, or the error that prevented it.23    struct TestOutcome: Equatable { let ok: Bool; let message: String; let info: JSONValue? }2425    init(env: AppEnvironment) { api = env.api; catalog = env.catalog; toasts = env.toasts }2627    func load() async {28        loading = true; defer { loading = false }29        do { overview = try await api.providers(); loadError = nil }30        catch {31            if Task.isCancelled { return }32            if let e = error as? APIError, e.kind == .cancelled { return }33            loadError = Self.message(error)34        }35    }3637    func test(_ id: String) async {38        busy.insert(id); defer { busy.remove(id) }39        do { let r = try await api.testProvider(id); tests[id] = TestOutcome(ok: r.ok, message: r.message, info: r.info) }40        catch { tests[id] = TestOutcome(ok: false, message: Self.message(error), info: nil) }41    }4243    func clearKeyError() { keyError = nil }4445    /// Sends the key once. Returns true when the provider accepted it; a refusal keeps its message in `keyError`.46    /// A `403 reauth_required` is handled by the client (passkey confirmation, then the request is replayed).47    func setKey(_ id: String, key: String) async -> Bool {48        busy.insert(id); defer { busy.remove(id) }49        keyError = nil50        do {51            try await api.setProviderKey(id, key: key)52            tests[id] = nil53            await refreshAfterKeyChange()54            toasts.show("Clé \(overview?.provider(id)?.name ?? id) enregistrée sur le serveur")55            return true56        } catch {57            keyError = Self.message(error)58            return false59        }60    }6162    func removeKey(_ id: String) async {63        busy.insert(id); defer { busy.remove(id) }64        let name = overview?.provider(id)?.name ?? id65        do {66            let r = try await api.removeProviderKey(id)67            tests[id] = nil68            await refreshAfterKeyChange()69            toasts.show(r.fallback ? "Clé \(name) révoquée — la clé de l'environnement du serveur prend le relais." : "Clé \(name) révoquée — \(name) n'est plus configuré.")70        } catch { toasts.error(error) }71    }7273    func refreshCatalog() async {74        do { try await catalog.refreshCatalog(); await load(); toasts.show("Catalogue actualisé") } catch { toasts.error(error) }75    }7677    private func refreshAfterKeyChange() async {78        await load()79        await catalog.reloadModels()80        await catalog.reloadSettings()81    }8283    private static func message(_ error: Error) -> String { (error as? LocalizedError)?.errorDescription ?? String(describing: error) }84}8586/// Facts of a « Tester » answer that may be shown. `label` (a masked form of the key) is deliberately left out:87/// the only trace of a key ever displayed is the server's `keyHint`.88enum ProviderTestInfo {89    static func facts(_ info: JSONValue?) -> [Fact] {90        guard let o = info?.objectValue else { return [] }91        var out: [Fact] = []92        func usd(_ key: String, _ label: String) { if let v = o[key]?.doubleValue { out.append(Fact(label, Format.usd(v))) } }93        usd("usage", "Consommation totale"); usd("usageDaily", "Aujourd'hui"); usd("usageMonthly", "Ce mois-ci"); usd("limit", "Plafond de la clé"); usd("limitRemaining", "Reste du plafond")94        if let free = o["isFreeTier"]?.boolValue { out.append(Fact("Palier gratuit", free ? "oui" : "non")) }95        if let e = o["expiresAt"]?.stringValue, let d = ServerDate.parse(e) { out.append(Fact("Expiration de la clé", ExplorerText.date(d))) }96        if let c = o["checkedAt"]?.stringValue, let d = ServerDate.parse(c) { out.append(Fact("Vérifié le", ExplorerText.dateTime(d))) }97        return out98    }99}100101struct ProvidersSettings: View {102    @Environment(AppEnvironment.self) private var env103    @State private var model: ProvidersModel?104    @State private var keySheet: ProviderInfo?105    @State private var revoking: ProviderInfo?106107    var body: some View {108        if env.session.phase != .signedIn {109            EmptyStateView(systemImage: "lock", title: "Connexion requise", message: "Connecte-toi avec ta clé d'accès pour voir ces réglages.")110        } else {111            Group {112                if let model { ProvidersPane(model: model, isRefreshing: env.catalog.isRefreshingCatalog, setKey: { keySheet = $0 }, revoke: { revoking = $0 }) }113                else { ProgressView().frame(maxWidth: .infinity, maxHeight: .infinity) }114            }115            .task {116                if model == nil { model = ProvidersModel(env: env) }117                await model?.load()118            }119            .onSync({ $0.providers }) { Task { await model?.load() } }120            .sheet(item: $keySheet) { p in121                if let model { ProviderKeySheet(provider: p, model: model) { keySheet = nil } }122            }123            .confirmationDialog(revoking.map { "Révoquer la clé \($0.name) ?" } ?? "", isPresented: Binding(get: { revoking != nil }, set: { if !$0 { revoking = nil } }), presenting: revoking) { p in124                Button("Révoquer la clé", role: .destructive) { Task { await model?.removeKey(p.id) } }125                Button("Annuler", role: .cancel) {}126            } message: { p in127                Text("La clé enregistrée sur le serveur est effacée. Si une clé existe dans l'environnement du serveur, elle prend le relais ; sinon \(p.name) n'est plus disponible dans les trois apps. Une confirmation par clé d'accès peut être demandée.")128            }129        }130    }131}132133/// The pane itself (no sheet, no dialog): rendered as-is by the snapshot tests.134struct ProvidersPane: View {135    let model: ProvidersModel136    var isRefreshing = false137    let setKey: (ProviderInfo) -> Void138    let revoke: (ProviderInfo) -> Void139140    var body: some View {141        ScrollView {142            VStack(alignment: .leading, spacing: 14) {143                HStack(alignment: .firstTextBaseline) {144                    VStack(alignment: .leading, spacing: 3) {145                        Text("Fournisseurs").font(DS.F.title).foregroundStyle(DS.C.text)146                        Text("Les clés restent sur le serveur : l'app n'en affiche et n'en conserve aucune.").font(DS.F.caption).foregroundStyle(DS.C.muted)147                    }148                    Spacer()149                    if isRefreshing { ProgressView().controlSize(.small) }150                    Button { Task { await model.refreshCatalog() } } label: { Label("Actualiser le catalogue", systemImage: "arrow.triangle.2.circlepath") }151                        .disabled(isRefreshing).help("Le serveur relit la liste de chaque fournisseur et le catalogue OpenRouter (jusqu'à 2 minutes).")152                }153                if let error = model.loadError { Banner(kind: .error, text: error, actionTitle: "Réessayer") { Task { await model.load() } } }154                if let overview = model.overview {155                    ForEach(overview.providers) { p in156                        ProviderCard(provider: p, test: model.tests[p.id], busy: model.busy.contains(p.id),157                                     onTest: { Task { await model.test(p.id) } }, onSetKey: { setKey(p) }, onRevoke: { revoke(p) })158                    }159                    if let logos = overview.logos, logos.source != nil || logos.license != nil {160                        Text("Logos : " + [logos.source, logos.license].compactMap { $0 }.joined(separator: " · "))161                            .font(.system(size: 10.5)).foregroundStyle(DS.C.muted).textSelection(.enabled).fixedSize(horizontal: false, vertical: true)162                    }163                } else if model.loading {164                    ProgressView("Chargement des fournisseurs…").frame(maxWidth: .infinity).padding(.vertical, 40)165                }166            }167            .padding(20).frame(maxWidth: .infinity, alignment: .leading)168        }169        .background(DS.C.bg)170    }171}172173struct ProviderCard: View {174    let provider: ProviderInfo175    let test: ProvidersModel.TestOutcome?176    let busy: Bool177    let onTest: () -> Void178    let onSetKey: () -> Void179    let onRevoke: () -> Void180181    var body: some View {182        VStack(alignment: .leading, spacing: 10) {183            HStack(alignment: .top, spacing: 12) {184                ModelMark(logo: provider.logo ?? provider.id, name: provider.name, size: 24)185                VStack(alignment: .leading, spacing: 3) {186                    HStack(spacing: 7) {187                        Text(provider.name).font(DS.F.heading).foregroundStyle(DS.C.text)188                        Tag(text: provider.kind == "tool" ? "outil" : (provider.kind == "models" ? "modèles" : provider.kind))189                        if let r = provider.route { if r == "openrouter" || r == "local" { RouteBadge(route: r) } else { Tag(text: ExplorerText.route(r).lowercased()) } }190                    }191                    HStack(spacing: 6) {192                        Circle().fill(provider.configured ? DS.C.ok : DS.C.muted).frame(width: 6, height: 6).accessibilityHidden(true)193                        Text(provider.configured ? "Configuré" : "Non configuré").font(DS.F.caption).foregroundStyle(provider.configured ? DS.C.text2 : DS.C.muted)194                        if provider.route == "local" { Text("· Inférence locale MacLustr").font(DS.F.caption).foregroundStyle(DS.C.muted) }195                        if let h = provider.health { healthLabel(h) }196                    }197                }198                Spacer(minLength: 8)199                if busy { ProgressView().controlSize(.small) }200                Button("Tester", action: onTest).disabled(busy || !provider.configured).help("Vérifie la clé auprès de \(provider.name)")201                    .accessibilityLabel("Tester la clé \(provider.name)")202                if provider.manageable {203                    Menu {204                        Button(provider.keySource == "stored" ? "Remplacer la clé…" : "Définir une clé…", action: onSetKey)205                        if provider.keySource == "stored" { Button("Révoquer la clé…", role: .destructive, action: onRevoke) }206                    } label: { Text("Clé") }207                    .fixedSize().disabled(busy).accessibilityLabel("Gérer la clé \(provider.name)")208                }209            }210            .controlSize(.small)211            FactGrid(rows: facts, columns: 1)212            if let t = test {213                HStack(alignment: .firstTextBaseline, spacing: 6) {214                    Image(systemName: t.ok ? "checkmark.circle.fill" : "xmark.octagon.fill").foregroundStyle(t.ok ? DS.C.ok : DS.C.danger)215                    Text(t.message.isEmpty ? (t.ok ? "Clé acceptée." : "Le test a échoué.") : t.message).font(DS.F.caption).foregroundStyle(DS.C.text2).textSelection(.enabled).fixedSize(horizontal: false, vertical: true)216                }217                .accessibilityElement(children: .combine)218                let info = ProviderTestInfo.facts(t.info)219                if !info.isEmpty { FactGrid(rows: info, columns: 1) }220            }221        }222        .card(padding: 14)223    }224225    private var facts: [Fact] {226        var rows = [Fact("Clé", provider.keySourceLabel + (provider.keyHint.map { " · \($0)" } ?? ""))]227        if let d = provider.validatedAt { rows.append(Fact("Validée le", ExplorerText.dateTime(d))) }228        if let m = provider.models { rows.append(Fact("Modèles", "\(m.total) au registre · \(m.chat) de chat")) }229        if let s = provider.catalog?["syncedAt"]?.stringValue, let d = ServerDate.parse(s) { rows.append(Fact("Catalogue synchronisé", ExplorerText.dateTime(d))) }230        if provider.manageable { rows.append(Fact("Gestion", "Clé modifiable depuis les apps")) }231        return rows232    }233234    private func healthLabel(_ h: ProviderInfo.Health) -> some View {235        let (text, color): (String, Color) = switch h.state {236        case "ok": ("Service en état", DS.C.ok)237        case "open": ("Suspendu après des échecs" + (h.retryInSec > 0 ? " · nouvel essai dans \(h.retryInSec) s" : ""), DS.C.danger)238        case "degraded", "half-open", "half_open": ("Dégradé", DS.C.warn)239        default: ("État : \(h.state)", DS.C.muted)240        }241        return HStack(spacing: 6) {242            Text("·").foregroundStyle(DS.C.muted)243            Text(text + (h.recentFailures > 0 ? " · \(h.recentFailures) échec\(h.recentFailures > 1 ? "s" : "") récent\(h.recentFailures > 1 ? "s" : "")" : "") + (h.active > 0 ? " · \(h.active) en cours" : ""))244                .font(DS.F.caption).foregroundStyle(color)245        }246    }247}248249/// Key entry: a `SecureField` whose content is cleared from the view state the moment it is sent.250struct ProviderKeySheet: View {251    let provider: ProviderInfo252    let model: ProvidersModel253    let close: () -> Void254    @State private var key = ""255    @State private var sending = false256    @FocusState private var focused: Bool257258    private var isRotation: Bool { provider.keySource == "stored" }259260    var body: some View {261        VStack(alignment: .leading, spacing: 14) {262            HStack(spacing: 10) {263                ModelMark(logo: provider.logo ?? provider.id, name: provider.name, size: 24)264                Text(isRotation ? "Remplacer la clé \(provider.name)" : "Définir la clé \(provider.name)").font(DS.F.heading)265            }266            Text("La clé est vérifiée auprès de \(provider.name), puis enregistrée chiffrée sur le serveur. Elle n'est ni conservée ni affichée par cette app ; une confirmation par clé d'accès peut être demandée.")267                .font(DS.F.caption).foregroundStyle(DS.C.muted).fixedSize(horizontal: false, vertical: true)268            SecureField(provider.id == "local" ? "mlx_sk_…" : "Clé d'API \(provider.name)", text: $key).textFieldStyle(.roundedBorder).focused($focused).disabled(sending).onSubmit(send)269                .accessibilityLabel("Clé d'API \(provider.name)").accessibilityIdentifier("provider-key-field")270            if let error = model.keyError { Banner(kind: .error, text: error) }271            HStack {272                if sending { ProgressView().controlSize(.small); Text("Vérification auprès de \(provider.name)…").font(DS.F.caption).foregroundStyle(DS.C.muted) }273                Spacer()274                Button("Annuler") { key = ""; close() }.keyboardShortcut(.cancelAction)275                Button(isRotation ? "Remplacer" : "Enregistrer", action: send).keyboardShortcut(.defaultAction).buttonStyle(.borderedProminent).tint(DS.C.accent)276                    .disabled(sending || key.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty)277            }278        }279        .padding(20).frame(width: 460)280        .onAppear { model.clearKeyError(); focused = true }281        .onDisappear { key = "" }282    }283284    private func send() {285        let value = key.trimmingCharacters(in: .whitespacesAndNewlines)286        guard !value.isEmpty, !sending else { return }287        key = ""   // the field no longer holds the key once it is on its way288        sending = true289        Task {290            let ok = await model.setKey(provider.id, key: value)291            sending = false292            if ok { close() } else { focused = true }293        }294    }295}296
Files main
Menu

Theme