SPB Git

Repository Public

Project.swift 7.3 KB 159 lines swift

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

Theme