@miguelarios/pim-core 0.5.0 → 0.6.0

package/dist/ics/_shared.d.ts

@@ -0,0 +1,11 @@
+import ICAL from "ical.js";
+import type { ParsedAlarm, ParsedAttendee, ParsedGeo, ParsedOrganizer } from "./types.js";
+export declare function parseAttendees(component: ICAL.Component): ParsedAttendee[];
+export declare function parseOrganizer(component: ICAL.Component): ParsedOrganizer | null;
+export declare function parseCategories(component: ICAL.Component): string[];
+export declare function parseGeo(component: ICAL.Component): ParsedGeo | null;
+export declare function parseDurationToSeconds(duration: string): number;
+export declare function formatTriggerHuman(seconds: number): string;
+export declare function parseAlarms(component: ICAL.Component): ParsedAlarm[];
+export declare function timeToIso(time: ICAL.Time): string;
+//# sourceMappingURL=_shared.d.ts.map

package/dist/ics/_shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_shared.d.ts","sourceRoot":"","sources":["../../src/ics/_shared.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAa1F,wBAAgB,cAAc,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,GAAG,cAAc,EAAE,CAsB1E;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,GAAG,eAAe,GAAG,IAAI,CAShF;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,GAAG,MAAM,EAAE,CAUnE;AAED,wBAAgB,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,GAAG,SAAS,GAAG,IAAI,CAepE;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAgB/D;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAe1D;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,GAAG,WAAW,EAAE,CAwBpE;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,GAAG,MAAM,CAKjD"}

package/dist/ics/_shared.js

@@ -0,0 +1,150 @@
+import ICAL from "ical.js";
+const CUTYPE_MAP = {
+    INDIVIDUAL: "person",
+    ROOM: "room",
+    RESOURCE: "resource",
+    GROUP: "group",
+};
+function stripMailto(value) {
+    return value.replace(/^mailto:/i, "");
+}
+export function parseAttendees(component) {
+    const properties = component.getAllProperties("attendee");
+    return properties.map((prop) => {
+        const value = prop.getFirstValue();
+        const email = typeof value === "string" ? stripMailto(value) : "";
+        const cnRaw = prop.getParameter("cn");
+        const cn = typeof cnRaw === "string" ? cnRaw : null;
+        const partstatRaw = prop.getParameter("partstat");
+        const partstat = typeof partstatRaw === "string" ? partstatRaw : undefined;
+        const roleRaw = prop.getParameter("role");
+        const role = typeof roleRaw === "string" ? roleRaw : undefined;
+        const cutypeRaw = prop.getParameter("cutype");
+        // RFC 5545 §3.2.3: CUTYPE defaults to INDIVIDUAL when absent.
+        const cutype = typeof cutypeRaw === "string" && cutypeRaw.length > 0 ? cutypeRaw : "INDIVIDUAL";
+        return {
+            email,
+            name: cn,
+            status: partstat ? partstat.toLowerCase() : null,
+            role: role ? role.toLowerCase() : null,
+            type: CUTYPE_MAP[cutype] ?? "unknown",
+        };
+    });
+}
+export function parseOrganizer(component) {
+    const prop = component.getFirstProperty("organizer");
+    if (!prop)
+        return null;
+    const value = prop.getFirstValue();
+    const email = typeof value === "string" ? stripMailto(value) : "";
+    if (!email)
+        return null;
+    const cnRaw = prop.getParameter("cn");
+    const name = typeof cnRaw === "string" ? cnRaw : null;
+    return { email, name };
+}
+export function parseCategories(component) {
+    const properties = component.getAllProperties("categories");
+    const out = [];
+    for (const prop of properties) {
+        const values = prop.getValues();
+        for (const v of values) {
+            if (typeof v === "string" && v.length > 0)
+                out.push(v);
+        }
+    }
+    return out;
+}
+export function parseGeo(component) {
+    const prop = component.getFirstProperty("geo");
+    if (!prop)
+        return null;
+    const value = prop.getFirstValue();
+    if (!Array.isArray(value) || value.length !== 2)
+        return null;
+    const [lat, lon] = value;
+    if (typeof lat !== "number" || typeof lon !== "number")
+        return null;
+    if (Number.isNaN(lat) || Number.isNaN(lon))
+        return null;
+    // Reject GEO:; sentinel: ical.js parses `GEO:;` (empty value) as [0, 0]
+    // (verified). The 0,0 false-rejection at Gulf-of-Guinea (0°N 0°E) is a known
+    // edge case — preferred over surfacing corrupted-GEO data as a real location.
+    // If you genuinely need 0,0, a future change can disambiguate by inspecting
+    // the raw property string for "GEO:;" vs "GEO:0;0".
+    if (lat === 0 && lon === 0)
+        return null;
+    return { latitude: lat, longitude: lon };
+}
+export function parseDurationToSeconds(duration) {
+    const negative = duration.startsWith("-");
+    // RFC 5545 §3.3.6: PnW (weeks-only) is mutually exclusive with the date/time form.
+    const weekMatch = duration.match(/P(\d+)W$/);
+    if (weekMatch) {
+        const weeks = Number.parseInt(weekMatch[1], 10);
+        return (negative ? -1 : 1) * weeks * 604800;
+    }
+    const match = duration.match(/P(?:(\d+)D)?(?:T(?:(\d+)H)?(?:(\d+)M)?(?:(\d+)S)?)?/);
+    if (!match)
+        return 0;
+    const days = Number.parseInt(match[1] || "0", 10);
+    const hours = Number.parseInt(match[2] || "0", 10);
+    const minutes = Number.parseInt(match[3] || "0", 10);
+    const seconds = Number.parseInt(match[4] || "0", 10);
+    const total = days * 86400 + hours * 3600 + minutes * 60 + seconds;
+    return negative ? -total : total;
+}
+export function formatTriggerHuman(seconds) {
+    if (seconds === 0)
+        return "At time of event";
+    const abs = Math.abs(seconds);
+    const suffix = seconds < 0 ? "before" : "after";
+    const parts = [];
+    const days = Math.floor(abs / 86400);
+    const hours = Math.floor((abs % 86400) / 3600);
+    const minutes = Math.floor((abs % 3600) / 60);
+    if (days > 0)
+        parts.push(`${days} ${days === 1 ? "day" : "days"}`);
+    if (hours > 0)
+        parts.push(`${hours} ${hours === 1 ? "hour" : "hours"}`);
+    if (minutes > 0)
+        parts.push(`${minutes} ${minutes === 1 ? "minute" : "minutes"}`);
+    if (parts.length === 0) {
+        parts.push(`${abs} ${abs === 1 ? "second" : "seconds"}`);
+    }
+    return `${parts.join(", ")} ${suffix}`;
+}
+export function parseAlarms(component) {
+    const valarms = component.getAllSubcomponents("valarm");
+    const out = [];
+    for (const valarm of valarms) {
+        const triggerProp = valarm.getFirstProperty("trigger");
+        if (!triggerProp)
+            continue;
+        const value = triggerProp.getFirstValue();
+        if (value instanceof ICAL.Time) {
+            const date = value.toJSDate();
+            out.push({
+                type: "absolute",
+                trigger: date.toISOString(),
+                trigger_human: date.toISOString(),
+            });
+        }
+        else if (value instanceof ICAL.Duration) {
+            const seconds = value.toSeconds();
+            out.push({
+                type: "relative",
+                trigger: seconds,
+                trigger_human: formatTriggerHuman(seconds),
+            });
+        }
+    }
+    return out;
+}
+export function timeToIso(time) {
+    // Convert to UTC then to JS Date then to ISO. Floating times resolve as-if-UTC
+    // unless the caller is providing context via a viewer timezone (handled at the
+    // parse-events layer where the timezone param is known).
+    return time.toJSDate().toISOString();
+}
+//# sourceMappingURL=_shared.js.map

package/dist/ics/_shared.js.map

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

package/dist/ics/_tz-init.d.ts

@@ -0,0 +1,2 @@
+export declare function initializeTimezones(): void;
+//# sourceMappingURL=_tz-init.d.ts.map

package/dist/ics/_tz-init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_tz-init.d.ts","sourceRoot":"","sources":["../../src/ics/_tz-init.ts"],"names":[],"mappings":"AAMA,wBAAgB,mBAAmB,IAAI,IAAI,CAqB1C"}

package/dist/ics/_tz-init.js

@@ -0,0 +1,29 @@
+import { getVtimezone } from "@touch4it/ical-timezones";
+import zones from "@touch4it/ical-timezones/zones.js";
+import ICAL from "ical.js";
+let initialized = false;
+export function initializeTimezones() {
+    if (initialized)
+        return;
+    initialized = true;
+    for (const tzid of Object.keys(zones)) {
+        if (ICAL.TimezoneService.has(tzid))
+            continue;
+        const vtimezoneBlock = getVtimezone(tzid);
+        if (!vtimezoneBlock || typeof vtimezoneBlock !== "string")
+            continue;
+        try {
+            const root = ICAL.Component.fromString(vtimezoneBlock);
+            const vtz = root.getFirstSubcomponent("vtimezone");
+            if (vtz) {
+                const tz = new ICAL.Timezone({ component: vtz });
+                ICAL.TimezoneService.register(tz, tzid);
+            }
+        }
+        catch {
+            // Skip any malformed entries silently — vendor data, not user input.
+        }
+    }
+}
+initializeTimezones();
+//# sourceMappingURL=_tz-init.js.map

package/dist/ics/_tz-init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_tz-init.js","sourceRoot":"","sources":["../../src/ics/_tz-init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,MAAM,mCAAmC,CAAC;AACtD,OAAO,IAAI,MAAM,SAAS,CAAC;AAE3B,IAAI,WAAW,GAAG,KAAK,CAAC;AAExB,MAAM,UAAU,mBAAmB;IACjC,IAAI,WAAW;QAAE,OAAO;IACxB,WAAW,GAAG,IAAI,CAAC;IAEnB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACtC,IAAI,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QAE7C,MAAM,cAAc,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,cAAc,IAAI,OAAO,cAAc,KAAK,QAAQ;YAAE,SAAS;QAEpE,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;YACvD,MAAM,GAAG,GAAG,IAAI,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC;YACnD,IAAI,GAAG,EAAE,CAAC;gBACR,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;gBACjD,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,qEAAqE;QACvE,CAAC;IACH,CAAC;AACH,CAAC;AAED,mBAAmB,EAAE,CAAC"}

package/dist/ics/components.d.ts

@@ -0,0 +1,26 @@
+import "./_tz-init.js";
+export interface ExceptionOverrides {
+    title?: string;
+    start?: string;
+    end?: string;
+    all_day?: boolean;
+    location?: string;
+    description?: string;
+    attendees?: Array<{
+        email: string;
+    }>;
+    alarms?: Array<{
+        type: "relative" | "absolute";
+        trigger: number | string;
+    }>;
+    categories?: string[];
+    organizer?: {
+        email: string;
+        name?: string | null;
+    };
+    availability?: "busy" | "free";
+}
+export declare function createExceptionComponent(masterIcs: string, componentType: "vevent" | "vtodo", occurrenceDate: string, overrides: ExceptionOverrides, allDay: boolean): string;
+export declare function combineIcsComponents(masterIcs: string, exceptionComponent: string): string;
+export declare function addExdateToIcs(icsContent: string, occurrenceDate: string, allDay: boolean): string;
+//# sourceMappingURL=components.d.ts.map

package/dist/ics/components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../src/ics/components.ts"],"names":[],"mappings":"AACA,OAAO,eAAe,CAAC;AAIvB,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrC,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,UAAU,GAAG,UAAU,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5E,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACpD,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAChC;AAUD,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,QAAQ,GAAG,OAAO,EACjC,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,kBAAkB,EAC7B,MAAM,EAAE,OAAO,GACd,MAAM,CAoGR;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,MAAM,CAyC1F;AAED,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,OAAO,GACd,MAAM,CAiCR"}

package/dist/ics/components.js

@@ -0,0 +1,178 @@
+import ICAL from "ical.js";
+import "./_tz-init.js";
+import { parseAttendees, parseCategories, parseOrganizer } from "./_shared.js";
+import { IcsParseError } from "./errors.js";
+function parseRoot(ics) {
+    try {
+        return ICAL.Component.fromString(ics);
+    }
+    catch (e) {
+        throw new IcsParseError("Invalid ICS content", e);
+    }
+}
+export function createExceptionComponent(masterIcs, componentType, occurrenceDate, overrides, allDay) {
+    const masterRoot = parseRoot(masterIcs);
+    const masterComp = masterRoot.getFirstSubcomponent(componentType);
+    if (!masterComp)
+        throw new IcsParseError(`No ${componentType} found in master ICS`, null);
+    // Read fields directly from the already-parsed component instead of running a
+    // second full pass through parseIcsEvents.
+    const rawUid = masterComp.getFirstPropertyValue("uid");
+    const uid = typeof rawUid === "string" ? rawUid : "";
+    const masterDtstart = masterComp.getFirstPropertyValue("dtstart");
+    const masterDtend = masterComp.getFirstPropertyValue("dtend");
+    const masterStartMs = masterDtstart instanceof ICAL.Time ? masterDtstart.toJSDate().getTime() : 0;
+    const masterEndMs = masterDtend instanceof ICAL.Time ? masterDtend.toJSDate().getTime() : 0;
+    const duration = masterEndMs - masterStartMs;
+    const occMs = new Date(occurrenceDate).getTime();
+    const defaultStart = new Date(occMs).toISOString();
+    const defaultEnd = new Date(occMs + duration).toISOString();
+    const rawSummary = masterComp.getFirstPropertyValue("summary");
+    const masterTitle = typeof rawSummary === "string" ? rawSummary : "";
+    const rawLocation = masterComp.getFirstPropertyValue("location");
+    const masterLocation = typeof rawLocation === "string" && rawLocation.length > 0 ? rawLocation : null;
+    const rawDescription = masterComp.getFirstPropertyValue("description");
+    const masterDescription = typeof rawDescription === "string" && rawDescription.length > 0 ? rawDescription : null;
+    const masterOrganizer = parseOrganizer(masterComp);
+    const masterAttendees = parseAttendees(masterComp);
+    const masterCategories = parseCategories(masterComp);
+    const masterTransp = masterComp.getFirstPropertyValue("transp");
+    let masterAvailability = null;
+    if (typeof masterTransp === "string") {
+        if (masterTransp.toUpperCase() === "OPAQUE")
+            masterAvailability = "busy";
+        else if (masterTransp.toUpperCase() === "TRANSPARENT")
+            masterAvailability = "free";
+    }
+    const ex = new ICAL.Component(componentType);
+    ex.updatePropertyWithValue("uid", uid);
+    const recurId = ICAL.Time.fromJSDate(new Date(occurrenceDate), true);
+    if (allDay)
+        recurId.isDate = true;
+    const recurProp = ex.updatePropertyWithValue("recurrence-id", recurId);
+    if (allDay)
+        recurProp.setParameter("value", "DATE");
+    const startIso = overrides.start ?? defaultStart;
+    const endIso = overrides.end ?? defaultEnd;
+    const isAllDay = overrides.all_day ?? allDay;
+    const dtstart = ICAL.Time.fromJSDate(new Date(startIso), true);
+    if (isAllDay)
+        dtstart.isDate = true;
+    const dtstartProp = ex.updatePropertyWithValue("dtstart", dtstart);
+    if (isAllDay)
+        dtstartProp.setParameter("value", "DATE");
+    const dtend = ICAL.Time.fromJSDate(new Date(endIso), true);
+    if (isAllDay)
+        dtend.isDate = true;
+    const dtendProp = ex.updatePropertyWithValue("dtend", dtend);
+    if (isAllDay)
+        dtendProp.setParameter("value", "DATE");
+    // SEQUENCE: bump master's
+    const masterSeq = masterComp.getFirstPropertyValue("sequence");
+    const seq = (typeof masterSeq === "number" ? masterSeq : 0) + 1;
+    ex.updatePropertyWithValue("sequence", seq);
+    ex.updatePropertyWithValue("summary", overrides.title ?? masterTitle);
+    if (overrides.location ?? masterLocation) {
+        ex.updatePropertyWithValue("location", overrides.location ?? masterLocation ?? "");
+    }
+    if (overrides.description ?? masterDescription) {
+        ex.updatePropertyWithValue("description", overrides.description ?? masterDescription ?? "");
+    }
+    const organizer = overrides.organizer ?? masterOrganizer;
+    if (organizer) {
+        const name = organizer.name && organizer.name.trim().length > 0
+            ? organizer.name
+            : organizer.email.split("@")[0];
+        const orgProp = ex.updatePropertyWithValue("organizer", `mailto:${organizer.email}`);
+        orgProp.setParameter("cn", name);
+    }
+    const attendees = overrides.attendees ?? masterAttendees;
+    if (attendees) {
+        for (const att of attendees) {
+            ex.addPropertyWithValue("attendee", `mailto:${att.email}`);
+        }
+    }
+    const categories = overrides.categories ?? masterCategories;
+    if (categories && categories.length > 0) {
+        ex.addPropertyWithValue("categories", categories.join(","));
+    }
+    const availability = overrides.availability ?? masterAvailability;
+    if (availability === "free")
+        ex.updatePropertyWithValue("transp", "TRANSPARENT");
+    else if (availability === "busy")
+        ex.updatePropertyWithValue("transp", "OPAQUE");
+    ex.updatePropertyWithValue("status", "CONFIRMED");
+    return ex.toString();
+}
+export function combineIcsComponents(masterIcs, exceptionComponent) {
+    const masterRoot = parseRoot(masterIcs);
+    // Guard against double-wrap: callers should pass a bare BEGIN:VEVENT…END:VEVENT
+    // block (the output of createExceptionComponent), not a full VCALENDAR.
+    if (/BEGIN:VCALENDAR/i.test(exceptionComponent)) {
+        throw new IcsParseError("exceptionComponent must be a bare VEVENT/VTODO block, not a full VCALENDAR", null);
+    }
+    // Wrap the bare exception VEVENT/VTODO in a synthetic VCALENDAR so it can be parsed.
+    const wrapped = `BEGIN:VCALENDAR\r\nVERSION:2.0\r\nPRODID:-//pim-core//combine//EN\r\n${exceptionComponent}\r\nEND:VCALENDAR`;
+    const exRoot = parseRoot(wrapped);
+    const exComp = exRoot.getFirstSubcomponent("vevent") ?? exRoot.getFirstSubcomponent("vtodo");
+    if (!exComp)
+        throw new IcsParseError("Exception component is not a VEVENT or VTODO", null);
+    const exUid = exComp.getFirstPropertyValue("uid");
+    const exRecurId = exComp.getFirstPropertyValue("recurrence-id");
+    if (!(exRecurId instanceof ICAL.Time)) {
+        throw new IcsParseError("Exception component must have a RECURRENCE-ID", null);
+    }
+    const exRecurMs = exRecurId.toJSDate().getTime();
+    const componentName = exComp.name;
+    // Find and remove any existing matching subcomponent.
+    const existing = masterRoot.getAllSubcomponents(componentName);
+    for (const sub of existing) {
+        const subUid = sub.getFirstPropertyValue("uid");
+        const subRecur = sub.getFirstPropertyValue("recurrence-id");
+        if (subUid === exUid &&
+            subRecur instanceof ICAL.Time &&
+            subRecur.toJSDate().getTime() === exRecurMs) {
+            masterRoot.removeSubcomponent(sub);
+        }
+    }
+    masterRoot.addSubcomponent(exComp);
+    return masterRoot.toString();
+}
+export function addExdateToIcs(icsContent, occurrenceDate, allDay) {
+    const root = parseRoot(icsContent);
+    // EXDATE goes on the master event (first VEVENT without a RECURRENCE-ID).
+    const masters = root
+        .getAllSubcomponents("vevent")
+        .filter((c) => !c.getFirstProperty("recurrence-id"));
+    const master = masters[0];
+    if (!master)
+        return icsContent;
+    const newDate = ICAL.Time.fromJSDate(new Date(occurrenceDate), true);
+    if (allDay)
+        newDate.isDate = true;
+    const newMs = newDate.toJSDate().getTime();
+    const newYmd = `${newDate.year}-${String(newDate.month).padStart(2, "0")}-${String(newDate.day).padStart(2, "0")}`;
+    // Idempotency check: scan existing EXDATE values. For all-day (DATE-typed)
+    // EXDATEs compare YYYY-MM-DD strings — toJSDate() on a date-only value uses
+    // local-midnight which can drift across DST boundaries vs. the new value's
+    // UTC-midnight epoch ms. For date-time EXDATEs the epoch comparison works.
+    for (const exProp of master.getAllProperties("exdate")) {
+        for (const v of exProp.getValues()) {
+            if (!(v instanceof ICAL.Time))
+                continue;
+            if (allDay && v.isDate) {
+                const vYmd = `${v.year}-${String(v.month).padStart(2, "0")}-${String(v.day).padStart(2, "0")}`;
+                if (vYmd === newYmd)
+                    return icsContent;
+            }
+            else if (!allDay && !v.isDate && v.toJSDate().getTime() === newMs) {
+                return icsContent;
+            }
+        }
+    }
+    const exProp = master.addPropertyWithValue("exdate", newDate);
+    if (allDay)
+        exProp.setParameter("value", "DATE");
+    return root.toString();
+}
+//# sourceMappingURL=components.js.map

package/dist/ics/components.js.map

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

package/dist/ics/errors.d.ts

@@ -0,0 +1,7 @@
+export declare class IcsParseError extends Error {
+    constructor(message: string, cause: unknown);
+}
+export declare class IcsGenerateError extends Error {
+    constructor(message: string, cause: unknown);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/ics/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;CAI5C;AAED,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;CAI5C"}

package/dist/ics/errors.js

@@ -0,0 +1,13 @@
+export class IcsParseError extends Error {
+    constructor(message, cause) {
+        super(message, { cause });
+        this.name = "IcsParseError";
+    }
+}
+export class IcsGenerateError extends Error {
+    constructor(message, cause) {
+        super(message, { cause });
+        this.name = "IcsGenerateError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/ics/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/ics/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,YAAY,OAAe,EAAE,KAAc;QACzC,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC,YAAY,OAAe,EAAE,KAAc;QACzC,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF"}

package/dist/ics/generate.d.ts

@@ -0,0 +1,4 @@
+import "./_tz-init.js";
+import type { EventCreateProps } from "./types.js";
+export declare function generateEventIcs(props: EventCreateProps): string;
+//# sourceMappingURL=generate.d.ts.map

package/dist/ics/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/ics/generate.ts"],"names":[],"mappings":"AAGA,OAAO,eAAe,CAAC;AAGvB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAoBnD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAqFhE"}

package/dist/ics/generate.js

@@ -0,0 +1,101 @@
+// packages/core/src/ics/generate.ts
+import { randomUUID } from "node:crypto";
+import ICAL from "ical.js";
+import "./_tz-init.js";
+import { IcsGenerateError } from "./errors.js";
+import { normalizeRecurrenceRule } from "./rrule.js";
+function toIcalTime(iso, allDay, tzid) {
+    const date = new Date(iso);
+    if (Number.isNaN(date.getTime())) {
+        throw new IcsGenerateError(`Invalid ISO date: ${iso}`, null);
+    }
+    if (allDay) {
+        return ICAL.Time.fromDateString(date.toISOString().slice(0, 10));
+    }
+    if (tzid) {
+        const zone = ICAL.TimezoneService.get(tzid);
+        if (zone) {
+            const utc = ICAL.Time.fromJSDate(date, true);
+            return utc.convertToZone(zone);
+        }
+    }
+    return ICAL.Time.fromJSDate(date, true);
+}
+export function generateEventIcs(props) {
+    if (props.attendees && props.attendees.length > 0 && !props.organizer) {
+        throw new IcsGenerateError("ORGANIZER is required when ATTENDEE is present (RFC 6638)", null);
+    }
+    const calendar = new ICAL.Component(["vcalendar", [], []]);
+    calendar.updatePropertyWithValue("prodid", "-//pim-core//cal-mcp//EN");
+    calendar.updatePropertyWithValue("version", "2.0");
+    if (props.timezone) {
+        const zone = ICAL.TimezoneService.get(props.timezone);
+        if (zone?.component) {
+            calendar.addSubcomponent(zone.component);
+        }
+    }
+    const vevent = new ICAL.Component("vevent");
+    const uid = props.uid ?? `${randomUUID()}@pim-core`;
+    vevent.updatePropertyWithValue("uid", uid);
+    vevent.updatePropertyWithValue("dtstamp", ICAL.Time.now());
+    vevent.updatePropertyWithValue("summary", props.title);
+    vevent.updatePropertyWithValue("status", "CONFIRMED");
+    const allDay = props.all_day === true;
+    const dtstart = toIcalTime(props.start, allDay, props.timezone);
+    const dtend = toIcalTime(props.end, allDay, props.timezone);
+    const dtstartProp = vevent.updatePropertyWithValue("dtstart", dtstart);
+    const dtendProp = vevent.updatePropertyWithValue("dtend", dtend);
+    if (props.timezone && !allDay) {
+        dtstartProp.setParameter("tzid", props.timezone);
+        dtendProp.setParameter("tzid", props.timezone);
+    }
+    if (props.location)
+        vevent.updatePropertyWithValue("location", props.location);
+    if (props.description)
+        vevent.updatePropertyWithValue("description", props.description);
+    if (props.availability === "free")
+        vevent.updatePropertyWithValue("transp", "TRANSPARENT");
+    else if (props.availability === "busy")
+        vevent.updatePropertyWithValue("transp", "OPAQUE");
+    if (props.organizer) {
+        const name = props.organizer.name && props.organizer.name.trim().length > 0
+            ? props.organizer.name
+            : props.organizer.email.split("@")[0];
+        const orgProp = vevent.updatePropertyWithValue("organizer", `mailto:${props.organizer.email}`);
+        orgProp.setParameter("cn", name);
+    }
+    if (props.attendees) {
+        for (const att of props.attendees) {
+            vevent.addPropertyWithValue("attendee", `mailto:${att.email}`);
+        }
+    }
+    if (props.categories && props.categories.length > 0) {
+        vevent.addPropertyWithValue("categories", props.categories.join(","));
+    }
+    if (props.recurrence_rule) {
+        const normalized = normalizeRecurrenceRule(props.recurrence_rule);
+        if (!normalized) {
+            throw new IcsGenerateError(`Invalid recurrence_rule: ${props.recurrence_rule}`, null);
+        }
+        vevent.addProperty(ICAL.Property.fromString(`RRULE:${normalized}`));
+    }
+    if (props.alarms) {
+        for (const alarm of props.alarms) {
+            const valarm = new ICAL.Component("valarm");
+            valarm.updatePropertyWithValue("action", "DISPLAY");
+            valarm.updatePropertyWithValue("description", props.title);
+            if (alarm.type === "relative" && typeof alarm.trigger === "number") {
+                const dur = ICAL.Duration.fromSeconds(alarm.trigger);
+                valarm.updatePropertyWithValue("trigger", dur);
+            }
+            else if (alarm.type === "absolute" && typeof alarm.trigger === "string") {
+                const t = ICAL.Time.fromJSDate(new Date(alarm.trigger), true);
+                valarm.updatePropertyWithValue("trigger", t);
+            }
+            vevent.addSubcomponent(valarm);
+        }
+    }
+    calendar.addSubcomponent(vevent);
+    return calendar.toString();
+}
+//# sourceMappingURL=generate.js.map

package/dist/ics/generate.js.map

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

package/dist/ics/index.d.ts

@@ -0,0 +1,11 @@
+import "./_tz-init.js";
+export { IcsParseError, IcsGenerateError } from "./errors.js";
+export type { ParsedAlarm, ParsedAttendee, ParsedOrganizer, ParsedGeo, ParsedEvent, ParsedTodo, ParsedJournal, TimeRange, EventCreateProps, } from "./types.js";
+export { normalizeRecurrenceRule } from "./rrule.js";
+export { parseIcsEvents } from "./parse-events.js";
+export { parseIcsTodos } from "./parse-todos.js";
+export { parseIcsJournals } from "./parse-journals.js";
+export { generateEventIcs } from "./generate.js";
+export { createExceptionComponent, combineIcsComponents, addExdateToIcs, } from "./components.js";
+export type { ExceptionOverrides } from "./components.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ics/index.ts"],"names":[],"mappings":"AAGA,OAAO,eAAe,CAAC;AAEvB,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC9D,YAAY,EACV,WAAW,EACX,cAAc,EACd,eAAe,EACf,SAAS,EACT,WAAW,EACX,UAAU,EACV,aAAa,EACb,SAAS,EACT,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/ics/index.js

@@ -0,0 +1,12 @@
+// Side-effect import: registers the IANA timezone set with ICAL.TimezoneService
+// at module load. Consumers of @miguelarios/pim-core/ics get tz resolution wired
+// up by virtue of importing from this barrel.
+import "./_tz-init.js";
+export { IcsParseError, IcsGenerateError } from "./errors.js";
+export { normalizeRecurrenceRule } from "./rrule.js";
+export { parseIcsEvents } from "./parse-events.js";
+export { parseIcsTodos } from "./parse-todos.js";
+export { parseIcsJournals } from "./parse-journals.js";
+export { generateEventIcs } from "./generate.js";
+export { createExceptionComponent, combineIcsComponents, addExdateToIcs, } from "./components.js";
+//# sourceMappingURL=index.js.map

package/dist/ics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ics/index.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,iFAAiF;AACjF,8CAA8C;AAC9C,OAAO,eAAe,CAAC;AAEvB,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAY9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,cAAc,GACf,MAAM,iBAAiB,CAAC"}

package/dist/ics/parse-events.d.ts

@@ -0,0 +1,4 @@
+import "./_tz-init.js";
+import type { ParsedEvent, TimeRange } from "./types.js";
+export declare function parseIcsEvents(icsContent: string, range?: TimeRange, timezone?: string): ParsedEvent[];
+//# sourceMappingURL=parse-events.d.ts.map

package/dist/ics/parse-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-events.d.ts","sourceRoot":"","sources":["../../src/ics/parse-events.ts"],"names":[],"mappings":"AACA,OAAO,eAAe,CAAC;AAUvB,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAoKzD,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,SAAS,EACjB,QAAQ,CAAC,EAAE,MAAM,GAChB,WAAW,EAAE,CAiEf"}

package/dist/ics/parse-events.js

@@ -0,0 +1,223 @@
+import ICAL from "ical.js";
+import "./_tz-init.js";
+import { parseAlarms, parseAttendees, parseCategories, parseGeo, parseOrganizer, timeToIso, } from "./_shared.js";
+import { IcsParseError } from "./errors.js";
+function nullIfEmpty(value) {
+    if (typeof value !== "string")
+        return null;
+    return value.length > 0 ? value : null;
+}
+function buildBaseEvent(component) {
+    const url = component.getFirstPropertyValue("url");
+    const status = component.getFirstPropertyValue("status");
+    const transp = component.getFirstPropertyValue("transp");
+    const rrule = component.getFirstPropertyValue("rrule");
+    const created = component.getFirstPropertyValue("created");
+    const lastModified = component.getFirstPropertyValue("last-modified");
+    const rdateProps = component.getAllProperties("rdate");
+    const rdates = [];
+    for (const prop of rdateProps) {
+        for (const v of prop.getValues()) {
+            if (v instanceof ICAL.Time)
+                rdates.push(timeToIso(v));
+        }
+    }
+    let availability = null;
+    if (typeof transp === "string") {
+        if (transp.toUpperCase() === "OPAQUE")
+            availability = "busy";
+        else if (transp.toUpperCase() === "TRANSPARENT")
+            availability = "free";
+    }
+    const summary = component.getFirstPropertyValue("summary");
+    const uid = component.getFirstPropertyValue("uid");
+    const location = component.getFirstPropertyValue("location");
+    const description = component.getFirstPropertyValue("description");
+    return {
+        uid: typeof uid === "string" ? uid : "",
+        title: typeof summary === "string" ? summary : "",
+        all_day: false, // overwritten below per-instance
+        location: nullIfEmpty(location),
+        description: nullIfEmpty(description),
+        status: typeof status === "string" ? status.toLowerCase() : null,
+        availability,
+        url: typeof url === "string" && url.length > 0 ? url : null,
+        attendees: parseAttendees(component),
+        categories: parseCategories(component),
+        geo: parseGeo(component),
+        organizer: parseOrganizer(component),
+        recurrence_rule: rrule ? rrule.toString() : null,
+        rdates: rdates.length > 0 ? rdates : null,
+        created: created instanceof ICAL.Time ? created.toJSDate().toISOString() : null,
+        last_modified: lastModified instanceof ICAL.Time ? lastModified.toJSDate().toISOString() : null,
+        is_recurring: !!rrule,
+        alarms: parseAlarms(component),
+        occurrence_date: null,
+    };
+}
+function dateOnlyToIso(time) {
+    // For VALUE=DATE values, treat as UTC midnight rather than local-midnight.
+    // ICAL.Time.toJSDate() for date-only values uses the local Date constructor
+    // which makes the result depend on the test machine's tz; we want a
+    // deterministic ISO string anchored at UTC midnight.
+    const yyyy = time.year.toString().padStart(4, "0");
+    const mm = time.month.toString().padStart(2, "0");
+    const dd = time.day.toString().padStart(2, "0");
+    return `${yyyy}-${mm}-${dd}T00:00:00.000Z`;
+}
+function timeToEventIso(time) {
+    return time.isDate ? dateOnlyToIso(time) : time.toJSDate().toISOString();
+}
+// A floating time has no TZID and is not UTC ("Z"). In ical.js v2 the parser
+// assigns ICAL.Timezone.localTimezone to such values, which makes
+// toJSDate() interpret the wall-clock components in the host process tz.
+// That makes parser output non-deterministic across machines. When the caller
+// passes a `timezone` argument, treat it as the viewer's preferred zone and
+// re-anchor the wall-clock there before converting to UTC.
+function isFloating(time) {
+    if (time.isDate)
+        return false;
+    const zone = time.zone;
+    return zone === ICAL.Timezone.localTimezone || zone == null;
+}
+function timeToEventIsoWithTz(time, timezone) {
+    if (time.isDate)
+        return dateOnlyToIso(time);
+    if (timezone && isFloating(time)) {
+        const tz = ICAL.TimezoneService.get(timezone);
+        if (tz) {
+            // Build a fresh ICAL.Time with the same wall-clock components anchored
+            // in the requested zone. Mutating `time.zone` directly also works in
+            // ical.js v2 but constructing a new value avoids touching the caller's
+            // component tree.
+            const rebound = new ICAL.Time({
+                year: time.year,
+                month: time.month,
+                day: time.day,
+                hour: time.hour,
+                minute: time.minute,
+                second: time.second,
+                isDate: false,
+            }, tz);
+            return rebound.toJSDate().toISOString();
+        }
+    }
+    return time.toJSDate().toISOString();
+}
+function emitNonExpanded(component, isException, timezone) {
+    const base = buildBaseEvent(component);
+    const dtstart = component.getFirstPropertyValue("dtstart");
+    const dtend = component.getFirstPropertyValue("dtend");
+    if (!(dtstart instanceof ICAL.Time))
+        return [];
+    const allDay = dtstart.isDate;
+    const startIso = timeToEventIsoWithTz(dtstart, timezone);
+    const endIso = dtend instanceof ICAL.Time ? timeToEventIsoWithTz(dtend, timezone) : startIso;
+    let occDate = null;
+    if (isException) {
+        const recurId = component.getFirstPropertyValue("recurrence-id");
+        if (recurId instanceof ICAL.Time)
+            occDate = recurId.toJSDate().toISOString();
+    }
+    return [{ ...base, all_day: allDay, start: startIso, end: endIso, occurrence_date: occDate }];
+}
+function emitOccurrences(event, range, timezone) {
+    const out = [];
+    const rangeStart = ICAL.Time.fromJSDate(new Date(range.start), true);
+    const rangeEnd = ICAL.Time.fromJSDate(new Date(range.end), true);
+    const it = event.iterator();
+    // event.iterator().next() returns null/undefined when the series is exhausted
+    // (finite RRULEs with COUNT or UNTIL hit this branch). Range is half-open
+    // [start, end) per RFC 4791 §9.9 — an occurrence whose DTSTART equals
+    // range.end is excluded.
+    while (true) {
+        const next = it.next();
+        if (!next)
+            break;
+        if (next.compare(rangeEnd) >= 0)
+            break;
+        if (next.compare(rangeStart) < 0)
+            continue;
+        const details = event.getOccurrenceDetails(next);
+        const effective = details.item; // master or exception override
+        const base = buildBaseEvent(effective.component);
+        const allDay = details.startDate.isDate;
+        out.push({
+            ...base,
+            all_day: allDay,
+            start: timeToEventIsoWithTz(details.startDate, timezone),
+            end: timeToEventIsoWithTz(details.endDate, timezone),
+            // occurrence_date is the original RRULE-generated slot (RECURRENCE-ID).
+            // For ordinary occurrences this equals startDate; for exception overrides
+            // it is the original time the occurrence was supposed to fire, which is
+            // what consumers need to reconcile overrides back to the master series.
+            occurrence_date: timeToEventIsoWithTz(details.recurrenceId, timezone),
+        });
+    }
+    return out;
+}
+export function parseIcsEvents(icsContent, range, timezone) {
+    if (!icsContent.trim())
+        return [];
+    let root;
+    try {
+        root = ICAL.Component.fromString(icsContent);
+    }
+    catch (e) {
+        throw new IcsParseError("Invalid ICS content", e);
+    }
+    const veventComponents = root.getAllSubcomponents("vevent");
+    // Group by UID. Master events have no RECURRENCE-ID; exception VEVENTs do.
+    const groups = new Map();
+    for (const comp of veventComponents) {
+        // UID is REQUIRED by RFC 5545 §3.8.4.7 but real-world fixtures sometimes
+        // omit it (e.g. ical.js sample timezone_from_file.ics). Bucket UID-less
+        // VEVENTs under the empty string so they still surface to consumers
+        // rather than being silently dropped.
+        const rawUid = comp.getFirstPropertyValue("uid");
+        const uid = typeof rawUid === "string" ? rawUid : "";
+        let group = groups.get(uid);
+        if (!group) {
+            group = { master: null, exceptions: [] };
+            groups.set(uid, group);
+        }
+        if (comp.getFirstProperty("recurrence-id")) {
+            group.exceptions.push(comp);
+        }
+        else {
+            group.master = comp;
+        }
+    }
+    const out = [];
+    for (const [, group] of groups) {
+        if (!group.master) {
+            // Orphan exception VEVENTs (master not in this ICS) — emit each as standalone.
+            for (const ex of group.exceptions) {
+                out.push(...emitNonExpanded(ex, true, timezone));
+            }
+            continue;
+        }
+        let event;
+        try {
+            event = new ICAL.Event(group.master);
+            for (const ex of group.exceptions) {
+                event.relateException(new ICAL.Event(ex));
+            }
+        }
+        catch {
+            // If ICAL.Event construction fails for this group, skip it but don't fail the batch.
+            continue;
+        }
+        if (event.isRecurring() && range) {
+            out.push(...emitOccurrences(event, range, timezone));
+        }
+        else {
+            out.push(...emitNonExpanded(group.master, false, timezone));
+            for (const ex of group.exceptions) {
+                out.push(...emitNonExpanded(ex, true, timezone));
+            }
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=parse-events.js.map

package/dist/ics/parse-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-events.js","sourceRoot":"","sources":["../../src/ics/parse-events.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,eAAe,CAAC;AACvB,OAAO,EACL,WAAW,EACX,cAAc,EACd,eAAe,EACf,QAAQ,EACR,cAAc,EACd,SAAS,GACV,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,SAAS,WAAW,CAAC,KAAc;IACjC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3C,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AACzC,CAAC;AAED,SAAS,cAAc,CAAC,SAAyB;IAC/C,MAAM,GAAG,GAAG,SAAS,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,SAAS,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,SAAS,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,SAAS,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC;IACvD,MAAM,OAAO,GAAG,SAAS,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC;IAC3D,MAAM,YAAY,GAAG,SAAS,CAAC,qBAAqB,CAAC,eAAe,CAAC,CAAC;IAEtE,MAAM,UAAU,GAAG,SAAS,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACvD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;YACjC,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI;gBAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED,IAAI,YAAY,GAAkB,IAAI,CAAC;IACvC,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,IAAI,MAAM,CAAC,WAAW,EAAE,KAAK,QAAQ;YAAE,YAAY,GAAG,MAAM,CAAC;aACxD,IAAI,MAAM,CAAC,WAAW,EAAE,KAAK,aAAa;YAAE,YAAY,GAAG,MAAM,CAAC;IACzE,CAAC;IAED,MAAM,OAAO,GAAG,SAAS,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC;IAC3D,MAAM,GAAG,GAAG,SAAS,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,SAAS,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC;IAC7D,MAAM,WAAW,GAAG,SAAS,CAAC,qBAAqB,CAAC,aAAa,CAAC,CAAC;IAEnE,OAAO;QACL,GAAG,EAAE,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;QACvC,KAAK,EAAE,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;QACjD,OAAO,EAAE,KAAK,EAAE,iCAAiC;QACjD,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAAC;QAC/B,WAAW,EAAE,WAAW,CAAC,WAAW,CAAC;QACrC,MAAM,EAAE,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI;QAChE,YAAY;QACZ,GAAG,EAAE,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI;QAC3D,SAAS,EAAE,cAAc,CAAC,SAAS,CAAC;QACpC,UAAU,EAAE,eAAe,CAAC,SAAS,CAAC;QACtC,GAAG,EAAE,QAAQ,CAAC,SAAS,CAAC;QACxB,SAAS,EAAE,cAAc,CAAC,SAAS,CAAC;QACpC,eAAe,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI;QAChD,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI;QACzC,OAAO,EAAE,OAAO,YAAY,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI;QAC/E,aAAa,EAAE,YAAY,YAAY,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI;QAC/F,YAAY,EAAE,CAAC,CAAC,KAAK;QACrB,MAAM,EAAE,WAAW,CAAC,SAAS,CAAC;QAC9B,eAAe,EAAE,IAAI;KACtB,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,IAAe;IACpC,2EAA2E;IAC3E,4EAA4E;IAC5E,oEAAoE;IACpE,qDAAqD;IACrD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACnD,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAClD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAChD,OAAO,GAAG,IAAI,IAAI,EAAE,IAAI,EAAE,gBAAgB,CAAC;AAC7C,CAAC;AAED,SAAS,cAAc,CAAC,IAAe;IACrC,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,CAAC;AAC3E,CAAC;AAED,6EAA6E;AAC7E,kEAAkE;AAClE,yEAAyE;AACzE,8EAA8E;AAC9E,4EAA4E;AAC5E,2DAA2D;AAC3D,SAAS,UAAU,CAAC,IAAe;IACjC,IAAI,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACvB,OAAO,IAAI,KAAK,IAAI,CAAC,QAAQ,CAAC,aAAa,IAAI,IAAI,IAAI,IAAI,CAAC;AAC9D,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAe,EAAE,QAAiB;IAC9D,IAAI,IAAI,CAAC,MAAM;QAAE,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,QAAQ,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,MAAM,EAAE,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,EAAE,EAAE,CAAC;YACP,uEAAuE;YACvE,qEAAqE;YACrE,uEAAuE;YACvE,kBAAkB;YAClB,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,IAAI,CAC3B;gBACE,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,MAAM,EAAE,KAAK;aACd,EACD,EAAE,CACH,CAAC;YACF,OAAO,OAAO,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,CAAC;QAC1C,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,CAAC;AACvC,CAAC;AAED,SAAS,eAAe,CACtB,SAAyB,EACzB,WAAoB,EACpB,QAAiB;IAEjB,MAAM,IAAI,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,SAAS,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC;IAC3D,MAAM,KAAK,GAAG,SAAS,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC;IACvD,IAAI,CAAC,CAAC,OAAO,YAAY,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC9B,MAAM,QAAQ,GAAG,oBAAoB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,KAAK,YAAY,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,oBAAoB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC7F,IAAI,OAAO,GAAkB,IAAI,CAAC;IAClC,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,OAAO,GAAG,SAAS,CAAC,qBAAqB,CAAC,eAAe,CAAC,CAAC;QACjE,IAAI,OAAO,YAAY,IAAI,CAAC,IAAI;YAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,CAAC;IAC/E,CAAC;IACD,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,CAAC,CAAC;AAChG,CAAC;AAED,SAAS,eAAe,CAAC,KAAiB,EAAE,KAAgB,EAAE,QAAiB;IAC7E,MAAM,GAAG,GAAkB,EAAE,CAAC;IAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;IACrE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;IACjE,MAAM,EAAE,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC5B,8EAA8E;IAC9E,0EAA0E;IAC1E,sEAAsE;IACtE,yBAAyB;IACzB,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,IAAI,GAAiC,EAAE,CAAC,IAAI,EAAE,CAAC;QACrD,IAAI,CAAC,IAAI;YAAE,MAAM;QACjB,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,MAAM;QACvC,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,+BAA+B;QAC/D,MAAM,IAAI,GAAG,cAAc,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC;QACxC,GAAG,CAAC,IAAI,CAAC;YACP,GAAG,IAAI;YACP,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,oBAAoB,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC;YACxD,GAAG,EAAE,oBAAoB,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC;YACpD,wEAAwE;YACxE,0EAA0E;YAC1E,wEAAwE;YACxE,wEAAwE;YACxE,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,YAAY,EAAE,QAAQ,CAAC;SACtE,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,UAAkB,EAClB,KAAiB,EACjB,QAAiB;IAEjB,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IAElC,IAAI,IAAoB,CAAC;IACzB,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAC/C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,aAAa,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,gBAAgB,GAAG,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAC5D,2EAA2E;IAC3E,MAAM,MAAM,GAAG,IAAI,GAAG,EAA2E,CAAC;IAClG,KAAK,MAAM,IAAI,IAAI,gBAAgB,EAAE,CAAC;QACpC,yEAAyE;QACzE,wEAAwE;QACxE,oEAAoE;QACpE,sCAAsC;QACtC,MAAM,MAAM,GAAG,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;QACjD,MAAM,GAAG,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,IAAI,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;YACzC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACzB,CAAC;QACD,IAAI,IAAI,CAAC,gBAAgB,CAAC,eAAe,CAAC,EAAE,CAAC;YAC3C,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;QACtB,CAAC;IACH,CAAC;IAED,MAAM,GAAG,GAAkB,EAAE,CAAC;IAE9B,KAAK,MAAM,CAAC,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAClB,+EAA+E;YAC/E,KAAK,MAAM,EAAE,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;gBAClC,GAAG,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;YACnD,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,KAAiB,CAAC;QACtB,IAAI,CAAC;YACH,KAAK,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACrC,KAAK,MAAM,EAAE,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;gBAClC,KAAK,CAAC,eAAe,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,qFAAqF;YACrF,SAAS;QACX,CAAC;QAED,IAAI,KAAK,CAAC,WAAW,EAAE,IAAI,KAAK,EAAE,CAAC;YACjC,GAAG,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;QACvD,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;YAC5D,KAAK,MAAM,EAAE,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;gBAClC,GAAG,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/ics/parse-journals.d.ts

@@ -0,0 +1,4 @@
+import "./_tz-init.js";
+import type { ParsedJournal } from "./types.js";
+export declare function parseIcsJournals(icsContent: string): ParsedJournal[];
+//# sourceMappingURL=parse-journals.d.ts.map

package/dist/ics/parse-journals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-journals.d.ts","sourceRoot":"","sources":["../../src/ics/parse-journals.ts"],"names":[],"mappings":"AACA,OAAO,eAAe,CAAC;AAGvB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAWhD,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,EAAE,CA2CpE"}

package/dist/ics/parse-journals.js

@@ -0,0 +1,54 @@
+import ICAL from "ical.js";
+import "./_tz-init.js";
+import { parseCategories } from "./_shared.js";
+import { IcsParseError } from "./errors.js";
+function dateOnlyToString(t) {
+    // For VALUE=DATE properties, ical.js sets isDate=true and the JS Date is at midnight UTC.
+    // Emit YYYY-MM-DD without timezone interpretation.
+    const yr = t.year.toString().padStart(4, "0");
+    const mo = t.month.toString().padStart(2, "0");
+    const da = t.day.toString().padStart(2, "0");
+    return `${yr}-${mo}-${da}`;
+}
+export function parseIcsJournals(icsContent) {
+    if (!icsContent.trim())
+        return [];
+    let root;
+    try {
+        root = ICAL.Component.fromString(icsContent);
+    }
+    catch (e) {
+        throw new IcsParseError("Invalid ICS content", e);
+    }
+    const out = [];
+    for (const vjournal of root.getAllSubcomponents("vjournal")) {
+        try {
+            const dtstart = vjournal.getFirstPropertyValue("dtstart");
+            const status = vjournal.getFirstPropertyValue("status");
+            const created = vjournal.getFirstPropertyValue("created");
+            const lastModified = vjournal.getFirstPropertyValue("last-modified");
+            let dateStr = "";
+            if (dtstart instanceof ICAL.Time) {
+                dateStr = dtstart.isDate ? dateOnlyToString(dtstart) : dtstart.toJSDate().toISOString();
+            }
+            const rawUid = vjournal.getFirstPropertyValue("uid");
+            const rawSummary = vjournal.getFirstPropertyValue("summary");
+            const rawDescription = vjournal.getFirstPropertyValue("description");
+            out.push({
+                uid: typeof rawUid === "string" ? rawUid : "",
+                title: typeof rawSummary === "string" ? rawSummary : "",
+                date: dateStr,
+                description: typeof rawDescription === "string" ? rawDescription : null,
+                categories: parseCategories(vjournal),
+                status: typeof status === "string" ? status.toLowerCase() : null,
+                created: created instanceof ICAL.Time ? created.toJSDate().toISOString() : null,
+                last_modified: lastModified instanceof ICAL.Time ? lastModified.toJSDate().toISOString() : null,
+            });
+        }
+        catch {
+            // Skip malformed VJOURNAL, don't fail whole batch.
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=parse-journals.js.map

package/dist/ics/parse-journals.js.map

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

package/dist/ics/parse-todos.d.ts

@@ -0,0 +1,4 @@
+import "./_tz-init.js";
+import type { ParsedTodo } from "./types.js";
+export declare function parseIcsTodos(icsContent: string): ParsedTodo[];
+//# sourceMappingURL=parse-todos.d.ts.map

package/dist/ics/parse-todos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-todos.d.ts","sourceRoot":"","sources":["../../src/ics/parse-todos.ts"],"names":[],"mappings":"AACA,OAAO,eAAe,CAAC;AAGvB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,EAAE,CAkD9D"}

package/dist/ics/parse-todos.js

@@ -0,0 +1,55 @@
+import ICAL from "ical.js";
+import "./_tz-init.js";
+import { parseAlarms, parseAttendees, parseCategories, parseOrganizer } from "./_shared.js";
+import { IcsParseError } from "./errors.js";
+export function parseIcsTodos(icsContent) {
+    if (!icsContent.trim())
+        return [];
+    let root;
+    try {
+        root = ICAL.Component.fromString(icsContent);
+    }
+    catch (e) {
+        throw new IcsParseError("Invalid ICS content", e);
+    }
+    const out = [];
+    for (const vtodo of root.getAllSubcomponents("vtodo")) {
+        try {
+            const due = vtodo.getFirstPropertyValue("due");
+            const completed = vtodo.getFirstPropertyValue("completed");
+            const percent = vtodo.getFirstPropertyValue("percent-complete");
+            const priority = vtodo.getFirstPropertyValue("priority");
+            const status = vtodo.getFirstPropertyValue("status");
+            const created = vtodo.getFirstPropertyValue("created");
+            const lastModified = vtodo.getFirstPropertyValue("last-modified");
+            const rrule = vtodo.getFirstPropertyValue("rrule");
+            const recurId = vtodo.getFirstPropertyValue("recurrence-id");
+            const rawUid = vtodo.getFirstPropertyValue("uid");
+            const rawSummary = vtodo.getFirstPropertyValue("summary");
+            const rawDescription = vtodo.getFirstPropertyValue("description");
+            out.push({
+                uid: typeof rawUid === "string" ? rawUid : "",
+                title: typeof rawSummary === "string" ? rawSummary : "",
+                due: due instanceof ICAL.Time ? due.toJSDate().toISOString() : null,
+                completed: completed instanceof ICAL.Time ? completed.toJSDate().toISOString() : null,
+                percent_complete: typeof percent === "number" ? percent : null,
+                priority: typeof priority === "number" ? priority : null,
+                status: typeof status === "string" ? status.toLowerCase() : null,
+                description: typeof rawDescription === "string" ? rawDescription : null,
+                categories: parseCategories(vtodo),
+                attendees: parseAttendees(vtodo),
+                organizer: parseOrganizer(vtodo),
+                alarms: parseAlarms(vtodo),
+                recurrence_rule: rrule ? rrule.toString() : null,
+                created: created instanceof ICAL.Time ? created.toJSDate().toISOString() : null,
+                last_modified: lastModified instanceof ICAL.Time ? lastModified.toJSDate().toISOString() : null,
+                occurrence_date: recurId instanceof ICAL.Time ? recurId.toJSDate().toISOString() : null,
+            });
+        }
+        catch {
+            // Skip malformed VTODO, don't fail whole batch.
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=parse-todos.js.map

package/dist/ics/parse-todos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-todos.js","sourceRoot":"","sources":["../../src/ics/parse-todos.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5F,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,MAAM,UAAU,aAAa,CAAC,UAAkB;IAC9C,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IAElC,IAAI,IAAoB,CAAC;IACzB,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAC/C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,aAAa,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,GAAG,GAAiB,EAAE,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAE,CAAC;QACtD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,KAAK,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;YAC/C,MAAM,SAAS,GAAG,KAAK,CAAC,qBAAqB,CAAC,WAAW,CAAC,CAAC;YAC3D,MAAM,OAAO,GAAG,KAAK,CAAC,qBAAqB,CAAC,kBAAkB,CAAC,CAAC;YAChE,MAAM,QAAQ,GAAG,KAAK,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC;YACzD,MAAM,MAAM,GAAG,KAAK,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;YACrD,MAAM,OAAO,GAAG,KAAK,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC;YACvD,MAAM,YAAY,GAAG,KAAK,CAAC,qBAAqB,CAAC,eAAe,CAAC,CAAC;YAClE,MAAM,KAAK,GAAG,KAAK,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC;YACnD,MAAM,OAAO,GAAG,KAAK,CAAC,qBAAqB,CAAC,eAAe,CAAC,CAAC;YAC7D,MAAM,MAAM,GAAG,KAAK,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;YAClD,MAAM,UAAU,GAAG,KAAK,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC;YAC1D,MAAM,cAAc,GAAG,KAAK,CAAC,qBAAqB,CAAC,aAAa,CAAC,CAAC;YAElE,GAAG,CAAC,IAAI,CAAC;gBACP,GAAG,EAAE,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;gBAC7C,KAAK,EAAE,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE;gBACvD,GAAG,EAAE,GAAG,YAAY,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI;gBACnE,SAAS,EAAE,SAAS,YAAY,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI;gBACrF,gBAAgB,EAAE,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;gBAC9D,QAAQ,EAAE,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI;gBACxD,MAAM,EAAE,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI;gBAChE,WAAW,EAAE,OAAO,cAAc,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI;gBACvE,UAAU,EAAE,eAAe,CAAC,KAAK,CAAC;gBAClC,SAAS,EAAE,cAAc,CAAC,KAAK,CAAC;gBAChC,SAAS,EAAE,cAAc,CAAC,KAAK,CAAC;gBAChC,MAAM,EAAE,WAAW,CAAC,KAAK,CAAC;gBAC1B,eAAe,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI;gBAChD,OAAO,EAAE,OAAO,YAAY,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI;gBAC/E,aAAa,EACX,YAAY,YAAY,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI;gBAClF,eAAe,EAAE,OAAO,YAAY,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI;aACxF,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,gDAAgD;QAClD,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/ics/rrule.d.ts

@@ -0,0 +1,2 @@
+export declare function normalizeRecurrenceRule(rule: string): string | null;
+//# sourceMappingURL=rrule.d.ts.map

package/dist/ics/rrule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rrule.d.ts","sourceRoot":"","sources":["../../src/ics/rrule.ts"],"names":[],"mappings":"AAEA,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAcnE"}

package/dist/ics/rrule.js

@@ -0,0 +1,23 @@
+import ICAL from "ical.js";
+export function normalizeRecurrenceRule(rule) {
+    if (typeof rule !== "string")
+        return null;
+    let trimmed = rule.trim();
+    if (!trimmed)
+        return null;
+    if (/^RRULE:/i.test(trimmed))
+        trimmed = trimmed.slice(6).trim();
+    if (/[\r\n]/.test(trimmed))
+        return null;
+    try {
+        const recur = ICAL.Recur.fromString(trimmed);
+        // Ensure it has a FREQ property to be valid
+        if (!recur.freq)
+            return null;
+    }
+    catch {
+        return null;
+    }
+    return trimmed;
+}
+//# sourceMappingURL=rrule.js.map

package/dist/ics/rrule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rrule.js","sourceRoot":"","sources":["../../src/ics/rrule.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,SAAS,CAAC;AAE3B,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC1C,IAAI,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC1B,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAChE,IAAI,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACxC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAC7C,4CAA4C;QAC5C,IAAI,CAAC,KAAK,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/ics/types.d.ts

@@ -0,0 +1,100 @@
+export interface ParsedAlarm {
+    type: "relative" | "absolute";
+    trigger: number | string;
+    trigger_human: string;
+}
+export interface ParsedAttendee {
+    name: string | null;
+    email: string;
+    status: string | null;
+    role: string | null;
+    type: string;
+}
+export interface ParsedOrganizer {
+    name: string | null;
+    email: string;
+}
+export interface ParsedGeo {
+    latitude: number;
+    longitude: number;
+}
+export interface ParsedEvent {
+    uid: string;
+    title: string;
+    start: string;
+    end: string;
+    all_day: boolean;
+    location: string | null;
+    description: string | null;
+    status: string | null;
+    availability: string | null;
+    url: string | null;
+    attendees: ParsedAttendee[];
+    categories: string[];
+    geo: ParsedGeo | null;
+    organizer: ParsedOrganizer | null;
+    recurrence_rule: string | null;
+    rdates: string[] | null;
+    created: string | null;
+    last_modified: string | null;
+    is_recurring: boolean;
+    alarms: ParsedAlarm[];
+    occurrence_date: string | null;
+}
+export interface ParsedTodo {
+    uid: string;
+    title: string;
+    due: string | null;
+    completed: string | null;
+    percent_complete: number | null;
+    priority: number | null;
+    status: string | null;
+    description: string | null;
+    categories: string[];
+    attendees: ParsedAttendee[];
+    organizer: ParsedOrganizer | null;
+    alarms: ParsedAlarm[];
+    recurrence_rule: string | null;
+    created: string | null;
+    last_modified: string | null;
+    occurrence_date: string | null;
+}
+export interface ParsedJournal {
+    uid: string;
+    title: string;
+    date: string;
+    description: string | null;
+    categories: string[];
+    status: string | null;
+    created: string | null;
+    last_modified: string | null;
+}
+export interface TimeRange {
+    start: string;
+    end: string;
+}
+export interface EventCreateProps {
+    title: string;
+    start: string;
+    end: string;
+    all_day?: boolean;
+    location?: string;
+    description?: string;
+    attendees?: Array<{
+        email: string;
+    }>;
+    uid?: string;
+    timezone?: string;
+    alarms?: Array<{
+        type: "relative" | "absolute";
+        trigger: number | string;
+    }>;
+    categories?: string[];
+    recurrence_rule?: string;
+    organizer?: {
+        email: string;
+        name?: string | null;
+    };
+    availability?: "busy" | "free";
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/ics/types.d.ts.map

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

package/dist/ics/types.js

@@ -0,0 +1,3 @@
+// packages/core/src/ics/types.ts
+export {};
+//# sourceMappingURL=types.js.map

package/dist/ics/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/ics/types.ts"],"names":[],"mappings":"AAAA,iCAAiC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miguelarios/pim-core",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Shared config, validation, errors, and utilities for PIM agent MCP servers",
   "keywords": [
     "pim",
@@ -24,6 +24,10 @@
     ".": {
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
+    },
+    "./ics": {
+      "import": "./dist/ics/index.js",
+      "types": "./dist/ics/index.d.ts"
     }
   },
   "scripts": {
@@ -32,6 +36,8 @@
     "test": "vitest run"
   },
   "dependencies": {
+    "@touch4it/ical-timezones": "^1.9.0",
+    "ical.js": "^2.2.1",
     "valibot": "^1.0.0"
   },
   "devDependencies": {