SPB Git

Repository Public

TasksModel.swift 15.7 KB 321 lines swift

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
Files main
Menu

Theme