Repository Public
1// Author: Simon-Pierre Boucher — contact@spboucher.ai2// File: FileProviderExtension/FileProviderEnumerator.swift3// Description: Enumeration for the system: the children of a folder, the trash, and the working set with incremental changes. Anchors are positions in the local mirror's change counter; the mirror is refreshed from the server's change feed first whenever the server is reachable.4import FileProvider5import Foundation6import SPDriveCore7import SPDriveSync89final class FileProviderEnumerator: NSObject, NSFileProviderEnumerator, @unchecked Sendable {10 enum Scope { case folder(String), workingSet, trash }11 private let scope: Scope12 private let services: DriveServices13 private static let pageSize = 50014 init(scope: Scope, services: DriveServices) { self.scope = scope; self.services = services }15 func invalidate() {}1617 private func anchor(_ seq: Int64) -> NSFileProviderSyncAnchor { NSFileProviderSyncAnchor(Data("\(services.store.generation):\(seq)".utf8)) }18 /// Position of an anchor in this mirror; nil when it belongs to another generation of the mirror.19 private func position(_ a: NSFileProviderSyncAnchor) -> Int64? {20 let parts = String(decoding: a.rawValue, as: UTF8.self).split(separator: ":")21 guard parts.count == 2, parts[0] == services.store.generation, let n = Int64(parts[1]) else { return nil }22 return n23 }24 private func visible(_ items: [DriveItem]) -> [FileProviderItem] {25 items.filter { !OperationJournal.isLocal($0.id) && !$0.isRoot && !($0.parentID.map(OperationJournal.isLocal) ?? false) }.compactMap { services.fpItem($0) }26 }2728 func enumerateItems(for observer: NSFileProviderEnumerationObserver, startingAt page: NSFileProviderPage) {29 let obs = SendableBox(observer), offset = Int(String(decoding: page.rawValue, as: UTF8.self)) ?? 030 Task {31 do {32 var rows: [DriveItem]33 switch scope {34 case .folder(let given):35 // "root" stands for the root folder until its identifier is known36 var id = given == "root" ? (services.store.rootID ?? given) : given37 if offset == 0 {38 // the live listing when the server answers; the mirror otherwise (offline browsing)39 do { let l = try await services.api.listFolder(id); try services.store.upsert([l.folder] + l.children); id = l.folder.id }40 catch { let e = DriveError.wrap(error); let known = (try? services.store.item(id)) ?? nil; if !e.isTransient || known == nil { throw e } }41 }42 rows = try services.store.children(of: id, limit: FileProviderEnumerator.pageSize, offset: offset)43 case .trash:44 if offset == 0 { await services.pull() }45 rows = Array(try services.store.trashRoots().dropFirst(offset).prefix(FileProviderEnumerator.pageSize))46 case .workingSet:47 if offset == 0 { await services.pull() }48 rows = try services.store.allItems(limit: FileProviderEnumerator.pageSize, offset: offset)49 }50 obs.value.didEnumerate(visible(rows))51 if rows.count == FileProviderEnumerator.pageSize { obs.value.finishEnumerating(upTo: NSFileProviderPage(Data("\(offset + rows.count)".utf8))) }52 else { obs.value.finishEnumerating(upTo: nil) }53 } catch { obs.value.finishEnumeratingWithError(services.fpError(error)) }54 }55 }5657 func enumerateChanges(for observer: NSFileProviderChangeObserver, from anchor: NSFileProviderSyncAnchor) {58 let obs = SendableBox(observer)59 Task {60 guard let since = position(anchor) else { obs.value.finishEnumeratingWithError(NSFileProviderError(.syncAnchorExpired)); return }61 await services.pull()62 do {63 let c = try services.store.changes(since: since, limit: FileProviderEnumerator.pageSize)64 var items = c.items65 if case .folder(let given) = scope { let id = given == "root" ? (services.store.rootID ?? given) : given; items = items.filter { $0.parentID == id } }66 if case .trash = scope { items = items.filter(\.trashRoot) }67 let updated = visible(items)68 if !updated.isEmpty { obs.value.didUpdate(updated) }69 let gone = c.deleted.filter { !OperationJournal.isLocal($0) }.map { NSFileProviderItemIdentifier($0) }70 if !gone.isEmpty { obs.value.didDeleteItems(withIdentifiers: gone) }71 obs.value.finishEnumeratingChanges(upTo: self.anchor(c.seq), moreComing: c.more)72 } catch { obs.value.finishEnumeratingWithError(services.fpError(error)) }73 }74 }75 func currentSyncAnchor(completionHandler: @escaping (NSFileProviderSyncAnchor?) -> Void) { completionHandler(anchor(services.store.seq)) }76}77/// Carries a non-Sendable system object into a task that uses it from one place only.78final class SendableBox<T>: @unchecked Sendable { let value: T; init(_ v: T) { value = v } }79