itip.rs
| 1 | //! Implicit scheduling: what organizer and attendee changes send, and how |
| 2 | //! the copies change. |
| 3 | |
| 4 | use chrono::{TimeZone, Utc}; |
| 5 | use pimdav::calcard::icalendar::ICalendar; |
| 6 | use pimdav::itip::{self, Message, Method, Refused, Role}; |
| 7 | |
| 8 | const ALICE: &str = "mailto:alice@dovenest.invalid"; |
| 9 | const BOB: &str = "mailto:bob@dovenest.invalid"; |
| 10 | const CAROL: &str = "mailto:carol@example.com"; |
| 11 | |
| 12 | fn is(who: &'static str) -> impl Fn(&str) -> bool { |
| 13 | move |a: &str| a.eq_ignore_ascii_case(who) |
| 14 | } |
| 15 | |
| 16 | fn cal(body: &str) -> ICalendar { |
| 17 | let text = format!( |
| 18 | "BEGIN:VCALENDAR\r\nVERSION:2.0\r\nPRODID:-//t//EN\r\n{}END:VCALENDAR\r\n", |
| 19 | body.replace('\n', "\r\n") |
| 20 | ); |
| 21 | ICalendar::parse(&text).unwrap() |
| 22 | } |
| 23 | |
| 24 | /// A weekly event organized by alice, with the given extra lines. |
| 25 | fn meeting(extra: &str) -> ICalendar { |
| 26 | cal(&format!( |
| 27 | "BEGIN:VEVENT |
| 28 | UID:m1 |
| 29 | DTSTAMP:20260101T000000Z |
| 30 | DTSTART:20260105T100000Z |
| 31 | DTEND:20260105T110000Z |
| 32 | RRULE:FREQ=WEEKLY;COUNT=4 |
| 33 | SUMMARY:Sync |
| 34 | ORGANIZER:{ALICE} |
| 35 | ATTENDEE;PARTSTAT=ACCEPTED:{ALICE} |
| 36 | {extra}END:VEVENT |
| 37 | " |
| 38 | )) |
| 39 | } |
| 40 | |
| 41 | fn now() -> chrono::DateTime<Utc> { |
| 42 | Utc.with_ymd_and_hms(2026, 1, 2, 12, 0, 0).unwrap() |
| 43 | } |
| 44 | |
| 45 | fn text(c: &ICalendar) -> String { |
| 46 | c.to_string().replace("\r\n ", "") |
| 47 | } |
| 48 | |
| 49 | fn to<'a>(msgs: &'a [Message], who: &str) -> Option<&'a Message> { |
| 50 | msgs.iter().find(|m| m.to.eq_ignore_ascii_case(who)) |
| 51 | } |
| 52 | |
| 53 | #[test] |
| 54 | fn roles() { |
| 55 | let m = meeting(&format!("ATTENDEE:{BOB}\n")); |
| 56 | assert_eq!(itip::role(&m, &is(ALICE)), Ok(Role::Organizer)); |
| 57 | assert_eq!(itip::role(&m, &is(BOB)), Ok(Role::Attendee)); |
| 58 | assert_eq!(itip::role(&m, &is(CAROL)), Ok(Role::None)); |
| 59 | let split = cal(&format!( |
| 60 | "BEGIN:VEVENT\nUID:x\nDTSTART:20260105T100000Z\nORGANIZER:{ALICE}\nEND:VEVENT\n\ |
| 61 | BEGIN:VEVENT\nUID:x\nRECURRENCE-ID:20260112T100000Z\nDTSTART:20260112T100000Z\nORGANIZER:{BOB}\nEND:VEVENT\n" |
| 62 | )); |
| 63 | assert_eq!(itip::role(&split, &is(ALICE)), Err(Refused::SameOrganizer)); |
| 64 | } |
| 65 | |
| 66 | #[test] |
| 67 | fn invite() { |
| 68 | // The client claims bob accepted; only bob can say that. |
| 69 | let new = cal(&format!( |
| 70 | "BEGIN:VEVENT |
| 71 | UID:m1 |
| 72 | DTSTAMP:20260101T000000Z |
| 73 | DTSTART:20260105T100000Z |
| 74 | SUMMARY:Sync |
| 75 | ORGANIZER:{ALICE} |
| 76 | ATTENDEE;PARTSTAT=ACCEPTED:{ALICE} |
| 77 | ATTENDEE;PARTSTAT=ACCEPTED;SCHEDULE-STATUS=1.2:{BOB} |
| 78 | ATTENDEE;SCHEDULE-AGENT=CLIENT;PARTSTAT=ACCEPTED:{CAROL} |
| 79 | BEGIN:VALARM |
| 80 | ACTION:DISPLAY |
| 81 | TRIGGER:-PT5M |
| 82 | END:VALARM |
| 83 | END:VEVENT |
| 84 | " |
| 85 | )); |
| 86 | let (store, msgs) = itip::organize(None, Some(new), &is(ALICE), now()); |
| 87 | let store = text(&store.unwrap()); |
| 88 | assert!( |
| 89 | store.contains(&format!("ATTENDEE;PARTSTAT=NEEDS-ACTION:{BOB}")), |
| 90 | "{store}" |
| 91 | ); |
| 92 | assert!( |
| 93 | store.contains("SCHEDULE-AGENT=CLIENT;PARTSTAT=ACCEPTED"), |
| 94 | "{store}" |
| 95 | ); |
| 96 | // Nothing to alice herself or to the attendee the client schedules. |
| 97 | assert_eq!(msgs.len(), 1); |
| 98 | let m = to(&msgs, BOB).unwrap(); |
| 99 | assert_eq!(m.method, Method::Request); |
| 100 | let body = text(&m.cal); |
| 101 | assert!(body.contains("METHOD:REQUEST")); |
| 102 | assert!(body.contains("DTSTAMP:20260102T120000Z")); |
| 103 | assert!(!body.contains("VALARM")); |
| 104 | assert!(!body.contains("SCHEDULE-"), "{body}"); |
| 105 | } |
| 106 | |
| 107 | #[test] |
| 108 | fn reschedule_resets_participation() { |
| 109 | let old = meeting(&format!( |
| 110 | "ATTENDEE;PARTSTAT=ACCEPTED;SCHEDULE-STATUS=2.0:{BOB}\n" |
| 111 | )); |
| 112 | // A new title keeps bob's answer, even from a client with a stale copy. |
| 113 | let retitled = text(&meeting(&format!("ATTENDEE;PARTSTAT=NEEDS-ACTION:{BOB}\n"))) |
| 114 | .replace("SUMMARY:Sync", "SUMMARY:Weekly sync"); |
| 115 | let (store, msgs) = itip::organize( |
| 116 | Some(&old), |
| 117 | Some(ICalendar::parse(&retitled).unwrap()), |
| 118 | &is(ALICE), |
| 119 | now(), |
| 120 | ); |
| 121 | let store = text(&store.unwrap()); |
| 122 | assert!( |
| 123 | store.contains(&format!("PARTSTAT=ACCEPTED;SCHEDULE-STATUS=2.0:{BOB}")), |
| 124 | "{store}" |
| 125 | ); |
| 126 | assert!(!to(&msgs, BOB).unwrap().quiet); |
| 127 | |
| 128 | let moved = text(&old).replace("DTSTART:20260105T100000Z", "DTSTART:20260105T090000Z"); |
| 129 | let (store, msgs) = itip::organize( |
| 130 | Some(&old), |
| 131 | Some(ICalendar::parse(&moved).unwrap()), |
| 132 | &is(ALICE), |
| 133 | now(), |
| 134 | ); |
| 135 | let store = text(&store.unwrap()); |
| 136 | assert!(store.contains("PARTSTAT=NEEDS-ACTION"), "{store}"); |
| 137 | assert!(store.contains("SEQUENCE:1"), "{store}"); |
| 138 | assert!(text(&to(&msgs, BOB).unwrap().cal).contains("DTSTART:20260105T090000Z")); |
| 139 | |
| 140 | // Shortening the series is no reschedule. |
| 141 | let shorter = text(&old).replace("COUNT=4", "COUNT=2"); |
| 142 | let (store, _) = itip::organize( |
| 143 | Some(&old), |
| 144 | Some(ICalendar::parse(&shorter).unwrap()), |
| 145 | &is(ALICE), |
| 146 | now(), |
| 147 | ); |
| 148 | assert!( |
| 149 | text(&store.unwrap()).contains(&format!("PARTSTAT=ACCEPTED;SCHEDULE-STATUS=2.0:{BOB}")) |
| 150 | ); |
| 151 | } |
| 152 | |
| 153 | #[test] |
| 154 | fn unchanged_or_forced() { |
| 155 | let old = meeting(&format!("ATTENDEE;PARTSTAT=ACCEPTED:{BOB}\n")); |
| 156 | let resaved = text(&old) |
| 157 | .replace("DTSTAMP:20260101T000000Z", "DTSTAMP:20260101T080000Z") |
| 158 | .replace("SUMMARY:Sync", "SUMMARY:Sync\r\nX-MOZ-GENERATION:3"); |
| 159 | let (_, msgs) = itip::organize( |
| 160 | Some(&old), |
| 161 | Some(ICalendar::parse(&resaved).unwrap()), |
| 162 | &is(ALICE), |
| 163 | now(), |
| 164 | ); |
| 165 | assert!(msgs.is_empty(), "{msgs:?}"); |
| 166 | let forced = text(&old).replace( |
| 167 | "ATTENDEE;PARTSTAT=ACCEPTED:mailto:bob", |
| 168 | "ATTENDEE;SCHEDULE-FORCE-SEND=REQUEST;PARTSTAT=ACCEPTED:mailto:bob", |
| 169 | ); |
| 170 | let (store, msgs) = itip::organize( |
| 171 | Some(&old), |
| 172 | Some(ICalendar::parse(&forced).unwrap()), |
| 173 | &is(ALICE), |
| 174 | now(), |
| 175 | ); |
| 176 | assert!(!text(&store.unwrap()).contains("FORCE-SEND")); |
| 177 | assert_eq!(to(&msgs, BOB).unwrap().method, Method::Request); |
| 178 | } |
| 179 | |
| 180 | #[test] |
| 181 | fn removed_attendee_and_delete_cancel() { |
| 182 | let old = meeting(&format!("ATTENDEE:{BOB}\nATTENDEE:{CAROL}\n")); |
| 183 | let (_, msgs) = itip::organize( |
| 184 | Some(&old), |
| 185 | Some(meeting(&format!("ATTENDEE:{BOB}\n"))), |
| 186 | &is(ALICE), |
| 187 | now(), |
| 188 | ); |
| 189 | let cancel = to(&msgs, CAROL).unwrap(); |
| 190 | assert_eq!(cancel.method, Method::Cancel); |
| 191 | assert!(text(&cancel.cal).contains("STATUS:CANCELLED")); |
| 192 | // The attendee list changed for bob too. |
| 193 | assert_eq!(to(&msgs, BOB).unwrap().method, Method::Request); |
| 194 | |
| 195 | let (store, msgs) = itip::organize(Some(&old), None, &is(ALICE), now()); |
| 196 | assert!(store.is_none()); |
| 197 | assert!(msgs.iter().all(|m| m.method == Method::Cancel)); |
| 198 | assert_eq!(msgs.len(), 2); |
| 199 | } |
| 200 | |
| 201 | #[test] |
| 202 | fn instances_only_reach_their_attendees() { |
| 203 | let old = cal(&format!( |
| 204 | "BEGIN:VEVENT |
| 205 | UID:m1 |
| 206 | DTSTART:20260105T100000Z |
| 207 | RRULE:FREQ=WEEKLY;COUNT=4 |
| 208 | ORGANIZER:{ALICE} |
| 209 | ATTENDEE:{BOB} |
| 210 | ATTENDEE:{CAROL} |
| 211 | END:VEVENT |
| 212 | BEGIN:VEVENT |
| 213 | UID:m1 |
| 214 | RECURRENCE-ID:20260112T100000Z |
| 215 | DTSTART:20260112T140000Z |
| 216 | ORGANIZER:{ALICE} |
| 217 | ATTENDEE:{BOB} |
| 218 | END:VEVENT |
| 219 | " |
| 220 | )); |
| 221 | let (_, msgs) = itip::organize(None, Some(old), &is(ALICE), now()); |
| 222 | let carol = text(&to(&msgs, CAROL).unwrap().cal); |
| 223 | assert!(carol.contains("EXDATE:20260112T100000Z"), "{carol}"); |
| 224 | assert!(!carol.contains("RECURRENCE-ID"), "{carol}"); |
| 225 | let bob = text(&to(&msgs, BOB).unwrap().cal); |
| 226 | assert!( |
| 227 | bob.contains("RECURRENCE-ID:20260112T100000Z") && !bob.contains("EXDATE"), |
| 228 | "{bob}" |
| 229 | ); |
| 230 | } |
| 231 | |
| 232 | #[test] |
| 233 | fn accept_and_apply_reply() { |
| 234 | let org = meeting(&format!("ATTENDEE;PARTSTAT=NEEDS-ACTION:{BOB}\n")); |
| 235 | let (_, msgs) = itip::organize(None, Some(org.clone()), &is(ALICE), now()); |
| 236 | let copy = itip::receive(None, to(&msgs, BOB).unwrap()).unwrap(); |
| 237 | assert!(!text(©).contains("METHOD")); |
| 238 | |
| 239 | let accepted = text(©).replace( |
| 240 | &format!("ATTENDEE;PARTSTAT=NEEDS-ACTION:{BOB}"), |
| 241 | &format!("ATTENDEE;PARTSTAT=ACCEPTED:{BOB}"), |
| 242 | ); |
| 243 | let (_, reply) = |
| 244 | itip::attend(©, ICalendar::parse(&accepted).unwrap(), &is(BOB), now()).unwrap(); |
| 245 | let reply = reply.unwrap(); |
| 246 | assert_eq!((reply.method, reply.to.as_str()), (Method::Reply, ALICE)); |
| 247 | let body = text(&reply.cal); |
| 248 | assert!(body.contains("METHOD:REPLY"), "{body}"); |
| 249 | assert!( |
| 250 | !body.contains(&format!("ATTENDEE;PARTSTAT=ACCEPTED:{ALICE}")), |
| 251 | "{body}" |
| 252 | ); |
| 253 | |
| 254 | let mut org = org; |
| 255 | assert!(itip::apply_reply(&mut org, &reply.cal, &is(BOB))); |
| 256 | let org = text(&org); |
| 257 | assert!( |
| 258 | org.contains(&format!("PARTSTAT=ACCEPTED;SCHEDULE-STATUS=2.0:{BOB}")), |
| 259 | "{org}" |
| 260 | ); |
| 261 | } |
| 262 | |
| 263 | #[test] |
| 264 | fn declining_one_instance() { |
| 265 | let org = meeting(&format!("ATTENDEE;PARTSTAT=ACCEPTED:{BOB}\n")); |
| 266 | let copy = org.clone(); |
| 267 | // bob overrides the second week to decline it. |
| 268 | let with_override = format!( |
| 269 | "{}BEGIN:VEVENT\r\nUID:m1\r\nRECURRENCE-ID:20260112T100000Z\r\nDTSTART:20260112T100000Z\r\nDTEND:20260112T110000Z\r\nSUMMARY:Sync\r\nORGANIZER:{ALICE}\r\nATTENDEE;PARTSTAT=ACCEPTED:{ALICE}\r\nATTENDEE;PARTSTAT=DECLINED:{BOB}\r\nEND:VEVENT\r\nEND:VCALENDAR\r\n", |
| 270 | text(©).trim_end_matches("END:VCALENDAR\r\n") |
| 271 | ); |
| 272 | let (_, reply) = itip::attend( |
| 273 | ©, |
| 274 | ICalendar::parse(&with_override).unwrap(), |
| 275 | &is(BOB), |
| 276 | now(), |
| 277 | ) |
| 278 | .unwrap(); |
| 279 | let reply = reply.unwrap(); |
| 280 | assert!(text(&reply.cal).contains("RECURRENCE-ID:20260112T100000Z")); |
| 281 | let mut org = org; |
| 282 | assert!(itip::apply_reply(&mut org, &reply.cal, &is(BOB))); |
| 283 | let org_text = text(&org); |
| 284 | assert!( |
| 285 | org_text.contains("RECURRENCE-ID:20260112T100000Z"), |
| 286 | "{org_text}" |
| 287 | ); |
| 288 | assert!(org_text.contains("DURATION:PT1H"), "{org_text}"); |
| 289 | assert!( |
| 290 | org_text.contains(&format!("PARTSTAT=DECLINED;SCHEDULE-STATUS=2.0:{BOB}")), |
| 291 | "{org_text}" |
| 292 | ); |
| 293 | |
| 294 | // An EXDATE declines too. |
| 295 | let excluded = text(©).replace( |
| 296 | "RRULE:FREQ=WEEKLY;COUNT=4", |
| 297 | "RRULE:FREQ=WEEKLY;COUNT=4\r\nEXDATE:20260119T100000Z", |
| 298 | ); |
| 299 | let (_, reply) = |
| 300 | itip::attend(©, ICalendar::parse(&excluded).unwrap(), &is(BOB), now()).unwrap(); |
| 301 | let body = text(&reply.unwrap().cal); |
| 302 | assert!( |
| 303 | body.contains("RECURRENCE-ID:20260119T100000Z") && body.contains("PARTSTAT=DECLINED"), |
| 304 | "{body}" |
| 305 | ); |
| 306 | } |
| 307 | |
| 308 | #[test] |
| 309 | fn reply_for_a_missing_instance_adds_nothing() { |
| 310 | let reply = |rid: &str| { |
| 311 | cal(&format!( |
| 312 | "METHOD:REPLY |
| 313 | BEGIN:VEVENT |
| 314 | UID:m1 |
| 315 | DTSTAMP:20260101T000000Z |
| 316 | RECURRENCE-ID:{rid} |
| 317 | DTSTART:{rid} |
| 318 | ORGANIZER:{ALICE} |
| 319 | ATTENDEE;PARTSTAT=DECLINED:{BOB} |
| 320 | END:VEVENT |
| 321 | " |
| 322 | )) |
| 323 | }; |
| 324 | let mut org = meeting(&format!("ATTENDEE;PARTSTAT=ACCEPTED:{BOB}\n")); |
| 325 | // A Tuesday, and a Monday after COUNT ends. |
| 326 | for rid in ["20260113T100000Z", "20260202T100000Z"] { |
| 327 | assert!(!itip::apply_reply(&mut org, &reply(rid), &is(BOB)), "{rid}"); |
| 328 | } |
| 329 | assert!(itip::apply_reply( |
| 330 | &mut org, |
| 331 | &reply("20260112T100000Z"), |
| 332 | &is(BOB) |
| 333 | )); |
| 334 | } |
| 335 | |
| 336 | #[test] |
| 337 | fn attendees_may_not_move_the_meeting() { |
| 338 | let copy = meeting(&format!("ATTENDEE;PARTSTAT=NEEDS-ACTION:{BOB}\n")); |
| 339 | let moved = text(©).replace("DTSTART:20260105T100000Z", "DTSTART:20260105T120000Z"); |
| 340 | assert_eq!( |
| 341 | itip::attend(©, ICalendar::parse(&moved).unwrap(), &is(BOB), now()).err(), |
| 342 | Some(Refused::AttendeeChange) |
| 343 | ); |
| 344 | // Alarms and transparency are the attendee's. |
| 345 | let own = text(©).replace( |
| 346 | "SUMMARY:Sync", |
| 347 | "SUMMARY:Sync\r\nTRANSP:TRANSPARENT\r\nBEGIN:VALARM\r\nACTION:DISPLAY\r\nTRIGGER:-PT5M\r\nEND:VALARM", |
| 348 | ); |
| 349 | let (_, reply) = itip::attend(©, ICalendar::parse(&own).unwrap(), &is(BOB), now()).unwrap(); |
| 350 | assert!(reply.is_none()); |
| 351 | } |
| 352 | |
| 353 | #[test] |
| 354 | fn attendee_delete_declines() { |
| 355 | let copy = meeting(&format!("ATTENDEE;PARTSTAT=ACCEPTED:{BOB}\n")); |
| 356 | let reply = itip::decline(©, &is(BOB), now()).unwrap(); |
| 357 | assert!(text(&reply.cal).contains(&format!("PARTSTAT=DECLINED:{BOB}"))); |
| 358 | let client = text(©).replace( |
| 359 | &format!("ORGANIZER:{ALICE}"), |
| 360 | &format!("ORGANIZER;SCHEDULE-AGENT=CLIENT:{ALICE}"), |
| 361 | ); |
| 362 | assert!(itip::decline(&ICalendar::parse(&client).unwrap(), &is(BOB), now()).is_none()); |
| 363 | } |
| 364 | |
| 365 | #[test] |
| 366 | fn updates_keep_what_the_attendee_owns() { |
| 367 | let org = meeting(&format!("ATTENDEE;PARTSTAT=ACCEPTED:{BOB}\n")); |
| 368 | let (_, msgs) = itip::organize(None, Some(org.clone()), &is(ALICE), now()); |
| 369 | let copy = itip::receive(None, to(&msgs, BOB).unwrap()).unwrap(); |
| 370 | let copy = ICalendar::parse(text(©).replace( |
| 371 | "SUMMARY:Sync", |
| 372 | "SUMMARY:Sync\r\nTRANSP:TRANSPARENT\r\nBEGIN:VALARM\r\nACTION:DISPLAY\r\nTRIGGER:-PT5M\r\nEND:VALARM", |
| 373 | )) |
| 374 | .unwrap(); |
| 375 | let retitled = |
| 376 | ICalendar::parse(text(&org).replace("SUMMARY:Sync", "SUMMARY:Planning")).unwrap(); |
| 377 | let (_, msgs) = itip::organize(Some(&org), Some(retitled), &is(ALICE), now()); |
| 378 | let updated = text(&itip::receive(Some(©), to(&msgs, BOB).unwrap()).unwrap()); |
| 379 | assert!( |
| 380 | updated.contains("SUMMARY:Planning") |
| 381 | && updated.contains("TRANSP:TRANSPARENT") |
| 382 | && updated.contains("TRIGGER:-PT5M"), |
| 383 | "{updated}" |
| 384 | ); |
| 385 | |
| 386 | let (_, msgs) = itip::organize(Some(&org), None, &is(ALICE), now()); |
| 387 | let cancelled = text(&itip::receive(Some(©), to(&msgs, BOB).unwrap()).unwrap()); |
| 388 | assert!(cancelled.contains("STATUS:CANCELLED"), "{cancelled}"); |
| 389 | } |
| 390 | |
| 391 | #[test] |
| 392 | fn sender_is_named_for_the_owner() { |
| 393 | let mut m = meeting(&format!("ATTENDEE:{BOB}\n")); |
| 394 | itip::stamp_sender(&mut m, &is(ALICE), Some(BOB)); |
| 395 | let got = text(&m); |
| 396 | assert!( |
| 397 | got.contains(&format!("ORGANIZER;SENT-BY=\"{BOB}\":{ALICE}")), |
| 398 | "{got}" |
| 399 | ); |
| 400 | assert!(!got.contains(&format!("SENT-BY=\"{BOB}\":{BOB}")), "{got}"); |
| 401 | // An edit by the owner drops it again. |
| 402 | itip::stamp_sender(&mut m, &is(ALICE), None); |
| 403 | assert!(!text(&m).contains("SENT-BY"), "{}", text(&m)); |
| 404 | |
| 405 | // Who sent it is no reason to message the attendees. |
| 406 | let old = meeting(&format!("ATTENDEE:{BOB}\n")); |
| 407 | let mut new = old.clone(); |
| 408 | itip::stamp_sender(&mut new, &is(ALICE), Some(BOB)); |
| 409 | let msgs = itip::messages(Some(&old), Some(&new), &is(ALICE), &[], now()); |
| 410 | assert!(msgs.is_empty(), "{msgs:?}"); |
| 411 | } |
| 412 | |
| 413 | #[test] |
| 414 | fn rooms_answer_from_their_bookings() { |
| 415 | use pimdav::freebusy::{Busy, Period}; |
| 416 | use pimdav::zone::Zone; |
| 417 | const ROOM: &str = "mailto:board@rooms.dovenest.invalid"; |
| 418 | let at = |d: u32, h: u32| Utc.with_ymd_and_hms(2026, 1, d, h, 0, 0).unwrap(); |
| 419 | // The weekly meeting runs on 5, 12, 19 and 26 January, 10:00 to 11:00. |
| 420 | let copy = meeting(&format!("ATTENDEE;PARTSTAT=NEEDS-ACTION:{ROOM}\n")); |
| 421 | let window = at(1, 0)..at(31, 0); |
| 422 | |
| 423 | let free = itip::auto_answer(©, &is(ROOM), &[], &window, &Zone::Utc); |
| 424 | assert!( |
| 425 | text(&free).contains(&format!("PARTSTAT=ACCEPTED:{ROOM}")), |
| 426 | "{}", |
| 427 | text(&free) |
| 428 | ); |
| 429 | |
| 430 | let taken = [Period { |
| 431 | kind: Busy::Busy, |
| 432 | start: at(12, 10), |
| 433 | end: at(12, 11), |
| 434 | }]; |
| 435 | let answer = itip::auto_answer(©, &is(ROOM), &taken, &window, &Zone::Utc); |
| 436 | let got = text(&answer); |
| 437 | assert!(got.contains("RECURRENCE-ID:20260112T100000Z"), "{got}"); |
| 438 | assert_eq!( |
| 439 | got.matches(&format!("PARTSTAT=DECLINED:{ROOM}")).count(), |
| 440 | 1, |
| 441 | "{got}" |
| 442 | ); |
| 443 | assert_eq!( |
| 444 | got.matches(&format!("PARTSTAT=ACCEPTED:{ROOM}")).count(), |
| 445 | 1, |
| 446 | "{got}" |
| 447 | ); |
| 448 | |
| 449 | // The answer travels as a REPLY for the series and the one instance. |
| 450 | let (_, reply) = itip::attend(©, answer, &is(ROOM), now()).unwrap(); |
| 451 | let reply = reply.unwrap(); |
| 452 | assert_eq!(reply.method, Method::Reply); |
| 453 | assert!(text(&reply.cal).contains("RECURRENCE-ID:20260112T100000Z")); |
| 454 | |
| 455 | // A single event on a taken slot is declined as a whole. |
| 456 | let single = cal(&format!( |
| 457 | "BEGIN:VEVENT\nUID:s1\nDTSTART:20260112T103000Z\nDURATION:PT1H\nORGANIZER:{ALICE}\n\ |
| 458 | ATTENDEE:{ROOM}\nEND:VEVENT\n" |
| 459 | )); |
| 460 | let got = text(&itip::auto_answer( |
| 461 | &single, |
| 462 | &is(ROOM), |
| 463 | &taken, |
| 464 | &window, |
| 465 | &Zone::Utc, |
| 466 | )); |
| 467 | assert!(got.contains(&format!("PARTSTAT=DECLINED:{ROOM}")), "{got}"); |
| 468 | } |
| 469 | |
| 470 | #[test] |
| 471 | fn forget_a_deleted_principal() { |
| 472 | let gone = is(BOB); |
| 473 | let tomb = "mailto:bob-7@deleted.dovenest.invalid"; |
| 474 | |
| 475 | // In alice's meeting bob becomes a tombstone that reaches no one. |
| 476 | let org = format!( |
| 477 | "BEGIN:VCALENDAR\r\nVERSION:2.0\r\nBEGIN:VEVENT\r\nUID:m1\r\nSUMMARY:Sync\r\nORGANIZER:{ALICE}\r\nATTENDEE;CN=Bob;PARTSTAT=ACCEPTED;SCHEDULE-STATUS=1.2:{BOB}\r\nATTENDEE:{CAROL}\r\nEND:VEVENT\r\nEND:VCALENDAR\r\n" |
| 478 | ); |
| 479 | let out = itip::forget(&org, &gone, tomb).unwrap(); |
| 480 | // The longer line is folded at 75 octets. |
| 481 | assert_eq!( |
| 482 | out.replace("\r\n ", ""), |
| 483 | org.replace( |
| 484 | &format!("ATTENDEE;CN=Bob;PARTSTAT=ACCEPTED;SCHEDULE-STATUS=1.2:{BOB}"), |
| 485 | &format!("ATTENDEE;CN=Bob;PARTSTAT=ACCEPTED;SCHEDULE-STATUS=3.7:{tomb}") |
| 486 | ) |
| 487 | ); |
| 488 | |
| 489 | // A copy of bob's meeting is cancelled, the override too; LF stays LF. |
| 490 | let copy = format!( |
| 491 | "BEGIN:VCALENDAR\nBEGIN:VEVENT\nUID:m2\nORGANIZER;CN=Bob:{}\nATTENDEE:{ALICE}\nEND:VEVENT\nBEGIN:VEVENT\nUID:m2\nRECURRENCE-ID:20260105T100000Z\nSTATUS:CONFIRMED\nORGANIZER:{BOB}\nEND:VEVENT\nEND:VCALENDAR\n", |
| 492 | BOB.to_uppercase() |
| 493 | ); |
| 494 | let out = itip::forget(©, &gone, tomb).unwrap(); |
| 495 | assert_eq!( |
| 496 | out, |
| 497 | format!( |
| 498 | "BEGIN:VCALENDAR\nBEGIN:VEVENT\nSTATUS:CANCELLED\nUID:m2\nORGANIZER;CN=Bob:{tomb}\nATTENDEE:{ALICE}\nEND:VEVENT\nBEGIN:VEVENT\nUID:m2\nRECURRENCE-ID:20260105T100000Z\nSTATUS:CANCELLED\nORGANIZER:{tomb}\nEND:VEVENT\nEND:VCALENDAR\n" |
| 499 | ) |
| 500 | ); |
| 501 | |
| 502 | assert_eq!( |
| 503 | itip::forget(&org, &is(CAROL.trim_end_matches('m')), tomb), |
| 504 | None |
| 505 | ); |
| 506 | } |
| 507 | |
| 508 | const ROOM: &str = "mailto:board@rooms.dovenest.invalid"; |
| 509 | |
| 510 | fn at(d: u32, h: u32) -> chrono::DateTime<Utc> { |
| 511 | Utc.with_ymd_and_hms(2026, 1, d, h, 0, 0).unwrap() |
| 512 | } |
| 513 | |
| 514 | fn booked(start: chrono::DateTime<Utc>, end: chrono::DateTime<Utc>) -> pimdav::freebusy::Period { |
| 515 | pimdav::freebusy::Period { |
| 516 | kind: pimdav::freebusy::Busy::Busy, |
| 517 | start, |
| 518 | end, |
| 519 | } |
| 520 | } |
| 521 | |
| 522 | #[test] |
| 523 | fn a_room_declines_a_series_with_many_conflicts_as_a_whole() { |
| 524 | use pimdav::zone::Zone; |
| 525 | let copy = cal(&format!( |
| 526 | "BEGIN:VEVENT\nUID:h1\nDTSTART:20260105T000000Z\nDURATION:PT30M\nRRULE:FREQ=HOURLY;COUNT=200\n\ |
| 527 | ORGANIZER:{ALICE}\nATTENDEE:{ROOM}\nEND:VEVENT\n" |
| 528 | )); |
| 529 | let taken = [booked(at(1, 0), at(31, 0))]; |
| 530 | let got = text(&itip::auto_answer( |
| 531 | ©, |
| 532 | &is(ROOM), |
| 533 | &taken, |
| 534 | &(at(1, 0)..at(31, 0)), |
| 535 | &Zone::Utc, |
| 536 | )); |
| 537 | assert!(!got.contains("RECURRENCE-ID"), "{got}"); |
| 538 | assert!(got.contains(&format!("PARTSTAT=DECLINED:{ROOM}")), "{got}"); |
| 539 | } |
| 540 | |
| 541 | #[test] |
| 542 | fn a_room_declines_one_instance_a_this_and_future_override_moves() { |
| 543 | use pimdav::zone::Zone; |
| 544 | // From the 12th on, the meeting runs two hours later. |
| 545 | let copy = cal(&format!( |
| 546 | "BEGIN:VEVENT\nUID:m1\nDTSTART:20260105T100000Z\nDTEND:20260105T110000Z\nRRULE:FREQ=WEEKLY;COUNT=4\n\ |
| 547 | ORGANIZER:{ALICE}\nATTENDEE:{ROOM}\nEND:VEVENT\n\ |
| 548 | BEGIN:VEVENT\nUID:m1\nRECURRENCE-ID;RANGE=THISANDFUTURE:20260112T100000Z\n\ |
| 549 | DTSTART:20260112T120000Z\nDTEND:20260112T130000Z\nORGANIZER:{ALICE}\nATTENDEE:{ROOM}\nEND:VEVENT\n" |
| 550 | )); |
| 551 | let taken = [booked(at(19, 12), at(19, 13))]; |
| 552 | let answer = itip::auto_answer(©, &is(ROOM), &taken, &(at(1, 0)..at(31, 0)), &Zone::Utc); |
| 553 | let got = text(&answer); |
| 554 | assert!( |
| 555 | got.contains("RECURRENCE-ID:20260119T100000Z\r\nDTSTART:20260119T120000Z") |
| 556 | || got.contains("DTSTART:20260119T120000Z\r\nRECURRENCE-ID:20260119T100000Z"), |
| 557 | "{got}" |
| 558 | ); |
| 559 | assert_eq!( |
| 560 | got.matches(&format!("PARTSTAT=DECLINED:{ROOM}")).count(), |
| 561 | 1, |
| 562 | "{got}" |
| 563 | ); |
| 564 | assert_eq!( |
| 565 | got.matches(&format!("PARTSTAT=ACCEPTED:{ROOM}")).count(), |
| 566 | 2, |
| 567 | "{got}" |
| 568 | ); |
| 569 | |
| 570 | // The moved override passes as the room's own answer, and the |
| 571 | // organizer's copy takes it. |
| 572 | let (_, reply) = itip::attend(©, answer, &is(ROOM), now()).unwrap(); |
| 573 | let mut org = copy.clone(); |
| 574 | assert!(itip::apply_reply(&mut org, &reply.unwrap().cal, &is(ROOM))); |
| 575 | let org = text(&org); |
| 576 | assert!(org.contains("DTSTART:20260119T120000Z"), "{org}"); |
| 577 | } |
| 578 | |
| 579 | #[test] |
| 580 | fn a_client_scheduled_attendee_gets_no_cancel() { |
| 581 | let old = meeting(&format!("ATTENDEE:{BOB}\n")); |
| 582 | let new = meeting(&format!("ATTENDEE;SCHEDULE-AGENT=CLIENT:{BOB}\n")); |
| 583 | let (_, msgs) = itip::organize(Some(&old), Some(new), &is(ALICE), now()); |
| 584 | assert!(to(&msgs, BOB).is_none(), "{msgs:?}"); |
| 585 | } |
| 586 | |
| 587 | #[test] |
| 588 | fn the_highest_sequence_does_not_overflow() { |
| 589 | let old = meeting(&format!( |
| 590 | "SEQUENCE:9223372036854775807\nATTENDEE:{BOB}\nATTENDEE:{CAROL}\n" |
| 591 | )); |
| 592 | let moved = text(&old) |
| 593 | .replace("DTSTART:20260105T100000Z", "DTSTART:20260105T090000Z") |
| 594 | .replace(&format!("ATTENDEE:{CAROL}\r\n"), ""); |
| 595 | let (store, msgs) = itip::organize( |
| 596 | Some(&old), |
| 597 | Some(ICalendar::parse(&moved).unwrap()), |
| 598 | &is(ALICE), |
| 599 | now(), |
| 600 | ); |
| 601 | assert!(text(&store.unwrap()).contains("SEQUENCE:9223372036854775807")); |
| 602 | assert!(text(&to(&msgs, CAROL).unwrap().cal).contains("SEQUENCE:9223372036854775807")); |
| 603 | } |
| 604 | |
| 605 | #[test] |
| 606 | fn answering_an_instance_the_series_lacks_changes_nothing() { |
| 607 | use pimdav::calcard::icalendar::ICalendarParticipationStatus::Declined; |
| 608 | use pimdav::zone::Zone; |
| 609 | let copy = meeting(&format!("ATTENDEE:{BOB}\n")); |
| 610 | // A Tuesday is no instance. |
| 611 | assert!(itip::respond(©, &is(BOB), Declined, Some(at(13, 10)), &Zone::Utc).is_none()); |
| 612 | let got = |
| 613 | text(&itip::respond(©, &is(BOB), Declined, Some(at(12, 10)), &Zone::Utc).unwrap()); |
| 614 | assert!(got.contains("RECURRENCE-ID:20260112T100000Z"), "{got}"); |
| 615 | assert_eq!( |
| 616 | got.matches(&format!("PARTSTAT=DECLINED:{BOB}")).count(), |
| 617 | 1, |
| 618 | "{got}" |
| 619 | ); |
| 620 | } |
| 621 | |
| 622 | #[test] |
| 623 | fn a_date_until_on_the_same_day_extends_the_series() { |
| 624 | let old = text(&meeting(&format!("ATTENDEE;PARTSTAT=ACCEPTED:{BOB}\n"))) |
| 625 | .replace("COUNT=4", "UNTIL=20260119T000000Z"); |
| 626 | let old = ICalendar::parse(&old).unwrap(); |
| 627 | // The DATE includes the instance at 10:00 on the 19th. |
| 628 | let longer = text(&old).replace("UNTIL=20260119T000000Z", "UNTIL=20260119"); |
| 629 | let (store, _) = itip::organize( |
| 630 | Some(&old), |
| 631 | Some(ICalendar::parse(&longer).unwrap()), |
| 632 | &is(ALICE), |
| 633 | now(), |
| 634 | ); |
| 635 | let store = text(&store.unwrap()); |
| 636 | assert!( |
| 637 | store.contains(&format!("PARTSTAT=NEEDS-ACTION:{BOB}")), |
| 638 | "{store}" |
| 639 | ); |
| 640 | } |
| 641 | |
| 642 | #[test] |
| 643 | fn a_room_declines_only_the_first_instance_of_a_this_and_future_override() { |
| 644 | use pimdav::calcard::icalendar::ICalendarParticipationStatus::Declined; |
| 645 | use pimdav::zone::Zone; |
| 646 | // From the 12th on, the meeting runs two hours later. |
| 647 | let copy = cal(&format!( |
| 648 | "BEGIN:VEVENT\nUID:m1\nDTSTART:20260105T100000Z\nDTEND:20260105T110000Z\nRRULE:FREQ=WEEKLY;COUNT=4\n\ |
| 649 | ORGANIZER:{ALICE}\nATTENDEE:{ROOM}\nEND:VEVENT\n\ |
| 650 | BEGIN:VEVENT\nUID:m1\nRECURRENCE-ID;RANGE=THISANDFUTURE:20260112T100000Z\n\ |
| 651 | DTSTART:20260112T120000Z\nDTEND:20260112T130000Z\nORGANIZER:{ALICE}\nATTENDEE:{ROOM}\nEND:VEVENT\n" |
| 652 | )); |
| 653 | let taken = [booked(at(12, 12), at(12, 13))]; |
| 654 | let answer = itip::auto_answer(©, &is(ROOM), &taken, &(at(1, 0)..at(31, 0)), &Zone::Utc); |
| 655 | let got = text(&answer); |
| 656 | assert!(got.contains("RECURRENCE-ID:20260112T100000Z"), "{got}"); |
| 657 | assert!( |
| 658 | got.contains("RECURRENCE-ID;RANGE=THISANDFUTURE:20260119T100000Z"), |
| 659 | "{got}" |
| 660 | ); |
| 661 | assert!(got.contains("DTSTART:20260119T120000Z"), "{got}"); |
| 662 | let declined = format!("PARTSTAT=DECLINED:{ROOM}"); |
| 663 | let accepted = format!("PARTSTAT=ACCEPTED:{ROOM}"); |
| 664 | assert_eq!(got.matches(&declined).count(), 1, "{got}"); |
| 665 | assert_eq!(got.matches(&accepted).count(), 2, "{got}"); |
| 666 | |
| 667 | // The organizer's copy splits its range the same way. |
| 668 | let (_, reply) = itip::attend(©, answer, &is(ROOM), now()).unwrap(); |
| 669 | let mut org = copy.clone(); |
| 670 | assert!(itip::apply_reply(&mut org, &reply.unwrap().cal, &is(ROOM))); |
| 671 | let org = text(&org); |
| 672 | assert!( |
| 673 | org.contains("RECURRENCE-ID;RANGE=THISANDFUTURE:20260119T100000Z"), |
| 674 | "{org}" |
| 675 | ); |
| 676 | assert_eq!(org.matches("PARTSTAT=DECLINED").count(), 1, "{org}"); |
| 677 | assert_eq!(org.matches("PARTSTAT=ACCEPTED").count(), 2, "{org}"); |
| 678 | |
| 679 | // So does an answer for that one instance from the web. |
| 680 | let got = |
| 681 | text(&itip::respond(©, &is(ROOM), Declined, Some(at(12, 10)), &Zone::Utc).unwrap()); |
| 682 | assert!( |
| 683 | got.contains("RECURRENCE-ID;RANGE=THISANDFUTURE:20260119T100000Z"), |
| 684 | "{got}" |
| 685 | ); |
| 686 | assert_eq!(got.matches(&declined).count(), 1, "{got}"); |
| 687 | } |
| 688 | |
| 689 | #[test] |
| 690 | fn a_new_override_takes_the_others_state_from_its_range() { |
| 691 | let old = cal(&format!( |
| 692 | "BEGIN:VEVENT\nUID:m1\nDTSTART:20260105T100000Z\nDTEND:20260105T110000Z\nRRULE:FREQ=WEEKLY;COUNT=4\n\ |
| 693 | ORGANIZER:{ALICE}\nATTENDEE:{BOB}\nATTENDEE;PARTSTAT=NEEDS-ACTION:{CAROL}\nEND:VEVENT\n\ |
| 694 | BEGIN:VEVENT\nUID:m1\nRECURRENCE-ID;RANGE=THISANDFUTURE:20260112T100000Z\n\ |
| 695 | DTSTART:20260112T120000Z\nDTEND:20260112T130000Z\nORGANIZER:{ALICE}\n\ |
| 696 | ATTENDEE:{BOB}\nATTENDEE;PARTSTAT=ACCEPTED:{CAROL}\nEND:VEVENT\n" |
| 697 | )); |
| 698 | let new = cal(&format!( |
| 699 | "{}BEGIN:VEVENT\nUID:m1\nRECURRENCE-ID:20260119T100000Z\nDTSTART:20260119T120000Z\n\ |
| 700 | DTEND:20260119T130000Z\nORGANIZER:{ALICE}\nATTENDEE;PARTSTAT=DECLINED:{BOB}\n\ |
| 701 | ATTENDEE;PARTSTAT=NEEDS-ACTION:{CAROL}\nEND:VEVENT\n", |
| 702 | text(&old) |
| 703 | .trim_start_matches("BEGIN:VCALENDAR\r\nVERSION:2.0\r\nPRODID:-//t//EN\r\n") |
| 704 | .trim_end_matches("END:VCALENDAR\r\n") |
| 705 | .replace("\r\n", "\n") |
| 706 | )); |
| 707 | let (store, reply) = itip::attend(&old, new, &is(BOB), now()).unwrap(); |
| 708 | let store = text(&store); |
| 709 | assert_eq!( |
| 710 | store.matches(&format!("PARTSTAT=ACCEPTED:{CAROL}")).count(), |
| 711 | 2, |
| 712 | "{store}" |
| 713 | ); |
| 714 | assert!(reply.is_some()); |
| 715 | } |
| 716 | |
| 717 | #[test] |
| 718 | fn an_attendee_dropped_from_the_master_gets_a_cancel_despite_a_client_override() { |
| 719 | let over = |agent: &str| { |
| 720 | format!( |
| 721 | "BEGIN:VEVENT\nUID:m1\nRECURRENCE-ID:20260112T100000Z\nDTSTART:20260112T120000Z\n\ |
| 722 | DTEND:20260112T130000Z\nORGANIZER:{ALICE}\nATTENDEE{agent}:{BOB}\nEND:VEVENT\n" |
| 723 | ) |
| 724 | }; |
| 725 | let series = |extra: &str| { |
| 726 | format!( |
| 727 | "BEGIN:VEVENT\nUID:m1\nDTSTART:20260105T100000Z\nDTEND:20260105T110000Z\n\ |
| 728 | RRULE:FREQ=WEEKLY;COUNT=4\nORGANIZER:{ALICE}\nATTENDEE:{CAROL}\n{extra}END:VEVENT\n" |
| 729 | ) |
| 730 | }; |
| 731 | let old = cal(&format!( |
| 732 | "{}{}", |
| 733 | series(&format!("ATTENDEE:{BOB}\n")), |
| 734 | over("") |
| 735 | )); |
| 736 | let new = cal(&format!("{}{}", series(""), over(";SCHEDULE-AGENT=CLIENT"))); |
| 737 | let (_, msgs) = itip::organize(Some(&old), Some(new), &is(ALICE), now()); |
| 738 | let cancel = to(&msgs, BOB).expect("a CANCEL for the series"); |
| 739 | assert_eq!(cancel.method, Method::Cancel); |
| 740 | assert!( |
| 741 | !text(&cancel.cal).contains("RECURRENCE-ID"), |
| 742 | "{}", |
| 743 | text(&cancel.cal) |
| 744 | ); |
| 745 | } |
| 746 |