import Foundation /// One appointment for the iCalendar export. The start is written as a /// floating local time so calendar applications show the parish's wall-clock /// time regardless of the device time zone. public struct CalendarEvent: Hashable, Sendable { public var uid: String public var start: Date public var durationMinutes: Int public var summary: String public var location: String public var description: String public init( uid: String, start: Date, durationMinutes: Int = 60, summary: String, location: String = "", description: String = "" ) { self.uid = uid self.start = start self.durationMinutes = durationMinutes self.summary = summary self.location = location self.description = description } } /// Builds a published iCalendar document with one timed VEVENT per assignment. public enum CalendarExport { /// Returns a complete `.ics` document in RFC 5545 format. public static func ics( calendarName: String, events: [CalendarEvent], generatedAt: Date = Date() ) -> String { let sorted = events.sorted { $0.start < $1.start } var output = "" appendLine("BEGIN:VCALENDAR", to: &output) appendLine("VERSION:2.0", to: &output) appendLine("PRODID:-//LektorenPlan//Gottesdienstplan//DE", to: &output) appendLine("CALSCALE:GREGORIAN", to: &output) appendLine("METHOD:PUBLISH", to: &output) appendLine("X-WR-CALNAME:\(escape(calendarName))", to: &output) let stamp = utcFormatter.string(from: generatedAt) for event in sorted { let duration = event.durationMinutes > 0 ? event.durationMinutes : 60 let end = event.start.addingTimeInterval(TimeInterval(duration * 60)) appendLine("BEGIN:VEVENT", to: &output) appendLine("UID:\(escape(event.uid))@lektorenplan", to: &output) appendLine("DTSTAMP:\(stamp)", to: &output) appendLine("DTSTART:\(localFormatter.string(from: event.start))", to: &output) appendLine("DTEND:\(localFormatter.string(from: end))", to: &output) appendLine("SUMMARY:\(escape(event.summary))", to: &output) let location = event.location.trimmingCharacters(in: .whitespacesAndNewlines) if !location.isEmpty { appendLine("LOCATION:\(escape(location))", to: &output) } let description = event.description.trimmingCharacters(in: .whitespacesAndNewlines) if !description.isEmpty { appendLine("DESCRIPTION:\(escape(description))", to: &output) } appendLine("END:VEVENT", to: &output) } appendLine("END:VCALENDAR", to: &output) return output } /// A filesystem-safe attachment name, for example /// `LektorenPlan-bad-godesberg-Kalender-2026-03-01.ics`. public static func filename(prefix: String, start: Date) -> String { var base = "LektorenPlan" let trimmed = prefix.trimmingCharacters(in: .whitespacesAndNewlines) if !trimmed.isEmpty { base += "-" + sanitizedComponent(trimmed) } return "\(base)-Kalender-\(DayMath.key(start)).ics" } private static func sanitizedComponent(_ value: String) -> String { let allowed = CharacterSet.alphanumerics.union(CharacterSet(charactersIn: "-_")) let folded = value.folding(options: .diacriticInsensitive, locale: .current) return folded .replacingOccurrences(of: " ", with: "-") .components(separatedBy: allowed.inverted) .joined() } private static let localFormatter: DateFormatter = { let formatter = DateFormatter() formatter.locale = Locale(identifier: "en_US_POSIX") formatter.timeZone = DayMath.calendar.timeZone formatter.dateFormat = "yyyyMMdd'T'HHmmss" return formatter }() private static let utcFormatter: DateFormatter = { let formatter = DateFormatter() formatter.locale = Locale(identifier: "en_US_POSIX") formatter.timeZone = TimeZone(identifier: "UTC") formatter.dateFormat = "yyyyMMdd'T'HHmmss'Z'" return formatter }() /// Appends one content line and folds it at 75 octets as required by RFC 5545. private static func appendLine(_ line: String, to output: inout String) { let limit = 75 var used = 0 for character in line { let width = String(character).utf8.count if used + width > limit { output += "\r\n " used = 1 } output.append(character) used += width } output += "\r\n" } /// Applies the TEXT escaping rules of RFC 5545. private static func escape(_ value: String) -> String { var escaped = value.replacingOccurrences(of: "\\", with: "\\\\") escaped = escaped.replacingOccurrences(of: ";", with: "\\;") escaped = escaped.replacingOccurrences(of: ",", with: "\\,") escaped = escaped.replacingOccurrences(of: "\r\n", with: "\\n") escaped = escaped.replacingOccurrences(of: "\n", with: "\\n") escaped = escaped.replacingOccurrences(of: "\r", with: "\\n") return escaped } }