Repository Public
1// SP Lecture Studio — LectureStorage2// File: Packages/LectureStorage/Sources/Library.swift3// Description: Library of lecture projects on disk: listing, search, create, duplicate, rename, archive, recoverable trash, portable archives.4//5// Author: Simon-Pierre Boucher6// Contact: contact@spboucher.ai7import Foundation8import LectureCore910public struct LibraryItem: Sendable, Hashable, Identifiable {11 public var package: ProjectPackage12 public var manifest: ProjectManifest13 public var byteCount: Int6414 public var needsRecovery: Bool15 public var id: UUID { manifest.id }16}1718public struct Library: Sendable {19 public let root: URL20 public var trashURL: URL { root.appendingPathComponent(".Trash", isDirectory: true) }2122 public init(root: URL) throws {23 self.root = root24 try FileManager.default.createDirectory(at: root, withIntermediateDirectories: true)25 }2627 /// Projects found in the library folder, most recently modified first. Unreadable packages are reported, never removed.28 public func scan(measureSize: Bool = true) -> (items: [LibraryItem], unreadable: [URL]) {29 let fm = FileManager.default30 var items: [LibraryItem] = [], bad: [URL] = []31 for u in (try? fm.contentsOfDirectory(at: root, includingPropertiesForKeys: nil, options: [.skipsHiddenFiles])) ?? [] where u.pathExtension == ProjectLayout.packageExtension {32 let pkg = ProjectPackage(url: u)33 if let m = try? pkg.loadManifest() {34 items.append(LibraryItem(package: pkg, manifest: m, byteCount: measureSize ? pkg.diskUsage() : 0,35 needsRecovery: ProjectRecovery.needsRecovery(pkg, manifest: m)))36 } else { bad.append(u) }37 }38 return (items.sorted { $0.manifest.modifiedAt > $1.manifest.modifiedAt }, bad)39 }4041 public static func matches(_ item: LibraryItem, query: String) -> Bool {42 let q = query.trimmingCharacters(in: .whitespaces).folding(options: [.diacriticInsensitive, .caseInsensitive], locale: nil)43 guard !q.isEmpty else { return true }44 let m = item.manifest45 var hay = [m.title, m.courseCode, m.publishingDestination, m.pdf?.originalName ?? ""]46 if let n = m.sessionNumber { hay.append(String(n)) }47 hay.append(contentsOf: m.notes.values)48 return hay.contains { $0.folding(options: [.diacriticInsensitive, .caseInsensitive], locale: nil).contains(q) }49 }5051 public func create(title: String, courseCode: String = "", sessionNumber: Int? = nil, lectureDate: Date = Date(),52 pdf: URL?, pdfPageCount: Int) throws -> ProjectPackage {53 let m = ProjectManifest(title: title, courseCode: courseCode, sessionNumber: sessionNumber, lectureDate: lectureDate)54 return try ProjectPackage.create(in: root, manifest: m, pdf: pdf, pdfPageCount: pdfPageCount)55 }5657 /// Full copy with a new identity. Recordings and edits are copied too.58 public func duplicate(_ package: ProjectPackage, titleSuffix: String) throws -> ProjectPackage {59 var m = try package.loadManifest()60 let dest = ProjectPackage(url: ProjectPackage.uniqueURL(in: root, baseName: ProjectPackage.safeFileName(m.title + " " + titleSuffix)))61 try FileManager.default.copyItem(at: package.url, to: dest.url)62 m.id = UUID(); m.title += " " + titleSuffix; m.createdAt = Date(); m.exports = []63 try dest.saveManifest(m)64 return dest65 }6667 /// Renames the lecture; the package folder follows the title when possible.68 public func rename(_ package: ProjectPackage, to title: String) throws -> ProjectPackage {69 var m = try package.loadManifest()70 m.title = title71 try package.saveManifest(m)72 let wanted = ProjectPackage.safeFileName(title)73 guard package.url.deletingPathExtension().lastPathComponent != wanted else { return package }74 let dest = ProjectPackage.uniqueURL(in: package.url.deletingLastPathComponent(), baseName: wanted)75 do { try FileManager.default.moveItem(at: package.url, to: dest); return ProjectPackage(url: dest) } catch { return package }76 }7778 public func setArchived(_ package: ProjectPackage, _ archived: Bool) throws {79 var m = try package.loadManifest(); m.archived = archived; try package.saveManifest(m)80 }8182 /// Moves a project to the library trash. Nothing is erased until `emptyTrash()` is called explicitly.83 @discardableResult84 public func moveToTrash(_ package: ProjectPackage) throws -> URL {85 let fm = FileManager.default86 try fm.createDirectory(at: trashURL, withIntermediateDirectories: true)87 let dest = ProjectPackage.uniqueURL(in: trashURL, baseName: package.url.deletingPathExtension().lastPathComponent)88 try fm.moveItem(at: package.url, to: dest)89 return dest90 }9192 public func trashedProjects() -> [LibraryItem] {93 let urls = (try? FileManager.default.contentsOfDirectory(at: trashURL, includingPropertiesForKeys: nil)) ?? []94 return urls.filter { $0.pathExtension == ProjectLayout.packageExtension }.compactMap { u in95 let pkg = ProjectPackage(url: u)96 return (try? pkg.loadManifest()).map { LibraryItem(package: pkg, manifest: $0, byteCount: pkg.diskUsage(), needsRecovery: false) }97 }98 }99100 @discardableResult101 public func restoreFromTrash(_ package: ProjectPackage) throws -> ProjectPackage {102 let dest = ProjectPackage.uniqueURL(in: root, baseName: package.url.deletingPathExtension().lastPathComponent)103 try FileManager.default.moveItem(at: package.url, to: dest)104 return ProjectPackage(url: dest)105 }106107 /// Permanently erases the trash. Only ever called from an explicit, confirmed user action.108 public func emptyTrash() throws {109 if FileManager.default.fileExists(atPath: trashURL.path) { try FileManager.default.removeItem(at: trashURL) }110 }111112 public func totalUsage() -> Int64 { ProjectPackage.directorySize(root) }113114 // MARK: Portable archives115116 /// Writes a single-file `.slecture.zip` holding the whole package (caches excluded unless `includeCaches`).117 public static func exportArchive(_ package: ProjectPackage, to destination: URL, includeCaches: Bool = false, progress: ((Double) -> Bool)? = nil) throws {118 try ZipArchive.create(at: destination, fromDirectory: package.url, rootName: package.url.lastPathComponent,119 exclude: { rel in (!includeCaches && rel.hasPrefix(ProjectLayout.cacheDirectory)) || rel.hasPrefix(ProjectLayout.exportsDirectory + "/") || rel.hasSuffix(".DS_Store") },120 progress: progress)121 }122123 /// Imports a `.slecture` package folder or a `.slecture.zip` archive into the library (always as a copy).124 /// A project whose identifier already exists is imported under a new identifier so that nothing is overwritten.125 public func importProject(from source: URL, progress: ((Double) -> Bool)? = nil) throws -> ProjectPackage {126 let fm = FileManager.default127 var isDir: ObjCBool = false128 guard fm.fileExists(atPath: source.path, isDirectory: &isDir) else { throw StorageError.io("missing \(source.lastPathComponent)") }129 let staging = root.appendingPathComponent(".import-\(UUID().uuidString)", isDirectory: true)130 defer { try? fm.removeItem(at: staging) }131 var found: URL132 if isDir.boolValue {133 found = source134 } else {135 try ZipArchive.extract(source, to: staging, progress: progress)136 guard let pkg = Self.findPackage(in: staging) else { throw StorageError.notAPackage(source.lastPathComponent) }137 found = pkg138 }139 var manifest = try ProjectPackage(url: found).loadManifest()140 let dest = ProjectPackage(url: ProjectPackage.uniqueURL(in: root, baseName: ProjectPackage.safeFileName(manifest.title)))141 if isDir.boolValue { try fm.copyItem(at: found, to: dest.url) } else { try fm.moveItem(at: found, to: dest.url) }142 for dir in [ProjectLayout.mediaDirectory, ProjectLayout.cacheDirectory, ProjectLayout.thumbnailsDirectory, ProjectLayout.exportsDirectory] {143 try fm.createDirectory(at: dest.url(dir), withIntermediateDirectories: true)144 }145 if scan(measureSize: false).items.contains(where: { $0.manifest.id == manifest.id && $0.package != dest }) {146 manifest.id = UUID(); try dest.saveManifest(manifest)147 }148 return dest149 }150151 static func findPackage(in directory: URL) -> URL? {152 let fm = FileManager.default153 if fm.fileExists(atPath: directory.appendingPathComponent(ProjectLayout.manifest).path) { return directory }154 guard let e = fm.enumerator(at: directory, includingPropertiesForKeys: nil) else { return nil }155 for case let u as URL in e where u.lastPathComponent == ProjectLayout.manifest { return u.deletingLastPathComponent() }156 return nil157 }158}159