SPB Git

Repository Public

SyncMonitor.swift 8.9 KB 167 lines swift

1// Author: Simon-Pierre Boucher — contact@spboucher.ai2// File: App/SyncMonitor.swift3// Description: Drives the shared synchronisation engine from the application (launch, edits, network back, timer) and publishes its state to the interface.4import SwiftUI5import SPNotesStore6import SPNotesSync78@Observable final class SyncMonitor {9    private(set) var status = SyncStatus()10    private(set) var isRunning = false11    @ObservationIgnored weak var env: AppEnvironment?12    @ObservationIgnored private let engine: SyncEngine13    @ObservationIgnored private let store: NotesStore14    @ObservationIgnored private var timer: Task<Void, Never>?15    @ObservationIgnored private var watcher: Task<Void, Never>?1617    init(engine: SyncEngine, store: NotesStore) { self.engine = engine; self.store = store }1819    /// What the status item shows.20    enum Summary: Equatable { case localOnly, signedOut, offline(pending: Int), syncing, pending(Int), conflicts(Int), attention(Int), failed(String), upToDate(Date?) }21    /// 2.0: things the synchronisation kept aside and that need the owner — operations the server refused for good,22    /// actions queued by a newer version of the app, canvases whose two copies could not be merged.23    struct Attention: Identifiable, Equatable { enum Kind { case rejected, unsupported, canvasConflicts }; let kind: Kind; let count: Int; var id: Kind { kind }24        var symbol: String { switch kind { case .rejected: "xmark.octagon"; case .unsupported: "questionmark.app.dashed"; case .canvasConflicts: "rectangle.on.rectangle.slash" } }25        var title: String {26            switch kind {27            case .rejected: count == 1 ? "1 opération refusée par le serveur" : "\(count) opérations refusées par le serveur"28            case .unsupported: count == 1 ? "1 action en attente d'une version plus récente" : "\(count) actions en attente d'une version plus récente"29            case .canvasConflicts: count == 1 ? "1 canvas en conflit" : "\(count) canvas en conflit"30            }31        }32        var detail: String {33            switch kind {34            case .rejected: "Elles sont conservées avec leur contenu. Ouvre « Tâches » pour les réessayer ou les abandonner."35            case .unsupported: "Elles ont été créées par une version plus récente de SP Notes. Elles sont gardées telles quelles et partiront après la mise à jour de l'application."36            case .canvasConflicts: "Les deux copies sont conservées. Ouvre le canvas sur le Web ou sur iPad pour choisir."37            }38        }39    }40    var attention: [Attention] {41        [Attention(kind: .rejected, count: status.rejected), Attention(kind: .unsupported, count: status.unsupported), Attention(kind: .canvasConflicts, count: status.canvasConflicts)].filter { $0.count > 0 }42    }43    var summary: Summary {44        guard let env else { return .localOnly }45        if env.account.phase == .local { return .localOnly }46        if env.account.phase == .expired { return .signedOut }47        if !env.connectivity.reachable { return .offline(pending: status.pending) }48        if isRunning || status.phase == .syncing { return .syncing }49        if status.conflicts > 0 { return .conflicts(status.conflicts) }50        if case .failed(let m) = status.phase { return .failed(m) }51        if status.phase == .offline { return .offline(pending: status.pending) }52        if status.pending > 0 { return .pending(status.pending) }53        if !attention.isEmpty { return .attention(attention.reduce(0) { $0 + $1.count }) }54        return .upToDate(status.lastSuccess)55    }5657    /// Follows the engine's status (counters, phase). Idempotent.58    func observe() {59        guard watcher == nil else { return }60        watcher = Task { [weak self] in61            guard let self else { return }62            for await s in await self.engine.statusUpdates() { self.status = s }63        }64    }6566    func start() {67        observe()68        // a periodic pull catches what other devices wrote while this Mac was idle69        timer = Task { [weak self] in70            while !Task.isCancelled {71                try? await Task.sleep(for: .seconds(75))72                guard let self, let env = self.env, env.preferences.syncAutomatically, NSApp.isActive else { continue }73                self.syncNow()74            }75        }76        syncNow()77    }7879    private var canSync: Bool { guard let env else { return false }; return env.account.isSignedIn && env.connectivity.reachable }8081    /// A local write happened: counters now, network after a quiet moment.82    func localChange() {83        Task { await engine.refreshCounts() }84        guard canSync, env?.preferences.syncAutomatically == true else { return }85        Task { await engine.schedule(after: .seconds(2)) }86    }8788    func syncNow() {89        guard canSync else { refresh(); return }90        Task { await run() }91    }92    /// One full cycle; returns when it is over (used by the tests and by "Synchroniser maintenant").93    @discardableResult func run() async -> SyncOutcome {94        guard canSync else { refresh(); return env?.account.isSignedIn == true ? .offline : .signedOut }95        isRunning = true; defer { isRunning = false }96        await env?.flushAll()97        let outcome = await engine.sync()98        await env?.refreshServerFeatures()99        ImageCache.shared.noteFilesChanged()100        return outcome101    }102    func refresh() { Task { await engine.refreshCounts() } }103    func connectivityChanged() { if canSync { syncNow() } else { refresh() } }104105    func resolve(pageId: String, choice: ConflictResolution) async throws -> String? {106        let copy = try await engine.resolveConflict(pageId: pageId, choice: choice)107        syncNow()108        return copy109    }110    func download(attachmentId: String) async throws -> URL { try await engine.download(attachmentId: attachmentId) }111}112113/// Transient messages at the bottom of a window. A toast can carry one action (« Annuler » after a triage or a deletion).114@Observable final class ToastCenter {115    struct Action { let title: String; let run: () -> Void }116    struct Toast: Identifiable, Equatable { let id = UUID(); var text: String; var symbol: String; var isError: Bool; var action: Action?117        static func == (a: Toast, b: Toast) -> Bool { a.id == b.id } }118    private(set) var current: Toast?119    @ObservationIgnored private var hide: Task<Void, Never>?120    func show(_ text: String, symbol: String = "checkmark.circle", isError: Bool = false, action: Action? = nil) {121        current = Toast(text: text, symbol: isError ? "exclamationmark.triangle" : symbol, isError: isError, action: action)122        hide?.cancel()123        hide = Task { [weak self] in try? await Task.sleep(for: .seconds(isError || action != nil ? 7 : 3)); if !Task.isCancelled { self?.current = nil } }124    }125    func dismiss() { hide?.cancel(); current = nil }126    func error(_ error: Error) { show((error as? LocalizedError)?.errorDescription ?? String(describing: error), isError: true) }127}128129/// Decoded images of local attachment files, keyed by document source.130final class ImageCache {131    static let shared = ImageCache()132    private let cache = NSCache<NSString, NSImage>()133    private var missing = Set<String>()134    private var paths: [String: String] = [:]135    var onFilesChanged: (() -> Void)?136    init() { cache.countLimit = 120 }137138    func image(src: String, env: AppEnvironment) -> NSImage? {139        if let hit = cache.object(forKey: src as NSString) { return hit }140        guard let path = paths[src] else {141            // the database lookup is asynchronous: answer nil now, draw again when the path is known142            if !missing.contains(src), let id = Self.attachmentId(src) {143                missing.insert(src)144                Task { @MainActor in145                    if let rec = try? await env.store.attachment(id: id), let rel = rec.localPath, FileManager.default.fileExists(atPath: env.files.url(relativePath: rel).path) {146                        self.paths[src] = env.files.url(relativePath: rel).path; self.missing.remove(src); self.onFilesChanged?()147                    } else if (try? await env.store.attachment(id: id)) != nil, env.account.isSignedIn, env.connectivity.reachable {148                        if (try? await env.syncMonitor.download(attachmentId: id)) != nil { self.missing.remove(src); self.onFilesChanged?() }149                    }150                }151            }152            return nil153        }154        guard let img = NSImage(contentsOfFile: path) else { return nil }155        cache.setObject(img, forKey: src as NSString)156        return img157    }158    static func attachmentId(_ src: String) -> String? {159        guard src.hasPrefix("/api/files/") else { return nil }160        let id = String(src.dropFirst("/api/files/".count).prefix(36)).lowercased()161        return UUID(uuidString: id) != nil ? id : nil162    }163    func register(src: String, path: String) { paths[src] = path; missing.remove(src) }164    func noteFilesChanged() { missing.removeAll(); onFilesChanged?() }165    func clear() { cache.removeAllObjects(); missing.removeAll(); paths.removeAll() }166}167
Files main
Menu

Theme