⚡ 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
export type CalendarTask = {
id: string;
title: string;
description: string | null;
startDate: Date | null;
dueDate: Date | null;
createdAt: Date;
updatedAt: Date;
};
function escapeText(value: string) {
return value
.replaceAll("\\", "\\\\")
.replace(/\r\n|\r|\n/g, "\\n")
.replaceAll(";", "\\;")
.replaceAll(",", "\\,");
}
// RFC 5545 limits physical lines to 75 octets, including continuation spaces.
function foldLine(line: string) {
const lines: string[] = [];
let current = "";
let bytes = 0;
for (const character of line) {
const size = Buffer.byteLength(character, "utf8");
if (bytes + size > 75) {
lines.push(current);
current = " ";
bytes = 1;
}
current += character;
bytes += size;
}
lines.push(current);
return lines.join("\r\n");
}
function timestamp(date: Date) {
return date
.toISOString()
.replace(/[-:]/g, "")
.replace(/\.\d{3}Z$/, "Z");
}
function calendarDate(date: Date, formatter: Intl.DateTimeFormat) {
const parts = formatter.formatToParts(date);
return ["year", "month", "day"]
.map((type) => parts.find((part) => part.type === type)?.value)
.join("");
}
function nextDay(date: string) {
const day = new Date(
`${date.slice(0, 4)}-${date.slice(4, 6)}-${date.slice(6, 8)}T00:00:00Z`,
);
day.setUTCDate(day.getUTCDate() + 1);
return day.toISOString().slice(0, 10).replaceAll("-", "");
}
function calendarHeader(name: string) {
return [
"BEGIN:VCALENDAR",
"VERSION:2.0",
"PRODID:-//Kaneo//Calendar Feed//EN",
"CALSCALE:GREGORIAN",
`X-WR-CALNAME:${escapeText(name)}`,
];
}
function eventFormatter(timeZone: string) {
const formatter = new Intl.DateTimeFormat("en-US", {
timeZone,
year: "numeric",
month: "2-digit",
day: "2-digit",
});
return (task: CalendarTask) => {
const scheduledDate = task.startDate ?? task.dueDate;
if (!scheduledDate) return [];
const start = calendarDate(scheduledDate, formatter);
const due = calendarDate(task.dueDate ?? scheduledDate, formatter);
return [
"BEGIN:VEVENT",
`UID:${task.id}@kaneo`,
`DTSTAMP:${timestamp(task.updatedAt)}`,
`CREATED:${timestamp(task.createdAt)}`,
`LAST-MODIFIED:${timestamp(task.updatedAt)}`,
`DTSTART;VALUE=DATE:${start}`,
// Task due dates are inclusive; iCalendar's DTEND is exclusive.
`DTEND;VALUE=DATE:${nextDay(due < start ? start : due)}`,
`SUMMARY:${escapeText(task.title)}`,
...(task.description
? [`DESCRIPTION:${escapeText(task.description)}`]
: []),
"TRANSP:TRANSPARENT",
"END:VEVENT",
];
};
}
function serializeLines(lines: string[]) {
return lines.length ? `${lines.map(foldLine).join("\r\n")}\r\n` : "";
}
export function buildCalendar({
name,
timeZone,
tasks,
}: {
name: string;
timeZone: string;
tasks: CalendarTask[];
}) {
const event = eventFormatter(timeZone);
return serializeLines([
...calendarHeader(name),
...tasks.flatMap(event),
"END:VCALENDAR",
]);
}
export function streamCalendar({
name,
timeZone,
tasks,
}: {
name: string;
timeZone: string;
tasks: AsyncIterable<CalendarTask>;
}) {
const event = eventFormatter(timeZone);
const encoder = new TextEncoder();
async function* chunks() {
yield encoder.encode(serializeLines(calendarHeader(name)));
for await (const task of tasks) {
yield encoder.encode(serializeLines(event(task)));
}
yield encoder.encode("END:VCALENDAR\r\n");
}
const iterator = chunks();
return new ReadableStream<Uint8Array>(
{
async pull(controller) {
try {
const result = await iterator.next();
if (result.done) controller.close();
else controller.enqueue(result.value);
} catch (error) {
await iterator.return();
controller.error(error);
}
},
async cancel() {
await iterator.return();
},
},
{ highWaterMark: 0 },
);
}