Repository Public
1// SP Lecture Studio — LectureCore2// File: Packages/LectureCore/Sources/Project.swift3// Description: Versioned project manifest of a .slecture package (metadata, PDF reference, recording sessions, media segments, exports).4//5// Author: Simon-Pierre Boucher6// Contact: contact@spboucher.ai7import Foundation89public struct PDFSource: Hashable, Sendable, Codable {10 /// Path relative to the package root.11 public var path: String12 public var originalName: String13 public var sha256: String14 public var byteCount: Int6415 public var pageCount: Int16 public init(path: String, originalName: String, sha256: String, byteCount: Int64, pageCount: Int) {17 self.path = path; self.originalName = originalName; self.sha256 = sha256; self.byteCount = byteCount; self.pageCount = pageCount18 }19}2021public struct MediaSegment: Hashable, Sendable, Codable, Identifiable {22 public var id: UUID23 public var kind: MediaKind24 /// Path relative to the package root.25 public var path: String26 public var index: Int27 /// Position of the first sample / frame on the project timeline.28 public var start: MediaTime29 public var duration: MediaTime30 public var sampleRate: Double31 public var channels: Int32 public var frames: Int6433 public var sha256: String?34 /// False while the file is being written. Only finalized segments are trusted without validation.35 public var finalized: Bool36 /// True when the segment was found on disk and re-attached by crash recovery.37 public var recovered: Bool38 public init(id: UUID = UUID(), kind: MediaKind, path: String, index: Int, start: MediaTime, duration: MediaTime,39 sampleRate: Double = 0, channels: Int = 0, frames: Int64 = 0, sha256: String? = nil, finalized: Bool, recovered: Bool = false) {40 self.id = id; self.kind = kind; self.path = path; self.index = index; self.start = start; self.duration = duration41 self.sampleRate = sampleRate; self.channels = channels; self.frames = frames; self.sha256 = sha25642 self.finalized = finalized; self.recovered = recovered43 }44 public var range: TimeRange { TimeRange(start: start, duration: duration) }45}4647public struct RecordingSession: Hashable, Sendable, Codable, Identifiable {48 public var id: UUID49 public var startedAt: Date50 public var endedAt: Date?51 /// Timeline time at which this session begins (sessions are appended one after the other).52 public var timelineStart: MediaTime53 public var duration: MediaTime54 public var segments: [MediaSegment]55 /// True when the session did not end cleanly and was closed by recovery.56 public var recovered: Bool57 public var audioOnly: Bool58 public init(id: UUID = UUID(), startedAt: Date = Date(), timelineStart: MediaTime) {59 self.id = id; self.startedAt = startedAt; self.endedAt = nil; self.timelineStart = timelineStart60 self.duration = .zero; self.segments = []; self.recovered = false; self.audioOnly = false61 }62 public var shortID: String { String(id.uuidString.prefix(8)).lowercased() }63}6465public struct ExportRecord: Hashable, Sendable, Codable, Identifiable {66 public var id: UUID67 public var date: Date68 public var kind: String // "video", "pdf", "captions", "archive", …69 public var fileName: String70 public var detail: String71 public var byteCount: Int6472 public init(id: UUID = UUID(), date: Date = Date(), kind: String, fileName: String, detail: String, byteCount: Int64) {73 self.id = id; self.date = date; self.kind = kind; self.fileName = fileName; self.detail = detail; self.byteCount = byteCount74 }75}7677public struct ProjectManifest: Hashable, Sendable, Codable, Identifiable {78 public static let currentSchema = 279 public var schemaVersion: Int80 public var id: UUID81 public var title: String82 public var courseCode: String83 public var sessionNumber: Int?84 public var lectureDate: Date85 public var createdAt: Date86 public var modifiedAt: Date87 public var archived: Bool88 public var coverPage: Int89 public var publishingDestination: String90 /// Presenter notes keyed by zero-based page index.91 public var notes: [Int: String]92 public var pdf: PDFSource?93 public var sessions: [RecordingSession]94 /// Total length of the recorded timeline.95 public var duration: MediaTime96 /// Page shown when the project was last closed.97 public var lastPage: Int98 public var exports: [ExportRecord]99 public var createdWith: String100101 public init(id: UUID = UUID(), title: String, courseCode: String = "", sessionNumber: Int? = nil, lectureDate: Date = Date()) {102 schemaVersion = Self.currentSchema; self.id = id; self.title = title; self.courseCode = courseCode103 self.sessionNumber = sessionNumber; self.lectureDate = lectureDate; createdAt = Date(); modifiedAt = Date()104 archived = false; coverPage = 0; publishingDestination = ""; notes = [:]; pdf = nil; sessions = []105 duration = .zero; lastPage = 0; exports = []; createdWith = "SP Lecture Studio"106 }107108 public func segments(_ kind: MediaKind) -> [MediaSegment] {109 sessions.flatMap(\.segments).filter { $0.kind == kind }.sorted { $0.start < $1.start }110 }111 public var hasRecording: Bool { duration > .zero }112113 public mutating func recomputeDuration() {114 var cursor = MediaTime.zero115 for i in sessions.indices {116 let audioEnd = sessions[i].segments.filter { $0.kind == .audio }.map { $0.start + $0.duration }.max()117 if let audioEnd { sessions[i].duration = max(sessions[i].duration, audioEnd - sessions[i].timelineStart) }118 cursor = max(cursor, sessions[i].timelineStart + sessions[i].duration)119 }120 duration = cursor121 }122123 /// Subtitle such as "IMM1003 · Séance 8".124 public func subtitle(sessionWord: String) -> String {125 var parts: [String] = []126 if !courseCode.isEmpty { parts.append(courseCode) }127 if let n = sessionNumber { parts.append("\(sessionWord) \(n)") }128 return parts.joined(separator: " · ")129 }130}131132public enum ProjectLayout {133 public static let packageExtension = "slecture"134 public static let manifest = "manifest.json"135 public static let events = "events.jsonl"136 public static let edits = "edits.json"137 public static let transcript = "transcript.json"138 public static let pdfDirectory = "pdf"139 public static let pdfFile = "pdf/source.pdf"140 public static let mediaDirectory = "media"141 public static let cacheDirectory = "cache"142 public static let waveform = "cache/waveform.json"143 public static let thumbnailsDirectory = "cache/thumbnails"144 public static let exportsDirectory = "exports"145146 public static func segmentFileName(kind: MediaKind, session: RecordingSession, index: Int) -> String {147 let ext = kind == .audio ? "caf" : "mov"148 return String(format: "%@-%@-%05d.%@", kind.rawValue, session.shortID, index, ext)149 }150151 /// Parses `audio-1a2b3c4d-00012.caf` → (kind, session short id, index).152 public static func parseSegmentFileName(_ name: String) -> (kind: MediaKind, session: String, index: Int)? {153 let base = (name as NSString).deletingPathExtension154 let parts = base.split(separator: "-")155 guard parts.count == 3, let kind = MediaKind(rawValue: String(parts[0])), let index = Int(parts[2]) else { return nil }156 return (kind, String(parts[1]), index)157 }158}159