⚡ Project management that doesn't become the project. Boards, Gantt charts, and GitHub integration. Self-host it or use Kaneo Cloud.
TypeScript honoissue-managementissue-trackerjira-alternativekanbanlinear-alternativemcpproject-managementreactself-hostedtypescript
import { describe, expect, it } from "vite-plus/test";
import {
buildCalendar,
streamCalendar,
} from "../../../apps/api/src/calendar-feed/ical";
const task: Parameters<typeof buildCalendar>[0]["tasks"][number] = {
id: "task-1",
title: "Deploy",
description: null,
startDate: null,
dueDate: new Date("2026-09-23T00:00:00Z"),
createdAt: new Date("2026-09-01T12:00:00Z"),
updatedAt: new Date("2026-09-22T10:30:00Z"),
};
const calendar = (tasks = [task], timeZone = "UTC") =>
buildCalendar({ name: "Changes", timeZone, tasks });
describe("iCalendar serialization", () => {
it("exports an inclusive all-day range with stable identity and revision timestamps", () => {
const result = calendar([
{ ...task, startDate: new Date("2026-09-21T00:00:00Z") },
]);
expect(result).toContain("UID:task-1@kaneo\r\n");
expect(result).toContain(
"DTSTART;VALUE=DATE:20260921\r\nDTEND;VALUE=DATE:20260924",
);
expect(result).toContain("DTSTAMP:20260922T103000Z");
expect(result).toContain("LAST-MODIFIED:20260922T103000Z");
expect(result).toBe(
calendar([{ ...task, startDate: new Date("2026-09-21T00:00:00Z") }]),
);
});
it("handles due-only, start-only, unscheduled, and reversed legacy dates", () => {
expect(calendar()).toContain(
"DTSTART;VALUE=DATE:20260923\r\nDTEND;VALUE=DATE:20260924",
);
expect(
calendar([{ ...task, dueDate: null, startDate: task.dueDate }]),
).toContain("DTEND;VALUE=DATE:20260924");
expect(calendar([{ ...task, dueDate: null }])).not.toContain(
"BEGIN:VEVENT",
);
expect(
calendar([{ ...task, startDate: new Date("2026-09-30T00:00:00Z") }]),
).toContain("DTEND;VALUE=DATE:20261001");
});
it("keeps local dates across UTC offsets and daylight saving changes", () => {
const result = calendar(
[
{
...task,
startDate: new Date("2026-10-24T22:00:00Z"),
dueDate: new Date("2026-10-25T23:00:00Z"),
},
],
"Europe/Berlin",
);
expect(result).toContain(
"DTSTART;VALUE=DATE:20261025\r\nDTEND;VALUE=DATE:20261027",
);
expect(
calendar(
[{ ...task, dueDate: new Date("2026-01-01T02:00:00Z") }],
"America/Los_Angeles",
),
).toContain("DTSTART;VALUE=DATE:20251231\r\nDTEND;VALUE=DATE:20260101");
});
it("escapes text and prevents newlines from injecting calendar properties", () => {
const result = buildCalendar({
name: "Changes, ops; team",
timeZone: "UTC",
tasks: [
{
...task,
title: "A\\B, C; D\r\nEND:VEVENT",
description: "First\rSecond\nThird",
},
],
});
expect(result).toContain("X-WR-CALNAME:Changes\\, ops\\; team");
expect(result).toContain("SUMMARY:A\\\\B\\, C\\; D\\nEND:VEVENT\r\n");
expect(result).toContain("DESCRIPTION:First\\nSecond\\nThird");
expect(result.match(/\r\nEND:VEVENT/g)).toHaveLength(1);
});
it("folds at 75 UTF-8 octets without splitting characters and uses CRLF", () => {
const title = "Änderung 日本語 🚀 ".repeat(20);
const result = calendar([{ ...task, title }]);
for (const line of result.split("\r\n"))
expect(Buffer.byteLength(line)).toBeLessThanOrEqual(75);
expect(result.replaceAll("\r\n ", "")).toContain(`SUMMARY:${title}\r\n`);
expect(result.replaceAll("\r\n", "")).not.toMatch(/[\r\n]/);
expect(result.endsWith("END:VCALENDAR\r\n")).toBe(true);
});
});
describe("calendar streaming", () => {
it("matches the calendar format and reads tasks only as requested", async () => {
let reads = 0;
let closed = false;
async function* tasks() {
try {
for (let i = 0; i < 100; i++) {
reads++;
yield { ...task, id: String(i) };
}
} finally {
closed = true;
}
}
const stream = streamCalendar({
name: "Changes",
timeZone: "UTC",
tasks: tasks(),
});
const reader = stream.getReader();
expect(reads).toBe(0);
const header = await reader.read();
expect(new TextDecoder().decode(header.value)).toContain("BEGIN:VCALENDAR");
expect(reads).toBe(0);
const first = await reader.read();
expect(new TextDecoder().decode(first.value)).toContain("UID:0@kaneo");
expect(reads).toBe(1);
await reader.cancel();
expect(closed).toBe(true);
expect(reads).toBe(1);
async function* oneTask() {
yield task;
}
expect(
await new Response(
streamCalendar({ name: "Changes", timeZone: "UTC", tasks: oneTask() }),
).text(),
).toBe(calendar());
});
it("fails the response instead of completing a partial calendar when a batch fails", async () => {
async function* tasks() {
yield task;
throw new Error("Batch failed");
}
const response = new Response(
streamCalendar({ name: "Changes", timeZone: "UTC", tasks: tasks() }),
);
await expect(response.text()).rejects.toThrow("Batch failed");
});
});