SPB Git

Repository Public

AppModel.swift 14.4 KB 304 lines swift

1// SP Wallet iOS2// File: App/AppModel.swift3// Description: Session and wallet state of the app: launch, passkey sign-in, optional device lock, read-only offline consultation,4//              the base data (networks, accounts, portfolio, activity, settings) with their freshness, and refresh scheduling.5//              Everything shown comes from the server or from a dated snapshot of what the server said; nothing is made up.6//7// Author: Simon-Pierre Boucher8// Contact: contact@spboucher.ai9import Foundation10import Observation11import OSLog12import SPWalletCore13import WidgetKit1415/** A value with its provenance: live from the server just now, or a snapshot saved at `savedAt`. */16struct Loaded<T: Sendable>: Sendable {17    var value: T?18    var savedAt: Date?19    /** True when `value` came from the server during this session's last successful refresh. */20    var live = false21    var error: APIError?2223    var isCached: Bool { value != nil && !live }24    mutating func set(live v: T) { value = v; savedAt = Date(); live = true; error = nil }25    mutating func set(cached c: Cached<T>) { value = c.value; savedAt = c.savedAt; live = false }26    mutating func fail(_ e: APIError) { error = e; live = false }27}2829@MainActor @Observable30final class AppModel {31    enum Phase: Equatable { case launching, signedOut, locked, ready }3233    let env: AppEnvironment34    /** Navigation state; kept here so that every presented content can be given the whole environment from the model alone. */35    let router = Router()36    @ObservationIgnored private let log = Logger(subsystem: "ai.spboucher.spwallet.ios", category: "app")3738    var phase: Phase = .launching39    /** Read-only consultation of the last synchronized data, without a session. No operation is offered in this mode. */40    var offlineBrowsing = false41    /** The last request could not reach the server. */42    var offline = false43    var signingIn = false44    var signInError: String?45    var hasOfflineData = false4647    var networks = Loaded<[Network]>()48    var accounts = Loaded<Accounts>()49    var portfolio = Loaded<Portfolio>()50    var activity = Loaded<[ActivityItem]>()51    var settings = Loaded<WalletSettings>()52    var isRefreshing = false5354    @ObservationIgnored private var eventsTask: Task<Void, Never>?55    @ObservationIgnored private var refreshTask: Task<Void, Never>?56    @ObservationIgnored private var backgroundedAt: Date?5758    /** Alerts: polling, unread badge, local notifications (Core/System/AlertCenter.swift). */59    @ObservationIgnored private(set) lazy var alertCenter = AlertCenter(model: self)6061    init(env: AppEnvironment) { self.env = env }6263    // MARK: derived6465    /** Operations (send, swap, approve…) need a live session and a reachable server. */66    var canOperate: Bool { phase == .ready && !offlineBrowsing && !offline }67    var currency: FiatCurrency { settings.value?.currency ?? .cad }68    var hideBalances: Bool { settings.value?.hideBalances ?? false }69    func network(_ id: String) -> Network? { networks.value?.first { $0.id == id } }70    func account(_ network: String) -> Account? { accounts.value?.accounts.first { $0.network == network } }7172    // MARK: lifecycle7374    func bootstrap() async {75        #if DEBUG76        await env.prepareDevStackIfNeeded()77        #endif78        eventsTask?.cancel()79        eventsTask = Task { [weak self] in80            guard let self else { return }81            for await e in await self.env.client.events() where e == .unauthenticated { self.sessionEnded() }82        }83        await loadSnapshots()84        hasOfflineData = portfolio.value != nil85        do {86            let s = try await env.auth.state()87            offline = false88            if s.authenticated { await enter() } else { phase = .signedOut }89        } catch let e as APIError where e.isOffline {90            offline = true91            // no network: with a stored session and snapshots, open in read-only mode behind the device lock92            if await env.client.hasToken, hasOfflineData { offlineBrowsing = true; phase = env.preferences.deviceLock ? .locked : .ready }93            else { phase = .signedOut }94        } catch { phase = .signedOut }95    }9697    private func enter() async {98        offlineBrowsing = false99        phase = env.preferences.deviceLock && DeviceLock.available() != .none ? .locked : .ready100        if phase == .locked { await unlock() }101        await refreshAll()102        startAutoRefresh()103    }104105    func signIn() async {106        guard !signingIn else { return }107        signingIn = true; signInError = nil108        defer { signingIn = false }109        do {110            try await env.auth.login(with: env.passkeys)111            offline = false; offlineBrowsing = false112            phase = .ready // the passkey just verified the person: no second local prompt113            await refreshAll()114            startAutoRefresh()115        } catch PasskeyError.cancelled {116            // dismissed: nothing to report117        } catch PasskeyError.noCredential {118            signInError = String(localized: "Aucune clé d’accès de ce portefeuille n’est disponible sur cet appareil. Ajoute cet appareil depuis un appareil déjà enrôlé (Sécurité → Ajouter une clé d’accès), ou utilise une clé d’accès synchronisée par iCloud.")119        } catch PasskeyError.notAvailable(let why) {120            signInError = String(localized: "Les clés d’accès ne sont pas utilisables pour ce portefeuille sur cet appareil pour le moment.") + "\n" + why121        } catch let e as APIError where e.isOffline {122            offline = true123            signInError = String(localized: "Le serveur du portefeuille est injoignable. Vérifie la connexion.")124        } catch let e as APIError {125            signInError = e.code == "login_failed" ? String(localized: "Le serveur n’a pas reconnu cette clé d’accès.") : e.message126        } catch { signInError = error.localizedDescription }127    }128129    /** Explicit sign-out: the session is revoked on the server and nothing of the wallet stays on the device. */130    func signOut() async {131        stopAutoRefresh()132        await env.auth.logout()133        await wipeLocalData()134        phase = .signedOut135    }136137    func wipeLocalData() async {138        await env.cache.removeAll()139        WidgetSnapshot.erase(appGroup: env.configuration.appGroup)140        WidgetCenter.shared.reloadAllTimelines()141        networks = .init(); accounts = .init(); portfolio = .init(); activity = .init(); settings = .init()142        hasOfflineData = false; offlineBrowsing = false143        alertCenter.reset()144    }145146    /** The server ended the session (30 minutes idle, 12 hours absolute, or revoked). Snapshots stay for read-only consultation. */147    private func sessionEnded() {148        stopAutoRefresh()149        guard phase != .signedOut else { return }150        offlineBrowsing = false151        phase = .signedOut152        markAllCached()153        alertCenter.sessionEnded()154    }155156    private func markAllCached() { networks.live = false; accounts.live = false; portfolio.live = false; activity.live = false; settings.live = false }157158    func browseOffline() async {159        guard hasOfflineData else { return }160        if env.preferences.deviceLock, DeviceLock.available() != .none {161            guard await DeviceLock.unlock(reason: String(localized: "Afficher les dernières données synchronisées du portefeuille")) else { return }162        }163        offlineBrowsing = true164        phase = .ready165    }166167    func leaveOfflineBrowsing() { offlineBrowsing = false; phase = .signedOut }168169    func unlock() async {170        guard phase == .locked else { return }171        if await DeviceLock.unlock(reason: String(localized: "Déverrouiller SP Wallet")) { phase = .ready }172    }173174    func sceneDidEnterBackground() { backgroundedAt = Date(); stopAutoRefresh() }175176    func sceneDidBecomeActive() async {177        if phase == .ready, env.preferences.deviceLock, DeviceLock.available() != .none, let t = backgroundedAt, Date().timeIntervalSince(t) > 60 {178            phase = .locked179        }180        backgroundedAt = nil181        if phase == .locked { await unlock() }182        if phase == .ready, !offlineBrowsing { await refreshAll(); startAutoRefresh() }183        else if phase == .ready, offlineBrowsing { await retryOnline() }184    }185186    /** From offline consultation: try the server again; a still-valid session resumes normally. */187    func retryOnline() async {188        do {189            let s = try await env.auth.state()190            offline = false191            if s.authenticated { offlineBrowsing = false; await refreshAll(); startAutoRefresh() }192            else if offlineBrowsing { /* stay in read-only mode; signing in is offered by the banner */ }193        } catch { offline = true }194    }195196    // MARK: data197198    private func loadSnapshots() async {199        if let c = await env.cache.load([Network].self, key: "networks") { networks.set(cached: c) }200        if let c = await env.cache.load(Accounts.self, key: "accounts") { accounts.set(cached: c) }201        if let c = await env.cache.load(Portfolio.self, key: "portfolio") { portfolio.set(cached: c) }202        if let c = await env.cache.load([ActivityItem].self, key: "activity") { activity.set(cached: c) }203        if let c = await env.cache.load(WalletSettings.self, key: "settings") { settings.set(cached: c) }204    }205206    func refreshAll() async {207        guard phase != .signedOut, !offlineBrowsing || !offline else { return }208        guard !isRefreshing else { return }209        isRefreshing = true210        defer { isRefreshing = false }211        async let n = fetch { try await $0.wallet.networks() }212        async let a = fetch { try await $0.wallet.accounts() }213        async let p = fetch { try await $0.wallet.portfolio() }214        async let h = fetch { try await $0.wallet.activity(limit: 200) }215        async let st = fetch { try await $0.wallet.settings() }216        let (rn, ra, rp, rh, rs) = await (n, a, p, h, st)217        networks = applied(rn, networks, key: "networks"); accounts = applied(ra, accounts, key: "accounts")218        portfolio = applied(rp, portfolio, key: "portfolio"); activity = applied(rh, activity, key: "activity"); settings = applied(rs, settings, key: "settings")219        hasOfflineData = portfolio.value != nil220        publishWidgetSnapshot()221    }222223    func refreshPortfolio() async {224        let r = await fetch { try await $0.wallet.portfolio() }225        portfolio = applied(r, portfolio, key: "portfolio")226        publishWidgetSnapshot()227    }228    /** Background app refresh: the widget snapshot needs the owner's display settings, so the snapshots are loaded first. */229    func backgroundRefresh() async {230        if settings.value == nil { await loadSnapshots() }231        guard settings.value != nil else { return }232        await refreshPortfolio()233    }234    func refreshActivity() async {235        let r = await fetch { try await $0.wallet.activity(limit: 200) }236        activity = applied(r, activity, key: "activity")237    }238239    private func fetch<T: Sendable>(_ call: @escaping @MainActor (AppEnvironment) async throws -> T) async -> Result<T, Error> {240        do { return .success(try await call(env)) } catch { return .failure(error) }241    }242243    private func applied<T: Codable & Sendable>(_ result: Result<T, Error>, _ current: Loaded<T>, key: String) -> Loaded<T> {244        var slot = current245        switch result {246        case .success(let v):247            slot.set(live: v); offline = false248            Task { await env.cache.save(v, key: key) }249        case .failure(let e as APIError):250            slot.fail(e)251            if e.isOffline { offline = true }252            else if !e.isUnauthenticated { log.error("refresh \(key, privacy: .public) failed: \(e.code, privacy: .public)") }253        case .failure: break254        }255        return slot256    }257258    func update(settings new: WalletSettings) async {259        do { settings.set(live: try await env.wallet.update(settings: new)); await env.cache.save(new, key: "settings"); publishWidgetSnapshot() }260        catch let e as APIError { settings.fail(e) } catch {}261    }262263    // MARK: refresh pacing (foreground only; the server caches chain reads for 12 s and prices for 4 minutes)264265    func startAutoRefresh() {266        refreshTask?.cancel()267        refreshTask = Task { [weak self] in268            while !Task.isCancelled {269                // faster while something is in flight, slow otherwise: fewer requests, less battery270                let inFlight = self?.portfolio.value?.pending.contains { $0.state.isInFlight } ?? false271                try? await Task.sleep(for: .seconds(inFlight ? 8 : 45))272                guard !Task.isCancelled, let self, self.phase == .ready, !self.offlineBrowsing else { continue }273                await self.refreshPortfolio()274                if inFlight { await self.refreshActivity() }275            }276        }277    }278    func stopAutoRefresh() { refreshTask?.cancel(); refreshTask = nil }279280    // MARK: widgets281282    func publishWidgetSnapshot() {283        guard let p = portfolio.value else { return }284        let allowed = env.preferences.widgetAmounts && !hideBalances285        let alertFields = alertCenter.widgetFields()286        let total = p.estimatedTotal(in: currency)287        var bySymbol: [String: (name: String, value: Double)] = [:]288        for b in p.balances { if let v = p.estimatedValue(of: b, in: currency), v > 0 { bySymbol[b.symbol, default: (b.name, 0)].value += v } }289        let top = bySymbol.sorted { $0.value.value > $1.value.value }.prefix(4).map { k, v in290            WidgetSnapshot.Asset(symbol: k, name: v.name, value: allowed ? Money.fiat(v.value, currency) : nil, share: total.value > 0 ? v.value / total.value : 0, change24h: p.prices?[k]?.change24h)291        }292        let txs = (activity.value ?? []).prefix(4).map {293            WidgetSnapshot.Transaction(id: $0.id, kind: $0.kind, symbol: $0.symbol, amount: allowed ? $0.amountDisplay : nil, state: $0.state, settled: $0.isSettled, at: $0.at)294        }295        var weighted = 0.0296        for (k, v) in bySymbol { if let c = p.prices?[k]?.change24h, total.value > 0 { weighted += c * v.value / total.value } }297        WidgetSnapshot(savedAt: portfolio.savedAt ?? Date(), signedIn: true, amountsAllowed: allowed,298                       total: allowed ? Money.fiat(total.value, currency) : nil, totalComplete: total.complete,299                       change24h: bySymbol.isEmpty ? nil : weighted, pricesStale: p.pricesStale, assets: Array(top), transactions: Array(txs),300                       unreadAlerts: alertFields.unreadAlerts, criticalAlert: alertFields.criticalAlert, halted: p.halted).write(appGroup: env.configuration.appGroup)301        WidgetCenter.shared.reloadAllTimelines()302    }303}304
Files main
Menu

Theme