@mcp-monorepo/ics 1.1.0 → 1.3.0

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

@@ -0,0 +1,26 @@
+import { type VComponent, type IcsProperty, type ParsedIcs } from './types.js';
+/**
+ * Unfolds multi-line properties in an ICS file.
+ * @param rawLines - An array of lines from the ICS file.
+ * @returns An array of unfolded lines.
+ */
+export declare function unfoldLines(rawLines: string[]): string[];
+/**
+ * Parses a single line into a property with a key, value, and parameters.
+ * @param line - An unfolded line from the ICS file.
+ * @returns An IcsProperty object or undefined if the line is invalid.
+ */
+export declare function parseProperty(line: string): IcsProperty | undefined;
+/**
+ * Parses an array of lines into a tree of VComponents.
+ * @param lines - An array of unfolded ICS lines.
+ * @returns An array of top-level VComponents.
+ */
+export declare function buildComponentTree(lines: string[]): VComponent[];
+/**
+ * Parses a raw ICS string into a structured object containing events and timezones.
+ * @param icsString - The full content of the .ics file.
+ * @returns A ParsedIcs object.
+ */
+export declare function parseIcs(icsString: string): ParsedIcs;
+//# sourceMappingURL=parser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/ics-parser/parser.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAA;AAE9E;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAiBxD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAqBnE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU,EAAE,CAyBhE;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAcrD"}

package/dist/ics-parser/parser.js

@@ -0,0 +1,99 @@
+import { CalendarNotFoundError } from './errors.js';
+/**
+ * Unfolds multi-line properties in an ICS file.
+ * @param rawLines - An array of lines from the ICS file.
+ * @returns An array of unfolded lines.
+ */
+export function unfoldLines(rawLines) {
+    const unfolded = [];
+    let currentLine = '';
+    for (const line of rawLines) {
+        if (line.startsWith(' ') || line.startsWith('\t')) {
+            currentLine += line.substring(1);
+        }
+        else {
+            if (currentLine) {
+                unfolded.push(currentLine);
+            }
+            currentLine = line;
+        }
+    }
+    if (currentLine) {
+        unfolded.push(currentLine);
+    }
+    return unfolded;
+}
+/**
+ * Parses a single line into a property with a key, value, and parameters.
+ * @param line - An unfolded line from the ICS file.
+ * @returns An IcsProperty object or undefined if the line is invalid.
+ */
+export function parseProperty(line) {
+    const separatorIndex = line.indexOf(':');
+    if (separatorIndex === -1) {
+        return undefined;
+    }
+    const keyPart = line.substring(0, separatorIndex);
+    const value = line.substring(separatorIndex + 1);
+    const keySegments = keyPart.split(';');
+    const key = keySegments[0];
+    const params = {};
+    for (let i = 1; i < keySegments.length; i++) {
+        const [paramKey, paramValue] = keySegments[i].split('=');
+        if (paramKey && paramValue) {
+            params[paramKey] = paramValue;
+        }
+    }
+    return { key, value, params };
+}
+/**
+ * Parses an array of lines into a tree of VComponents.
+ * @param lines - An array of unfolded ICS lines.
+ * @returns An array of top-level VComponents.
+ */
+export function buildComponentTree(lines) {
+    const componentStack = [];
+    const topLevelComponents = [];
+    for (const line of lines) {
+        if (line.startsWith('BEGIN:')) {
+            const type = line.substring(6).trim();
+            const newComponent = { type, properties: [], subComponents: [] };
+            if (componentStack.length > 0) {
+                componentStack[componentStack.length - 1].subComponents.push(newComponent);
+            }
+            componentStack.push(newComponent);
+        }
+        else if (line.startsWith('END:')) {
+            const endedComponent = componentStack.pop();
+            if (endedComponent && componentStack.length === 0) {
+                topLevelComponents.push(endedComponent);
+            }
+        }
+        else if (componentStack.length > 0) {
+            const prop = parseProperty(line);
+            if (prop) {
+                componentStack[componentStack.length - 1].properties.push(prop);
+            }
+        }
+    }
+    return topLevelComponents;
+}
+/**
+ * Parses a raw ICS string into a structured object containing events and timezones.
+ * @param icsString - The full content of the .ics file.
+ * @returns A ParsedIcs object.
+ */
+export function parseIcs(icsString) {
+    const rawLines = icsString.replace(/\r\n/g, '\n').split('\n');
+    const unfolded = unfoldLines(rawLines);
+    const allComponents = buildComponentTree(unfolded);
+    const calendar = allComponents.find((c) => c.type === 'VCALENDAR');
+    if (!calendar) {
+        throw new CalendarNotFoundError();
+    }
+    return {
+        events: calendar.subComponents.filter((c) => c.type === 'VEVENT'),
+        timezones: calendar.subComponents.filter((c) => c.type === 'VTIMEZONE'),
+    };
+}
+//# sourceMappingURL=parser.js.map

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

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

package/dist/ics-parser/property-parsers.d.ts

@@ -0,0 +1,66 @@
+import { DateTime } from 'luxon';
+import { type CalAddress, type Geo, type IcsProperty, type RecurrenceRule, type TimeZoneResolver } from './types.js';
+/**
+ * Extracts the raw string value from an ICS property.
+ * @param prop - The ICS property.
+ * @returns The string value or undefined.
+ */
+export declare function parseString(prop: IcsProperty | undefined): string | undefined;
+/**
+ * Parses the string value of an ICS property into an integer.
+ * @param prop - The ICS property.
+ * @returns The integer value or undefined if parsing fails.
+ */
+export declare function parseInteger(prop: IcsProperty | undefined): number | undefined;
+/**
+ * Parses one or more CATEGORIES properties into a flat array of category strings.
+ * Handles comma-separated values within a single property.
+ * @param props - An array of CATEGORIES properties.
+ * @returns An array of category strings.
+ */
+export declare function parseCategories(props: IcsProperty[]): string[];
+/**
+ * Parses a GEO property value (e.g., '37.386013;-122.082932') into a structured Geo object.
+ * @param prop - The GEO property.
+ * @returns A Geo object or undefined if parsing fails.
+ */
+export declare function parseGeo(prop: IcsProperty | undefined): Geo | undefined;
+/**
+ * Parses a calendar user address property (like ORGANIZER or ATTENDEE) into a structured CalAddress object,
+ * extracting the email, common name, and other parameters.
+ * @param prop - The ICS property for a calendar user.
+ * @returns A CalAddress object or undefined.
+ */
+export declare function parseCalAddress(prop: IcsProperty | undefined): CalAddress | undefined;
+/**
+ * Parses an iCalendar DATE-TIME or DATE property into a Luxon DateTime object.
+ * Handles different formats, including date-only values, UTC time, and times with a TZID parameter.
+ * It uses the provided timezone resolver for VTIMEZONE definitions and falls back to Luxon's
+ * built-in IANA database for standard timezones.
+ * @param prop - The IcsProperty containing the date value and parameters.
+ * @param resolver - The optional timezone resolver for VTIMEZONE components.
+ * @returns A Luxon DateTime object.
+ */
+export declare function parseIcsDateTime(prop: IcsProperty, resolver?: TimeZoneResolver): DateTime;
+/**
+ * Parses an iCalendar UTC offset string (e.g., "+0100" or "-0500") into minutes.
+ * @param offsetString - The UTC offset string from a TZOFFSETFROM or TZOFFSETTO property.
+ * @returns The offset in total minutes.
+ */
+export declare function parseOffset(offsetString: string): number;
+/**
+ * Parses a property containing a comma-separated list of date or date-time values
+ * (e.g., from an RDATE or EXDATE property) into an array of Luxon DateTime objects.
+ * @param prop - The IcsProperty containing the comma-separated date values.
+ * @param resolver - The optional timezone resolver.
+ * @returns An array of Luxon DateTime objects.
+ */
+export declare function parseDateTimeList(prop: IcsProperty, resolver?: TimeZoneResolver): DateTime[];
+/**
+ * Parses a raw RRULE string into a structured `RecurrenceRule` object, breaking
+ * down its components like FREQ, UNTIL, BYDAY, etc..
+ * @param rruleString - The raw value of the RRULE property.
+ * @returns A structured RecurrenceRule object.
+ */
+export declare function parseRruleString(rruleString: string): RecurrenceRule;
+//# sourceMappingURL=property-parsers.d.ts.map

package/dist/ics-parser/property-parsers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"property-parsers.d.ts","sourceRoot":"","sources":["../../src/ics-parser/property-parsers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAmB,MAAM,OAAO,CAAA;AAGjD,OAAO,EACL,KAAK,UAAU,EAEf,KAAK,GAAG,EACR,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EAEtB,MAAM,YAAY,CAAA;AAInB;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAE7E;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAI9E;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,MAAM,EAAE,CAO9D;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,GAAG,GAAG,SAAS,CAKvE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAQrF;AAID;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,gBAAgB,GAAG,QAAQ,CA6CzF;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAQxD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,gBAAgB,GAAG,QAAQ,EAAE,CAE5F;AAID;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CA8EpE"}

package/dist/ics-parser/property-parsers.js

@@ -0,0 +1,226 @@
+import { DateTime, FixedOffsetZone } from 'luxon';
+import { InvalidRruleError, TimeZoneDefinitionNotFoundError } from './errors.js';
+// --- Primitive & Simple Structure Parsers ---
+/**
+ * Extracts the raw string value from an ICS property.
+ * @param prop - The ICS property.
+ * @returns The string value or undefined.
+ */
+export function parseString(prop) {
+    return prop?.value;
+}
+/**
+ * Parses the string value of an ICS property into an integer.
+ * @param prop - The ICS property.
+ * @returns The integer value or undefined if parsing fails.
+ */
+export function parseInteger(prop) {
+    if (!prop?.value)
+        return undefined;
+    const num = parseInt(prop.value, 10);
+    return isNaN(num) ? undefined : num;
+}
+/**
+ * Parses one or more CATEGORIES properties into a flat array of category strings.
+ * Handles comma-separated values within a single property.
+ * @param props - An array of CATEGORIES properties.
+ * @returns An array of category strings.
+ */
+export function parseCategories(props) {
+    return props.flatMap((p) => p.value
+        .split(',')
+        .map((cat) => cat.trim())
+        .filter(Boolean));
+}
+/**
+ * Parses a GEO property value (e.g., '37.386013;-122.082932') into a structured Geo object.
+ * @param prop - The GEO property.
+ * @returns A Geo object or undefined if parsing fails.
+ */
+export function parseGeo(prop) {
+    if (!prop?.value)
+        return undefined;
+    const [lat, lon] = prop.value.split(';').map(parseFloat);
+    if (isNaN(lat) || isNaN(lon))
+        return undefined;
+    return { lat, lon };
+}
+/**
+ * Parses a calendar user address property (like ORGANIZER or ATTENDEE) into a structured CalAddress object,
+ * extracting the email, common name, and other parameters.
+ * @param prop - The ICS property for a calendar user.
+ * @returns A CalAddress object or undefined.
+ */
+export function parseCalAddress(prop) {
+    if (!prop?.value)
+        return undefined;
+    return {
+        email: prop.value.replace(/^mailto:/i, ''),
+        commonName: prop.params['CN'],
+        partstat: prop.params['PARTSTAT'],
+        role: prop.params['ROLE'],
+    };
+}
+// --- Date, Time & Offset Parsers ---
+/**
+ * Parses an iCalendar DATE-TIME or DATE property into a Luxon DateTime object.
+ * Handles different formats, including date-only values, UTC time, and times with a TZID parameter.
+ * It uses the provided timezone resolver for VTIMEZONE definitions and falls back to Luxon's
+ * built-in IANA database for standard timezones.
+ * @param prop - The IcsProperty containing the date value and parameters.
+ * @param resolver - The optional timezone resolver for VTIMEZONE components.
+ * @returns A Luxon DateTime object.
+ */
+export function parseIcsDateTime(prop, resolver) {
+    const { value, params } = prop;
+    const tzid = params['TZID'] === 'Romance Standard Time' ? 'Europe/Paris' : params['TZID'];
+    const isDateOnly = params['VALUE'] === 'DATE';
+    if (isDateOnly) {
+        // For date-only values, parse as a date and treat it as local or in the specified zone's start of day.
+        return DateTime.fromFormat(value, 'yyyyMMdd', { zone: tzid || 'local' });
+    }
+    if (value.endsWith('Z')) {
+        // Value is explicitly in UTC.
+        return DateTime.fromISO(value, { zone: 'utc' });
+    }
+    if (tzid && resolver) {
+        try {
+            const localDt = DateTime.fromFormat(value, "yyyyMMdd'T'HHmmss", { zone: 'local' });
+            if (!localDt.isValid)
+                return localDt;
+            const offsetMinutes = resolver(localDt, tzid);
+            const zone = FixedOffsetZone.instance(offsetMinutes);
+            return localDt.setZone(zone, { keepLocalTime: true });
+        }
+        catch (error) {
+            if (!(error instanceof TimeZoneDefinitionNotFoundError)) {
+                throw error; // Re-throw unexpected errors.
+            }
+            // If a TimeZoneDefinitionNotFoundError is caught, it means the TZID was not in the VTIMEZONE components.
+            // We fall through to let Luxon try and resolve it as a standard IANA timezone.
+        }
+    }
+    if (tzid) {
+        // Per RFC 5545, parse with the specified timezone identifier.
+        // Fallback logic for standard IANA timezones (e.g., 'Europe/Paris') or when resolver fails.
+        // Luxon handles DST gaps by rolling forward to the next valid time,
+        // which correctly determines the absolute instant in time.
+        return DateTime.fromFormat(value, "yyyyMMdd'T'HHmmss", { zone: tzid });
+    }
+    // A time without 'Z' or TZID is a "floating" time.
+    // We parse it as local time according to the machine's settings.
+    return DateTime.fromFormat(value, "yyyyMMdd'T'HHmmss", { zone: 'local' });
+}
+/**
+ * Parses an iCalendar UTC offset string (e.g., "+0100" or "-0500") into minutes.
+ * @param offsetString - The UTC offset string from a TZOFFSETFROM or TZOFFSETTO property.
+ * @returns The offset in total minutes.
+ */
+export function parseOffset(offsetString) {
+    if (!/^[+-]\d{4}$/.test(offsetString)) {
+        throw new Error(`Invalid offset string: ${offsetString}`);
+    }
+    const sign = offsetString.startsWith('-') ? -1 : 1;
+    const hours = parseInt(offsetString.substring(1, 3), 10);
+    const minutes = parseInt(offsetString.substring(3, 5), 10);
+    return sign * (hours * 60 + minutes);
+}
+/**
+ * Parses a property containing a comma-separated list of date or date-time values
+ * (e.g., from an RDATE or EXDATE property) into an array of Luxon DateTime objects.
+ * @param prop - The IcsProperty containing the comma-separated date values.
+ * @param resolver - The optional timezone resolver.
+ * @returns An array of Luxon DateTime objects.
+ */
+export function parseDateTimeList(prop, resolver) {
+    return prop.value.split(',').map((val) => parseIcsDateTime({ ...prop, value: val }, resolver));
+}
+// --- Rule Parsers ---
+/**
+ * Parses a raw RRULE string into a structured `RecurrenceRule` object, breaking
+ * down its components like FREQ, UNTIL, BYDAY, etc..
+ * @param rruleString - The raw value of the RRULE property.
+ * @returns A structured RecurrenceRule object.
+ */
+export function parseRruleString(rruleString) {
+    const parts = rruleString.split(';');
+    const rule = {};
+    for (const part of parts) {
+        if (!part.includes('='))
+            continue;
+        const [key, value] = part.split('=');
+        switch (key.toUpperCase()) {
+            case 'FREQ': {
+                const validFreqs = [
+                    'YEARLY',
+                    'MONTHLY',
+                    'WEEKLY',
+                    'DAILY',
+                    'HOURLY',
+                    'MINUTELY',
+                    'SECONDLY',
+                ];
+                const freqValue = value.toUpperCase();
+                if (!validFreqs.includes(freqValue)) {
+                    throw new InvalidRruleError(`Invalid FREQ value: ${value}`);
+                }
+                rule.freq = freqValue;
+                break;
+            }
+            case 'INTERVAL':
+                rule.interval = parseInt(value, 10);
+                break;
+            case 'COUNT':
+                rule.count = parseInt(value, 10);
+                break;
+            case 'WKST':
+                rule.wkst = value;
+                break;
+            case 'UNTIL': {
+                const isUtc = value.endsWith('Z');
+                // RFC5545 states UNTIL MUST be a UTC date-time
+                rule.until = DateTime.fromISO(value, { zone: isUtc ? 'utc' : 'local' }).toUTC();
+                break;
+            }
+            case 'BYDAY':
+                rule.byday = value.split(',').map((day) => {
+                    const match = day.match(/([+-]?\d+)?(SU|MO|TU|WE|TH|FR|SA)/);
+                    if (!match)
+                        throw new InvalidRruleError(`Invalid BYDAY value: ${day}`);
+                    const weekday = match[2];
+                    const n = match[1] ? parseInt(match[1], 10) : undefined;
+                    return { weekday, n };
+                });
+                break;
+            case 'BYMONTH':
+                rule.bymonth = value.split(',').map((v) => parseInt(v, 10));
+                break;
+            case 'BYMONTHDAY':
+                rule.bymonthday = value.split(',').map((v) => parseInt(v, 10));
+                break;
+            case 'BYYEARDAY':
+                rule.byyearday = value.split(',').map((v) => parseInt(v, 10));
+                break;
+            case 'BYWEEKNO':
+                rule.byweekno = value.split(',').map((v) => parseInt(v, 10));
+                break;
+            case 'BYHOUR':
+                rule.byhour = value.split(',').map((v) => parseInt(v, 10));
+                break;
+            case 'BYMINUTE':
+                rule.byminute = value.split(',').map((v) => parseInt(v, 10));
+                break;
+            case 'BYSECOND':
+                rule.bysecond = value.split(',').map((v) => parseInt(v, 10));
+                break;
+            case 'BYSETPOS':
+                rule.bysetpos = value.split(',').map((v) => parseInt(v, 10));
+                break;
+        }
+    }
+    if (!rule.freq) {
+        throw new InvalidRruleError('RRULE string must contain a FREQ part.');
+    }
+    return rule;
+}
+//# sourceMappingURL=property-parsers.js.map

package/dist/ics-parser/property-parsers.js.map

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

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

@@ -0,0 +1,10 @@
+import { DateTime } from 'luxon';
+import { type RRuleOptions } from './types.js';
+/**
+ * **REFACTORED**: A generator that expands a recurrence rule into a sequence of dates.
+ * This implementation uses an "iterative advancement" strategy to avoid generating
+ * huge arrays of candidates, making it significantly more performant.
+ * @param options - The start date of the event series (`rangeStart`), the rule, and the query `rangeEnd`.
+ */
+export declare function expandRrule(options: RRuleOptions): Generator<DateTime, void, unknown>;
+//# sourceMappingURL=rrule-expander.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rrule-expander.d.ts","sourceRoot":"","sources":["../../src/ics-parser/rrule-expander.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAuB,MAAM,OAAO,CAAA;AAGrD,OAAO,EAAgD,KAAK,YAAY,EAAE,MAAM,YAAY,CAAA;AA0E5F;;;;;GAKG;AACH,wBAAiB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAiCtF"}