@mcp-monorepo/ics 1.1.0 → 1.3.0

package/dist/ics-parser/errors.d.ts

@@ -0,0 +1,16 @@
+export declare class IcsError extends Error {
+    constructor(message: string);
+}
+export declare class TimeZoneDefinitionNotFoundError extends IcsError {
+    constructor(tzid: string);
+}
+export declare class InvalidObservanceError extends IcsError {
+    constructor();
+}
+export declare class CalendarNotFoundError extends IcsError {
+    constructor();
+}
+export declare class InvalidRruleError extends IcsError {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/ics-parser/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/ics-parser/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,QAAS,SAAQ,KAAK;gBACrB,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,+BAAgC,SAAQ,QAAQ;gBAC/C,IAAI,EAAE,MAAM;CAIzB;AAED,qBAAa,sBAAuB,SAAQ,QAAQ;;CAKnD;AAED,qBAAa,qBAAsB,SAAQ,QAAQ;;CAKlD;AAED,qBAAa,iBAAkB,SAAQ,QAAQ;gBACjC,OAAO,EAAE,MAAM;CAI5B"}

package/dist/ics-parser/errors.js

@@ -0,0 +1,31 @@
+export class IcsError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'IcsError';
+    }
+}
+export class TimeZoneDefinitionNotFoundError extends IcsError {
+    constructor(tzid) {
+        super(`Timezone definition for TZID="${tzid}" not found.`);
+        this.name = 'TimeZoneDefinitionNotFoundError';
+    }
+}
+export class InvalidObservanceError extends IcsError {
+    constructor() {
+        super('Time zone data contains no valid observances.');
+        this.name = 'InvalidObservanceError';
+    }
+}
+export class CalendarNotFoundError extends IcsError {
+    constructor() {
+        super('Invalid ICS: No VCALENDAR component found.');
+        this.name = 'CalendarNotFoundError';
+    }
+}
+export class InvalidRruleError extends IcsError {
+    constructor(message) {
+        super(message);
+        this.name = 'InvalidRruleError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/ics-parser/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/ics-parser/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,UAAU,CAAA;IACxB,CAAC;CACF;AAED,MAAM,OAAO,+BAAgC,SAAQ,QAAQ;IAC3D,YAAY,IAAY;QACtB,KAAK,CAAC,iCAAiC,IAAI,cAAc,CAAC,CAAA;QAC1D,IAAI,CAAC,IAAI,GAAG,iCAAiC,CAAA;IAC/C,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,QAAQ;IAClD;QACE,KAAK,CAAC,+CAA+C,CAAC,CAAA;QACtD,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAA;IACtC,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,QAAQ;IACjD;QACE,KAAK,CAAC,4CAA4C,CAAC,CAAA;QACnD,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAA;IACrC,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,QAAQ;IAC7C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAA;IACjC,CAAC;CACF"}

package/dist/ics-parser/event-expander.d.ts

@@ -0,0 +1,71 @@
+import { DateTime, Duration } from 'luxon';
+import { type ExpandedEvent, type TimeZoneResolver, type UnexpandedEvent, type VComponent } from './types.js';
+/**
+ * Gathers all standard and custom properties from a VEVENT component.
+ * @param event - The VEVENT component.
+ * @returns A partially filled ExpandedEvent object containing all static details.
+ */
+export declare function extractEventDetails(event: VComponent, resolver?: TimeZoneResolver): Omit<ExpandedEvent, 'start' | 'end' | 'allDay'>;
+/**
+ * Parses a single VEVENT component into a structured but unexpanded event object,
+ * including parsed recurrence rules.
+ * @param event - The VEVENT component.
+ * @param resolver - The timezone resolver function.
+ * @returns An UnexpandedEvent object.
+ * @throws {IcsError} If the VEVENT component is missing a DTSTART property.
+ */
+export declare function parseUnexpandedEvent(event: VComponent, resolver: TimeZoneResolver): UnexpandedEvent;
+/**
+ * Determines the duration of an event from its DTEND or DURATION property.
+ * @param event - The VEVENT component.
+ * @param dtstart - The start time of the event.
+ * @param isAllDay - Whether the event is an all-day event.
+ * @returns A Luxon Duration object.
+ */
+export declare function getEventDuration(event: VComponent, dtstart: DateTime, isAllDay: boolean, resolver?: TimeZoneResolver): Duration;
+/**
+ * Gathers all inclusion dates from RRULE and RDATE properties.
+ * @returns A Set of timestamps in milliseconds.
+ */
+export declare function getInclusionDates(event: VComponent, dtstart: DateTime, rangeStart: DateTime, rangeEnd: DateTime, resolver: TimeZoneResolver): Set<number>;
+/**
+ * Gathers all exclusion dates from the EXDATE property.
+ * @returns A Set of timestamps in milliseconds.
+ */
+export declare function getExclusionDates(event: VComponent, resolver: TimeZoneResolver): Set<number>;
+/**
+ * Converts a single local occurrence to a UTC start/end object using a timezone resolver.
+ * @returns UTC start and end DateTimes.
+ */
+export declare function applyTimeZone(occurrenceStart: DateTime, duration: Duration, tzid: string | undefined, isAllDay: boolean, resolver: TimeZoneResolver): {
+    startUtc: DateTime;
+    endUtc: DateTime;
+};
+/**
+ * Expands a single VEVENT component into a list of concrete occurrences.
+ * This is a low-level function that handles recurrence for a single component.
+ * Use `expandCalendar` for processing a full calendar with UID-based modifications.
+ *
+ * @param event - The VEVENT component to expand.
+ * @param options - Expansion options including the resolver and time range.
+ * @returns An array of ExpandedEvent objects.
+ * @throws {IcsError} If the VEVENT component is missing a DTSTART property.
+ */
+export declare function expandEvent(event: VComponent, options: {
+    resolver: TimeZoneResolver;
+    rangeStart: DateTime;
+    rangeEnd: DateTime;
+    exclusions?: Set<number>;
+}): ExpandedEvent[];
+/**
+ * Expands all VEVENT components from a calendar, correctly handling recurring events
+ * and their modifications (exceptions) based on UID and RECURRENCE-ID.
+ *
+ * @param components - All VComponents parsed from an iCalendar file.
+ * @param resolver - The timezone resolver function.
+ * @param rangeStart - The start of the query range.
+ * @param rangeEnd - The end of the query range.
+ * @returns A consolidated array of all expanded event occurrences.
+ */
+export declare function expandCalendar(components: VComponent[], resolver: TimeZoneResolver, rangeStart: DateTime, rangeEnd: DateTime): ExpandedEvent[];
+//# sourceMappingURL=event-expander.d.ts.map

package/dist/ics-parser/event-expander.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-expander.d.ts","sourceRoot":"","sources":["../../src/ics-parser/event-expander.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAc1C,OAAO,EAEL,KAAK,aAAa,EAElB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,UAAU,EAChB,MAAM,YAAY,CAAA;AAenB;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,UAAU,EACjB,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,IAAI,CAAC,aAAa,EAAE,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC,CA8DjD;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,gBAAgB,GAAG,eAAe,CAqCnG;AAID;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,QAAQ,EACjB,QAAQ,EAAE,OAAO,EACjB,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,QAAQ,CAYV;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,QAAQ,EACjB,UAAU,EAAE,QAAQ,EACpB,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,gBAAgB,GACzB,GAAG,CAAC,MAAM,CAAC,CAqBb;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,gBAAgB,GAAG,GAAG,CAAC,MAAM,CAAC,CAQ5F;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,eAAe,EAAE,QAAQ,EACzB,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,QAAQ,EAAE,OAAO,EACjB,QAAQ,EAAE,gBAAgB,GACzB;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAA;CAAE,CA4B1C;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE;IACP,QAAQ,EAAE,gBAAgB,CAAA;IAC1B,UAAU,EAAE,QAAQ,CAAA;IACpB,QAAQ,EAAE,QAAQ,CAAA;IAClB,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CACzB,GACA,aAAa,EAAE,CAsCjB;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,UAAU,EAAE,EACxB,QAAQ,EAAE,gBAAgB,EAC1B,UAAU,EAAE,QAAQ,EACpB,QAAQ,EAAE,QAAQ,GACjB,aAAa,EAAE,CA0EjB"}

package/dist/ics-parser/event-expander.js

@@ -0,0 +1,328 @@
+import { DateTime, Duration } from 'luxon';
+import { IcsError } from './errors.js';
+import { parseCalAddress, parseCategories, parseDateTimeList, parseGeo, parseIcsDateTime, parseInteger, parseRruleString, parseString, } from './property-parsers.js';
+import { expandRrule } from './rrule-expander.js';
+import { findProperty, findProperties } from './utils.js';
+/**
+ * Parses a date-time property into an ISO 8601 string.
+ * @param prop - The ICS property.
+ * @returns An ISO 8601 string or undefined.
+ */
+function parseDateTimeValue(prop, resolver) {
+    if (!prop)
+        return undefined;
+    // Note: This does not resolve timezones, it just formats the parsed time to UTC.
+    // This is suitable for properties like CREATED and LAST-MODIFIED which are often in UTC.
+    return parseIcsDateTime(prop, resolver).toUTC().toISO() ?? undefined;
+}
+/**
+ * Gathers all standard and custom properties from a VEVENT component.
+ * @param event - The VEVENT component.
+ * @returns A partially filled ExpandedEvent object containing all static details.
+ */
+export function extractEventDetails(event, resolver) {
+    const customProperties = {};
+    const knownKeys = new Set([
+        'UID',
+        'SUMMARY',
+        'DTSTART',
+        'DTEND',
+        'DURATION',
+        'RRULE',
+        'RDATE',
+        'EXDATE',
+        'DESCRIPTION',
+        'LOCATION',
+        'STATUS',
+        'CLASS',
+        'CREATED',
+        'LAST-MODIFIED',
+        'SEQUENCE',
+        'ORGANIZER',
+        'ATTENDEE',
+        'CATEGORIES',
+        'PRIORITY',
+        'TRANSP',
+        'URL',
+        'GEO',
+        'RECURRENCE-ID',
+    ]);
+    for (const prop of event.properties) {
+        if (prop.key.startsWith('X-') || !knownKeys.has(prop.key)) {
+            // Per RFC 5545, non-standard and IANA properties can be included.
+            // We store them in a dedicated nested object.
+            customProperties[prop.key] = prop;
+        }
+    }
+    const attendees = findProperties(event, 'ATTENDEE')
+        .map(parseCalAddress)
+        .filter((a) => !!a);
+    const categories = parseCategories(findProperties(event, 'CATEGORIES')).filter((a) => !!a);
+    return {
+        uid: findProperty(event, 'UID')?.value ?? `generated-${Math.random()}`,
+        summary: parseString(findProperty(event, 'SUMMARY')) ?? '(No Summary)',
+        description: parseString(findProperty(event, 'DESCRIPTION')),
+        location: parseString(findProperty(event, 'LOCATION')),
+        status: parseString(findProperty(event, 'STATUS')),
+        class: parseString(findProperty(event, 'CLASS')),
+        created: parseDateTimeValue(findProperty(event, 'CREATED'), resolver),
+        lastModified: parseDateTimeValue(findProperty(event, 'LAST-MODIFIED'), resolver),
+        sequence: parseInteger(findProperty(event, 'SEQUENCE')),
+        organizer: parseCalAddress(findProperty(event, 'ORGANIZER')),
+        attendees: attendees.length > 0 ? attendees : undefined,
+        categories: categories.length > 0 ? categories : undefined,
+        priority: parseInteger(findProperty(event, 'PRIORITY')),
+        transp: parseString(findProperty(event, 'TRANSP')),
+        url: parseString(findProperty(event, 'URL')),
+        geo: parseGeo(findProperty(event, 'GEO')),
+        recurrenceId: parseDateTimeValue(findProperty(event, 'RECURRENCE-ID'), resolver),
+        customProperties: Object.keys(customProperties).length > 0 ? customProperties : undefined,
+    };
+}
+/**
+ * Parses a single VEVENT component into a structured but unexpanded event object,
+ * including parsed recurrence rules.
+ * @param event - The VEVENT component.
+ * @param resolver - The timezone resolver function.
+ * @returns An UnexpandedEvent object.
+ * @throws {IcsError} If the VEVENT component is missing a DTSTART property.
+ */
+export function parseUnexpandedEvent(event, resolver) {
+    const eventDetails = extractEventDetails(event, resolver);
+    const dtstartProp = findProperty(event, 'DTSTART');
+    if (!dtstartProp) {
+        throw new IcsError(`Event with UID "${eventDetails.uid}" is missing a DTSTART property.`);
+    }
+    const tzid = dtstartProp.params['TZID'];
+    const isAllDay = dtstartProp.params['VALUE'] === 'DATE';
+    const dtstart = parseIcsDateTime(dtstartProp, resolver);
+    const duration = getEventDuration(event, dtstart, isAllDay, resolver);
+    const { startUtc, endUtc } = applyTimeZone(dtstart, duration, tzid, isAllDay, resolver);
+    const rruleProp = findProperty(event, 'RRULE');
+    const rrule = rruleProp ? parseRruleString(rruleProp.value) : undefined;
+    const rdates = findProperties(event, 'RDATE')
+        .flatMap((prop) => parseDateTimeList(prop, resolver))
+        .map((dt) => dt.toISO())
+        .filter((d) => !!d);
+    const exdates = findProperties(event, 'EXDATE')
+        .flatMap((prop) => parseDateTimeList(prop, resolver))
+        .map((dt) => dt.toISO())
+        .filter((d) => !!d);
+    return {
+        ...eventDetails,
+        start: startUtc.toISO(),
+        end: endUtc.toISO() ?? undefined,
+        allDay: isAllDay,
+        rrule: rrule,
+        rdates: rdates.length > 0 ? rdates : undefined,
+        exdates: exdates.length > 0 ? exdates : undefined,
+    };
+}
+// --- Core Expansion Logic ---
+/**
+ * Determines the duration of an event from its DTEND or DURATION property.
+ * @param event - The VEVENT component.
+ * @param dtstart - The start time of the event.
+ * @param isAllDay - Whether the event is an all-day event.
+ * @returns A Luxon Duration object.
+ */
+export function getEventDuration(event, dtstart, isAllDay, resolver) {
+    const dtendProp = findProperty(event, 'DTEND');
+    if (dtendProp) {
+        return parseIcsDateTime(dtendProp, resolver).diff(dtstart);
+    }
+    const durationProp = findProperty(event, 'DURATION');
+    if (durationProp) {
+        return Duration.fromISO(durationProp.value);
+    }
+    // For all-day events without DTEND/DURATION, the duration is one day.
+    // For timed events, it's zero length (ends at the same time it starts).
+    return isAllDay ? Duration.fromObject({ days: 1 }) : Duration.fromMillis(0);
+}
+/**
+ * Gathers all inclusion dates from RRULE and RDATE properties.
+ * @returns A Set of timestamps in milliseconds.
+ */
+export function getInclusionDates(event, dtstart, rangeStart, rangeEnd, resolver) {
+    const dates = new Set();
+    dates.add(dtstart.toMillis());
+    const rruleProp = findProperty(event, 'RRULE');
+    if (rruleProp) {
+        const rule = parseRruleString(rruleProp.value);
+        const instances = expandRrule({ dtstart, rule, rangeStart, rangeEnd });
+        if (instances) {
+            for (const instance of instances) {
+                dates.add(instance.toMillis());
+            }
+        }
+    }
+    findProperties(event, 'RDATE').forEach((prop) => {
+        for (const date of parseDateTimeList(prop, resolver)) {
+            dates.add(date.toMillis());
+        }
+    });
+    return dates;
+}
+/**
+ * Gathers all exclusion dates from the EXDATE property.
+ * @returns A Set of timestamps in milliseconds.
+ */
+export function getExclusionDates(event, resolver) {
+    const dates = new Set();
+    findProperties(event, 'EXDATE').forEach((prop) => {
+        for (const date of parseDateTimeList(prop, resolver)) {
+            dates.add(date.toMillis());
+        }
+    });
+    return dates;
+}
+/**
+ * Converts a single local occurrence to a UTC start/end object using a timezone resolver.
+ * @returns UTC start and end DateTimes.
+ */
+export function applyTimeZone(occurrenceStart, duration, tzid, isAllDay, resolver) {
+    // All-day events don't have a time-of-day, so we treat them as starting at midnight
+    // in the specified timezone, or in UTC if no timezone is given.
+    if (isAllDay) {
+        const startOfDay = occurrenceStart.startOf('day');
+        const startUtc = tzid
+            ? startOfDay.setZone('utc', { keepLocalTime: true }).minus({ minutes: resolver(startOfDay, tzid) })
+            : startOfDay.toUTC();
+        const endUtc = startUtc.plus(duration);
+        return { startUtc, endUtc };
+    }
+    // Floating time (no TZID) is interpreted as UTC per our convention.
+    if (!tzid) {
+        const startUtc = occurrenceStart.setZone('utc', { keepLocalTime: true });
+        return { startUtc, endUtc: startUtc.plus(duration) };
+    }
+    // For timed events with a TZID, we convert the local time to UTC by subtracting the offset.
+    const startUtc = occurrenceStart
+        .setZone('utc', { keepLocalTime: true })
+        .minus({ minutes: resolver(occurrenceStart, tzid) });
+    // The end time offset might be different if the event crosses a DST boundary.
+    const occurrenceEnd = occurrenceStart.plus(duration);
+    const endUtc = occurrenceEnd.setZone('utc', { keepLocalTime: true }).minus({ minutes: resolver(occurrenceEnd, tzid) });
+    return { startUtc, endUtc };
+}
+/**
+ * Expands a single VEVENT component into a list of concrete occurrences.
+ * This is a low-level function that handles recurrence for a single component.
+ * Use `expandCalendar` for processing a full calendar with UID-based modifications.
+ *
+ * @param event - The VEVENT component to expand.
+ * @param options - Expansion options including the resolver and time range.
+ * @returns An array of ExpandedEvent objects.
+ * @throws {IcsError} If the VEVENT component is missing a DTSTART property.
+ */
+export function expandEvent(event, options) {
+    const { resolver, rangeStart, rangeEnd, exclusions } = options;
+    const dtstartProp = findProperty(event, 'DTSTART');
+    const eventDetails = extractEventDetails(event, resolver);
+    if (!dtstartProp) {
+        // According to RFC 5545, DTSTART is required for VEVENTs in most cases.
+        throw new IcsError(`Event with UID "${eventDetails.uid}" is missing a DTSTART property.`);
+    }
+    const tzid = dtstartProp.params['TZID'] === 'Romance Standard Time' ? 'Europe/Paris' : dtstartProp.params['TZID'];
+    // The 'VALUE=DATE' parameter indicates an all-day event.
+    const isAllDay = dtstartProp.params['VALUE'] === 'DATE';
+    const dtstart = parseIcsDateTime(dtstartProp, resolver);
+    const duration = getEventDuration(event, dtstart, isAllDay, resolver);
+    const inclusionDates = getInclusionDates(event, dtstart, rangeStart, rangeEnd, resolver);
+    const exclusionDates = exclusions ?? getExclusionDates(event, resolver);
+    const finalEvents = [];
+    for (const millis of inclusionDates) {
+        if (exclusionDates.has(millis))
+            continue;
+        const occurrenceStart = DateTime.fromMillis(millis, { zone: dtstart.zone });
+        const { startUtc, endUtc } = applyTimeZone(occurrenceStart, duration, tzid, isAllDay, resolver);
+        // Filter out occurrences that do not overlap with the query range.
+        if (startUtc < rangeEnd && endUtc > rangeStart) {
+            finalEvents.push({
+                ...eventDetails,
+                start: startUtc.toISO(),
+                end: endUtc.toISO() ?? undefined,
+                allDay: isAllDay,
+            });
+        }
+    }
+    return finalEvents;
+}
+/**
+ * Expands all VEVENT components from a calendar, correctly handling recurring events
+ * and their modifications (exceptions) based on UID and RECURRENCE-ID.
+ *
+ * @param components - All VComponents parsed from an iCalendar file.
+ * @param resolver - The timezone resolver function.
+ * @param rangeStart - The start of the query range.
+ * @param rangeEnd - The end of the query range.
+ * @returns A consolidated array of all expanded event occurrences.
+ */
+export function expandCalendar(components, resolver, rangeStart, rangeEnd) {
+    const events = components.filter((c) => c.type === 'VEVENT');
+    const eventsByUid = new Map();
+    const eventsWithoutUid = [];
+    // 1. Group all VEVENTs by their UID.
+    for (const event of events) {
+        const uid = findProperty(event, 'UID')?.value;
+        if (uid) {
+            if (!eventsByUid.has(uid)) {
+                eventsByUid.set(uid, []);
+            }
+            eventsByUid.get(uid)?.push(event);
+        }
+        else {
+            // Handle events without a UID as standalone. They cannot be part of a
+            // recurrence set with overrides.
+            eventsWithoutUid.push(event);
+        }
+    }
+    const allExpandedEvents = [];
+    // 2. Process each UID group.
+    for (const group of eventsByUid.values()) {
+        const masterEvent = group.find((e) => findProperty(e, 'RRULE') && !findProperty(e, 'RECURRENCE-ID'));
+        const exceptionEvents = group.filter((e) => findProperty(e, 'RECURRENCE-ID'));
+        const singleEvents = group.filter((e) => !findProperty(e, 'RRULE') && !findProperty(e, 'RECURRENCE-ID'));
+        // 3. Gather all dates to be excluded from the master recurring event.
+        // This includes both EXDATEs from the master and RECURRENCE-IDs from exceptions.
+        const combinedExclusions = new Set();
+        if (masterEvent) {
+            getExclusionDates(masterEvent, resolver).forEach((d) => combinedExclusions.add(d));
+        }
+        for (const ex of exceptionEvents) {
+            const recurrenceIdProp = findProperty(ex, 'RECURRENCE-ID');
+            if (recurrenceIdProp) {
+                // Parse RECURRENCE-ID to get a comparable millisecond timestamp.
+                const recurrenceDate = parseIcsDateTime(recurrenceIdProp, resolver);
+                combinedExclusions.add(recurrenceDate.toMillis());
+            }
+        }
+        // 4. Expand the master event, applying the combined exclusions.
+        if (masterEvent) {
+            const masterOccurrences = expandEvent(masterEvent, {
+                resolver,
+                rangeStart,
+                rangeEnd,
+                exclusions: combinedExclusions,
+            });
+            allExpandedEvents.push(...masterOccurrences);
+        }
+        // 5. Expand all exception events. These are treated as individual appointments.
+        for (const ex of exceptionEvents) {
+            const exceptionOccurrence = expandEvent(ex, { resolver, rangeStart, rangeEnd });
+            allExpandedEvents.push(...exceptionOccurrence);
+        }
+        // 6. Expand any standalone (non-recurring) events in the group.
+        for (const single of singleEvents) {
+            const singleOccurrence = expandEvent(single, { resolver, rangeStart, rangeEnd });
+            allExpandedEvents.push(...singleOccurrence);
+        }
+    }
+    // 7. Expand all events that didn't have a UID.
+    for (const single of eventsWithoutUid) {
+        const singleOccurrence = expandEvent(single, { resolver, rangeStart, rangeEnd });
+        allExpandedEvents.push(...singleOccurrence);
+    }
+    return allExpandedEvents;
+}
+//# sourceMappingURL=event-expander.js.map

package/dist/ics-parser/event-expander.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-expander.js","sourceRoot":"","sources":["../../src/ics-parser/event-expander.ts"],"names":[],"mappings":"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"}

package/dist/ics-parser/index.d.ts

@@ -0,0 +1,67 @@
+import { type ExpandedEvent, type TimeZoneData, type UnexpandedEvent, type VComponent } from './types.js';
+export { ExpandedEvent, UnexpandedEvent } from './types.js';
+/**
+ * Represents the pre-processed, structured data from an ICS file.
+ * This object contains the VEVENT components and a `Map` of processed VTIMEZONE
+ * data. While the `Map` itself isn't directly serializable, the `serialize`
+ * and `deserialize` functions handle its conversion to/from a JSON-compatible format.
+ */
+export interface PreparedIcs {
+    /**
+     * An array of all VEVENT components found in the ICS file.
+     */
+    events: VComponent[];
+    /**
+     * A map from a Time Zone ID (TZID) to its structured `TimeZoneData`.
+     */
+    tzData: Map<string, TimeZoneData>;
+}
+/**
+ * Parses a raw ICS string and prepares it for event expansion.
+ * This function performs the initial parsing of the ICS data into a structured
+ * format containing event components and processed timezone information.
+ * The result can be serialized for caching.
+ *
+ * @param icsString - The full content of the .ics file.
+ * @returns A `PreparedIcs` object containing parsed events and a `Map` of timezone data.
+ */
+export declare function prepare(icsString: string): PreparedIcs;
+/**
+ * Serializes the prepared ICS data into a JSON string for caching.
+ * It converts the `tzData` Map into an array of `[key, value]` pairs under
+ * a `timezones` key to ensure it is JSON-serializable.
+ *
+ * @param preparedIcs - The `PreparedIcs` object to serialize.
+ * @returns A JSON string representation of the prepared data.
+ */
+export declare function serialize({ events, tzData }: PreparedIcs): string;
+/**
+ * Deserializes a JSON string back into a `PreparedIcs` object.
+ * It expects the JSON to contain an `events` array and a `timezones` array,
+ * which it uses to reconstruct the `tzData` Map.
+ *
+ * @param jsonString - The JSON string to deserialize from a cache.
+ * @returns The deserialized `PreparedIcs` object with a reconstructed `tzData` Map.
+ */
+export declare function deserialize(jsonString: string): PreparedIcs;
+/**
+ * Expands all recurring events from the prepared data within a given time range.
+ * This is the second step after `prepare`, taking the structured data and a date range
+ * to generate the final list of event occurrences.
+ *
+ * @param preparedIcs - The `PreparedIcs` object from `prepare` or `deserialize`.
+ * @param rangeStartIso - The start of the desired time frame (UTC ISO string).
+ * @param rangeEndIso - The end of the desired time frame (UTC ISO string).
+ * @returns An array of all event occurrences within the range, sorted by start time.
+ */
+export declare function getEventsBetween({ events, tzData }: PreparedIcs, rangeStartIso: string, rangeEndIso: string): ExpandedEvent[];
+/**
+ * Parses all VEVENT components into a structured, but not expanded, format.
+ * This is ideal for searching, as it provides all event details without generating
+ * every single recurrence instance.
+ *
+ * @param preparedIcs - The `PreparedIcs` object from `prepare` or `deserialize`.
+ * @returns An array of `UnexpandedEvent` objects.
+ */
+export declare function getUnexpandedEvents({ events, tzData }: PreparedIcs): UnexpandedEvent[];
+//# sourceMappingURL=index.d.ts.map

package/dist/ics-parser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ics-parser/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,KAAK,eAAe,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAA;AACzG,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAE3D;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,MAAM,EAAE,UAAU,EAAE,CAAA;IACpB;;OAEG;IACH,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;CAClC;AAED;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,CAQtD;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,WAAW,GAAG,MAAM,CAKjE;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,CAS3D;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,WAAW,EAC/B,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,GAClB,aAAa,EAAE,CAUjB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,WAAW,GAAG,eAAe,EAAE,CActF"}

package/dist/ics-parser/index.js

@@ -0,0 +1,91 @@
+import { DateTime } from 'luxon';
+import { expandCalendar, parseUnexpandedEvent } from './event-expander.js';
+import { parseIcs } from './parser.js';
+import { buildTimeZoneData, createTimeZoneResolver } from './timezone-processor.js';
+/**
+ * Parses a raw ICS string and prepares it for event expansion.
+ * This function performs the initial parsing of the ICS data into a structured
+ * format containing event components and processed timezone information.
+ * The result can be serialized for caching.
+ *
+ * @param icsString - The full content of the .ics file.
+ * @returns A `PreparedIcs` object containing parsed events and a `Map` of timezone data.
+ */
+export function prepare(icsString) {
+    const { timezones, events } = parseIcs(icsString);
+    const tzData = buildTimeZoneData(timezones);
+    return {
+        events,
+        tzData,
+    };
+}
+/**
+ * Serializes the prepared ICS data into a JSON string for caching.
+ * It converts the `tzData` Map into an array of `[key, value]` pairs under
+ * a `timezones` key to ensure it is JSON-serializable.
+ *
+ * @param preparedIcs - The `PreparedIcs` object to serialize.
+ * @returns A JSON string representation of the prepared data.
+ */
+export function serialize({ events, tzData }) {
+    return JSON.stringify({
+        events: events,
+        timezones: Array.from(tzData.entries()),
+    });
+}
+/**
+ * Deserializes a JSON string back into a `PreparedIcs` object.
+ * It expects the JSON to contain an `events` array and a `timezones` array,
+ * which it uses to reconstruct the `tzData` Map.
+ *
+ * @param jsonString - The JSON string to deserialize from a cache.
+ * @returns The deserialized `PreparedIcs` object with a reconstructed `tzData` Map.
+ */
+export function deserialize(jsonString) {
+    const { events, timezones } = JSON.parse(jsonString);
+    return {
+        events,
+        tzData: new Map(timezones),
+    };
+}
+/**
+ * Expands all recurring events from the prepared data within a given time range.
+ * This is the second step after `prepare`, taking the structured data and a date range
+ * to generate the final list of event occurrences.
+ *
+ * @param preparedIcs - The `PreparedIcs` object from `prepare` or `deserialize`.
+ * @param rangeStartIso - The start of the desired time frame (UTC ISO string).
+ * @param rangeEndIso - The end of the desired time frame (UTC ISO string).
+ * @returns An array of all event occurrences within the range, sorted by start time.
+ */
+export function getEventsBetween({ events, tzData }, rangeStartIso, rangeEndIso) {
+    const timeZoneResolver = createTimeZoneResolver(tzData);
+    const rangeStart = DateTime.fromISO(rangeStartIso, { zone: 'utc' });
+    const rangeEnd = DateTime.fromISO(rangeEndIso, { zone: 'utc' });
+    const finalEvents = expandCalendar(events, timeZoneResolver, rangeStart, rangeEnd);
+    finalEvents.sort((a, b) => a.start.localeCompare(b.start));
+    return finalEvents;
+}
+/**
+ * Parses all VEVENT components into a structured, but not expanded, format.
+ * This is ideal for searching, as it provides all event details without generating
+ * every single recurrence instance.
+ *
+ * @param preparedIcs - The `PreparedIcs` object from `prepare` or `deserialize`.
+ * @returns An array of `UnexpandedEvent` objects.
+ */
+export function getUnexpandedEvents({ events, tzData }) {
+    const timeZoneResolver = createTimeZoneResolver(tzData);
+    const unexpandedEvents = [];
+    for (const event of events) {
+        try {
+            unexpandedEvents.push(parseUnexpandedEvent(event, timeZoneResolver));
+        }
+        catch (e) {
+            // Silently ignore events that fail to parse (e.g., missing DTSTART).
+            // This is acceptable for search, where we just skip unsearchable items.
+        }
+    }
+    return unexpandedEvents;
+}
+//# sourceMappingURL=index.js.map

package/dist/ics-parser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ics-parser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAEhC,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAC1E,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AAqBnF;;;;;;;;GAQG;AACH,MAAM,UAAU,OAAO,CAAC,SAAiB;IACvC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAA;IACjD,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAA;IAE3C,OAAO;QACL,MAAM;QACN,MAAM;KACP,CAAA;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,EAAe;IACvD,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,MAAM,EAAE,MAAM;QACd,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;KACxC,CAAC,CAAA;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,UAAkB;IAC5C,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAGlD,CAAA;IACD,OAAO;QACL,MAAM;QACN,MAAM,EAAE,IAAI,GAAG,CAAC,SAAS,CAAC;KAC3B,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAC9B,EAAE,MAAM,EAAE,MAAM,EAAe,EAC/B,aAAqB,EACrB,WAAmB;IAEnB,MAAM,gBAAgB,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAA;IAEvD,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IACnE,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IAE/D,MAAM,WAAW,GAAG,cAAc,CAAC,MAAM,EAAE,gBAAgB,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAA;IAClF,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAA;IAE1D,OAAO,WAAW,CAAA;AACpB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAe;IACjE,MAAM,gBAAgB,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAA;IACvD,MAAM,gBAAgB,GAAsB,EAAE,CAAA;IAE9C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,gBAAgB,CAAC,IAAI,CAAC,oBAAoB,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAA;QACtE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,qEAAqE;YACrE,wEAAwE;QAC1E,CAAC;IACH,CAAC;IAED,OAAO,gBAAgB,CAAA;AACzB,CAAC"}