@remit/calendar-service 0.0.10 → 0.0.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remit/calendar-service",
-  "version": "0.0.10",
+  "version": "0.0.11",
   "description": "iCalendar (RFC 5545) parsing, projection and recurrence expansion over the calendar store",
   "type": "module",
   "main": "src/index.ts",

package/src/index.ts

@@ -93,5 +93,6 @@ export {
 	isBusy,
 	listBusySpans,
 	listCalendarInstances,
+	listObjectInstances,
 	mergeBusySpans,
 } from "./window.js";

package/src/window.test.ts

@@ -20,6 +20,7 @@ import {
 	type CalendarWindowRepositories,
 	listBusySpans,
 	listCalendarInstances,
+	listObjectInstances,
 	mergeBusySpans,
 } from "./window.js";
 
@@ -369,6 +370,78 @@ describe("listCalendarInstances", () => {
 	});
 });
 
+describe("listObjectInstances", () => {
+	const ownRows = (resource: StoredResource) => ({
+		calendarEventIndex: {
+			listForObject: async () => resource.rows,
+		},
+	});
+
+	it("reads one resource's own rows where its index reaches the window", async () => {
+		const calendar = collection();
+		const weekly = await store(
+			calendar,
+			"weekly.ics",
+			ical(
+				"BEGIN:VCALENDAR",
+				"VERSION:2.0",
+				"BEGIN:VEVENT",
+				"UID:weekly@example.com",
+				"DTSTART:20260907T090000Z",
+				"DTEND:20260907T100000Z",
+				"SUMMARY:Stand-up",
+				"RRULE:FREQ=WEEKLY;COUNT=4",
+				"END:VEVENT",
+				"END:VCALENDAR",
+			),
+		);
+
+		const instances = await listObjectInstances(
+			ownRows(weekly),
+			calendar,
+			weekly.object,
+			{ from: "2026-09-10T00:00:00Z", to: "2026-09-25T00:00:00Z" },
+		);
+
+		assert.deepEqual(
+			instances.map((instance) => instance.startAt),
+			["2026-09-14T09:00:00Z", "2026-09-21T09:00:00Z"],
+		);
+	});
+
+	it("expands the resource live where its index stops before the window", async () => {
+		const calendar = collection();
+		const openEnded = await store(
+			calendar,
+			"open.ics",
+			ical(
+				"BEGIN:VCALENDAR",
+				"VERSION:2.0",
+				"BEGIN:VEVENT",
+				"UID:open@example.com",
+				"DTSTART:20200907T090000Z",
+				"DTEND:20200907T100000Z",
+				"SUMMARY:Weekly one-to-one",
+				"RRULE:FREQ=WEEKLY",
+				"END:VEVENT",
+				"END:VCALENDAR",
+			),
+		);
+
+		const instances = await listObjectInstances(
+			ownRows(openEnded),
+			calendar,
+			openEnded.object,
+			{ from: "2026-09-14T00:00:00Z", to: "2026-09-28T00:00:00Z" },
+		);
+
+		assert.deepEqual(
+			instances.map((instance) => instance.startAt),
+			["2026-09-14T09:00:00Z", "2026-09-21T09:00:00Z"],
+		);
+	});
+});
+
 describe("mergeBusySpans", () => {
 	it("collapses overlapping and touching spans", () => {
 		assert.deepEqual(

package/src/window.ts

@@ -158,6 +158,55 @@ export const listCalendarInstances = async (
 		.sort((left, right) => left.startAt.localeCompare(right.startAt));
 };
 
+/**
+ * The occurrences of one resource in a window, read from that resource alone:
+ * its own index rows where the index reaches the window, and a live expansion
+ * of it where it does not.
+ */
+export const listObjectInstances = async (
+	repositories: {
+		calendarEventIndex: Pick<ICalendarEventIndexRepository, "listForObject">;
+	},
+	collection: CalendarCollectionItem,
+	object: CalendarObjectItem,
+	window: CalendarWindow,
+): Promise<CalendarInstance[]> => {
+	const fromMs = Date.parse(window.from);
+	const toMs = Date.parse(window.to);
+	const indexReaches =
+		object.expandedThrough === "" || object.expandedThrough >= window.to;
+
+	const occurrences = indexReaches
+		? await repositories.calendarEventIndex.listForObject(
+				collection.calendarId,
+				object.calendarObjectId,
+			)
+		: await expandObject(object, collection.timezone, fromMs, toMs);
+
+	return occurrences
+		.map((occurrence) => instanceOf(collection, object, occurrence))
+		.filter((instance) => overlapsWindow(instance, fromMs, toMs))
+		.sort((left, right) => left.startAt.localeCompare(right.startAt));
+};
+
+const expandObject = async (
+	object: CalendarObjectItem,
+	timezone: string,
+	fromMs: number,
+	toMs: number,
+): Promise<CalendarOccurrenceInput[]> => {
+	const parsed = await parseCalendar(object.icalData);
+	if (!parsed.ok) {
+		throw new Error(
+			`stored calendar object ${object.calendarObjectId} no longer parses: ${parsed.error.message}`,
+		);
+	}
+	return expandCalendarWindow(parsed.value, timezone, {
+		fromMs: fromMs - LOOKBACK_MS,
+		toMs,
+	});
+};
+
 const overlapsWindow = (
 	instance: CalendarInstance,
 	fromMs: number,