Repository Public
1// SP Notes iOS2// File: Features/Tasks/TasksModel.swift3// Description: The global task list: the pure rules (due days — a bare day is stored at noon UTC and shown as that UTC date —,4// groups En retard / Aujourd’hui / À venir / Sans date / Terminées) and the observable model over5// `TasksRepository`. Every write works offline (outbox); pending and refused operations are surfaced; a 2.x server6// is an explained state. The 1.0 reminders are listed read-only (they stay reminders, see SYNC_ENGINE §7.6).7//8// Author: Simon-Pierre Boucher9// Contact: contact@spboucher.ai10import Foundation11import Observation12import SPNotesAPI13import SPNotesCore1415/// The priority of a task (the name alone is ambiguous with Swift's own `TaskPriority`).16typealias TaskPriority = SPNotesAPI.TaskPriority1718/// Calendar days of tasks.19enum TaskDue {20 struct Day: Hashable, Comparable, Sendable {21 var year: Int, month: Int, day: Int22 static func < (a: Day, b: Day) -> Bool { (a.year, a.month, a.day) < (b.year, b.month, b.day) }23 /// `YYYY-MM-DD`, the form `TasksRepository.create(dueDay:)` takes.24 var string: String { String(format: "%04d-%02d-%02d", year, month, day) }25 }2627 static let utc: Calendar = {28 var calendar = Calendar(identifier: .gregorian)29 calendar.timeZone = TimeZone(identifier: "UTC") ?? .gmt30 return calendar31 }()3233 /// A due date without a time: the server stores a bare day at 12:00:00 UTC.34 static func isBareDay(_ date: Date) -> Bool {35 let parts = utc.dateComponents([.hour, .minute, .second], from: date)36 return parts.hour == 12 && parts.minute == 0 && parts.second == 037 }3839 /// The day a due date falls on: the UTC date part of a bare day (the same day everywhere), the local day of a timed one.40 static func day(of date: Date, calendar: Calendar = .current) -> Day {41 let parts = (isBareDay(date) ? utc : calendar).dateComponents([.year, .month, .day], from: date)42 return Day(year: parts.year ?? 1970, month: parts.month ?? 1, day: parts.day ?? 1)43 }4445 static func today(now: Date = Date(), calendar: Calendar = .current) -> Day {46 let parts = calendar.dateComponents([.year, .month, .day], from: now)47 return Day(year: parts.year ?? 1970, month: parts.month ?? 1, day: parts.day ?? 1)48 }4950 static func day(_ day: Day, adding days: Int) -> Day {51 let date = utc.date(byAdding: .day, value: days, to: noonUTC(day)) ?? noonUTC(day)52 return self.day(of: date)53 }5455 /// The instant a bare day is stored at.56 static func noonUTC(_ day: Day) -> Date {57 utc.date(from: DateComponents(year: day.year, month: day.month, day: day.day, hour: 12)) ?? Date(timeIntervalSince1970: 0)58 }5960 /// A date for a date picker (local calendar) showing this day.61 static func pickerDate(_ day: Day, calendar: Calendar = .current) -> Date {62 calendar.date(from: DateComponents(year: day.year, month: day.month, day: day.day, hour: 12)) ?? Date()63 }6465 /// « Aujourd’hui », « Demain », « Hier », otherwise the date; a timed due date also says its time.66 static func label(_ date: Date, now: Date = Date(), calendar: Calendar = .current, locale: Locale = .current) -> String {67 let due = day(of: date, calendar: calendar), today = today(now: now, calendar: calendar)68 var text: String69 if due == today { text = String(localized: "Aujourd’hui") }70 else if due == day(today, adding: 1) { text = String(localized: "Demain") }71 else if due == day(today, adding: -1) { text = String(localized: "Hier") }72 else {73 var style = Date.FormatStyle(locale: locale, timeZone: utc.timeZone).weekday(.abbreviated).day().month(.abbreviated)74 if due.year != today.year { style = style.year() }75 text = noonUTC(due).formatted(style)76 }77 if !isBareDay(date) {78 var time = Date.FormatStyle(date: .omitted, time: .shortened, locale: locale)79 time.timeZone = calendar.timeZone80 text += " · " + date.formatted(time)81 }82 return text83 }84}8586enum TaskGroupKind: String, CaseIterable, Sendable {87 case overdue, today, upcoming, undated, done8889 var title: String {90 switch self {91 case .overdue: return String(localized: "En retard")92 case .today: return String(localized: "Aujourd’hui")93 case .upcoming: return String(localized: "À venir")94 case .undated: return String(localized: "Sans date")95 case .done: return String(localized: "Terminées")96 }97 }98}99100struct TaskGroup: Identifiable, Equatable, Sendable {101 var kind: TaskGroupKind102 var tasks: [TaskItem]103 var id: String { kind.rawValue }104}105106enum TaskGrouping {107 static func kind(of task: TaskItem, now: Date = Date(), calendar: Calendar = .current) -> TaskGroupKind {108 if task.isDone { return .done }109 guard let due = task.dueAt else { return .undated }110 let day = TaskDue.day(of: due, calendar: calendar), today = TaskDue.today(now: now, calendar: calendar)111 return day < today ? .overdue : (day == today ? .today : .upcoming)112 }113114 /// Non-empty groups in reading order. Dated groups: soonest first, then high priority first; done: most recently completed first.115 static func groups(_ tasks: [TaskItem], showDone: Bool, now: Date = Date(), calendar: Calendar = .current) -> [TaskGroup] {116 var buckets: [TaskGroupKind: [TaskItem]] = [:]117 for task in tasks where task.deletedAt == nil { buckets[kind(of: task, now: now, calendar: calendar), default: []].append(task) }118 func rank(_ task: TaskItem) -> Int { task.priority == "high" ? 0 : (task.priority == "low" ? 2 : 1) }119 return TaskGroupKind.allCases.compactMap { kind in120 guard var list = buckets[kind], !list.isEmpty, kind != .done || showDone else { return nil }121 switch kind {122 case .done: list.sort { ($0.completedAt ?? $0.updatedAt) > ($1.completedAt ?? $1.updatedAt) }123 case .undated: list.sort { rank($0) != rank($1) ? rank($0) < rank($1) : $0.createdAt > $1.createdAt }124 default:125 list.sort { a, b in126 let x = a.dueAt ?? .distantFuture, y = b.dueAt ?? .distantFuture127 if x != y { return x < y }128 return rank(a) != rank(b) ? rank(a) < rank(b) : a.createdAt > b.createdAt129 }130 }131 return TaskGroup(kind: kind, tasks: list)132 }133 }134135 static func priorityLabel(_ priority: TaskPriority) -> String {136 switch priority {137 case .low: return String(localized: "Basse")138 case .medium: return String(localized: "Moyenne")139 case .high: return String(localized: "Haute")140 }141 }142}143144/// A task operation the server refused, with what the user needs to decide.145struct RejectedTaskOperation: Identifiable, Equatable, Sendable {146 var operation: PendingTaskOperation147 var taskTitle: String148 var id: Int64 { operation.id }149150 var verbLabel: String {151 switch operation.verb {152 case "create": return String(localized: "Création refusée")153 case "delete": return String(localized: "Suppression refusée")154 default: return String(localized: "Modification refusée")155 }156 }157}158159/// A 1.0 reminder shown in the task list (read-only: it opens its note).160struct ReminderEntry: Identifiable, Equatable, Sendable {161 var reminder: ReminderRecord162 var noteTitle: String163 var id: String { reminder.id }164}165166@MainActor167@Observable168final class TasksModel {169 enum Phase: Equatable { case loading, ready, unsupported }170171 private(set) var phase: Phase = .loading172 private(set) var tasks: [TaskItem] = []173 private(set) var groups: [TaskGroup] = []174 private(set) var doneCount = 0175 private(set) var reminders: [ReminderEntry] = []176 /// Tasks with local changes the server has not acknowledged yet.177 private(set) var pending: Set<String> = []178 private(set) var rejected: [RejectedTaskOperation] = []179 private(set) var pageTitles: [String: String] = [:]180 var showsDone = false { didSet { if showsDone != oldValue { regroup() } } }181 /// A failure to tell the user (validation, storage); cleared by the screen once shown.182 var notice: String?183184 @ObservationIgnored private let repository: TasksRepository185 @ObservationIgnored private let features: @Sendable () async -> ServerMeta?186 @ObservationIgnored private let loadReminders: @Sendable () async -> [ReminderRecord]187 @ObservationIgnored private let pageTitle: @Sendable (String) async -> String?188 @ObservationIgnored private let now: @Sendable () -> Date189 @ObservationIgnored private let calendar: Calendar190191 init(repository: TasksRepository, features: @escaping @Sendable () async -> ServerMeta? = { nil },192 reminders: @escaping @Sendable () async -> [ReminderRecord] = { [] }, pageTitle: @escaping @Sendable (String) async -> String? = { _ in nil },193 now: @escaping @Sendable () -> Date = { Date() }, calendar: Calendar = .current) {194 self.repository = repository195 self.features = features196 self.loadReminders = reminders197 self.pageTitle = pageTitle198 self.now = now199 self.calendar = calendar200 }201202 convenience init(app: AppModel) {203 let store = app.store, repositories = app.repositories204 self.init(repository: repositories.tasks, features: { await repositories.features() },205 reminders: { (try? await store.upcomingReminders(from: nil, limit: 200)) ?? [] },206 pageTitle: { id in (try? await store.summary(id: id)).flatMap { $0 }.flatMap { $0.deletedAt == nil ? $0.title : nil } })207 }208209 var isEmpty: Bool { tasks.isEmpty && reminders.isEmpty }210 var openCount: Int { tasks.filter { !$0.isDone }.count }211212 func group(_ kind: TaskGroupKind) -> [TaskItem] { groups.first { $0.kind == kind }?.tasks ?? [] }213214 // MARK: reading215216 func load() async {217 let meta = await features()218 let unsupported = meta.map { !$0.has(ServerFeature.tasksV2) } ?? false219 let records = await loadReminders()220 // A reminder synced as a task comes back through the feed: it stays a reminder here (one writer), not a second row.221 let reminderTasks = Set(records.compactMap(\.serverTaskId))222 let all = ((try? await repository.list(.all)) ?? []).filter { !reminderTasks.contains($0.id) }223 var entries: [ReminderEntry] = []224 for record in records where !record.deleted && !record.done {225 var title = ""226 if let pageId = record.pageId { title = await pageTitle(pageId) ?? "" }227 entries.append(ReminderEntry(reminder: record, noteTitle: title))228 }229 var titles = pageTitles230 for pageId in Set(all.compactMap(\.pageId)) where titles[pageId] == nil {231 if let title = await pageTitle(pageId) { titles[pageId] = title }232 }233 let operations = (try? await repository.pendingOperations()) ?? []234 var dirty = Set<String>()235 for task in all { if (try? await repository.isPending(id: task.id)) == true { dirty.insert(task.id) } }236 let byId = Dictionary(all.map { ($0.id, $0) }, uniquingKeysWith: { a, _ in a })237 tasks = all238 reminders = entries.sorted { ($0.reminder.dueAt ?? .distantFuture) < ($1.reminder.dueAt ?? .distantFuture) }239 pageTitles = titles240 pending = dirty241 rejected = operations.filter { $0.state == .rejected }.map { RejectedTaskOperation(operation: $0, taskTitle: byId[$0.taskId]?.title ?? String(localized: "Tâche")) }242 phase = unsupported ? .unsupported : .ready243 regroup()244 }245246 private func regroup() {247 groups = TaskGrouping.groups(tasks, showDone: showsDone, now: now(), calendar: calendar)248 doneCount = tasks.filter(\.isDone).count249 }250251 // MARK: writing (all offline-capable)252253 @discardableResult254 func add(title: String, due: TaskDue.Day? = nil, priority: TaskPriority = .medium, pageId: String? = nil, blockId: String? = nil) async -> TaskItem? {255 let trimmed = title.trimmingCharacters(in: .whitespacesAndNewlines)256 guard !trimmed.isEmpty else { return nil }257 return await write { try await self.repository.create(title: trimmed, dueDay: due?.string, priority: priority, pageId: pageId, blockId: blockId) }258 }259260 func setDone(_ task: TaskItem, _ done: Bool) async { await write { try await self.repository.setDone(id: task.id, done) } }261 func setPriority(_ task: TaskItem, _ priority: TaskPriority) async { await write { try await self.repository.update(id: task.id, TaskEdit(priority: priority)) } }262 func rename(_ task: TaskItem, to title: String) async { await write { try await self.repository.update(id: task.id, TaskEdit(title: title)) } }263264 /// Sets the due day (nil clears it). A day is stored as the server stores it: noon UTC.265 func setDue(_ task: TaskItem, _ day: TaskDue.Day?) async {266 await write { try await self.repository.update(id: task.id, TaskEdit(dueAt: day.map { .value(TaskDue.noonUTC($0)) } ?? .null)) }267 }268269 /// Applies an edit made in the sheet, sending only what changed.270 func apply(_ task: TaskItem, title: String, due: TaskDue.Day?, priority: TaskPriority) async {271 var edit = TaskEdit()272 let trimmed = title.trimmingCharacters(in: .whitespacesAndNewlines)273 if !trimmed.isEmpty, trimmed != task.title { edit.title = trimmed }274 if priority.rawValue != (task.priority ?? TaskPriority.medium.rawValue) { edit.priority = priority }275 let currentDay = task.dueAt.map { TaskDue.day(of: $0, calendar: calendar) }276 if due != currentDay || (due == nil) != (task.dueAt == nil) { edit.dueAt = due.map { .value(TaskDue.noonUTC($0)) } ?? .null }277 guard !edit.isEmpty else { return }278 let changes = edit279 await write { try await self.repository.update(id: task.id, changes) }280 }281282 /// Deletes a task. Returns it so the screen can offer to undo.283 @discardableResult284 func delete(_ task: TaskItem) async -> TaskItem? {285 let done: Bool? = await write { try await self.repository.delete(id: task.id); return true }286 return done == true ? task : nil287 }288289 /// Undo of a deletion: the task is created again with the same fields (a new id: the deleted one may already be gone on the server).290 func restore(_ task: TaskItem) async {291 await write {292 try await self.repository.create(title: task.title, dueAt: task.dueAt, priority: TaskPriority(rawValue: task.priority ?? "") ?? .medium,293 status: TaskStatus(rawValue: task.status) ?? .todo, project: task.project, pageId: task.pageId, blockId: task.blockId)294 }295 }296297 func retry(_ rejected: RejectedTaskOperation) async { await write { try await self.repository.retry(operation: rejected.operation.id); return true } }298 func discard(_ rejected: RejectedTaskOperation) async { await write { try await self.repository.discard(operation: rejected.operation.id); return true } }299300 @discardableResult301 private func write<T: Sendable>(_ work: @MainActor () async throws -> T) async -> T? {302 do {303 let value = try await work()304 await load()305 return value306 } catch let error as RepositoryError {307 switch error {308 case .unsupported: phase = .unsupported309 case .invalid(let message): notice = message310 case .offline: notice = String(localized: "Cette action demande une connexion. Rien n’a été modifié.")311 default: notice = error.errorDescription ?? String(localized: "L’opération n’a pas pu être enregistrée sur cet appareil.")312 }313 await load()314 return nil315 } catch {316 notice = String(localized: "L’opération n’a pas pu être enregistrée sur cet appareil.")317 return nil318 }319 }320}321