Repository Public
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