verdande/internal/ics/ics_test.go

package ics

import (
	"strings"
	"testing"
	"time"
)

func sample() Calendar {
	due := time.Date(2026, 3, 10, 9, 0, 0, 0, time.UTC)
	done := time.Date(2026, 3, 9, 14, 30, 0, 0, time.UTC)
	duration := 45

	return Calendar{
		Name:   "verdande",
		Domain: "todo.example.dk",
		Tasks: []Task{
			{
				ID: "t1", Content: "Betal moms", Description: "husk bilag",
				ProjectName: "Firma", DueDate: "2026-03-10", DueDatetime: &due,
				DurationMin: &duration, Priority: 1,
				CreatedAt: done, UpdatedAt: done,
			},
			{
				ID: "t2", Content: "Ryd op", DueDate: "2026-03-12", Priority: 4,
				CreatedAt: done, UpdatedAt: done,
			},
			{
				ID: "t3", Content: "Vand planterne", Recurrence: "FREQ=WEEKLY;BYDAY=MO",
				DueDate: "2026-03-16", Priority: 3, CreatedAt: done, UpdatedAt: done,
			},
			{
				ID: "t4", Content: "Færdig ting", Completed: true, CompletedAt: &done,
				CreatedAt: done, UpdatedAt: done,
			},
		},
	}
}

func TestRenderStructure(t *testing.T) {
	out := Render(sample())

	if !strings.HasPrefix(out, "BEGIN:VCALENDAR\r\n") {
		t.Error("the document does not begin with BEGIN:VCALENDAR")
	}
	if !strings.HasSuffix(out, "END:VCALENDAR\r\n") {
		t.Error("the document does not end with END:VCALENDAR")
	}
	if strings.Count(out, "BEGIN:VTODO") != 4 {
		t.Errorf("got %d VTODOs, want one per task", strings.Count(out, "BEGIN:VTODO"))
	}
	if a, b := strings.Count(out, "BEGIN:VTODO"), strings.Count(out, "END:VTODO"); a != b {
		t.Errorf("%d BEGIN:VTODO but %d END:VTODO", a, b)
	}

	// Every line ends CRLF — a bare LF is not iCalendar and some clients refuse it.
	for _, line := range strings.Split(strings.TrimSuffix(out, "\r\n"), "\r\n") {
		if strings.Contains(line, "\n") {
			t.Fatalf("a line contains a bare newline: %q", line)
		}
	}
}

// Tasks are VTODO. That is what makes them to-dos in Apple Reminders rather than
// events, and it is the same component CalDAV will serve.
func TestTasksAreTodos(t *testing.T) {
	out := Render(sample())

	if !strings.Contains(out, "SUMMARY:Betal moms") {
		t.Error("the summary is missing")
	}
	if !strings.Contains(out, "UID:t1@todo.example.dk") {
		t.Error("the UID is missing or not domain-qualified")
	}
	if !strings.Contains(out, "STATUS:NEEDS-ACTION") {
		t.Error("an open task is not marked NEEDS-ACTION")
	}
	if !strings.Contains(out, "STATUS:COMPLETED") {
		t.Error("a completed task is not marked COMPLETED")
	}
	if !strings.Contains(out, "RRULE:FREQ=WEEKLY;BYDAY=MO") {
		t.Error("the recurrence rule did not survive into the feed")
	}
	if !strings.Contains(out, "CATEGORIES:Firma") {
		t.Error("the project is not carried as a category")
	}
}

// A whole-day due date must be a DATE, not a DATE-TIME. Emitting midnight in some
// timezone would move the task by a day for anybody east or west of the server.
func TestWholeDayDueDatesAreDates(t *testing.T) {
	out := Render(sample())

	if !strings.Contains(out, "DUE;VALUE=DATE:20260312") {
		t.Error("a dateless task's due date is not a DATE value")
	}
	// The one with a clock time keeps it.
	if !strings.Contains(out, "DUE:20260310T090000Z") {
		t.Error("a timed task lost its clock time")
	}
}

// Google Calendar ignores VTODO. Timed tasks are therefore also emitted as events,
// or a feed is useless in the calendar most people actually keep.
func TestDatedTasksBecomeEvents(t *testing.T) {
	out := Render(sample())

	// Every dated, unfinished task becomes an event, so it shows in a calendar app
	// that ignores VTODO — timed t1, and date-only t2 and t3. The finished t4 has no
	// date and no event.
	if got := strings.Count(out, "BEGIN:VEVENT"); got != 3 {
		t.Fatalf("got %d VEVENTs, want 3 (one timed, two all-day)", got)
	}

	// The timed one keeps its clock and its 45-minute duration.
	if !strings.Contains(out, "DTSTART:20260310T090000Z") || !strings.Contains(out, "DTEND:20260310T094500Z") {
		t.Error("the timed event's start or duration is wrong")
	}
	// The date-only ones are all-day: a DATE start and an exclusive next-day end, so
	// they sit on their own day rather than bleeding into the next.
	if !strings.Contains(out, "DTSTART;VALUE=DATE:20260312") || !strings.Contains(out, "DTEND;VALUE=DATE:20260313") {
		t.Error("the date-only event is not a single all-day event")
	}
	// A recurring date-only task carries its rule onto the event.
	if !strings.Contains(out, "RRULE:FREQ=WEEKLY;BYDAY=MO") {
		t.Error("the recurring task's event has no RRULE")
	}
	// The event must not share the to-do's UID, or clients treat them as one item.
	if !strings.Contains(out, "UID:t1-event@todo.example.dk") {
		t.Error("the event does not have a UID of its own")
	}
}

// A comma or semicolon is a value separator in iCalendar. Unescaped, it silently
// truncates the summary at that character in every client.
func TestSpecialCharactersAreEscaped(t *testing.T) {
	now := time.Date(2026, 3, 10, 9, 0, 0, 0, time.UTC)
	out := Render(Calendar{
		Name: "verdande", Domain: "example.dk",
		Tasks: []Task{{
			ID: "t1", Content: `Køb: mælk, brød; smør \ og mere`,
			Description: "linje 1\nlinje 2",
			CreatedAt:   now, UpdatedAt: now,
		}},
	})

	if !strings.Contains(out, `SUMMARY:Køb: mælk\, brød\; smør \\ og mere`) {
		t.Errorf("the summary is not escaped correctly:\n%s", out)
	}
	if !strings.Contains(out, `DESCRIPTION:linje 1\nlinje 2`) {
		t.Error("a newline in the description was not escaped")
	}
	// And the raw separators must not survive unescaped anywhere in the summary.
	for _, line := range strings.Split(out, "\r\n") {
		if !strings.HasPrefix(line, "SUMMARY:") {
			continue
		}
		body := strings.TrimPrefix(line, "SUMMARY:")
		for i := 0; i < len(body); i++ {
			if (body[i] == ',' || body[i] == ';') && (i == 0 || body[i-1] != '\\') {
				t.Errorf("unescaped %q in %q", body[i], line)
			}
		}
	}
}

// Lines fold at 75 octets, and a fold in the middle of a multi-byte character
// produces a line no parser can read.
func TestLongLinesFoldWithoutBreakingCharacters(t *testing.T) {
	now := time.Date(2026, 3, 10, 9, 0, 0, 0, time.UTC)
	long := strings.Repeat("ø", 200) // two bytes each, so folds land mid-character
	out := Render(Calendar{
		Name: "verdande", Domain: "example.dk",
		Tasks: []Task{{ID: "t1", Content: long, CreatedAt: now, UpdatedAt: now}},
	})

	for _, line := range strings.Split(out, "\r\n") {
		if len(line) > 75 {
			t.Errorf("a line is %d octets, over the 75 limit: %q", len(line), line)
		}
	}

	// Unfolding must reproduce the original text exactly.
	unfolded := strings.ReplaceAll(out, "\r\n ", "")
	if !strings.Contains(unfolded, "SUMMARY:"+long) {
		t.Error("the summary did not survive folding and unfolding")
	}
}

// P4 means "no priority stated", not "lowest". Mapping it to 9 would arrive in a
// client as an explicit low priority on every ordinary task.
func TestPriorityMapping(t *testing.T) {
	now := time.Date(2026, 3, 10, 9, 0, 0, 0, time.UTC)
	want := map[int]string{1: "PRIORITY:1", 2: "PRIORITY:5", 3: "PRIORITY:7", 4: "PRIORITY:0"}

	for priority, expected := range want {
		out := Render(Calendar{
			Name: "v", Domain: "example.dk",
			Tasks: []Task{{ID: "t", Content: "x", Priority: priority, CreatedAt: now, UpdatedAt: now}},
		})
		if !strings.Contains(out, expected) {
			t.Errorf("priority %d did not produce %q", priority, expected)
		}
	}
}

func TestEmptyCalendarIsStillValid(t *testing.T) {
	out := Render(Calendar{Name: "verdande", Domain: "example.dk"})

	if !strings.Contains(out, "BEGIN:VCALENDAR") || !strings.Contains(out, "END:VCALENDAR") {
		t.Error("an empty calendar is not a well-formed document")
	}
	if strings.Contains(out, "BEGIN:VTODO") {
		t.Error("an empty calendar contains a task")
	}
}

func TestFilename(t *testing.T) {
	cases := map[string]string{
		"verdande":      "verdande.ics",
		"Mine opgaver":  "mine-opgaver.ics",
		"Q3/2026 møder": "q32026-mder.ics",
		"":              "verdande.ics",
		"???":           "verdande.ics",
	}
	for in, want := range cases {
		if got := Filename(in); got != want {
			t.Errorf("Filename(%q) = %q, want %q", in, got, want)
		}
	}
}

// En abonnementskalender, som den ser ud fra nogen andens software.
//
// Alle fire former, der findes i naturen, i én fil: en heldagsbegivenhed, en med
// et UTC-stempel, en med TZID og lokal tid, og en over flere dage. Plus en, der
// mangler det, et gitter ikke kan undvære, og en foldet linje — begge dele
// kommer, og de kommer uden varsel.
func TestParseCalendarReadsTheFourShapesThatExist(t *testing.T) {
	body := "BEGIN:VCALENDAR\r\n" +
		"VERSION:2.0\r\n" +
		"X-WR-CALNAME:Helligdage\r\n" +
		"BEGIN:VEVENT\r\n" +
		"UID:heldag@example.dk\r\n" +
		"DTSTART;VALUE=DATE:20260824\r\n" +
		"DTEND;VALUE=DATE:20260825\r\n" +
		"SUMMARY:Grundlovsdag\r\n" +
		"END:VEVENT\r\n" +
		"BEGIN:VEVENT\r\n" +
		"UID:utc@example.dk\r\n" +
		"DTSTART:20260825T120000Z\r\n" +
		"DTEND:20260825T133000Z\r\n" +
		`SUMMARY:Møde med en meget lang titel\, der er foldet over to lin` + "\r\n" + " jer\r\n" +
		"END:VEVENT\r\n" +
		"BEGIN:VEVENT\r\n" +
		"UID:lokal@example.dk\r\n" +
		"DTSTART;TZID=Europe/Copenhagen:20260826T090000\r\n" +
		"DTEND;TZID=Europe/Copenhagen:20260826T100000\r\n" +
		"SUMMARY:Tandlæge\r\n" +
		"END:VEVENT\r\n" +
		"BEGIN:VEVENT\r\n" +
		"UID:flerdage@example.dk\r\n" +
		"DTSTART;VALUE=DATE:20260901\r\n" +
		"DTEND;VALUE=DATE:20260904\r\n" +
		"SUMMARY:Ferie\r\n" +
		"END:VEVENT\r\n" +
		"BEGIN:VEVENT\r\n" +
		"SUMMARY:Uden uid og uden start\r\n" +
		"END:VEVENT\r\n" +
		"END:VCALENDAR\r\n"

	cal := ParseCalendar(body)

	if cal.Name != "Helligdage" {
		t.Errorf("kalenderens navn = %q", cal.Name)
	}
	if len(cal.Events) != 4 {
		t.Fatalf("%d begivenheder, want 4 — den femte mangler både uid og start", len(cal.Events))
	}

	// Heldag. DTEND er eksklusiv i filen: en endagsbegivenhed slutter næste morgen.
	// Gemmes inklusivt, ellers dækker hver eneste heldagsbegivenhed én celle for
	// meget — og en helligdag æder dagen efter sig.
	one := cal.Events[0]
	if !one.AllDay || one.StartDay != "2026-08-24" || one.EndDay != "2026-08-24" {
		t.Errorf("heldag: %+v", one)
	}
	if one.StartsAt != "" {
		t.Errorf("en heldagsbegivenhed fik et klokkeslæt: %q", one.StartsAt)
	}

	// UTC, og den foldede linje samlet igen.
	two := cal.Events[1]
	if two.StartsAt != "2026-08-25T12:00:00Z" || two.EndsAt != "2026-08-25T13:30:00Z" {
		t.Errorf("utc: %+v", two)
	}
	if two.Summary != "Møde med en meget lang titel, der er foldet over to linjer" {
		t.Errorf("den foldede linje blev ikke samlet: %q", two.Summary)
	}

	// Lokal tid med TZID: klokkeslættet står, som filen skrev det. At flytte det
	// her ville spørge *denne* proces, hvilken tidszone den er i.
	three := cal.Events[2]
	if three.StartsAt != "2026-08-26T09:00:00" {
		t.Errorf("lokal: %q", three.StartsAt)
	}

	// Flere dage, begge ender inklusive.
	four := cal.Events[3]
	if four.StartDay != "2026-09-01" || four.EndDay != "2026-09-03" {
		t.Errorf("ferie: %s til %s", four.StartDay, four.EndDay)
	}
}

// En fil, der ikke er en kalender, må ikke koste noget. Den hentes på et skema
// uden nogen, der kigger med, og en fejl her ville være en sweep, der stopper.
func TestParseCalendarSurvivesRubbish(t *testing.T) {
	for _, body := range []string{
		"",
		"ikke en kalender overhovedet",
		"BEGIN:VCALENDAR\r\nEND:VCALENDAR\r\n",
		"BEGIN:VEVENT\r\nDTSTART:x\r\nEND:VEVENT\r\n",
		"BEGIN:VEVENT\r\nUID:a\r\nDTSTART:2026\r\nEND:VEVENT\r\n",
	} {
		if got := ParseCalendar(body); len(got.Events) != 0 {
			t.Errorf("%q gav %d begivenheder", body, len(got.Events))
		}
	}
}